summaryrefslogtreecommitdiff
path: root/Documentation/ABI/testing/sysfs-bus-i2c-devices-turris-omnia-mcu
blob: 210a39043dc15c7e3cb6a4b2766d5de7061ae505 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
What:		/sys/bus/i2c/devices/<mcu_device>/board_revision
Date:		September 2024
KernelVersion:	6.11
Contact:	Marek Behún <kabel@kernel.org>
Description:	(RO) Contains board revision number.

		Only available if board information is burned in the MCU (older
		revisions have board information burned in the ATSHA204-A chip).

		Format: %u.

What:		/sys/bus/i2c/devices/<mcu_device>/first_mac_address
Date:		September 2024
KernelVersion:	6.11
Contact:	Marek Behún <kabel@kernel.org>
Description:	(RO) Contains device first MAC address. Each Turris Omnia is
		allocated 3 MAC addresses. The two additional addresses are
		computed from the first one by incrementing it.

		Only available if board information is burned in the MCU (older
		revisions have board information burned in the ATSHA204-A chip).

		Format: %pM.

What:		/sys/bus/i2c/devices/<mcu_device>/front_button_mode
Date:		September 2024
KernelVersion:	6.11
Contact:	Marek Behún <kabel@kernel.org>
Description:	(RW) The front button on the Turris Omnia router can be
		configured either to change the intensity of all the LEDs on the
		front panel, or to send the press event to the CPU as an
		interrupt.

		This file switches between these two modes:
		 - "mcu" makes the button press event be handled by the MCU to
		   change the LEDs panel intensity.
		 - "cpu" makes the button press event be handled by the CPU.

		Format: %s.

What:		/sys/bus/i2c/devices/<mcu_device>/front_button_poweron
Date:		September 2024
KernelVersion:	6.11
Contact:	Marek Behún <kabel@kernel.org>
Description:	(RW) Newer versions of the microcontroller firmware of the
		Turris Omnia router support powering off the router into true
		low power mode. The router can be powered on by pressing the
		front button.

		This file configures whether front button power on is enabled.

		This file is present only if the power off feature is supported
		by the firmware.

		Format: %i.

What:		/sys/bus/i2c/devices/<mcu_device>/fw_features
Date:		September 2024
KernelVersion:	6.11
Contact:	Marek Behún <kabel@kernel.org>
Description:	(RO) Newer versions of the microcontroller firmware report the
		features they support. These can be read from this file. If the
		MCU firmware is too old, this file reads 0x0.

		Format: 0x%x.

What:		/sys/bus/i2c/devices/<mcu_device>/fw_version_hash_application
Date:		September 2024
KernelVersion:	6.11
Contact:	Marek Behún <kabel@kernel.org>
Description:	(RO) Contains the version hash (commit hash) of the application
		part of the microcontroller firmware.

		Format: %s.

What:		/sys/bus/i2c/devices/<mcu_device>/fw_version_hash_bootloader
Date:		September 2024
KernelVersion:	6.11
Contact:	Marek Behún <kabel@kernel.org>
Description:	(RO) Contains the version hash (commit hash) of the bootloader
		part of the microcontroller firmware.

		Format: %s.

What:		/sys/bus/i2c/devices/<mcu_device>/mcu_type
Date:		September 2024
KernelVersion:	6.11
Contact:	Marek Behún <kabel@kernel.org>
Description:	(RO) Contains the microcontroller type (STM32, GD32, MKL).

		Format: %s.

What:		/sys/bus/i2c/devices/<mcu_device>/reset_selector
Date:		September 2024
KernelVersion:	6.11
Contact:	Marek Behún <kabel@kernel.org>
Description:	(RO) Contains the selected factory reset level, determined by
		how long the rear reset button was held by the user during board
		reset.

		Format: %i.

What:		/sys/bus/i2c/devices/<mcu_device>/serial_number
Date:		September 2024
KernelVersion:	6.11
Contact:	Marek Behún <kabel@kernel.org>
Description:	(RO) Contains the 64-bit board serial number in hexadecimal
		format.

		Only available if board information is burned in the MCU (older
		revisions have board information burned in the ATSHA204-A chip).

		Format: %016X.