Skip to main content

Mango I/O Tools

Overview​

The Mango Analog module is an expansion module designed to work with the MangoGT V3. It can be deployed in two configurations: fitted inside the MangoGT enclosure as an internal expansion, or as a stand-alone Modbus device connected externally via RS-485.

The module features eight 12-bit analog inputs, each independently software-programmable for the following modes:

ModeRange / Description
Voltage (low)0-5 VDC
Voltage (high)0-10 VDC
Current loop4-20 mA (requires 250 ohm 1/2W 0.1% resistor between input and ground)
Thermistor10k Type 2 (converted to degrees F before scaling)
Digital inputLow-speed binary input with hysteresis
CounterPulse counting up to 200 Hz, range 0 to 4,294,967,295

When used as a stand-alone device, the module PCB is fitted to a separate base board that provides an RS-485 transceiver, Modbus connector, and a 16-way input terminal strip. The I2C interface also allows additional I/O expansion such as power-limited outputs with PWM capability.

Modbus Register Map​

The Modbus interface presents a series of registers for reading and configuration. The first eight registers are 32-bit signed values corresponding to each input channel. Following these are configuration registers that control scaling, offset, and input mode for each channel.

Two scaling algorithms are available for voltage, current, and thermistor ranges:

  • (ADC * 32768 / scale) + offset
  • (ADC * scale / 32768) + offset

Scale is an unsigned 16-bit value and offset is a signed 16-bit value, both applied directly to the ADC count (0-4095). Factory default scaling is set to 0-4096 for all ranges except temperature. Factory defaults can be restored per channel through a control register bit.

Device Connections​

Device inputs are brought out on the MangoGT through a 16-way expansion connector. With the MangoGT oriented so the connector is on the bottom, pin 1 is on the left.

Accessing the I/O Tools​

In your MangoGT, navigate to Administration > Admin Home and locate the Mango I/O Tools in the Utilities section.

Use the Mango I/O Tools module to manage and configure attached Mango I/O modules, whether installed internally or connected externally.

Selecting the Comm Port​

If your MangoGT includes the internal Analog Input module, the data source and data points are pre-configured. The data source named IOBoard uses the comm port connected to the internal analog module with a default Slave ID of 1.

You only need to change the selected data source or Slave ID if you are configuring external I/O modules connected via RS-485.

Tools​

The Mango I/O Tools module contains four utilities:

Scan​

The Scan tool queries the network for connected Mango I/O devices and displays their type, serial number, manufacturing date, and hardware and software versions. Use this to verify that external modules are properly connected and communicating.

Configure​

The Configuration tool is the primary interface for setting up each channel of the input module individually. This is where you select input modes, set scaling parameters, and configure channel behavior.

Calibration​

The Calibration tool performs a calibration against a known voltage reference. Factory calibration is completed before shipping, so this tool is typically only needed if you suspect measurement drift or after replacing a module.

I/O Console​

The I/O Console is an advanced tool that provides a direct command interface to the I/O device, allowing developers to send and receive raw commands for debugging or custom configuration.

Firmware​

The Firmware upload tool allows you to upload new firmware files to the I/O device. Use this when Radix IoT releases firmware updates for the analog module.

Configuring Analog Channels​

Before making any configuration changes, click the Read From Device button to load the current parameters from the module.

Each channel can be configured with the following properties:

Mode​

Select the sensor type from the available options: 0-5 VDC, 0-10 VDC, 4-20 mA, thermistor, digital input, or counter.

Digital input mode: The input is treated as low if below 1/3 scale and high if above 2/3 scale, providing 1/3 scale hysteresis. The input has a 0-5V range with a 10k pull-down resistor. Low-speed digital mode returns 0 when the input is low and -1 when high.

Counter mode: The count range is 0 to 4,294,967,295 with a maximum rate of 200 pulses per second. The count value is saved to non-volatile storage every 5 seconds to ensure integrity during power loss. Writing to the result register clears the count. A per-channel debounce period is configurable between 0 and 60 seconds in 1 ms increments.

Raw Value​

The raw value is the unscaled output from the 12-bit analog-to-digital converter, ranging from 0 to 4095.

Data Point Value​

This is the scaled value that Mango reads, logs, and displays from the I/O board. It reflects the raw ADC value after the configured scaling and offset have been applied.

Low and High Scaling​

The ADC produces raw values from 0 to 4095 (12-bit resolution). The low scale and high scale values define how this range maps to engineering units. For example, a 0-100 PSI pressure sensor would use:

ParameterValue
Low Scale Value0
High Scale Value100
Decimal Places1
Suffixpsi

Digital Input Mode​

Switching to digital input mode changes the data point type from Numeric to Binary and updates logging from a 1-minute average to log-on-change.

caution

Changing a data point's type (for example, from Numeric to Binary) causes all historical data for that point to be deleted. Back up any important historical data before changing input modes.