4PointX IoT Gateway

4PointX IoT Gateway device is used to collect data from Plant / Shop floor and send to 4PointX IIoT Workbench. The device is based on Raspberry Pi and contains necessary interfaces (RS-485, CAN, ETH etc.) for collecting and transferring data.

The following configuration is required to be performed on 4PointX IoT Gateway before it can be used for onboarding data.

  1. Change hostname
    1. Use the following naming convention for hostname: 4px-<app>-<site>-<plant>-<function>-<#> (e.g., 4px-ems-jsw_vjnr-crm1-pltcm-1)

    2. Set the hostname.

      Linux command:

      vi /etc/hostname
      
  2. Assign IP address
    1. Assign IP and reboot the device. Linux commands:
      sudo vi /etc/network/interfaces #Comment pre-up line. See below for example setting.
      sudo reboot
      

      Example Settings:

      auto eth0
      iface eth0 inet static
        address 192.168.1.42
          netmask 255.255.255.0
            gateway 192.168.1.1
              dns-nameservers 1.1.1.1, 8.8.8.8
      
  3. Sample setting:
  4. After reboot, confirm that the IP is set. Also note the MAC Address. Linux command:
    1. baship addr

    2. Sample output:
  5. Set the host
    1. Change the “management_host” and “data_brokers” parameters in settings.json file to include the appropriate 4PointX IIoT Workbench server IP and Ports, and reboot the device.
      sudo vi /home/4px/4px.firmware/config/settings.json
      sudo reboot
      

      Example Settings:

      {
          "management_host": "34.9.188.179:443",
          "data_brokers": [
              "34.9.188.179:9092"
          ],
          "data_directory": "/home/4px/4px.data",
          "module": "gateway"
      }
      

With these steps the device would be ready to be used for onboarding data.

The following ports are relevant for the operation, configuration, and data communication of the 4PointX IoT Gateway. Ensure they are open on the firewall/router to allow seamless device-to-server connectivity.

Port

Protocol

Direction

Purpose

Access

Application Protocol

443

TCP

Outbound

For Configuration update

Open

HTTPS

9092

TCP

Outbound

For Data streaming

Open

HTTPS

22

TCP

Inbound

For Troubleshooting

Open

SSH

4PointX IoT Gateway can be deployed to collect data from various levels in a Plant network. At each level the Gateway is connected to a network Switch which in turn is connected to a Firewall. Port 443 and 9092 are required to be open in the Firewall for Outbound communication from 4PointX IoT Gateway (device) to 4PointX IIoT Workbench (server).

The following diagram depicts the network deployment architecture.

Issue

Symptoms

Possible Causes

Resolution Steps

No Data Reaching Platform

Dashboard shows no data

Incorrect settings.json host or brokerNetwork issues (firewall, DNS)Kafka broker issue

Verify IPs/ports in settings.jsonTest connectivity: ping, telnetCheck logs: tail -f /home/4px/4px.firmware/logs/<file-name>

Time Drift / Incorrect Time

Wrong timestampsDashboard shows future/past data

Clock unsynchronized

Run time sync script:python3 /home/4px/4px.firmware/time-sync.py Check system time:timedatectlEnsure timezone:sudo timedatectl set-timezone Asia/Kolkata