ファームウェアの準備手順

DCC/MM2シールド・DSmain側の準備

当サイトから直接頒布されたキットには、予めDCC/MM2シールド・DSmainを制御するファームウェアが書き込まれています。特に書き込みなどの作業や特別な準備は不要です。


DCC/MM2シールドやDSmain上に直接載っているマイコンのファームウェアは、こちらから頒布する機器は全てソフト書き込み済みで出荷しますので一切操作は不要です。 Arduino側のマイコンはArduino IDEを用いてご自分で好きなソフトをUSB経由で簡単に何度でも書き込めます。

Arduino側の準備手順

Arduino側は、皆様がご自由にソフトを作って書き込んで、鉄道模型を制御できます。DCC/MM2シールドに指令を送るために、当ページでダウンロードできるDSGatewayLib(Arduino IDE専用)を提供しています。DSGatewayLibには、サンプルスケッチ（サンプルソフト）が含まれています。
Arduino IDEを予めダウンロードし、インストールを完了していることを前提とします。Arduino IDEのインストールなどは、インターネットで数多く掲載されていますので、ご自分で探しになられるか、関連書籍をお買い求めください。

必要な外部ソフトなど：

  • Arduino IDE 1.0.xを推奨(安定版のため)
  • DSGatewayLib
  • Desktop Station コマンドステーションソフト(PCから制御する場合)

  • まず、ArduinoをPCに接続し、ドライバをインストールします。インストール方法については、Arduino用ドライバのインストール手順をご覧ください。
    Arduinoのドライバは、Arduino IDEに含まれています。


    ダウンロードした、DSGatewayLibを解凍し、Arduino IDEのLibrariesフォルダ内にフォルダごとコピーしてください。


    Arduino IDEを起動する前もしくは直後にArduinoを接続し、ボードをArduinoの種類にあわせて選択してください。ここでは、Arduino UNOを選択しています。

    シリアルポート(COMポート)の確認と設定変更も忘れずに行いましょう。もし、シリアルポートがArduino以外になく、１つのみの場合は自動的にArduinoのCOMポートが選択されます。



    この時点で、後は自由にArduinoのソフトを作成できるようになっています。もし、サンプルを試しに動かしたい場合は、exampleからDSGatewayLibを選ぶとサンプルのスケッチ（ソフト）が呼びさせるようになるはずです。


    なお、ArduinoとDCC/MM2 ShieldをDesktop Stationと接続する場合は、DSGatewayをexampleの中から開いてください。単独で走らせるサンプルスケッチを開くには、DSLocRunを開いてください。そのまま、Arduinoにアップロードすると、制御できるようになります。

    ファイルメニューからアップロードを選択すると、Arduinoにあなたの作成したソフト（もしくはサンプルソフト）が書き込まれます。アップロード後すぐに、動き出します。

    Arduino用DSGatewayLibの使い方

    Desktop Stationをご使用になる場合は、exampleのDSGatewayを開いて書き込みます。書き込み後は、Desktop Stationの使い方ページをご参考ください。本項は、ご自分でArduinoに自動運転などの処理を記述する際の説明資料です。
    まずは、exampleのDSG_LocRunをベースにご参考にしてください。なお、ArduinoではC言語で命令を記載します。ご存じない方は、「Arduino 入門」などで検索いただき、予め使い方などを確認することをおすすめします。

    DSGatewayLibの動かし方：
    DSGatewayLib.h, SPI.hをインクルードします。グローバル変数などを宣言するところにDSGatewayLib Gateway;などと、DSGatewayLibのクラスを宣言しておきます。ここでは、Gatewayという名前で使えるようにしました。setup()内で、Gateway.begin();を記述することで、使えるようになります。

    機関車のアドレスの決め方：
    MM2機関車の場合、word型の変数とし、"ADDR_MM2+機関車アドレス"となります。
    DCC機関車の場合、word型の変数とし、"ADDR_DCC+機関車アドレス"となります。

    アクセサリのアドレスの決め方：
    MM2アクセサリの場合、word型の変数とし、"ADDR_ACC_MM2+アクセサリアドレス"となります。
    DCCアクセサリの場合、word型の変数とし、"ADDR_ACC_DCC+アクセサリアドレス"となります。

    例：
    word aLocAddr = ADDR_DCC + 34; /* DCCアドレス34の機関車を操作するためアドレス設定用変数をセット */
    Gateway.SetLocoSpeed(aLocAddr, 128);

    例：
    word aAccAddr = ADDR_ACC_MM2 + 4; /* MM2アクセサリアドレス4のポイントを操作するためアドレス設定用変数をセット */
    Gateway.SetTurnout(aAccAddr, true); /* ポイントをまっすぐ */

    提供されている関数：

    関数名
    SetPower(boolean power)
    引数 引数の意味
    boolean power true : 線路に電源投入(運転可)
    false : 供給停止(運転不可)

    関数名
    SetLocoSpeed(word address, int inSpeed)
    引数 引数の意味
    word address 機関車のアドレス
    MM2: ADDR_MM2+1～255
    DCC: ADDR_DCC+1～127
    int inSpeed 機関車の速度(0～1024)
    0:停止,
    1024:最高速度

    関数名
    SetLocoFunction(word address, unsigned char inFunction, unsigned char inPower)
    引数 引数の意味
    word address 機関車のアドレス
    MM2: ADDR_MM2+1～255
    DCC: ADDR_DCC+1～127
    unsigned char inFunction ファンクション番号(0:F0, 1:F1, ・・・)
    DCCはF12まで、MM2はF4まで。
    unsigned char inPower 0: オン,
    1: オフ

    関数名
    SetLocoDirection(word address, unsigned char inDirection)
    引数 引数の意味
    word address 機関車のアドレス
    MM2: ADDR_MM2+1～255
    DCC: ADDR_DCC+1～127
    unsigned char inDirection 進行方向(FWD: 1, REV: 2)

    関数名
    SetTurnout(word address, boolean straight)
    引数 引数の意味
    word address ポイントのアドレス
    MM2: ADDR_ACC_MM2+1～320
    DCC: ADDR_ACC_DCC+1～2044
    byte inSwitch 1: 直進
    0: 曲がる

    運転サンプル

    1. /*********************************************************************
    2.  * Desktop Station Gateway Sketch for Arduino UNO/Leonard
    3.  *
    4.  * Copyright (C) 2014 Yaasan
    5.  *
    6.  */
    8. #include <avr/wdt.h>
    9. #include <SPI.h>
    10. #include "DSGatewayLib.h"
    12. #define CHANGETIME 5000
    14. DSGatewayLib Gateway;
    16. void setup()
    17. {
    18.     
    19.     Gateway.begin();
    20.     
    21.     delay(5000);
    22.     Gateway.SetPower(true);
    23. }
    25. void loop()
    26. {
    27.     int aSpeed;
    28.     word aLocAddr = ADDR_MM2 + 3;←ここを変えると機関車が変更できる
    29.     
    30.     // Go forward
    31.     Gateway.SetLocoDirection( aLocAddr, 1);
    32.     
    33.     for( int i = 0; i < 10; i++)
    34.     {
    35.         aSpeed =i * 73;
    36.         Gateway.SetLocoSpeed( aLocAddr, aSpeed);
    37.         delay(CHANGETIME);
    38.     }
    39.     
    40.     for( int i = 0; i < 10; i++)
    41.     {
    42.         aSpeed = (10 - i) * 73;
    43.         Gateway.SetLocoSpeed( aLocAddr, aSpeed);
    44.         delay(CHANGETIME);
    45.     }
    46.     
    47.     // Go reverse
    48.     Gateway.SetLocoDirection( aLocAddr, 2);
    49.     
    50.     for( int i = 0; i < 10; i++)
    51.     {
    52.         aSpeed =i * 73;
    53.         Gateway.SetLocoSpeed( aLocAddr, aSpeed);
    54.         delay(CHANGETIME);
    55.     }
    56.     
    57.     for( int i = 0; i < 10; i++)
    58.     {
    59.         aSpeed = (10 - i) * 73;
    60.         Gateway.SetLocoSpeed( aLocAddr, aSpeed);
    61.         delay(CHANGETIME);
    62.     }
    63.     
    64. }

    Go to top.