1 TCP_BP3591 の説明 Ｖ００２ ２０１４／０３／２８
ROHM 社製 WIFi モジュール BP3591 を使用して、無線 LAN により TCP/IP 通信を行うプログラムです。
簡単な文字列によるコマンド(例： “LED0 ON”)を受信して LED の ON/OFF を行います。 受信したデータはエコーバックされます。
無料の開発ツール Atollic TrueSTUDIO for ARM Lite (試用版) で作成したプロジェクトです。
プログラムの開始番地は 0x08000000 です。デバッグが可能です。
目次
１． CPU 基板と WiFi モジュール BP3591 との接続 ... 2 １．１． 「飛石伝ひ CPU 基板」の場合 ... 2 １．２． 「飛石伝ひ I/F 基板」の場合 ... 3 １．３． STM32F4 Discovery 基板の場合 ... 4 ２． TCP/IP 通信のための Network 構成(ローカル接続) ... 5 ３． プログラム実行時の動作と動作確認 ... 6 ３．１． AccessTCP_Local プログラムで試験... 6 １） AccessTCP_Local プログラムの起動 ... 6 ２） エコーバック ... 7 ３） LED ON/OFF ... 7 ３．２． Tera Term で試験 ... 8 １） Tera Term の起動 ... 8 ２） IP アドレスの登録 ... 8 ３） TCP/IP 接続 ... 10 ４） エコーバック ... 11 ５） コマンド送信による LED の ON/OFF ... 12 ４． プロジェクトの構成 ... 13 ４．１． 追加したソースフォルダ ... 14 ４．２． フォルダ main ... 15 ５． Network パラメータの設定 ... 16 ５．１． WiFi ルータの設定 (NetworkParam.h) ... 16５．２． TCP/IP の Port 番号の設定 (NetworkParam.h) ... 16
５．３． TCP/IP のアドレスの設定 (NetworkParam.c) ... 16 ６． TCP_BP3591 のプログラムの構造 ... 17 ６．１． 処理番号を使用したプログラムのフロー ... 17 ６．２． 処理番号を使用したプログラムの形 ... 18 ７． Network 処理モジュールの概要 ... 19 ７．１．ソースフォルダ Network の下のファイル ... 19 ７．２． ソースフォルダ BP3591 ... 20
2 １． CPU 基板と WiFi モジュール BP3591 との接続 WiFi モジュール BP3591 をアクセスするために UART(非同期シリアル通信)を使用します。 １．１． 「飛石伝ひ CPU 基板」の場合 １） ROHM 株式会社製の WiFi モジュール BP3591 と接続用基板 BP359D とのセット 表１．１． １） BP359D と「飛石伝ひ CPU 基板」との接続信号 CN1 番号 BP359D の信号名 CPU 信号名 CPU 機能名 コネクタピン番号 備考 1 GND --- --- --- 2 GPIO0 --- --- --- 3 GPIO1 --- --- --- 4 VCC --- --- +3.3V 5 VCC --- --- +3.3V 6 BOOT_SEL1 --- --- --- 10k の抵抗でプルアップ 7 BOOT_SEL0 --- --- --- 8 FLASH_SEL --- --- --- 9 GND --- --- --- CN2 番号 BP359D の信号名 CPU 信号名 CPU 機能名 コネクタピン番号 備考 1 GND --- --- --- 2 SDDATA1 --- --- --- 3 SDDATA0 --- --- --- 4 UART_RxD PB10 UART3_TX P2-20 5 UART_TxD PB11 UART3_RX P2-19 6 GPIO6 --- --- ---
7 PRST PA1 I/O P2-41 Network_Reset
8 GPIO2 --- --- --- Status_LED
9 GND --- --- ---
２） TMD3591AD との接続
表１．１． ２） TMD3591AD と「飛石伝ひ CPU 基板」との接続信号
番号 TMD3591AD の信号名 CPU 信号名 CPU 機能名 コネクタピン番号 備考
1 VCC --- --- --- +3.3V
2 VCC --- --- --- +3.3V
3 PRST PA1 I/O P2-41 Network_Reset
4 GPIO0 --- --- --- 5 GPIO1 --- --- --- 6 GPIO2 --- --- --- Status_LED 7 GPIO6 --- --- --- 8 M_ANA --- --- --- 9 FLASH_SEL --- --- --- 10 BOOT_SEL_0 --- --- --- 11 UART_RXD PB10 USART3_TX P2-20 12 UART_TXD PB11 USART3_RX P2-19 13 SDATA1 --- --- --- 14 SDATA0 --- --- --- 15 GND --- --- --- 16 GND --- --- ---
3 １．２． 「飛石伝ひ I/F 基板」の場合 １） ROHM 株式会社製の WiFi モジュール BP3591 と接続用基板 BP359D とのセット I/F02 基板の CN1, CN2 に実装することができます。 ２） TMD3591AD との接続 I/F02 基板の P10 に実装することができます。
4 １．３． STM32F4 Discovery 基板の場合 １） ROHM 株式会社製の WiFi モジュール BP3591 と接続用基板 BP359D とのセット 表１．２． １） BP359D と STM32F4 Discovery 基板との接続信号 CN1 番号 BP359D の信号名 CPU 信号名 CPU 機能名 コネクタピン番号 備考 1 GND --- --- --- 2 GPIO0 --- --- --- 3 GPIO1 --- --- --- 4 VCC --- --- +3.3V 5 VCC --- --- +3.3V 6 BOOT_SEL1 --- --- --- 10k の抵抗でプルアップ 7 BOOT_SEL0 --- --- --- 8 FLASH_SEL --- --- --- 9 GND --- --- --- CN2 番号 BP359D の信号名 CPU 信号名 CPU 機能名 コネクタピン番号 備考 1 GND --- --- --- 2 SDDATA1 --- --- --- 3 SDDATA0 --- --- --- 4 UART_RxD PB10 UART3_TX P1-34 5 UART_TxD PB11 UART3_RX P1-35 6 GPIO6 --- --- ---
7 PRST PA1 I/O P1-11 Network_Reset
8 GPIO2 --- --- --- Status_LED
9 GND --- --- ---
２） TMD3591AD との接続
表１．２． ２） TMD3591AD と STM32F4 Discovery 基板との接続信号
番号 TMD3591AD の信号名 CPU 信号名 CPU 機能名 コネクタピン番号 備考
1 VCC --- --- --- +3.3V
2 VCC --- --- --- +3.3V
3 PRST PA1 I/O P1-11 Network_Reset
4 GPIO0 --- --- --- 5 GPIO1 --- --- --- 6 GPIO2 --- --- --- Status_LED 7 GPIO6 --- --- --- 8 M_ANA --- --- --- 9 FLASH_SEL --- --- --- 10 BOOT_SEL_0 --- --- --- 11 UART_RXD PB10 USART3_TX P1-34 12 UART_TXD PB11 USART3_RX P1-35 13 SDATA1 --- --- --- 14 SDATA0 --- --- --- 15 GND --- --- --- 16 GND --- --- ---
5 ２． TCP/IP 通信のための Network 構成(ローカル接続) ルータと PC および CPU 基板の接続は次のようになります。 ルータ WiFi モジュール BP3591 CPU 基板 UART PC
6 ３． プログラム実行時の動作と動作確認
１） プログラムを実行すると基板上の LED LD4(緑)が 1 秒点灯、2 秒消灯 で点滅します。
２） プログラムの動作が開始してから、BP3591 と WiFi ルータの接続が確立するのに、約 20 秒程度かかります。
BP3591 の GPIO2 に Status LED を接続している場合、接続確立中は１秒間隔で点滅します。接続が確立すると点灯した ままになります。
ただし、コンフィグレーションが行われなかった場合など、最初から点灯したままなので注意が必要です。
20 秒近く点滅した後、点灯したら接続が確立したと判断するとよいと思います。
TCP 通信プログラム AccessTCP_Local または Tera Term を使用して TCP/IP 通信の確認を行います。
AccessTCP_Local は Microsoft Visual C# 2010 Express で作成したプログラムです。プロジェクトを公開していますので 興味のある方はご覧ください。インストールして使用する方法も説明しています。(TCP_Server のページ)
３．１． AccessTCP_Local プログラムで試験 １） AccessTCP_Local プログラムの起動
AccessTCP_Local プログラムを起動すると、次のダイアログが表示されます。
7 ２） エコーバック
この例では、送信データに ”How are you?” と入力して、[送信] ボタンをクリックした結果、エコーバックされて受信の 部分に表示されています。
３） LED ON/OFF
ａ） STM32F4 Discovery 基板の場合 ： LED0 : LD5(赤) または LED1 : LD6(青) を ON/OFF します。 ｂ） 「飛石伝ひ CPU 基板」の場合 ： Port1-bit6 または Port1-bit7 を ON/OFF します。
この例では “LED1 ON” を送信しました。
ａ） STM32F4 Discovery 基板で実行している場合は、LD6(青)の LED が点灯します。 ｂ） 「飛石伝ひ CPU 基板」で実行している場合は、Port1-bit7 が ON します。
8 ３．２． Tera Term で試験
１） Tera Term の起動
以前の設定が Serial port を使用に設定してあったので、”Cannot open COM4” のメッセージが表示されました。 [OK] ボタンをクリックします。
２） IP アドレスの登録
9
ルータに設定した DHCP の静的割り当てアドレスを指定して [Add] ボタンをクリックします。
ここに追加されました。[OK] ボタンをクリックしてダイアログを閉じます。
10 ３） TCP/IP 接続
メニューの {File} -> {New connection…} をクリックします。次のダイアログが開きます。
TCP/IP のラジオボタンを選択して、TCP port#: に 10000 を設定します。10000 は TCP_Server のプログラムの NetParam.h で指定している番号です。
[OK] ボタンをクリックしてください。
11 ４） エコーバック
ABCD と PC のキーを押すとエコーバックされて画面に表示されます。
メモ帳で “LED0 ON”と書いたファイルを作成して LED0_ON.txt という名前で保存します。
メニューの {File} -> {Send file…} をクリックして LED0_ON.txt を選択して送信すると、GPIO PD14 に対応した LED が 点灯します。
12 ５） コマンド送信による LED の ON/OFF
メニューの {File} -> {Send file…} をクリックすると次のダイアログが開きます。
“LED0 ON” が記述されたファイル LED0_ON.txt を選択して、[開く(O)] ボタンをクリックします。 次ページに続く
13
送信した “LED0 ON” がエコーバックされて CPU 基板側では対応する LED が点灯します。 LED0_OFF.txt を送信すると、LED が消灯します。
４． プロジェクトの構成
14 ４．１． 追加したソースフォルダ １） CommonModules 共通に使用するモジュールを記述してあります。 時間待ち、文字列操作 などの処理を記述しています。 ２） CommunicateHOST
TCP/IP 通信で受信した “LED0 ON” などの文字列コマンドを処理します。 ３） Handles ａ） HandleTimer2 タイマ割り込みの初期化を記述しています。 ｂ） HandleUART UART(非同期シリアル通信)の初期化を行います。 ４） Network TCP/IP 通信の処理を記述しています。 ａ） Network.h Network.c TCP/IP 通信処理の一番上位のモジュールです。BP3591 のコンフィグレーションを行った後、TCP/IP 通信を行います。 ｂ） NetParam WiFi ルータに接続するためのパラメータと IP アドレスなどを設定します。 ｃ） NetUtilities 文字列の IP アドレスを 32bit のデータに変換する処理や、32bit データを文字列の IP アドレスに変換するなど、 Network 処理に使用する共通処理を記述してあります。 ５） BP3591 : フォルダ Network の下にフォルダ BP3591 があります。 ａ） HandleBP3591 BP3591 のコミュニケーションモードを使用するための WID の書き込み、読み込みを行います。 ｂ） CommunicateBP3591 UART により BP3591 と送受信する処理を行います。 ｃ） ConfigBP3591 BP3591 をコンフィグレーションします。 ｄ） AccessBP3591 受信データからフレームデータを取り出し、種類により処理します。 TCP Server としての処理を行い、受信したコマンドデータの処理を行います。 ６） UserPrograms
15 ４．２． フォルダ main
１） main.c
ａ） main モジュール
プログラム開始のモジュールです。
I/O の初期化、Network の初期化 および TCP/IP 通信処理を呼び出しています。
２） stm32f4xx_it.
16 ５． Network パラメータの設定 本プログラムサンプルでは WiFi ルータの SSID やアクセスのための IP アドレスなどをプログラム埋め込みにしているため、 使用環境に応じて、設定部分を変更する必要があります。 ５．１． WiFi ルータの設定 (NetworkParam.h) NetworkParam.h内の下記の部分を使用するWiFiルータに合わせて書き換えてください。 項目は上から、SSID, SecurityKey, PinCode の３項目です。
//--- // WiFiルータの設定
//--- // 実際の環境に合わせて書き換えてください。
//--- #define defSSID "URoadWPS-35F14B"
#define defSecurityKEY "01234567"
#define defPinCode "76543210"
//--- ５．２． TCP/IP の Port 番号の設定 (NetworkParam.h)
NetworkParam.h 内の下記の部分の TCP/IP にアクセスするための Port 番号を実際に使用する番号に変更してください。
//--- //Port番号 //--- // 実際の環境に合わせて書き換えてください。 //--- #define defTCP_ServerPort 10000 #define defHTTP_ServerPort 10001 //--- ５．３． TCP/IP のアドレスの設定 (NetworkParam.c) NetworkParam.c 内の下記の部分の TCP/IP にアクセスするためのアドレスを実際に使用するアドレスに変更してください。 上から、IP アドレス、 Mask アドレス、 Gateway アドレス です。
//--- // IP Addressの設定
//--- // 実際の環境に合わせて書き換えてください。
//---
uint8_t GLB_uchrIP[4] = {192, 168, 100, 109}; //Source IP Address
uint8_t GLB_uchrMaskIP[4] = {0xFF, 0xFF, 0xFF, 0x00}; //IP Address Mask
uint8_t GLB_uchrGatewayIP[4] = {192, 168, 100, 254}; //Gateway IP Address //---
17 ６． TCP_BP3591 のプログラムの構造 TCP_BP3591 のプログラムは処理番号を使用して、順次処理を行う構造をとっています。 今後、紹介する HTTP Server, Mail 送信、 DDNS 処理 は全てこの構造になっています。 ６．１． 処理番号を使用したプログラムのフロー 処理番号を使用したプログラムの概念的なフローを以下に示します。 この例ではモジュールが 処理番号０、 処理番号１、 処理番号２ の３個の処理で構成されています。 処理番号０ -> 処理番号１ -> 処理番号２ -> 処理番号０ -> ．．．と処理番号０ ～ 処理番号２を繰り返します。 また、戻り値は処理中は -1、 最後の処理番号の処理で正常終了時 0、エラーが発生した場合 NG : 1 以上の値を 返します。 YES 開始 処理番号による分岐 処理番号０の処理 処理番号１の処理 処理番号２の処理 処理終了? NO 処理番号 ＋１ 終了 YES 処理終了? NO 処理番号 ＋１ YES 処理終了? NO 処理番号 = ０ 戻り値 = -1 戻り値 = -1 戻り値 = 0
18 ６．２． 処理番号を使用したプログラムの形 例えば、処理番号 : uint8_t uchrJobNum を用いて次のように処理します。 この例では、通信の処理において 受信待ちをしてデータを受信したらデータの処理をして応答のための送信処理を 行っています。送信処理が終了したら受信待ちに戻ります。 //戻り値 ： // -1 : 処理中 // 0 : OK 終了 // 1 以上 : NG 終了 int16_t 送受信処理() { switch(uchrJobNum){ case 0: intReturn = 受信処理(); if(intReturn == -1){ break; //処理中 } if(intReturn > 0){ intReturn = 1; //NG 終了 break; } 受信データによる処理と送信データ作成(); uchrJobNum++; //次の処理番号 intReturn = -1; //処理中 break; case 1: intReturn = 送信処理(); if(intReturn == -1){ break; //処理中 } uchrJobNum = 0; //処理番号を 0 に戻す intReturn = 0; //OK 終了 break; } return(intReturn); } 上記の 受信処理(); と 送信処理(); の内部も同じ構造で記述されています。戻り値が -1 の時は処理中で同じ処理番号 の部分をループして、処理が OK 終了だった場合、処理番号を進めて、次の処理を行います。
19 ７． Network 処理モジュールの概要 Network 処理のためのモジュールについて概要を説明します。 プロジェクトのソースフォルダ Network のしたに、上位モジュールを記述したファイルと BP3591 をアクセスするための モジュールが記述されたソースファイル群が格納されているソースフォルダ BP3591 があります。 ７．１．ソースフォルダ Network の下のファイル １） Network Network 処理の最上位のモジュールです。 Network の初期化を行った後、Network 通信処理をループします。 ａ） TransaxtNetwork //--- //Network処理 //--- // BP3591の初期化を行った後、Network通信処理をLoopする。 //--- //引数 ： //uint8_t *puchrJobNum : 処理番号のポインタ //---
int16_t TransactNetwork(uint8_t *puchrJobNum);
２） NetParam
ａ） SetNetworkParameter
Network 接続のためのパラメータ、WiFi の SSID, SecurityKEY や IP アドレスなどを設定します。
//--- //Set parameter for Network :
//--- //戻り値: // 0 : OK // 1以上 : NG //--- int16_t SetNetworkParameter(void); ３） NetUtilities Network 処理のための共通モジュールを記述してあります。
20 ７．２． ソースフォルダ BP3591 １） AccessBP3591 ａ） NetworkAccessBP3591 BP3591 にアクセスして Network 通信を行います。 //--- //Network通信処理 //--- //引数 ： // uint8_t *puchrJobNum : 処理番号
// struct sNetworkData *pstructNetworkData : 受信したNetworkデータを格納する構造体のポインタ //戻り値:
// -1 : 処理中
// 0 : OK終了
//---
int16_t NetworkAccessBP3591(uint8_t *puchrJobNum, struct sNetworkData *pstructNetworkData);
ｂ） TCP_AccessBP3591 TCP 通信を行います。
//--- //Access for TCP Server : TCP Server通信処理
//--- //引数 ：
// uint8_t *puchrJobNum : 処理番号
// struct sNetworkExpect *pstructNetworkExpect : 取得するデータを指定する構造体のポインタ // struct sSocket *pstructSocket_TCP : パケットの内容をセットする構造体のポインタ
//戻り値:
// -1 : 処理中
// 0 : OK終了
//---
int16_t TCP_AccessBP3591(uint8_t *puchrJobNum, struct sNetworkExpect *pstructNetworkExpect, struct sSocket *pstructSocket_TCP);
21 ２） CommunicateBP3591 BP3591 との通信処理を行います。 ａ） UART_SendBP3591 BP3591 にデータを送信します。 //--- //Network WiFiBP3591 UART送信
//--- //引数 ： // uint8_t *puchrJobNum : 処理番号のポインタ // uint16_t uintLength : 送信データ数 // uint8_t *puchrData : 送信データのポインタ //戻り値 ： // -1 : 処理中 // 0 : OK終了 //---
int16_t UART_SendBP3591(uint8_t *puchrJobNum, uint16_t uintLength, uint8_t *puchrData);
ｂ） UART_ReceiveBP3591
BP3591 からデータを受信します。
//--- //Network WiFiBP3591 UART受信
//--- //引数 ：
// uint8_t *puchrJobNum : 処理番号のポインタ
// uint8_t *puchrData : 受信データを格納するBufferのポインタ // uint16_t uintLength : 受信データ数をセットするWorkのポインタ //戻り値 ：
// -1 : 処理中
// 0 : OK終了
// 1以上 : NG
//---
22 ｃ） CommunicationReceiveBP3591 BP3591 からの受信データからフレームデータを取り出し、種類に見合ったデータを取得します。 //--- //受信 BP3591 : 受信したデータの種類を識別して種類に見合ったデータを取得する。 //--- //引数 ： //uint8_t *puchrJobNum : 処理番号
//struct sNetworkData *pstructNetworkData : 受信したNetworkデータを格納する構造体のポインタ //戻り値:
// -1 : 処理中
// 0 : OK終了
//---
int16_t CommunicationReceiveBP3591(uint8_t *puchrJobNum, struct sNetworkData *pstructNetworkData);
ｄ） GetReceiveDataAndSetFlag_BP3591 フレームデータから種類に見合ったデータを取得します。 //--- //Data取得とflagセット : 受信データの種類(WID/DATA)によりフラグをセットして種類に見合ったデータを取得する。 //--- //引数 ：
//uint8_t *puchrReceiveData : 受信データが格納されたBufferのポインタ
//struct sNetworkData *pstructNetworkData : 受信したNetworkデータを格納する構造体のポインタ //戻り値:
// 0 : OK
// 1 : NG and Continue
// 2 : NG and End
//---
int16_t GetReceiveDataAndSetFlag_BP3591(uint8_t *puchrReceiveData,
23 ３） ConfigBP3591 ａ） InitializeBP3591 BP3591 との通信に使用する UART を初期化し、BP3591 をコンフィグレーションします。 //--- //WiFi BP3591初期化 //--- //引数 ： // uint8_t *puchrJobNum : 処理番号のポインタ
// struct sNetworkData *pstructNetworkData : 受信したNetworkデータを格納する構造体のポインタ // struct sNetworkExpect *pstructNetworkExpect : 取得するデータを指定する構造体のポインタ //戻り値:
// -1 : 処理中
// 0 : OK
// 1 : NG
//---
int16_t InitializeBP3591(uint8_t *puchrJobNum, struct sNetworkData *pstructNetworkData,
struct sNetworkExpect *pstructNetworkExpect);
ｂ） EnterCommunicationMode BP3591 をコミュニケーションモードにします。 //--- //コミュニケーションモードに移行 //--- //引数 ： // uint8_t *puchrJobNum : 処理番号のポインタ //戻り値: // -1 : 処理中 // 0 : OK // 1 : Timeout //---
24 ｃ） ConfigurationBP5391
BP3591 をコンフィグレーションします。
//--- //コンフィグレーションBP5391 : 接続するWiFiのSSIDやBP3591のIP Address, Port番号などを設定する。 //--- //引数 ：
// uint8_t *puchrJobNum : 処理番号のポインタ
// struct sNetworkExpect *pstructNetworkExpect : 取得するデータを指定する構造体のポインタ //戻り値 : // -1 : 処理中 // 0 : OK // 1 : NG(初期化失敗) // 2 : Network ParameterがFlashMemoryに設定されていない。 //---
int16_t ConfigurationBP5391(uint8_t *puchrJobNum, struct sNetworkExpect *pstructNetworkExpect);
４） HandleBP3591
BP3591 のコンフィグレーションモードにおいて WID 書き込み、読み込みを行います。
WID 処理をするためのモジュールを全て記述してあります。
25 改訂履歴
Ｖ００１ ２０１４／０１／３１ 初版
