Docs/Intro のバックアップ差分(No.7)

追加された行はこの色です。
削除された行はこの色です。
*Propellar イントロダクション [#we4ede61]
「Propellarをいじってみたいんだけど、どう始めればいいの？」そんな疑問へのソリューションをご提供！

必要なものはこれだけです：
-Propellar搭載ボード(クイックスタートボードがおすすめ）
-PC(OSはWindows か MacOSX か Linux）
-USBケーブル(MiniUSB)
-開発環境(無料です)

以下で解説をしていきます。

**まず、体験できるハードウェアを入手しましょう [#uf56b230]
日本マイクロボット教育社さんで、クイックスタートボードを入手しましょう。
コチラで購入できます→http://www.microbot-ed.com/j_quickstart.html
安くて手早くプロペラを体験できてオイシイです:-)

日本マイクロボット教育社さんは、PARALLAX社さんの日本での代理店です。
http://www.microbot-ed.com/
各種キット・ボードなどを購入できます。

**開発環境を手に入れましょう [#p6b616d0]
開発環境は無償で入手できます。
2種類ありまして、一つはPARALLAX社公式開発環境、もう一つはBradさんという方が作っている開発環境です。

***PARALLAX社公式ツール群 [#cf16e596]
PARALLAX社公式Spin言語開発環境「Propeller Tool」
→http://www.parallaxsemiconductor.com/support/software
PropellarTool以外にも、いくつかのツールがダウンロードできます。
最低限必要なのは、「Propeller Tool v.1.3」です。

クイックスタートボードにはUSBシリアル変換チップが搭載されていますが、これのドライバ(USBシリアルドライバ)は、公式開発環境のインストール中に一緒にインストールされます(インストールするかどうかは選択できます)。


PropellarToolには、Spin言語(後で解説します)のサンプルソースもいっぱい入ってます。すごく勉強になりますので、一読の価値ありです。

***Bradさん謹製ナイスツール群「Brad's Spin Tool」 [#sf2db8bc]
「BST - The multi-platform Propeller Tool Suite」
→http://www.fnarfbargle.com/bst.html
Windows/Linux/Macで動作する開発環境です(バイナリはそれぞれ別に用意されてます)。
公式のツールとの違いは
-Windows以外にも、LinuxとMac用のバイナリが用意されてる
-日本語環境でのソース表示に関するバグがありません(=日本語環境できちんと実行可能)
-GUIがチョット違う
-サンプルソースは付いてません

BSTを使うときには、Windows環境ではUSBシリアルデバイスドライバのインストールが必要です。
USBシリアルドライバはPARALLAX公式ページの「Off-site software」の欄にある「Parallax USB Drivers」を見て下さい。

**その他必要なものを用意しましょう [#k2ae2af1]
あと必要なのは、PCとMini-USBのケーブルです。

***PC [#n7993e31]
開発環境でプロペラのプログラムを書いてプログラムをプロペラクイックスタートボードに書き込むために、PCが必要です。
PARALLAX公式開発環境を使う場合ですと、Windowsが動作しているPCが必要です。
Brad's Spin Toolを使うなら、Windows、MacOSX、Linux(x86)の3種のOS向けに開発環境が用意されています。
Linuxをお使いの場合、ディストリビューションは何でもいいです。((BSTのインストール作業とかは特にありません、アーカイブを展開したら完了ですので。))

***Mini-USBケーブル [#g36510d4]
プロペラクイックスタートボードとPCは、USB A～Mini-USBのケーブルで接続します。
このケーブルは付属してません。なので、適当なのを用意してください。
長さとか適当でいいですが、通信できることが確認されたものを使うようにしましょう。

**開発環境を準備しましょう [#r0bbcbff]
上記のものが用意できましたら、開発環境をインストールしましょう。
インストールは、公式開発環境とBrad's Spin Toolとでだいぶ違います。

どちらがおすすめ、とは言えません、が!Windowsを使う方はどちらもインストールするのをおすすめしたいです。
サンプルソースがすごく役に立ちますので。
LinuxかMacをお使いの方でも、アーカイブ内のサンプルをなんとかして見ていただきたいです。ゼヒ！
(書き中)
***公式開発環境 Propellar Tool [#b4f1ed4f]
まずアーカイブをダウンロードします。

&ref(DL_here.PNG);

Setup-Propeller-Tool-v1.3.zipがダウンロードされます。

次に、これを展開します。
Setup-Propeller-Tool-v1.3.exeが出てきます。

そのSetup-Propeller-Tool-v1.3.exeを実行します。
ウィンドウに表示されている内容をお好みかつ適切に設定し、進めていきます。

&ref(1_start.png);
&ref(2_user_reg.PNG);

特にカスタマイズすることはないと思いますので、Completeでいいと思います。
&ref(3_sel_type.png);

インストールフォルダも特に変更しなくてOKです。してもかまいません。
&ref(4_dest_dir.png);

途中でUSBドライバのインストールをするかどうかのチェックボックスが出てきます。
すでにFTDI USBシリアル変換デバイスのドライバをインストールしてあるなら、このチェックボックスはオフにしてください。
インストールしてないなら、チェックボックスはオンにしておくのがいいですね。
&ref(5_usb_drv.png);

Installというボタンが出てきたら、それを押すとインストールがモリモリ進んでいきます。
&ref(6_install.png);
&ref(7_progress.png);

USBドライバのインストールをチェックしている場合は、USBドライバのインストール進行状況も表示されます。すぐ終わりますが。
USBドライバのインストールのところで、チェック印をつけた場合は、USBドライバのインストールがここで入り、進行状況が表示されます。すぐ終わりますが。
&ref(8_usb_progress.png);

Finishボタンが出てきたら、それを押して終了。
&ref(9_complete.PNG);



***Brad's Spin Tool [#fc6a5cac]
こちらは簡単です。
アーカイブをダウンロードします。
そのアーカイブを展開します。
展開して出てくるバイナリがBST本体です。それを実行すると開発環境が起動します。

-Windows
FTDI VCPドライバを別途入手してインストールします。
-Windows版のインストール
まず、BSTのアーカイブを取得します。これ→http://www.fnarfbargle.com/bst/Latest/bst-0.19.3.exe.zip
アーカイブを展開するとbst.exeというファイルが出てきます。これが本体。
次に、FTDI VCPドライバを別途入手してインストールします。
ドライバはPARALLAX公式ページの「Off-site software」の欄にある「Parallax USB Drivers」からダウンロードできます。
-Linux
大抵のディストリビューションでFTDI USBシリアルドライバは既に入っていると思います。
-MacOSX
FTDI VCPドライバを別途入手してインストールします。
ドライバはコチラから取得してください→http://www.ftdichip.com/Drivers/VCP.htm

-Linux版のインストール
まず、BSTのアーカイブを取得します。これ→http://www.fnarfbargle.com/bst/Latest/bst-0.19.3.linux.zip
アーカイブを展開するとbst.linuxという実行ファイルが出てきます。これが本体です。
USBシリアルドライバですが、大抵のディストリビューションでFTDI USBシリアルドライバは既に入っていると思いますので、ドライバに関しては何もすることはありません。
もしクイックスタートボードを認識しなかった場合は、お使いのディストリビューションで提供されているFTDI USBシリアルドライバをインストールしてください。

-MacOSX版のインストール((titoi2さん、宮崎さん、ご協力ありがとうございました))
まず、BSTのアーカイブを取得します。これ→http://www.fnarfbargle.com/bst/Latest/bst-0.19.3.osx.zip
アーカイブをダブルクリックして展開します。
すると、「bst」という名前のファイルが出てきます。これが本体です。
インストールはbstをアプリケーションフォルダにドロップ。
それと、FTDI VCPドライバを別途入手してインストールします。
MLにて参加者の方がインストールレポートを書いてくださったので転載します。
-----
ちなみに、OSは Mac OS X 10.6.8 snow Lepard です。
FTDI USB-シリアル変換ドライバを入れてみまたらプログラムのがロードできました。

入手元
http://www.ftdichip.com/Drivers/VCP.htm

以下、私が試した手順です。

1.MacOSX (32bit) 2.2.16 を選択。
→ダウンロードされるファイル：FTDIUSBSerialDriver_v2_2_16.dmg

2.ダウンロードされたFTDIUSBSerialDriver_v2_2_16.dmgをダブルクリック。
→イメージがマウント？されるのでFTDIUSBSerialDriver_10_4_10_5_10_6
　をダブルクリック。
※ディレクトリ内にはFTDIUSBSerialDriver_10_3というファイルも存在するがおそらくMacOSX 10.3はこちらですね。

3.インストーラの指示に従ってインストール

4.再起動の必要無し。
　→bsからプログラムがロードできました。(ひゃっは～)
-----