AN192 AP-SH2A-6A WM-RP-10 サンプルプログラム …アプリケーションノート AN192...

アプリケーションノート AN192

ALPHA PROJECT Co.,LTD.

1 AN192 AP-SH2A-6A WM-RP-10 サンプルプログラム解説

Copyright©2019- ALPHA PROJECT Co.,LTD All right reserved

https://www.apnet.co.jp

目次

1. 概要 ....................................................................................................... 3

1.1 概要 ................................................................................................................. 3

1.2 ネットワーク構成イメージ ..................................................................................... 5

1.3 動作モード ......................................................................................................... 6

1.4 開発環境 ............................................................................................................ 7

1.5 ワークスペースについて ........................................................................................ 7

2. サンプルプログラムの構成 ........................................................................... 8

2.1 TCP/IP サンプルプログラム ................................................................................... 9

2.1.1 フォルダ構成 ........................................................................................................ 9

2.1.2 ファイル構成 ....................................................................................................... 10

3. 動作説明 ................................................................................................ 12

3.1 ビルド・デバッグ方法 .......................................................................................... 12

3.2 動作説明 ........................................................................................................... 12

3.2.1 サンプルプログラム概要 ......................................................................................... 12

3.2.2 サンプルプログラム動作内容 ................................................................................... 14

3.2.3 TCP/IP サンプルプログラムの設定パラメータ .............................................................. 15

3.2.4 サンプルプログラムの動作フロー（初期化処理） ......................................................... 18

3.2.5 サンプルプログラムの動作フロー（WLAN モード） ...................................................... 19

3.2.6 サンプルプログラムの動作フロー（BT モード） ........................................................... 29

3.2.7 サンプルプログラムの動作フロー（BLE モード） ......................................................... 35

4. WM-RP-10 制御方法 ................................................................................ 40

4.1 概要 ................................................................................................................ 40

4.2 SPI ................................................................................................................. 40

4.2.1 SPI 仕様 .............................................................................................................. 40

4.2.2 初期化 ................................................................................................................ 41

4.2.3 コマンド制御 ....................................................................................................... 41

4.2.4 非同期メッセージ .................................................................................................. 42

4.2.5 INTR 割り込み信号のアクティブ .............................................................................. 42

AP-SH2A-6A

WM-RP-10サンプルプログラム解説

・SSW

１版２０１９年１０月２３日

Fig1.2-1 動作モード設定

１版２０１１年０６月０６日

JSW3

Fig1.2-1 動作モード設定

１版２０１１年０６月０６日

https://www.apnet.co.jp/






4.2.6 INTR 割り込み発生条件 .......................................................................................... 42

5. Redpine Signals 社提供 API ...................................................................... 43

5.1 概要 ................................................................................................................ 43

5.2 サンプルプログラムで使用している API ................................................................... 44

5.2.1 初期化で使用する API ............................................................................................ 44

5.2.2 WLAN モードで使用する API ................................................................................... 45

5.2.3 BT モードで使用する API ........................................................................................ 55

5.2.4 BLE モードで使用する API ...................................................................................... 61

5.3 API の使用について ............................................................................................. 69

5.4 補足事項 ........................................................................................................... 70

6. 参考資料 ................................................................................................ 72







1. 概要

1.1 概要

本アプリケーションノートでは WM-RP-10 用サンプルプログラムについて解説します。

本サンプルプログラムは「無線 LAN」「Bluetooth Classic」「Bluetooth Low Energy」の各無線通信において、ク

ライアント機能やアクセスポイント機能、あるいは、スレーブ機能やマスター機能などの各種機能を動作確認できる

プログラムです。

また、本サンプルプログラムは WM-RP-10 に内蔵された TCP/IP プロトコルスタックを使用して動作する「TCP/IP

サンプルプログラム」を用意しています。

サンプルプログラムの構成イメージは以下の通りです。

TCP/IP サンプルプログラムの構成イメージ

ホスト CPU

アプリケーション

ネットワーク通信処理部

デバイスドライバ

SPI 通信

ミドルウェア

WM-RP-10 用 API 群/Redpine 社提供 API 群

WM-RP-10 インタフェースドライバ

WiFi プロトコルスタック

RF トランシーバ

RF コントロールドライバ（WiFi/Bluetooth）

Bluetooth プロトコルスタック







各モードの動作内容と動作確認に必要な機器を以下に示します。

モード動作内容動作確認に必要な機器例

■WLAN モード

WLAN Client モード・アクセスポイントへの接続

・TCP クライアントソケット通信

（1 秒経過ごとに 1 バイト送信、

エコーバック）

ネットワーク通信可能な PC/スマート

フォン

アクセスポイント

Wi-Fi Direct モード・Wi-Fi Direct による接続

TCP サーバソケット通信

（エコーバック）

Wi-Fi Direct に対応した PC/スマートフ

ォン

（WM-RP-10 同士の通信不可）

Enterprise Security

Client モード

・アクセスポイントへの接続

・TCP クライアントソケット通信

（1 秒ごとに 1 バイト送信、エコーバック）

ネットワーク通信可能な PC


RADIUS サーバ（EAP-PEAP

(MS-CHAPv2)認証方式対応）

Access Point モード・アクセスポイントの生成

・TCP サーバソケット通信


ネットワーク通信可能な PC/スマート

フォン

■Bluetooth Classic モード ※これ以降、Bluetooth Classic は BT と略して示します。

Slave モード・SPP(Serial Port Profile)通信

・エコーバック

BT Master 動作、SPP 通信可能なスマ

ートフォン

Master モード・SPP 通信

・1 秒経過ごとに 1 バイト送信

BT Slave 動作、SPP 通信可能なスマー

トフォン

■Bluetooth Low Energy モード ※これ以降、Bluetooth Low Energy は BLE と略して示します。

Peripheral モード・GATT バッテリーサービス

・1 秒経過ごとにバッテリー値の更新

BLE スキャン動作可能なスマートフォ

ン

Central モード・GATT バッテリーサービスの参照 GATT バッテリーサービスの通信に対

応したスマートフォン







1.2 ネットワーク構成イメージ

本サンプルプログラムの各機能におけるネットワーク構成イメージ図を示します。（図中のボードは AP-SH4A-4A です）

WLAN Client モード

アクセスポイント経由で、無線通信を行います。

Wi-Fi Direct モード

WM-RP-10 とスマートフォンなどの端末同士が直接無線通信を行います。

※WM-RP-10 同士の接続は行えません。

Enterprise Security Client モード

エンタープライズセキュリティ対応アクセスポイント経由で、無線通信を行います。


＋RADIUS サーバ







Access Point モード

WM-RP-10 側がアクセスポイントとなり、スマートフォンなどの端末が WM-RP-10 に接続して、無線通信を行います。

BT Slave モード

BT Master モード

BLE Peripheral モード

BLE Central モード

WM-RP-10 とスマートフォンなどの端末同士が直接無線通信を行います。

1.3 動作モード

本サンプルプログラムは、AP-SH2A-6A で動作します。CPU 動作モード、各メモリ設定につきましては、

｢AP-SH2A-6A ハードウェアマニュアル｣をご確認ください。







1.4 開発環境

本サンプルプログラムは統合開発環境 High-performance Embedded Workshop を用いて開発されています。

開発に使用した開発環境、コンパイラのバージョンは次のとおりです。

ソフトウェアバージョン備考

High-performance Embedded

Workshop

4.09.01.007 －

SHC 9.4.3 SuperH ファミリ用 C/C++コンパイラパッケージに付

属（※）

※「SuperH ファミリ用 C/C++コンパイラパッケージ」です。ルネサスエレクトロニクス社のウェブサイトより評価版を

ダウンロードできます。

1.5 ワークスペースについて

本サンプルプログラムのプロジェクトファイルは次のフォルダに格納されています。

サンプルプログラムフォルダ備考

TCP/IP サンプルプログラム

プロジェクトフォルダ

\Sample\ap_sh2a_6a_wmrp10 －







2. サンプルプログラムの構成

本章では、サンプルプログラムの中でも WM-RP-10 の動作に関わる箇所を中心に記述し、ミドルウェア・ドライバ等のファ

イルに関しては説明を省略している箇所があります。

【サンプルプログラム一覧】

TCP/IP サンプルプログラム

（内蔵スタックモード）





BT Slave モード

BT Master モード

BLE Peripheral モード

BLE Central モード







2.1 TCP/IP サンプルプログラム

2.1.1 フォルダ構成

サンプルプログラムは、共通して使用するフォルダ（デバイスドライバ、ミドルウェア等）と、WM-RP-10 の動作モード

ごとで異なるアプリケーション用フォルダとで構成されています。

ap_sh2a_6a_wmrp10

Debug RAM 動作用ワークフォルダ

Release ROM 動作用ワークフォルダ

src

wmrp10_apis WM-RP-10 制御

app アプリケーション

inc アプリケーションヘッダ

モード機能部

共通使用部







2.1.2 ファイル構成

■共通して使用するファイル

＜Sample\ap_sh2a_6a_wmrp10\ap_sh2a_6a_wmrp10＞

ap_sh2a_6a_wmrp10.hwp ･･･ HEW 用プロジェクトファイル

＜Sample\ap_sh2a_6a_wmrp10\ap_sh2a_6a_wmrp10\src＞

main.c ･･･メイン処理

timer.c ･･･タイマ処理

sci.c ･･･シリアル処理

boot.c ･･･ CPU 初期化処理

vector.c ･･･割込みハンドラ処理ファイル

rspi.c ･･･ RSPI 処理

iodefine.h ･･･レジスタ定義ヘッダファイル

common.h ･･･共通ヘッダファイル

boarddepend.h ･･･ボード依存ファイル

section.src ･･･セクション定義ファイル

＜Sample\ap_sh2a_6a_wmrp10\ap_sh2a_6a_wmrp10\src\wmrp10_apis＞

WM-RP-10 制御プログラムです。

詳しくは「5. Redpine Signals 社提供 API」で説明します。







■モードごとのファイル

＜Sample\ap_sh2a_6a_wmrp10\ap_sh2a_6a_wmrp10\app＞

bt_slave.c ･･･ BT Slave モードサンプルプログラム

bt_master.c ･･･ BT Master モードサンプルプログラム

ble_peripheral.c ･･･ BLE Peripheral モードサンプルプログラム

ble_central.c ･･･ BLE Central モードサンプルプログラム

wlan_ap.c ･･･ Access Point モードサンプルプログラム

wlan_client.c ･･･ WLAN Client モードサンプルプログラム

wlan_direct.c ･･･ Wi-Fi Direct モードサンプルプログラム

wlan_eap.c ･･･ Enterprise Security Client モードサンプルプログラム

wlan_tcp.c ･･･ TCP server、TCP client サンプルプログラム

sample.c ･･･サンプルアプリケーションメインプログラム

＜Sample\ap_sh2a_6a_wmrp10\ap_sh2a_6a_wmrp10\app\inc＞

bt_slave_config.h ･･･ BT Slave モード用パラメータ定義

bt_master_config.h ･･･ BT Master モード用パラメータ定義

ble_peripheral_config.h ･･･ BLE Peripheral モード用パラメータ定義

ble_central_config.h ･･･ BLE Central モード用パラメータ定義

wlan_ap_config.h ･･･ Access Point モード用パラメータ定義

wlan_client_config.h ･･･ WLAN Client モード用パラメータ定義

wlan_direct_config.h ･･･ Wi-Fi Direct モード用パラメータ定義

wlan_eap_config.h ･･･ Enterprise Security Client モード用パラメータ定義

wlan_tcp_config.h ･･･ TCP server、TCP client 用パラメータ定義

sample.h ･･･サンプルアプリケーションメインヘッダ







3. 動作説明

3.1 ビルド・デバッグ方法

サンプルプログラムを CPU ボード上で実行するためには、ビルドしたサンプルプログラムの実行ファイルを CPU ボードに

ダウンロードする必要があります。

サンプルプログラムのビルド方法および CPU ボードにサンプルプログラムをダウンロードする方法については、それぞれ以下

の資料に詳細な手順が記されていますので、ご参考ください。

アプリケーションノート「AN171 AP-SH2A-6A(SH7269 CPU BOARD) サンプルプログラム解説」の「3.1 ビルド・デバッ

グ方法（USB ファンクション）」

3.2 動作説明

3.2.1 サンプルプログラム概要

サンプルプログラムの概略フローを以下に示します。

本サンプルプログラムは、大きく分けて以下の 3 つの構成で成り立っています。

電源起動直後の「初期化処理」部

ネットワークに参加するまでの「接続処理」部

ネットワークに参加した後でデータ通信を行う「イベント処理」部

初期化フロー WLAN モード初期設定 WLAN Client モード TCP server 動作

Wi-Fi Direct モード TCP client 動作



BT モード初期設定 Slave モード SPP 通信動作

Master モード

BLE モード初期設定 Peripheral モードキャラクタリス

ティックの

送受信動作

Central モード

初期化処理接続処理イベント処理

初期化フロー

どのモードでも最初に行う共通の処理です。周辺機能の初期化、WM-RP-10 モジュールの初期化などを行います。

WLAN モード初期設定

WLAN モードの初期設定を行い、次に各モードの処理を行います。モードの処理と TCP server/client の処理は別々の関

数で構成されているため、呼び出す関数を入れ替えれば、TCP server でも TCP client でも動作させることができます。

BT モード初期設定

BT モードの初期設定を行い、次に各モードの処理を行います。

BLE モード初期設定

BLE モードの初期設定を行い、次に各モードの処理を行います。







本サンプルプログラムはデフォルトで「WLAN Client モード」が動作するよう設定されています。

その他の動作モードで動作を確認する場合は、下記ソースコードの赤字をそれぞれの動作モードに対応した値に変更してくだ

さい。

その後、開発環境上で必ずプロジェクトの再ビルドを行ってください。

Sample\ap_sh2a_6a_wmrp10\ap_sh2a_6a_wmrp10\src\app\inc\sample.h

#define WMRP10_MODE (WLAN_CLIENT)

各動作モードに対応する値

動作確認したいモード設定値

WLAN Client モード（デフォルト） WLAN_CLIENT

Wi-Fi Direct モード WLAN_DIRECT

エンタープライズセキュリティ対応 WLAN Client モード WLAN_EAP

アクセスポイントモード WLAN_AP

BT スレーブモード BT_SLAVE

BT マスターモード BT_MASTER

BLE ペリフェラルモード BLE_PERIPHERAL

BLE セントラルモード BLE_CENTRAL







3.2.2 サンプルプログラム動作内容

サンプルプログラムは、下記の動作を行います。

● 電源起動後、設定した動作モードに従って、対象の機器と接続処理を試みます。

● 接続処理が完了後、各動作モードに従って、以下のイベント処理を行います

・

・


エンタープライズセキュリティ対応 WLAN Client モード

→ ソケット通信


（1 秒ごとに 1 バイトをサーバに送信（「0」から始まり「9」まで、その後「0」に戻る））

・

・


アクセスポイントモード

→ ソケット通信


・ BT スレーブモード

→ SPP 通信


・ BT マスターモード

→ SPP 通信


（1 秒ごとに 1 バイトをサーバに送信（「0」から始まり「9」まで、その後「0」に戻る））

・ BLE ペリフェラルモード

→ キャラクタリスティック（バッテリーサービス）を送信

・ BLE セントラルモード

→ キャラクタリスティック（バッテリーサービス）を受信

● 電源起動後の LED は以下のパターンで点灯/消灯を行います。

接続中： 1000ms 周期で点滅

接続成功後（イベント処理中）：点灯

接続失敗後： 500ms 周期で点滅

アプリケーション終了後

（イベント処理後）

：消灯

● SCI0 を用いて以下のパターンでログ表示を行います。（38400bps、パリティなし、ストップビット 1bit）

ログの確認は、ホスト PC 上のターミナルソフト（ハイパーターミナル等）を使用してください。

アプリケーション開始時： "\r\nApplication Start\r\n"

接続成功時（イベント処理開始時）： "\r\nConnected OK\r\n"

接続失敗時： "\r\nConnected NG\r\n"

アプリケーション終了時

（イベント処理正常終了時）

： "\r\nApplication End (Event OK)\r\n"

アプリケーション終了時

（イベント処理異常終了時）

： "\r\nApplication End (Event NG)\r\n"

また、イベント処理内で送受信を行ったデータもそれぞれログとして表示します。







3.2.3 TCP/IP サンプルプログラムの設定パラメータ

本サンプルプログラムのうち、TCP/IP サンプルプログラムの各動作モードにおけるパラメータを以下にまとめます。

パラメータはユーザの無線・ネットワーク環境に従って適宜変更し、お使いください。

3.2.3.1 WLAN Client モードパラメータ

項目初期値プログラムでの定義(wlan_client_config.h)

周波数帯域 5GHz #define BAND RSI_BAND_5GHZ

SSID TEST #define SSID "TEST"

セキュリティの種類 WPA2 #define SECURITY_MODE 2

PSK(事前共有鍵) 12345678 #define AP_PSK "12345678"

IP アドレス 192.168.1.200 #define MY_IP_ADDR "192.168.1.200"

サブネットマスク 255.255.255.0 #define NETMASK "255.255.255.0"

ゲートウェイアドレス 192.168.1.253 #define GATEWAY "192.168.1.253"

項目初期値プログラムでの定義(wlan_tcp_config.h)

自身のソケット Port 50000 #define CLIENT_PORT_NUM 50000

接続先ソケット IP 192.168.1.201 #define SERVER_IP_ADDR "192.168.1.201"

接続先ソケット Port 50001 #define SERVER_PORT_NUM 50001

3.2.3.2 Wi-Fi Direct モードパラメータ

項目初期値プログラムでの定義(wlan_direct_config.h)


デバイス名 WMRP10 #define DEVICE_NAME "WMRP10"

チャネル 48 #define OPER_CH 48

SSID 接尾文字 Alpha #define SSID_POST_FIX "Alpha"

PSK(事前共有鍵) 12345678 #define WFD_PSK "12345678"

Group Owner インテント

値

16 #define GO_INTENT 16

接続先デバイス名 TargetDevice #define

TARGET_DEVICE_NAME

“TargetDevice”

IP アドレス（※） 192.168.1.201 #define MY_IP_ADDR "192.168.1.201"

サブネットマスク（※） 255.255.255.0 #define NETMASK "255.255.255.0"

ゲートウェイアドレス（※） 192.168.1.253 #define GATEWAY "192.168.1.253"


自身のソケット Port 50001 #define SERVER_PORT_NUM 50001

接続可能なクライアント数 1 #define MAX_CONNECTION 1

※クライアント動作時のみ設定可。

オーナー動作時は以下のデフォルト値で動作します。

項目初期値

IP アドレス 192.168.100.76







3.2.3.3 エンタープライズセキュリティ対応 WLAN Client モードパラメータ

項目初期値プログラムでの定義(wlan_eap_config.h)



認証方式 EAP-PEAP

(MSCHAPV2)

#define METHOD

#define INNER

"PEAP"

"\"auth=MSCHAPV2\""

ID test-user #define IDENTITY "\"test-user\""

パスワード 12345678 #define EAP_PASS "\"12345678\""





自身のソケット Port 50000 #define CLIENT_PORT_NUM 50000

接続先ソケット IP 192.168.1.201 #define SERVER_IP_ADDR "192.168.1.201"

接続先ソケット Port 50001 #define SERVER_PORT_NUM 50001

3.2.3.4 アクセスポイントモードパラメータ

項目初期値プログラムでの定義(wlan_ap_config.h)



チャネル 48 #define OPER_CH 48

セキュリティの種類 WPA2 #define SECURITY_MODE 2

暗号化の種類 CCMP #define ENCRYP_MODE 2

PSK(事前共有鍵) 12345678 #define AP_PSK "12345678"

WLAN クライアント数８ #define MAX_WIFI_CLIENTS 8





自身のソケット Port 50001 #define SERVER_PORT_NUM 50001

接続可能なクライアント数 1 #define MAX_CONNECTION 1







3.2.3.5 BT スレーブモードパラメータ

項目初期値プログラムでの定義(bt_srave_config.h)

デバイス名 BT-Slave-AP-Sa

mple

#define BT_SET_LOCAL_NAME "BT-Slave-AP-Sample"

PIN コード 1234 #define BT_PINCODE "1234"

3.2.3.6 BT マスターモードパラメータ

項目初期値プログラムでの定義(bt_master_config.h)

デバイス名 BT-Master-AP-S

ample

#define BT_SET_LOCAL_NAME "BT-Master-AP-Sample"

接続相手のデバイス名 BT-Slave-AP-Sa

mple

#define

BT_REMOTE_DEVICE_NAME

"BT-Slave-AP-Sample"

PIN コード 1234 #define BT_PINCODE "1234"

3.2.3.7 BLE ペリフェラルモードパラメータ

項目初期値プログラムでの定義(ble_peripheral_config.h)

デバイス名 BLE-Peri-AP-Sa

mple

#define

BLE_SET_LOCAL_NAME

"BLE-Peri-AP-Sample"

ランダムアドレス 00:23:A7:11:

22:33

#define BLE_SET_RAND_ADDR "00:23:A7:11:22:33"

3.2.3.8 BLE セントラルモードパラメータ

項目初期値プログラムでの定義(ble_central_config.h)

デバイス名 BLE-Central-AP

-Sample

#define

BLE_SET_LOCAL_NAME

"BLE-Central-AP-Sample

"

接続相手のデバイス名 BLE-Peri-AP-Sa

mple

#define BLE_SET_RAND_ADDR "BLE-Peri-AP-Sample"

ランダムアドレス 00:23:A7:44:

55:66

#define

BLE_REMOTE_DEVICE_NAME

"00:23:A7:44:55:66"







3.2.4 サンプルプログラムの動作フロー（初期化処理）

どの動作モードでも最初に行う共通の処理です。

処理のいずれかでエラーが起きると、その後の処理が正常に動作しません。

エラーが起きた際はボードと WM-RP-10 の接続などをご確認ください。

1. 周辺機能の初期化

タイマ、SPI、IRQ 割り込みの初期化を行います。

2. WM-RP-10 初期化コマンド

WM-RP-10 モジュールの初期化を行います。

3. Board Ready 待ち

WM-RP-10 モジュールの初期化後、Board Ready 状態になるまで待ちます。

4. Bootload 処理

Bootload 処理を行います。INTR 割り込み信号のアクティブはここで設定します。

電源投入

2.WM-RP-10

初期化コマンド

4.Bootload 処理

3.BoardReady 待ち

「WLAN モード」「BT モード」「BLE モード」

それぞれのフローへ進む

huro-

1.周辺機能の初期化







3.2.5 サンプルプログラムの動作フロー（WLAN モード）

3.2.5.1 サンプルプログラムの動作フロー（WLAN モード初期化共通部）

BT, BLE 以外の動作モードを選択した際に、本項目の処理が行われます。

1. Set Operating Mode コマンド

WM-RP-10 モジュールの動作モードと TCP/IP の機能などを設定します。

・ oper_mode ：使用する動作モードを設定します。

・ feature_bit_map ：セキュリティの有無、WPS 機能の有効/無効などについて設定します。

・ tcp_ip_fieature_bit_map ：モジュール内蔵のプロトコルスタックを使用するか否かを設定します。内

蔵プロトコルスタックを使用しない場合は、ソフトウェアにてプロトコル

スタックを用意する必要があります。

・ custom_feature_bit_map ： DFS チャネル帯の有効/無効(Access Point モードでは DFS チャネルは使

用不可)、ext_custom_feature_bit_map パラメータの有効/無効などを

設定します。

・ ext_custom_feature_bit_map ：アンテナ外部接続の使用/不使用などを設定します。

1.Set Operating Mode

コマンド

3.Init

コマンド

2.Band

コマンド

「Client モード」「Wi-Fi Direct モード」

「Enterprise Security Client モード」「Access Point モード」

それぞれのフローへ進む

初期化フロー完了

（4.Antenna Selection

コマンド）







2. Band コマンド

電波の使用帯域を設定します。

3. Init コマンド

Band コマンドの次に行う必要のある初期化処理です。

4. Antenna Selection コマンド

アンテナの外部接続の使用/不使用などを設定します。（デフォルトはオンチップアンテナ有効）

サンプルはオンチップアンテナを使用するため、本コマンドは省略しています。

3.2.5.2 サンプルプログラムの動作フロー（WLAN Client モード）

動作モードを「WLAN Client モード」を指定した場合に、本項目の処理が行われます。

WLAN モード

初期設定フロー

完了

1.Set Region

コマンド

2.Scan

コマンド

3.PSK

コマンド

4.Join

コマンド

5.Set IP Parameters

コマンド

「TCP client」のフローへ進む







1. Set Region コマンド

仕向地を設定します。アメリカ、欧州、日本を設定できます。

2. Scan コマンド

アクセスポイントをスキャンします。スキャン対象をすべてのチャネルにしたり、限定したりすることができます。

3. PSK コマンド

アクセスポイントの PSK(事前共有鍵)を設定します。セキュリティなしの場合、このコマンドは必要ありません。

4. Join コマンド

アクセスポイントに接続します。アクセスポイントの SSID、セキュリティの種類、データレート、送信出力レベルを設

定します。

5. Set IP Parameters コマンド

IP アドレスを設定します。DHCP の使用/不使用を設定し、使用しない場合は IP アドレス、サブネットマスク、ゲート

ウェイアドレスを設定します。







3.2.5.3 サンプルプログラムの動作フロー（Wi-Fi Direct モード）

動作モードを「Wi-Fi Direct モード」を指定した場合に、本項目の処理が行われます。

「TCP server」のフローへ進む

3.メッセージ

受信？

1.Set Region

コマンド

2.Configure Wi-Fi Direct

Peer-to-Peer Mode

コマンド

6.Join

コマンド

4.Wi-Fi Direct

のメッセージ？

5.デバイス名の

取得

Yes

Yes

No

No

WLAN モード初期設定フロー

完了

7.Set IP Parameters コマンド









2. Configure Wi-Fi Direct Peer-to-Peer Mode コマンド

インテント値、デバイス名、チャネル、SSID 接尾文字、PSK(事前共有鍵)を設定します。

インテント値は 0 から 16 までの値を設定し、相手デバイスとのインテント値を比較し、大きいインテント値を設定した

デバイス側が Group Owner になります。なお、インテント値を 16 にすると強制的に GO となります。

GO になると、Wi-Fi Direct に対応していないデバイスからはアクセスポイントとして検出され、SSID は「DIRECT-[ラ

ンダムな 2 文字][SSID 接尾文字]」になります。

SSID 例：DIRECT-78Alpha

（「DIRECT-」は固定文字列。「78」はランダム文字列。「Alpha」はサンプルプログラムで指定できる SSID）

3. ネゴシエーション処理（メッセージ受信待ち）

対向する Wi-Fi Direct デバイスの情報を受信待ちします。

4. Wi-Fi Direct メッセージか判断

メッセージを受信した後、データ内容を確認し、以下のレスポンス ID であれば、Wi-Fi Direct デバイスからのメッセー

ジとして判断し、接続準備へ進めます。

・RSI_RSP_P2P_CONNREQ（0x30）

・RSI_RESP_WFD_DEV（0x54）

5. デバイス名の取得

Wi-Fi Direct デバイスとの接続には相手のデバイス名を必要とします。そのため、受信した Wi-Fi Direct メッセージか

らデバイス名を取得します。


接続する SSID を指定し、相手のデバイスと接続を行います。


IP アドレスを設定します。DHCP の使用/不使用等を設定し、DHCP を使用しない場合は指定の IP アドレス、サブネッ

トマスク、ゲートウェイアドレスを設定します。







3.2.5.4 サンプルプログラムの動作フロー（エンタープライズセキュリティ対応 WLAN Client モード）

動作モードを「エンタープライズセキュリティ対応 WLAN Client モード」を指定した場合に、本項目の処理が行われます。



2. Set EAP Configuration コマンド

認証方式、ID、パスワードを設定します。

3. Scan コマンド

アクセスポイントをスキャンします。スキャン対象をすべてのチャネルにしたり、限定したりすることができます。


アクセスポイントに接続します。アクセスポイントの SSID、セキュリティの種類、データレート、送信出力レベルを設

定します。

WLAN モード


完了

1.Set Region

コマンド

2.Set EAP Configuration

コマンド

3.Scan

コマンド

4.Join

コマンド

5.Set IP Parameters

コマンド

「TCP client」のフローへ進む








IP アドレスを設定します。DHCP の使用/不使用を設定し、使用しない場合は IP アドレス、サブネットマスク、ゲート

ウェイアドレスを設定します。

3.2.5.5 サンプルプログラムの動作フロー（アクセスポイントモード）

動作モードを「アクセスポイントモード」を指定した場合に、本項目の処理が行われます。

1. Set Region AP コマンド

仕向地を設定します。国、ルール数、チャネル、チャネル数、送信出力レベルを設定します。


IP アドレスを設定します。このコマンドを使用するタイミングが他のモードとは異なりますのでご注意ください。

WLAN モード


完了

1.Set Region AP

コマンド

2.Set IP Parameters

コマンド

3.Configure AP Mode

コマンド

4.Join

コマンド

「TCP server」のフローへ進む







3. Configure AP Mode コマンド

チャネル、SSID、セキュリティの種類、暗号化の種類、PSK(事前共有鍵)、ビーコン間隔、DTIM 間隔、端末キープアラ

イブ間隔、接続可能な WLAN クライアント数を設定します。


アクセスポイントを生成します。SSID、データレート、送信出力レベルを設定します。SSID は Configure AP Mode コ

マンドと同じ内容を設定してください。







3.2.5.6 サンプルプログラムの動作フロー（TCP Server 通信）

動作モードを「Wi-Fi Direct モード」「アクセスポイントモード」を指定した場合に、ネットワークへの参加成功後、本項目

の処理が行われます。

1. Open Socket コマンド

TCP サーバのソケットをオープンします。ポート番号、接続可能な TCP クライアント数を設定します。

2. データ受信待ち

受信するフレームのうち、レスポンス ID が RSI_RSP_DATA_RECEIVE(0x00)であるものがデータです。サンプルプロ

グラム中の API「wmrp10_rsi_data()」でデータ受信を待つことができます。

3. Send Data コマンド

データを送信します。ディスクリプタ、送信データ、データサイズ、IP バージョンを設定します。

サンプルではバージョンは IPv4 とし、受信したデータを設定することによりエコーバックを行っています。

Join コマンド

完了

2.データ受信？

Yes

3.Send Data

コマンド

No

1.Open Socket

コマンド







3.2.5.7 サンプルプログラムの動作フロー（TCP Client 通信）

動作モードを「WLAN Client モード」「エンタープライズセキュリティ対応 WLAN Client モード」を指定した場合に、ネッ

トワークへの参加成功後、本項目の処理が行われます。

1. Open Socket コマンド

TCP クライアントのソケットをオープンします。ポート番号、接続先 IP アドレス、接続先ポート番号を設定します。

2. Send Data コマンド

1 秒経過するたびにデータを送信します。ディスクリプタ、送信データ、データサイズ、IP バージョンを設定します。

サンプルではバージョンは IPv4 とし、1 秒経過時に更新したデータ、1 バイトサイズを設定しています。

3. データ受信待ち

受信するフレームのうち、レスポンス ID が RSI_RSP_DATA_RECEIVE(0x00)であるものがデータです。サンプルプロ

グラム中の API「wmrp10_rsi_data()」でデータ受信を待つことができます。

Join コマンド

完了

1 秒経過？

Yes

2.Send Data

コマンド

No

1.Open Socket

コマンド

3.データ受信？

Yes

No







3.2.6 サンプルプログラムの動作フロー（BT モード）

3.2.6.1 サンプルプログラムの動作フロー（BT モード初期化共通部）

動作モードに「BT スレーブモード」「BT マスターモード」を選択した際に、本項目の処理が行われます。



WM-RP-10 モジュールの動作モードでは WLAN and BT coexistence mode を選択してください。

2. Set Local name コマンド

デバイス名を設定します。

3. Set Profile Mode コマンド

SPP プロファイルを設定します。


コマンド

3.Set Profile Mode

コマンド

2.Set Local name

コマンド

「BT Slave モード」「BT Master モード」それぞれの処理へ進む








3.2.6.2 サンプルプログラムの動作フロー（BT スレーブモード）

動作モードに「BT スレーブモード」を選択した際に、本項目の処理が行われます。

BT モード


完了

1.Set Connectability mode

コマンド

2.Set Device Discovery mode

コマンド

イベント判断

User pincode

request イベント

User linkkey

save イベント

User linkkey


3.イベント

待ち

接続完了？

Auth complete

イベント

Yes

No

4.SPP イベント待ち

SPP 受信？

5.SPP Transfer コマンド

No

Yes







1. Set Connectability mode コマンド

BT 接続を許可します。

2. Set Device Discovery mode コマンド

WM-RP-10 を被検索状態（スレーブモード）に設定します。

このコマンドを実行することにより Master から検索されるようになります。

limited discovering mode はタイムアウト付き、enable discovering mode はタイムアウトなしです。

3. イベント待ち・イベント判断

Masterからの接続要求がイベントとして通知されます。イベントはMasterの要求する接続手順により異なるため、Slave

は受け取ったイベントから接続手順を判断し適切な処理を行う必要があります。

・ User pincode request イベント： PIN コードの入力要求をされたときに発生するイベントです。

これを受信することで Pincode Request Reply コマンドを実行する必

要があります。

接続を要求する Master と同じ PIN コードを設定してください。

あるいは、Master で PIN コードの入力が必要になった場合はこの値を

設定してください。

・ User linkkey save イベント：接続完了通知を受信した時に発生するイベントです。

再接続に使用するリンクキーとともにこのイベントが通知されます。

本サンプルではリンクキーをスタック領域に保存していますが、不揮

発性メモリに保存すれば、電源 OFF、ON 後の次回接続時の Linkkey

Reply で positive reply の設定が可能となります。

・ User linkkey request イベント：リンクキーの入力要求をされたときに発生するイベントです。

過去に接続したことがあり、再接続する場合に通知されることがある

場合、Linkkey Reply コマンドを実行してください。

前回接続したときのリンクキーが保存してある場合は positive reply

を設定し、保存していない場合は negative reply を設定します。

・ Auth complete イベント：接続完了通知を受信した時に発生するイベントです。

4. SPP イベント待ち

SPP を用いて Master からデータの受信待ちを行います。

5. SPP Transfer コマンド

SPP を用いて Master から受信したデータを送信します。







3.2.6.3 サンプルプログラムの動作フロー（BT マスターモード）

動作モードに「BT マスターモード」を選択した際に、本項目の処理が行われます。

続きは次のページ

BT モード


完了

1.Inquiry コマンド

イベント判断

Inquiry response イベント Inquiry complete イベント

2.イベント待ち

Inquiry 完了？

イベント判断

3.Bond コマンド

Yes

No


User linkkey


Auth complete

イベント User linkkey

save イベント

User pincode


接続完了？ No

Yes







1. Inquiry コマンド

BT デバイスを検索します。WLAN のスキャンに相当するコマンドです。

2. イベント待ち

BT デバイスの検索結果はイベントとして通知されます。そのイベントを待ちます。

・ Inquiry response イベント： BT デバイスの検索結果を受信した時に発生するイベントです。

目的とするデバイスの情報を検索結果から取得してください。

・ Inquiry complete イベント： BT デバイスの検索が完了した時に発生するイベントです。

3. Bond コマンド

BT デバイスに接続します。

ただし、あくまで接続の最初の手続きであり、このコマンドが成功しても接続が完了したわけではありません。

また、Bond コマンドが成功すると Bond Response イベントが通知されますが、サンプルプログラムでは Bond

Response イベントにて特別な処理は行いません。

1 秒経過？

Yes

6.SPP Transfer

コマンド

No

5.SPP Connect

コマンド

SPP 受信？

Yes

No

前のページの続き

7.SPP イベント

待ち








・ User linkkey request イベント： BT デバイスとの接続に必要とするリンクキーの入力要求されたとき

に発生するイベントです。

Linkkey Reply コマンドを実行してください。

過去に接続したことがあり、そのときのリンクキーを使う場合は

「positive reply」の応答をし、リンクキーがない場合は「negative

reply」の応答をします。

・ User pincode request イベント： PIN コードの入力要求をされたときに発生するイベントです。

Pincode Request Reply コマンドを実行してください

・ User linkkey save イベント： PIN コードを入力した接続が成功した場合、再接続に使用するリンク

キーを通知されると共に発生するイベントです。

・ Auth complete イベント：接続完了通知を受信した時に発生するイベントです。

5. SPP Connect コマンド

SPP 通信の接続用コマンドです。接続相手のアドレスを指定して接続します。

6. SPP Transfer コマンド

1 秒ごと SPP を用いて Master から 1 バイトのデータを送信します。

7. SPP イベント待ち

SPP を用いて Master からデータの受信待ちを行います。

データを受信していた場合は、SPP を用いて受信したデータを送信します。







3.2.7 サンプルプログラムの動作フロー（BLE モード）

3.2.7.1 サンプルプログラムの動作フロー（BLE モード初期化共通部）

動作モードに「BLE ペリフェラルモード」「BLE セントラルモード」を選択した際に、本項目の処理が行われます。



WM-RP-10 モジュールの動作モードでは WLAN and BTLE coexistence mode を選択します。

2. Set Local name コマンド

デバイス名を設定します。

3. BLE Set Random Address コマンド

任意のランダムアドレスを設定します。


コマンド

3.BLE Set Random Address

コマンド

2.Set Local name

コマンド

「BLE Peripheral モード」「BLE Central モード」それぞれの処理へ進む








3.2.7.2 サンプルプログラムの動作フロー（BLE ペリフェラルモード）

動作モードに「BLE ペリフェラルモード」を選択した際に、本項目の処理が行われます。

1. Add GATT Service Record コマンド

使用するサービスを設定します。

Bluetooth SIG であらかじめ定義されたサービスを使用するか、独自サービスを作成することができます。サンプルでは

あらかじめ定義された「バッテリーサービス(Battery Service)」を設定しています。

※バッテリーサービスとは Bluetooth SIG であらかじめ定義されたサービスです。

バッテリー値の通信を想定したサービスですが、データ構造が単純で分かりやすいという特徴があります。

1.Add GATT Service Record

コマンド

3.BLE Set Advertise Data

コマンド

2.Add Attribute Record

コマンド

BLE モード


完了

4.Advertise Local Device

コマンド

1 秒経過？

5.バッテリー値の更新

6.Set Local Attribute Value

コマンド

Yes

No







2. Add Attribute Record コマンド

サービスのキャラクタリスティックを設定します。

キャラクタリスティックとはサービスを構成する要素のようなものであり、これも Bluetooth SIG であらかじめ定義さ

れています。

まずキャラクタリスティックを宣言し、次に Read/Write 等の属性と値を設定します。

サンプルでは、バッテリー値(Battery Level)を宣言し、Read only、値は 100 を設定しています。

3. BLE Set Advertise Data コマンド

アドバタイジングデータを設定します。

構成は Bluetooth SIG の Generic Access Profile(GAP)で定義されています。

4. Advertise Local Device コマンド

アドバタイジングをします。

5. 1 秒経過後、バッテリー値の更新

1 秒経過するたびにバッテリー値を更新します。

6. Set Local Attribute Value コマンド

バッテリー値のキャラクタリスティックを設定します。

個々のキャラクタリスティックはハンドルで指定します。「2.Add Attribute Record コマンド」でバッテリー値のキャ

ラクタリスティックを設定したときと同じハンドルを指定します。







3.2.7.3 サンプルプログラムの動作フロー（BLE セントラルモード）

動作モードに「BLE セントラルモード」を選択した際に、本項目の処理が行われます。

1.BLE Scan

コマンド

5.Query Device State

コマンド

BLE モード


完了

目的のデバイス？


4.BLE Connect

コマンド

Connected？

6.Query Profile

コマンド

7.Read Characteristic Value by UUID

コマンド

Yes

Yes

No

No

終了

3.BLE デバイスのアドレス取得







1. BLE Scan コマンド

BLE デバイスをスキャンします。


Scan Response イベントを待ちます。目的とするデバイスのレスポンスが通知されるまで待ち続けます。

サンプルでは「BLE-Peri-AP-Sample」というデバイス名のレスポンスを待つようにしています。

3. BLE デバイスのアドレス取得

目的とするデバイスのアドレスを取得します。

また、BLE Scan コマンドを再発行し、Scan 動作を停止させます。

4. BLE Connect コマンド

BLE デバイスに接続します。

5. Query Device State コマンド

デバイスの状態を取得します。接続状態になるまで取得を続けます。

6. Query Profile コマンド

サービスのハンドルを取得します。サービスの UUID を設定します。

サンプルはバッテリーサービスの UUID 0x180F(GATT_SERVICE_BATTERY でマクロ定義)を設定し、ハンドルを取得

しています。

7. Read Characteristic Value by UUID コマンド

キャラクタリスティックを取得します。

キャラクタリスティックの UUID とハンドルを設定します。

サンプルはバッテリー値の UUID 0x2A19(GATT_CHAR_BATTERY_LEVEL でマクロ定義)と「6.Query Profile コマン

ド」で取得したハンドルを設定し、バッテリー値を取得しています。







4. WM-RP-10 制御方法

4.1 概要

WM-RP-10 はホスト CPU とのインタフェースに SPI を採用しています。

ホスト CPU はバイナリコマンドを送信することで WM-RP-10 を制御し、初期化、ネットワークの設定、データの送受信など

を行います。

4.2 SPI

4.2.1 SPI 仕様

WM-RP-10 の SPI 仕様を示します。

機能仕様

接続方式 4 線式接続(MOSI、MISO、CLK、CS)

ボーレート最大 25MHz

動作モードスレーブモード

割り込み INTR 信号

※レベル信号割り込みです。アクティブレベルは

Bootload 処理のときに設定できます。

Table 4.2-1 SPI 仕様

SPI 動作のタイミングチャートを示します。WM-RP-10 はスレーブとなり(ホスト CPU はマスター、MSB ファーストにて

データを送受信します。データは CLK の立ち上がりで有効です。







4.2.2 初期化

WM-RP-10 の初期化のタイミングチャートを示します。ホスト CPU から「0x15」を送信し、そのレスポンスである「0x58」

を WM-RP-10 から受信するために「0x00」（下図では MiscData」）を送信します。

4.2.3 コマンド制御

コマンドによる WM-RP-10 の制御は以下の流れで行います。

1. WM-RP-10 へのコマンドです。ホスト CPU からバイナリコマンドを送信します。

2. WM-RP-10 からの SPI レスポンス（0x58、0x55 など）です。バイナリデータにてホスト CPU に応答が返されます。

3. その後、コマンドのレスポンスの存在を通知する INTR 割り込みが発生します。

4. ホスト CPU はレスポンスを受信します。

0x15,0x00 を送信し、

レスポンス 0x58 を受信する。

ホスト CPU WM-RP-10

１

２

３ INTR 割り込み

4







4.2.4 非同期メッセージ

コマンドに同期して受信する「レスポンス」以外に、同期せず唐突に発生する非同期メッセージがあります（イベントとも呼

びます）。

非同期メッセージはコマンドのやりとりをすることなく、INTR 割り込みが発生します。

非同期メッセージの例として以下のものがあります。

Wi-Fi Direct モードで動作しているときの他のデバイスからの接続要求

Access Point モードで動作しているときのクライアント接続/切断通知

TCP コネクション接続/切断通知など

4.2.5 INTR 割り込み信号のアクティブ

レベル信号割り込みです。アクティブレベルの変更は Bootload 処理時に設定できます。

サンプルプログラムでは、アクティブ High となるように設定しています。

AP-SH2A-6A では IO ポート入力でアクティブ High を認識できるように設定しています。

4.2.6 INTR 割り込み発生条件

以下のいずれかのタイミングで INTR 割り込みが発生します。

コマンドによるレスポンスがあるとき

非同期メッセージがあるとき

無線通信の相手からの受信データがあるとき

Bootload 処理が完了したとき

割り込みが発生したらフレームをリードし、レスポンスまたは非同期メッセージまたはデータを取得します。

サンプルプログラムでは、INTR 信号を検知すると API「rsi_frame_read()」を呼び出してフレームをリードするよう構成さ

れています。







5. Redpine Signals 社提供 API

5.1 概要

本サンプルプログラムでは、Redpine Signals社が提供するAPIを使用してWM-RP-10を制御しています。（これ以降、Redpine

Signals 社提供の API は RSI API と略して示します）

プロジェクトフォルダ内の「src\wmrp_apis\apis」フォルダ以下のソフトウェアが、RSI API です。

本章では、RSI API の中からサンプルプログラムで使用している API を抜粋して解説をします。

RSI API の詳細につきましては、以下のデータシートをご参照ください。

RS9113-WiSeConnect-API-Guide

RS9113-WiseConnect-BT-Classic-Software-PRM-API-Guide

RS9113-WiseConnect-BLE-Software-PRM-API-Guide







5.2 サンプルプログラムで使用している API

5.2.1 初期化で使用する API

5.2.1.1 rsi_sys_init

説明 WM-RP-10 を初期化します。

API パラメータなし

レスポンスパラメータなし

補足本 API は電源起動後に一度だけ呼び出し、その後再初期化しないでください。再度呼び出すと実

行時にエラーが発生します。

5.2.1.2 rsi_waitfor_boardready

説明 WM-RP-10 の初期化が完了したか否かを確認します。



補足本サンプルプログラムでは、API「rsi_sys_init」を実行後に本 API を繰り返し実行し、戻り値が

「SUCCESS（0）」となるまで次処理へ進まないように構成されています。

5.2.1.3 rsi_select_option

説明 WM-RP-10 の動作設定のうちファームウェアアップデートの許可/不許可やバイパスモードの許

可/不許可等をします。

API パラメータ uint8 cmd;

cmd に INTR 割り込み信号のアクティブを設定します。

・アクティブハイ：RSI_LOAD_IMAGE_I_FW(‘1’)

・アクティブロー：RSI_LOAD_IMAGE_I_ACTIVE_LOW_FW(0x71)


補足なし







5.2.2 WLAN モードで使用する API

5.2.2.1 rsi_frame_read

説明 INTR 信号が有効になっているときに使用することで、レスポンス・データ・非同期メッセージ（イ

ベント）を読み出します。



補足 WM-RP-10 の INTR 信号が有効になったときに本 API を実行してください。

本サンプルプログラムでは、「wmrp10_rsi_frame_read()」内で呼び出しており、読み出した

レスポンスやデータは wmrp10_os.c 内で定義された以下の変数に格納するよう構成されていま

す。

・wmrp10_cmd /* コマンドレスポンス格納用 */

・wmrp10_data /* 受信データ格納用 */

・wmrp10_msg /* 非同期メッセージ格納用 */

・f_wlan_cmd /* レスポンス受信通知フラグ */

・f_wlan_data /* データ受信通知フラグ */

・f_wlan_msg /* 非同期メッセージ受信通知フラグ */







5.2.2.2 rsi_oper_mode

説明 WM-RP-10 の動作設定のうち動作モード（無線 LAN 通信か Bluetooth 通信かの選択）や通信の

チャンネル設定等をします。

API パラメータ struct {

uint8 oper_mode[4];

uint8 feature_bit_map[4];

uint8 tcp_ip_feature_bit_map[4];

uint8 custom_feature_bit_map[4];

uint8 ext_custom_feature_bit_map[4];

} operModeFrameSnd;

oper_mode に使用するモードを設定します。

feature_bit_map に以下の項目を設定します。

・セキュリティの有無

・WPS 機能

tcp_ip_feature_bit_map に TCP/IP の機能を設定します。

custom_feature_bit_map に以下の項目を設定します。

・DFS チャネル帯の使用/不使用

・Wi-Fi Direct モードのとき、接続するデバイス数(最大 4 まで可能)

・Access Point モードのとき、SSID ステルス機能の有効/無効

・Access Point モードのとき、クライアントの接続数(最大 8 まで可能)

ext_custom_feature_bit_map にアンテナ外部接続の有無などを設定します。


補足 Access Point モードでは DFS チャネル帯は使用できません。

一度設定した内容を変更するには WM-RP-10 モジュールをハードウェアリセットするしか方法

はありませんのでご注意ください。

5.2.2.3 rsi_band

説明 WLAN モードを使用する際の通信帯域を設定します。

API パラメータ uint8 band (0:2.4GHz, 1:5GHz, 2:Dual band)


補足この関数は rsi_oper_mode()の次に呼び出してください。

Access Point モードの場合、Dual band は設定できません。

一度設定した内容を変更するには WM-RP-10 モジュールをハードウェアリセットするしか方法

はありませんのでご注意ください。







5.2.2.4 rsi_init

説明 WLAN モード動作用の初期化を行います。


レスポンスパラメータ typedef struct {

uint8 macAddress1[6];

uint8 macAddress2[6];

} rsi_initResponse;

macAddress1 に WM-RP-10 モジュールの MAC アドレスが格納されます。

補足この関数は rsi_band()の次に呼び出してください。

本 API を再度呼び出すことで、本 API 以降に設定した内容を初期化することができます。初期化

する状況例を以下に示します。

・rsi_join()を呼び出してエラーが発生したとき

・アクセスポイントに接続後に通信接続を断ったとき

5.2.2.5 rsi_set_region

説明 WLAN モード動作用にモジュールの仕向地を設定します。


uint8 setregion_code_from_user_cmd;

uint8 region_code;

} setRegionFrameSnd;

setregion_code_from_user_cmd

・1：本コマンドでの設定が仕向け地の設定に反映されます。

・0：アクセスポイントのビーコン信号にもとづいて仕向け地の設定が行われます。

region_code に国を設定します。

・0 or 1：US

・2：Europe

・3：Japan


uint8 region_code;

} rsi_uSetRegionRsp;

region_code

・0：invalid region code

・1：US

・2：Europe

・3：Japan

補足なし







5.2.2.6 rsi_join

説明無線 LAN の通信接続（アクセスポイントへの接続、WiFi ダイレクトによる接続、アクセスポイン

トの生成、Access Point モードの WPS プッシュ機能の開始）を行います。


uint8 reserved1;

uint8 securityType;

uint8 dataRate;

uint8 powerLevel;

uint8 psk[RSI_PSK_LEN];

uint8 ssid[RSI_SSID_LEN];

uint8 join_feature_bitmap;

uint8 reserved2[2];

uint8 ssid_len;

uint8 listen_interval[4];

uint8 vap_id;

} joinFrameSnd;

securityType にセキュリティの種類を設定します。

dataRate に 0 を設定すると Auto-rate になります。

powerLevel に送信出力レベルを設定します。

ssid に WLAN Client モードのときは接続するアクセスポイントの SSID を設定します。

Access Point モードのときは自身の SSID を設定します。

ssid_len に SSID の文字数を設定します。


uint8 operState;

} rsi_joinResponse;

WLAN Client モードでアクセスポイントへの接続に成功するとレスポンスが 0x43(‘C’)となり

ます。

Access Point モードでアクセスポイントの生成に成功するか、もしくは Wi-Fi Direct モード

で GO(Group Owner)になるとレスポンスが 0x47(‘G’)となります。

補足なし







5.2.2.7 rsi_ip_param_set

説明 TCP/IP 通信用に IP パラメータを設定します。


uint8 dhcpMode;

uint8 ipaddr[4];

uint8 netmask[4];

uint8 gateway[4];

uint8 hostname[31];

uint8 vap_id;

} ipparamFrameSnd;

DHCP の使用/不使用を dhcpMode に設定します。

ipaddr に IP アドレスを設定します。

netmask にサブネットマスクを設定します。

gateway にゲートウェイアドレスを設定します。


uint8 macAddr[6];

uint8 ipaddr[4];

uint8 netmask[4];

uint8 gateway[4];

} rsi_ipparamFrameRcv;

レスポンスは WM-RP-10 モジュールに設定された MAC アドレス、設定された IP アドレス、

サブネットマスク、ゲートウェイアドレスです。

補足 TCP/IP モード時のみ有効







5.2.2.8 rsi_socket

説明 TCP クライアント、TCP サーバ、UDP のソケットをオープンする。


uint8 ip_version[2];

uint8 socketType[2];

uint8 moduleSocket[2];

uint8 destSocket[2];

union {

uint8 ipv4_address[4];

uint8 ipv6_address[16];

} destIpaddr;

uint8 max_count[2];

uint8 tos[4];

uint8 ssl_bitmap;

uint8 ssl_ciphers;

uint8 webs_resource_name[WEBS_MAX_URL_LEN];

uint8 webs_host_name[WEBS_MAX_HOST_LEN];

uint8 tcp_retry_count;

uint8 socket_bitmap;

uint8 rx_window_size;

} socketFrameSnd;

ip_version にバージョンを設定します。

socketType にソケットのタイプを設定します。

・TCP/SSL クライアント

・TCP/SSL サーバ

・UDP

moduleSocket に自身のポート番号を設定します(1024～49151 まで設定可能)。

destSocket に接続先のポート番号を設定します(1024～49151 まで設定可能)。

destIpaddr に接続先の IP アドレスを設定します。

max_count に接続可能な TCP クライアント数を設定します。


uint8 ip_version[2];

uint8 socketType[2];

uint8 socketDescriptor[2];

uint8 moduleSocket[2];

union {

uint8 ipv4_addr[4];

uint8 ipv6_addr[16];

} moduleIPaddr;

uint8 mss[2];

uint8 window_size[4];

} rsi_socketFrameRcv;

socketDescriptor にソケットディスクリプタが格納されます。








5.2.2.9 rsi_send_data

説明 TCP/IP 内蔵プロトコルスタックを使用して送信するデータをセットする。

API パラメータ uint16 socketDescriptor;

uint8 *payload;

uint32 payloadLen;

uint8 protocol;

uint32 *bytes_sent

socketDescriptor にソケットディスクリプタを設定します。

payload にペイロードを設定します。

payloadLen に送信サイズをを設定します。

protocol にプロトコルを設定します。

bytes_sent に送信成功できたバイト数が格納されます。


5.2.2.10 rsi_send_raw_data

コマンド名 TCP/IP バイパスモード時に送信するデータをセットする。

説明 TCP/IP バイパスモード時の送信

API パラメータ uint8 *payload;

uint32 payloadLen;

uint32 *bytes_sent;

payload にペイロードを設定します。

payloadLen に送信サイズを設定します。

bytes_sent に送信成功できたバイト数が格納されます。

補足 TCP/IP バイパスモード時のみ有効







5.2.2.11 rsi_scan

説明 WLAN Client モードやエンタープライズセキュリティ対応 WLAN Client モード時に、接続する

アクセスポイントのスキャンを行う。


uint8 channel[4];


uint8 reserved[5];

uint8 scan_feature_bitmap;

uint8 channel_bit_map_2_4[2];

uint8 channel_bit_map_5[4];

} scanFrameSnd;

channel にスキャン対象とするチャネルを設定します。0 を設定するとすべてのチャネルをス

キャンします。

ssid にはステルス機能のアクセスポイントをスキャンする場合に SSID を設定します。

スキャン対象とするチャネルを選択的に複数個設定する場合、channel_bit_map_2_4 と

channel_bit_map_5 の該当ビットを設定します。


uint8 rfChannel;

uint8 securityMode;

uint8 rssiVal;

uint8 uNetworkType;


uint8 bssid[RSI_BSSID_LEN];

uint8 reserved[2];

} rsi_scanInfo;

typedef struct {

uint8 scanCount[4];

uint8 padding[4];

rsi_scanInfo strScanInfo[RSI_AP_SCANNED_MAX];

} rsi_scanResponse;

スキャン結果がレスポンスです。

補足なし

5.2.2.12 rsi_psk

説明生成するアクセスポイントの PSK、あるいは、接続するアクセスポイントの PSK を設定する。


uint8 TYPE;

uint8 psk_or_pmk[RSI_PSK_LEN];

uint8 ap_ssid[RSI_SSID_LEN] ;

} PskFrameSnd;

アクセスポイントの PSK(事前共有鍵)を設定する場合は TYPE には 1 を設定します。

psk_or_pmk に PSK(事前共有鍵)を設定します。


補足なし







5.2.2.13 rsi_set_eap

説明エンタープライズセキュリティ対応 WLAN Client モード時に、接続するアクセスポイントのセキ

ュリティの設定をする。


uint8 eapMethod[32];

uint8 innerMethod[32];

uint8 userIdentity[64];

uint8 password[128];

uint8 okc_enable[4];

uint8 private_key_passwd[82];

} setEapFrameSnd;

eapMethod に認証方式を設定します。設定できるのは TLS、TTLS、FAST、PEAP の 4 種類

です。

innerMethod は TTLS または PEAP タイプのとき有効となり、MSCHAP または MSCHAPV2

を選べます。TLS または FAST タイプのときは MSCHAPV2 固定です。

userIdentity には RADIUS サーバに登録した ID を設定します。

password には RADIUS サーバに登録したパスワードを設定します。


補足なし

5.2.2.14 rsi_set_region_ap

説明アクセスポイントモード時に生成するアクセスポイントの仕向地を設定する。

API パラメータ struct{

uint8 setregion_code_from_user_cmd;

uint8 country_code[3];

uint8 no_of_rules[4];

struct {

uint8 first_channel;

uint8 no_of_channels;

uint8 max_tx_power;

} channel_info[MAX_POSSIBLE_CHANNEL];

} setRegionApFrameSnd;

setregion_code_from_user_cmd

・1：本コマンドでの設定が仕向け地の設定に反映されます。

・0：モジュール内部メモリに記憶されている情報にもとづいて仕向け地の設定が行われます。

US domain の設定になります。

country_code に国を設定します。”US ”, “EU ”, “JP ”のいずれかを設定してください。

no_of_rules にルール数を設定します。

channel_info にチャネル、チャネル数、送信出力を設定します。


補足 DFS チャネル帯は使用できません。

送信出力は 18dBm まで設定可能です。







5.2.2.15 rsi_set_ap_config

説明アクセスポイントモード時に生成するアクセスポイントの設定を行う。

API パラメータ typedef struct {

uint8 channel_no[2];


uint8 security_type;

uint8 encryp_mode;

uint8 psk[RSI_PSK_LEN];

uint8 beacon_interval[2];

uint8 dtim_period[2];

uint8 ap_keepalive_type;

uint8 ap_keepalive_period;

uint8 max_sta_support[2];

} rsi_apconfig;

channel_no にチャネルを設定します。

ssid に SSID を設定します。

security_type にセキュリティの種類を設定します。

encryp_mode に暗号化の種類を設定します。

psk に PSK(事前共有鍵)を設定します。

beacon_interval にビーコン信号の間隔を設定します。100 ミリ秒から 1000 ミリ秒まで設定

可能です。ただし、設定できる値は 100 ミリ秒間隔です。

dtim_period に DTIM 間隔を設定します。1 から 255 まで設定可能です。

ap_keepalive_type にキープアライブ種を設定します。

ap_keepalive_period にキープアライブの間隔を設定します。

max_sta_support に最大同時接続数を設定します。


補足 DFS チャネル帯は使用できません。







5.2.3 BT モードで使用する API




「6.2.2 WLAN モードで使用する API」内の API「rs_frame_read」と同一です。



補足 WM-RP-10 の INTR 割り込みが発生したときに本 API を実行してください。

本サンプルプログラムでは、「wmrp10_bt_rsi_frame_read()」内で呼び出しており、読み出し

たレスポンスやデータは wmrp10_os.c と wmrp10_bt_os.c 内で定義された以下の変数に格納

するよう構成されています。

・wmrp10_cmd /* WLAN コマンドレスポンス格納用 */

・wmrp10_data /* WLAN 受信データ格納用 */

・wmrp10_msg /* WLAN 非同期メッセージ格納用 */

・wmrp10_bt_cmd /* BT コマンドレスポンス格納用 */

・wmrp10_bt_event /* BT イベント格納用 */

・f_wlan_cmd /* WLAN レスポンス受信通知フラグ */

・f_wlan_data /* WLAN データ受信通知フラグ */

・f_wlan_msg /* WLAN 非同期メッセージ受信通知フラグ */

・f_bt_cmd /* BT レスポンス受信通知フラグ */

・f_bt_event /* BT イベント受信通知フラグ */










「6.2.2 WLAN モードで使用する API」内の API「rs_oper_mode」と同一です。


uint8 oper_mode[4];





} operModeFrameSnd;


・WLAN and BT coexistence mode を設定してください。

WLAN については Client モードもしくは Access Point モードを設定してください。



・WPS 機能


・TCP/IP bypass モードを設定してください。








一度設定した内容を変更するには WM-RP-10 モジュールをハードウェアリセットを行ってくだ

さい。

5.2.3.3 rsi_bt_set_local_name

説明 WM-RP-10 のローカルデバイス名を設定する


UINT08 NameLength;

INT08 Name[RSI_BT_DEVICE_NAME_LEN];

} SetLocalNameFrameSnd;

NameLengtn にデバイス名の文字数を設定します。

Name にデバイス名を設定します。最大 50 文字までです。


補足なし







5.2.3.4 rsi_bt_set_profile_mode

説明 BT 通信におけるプロファイル設定を行う。


UINT08 ProfileMode; /* 1:SPP Profile */

} SetprofileModeFrameSnd;

SPP プロファイルを設定します。


補足 SPP プロファイル以外は設定できません。

5.2.3.5 rsi_bt_set_connectability_mode

説明 BT 接続の許可/禁止を設定します。


UINT08 ConnectabilityMode; /* 1:enable connection mode */

} SetConnectabilityModeFrameSnd;

enable を設定することで、BT 接続を許可します。


補足このコマンドを発行するだけでは他のデバイスから検索されるようにはなりません。次に説明す

る API「rsi_bt_set_discovery_mode」も必要です。

5.2.3.6 rsi_bt_set_discovery_mode

説明 WM-RP-10 の BT デバイスとしての被検索状態を設定します


UINT08 Mode;

UINT08 Reserved[3];

INT32 Timeout;

} SetDiscvModeFrameSnd;

Mode に検索モードを設定します。

・0（disable discovering）：他のデバイスから検索されない。

・1（enable discovering）：他のデバイスから検索される。

・2（limited discovering）：タイムアウト付きで検索される。

Timeout にミリ秒単位で時間を設定します。limited discovering mode のとき有効です。


補足なし







5.2.3.7 rsi_bt_pincode_reply

説明 BT 接続時の PIN コード要求への応答をします。


UINT08 BDAddress[RSI_BT_BD_ADDR_LEN];

UINT08 ReplyType;

UINT08 Reserved;

UINT08 Pincode[MAX_PINCODE_REPLY_SIZE];

} PincodeReplyFrameSnd;

BDAddress に接続先 BT デバイスのアドレスを設定します。

ReplyType を設定します。

・0（negative）：接続を拒否する。

・1（positive）：接続を許可する。

Pincode に PIN コードを設定します。


補足なし

5.2.3.8 rsi_bt_linkkey_reply

説明 BT 接続時のリンクキー要求への応答をします。



UINT08 ReplyType;

UINT08 Reserved;

UINT08 LinkKey[RSI_BT_LINK_KEY_LEN];

} LinkKeyReplyFrameSnd;

BDAddress に接続先 BT デバイスのアドレスを設定します。

ReplyType を設定します。

・0（negative）：リンクキーがない場合（初めて接続するときなど）

・1（positive）：リンクキーがある場合（過去に接続した際のリンクキーがあるとき）

LinkKey にリンクキーを設定します。（negative reply の場合は不要です）


補足なし







5.2.3.9 rsi_bt_inquiry

説明接続先の BT デバイスの検索を行います。


UINT08 InquiryType;

UINT08 Reserved[3];

UINT32 Duration;

UINT08 MaximumDevicesToFind;

UINT08 Reserved1[3];

} InqFrameSnd;

InquiryType

・0：standard inquiry

・1：inquiry with RSSI

・2：extended inquiry

Duration にミリ秒単位で時間を設定します。extended inquiry のとき有効です。最大 5000

ミリ秒です。

MaximumDevicesToFind に検索するデバイスの最大数を設定します。（1～10）


補足・WLAN のスキャンに相当するコマンドです。

5.2.3.10 rsi_bt_bond

説明発見した BT デバイスと接続します。



} BondFrameSnd;

接続先 BT デバイスのアドレスを設定します。


補足なし







5.2.3.11 rsi_bt_spp_connect

説明接続した BT デバイスと SPP 通信接続を行います。



} SppConnFrameSnd;

接続先 BT デバイスのアドレスを設定します。


補足 Master、Slave 不問です。どちらからでもこのコマンドを使用できます。

5.2.3.12 rsi_bt_spp_transfer

説明 SPP 通信瀬鵜族を行った BT デバイスにデータを送信します。


UINT08 DataLength[2];

UINT08 Data[RSI_BT_MAX_PAYLOAD_SIZE];

} SppTransferFrameSnd;

DataLength に送信データサイズをバイト単位で設定します(200 まで設定可能)。

Data に送信データを設定します。


補足なし







5.2.4 BLE モードで使用する API




「6.2.2 WLAN モードで使用する API」内の API「rs_frame_read」と同一です。



補足 WM-RP-10 の INTR 割り込みが発生したときに本 API を実行してください。

本サンプルプログラムでは、「wmrp10_bt_rsi_frame_read()」内で呼び出しており、読み出し

たレスポンスやデータは wmrp10_os.c と wmrp10_bt_os.c と wmrp10_ble_os.c 内で定義さ

れた以下の変数に格納するよう構成されています。

・wmrp10_cmd /* WLAN コマンドレスポンス格納用 */

・wmrp10_data /* WLAN 受信データ格納用 */

・wmrp10_msg /* WLAN 非同期メッセージ格納用 */

・wmrp10_bt_cmd /* BT コマンドレスポンス格納用 */

・wmrp10_ble_cmd /* BLE コマンドレスポンス格納用 */

・wmrp10_ble_event /* BLE イベント格納用 */

・f_wlan_cmd /* WLAN レスポンス受信通知フラグ */

・f_wlan_data /* WLAN データ受信通知フラグ */

・f_wlan_msg /* WLAN 非同期メッセージ受信通知フラグ */

・f_bt_cmd /* BT レスポンス受信通知フラグ */

・f_ble_cmd /* BLE レスポンス受信通知フラグ */

・f_ble_event /* BLE イベント受信通知フラグ */










「6.2.2 WLAN モードで使用する API」内の API「rs_oper_mode」と同一です。


uint8 oper_mode[4];





} operModeFrameSnd;


・WLAN and BT coexistence mode を設定してください。

WLAN については Client モードもしくは Access Point モードを設定してください。



・WPS 機能


・TCP/IP bypass モードを設定してください。








一度設定した内容を変更するには WM-RP-10 モジュールをハードウェアリセットを行ってくだ

さい。

5.2.4.3 rsi_bt_local_name

説明 WM-RP-10 のローカルデバイス名を設定する

「6.2.3 BT モードで使用する API」内の API「rsi_bt_local_name」と同一です。


UINT08 NameLength;

INT08 Name[RSI_BT_DEVICE_NAME_LEN];

} SetLocalNameFrameSnd;

NameLengtn にデバイス名の文字数を設定します。

Name にデバイス名を設定します。最大 50 文字までです。


補足なし







5.2.4.4 rsi_ble_set_random_address

説明 BLE 接続時のランダムアドレスを設定します。



} SetRandAddFrameSnd;

ランダムアドレスを設定します。


補足なし

5.2.4.5 rsi_ble_device_AddService

説明 BLE 通信で行う GATT サービスを設定します。


UUID_T ServiceUUID;

UINT16 NbrAttributes;

UINT16 MaxAttDataSize;

} AddServiceRecord;

ServiceUUID にサービスの UUID を設定します。

レスポンスパラメータ typedef struct rsi_ble_resp_add_gatt_service {

void *ServiceHndlerPtr;

UINT16 StartHndl;

} RSI_BLE_RESP_ADD_GATT_SERVICE;

ServiceHndlerPtr にサービスのオブジェクトのアドレスが格納されます。

StartHndl に先頭のハンドルが格納されます。

補足 Bluetooth SIG であらかじめ定義されたサービスを使用するか、独自サービスを作成することが

できます。







5.2.4.6 rsi_ble_device_AddServiceAttribute

説明 GATT サービスのキャラクタリスティックを設定します


void *ServiceHndlerPtr;

UINT16 Hndl;

UINT16 Reserved;

UUID_T AttUUID;

UINT08 Prop;

UINT08 Data[31];

UINT16 DataLen;

} AddAttRecord;

ServiceHndlerPtr に Add GATT Service Record コマンドのレスポンスの ServiceHndlerPtr

を設定します。

Hndl にキャラクタリスティックのハンドルを設定します。

AttUUID にキャラクタリスティックの UUID を設定します。

Prop に Read/Write 等の属性を設定します。

Data に値を設定します。

DataLen にサイズを設定します。


補足なし

5.2.4.7 rsi_ble_set_advertise_data

説明アドバタイジングデータを設定します。


UINT08 DataLen;

UINT08 Data[31];

} SetAdvertiseDataFrameSnd;

DataLen にサイズを設定します。

Data に値を設定します。


補足アドバタイジングデータの構成は Bluetooth SIG の Generic Access Profile（GAP）で定義され

ています。







5.2.4.8 rsi_ble_advertise

説明アドバタイジングを行います。


UINT08 Status;

UINT08 AdvertiseType;

UINT08 FilterType;

UINT08 DirectAddrType;

UINT08 DirectAddr[RSI_BT_BD_ADDR_LEN];

UINT16 adv_int_min;

UINT16 adv_int_max;

UINT08 own_add_type;

UINT08 adv_channel_map;

} AdvFrameSnd;

Status に Enable Advertising(1)を設定します。

AdvertiseType

・0x80：Connectable undirected

・0x81：Connectable directed with high duty cycle

・0x82：Scannable undirected

・0x83：Non connectable undirected

・0x84：Connectable directed with low duty cycle

FilterType

・0：Allow Scan Request from Any, Allow Connect Request from Any

・1：Allow Scan Request from White List Only, Allow Connect Request from Any

・2：Allow Scan Request from Any, Allow Connect Request from White List Only

・3：Allow Scan Request from White List Only, Allow Connect Request from White List

Only

DirectAddrType にアドレスタイプを設定します。

adv_int_min にインターバル(最小値)を設定します。

adv_int_max にインターバル(最大値)を設定します。

own_add_type にアドレスタイプを設定します。

adv_channel_map にチャンネルを設定します。


補足なし







5.2.4.9 rsi_ble_scan

説明アドバタイザをスキャンします。


UINT08 Status;

UINT08 Scantype;

UINT08 FilterType;

UINT08 own_add_type;

UINT16 scan_int;

UINT16 scan_win;

} ScanFrameSnd;

Status に Enable Scanning(1)/Disable Scanning(0)を設定します。

Scantype にスキャンタイプを設定します。

・0：Passive Scanning

・1：Active Scanning

FilterType にフィルタタイプを設定します。

・0：Accept all advertisement packets

・1：Accept only white listed device advertisement packets

own_add_type にアドレスタイプを設定します。

scan_int にスキャンインターバルを設定します。

scan_win にスキャンウィンドウサイズを設定します。


補足なし

5.2.4.10 rsi_ble_connect

説明発見した BLE デバイスと接続します。


UINT08 AddressType;


UINT08 Reserved;

UINT16 LeScanInterval;

UINT16 LeScanWindow;

UINT16 ConnIntervalMin;

UINT16 ConnIntervalMax;

UINT16 ConnLatency;

UINT16 SupervisionTimeout;

} ConnectFrameSnd;

AddressType にアドレスタイプを設定します。

BDAddress に接続先の BLE アドレスを設定します。

LeScanInterval にスキャンインターバルを設定します。

LeScanWindow にスキャンウィンドウサイズを設定します。

ConnIntervalMin にインターバル(最小値)を設定します。

ConnIntervalMax にインターバル(最大値)を設定します。

ConnLatency にレイテンシを設定します。

SupervisionTimeout にタイムアウトを設定します。


補足なし







5.2.4.11 rsi_ble_query_device_state

説明アドバタイズ中であるか否か等のデバイスの通信状態の取得をします。


レスポンスパラメータ typedef struct rsi_ble_resp_query_device_state {

UINT08 DeviceState;

} RSI_BLE_RESP_QUERY_DEVICE_STATE;

DeviceState にデバイスの状態が格納されます。（0-disable、1-enable）

・b0:Advertise

・b1:scan state

・b2:connection initiated

・b3:connected state

補足レスポンスの b3 が 1 であれば、接続状態であると判断できます。

5.2.4.12 rsi_ble_query_profile

説明 GATT サービスのハンドルを取得します。


UINT08 BDAddress[6];

UINT08 Reserved[2];

UUID_T ProfileUUID;

} QueryProfileDescFrameSnd;

BDAddress に接続先 BLE デバイスのアドレスを設定します。

ProfileUUID にサービスの UUID を設定します。

レスポンスパラメータ typedef struct profile_descriptor {

UINT08 StartHandle[2];

UINT08 EndHandle[2];

UUID_T ProfileUUID;

} PROFILE_DESCRIPTOR;

StartHandle に先頭のハンドルが格納されます。

EndHandle に最後のハンドルが格納されます。

ProfileUUID にサービスの UUID が格納されます。

補足なし







5.2.4.13 rsi_ble_read_char_value_by_UUID

説明指定の UUID からキャラクタリスティックを取得します。


UINT08 BDAddress[6];

UINT08 StartHandle[2];

UINT08 EndHandle[2];

UINT08 Reserved[2];

UUID_T CharacterUUID;

} ReadCharValByUuidFrameSnd;

BDAddress に接続先 BLE デバイスのアドレスを設定します。

StartHandle に先頭のハンドルを設定します。

EndHandle に最後のハンドルを設定します。

CharacterUUID にキャラクタリスティックの UUID を設定します。

レスポンスパラメータ typedef struct rsi_ble_resp_read_char_value_by_uuid {

UINT16 NumberOfValues;

UINT08 CharacterValue[30];

} RSI_BLE_RESP_READ_CHAR_VALUE_BY_UUID;

NumberOfValues にキャラクタリスティックの要素数が格納されます。

CharacterValue にキャラクタリスティックが格納されます。

補足なし







5.3 API の使用について

RSI API をユーザが使用する場合、ターゲット CPU に対応する必要があります。

WM-RP-10 を使用する環境に合わせて下記の項目をユーザは設定してください。

ハードウェア依存部の作成

ハードウェア環境に合わせてプログラムを作成していただく必要があります。

ハードウェア依存部は以下のファイルです。

<wmrp10_apis\apis\hal フォルダ以下>

rsi_hal_mcu_ioports.c ･･･ I/O ポート処理

rsi_hal_mcu_spi.c ･･･ SPI 通信処理

rsi_hal_mcu_timers.c ･･･タイマ処理

割り込み処理でのフレーム読み出し

INTR 割り込み発生時にフレームを読み出す必要があります。

INTR 割り込み発生により起動される割り込み関数を作成し、その関数からフレーム読み出し用の API

「rsi_frame_read()」を呼び出してください。







5.4 補足事項

API パラメータとレスポンスパラメータの型

API パラメータとレスポンスパラメータの多くは構造体で構成されています。

各構造体の宣言箇所について以下に示します。

rsi_global.h ･･･ WLAN モードで使用する構造体等の宣言

rsi_bt_generic.h ･･･ BT モードと BLE モードで使用する構造体等の宣言

rsi_bt_global.h ･･･ BT モードで使用する構造体等の宣言

rsi_ble_global.h ･･･ BLE モードで使用する構造体等の宣言

データ型

「rsi_common_types.h」で宣言されているデータ型を以下に示します。

typedef unsigned char uint8;

typedef unsigned short uint16;

typedef unsigned int uint32;

typedef signed char int8;

typedef short int16;

typedef long int32;

typedef unsigned char UINT08;

typedef signed char INT08;

typedef unsigned short int UINT16;

typedef short INT16;

typedef unsigned int UINT32;

typedef int INT32;

typedef long SINT32;

データの変換

RSI API には以下に示すデータ変換用の関数が用意されています。

void rsi_uint32_to_4bytes(uint8 *dBuf, uint32 val); ･･･ uint32 型の整数を 4 バイトの配列に設定

void rsi_uint16_to_2bytes(uint8 *dBuf, uint16 val); ･･･ uint16 型の整数を 2 バイトの配列に設定

uint32 rsi_bytes4R_to_uint32(uint8 *dBuf); ･･･ 4 バイトの配列を uint32 型の整数に変換

uint16 rsi_bytes2R_to_uint16(uint8 *dBuf); ･･･ 2 バイトの配列を uint16 型の整数に変換

void rsi_ascii_mac_address_to_6bytes

(uint8 *hexAddr, int8 *asciiMacAddress); ･･･

文字列で表現された MAC アドレスを 6 バイトの配

列に設定







エラーコード

コマンドのレスポンスにはエラーコードが含まれており、コマンドの成功/失敗等のステータス情報を示します。

エラーコードの詳細につきましては、以下の資料をご確認ください。

・RS9113-WiseConnect-Software-PRM

「9 Error Codes」

・RS9113-WiseConnect-BT-Classic-Software-PRM-API-Guide

「3 Bluetooth Classic Error Codes」

・RS9113-WiseConnect-BLE-Software-PRM-API-Guide

「2.5 Bluetooth Generic Error Codes」

「2.6 BLE Mode Error Codes」







6. 参考資料

モジュール仕様の詳細につきましては Redpine Signals 社の以下のデータシートをご確認ください。

RS9113-WiseConnect-Software-PRM

RS9113-WiSeConnect-API-Guide

RS9113-WiseConnect-BT-Classic-Software-PRM-API-Guide

RS9113-WiseConnect-BLE-Software-PRM-API-Guide







商標について

・SH7269 はルネサスエレクトロニクス株式会社の登録商標、商標または商品名称です。

・High-performance Embedded Workshop はルネサスエレクトロニクス株式会社の登録商標、商標または商品名称です。

・SuperH はルネサスエレクトロニクス株式会社の登録商標、商標または商品名称です。

・RS9113DB は、米国 Redpine Signals の米国及びその他の国における登録商標または商標です。

・ＷiseConnect は、米国 Redpine Signals の米国及びその他の国における登録商標または商標です。

・Wi-Fi Direct、WPA、WPA2 は、Wi-Fi Alliance の登録商標、商標または商品名称です。

・Bluetooth、Bluetooth Low Energy およびブルートゥースは、米国 Bluetooth SIG, INC.の米国及びその他の国における登録商標または商標です。

・その他の会社名、製品名は、各社の登録商標または商標です。

ご注意

・本文書の著作権は株式会社アルファプロジェクトが保有します。

・本文書の内容を無断で転載することは一切禁止します。

・本文書に記載されているサンプルプログラムの著作権は株式会社アルファプロジェクトが保有します。

・本サンプルプログラムで使用されているミドルウェアおよびドライバの著作権はルネサスエレクトロニクス株式会社が保有します。

・本文書に記載されている内容およびサンプルプログラムについてのサポートは一切受け付けておりません。

・本文書の内容およびサンプルプログラムに基づき、アプリケーションを運用した結果、万一損害が発生しても、弊社では一切責任を負

いませんのでご了承ください。

・本文書の内容については、万全を期して作成いたしましたが、万一ご不審な点、誤りなどお気付きの点がありましたら弊社までご連絡

ください。

・本文書の内容は、将来予告なしに変更されることがあります。

〒431-3114 静岡県浜松市東区積志町８３４ https://www.apnet.co.jp E-MAIL : [email protected]


AN192 AP-SH2A-6A WM-RP-10 サンプルプログラム …アプリケーションノート AN192...

Documents

Transcript of AN192 AP-SH2A-6A WM-RP-10 サンプルプログラム …アプリケーションノート AN192...