Gateway Setup
How to set up a gateway.
A gateway reads the machine through Modbus and sends the selected values to MojoScale.
Setup steps
Use this order when creating a new gateway.
Choose a siteSelect the customer/site where this gateway belongs. Create the site first if it does not exist.
Name the gatewayUse a clear field name, such as factory-a-genset-1 or panel-room-meter.
Select the device profilePick the built-in profile for the controller or meter. The profile provides Modbus defaults and available metrics.
Review selected metricsMojoScale starts with the recommended set. Keep it, or change it if the operator needs different values.
Choose network modeCloud mode reports to MojoScale. Local mode keeps the gateway on Wi-Fi with local APIs. AP mode starts its own setup Wi-Fi.
Flash the gatewayConnect the board by USB, start flashing, and keep the dialog open until setup finishes.
Metric limit: select up to 20 values. The default set is meant to be enough for normal use, and you can change it before flashing.
Wire the gateway to RS485
Before checking software settings, confirm the physical connection.
Connect controller RS485 A to gateway A.
Connect controller RS485 B to gateway B.
Connect GND if the controller/manual recommends it.
Power the gateway from a supported DC input or USB during setup.
If there is no Modbus response, try swapping A and B.
Confirm the controller slave ID and baud rate.
Common baud rates are 9600 and 19200.
RS485 labels are not always consistent across vendors. A/B reversed is a common field problem.
Metric selection
The gateway should send only the values that matter. This keeps the device stable and keeps the UI readable.
TypeWhat it meansHow it is sent
ScalarA measured number like voltage, current, frequency, RPM, temperature, pressure, fuel, power, or run hours.Sent as a selected value.
BooleanAn on/off state like running, charger fault, or emergency stop.Shown as status when active.
EnumA coded state like Off, Manual, Auto, Running, or Stopped.Shown with the mapped name.
Bit flags / alarmsMany statuses packed into one register.Shown as named active statuses/alarms.
Field meanings
Device IDThe unique machine record in MojoScale.
Gateway nameThe name shown in the console and used to identify the gateway locally.
Local addressThe `.local` address used on the same network, for example factory-a-genset-1.local.
Modbus addressThe slave ID of the machine controller. If unknown, the gateway can scan common addresses.
Baud rateThe serial speed. Common values are 9600 and 19200. The gateway can scan common baud rates.
Wi-Fi SSID/passwordThe site network credentials. Leave them empty for AP-only setup.
Startup modeAP only, local webserver, or cloud/MQTT mode.
Polling intervalHow often the gateway reads Modbus.
Telemetry intervalHow often the gateway sends selected values to MojoScale.