Description
This LwM2M Objects provides the data related to a LwM2M Server. A Bootstrap-Server has no such an Object Instance associated to it.
Object definition
| Name | Object ID | Object Version | LWM2M Version |
| LwM2M Server | 1 | 1.2 | 1.2 |
| Object URN | Instances | Mandatory | |
| urn:oma:lwm2m:oma:1:1.2 | Multiple | Mandatory | |
Resource definitions
| ID | Name | Operations | Instances | Mandatory | Type | Range or Enumeration | Units | Description |
|---|---|---|---|---|---|---|---|---|
| 0 | Short Server ID | R | Single | Mandatory | Integer | 1..65534 | Used as link to associate server Object Instance. | |
| 1 | Lifetime | RW | Single | Mandatory | Unsigned Integer | s | Specify the lifetime of the registration in seconds (see Client Registration Interface). If the value is set to 0, the lifetime is infinite. | |
| 2 | Default Minimum Period | RW | Single | Optional | Integer | s | The default value the LwM2M Client should use for the Minimum Period of an Observation in the absence of this parameter being included in an Observation. If this Resource doesn’t exist, the default value is 0. | |
| 3 | Default Maximum Period | RW | Single | Optional | Integer | s | The default value the LwM2M Client should use for the Maximum Period of an Observation in the absence of this parameter being included in an Observation. | |
| 4 | Disable | E | Single | Optional | If this Resource is executed, this LwM2M Server Object is disabled for a certain period defined in the Disabled Timeout Resource. After receiving “Execute” operation, LwM2M Client MUST send response of the operation and perform de-registration process, and underlying network connection between the Client and Server MUST be disconnected to disable the LwM2M Server account. After the above process, the LwM2M Client MUST NOT send any message to the Server and ignore all the messages from the LwM2M Server for the period. | |||
| 5 | Disable Timeout | RW | Single | Optional | Integer | s | A period to disable the Server. After this period, the LwM2M Client MUST perform registration process to the Server. If this Resource is not set, a default timeout value is 86400 (1 day). | |
| 6 | Notification Storing When Disabled or Offline | RW | Single | Mandatory | Boolean | If true, the LwM2M Client stores “Notify” operations to the LwM2M Server while the LwM2M Server account is disabled or the LwM2M Client is offline. After the LwM2M Server account is enabled or the LwM2M Client is online, the LwM2M Client reports the stored “Notify” operations to the Server. If false, the LwM2M Client discards all the “Notify” operations or temporarily disables the Observe function while the LwM2M Server is disabled or the LwM2M Client is offline. The default value is true. The maximum number of storing Notifications per Server is up to the implementation. | ||
| 7 | Binding | RW | Single | Mandatory | String | The possible values are those listed in the LwM2M Core Specification | This Resource defines the transport binding configured for the LwM2M Client. If the LwM2M Client supports the binding specified in this Resource, the LwM2M Client MUST use that transport for the Current Binding Mode. | |
| 8 | Registration Update Trigger | E | Single | Mandatory | If this Resource is executed the LwM2M Client MUST perform an “Update” operation with this LwM2M Server. The LwM2M Client can use a transport binding supported in the Current Binding Mode, Preferred Transport resource or the transport specified as an argument in the Registration Update Trigger. | |||
| 9 | Bootstrap-Request Trigger | E | Single | Optional | When this Resource is executed the LwM2M Client MUST initiate a "Client Initiated Bootstrap" procedure in using the LwM2M Bootstrap-Server Account. | |||
| 10 | APN Link | RW | Single | Optional | Objlnk | If this resource is defined, it provides a link to the APN connection profile Object Instance (OMNA registered Object ID:11) to be used to communicate with this server. | ||
| 11 | TLS-DTLS Alert Code | R | Single | Optional | Unsigned Integer | 0..255 | If this resource is defined, it contains the most recent TLS / DTLS alert message received from the LwM2M Server respective represented by the AlertDescription defined in Section 7.2 of RFC 5246. This resource set by the LwM2M Client may help the LwM2M Bootstrap-Server to determine the cause of TLS/DTLS connection failure with the respective LwM2M Server. | |
| 12 | Last Bootstrapped | R | Single | Optional | Time | If this resource is defined, it represents the last time that the bootstrap server updated this LwM2M Server Account. The LwM2M Client is responsible for updating this value. When the Bootstrap Server detects that this LwM2M Server Account is "out-of-date", the Bootstrap Server can update the LwM2M Server Account as represented by the LwM2M Server object instance. | ||
| 13 | Registration Priority Order | R | Single | Optional | Unsigned Integer | The LwM2M Client sequences the LwM2M Server registrations in increasing order of this value. If this value is not defined, registration attempts to this server are not impacted by other server registrations. | ||
| 14 | Initial Registration Delay Timer | RW | Single | Optional | Unsigned Integer | s | The delay, in seconds, before registration is attempted for this LwM2M Server based upon the completion of registration of the previous LwM2M Server in the registration order. This is only applied until the first successful registration after a successful bootstrapping sequence. | |
| 15 | Registration Failure Block | R | Single | Optional | Boolean | When set to true and registration to this LwM2M server fails, the LwM2M Client blocks registration to other servers in the order. When set to false, the LwM2M Client proceeds with registration to the next server in the order. | ||
| 16 | Bootstrap on Registration Failure | R | Single | Optional | Boolean | If set to true, this indicates that the LwM2M Client should re-bootstrap when either registration is explicitly rejected by the LwM2M Server or registration is considered as failing as dictated by the other resource settings. If set to false, the LwM2M Client will continue with the registration attempts as dictated by the other resource settings. | ||
| 17 | Communication Retry Count | RW | Single | Optional | Unsigned Integer | The number of successive communication attempts before which a communication sequence is considered as failed. | ||
| 18 | Communication Retry Timer | RW | Single | Optional | Unsigned Integer | s | The delay, in seconds, between successive communication attempts in a communication sequence. This value is multiplied by two to the power of the communication retry attempt minus one (2**(retry attempt-1)) to create an exponential back-off. | |
| 19 | Communication Sequence Delay Timer | RW | Single | Optional | Unsigned Integer | s | The delay, in seconds, between successive communication sequences. A communication sequence is defined as the exhaustion of the Communication Retry Count and Communication Retry Timer values. A communication sequence can be applied to server registrations or bootstrapping attempts. MAX_VALUE means do not perform another communication sequence. | |
| 20 | Communication Sequence Retry Count | RW | Single | Optional | Unsigned Integer | The number of successive communication sequences before which a registration attempt is considered as failed. | ||
| 21 | Trigger | RW | Single | Optional | Boolean | Using the Trigger Resource a LwM2M Client can indicate whether it is reachable over SMS (value set to 'true') or not (value set to 'false'). The default value (resource not present) is 'false'. When set to 'true' the LwM2M Server MAY, for example, request the LwM2M Client to perform operations, such as the "Update" operation by sending an "Execute" operation on "Registration Update Trigger" Resource via SMS. No SMS response is expected for such a message. | ||
| 22 | Preferred Transport | RW | Single | Optional | String | The possible values are those listed in the LwM2M Core Specification | Only a single transport binding SHALL be present. When the LwM2M client supports multiple transports, it MAY use this transport to initiate a connection. This resource can also be used to switch between multiple transports e.g. a non-IP device can switch to UDP transport to perform firmware updates. | |
| 23 | Mute Send | RW | Single | Optional | Boolean | If true or the Resource is not present, the LwM2M Client Send command capability is de-activated. If false, the LwM2M Client Send Command capability is activated. | ||
| 24 | Alternate APN Links | RW | Multiple | Optional | Objlnk | If this resource is defined, it provides links to alternate APN connection profile Object Instance (OMNA registered Object ID:11) to be used to communicate with this server if Resource 10 has configuration conflicts. | ||
| 25 | Supported Server Versions | RW | Multiple | Optional | String | This resource provides the supported enabler versions of the server to the client as a set of strings. Format for each string is 1*DIGIT"."1*DIGIT"."1*DIGIT where the third DIGIT is optional. |