Skip to content

docs: plain ws, reported model, and the connector status caveat for Autel - #2076

Merged
drc38 merged 1 commit into
lbbrhzn:mainfrom
proscar87:docs/autel-plain-ws-and-status
Aug 14, 2026
Merged

docs: plain ws, reported model, and the connector status caveat for Autel#2076
drc38 merged 1 commit into
lbbrhzn:mainfrom
proscar87:docs/autel-plain-ws-and-status

Conversation

@proscar87

@proscar87 proscar87 commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #2072, which merged before I could get these into it — I'd left them as a comment there. All three come from two MaxiChargerAC units running here on OCPP 1.6-J.

The section reads as though TLS were required. Everything documented so far is the wss:// + reverse-proxy path, which is the harder setup. A plain ws://<ha-ip>:9000 on a LAN works with no certificate handling at all. The TLS instructions are worth keeping — they just needed a line saying what they're for.

The reported model, and a vendor claim worth contradicting. These report vendor Autel, model MaxiChargerAC, firmware PFA0102|V0.00.00|V1.38.00||2.4.3.0. Autel support told the owner these units don't support OCPP — that only the AC Smart Elite does. They've been running against this integration for weeks. In a document called supported devices, a vendor telling someone their hardware can't do this is precisely what stops them trying.

One automation caveat. sensor.<cpid>_status can read Available while a car is plugged in and simply not drawing; sensor.<cpid>_status_connector read SuspendedEV for the same charger at the same moment. Anything gating on plugged-in state wants the connector sensor. This came out of having two chargers in different states simultaneously — it isn't visible with one.

Documentation only, no code touched.

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation
    • Added support details for the Autel MaxiChargerAC using OCPP 1.6-J.
    • Documented required model, vendor, and firmware information.
    • Clarified connection options for local non-TLS setups and reverse-proxy configurations.
    • Added automation guidance recommending the connector status sensor for improved reliability.

…utel

Follow-up to lbbrhzn#2072, from two MaxiChargerAC units running here.

The section as merged documents only the wss:// + reverse proxy path,
which reads as though TLS were required. On a LAN a plain ws:// URL works
with no certificate handling at all, so the TLS instructions now say what
they are for.

Adds the model string the chargers actually report, and the fact that
Autel support has told an owner these units do not speak OCPP -- worth
contradicting in a document called supported-devices, since a vendor
saying "your model cannot do this" is what stops people trying.

Adds one automation caveat: sensor.<cpid>_status can read Available while
a car is plugged in and not drawing, where status_connector reads
SuspendedEV. Observed on two chargers in different states at the same
moment.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@proscar87
proscar87 deployed to continuous-integration August 14, 2026 14:02 — with GitHub Actions Active
@coderabbitai

coderabbitai Bot commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 1276e753-50e0-4bc4-aeef-d6d1d1c1183c

📥 Commits

Reviewing files that changed from the base of the PR and between e2e945d and ad596dc.

📒 Files selected for processing (1)
  • docs/supported-devices.md

📝 Walkthrough

Walkthrough

The documentation confirms MaxiChargerAC compatibility, clarifies TLS requirements for local and reverse-proxy connections, and recommends the connector-specific status sensor for automations.

Changes

Device documentation

Layer / File(s) Summary
Connection and automation guidance
docs/supported-devices.md
Documents MaxiChargerAC OCPP 1.6-J compatibility and connection requirements. Adds guidance to use the connector-specific status sensor in automations.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Merge Risk: ⚪ Minimal · up to ad596

This is a localized documentation update with no code or runtime behavior changes, so no actionable merge-blocking risk remains after normal checks and review.

Suggested reviewers: jhenkens, kinghavok

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the documentation changes for plain WebSocket connections, reported device details, and the connector status caveat.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@codecov

codecov Bot commented Aug 14, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.27%. Comparing base (e2e945d) to head (ad596dc).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #2076   +/-   ##
=======================================
  Coverage   96.27%   96.27%           
=======================================
  Files          12       12           
  Lines        3250     3250           
=======================================
  Hits         3129     3129           
  Misses        121      121           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@drc38
drc38 merged commit fa2aeed into lbbrhzn:main Aug 14, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants