Microtronics myDatalogEASY IoTmini, Руководство пользователя, Страница: 33 / 210

Chapter 5 Functional principle
The "rM2M_RegGetString()", "rM2M_RegGetValue()", "rM2M_RegSetString()", "rM2M_RegSetValue()",
"rM2M_RegDelValue()" and "rM2M_RegDelKey()" functions are available for accessing the registration
memory blocks.
5.5.1 REG_SYS_FLASH
If the site that is linked to the device was created from an application template (see myDatanet Server Manual
805002), the registration memory block contains the following fields:
latestAppVersion
The latest available version of the application template installed on the device [16-bit unsigned]
installedAppVersion
Version of the application template currently installed on the device [16-bit unsigned]
appId
Application ID of the application installed on the device [max. 50 characters]
5.5.2 REG_APP_OTP
By saving the "Product Identity Profile" (PIP) in this registration memory block, the functions described in the
following can be initiated on the myDatanet server. The PIP consists of the following fields:
pipCustomer
Name of the customer to whom the site should be assigned [2-50 characters].
pipCtx
Name of the site that should be created/used [2-50 characters].
pipAppId
Application ID of the application template from which the site should be created [max. 50 characters].
pipAppVer (optional)
Version of the Device Logic currently installed on the device (e.g. "01v005") [6 characters].
pipCtxAutocreate (optional)
Indicates whether the site (if it does not exist yet) should be created ("0" or "1" must be saved as the
string)
l
"0": creation of a new site is not permissible
l
"1": new site can be created (default)
If the myDatanet server receives a PIP, the two basic scenarios are differentiated:
l
There is no site with the name specified in the "pipCtx" field:
The new site is only created if the customer and application template were found on the myDatanet
server and "pipCtxAutocreate=1" or the field is missing.
l
A site with the name specified in the "pipCtx" field was found on the server:
In this case, the "pipCtxAutocreate" and "pipCustomer" fields are not relevant. The device is assigned
to the site, even if it is located within a different customer, if the application ID in the "pipAppId" field and
that of the found site match. The device is moved to the relevant customer for this purpose. The
allocation of the existing device is deallocated if a device is already assigned to the site. The existing
device is moved to the customer's pool.
Rev. 01 33