STLLOAD(8)

名称
stlload - Stallion Technologies 製マルチポートシリアルボード用のダウンローダ

書式
stlload [-vhVR] [-i image-file] [-c control-device] [-r rx-buf-size] [-t tx-buf-size] [-B boot-banner] [-b unit-number]

解説
stlload は Stallion Technologies 製の インテリジェント型マルチポートシリアルボードに ファームウェアをダウンロードするのに用いられます。 ファームウェアのダウンロードを必要とするのは、 stli ドライバを用いるボードだけです。 この中には EasyConnection 8/64 と ONboard and Brumby ファミリのボードが 含まれます。

ボードの型が異なれば、異なるファームウェアのイメージファイルが 必要となります。 正しくないファームウェアがボードにロードされた場合、動作に失敗するでしょう。

ダウンロード処理は Stallion stli ドライバ制御用デバイス /dev/staliomem? を通じて行われます。 このデバイスは、ボードのシェアードメモリ領域を読み書きできる ファイル型のデバイスを実現します。 また、ボードをリセットし、再始動する特殊な ioctl 群を実装しています。

オプションは以下の通りです。

-v  冗長な出力を生成します。ダウンロードとスタートアップ処理の 各段階において、トレースが生成されます。

-h  使用法の情報を出力します。

-V  バージョン情報を出力します。

-R  ボードのリセットだけを行います。 ファームウェアのボードへのダウンロードを開始しません。

-i image-file
    ダウンロードするイメージファイルを指定します。 デフォルトのファームウェアイメージは、 /usr/libdata/stallion/cdk.sys です。

-c control-device
    ファームウェアをダウンロードし、ボードを始動するのに用いる ボード制御用デバイスを指定します。 デフォルトは /dev/staliomem0 です。

-r rx-buf-size
    ボードのシェアードメモリ上の受信データバッファのサイズを指定します。 デフォルトではバッファは、シェアードメモリの使用できる最大量を 用いるように動的に調整されます。

-t tx-buf-size
    ボードのシェアードメモリ上の送信データバッファのサイズを指定します。 デフォルトではバッファは、シェアードメモリの使用できる最大量を 用いるように動的に調整されます。

-B boot-banner
    ダウンロード中のスレーブデバッグトレースフラグをイネーブルにします。 ファームウェアコードからのトレース出力をデバッグすることが、 これによって可能になります。 このトレースが出力されるのはボードのポート 0 で、このポートは 9600 ボー、 8 データビット、パリティ無しの 1 ストップビットに セットされます。

-b unit-number
    ダウンロードするユニット (ボード) 番号を指定します。デフォルトでは ボード 0 にダウンロードします。

stlload は /etc/rc.serial から起動されるのが典型的な用法です。

関連ファイル

/usr/libdata/stallion/cdk.sys
    EasyConnection 8/64 クラスのボード用ファームウェアコード

/usr/libdata/stallion/2681.sys
    ONboard and Brumby クラスのボード用ファームウェアコード

/dev/staliomem?
    ドライバボード制御用デバイス

関連項目
stl(4), stli(4), stlstats(8)

歴史
このプログラムのオリジナル版は Greg Ungerer <gerg@stallion.com> によって開発されました。