FIRMWARE

 

Description

Upload the firmware image file to the device's flash.
In PlatformW and PlatformA devices, the MD5 file is needed for file integrity check. Therefore, there are two image files will be uploaded in this URL. One is the firmware image and the other one is MD5 file.
In PlatformT and PlatformK devices, they don't use MD5 to check the file integrity. Only the firmware image file will be uploaded in this URL.

The configuration will be saved to the device flash when the firmware upgrade is completed. When everything is done, firmware sends the return code back to remote host. The device will be rebooted automatically, then.

In multiple channel video server, this URL command is used for upgrading router firmware image. To upgrade the channel module firmware, the URL FIRMWARE_ALL is used.

Note:

The firmware might not cover some device models (hardware) because the development stages of them are different. The old firmware might not support new device models. The new device might unstable or out of order when old firmware was saved to them. However, it increases firmware complexity and firmware maintenance cost if we need to block uploading old firmware to new device models. We expected users should consult technical support people before they downgrade device firmware.
We do not cover the backward compatibility of device models in firmware design.

The format of this URL http://172.16.3.14/cgi-bin/update?USER=Admin&PWD=123456&FIRMWARE is used an an example of this URL.

Stage 1: Send this URL to the device for firmware image file upload

GET /cgi-bin/update?USER=admin&PWD=123456&FIRMWARE HTTP/1.1
Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/x-shockwave-flash, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, */*
Accept-Language: zh-tw
Accept-Encoding: gzip, deflate
User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)
Host: 172.16.3.14
Connection: Keep-Alive

Stage 2 : Device reply the URL

HTTP/1.0 200 OK
Content-type: text/html

<html><head><title>UPLOAD FILES</title></head>
<meta http-equiv="PRAGMA" content="NO-CACHE"><body>
<form name="UPLOAD_FORM" method="POST" enctype="multipart/form-data" action="update?FIRMWARE_SAVE">
FIRMWARE : <input type="FILE" name="URL_FIRMWARE_IMAGE" value="" size="40">
<br>
MD5 : <input type="FILE" name="URL_FIRMWARE_MD5" value="" size="40">
<br>
<input type="submit" value="Apply" name="URL_FIRMWARE_SUBMIT">
<input type="reset" value="Reset" name="URL_FIRMWARE_RESET">
<br>
</form></body></html>

Stage 3: Upload the image file to device and get the return code

POST /cgi-bin/update?FIRMWARE_SAVE HTTP/1.1
Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/x-shockwave-flash, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, */*
Referer: http://172.16.3.14/cgi-bin/update?USER=admin&PWD=123456&FIRMWARE
Accept-Language: zh-tw
Content-Type: multipart/form-data; boundary=---------------------------7d834b76e0708
Accept-Encoding: gzip, deflate
User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)
Host: 172.16.3.14
Content-Length: 2503864
Connection: Keep-Alive
Cache-Control: no-cache

-----------------------------7d834b76e0708
Content-Disposition: form-data; name="URL_FIRMWARE_IMAGE"; filename="C:\Documents and Settings\MingYoung.You\My Documents\LinuxShare\AEC1100\release\220-V3.09.01\A1D-220-V3.09.01-AC.upg"
Content-Type: application/x-gzip-compressed

......................................

-----------------------------7d834b76e0708
Content-Disposition: form-data; name="URL_FIRMWARE_MD5"; filename=" C:\Documents and Settings\MingYoung.You\My Documents\LinuxShare\AEC1100\release\220-V3.09.01\A1D-220-V3.09.01-AC.md5"
Content-Type: application/octet-stream

IMG_MD5='15ff269d2b8735e31f62b4bdbea097ba'


-----------------------------7d834b76e0708
Content-Disposition: form-data; name="URL_FIRMWARE_SUBMIT"

Apply
-----------------------------7d834b76e0708--

Stage 4: device reply this URL

HTTP/1.0 200 OK
Content-type: text/plain
Content-Length: 3

OK

Input Argument

None

Attribute

Return of Message

OK
or
ERROR: description of error

Applicability

Status

Valid

See Also

FIRMWARE_ALL

Example

http://ip:port/cgi-bin/update?USER=Admin&PWD=123456&FIRMWARE

Back to

HOME, UPDATE CGI