—The box POSTs a heartbeat every 30 s. It is shown as offline once 90 s pass with no heartbeat. This is independent of whether this app is connected to the MQTT broker — the broker stays reachable even when the box is unplugged, which is why the two are reported separately.
Saved networks are tried in order on boot and on every reconnect. The box skips any that are not currently in range, so a dead entry costs seconds, not minutes.
The box raises its own Wi-Fi hotspot. Join
CourierBox-Setup with password 12345678, and the
setup page opens by itself. The box does this automatically after two
minutes offline — this button is for triggering it early, and needs the
box to still be reachable.
Two-step calibration: first tare with nothing on the scale, then place a known weight and calibrate. Works over MQTT from anywhere.
Remove all weight from the scale, then click Tare.
Place a known weight on the scale, enter its value in grams, then click Calibrate.
Tip: MQTT works cross-origin. HTTP fallback requires device CORS headers.
Start AP mode to add a new network from another device. The box stays connected to its current network while AP is active.
<worker>/photo/<file> via Cloudflare's HTTPS edge. The cam uploads each new snap to this URL automatically./stream (live MJPEG) and as the photo source if the Worker URL above isn't set. Only needed if you want internet-reachable live preview.Grace_5G). To switch networks, edit WIFI_SSID/WIFI_PASS in esp32-cam-firmware/src/main.cpp and re-flash. Full MQTT-driven WiFi management (like the main box has) is on the roadmap.
How long the door-lock solenoid stays energised per unlock. Trim it to the shortest time that still reliably throws the bolt — shorter pulses run cooler and extend the solenoid's life. Accepts decimals for fine tuning.
Range 0.10–10.0 s. Applies to the front-door lock (the main gate keeps its own timing). Saved on the device; the built-in default is used until you change it.
How long the door must stay closed, without a single flicker, before the box treats it as locked — only then does it announce the confirmation code and tell the app the parcel is secure. Raise it if a door resting on the catch ever counts as locked; lower it if couriers are left waiting. Any flicker restarts the hold.
Range 1.0–15.0 s, clamped on the device. Default 3.5 s. Watch Diagnostic — Last door-close judgment below while testing: it reports how many times the hold restarted, which is the number that tells you the mechanism needs a longer window rather than a luckier push.
What the light does when nothing is happening. It still comes on by itself at every unlock, stays on while the door is open and goes off 5 s after it closes — that is unchanged in all three modes.
The box fetches its sunrise and sunset times for this position once a day and caches them. It keeps using the cached times when it is offline — they drift only a minute or two a day, so even a week-old copy is within ten minutes.
Saving clears the cached times and re-fetches, so the box is never lit to the previous location's dusk. India is 330 minutes (UTC+05:30).
A cycle is one run, capped at 60 min. Min gap stops back-to-back runs when several parcels arrive together. The daily cap bounds the total and counts minute by minute while running, so an interrupted cycle still costs its budget. 0 means uncapped. Default is 10 min — long UV exposure embrittles the box's own plastics and gaskets, which is why an hour per delivery is not offered.
Playback level per kind of sound, saved on the box. Drag a slider and release to apply — each one is sent on its own, so moving Announcements never overwrites a level you have not refreshed.
Requires Device HTTP Base + CORS on device.