xref: /linux/Documentation/ABI/testing/sysfs-bus-i2c-devices-turris-omnia-mcu (revision 992f1a3d4e88498de04b0b13b94705d8540f3d81)
1*992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/board_revision
2*992f1a3dSMarek BehúnDate:		September 2024
3*992f1a3dSMarek BehúnKernelVersion:	6.11
4*992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
5*992f1a3dSMarek BehúnDescription:	(RO) Contains board revision number.
6*992f1a3dSMarek Behún
7*992f1a3dSMarek Behún		Only available if board information is burned in the MCU (older
8*992f1a3dSMarek Behún		revisions have board information burned in the ATSHA204-A chip).
9*992f1a3dSMarek Behún
10*992f1a3dSMarek Behún		Format: %u.
11*992f1a3dSMarek Behún
12*992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/first_mac_address
13*992f1a3dSMarek BehúnDate:		September 2024
14*992f1a3dSMarek BehúnKernelVersion:	6.11
15*992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
16*992f1a3dSMarek BehúnDescription:	(RO) Contains device first MAC address. Each Turris Omnia is
17*992f1a3dSMarek Behún		allocated 3 MAC addresses. The two additional addresses are
18*992f1a3dSMarek Behún		computed from the first one by incrementing it.
19*992f1a3dSMarek Behún
20*992f1a3dSMarek Behún		Only available if board information is burned in the MCU (older
21*992f1a3dSMarek Behún		revisions have board information burned in the ATSHA204-A chip).
22*992f1a3dSMarek Behún
23*992f1a3dSMarek Behún		Format: %pM.
24*992f1a3dSMarek Behún
25*992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/fw_features
26*992f1a3dSMarek BehúnDate:		September 2024
27*992f1a3dSMarek BehúnKernelVersion:	6.11
28*992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
29*992f1a3dSMarek BehúnDescription:	(RO) Newer versions of the microcontroller firmware report the
30*992f1a3dSMarek Behún		features they support. These can be read from this file. If the
31*992f1a3dSMarek Behún		MCU firmware is too old, this file reads 0x0.
32*992f1a3dSMarek Behún
33*992f1a3dSMarek Behún		Format: 0x%x.
34*992f1a3dSMarek Behún
35*992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/fw_version_hash_application
36*992f1a3dSMarek BehúnDate:		September 2024
37*992f1a3dSMarek BehúnKernelVersion:	6.11
38*992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
39*992f1a3dSMarek BehúnDescription:	(RO) Contains the version hash (commit hash) of the application
40*992f1a3dSMarek Behún		part of the microcontroller firmware.
41*992f1a3dSMarek Behún
42*992f1a3dSMarek Behún		Format: %s.
43*992f1a3dSMarek Behún
44*992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/fw_version_hash_bootloader
45*992f1a3dSMarek BehúnDate:		September 2024
46*992f1a3dSMarek BehúnKernelVersion:	6.11
47*992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
48*992f1a3dSMarek BehúnDescription:	(RO) Contains the version hash (commit hash) of the bootloader
49*992f1a3dSMarek Behún		part of the microcontroller firmware.
50*992f1a3dSMarek Behún
51*992f1a3dSMarek Behún		Format: %s.
52*992f1a3dSMarek Behún
53*992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/mcu_type
54*992f1a3dSMarek BehúnDate:		September 2024
55*992f1a3dSMarek BehúnKernelVersion:	6.11
56*992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
57*992f1a3dSMarek BehúnDescription:	(RO) Contains the microcontroller type (STM32, GD32, MKL).
58*992f1a3dSMarek Behún
59*992f1a3dSMarek Behún		Format: %s.
60*992f1a3dSMarek Behún
61*992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/reset_selector
62*992f1a3dSMarek BehúnDate:		September 2024
63*992f1a3dSMarek BehúnKernelVersion:	6.11
64*992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
65*992f1a3dSMarek BehúnDescription:	(RO) Contains the selected factory reset level, determined by
66*992f1a3dSMarek Behún		how long the rear reset button was held by the user during board
67*992f1a3dSMarek Behún		reset.
68*992f1a3dSMarek Behún
69*992f1a3dSMarek Behún		Format: %i.
70*992f1a3dSMarek Behún
71*992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/serial_number
72*992f1a3dSMarek BehúnDate:		September 2024
73*992f1a3dSMarek BehúnKernelVersion:	6.11
74*992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
75*992f1a3dSMarek BehúnDescription:	(RO) Contains the 64-bit board serial number in hexadecimal
76*992f1a3dSMarek Behún		format.
77*992f1a3dSMarek Behún
78*992f1a3dSMarek Behún		Only available if board information is burned in the MCU (older
79*992f1a3dSMarek Behún		revisions have board information burned in the ATSHA204-A chip).
80*992f1a3dSMarek Behún
81*992f1a3dSMarek Behún		Format: %016X.
82