IntelliCenter Firmware v3.008

[tagyoureit]

Huge thanks to @jwtaylor310 for making his Intellicenter equipment available for local testing!

Let's use this thread for testing and fixing the firmware. I've already discovered a lot of great info...

1. The physical ports on Intellicenter are separate and not connected.  If the same packet is on both busses, it's because the OCP put it there.  Inbound packets on one bus are definitely not seen by the other bus.
2. The wireless has a different device type in the registration packet vs the ICP.  If a second "wireless" tries to register it will have a status of 4 (invalid?).  This explains why Pentair can't or doesn't yet support 2+ wireless devices (see next item).
3. The ICP starts by trying to register with address 32.  However, if there is already an ICP registered on address 32, the OCP assigns it address 33.  I first noticed this by exactly spoofing njsPC with the ICP registration packet and saw on the display it was called "ICP 2".  So, this means address 32 = ICP 1 and address 33 = ICP 2.  (It doesn't auto increment the address for the wireless devices.)
4. On the flip side, if an ICP (aka this app) tries to register with address 33, the OCP assigns it address 32!  It really really wants to have an ICP 1 assigned.  For every single other Pentair system we have used the default of 33 (because it was unused, primarily) and it's been fine, but that prevented us from registering as a valid ICP on the system.  
5. Holding the reset on the OCP for 10+ seconds does clear out all the registrations.  They are only kept in memory.
6. Doing a reboot on the ICP/Wireless does cause it to reregister(these were both very handy today)

I'll be working my way through the configuration pages and new features over the next few days and weeks.

[jwtaylor310]

I pulled the latest version and it appears to update more quickly than the previous version and with no new issues.

I have run into one problem which pre-exists the most recent revisions. I recently switched the Pentair firmware from v3.008 to v3.004 and then back to v3.008 again. In that process nodeJS lost its configuration and I used the Settings ... Restore function to reload an earlier configuration. Since then everything looks normal except the Spa which reports as "UNCONFIGURED". If I go into the "Bodies" tab I can edit the name to "Spa". That fixes the problem until the next configuration reload at which time it reverts to "UNCONFIGURED".

Here's a capture during which I edited the name to "Spa" and the capacity to "1000" and then did a system ... reload configuration:

replay(186).zip

[tagyoureit]

This one should have been fixed yesterday with 90b9fe7#diff-355a349fa101cf8304b382b1b9357c772811f4a4fab70810e5f8d01adb119a3aR109-R213. I saw this, too.

[jwtaylor310]

Doesn't appear to have fixed it. After updating and restarting poolController and poolController-dashPanel the initial display shows the 2nd body of water is "UNCONFIGURED". I entered "Spa" and 1,000 gallons in the app and that displayed correctly. However, after doing a "Reload Configuration" the display went back to unconfigured/0 gallons.

[tagyoureit]

After a long few days of work, 81 issues discovered and 60 fixed in v3.008 of the Intellicenter Firmware. Pretty incredible having Claude and Codex helping me with a test unit on the bench! Still more work to do...

v3.008 Issue Tracker

Generated: 2026-04-19
Source: .plan/ISSUES_INDEX.md + .plan/ISSUES*.md + .plan/ISSUES_COMPLETED*.md

Status Legend

• Open — issue is still being investigated or fix is not yet implemented
• Pending — fix implemented in code, awaiting bench/hardware verification
• Closed — fully resolved and moved to ISSUES_COMPLETED*.md
• Can't Fix — OCP firmware bug

Summary Counts

Status	Count
Open	16
Pending	1
Closed	60
Won't Fix	4
Total	81

---

By Category

Schedules

#	Status	Severity	Short Description
ISSUE-001	Closed	High	processCircuit missing case 7 for schedules 81–100
ISSUE-002	Closed	Low	_maxSchedId ordering dependency (superseded by ISSUE-003)
ISSUE-003	Closed	Critical	Off-by-one: single-byte handlers read past payload, corrupt page-boundary schedules

Pumps

#	Status	Severity	Short Description
ISSUE-005	Closed	Medium	setPumpAsync crashes on name-only PUT (typeof string comparison bug)
ISSUE-006	Closed	High	Pump circuit picklist mismatch — wrong items, OCP entries missing
ISSUE-059	Closed	Low	Pump name maxlength 15 to match OCP editor
ISSUE-060	Closed	Medium	ICv3 pump pages honor speed/flow step sizes
ISSUE-061	Closed	High	ICv3 pump speed/type updates no longer emit NaN bytes or abort Action 168
ISSUE-062	Closed	High	Pump body stale in dP/API after OCP/WL or dP change
ISSUE-064	Closed	Medium	Pump popover empty-state + non-configurable row controls
ISSUE-065	Closed	Low	VF pump config page exposes invalid Priming Speed field
ISSUE-066	Open	Medium	IntelliFlo pump address picker must only allow 1–16 (not full list)
ISSUE-067	Closed	High	Pump 5 body stale after OCP Spa→Pool change
ISSUE-068	Closed	High	Pump 5 circuits clobbered by aggregate category 4 parser path
ISSUE-076	Won't Fix	Low	VF pump tiles show RPM on main dashPanel (real Pentair Action 7 telemetry)

Bodies / Temps

#	Status	Severity	Short Description
ISSUE-012	Closed	Medium	setPoint case-sensitivity typo — NaN in body setpoint API
ISSUE-015	Closed	High	Recurring body state corruption — setPoint/heatMode fields misaligned from OCP
ISSUE-063	Closed	Medium	Bodies capacity units stale on unit changes (backend + live UI refresh)
ISSUE-073	Open	High	v3.008 body capacity stays 0 — byte offsets wrong for ICv3
ISSUE-074	Open	Medium	v3.008 Action 30 cat 13 sub 0 — equipment.type/panel.type/body.type at stale v1 offsets

Heaters / Heat Modes

#	Status	Severity	Short Description
ISSUE-011	Won't Fix	Low	OCP/WCP/ICP heat mode picklist shows only "Off" until reboot (OCP firmware)
ISSUE-032	Closed	Low	ETI250 heater type=8, heat mode val=13 — added to valueMap
ISSUE-033	Open	High	v3 heater split-layout payload offset wrong — stopTempDelta and differentialTemp
ISSUE-037	Closed	High	Heat modes wrong — not body-specific, preferred modes missing with gas heater
ISSUE-044	Closed	Medium	v3 heat mode desc overrides rename "Solar Preferred" → "Solar Only"
ISSUE-045	Closed	High	"Preferred" heat modes appear without combustion heater
ISSUE-046	Closed	Medium	cooldownDelay exposed for heat pump heater type
ISSUE-047	Open	Medium	v3 OCP doesn't broadcast heater config changes — body/type require restart
ISSUE-048	Won't Fix	Low	OCP displays ghost heat mode for Pool when all heaters Spa-only (OCP firmware)
ISSUE-049	Closed	High	setHeatModeAsync rejects MasterTemp — v1 validation name mismatch
ISSUE-050	Closed	High	setHeaterAsync rejects partial updates — requires type for any change
ISSUE-051	Closed	Medium	Heater name 16-char limit — no null terminator, garbled OCP display
ISSUE-052	Closed	High	Max-E-Therm heat mode missing from heatSources — not in dP/API
ISSUE-053	Closed	High	hybhybrid heat mode broken — val=9 collision with heatpump
ISSUE-054	Closed	Medium	Hybrid Boost Temp / Economy Time grayed out for IntelliCenter
ISSUE-055	Closed	High	v3 Heat Pump Preferred val=15, not val=25 — dP→OCP broken
ISSUE-056	Closed	High	v3 heatStatus values remapped — Cooling shown for Heating
ISSUE-057	Won't Fix	Low	OCP resets heat mode to Off on body switch (OCP firmware)

Circuits / Features

#	Status	Severity	Short Description
ISSUE-004	Open	High	njsPC does not request config from OCP — parasitic on ICP2 (state poll mitigated)
ISSUE-007	Closed	High	v3 feature/circuit state delayed ~30s — no active state poll
ISSUE-008	Closed	High	32 phantom features — Feature.initData() defaults isActive=true on transients
ISSUE-009	Closed	Medium	Feature dontStop flag not set — v3 encodes as hours>=24
ISSUE-010	Closed	Medium	Feature freezeProtect state not synced from config (Rule 18)

Circuit Groups / Light Groups

#	Status	Severity	Short Description
ISSUE-020	Closed	Medium	Circuit group eggTimer not functional when created via API/dashPanel
ISSUE-021	Closed	High	v3 circuit group toggle broken — group ID sent through Action 184
ISSUE-022	Closed	High	v3 circuit group state reverts — OCP broadcast overwrites local state
ISSUE-023	Closed	Medium	Outbound eggTimer encoding always sends 0 for minutes byte
ISSUE-024	Closed	High	v3 Action 168 circuit group payload layout shift — eggTimer at wrong offset
ISSUE-028	Closed	High	v3 circuit group toggle ignores desiredState IGNORE and misinterprets OFF
ISSUE-029	Closed	Medium	Light group colors stale — v3 sub-message mapping
ISSUE-030	Closed	High	API setLightGroupThemeAsync + v3 lightColors mismatch
ISSUE-034	Closed	High	v3 piggyback not targeted — A168 triggers category-specific refresh
ISSUE-036	Closed	High	v3 light group ON sends OFF — desiredState logic applied to light groups
ISSUE-038	Closed	Medium	Light group sequencing state not emitted — dP button not disabled during OCP lockout
ISSUE-039	Closed	Medium	Setting per-circuit color/theme to White (0) — falsy-zero encoding bugs
ISSUE-040	Closed	Medium	Palette icon click toggles circuit ON/OFF instead of opening color picker
ISSUE-042	Closed	Medium	Stuck light group action persists across restart — palette spins forever
ISSUE-043	Closed	Medium	Missing "Please Wait!" overlay on light group theme set and ON toggle

Options / General Config

#	Status	Severity	Short Description
ISSUE-013	Closed	Medium	API rename 16+ char name — no null terminator, OCP shows garbage
ISSUE-014	Open	Medium	API zip change goes to owner location, not pool config — OCP shows stale zip
ISSUE-016	Open	High	v3 Options byte offsets wrong — partial fix (cooldownDelay+pumpDelay done, 3 fields remain)
ISSUE-019	Closed	Medium	Units (English/Metric) not changeable from API on ICv3 — outbound payload fix
ISSUE-025	Open	High	v3 Options changes from OCP not propagated in real-time — requires restart
ISSUE-027	Closed	Medium	IC valve delay — wrong default and missing on/off toggle read
ISSUE-031	Open	Low	Action 30 cat 0 byte 13 marker — unknown flags, multiple observed values
ISSUE-035	Open	High	Freeze override decode/pickList fixed; A30 offset + cycle time update remain
ISSUE-041	Closed	Medium	Freeze override shows "See OCP" instead of editable dropdown
ISSUE-070	Closed	High	IntelliCenter name fields now enforce 15-char max (prevents OCP garble)

Chlorinator / Chemistry

#	Status	Severity	Short Description
ISSUE-078	Pending	High	v3.008 cat=7 sub=0 row-major stride-9 decoder + Action 168 cat=7 live-edit piggyback (awaiting bench verification)

Covers

#	Status	Severity	Short Description
ISSUE-075	Open	High	CoverMessage drops first Affected Circuit; IntelliChlor fields + Body Assignment unparsed; no /config/options/covers
ISSUE-079	Open	Medium	Cover live open/closed state not observable — blocked by missing Pentair cover expansion card; dashPanel tile also missing
ISSUE-080	Open	Medium	Add ICv3-only Controllers tab in dashPanel with cover configuration editing

Valves

#	Status	Severity	Short Description
ISSUE-069	Open	Medium	Add valves section with valve icon + diverted/not-diverted status on dashPanel homepage
ISSUE-071	Closed	Low	Valve named "Solar" bound to poolHeater (244) instead of solar (252) — config/user issue, no code bug

Equipment State / Time

#	Status	Severity	Short Description
ISSUE-017	Closed	Medium	A204 date bytes 0xFF when OCP clock="internet" with no NTP — year 255 corrupts time

IntelliCenter Comms / Alerts

#	Status	Severity	Short Description
ISSUE-072	Open	Medium	Decode OCP "Status" alert queue broadcast on RS-485 bus (badge parity)
ISSUE-077	Closed	Low	IntelliCenter v1.x Action 222 abort loop for Equipment pages 12–15 (PR #1172)

dashPanel (general)

#	Status	Severity	Short Description
ISSUE-026	Closed	Medium	dashPanel shows manualHeat/manualPriority for IC — gated in UI

OCP Firmware (not njsPC)

#	Status	Severity	Short Description
ISSUE-058	Open	Medium	OCP/local panel update not confirmed to other panels/dP (3150 vs 3250)

---

Open Issue Quick List

Prioritized by severity (Critical/High first):

1. ISSUE-004 (High) — njsPC does not request config from OCP
2. ISSUE-016 (High) — v3 Options byte offsets wrong (3 fields remain)
3. ISSUE-025 (High) — v3 Options changes from OCP require restart
4. ISSUE-033 (High) — v3 heater split-layout payload offset wrong
5. ISSUE-035 (High) — Freeze override A30 offset + cycle time update
6. ISSUE-073 (High) — v3.008 body capacity stays 0
7. ISSUE-075 (High) — Cover message parsing gaps + REST
8. ISSUE-078 (High, Pending) — v3.008 cat=7 chlorinator decoder
9. ISSUE-014 (Medium) — API zip change target wrong
10. ISSUE-047 (Medium) — v3 OCP heater config changes not broadcast
11. ISSUE-058 (Medium) — OCP panel-to-panel sync (firmware)
12. ISSUE-066 (Medium) — IntelliFlo address picker 1–16
13. ISSUE-069 (Medium) — dashPanel valves section
14. ISSUE-072 (Medium) — OCP alert queue broadcast decode
15. ISSUE-074 (Medium) — A30 cat 13 sub 0 stale v1 offsets
16. ISSUE-079 (Medium) — Cover live state (blocked by hardware)
17. ISSUE-080 (Medium) — dashPanel Controllers tab for covers
18. ISSUE-031 (Low) — A30 cat 0 byte 13 marker unknown

[jwtaylor310]

An impressive amount of work. Congrats and thank you!

Unfortunately, I ran into what I hope is a minor configuration issue when trying to restart poolContoller after updating. Multiple "Property 'targetid' does not exist on type 'Circuit'" errors. This occurring in response to "npm start".

Hopefully an easy fix!

[tagyoureit]

That's strange... I don't see these anywhere on my system or on the commit history on Git.

Either delete those two files independently:

rm controller/boards/Intellicenter_REFERENCE.ts
rm controller/boards/IntellicenterBoardPATCHED.ts

Or clean the dir with Git:

git status
# git stash -u   # if there are local changes he wants to keep
git clean -fd controller/boards/   # removes untracked files in that dir only; on just `git clean -fd` to clean all the directories

[jwtaylor310]

Deleting the two files fixed the loading problem. The "undefined" label for the Spa is also fixed and most of what I've tried so far that didn't work before now does. Good job!

[matthew-hz]

IntelliCenter i10D
Valve Expansion Module
2 i10x Expansion Panels
8 Intelliflo VSF pumps
2 Pentair heaters
10 Intellibrite lights
7 valves

Closed Firmware 3.004 Issues #1163 and will post here.

After updating to v3.004, then v3.008 and starting the poolController this was the console output when started.

pi@poolpi:~/nodejs-poolController $ npm start

nodejs-poolcontroller@9.0.0 start
npm run build && node dist/app.js

nodejs-poolcontroller@9.0.0 build
tsc

[20/04/2026, 14:54:01] info: VirtualEquipment: loaded 0 pump definitions (0 effective)
Init state for Pool Controller
[20/04/2026, 14:54:01] info: The current git branch output is master
[20/04/2026, 14:54:01] info: The current git commit output is 78dd856
[20/04/2026, 14:54:01] info: Starting up SSDP server
[20/04/2026, 14:54:01] info: Server is now listening on 0.0.0.0:4200 - 192.168.1.168:4200
[20/04/2026, 14:54:01] info: Serial port: /dev/ttyUSB0 request to open successful 9600b 8-none-1
[20/04/2026, 14:54:01] info: Checking njsPC versions...
[20/04/2026, 14:54:01] info: Starting Pool System intellicenter
[20/04/2026, 14:54:01] info: Auto-backup initialized Last Backup: 2026-04-20T14:46:08.329-0700 Next Backup: 2026-04-22T14:46:08.329-0700
[20/04/2026, 14:54:03] info: Found IntelliTouch Controller
RESETTING DATA -- Controller type changed from intellicenter to intellitouch
Pentair IntelliTouch System Detected!
[20/04/2026, 14:54:03] info: Initializing IntelliTouch Valve A
[20/04/2026, 14:54:03] info: Initializing IntelliTouch Valve B
[20/04/2026, 14:54:04] info: Requesting intellitouch configuration
[20/04/2026, 14:54:08] warn: Message aborted after 4 attempt(s): 165,1,16,33,197,1,0,1,157
[20/04/2026, 14:54:08] error: Error sending configuration request message on port 0: Message aborted after 4 attempt(s): 165,1,16,33,197,1,0,1,157 ;
RS485 Stats:{ "bytesReceived": 933 "success": 42, "failed": 1, "bytesSent": 96, "collisions": 0, "failureRate": 2.33% }
[20/04/2026, 14:54:12] warn: Message aborted after 4 attempt(s): 165,1,16,33,200,1,0,1,160
[20/04/2026, 14:54:12] error: Error sending configuration request message on port 0: Message aborted after 4 attempt(s): 165,1,16,33,200,1,0,1,160 ;
[20/04/2026, 14:54:12] info: New socket client connected oN-bIJ_0S2UJ4m84AAAB -- 192.168.1.180
[20/04/2026, 14:54:12] info: [14:54:12] 192.168.1.180 GET /state/all {}
[20/04/2026, 14:54:14] info: [14:54:14] 192.168.1.180 GET /state/all {}
[20/04/2026, 14:54:14] info: New socket client connected 3MQUIg9stkUZokNRAAAD -- 192.168.1.180
[20/04/2026, 14:54:14] info: [14:54:14] 192.168.1.180 GET /state/all {}
[20/04/2026, 14:54:17] warn: Message aborted after 4 attempt(s): 165,1,16,33,226,1,0,1,186
[20/04/2026, 14:54:17] error: Error sending configuration request message on port 0: Message aborted after 4 attempt(s): 165,1,16,33,226,1,0,1,186 ;
[20/04/2026, 14:54:17] info: [14:54:17] 192.168.1.180 GET /state/all {}
[20/04/2026, 14:54:17] info: New socket client connected G9Dpf3a0ow6eTdlFAAAF -- 192.168.1.180
[20/04/2026, 14:54:17] info: [14:54:17] 192.168.1.180 GET /state/all {}
[20/04/2026, 14:54:21] warn: Message aborted after 4 attempt(s): 165,1,16,33,202,1,0,1,162
[20/04/2026, 14:54:21] error: Error sending configuration request message on port 0: Message aborted after 4 attempt(s): 165,1,16,33,202,1,0,1,162 ;
[20/04/2026, 14:54:21] info: Last auto-backup 2026-04-20T14:46:08.329-0700 Next auto - backup 2026-04-22T14:46:08.329-0700
[20/04/2026, 14:54:25] warn: Message aborted after 4 attempt(s): 165,1,16,33,202,1,1,1,163
[20/04/2026, 14:54:25] error: Error sending configuration request message on port 0: Message aborted after 4 attempt(s): 165,1,16,33,202,1,1,1,163 ;
RS485 Stats:{ "bytesReceived": 2110 "success": 99, "failed": 2, "bytesSent": 264, "collisions": 1, "failureRate": 1.98% }
RS485 Stats:{ "bytesReceived": 2213 "success": 105, "failed": 3, "bytesSent": 276, "collisions": 1, "failureRate": 2.78% }
[20/04/2026, 14:54:29] warn: Message aborted after 4 attempt(s): 165,1,16,33,202,1,2,1,164
[20/04/2026, 14:54:29] error: Error sending configuration request message on port 0: Message aborted after 4 attempt(s): 165,1,16,33,202,1,2,1,164 ;
RS485 Stats:{ "bytesReceived": 2439 "success": 116, "failed": 4, "bytesSent": 312, "collisions": 1, "failureRate": 3.33% }
[20/04/2026, 14:54:33] warn: Message aborted after 4 attempt(s): 165,1,16,33,202,1,3,1,165
[20/04/2026, 14:54:33] error: Error sending configuration request message on port 0: Message aborted after 4 attempt(s): 165,1,16,33,202,1,3,1,165 ;
[20/04/2026, 14:54:38] warn: Message aborted after 4 attempt(s): 165,1,16,33,202,1,4,1,166
[20/04/2026, 14:54:38] error: Error sending configuration request message on port 0: Message aborted after 4 attempt(s): 165,1,16,33,202,1,4,1,166 ;
[20/04/2026, 14:54:42] info: [14:54:42] 192.168.0.10 GET /state/all {}
[20/04/2026, 14:54:42] info: New socket client connected rwSVvtf23b-MH6ICAAAH -- 192.168.0.10
[20/04/2026, 14:54:42] warn: Message aborted after 4 attempt(s): 165,1,16,33,202,1,5,1,167
[20/04/2026, 14:54:42] error: Error sending configuration request message on port 0: Message aborted after 4 attempt(s): 165,1,16,33,202,1,5,1,167 ;
[20/04/2026, 14:54:46] warn: Message aborted after 4 attempt(s): 165,1,16,33,202,1,6,1,168
[20/04/2026, 14:54:46] error: Error sending configuration request message on port 0: Message aborted after 4 attempt(s): 165,1,16,33,202,1,6,1,168 ;
RS485 Stats:{ "bytesReceived": 3798 "success": 180, "failed": 5, "bytesSent": 504, "collisions": 1, "failureRate": 2.70% }
RS485 Stats:{ "bytesReceived": 3824 "success": 182, "failed": 6, "bytesSent": 516, "collisions": 1, "failureRate": 3.19% }
RS485 Stats:{ "bytesReceived": 3948 "success": 186, "failed": 7, "bytesSent": 528, "collisions": 1, "failureRate": 3.63% }

[matthew-hz]

Haven't had time to test everything yet, but things seem to be running smoothly after the latest pull!

Edit: It looks like one of the expansion panels is missing.

Out of curiosity, why was the option to change the pump speed directly from the pumps section removed?

[tagyoureit]

Pull dashPanel again. I fixed relay pumps accidentally showing the +/- toggle but the fix was too aggressive. Thanks for finding this.

Which expansion panel is missing? Can you tell me how it's listed on you OCP. Settings->Advanced->System->Detected Hardware
vs what dashPanel shows (Hamburger menu->System)?

[matthew-hz]

Speed settings are back!

This is what it shows on the OCP. The XCP 2 panel is the one that has the items that are not showing in pool controller.

[matthew-hz]

Also, I just noticed for the XCP 1, it is only showing 9 circuits and 2 of those are showing as Pool (XP 1) and Spa (XP 1) like they are bodies.

I also moved the 2 expansion panels and pool controller adapter to the same port on the OCP. It didn't make a difference, but I thought I would try.

[tagyoureit]

I pushed up a fix for the 3rd expansion panel not registering. But if that doesn't work then I'd like to ask you to do some different captures with just the base i10d, then all the combinations of expansion cards (one, two with one in each slot, and then three in all slots). But hoping this works.

For the pool/body circuits, pull the latest fix and then do a packet capture with configuration reload and this will reset the baseline (or stop the app and manually delete ./data/pool*.json files).

[jwtaylor310]

FYI, Pentair sent a service person to address my controller's intermittent "156 degree water temperature and simultaneous Freeze Mode" issue. He updated the firmware to 3.011 with the statement that it fixed "lots of bugs". As far as I know, that version is not yet available on the Pentair web site.

[tagyoureit]

Interesting... yes, we will have to wait for it to be made public. Note that now this app and your OCP may have some oddities that others don't experience.

[tagyoureit]

Just to update... 40+ bug fixes in 9.0 and 9.1! And, as a preview, I'm working on direct network connection to Intellicenter. Stay tuned!

Unreleased

IntelliCenter v3 local WebSocket transport (foundation).

New Features

1. New comms type ocpws for IntelliCenter v3 OCP local WebSocket on port 6680. Selectable from dashPanel alongside Local / Network / ScreenLogic / Mock. Mutually exclusive with all RS-485-style transports — opening WS closes RS-485 ports and vice versa, with a hard guard in Comms.queueSendMessageAsync that refuses to put any RS-485 frame on the wire while WS is the active transport.
2. mDNS discovery for IntelliCenter OCP via new IntelliCenterWSComms.searchAsync() and REST endpoint GET /config/options/ocpws/search. Filters _http._tcp.local for Pentair -i -n<alias> services and returns [{alias, host, port}].
3. WebSocket client with JSON envelope ({command, messageID, objectList}), request/response correlator keyed by messageID, configurable timeout, auto-reconnect, and RequestParamList subscription manager that re-subscribes after reconnect.
4. New REST endpoints: /config/options/ocpws/search (mDNS browse), /config/options/ocpws/test (one-shot probe), /config/options/ocpws/stats (live stats). Stats stream pushed on socket.io channel icwsStats.
5. dashPanel: new "IntelliCenter Network" port type, host/port/discovery panel with Discover and Test buttons, stats subscription wired into the homepage badge.

Security

6. The OCP local WebSocket has no authentication — any LAN device can read or write the full system, including PIN-based PERMIT roles in plaintext (see .plan/209f-system-clock-security.md). Operators must treat port 6680 as trusted-LAN-only and never expose it to the internet. Documented in README.

Notes

• This release ships the transport foundation only: discovery, connect/disconnect lifecycle, mutual exclusion, request/subscribe primitives, and dashPanel surface. Translators that mirror Action 30 sub-handlers and rewiring of IntelliCenterBoard outbound writes (Action 168/184/222/228/251) are tracked separately and ship in a follow-on PR.
• Out of scope: Regal/Neptune Modbus pumps remain on their existing direct-Modbus path (never on the IC bus).

9.1.0

IntelliCenter security rationalization, JXi/LXi heater support, virtual IntelliChem, and various fixes.

Security

1. IntelliCenter v3 PIN-based security: full role management with up to 9 roles, 22-section granular permissions, session timeout with activity tracking, and server-side write protection on /config/* routes.
2. dashPanel security integration: Guest mode auto-session on page load, "Guest" badge, config tab gating by permission bitmask, dashboard widget permission gating (bodies, circuits, lights, chemistry, pumps), PIN dialog via lock icon, and session timeout auto-revert.
3. Permission bit map empirically verified against OCP firmware (bit order differs from OCP display order).

New Features

4. Jandy JXi/LXi heater RS485 protocol support with fault message handling (Direct connect to Jandy JXI heater? #1128).
5. Virtual IntelliChem support with alarm sync and API routes for testing without hardware.
6. Virtual chlorinator support with full emulation of chlorinator protocol responses.
7. Chlorinator comms-lost alert from Action 204 byte 34.
8. Configurable single mixing period option for chemistry controllers (Chemistry: add optional singleMixPeriod gating #1181). Thanks to @johnny2678.
9. IntelliBrite light sequencing delay detection: OCP/ICP "gray-out" state now propagates to dashPanel via inbound A184 channel 0x94AF decode. Circuit button dims and disables clicks during theme sequencing.
10. v3 light group Swim/Set/Sync commands: dashPanel triggers via v3 A184 protocol (channel 0x58A3, target 0x8AB1) instead of v1 rapid-toggle sequencing. Group and member circuits show disabled state until OCP confirms completion.
11. Automatic lat/lon resolution from zip code: heliotrope sunrise/sunset calculations now fall back to a bundled US zip code coordinate table when latitude/longitude are not explicitly configured or provided via environment variables.
12. Alert notification management: full PUT /config/alerts endpoint for all 7 alert categories (circuits, pumps, ultratemp, chlorinator, intellichem, hybrid, connected gas) with Select All / Select None support. dashPanel pnlAlerts config UI with per-category accordion, checkbox list, and real-time selected/total counts.
13. ICP→dashPanel alert sync: alert notification changes made on ICP now propagate to dashPanel in real-time via A168 cat=13 piggyback handler in the v3 early-return guard (same pattern as ISSUE-073 body capacity).
14. v3 delay configuration: freeze cycle time, valve delay, and cooldown delay now decoded from A30 cat=0 sub=0 and writable via A168. dashPanel Delays panel binds valveDelay for ICv3 (was pumpDelay). Cancel delay endpoint added (PUT /state/cancelDelay).
15. v3 Timed Service Mode (Timeout) detection from A204 byte 9 bit 1.
16. Remote control configuration: virtualCircuits byteValueMap corrected for remote button context with missing entries added (All Lights On/Off, Pool Heat Enable). dashPanel iS10 body selection locked to Spa.
17. Cover configuration fixes: circuit IDs corrected for 0-indexed wire protocol, body flags bit 3 polarity fixed (set=Spa not Pool), dashPanel cover config excludes Pool/Spa body circuits. Homepage Covers section added with valve-style widget.
18. v3 circuit group toggle fix: API now sends on correct A184 channel (0x58A3 instead of 0x688F). ICP-initiated light group theme changes propagate sequencing state to dashPanel.
19. Freeze protection manual override detection: A204 byte[47] decoded as per-body override bitmask (bit 0=Pool, bit 1=Spa). New manualFreezeOverride boolean on body state distinguishes normal freeze cycling from user-initiated override. Smart body toggle forces ON during freeze (prevents accidental OFF).
20. dashPanel freeze protection UI: green indicator for freeze cycle, blue for manual override, subtitle text ("Freeze Cycle" / "Manual Override"), enhanced banner with per-body override detail.

Bug Fixes

21. IntelliCenter v3 circuit/light group eggTimer offset regression: outbound A168 cat=6 now sends 45-byte payload with eggTimer at bytes 40-41 (was incorrectly at 38-39). Inbound ExternalMessage.processGroupSettings also reads v3 offset. Added processEggTimer protection guard against OCP overwriting valid local values with 0.
22. IntelliCenter V3 chlorinator: fixed payload format, improved superChlor handling, debounced spurious 255 values.
23. JXi burner-on status: use bitmask check instead of equality for reliable detection.
24. JXi/LXi heater: default RS485 address to 0x68/0x38.
25. EquipmentStateMessage: header byte check to disambiguate IntelliCenter from IntelliTouch i9+3 (IntelliTouch i9+3 Rev B detected as IntelliCenter over RS-485 #1179).
26. IntelliCenterBoard: process 3rd power center expansion modules correctly (IntelliCenter Firmware v3.008 #1171).
27. Chlorinator ID fallback when useChlorinator is true in setORPAsync. Thanks to @johnny2678 — PR #1178.
28. Hayward remote control handler: fix no-op catch (Pump: fix no-op catch in Hayward remote control handler #1182).
29. ChemDoser: simplify singleMixPeriod loop.
30. IntelliCenter v3 expansion panel decoding and plugin address management improvements.
31. Schedule calculation crash when heliotrope invalid: calcAdjustedTimes now guards against undefined dt and missing lat/lon; calcSchedule null-checks endTime before calling .getTime().
32. Schedule nsod (tomorrow start-of-day) was calculated as yesterday due to copy-paste typo (addHours(-24) → addHours(24)).
33. Alert bitmask mixed endianness: 4-byte selectors (IntelliChem, Hybrid) use little-endian while 1-2 byte selectors use big-endian. Encode (maskToBytes), decode (extractAlertMask), and piggyback decode (applyAlertNotificationFromExternal) all branch on byte count.
34. A168 cat=11 security role write: fixed phantom duplicate creation from incorrect byte[2] and trailing bytes.
35. dashPanel Save Remote response wrapper not unwrapped — dataBind crash on type.desc fixed.
36. dashPanel freeze state race condition: body socket event fires before A204 byte[47] decode completes. Controller state/all handler now updates body labels and indicators atomically from the authoritative snapshot data.
37. RunOnce schedule type: skip recalc check that incorrectly expired one-shot schedules.

9.0.0

Focused release on IntelliCenter v3.008 firmware compatibility, finishing the v3 work started in 8.4.1, plus the Regal Century pump Modbus fixes.

1. IntelliCenter v3.008 chlorinator support: row-major stride-9 decoder for Action 30 cat=7 sub=0 payloads and live-edit piggyback on Action 168 cat=7.
2. v3 state polling so feature and circuit changes from the panel appear in dashPanel within seconds instead of ~30s.
3. v3 heater management: ETI250 (type 8), expanded heater type/mode coverage, and improved control-path handling.
4. v3 body handling: body capacity updates from ExternalMessage and enhanced unit handling.
5. v3 light group state management improvements (sync-back, theme/color updates, stuck-action clearing).
6. v3 firmware change detection so configuration reloads when the OCP firmware version shifts.
7. Circuit management enhancements in IntelliCenterBoard and CircuitCommands; getCircuitFunctions retains pool/spa options across call sites.
8. Virtual equipment management with new API endpoints.
9. Equipment item queuing refactor in IntelliCenterConfigQueue for v3 compatibility.
10. Regal (Century) Modbus pump now supported as equipment in Nixie: improved collision detection, header validation via pumpTypes (accepts messages only from configured RegalModbus pumps), and NACK/fault response handling on Go/Stop commands (0x41/0x42). Thanks to @celestinjr — PR #1169.

[jwtaylor310]

*** UPDATE:
The following is for reference. Since posting it I did a clean install and that completed without a problem.

---

I'm having trouble updating. Here's my first attempt::

pi@raspberrypi:~/nodejs-poolController $ git pull
hint: Pulling without specifying how to reconcile divergent branches is
hint: discouraged. You can squelch this message by running one of the following
hint: commands sometime before your next pull:
hint:
hint: git config pull.rebase false # merge (the default strategy)
hint: git config pull.rebase true # rebase
hint: git config pull.ff only # fast-forward only
hint:
hint: You can replace "git config" with "git config --global" to set a default
hint: preference for all repositories. You can also pass --rebase, --no-rebase,
hint: or --ff-only on the command line to override the configured default per
hint: invocation.
Updating fb67a2d..8961410
error: Your local changes to the following files would be overwritten by merge:
package-lock.json
Please commit your changes or stash them before you merge.

I tried renaming package-lock.json and tried again:

hint: Pulling without specifying how to reconcile divergent branches is
hint: discouraged. You can squelch this message by running one of the following
hint: commands sometime before your next pull:
hint:
hint: git config pull.rebase false # merge (the default strategy)
hint: git config pull.rebase true # rebase
hint: git config pull.ff only # fast-forward only
hint:
hint: You can replace "git config" with "git config --global" to set a default
hint: preference for all repositories. You can also pass --rebase, --no-rebase,
hint: or --ff-only on the command line to override the configured default per
hint: invocation.
Updating fb67a2d..8961410
error: Your local changes to the following files would be overwritten by merge:
.gitignore
AGENTS.md
Changelog
README.md
controller/Constants.ts
controller/Equipment.ts
controller/State.ts
controller/boards/AquaLinkBoard.ts
controller/boards/EasyTouchBoard.ts
controller/boards/IntelliCenterBoard.ts
controller/boards/NixieBoard.ts
controller/boards/SystemBoard.ts
controller/comms/Comms.ts
controller/comms/messages/Messages.ts
controller/comms/messages/config/CircuitGroupMessage.ts
controller/comms/messages/config/CoverMessage.ts
controller/comms/messages/config/EquipmentMessage.ts
controller/comms/messages/config/ExternalMessage.ts
controller/comms/messages/config/GeneralMessage.ts
controller/comms/messages/config/OptionsMessage.ts
controller/comms/messages/config/ScheduleMessage.ts
controller/comms/messages/config/SecurityMessage.ts
controller/comms/messages/status/ChlorinatorStateMessage.ts
controller/comms/messages/status/EquipmentStateMessage.ts
controller/comms/messages/status/HeaterStateMessage.ts
controller/comms/messages/status/IntelliChemStateMessage.ts
controller/comms/messages/status/VersionMessage.ts
controller/nixie/chemistry/ChemController.ts
controller/nixie/chemistry/ChemDoser.ts
controller/nixie/chemistry/Chlorinator.ts
controller/nixie/heaters/Heater.ts
controller/nixie/pumps/Pump.ts
Please commit your changes or stash them before you merge.
error: The following untracked working tree files would be overwritten by merge:
2026-05-11_12-17-18.zip
controller/comms/IntelliCenterWS.ts
Please move or remove them before you merge.
Aborting

I'm not sure how to proceed....