百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
N

nodejs-poolController

> 编程语言
开源

一个用于从各个制造商控制池设备的应用程序。

400 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

一个用于从各个制造商控制池设备的应用程序。

nodejs-poolController (njsPC)

Local, open-source control for Pentair IntelliCenter / IntelliTouch / EasyTouch, Jandy Aqualink, Hayward, and standalone pool equipment. A self-hosted alternative to the Pentair Home and ScreenLogic cloud apps — your data stays on your network, your pool responds in real time, and your smart home can finally see it.

  • Works with your gear — IntelliCenter (through firmware v3.008), IntelliTouch, EasyTouch, SunTouch, Aqualink, IntelliCom, or no controller at all (Nixie mode).
  • Plugs into your smart home — HomeKit/Siri (via Homebridge), Home Assistant (via MQTT), Hubitat, SmartThings, MQTT, InfluxDB, Alexa.
  • No cloud required — runs on a Raspberry Pi, NAS, or any Node.js 22+ host. Pairs with dashPanel for a web dashboard and REM for direct GPIO/i2c/SPI hardware I/O.

UI pictured: dashPanel, the recommended web client.

Quick start (Docker): see Docker Compose — one file, docker compose up -d, done. Quick start (source): git clone → npm install → npm start. Full steps in Installation. Hardware needed: an RS-485 adapter (or a ScreenLogic network connection) to talk to your equipment.

In the wild: featured in the TroubleFreePool IntelliCenter walk-through guide (thanks @MyAZPool). Actively maintained — questions welcome in GitHub Discussions.

diff
+ NEW in 10.0: IntelliCenter WebSocket protocol — control your pool over
+ the local network with no RS-485 adapter. Just plug in Ethernet.
+ If anything looks off, please open a discussion with a replay capture.

What is njsPC?

njsPC is a Node.js service that talks to your pool controller over RS-485 (or ScreenLogic) and exposes everything — circuits, bodies, pumps, heaters, chlorinators, chemistry, lights, covers, valves, schedules — as a live REST + WebSocket API. Point a web client at it for a browser UI, or wire it into home automation so your pool shows up next to your lights and thermostats.

  • Want to add a low-cost controller to your pool?
  • Want a modern web interface for your existing system?
  • Want to turn pumps on remotely, or schedule them on sunrise/sunset?
  • Want your home automation hub to read and control your pool?
  • Want to run pumps or a chlorinator with no pool controller at all?

Equipment supported

Category Supported Notes
Controllers IntelliCenter, IntelliTouch, EasyTouch, SunTouch, Aqualink, IntelliCom, Nixie (standalone) RS-485, ScreenLogic (network), or IntelliCenter local WebSocket (new in 10.0 — no adapter needed)
Pumps IntelliFlo VS / VSF / VF, IntelliFlo VS+SVRS, SuperFlo VS, Hayward Eco/TriStar VS, Hayward Relay VS, Whisperflo, single/two-speed, relay-controlled, Neptune Modbus, Regal (Century) Modbus Regal added in 9.0 — PR #1169
Heaters Gas, solar, heat pump, hybrid (ETi / ETi250), MasterTemp, Max-E-Therm, UltraTemp / UltraTempDirect, Jandy JXi / LXi JXi/LXi added in 9.1 — discussion #1128
Chlorinators IntelliChlor, Aqua-Rite, OEM brands (physical and virtual) Dual chlorinators supported via REM. Virtual chlorinator added in 9.1
Lights IntelliBrite, MagicStream, Jandy WaterColors, Hayward ColorLogic, Pooltone (Florida Sunseeker), plus legacy SAM / SAL / Color Wheel / Photon Gen
Chemistry IntelliChem (OCP-paired, standalone, and virtual), Relay Equipment Manager (REM) Atlas Scientific pH / ORP / EC probes, flow, pressure, temperature via REM. Virtual IntelliChem added in 9.1
Covers IntelliCenter cover configuration & control Live-state feedback is limited on ICv3
Filters Configuration, pressure monitoring, clean/dirty thresholds
Valves Standard intake/return with diverted status Intellivalve planned
Home Automation HomeKit/Siri (Homebridge), Home Assistant (via MQTT), Hubitat, SmartThings, MQTT, InfluxDB, ISY, Vera, Alexa See Home Automation Bindings

What's new in 10.0

IntelliCenter WebSocket Protocol — Communicate Without RS-485 Hardware.

For the first time, njsPC can talk to IntelliCenter v3.004+ controllers over the local network using Pentair's native JSON WebSocket protocol on port 6680. No RS-485 adapter, no serial wiring — just Ethernet. This is a complete alternative communication path with full bidirectional config, live state push, and equipment control.

  1. Full WebSocket transport — new comms type ocpws with mDNS auto-discovery, JSON request/response protocol, and live NotifyList push subscriptions. Selectable from dashPanel alongside all existing transport types.
  2. No hardware required — IntelliCenter v3.004+ owners can control their pool with just an Ethernet cable to the OCP. Select "IntelliCenter Network" in dashPanel, hit Discover, and connect.
  3. Complete config loading over WS — all equipment configuration (circuits, bodies, pumps, heaters, schedules, chemistry, valves, covers, remotes, security) loaded via GetParamList queries over WebSocket.
  4. Bidirectional control — circuit toggle, body heat mode/setpoint, schedule changes, and light commands sent as SetParamList writes. Real-time state changes received via subscriptions.
  5. Architecture refactoring — IntelliCenter board split into dedicated IntelliCenterV1Board (RS-485 v1.x), IntelliCenterWSBoard (WebSocket mode), and shared base. Board swaps dynamically at runtime when you change transport type.
  6. Pump error code parsing — pump errors now decoded into human-readable descriptions with state tracking (#1197).
  7. EasyTouch Dimmer support — Dimmer circuit type (type 8) with RS-485 level control via action 134 (#1203).
  8. 14 bug fixes — Jandy DLE byte-stuffing, schedule endTime midnight rollover, EasyTouch v3 detection regression, Docker container bindings, and more.
  9. Integration test infrastructure — full vitest suite with OCP WebSocket mock, golden snapshot fixtures, and development utility scripts.

See the full Changelog for all 33 items in 10.0.

What was new in 9.1

9.1 adds IntelliCenter security, Jandy JXi/LXi heater support, virtual chemistry equipment, and a batch of v3.008 refinements.

  1. IntelliCenter security — full PIN-based role management (up to 9 roles, 22-section granular permissions) with session timeout, server-side write protection, and dashPanel integration (guest mode, lock icon, per-widget gating).
  2. Jandy JXi / LXi heater protocol — RS-485 support with fault message handling, bitmask burner-on detection, and correct default addresses (discussion #1128).
  3. Virtual IntelliChem — alarm sync and API routes for testing chemistry without hardware.
  4. Virtual chlorinator — full emulation of chlorinator protocol responses.
  5. Alert notification management — PUT /config/alerts endpoint for all 7 alert categories with dashPanel accordion UI and ICP→dashPanel real-time sync.
  6. v3 light sequencing — IntelliBrite gray-out state propagates to dashPanel during theme changes; light group Swim/Set/Sync uses v3 A184 protocol.
  7. Freeze protection — manual override detection (per-body bitmask), smart body toggle, and dashPanel freeze/override indicators.
  8. v3 delay configuration — freeze cycle time, valve delay, and cooldown delay decoded and writable; cancel delay endpoint added.
  9. Remote control & cover configuration — virtualCircuits byteValueMap corrected, cover circuit IDs fixed, homepage Covers section added.
  10. Zip-to-coordinates fallback — heliotrope sunrise/sunset calculations now resolve lat/lon from zip code when not explicitly configured.
  11. Configurable single mixing period for chemistry controllers — thanks to @johnny2678 (PR #1181).
  12. IntelliCenter/IntelliTouch i9+3 disambiguation fix (#1179), 3rd power center expansion fix (#1171), chlorinator ID fallback fix — thanks to @johnny2678 (PR #1178).

What was new in 9.0

9.0 focused on IntelliCenter v3.008 firmware compatibility and finished the v3 work started in 8.4.1.

  1. IntelliCenter v3.008 chlorinator support, including live-edit changes coming back from the panel.
  2. Faster state updates on v3 — circuit, feature, and body changes made at the panel now appear in dashPanel within seconds.
  3. v3 heater enhancements, including ETi250 support and broader heater control coverage.
  4. v3 body and unit handling improvements, so capacity and English/Metric changes stay in sync between njsPC and the OCP.
  5. Light group state fixes: themes, colors, and ON/OFF transitions sync correctly with the panel.
  6. Firmware change detection — njsPC reloads its configuration automatically when the OCP firmware version changes.
  7. Virtual equipment management with new REST endpoints.
  8. Regal (Century) Modbus pump added, with collision detection and NACK/fault handling on Go/Stop commands — thanks to @celestinjr (PR #1169).

For earlier releases (8.4.x, 8.3, 8.1, 8.0, 7.x and before), see the Changelog.

Installation Instructions

Before you start — hardware required njsPC needs a way to reach your pool bus:

  • RS-485 adapter (recommended) — see the adapter details wiki.
  • ScreenLogic (network connection) — if you already have a Pentair ScreenLogic box on your network.
  • IntelliCenter v3 local WebSocket (network connection, no adapter) — see Local Network Comms (IntelliCenter v3) below.
  • Socat — to bridge a remote serial device, see the Socat wiki.

Local Network Comms (IntelliCenter v3)

IntelliCenter v3.004+ exposes a JSON WebSocket API on port 6680 of the OCP. njsPC can use this as an alternative to RS-485 — no adapter, no wiring. Configure it from the dashPanel comms page by selecting port type IntelliCenter Network, hitting Discover to mDNS-browse the LAN, and Save.

Prerequisites

  • The OCP must have ethernet connected and "Web and Mobile Interface" enabled in OCP settings.
  • v3.004 firmware or newer.
  • Your njsPC host must reach the OCP on port 6680 over the LAN (no firewall in between, no routing across subnets unless you've explicitly allowed it).

How it works

  • Discovery — mDNS browse for Pentair -i -n advertised under _http._tcp.local. The Discover button calls GET /config/options/ocpws/search.
  • Bootstrap — on connect, njsPC issues a GetParamList objnam:"ALL" to enumerate the panel and a RequestParamList to subscribe for live NotifyList push updates.
  • Mutual exclusion with RS-485 — only one transport is ever live at once. When you switch to IntelliCenter Network, all RS-485 ports are closed; switching back closes th

Issues· 29 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

TypeScriptchlorinatoreasytouchichlorintellicenter

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言