Skip to content

Device Authorization Commands

Device Authorization Command Overview

AT CommandDescription
AT+QIOTBINDCODEReport Device Binding Information
AT+QIOTRSTReset Device Information

AT Command Description

AT+QIOTBINDCODE (Report Device Binding Information)

  • Description: This command reports device binding information.
  • Maximum Response Time: 300 ms.

Test Command

  • Issue

    c
    AT+QIOTBINDCODE=?
  • Response

    Return the supported parameter range.

    c
    +QIOTBINDCODE: <timeout>,<bindcode>
    
    OK

Read Command

  • Issue

    c
    AT+QIOTBINDCODE?
  • Response

    Return the current setting

    c
    +QIOTBINDCODE: <timeout>,<bindCode>
    
    OK

Write Command

  • Issue

    c
    AT+QIOTBINDCODE=<timeout>[,<bindCode>]
  • Response

    If the command is executed successfully:

    c
    OK

    If there is any error:

    c
    ERROR

Parameter

  • <timeout> Integer type. Allowable binding time. Range: 0-3600. Unit: second. When this parameter is 0, it indicates the binding is canceled.
  • <bindCode> String type. String type. Bind code of the device. The length is fixed to 16 bytes. Range: 0–9, A–F.When it is NULL, the bind code will be generated randomly.

NOTE

  • This command is supported in SDK version 2.10.3 and above.

Example

Example 1 (Query the allowed binding time and bind code)

c
[TX]AT+QIOTBINDCODE?

[RX]+QIOTBINDCODE:  105,"7F369C6E6CE6BC9C"

[RX]OK

Note: If you send the Read Command when the device is in the unbound state, an ERROR will be returned.

Example 2 (Set the allowable binding time)

c
[TX]AT+QIOTBINDCODE=120

[RX]OK

Example 3 (Disable the allowable binding time and set the bind code value)

c
[TX]AT+QIOTBINDCODE=0,"0123456789ABCDEF"

[RX]OK

AT+QIOTRST (Reset Device Information)

  • Description: This command resets device information, including DeviceSecret and device bind code.
  • Maximum Response Time: 300 ms.

Test Command

  • Issue

    c
    AT+QIOTRST=?
  • Response

    Return whether the command is valid.

    c
    OK

Execution Command

  • Issue

    c
    AT+QIOTRST
  • Response

    If the command is executed successfully:

    c
    OK

    If there is any error:

    c
    ERROR

NOTE

  • This command is supported in SDK version 2.10.0 and above.

Example

Example 1 (Reset DeviceSecret and device bind code)

c
[TX]AT+QIOTRST

[RX]OK