Guide 1

Set up a new Modbus profile.

A profile is the recipe for a controller or meter. It says how to connect, which registers to read, and how raw Modbus values become useful engineering values.

What a profile contains

A good profile has two layers: device defaults and metric rows. The defaults make setup faster later. The rows describe the actual data points.

Name and typeUse a name an installer can recognize, such as DeepSea DSE 7310 / 7320 or Schneider PM1200. Type groups it as genset, meter, pump, or another machine class.

Vendor and modelThese fields are for search and clarity. They help the profile library stay usable as more devices are added.

Communication defaultsSlave ID, baud, parity, data bits, stop bits, poll interval, send interval, and cache size are copied into the gateway setup page when this profile is selected.

Metric spreadsheetEach row describes one value. Rows can be scalar values, enums, booleans, bit flags, or text.

Profile Header Example

NameDSE 7310 / 7320 Gencomm

TypeGenset

VendorDeep Sea Electronics

ModelDSE7310 MKII / DSE7320 MKII

Slave ID10

Serial19200 8N1

Metric row fields

The spreadsheet is intentionally descriptive. A user should be able to look at a row and understand what it reads.

TypeScalar is a normal number. Enum is a code mapped to text. Boolean is true/false. Bit flags are many on/off states packed into one register. Text reads characters.

Label and KeyLabel is what people see. Key is what the payload uses. Example: label Battery Voltage becomes key battery_voltage.

FCThe Modbus function code. Common values are 3 for holding registers and 4 for input registers.

Address and CountAddress is the first register. Count is how many registers are required. A 32-bit number usually needs count 2.

Data, Word, ByteThese explain how bytes should be decoded: u16, s16, u32, s32, float32, and byte/word order.

Scale and OffsetUse these to convert raw values. Formula: readable value = raw value x scale + offset.

Unit and DecimalsUnit is shown on the data page. Decimals controls display precision.

Enum / Bit MapFor enum and bit flags, map raw numbers or bit positions to text labels.

Metric Spreadsheet Example

TypeLabelFCAddressUnit

ScalarBattery Voltage31029V

ScalarEngine Speed31030RPM

EnumController Mode3772state

Bit FlagsAlarm Register339425

Example scaling: if battery raw value is 246 and scale is 0.1, MojoScale displays 24.6 V.