요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Timestamp와 CLOCKSYNC interval
configfs-stp-policy-p_sys-t:23-41Source packet metadata의 timestamp와 별도 CLOCKSYNC packet의 millisecond 주기를 설정하며 각각 0은 전송하지 않음을 뜻합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
What: /config/stp-policy/<device>:p_sys-t.<policy>/<node>/uuid
Date: June 2018
KernelVersion: 4.19
Description:
UUID source identifier string, RW.
Default value is randomly generated at the mkdir <node> time.
Data coming from trace sources that use this <node> will be
tagged with this UUID in the MIPI SyS-T packet stream, to
allow the decoder to discern between different sources
within the same master/channel range, and identify the
higher level decoders that may be needed for each source.
What: /config/stp-policy/<device>:p_sys-t.<policy>/<node>/do_len
Date: June 2018
KernelVersion: 4.19
Description:
Include payload length in the MIPI SyS-T header, boolean.
If enabled, the SyS-T protocol encoder will include payload
length in each packet's metadata. This is normally redundant
if the underlying transport protocol supports marking message
boundaries (which STP does), so this is off by default.
What: /config/stp-policy/<device>:p_sys-t.<policy>/<node>/ts_interval
Date: June 2018
KernelVersion: 4.19
Description:
Time interval in milliseconds. Include a timestamp in the
MIPI SyS-T packet metadata, if this many milliseconds have
passed since the previous packet from this source. Zero is
the default and stands for "never send the timestamp".
What: /config/stp-policy/<device>:p_sys-t.<policy>/<node>/clocksync_interval
Date: June 2018
KernelVersion: 4.19
Description:
Time interval in milliseconds. Send a CLOCKSYNC packet if
this many milliseconds have passed since the previous
CLOCKSYNC packet from this source. Zero is the default and
stands for "never send the CLOCKSYNC". It makes sense to
use this option with sources that generate constant and/or
periodic data, like stm_heartbeat.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
MIPI SyS-T source UUID
1-11| 항목 | 내용 |
|---|---|
| What | /config/stp-policy/<device>:p_sys-t.<policy>/<node>/uuid |
| Date | 2018년 6월 |
| KernelVersion | 4.19 |
| Access | Read/write |
| Description | UUID source identifier 문자열이다. 기본값은 <node>를 mkdir하는 시점에 무작위로 생성된다. |
이 <node>를 사용하는 trace source의 data는 MIPI SyS-T packet stream에서 이 UUID로 tag된다. Decoder는 이를 이용해 같은 master/channel 범위 안의 서로 다른 source를 구별하고, 각 source에 필요할 수 있는 상위 수준 decoder를 식별한다.
SyS-T header의 payload length
13-21| 항목 | 내용 |
|---|---|
| What | /config/stp-policy/<device>:p_sys-t.<policy>/<node>/do_len |
| Date | 2018년 6월 |
| KernelVersion | 4.19 |
| Description | MIPI SyS-T header에 payload length를 포함할지를 정하는 boolean이다. |
활성화하면 SyS-T protocol encoder가 각 packet의 metadata에 payload length를 포함한다. STP처럼 기반 transport protocol이 message boundary 표시를 지원하면 보통 중복 정보이므로 기본값은 off이다.
Packet metadata timestamp interval
23-30| 항목 | 내용 |
|---|---|
| What | /config/stp-policy/<device>:p_sys-t.<policy>/<node>/ts_interval |
| Date | 2018년 6월 |
| KernelVersion | 4.19 |
| Description | Millisecond 단위 시간 간격이다. 이 source의 이전 packet 이후 지정한 millisecond가 지났다면 MIPI SyS-T packet metadata에 timestamp를 포함한다. |
| 기본값 | 0이며, timestamp를 절대 보내지 않는다는 뜻이다. |
CLOCKSYNC packet interval
32-41| 항목 | 내용 |
|---|---|
| What | /config/stp-policy/<device>:p_sys-t.<policy>/<node>/clocksync_interval |
| Date | 2018년 6월 |
| KernelVersion | 4.19 |
| Description | Millisecond 단위 시간 간격이다. 이 source의 이전 CLOCKSYNC packet 이후 지정한 millisecond가 지났다면 CLOCKSYNC packet을 보낸다. |
| 기본값 | 0이며, CLOCKSYNC를 절대 보내지 않는다는 뜻이다. |
이 option은 `stm_heartbeat`처럼 일정하거나 주기적인 data를 생성하는 source와 함께 사용하는 것이 합리적이다.
Source identity는 UUID로 유지되고, payload length·timestamp·CLOCKSYNC는 각각의 설정과 시간 조건에 따라 선택적으로 추가된다.
Source UUID와 payload length
configfs-stp-policy-p_sys-t:1-21Node 생성 시 random UUID를 부여해 같은 master/channel 범위의 source를 구분하고, 필요하면 SyS-T header에 payload length를 포함합니다.