Documentation
TutorialsCommunity
  1. ALPON
  2. Tutorials

IoT Cube Gateway Connection Guide

Connect ALPON X5 AI or ALPON X4 to the IoT Cube platform as a secure gateway: install the gateway agent with the generated licensing command, verify the connection, add a Modbus field device, bind it to an application object, deploy the configuration, and confirm live data is flowing.

Connect ALPON to IoT Cube as a Gateway

Register your ALPON X5 AI or ALPON X4 on the IoT Cube platform as a secure gateway that collects field data over protocols such as Modbus, BACnet, and LoRaWAN and forwards it to IoT Cube. This guide installs the gateway agent, licenses the device, sets up a Modbus field device with an application binding, and verifies live data flow.

ALPON X5 AI ALPON X4 IoT Cube Modbus
ALPON · Tutorial · Integrations · IoT Cube
How do I connect ALPON to IoT Cube as a gateway?

Generate the installation command with your registrationCode in the IoT Cube interface and run it on the ALPON X5 AI or ALPON X4 over ALPON Cloud or SSH. The device requests a license, receives a serial number and label key, and switches to Connected in IoT Cube. Then add a field device (Modbus in this example), create an application binding with a real-time application object, click Deploy, and open the device graph to confirm live data is arriving.

Overview

IoT Cube is an IoT management platform that provides centralized device management, data visualization, and automation capabilities. Using IoT Cube, field devices can be connected via protocols such as Modbus, BACnet, LoRaWAN, and more. This guide walks through setting up an ALPON X5 AI or ALPON X4 as a secure and functional gateway that collects field data and transmits it to the IoT Cube system.

The steps below are identical on ALPON X4 and ALPON X5 AI. For details about the platform, visit the IoT Cube website.

Before you start
  • ALPON device: an ALPON X5 AI or ALPON X4 with a clean production image installed.
  • ALPON Cloud access: required to open a remote terminal on the device from ALPON Cloud — or use SSH instead.
  • IoT Cube account: access to the IoT Cube interface to generate the installation command and configure devices.
  1. 1

    Install the gateway agent

    Access your ALPON via ALPON Cloud or SSH. Then, on the IoT Cube interface, generate the installation command with the correct registrationCode. The screenshots below show how to obtain the required code.

    IoT Cube interface showing where to start adding a new gateway
    Start from the gateway section of the IoT Cube interface to add a new gateway.
    IoT Cube gateway registration dialog where the registration code is generated
    IoT Cube generates a registration code for the new gateway.
    IoT Cube showing the generated installation command containing the registration code
    The installation command with the registrationCode, ready to copy to the device.

    On your ALPON device, run the setup command automatically generated by the system to start the licensing process:

    bash · install the gateway agent 
    wget -qO- https://api-edge.iotcube.io/licensing/v1/enode?registrationCode=...
    Use the generated command

    The full command and the correct registrationCode are generated automatically by IoT Cube — copy it exactly as shown in the interface rather than typing the placeholder above.

    After running this command, the device requests a license from the system.

  2. 2

    License and serial number

    After successful licensing, the terminal prints the identity assigned to your gateway:

    Serial Number E00*****
    Label Key 95*********

    Keep this information stored securely.

    Terminal output on the ALPON device showing the serial number and label key after licensing
    Licensing output on the device with the serial number and label key.
  3. 3

    Verify gateway connection

    Once registered, the gateway status switches to Connected in IoT Cube.

    IoT Cube gateway list showing the ALPON gateway with Connected status
    The ALPON gateway listed as Connected in IoT Cube.
  4. 4

    Add a field device

    • Click the Add Field Device button.
    • Click the + icon in the top right to manually create a device template.
  5. 5

    Choose connection type

    IoT Cube connection type selection listing BACnet, Input/Output, KNX, LoRaWAN, Modbus, and REST API
    Connection type selection for the new field device.

    Select a protocol supported by the ALPON gateway, such as:

    • BACnet
    • Input/Output
    • KNX
    • LoRaWAN
    • Modbus (used in this example)
    • REST API
  6. 6

    Create a device template

    IoT Cube device template dialog with the Create from scratch option
    Choose Create from scratch to build a new device template.

    Click the Create from scratch option to build the template from the beginning.

  7. 7

    Configure communication settings

    Communication channel

    IoT Cube communication settings form with TCP selected as the communication channel
    Communication settings for the Modbus template with TCP as the channel.
    • Communication Channel: TCP
    • Fill in the fields as shown.
    • Click the Next button to proceed.

    Register definition

    IoT Cube register definition form with register type COIL, register address 1, and unit StateInteger
    Register definition for the example coil.
    Register Type COIL
    Register Address 1
    Unit StateInteger

    These fields may vary depending on your needs. After completing the settings, finish template creation with Next → Finish.

  8. 8

    Create application binding

    Go to the Application Binding tab and click the Create button.

    IoT Cube Application Binding tab with the Create button
    The Application Binding tab with the Create button.

    Select the Field Device you just created and proceed with Next.

    IoT Cube application binding wizard with the new field device selected and the Add New button
    Select the field device, then use Add New to create a binding template.

    Click the Add New button to create a new binding template.

  9. 9

    Configure binding & data mapping

    Fill in the form as shown below. Optionally, you can add a description and keywords.

    IoT Cube binding template form with name, description, and keyword fields
    The binding template form with the name and optional description and keywords.

    Click Next to continue.

    IoT Cube data mapping screen with the COIL_EXAMPLE field selected
    Select the COIL_EXAMPLE field created earlier.

    On the next screen, select the COIL_EXAMPLE field created earlier and click Next again.

  10. 10

    Create application object

    • Select COIL_EXAMPLE.
    • Click the + icon next to the 0 Application Objects section.
    IoT Cube binding screen with COIL_EXAMPLE selected
    COIL_EXAMPLE selected in the binding screen.
    IoT Cube binding screen with the plus icon next to 0 Application Objects
    The + icon next to 0 Application Objects.

    In the new screen:

    • Follow the path Real-Time Reading → Standard Real-Time → Real-Time.
    • Without changing anything, click Next → Save to continue.
    IoT Cube application object dialog with Real-Time Reading, Standard Real-Time, Real-Time selected
    The application object dialog with Real-Time Reading → Standard Real-Time → Real-Time selected.

    Once the form closes, complete the process with Next → Finish.

  11. 11

    Save binding settings

    • Select the Application Binding you created and proceed with Next.
    • Complete the process without changing the other tabs.
    IoT Cube wizard with the newly created application binding selected
    Select the application binding you created.
    IoT Cube wizard tab left at its default settings before proceeding
    Leave the remaining tabs unchanged and continue with Next.
    IoT Cube wizard showing a further tab with default settings
    Continue through the wizard without changing the defaults.
    IoT Cube wizard final screen confirming the saved binding settings
    The binding settings are saved on the final screen.
  12. 12

    Deploy configuration

    After all steps are completed, you need to Deploy the configuration to apply it to the device. Click the blue airplane icon in the top right corner.

    IoT Cube interface with the blue airplane Deploy icon in the top right corner
    The blue airplane icon in the top right starts the deployment.

    In the popup window, click the Deploy button again.

    IoT Cube deploy confirmation popup with the Deploy button
    Confirm the deployment in the popup window.
  13. 13

    Verify data flow

    After the deploy process is complete, check whether data is coming from the device:

    • Click the graph icon next to your device name.
    • Check if live data is flowing in.
    IoT Cube device list with the graph icon next to the device name
    The graph icon next to the device name opens the live data view.
    IoT Cube live data graph showing values arriving from the Modbus coil
    Live data from the field device arriving in IoT Cube.

    If data is visible, your setup is complete.

Ready when…
  • The licensing command printed a Serial Number and Label Key on the device.
  • The gateway shows as Connected in IoT Cube.
  • The configuration has been deployed and the graph icon next to the device shows live data flowing in.

Your ALPON is now successfully connected as an IoT Cube gateway. You can continue adding devices, configuring bindings, and visualizing real-time data.

Continue exploring

Related guides

Build on this workflow with deployment, fleet-management, and hardware guidance for the ALPON platform.

Workflow Deploy Applications on ALPON Push an ARM64 image, configure its runtime, and launch it from ALPON Cloud. Open guide Platform ALPON Cloud Manage devices, applications, connectivity, and remote operations from one workspace. Open guide Hardware Compare ALPON devices Compare ALPON X4 and ALPON X5 AI capabilities for your edge workload. Open guide

Updated 15 days ago

Did this page help you?