GR5xxx_console.exe

Follow the steps below to run GR5xxx_console.exe:

Open the Command Prompt window from the Start menu or by entering cmd in the Run window.
Navigate to the GProgrammer installation directory by using cd command.
Type the GR5xxx_console.exe command to complete corresponding operations. The details about the command are shown in Table 8.

Table 8 GR5xxx_console supported commands
Command	Functional Description	Command Format and Parameter Description	Remarks
program	Programs firmware files to internal SoC flash memories.	program <firmware file path> <run immediately:y \| n> <flash start address(hex)> <flash size> <product type> Parameter description: <firmware file path>: It sets the path of the to-be-downloaded firmware file. <run immediately:y \| n>: It decides on whether to run the firmware immediately after downloading.	The following parameters apply to all commands: <flash start address(hex)>: It sets the start address in the Flash memories to which firmware files are downloaded. Value: 0x01000000: for GR551x <flash size>: It indicates the Flash size (unit: KB) of the selected SoC. For value details, see the Flash column in Figure 6. Note: For SoCs with 0 KB Flash, the external Flash size applies. <product type>: It indicates the SoC series. Valid value and description: 0: GR551x
erase	Erases flash memory data within an SoC based on a specified address range.	erase <start address<hex>> <end address<hex>><force erase when conflict with firmware/bootinfo:y \| n> <flash start address(hex)> <flash size> <product type> Parameter description: <start address<(hex)>>: It represents the start address of the storage area to be erased (in hexadecimal). <end address<(hex)>>: It represents the end address of the storage area to be erased (in hexadecimal). <force erase when conflict with firmware/bootinfo:y \| n>: This parameter decides whether to forcibly erase the flash memory data when its address conflicts with that of firmware, Boot info, or NVDS.
eraseall	Erases all flash memory data within an SoC.	eraseall <product type>
download	Downloads data files to internal SoC flash memories.	download <data file path> <start address<(hex)>> <force download when conflict with firmware/bootinfo:y \| n> <flash start address(hex)> <flash size> <product type> Parameter description: <data file path>: It sets the path of the to-be-downloaded data file. <start address<(hex)>>: It represents the start address of the download area (in hexadecimal). <force download when conflict with firmware/bootinfo:y \| n>: This parameter decides whether to forcibly download the data files to internal SoC flash memories when their addresses conflict with that of firmware or Boot info.
writeefuse	Writes Encrypt Key Info and Mode Control files to eFuse.	writeefuse <Encrypt Key Info file Path> <Mode Control file Path> <product type> Parameter description: <Encrypt Key Info file Path>: It sets the path of Encrypt Key Info file. <Mode Control file Path>: It sets the path of Mode Control file.
reset	Resets the GR551x SoC.	reset <product type>
generate	Converts firmware files into BIN files that can be used by the SoC	generate <input firmware file path> <output firmware file path> <flash start address(hex)> <flash size> <product type> Parameter description: <input firmware file path>: It indicates the path of an imported file (HEX/BIN file generated via integrated development environment tools). <output firmware file path>: It indicates the output file of an exported file.
help	Displays all help information.	help

Take GR551x SoC as an example. The code below shows how to use the program command to download a firmware file to SoC flash memories and run the firmware immediately after downloading. Command line:

GR5xxx_console.exe program "D:/test/test_fw.bin" y "0x01000000" 1024 0

The parameter descriptions are listed below:

"D:/test/test_fw.bin": It indicates the path for the to-be-downloaded firmware BIN file
"0x01000000" 1024 0: It represents the start address in Flash to which the firmware is downloaded (0x01000000), the Flash size (1024 KB), and SoC model (GR551x) respectively.

The downloading progress is displayed in real time during executing the program command.

Note:

You cannot operate GR5xxx_console.exe while GProgrammer is running.

GR5xxx_console.exe

Scan to follow