Firmware Update Guide

Command Overview:

Firmware Update Command:

--fw-update <type> <file> [--mode <mode>] [--bus <address>]

• type:
  • 1: ISP firmware update.
    • bus (optional): Specify the I2C bus address for ISP.
  • 2: UVC firmware update.
    • mode (optional, default: spi): Specify the update mode for UVC firmware. Options are:
      • ram: Burns the firmware code to RAM.
      • i2c: Burns the firmware code to EEPROM.
      • spi: Burns the firmware code to SPI.
  • 3: TEVS firmware update.

Additional Commands:

• --isp-fw-version: Display ISP firmware version information.
• --uvc-fw-version: Display UVC firmware version information.
• --tevs-fw-version: Display TEVS firmware version information.

MIPI Camera Firmware Update:

Example:

root@edm-g-imx8mp:~# vizion-ctl -l
TEVS-AR0522(/dev/video0)

• Device Information: The device is part of the TEVS series using MIPI.

Update Command:

root@edm-g-imx8mp:~# vizion-ctl -d /dev/video0 --fw-update 3 TEVS-AR0522_Color_24.10.00.01.bin

• Output:

Recover default setting...
[WARNING] Please do not turn off the power or disconnect the camera during the update process.
Start update TEVS sensor firmware.
Success: TEVS firmware update completed successfully. Please restart the camera.

UVC Camera Firmware Update:

Example:

root@edm-g-imx8mp:~# vizion-ctl -l
VCI-AR1335-C(/dev/video1)

ISP Firmware Update:

vizion-ctl -d /dev/video1 --fw-update 1 TEVI-AR1335_Color_24.01.436.00.bin

• Output:

Recover default setting...
Starting ISP firmware update...
Opening camera: 1
Cleaning ISP bootdata...
Retrieving ISP bootdata...
addr:TEVI-AR1335_Color_24.01.436.00.bin
Success: ISP firmware update completed successfully. Please restart the camera.

UVC Firmware Update:

vizion-ctl -d /dev/video1 --fw-update 2 VCI_UVC_24.10.00.01.img

• Output:

Recover default setting...
[WARNING] Please do not turn off the power or disconnect the camera during the update process.
Info: Found FX3 flash programmer
Info: Erased sector 0 of SPI flash
Info: Erased sector 1 of SPI flash
Info: Erased sector 2 of SPI flash
Info: Erased sector 3 of SPI flash
Info: SPI flash programming completed
Success: UVC firmware update completed successfully. Please restart the camera.

Handling UVC Firmware Corruption

If the UVC Firmware Update Fails and the Device is Not Detected:
If the UVC firmware update fails and the device is not detected as expected, use lsusb to check if the Cypress device ("Cypress Semiconductor Corp. FX3") is visible.

Step 1: Identify Device in DFU Mode

Run the following command:

lsusb

• Example Output:

Bus 001 Device 007: ID 04b4:00f3 Cypress Semiconductor Corp. FX3 micro-controller (DFU mode)

Step 2: Burn CyBootProgrammer.img to RAM

vizion-ctl --fw-update 2 /opt/vizionviewer/driver/CyBootProgrammer.img --mode ram

• Output:

[WARNING] Please do not turn off the power or disconnect the camera during the update process.
Success: UVC firmware update completed successfully. Please restart the camera.

Step 3: Verify Device Mode

Run lsusb again:

• Expected Output:

Bus 002 Device 011: ID 04b4:4720 Cypress Semiconductor Corp. FX3

Step 4: Perform UVC Firmware Update

vizion-ctl --fw-update 2 VCI_UVC_24.10.00.01.img

• Output:

[WARNING] Please do not turn off the power or disconnect the camera during the update process.
Info: Found FX3 flash programmer
Info: Erased sector 0 of SPI flash
Info: Erased sector 1 of SPI flash
Info: Erased sector 2 of SPI flash
Info: Erased sector 3 of SPI flash
Info: SPI flash programming completed
Success: UVC firmware update completed successfully. Please restart the camera.