firm/tools/kz_xmodem/README.txt

   1
   2 =====================================================================
   3  XMODEM for KOZOS H8/3069F
   4  Copyright(C) 2012 Shinichiro Nakamura
   5 =====================================================================
   6
   7  XMODEM for KOZOS H8/3069FはKOZOSブートローダ経由で
   8  OSを書き込んでいるのだけど、ちょくちょく転送に失敗するので
   9  作業効率が悪くてモチベーションが下がっている方の為の転送用ツールです。
  10
  11  /doc
  12     README.txt          このファイル
  13  /example
  14     kozos               動作確認用サンプルデータ
  15                         KOZOSのブートローダ経由で転送します。
  16  /src
  17     Makefile            メイクファイル
  18     kz_xmodem.c         本体ソースコード
  19     kz_xmodem.h         本体に対する定義
  20     serial_linux.c      シリアルポートライブラリの実装(Linux)
  21     serial_windows.c    シリアルポートライブラリの実装(Windows)
  22     serial.h            シリアルポートライブラリのインターフェース
  23
  24 =====================================================================
  25  特徴
  26 =====================================================================
  27
  28  KOZOSのXMODEM実装に合わせて実装したXMODEM。
  29  KOZOSのブートローダのloadコマンドを内部で自動発行。
  30  リセットボタンを押して本プログラムを実行するだけの簡単操作。
  31
  32 =====================================================================
  33  使い方
  34 =====================================================================
  35
  36  motファイル名、書き込みインターフェースを与えて実行します。
  37
  38  例) kz_xmodem kozos /dev/ttyUSB0
  39
  40  書き込みに成功した場合、実行表示の最後にComplete.と表示されます。
  41
  42 =====================================================================
  43  出力例
  44 =====================================================================
  45
  46  (Windows)
  47
  48   > kz_xmodem.exe kozos com5
  49
  50     =================================================
  51     XMODEM for KOZOS H8/3069F (Version 0.0.1)
  52     Copyright(C) 2012 Shinichiro Nakamura
  53     =================================================
  54     Flushing serial port.
  55     Wait.
  56     Setup load condition.
  57     Wait a NAK.
  58     ..........
  59     Transmit the target ELF file.
  60     File(kozos): 24 blocks + 44 bytes
  61     .........................
  62     Wait a message from the target.
  63     Complete.
  64
  65  (Linux)
  66
  67   > kz_xmodem kozos /dev/ttyUSB0
  68
  69     =================================================
  70      XMODEM for KOZOS H8/3069F (Version 0.0.1)
  71      Copyright(C) 2012 Shinichiro Nakamura
  72     =================================================
  73     Flushing serial port.
  74     Wait.
  75     Setup load condition.
  76     Wait a NAK.
  77     .........
  78     Transmit the target ELF file.
  79     File(kozos): 24 blocks + 44 bytes
  80     .........................
  81     Wait a message from the target.
  82     Complete.
  83
  84 =====================================================================
  85  バージョン
  86 =====================================================================
  87
  88  2012/04/28 Version 0.0.1    初版
  89  2012/04/30 Version 0.0.2    転送サイズの計算バグを修正した。
  90