Firmware

These operations allow the device firmware to be upgraded by uploading a new firmware image over API. This includes integrity and signature validation allowing only a legitimate firmware to be install

Embedded Flash Drive is available on Encedo PPA only. On Encedo EPA those endpoints are not available, and response code 404 will be returned.

Allowed users

User

Allowed

Master

Allowed

ExtAuth

Allowed

Required access scope

Main

system:upgrade

Alternative

system:config

The Authorization header is not required on fresh, not personalized devices.

TLS connection is not required. It is a last resort way to upload fixes. Firmware is signed anyway, no worry about the integrity and genuine.

Upload the file

Upload a new firmware

POST https://my.ence.do/api/system/upgrade/upload_fw

Upload a new firmware image (firmware.bin) file.

Headers

Name	Type	Description
Authorization	String	Bearer JWT_TOKEN
Content-Type*	String	application/octet-stream
Content-Disposition*	String	attachment; filename="firmware.bin"
Expect*	String	100-continue

200: OK Operation sucessful

406: Not Acceptable Operation failed

401: Unauthorized Missing or invalid JWT_TOKEN

403: Forbidden Incorrect access scope

Log entries

Event	Result	Source
LOG_TYPE_FAILED_SCOPE_CHECK	LOG_RESULT_FAILED	403

Validate uploaded file

Check firmware

GET https://my.ence.do/api/system/upgrade/check_fw

Check if the new uploaded firmware file is valid.

Headers

Name	Type	Description
Authorization	String	Bearer JWT_TOKEN

200: OK Operation sucsessful

202: Accepted Process of validation ongoing

401: Unauthorized Missing or invalid JWT_TOKEN

403: Forbidden Incorrect access scope

201: Created Process of validation started

406: Not Acceptable Operation failed

Log entries

Event	Result	Source
LOG_TYPE_FAILED_SCOPE_CHECK	LOG_RESULT_FAILED	403

Install new firmware

Install firmware

GET https://my.ence.do/api/system/upgrade/install_fw

Install uploaded and validate firmware (checked) in bootloader mode (the device will reboot on 200).

Headers

Name	Type	Description
Authorization	String	Bearer JWT_TOKEN

200: OK Operation sucessful

401: Unauthorized Missing or invalid JWT_TOKEN

403: Forbidden Incorrect access scope

409: Conflict Incorrect internal state

406: Not Acceptable Operation failed

Log entries

Event	Result	Source
LOG_TYPE_FAILED_SCOPE_CHECK	LOG_RESULT_FAILED	403
LOG_TYPE_UPGRADE	LOG_RESULT_ERROR	406
LOG_TYPE_UPGRADE	LOG_RESULT_ERROR	409
LOG_TYPE_UPGRADE	LOG_RESULT_OK	200