Skip to content

Latest commit

 

History

History

code-generator

c2a-code-generator

TlmCmd DBからC2Aのコードを生成するためのスクリプト

以下が自動生成される.

  • command_definitions.c
  • command_definitions.h
  • telemetry_definitions.c
  • telemetry_definitions.h
  • block_command_definitions.h

実行

$ python GenerateC2ACode.py

設定

実行時のパスと同じディレクトリに settings.json を置いて設定する.

is_main_obc は,MOBC(地上局と通信するOBC.sub OBCのtlm/cmdを取りまとめる)かそれ以外のOBC(sub OBC.MOBCと通信するOBC)かを制御する.
1 とした場合,MOBC用のコードに加えて以下が生成される.

  • sub_obc_command_definitions.h
  • sub_obc_telemetry_definitions.h
  • sub_obc_telemetry_buffer.c
  • sub_obc_telemetry_buffer.h
  • sub_obc_telemetry_data_definitions.h

なお,MOBC の場合でも, 0 にすることで, sub OBC のコードを生成せず, MOBC のコードのみを生成することができる

設定の記述例(JSON としては invalid だがコメント付き)

{
  # `src_core`, `src_user` のあるディレクトリへのパス
  "path_to_src" : "../../c2a/src/",
  # テレコマ DB のあるディレクトリへのパス
  "path_to_db" : "../../c2a/database/",
  # TlmCmdDBのファイル名の接頭辞
  "db_prefix" : "SAMPLE_MOBC",
  # TLM ID の定義域
  "tlm_id_range" : ["0x00", "0x100"],
  # Cmd DB の Name に "Cmd_" の接頭辞が含まれるか?(今後は含まれないのが基本とする)
  "is_cmd_prefixed_in_db" : 0,
  # 入力 Tlm Cmd DB のエンコーディング
  "input_file_encoding" : "utf-8",
  # 出力ファイルのエンコーディング
  "output_file_encoding" : "utf-8",
  # MOBCか?(他のOBCのtlm/cmdを取りまとめるか?) 0/1
  # sub OBCのコードを生成するときなどは 0 にする
  # MOBC の場合でも, 0 にすることで, sub OBC のコードを生成せず, MOBC のコードのみを生成することができる
  # 0 の場合,以後のパラメタは無効
  "is_main_obc" : 1,
  "other_obc_data" : [
    {
      # OBC名
      "name" : "AOBC",
      # コードを生成するか?
      "is_enable" : 1,
      "db_prefix" : "SAMPLE_AOBC",
      "tlm_id_range" : ["0x90", "0xc0"],
      "is_cmd_prefixed_in_db" : 0,
      "input_file_encoding" : "utf-8",
      # DBがあるディレクトリへのパス(絶対でも相対でもOK)
      "path_to_db" : "../../c2a_sample_aobc/database/",
      # MOBC で保持するテレメの TLM ID の最大値(=テレメ種類数)
      "max_tlm_num" : 256,
      "driver_path" : "aocs/",
      "driver_type" : "AOBC_Driver",
      "driver_name" : "aobc",
      "code_when_tlm_not_found" : "aobc_driver->info.comm.rx_err_code = AOBC_RX_ERR_CODE_TLM_NOT_FOUND;"
    },
    {
      # OBC名
      "name" : "TOBC",
      # コードを生成するか?
      "is_enable" : 1,
      "db_prefix" : "SAMPLE_TOBC",
      "tlm_id_range" : ["0xc0", "0xf0"],
      "is_cmd_prefixed_in_db" : 0,
      "input_file_encoding" : "utf-8",
      # DBがあるディレクトリへのパス(絶対でも相対でもOK)
      "path_to_db" : ""../../c2a_sample_tobc/database/",
      # MOBC で保持するテレメの TLM ID の最大値(=テレメ種類数)
      "max_tlm_num" : 256,
      "driver_path" : "thermal/",
      "driver_type" : "TOBC_Driver",
      "driver_name" : "tobc",
      "code_when_tlm_not_found" : "tobc_driver->info.comm.rx_err_code = TOBC_RX_ERR_CODE_TLM_NOT_FOUND;"
    }
  ]
}

要求

  • python 3.7 以上
  • 必要ライブラリは ./requirements.txt に記載.
    • なお,現在は標準ライブラリのみしか使っていない
    • 以下で一括インストール可能
$ pip install -r requirements.txt

その他