wiki: hub ships with a USB-to-DC-jack cable, not USB-C
The kit includes a USB-to-DC-jack cable and the shipping receiver takes power
through a DC barrel jack. The setup pages said USB-C, which would have someone
hunting the box for a cable that isn't in it.
Self-built DevKit hubs genuinely are USB-C powered, so First Boot now says
which is which. The DIY build pages are unchanged - they document the open
hardware, not what ships in the box.
307d5e0
wiki: correct TX pairing gesture and setup AP, add buyer setup track
The pairing instructions contradicted the firmware in ways that make setup
fail. The BOOT button is only read during the 10s window that opens on reset
or power-on, which we never mentioned, so the steps couldn't work on an
already-running transmitter. Pairing fires on RELEASE between 2-5s; holding
past 5s auto-triggers Wi-Fi update mode and past 15s wipes NVS, both
previously undocumented. And we described pairing as "LED pulses cyan" when
cyan is the update-mode colour — pairing blinks blue, then green.
The setup AP was wrong too: it broadcasts as TankSync-XXXX, not
TankSync-Setup-XXXX, and it's an open network. We told people to find a
password on the OLED that was never printed there because it doesn't exist.
Also corrected First Boot, which claimed an unpaired transmitter pulses cyan
every 5s and stays awake. It doesn't - an unpaired unit runs the normal sleep
cycle and gives no such signal.
New pages for people who bought an assembled kit rather than building one.
The wiki only ever documented the DIY path, and Home sent buyers to the shop
page, which is a sales page, not instructions:
Setup - Start Here, Install the Transmitter, Tank Calibration,
Pairing a Transmitter, Connect to Cloud, App Overview, App Settings,
Updating Firmware
Sidebar regrouped into "I bought a kit" / "Daily use" / "Build it yourself" /
"Reference" so the two audiences stop colliding.
ab5276d
docs: TX pairing ~3s + document TX Wi-Fi AP gesture, reconcile TX OTA paths, unified tag scheme
935807e
docs: update wiki for v3.6.6 + S3 hub + fix broken links
7b42791
Document v3.6.2 hub LED status-ring animations
- First-Boot: fix stale "setup pulses orange" (now blue breathing) + add a hub
LED ring colour legend (setup/pairing/hub-update/TX-update)
- Quick-Start: note the cyan pairing comet at the pair step
- Firmware-Versions: unified v<x.y.z> tag scheme, v3.x section + v3.6.2 highlights
f4ebb2a
Power Saving: add battery-life-by-reporting-interval guidance (deep-sleep-optimized firmware)
b3d66b4
docs: add TankSync trademark mark across wiki pages
d8275ba
Add rx-v2.8.6 + tx-v2.0.15 + PWA 1.14.4 to changelog; new sensor-selector and diagnostic-console compat rows
0b3a9d6
positioning: reframe Home around reliability + local-first thesis
51a38fa
docs: HACS-Integration walkthrough — screenshots + accurate entity list
- Fix install search term ("SmartGhar TankSync" → "SmartGhar"; the
HACS listing is multi-product, not TankSync-specific).
- Add "What it looks like in HA" section with a compact 5-up screenshot
strip (HACS listing → integration overview → device page → sensors+
events → configuration+diagnostic). Sized at width=18% each so
phone-portrait shots don't dominate.
- Explain why this matters: HA's grouping (Sensors / Events /
Configuration / Diagnostic) reflects entity-class assignments in the
integration; configuration entities are bidirectional via MQTT so
changes from HA reach the PWA within seconds.
- Rebuild entity tables to match what HA actually renders: friendly
names alongside entity_ids, separated into Sensors / Events /
Configuration (editable) / Diagnostic / Per-hub controls. Adds
entities present in the integration but missing from the doc: Water
consumed, Water volume, Fill event, Sensor stuck.
Image URLs resolve once the sync-to-public workflow mirrors
docs/firmware/screenshots/hacs/ to the public repo.
85327e2
docs: add Power-Saving page, fix broken RELEASES.md link, use generic example creds in Self-Host
- Power-Saving: new page covering MOSFET high-side switching topology
(Q3 N-FET driver + Q1/Q2 P-FETs), sleep cycle diagram with measured
current draw per phase, 80-day battery math, CN3791 MPPT solar story,
adaptive duty cycle (normal / fill-track / leak-watch / stranded),
and practical battery-extension tips.
- _Sidebar: Power-Saving linked under "Build it".
- Firmware-Versions: removed broken link to RELEASES.md (that doc lives
only on private and discusses the canary strategy — can't be mirrored).
Tag scheme + paired-release discipline summarized inline instead.
- Self-Host-Guide: replaced 'ravi' as the mosquitto example username
with the generic 'tanksync' to avoid reading like a hardcoded credential.
f964daa
docs: Wave 2 — fill empty sidebar pages
- Manual-Flashing: esptool + IDF build paths
- Troubleshooting: hub / TX / multi-hub / cloud symptom→fix lookup
- Firmware-Versions: per-binary release history + compatibility matrix
- How-TankSync-Works: sleep cycle, LoRa packet protocol, NETID isolation, MQTT topic structure
- Self-Host-Guide: HA Mosquitto + standalone Debian + Docker + TLS
Plus earlier Wave 2 updates (2-up image layout in PWA-Walkthrough +
Local-Web-UI, schematics in Wiring pages) were already pushed in fd21620.
73bd939
docs: 2-up image layout on PWA-Walkthrough + Local-Web-UI; embed schematics in Wiring pages
PWA-Walkthrough + Local-Web-UI now use <p align="center"><img width="38%"/>
<img width="38%"/></p> pairs instead of single full-width images. Half
the scrolling, natural visual pairing (light/dark variants, related
sections together).
Wiring-Reference-Hub + Wiring-Reference-Transmitter now embed the
REV 2.1 schematic PNGs (already on main at hardware/pcb/) at 95%
width, with high-res SVG + STEP-file links underneath.
fd21620
docs: fix hallucinated URLs + add Browser-Flasher / Local-Web-UI / PWA-Walkthrough
Fixed:
- home-assistant-tanksync → smartghar-homeassistant (real HACS repo)
- @RaviSinghTechposts → @ravis1ngh (real YouTube)
- smartghar.org/products/tanksync → smartghar.org/tanksync
- removed unverified /privacy + /pricing references
Added 3 new pages embedding screenshots already in the main repo:
- Browser-Flasher: WebSerial flasher walkthrough with screenshots
- Local-Web-UI: every tab (Tanks/Devices/Network/System/Cloud)
- PWA-Walkthrough: every PWA screen including light/dark variants
Hardware-Build now embeds all 9 build photos inline.
8bb180a
docs(wiki): Wave 1 — Home, Quick Start, First Boot, Hardware Build, BOM, Wiring (Hub + TX), HACS, FAQ + Sidebar
Wave 1 covers the contributor + builder onramp:
- Home: landing + documentation map
- Quick Start: browser-flasher path, 5 steps to working hub
- First Boot: what every OLED screen + LED color means
- Hardware Build: full assembly walkthrough
- Bill of Materials: sourcing + Indian rupee costs + counterfeit warnings
- Wiring (Hub) + Wiring (TX): per-pin map + wire list per board
- HACS Integration: entities, automations, troubleshooting
- FAQ: common questions, grouped
- _Sidebar: nav across all pages
Wave 2 backlog (PWA walkthrough, Local Web UI, Troubleshooting,
Self-Host) tracked in cloud/wiki-drafts/README.md (private).
808be23