serves a one-level directory with two files
that give access to the target device with address
(given in hexadecimal)
on the system's I2C bus.
is usually determined by the I2C device manufacturer.
I2C gives address 0 special meaning as the `general call' address.
See an I2C specification for details.
The control file
accepts commands to set the valid address range and
subaddressing mode for the corresponding data file.
The following control messages can be written to it:
- Force 10-bit addressing instead of 7-bit addressing.
Otherwise 10-bit addressing is used only if the device address
is bigger than 255.
- size nbytes
- Set the logical size of the target device to
(By default when opened, it is 256 bytes, enough for most small I2C devices.)
IO requests will be kept within this limit.
This value is also returned by
as the length of the data file.
- subaddress [ n ]
- Cause subsequent reads and writes
on the data file to use I2C subaddressing
byte subaddresses (default: 1 byte).
must be no larger than 4.
The target device must support subaddressing.
By default, the device is not subaddressed.
to zero switches off subaddressing.
the control file displays the current settings.
The data file
can be read or written to
exchange data with the slave device with address
is given in hexadecimal).
Each write request transmits the given data
to the device.
Each read request sends a receive
request to the device and returns the resulting data.
If the I2C target is subaddressed, the current file offset
is used as the subaddress;
otherwise the file offset is ignored, and the device typically starts at 0 for each transfer request.
Read and write requests are trimmed to the declared
size of the device.