SATUPGRADE SUP UG
Gets or sets tuner capabilities. On get, the returned value is a number which
represents the current capabilities of the tuner.
Form:
Command Handler: SYSD
SATUPGRADE|SUP|UG [[Key String] | [FIRMWARE [BEGIN]] | [RESET [VAL]] | [DEFAULT] | [LIST] [ECRESET 0 | 1]]
[Key String] is the key issued for upgrading the device.
BOARD_ID is a returned value that will either be NTC7044,
ADT7201 (which is sometimes referred to as PC72xx in other commands),
or TCAST DTMA2910.
If BOARD_ID is NTC7044 then BOARD_SERIAL and BOARD_LICENSE will also
be displayed. These return numeric values.
FIRMWARE will return the status of a firmware upgrade if one is in progress.
BEGIN will automatically select the firmware and start the upgrade process.
RESET will reset the device.
DEFAULT will restore factory settings to the device. (TCAST only)
LIST will display the existing firmware available for upgrade.
ECRESET will reset the error counters. (TCAST only)
Response:
SATUPGRADE RESPONSE
Verbose- "OK\r\n" to acknowledge receipt of command, or
"ERROR- [Description]\r\n" if error, ending command
Terse- "0\r\n" to acknowledge receipt of command, or
"[NON-ZERO NUMERIC VALUE]\r\n" if error, ending command
"\r\n" concludes modify responses (empty line)
Examples:
To get the current device id, serial and capabilities:
*.SYSD SUP
OK
BOARD_ID=NTC/7044/BB DVB Demodulator
BOARD_SERIAL=30079083
BOARD_LICENSE=165
BOARD_SW_VER=2.10
Command issued to the ADT7201 board
*.SYSD SUP
OK
BOARD_ID=ADT7201
Checking firmware status when no update is in progress will return an error:
*.SYSD SUP FIRMWARE
ERROR-Firmware update not in progress
If trying to begin a firmware upgrade without first uploading a Newtec firmware
file you will get a "No file" error message:
*.SYSD SUP FIRMWARE BEGIN
ERROR-No file
If a firmware file was found, it will be automatically selected and OK is returned:
*.SYSD SUP FIRMWARE BEGIN
OK
If trying to begin a firmware upgrade while it is already running:
*.SYSD SUP FIRMWARE BEGIN
ERROR-Firmware update already in progress
Once a firmware upgrade is in progress, you can view the status.
*.SYSD SUP FIRMWARE
OK
START_TIME=Thu Apr 16 10:06:51 2012
ESTIMATED_END_TIME=Thu Apr 16 10:31:27 2012
ESTIMATED_TIME_REMAINING(s)=1476
COMPLETED=3356
TOTAL=31354
PERCENT_COMPLETE=10.7036
Factory reset ADV/PRM demod
*.SYSD SUP RESET 2
OK
Terse FIRMWARE progress will show the start/end times as the number of seconds
since the Epoch (1970-01-01 00:00:00 +0000 (UTC)).
*.SYSD UG FIRMWARE
0
1334585211 1334586874 1663 1575 31354 5.02328
To list the existing firmware available for upgrade:
*.SYSD SUP LIST
OK
FILE_COUNT=2
FILE[0]=teamcast-v1.fir.tgz
FILE[1]=teamcast-v2.fir.tgz
Notes:
This command only shows the BOARD_SERIAL and BOARD_LICENSE fields for the NTC7044 board.
SUP FIRMWARE BEGIN will automatically locate the firmware if an appropriate file
has been uploaded to the unit in /media/hd0/media. The expected file extension
are ".ntc.tgz" for Newtec and ".fir.tgz" for Teamcast.
If a firmware upgrade starts but does not run to completion (either due to power
loss or resetting the unit) then the device will not function until an upgrade
is allowed to run to completion.
If a firmware upgrade fails and the logs show the following message:
[DEV_UPDT]: 250000 Failed ftp command: OPEN_FAILED
then that means a previous upgrade was not allowed to run to completion due to a
soft reset. The application should reset the device when it encounters this which
will prevent this error from happening if you try the command again.
SUP FIRMWARE will show 100% complete for a short while as the board is resetting.
The ESTIMATED_* values are wildly inaccurate at first.