How kempf09/sense-grip works
SENSE-GRIP is ESP32-S3 gripper firmware operated through a web dashboard. The user configures and opens the jaw, calibrates force sensors, then arms it; ToF detection starts a state-machine grip, while FSR contact and force guide grasping and safety trips lead to FAULT. The control task owns command dispatch, sensor sampling, and servo actions. The README documents additional dashboard diagnostics, calibration, filtering, jogging, and safety behavior. Edges reflect the excerpts, SOURCE INDEX references, or README; unsampled implementation details are not asserted.
Main entry points: control.cpp Control task · web.cpp HTTP API · fsr.cpp FSR acquisition · web_pages.h Dashboard UI
Components 15
Dashboard
- HTTP API
SenseGrip/web.cpp - Dashboard UI
SenseGrip/web_pages.h
Grip control
- Control task
SenseGrip/control.cpp - Grip state machine
SenseGrip/fsm_core.cpp - Runtime settings
SenseGrip/config_core.cpp - Config persistence
SenseGrip/config.cpp
Sensing
- FSR acquisition
SenseGrip/fsr.cpp - Force filters
SenseGrip/fsr_filter.cpp - Force and contact math
SenseGrip/fsr_math.cpp - ToF acquisition
SenseGrip/tof.cpp - Object detection
SenseGrip/tof_detect.cpp
Servo actuation
- Servo control
SenseGrip/servo.cpp - Servo protocol
SenseGrip/servo_proto.cpp
Other components
- Operator
- Gripper hardware
Connections 17
- Operator → Dashboard UI: operates
README.md - Dashboard UI → HTTP API: sends requests
SenseGrip/web.cpp - HTTP API → Control task: queues commands
SenseGrip/web.cpp - HTTP API → Control task: reads snapshots
SenseGrip/web.cpp - Control task → Grip state machine: steps
SenseGrip/control.cpp - Control task → Runtime settings: applies settings
SenseGrip/control.cpp - Control task → Config persistence: loads settings
- Control task → FSR acquisition: samples
SenseGrip/control.cpp - FSR acquisition → Force filters: filters samples
- FSR acquisition → Force and contact math: computes force
- Control task → ToF acquisition: sets detection
SenseGrip/control.cpp - ToF acquisition → Object detection: detects objects
SenseGrip/tof.cpp - Control task → Servo control: polls and moves
SenseGrip/control.cpp - Grip state machine → Control task: returns motor action
- Control task → Gripper hardware: reads and actuates
README.md - Servo control → Servo protocol: uses packet codec
- Servo protocol → Gripper hardware: exchanges packets
README.md