Skip to main content
Version: 2.3.x

Software Development

ThingsPro Edge offers rich RESTful APIs to help SI and ISVs leverage or integrate functions and capabilities to simplify solution development. For a list of the Open APIs and instructions on using the the Thingspro Agent utility, check the link here.

Linux Development​

Linux developers must exercise caution when running their own programs to extent the capabilities provided by ThingsPro Edge. ThingsPro Edge provides functions for general settings and network configuration. Avoid using system operations and commands that destabilize the system.

Note: Linux development is not recommended in the field in a production environment. Develop and test your applications in a lab before deploying in a production environment.

THINGS TO AVOID​

Items listed here are usually managed by ThingsPro Edge. You may be able to temporarily modify the configuration but they are reverted back to the system settings

  • Networking: IP Settings, Routing, Ethernet, Wi-Fi, Cellular, including commands such as ip, dhclient, dhcpd, route, iw, hostapd, wpa_supplicant, cell_mgmt
  • LED control: mx-led-ctl
  • Serial: mx-uart-ctl
  • Time: timedatectl, ntpd
  • SD card: Auto-mounted configuration
  • Snapshot: mx-snapshot-ctl, mx-system-ctl

CAUTION​

Items listed here are not managed by ThingsPro Edge. However, exercise caution or avoid modifying these to ensure stability of ThingsPro Edge.

  • Networking: iptables (DO NOT modify MOXA-* CHAINS; other items should be ok to modify)

  • Package Management: 

    apt-get

    (Read warning messages before installing/upgrading/removing packages)

Important Notes​

  1. Web server is bound to the following by default.

    • HTTP : 80 port
    • HTTPS : 8443 port

  2. SSH server is bound to port 22 but disabled by default. You can enable it via the Web UI or the RESTful API.

  3. ICMP protocol is disabled by default.

  4. All containers' logs are integrated into the Linux journal service. You can monitor the Azure IoT Edge containers' logs using the following commands:

    journalctl CONTAINER_NAME=edgeAgent -f
    journalctl CONTAINER_NAME=edgeHub -f
    journalctl CONTAINER_NAME=thingspro-agent -f

Last updated on 2022-07-22 by Cecilia Fernandes