USB Autorun

This feature can be used to automatically launch a shell script or perform a software/config update as soon as an USB storage stick has been plugged in. For authentication, a file called autorun.key must exist in the root directory of a FAT16/32 formatted stick. It can be downloaded from that page and holds the SHA256 hash key of the admin password. The file can hold multiple hashes which will be processed line-by-line during authentication which can be used for setting up more systems with different admin passwords. For new devices with an empty password the hash key e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 can be used. The hash keys can be generated by running the command echo -n “<admin-password>” | sha256sum on a Linux system or an Internet hash key generator (search for “sha-256 hash calculator”). Once authentication has succeeded, the system scans for other files in the root directory which can perform the following actions:

  1. For a configuration update: cfg-<SERIALNO>.zip (e.g. cfg-00112B000815.zip), or if not available cfg.zip
  2. For a software update: sw-update.img
  3. For running a script: autorun.sh

Example autorun.key

autorun.key
# corresponds to password in factory defaults
# as of release 3.8 the password in factory default is an empty string hence the hash is ''echo -n "" | sha256sum''
d6414f06abe9d25df078def16971fc48a0c18fb5da799c141cc8c555683467a7
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

Procedure

The autorun feature need to be enabled. This is case case either in the factory state or when you have it enabled on purpose in the Config.

  1. Please do not plug in the USB Stick before the System is bootet completly (Status LED need to light steady green).
  2. After that pluging the USB Stick.
  3. If the Autorun was triggert correctly all LEDs need to flash GREEN at the same time

Function is not always enabled

Please keep in mind that the usb autorun function is not always enabled:

  1. It's enabled in Factory State until you define your admin password
  2. After that you need to enable it either via Webinterface or config parameter: autorun.status=1

Useful USB autorun