Sending UDP Messages between 1NCE OS and Datacake

Introduction

Welcome to the documentation about the 1NCE OS. In this document, we will show the steps that need to be taken on the 1NCE OS management platform to set up SIM cards and IoT devices that contain a 1NCE OS SIM card to send UDP messages. These messages are forwarded to Datacake.

Overview of 1NCE OS and Datacake

1NCE OS offers a variety of server options, including a UDP server, CoAP server, and lightweight M2M. In this documentation, we will focus on the UDP option, as it is the easiest to set up and allows efficient use of data volume in conjunction with the SIM card. The 1NCE OS platform automatically forwards the received UDP data to Datacake via HTTPS. This allows users to manage devices on the Datacake platform and send downlinks back to the devices.

Setting up UDP messages in 1NCE OS

To set up the 1NCE OS SIM cards to send UDP messages, they must be configured on the 1NCE OS management platform. This is described in detail below.

Using the 1NCE OS Management Platform

Overview and Statistics

After logging in to the 1NCE OS Management Platform, you will see a menu item “1NCE OS” at the top of the menu bar. Clicking on it will take you to the overview page, which provides information about activated devices, cloud integrations and other statistics.

Navigating to the Device Integrator Function

On the left side of the platform, there is a sidebar with various menu items. Under the category “IoT Integrator”, you will find the item “Device Integrator”. This is the area where the integrations for devices can be activated.

Activating the UDP integration

Selecting the transport protocol

In the “Device Integrator” area, there is a button called “New Integration”.

Clicking on it opens a new window with the option “Choose Transport Protocol”. Here you select the UDP protocol, since we are focusing on UDP integration.

Configuring the server address

In the same window, you will see the server address under “Connection Information”.

This address must be entered on the device in order to send UDP messages to the 1NCE OS platform. If necessary, the address can also be converted into an IP address.

• Address: udp://udp.os.1nce.com:4445

• IP-Address: 10.60.2.239

• Port: 4445

Please check if IP-Address is the same in your area by running a ping action on the server address udp://udp.os.1nce.com:4445

Completing the integration

After selecting UDP and entering the server address, click on “Use this Protocol” to complete the setup. The UDP integration now appears in the integration list on the platform.

Testing and monitoring the UDP integration

You can test the UDP integration in the integration list. By clicking on “test”, you can simulate messages and track which messages are received in a debug log.

Adding and managing SIM cards and devices

Using the Device Controller and Device Inspector

Other important functions on the 1NCE OS Management platform are the “Device Controller” and “Device Inspector”. These enable the management and monitoring of all SIM cards.

Automatic device list and monitoring

As soon as a SIM card is used in a device and the device is programmed to send UDP messages to the configured address, the device is automatically listed on the 1NCE OS platform. The identification is done via the SIM card number.

Security and encryption

Communication via 1NCE OS is automatically encrypted, which means that unencrypted UDP connections can be used securely. The data is sent directly to the endpoints via the SIM card in encrypted form.

Setting up forwarding to Datacake

Using the Datacake plugin

The 1NCE OS management platform has a Datacake plugin, which can be found in the left sidebar under “Plugins”. Clicking on the plugin opens the configuration options.

Configuring the plugin with workspace ID

To configure the Datacake plugin, you only need to enter a workspace ID, which can be obtained from the Datacake account. Detailed instructions can be found in the 1NCE OS documentation.

1NCE OS

Adding devices to the Datacake workspace

After entering the workspace ID, the plugin automatically sends all received UDP messages to the Datacake workspace. You can then add and configure new devices on the Datacake platform.

Conclusion

The 1NCE OS platform provides a simple and efficient way to connect and manage IoT devices with Datacake. Using UDP and automatic forwarding to Datacake simplifies setup and ensures security. Thank you for using the 1NCE OS documentation!