@spec handle_message(t(), any()) :: {any(), t()}

Handle an user message

User messages are used to modify the state of the simulated device outside of I2C. This can be used to simulate real world changes like temperature changes affecting a simulated temperature sensor. Another use is as a hook for getting internal state.

@spec read(t(), non_neg_integer()) :: {{:ok, binary()} | {:error, any()}, t()}

Read count bytes

The first item in the returned tuple is what's returned from the original call to Circuits.I2C.read/2. Try to make the errors consistent with that function if possible.

@spec render(t()) :: IO.ANSI.ansidata()

Return the internal state as ASCII art

@spec write(t(), binary()) :: t()

Write data to the device

@spec write_read(t(), binary(), non_neg_integer()) ::
  {{:ok, binary()} | {:error, any()}, t()}

Write data to the device and immediately follow it with a read