Add manual servo offset calibration for tendon setup variations - #49
Open
actinbrandnew wants to merge 2 commits into
Open
Add manual servo offset calibration for tendon setup variations#49actinbrandnew wants to merge 2 commits into
actinbrandnew wants to merge 2 commits into
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
CALIBRATE_MIDcommand for manually recalibrating an actuator offsetWhy
Tendon length, pretension, and spool winding can vary between hand assemblies.
The existing Homing routine detects a mechanical stop and then applies a fixed half-turn offset of 2048 counts. This works with the expected assembly and winding configuration, but it may not place the full finger extension-to-flexion travel inside the actuator's single-turn position window when:
In these cases, Homing can complete successfully while the slider range still cannot cover the full finger motion.
This PR gives users direct control over the actuator offset. They can move an actuator to a suitable physical reference position in the GUI, calibrate that position to the actuator midpoint, and then use Trim to align the extension endpoint.
The following assembly is an example where tendon routing and spool winding may differ from the default Homing assumption:

Calibration workflow
This does not replace the existing Homing routine. It provides an additional manual calibration option when the fixed Homing offset does not match the assembled tendon and spool configuration.
Safety
Protocol and compatibility
0x04forCALIBRATE_MIDExtend CountSDK return field for compatibilityTesting
py_compile