跳转到内容

数据段

在计算机科学和通信领域,「数据段」(Data Segment)通常指的是数据在传输或存储过程中被划分成的特定部分或块。

在极测内,「数据段」是通信数据设计的核心概念,它不仅用于定义报文的整体结构或数据的组织形式,还代表了一种明确的数据编解码方式:

  1. 定义报文结构或数据结构:数据段通过明确的字段定义和排列顺序,规定了报文或数据的基本框架。例如,在一个网络协议中,数据段可以指定报文的头部、载荷和尾部等部分的长度、类型和顺序。
  2. 定义数据编解码方式:数据段不仅规定了数据的结构,还定义了数据的表示和转换规则。例如,数据段可以指定某个字段是整数、字符串还是二进制数据,并规定其字节序(大端或小端)、编码方式(如UTF-8)或压缩算法等。

定义数据段

下面的示例介绍了创建「遥测通信数据段」的基本操作。

  1. 在「首页」,点击「数据段」标签,切换到数据段界面。
  1. 鼠标悬浮在左侧列表中的「示例数据段」上,点击「复制」图标,可以获得一个可编辑的示例数据段副本。另一种复制方式是点击各数据段卡片右上角的「复制」链接。

点击「新增」链接会创建一个新的空数据段,从零开始逐字段进行定义。

  1. 在复制后的数据段卡片中,点击金额右侧的「删除」链接,将会删除该字段。
  1. 在「点击新增行」输入新字段设备ID,并将数据类型设为uint32,在「描述」列输入遥测设备的唯一标识

关于如何使用上述示例的数据段生成并发送数据,可参照新建接口和数据发送接口数据

定义帧头/帧尾

数据段可以定义任意二进制数据的帧头或帧尾。「帧头」和「帧尾」输入框期望的内容是Hex文本,并且会在失焦时清除无效字符和格式化字符串。

字节序

每个数据段可定义自己的、独立于系统设置的「字节序」,即按照大尾序(Big Endian)或小尾序(Little Endian)进行编解码,默认为小尾序

导入/导出

数据段支持两种格式的导入/导出,分别是CSVXLSX

枚举值

所有整数类型的字段都支持定义「枚举值」,包括整数、无符号整数、比特位类型等。通过「新增枚举值」可以预定义具有实际意义的数值。例如,假设存在两种型号的遥测设备,它们的长度分别是10米(型号V1)和20米(型号V2),我们可以在数据段定义中通过「新增枚举值」将设备型号与设备长度进行关联。通过切换「仅使用枚举值」开关,可以在生成数据时强制选择已有选项,或者允许输入枚举值以外的其他数值。

定义枚举值后,在接口页面生成数据时,可以从下拉列表中选择预定义的选项。

进制显示

整数类型的字段默认按「十进制」来显示,即系统默认设置。但也可以对指定字段设置其合适的显示方式,支持以「十进制」或「十六进制」。例如,将长度字段设置为按十六进制显示。设置后,预览该字段时将显示为指定的进制。

可以在数据包预览界面看到,当数据以该数据段解码之后,长度字段以十六进制显示。