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
3 changes: 2 additions & 1 deletion 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 |
|---|---|
| 13 Nov 2026 | **Set up AgOpenWeb from your measures** (version 1.6): the measured noses of the Maxxum (1 m) and the Farmall (0.85 m), and Renato's own one-axle manure spreader ([the page](#set-up-agopenweb-from-your-measures)). |
| 12 Nov 2026 | **Set up AgOpenWeb from your measures** (version 1.5): buttons for Renato's Farmall 115C, Maxxum 135 and Puma 180; a drawbar implement takes the tractor's pin ([the page](#set-up-agopenweb-from-your-measures)). [Action](#how-it-is-built) on `ubuntu-26.04`. |
| 11 Nov 2026 | `build.py` leaves the pages' own build date (`PAGE_BUILT`) empty, so the pages' new "is this the running firmware's page" check stays off here. The pretend Keya reports its current in amps, the kickout sensor. |
| 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. |
Expand Down Expand Up @@ -64,7 +65,7 @@ To run it on your own computer: `python3 Firmware/simulator/build.py` and open `

## Set up AgOpenWeb from your measures

**https://renatorgr.github.io/Boards/aow-settings/** is not a module page: a calculator. Choose the machine (a tractor, an articulated one that bends at its joint, a harvester steered from the back, each with its own turning geometry), type its wheelbase, the angle on the stop and the overhang, and the implement as AgOpenWeb's Tool page has it (front fixed, rear fixed, trailing or TBT, the sections and their width, the overlap, the tool offset, the hitch, trailing hitch and pivot distances, the implement length), and it suggests what to put in AgOpenWeb's Vehicle & Tool page, each value with its reason, and draws the turn from above: the U-turn radius, the turn style and the rows to skip, the distance from boundary, the headland width, the extension, the Go around radius and the tramline passes. Three tractor buttons, by power, fill in Renato's Case IH Farmall 115C (2.3 m, about 45°, 540/65 R34 tyres, its drawbar pin 0.74 m behind the rear axle), his Maxxum 135 (2.7 m, 42°) and his Puma 180 CVX (2.88 m and 33° from its manual's turning circle, 2 m track, 650/65 R42 tyres, its pin 0.9 m back); an implement on the drawbar moves to the chosen tractor's pin. It opens on the Maxxum with his 8 m sprayer on the front linkage; a second button fills in his semi-mounted 3 m no-till drill (its pivot behind the lower links, its wheels behind the discs). Three more buttons have typical measures: a manure spreader on two axles (measured to the middle between them; its beaters swing out as the tractor straightens), a trailed disc harrow and a 4-furrow reversible plough on the 3-point linkage, drawn with a K-turn since a plough skips no rows. A long implement's rear corner (its length) is followed through the turn too: a K-turn backs it towards the edge first. A trailed implement's drawbar must stay off the rear tyres: from the hitch pin, the drawbar's width, the rear track and the tyres' width and height, the page finds the angle where the drawbar touches a tyre and keeps the turn 5° under it; the tyre counts at the drawbar's height (a field, 0.5 m by default), where it is shorter than at its axle, so the drawbar touches it later than the whole wheel would say. A drawbar pin inside the tyres' back edge touches them long before 90° and then sets the radius; a semi-mounted implement's pivot, further back, does not, but its own stop may: a field takes the most the drawbar may turn to each side, from its stop or from what the farmer knows. Two more buttons hold Renato's quick disc harrow on the 3-point linkage and his semi-mounted roller (120° of swing in all), their measures guessed until he takes them. A rigid implement is measured with a tape from the axle nearest to it (a front sprayer from the front axle); AgOpenWeb measures it from the pivot, so for a front implement on a tractor the page adds the wheelbase and shows the hitch length to type in.
**https://renatorgr.github.io/Boards/aow-settings/** is not a module page: a calculator. Choose the machine (a tractor, an articulated one that bends at its joint, a harvester steered from the back, each with its own turning geometry), type its wheelbase, the angle on the stop and the overhang, and the implement as AgOpenWeb's Tool page has it (front fixed, rear fixed, trailing or TBT, the sections and their width, the overlap, the tool offset, the hitch, trailing hitch and pivot distances, the implement length), and it suggests what to put in AgOpenWeb's Vehicle & Tool page, each value with its reason, and draws the turn from above: the U-turn radius, the turn style and the rows to skip, the distance from boundary, the headland width, the extension, the Go around radius and the tramline passes. Three tractor buttons, by power, fill in Renato's Case IH Farmall 115C (2.3 m, about 45°, 540/65 R34 tyres, its drawbar pin 0.74 m behind the rear axle), his Maxxum 135 (2.7 m, 42°) and his Puma 180 CVX (2.88 m and 33° from its manual's turning circle, 2 m track, 650/65 R42 tyres, its pin 0.9 m back); an implement on the drawbar moves to the chosen tractor's pin. It opens on the Maxxum with his 8 m sprayer on the front linkage; a second button fills in his semi-mounted 3 m no-till drill (its pivot behind the lower links, its wheels behind the discs). Renato's manure spreader has one axle 4.2 m behind the drawbar pin and its body ends 1.5 m past the axle. Two more buttons have typical measures: a trailed disc harrow and a 4-furrow reversible plough on the 3-point linkage, drawn with a K-turn since a plough skips no rows. A long implement's rear corner (its length) is followed through the turn too: a K-turn backs it towards the edge first. A trailed implement's drawbar must stay off the rear tyres: from the hitch pin, the drawbar's width, the rear track and the tyres' width and height, the page finds the angle where the drawbar touches a tyre and keeps the turn 5° under it; the tyre counts at the drawbar's height (a field, 0.5 m by default), where it is shorter than at its axle, so the drawbar touches it later than the whole wheel would say. A drawbar pin inside the tyres' back edge touches them long before 90° and then sets the radius; a semi-mounted implement's pivot, further back, does not, but its own stop may: a field takes the most the drawbar may turn to each side, from its stop or from what the farmer knows. Two more buttons hold Renato's quick disc harrow on the 3-point linkage and his semi-mounted roller (120° of swing in all), their measures guessed until he takes them. A rigid implement is measured with a tape from the axle nearest to it (a front sprayer from the front axle); AgOpenWeb measures it from the pivot, so for a front implement on a tractor the page adds the wheelbase and shows the hitch length to type in.

The rules are AgOpenWeb's own (its `SagittaTurnGeometry`, `YouTurnCreationService` and `VehicleToolLimits`): the turn is drawn by the tractor's pivot, which must stay inside the field edge pulled in by the distance from boundary; a pass closer than twice the radius needs a loop (Sagitta or Keyhole), skipped rows or a K-turn (AgOpenWeb drives a 126° arc and a straight tail; as soon as the tractor reverses the turn is over for AgOpenWeb and its guidance is on the next pass, backing up too, so the tractor backs up until it is on that pass and straight; a trailed implement that would jackknife backing up gets no K-turn), a pass at twice the radius or more gets a plain semicircle. The radius is 1.2 × the tightest the machine can do (wheelbase ÷ tan of the steering angle; an articulated machine (wheelbase ÷ 2) ÷ tan of half the articulation angle), never under 4 m; the distance from boundary keeps what sweeps the widest in the turn, the outer corner of the tractor's nose (half the machine's width, from its rear track and tyres, out from the centre line) or the implement's outer end, a safety margin inside the edge (1 m by default, a field of the page: more where the edge is irregular); each turn is followed step by step every 10 cm, with the implement (a trailed one following its hitch without side slip) and the machine's far end, and the headland is the turn's depth plus that distance plus how far back into the field anything not yet straight on a pass reaches (the implement finishing its pass, a front implement or a trailed one until it is straight on the next pass, a K-turn's tail), in whole passes. The drawing shows the pivot's path, both ends of the implement and the outer corner of the machine's far end. What is not geometry (the section timing, the steering gains, the antenna position) is not suggested.

Expand Down
20 changes: 10 additions & 10 deletions Firmware/simulator/aow-settings/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="color-scheme" content="dark light">
<title>Set up AgOpenWeb from your measures</title>
<script src="settings.js?v=1.5"></script> <!-- the version in the address: a browser that kept the old file fetches the new one -->
<script src="settings.js?v=1.6"></script> <!-- the version in the address: a browser that kept the old file fetches the new one -->
<style>
:root{color-scheme:dark;--bg:#121511;--card:#1b1f1a;--ink:#e7ebe3;--mute:#9aa395;--line:#2e352b;--warn:#ffb74d;--acc:#8cc068;--accInk:#10140f;--soft:#232a21;--pass:#4a5a44;--fence:#e06c5a;--tool:#6aa4d9}
@media (prefers-color-scheme:light){:root{color-scheme:light;--bg:#f2f4ef;--card:#ffffff;--ink:#1c2318;--mute:#5f6b5a;--line:#d4dbcf;--warn:#b45309;--acc:#4c7d2a;--accInk:#ffffff;--soft:#e9eee5;--pass:#b9c7b1;--fence:#c0392b;--tool:#2f6fb0}}
Expand Down Expand Up @@ -96,7 +96,7 @@
<span class="plabel">Implement</span>
<button type="button" data-name="sprayer" onclick="preset('sprayer')">8 m sprayer, front</button>
<button type="button" data-name="drill" onclick="preset('drill')">3 m no-till drill, semi-mounted</button>
<button type="button" data-name="spreader" onclick="preset('spreader')">10 m manure spreader, two axles</button>
<button type="button" data-name="spreader" onclick="preset('spreader')">10 m manure spreader, one axle</button>
<button type="button" data-name="harrow" onclick="preset('harrow')">4 m disc harrow, trailed</button>
<button type="button" data-name="plough" onclick="preset('plough')">4-furrow reversible plough</button>
<button type="button" data-name="quickHarrow" onclick="preset('quickHarrow')">2.7 m quick disc harrow, 3-point</button>
Expand All @@ -111,7 +111,7 @@ <h2>Machine</h2>
<div class="row"><label for="machine">Type<small>the steering is different in each</small></label><select id="machine"><option value="tractor">Tractor</option><option value="articulated">Articulated</option><option value="harvester">Harvester</option></select></div>
<div class="row"><label for="wheelbase">Wheelbase (m)<small>front axle to rear axle</small></label><input id="wheelbase" type="number" step="0.01" min="0.5" value="2.7"></div>
<div class="row"><label for="steer" id="steerLabel">Maximum steering angle (°)<small>the front wheels on the stop, what the steer wizard measured</small></label><input id="steer" type="number" step="1" min="10" max="89" value="42"></div>
<div class="row"><label for="overhang" id="overhangLabel">Front overhang (m)<small>front axle to the nose, weights included</small></label><input id="overhang" type="number" step="0.1" min="0" value="1.5"></div>
<div class="row"><label for="overhang" id="overhangLabel">Front overhang (m)<small>front axle to the nose, weights included</small></label><input id="overhang" type="number" step="0.05" min="0" value="1"></div>
<div class="row"><label for="trackWidth">Rear track width (m)<small>centre to centre of the rear tyres: the Vehicle page's track width. With the tyre width it gives the machine's width, whose front corner sweeps wider than its centre line</small></label><input id="trackWidth" type="number" step="0.01" min="0.5" value="1.81"></div>
<div class="row"><label for="tyreWidth">Rear tyre width (m)<small>0.65 for a 650/65 R38, 0.54 for a 540/65 R34</small></label><input id="tyreWidth" type="number" step="0.01" min="0.1" value="0.65"></div>
<div class="row" data-for="trailed"><label for="wheelDiameter">Rear wheel height (m)<small>its diameter: 1.8 for a 650/65 R38, 1.9 for a 650/65 R42, 1.57 for a 540/65 R34</small></label><input id="wheelDiameter" type="number" step="0.01" min="0.3" value="1.8"></div>
Expand Down Expand Up @@ -176,22 +176,22 @@ <h3>Every turn AgOpenWeb can make here, the smallest headland first</h3>
const TRACTORS = {
// Renato's tractors, by power (the buttons' order too): they fill the Machine card. `pin`: the drawbar's hitch pin behind the rear axle, the hitch length of the implements
// that go on the drawbar (`onDrawbar` below); a semi-mounted implement brings its own pivot instead.
maxxum: {machine: "tractor", wheelbase: 2.7, steer: 42, overhang: 1.5, trackWidth: 1.81, tyreWidth: 0.65, wheelDiameter: 1.8, pin: 0.7,
note: "Renato's Case IH Maxxum 135: 2.7 m wheelbase, 42° measured with the steer wizard, 1.81 m rear track. Its rear tyres (650/65 R38) and the drawbar pin 0.7 m behind the rear axle are guessed until he measures them."},
maxxum: {machine: "tractor", wheelbase: 2.7, steer: 42, overhang: 1.0, trackWidth: 1.81, tyreWidth: 0.65, wheelDiameter: 1.8, pin: 0.7,
note: "Renato's Case IH Maxxum 135: 2.7 m wheelbase, 42° measured with the steer wizard, 1.81 m rear track, its nose 1 m ahead of the front axle. Its rear tyres (650/65 R38) and the drawbar pin 0.7 m behind the rear axle are guessed until he measures them."},
puma: {machine: "tractor", wheelbase: 2.88, steer: 33, overhang: 1.5, trackWidth: 2.0, tyreWidth: 0.65, wheelDiameter: 1.91, pin: 0.9,
note: "Renato's Case IH Puma 180 CVX: 2.88 m wheelbase (its manual), 2 m rear track, 650/65 R42 rear tyres, the drawbar pin 0.9 m behind the rear axle as his AgOpenWeb profile has it. 33° of steering from the manual: the middle of the rear axle turns on an 8.87 m circle with a 1.83 m front track (5.15 m with 1.55 m). It turns wider than AgOpenWeb's 4 m floor, so the tractor sets the radius. A wider front track may let it steer a little more: the steer wizard will tell. The front overhang is guessed."},
farmall: {machine: "tractor", wheelbase: 2.3, steer: 45, overhang: 1.3, trackWidth: 1.7, tyreWidth: 0.54, wheelDiameter: 1.57, pin: 0.74,
note: "Renato's Case IH Farmall 115C: 2.3 m wheelbase, 1.7 m rear track, 540/65 R34 rear tyres, the drawbar pin 0.74 m behind the rear axle. About 45° of steering, by eye until a wheel angle sensor measures it: any angle over 35° gives the same turn, AgOpenWeb's 4 m floor. The front overhang is guessed."}
farmall: {machine: "tractor", wheelbase: 2.3, steer: 45, overhang: 0.85, trackWidth: 1.7, tyreWidth: 0.54, wheelDiameter: 1.57, pin: 0.74,
note: "Renato's Case IH Farmall 115C: 2.3 m wheelbase, 1.7 m rear track, 540/65 R34 rear tyres, the drawbar pin 0.74 m behind the rear axle, its nose 0.85 m ahead of the front axle. About 45° of steering, by eye until a wheel angle sensor measures it: any angle over 35° gives the same turn, AgOpenWeb's 4 m floor."}
};
const PRESETS = {
// the example buttons: Renato's two machines, measured, three with typical measures, then two more of his, guessed. `note`: shown under the buttons;
// the example buttons: Renato's sprayer, drill and manure spreader, measured; a disc harrow and a plough with typical measures; his quick harrow and roller, guessed. `note`: shown under the buttons;
// `turn`: the turn option drawn first (a plough cannot skip rows); `onDrawbar`: its hitch is the tractor's drawbar pin
sprayer: {mount: "front", sections: 8, sectionWidth: 100, width: 8, overlap: 0, offset: 0, axleToTool: 2, hitch: 1, length: 0, sprayerWidth: 8,
note: "Measured on Renato's sprayer: the 8 m boom on the front linkage, 2 m ahead of the front axle."},
drill: {mount: "trailed", sections: 19, sectionWidth: 15.8, width: 3, overlap: -0.05, offset: 0, hitch: 1.54, drawbar: 4.15, pivotToTool: -1.6, drawbarWidth: 0.3, swingDeg: 0, length: 0, sprayerWidth: 8,
note: "Measured on Renato's no-till drill: semi-mounted, its pivot 1.54 m behind the rear axle, its wheels 4.15 m behind the pivot and the discs 1.6 m ahead of the wheels. Its pivot is behind the rear tyres' back edge, so the tyres do not limit its turn; its own headstock or stop does: watch how far it folds and type that in 'Most the drawbar may turn'. It never backs up in the ground: no K-turn."},
spreader: {mount: "trailed", onDrawbar: true, sections: 1, sectionWidth: 1000, width: 10, overlap: 0, offset: 0, drawbar: 4.8, pivotToTool: 3, drawbarWidth: 0.3, swingDeg: 0, length: 3.3, sprayerWidth: 0,
note: "Typical measures, change them to yours. On the tractor's drawbar, its pin (the tractor button's) near the rear tyres' back edge: the drawbar touches a tyre before 90° (at the drawbar's height, where the tyre is shorter than at its axle), and that sets the radius. Two axles close together turn about the middle between them (their tyres scrub sideways in a tight turn): measure the trailing hitch to that middle. The beaters 3 m behind it swing out as the tractor straightens."},
spreader: {mount: "trailed", onDrawbar: true, sections: 1, sectionWidth: 1000, width: 10, overlap: 0, offset: 0, drawbar: 4.2, pivotToTool: 1.5, drawbarWidth: 0.3, swingDeg: 0, length: 1.5, sprayerWidth: 0,
note: "Renato's manure spreader: one axle 4.2 m behind the drawbar pin, the body 1.5 m past the axle with the beaters at its back; it spreads 10 m wide. On the tractor's drawbar, its pin (the tractor button's) near the rear tyres' back edge: the drawbar touches a tyre before 90° (at the drawbar's height, where the tyre is shorter than at its axle), and that sets the radius."},
harrow: {mount: "trailed", onDrawbar: true, sections: 1, sectionWidth: 400, width: 4, overlap: 0.2, offset: 0, drawbar: 3.5, pivotToTool: 0, drawbarWidth: 0.3, swingDeg: 0, length: 1.5, sprayerWidth: 0,
note: "Typical measures, change them to yours: on the tractor's drawbar, its pin (the tractor button's) near the rear tyres' back edge; the wheels between the front and the rear gangs, 20 cm of overlap so no strip is missed. With its wheels at the back (a roller), the discs are ahead of them: a negative pivot distance. A semi-mounted harrow's hitch is its pivot, further back."},
plough: {mount: "rear", sections: 1, sectionWidth: 160, width: 1.6, overlap: 0, offset: 0, axleToTool: 3, hitch: 1, length: 4.5, sprayerWidth: 0, turn: "kturn0",
Expand Down
2 changes: 1 addition & 1 deletion Firmware/simulator/aow-settings/settings.js
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@
// (Sagitta or Keyhole), a pass at twice the radius or more gets a plain semicircle.
"use strict";
(function (root) {
const VERSION = "1.5"; // shown under the page's title and in index.html's "settings.js?v=": raise both with every change
const VERSION = "1.6"; // shown under the page's title and in index.html's "settings.js?v=": raise both with every change
const RADIUS_FACTOR = 1.2; // the turn radius over the tightest the tractor can do: the steering stays off its stop
const RADIUS_FLOOR = 4.0; // AgOpenWeb's simple turn path never goes below 4 m
const MARGIN = 1.0; // room kept between what sweeps the widest and the field edge, unless `margin` says otherwise
Expand Down
Loading