요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/w1/w1-uart.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: UART 1-Wire Bus
maintainers:
- Christoph Winklhofer <cj.winklhofer@gmail.com>
description: |
UART 1-wire bus. Utilizes the UART interface via the Serial Device Bus
to create the 1-Wire timing patterns.
The UART peripheral must support full-duplex and operate in open-drain
mode. The timing patterns are generated by a specific combination of
baud-rate and transmitted byte, which corresponds to a 1-Wire read bit,
write bit or reset pulse.
The default baud-rate for reset and presence detection is 9600 and for
a 1-Wire read or write operation 115200. In case the actual baud-rate
is different from the requested one, the transmitted byte is adapted
to generate the 1-Wire timing patterns.
https://www.analog.com/en/technical-articles/using-a-uart-to-implement-a-1wire-bus-master.html
properties:
compatible:
const: w1-uart
reset-bps:
default: 9600
description:
The baud rate for the 1-Wire reset and presence detect.
write-0-bps:
default: 115200
description:
The baud rate for the 1-Wire write-0 cycle.
write-1-bps:
default: 115200
description:
The baud rate for the 1-Wire write-1 and read cycle.
required:
- compatible
additionalProperties:
type: object
examples:
- |
serial {
onewire {
compatible = "w1-uart";
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
UART 1-Wire bus
1-11GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 UART 기반 1-Wire bus를 정의합니다. 관리자는 Christoph Winklhofer입니다.
Baud rate와 transmitted byte timing
12-27Serial Device Bus를 통해 UART interface를 이용해 1-Wire timing pattern을 만듭니다. UART peripheral은 full-duplex와 open-drain mode를 지원해야 합니다.
Baud rate와 transmitted byte의 특정 조합이 1-Wire read bit, write bit 또는 reset pulse를 만듭니다. reset·presence detection 기본 baud rate는 9600, read·write 동작은 115200입니다. 실제 baud rate가 요청값과 다르면 transmitted byte를 조정해 timing을 맞춥니다.
description: |
UART 1-wire bus. Utilizes the UART interface via the Serial Device Bus
to create the 1-Wire timing patterns.
The UART peripheral must support full-duplex and operate in open-drain
mode. The timing patterns are generated by a specific combination of
baud-rate and transmitted byte, which corresponds to a 1-Wire read bit,
write bit or reset pulse.
The default baud-rate for reset and presence detection is 9600 and for
a 1-Wire read or write operation 115200. In case the actual baud-rate
is different from the requested one, the transmitted byte is adapted
to generate the 1-Wire timing patterns.
https://www.analog.com/en/technical-articles/using-a-uart-to-implement-a-1wire-bus-master.html
Reset과 bit cycle baud rate
28-52`compatible`은 `w1-uart`입니다. `reset-bps`는 reset·presence detect baud rate이며 기본값 9600입니다. `write-0-bps`는 write-0 cycle, `write-1-bps`는 write-1 및 read cycle의 baud rate이고 둘 다 기본값 115200입니다.
compatible이 필수이며 1-Wire slave child object를 허용합니다.
properties:
compatible:
const: w1-uart
reset-bps:
default: 9600
description:
The baud rate for the 1-Wire reset and presence detect.
write-0-bps:
default: 115200
description:
The baud rate for the 1-Wire write-0 cycle.
write-1-bps:
default: 115200
description:
The baud rate for the 1-Wire write-1 and read cycle.
required:
- compatible
additionalProperties:
type: object
Serial child bus 예제
53-59예제는 serial controller 아래에 `compatible = "w1-uart"`인 `onewire` child bus를 배치합니다.
examples:
- |
serial {
onewire {
compatible = "w1-uart";
};
};
요약과 해설
w1-uart.yaml:1-59UART baud rate와 transmitted byte로 만드는 1-Wire timing을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, property, phandle, baud rate, example, source path와 원문 줄 좌표를 원형대로 보존합니다.