Flash the Image

This section details the steps for flashing your device. Ensure you’ve completed the prerequisites and set up the usb-tool as described in the previous section.

Note

To obtain the latest firmware image, either build it from source or download a prebuilt image.

See previous sections for details on building or downloading the image.

Connect the Board

Flashing Grinn AstraADA-1680 requires:

  • external USB-C Power Delivery power source,

  • Debug USB port connected to the host PC.

|BOARD_NAME| evaluation board connections

Download Mode

To flash the Grinn AstraADA-1680, it must first be in download mode.

  1. Locate the RESET and USB_BOOT buttons on your device (see the picture below).

  2. Press and hold both buttons at the same time.

  3. While still holding USB_BOOT, release RESET.

  4. After a brief pause, release USB_BOOT.

Grinn AstraADA-1680 should now be in download mode.

|BOARD_NAME| evaluation board buttons

Flashing

Once the usb-tool is ready and your device is in download mode, you can proceed with flashing the firmware.

  1. Navigate to the root directory of your Yocto build.

    Open a new terminal (do not use the Grinn Yocto Docker container) and navigate to the root directory of your Grinn AstraADA-1680 Yocto build.

    cd /path/to/your/yocto/main/directory

  2. Execute the flashing process.

    Use the flash-grinn-astra.sh helper script to flash your device, specifying the path to usb-tool and selecting the Grinn AstraADA-1680 platform (ada). The proper image will be selected from the Yocto build tree automatically:

    ./src/meta-grinn-astra/scripts/flash-grinn-astra <path/to/usb-tool> <platform_selector>

    If you have a pre-built image to be flashed, you can specify the path to the image manually:

    ./src/meta-grinn-astra/scripts/flash-grinn-astra <path/to/usb-tool> <platform_selector> <path/to/prebuilt/image>

    After the flashing is complete, an appropriate success message will appear in the script’s output.

Note

The script will display progress updates in your terminal.

Do not disconnect your device or interrupt the process until it completes successfully.

Troubleshooting

Failed to boot device / Device not detected

You might see messages such as:

Boot Failed: Timeout during boot, press RESET while holding USB_BOOT to try again
Failed to Boot Device

To resolve this, ensure the device is correctly in download mode by repeating the steps in the Download Mode section. Also check your USB cable and connection.

Flashing tool errors

Make sure you are running the command with sudo. Double-check the command syntax and the path to your firmware image.

For specific error messages, refer to the usb-tool documentation.

Flashing fails mid-process

Do not disconnect the device. Put it back into bootloader mode by repeating the Download Mode steps, then try flashing again.

If the problem continues, the firmware image might be corrupted or there could be a hardware issue with the device.