ライブラリ

■概要

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

このWIKIを編集するにはパスワード入力が必要です

認証パスワード