Skip to content

bareboat-necessities/bbn_sensors_hub_AB

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 

Repository files navigation

bbn_sensors_hub_AB

BBN NMEA XDR sensors hub esp32 hardware

BBN HubAB pic1

BBN HubAB pic3 BBN HubAB pic2

BBN HubAB pic5 BBN HubAB pic4

Hardware

It's really two devices in one. Both use atomS3-lite esp32s3 microcontroller from m5stack: https://shop.m5stack.com/products/atoms3-lite-esp32s3-dev-kit

Hub A is mostly environental sensors:

  • Lightning strike detector
  • Pressure
  • Temperature/Humidity
  • Multiple 1-wire waterproof temperature probes
  • Illuminance
  • Motion detector
  • Hatch open/closed limit switch sensor
  • i2c connector for more external i2c sensors supported by the Hub A firmware

Hub B is for electrical and liquid level sensors:

  • Current/Voltage/Power sensors
  • Resistance sensor for fuel level, engine oil pressure, rudder position, or trim
  • Water quality (TDS - Total Dissolved Solids) sensor
  • Liquid level (0-20 mAmps)

Enclosure, etc

Environmental Sensors (Hub A)

For all supported hardware and software of Hub A firmware look here: https://github.com/bareboat-necessities/bbn_sensors_hub_A

Making Connections for Hub A

For pins used in connections browse through the firmware code: https://github.com/bareboat-necessities/bbn_sensors_hub_A

M5Stack connectors are well color coded and pins are labeled on m5stack portABC.

Loading Firmware for Hub A

On Bareboat Necessities (BBN) OS (full)

Long press side button on atomS3 till you see green to enter the mode for uploading firmware.

NOTE: /dev/ttyACM1 in the script below is for example. In your case device name might be different. You can find out what it is by inspecting differences in output of

ls -ltr /dev/tty*

with the device unplugged from USB and plugged into USB.

Load the hub A firmware:

# shutdown signalk
sudo systemctl stop signalk

if [ -f bbn-flash-sensors-hub-A.sh ]; then rm bbn-flash-sensors-hub-A.sh; fi
wget https://raw.githubusercontent.com/bareboat-necessities/my-bareboat/refs/heads/master/m5stack-tools/bbn-flash-sensors-hub-A.sh
chmod +x bbn-flash-sensors-hub-A.sh 
./bbn-flash-sensors-hub-A.sh -p /dev/ttyACM1

Unplug and plug the device into USB to reboot.

Reading serial port

stty -F /dev/ttyACM1 38400
socat stdio /dev/ttyACM1

Liquid Levels and Electrical Sensors (Hub B)

For all supported hardware and software of Hub B firmware look here: https://github.com/bareboat-necessities/bbn_sensors_hub_B

Making Connections for Hub B

For pins used in connections browse through the firmware code: https://github.com/bareboat-necessities/bbn_sensors_hub_B

M5Stack connectors are well color coded and pins are labeled on m5stack portABC.

Loading Firmware for Hub B

On Bareboat Necessities (BBN) OS (full)

Long press side button on atomS3 till you see green to enter the mode for uploading firmware.

NOTE: /dev/ttyACM1 in the script below is for example. In your case device name might be different. You can find out what it is by inspecting differences in output of

ls -ltr /dev/tty*

with the device unplugged from USB and plugged into USB.

Load the hub B firmware:

# shutdown signalk
sudo systemctl stop signalk

if [ -f bbn-flash-sensors-hub-B.sh ]; then rm bbn-flash-sensors-hub-B.sh; fi
wget https://raw.githubusercontent.com/bareboat-necessities/my-bareboat/refs/heads/master/m5stack-tools/bbn-flash-sensors-hub-B.sh
chmod +x bbn-flash-sensors-hub-B.sh
./bbn-flash-sensors-hub-B.sh -p /dev/ttyACM1

Unplug and plug the device into USB to reboot.

Reading serial port

stty -F /dev/ttyACM1 38400
socat stdio /dev/ttyACM1

Integration with SignalK

Integration with SignalK is done via NMEA XDR Parser SignalK plugin.

More: https://github.com/GaryWSmith/xdr-parser-plugin

Recommended config file for XDR Parser SignalK plugin:

https://github.com/bareboat-necessities/lysmarine_gen/blob/bookworm/install-scripts/4-server/files/xdrParser-plugin.json

When registering a serial connection in SignalK use device symbolic link from /dev/serial/by-id/ (instead of direct /dev/ttyXXX name).

Other Bareboat Necessities Devices

Project Home: https://bareboat-necessities.github.io/

About

BBN NMEA XDR sensors hub esp32 hardware

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors