Preparing Radxa ROCK 3A to run examples

Switching for a computer and Radxa ROCK 3A

To see the output from Radxa ROCK 3A on a computer and to have debug capabilities, do the following:

  1. Connect the pins of the USB-UART converters to the corresponding GPIO pins of the Radxa ROCK 3A (see the figure below). If debugging is not necessary, all you need to do is connect one USB-UART converter for output.

    RPI_USB

    Diagram for connecting USB-UART converters and Radxa ROCK 3A

  2. Connect the computer's USB ports and the USB-UART converters.
  3. Install PuTTY or another equivalent program. Configure the parameters as follows:
    • bps = 115200, data bits = 8, stop bits = 1, parity = none, flow control = none for the main output.
    • bps = 115200, data bits = 8, stop bits = 1, parity = none, flow control = none for the debug output.

    Define the USB port connected to the USB-UART converter used for receiving output from Radxa ROCK 3A.

To allow a computer and Radxa ROCK 3A to interact through Ethernet, perform the following actions:

  1. Connect the network cards of the computer and Radxa ROCK 3A to a switch or to each other.
  2. Configure the computer's network card so that its IP address is in the same subnet as the IP address of the Radxa ROCK 3A network card (the settings of the Radxa ROCK 3A network card are defined in the dhcpcd.conf file, which is found at the path <example name>/resources/...).

Connecting an eMMC module

To work with examples that use the SDHC driver, you must include a storage device: microSD card or eMMC module. By default, the Radxa ROCK 3A examples are configured to work with a microSD card. To use an eMMC module, you need to install a compatible eMMC module on the Radxa ROCK 3A board (for example: eMMC 5.1 Module 32Gb for Rock Pi). Without an included eMMC module, initialization errors for the SDCard driver (which is part of the SDHC driver stack) will be displayed in standard output when running the examples. Also, in the solution build CMake file, you must change the device index in the EXTRA_ENV property from 1 (microSD card) to 0 (eMMC) using the set_target_properties() function.

# Configuration for microSD card (used by default for the Radxa ROCK 3A)

set_target_properties(Client PROPERTIES EXTRA_ENV " MMC_DEV_NUM: '1'")

# Configuration for eMMC module

set_target_properties(Client PROPERTIES EXTRA_ENV " MMC_DEV_NUM: '0'")

Preparing a bootable SD card for Radxa ROCK 3A

If the hdd.img image was created when building the example, all you have to do is write the resulting image to the SD card. To do this, connect the SD card to the computer and run the following command:

# In the following command, path_to_img is the path to the image file

# [X] is the final character in the name of the SD card block device.

$ sudo dd of=/dev/sd[X] if=path_to_img status=progress bs=64K conv=fsync

If kos-image was created when building the example, the SD card requires additional preparations before you can write the image to it. A bootable SD card for Radxa ROCK 3A can be prepared automatically or manually. After preparing the SD card, you must copy the kos-image file from the directory <example name>/build/einit to the bootable area (FAT32 partition) of the prepared SD card.

To automatically prepare the bootable SD card, connect the SD card to the computer and run the following commands:

# To create a bootable drive image file (*.img),

# run the script:

$ sudo /opt/KasperskyOS-Community-Edition-<platform>-<version>/common/rock3a_prepare_sdcard_image.sh

# In the following command, path_to_img is the path to the image file

# of the bootable drive (this path is displayed upon completion

# of the previous command), [X] is the final character

# in the name of the SD card block device.

$ sudo dd of=/dev/sd[X] if=path_to_img status=progress bs=64K conv=fsync

Clearing the Radxa ROCK 3A flash memory

In some editions of the Radxa ROCK 3A, the flash memory may contain a bootloader that is incompatible with the card that you have prepared according to the instructions provided above.

If you see the message "SPL: failed to boot from all boot devices" when running examples on the Radxa ROCK 3A, you must clear the Radxa ROCK 3A flash memory before running the examples.

To clear the Radxa ROCK 3A flash memory:

  1. Download and install the tool named rkdeveloptool.

    Instructions on installing this tool are provided in the documentation: https://docs.radxa.com/en/rock3/rock3a/low-level-dev/rkdeveloptool?host-os=debian#installation-for-rkdeveloptool

  2. Download the bootloader for interacting with the Radxa ROCK 3A: https://dl.radxa.com/rock3/images/loader/rk356x_spl_loader_ddr1056_v1.12.109_no_check_todly.bin
  3. Switch the Radxa ROCK 3A to Maskrom mode:
    1. Power it off.
    2. Extract the SD card (and the eMMC module if present).
    3. Connect the computer's USB port to the ROCK 3A OTG port (upper USB 3.0 port).
    4. Connect the Radxa ROCK 3A pins as shown on the figure below and power on the Radxa ROCK 3A.

      RPI_USB

    5. Disconnect the pins that were connected at the previous step.
    6. Make sure that the Radxa ROCK 3A is in Maskrom mode by running the following command in the terminal:

      $: rkdeveloptool ld

      DevNo=1 Vid=0x2207,Pid=0x350a,LocationID=104 Maskrom

  4. Clear the Radxa ROCK 3A flash memory by running the following commands in the terminal:

    rkdeveloptool ef

    rkdeveloptool rd

Page top