Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
nearlink-sdr 1.0.9 文档
nearlink-sdr 1.0.9 文档
  • 快速入门
  • 操作指南
    • 运行链路仿真
    • 添加新的调制方式
    • QoS 服务质量管理
    • 使用 SLE 节点实体
    • Rust 加速模块
    • SDR E310 部署规划
    • 构建文档
  • 技术参考
    • nearlink_sdr
      • nearlink_sdr.mac
        • nearlink_sdr.mac.access
        • nearlink_sdr.mac.broadcast
        • nearlink_sdr.mac.crypto
        • nearlink_sdr.mac.frame
        • nearlink_sdr.mac.link_control
        • nearlink_sdr.mac.link_manager
        • nearlink_sdr.mac.power_control
        • nearlink_sdr.mac.qos
        • nearlink_sdr.mac.scheduler
        • nearlink_sdr.mac.security
        • nearlink_sdr.mac.security_manager
        • nearlink_sdr.mac.signaling
        • nearlink_sdr.mac.smf
        • nearlink_sdr.mac.smf_scheduler
      • nearlink_sdr.sim
        • nearlink_sdr.sim.link_sim
        • nearlink_sdr.sim.usrp_sim
      • nearlink_sdr.common
        • nearlink_sdr.common.bch
        • nearlink_sdr.common.code_block_seg
        • nearlink_sdr.common.crc
        • nearlink_sdr.common.m_sequence
        • nearlink_sdr.common.mcs
        • nearlink_sdr.common.polar
        • nearlink_sdr.common.prbs
        • nearlink_sdr.common.scrambler
      • nearlink_sdr.phy
        • nearlink_sdr.phy.channel
        • nearlink_sdr.phy.control_info
        • nearlink_sdr.phy.data_link
        • nearlink_sdr.phy.equalizer
        • nearlink_sdr.phy.frame
        • nearlink_sdr.phy.freq_hopping
        • nearlink_sdr.phy.gfsk
        • nearlink_sdr.phy.mac_interface
        • nearlink_sdr.phy.measurement
        • nearlink_sdr.phy.measurement_frame
        • nearlink_sdr.phy.measurement_tx
        • nearlink_sdr.phy.mock_backend
        • nearlink_sdr.phy.multitone
        • nearlink_sdr.phy.pilot
        • nearlink_sdr.phy.pluto_backend
        • nearlink_sdr.phy.preamble
        • nearlink_sdr.phy.psk
        • nearlink_sdr.phy.rf_compliance
        • nearlink_sdr.phy.rx_pipeline
        • nearlink_sdr.phy.sdr_backend
        • nearlink_sdr.phy.sync_sequence
        • nearlink_sdr.phy.tx_pipeline
        • nearlink_sdr.phy.uhd_backend
        • nearlink_sdr.phy.usrp
        • nearlink_sdr.phy.uwb_measurement_security
        • nearlink_sdr.phy.uwb_pulse
      • nearlink_sdr.node
  • 设计说明
    • SparkLink SLE 协议总览
    • 物理层原理
    • 物理层详解
    • MAC 层详解
    • 安全子系统详解
    • 端到端数据流
    • 系统架构
    • 标准条款映射
  • 更新日志
  • API Reference
    • nearlink_sdr
      • nearlink_sdr.mac
        • nearlink_sdr.mac.access
        • nearlink_sdr.mac.broadcast
        • nearlink_sdr.mac.crypto
        • nearlink_sdr.mac.frame
        • nearlink_sdr.mac.link_control
        • nearlink_sdr.mac.link_manager
        • nearlink_sdr.mac.power_control
        • nearlink_sdr.mac.qos
        • nearlink_sdr.mac.scheduler
        • nearlink_sdr.mac.security
        • nearlink_sdr.mac.security_manager
        • nearlink_sdr.mac.signaling
        • nearlink_sdr.mac.smf
        • nearlink_sdr.mac.smf_scheduler
      • nearlink_sdr.sim
        • nearlink_sdr.sim.link_sim
        • nearlink_sdr.sim.usrp_sim
      • nearlink_sdr.common
        • nearlink_sdr.common.bch
        • nearlink_sdr.common.code_block_seg
        • nearlink_sdr.common.crc
        • nearlink_sdr.common.m_sequence
        • nearlink_sdr.common.mcs
        • nearlink_sdr.common.polar
        • nearlink_sdr.common.prbs
        • nearlink_sdr.common.scrambler
      • nearlink_sdr.phy
        • nearlink_sdr.phy.channel
        • nearlink_sdr.phy.control_info
        • nearlink_sdr.phy.data_link
        • nearlink_sdr.phy.equalizer
        • nearlink_sdr.phy.frame
        • nearlink_sdr.phy.freq_hopping
        • nearlink_sdr.phy.gfsk
        • nearlink_sdr.phy.mac_interface
        • nearlink_sdr.phy.measurement
        • nearlink_sdr.phy.measurement_frame
        • nearlink_sdr.phy.measurement_tx
        • nearlink_sdr.phy.mock_backend
        • nearlink_sdr.phy.multitone
        • nearlink_sdr.phy.pilot
        • nearlink_sdr.phy.pluto_backend
        • nearlink_sdr.phy.preamble
        • nearlink_sdr.phy.psk
        • nearlink_sdr.phy.rf_compliance
        • nearlink_sdr.phy.rx_pipeline
        • nearlink_sdr.phy.sdr_backend
        • nearlink_sdr.phy.sync_sequence
        • nearlink_sdr.phy.tx_pipeline
        • nearlink_sdr.phy.uhd_backend
        • nearlink_sdr.phy.usrp
        • nearlink_sdr.phy.uwb_measurement_security
        • nearlink_sdr.phy.uwb_pulse
      • nearlink_sdr.node
Back to top
View this page

nearlink_sdr.mac.frame¶

数据链路层控制面帧结构 -- TXS-10002-2025 标准 7.3.2

控制面帧由数据类型索引 + 数据长度 + 控制面数据组成。 支持信令消息的注册、编码和解码。

Module Contents¶

Classes¶

AsyncDataFrame

异步数据帧: [分段类型: 2b][数据长度: 11b][预留: 3b][数据: NB]

ControlFrame

控制面帧: [data_type_index: 2B][data_length: 1B][payload: NB]

MuxFrame

数据面与控制面复用帧。

SegmentType

分段类型指示 (7.3.3.2)。

SyncDataFrame

链接态同步数据帧 (非周期适配)。

API¶

class nearlink_sdr.mac.frame.AsyncDataFrame[源代码]¶

异步数据帧: [分段类型: 2b][数据长度: 11b][预留: 3b][数据: NB]

segment_type: int¶

None

data: bytes¶

None

pack() → bytes[源代码]¶

编码为字节流 (不含数据包类型索引前缀)。

classmethod unpack(data: bytes) → nearlink_sdr.mac.frame.AsyncDataFrame[源代码]¶

从字节流解码 (不含数据包类型索引)。

class nearlink_sdr.mac.frame.ControlFrame[源代码]¶

控制面帧: [data_type_index: 2B][data_length: 1B][payload: NB]

data_type_index: int¶

None

payload: bytes¶

None

pack() → bytes[源代码]¶

编码为字节流。

classmethod unpack(data: bytes) → tuple[nearlink_sdr.mac.frame.ControlFrame, int][源代码]¶

从字节流解码, 返回 (帧, 已消费字节数)。

class nearlink_sdr.mac.frame.MuxFrame[源代码]¶

数据面与控制面复用帧。

存储一组控制面帧和一个可选数据帧 (异步或同步)。

control_frames: list[nearlink_sdr.mac.frame.ControlFrame]¶

None

data_frame: nearlink_sdr.mac.frame.AsyncDataFrame | nearlink_sdr.mac.frame.SyncDataFrame | None¶

None

pack() → bytes[源代码]¶

编码全部帧为字节流。

class nearlink_sdr.mac.frame.SegmentType[源代码]¶

Bases: enum.IntEnum

分段类型指示 (7.3.3.2)。

Initialization

Initialize self. See help(type(self)) for accurate signature.

COMPLETE¶

0

FIRST¶

1

MIDDLE¶

2

LAST¶

3

class nearlink_sdr.mac.frame.SyncDataFrame[源代码]¶

链接态同步数据帧 (非周期适配)。

pdu_seq: int¶

None

event_group: int¶

None

frame_format: int¶

None

segment_type: int¶

None

data: bytes¶

None

time_offset: int | None¶

None

sdu_seq: int | None¶

None

pack() → bytes[源代码]¶

编码为字节流 (不含数据包类型索引前缀)。

classmethod unpack(data: bytes) → nearlink_sdr.mac.frame.SyncDataFrame[源代码]¶

从字节流解码 (不含数据包类型索引)。

Next
nearlink_sdr.mac.link_control
Previous
nearlink_sdr.mac.crypto
Copyright ©
Made with Sphinx and @pradyunsg's Furo
On this page
  • nearlink_sdr.mac.frame
    • Module Contents
      • Classes
      • API
        • AsyncDataFrame
          • AsyncDataFrame.segment_type
          • AsyncDataFrame.data
          • AsyncDataFrame.pack()
          • AsyncDataFrame.unpack()
        • ControlFrame
          • ControlFrame.data_type_index
          • ControlFrame.payload
          • ControlFrame.pack()
          • ControlFrame.unpack()
        • MuxFrame
          • MuxFrame.control_frames
          • MuxFrame.data_frame
          • MuxFrame.pack()
        • SegmentType
          • SegmentType.COMPLETE
          • SegmentType.FIRST
          • SegmentType.MIDDLE
          • SegmentType.LAST
        • SyncDataFrame
          • SyncDataFrame.pdu_seq
          • SyncDataFrame.event_group
          • SyncDataFrame.frame_format
          • SyncDataFrame.segment_type
          • SyncDataFrame.data
          • SyncDataFrame.time_offset
          • SyncDataFrame.sdu_seq
          • SyncDataFrame.pack()
          • SyncDataFrame.unpack()