GHI Electronics Bootloader
The GHI Electronics Bootloader is used to update the firmware on our devices. It is the first program to run and unless the device specific LDR pins are set (see device documentation for details), it will execute the firmware on the device (if present).
The bootloader communicates over a USB (virtual serial port) and a regular serial port. The interface used is controlled by a MOD pin as detailed in Special Pins.
Loading the Firmware
The individual product pages include further instructions on the firmware needed and how to set the board in the loader mode. Once you have downloaded the firmware and set the board in loader mode, use the instructions below to load the firmware.
Using TinyCLR Config
TinyCLR Config tool includes multiple features developers need to work with TinyCLR OS-enabled devices. It simplifies the firmware update and it includes options for accessing the TinyCLR firmware at runtime.
Using this tool is the recommended path; however, manual installation instructions are also included on this page. Read more on the TinyCLR Config page.
TinyCLR Config tool should be used to update the firmware. As a backup, use these instructions:
- Put your board in bootloader mode. Each product has a specific way to enter the boot loader.
- Open any terminal software, for example Tera Term.
- Select serial and pick the COM port associated with your board. (If unsure, check Device Manager)
Vand then enter. You will see back the boot loader version number (v2.x.x)
Xand then enter. Use
Xfor firmware file type GHI and
Ufor firmware file type GLB.
Yto confirm then enter. You will now see
- Go to
- IMPORTANT: Make sure you check the
- Select the firmware file.
- When the transfer is complete, reset your board.
All commands and results are terminated with CR and LF (\r\n). "OK." will be sent after each successful command.
On startup, a banner is sent that is terminated by "OK.". Once the banner is received, you are free to enter any of the case-insensitive single-character commands described below.
Most commands require confirmation. Send Y or y followed by a new-line to proceed or anything else to cancel.
- V: Returns the current version.
- N: Returns the current device type.
- E: Erases all user sectors of the device.
- R: Runs the firmware if present.
- B: Increases the baud rate in serial mode to 921,600.
- X: Upload a
ghifile to the device using 1K XMODEM. Only send *.ghi files meant for your device.
- U: Upload a
glbfile to the device.
Only needed for Windows 7 and 8.