Configuring MQTT using ION Setup

Use advanced mode in ION Setup to:

  • Select the data to publish.

    Note: Data comes from linking numeric ION output registers from other modules to the MQTT Export Module's input registers. You cannot link other types of ION registers. For more information, see ION Reference Help.

  • Enter the connection details between the meter and the broker.

  • Check the status of the MQTT connection.

Prerequisites:

  • An understanding of ION architecture.

  • The MQTT broker's IPv4, IPv6, or fully-qualified domain name.

  • Full meter configuration access.

  • You have uploaded a certificate authority (CA) file for the broker. For more information, see Uploading an MQTT certificate authority file.

To configure MQTT:

  1. Open ION Setup.
  2. Open advanced mode for your meter.

    If prompted, enter the device credentials.

    Tip: To open advanced mode, Ctrl+Select your meter in the Network Viewer.

  3. Open MQTT Export Modules.
  4. If you do not already have an MQTT module:

    1. Right-click MQTT Export Modules.

    2. Select Insert Module.

      MQTT Export 1 is created.

  5. Open MQTT Export 1.
  6. Go to Inputs, select the Source that you want to link, and then select Edit.

    The ION Input Selection screen appears.

  7.  Link the source inputs:
    1. To link one input at a time:

      1. Go to Inputs, and then select the Source of the MQTT module that you want to link.

      2. Go to Output Registers, and then:

        1. Select a module type that has a numeric register.

        2. Select the module that you want to open.

        3. Select the numeric register that you want to link to the selected Source.

      3. Select OK.

        Tip: You must select a register for OK to become active.

      OR

    2. To link multiple inputs at once:

      1. Go to Inputs, select a range of sources from the MQTT module that you want to link using Shift+Select or Ctrl+Select.

      2. Go to Output Registers, and then:

        1. Select a module type that has a numeric register.

        2. Select the module that you want to open.

        3. Select the starting numeric register that you want to link to the Source range.

        Tip: ION Setup will automatically link as many available contiguous registers after the starting register.

      3. Select OK.

        Tip: You must select a register for OK to become active.

    3. Repeat until all the desired links are created.

  8. Select Setup Registers.
  9. Enter your MQTT connection settings.
  10. Select Send.
  11. Confirm your MQTT connection.