Encedo HEM API Developer Manual
  • Welcome!
  • Preliminary
    • Quick Start
    • General information
  • Security
    • Report an issue
    • Advisory
      • Hall of fame
  • Reference
    • API Reference
      • System
        • Version & Status
        • Checkin
        • Configuration
        • Upgrade
          • Firmware
            • Low level USB mode
          • Management app
        • Self-test
        • Reboot
        • Shutdown
      • Authorization
        • Initialization
        • User authentication
        • External authenticator
          • Registration
          • Authentication
      • Key Management
        • Create a key
        • Derive a key
        • Import a key
        • Update a key
        • Delete a key
        • Get a public key
        • List the keys
        • Search a key
      • Cryptography operations
        • HMAC
        • ExDSA
        • ECDH
        • Encryption
          • Encryption/Decryption
          • Wrap/Unwrap
      • Audit log
      • Storage
Powered by GitBook
On this page
  1. Reference
  2. API Reference
  3. System
  4. Upgrade
  5. Firmware

Low level USB mode

Allowed users

Allowed

Allowed

Allowed

Required access scope

system:upgrade

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

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

PreviousFirmwareNextManagement app

Last updated 3 years ago