요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Front-button controls
sysfs-bus-i2c-devices-turris-omnia-mcu:25-55front_button_mode는 LED intensity를 MCU가 바꾸는 mode와 CPU interrupt mode를 전환하고, front_button_poweron은 true low-power off를 지원하는 firmware에서 button power-on을 제어합니다.
Firmware features and version hashes
sysfs-bus-i2c-devices-turris-omnia-mcu:57-83fw_features는 firmware capability bitmap을 노출하고, application과 bootloader version-hash attributes는 각각의 commit hash를 제공합니다.
MCU type and reset selector
sysfs-bus-i2c-devices-turris-omnia-mcu:85-101mcu_type은 STM32·GD32·MKL 가운데 controller type을, reset_selector는 rear reset button을 누른 시간으로 결정된 factory-reset level을 표시합니다.
Board serial number
sysfs-bus-i2c-devices-turris-omnia-mcu:103-113serial_number는 board information이 MCU에 저장된 revision에서 64bit serial을 16자리 uppercase hexadecimal 형식으로 노출합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/i2c/devices/<mcu_device>/board_revision
2
Date: September 2024
3
KernelVersion: 6.11
4
Contact: Marek Behún <[email protected]>
5
Description: (RO) Contains board revision number.
7
Only available if board information is burned in the MCU (older
8
revisions have board information burned in the ATSHA204-A chip).
10
Format: %u.
12
What: /sys/bus/i2c/devices/<mcu_device>/first_mac_address
13
Date: September 2024
14
KernelVersion: 6.11
15
Contact: Marek Behún <[email protected]>
16
Description: (RO) Contains device first MAC address. Each Turris Omnia is
17
allocated 3 MAC addresses. The two additional addresses are
18
computed from the first one by incrementing it.
20
Only available if board information is burned in the MCU (older
21
revisions have board information burned in the ATSHA204-A chip).
23
Format: %pM.
25
What: /sys/bus/i2c/devices/<mcu_device>/front_button_mode
26
Date: September 2024
27
KernelVersion: 6.11
28
Contact: Marek Behún <[email protected]>
29
Description: (RW) The front button on the Turris Omnia router can be
30
configured either to change the intensity of all the LEDs on the
31
front panel, or to send the press event to the CPU as an
32
interrupt.
34
This file switches between these two modes:
35
- ``mcu`` makes the button press event be handled by the MCU to
36
change the LEDs panel intensity.
37
- ``cpu`` makes the button press event be handled by the CPU.
39
Format: %s.
41
What: /sys/bus/i2c/devices/<mcu_device>/front_button_poweron
42
Date: September 2024
43
KernelVersion: 6.11
44
Contact: Marek Behún <[email protected]>
45
Description: (RW) Newer versions of the microcontroller firmware of the
46
Turris Omnia router support powering off the router into true
47
low power mode. The router can be powered on by pressing the
48
front button.
50
This file configures whether front button power on is enabled.
52
This file is present only if the power off feature is supported
53
by the firmware.
55
Format: %i.
57
What: /sys/bus/i2c/devices/<mcu_device>/fw_features
58
Date: September 2024
59
KernelVersion: 6.11
60
Contact: Marek Behún <[email protected]>
61
Description: (RO) Newer versions of the microcontroller firmware report the
62
features they support. These can be read from this file. If the
63
MCU firmware is too old, this file reads 0x0.
65
Format: 0x%x.
67
What: /sys/bus/i2c/devices/<mcu_device>/fw_version_hash_application
68
Date: September 2024
69
KernelVersion: 6.11
70
Contact: Marek Behún <[email protected]>
71
Description: (RO) Contains the version hash (commit hash) of the application
72
part of the microcontroller firmware.
74
Format: %s.
76
What: /sys/bus/i2c/devices/<mcu_device>/fw_version_hash_bootloader
77
Date: September 2024
78
KernelVersion: 6.11
79
Contact: Marek Behún <[email protected]>
80
Description: (RO) Contains the version hash (commit hash) of the bootloader
81
part of the microcontroller firmware.
83
Format: %s.
85
What: /sys/bus/i2c/devices/<mcu_device>/mcu_type
86
Date: September 2024
87
KernelVersion: 6.11
88
Contact: Marek Behún <[email protected]>
89
Description: (RO) Contains the microcontroller type (STM32, GD32, MKL).
91
Format: %s.
93
What: /sys/bus/i2c/devices/<mcu_device>/reset_selector
94
Date: September 2024
95
KernelVersion: 6.11
96
Contact: Marek Behún <[email protected]>
97
Description: (RO) Contains the selected factory reset level, determined by
98
how long the rear reset button was held by the user during board
99
reset.
101
Format: %i.
103
What: /sys/bus/i2c/devices/<mcu_device>/serial_number
104
Date: September 2024
105
KernelVersion: 6.11
106
Contact: Marek Behún <[email protected]>
107
Description: (RO) Contains the 64-bit board serial number in hexadecimal
108
format.
110
Only available if board information is burned in the MCU (older
111
revisions have board information burned in the ATSHA204-A chip).
113
Format: %016X.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Board revision and MAC allocation
1-23다음 두 record의 Date는 2024년 9월, KernelVersion은 6.11, Contact는 Marek Behún <[email protected]>입니다.
| What | Access / Format | 전문 번역 |
|---|---|---|
| /sys/bus/i2c/devices/<mcu_device>/board_revision | RO / %u | Board revision number를 포함합니다. Board information이 MCU에 기록된 경우에만 사용할 수 있습니다. 이전 revisions에서는 board information이 ATSHA204-A chip에 기록되어 있습니다. |
| /sys/bus/i2c/devices/<mcu_device>/first_mac_address | RO / %pM | Device의 첫 MAC address를 포함합니다. 각 Turris Omnia에는 3개의 MAC addresses가 할당됩니다. 추가 두 주소는 첫 주소를 증가시켜 계산합니다. Board information이 MCU에 기록된 경우에만 사용할 수 있습니다. 이전 revisions에서는 board information이 ATSHA204-A chip에 기록되어 있습니다. |
Front-button controls
25-55다음 두 record의 Date는 2024년 9월, KernelVersion은 6.11, Contact는 Marek Behún <[email protected]>입니다.
| What | Access / Format | 전문 번역 |
|---|---|---|
| /sys/bus/i2c/devices/<mcu_device>/front_button_mode | RW / %s | Turris Omnia router의 front button은 front panel의 모든 LEDs intensity를 변경하거나 press event를 interrupt로 CPU에 보내도록 구성할 수 있습니다. 이 file은 두 mode를 전환합니다. 'mcu'는 MCU가 button press event를 처리하여 LED panel intensity를 바꾸게 하고, 'cpu'는 CPU가 button press event를 처리하게 합니다. |
| /sys/bus/i2c/devices/<mcu_device>/front_button_poweron | RW / %i | Turris Omnia router의 최신 microcontroller firmware는 router를 true low-power mode로 power off하는 기능을 지원합니다. Front button을 누르면 router를 power on할 수 있습니다. 이 file은 front-button power-on의 enable 여부를 구성합니다. Firmware가 power-off feature를 지원하는 경우에만 이 file이 존재합니다. |
Firmware features and version hashes
57-83다음 세 record의 Date는 2024년 9월, KernelVersion은 6.11, Contact는 Marek Behún <[email protected]>입니다.
| What | Access / Format | 전문 번역 |
|---|---|---|
| /sys/bus/i2c/devices/<mcu_device>/fw_features | RO / 0x%x | 최신 microcontroller firmware는 지원하는 features를 보고하며 이 file에서 읽을 수 있습니다. MCU firmware가 너무 오래되었으면 이 file은 0x0을 읽습니다. |
| /sys/bus/i2c/devices/<mcu_device>/fw_version_hash_application | RO / %s | Microcontroller firmware application 부분의 version hash(commit hash)를 포함합니다. |
| /sys/bus/i2c/devices/<mcu_device>/fw_version_hash_bootloader | RO / %s | Microcontroller firmware bootloader 부분의 version hash(commit hash)를 포함합니다. |
MCU type and reset selector
85-101다음 두 record의 Date는 2024년 9월, KernelVersion은 6.11, Contact는 Marek Behún <[email protected]>입니다.
| What | Access / Format | 전문 번역 |
|---|---|---|
| /sys/bus/i2c/devices/<mcu_device>/mcu_type | RO / %s | Microcontroller type(STM32, GD32, MKL)을 포함합니다. |
| /sys/bus/i2c/devices/<mcu_device>/reset_selector | RO / %i | 선택된 factory reset level을 포함합니다. 이 level은 board reset 중 사용자가 rear reset button을 얼마나 오래 눌렀는지에 따라 결정됩니다. |
Board serial number
103-113| 항목 | 전문 번역 |
|---|---|
| What | /sys/bus/i2c/devices/<mcu_device>/serial_number |
| Date | 2024년 9월 |
| KernelVersion | 6.11 |
| Contact | Marek Behún <[email protected]> |
| Description | 64bit board serial number를 hexadecimal 형식으로 포함하는 read-only attribute입니다. Board information이 MCU에 기록된 경우에만 사용할 수 있습니다. 이전 revisions에서는 board information이 ATSHA204-A chip에 기록되어 있습니다. |
| Format | %016X |
Board revision and MAC allocation
sysfs-bus-i2c-devices-turris-omnia-mcu:1-23board_revision과 first_mac_address는 board information이 MCU에 저장된 revision에서만 제공되며, 첫 MAC으로부터 추가 2개 주소를 증가시켜 계산합니다.