概述

本程序用于星脑单机中GPU系统的上注数据还原。主要功能包括：根据上注数据协议还原上注文件、自身状态数据管理、临时数据文件管理、自身日志管理等。

运行环境：（适用于但不局限于此环境）
硬件: NVidia Jetson Orin NX 16GB
软件: Ubuntu 22.04, JetPack6.0(L4T 36.3.0),GCC 11.4.0, Python 3.10.12

1.代码结构

ReBuildUploadFile/
    |--- readme.md     #说明文件
    |--- src/          #源码
    |--- systemd/      #用于生成服务启动管理
    |--- makeDebPKG/   #用于生成debian包

2.上注数据包

上注数据包结构如下：

偏移量  | 内容         | 长度  | 说明
0      | 上注文件ID    | 4    | 无符号整型，从1开始累加，循环使用。数值0保留。
4      | 上注文件包ID  | 4    | 无符号整型，从1开始累加。数值0保留。
8      | 有效数据      | K    | 文件字节流数据，该字段大小根据上注帧有效数据的长度变化，K≥332。
8+K    | CRC16校验    | 2    | CRC16-IBM 校验算法，校验以上所有 8+K 字节数据。

上注数据包具体格式参看文档：MSS-PUB-SYSUL-SPEC-001_卫星上注通道通信协议

3.程序输入

输入为接口程序保存的上注数据包文件，扩展名为：bin。文件内容为连续保存的二进制上注数据包文件。

上注数据包文件命名规则：
文件ID-文件编号.bin。  
文件ID：源自上注数据包的前4个字节；  
文件编号：保存相同文件ID的数据包文件编号，从1开始累加。如果文件大小超过1MB，则另开新文件保存，此时编号加1。  

例如：
1.共收到并校验通过5个上注数据包（890字节），文件ID均为10，则生成的数据包文件为：10-1.bin，文件大小为：5 X 890字节。
2.共收到并校验通过2000个数据包（890字节），文件ID均为10，则生成的数据包文件为：10-1.bin（大小：1800X890字节），10-2.bin（大小：200X890 字节）。

4.程序输出

4.1.输出还原文件

程序还原后的上注文件保存至指定目录：还原文件输出目录。每次还原结束，程序输出两个文件：上注原始文件和对应的路径文件。

上注原始文件：就是用户上注的原始文件，支持各类型的文件，支持0字节空文件，文件大小限制在4G字节以内。
路径文件：上注原始文件对应的安装部署路径文件，包含上注文件的目标节点号和部署路径。
路径文件命名规则：上注原始文件（含扩展名）+“.path”
路径文件内容包含：上注原始文件的目标节点号和部署路径，格式为：节点编号:/绝对路径，编码格式：UTF-8.

4.2.输出遥测状态文件

程序在运行的时候，以固定时间间隔保存自身的状态数据，以供地面和星务判断本程序的状态。
遥测数据文件为json格式，保存至指定目录：程序遥测存放目录。

5.文件部署目录

文件默认部署目录如下：

执行程序部署目录：/opt/SatService/ReBuildUploadFile
程序日志存放目录：/var/opt/SatService/ReBuildUploadFile/log
程序遥测存放目录：/var/run/SatService/UPFile/TM
上注数据输入目录：/var/opt/SatService/UPFile/BinInput
还原文件临时目录：/var/opt/SatService/UPFile/TMP
还原文件输出目录：/var/opt/SatService/UPFile/UPOut

6.Debian安装包

6.1.制作安装包

在makeDebPKG目录内，运行命令：./makeDeb.sh，在上一级目录下生成deb安装包：ReBuildUploadFile-SDS3_x.x.x_arm64.deb
如需更改软件版本号，则根据版本管理规则，更改文件：makeDeb.sh内的VERSION字段 如需更改软件平台，则根据版本管理规则，更改文件：makeDeb.sh内的PLATFORM字段

6.2.安装包格式说明

Debian安装包文件名格式：包名_版本_平台.deb
包名：ReBuildUploadFile-SDS3
版本：x.x.x
平台：arm64、amd64
例如：ReBuildUploadFile-SDS3_1.0.0_arm64.deb