ライブラリ
■概要
3Gシールド(3GIM+3GIMシールド)の機能は,Arduinoからはライブラリ"a3gs"を通じて利用することができます。
■機能
a3gsやa3gimの主な機能は下表の通りです:
分類 | 機能概要 | 補足 |
---|---|---|
コントロール機能 | 3Gシールドの電源制御,初期化・終了等 | |
ショートメッセージ機能 | SMS(ショートメッセージ)の送受信 | SIMカードにより利用の可否有り※1 |
Web機能 | GET/POSTのメソッド発行,Tweet | HTTP/HTTPSのGET/POST |
現在位置取得機能 | GPSによる位置情報取得 | GPS,AGPS |
TCP/IP機能 | TCP/IP通信機能 | |
プロファイル機能 | デフォルトプロファイルの読み書き | 使用するSIMカードに合わせてプロファイル設定が必要となる場合有り |
通信その他機能 | 電波強度,時刻取得,サービス取得,LED制御 |
※1一般に、SMSは音声通話サービスに加入している場合にのみ利用できます。3Gシールドでは、docomoの音声通話可能なSIMカードでの利用を推奨いたします。
■補足
- ライブラリの詳細は,別冊「3Gシールド ライブラリ仕様書」を参照してください。またライブラリが提供する各機能の利用方法については,a3gsライブラリに同梱されているサンプルスケッチをご参照ください。
- ライブラリ関数一覧
分類 | 関数名 | 機能概要 | 補足 |
---|---|---|---|
制御 | getStatus※1 | 状態の取得 | |
begin※1 | ライブラリの初期化 | ||
end※1 | ライブラリの終了 | ||
restart※1 | 3Gシールドのリセット | ||
start※1 | 3Gシールドの電源ON | ||
shutdown※1 | 3Gシールドの電源OFF | ||
getIMEI | IMEIの取得 | ||
setLED | LED1の制御(ON/OFF) | ||
setBaudrate | UART通信速度の設定 | 使用には十分留意 | |
SMS | sendSMS※1 | SMSの送信 | |
availableSMS※1 | SMSの受信状態チェック | ||
readSMS※1 | SMSの読み出し | ||
onSMSReceived | SMS着信時のコールバック設定 | INT0を使用 | |
Web | httpGET※1 | GETメソッドの要求 | httpおよびhttpsが利用可能 |
httpPOST | POSTメソッドの要求 | 同上 | |
tweet※1 | Twitterへの投稿 | ||
GPS | getLocation | 現在位置の取得 | 内蔵GPSを使用 |
TCP/IP | connectTCP※1 | TCPコネクションの接続 | |
disconnectTCP※1 | TCPコネクションの切断 | ||
read※1 | データの読み出し | ||
write※1 | データの書き出し | ||
プロファイル | setDefaultProfile | デフォルトプロファイルの設定 | |
getDefaultProfile | デフォルトプロファイルの取得 | ||
その他 | getServices | 利用可能サービスの取得 | |
getRSSI | 電波強度の取得 | ||
getTime | 現在時刻の取得 | 日付・時刻形式 | |
getTime2 | 現在時刻の取得 | 通算秒形式 | |
getVesrion | IEM上のバージョン取得 |
※1Arduino GSM/GPRSシールド用ライブラリと互換性がある関数
■補足
- a3gsライブラリやa3gimライブラリは、標準のSoftwareSerialライブラリを使ってシリアリポートを1つ使用します。他にSoftwareSerialライブラリのシリアルポートを使う場合には、以下の点に留意してください:
・a3gsライブラリを呼び出した際、本ライブラリで使用しているシリアルポートに対してlisten()を呼び出します。
- a3gsライブラリやa3gimライブラリはINT0を使用しますので、割り込み0に対してdetachInterrupt()/attachInterrupt()等を直接スケッチから呼び出さないようにしてください。
- D2/D4/D5/D6/D7を、スケッチから直接制御しないようにしてください。
- 最終更新:2016-10-13 07:08:45