Describe instrument protocols as data, and let SutterDevice speak through one - #118

Merged

dccote merged 17 commits into

protocol-description

Aug 13, 2026

Commits on Aug 5, 2026

Sketch a sans-I/O protocol description, in its test file

dccote
and
claude
committed
88d4e2d

Commits on Aug 6, 2026

Add a ctypes-layout variant of the binary description

dccote
and
claude
committed
9913b3e
Name the ctypes layout explicitly, for Python 3.14

dccote
and
claude
committed
f174f60
Drop the ctypes variant: string templates and struct formats it is

dccote
and
claude
committed
91c7ba0
Put the request terminator in the template, where it can be seen

dccote
and
claude
committed
c591017
A reply parses what it is handed; reading is the caller's business

dccote
and
claude
committed
f8c4c22
Require an explicit byte order, and rename Exchange to Transaction

dccote
and
claude
committed
9a0b5a5
Rename Transaction to Command

dccote
and
claude
committed
e02d0ce
Read a device's commands from JSON into a CommandDictionary

dccote
and
claude
committed
9572a63
Fold the description builders into CommandDictionary

dccote
and
claude
committed
89aa7f2
Docstring every method of the prototype classes

dccote
and
claude
committed
58b1317

Commits on Aug 12, 2026

Describe both directions of a protocol, and let it explain itself

dccote
and
claude
committed
49a6dea
Collapse the frame hierarchy: a frame has no role, a command gives it one

dccote
and
claude
committed
beae39d
Document every argument and return value, and type-hint the signatures

dccote
and
claude
committed
8cc0252
Skip whitespace in a struct format, as struct itself does

dccote
and
claude
committed
70d651f

Commits on Aug 13, 2026

Describe a protocol in the library, and let SutterDevice speak through it

dccote
and
claude
committed
344710e
Delete PhysicalDevice.sendCommand, which nothing called

dccote
and
claude
committed
e64a11c