Moxa Technologies AIG-301 Series User Manual
  1. Manuals
  2. Brands
  3. Moxa Technologies Manuals
  4. Gateway
  5. AIG-301 Series
  6. User manual

Moxa Technologies AIG-301 Series User Manual

Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
AIG-301 Series User Manual
Version 2.0, July 2023
www.moxa.com/products
© 2023 Moxa Inc. All rights reserved.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the AIG-301 Series and is the answer not in the manual?

Questions and answers

Related Manuals for Moxa Technologies AIG-301 Series

Summary of Contents for Moxa Technologies AIG-301 Series

  • Page 1 AIG-301 Series User Manual Version 2.0, July 2023 www.moxa.com/products © 2023 Moxa Inc. All rights reserved.
  • Page 2 AIG-301 Series User Manual The software described in this manual is furnished under a license agreement and may be used only in accordance with the terms of that agreement. Copyright Notice © 2023 Moxa Inc. All rights reserved. Trademarks The MOXA logo is a registered trademark of Moxa Inc.

  • Page 3: Table Of Contents

    Table of Contents Introduction ............................4 Overview .............................. 4 Getting Started ............................. 5 Connecting the Power ..........................5 Connecting Serial Devices ........................5 Connecting to a Network ........................5 Access to the Web Console ........................6 Web Console ............................7 Dashboard ............................

  • Page 4: Introduction

    RTU/TCP master/client protocols which can help you to collect Modbus devices. Moreover, Azure IoT Edge software is preloaded and seamlessly integrated with the AIG-301 Series to enable easy, reliable, yet secure sensor-to-cloud connectivity for data acquisition and device management using the Azure Cloud solution.

  • Page 5: Getting Started

    Connect one end of the Ethernet cable to the AIG’s 10/100/1000M Ethernet port and the other end of the cable to the Ethernet network. The AIG will show a valid connection to the Ethernet by LAN1/LAN2 maintaining solid green/yellow color. For details on the behavior of the LEDs, refer to the AIG-301 Series Quick Installation Guide.

  • Page 6: Access To The Web Console

    Ensure your host and the AIG are in the same subnet (AIG's default subnet mask is 255.255.255.0). https://192.168.4.127:8443 Connect to LAN2 and enter in your web browser. Enter the account and password information. Default account: admin Password: admin@123 You will see the following home page after logging in successfully. AIG-301 Series User Manual...

  • Page 7: Web Console

    Network Dashboard This dashboard displays information on the WAN and LAN interfaces and the network traffic passing through the interfaces. Network Status shows whether the gateway can connect to the Internet. AIG-301 Series User Manual...
  • Page 8 The information is refreshed every 10 seconds. Information on the LAN interfaces is organized under the LAN tab and includes information on the usage of the interfaces and the traffic passing through them. AIG-301 Series User Manual...

  • Page 9: System Configuration

    The way to sync the time clock IP or Domain address (e.g., This field is required to specify your time server's IP or domain Time Sever 192.168.1.1 or pool.ntp.org) name if you choose the NTP server as the source AIG-301 Series User Manual...

  • Page 10: System Settings-Ip Address

    To configure the network, do the following: Choose LAN1 or LAN2 for configuration. Select the WAN (Wide Area Networks) or LAN (Local Area Networks). Select DHCP or Static mode. Configure IP address, Subnet mask, Gateway, and DNS. AIG-301 Series User Manual...

  • Page 11: System Settings-Cellular

    Specify the target SIM card. Enter the PIN Code if your SIM card requires it. (NOTE: Three wrong attempts will lock the SIM card.) Choose a Carrier. (NOTE: This option is displayed only if the cellular module supports carrier switching.) AIG-301 Series User Manual...
  • Page 12 To enable automatic system reboot, select the Reboot the device when pings to the target host failed continuously for a certain amount of time option and specify a reboot interval. Go to Network Overview > WAN if you want to check the cellular network's connection status afterwards. AIG-301 Series User Manual...

  • Page 13: System Settings-Http/Https

    To use the HTTPS console without a certificate warning appearing, you need to import a trusted certificate issued by a third-party certificate authority. If there are no imported certificates, the AIG Series can generate the “AIG Series Root CA for HTTPS” certificate instead. AIG-301 Series User Manual...

  • Page 14: System Settings-Serial

    Description rs232 rs422 Interface rs485-2w rs-485 4w Baud Rate 300 to 921600 Parity none, odd, even, space, mark Data Bits 7, 8 Stop Bits 1, 2 none Flow Control Hardware: flow control by RTS/CTS signal hardware AIG-301 Series User Manual...

  • Page 15: System Settings-I/O

    To activate a DI, just click on the edit icon and enable auto sampling and input sampling rates according to your requirements. For DOs, clicking on the edit icon allows you to configure the status and initial status settings. Parameter Value Description High voltage Status Low voltage AIG-301 Series User Manual...

  • Page 16: System Settings-Dhcp Server

    To configure DHCP server settings, do the following: Check Enable DHCP Server. Input IP Address Range parameters. (Optional) Input DNS. Specify Lease Time. Click SAVE. (Optional) input Domain Name. NOTE The DHCP server service is only available on LAN and static IP interfaces. AIG-301 Series User Manual...

  • Page 17: System Settings-Wi-Fi

    If the Wi-Fi Client is Selected Click +CREATE to manually Create by SSID or be Created by Scan Results. Select DHCP or Static mode. Check Check-alive function which can be used to ensure Internet connectivity. Click SAVE. AIG-301 Series User Manual...

  • Page 18: Protocol

    Click + ADD COMMAND to add Modbus commands to collect the data, then press NEXT. Click DONE if you have confirmed the settings are correct. Click GO TO APPLY SETTINGS and APPLY for the settings to take effect. AIG-301 Series User Manual...
  • Page 19 Modbus Device Settings After configuring the basic settings, configure related parameters to retrieve data from the Modbus device. In the beginning, press ADD DEVICE and go to the wizard to guide you through the configuration step by step. AIG-301 Series User Manual...
  • Page 20 1 to 255 – The slave ID of a remote slave device. Step 2. Command When you configure the device for the first time, select Manual mode and press ADD COMMAND. The command settings will pop up. AIG-301 Series User Manual...
  • Page 21 Byte: 0x0A, 0x0B, 0x0C, 0x0D becomes 0x0B, 0x0A, None 0x0D, 0x0C Byte Endian swap None Word: 0x0A, 0x0B, 0x0C, 0x0D becomes 0x0C, 0x0D, Word 0x0A, 0x0B. Byte and Word Byte and Word: 0x0A, 0x0B, 0x0C, 0x0D becomes 0x0D, 0x0C, 0x0B, 0x0A. AIG-301 Series User Manual...
  • Page 22 If you already have a Modbus command file, select Import Configuration mode. Importing a configuration file will help you reduce configuration time. Step 3. Confirm Review whether the information of the settings is correct. AIG-301 Series User Manual...
  • Page 23 IMPORT a file (golden sample) to reduce configuration time. After finishing all the settings, press GO TO APPLY SETTINGS and click APPLY for the settings take effect. AIG-301 Series User Manual...
  • Page 24 Rx signals within an expected time interval, all received data uncheck: check intercharacter will be discarded. 10 to 500 timeout (ms) Check: The AIG will automatically determine the time out. Uncheck: You can input a specific timeout value. AIG-301 Series User Manual...
  • Page 25 Value Default Description Alphanumeric string and Device Name characters ( ~ . _ - ) are – Name your Modbus device allowed Slave ID 1 to 255 – The slave ID of a remote slave device. AIG-301 Series User Manual...
  • Page 26 Address Read Coils: 1 to 2000 Read Discrete Inputs: 1 to 2000 Read Inputs Registers: 1 to Read Specifying how much data to read quantity Read Holding Registers: 1 to Read/Write Multiple Registers: 1 to 125 AIG-301 Series User Manual...
  • Page 27 Proceed - Set to User-defined value boolean int16 int32 int64 uint16 The command will be generated into a meaningful tag by tag Tag Type – uint32 type and stored in the tag hub. uint64 float double string AIG-301 Series User Manual...
  • Page 28 If you already have a Modbus command file on hand, select the Import Configuration mode. Importing a configuration file will help you reduce configuration time. Step 3. Confirm Review whether the information of the settings is correct. AIG-301 Series User Manual...
  • Page 29 Modbus commands into a file for backup purposes; or you can IMPORT a file (golden sample) to reduce configuration time. After finishing all the settings, press GO TO APPLY SETTINGS and click APPLY for the settings to take effect. AIG-301 Series User Manual...
  • Page 30 Check: If the Modbus command fails, e.g., Modbus exception code is Enable Check received or Modbus response times out, the value of the status tag in command Check uncheck the tag hub will change to 1. event Uncheck: Disable the function. AIG-301 Series User Manual...
  • Page 31 Import/Export Configuration You can Import/Export the Modbus Master settings, which will be stored in XML format. An example of an exported file that can be viewed/edited by EXCEL. AIG-301 Series User Manual...

  • Page 32: Opc Ua Server

    Go to OPC UA Server to configure the corresponding settings. To enable the OPC UA Server, click LAN and do the following: Click Connection EDIT, select Enable This Server, and click DONE. The service is enabled by default on port 4840. AIG-301 Series User Manual...
  • Page 33 (Optional) Click Security EDIT to edit Policies, User Authentication, and Certificates. (Optional) Click Manage Account Details to CREATE new accounts. The default account/ password is admin/moxa. AIG-301 Series User Manual...
  • Page 34 (Optional) Click Manage Certificate Details to download the server certificate or upload a client certificate. AIG-301 Series User Manual...
  • Page 35 (Optional) Click Advanced > EDIT to configure the subscription settings here. Click ADD TAGS and select providers and tags. Click DONE. Click GO TO APPLE SETTINGS. Click APPLY. AIG-301 Series User Manual...

  • Page 36: Edge Computing

    Edge Computing Function Management AIG-301 Series provides a functionality to trigger actions based on specific data or time frame. For example, you can create a function that implements a defined action such as a device reboot or a cron job triggered by a specified change in a tag value or newly generated tags/events.
  • Page 37 Retrying a failed function every 5 seconds (unlimited tries) The function failed during a retry. Failure The correspondent error message will be displayed in the table. You can click EXPORT LOG to check the logs. Inactive The function is disabled. AIG-301 Series User Manual...

  • Page 38: Tag Management

    To see the tag’s real-time value, do the following: Click + EDIT TAGS. Select the tags to monitor in the list. (Optional) use SEARCH to find the tags quickly. Click SAVE. (Optional) Press the icon to deactivate the monitoring tags. AIG-301 Series User Manual...

  • Page 39: Cloud Connectivity

    Azure IoT Edge service and enroll the device via manual setting or DPS (Device Provisioning Service) here. NOTE A registered Azure account is needed to manage the Azure IoT Edge service for your IoT application. AIG-301 Series User Manual...
  • Page 40 TPM attestation is only available for devices with a built-in TPM module.  For the Azure IoT Hub device provisioning service and Symmetric encryption. enter the Registration ID and Endorsement Key.  For X.509, upload the X.509 Certificate and Private Key. AIG-301 Series User Manual...
  • Page 41 If an unexpected situation occurs when you upgrade/downgrade to a certain version of Azure IoT Edge, you can restore Azure IoT Edge by clicking RESTORE in the Provisioning Settings. Using the restore function will remove existing settings including Message Group, Store and Forward, Device Management, and Downstream/Upstream credentials. AIG-301 Series User Manual...
  • Page 42 Click + MESSAGE to create a new telemetry message. Specify an Output Topic name. Select a Publish Mode. For details, see Publish Mode. Input corresponding parameters such as publish interval, sampling mode, and publish size. Click NEXT. Select tags (e.g., Modbus Master). AIG-301 Series User Manual...
  • Page 43 If you cannot receive D2C messages, check and ensure that a default route of the modules is added. You can add routes in Azure IoT Hub. Log in your IoT Hub > IoT Edge > choose a device > Set Modules > Routes. AIG-301 Series User Manual...
  • Page 44 To prevent your device from connecting to potentially malicious gateways (Azure IoT Edge inside), you can upload X.509 certificate, Private Key, or Trusted CA Certificate. You can generate the certificates and the private key using ThingsPro Edge. For additional information, see Downstream Certificate. AIG-301 Series User Manual...

  • Page 45: Azure Iot Device

    To create the Azure IoT Device connectivity, follow the steps below: Click to set connection. Enter Connection String. Select a Connection Protocol. Select an Authentication Type. (Optional) Upload X.509 Certificate and Private Key. Click SUBMIT. AIG-301 Series User Manual...
  • Page 46 Click + MESSAGE to create a new telemetry message. Specify an Output Topic name. Select a Publish Mode. For details, see Publish Mode. Input corresponding parameters such as publish interval, sampling mode, and publish. Click NEXT. Select tags (e.g., Modbus Master). AIG-301 Series User Manual...
  • Page 47 The device-to-cloud (D2C) message policy allows you to transform default payload to your desired payload schema via the jq filter. For additional information, refer to the jq website (https://stedolan.github.io/jq/manual/). Click NEXT. (Optional) Enter Property Key and Value. 10. Click SAVE. AIG-301 Series User Manual...
  • Page 48 Store and Forward and select Enable Store and Forward. Select a target disk and a maximum storage cache, a retention policy, and a TTL (Time to Live) value for the messages. NOTE if you want to use the direct method to write tags from the cloud, refer to https://docs.moxa.online/tpe/openapi/taghub/#tag/access AIG-301 Series User Manual...

  • Page 49: Aws Iot Core

    IoT Core connectivity, follow the steps below: Click to set connection. Enter Host (Endpoint). Port (default: 8883). Enter ThingID. Input Keep Alive Time (sec) Select a way of message QoS. Upload X.509 Certificate, Private Key, and (optional) Trusted Root CA. Click SAVE. AIG-301 Series User Manual...
  • Page 50 Click + MESSAGE to create a new telemetry message. Specify an Output Topic name. Select a Publish Mode. For details, see Publish Mode. Input corresponding parameters such as publish interval, sampling mode, and publish size. Click NEXT. Select tags (e.g., Modbus Master). AIG-301 Series User Manual...
  • Page 51 (Optional) Enable custom payload by using the jq filter. The device-to-cloud (D2C) message policy allows you to transform default payload to your desired payload schema via the jq filter. For additional information, refer to the jq website (https://stedolan.github.io/jq/manual/). Click SAVE. AIG-301 Series User Manual...
  • Page 52 Store and Forward and select Enable Store and Forward. Select a target disk and a maximum storage cache, a retention policy, and a TTL (Time to Live) value for the messages. NOTE if you want to use the direct method to write tags from the cloud, refer to https://docs.moxa.online/tpe/openapi/taghub/#tag/access AIG-301 Series User Manual...

  • Page 53: Generic Mqtt Client

    Click ADD CONNECTION. Specify a Server (default port: 8883). Select an MQTT Version. (Optional) If the broker requires, enter Client ID, Username, and Password. (Optional) Enable persistent session. Select a type of QoS and retain function on/off. AIG-301 Series User Manual...
  • Page 54 (Optional) Select type of QoS and retain function for Will flag. Once an MQTT Broker has been created, create a new telemetry message by following the steps below: Click + MESSAGE. Specify an output topic. Select a Publish Mode. For details, see Publish Mode. AIG-301 Series User Manual...
  • Page 55 (Optional) Enable custom payload by using the jq filter. Click SAVE. The device-to-cloud (D2C) message policy allows you to transform the default payload to your desired payload schema via the jq filter. For additional information, refer to the jq website (https://stedolan.github.io/jq/manual/ AIG-301 Series User Manual...

  • Page 56: Sparkplug

    Go to Cloud Connectivity > Sparkplug to enable Sparkplug B and communication. The configuration process consists of the following: Enabling Sparkplug • Configuring a Broker • • Configuring a Telemetry Message AIG-301 Series User Manual...
  • Page 57 Enabling Sparkplug Click on the Sparkplug B. link and use the scroll bar to enable Sparkplug B. Specify an Edge Node ID. Specify a Group ID. (optional) Specify a Primary Host ID. Click SAVE. AIG-301 Series User Manual...
  • Page 58 (optional) Enable SSL/TLS and upload Client Certificate, Key, and Trusted Root CA. Click SAVE. NOTE Data loss might occur during the period of connection interval prior to network connection check (Keep Alive Time). We suggest setting a shorter interval of Keep Alive Time (e.g., 10 seconds) AIG-301 Series User Manual...
  • Page 59 Click on the + MESSAGE link. Select tags from providers (e.g., Modbus Master). Select devices or system tags. Click NEXT. Select a publish mode. For details, see Publish Mode. Select a sampling mode. Click NEXT. (optional) Specify a description. AIG-301 Series User Manual...
  • Page 60 Click SUBMIT. AIG-301 Series User Manual...
  • Page 61 TTL (Time to Live) value for the messages and a size of bulk transfer. NOTE if you want to use the direct method to write tags from the cloud, refer to https://docs.moxa.online/tpe/openapi/taghub/#tag/access AIG-301 Series User Manual...
  • Page 62 To back up the configuration of Sparkplug, you can export the configuration as a backup file. NOTE The exported configuration includes credentials, client ID, and policies of D2C messages. You can modify these parameters after the configuration file is imported to other gateways. AIG-301 Series User Manual...

  • Page 63: Moxa Dlm Service

    Once you have access to the service, go the Moxa DLM Service to register the product online as follows. 10. Input DLM email and password, and press VERIFY. 11. If the input information is correct, you will see the connection has been verified. AIG-301 Series User Manual...
  • Page 64 13. Once the enrollment is successful, you will see the following information: NOTE Ensure the Moxa DLM service is enabled at the top left corner. 14. Log in to the Moxa DLM Service. You will see your AIG device online and you can manage it. AIG-301 Series User Manual...

  • Page 65: Security

    The rootCA.cer certificate is used to sign the HTTP SSL X.509 certificate, default.crt. You can download this root CA and import it to your client devices to trust the HTTPs connection between clients and AIG. To import to Google Chrome, you can refer to the below link: https://docs.moxa.online/tpe/users-manual/security/certificate_center/#import-rootcacer-to-google-chrome AIG-301 Series User Manual...

  • Page 66: Firewall

    The AIG disables all ports by default excluding the reserved ports mentioned above. To add service ports, add them to the Allowed List. Allowed List AIG provides an allowed list for creating firewall rules. You can create, edit, and delete firewall rules here. AIG-301 Series User Manual...
  • Page 67 Click + ADD RULE. Select action Allow. Specify the priority, protocol, gateway port, rule name, and description (optional). Specify a source IP or a subnet. Specify a source port or a range of ports. Click SAVE. AIG-301 Series User Manual...
  • Page 68 Specify a destination IP and port. Click SAVE. NOTE AIG Edge reserves priority 1 to 500 for system default rules. The priority range 501 to1000 is for Forward action rules; while the range 1001 to 1500 is for Allow action rules. AIG-301 Series User Manual...

  • Page 69: Openvpn Client

    You should see it listed in the OpenVPN client. Click the button to enable OpenVPN client to connect. If the connection is successful, you will be connected to the VPN network, and your internet traffic will be encrypted and routed through the VPN server. AIG-301 Series User Manual...

  • Page 70: Account Management

    Click on + CREATE to create a new user account. In the dialogue box that is displayed, fill up the fields and click SAVE. NOTE We recommend that you specify a strong password that is at least eight characters long, consisting of at least one number and at least one special character. Password Policy Valid Password AIG-301 Series User Manual...
  • Page 71 Administrator role is selected, all items in the pop-up menu will be grayed out. Roles You can View, Create, Edit, and Delete user roles in ThingsPro Edge. In the main menu, go to Security > Account Management > Roles to manage the user roles. AIG-301 Series User Manual...
  • Page 72 When you are done, click on the button "SAVE" to create the role in the system. You can edit the settings or delete an existing role by clicking on the pop-up menu icon next to the role. AIG-301 Series User Manual...

  • Page 73: Maintenance

    For AWS, Azure, Sparkplug, MQTT Client troubleshooting, do the following: Click CHECK. Click START. (The example below selects Azure IoT Device. The steps may vary depending on the protocol you choose.) View the logs to identify the issue. (Optional) Export the logs. AIG-301 Series User Manual...
  • Page 74 For Modbus troubleshooting, do the following: Click CHECK. Choose TCP or COMx. View the diagnostic information. Click the Traffic Monitoring tab to capture the traffic logs. (Optional) Export the traffic logs to send to experienced engineer for further analysis. AIG-301 Series User Manual...

  • Page 75: General Operation

    Go to General Operation > Config. Import/Export, where you can import or export the gateway configuration file with a given password. The exported configuration file will be compressed to the tar.gz format and downloaded on your computer. AIG-301 Series User Manual...
  • Page 76 Upgrade From the Local Drive: click BROWSER and select the software package file in *.deb file format on your computer, then click UPLOAD. Download Over the Air: Enter the file URL. For additional details, see https://github.com/TPE- TIGER/AIG301-501-Technical-Document/blob/main/documents/AIG%20Software%20Upgrade.md AIG-301 Series User Manual...
  • Page 77 Reserve Network Settings before clicking RESET. If you want to reset to Factory default, go to General Operation > Reset to Default > press RESET under Factory Reset. NOTE The configurations and firmware will be reset back to factory default. AIG-301 Series User Manual...
  • Page 78 Enablement For security reasons, disable all unused services. Go to Maintenance > Enablement > Service to disable or enable the system services by just toggling the buttons. AIG-301 Series User Manual...

  • Page 79: Diagnostic

    To optimize the use of storage space on your AIG, you can check the Enable Time to Live option and specify the maximum storage space for the system logs. Click SAVE to confirm your settings. AIG-301 Series User Manual...
  • Page 80 *.zip file and downloaded on to your computer. Configuring Event Log Settings Choose the type of events to be stored, specify where to keep the logs, and the maximum storage size to use. Click the Event Settings to access these settings. AIG-301 Series User Manual...
  • Page 81 To optimize the use of storage space on your AIG, you can check the Enable Time to Live option and specify the maximum storage space for the system logs. Click SAVE to confirm your settings. AIG-301 Series User Manual...

  • Page 82: Appendix

    To avoid situations where the data takes a long time Idle Timer to reach the desired size, a threshold value can be 0 – 86400 (sec) set to ensure that the data is sent out as soon as it reaches the specified timer setting. AIG-301 Series User Manual...

This manual is also suitable for:

Aig-501 series

Table of Contents