Sending UDP Messages between 1NCE OS and Datacake
Last updated
Last updated
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.
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.
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.
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.
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.
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.
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
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.
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.
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.
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.
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.
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.
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.
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.
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!
