Low level USB mode

Allowed users

User

Allowed

Master

Allowed

ExtAuth

Allowed

Required access scope

Main

system:upgrade

Second Tab

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.

Activate USB ACM programming

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

Switch (reboot) the device into the bootloader into USB CDC-ACM mode to allow the upload of the Intel HEX firmware image.

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 Operation failed

Log entries

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