Family `dpll` netlink 規範 ¶

摘要 ¶

DPLL 子系統。

操作 ¶

device-id-get ¶

獲取與給定屬性匹配的 dpll 裝置的 ID

attribute-set:

dpll

flags:

[admin-perm]

do:

pre

dpll-lock-doit

post

dpll-unlock-doit

request

attributes:: [module-name, clock-id, type]

reply

attributes:: [id]

device-get ¶

獲取 DPLL 裝置列表（轉儲）或單個 dpll 裝置的屬性

attribute-set:

dpll

flags:

[admin-perm]

do:

pre

dpll-pre-doit

post

dpll-post-doit

request

attributes:: [id]

reply

attributes:: [id, module-name, mode, mode-supported, lock-status, lock-status-error, temp, clock-id, type]

dump:

reply

attributes:: [id, module-name, mode, mode-supported, lock-status, lock-status-error, temp, clock-id, type]

device-set ¶

設定 DPLL 裝置的屬性

attribute-set:

dpll

flags:

[admin-perm]

do:

pre

dpll-pre-doit

post

dpll-post-doit

request

attributes:: [id]

device-create-ntf ¶

裝置出現時的通知

notify:: device-get
mcgrp:: monitor

device-delete-ntf ¶

裝置消失時的通知

notify:: device-get
mcgrp:: monitor

device-change-ntf ¶

裝置配置更改時的通知

notify:: device-get
mcgrp:: monitor

pin-id-get ¶

獲取與給定屬性匹配的引腳的 ID

attribute-set:

flags:

[admin-perm]

do:

pre

dpll-lock-doit

post

dpll-unlock-doit

request

attributes:: [module-name, clock-id, board-label, panel-label, package-label, type]

reply

attributes:: [id]

pin-get ¶

獲取引腳及其屬性的列表。

沒有給定任何屬性的轉儲請求 - 列出系統中的所有引腳
具有目標 dpll 的轉儲請求 - 列出已註冊到給定 dpll 裝置的所有引腳
具有目標 dpll 和目標引腳的 do 請求 - 單個引腳屬性

attribute-set:

flags:

[admin-perm]

do:

pre

dpll-pin-pre-doit

post

dpll-pin-post-doit

request

attributes:: [id]

reply

attributes:: [id, board-label, panel-label, package-label, type, frequency, frequency-supported, capabilities, parent-device, parent-pin, phase-adjust-min, phase-adjust-max, phase-adjust, fractional-frequency-offset, esync-frequency, esync-frequency-supported, esync-pulse]

dump:

request

attributes:: [id]

reply

attributes:: [id, board-label, panel-label, package-label, type, frequency, frequency-supported, capabilities, parent-device, parent-pin, phase-adjust-min, phase-adjust-max, phase-adjust, fractional-frequency-offset, esync-frequency, esync-frequency-supported, esync-pulse]

pin-set ¶

設定目標引腳的屬性

attribute-set:

flags:

[admin-perm]

do:

pre

dpll-pin-pre-doit

post

dpll-pin-post-doit

request

attributes:: [id, frequency, direction, prio, state, parent-device, parent-pin, phase-adjust, esync-frequency]

pin-create-ntf ¶

引腳出現時的通知

notify:: pin-get
mcgrp:: monitor

pin-delete-ntf ¶

引腳消失時的通知

notify:: pin-get
mcgrp:: monitor

pin-change-ntf ¶

引腳配置更改時的通知

notify:: pin-get
mcgrp:: monitor

多播組 ¶

monitor

定義 ¶

mode ¶

type:

enum

doc:

dpll 可以支援的工作模式，區分 dpll 如何以及是否選擇其輸入之一以與其同步，DPLL_A_MODE 屬性的有效值

entries:

manual:: 只能透過向 dpll 傳送請求來選擇輸入
automatic:: dpll 自動選擇最高優先順序的輸入引腳

lock-status ¶

type:

enum

doc:

提供 dpll 裝置鎖定狀態的資訊，DPLL_A_LOCK_STATUS 屬性的有效值

entries:

unlocked:: dpll 尚未鎖定到任何有效輸入（或透過將 DPLL_A_MODE 設定為 DPLL_MODE_DETACHED 強制執行）
locked:: dpll 已鎖定到有效訊號，但沒有保持可用
locked-ho-acq:: dpll 已鎖定並獲得保持
holdover:: dpll 處於保持狀態 - 丟失了有效鎖或透過斷開所有引腳強制執行（後者僅在 dpll 鎖定狀態已經是 DPLL_LOCK_STATUS_LOCKED_HO_ACQ 時才可能，如果 dpll 鎖定狀態不是 DPLL_LOCK_STATUS_LOCKED_HO_ACQ，則 dpll 的鎖定狀態應保持 DPLL_LOCK_STATUS_UNLOCKED）

lock-status-error ¶

type:

enum

doc:

如果之前的狀態更改是由於故障引起的，則提供 dpll 裝置鎖定狀態錯誤的資訊。DPLL_A_LOCK_STATUS_ERROR 屬性的有效值

entries:

none:: dpll 裝置鎖定狀態已更改，沒有任何錯誤
undefined:: dpll 裝置鎖定狀態已更改，原因是未定義的錯誤。如果驅動程式無法獲得合適的精確錯誤型別，則會填充此值。
media-down:: dpll 裝置鎖定狀態已更改，原因是關聯的媒體已關閉。例如，如果 dpll 裝置之前已鎖定在 PIN_TYPE_SYNCE_ETH_PORT 型別的輸入引腳上，則可能會發生這種情況。
fractional-frequency-offset-too-high:: 媒體上 RX 和 TX 符號率之間的 FFO（分數頻率偏移）過高。例如，如果 dpll 裝置之前已鎖定在 PIN_TYPE_SYNCE_ETH_PORT 型別的輸入引腳上，則可能會發生這種情況。

clock-quality-level ¶

type:

enum

doc:

時鐘裝置的質量級別。這主要適用於 dpll 鎖定狀態為 DPLL_LOCK_STATUS_HOLDOVER 時。當前列表是根據 ITU-T G.8264/Y.1364 文件中包含的表 11-7 定義的。可以自由地透過其他 ITU-T 定義的時鐘質量來擴充套件此列表，或者透過另一個標準化機構定義的其他時鐘質量（對於這些，請使用不同的字首）。

entries:

itu-opt1-prc:
itu-opt1-ssu-a:
itu-opt1-ssu-b:
itu-opt1-eec1:
itu-opt1-prtc:
itu-opt1-eprtc:
itu-opt1-eeec:
itu-opt1-eprc:

temp-divider ¶

type:: const
value:: 1000
doc:: 溫度除數，允許使用者空間計算具有三位小數精度的浮點溫度。 (DPLL_A_TEMP / DPLL_TEMP_DIVIDER) 的值是溫度值的整數部分。 (DPLL_A_TEMP % DPLL_TEMP_DIVIDER) 的值是溫度值的小數部分。

type ¶

type:

enum

doc:

dpll 的型別，DPLL_A_TYPE 屬性的有效值

entries:

pps:: dpll 產生每秒脈衝訊號
eec:: dpll 驅動乙太網裝置時鐘

pin-type ¶

type:

enum

doc:

定義引腳的可能型別，DPLL_A_PIN_TYPE 屬性的有效值

entries:

mux:: 聚合另一層可選擇的引腳
ext:: 外部輸入
synce-eth-port:: 乙太網埠 PHY 的恢復時鐘
int-oscillator:: 裝置內部振盪器
gnss:: GNSS 恢復時鐘

pin-direction ¶

type:

enum

doc:

定義引腳的可能方向，DPLL_A_PIN_DIRECTION 屬性的有效值

entries:

input:: 引腳用作訊號的輸入
output:: 引腳用於輸出訊號

pin-frequency-1-hz ¶

type:: const
value:: 1

pin-frequency-10-khz ¶

type:: const
value:: 10000

pin-frequency-77-5-khz ¶

type:: const
value:: 77500

pin-frequency-10-mhz ¶

type:: const
value:: 10000000

pin-state ¶

type:

enum

doc:

定義引腳的可能狀態，DPLL_A_PIN_STATE 屬性的有效值

entries:

connected:: 引腳已連線，鎖相環的有效輸入
disconnected:: 引腳已斷開連線，不被視為有效輸入
selectable:: 啟用引腳以進行自動輸入選擇

pin-capabilities ¶

type:

flags

doc:

定義引腳的可能功能，DPLL_A_PIN_CAPABILITIES 屬性上的有效標誌

entries:

direction-can-change:: 可以更改引腳方向
priority-can-change:: 可以更改引腳優先順序
state-can-change:: 可以更改引腳狀態

phase-offset-divider ¶

type:: const
value:: 1000
doc:: 相位偏移除數允許使用者空間將引腳和 dpll 裝置之間測量的訊號相位差計算為具有三位小數精度的分數。 (DPLL_A_PHASE_OFFSET / DPLL_PHASE_OFFSET_DIVIDER) 的值是測量的相位偏移值的整數部分。 (DPLL_A_PHASE_OFFSET % DPLL_PHASE_OFFSET_DIVIDER) 的值是測量的相位偏移值的小數部分。

屬性集 ¶

dpll ¶

id (`u32`)¶

module-name (`string`)¶

pad (`pad`)¶

clock-id (`u64`)¶

mode (`u32`)¶

enum:: mode

mode-supported (`u32`)¶

enum:: mode
multi-attr:: True

lock-status (`u32`)¶

enum:: lock-status

temp (`s32`)¶

type (`u32`)¶

enum:: type

lock-status-error (`u32`)¶

enum:: lock-status-error

clock-quality-level (`u32`)¶

enum:: clock-quality-level
multi-attr:: True
doc:: 時鐘裝置的質量等級。這主要適用於 dpll 鎖定狀態為 DPLL_LOCK_STATUS_HOLDOVER 時。可以多次將其放入訊息中，以指示可能的並行質量等級（例如，一個由 ITU 選項 1 指定，另一個由選項 2 指定）。

pin ¶

id (`u32`)¶

parent-id (`u32`)¶

module-name (`string`)¶

pad (`pad`)¶

clock-id (`u64`)¶

board-label (`string`)¶

panel-label (`string`)¶

package-label (`string`)¶

type (`u32`)¶

enum:: pin-type

direction (`u32`)¶

enum:: pin-direction

frequency (`u64`)¶

frequency-supported (`nest`)¶

multi-attr:: True
nested-attributes:: frequency-range

frequency-min (`u64`)¶

frequency-max (`u64`)¶

prio (`u32`)¶

state (`u32`)¶

enum:: pin-state

capabilities (`u32`)¶

enum:: pin-capabilities

parent-device (`nest`)¶

multi-attr:: True
nested-attributes:: pin-parent-device

parent-pin (`nest`)¶

multi-attr:: True
nested-attributes:: pin-parent-pin

phase-adjust-min (`s32`)¶

phase-adjust-max (`s32`)¶

phase-adjust (`s32`)¶

phase-offset (`s64`)¶

fractional-frequency-offset (`sint`)¶

doc:: 該FFO（分數頻率偏移）是與引腳相關的介質上RX和TX符號率之間的偏移：（rx_frequency-tx_frequency）/rx_frequency 值以PPM（百萬分之幾）為單位。例如，這可以為PIN_TYPE_SYNCE_ETH_PORT型別的引腳實現。

esync-frequency (`u64`)¶

doc:: 嵌入式同步訊號的頻率。如果提供，則引腳配置為將SYNC訊號嵌入其基本時鐘頻率中。

esync-frequency-supported (`nest`)¶

multi-attr:: True
nested-attributes:: frequency-range
doc:: 如果提供了一個引腳，則該引腳能夠將其SYNC訊號（在給定的範圍內）嵌入到其基頻訊號中。

esync-pulse (`u32`)¶

doc:: 嵌入到基本時鐘頻率中的SYNC訊號脈衝的高電平與低電平狀態的比率。值以百分比表示。

id (u32)¶

module-name (string)¶

pad (pad)¶

clock-id (u64)¶

mode (u32)¶

mode-supported (u32)¶

lock-status (u32)¶

temp (s32)¶

type (u32)¶

lock-status-error (u32)¶

clock-quality-level (u32)¶

id (u32)¶

parent-id (u32)¶

module-name (string)¶

pad (pad)¶

clock-id (u64)¶

board-label (string)¶

panel-label (string)¶

package-label (string)¶

type (u32)¶

direction (u32)¶

frequency (u64)¶

frequency-supported (nest)¶

frequency-min (u64)¶

frequency-max (u64)¶

prio (u32)¶

state (u32)¶

capabilities (u32)¶

parent-device (nest)¶

parent-pin (nest)¶

phase-adjust-min (s32)¶

phase-adjust-max (s32)¶

phase-adjust (s32)¶

phase-offset (s64)¶

fractional-frequency-offset (sint)¶

esync-frequency (u64)¶

esync-frequency-supported (nest)¶

esync-pulse (u32)¶

parent-id¶

direction¶

prio¶

state¶

phase-offset¶

parent-id¶

state¶

frequency-min¶

frequency-max¶

id (`u32`)¶

module-name (`string`)¶

pad (`pad`)¶

clock-id (`u64`)¶

mode (`u32`)¶

mode-supported (`u32`)¶

lock-status (`u32`)¶

temp (`s32`)¶

type (`u32`)¶

lock-status-error (`u32`)¶

clock-quality-level (`u32`)¶

id (`u32`)¶

parent-id (`u32`)¶

module-name (`string`)¶

pad (`pad`)¶

clock-id (`u64`)¶

board-label (`string`)¶

panel-label (`string`)¶

package-label (`string`)¶

type (`u32`)¶

direction (`u32`)¶

frequency (`u64`)¶

frequency-supported (`nest`)¶

frequency-min (`u64`)¶

frequency-max (`u64`)¶

prio (`u32`)¶

state (`u32`)¶

capabilities (`u32`)¶

parent-device (`nest`)¶

parent-pin (`nest`)¶

phase-adjust-min (`s32`)¶

phase-adjust-max (`s32`)¶

phase-adjust (`s32`)¶

phase-offset (`s64`)¶

fractional-frequency-offset (`sint`)¶

esync-frequency (`u64`)¶

esync-frequency-supported (`nest`)¶

esync-pulse (`u32`)¶