Configure a Modbus TCP source (console) - AWS IoT SiteWise

Configure a Modbus TCP source (console)

To configure a Modbus TCP source

  1. Navigate to the AWS IoT SiteWise console.

  2. In the left navigation pane, choose Gateways.

  3. On the gateway you want to create a source for, choose Manage, and then choose View details.

    
                  AWS IoT SiteWise "Gateways" page screenshot with "View details"
                    highlighted.
  4. Choose New source in the upper-right corner.

  5. For Protocol options, choose Modbus TCP.

  6. For Modbus TCP source configuration, enter a Name for the source.

  7. For IP address, enter the IP address for the data source server.

  8. (Optional) Enter the Port and Unit ID for the source server.

  9. (Optional) For Minimum inter-request duration, enter the time interval between subsequent requests sent to your server. Your gateway automatically calculates the minimum allowable interval based on your device and the number of registers you have.

  10. For Property groups, enter a Name.

  11. For Properties:

    1. For Tag, enter a property alias for your register set. For example, TT-001.

    2. For Register address, enter the register address that starts the register set.

    3. For Source data type, choose the Modbus TCP data type you want to convert data from. This defaults to Hex dump.

      Note

      The source data type you choose determines the data size, destination data type, and swap mode you can choose. For more information, see Configure a Modbus TCP source.

    4. For Data size, enter the number of registers to read when starting from the Register address. This is determined by the source data type you choose for this source.

    5. For Destination data type, choose the AWS IoT SiteWise data type that you want your data to be converted to. The default is String. The destination type must be compatible with the source data type you choose for this source. For more information, see Configure a Modbus TCP source.

    6. For Swap mode, choose the data swap mode you want to use to read data from your register set. The swap mode must be compatible with the source data type you choose for this source. For more information, see Configure a Modbus TCP source.

  12. For Scan rate, update the rate at which you want the gateway to read your registers. AWS IoT SiteWise automatically calculates the minimum allowable scan rate for your gateway.

  13. (Optional) For Destination, choose where the source data is sent. By default, your source sends data to AWS IoT SiteWise.You can use a AWS IoT Greengrass stream to export your data to a local destination or to the AWS Cloud instead.

    Note

    You must choose AWS IoT SiteWise as your source destination if you want to process data from this source at the edge with AWS IoT SiteWise. For more information about processing data at the edge, see Process data locally with AWS IoT SiteWise.

    To send your data to another destination:

    1. For Destination options, choose Other destinations.

    2. For Greengrass stream name, enter the exact name of your AWS IoT Greengrass stream.

      Note

      You can use a stream that you've already created, or you can create a new AWS IoT Greengrass stream to export your data. If you want to use an existing stream, you must enter the exact name of the stream or a new stream will be created.

      For more information about working with AWS IoT Greengrass streams, see Manage data streams in the AWS IoT Greengrass developer guide.

  14. Choose Add source.

    AWS IoT SiteWise deploys the gateway configuration to your AWS IoT Greengrass core. You don't need to manually trigger a deployment.