Skip to content

Reference — Aquabase gateway ​

The MUXEN devices this gateway publishes ​

DeviceFunctionInstanceWhat it carries
Watermaker20configured (InstanceNum), default 0the watermaker: mode, salinity, flow, pressures, pumps, valves, hour meter
Generic I/O17configured (InstanceNum), default 255the box's own relays, inputs and analog inputs

MQTT topics on the Brain follow device/<function>/<instance>/<frame>, so a watermaker left on its default instance is device/20/0/life.

What it publishes ​

device/20/<instance>/life, once a second:

FieldMeaning
state, stateCodewhat the machine is doing — see the table below
salinitysalinity measured by the CE62 probe, in ppm
productionFlowproduction flow measured by the FI61 flow meter
countera rolling counter, to tell a fresh message from a repeat
ProductLiterCmpt, FlowNowRateFromMaxFlowalways 0 — an Aquabase does not report them, keep them off the screens

device/20/<instance>/state, once a second:

FieldMeaning
preFilterPressurePSn06, pressure before the filter
postFilterPressurePSn34, pressure after the filter
highPressurePSn43, the high-pressure side, divided by ten before publication
rinsingValveSteV17, the rinsing valve
productionValveSteV64, the production valve
lpPumpSte, lpPumpFuseSteP04, the low-pressure pump, and its breaker
hpPumpSte, hpPumpFuseSteP40, the high-pressure pump, and its breaker
sensorLoopStethe tank sensor loop of the unit
hourMeterthe unit's own hour meter

Machine states ​

0 standby · 1 production · 2 rinsing · 3 FAS cleaning · 4 membrane cleaning · 5 fault · 6 emergency stop.

Commands ​

Published to device/20/<instance>/command:

PayloadEffect
{"produce":true}start producing
{"rinsing":true}start a rinse
{"off":true}back to standby

Commands are discarded while the unit is absent, and the unit's own controller may refuse them. productionFlowUp and productionFlowDown are not supported by this gateway — see Common mistakes — Aquabase gateway.

Parameters — watermaker (function 20) ​

ParameterTypeDefaultMeaning
InstanceNum0…620the watermaker's instance. Unlike most CanCan devices it is not 255, so a fresh box publishes as watermaker 0
BindToParcautothe electrical zone this machine is counted in
WatermakerModelread-only in practice2 (Aquabase)rewritten to 2 at every start; do not change it
ProductId, HardwareId, SoftwareId, SoftwareVersionread-onlysee Reference

Changes take effect at the next restart — write with --reboot.

Parameters of the generic I/O device are the ones common to every CanCan: Reference.

Routine 1 is the usual factory reset: 0001 restores the instance number to its default (0 here), any higher bit the other parameters.

Timings ​

Watermaker life and state published every1 s
Unit declared absent after5 s without its state message
Generic I/O published every500 ms, and on change
Alarms carried at once32

The Aquabase side ​

BusCAN 2, 62.5 kbit/s, fixed by the firmware
Readunit state and hour meter, the PSn06 / PSn34 / PSn43 pressures, the FI61 flow meter, the CE62 salinity probe, valve and pump states, rinsing programme, auto-stop settings, unit model
Writtenstandby / production / rinsing commands, auto-stop settings
Filteringnone — it listens to the whole bus and picks out what it understands; anything else is ignored
Models recognisedARUBA and SOROYA, Comfort and Premium, read from the unit

Fault codes reported by the unit ​

CodeFault
1, 2high pressure PSn43: pressure fault, sensor electrical fault
5, 6, 7post-filter PSn34: low pressure, water, sensor electrical fault
8, 9, 10pre-filter PSn06: low pressure, water, sensor electrical fault
11dirty filter
15, 16, 17pump fault: P04 (low pressure), P40 (high pressure), P52
19valve V48 did not open
21overflow
22flow meter FI61

The alarm code published on the MUXEN bus is one lower than the code above, except for the three pump faults. The alarm therefore reaches the boat's screens under a neighbouring name. Read the code on the Aquabase panel before ordering a part.

Known limitations ​

  • The alarm code shift described above.
  • Automatic rinsing programming and the flow-rate commands are not carried, and sending them is not harmless — see Common mistakes — Aquabase gateway.

Versions ​

HardwareVersionImage
CanCan v15.5010010020-app_aquabase-firmware.srec
CanCan v26.2010010020-V2-app_aquabase-firmware.srec

Source: workspace/muxen/cancan/app_aquabase/, product overlay boards/arm/<board>/010010020.overlay.

Integration of multiplexed solutions
MUXEN and the MUXEN logo are trademarks of MUXEN SAS.