Skip to content

Commit 4466eba

Browse files
committed
Update documentation for FarDriver ESC settings and configurations; add unlock video reference
1 parent 9eac491 commit 4466eba

6 files changed

Lines changed: 463 additions & 4 deletions

File tree

docs/drive/gearshift.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,5 +76,8 @@ for ~80 ms, release for ~80 ms, per pulse) so the control loop never stalls.
7676

7777
Medium speed mode is the ESC's default when neither the high-speed nor low-speed
7878
line is grounded. The FarDriver-app-side configuration of the speed profiles
79-
(what each mode actually does) is a physical/app setting — see
79+
(what each mode actually does — the per-gear current and speed limits) is set in
80+
the ESC, not this repo. Those values are captured in the
81+
[FarDriver ESC Settings](../reference/esc-fardriver.md) reference (see *Ratios in
82+
Gear*); remaining open questions are tracked in
8083
[Hardware & Open Items](../hardware-open-items.md).

docs/drive/speedometer.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,11 @@ Out of the box SPD was silent/erratic. Two **FarDriver app** settings fixed it:
2727
- **Speed pulses: 2 → 6** (3× resolution);
2828
- **Speedometer mode: "pulse" → "isolated pulse"** (a clean, isolated output).
2929

30+
These are the `Speed Pulses` and `SpeedoMeter` fields on the ESC's Display page —
31+
see the [FarDriver ESC Settings](../reference/esc-fardriver.md) reference for the
32+
full parameter set (including the wheel-dimension fields that scale the ESC's own
33+
speed/odometer readings).
34+
3035
## How the firmware reads it
3136

3237
- An interrupt on pin 22 counts each SPD edge into `g_spdCount`, glitch-filtered to

docs/hardware-open-items.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -60,10 +60,15 @@ See [Steering](steering/overview.md).
6060
matching part. → *Confirm the resistor, contactor, and any bus-sense line.*
6161
- **🔧 Hardware e-stop.** Its wiring, what exactly it interrupts, and its placement
6262
are physical and independent of software. → *Document the e-stop.*
63-
- **📡 FarDriver ND721000 app configuration.** Motor direction, the Low/Med/High
63+
- **📡 FarDriver ESC app configuration.** Motor direction, the Low/Med/High
6464
speed-profile definitions, the regen brake level, and the SPD-pulse settings
65-
(2→6 pulses, "isolated pulse") are set in the FarDriver app, not the repo. →
66-
*Record the ESC parameter set.*
65+
(2→6 pulses, "isolated pulse") are set in the FarDriver app, not the repo. The
66+
full parameter snapshot is now recorded in the
67+
[FarDriver ESC Settings](reference/esc-fardriver.md) reference (accessed via
68+
`Paras → Open Pro` in the app; that page includes a screen recording of the
69+
unlock procedure). Its **"Settings needing attention"** section still lists items
70+
to resolve on the kart — the current limits vs. BMS burst limit, the wrong wheel
71+
dimensions, and whether Park is inert as configured.
6772

6873
See [Arming · Precharge · Contactor](drive/precharge-contactor.md) and
6974
[Gearshifting](drive/gearshift.md).

0 commit comments

Comments
 (0)