{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"f843f6ab-d45d-42b2-8e83-96edf004acf5"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"a08fad9d-423d-4497-8b34-ffafea4f2752"}},{"type":"heading","attrs":{"level":1},"content":[{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Get / install the CLI Flasher","type":"text"}]},{"type":"paragraph","content":[{"text":"Download the ","type":"text"},{"text":"CLI Flasher","type":"text","marks":[{"type":"link","attrs":{"href":"https://hilscher.atlassian.net/wiki/x/HSQFCQ"}}]}]},{"type":"paragraph","content":[{"text":"Unzip the CLI Flasher","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"USB driver for Windows","type":"text"}]},{"type":"paragraph","content":[{"text":"Download the ","type":"text"},{"text":"USB driver","type":"text","marks":[{"type":"link","attrs":{"href":"https://hilscher.atlassian.net/wiki/x/-wwFCQ"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Install the USB driver","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"udev rules for Linux","type":"text"}]},{"type":"paragraph","content":[{"text":"Apply the udev rules from this page ","type":"text"},{"text":"udev rules","type":"text","marks":[{"type":"link","attrs":{"href":"https://hilscher.atlassian.net/wiki/x/BQYFCQ"}}]},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"CLI Flasher starting with version 2.x.x","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Verify communication with netX","type":"text"}]},{"type":"paragraph","content":[{"text":"Put the netX hardware into boot mode and connect it to the PC. Change into the directory, where the flasher is located. Open a command line and enter the following command:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"cd ...\\flasher_cli-2.0.2-windows_x86_64\\flasher_cli-2.0.2>","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.4.exe cli_flash.lua info ","type":"text"}]},{"type":"paragraph","content":[{"text":"A list similar to the one below should appear:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"Please select the interface:\n1: romloader_uart_COM3 (romloader_uart) Used: false, Valid: true\n2: romloader_uart_COM4 (romloader_uart) Used: false, Valid: true\n3: romloader_uart_COM6 (romloader_uart) Used: false, Valid: true\n4: romloader_jtag_netX90_COM@NXHX_90-JTAG@3:2,3,1,1,4 (romloader_jtag) Used: false, Valid: true\nR: rescan\nC: cancel\n>","type":"text"}]},{"type":"paragraph","content":[{"text":"It should contain an entry with the interface the netX is connected to. Enter the number of this entry and press Enter.","type":"text"}]},{"type":"paragraph","content":[{"text":"Some more output should appear, ending with:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"Board info:\nBus 1: Serial Flash\n Unit 0: SQI\n Unit 1: SPI0_APP\n Unit 2: SPI1_APP\n Unit 3: SPI2_APP\n\nBus 2: Internal Flash\n Unit 0: IFLASH0\n Unit 1: IFLASH1\n Unit 2: IFLASH2\n Unit 3: IFLASH01","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"If it does, the PC can communicate with the netX.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Get help","type":"text"}]},{"type":"paragraph","content":[{"text":"The commands","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"lua5.4.exe ","type":"text"},{"text":"cli_flash.lua","type":"text","marks":[{"type":"strong"}]},{"text":" --help","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"lua5.4.exe ","type":"text"},{"text":"wfp.lua","type":"text","marks":[{"type":"strong"}]},{"text":" --help","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"lua5.4.exe ","type":"text"},{"text":"usip_player.lua","type":"text","marks":[{"type":"strong"}]},{"text":" --help","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"provide help for the implemented features.","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","content":[{"text":"Usage: Cli Flasher [-v] [-h] ...\n\n\n\nOptions:\n -v, --version Show version info and exit.\n -h, --help Show this help message and exit.\n\nCommands:\n flash, f Flash a file to the netX\n read, r Read data from netX to a File\n erase, e Erase area inside flash\n verify, v Verify that a file is flashed\n verify_hash, vh Quick compare using checksums\n hash, h Compute SHA1\n detect, d Check if flash is recognized\n test, t Test flasher\n testcli, tc Test cli flasher\n info, i Show information about the netX\n list_interfaces, li List all connected interfaces\n detect_netx, dn Detect if an interface is a netX\n detect_secure_boot_mode, dsbm\n Detect if secure boot is enabled (netX 90 only)\n reset_netx, rn Reset the netX\n identify_netx, in Blink SYS LED for 5 sec\n check_helper_version, chv\n Check that the helper files have the correct versions\n check_helper_signature, chs\n Verify the signatures of the helper files.\n\nLimitations:\n\nThere are several commands that are only valid for the netX 90:\n check_helper_version\n check_helper_signature\n detect_secure_boot_mode\n\nLikewise, the optional arguments for secure boot mode are only valid\nfor the netX 90:\n --sec\n --comp\n --disable_helper_signature_check\n\nThe reset_netx command currently supports only the netX 90.\n\nThe hash and verify_hash commands do not support the netIOL.\n\nExamples:\n\nWrite file to serial flash:\nlua cli_flash.lua flash -b 1 NETX100-BSL.bin\n\nErase boot cookie from serial flash:\nlua cli_flash.lua erase -b 1 -l 4\n\nErase boot cookie from parallel flash:\nlua cli_flash.lua erase -b 0 -l 4","type":"text"}]},{"type":"paragraph","content":[{"text":"Further details will be received with the command specific help","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.4.exe cli_flash.lua detect -h","type":"text"}]},{"type":"codeBlock","content":[{"text":"Usage: Cli Flasher detect ([--comp] | [--sec ]) -b [-u ]\n [-c ] [-p ] [-t ]\n [--jtag_reset ] [--jtag_khz ]\n [--disable_helper_signature_check] [-h]\n\nCheck if flash is recognized\n\nOptions:\n -b bus number\n -u unit number\n -c chip select number\n -p ,\n --plugin_name \n plugin name\n -t ,\n --plugin_type \n plugin type\n --jtag_reset \n JTAG reset method. Possible values are: hard (default), soft, attach\n --jtag_khz JTAG clock in kHz\n --comp use compatibility mode for netx90 M2M interfaces\n --sec Path to signed image directory (default: C:\\Daten_local_only\\Tools\\Hilscher\\flasher\\flasher_cli-2.0.2-windows_x86_64\\flasher_cli-2.0.2\\netx\\hboot\\unsigned)\n --disable_helper_signature_check\n Disable signature checks on helper files.\n -h, --help Show this help message and exit.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"The parameters to the various flashing operations should be clear, except how to specify the destination device.","type":"text"},{"type":"hardBreak"},{"text":"It consists of three parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"bus (-b )","type":"text","marks":[{"type":"strong"}]},{"text":": MANDATORY: selects between different flash types at different memory interfaces","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"unit","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"(-u )","type":"text","marks":[{"type":"strong"}]},{"text":": OPTIONAL default 0: selects one out of several interfaces of the same types (e.g. from multiple SPI interfaces)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"chip","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"select (-c )","type":"text","marks":[{"type":"strong"}]},{"text":": OPTIONAL default 0: selects one out of several available chip select lies on the same interface.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The serial flash on a netX 90 is bus 1, unit 0, chip select 0 by default. ","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.4.exe cli_flash.lua detect -b 1","type":"text"}]},{"type":"paragraph","content":[{"text":"attempts to detect the serial flash connected to the netX.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Example result if successful:","type":"text"}]},{"type":"codeBlock","content":[{"text":"JEDEC ID from flash ID sequence: 0xc2, 0x20, 0x16\nFlash device name: MX25L32xx\nFlash device has JEDEC ID: 0xc2, 0x20, 0x16\nFlash device size: 4194304/0x00400000 bytes","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Flash the file \"firmware.bin\" to bus 1, unit 0, chip select 0 and offset 0:","type":"text"}]},{"type":"paragraph","content":[{"text":"lua5.4.exe cli_flash.lua flash -b 1 -u 0 -c 0 firmware.bin","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Flash the file \"firmware.bin\" to bus 1, unit 0, chip select 0 and offset 0x1000:","type":"text"}]},{"type":"paragraph","content":[{"text":"lua5.4.exe cli_flash.lua flash -b 1 -u 0 -c 0 -s 0x1000 firmware.bin","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"netX 90: write into internal flash","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"parameter cs is always 0 to access the main flash content","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"COM side: at offset 0x3000","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.4.exe cli_flash.lua flash -b 2 -u 3 -c 0 -s 0x3000 firmware_com.bin","type":"text"}]},{"type":"paragraph","content":[{"text":"APP side: at offset 0x0000","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.4.exe cli_flash.lua flash -b 2 -u 2 -c 0 -s 0x0000 firmware_app.bin","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"netX 90: write into external flash","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"parameter c depends on the extern circuitry at the PCB. Most times it is C 0","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"at offset 0x0000","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.4.exe cli_flash.lua flash -b 1 -u 0 -c 0 -s 0x0000 firmware_com_extented.bin","type":"text"}]},{"type":"paragraph","content":[{"text":"at offset 0x0030 0000 (3MByte)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.4.exe cli_flash.lua flash -b 1 -u 0 -c 0 -s 0x00300000 firmware_app_extented.bin","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"CLI Flasher before version 2.x","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Verify communication with netX","type":"text"}]},{"type":"paragraph","content":[{"text":"Put the netX hardware into boot mode and connect it to the PC. Change into the directory, where the flasher is located. Open a command line and enter the following command:","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"cd ...\\flasher_cli-1.6.0-windows_x86_64\\flasher_cli-1.6.0","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.1.exe cli_flash.lua info ","type":"text"}]},{"type":"paragraph","content":[{"text":"A list similar to the one below should appear:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"Please select the interface:\n1: romloader_usb_02_05 (romloader_usb) Used: false, Valid: true\n2: romloader_uart_COM1 (romloader_uart) Used: false, Valid: true\n3: romloader_uart_COM3 (romloader_uart) Used: false, Valid: true\n4: romloader_jtag_netX90_COM@NXHX_90-JTAG@2:1,3 (romloader_jtag) Used: false, Valid: true\nR: rescan\nC: cancel\n>1","type":"text"}]},{"type":"paragraph","content":[{"text":"Note:","type":"text","marks":[{"type":"strong"}]},{"text":" Starting with (internal) version 1.5.3, USB-JTAG interfaces have a suffix starting with \"@\". It specifies the position of the adapter in the USB port hierarchy and allows distinguishing multiple adapters that are of the same type and are connected to the same type of target.","type":"text"}]},{"type":"paragraph","content":[{"text":"It should contain an entry with the interface the netX is connected to. Enter the number of this entry and press Enter.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Some more output should appear, ending with:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"Board info:\nBus 0: Parallel Flash\n Unit 0: SRamBus\n Unit 1: ExtBus\n\nBus 1: Serial Flash\n Unit 0: SPI","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"If it does, the PC can communicate with the netX.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Get help","type":"text"}]},{"type":"paragraph","content":[{"text":"The command","type":"text"},{"type":"hardBreak"},{"text":" lua5.1.exe cli_flash.lua -h ","type":"text"},{"type":"hardBreak"},{"text":"shows a command overview.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"Usage: lua cli_flash.lua mode parameters\n \nMode Parameters \nflash [p] dev [offset] file Write file to flash \nread [p] dev [offset] size file Read flash and write to file \nerase [p] dev [offset] size Erase area or whole flash \nverify [p] dev [offset] file Byte-by-byte compare\nverify_hash [p] dev [offset] file Quick compare using checksums\nhash [p] dev [offset] size Compute SHA1\ninfo [p] Show busses/units/chip selects\ndetect [p] dev Check if flash is recognized\ntest [p] dev Test flasher \ntestcli [p] dev Test cli flasher \nlist_interfaces List all usable interfaces\ndetect_netx [p] Detect the netx chip type\n-h Show this help \n \np: -p plugin_name\n select plugin\n example: -p romloader_usb_00_01\n \ndev: -b bus [-u unit -cs chip_select]\n select flash device\n default: -u 0 -cs 0\n \noff: -s device_start_offset\n offset in the flash device, defaults to 0\n \nsize: -l length\n number of bytes to read/erase/hash\n read/erase: 0xffffffff = from offset to end of chip\n\n \nExamples:\n\nWrite file to serial flash:\nlua cli_flash.lua flash -b 1 NETX100-BSL.bin\n\nErase boot cookie from serial flash:\nlua cli_flash.lua erase -b 1 -l 4 \n\nErase boot cookie from parallel flash:\nlua cli_flash.lua erase -b 0 -l 4","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"hardBreak"},{"text":"The parameters to the various flashing operations should be clear, except how to specify the destination device.","type":"text"},{"type":"hardBreak"},{"text":"It consists of three parameters:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"bus (-b )","type":"text","marks":[{"type":"strong"}]},{"text":": MANDATORY: selects between different flash types at different memory interfaces","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"unit","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"(-u )","type":"text","marks":[{"type":"strong"}]},{"text":": OPTIONAL default 0: selects one out of several interfaces of the same types (e.g. from multiple SPI interfaces)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"chip","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"select (-cs )","type":"text","marks":[{"type":"strong"}]},{"text":": OPTIONAL default 0: selects one out of several available chip select lies on the same interface.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The serial flash on a netX 100/500 is bus 1, unit 0, chip select 0 by default.","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.1.exe cli_flash.lua detect -b 1 -u 0 -cs 0","type":"text"}]},{"type":"paragraph","content":[{"text":"attempts to detect the serial flash connected to the netX.","type":"text"}]},{"type":"paragraph","content":[{"text":"Result if successful:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"[netx] . Mode: Detect\n[netx] . Device: SPI flash\n[netx] . Detecting SPI flash on unit 0, cs 0...\n[netx] . OK, found AT45DB321D","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Flashing a file","type":"text"}]},{"type":"paragraph","content":[{"text":"To flash a file to a device, the mode is set to \"flash\".","type":"text"}]},{"type":"paragraph","content":[{"text":"The default offset in the flash is 0, which is the start of the flash area. This can be changed with the option \"-s\".","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Flash the file \"firmware.bin\" to bus 1, unit 0, chip select 0 and offset 0:","type":"text"}]},{"type":"paragraph","content":[{"text":"lua5.1.exe cli_flash.lua flash -b 1 -u 0 -cs 0 firmware.bin","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Flash the file \"firmware.bin\" to bus 1, unit 0, chip select 0 and offset 0x1000:","type":"text"}]},{"type":"paragraph","content":[{"text":"lua5.1.exe cli_flash.lua flash -b 1 -u 0 -cs 0 -s 0x1000 firmware.bin","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"netX 90: write into internal flash","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"parameter cs is always 0 to access the main flash content","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"COM side: at offset 0x3000","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.1.exe cli_flash.lua flash -b 2 -u 3 -cs 0 -s 0x3000 firmware_com.bin","type":"text"}]},{"type":"paragraph","content":[{"text":"APP side: at offset 0x0000","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.1.exe cli_flash.lua flash -b 2 -u 2 -cs 0 -s 0x0000 firmware_app.bin","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"netX 90: write into external flash","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"parameter cs depends on the extern circuitry at the PCB. Most times it is CS 0","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"at offset ","type":"text"},{"text":"0x0000","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.1.exe cli_flash.lua flash -b 1 -u 0 -cs 0 -s 0x0000 firmware_com_extented.bin","type":"text"}]},{"type":"paragraph","content":[{"text":"at offset ","type":"text"},{"text":"0x0030 0000","type":"text","marks":[{"type":"textColor","attrs":{"color":"#333333"}}]},{"text":" (3MByte)","type":"text"}]},{"type":"paragraph","marks":[{"type":"indentation","attrs":{"level":1}}],"content":[{"text":"lua5.1.exe cli_flash.lua flash -b 1 -u 0 -cs 0 -s 0x00300000 firmware_app_extented.bin","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}