nearlink_sdr.mac.signaling

控制面信令注册表 -- TXS-10002-2025 标准 7.3.2 / 附录 G

维护 data_type_index 到信令类型的映射, 支持自动编解码。

Module Contents

Functions

decode_signaling	将控制面帧解码为信令消息。
encode_signaling	将信令消息编码为控制面帧。
get_signaling_name	获取信令名称, 未注册则返回 '未知'。
list_registered	列出所有已注册的信令类型: [(index, name, byte_length), ...]
register_signaling	注册一个新的信令类型。

API

nearlink_sdr.mac.signaling.decode_signaling(frame: nearlink_sdr.mac.frame.ControlFrame) → Any

将控制面帧解码为信令消息。

如果 data_type_index 未注册, 返回原始 ControlFrame。

nearlink_sdr.mac.signaling.encode_signaling(msg: Any) → nearlink_sdr.mac.frame.ControlFrame

将信令消息编码为控制面帧。

nearlink_sdr.mac.signaling.get_signaling_name(data_type_index: int) → str

获取信令名称, 未注册则返回 '未知'。

nearlink_sdr.mac.signaling.list_registered() → list[tuple[int, str, int]]

列出所有已注册的信令类型: [(index, name, byte_length), ...]

nearlink_sdr.mac.signaling.register_signaling(data_type_index: int, name: str, cls: type, byte_length: int) → None

注册一个新的信令类型。

信令类必须实现 pack() -> bytes 和 unpack(bytes) -> Self 方法。