librespace/kaitai

SatNOGS Kaitai Struct Docker镜像

概述

SatNOGS Kaitai Struct Docker镜像专为SatNOGS项目设计，提供Kaitai Struct工具的容器化运行环境，用于解析二进制数据格式，支持SatNOGS地面站系统的数据处理需求。

核心功能与特性

• 提供Kaitai Struct工具的完整运行环境
• 容器化部署，简化依赖管理和环境配置
• 与SatNOGS项目生态系统无缝集成
• 支持多种二进制格式解析场景

源代码

该镜像的源代码在GitLab上维护。

问题跟踪

如遇任何问题，请在项目的问题跟踪器中报告。

构建状态

![pipeline status]([***]

使用方法

基本运行

通过以下命令可查看Kaitai Struct编译器(ksc)的帮助信息：

bash
docker run --rm satnogs/kaitai-struct:latest ksc --help

解析二进制文件

将本地工作目录挂载到容器中，使用Kaitai Struct定义文件(.ksy)解析二进制数据：

bash
docker run --rm -v $(pwd):/work satnogs/kaitai-struct:latest ksc -t <target_language> /work/your_format.ksy -o /work/output

参数说明：

• -v $(pwd):/work: 将当前目录挂载到容器的/work工作目录
• -t <target_language>: 指定生成代码的目标语言（如python、c++、java等）
• /work/your_format.ksy: Kaitai Struct格式定义文件路径
• -o /work/output: 指定生成代码的输出目录

示例：生成Python解析代码

bash
docker run --rm -v $(pwd):/work satnogs/kaitai-struct:latest ksc -t python /work/satellite_data.ksy -o /work/python_parser

此命令将根据satellite_data.ksy定义文件，在当前目录的python_parser文件夹中生成Python解析代码。