From 7cb1530302ff8341700304cf7b5c03727dbd31da Mon Sep 17 00:00:00 2001 From: Ryo Suzumoto Date: Tue, 18 Apr 2023 01:57:48 +0900 Subject: [PATCH 1/3] add docs of TSP ver2 --- Docs/Core/communication.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/Docs/Core/communication.md b/Docs/Core/communication.md index ed3733c0d..6d35019fa 100644 --- a/Docs/Core/communication.md +++ b/Docs/Core/communication.md @@ -71,11 +71,15 @@ Secondary Header は CCSDS Space Packet 定義において，ユーザー定義 https://github.com/ut-issl/c2a-core/blob/e84ac663187adb7b9d51939f2228b9ecfa7ae292/TlmCmd/Ccsds/tlm_space_packet.h#L1-L51 #### 各フィールドの説明 +##### バージョン共通 - Secondary Header Version - `0x00`: バージョン不定 - `0x01`: Version 1 + - `0x02`: Version 2 - Board Time - テレメトリが生成されたボード (OBC など) の時刻 (TI など) + +##### Version 1 - Telemetry ID - テレメトリID - APID 内でユニークであればいい @@ -105,6 +109,20 @@ https://github.com/ut-issl/c2a-core/blob/e84ac663187adb7b9d51939f2228b9ecfa7ae29 - 例えば，Stored Telemetry 時には Data Recorder のどのパーティションに配送されるかを規定する - 将来拡張の可能性あり +##### Version 2 +- On-Board Subnetwork Time （将来拡張） + - 各ボードで作られたパケットの時刻を統一的に管理するために，オンボードサブネットワークで共通の時刻体系に基づくテレメトリ生成時刻 + - `0xFFFFFFFF` の場合， パケット中継中に MOBC (地上局とつながる OBC) で，上書き設定される + - On-Board Subnetwork Time を取得できない機器向け + +#### バージョンの使い分け +- Version 1 + - 主に，Telemetry ID で区別される，パケットごとに構造化され定義されたテレメトリに使う + - 基本的にはパケット分割されない（Sequence Flag が Standalone Packet である） +- Version 2 + - 主に，画像などのミッションデータを送信するときに使う + - パケット分割は許容される + ### Secondary Header (Command) Secondary Header は CCSDS Space Packet 定義において，ユーザー定義部分であるため，ここで定義する． From 6ad0218ee43bca2fc5511f382356bebacb463df5 Mon Sep 17 00:00:00 2001 From: Ryo Suzumoto Date: Tue, 18 Apr 2023 10:03:48 +0900 Subject: [PATCH 2/3] update docs --- Docs/Core/communication.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/Docs/Core/communication.md b/Docs/Core/communication.md index 6d35019fa..b234bec1d 100644 --- a/Docs/Core/communication.md +++ b/Docs/Core/communication.md @@ -117,10 +117,11 @@ https://github.com/ut-issl/c2a-core/blob/e84ac663187adb7b9d51939f2228b9ecfa7ae29 #### バージョンの使い分け - Version 1 - - 主に，Telemetry ID で区別される，パケットごとに構造化され定義されたテレメトリに使う + - 主に，Telemetry ID で区別される，パケットごとに構造化され定義されたテレメトリ (Character Tlm Packet) に使う + - C2A では，Tlm Cmd DB の Tlm DB によってスキーマが定義され，時系列データベースなどに格納されることが一般的である - 基本的にはパケット分割されない（Sequence Flag が Standalone Packet である） - Version 2 - - 主に，画像などのミッションデータを送信するときに使う + - 主に，画像などのミッションデータやメモリダンプ (Binary Tlm Packet) を送信するときに使う - パケット分割は許容される From e92641f0d6847c8cc998bcef538019d7e39cc98e Mon Sep 17 00:00:00 2001 From: Ryo Suzumoto Date: Tue, 18 Apr 2023 17:15:13 +0900 Subject: [PATCH 3/3] memo --- Docs/Core/communication.md | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) diff --git a/Docs/Core/communication.md b/Docs/Core/communication.md index b234bec1d..23947d3ed 100644 --- a/Docs/Core/communication.md +++ b/Docs/Core/communication.md @@ -125,6 +125,36 @@ https://github.com/ut-issl/c2a-core/blob/e84ac663187adb7b9d51939f2228b9ecfa7ae29 - パケット分割は許容される + +メモ + +| offset [byte] | Ver. 1
(deprecated) | Ver. 2 | Ver. 3 | +| -- | -- | -- | -- | +| 0 | Sec. HDR Ver | Sec. HDR Ver | Sec. HDR Ver | +| 1 | Board Time | Board Time | Board Time | +| 2 | \| | \| | \| | +| 3 | \| | \| | \| | +| 4 | \| | \| | \| | +| 5 | Tlm ID | On-Board
Subnetwork Time | On-Board
Subnetwork Time | +| 6 | Global Time | \| | \| | +| 7 | \| | \| | \| | +| 8 | \| | \| | \| | +| 9 | \| | Global Time | --- | +| 10 | \| | \| | | +| 11 | \| | \| | | +| 12 | \| | \| | | +| 13 | \| | \| | | +| 14 | On-Board
Subnetwork Time | \| | | +| 15 | \| | \| | | +| 16 | \| | \| | | +| 17 | \| | Tlm ID | | +| 18 | Dest Flags | Dest Flags | | +| 19 | Dest Info | Dest Info | | + + + + + ### Secondary Header (Command) Secondary Header は CCSDS Space Packet 定義において，ユーザー定義部分であるため，ここで定義する． 本ドキュメント更新時の実装は，以下である．ヘッダ構造は以下を参照すること．