Skip to content

docs: note the force floor below which the jaws cannot close - #79

Merged
cao-xiao-hao merged 1 commit into
mainfrom
docs/note-the-force-floor
Nov 2, 2026
Merged

cao-xiao-hao merged 1 commit into
mainfrom
docs/note-the-force-floor

Conversation

@cao-xiao-hao

Copy link
Copy Markdown
Contributor

Summary

The grasp section warns about a low setpoint only where it meets the speed cap ("below about 3.7 N the approach speed becomes the limit"). The low end has a harder failure: under about 2.2 N the closing leg's torque budget cannot break the jaws away from static friction, so the approach never moves — and after #78 the SDK refuses that hand-over (no_bite) instead of reading the stillness as contact. The bench hit exactly this at 2 N and 2.5 N on 2026-11-02, so the number to ask for is 3 N.

This adds that to the README's grasp bullets, next to the 3.7 N one, in English and Chinese.

Changes

  • README.md / README.zh-CN.md, "Gripping and force": a new bullet — below about 2.2 N the jaws may not close at all, keep force_n at 3 N or more; the budget is the setpoint, 0.2 Nm of breakaway is 2.2 N of setpoint, under that grasp() refuses the hand-over (ok=False, no_bite=True, torque dropped, no hold frames), between 2.2 N and 3 N it closes but is marginal on this bench.

No code, test, or behaviour change.

Testing

python3 -m unittest discover -s tests -t tests
Ran 478 tests in 9.756s
OK (skipped=12)
npx --yes markdownlint-cli2@0.23.3 "README.md" "README.zh-CN.md"
Summary: 0 issues in 0 files

Issues

No tracking issue — documents the bench behaviour reported on 2026-11-02 (nexform-tech/litegrip-studio#46).

The grasp section documents the two ways a low setpoint goes wrong only
in passing, and the bench found the first one again on 2026-11-02: under
about 2.2 N the closing leg's budget cannot break the jaws away from
static friction, the approach never moves, and the grip is refused
(no_bite) rather than handed over — 3 N is the setpoint to ask for, and
between 2.2 N and 3 N the grip closes but is marginal on this unit.

Written next to the existing "below about 3.7 N the approach speed
becomes the limit" bullet, which covers the other end of the same
trade-off, in both READMEs.
@cao-xiao-hao
cao-xiao-hao merged commit 577e16b into main Nov 2, 2026
1 check passed
@cao-xiao-hao
cao-xiao-hao deleted the docs/note-the-force-floor branch November 2, 2026 03:16
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.3.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@github-actions github-actions Bot added the released Shipped in a release label Nov 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

released Shipped in a release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant