Use digidevice.datapoint to upload custom datapoints to Digi Remote Manager

Use the datapoint Python module to upload custom datapoints to Digi Remote Manager.

The following characteristics can be defined for a datapoint:

• Stream ID
• Value
• (Optional) Data type
• integer
• long
• float
• double
• string
• binary
• Units (optional)
• Timestamp (optional)
• Location (optional)
• Tuple of latitude, longitude and altitude
• Description (optional)
• Quality (optional)
• An integer describing the quality of the data point

For example, to use an interactive Python session to upload datapoints related to velocity, temperature, and the state of the emergency door:

1. Select a device in Remote Manager that is configured to allow shell access to the admin user, and click Actions > Open Console. Alternatively, log into the LR54 local command line as a user with shell access.

   Depending on your device configuration, you may be presented with an Access selection menu. Type shell to access the device shell.

2. At the shell prompt, use the python command with no parameters to enter an interactive Python session:

   # python
   Python 3.10.1 (main, Mar 30 2023, 23:47:13) [GCC 11.2.0] on linux
   Type "help", "copyright", "credits" or "license" for more information.
   >>>
   

3. Import the datapoint submodule and other necessary modules:

   >>> from digidevice import datapoint
   >>> import time
   >>>

4. Upload the datapoints to Remote Manager:

   >>> datapoint.upload("Velocity", 69, units="mph")
   >>> datapoint.upload("Temperature", 24, geo_location=(54.409469, -1.718836, 129))
   >>> datapoint.upload("Emergency_Door", "closed", timestamp=time.time())

5. Use Ctrl-D to exit the Python session. You can also exit the session using exit() or quit().

You can also upload multiple datapoints:

1. Select a device in Remote Manager that is configured to allow shell access to the admin user, and click Actions > Open Console. Alternatively, log into the LR54 local command line as a user with shell access.

   Depending on your device configuration, you may be presented with an Access selection menu. Type shell to access the device shell.

2. At the shell prompt, use the python command with no parameters to enter an interactive Python session:

   # python
   Python 3.10.1 (main, Mar 30 2023, 23:47:13) [GCC 11.2.0] on linux
   Type "help", "copyright", "credits" or "license" for more information.
   >>>
   

3. Import the datapoint submodule and other necessary modules:

   >>> from digidevice import datapoint
   >>> import time
   >>>

4. Create datapoint objects:

>>> p1 = datapoint.DataPoint("Velocity", 69, units="mph")
>>> p2 = datapoint.DataPoint("Temperature", 24, geo_location=(54.409469, -1.718836, 129))
>>> p3 = datapoint.DataPoint("Emergency_Door", "closed", timestamp=time.time())
>>>

5. Upload the datapoints to Remote Manager:

   >>> datapoint.upload_multiple([p1, p2, p3])
   >>>

6. Use Ctrl-D to exit the Python session. You can also exit the session using exit() or quit().

Once the datapoints have been uploaded to Remote Manager, they can be viewed via Remote Manager or accessed using Web Services calls. See the Digi Remote Manager Programmers Guide for more information on web services and datapoints.