OpenIPC Wiki

Table of Content

Upgrading firmware

Upgrading from GitHub

For old firmware running sysupgrade without parameters is enough. For newer firmware, run sysupgrade -k -r to update both kernel and rootfs.

ATTENTION! Upgrading firmware can lead to "bricking" your camera. Make sure you are prepared both morally and skillwise. Have your rescue SD card and/or UART adapter ready. Be prepared to desolder and reprogram flash chip as the last resort. Do not upgrade production cameras unless you really have to!

Upgrading from a TFTP server

Go to https://github.com/OpenIPC/firmware/releases/tag/latest and download the latest firmware bundle for your SoC. Extract content of the bundle into the root directory of your TFTP server.

On the camera run:

soc=$(fw_printenv -n soc)
serverip=$(fw_printenv -n serverip)
busybox tftp -r rootfs.squashfs.${soc} -g ${serverip}
busybox tftp -r uImage.${soc} -g ${serverip}

Upgrading from local files

Go to https://github.com/OpenIPC/firmware/releases/tag/latest and download the latest firmware bundle for your SoC. Unpack the bundle and upload its content on camera using scp:

tar xvf <firmware.tgz>
scp uImage* rootfs* root@<yourcameraip>:/tmp/

On the camera run:

soc=$(fw_printenv -n soc)
sysupgrade --kernel=/tmp/uImage.${soc} --rootfs=/tmp/rootfs.squashfs.${soc} -z

Upgrading from SD card

Go to https://github.com/OpenIPC/firmware/releases/tag/latest and download the latest firmware bundle for your SoC. Insert an SD card into your desktop PC. Unpack the bundle and copy its content to the card:

tar xvf <firmware.tgz>
cp uImage* rootfs* /media/<username>/<card-id>/

Insert the SD card into your camera. On the camera run:

soc=$(fw_printenv -n soc)
sysupgrade --kernel=/mnt/mmcblk0p1/uImage.${soc} --rootfs=/mnt/mmcblk0p1/rootfs.squashfs.${soc} --force_ver -z

Troubleshooting

If you got this error:

losetup: /tmp/rootfs.squashfs.${soc}: No such file or directory
Rootfs: Unable to get hostname, execution was interrupted...

then try to update only kernel first: sysupgrade -k

If it doesn't help, use --force option: sysupgrade -r --force

If you caught a glitch, retrieve the most recent version of the utility:

curl -k -L -o /usr/sbin/sysupgrade "https://raw.githubusercontent.com/OpenIPC/firmware/master/general/overlay/usr/sbin/sysupgrade"

2.4 KiB Raw Blame History