Skip to content

fix: handle firmware slave timeout for slow CoRe 96 head operations#983

Open
rickwierenga wants to merge 1 commit intomainfrom
fix/core96-slave-timeout
Open

fix: handle firmware slave timeout for slow CoRe 96 head operations#983
rickwierenga wants to merge 1 commit intomainfrom
fix/core96-slave-timeout

Conversation

@rickwierenga
Copy link
Copy Markdown
Member

Summary

  • The Hamilton firmware master has an internal ~5 minute timeout for slave commands. For slow 96-head operations (large volumes at low flow rates), the master reports a slave timeout error even though the head is still working
  • When aspirate96/dispense96 receive this error (H0 HardwareError trace 11), we now poll by sending C0 EV (move Z to safety) which goes through the 96-head task queue — trace 46 means still busy, success means done
  • Also increases read_timeout on aspirate_core_96/dispense_core_96 to 300s so Python doesn't timeout before the firmware does
  • Adds _bypass_fw_wait param on low-level methods for advanced users who want to manually fire-and-poll

Closes #944

Test plan

  • Verified on hardware: C0 EV returns trace 46 when 96-head is busy
  • Verified on hardware: C0 EV succeeds when head is idle (harmless Z safety move)
  • Normal fast aspirate96/dispense96 still work (no regression)
  • Full end-to-end test with a >5 min operation to trigger the actual firmware timeout

🤖 Generated with Claude Code

The Hamilton firmware master has an internal ~5 minute timeout for slave
commands. For slow liquid handling operations (e.g. large volumes at low
flow rates), the master reports a slave timeout error (H0 HardwareError,
trace 11) even though the CoRe 96 head is still working and will finish.

This adds a workaround: when aspirate96/dispense96 receive this specific
error, we poll the master by sending C0 EV (move Z to safety) which goes
through the 96-head task queue. If the head is busy, the master responds
with trace 46 ("CoRe 96 head task busy"). When it finishes, EV succeeds
harmlessly. Also increases read_timeout on aspirate_core_96/dispense_core_96
to 300s so our Python timeout doesn't fire before the firmware's.

Closes #944

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@rickwierenga rickwierenga force-pushed the fix/core96-slave-timeout branch from e22fdd6 to 018ccbe Compare April 2, 2026 00:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

star 96 head: firmware error for long liquid handling operations

1 participant