PilotSpa

Balboa with panel VL801D DeluxeSerie and board SF273

Balboa with VL801D (DeluxeSerie)

RJ45 pins

PIN	Description
PIN 1	Functionality unclear!
PIN 2	Functionality unclear!
PIN 3	Button data
PIN 4	GND
PIN 5	Display data
PIN 6	Clock
PIN 7	5 VDC
PIN 8	Floating output

##PIN 6 (Yellow - clock), PIN 5 (Blue - display data), PIN 3 (Pink - button data)

Conclusion

• The clock is pulsing 7 times for each chunck of display data, totaly 71 bits and 4 times for button data. A complete cycle 75 pulses.
  
• Totaly of 6 display data chunks in each cycle
  
• Each cycle is repeted every 10 ms
  
• One total cycle duration 3.54 ms
• Bit duration for display data is 23.75 microseconds for display data
  
• Bit duration for button data is 71.5 microseconds
  

Display Data

Display shows 29.5C - How does that translates into the bitstream? The first 4 chunks is coded in BCD to 7 segment LCD (see reference) but only with 7 bits sinse the LSB always is (0).
2 = 1101101(0) = (Chunk 1)
9 = 1110011(0) = (Chunk 2)
5 = 1011011(0) = (Chunk 3)
C = 1001110(0) = (Chunk 4)

Chunk 4 - bit(0-7)	Chunk 3 - bit(7-14)	Chunk 2 - bit(14-21)	Chunk 4 - bit(21-28)	Chunk 5 - bit(29-71)
LCD segment 1	LCD segment 2	LCD Segment 3	LCD segment 4	29 - Button down/up
				???
				39 - Button
				40 - Button
				42 - Blower
				44 - Pump3
				47 - Light
				48 - Pump1
				49 - Pump2
				59 - Standard mode
				60 - Eco mode
				???

For the raccordement I choose an ESP 32 and I connect :

Clock pin : 23
Read pin : 22
Write Pin : 13

Button data

Button	Decoding bit(0-3)
Mode	1 0 0 0
Temp up	1 1 1 0
Temp down	1 1 1 1
Light	1 0 1 1
Pump 1	1 0 0 0
Pump 2	1 0 1 0
Blower	1 1 0 1

PCB fabrication

Schema

Gerber files located here: PCB Balboa-GS510SZ

Synthèse

This project appears to be an application to control a Balboa spa system using an ESP32, with a web user interface and MQTT integration. Here's a summary of the main features of your code:

• Wi-Fi Connection:
  The code handles Wi-Fi connection at startup. If Wi-Fi connection fails, the code switches to SoftAP mode to allow for configuration. A web server is configured for Wi-Fi configuration management.

• EEPROM:
  Configuration information such as SSID, password, etc., is stored in EEPROM.

• Web Server: A web server is configured with HTML pages to display the spa's status and allow configuration. Custom CSS files are also served.

• MQTT:
  The code connects to an MQTT broker with configuration information. Spa status data is published via MQTT.

• OTA (Over-The-Air):
  The code supports Over-The-Air updates, allowing wireless firmware updates.

• Balboa Interface:
  The code uses a Balboa interface to interact with the spa system. Commands are sent to the Balboa system based on user actions.

• Home Assistant Integration:
  Spa data is exposed as sensors, switches, etc., for integration with Home Assistant. Virtual buttons on the user interface trigger commands on the Balboa system.

• Timestamping:
  The ESP32 is configured to use NTP time for timestamping.

• Debugging:
  Debug information is displayed on the serial port. A specific configuration page is protected with a username and password.

• Timing Mechanism (Ticker):
  A timing mechanism (Ticker) is used to periodically check the Wi-Fi connection.

• Wi-Fi Reconnection Function:
  In case of Wi-Fi connection loss, the code attempts to reconnect.

First installation

• upload SPIFF in ESP32
• upload code generation in ESP32
• connect your wifi devices to the OpenSpa-config wifi with the password openspa2801
• call the IP address of OpenSpa-config (ex: http://192.168.4.1)
• set all information on settings page
• call the new IP address connected to your local network (ex: http://192.168.1.33)

References of great help!

• https://github.com/Shuraxxx/-Balboa-GS523SZ-with-panel-VL801D-DeluxeSerie--MQTT
• https://docs.google.com/document/u/0/d/1xuc5N6-Q7J7bQxBARYjUywhqkIFjOnh8vAHqEya5QAI/mobilebasic
• https://github.com/NickB1/OpenSpa/blob/master/documents/Balboa/Balboa_Display_Measurements.pdf
• https://www.olivierhill.ca/archives/72-The-Internet-of-Spas.html
• https://create.arduino.cc/projecthub/meljr/7-segment-led-displays-102-using-a-shift-register-6b6976

Other Balboa projects

• GL2000 Series https://github.com/netmindz/balboa_GL_ML_spa_control
• BP Series https://github.com/ccutrer/balboa_worldwide_app
• https://github.com/MagnusPer/Balboa-GS510SZ/