Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions Firmware/simulator/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ One row per day, in short; the details are in the sections of this file (the lin

| Date | What changed |
|---|---|
| 10 Nov 2026 | Teensy page: the pretend UM982 reports its temperature (59 °C, from `HWSTATUSA`) and the module's name on the network reads `AiO-3F2A`, as the firmware now does. |
| 9 Nov 2026 | **Set up AgOpenWeb from your measures** 1.3: front corner, drawbar at the tyre, turns by headland, reasons ([the page](#set-up-agopenweb-from-your-measures)). Seed drill: 19 sections offline; short start page. [Action](#how-it-is-built) on Node 24. Check: pages in a web card's frame ([How it is built](#how-it-is-built)). |
| 8 Nov 2026 | **Set up AgOpenWeb from your measures**: a calculator that turns the tractor and implement measures into the U-turn, headland and tramline settings, with the reasons, a drawing, examples and drawbars kept off the rear tyres ([the page](#set-up-agopenweb-from-your-measures)). |
| 7 Nov 2026 | The seed drill page's four tabs and Firmware tab checked, with a made-up newer `.bin` "on GitHub"; `firmware.json` lists the seed drill `.bin` once it is on `main`; the modules' names on the network ([How it is built](#how-it-is-built)). |
Expand Down
7 changes: 5 additions & 2 deletions Firmware/simulator/sim-common.js
Original file line number Diff line number Diff line change
Expand Up @@ -342,6 +342,7 @@ function Module(key) {
L.push([9.0, "[status] GPS: RTK float (fix 5, 25 satellites, correction age 1.0 s)"]);
L.push([9.5, "[status] GPS: the receiver sends (last 5 s): " + rxTypes()]);
if (hasImu) L.push([10.0, "[status] " + h.imu + ": data OK (roll, and heading without dual antenna)"]);
if (um) L.push([11.0, "[status] GPS receiver: temperature 59 C (UM982 HWSTATUSA, first field 59493, read as thousandths of a degree)"]);
if (dual && rx.dual === "um982" && cfg.hprAcceptFloat) L.push([12.0, "[status] Dual: dual-antenna heading OK (HPR QF 5 float), sent as " + (classic ? "$PAOGI" : "$GNTHS")]);
L.push([22.0, "[status] GPS: RTK fixed (fix 4, 26 satellites, correction age 0.8 s)"]);
if (dual) L.push([22.0, "[status] Dual: dual-antenna heading OK (" + (rx.dual === "f9p" ? "second F9P, RELPOSNED, RTK" : "HPR QF 4") + " fixed), sent as " + (classic ? "$PAOGI" : "$GNTHS")]);
Expand Down Expand Up @@ -437,9 +438,11 @@ function Module(key) {
if (p === 1 && !f9p2Here()) return "none"; // GPS2 set to a second F9P, but a XIAO is there
return T() < 3 ? "wait" : "ok";
}
// the receiver's temperature (UBX-MON-SYS, polled every 10 s): the X20P answers 0 (not filled), an F9P on HPG 1.13 does not answer
// the receiver's temperature (UBX-MON-SYS, polled every 10 s): the X20P answers 0 (not filled), an F9P on HPG 1.13 does not answer;
// a UM982 answers HWSTATUSA (thousandths of a degree in its first field)
function rxTemp(p, t) {
const kind = p === 0 ? rx.kind : "ublox", fw = p === 0 ? rx.fw : "HPG 1.13";
if (kind === "um982") return t < 11 ? {tempSt: "ask"} : {temp: 59, tempSt: "ok"};
if (kind !== "ublox") return {tempSt: ""};
if (fw === "HPG 1.13") return {tempSt: t < 35 ? "ask" : "none"};
return {tempSt: t < 15 ? "ask" : "zero"}; // the X20P (HPG 2.11) answers, always with 0 (bench, 4 Nov 2026): not filled
Expand Down Expand Up @@ -493,7 +496,7 @@ function Module(key) {
const j = {fw: fwName() + " " + fwVer(), built: built(), target: "fw_teensy41", marker: "AiO-WEB-OTA-1", up: up, ip: ip(),
cpuMhz: 450, cpuTemp: r2(46.2 + wob(t, 1.5, 0.05), 1), cpuTempMax: 51.2, cpuHot: false, // the Teensy's clock and temperature (zSafety.ino)
prev: st.prev || null}; // the firmware that ran before the last update, kept in the flash (zOTA.ino otaPrevGet)
j.net = {link: true, mdns: "AiO 3F2A", aog: t >= 6, aogIp: t >= 6 ? st.net + ".10" : "0.0.0.0", host: host, hostBoth: false, helloAgo: t >= 6 ? 0 : -1,
j.net = {link: true, mdns: "AiO-3F2A", aog: t >= 6, aogIp: t >= 6 ? st.net + ".10" : "0.0.0.0", host: host, hostBoth: false, helloAgo: t >= 6 ? 0 : -1,
rtcm: rtcm, rtcmKB: r2(rtcmT * 1.31, 1), rtcmBps: rtcm ? Math.round(1310 + wob(t, 60, 0.2)) : 0, rtcmOk: Math.floor(rtcmT * 4.6), rtcmBad: t > 60 ? 1 : 0,
rtcmTypes: rtcm ? (um ? "1006 1008 1033 1075 1085 1095 1125 1230" : "1005 1074 1084 1094 1124 1230") : "",
radio: false, radioKB: 0, radioBps: 0, radioOk: 0, radioBad: 0, radioTypes: ""};
Expand Down
2 changes: 1 addition & 1 deletion Firmware/v4.5_AiO_WEB/CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,7 +98,7 @@ The files are flat, but they group into modules like the AiO 26 `lib/aio_*` fold
| `zHandlers.ino` | GGA / VTG / HPR handlers, epoch assembly, IMU heading fusion, standard / classic output, PGN 247 vehicle geometry |
| `zNMEAParser.h` | NMEA parser (Glinnes Hulden, CC0) |
| `zDualF9P.ino` | Second F9P on Serial2: UBX-NAV-RELPOSNED → dual heading and roll; its flags (refPosMiss / refObsMiss, relPosHeadingValid) explain a missing heading |
| `zReceiver.ino` / `.h` | Receiver identification (VERSIONA / UBX-MON-VER), its temperature (UBX-MON-SYS), u-blox and UM982 settings from the web page, UBX frames taken out of the stream |
| `zReceiver.ino` / `.h` | Receiver identification (VERSIONA / UBX-MON-VER), its temperature (UBX-MON-SYS; a UM982: HWSTATUSA), u-blox and UM982 settings from the web page, UBX frames taken out of the stream |
| `zRxCheck.ino` / `.h` | Receiver check: data at 460800, baud search, settings against the AgOpenGPS files |
| `zRxConfig.h` | AOGConfigOMatic settings (generated by a script, do not edit by hand) |
| `zUdpNtrip.ino`, `zRtcm.h` | NTRIP from the program (UDP 2233) to the receiver; RTCM message counter |
Expand Down
14 changes: 8 additions & 6 deletions Firmware/v4.5_AiO_WEB/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ One row per day, in short; the details are in the sections of this file (the lin

| Date | What changed |
|---|---|
| 10 Nov 2026 | A temperature that a device does not give (UM982, some u-blox firmware, an older XIAO program) now reads just *not reported* ([Identification](#identification)). |
| 10 Nov 2026 | The UM982's temperature is read (`HWSTATUSA`); one a device does not give reads *not reported* ([Identification](#identification)). Tabs and light/dark button 44 px high, 8 px corners; network name `AiO-xxxx`, with a hyphen ([Web page](#web-page)). |
| 9 Nov 2026 | The page's questions (TM171, receiver set-up, settings, firmware, restart) in its own box: the browser's pop-ups show nothing inside an AgOpenWeb web card, so those buttons did nothing there ([Web page](#web-page)). |
| 7 Nov 2026 | Add-on card (`_aowcard._tcp`) under a unique name, on the Connections card. Status cards reordered, steering settings folded into Steering; Machine tab reads the sprayer's PGN 161 (rate, alarms) ([Web page](#web-page)). Shorter notes, short headers. |
| 4 Nov 2026 | Built at **450 MHz** (cooler; the loop has time to spare). Temperatures on the cards: the Teensy with its clock ([Firmware tab](#web-page)), the u-blox [receivers](#identification), the [TM171](#imu-tm171-or-bno085) and the [XIAO](#xiao-esp32c3--esp32s3). |
Expand Down Expand Up @@ -69,13 +69,13 @@ One row per day, in short; the details are in the sections of this file (the lin

## Web page

Open `http://<module IP>/`, normally `http://192.168.5.126/` (the third number follows the subnet set in AgOpenWeb), or **`http://aio.local/`**: the module announces its name and its page by mDNS (DNS-SD `_http._tcp`, and `_aowcard._tcp` for the official AgOpenWeb's add-on cards), which works on Windows, Mac, iPhone and Linux (on many Android phones use the IP). In AgOpenWeb's web cards, ⚙ › **Search the network** lists the page within a second under the module's name on the network, **AiO** and four digits of the Teensy's own id (e.g. `AiO 3F2A`, shown on the Connections card), next to the XIAO's, the sprayer's and the seed drill's. There is no password: anyone on the module's network can open it.
Open `http://<module IP>/`, normally `http://192.168.5.126/` (the third number follows the subnet set in AgOpenWeb), or **`http://aio.local/`**: the module announces its name and its page by mDNS (DNS-SD `_http._tcp`, and `_aowcard._tcp` for the official AgOpenWeb's add-on cards), which works on Windows, Mac, iPhone and Linux (on many Android phones use the IP). In AgOpenWeb's web cards, ⚙ › **Search the network** lists the page within a second under the module's name on the network, **AiO** and four digits of the Teensy's own id (e.g. `AiO-3F2A`, shown on the Connections card), next to the XIAO's, the sprayer's and the seed drill's. There is no password: anyone on the module's network can open it.

**Another network** (not 192.168.5.x): the module keeps its subnet in the EEPROM. AgOpenWeb / AgOpenGPS change it when their subnet is set (PGN 201, the module restarts). It can also be changed by hand on the **XIAO's WiFi page** (WiFi tab → Module network), which is on WiFi whatever the module's IP is and shows the module's IP; type the first three numbers and the module restarts at the new IP. The module's own page only shows its IP (in the header): if you can open it you are on the right network already, and a wrong subnet typed there would leave the page unreachable.

Dark or light: the ☀ / ☾ button at the top (remembered by the browser), otherwise the device's setting.

Every question the page asks (write to the TM171, load the receiver's settings, switch the WAS check off, install firmware, restart…) opens in a box of the page itself, not a browser pop-up: inside an AgOpenWeb web card the browser's pop-ups show nothing, so those buttons did nothing there (official `Docs/ADD_ON_CARDS.md`: the card's frame has no `allow-modals`).
Every question the page asks (write to the TM171, load the receiver's settings, switch the WAS check off, install firmware, restart…) opens in a box of the page itself, not a browser pop-up: inside an AgOpenWeb web card the browser's pop-ups show nothing, so those buttons did nothing there (official `Docs/ADD_ON_CARDS.md`: the card's frame has no `allow-modals`). The tabs and the light/dark button at the top are 44 px high, with the same 8 px corners as that box's buttons: a size a finger hits on the cab's screen.

**Without a module:** the [simulator](https://renatorgr.github.io/Boards/) shows this page and the XIAO's with a pretend module behind them (any GPS, IMU, steering and program; tractor driving or parked), rebuilt from the code on every change. See [`Firmware/simulator`](../simulator).

Expand Down Expand Up @@ -162,9 +162,11 @@ After the receiver's first second, the Teensy asks it what it is: `VERSIONA` (UM

What goes to the program does not depend on this: a receiver that sends HPR is treated as dual antenna.

**Temperature** (since 4 Nov 2026): once a u-blox receiver is identified, the Teensy asks it for `UBX-MON-SYS` every 10 s and shows its temperature in the GNSS card (a row under the receiver) and on the GPS tab (the second F9P: in the dual-antenna card and in its check). A firmware without that message never answers (after three tries), and a receiver that answers 0 every time does not fill the field (Messages has the bytes of its first answer). The UM982 is not asked yet (Unicore's manual lists a `HWSTATUS` hardware status log; the firmware does not read it). In these cases the row reads just *not reported*, like the XIAO row when its program is older than 4 Nov 2026. A temperature that does arrive is always shown.
**Temperature** (since 4 Nov 2026): once a u-blox receiver is identified, the Teensy asks it for `UBX-MON-SYS` every 10 s and shows its temperature in the GNSS card (a row under the receiver) and on the GPS tab (the second F9P: in the dual-antenna card and in its check). A firmware without that message never answers (after three tries), and a receiver that answers 0 every time does not fill the field (Messages has the bytes of its first answer). In these cases the row reads just *not reported*, like the XIAO row when its program is older than 4 Nov 2026. A temperature that does arrive is always shown.

Seen on the bench on 4 Nov 2026: the ZED-X20P (HPG 2.11) answers with 0, the ZED-F9P on HPG 1.13 does not answer. So for now no receiver here shows a temperature; a newer receiver firmware may.
A **UM982** is asked `HWSTATUSA` (its hardware status) at the same pace, since 10 Nov 2026. The answer, as Renato's receiver (R4.10Build13495) gave it: `#HWSTATUSA,…;59493,0.914,1.025,1.805,1,-0.822,0.0,0x84,1,0x0377,0,0*6e81c92f`. After the `;` come one number, then the 0.9 V, 1.0 V and 1.8 V supplies, the clock and the hardware flags. The firmware shows that first number, divided by 1000, as the temperature in °C (59 °C here, in the closed box after 40 minutes). What could be read of Unicore's manual does not name that field, so this is a deduction, not a documented fact: the manual's own example has 66807 there, and a number that starts lower on a cold morning and climbs as the box warms confirms it. The first answer after start-up goes to Messages with the number as it came (`GPS receiver: temperature 59 C (UM982 HWSTATUSA, first field 59493, …)`), to compare a cold start with a warm one. A line with a wrong CRC is dropped, and a value outside -40 to 125 °C reads *not reported*. The poll waits while the page reads or writes the UM982's settings, and its answer stays out of the UM982 console.

Seen on the bench on 4 Nov 2026: the ZED-X20P (HPG 2.11) answers with 0, the ZED-F9P on HPG 1.13 does not answer. So of the receivers here only the UM982 shows a temperature; a newer u-blox firmware may.

### Receiver check (GPS tab)

Expand Down Expand Up @@ -393,7 +395,7 @@ The addresses only mean something with that build. Send the `.elf` too: Arduino

NativeEthernet runs the network stack (FNET) from a 1 ms timer interrupt, which could change the stack's memory in the middle of a network call from the loop (the crash at `0x0001D542`). The firmware stops that timer after `Ethernet.begin()` and runs the stack itself from the loop and in every wait for the network (`zNet.h`). NativeEthernet itself is not changed.

The mDNS responder (`aio.local`; the page announced as `_http._tcp` for the fork's **Search the network** and as `_aowcard._tcp` with TXT `v=1` and `path=/` for the official AgOpenWeb's add-on cards, `Docs/ADD_ON_CARDS.md`, both under the instance name `AiO xxxx`) is FNET's own, started after the IP is set (`mdnsStart` in `zEthernet.ino`) and run by the same polling. The four digits come from the Teensy's serial id, because the Ethernet MAC is the same on every AiO board.
The mDNS responder (`aio.local`; the page announced as `_http._tcp` for the fork's **Search the network** and as `_aowcard._tcp` with TXT `v=1` and `path=/` for the official AgOpenWeb's add-on cards, `Docs/ADD_ON_CARDS.md`, both under the instance name `AiO-xxxx`) is FNET's own, started after the IP is set (`mdnsStart` in `zEthernet.ino`) and run by the same polling. The four digits come from the Teensy's serial id, because the Ethernet MAC is the same on every AiO board.

## Main loop

Expand Down
3 changes: 3 additions & 0 deletions Firmware/v4.5_AiO_WEB/v4.5_XIAO_ESP32/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ Version 4.5, the same number as the Teensy firmware it goes with (v4.5_AiO_WEB).

| Date | What changed |
|---|---|
| 10 Nov 2026 | Tabs and the light/dark button 44 px high with 8 px corners; the WiFi tab's password to confirm in a card of its own, no longer a field across the page ([What it does](#what-it-does)). Messages give the size of an updated program, not 0 bytes. |
| 9 Nov 2026 | The page's questions (save and restart, install, the module's firmware, subnet) in its own box: the browser's pop-ups show nothing inside an AgOpenWeb web card, so those buttons did nothing there ([What it does](#what-it-does)). |
| 7 Nov 2026 | Add-on card (`_aowcard._tcp`) under the XIAO's own WiFi name ([What it does](#what-it-does)). Program → module shows up to 64 sections (PGN 229); the WiFi settings save in one row; a shorter note in the Module firmware card; short file headers. |
| 4 Nov 2026 | The XIAO's temperature in its card, here and on the Teensy page; the Teensy's clock and temperature in the [Module card](#what-it-does). |
Expand Down Expand Up @@ -63,6 +64,8 @@ Version 4.5, the same number as the Teensy firmware it goes with (v4.5_AiO_WEB).

- Changes (WiFi, update, restart) **ask for the password of the XIAO's own network**, to confirm.
- The question before each one (save and restart, install, the module's firmware, the subnet) opens in a box of the page itself, not a browser pop-up: inside an AgOpenWeb web card the browser's pop-ups show nothing, so those buttons did nothing there.
- The tabs and the light/dark button at the top are 44 px high, with the same 8 px corners as that box's buttons: a size a finger hits on the cab's screen.
- On the WiFi tab the password and **Save and restart the XIAO** have a card of their own, *Confirm and save*, as wide as the other two.
- Typed once, it is filled in both tabs until the page is closed.
- The page never shows or stores it.
- Just viewing the page needs nothing more than being on the network.
Expand Down
4 changes: 3 additions & 1 deletion Firmware/v4.5_AiO_WEB/v4.5_XIAO_ESP32/v4.5_XIAO_ESP32.ino
Original file line number Diff line number Diff line change
Expand Up @@ -540,6 +540,7 @@ static void apiScan()
// Program update: the .bin from "Sketch > Export Compiled Binary"
static bool updOk = false;
static String updErr;
static size_t updBytes = 0; // size of the program received (Update.progress() reads 0 once Update.end() has run)

// How long an upload may wait for the next data from the browser (3 Nov 2026). The web server gives up after 5 s
// (HTTP_MAX_SEND_WAIT), and a weak Wi-Fi link can pause longer than that: the upload was then cut off with nothing
Expand Down Expand Up @@ -577,6 +578,7 @@ static void updateUpload()
{
if (updErr.length() == 0)
{
updBytes = up.totalSize;
if (Update.end(true)) updOk = true;
else updErr = Update.errorString();
}
Expand All @@ -596,7 +598,7 @@ static void updateDone()
{
if (updOk)
{
logEvent("Program update: %u bytes checked, restarting", (unsigned)Update.progress());
logEvent("Program update: %u bytes checked, restarting", (unsigned)updBytes);
server.send(200, "application/json", "{\"ok\":true}");
rebootAtMs = millis() + 1500;
}
Expand Down
Loading
Loading