992f1a3d4e
Add the basic skeleton for a new platform driver for the microcontroller found on the Turris Omnia board. Signed-off-by: Marek Behún <kabel@kernel.org> Reviewed-by: Andy Shevchenko <andy@kernel.org> Acked-by: Bartosz Golaszewski <bartosz.golaszewski@linaro.org> Link: https://lore.kernel.org/r/20240701113010.16447-3-kabel@kernel.org Signed-off-by: Arnd Bergmann <arnd@arndb.de>
81 lines
2.6 KiB
Text
81 lines
2.6 KiB
Text
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.
|