Claim/Activate
Device Management Server (DMS)

DMS claiming and activation operations. More...

Functions

zos_result_t zn_dms_claim (const char *username, const char *password, zos_buffer_t *server_msg)
 Claim this device with your DMS username/password. More...
 
zos_result_t zn_dms_activate (const char *product_code, zos_buffer_t *server_msg)
 Activate this device with the specified product. More...
 

Detailed Description

DMS claiming and activation operations.

Function Documentation

zos_result_t zn_dms_activate ( const char *  product_code,
zos_buffer_t *  server_msg 
)

Activate this device with the specified product.

Once activated, device updates with get this product's firmware.

Before the device can activate to a product it needs to be 'claimed' with a user who has access to the product. See zn_dms_claim() for more information about 'claiming' the device.

See the ZentriOS command documentation for more information: dms

Note
The server_msg argument, a zos_buffer_t, should be pre-configured to point to a buffer that will be populated with a message from the server. The .data member should point to a string buffer. The size to be the size of the string buffer.
Parameters
product_codeProduct's code in DMS
[out]server_msgzos_buffer_t pointer to buffer to hold message from server, leave NULL if unused
Returns
Result of API, see zos_result_t
zos_result_t zn_dms_claim ( const char *  username,
const char *  password,
zos_buffer_t *  server_msg 
)

Claim this device with your DMS username/password.

This 'claims' this device with the given username in the DMS. Once 'claimed' the device has access to all products in the DMS to which the username has access.

Once the device is claimed, it should be activated with the desired product using zn_dms_activate(). Once activated, the device can update to the product's firmware.

See the ZentriOS command documentation for more information: dms

Note
The server_msg argument, a zos_buffer_t, should be pre-configured to point to a buffer that will be populated with a message from the server. The .data member should point to a string buffer. The size to be the size of the string buffer.
Parameters
[in]usernameYour DMS username
[in]passwordYour DMS password
[out]server_msgzos_buffer_t pointer to buffer to hold message from server, leave NULL if unused
Returns
Result of API, see zos_result_t