Introduction

All Keonn RFID readers/systems running AdvanNet include a SW Bootloader that can be

used to upgrade AdvanNet FW and also apply generic OS upgrades.

The Bootloader is accessed at port 8080 of the device.

The Bootloader may work using HTTP (default) or HTTPS, depending on the configuration.

Bootloader upgrades need to be digitally signed by Keonn.

Not signed Upgrades will fail to be installed/applied.

Available operations

Update Advannet

This operation installs the provided AdvanNet version.

Request

This is a POST multipart/form-data request with the following parts

• URL: http://$device-ip:8080/formAction

• multipart/form-data

  • module: fixed value of app.AdvanNet

  • file: binary jar or zip file containing the signed AdvanNet upgrade

Response

From the HTTP response it is possible to know whether the upgrade has been applied successfully.

• HTTP status code:

  • 200: the upgrade has been applied successfully

  • 500: the upgrade failed to be applied

• (Bootloader version > 190318) Header X-Keonn-bootloader-msg: indicator of the error message. Only available if the HTTP status code is 500

CURL example

curl -F module=app.AdvanNet -F upload=@AdvanNet-upgrade-advannet-2.8.39__signed.zip http://192.168.2.92:8080/formAction

OS upgrade

This is the operation that applies a generic OS upgrade. An OS upgrade can be anything:

• OS package upgrade

• OS package downgrade

• OS package install

• Etc

Request

This is a POST multipart/form-data request with the following parts

• URL: http://$device-ip:8080/formAction

• multipart/form-data

  • module: fixed value of OS

  • file: binary jar or zip file containing the signed OS upgrade

Response

From the HTTP response it is possible to know whether the action has been successfully carried out.

• HTTP status code:

  • 200: the upgrade has been applied successfully

  • 500: the upgrade failed to be applied

• (Bootloader version > 190318) Header X-Keonn-bootloader-msg: indicator of the error message. Only available if the HTTP status code is 500

CURL example

curl -F module=OS -F upload=@installDbLibrariesMySQL8.zip http://192.168.2.92:8080/formAction

Clear

The Clear operation removes any AdvanNet upgrades installed. The factory version remains untouched.

Request

This is a regular POST request.

• URL: http://$device-ip:8080/clearAction?module=app.AdvanNet

• No payload

Response

From the HTTP response it is possible to know whether the action has been successfully carried out.

• HTTP status code:

  • 200: the clear has been executed successfully

  • 500: clear has failed

CURL example

curl -X POST -g "http://192.168.2.92:8080/clearAction?module=app.AdvanNet"

Reboot

The reboot operation is a soft reboot of AdvanNet.

Request

This is a regular POST request.

• URL: http://$device-ip:8080/rebootAction

• No payload

From the HTTP response it is possible to know whether the action has been successfully carried out.

• HTTP status code:

  • 200: reboot successfull

  • 500: reboot failed

CURL example

curl -X POST http://192.168.2.92:8080/rebootAction