CCSDS で規定される Space Packet のテレメ版の実装 [詳解]

#include <src_user/Settings/TlmCmd/Ccsds/tlm_space_packet_params.h>
#include <stdint.h>
#include "space_packet_typedef.h"
#include "space_packet.h"
#include "../common_tlm_packet.h"

tlm_space_packet.h の依存先関係図:

被依存関係図:

[ソースコード]

マクロ定義
#define	TSP_SND_HDR_LEN (20)
	Secondary Header 長 [詳解]

#define	TSP_2ND_HDR_VER_TO_USE (TSP_2ND_HDR_VER_1)
	使う Sec. HDR Ver [詳解]

列挙型
enum	TSP_2ND_HDR_VER { TSP_2ND_HDR_VER_UNKNOWN = 0 , TSP_2ND_HDR_VER_1 = 1 }
	Secondary Header Version No [詳解]

関数
SP_VER	TSP_get_ver (const TlmSpacePacket *tsp)
	Version No を取得 [詳解]

void	TSP_set_ver (TlmSpacePacket *tsp, SP_VER ver)
	Version No を設定 [詳解]

SP_TYPE	TSP_get_type (const TlmSpacePacket *tsp)
	Packet Type を取得 [詳解]

void	TSP_set_type (TlmSpacePacket *tsp, SP_TYPE type)
	Packet Type を設定 [詳解]

SP_2ND_HDR_FLAG	TSP_get_2nd_hdr_flag (const TlmSpacePacket *tsp)
	Secondary Header Flag を取得 [詳解]

void	TSP_set_2nd_hdr_flag (TlmSpacePacket *tsp, SP_2ND_HDR_FLAG flag)
	Secondary Header Flag を設定 [詳解]

APID	TSP_get_apid (const TlmSpacePacket *tsp)
	APID を取得 [詳解]

void	TSP_set_apid (TlmSpacePacket *tsp, APID apid)
	APID を設定 [詳解]

SP_SEQ_FLAG	TSP_get_seq_flag (const TlmSpacePacket *tsp)
	Sequence Flag を取得 [詳解]

void	TSP_set_seq_flag (TlmSpacePacket *tsp, SP_SEQ_FLAG flag)
	Sequence Flag を設定 [詳解]

uint16_t	TSP_get_seq_count (const TlmSpacePacket *tsp)
	Sequence Count を取得 [詳解]

void	TSP_set_seq_count (TlmSpacePacket *tsp, uint16_t count)
	Sequence Count を設定 [詳解]

uint16_t	TSP_get_packet_data_len (const TlmSpacePacket *tsp)
	Packet Data Length を取得 [詳解]

void	TSP_set_packet_data_len (TlmSpacePacket *tsp, uint16_t len)
	Packet Data Length を設定 [詳解]

TSP_2ND_HDR_VER	TSP_get_2nd_hdr_ver (const TlmSpacePacket *tsp)
	Secondary Header Version No を取得 [詳解]

void	TSP_set_2nd_hdr_ver (TlmSpacePacket *tsp, TSP_2ND_HDR_VER ver)
	Secondary Header Version No を設定 [詳解]

uint32_t	TSP_get_board_time (const TlmSpacePacket *tsp)
	Board Time を取得 [詳解]

void	TSP_set_board_time (TlmSpacePacket *tsp, uint32_t time)
	Board Time を設定 [詳解]

double	TSP_get_global_time (const TlmSpacePacket *tsp)
	Global Time を取得 [詳解]

void	TSP_set_global_time (TlmSpacePacket *tsp, double time)
	Global Time を設定 [詳解]

uint32_t	TSP_get_on_board_subnet_time (const TlmSpacePacket *tsp)
	On-Board Subnetwork Time を取得 [詳解]

void	TSP_set_on_board_subnet_time (TlmSpacePacket *tsp, uint32_t time)
	On-Board Subnetwork Time を設定 [詳解]

TLM_CODE	TSP_get_tlm_id (const TlmSpacePacket *tsp)
	Tlm ID を取得 [詳解]

void	TSP_set_tlm_id (TlmSpacePacket *tsp, TLM_CODE id)
	Tlm ID を設定 [詳解]

ctp_dest_flags_t	TSP_get_dest_flags (const TlmSpacePacket *tsp)
	Destination Flags を取得 [詳解]

void	TSP_set_dest_flags (TlmSpacePacket *tsp, ctp_dest_flags_t flags)
	Destination Flags を設定 [詳解]

uint8_t	TSP_get_dest_info (const TlmSpacePacket *tsp)
	Dest Info を取得 [詳解]

void	TSP_set_dest_info (TlmSpacePacket *tsp, uint8_t info)
	Dest Info を設定 [詳解]

uint16_t	TSP_get_packet_len (const TlmSpacePacket *tsp)
	Packet Length を取得 [詳解]

void	TSP_set_packet_len (TlmSpacePacket *tsp, uint16_t len)
	Packet Length を設定 [詳解]

void	TSP_copy_packet (TlmSpacePacket dest, const TlmSpacePacket src)
	TlmSpacePacket をコピー [詳解]

uint8_t *	TSP_get_user_data_head (const TlmSpacePacket *tsp)
	User Data Field の先頭ポインタを取得 [詳解]

void	TSP_setup_primary_hdr (TlmSpacePacket *tsp, APID apid, uint16_t seq_count, uint16_t packet_len)
	Primary Header を構築 [詳解]

void	TSP_set_common_hdr (TlmSpacePacket *tsp)
	共通部分の Header を構築 [詳解]

void	TSP_setup_fill_packet (TlmSpacePacket *tsp, uint16_t fill_size)
	パケット全体を 0x00 クリアし， fill_size に等しいサイズのパケットを生成する [詳解]

詳解

CCSDS で規定される Space Packet のテレメ版の実装

C ではテンプレートが使えないため，別で定義する

覚え書き: 詳細は space_packet.h を参照; 現在は， Sec. HDR Ver.1 のみ．追加するときに拡張していく; packet 構造 |------—+----—+----—+---------------—| | Pos | Pos | size | name | | [octet] | [bit] | [bit] | | |------—+----—+----—+---------------—| | === Primary Header ======================= | |------—+----—+----—+---------------—| | 0 | 0 | 3 | Version No | | 0 | 3 | 1 | Packet Type | | 0 | 4 | 1 | Sec. HDR Flag | | 0 | 5 | 11 | APID | | 2 | 0 | 2 | Sequence Flags | | 2 | 2 | 14 | Sequence Count | | 4 | 0 | 16 | Packet Data Len | |------—+----—+----—+---------------—| | === Secondary Header ===================== | |------—+----—+----—+---------------—| | 6 | 0 | 8 | Sec. HDR Ver | | 7 | 0 | 32 | Board Time | | 11 | 0 | 8 | Tlm ID | | 12 | 0 | 64 | Global Time | | 20 | 0 | 32 | On-Board | | | | | Subnetwork Time | | 24 | 0 | 8 | Dest Flags | | 25 | 0 | 8 | Dest Info | |------—+----—+----—+---------------—| | === User Data Field ====================== | |------—+----—+----—+---------------—| | 26 | 0 | * | Tlm Data #0 | | * | 0 | * | Tlm Data #1 | | * | 0 | * | Tlm Data #2 | | * | 0 | * | ... | |------—+----—+----—+---------------—|

以下の 3 つの時刻情報をパケットに仕込む

Board Time
- テレメパケットを生成したボードのテレメ生成時間． TI など．型は任意．
Global Time
- テレメパケットを生成したボードの絶対時刻でのテレメ生成時刻． GPS Time や unixtime など．型は任意．
- 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF 0xFF の場合，パケット中継中に MOBC で上書きされる
- FIXME: 一旦 double で実装するが，本当は変えたほうが良いかもしれない．．．？
On-Board Subnetwork Time
- オンボードサブネットワークでのテレメ生成時刻．オンボードサブネットワーク TI など．型は任意．
- 0xFFFFFFFF の場合，パケット中継中に MOBC で上書きされる

tlm_space_packet.h に定義があります。

マクロ定義詳解

◆ TSP_2ND_HDR_VER_TO_USE

#define TSP_2ND_HDR_VER_TO_USE (TSP_2ND_HDR_VER_1)

使う Sec. HDR Ver

tlm_space_packet.h の 69 行目に定義があります。

◆ TSP_SND_HDR_LEN

#define TSP_SND_HDR_LEN (20)

Secondary Header 長

tlm_space_packet.h の 68 行目に定義があります。

列挙型詳解

◆ TSP_2ND_HDR_VER

enum TSP_2ND_HDR_VER

Secondary Header Version No

覚え書き: 8bit

列挙値
TSP_2ND_HDR_VER_UNKNOWN	バージョン不定
TSP_2ND_HDR_VER_1	Version-1

tlm_space_packet.h の 61 行目に定義があります。

関数詳解

◆ TSP_copy_packet()

void TSP_copy_packet	(	TlmSpacePacket *	dest,
		const TlmSpacePacket *	src
	)

TlmSpacePacket をコピー

覚え書き: 高速化のためすすべてではなく必要最低限しかコピーしない

引数

[in,out]	dest	コピー先 TlmSpacePacket
[in]	src	コピー元 TlmSpacePacket

戻り値: void

tlm_space_packet.c の 249 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_get_2nd_hdr_flag()

SP_2ND_HDR_FLAG TSP_get_2nd_hdr_flag ( const TlmSpacePacket * tsp )

Secondary Header Flag を取得

引数

tsp	TlmSpacePacket

戻り値: SP_2ND_HDR_FLAG

tlm_space_packet.c の 53 行目に定義があります。

呼び出し関係図:

◆ TSP_get_2nd_hdr_ver()

TSP_2ND_HDR_VER TSP_get_2nd_hdr_ver ( const TlmSpacePacket * tsp )

Secondary Header Version No を取得

引数

tsp	TlmSpacePacket

戻り値: TSP_2ND_HDR_VER

tlm_space_packet.c の 117 行目に定義があります。

呼び出し関係図:

◆ TSP_get_apid()

APID TSP_get_apid ( const TlmSpacePacket * tsp )

APID を取得

引数

tsp	TlmSpacePacket

戻り値: APID

tlm_space_packet.c の 65 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_get_board_time()

uint32_t TSP_get_board_time ( const TlmSpacePacket * tsp )

Board Time を取得

引数

tsp	TlmSpacePacket

戻り値: Board Time

tlm_space_packet.c の 142 行目に定義があります。

呼び出し関係図:

◆ TSP_get_dest_flags()

ctp_dest_flags_t TSP_get_dest_flags ( const TlmSpacePacket * tsp )

Destination Flags を取得

引数

tsp	TlmSpacePacket

戻り値: Destination Flags

tlm_space_packet.c の 203 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_get_dest_info()

uint8_t TSP_get_dest_info ( const TlmSpacePacket * tsp )

Dest Info を取得

引数

tsp	TlmSpacePacket

戻り値: Dest Info

tlm_space_packet.c の 218 行目に定義があります。

呼び出し関係図:

◆ TSP_get_global_time()

double TSP_get_global_time ( const TlmSpacePacket * tsp )

Global Time を取得

引数

tsp	TlmSpacePacket

戻り値: Global Time

tlm_space_packet.c の 157 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_get_on_board_subnet_time()

uint32_t TSP_get_on_board_subnet_time ( const TlmSpacePacket * tsp )

On-Board Subnetwork Time を取得

引数

tsp	TlmSpacePacket

戻り値: On-Board Subnetwork Time

tlm_space_packet.c の 172 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_get_packet_data_len()

uint16_t TSP_get_packet_data_len ( const TlmSpacePacket * tsp )

Packet Data Length を取得

引数

tsp	TlmSpacePacket

戻り値: Packet Data Length

tlm_space_packet.c の 101 行目に定義があります。

呼び出し関係図:

◆ TSP_get_packet_len()

uint16_t TSP_get_packet_len ( const TlmSpacePacket * tsp )

Packet Length を取得

引数

tsp	TlmSpacePacket

戻り値: Packet Length

tlm_space_packet.c の 237 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_get_seq_count()

uint16_t TSP_get_seq_count ( const TlmSpacePacket * tsp )

Sequence Count を取得

引数

tsp	TlmSpacePacket

戻り値: Sequence Count

tlm_space_packet.c の 89 行目に定義があります。

呼び出し関係図:

◆ TSP_get_seq_flag()

SP_SEQ_FLAG TSP_get_seq_flag ( const TlmSpacePacket * tsp )

Sequence Flag を取得

引数

tsp	TlmSpacePacket

戻り値: SP_SEQ_FLAG

tlm_space_packet.c の 77 行目に定義があります。

呼び出し関係図:

◆ TSP_get_tlm_id()

TLM_CODE TSP_get_tlm_id ( const TlmSpacePacket * tsp )

Tlm ID を取得

引数

tsp	TlmSpacePacket

戻り値: Tlm ID

tlm_space_packet.c の 187 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_get_type()

SP_TYPE TSP_get_type ( const TlmSpacePacket * tsp )

Packet Type を取得

引数

tsp	TlmSpacePacket

戻り値: SP_TYPE

tlm_space_packet.c の 41 行目に定義があります。

呼び出し関係図:

◆ TSP_get_user_data_head()

uint8_t* TSP_get_user_data_head ( const TlmSpacePacket * tsp )

User Data Field の先頭ポインタを取得

引数

tsp	TlmSpacePacket

戻り値: *user_data_head

覚え書き: FIXME: この関数で取得したポインタ経由で tlm のデータをセットする事があるため， const をつけていない引数の const を外しても良いかも？

tlm_space_packet.c の 255 行目に定義があります。

被呼び出し関係図:

◆ TSP_get_ver()

SP_VER TSP_get_ver ( const TlmSpacePacket * tsp )

Version No を取得

引数

tsp	TlmSpacePacket

戻り値: SP_VER

tlm_space_packet.c の 29 行目に定義があります。

呼び出し関係図:

◆ TSP_set_2nd_hdr_flag()

void TSP_set_2nd_hdr_flag	(	TlmSpacePacket *	tsp,
		SP_2ND_HDR_FLAG	flag
	)

Secondary Header Flag を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	flag	SP_2ND_HDR_FLAG

戻り値: void

tlm_space_packet.c の 59 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_2nd_hdr_ver()

void TSP_set_2nd_hdr_ver	(	TlmSpacePacket *	tsp,
		TSP_2ND_HDR_VER	ver
	)

Secondary Header Version No を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	id	TSP_2ND_HDR_VER

戻り値: void

tlm_space_packet.c の 135 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_apid()

void TSP_set_apid	(	TlmSpacePacket *	tsp,
		APID	apid
	)

APID を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	apid	APID

戻り値: void

tlm_space_packet.c の 71 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_board_time()

void TSP_set_board_time	(	TlmSpacePacket *	tsp,
		uint32_t	time
	)

Board Time を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	time	Board Time

戻り値: void

tlm_space_packet.c の 151 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_common_hdr()

void TSP_set_common_hdr ( TlmSpacePacket * tsp )

共通部分の Header を構築

引数

[in,out] tsp TlmSpacePacket

戻り値: void

tlm_space_packet.c の 272 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_dest_flags()

void TSP_set_dest_flags	(	TlmSpacePacket *	tsp,
		ctp_dest_flags_t	flags
	)

Destination Flags を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	flags	Destination Flags

戻り値: void

tlm_space_packet.c の 212 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_dest_info()

void TSP_set_dest_info	(	TlmSpacePacket *	tsp,
		uint8_t	info
	)

Dest Info を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	info	Dest Info

戻り値: void

tlm_space_packet.c の 227 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_global_time()

void TSP_set_global_time	(	TlmSpacePacket *	tsp,
		double	time
	)

Global Time を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	time	Global Time

戻り値: void

tlm_space_packet.c の 166 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_on_board_subnet_time()

void TSP_set_on_board_subnet_time	(	TlmSpacePacket *	tsp,
		uint32_t	time
	)

On-Board Subnetwork Time を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	time	On-Board Subnetwork Time

戻り値: void

tlm_space_packet.c の 181 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_packet_data_len()

void TSP_set_packet_data_len	(	TlmSpacePacket *	tsp,
		uint16_t	len
	)

Packet Data Length を設定

覚え書き: Packet Data Length とは PACKET DATA FIELD 長であり，PRIMARY HEADER を含まない， 0 起算の長さ ( https://public.ccsds.org/Pubs/133x0b2e1.pdf )

引数

[in,out]	tsp	TlmSpacePacket
[in]	len	Packet Data Length

戻り値: void

tlm_space_packet.c の 107 行目に定義があります。

呼び出し関係図:

◆ TSP_set_packet_len()

void TSP_set_packet_len	(	TlmSpacePacket *	tsp,
		uint16_t	len
	)

Packet Length を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	len	Packet Length

戻り値: void

tlm_space_packet.c の 243 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_seq_count()

void TSP_set_seq_count	(	TlmSpacePacket *	tsp,
		uint16_t	count
	)

Sequence Count を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	count	Sequence Count

戻り値: void

tlm_space_packet.c の 95 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_seq_flag()

void TSP_set_seq_flag	(	TlmSpacePacket *	tsp,
		SP_SEQ_FLAG	flag
	)

Sequence Flag を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	flag	SP_SEQ_FLAG

戻り値: void

tlm_space_packet.c の 83 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_tlm_id()

void TSP_set_tlm_id	(	TlmSpacePacket *	tsp,
		TLM_CODE	id
	)

Tlm ID を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	id	Tlm ID

戻り値: void

tlm_space_packet.c の 196 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_type()

void TSP_set_type	(	TlmSpacePacket *	tsp,
		SP_TYPE	type
	)

Packet Type を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	type	SP_TYPE

戻り値: void

tlm_space_packet.c の 47 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_set_ver()

void TSP_set_ver	(	TlmSpacePacket *	tsp,
		SP_VER	ver
	)

Version No を設定

引数

[in,out]	tsp	TlmSpacePacket
[in]	ver	SP_VER

戻り値: void

tlm_space_packet.c の 35 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_setup_fill_packet()

void TSP_setup_fill_packet	(	TlmSpacePacket *	tsp,
		uint16_t	fill_size
	)

パケット全体を 0x00 クリアし， fill_size に等しいサイズのパケットを生成する

覚え書き: Primary Header Size より小さなパケットは作れないので，その場合は， SP_PRM_HDR_LEN + 1 の長さのパケットを生成する

引数

[in,out]	tsp	TlmSpacePacket
[in]	fill_size	packet size

戻り値: void

tlm_space_packet.c の 285 行目に定義があります。

呼び出し関係図:

被呼び出し関係図:

◆ TSP_setup_primary_hdr()

void TSP_setup_primary_hdr	(	TlmSpacePacket *	tsp,
		APID	apid,
		uint16_t	seq_count,
		uint16_t	packet_len
	)

Primary Header を構築

引数

[in,out]	tsp	TlmSpacePacket
[in]	apid	APID
[in]	seq_count	Sequence Count
[in]	packet_len	Packet Length

戻り値: void

tlm_space_packet.c の 263 行目に定義があります。

呼び出し関係図:

被呼び出し関係図: