xref: /linux/Documentation/ABI/testing/sysfs-bus-i2c-devices-turris-omnia-mcu (revision dfa556e45ae9ecc199e598222debc8f1883a7cce)
1992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/board_revision
2992f1a3dSMarek BehúnDate:		September 2024
3992f1a3dSMarek BehúnKernelVersion:	6.11
4992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
5992f1a3dSMarek BehúnDescription:	(RO) Contains board revision number.
6992f1a3dSMarek Behún
7992f1a3dSMarek Behún		Only available if board information is burned in the MCU (older
8992f1a3dSMarek Behún		revisions have board information burned in the ATSHA204-A chip).
9992f1a3dSMarek Behún
10992f1a3dSMarek Behún		Format: %u.
11992f1a3dSMarek Behún
12992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/first_mac_address
13992f1a3dSMarek BehúnDate:		September 2024
14992f1a3dSMarek BehúnKernelVersion:	6.11
15992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
16992f1a3dSMarek BehúnDescription:	(RO) Contains device first MAC address. Each Turris Omnia is
17992f1a3dSMarek Behún		allocated 3 MAC addresses. The two additional addresses are
18992f1a3dSMarek Behún		computed from the first one by incrementing it.
19992f1a3dSMarek Behún
20992f1a3dSMarek Behún		Only available if board information is burned in the MCU (older
21992f1a3dSMarek Behún		revisions have board information burned in the ATSHA204-A chip).
22992f1a3dSMarek Behún
23992f1a3dSMarek Behún		Format: %pM.
24992f1a3dSMarek Behún
25*dfa556e4SMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/front_button_mode
26*dfa556e4SMarek BehúnDate:		September 2024
27*dfa556e4SMarek BehúnKernelVersion:	6.11
28*dfa556e4SMarek BehúnContact:	Marek Behún <kabel@kernel.org>
29*dfa556e4SMarek BehúnDescription:	(RW) The front button on the Turris Omnia router can be
30*dfa556e4SMarek Behún		configured either to change the intensity of all the LEDs on the
31*dfa556e4SMarek Behún		front panel, or to send the press event to the CPU as an
32*dfa556e4SMarek Behún		interrupt.
33*dfa556e4SMarek Behún
34*dfa556e4SMarek Behún		This file switches between these two modes:
35*dfa556e4SMarek Behún		- "mcu" makes the button press event be handled by the MCU to
36*dfa556e4SMarek Behún		  change the LEDs panel intensity.
37*dfa556e4SMarek Behún		- "cpu" makes the button press event be handled by the CPU.
38*dfa556e4SMarek Behún
39*dfa556e4SMarek Behún		Format: %s.
40*dfa556e4SMarek Behún
41992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/fw_features
42992f1a3dSMarek BehúnDate:		September 2024
43992f1a3dSMarek BehúnKernelVersion:	6.11
44992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
45992f1a3dSMarek BehúnDescription:	(RO) Newer versions of the microcontroller firmware report the
46992f1a3dSMarek Behún		features they support. These can be read from this file. If the
47992f1a3dSMarek Behún		MCU firmware is too old, this file reads 0x0.
48992f1a3dSMarek Behún
49992f1a3dSMarek Behún		Format: 0x%x.
50992f1a3dSMarek Behún
51992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/fw_version_hash_application
52992f1a3dSMarek BehúnDate:		September 2024
53992f1a3dSMarek BehúnKernelVersion:	6.11
54992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
55992f1a3dSMarek BehúnDescription:	(RO) Contains the version hash (commit hash) of the application
56992f1a3dSMarek Behún		part of the microcontroller firmware.
57992f1a3dSMarek Behún
58992f1a3dSMarek Behún		Format: %s.
59992f1a3dSMarek Behún
60992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/fw_version_hash_bootloader
61992f1a3dSMarek BehúnDate:		September 2024
62992f1a3dSMarek BehúnKernelVersion:	6.11
63992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
64992f1a3dSMarek BehúnDescription:	(RO) Contains the version hash (commit hash) of the bootloader
65992f1a3dSMarek Behún		part of the microcontroller firmware.
66992f1a3dSMarek Behún
67992f1a3dSMarek Behún		Format: %s.
68992f1a3dSMarek Behún
69992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/mcu_type
70992f1a3dSMarek BehúnDate:		September 2024
71992f1a3dSMarek BehúnKernelVersion:	6.11
72992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
73992f1a3dSMarek BehúnDescription:	(RO) Contains the microcontroller type (STM32, GD32, MKL).
74992f1a3dSMarek Behún
75992f1a3dSMarek Behún		Format: %s.
76992f1a3dSMarek Behún
77992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/reset_selector
78992f1a3dSMarek BehúnDate:		September 2024
79992f1a3dSMarek BehúnKernelVersion:	6.11
80992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
81992f1a3dSMarek BehúnDescription:	(RO) Contains the selected factory reset level, determined by
82992f1a3dSMarek Behún		how long the rear reset button was held by the user during board
83992f1a3dSMarek Behún		reset.
84992f1a3dSMarek Behún
85992f1a3dSMarek Behún		Format: %i.
86992f1a3dSMarek Behún
87992f1a3dSMarek BehúnWhat:		/sys/bus/i2c/devices/<mcu_device>/serial_number
88992f1a3dSMarek BehúnDate:		September 2024
89992f1a3dSMarek BehúnKernelVersion:	6.11
90992f1a3dSMarek BehúnContact:	Marek Behún <kabel@kernel.org>
91992f1a3dSMarek BehúnDescription:	(RO) Contains the 64-bit board serial number in hexadecimal
92992f1a3dSMarek Behún		format.
93992f1a3dSMarek Behún
94992f1a3dSMarek Behún		Only available if board information is burned in the MCU (older
95992f1a3dSMarek Behún		revisions have board information burned in the ATSHA204-A chip).
96992f1a3dSMarek Behún
97992f1a3dSMarek Behún		Format: %016X.
98