git.giacomolli.uk - onehouse/blob - doc/m31.rst

   1 ###############
   2  Ebyte M31 I/O
   3 ###############
   4
   5 The ``driver/m31`` package defines one host and up to fifteen expansion
   6 modules. A module's slice index is its slot. The host has eight digital
   7 inputs and eight digital outputs. Mixed expansions add eight of each,
   8 input expansions add sixteen inputs, output expansions add sixteen
   9 outputs, and analog expansions add eight voltage outputs.
  10
  11 Each point uses ``m{slot}.di{channel}``, ``m{slot}.do{channel}``, or
  12 ``m{slot}.ao{channel}``. Inputs, coils, and analog registers have
  13 independent zero-based address ranges that continue across modules.
  14 Configure every physical analog output channel for zero through ten
  15 volts before operation. The driver does not configure the module's
  16 output range. Analog registers represent zero through ten volts as zero
  17 through 10000. Hardware pulse widths are whole milliseconds from 50
  18 through 65535. Their width registers start at ``0x30d4`` and their
  19 output-mode registers start at ``0x32c8``, both indexed by coil address.
  20 Mode zero is level control and mode one is pulse control.
  21
  22 Descriptors use manufacturer ``ebyte`` and firmware ``unknown``. The
  23 package does not read the host identity registers. Pulse capabilities
  24 accept commands but do not report transient coil state. Input
  25 capabilities are read-only.
  26
  27 Tests verify topology and descriptor values without a physical module.
  28 They do not confirm physical expansion limits or relay timing under
  29 load. The conservative sixteen-module limit includes the host.