summaryrefslogtreecommitdiff
path: root/Documentation/ABI/testing/sysfs-bus-i2c-devices-turris-omnia-mcu
blob: 9bc5aad00de03340e85d64dfbe05637485d20fdd (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
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>/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.