xref: /linux/Documentation/i2c/slave-eeprom-backend.rst (revision 2697b79a469b68e3ad3640f55284359c1396278d)
1==============================
2Linux I2C slave EEPROM backend
3==============================
4
5by Wolfram Sang <wsa@sang-engineering.com> in 2014-20
6
7This backend simulates an EEPROM on the connected I2C bus. Its memory contents
8can be accessed from userspace via this file located in sysfs::
9
10	/sys/bus/i2c/devices/<device-directory>/slave-eeprom
11
12The following types are available: 24c02, 24c32, 24c64, and 24c512. Read-only
13variants are also supported. The name needed for instantiating has the form
14'slave-<type>[ro]'. Examples follow:
15
1624c02, read/write, address 0x64:
17  # echo slave-24c02 0x1064 > /sys/bus/i2c/devices/i2c-1/new_device
18
1924c512, read-only, address 0x42:
20  # echo slave-24c512ro 0x1042 > /sys/bus/i2c/devices/i2c-1/new_device
21
22You can also preload data during boot if a device-property named
23'firmware-name' contains a valid filename (DT or ACPI only).
24
25As of 2015, Linux doesn't support poll on binary sysfs files, so there is no
26notification when another master changed the content.
27