Integrate Gateways and Devices with the Platform

TABLE OF CONTENTS

• Description
• Requirement
• Configuration
  • Step 1: Request an Account
  • Step 2: First Login
  • Step 3: Connect the Gateway
    • a) Semtech Method
    • b) Basic Station Method
    • c) Script Installation Method
  • Step 4: Adding Sensor
  • Step 5: Configure Decoding

Description

OrbiWise is a company focused on IoT network infrastructure, with its core product being OrbiWAN, a highly scalable, flexible, and LoRaWAN-compliant network server platform. OrbiWAN supports both public and private LoRa network operations and provides full-process management from sensor connectivity and network management to data routing. The platform supports multi-tenancy, robust device lifecycle management, complete API integration, and can be deployed either on-premises or in the cloud. OrbiWise solutions are widely adopted in smart cities, industrial monitoring, agriculture, and utility projects around the world, offering high reliability, low power consumption, and excellent network visualization capabilities.

This guide explains how to connect a UG63 gateway and UG65 to the Orbiwise platform and view real-time sensor data from the gateway on the platform. In this example, the UC510 device is used as the sensor.

Note: The UC510 device is used for demonstration purposes only. Other sensor types are also supported. Please adapt the steps based on your actual devices.

Requirement

• Gateway model: UG63 (UG56, UG65, UG67, SG50 also supported)
• Sensor model: UC512-DI
• Frequency band used in this guide: EU868

• Gateway must be connected to the Internet

Configuration

Step 1: Request an Account

Visit the official website and fill out the required request form.The Orbiwise team will contact you and create a platform account based on your needs.

Step 2: First Login

In addition to the account and password, the Orbiwise team will typically provide a login URL. 

Use the provided trial account to log in via the login page as shown:

Step 3: Connect the Gateway

The platform supports three connection methods:

● Semtech UDP

● Basic Station

● Script Installation

Note:

● The first two methods support SG50, UG63, UG56, UG65, UG67

● The third method supports UG56, UG65, UG67 only

a) Semtech Method

Find the Semtech section as shown:

Choose the required gateway type and fill in 

● Gateway Name

● mac_address(based on EUI) 

Example:

If your EUI is 24E124FFFEF9A1E2, remove the middle FFFEF, giving 24E124F9A1E2. Insert a colon every two characters: 24:E1:24:F9:A1:E2.

Once complete, click Generate Gateway Configuration at the bottom of the page:

You will see a new section appear on the left:

Click Download to download the configuration file.

Open it with a text editor and locate the gateway_conf section near the bottom. Record the following:

● server_address

● gateway_ID

● serv_port_up

● serv_port_down

These values will be used in the gateway configuration.

Now begin configuring the gateway. 

Using UG63 as an example, navigate to the Packet Forward interface, select Type as Semtech, and fill in Gateway ID, Server Address, Port Up, Port Down as shown:

Refer to the following parameter mapping:

After configuration, click the Save & Apply button. 

Wait about 30 seconds and refresh the interface. If it shows a green Connected status, it means the gateway has successfully connected to the Orbiwise platform:

Configuration reference for UG56, UG65, UG67 is as follows:

Go back to the Orbiwise platform and refresh the page, you will see the gateway automatically come online:

This concludes the Semtech connection method. You can now proceed to the section on adding sensor examples to continue configuration.

b) Basic Station Method

Operate as shown in the image, and find the Basic Station add section:

Click and fill in the information as shown:

After completing the form, click the Generate gateway configuration button. 

The platform will automatically generate parameters and certificate content for Basic Station:

Record Server URI, Server Port, and download the three certificate files:

You will obtain the following three files. 

Rename the file extensions as needed according to the screenshot:

Now begin configuring the gateway. 

Using UG63 as an example, navigate to the Packet Forward interface, select Type as Basic Station, fill in the URI content, and import CA File (.trust), Client Certificate File (.crt), Client Key File (.key) as shown. 

Refer to the following parameter mapping:

After configuration, click the Save & Apply button. Wait about 30 seconds and refresh the interface. If it shows a green Connected status, it means the gateway has successfully connected to the Orbiwise platform:

Configuration reference for UG56, UG65, UG67 is as follows:

Go back to the Orbiwise platform and refresh the page, you will see the gateway automatically come online:

This concludes the Basic Station connection method. You can now proceed to the section on adding sensor examples to continue configuration.

c) Script Installation Method

Next, I will use the UG65 device as an example for demonstration. 

Please follow the steps shown in the figure:

Fill in the Gateway Name as shown in the figure, then click the Generate gateway configuration button:

At this point, an installation script will pop up. 

Copy the content of this script:

Below is the sample script I used in this example:

cd /tmp/; curl -# -k https://34.250.112.11:50010/gwinstaller_aarch64 -o owinst && chmod +x owinst && ./owinst eyJnd21vZGVsIjoidXJzYWxpbmsiLCJzZXJ2ZXJJUCI6IjM0LjI1MC4xMTIuMTE6NTAwMTAiLCJ1dWlkIjoiY2NjYmE3NTMtYTMyZS00NzE4LWEzMTktY2ZjZjg0NWUyOGViIn0=

After a short while, return to the Orbiwise platform. 

You will see that the UG65 device has been automatically created and is functioning properly:

At this point, all three installation methods have been fully introduced.

Next, continue following the steps in this document to add sensors and proceed with the rest of the setup.

Step 4: Adding Sensor

Operate as shown:

Refer to the following image and fill in the LoRa parameters of the sensor step by step:

Special Note:

● LoRaWAN Mac Version must be 1.0.2 or 1.0.3

● Regional Parameter Rev must be Rev B

● The rest of the parameters should be filled in based on your actual setup

After adding, the screen will look like this:

Wait a moment and you will see the Status change from a question mark to Joined:

Finally, when it shows data received, it means the sensor has been successfully added to the platform:

Click View data to view real-time data reported by the sensor:

At this point, the sensor has been successfully connected to the Orbiwise platform and is reporting data in real time.

Step 5: Configure Decoding

Follow the steps below to achieve sensor data decoding.

First, create the Roaming Profiles configuration:

Then create the Connectivity Profiles configuration:

Then create the Service Profiles configuration:

Finally, create the Device Profiles configuration:

Then configure the Payload Codec:

Note: The code can be obtained here.

After creation, the screen will look like this:

Next, configure Device settings. 

As shown, modify the Device Profile parameter to the one we just created:

Now view the Device data again:Check the box to display the Decoded column. 

We can see that the decoded sensor data is now successfully displayed:

At this point, the entire process is fully complete.

-END-