802.3ah OAM Event Notification (`efm_oam_event_notification`)

レイヤ: L2 (データリンク)
ヘッダ: 可変長
補足: PTP / ESMC / CFM / R-APS / 802.3ah OAM (P2)

下位レイヤからの到達

下位レイヤ	判別フィールド	値
`ethernet2`	`ethertype` = 34825 (0x8809) のときのペイロード先頭 8 ビット	3 (0x03)
`efm_oam`	`code`	1 (0x01) (このレイヤを読み直す)

フィールド

フィールド	型	既定値	Auto	説明
`subtype`	`uint(8)`	`3`		Slow Protocols サブタイプ（3 = OAM）。
`flags`	`flags(16)`	`0x50`		フラグ: リンク障害、Dying Gasp、重大イベント、ローカル / リモートの評価中・安定。
`code`	`enum(8)`	`1` (event_notification)		OAMPDU コード: 0x00 Information、0x01 Event Notification、0x02 Variable Request、0x03 Variable Response、0x04 Loopback Control、0xfe Organization Specific。
`sequence_number`	`uint(16)`	`1`		イベント通知のシーケンス番号。
`tlvs`	`tlv` — タイプ 0 の最初の項目まで (なければ PDU の終わりまで)	2 要素		リンクイベント TLV（8 ビット型、ヘッダを含む 8 ビット長、自動）: Errored Symbol Period、Errored Frame、Errored Frame Period、Errored Frame Seconds Summary、Organization Specific。End TLV（タイプ 0）で終わる。

`flags`

ビット	マスク	名前
0	1 (0x0001)	`link_fault`
1	2 (0x0002)	`dying_gasp`
2	4 (0x0004)	`critical_event`
3	8 (0x0008)	`local_evaluating`
4	16 (0x0010)	`local_stable`
5	32 (0x0020)	`remote_evaluating`
6	64 (0x0040)	`remote_stable`

`code`

値	名前
0 (0x00)	`information`
1 (0x01)	`event_notification`
2 (0x02)	`variable_request`
3 (0x03)	`variable_response`
4 (0x04)	`loopback_control`
254 (0xfe)	`organization_specific`

`tlvs`

タイプ 8 ビット、長さ 8 ビット。
長さはタイプと長さのフィールドも含みます。
未知のタイプは値をオクテット列のまま保持します。

タイプ値	名前	値のフィールド	説明
0 (0x00)	`end`	(タイプのみ。長さと値なし)
1 (0x01)	`errored_symbol_period`	`timestamp`, `window`, `threshold`, `errors`, `error_running_total`, `event_running_total`
2 (0x02)	`errored_frame`	`timestamp`, `window`, `threshold`, `errors`, `error_running_total`, `event_running_total`
3 (0x03)	`errored_frame_period`	`timestamp`, `window`, `threshold`, `errors`, `error_running_total`, `event_running_total`
4 (0x04)	`errored_frame_seconds_summary`	`timestamp`, `window`, `threshold`, `errors`, `error_running_total`, `event_running_total`
254 (0xfe)	`organization_specific`	`oui`, `value`

`tlvs` › `errored_symbol_period`

フィールド	型	既定値	Auto	説明
`timestamp`	`uint(16)`	`0`
`window`	`uint(64)`	`10`
`threshold`	`uint(64)`	`1`
`errors`	`uint(64)`	`1`
`error_running_total`	`uint(64)`	`1`
`event_running_total`	`uint(32)`	`1`

`tlvs` › `errored_frame`

フィールド	型	既定値	Auto	説明
`timestamp`	`uint(16)`	`0`
`window`	`uint(16)`	`10`
`threshold`	`uint(32)`	`1`
`errors`	`uint(32)`	`1`
`error_running_total`	`uint(64)`	`1`
`event_running_total`	`uint(32)`	`1`

`tlvs` › `errored_frame_period`

フィールド	型	既定値	Auto	説明
`timestamp`	`uint(16)`	`0`
`window`	`uint(32)`	`10`
`threshold`	`uint(32)`	`1`
`errors`	`uint(32)`	`1`
`error_running_total`	`uint(64)`	`1`
`event_running_total`	`uint(32)`	`1`

`tlvs` › `errored_frame_seconds_summary`

フィールド	型	既定値	Auto	説明
`timestamp`	`uint(16)`	`0`
`window`	`uint(16)`	`10`
`threshold`	`uint(16)`	`1`
`errors`	`uint(16)`	`1`
`error_running_total`	`uint(32)`	`1`
`event_running_total`	`uint(32)`	`1`

`tlvs` › `organization_specific`

フィールド	型	既定値	Auto	説明
`oui`	`uint(24)`
`value`	`bytes` — PDU の残りすべて

サンプルテンプレート

efm-oam-event — templates/protocols/oam/efm-oam-event.wpg.yaml