LE910Cx WE866C3-P Bundling Use Case Reference Guide. 1VV Rev

Transcription

1 LE910Cx WE866C3-P Bundling Use Case Reference Guide 1VV Rev

2 SPECIFICATIONS ARE SUBJECT TO CHANGE WITHOUT NOTICE NOTICE While reasonable efforts have been made to assure the accuracy of this document, Telit assumes no liability resulting from any inaccuracies or omissions in this document, or from use of the information obtained herein. The information in this document has been carefully checked and is believed to be reliable. However, no responsibility is assumed for inaccuracies or omissions. Telit reserves the right to make changes to any products described herein and reserves the right to revise this document and to make changes from time to time in content hereof with no obligation to notify any person of revisions or changes. Telit does not assume any liability arising out of the application or use of any product, software, or circuit described herein; neither does it convey license under its patent rights or the rights of others. It is possible that this publication may contain references to, or information about Telit products (machines and programs), programming, or services that are not announced in your country. Such references or information must not be construed to mean that Telit intends to announce such Telit products, programming, or services in your country. COPYRIGHTS This instruction manual and the Telit products described in this instruction manual may be, include or describe copyrighted Telit material, such as computer programs stored in semiconductor memories or other media. Laws in the Italy and other countries preserve for Telit and its licensors certain exclusive rights for copyrighted material, including the exclusive right to copy, reproduce in any form, distribute and make derivative works of the copyrighted material. Accordingly, any copyrighted material of Telit and its licensors contained herein or in the Telit products described in this instruction manual may not be copied, reproduced, distributed, merged or modified in any manner without the express written permission of Telit. Furthermore, the purchase of Telit products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Telit, as arises by operation of law in the sale of a product. COMPUTER SOFTWARE COPYRIGHTS The Telit and 3rd Party supplied Software (SW) products described in this instruction manual may include copyrighted Telit and other 3rd Party supplied computer programs stored in semiconductor memories or other media. Laws in the Italy and other countries preserve for Telit and other 3rd Party supplied SW certain exclusive rights for copyrighted computer programs, including the exclusive right to copy or reproduce in any form the copyrighted computer program. Accordingly, any copyrighted Telit or other 3rd Party supplied SW computer programs contained in the Telit products described in this instruction manual may not be copied (reverse engineered) or reproduced in any manner without the express written permission of Telit or the 3rd Party SW supplier. Furthermore, the purchase of Telit products shall not be deemed to grant either directly or by implication, estoppel, or otherwise, any license under the copyrights, patents or patent applications of Telit or other 3rd Party supplied SW, except for the normal non-exclusive, royalty free license to use that arises by operation of law in the sale of a product. 1VV Rev. 0 Page 2 of

3 USAGE AND DISCLOSURE RESTRICTIONS I. License Agreements The software described in this document is the property of Telit and its licensors. It is furnished by express license agreement only and may be used only in accordance with the terms of such an agreement. II. Copyrighted Materials Software and documentation are copyrighted materials. Making unauthorized copies is prohibited by law. No part of the software or documentation may be reproduced, transmitted, transcribed, stored in a retrieval system, or translated into any language or computer language, in any form or by any means, without prior written permission of Telit III. High Risk Materials Components, units, or third-party products used in the product described herein are NOT fault-tolerant and are NOT designed, manufactured, or intended for use as on-line control equipment in the following hazardous environments requiring fail-safe controls: the operation of Nuclear Facilities, Aircraft Navigation or Aircraft Communication Systems, Air Traffic Control, Life Support, or Weapons Systems (High Risk Activities"). Telit and its supplier(s) specifically disclaim any expressed or implied warranty of fitness for such High Risk Activities. IV. Trademarks TELIT and the Stylized T Logo are registered in Trademark Office. All other product or service names are the property of their respective owners. V. Third Party Rights The software may include Third Party Right software. In this case you agree to comply with all terms and conditions imposed on you in respect of such separate software. In addition to Third Party Terms, the disclaimer of warranty and limitation of liability provisions in this License shall apply to the Third Party Right software. TELIT HEREBY DISCLAIMS ANY AND ALL WARRANTIES EXPRESS OR IMPLIED FROM ANY THIRD PARTIES REGARDING ANY SEPARATE FILES, ANY THIRD PARTY MATERIALS INCLUDED IN THE SOFTWARE, ANY THIRD PARTY MATERIALS FROM WHICH THE SOFTWARE IS DERIVED (COLLECTIVELY OTHER CODE ), AND THE USE OF ANY OR ALL THE OTHER CODE IN CONNECTION WITH THE SOFTWARE, INCLUDING (WITHOUT LIMITATION) ANY WARRANTIES OF SATISFACTORY QUALITY OR FITNESS FOR A PARTICULAR PURPOSE. NO THIRD PARTY LICENSORS OF OTHER CODE SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND WHETHER MADE UNDER CONTRACT, TORT OR OTHER LEGAL THEORY, ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE OTHER CODE OR THE EXERCISE OF ANY RIGHTS GRANTED UNDER EITHER OR BOTH THIS LICENSE AND THE LEGAL TERMS APPLICABLE TO ANY SEPARATE FILES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. 1VV Rev. 0 Page 3 of

4 Contents NOTICE COPYRIGHTS... 2 COMPUTER SOFTWARE COPYRIGHTS... 2 USAGE AND DISCLOSURE RESTRICTIONS... 3 CONTENTS INTRODUCTION... 6 Scope... 6 Audience... 6 Contact Information, Support... 6 Text Conventions HARDWARE AND SOFTWARE FEATURES... 8 Specification Overview... 8 Hardware Interface... 9 Data Rate WIRELESS OPERATIONS Wi-Fi AP Mode Accessing internet through cellular hotspot mode AT COMMANDS WLAN Commands Enable/Disable WLAN - #WLANSTART Enable/Disable broadcast - #WLANBROADCAST Change the SSID name - #WLANSSID Change WLANE mode - #WLANMODE Return assigned IP address - # WLANIP Return signal strength of the network - # WLANSIGNAL Scanning wifi networks - #WLANSCAN Connect to SSID - #WLANCONNECT Disconnect from the network - #WLANDISCONNECT Use to add or change the hostapd.conf. - #WLANCONFIG Use to changing wlan security parameters - #WLANSECURITY Use to change the channel number and the WLAN protocol- # WLANPC 17 1VV Rev. 0 Page 4 of

5 Display last error in detailed form. - #WLANCFGERROR Enable/Disable MAC address filter- # WLANMACMODE Use to add/ remove MAC address to/from accept list - #WLANMACACCEPT Use to add/remove MAC address to/from deny list - #WLANMACDENY Use to set the regulatory domain - #WLANCOUNTRYCODE Enable/Disable WLAN unsolicited message - #WLANINDI Get the device MAC address - #WLANMAC Get the WLAN SW version - #WLANSWV DOCUMENT HISTORY VV Rev. 0 Page 5 of

6 1. INTRODUCTION Scope This document gives a reference for using a set of AT commands for LE910Cx in bundle with WE866C3-P and its usage in different scenarios. Audience This document is intended only for Telit customers who want to set up a bundling application between LE910Cx + WE866C3-P. Contact Information, Support For general contact, technical support services, technical questions and report documentation errors, contact Telit Technical Support at: TS-SRD@telit.com Alternatively, use: For detailed information about where you can buy the Telit modules or for recommendations on accessories and components visit: Our aim is to make this guide as helpful as possible. Keep us informed of your comments and suggestions for improvements. Telit appreciates feedback from the users of our information. 1VV Rev. 0 Page 6 of

7 Text Conventions Danger This information MUST be followed or catastrophic equipment failure or bodily injury may occur. Caution or Warning Alerts the user to important points about integrating the module, if these points are not followed, the module and end user equipment may fail or malfunction. Tip or Information Provides advice and suggestions that may be useful when integrating the module. All dates are in ISO 8601 format, i.e. YYYY-MM-DD. 1VV Rev. 0 Page 7 of

8 2. HARDWARE AND SOFTWARE FEATURES Specification Overview Dual Band 1x1 Wi-Fi + BT module based on QCA a/b/g/n/ac o Up to 40Mhz channel BW for 2.4G (802.11n) o Up to 80Mhz channel BW for 5G (802.11ac) o Max TpT ~215Mbps BT4.1 + HS + BLE 3.3V main input VCCIO input for flexible interface voltage control 1.8V/3V (SDIO, UART, PCM) AP and STA modes Size: 15mm x 13mm x 2.15mm o T&R packaging only (200 units per reel) Temperature Range: -40 C => 85 C o No reliability testing planned PHY Specification Overview Protocol Release Date Frequency (GHz) Bandwidth (MHz) Data Rate (Mbit/s) *SGI MIMO streams Modulation Range (m) Indoor Outdoor b Sept SISO DSSS a Sept SISO OFDM g June SISO OFDM p July /10 27 SISO OFDM n Oct / ac wave Dec 13 5 wave OFDM ad Dec SISO OFDM, SC, LP-SC VV Rev. 0 Page 8 of

9 PHY Specification Overview Protocol Release Date Frequency (GHz) Bandwidth (MHz) Data Rate (Mbit/s) *SGI MIMO streams Modulation Range (m) Indoor Outdoor ax Jul-19 (Draft 1.Jan17) 2.4/ OFDMA Hardware Interface Single antenna port 4 bit SDIO3.0 for Wi-Fi host interface (up to 200Mhz) 4 pin UART for BT interface 32KHz input for Wi-Fi sleep LTE Coexistence interface (2 pin WCI UART) Control pins (Enable input, WoW Output) Debug UART (TX only) Data Rate a (5GHz): 6, 9, 12, 18, 24, 36, 48, 54Mbps b (2.4GHz): 1, 2, 5.5, 11Mbps g (2.4GHz): 6, 9, 12, 18, 24, 36, 48, 54Mbps n (2.4GHz/5GHz): o 20Mhz BW: Up to 72.2Mbps using short GI (MCS0-7) o 40Mhz BW: Up to 144.4Mbps using short GI (MCS0-7) ac (5GHz): o HT20 (MCS0-8), VHT40 (MCS0-9), VHT80 (MCS0-9) a/54Mbps: 13 dbm b/11Mbps: dbm g/54Mbps: 158 dbm n/HT20 (MCS7): dbm ac/HT20 (MCS0): dbm ac/VHT40 (MCS9): 11.5 dbm ac/VHT80 (MCS9): dbm 1VV Rev. 0 Page 9 of

10 3. WIRELESS OPERATIONS This section describes the use case for wireless operations in WE866C3-P module. Wi-Fi AP Mode Accessing internet through cellular hotspot mode. The WE866C3-P module operates in AP mode. The internet connectivity for the Wi-Fi module is provided via cellular modem. The Host MCU uses the AT commands to access the internet through the cellular connection, whereas an external STA can connect to an AP. Routing function for the Wi-Fi module is provided by the Linux OS and is orthogonal to the data AT commands. Figure 1: Hardware Architecture The following example demonstrates how to access the internet through cellular AT commands: Step 1: Prepare module for AP mode using the AT commands fromhost MCU (refer 4. AT Command): AT+CGDCONT=1, IP, Example_APN AT+CGDCONT=2, IP, Example_APN AT#DUALAPN=1 AT#REBOOT // Example_APN should be changed to the cellular provider s // APN. After changing DUALAPN mode, user must reboot for // changes to take affect. // The above changes are persistant, and must be done only // for the first time. 1VV Rev. 0 Page 10 of

11 Step 2: Configure to AP mode using the following command AT#WLANMODE=0 Step 3: Bring up the WE866C3-P module. AT#WLANSTART=1 Step 4: Bring up a data connection in the modem side AT#SGACT=2,1 The Linux and the host MCU will share the cellular data connection (each has its own IP!), and every STA connected to the device will be routed through the Linux platform. 1VV Rev. 0 Page 11 of

12 4. AT COMMANDS WLAN Commands Enable/Disable WLAN - #WLANSTART #WLANSTART Enable/Disable WLAN AT#WLANSTART=[< mode>] Set command to enable/disable WLAN <Mode> - int type, status mode. 0 Disable 1 Enable 2 Auto enable with start <cid> - (PDP Context Identifier) numeric parameter which specifies a particular PDP context definition. Note: Enable WLAN will start it as access point mode by default unless configure prior to start (at#wlanmode). AT#WLANSTART? Note: In case of starting WLAN with no network (no SIM card, +cfun=4, ) WLAN will start without internet access and it will return +CME ERROR: No Internet Access. Note: starting WLAN without <cid> parameter will start the WLAN with <cid>=1. Read command returns the current WLAN status in the format: #WLANSTART: <mode> Where: <mode> 0 WLAN off 1 WLAN on 2 WLAN on and auto start AT#WLANSTART=? <cid> - PDP Context Identifier Test command returns the supported range of values for parameter <mode> <cid>. 1VV Rev. 0 Page 12 of

13 Enable/Disable broadcast - #WLANBROADCAST #WLANBROADCAST Enable/Disable broadcast AT#WLANBROADCA ST=[<mode>] Set command enable/disable broadcast <mode> - int type,status mode. 0 Enable broadcast 1 Disable broadcast AT#WLANBROADCA ST? Read command returns the current broadcast status in the format: #WLANBROADCAST: <mode> Where: <mode> 0 Enable broadcast 1 Disable broadcast AT#WLANBROADCA ST =? Test command returns the supported range of values for parameter <mode> Change the SSID name - #WLANSSID #WLANSSID Change the SSID name AT#WLANSSID=[<ss id>] Set command change the SSID name <ssid> - string type,ssid. AT#WLANSSID? Read command returns the current SSID in the format: #WLANSSID: <ssid> AT#WLANSSID=? Test command returns OK result code. 1VV Rev. 0 Page 13 of

14 Change WLANE mode - #WLANMODE #WLANMODE Change mode: access point/client AT#WLANMODE=[< mode>] Set command change WLANE mode <mode> - int type,status mode. 0 Access point mode (AP) 1 Client mode (STA) 2 - Concurrent mode (AP+STA) AT#WLANMODE? Read command returns the current mode status in the format: #WLANMODE: <mode> Where: <mode> 0 Access point mode (AP) 1 Client mode (STA) 2 - Concurrent mode (AP+STA) AT#WLANMODE=? Test command returns the supported range of values for parameter <mode> Return assigned IP address - # WLANIP #WLANIP Return assigned IP address AT#WLANIP AT#WLANIP=? Execute return the assigned IP address Test command returns OK Return signal strength of the network - # WLANSIGNAL #WLANSIGNAL Return the signal strength of the network we connected to AT#WLANSIGNAL AT# WLANSIGNAL =? Execute return the signal strength of the network we connected to Test command returns OK 1VV Rev. 0 Page 14 of

15 Scanning wifi networks - #WLANSCAN #WLANSCAN Scan Wi-Fi Network AT#WLANSCAN=[< mode>] Set command for client mode only for scanning for wifi networks. <mode> - int type, mode. 0 normal result 1 extend result AT#WLANSCAN=? Test command returns the supported range of values for parameter <mode> Connect to SSID - #WLANCONNECT #WLANCONNECT Connect to SSID AT#WLANCONNECT =[[<ssid>],[<security >],[<key>]] Set command for client mode only, to connect to a given SSID <ssid> - string type, ssid. <security> - int type 0 wep 1 wpax <key> - string type, key. AT#WLANCONNECT? AT#WLANCONNECT =? Read command returns the currently ssid it connect to in the format: # WLANCONNECT: <ssid> Test command reports supported values for the parameter < type >. #WLANCONNECT:(0-1) Disconnect from the network - #WLANDISCONNECT #WLANDISCONNECT Disconnect from SSID AT#WLANDISCONN Execution command will disconnect from the network. Relevant for client ECT mode only. AT#WLANDISCONN ECT=? Test command returns OK result code. 1VV Rev. 0 Page 15 of

16 Use to add or change the hostapd.conf. - #WLANCONFIG #WLANCONFIG Use to add hostapd.conf file. AT#WLANCONFIG=[ <size>] Set command allows to add or change the hostapd.conf. Hostapd configuration file controls many options with regards to AP mode only, in which not all are supported by the current WIFI chip. int type, size. <size> - file size AT#WLANCONFIG=? Test command returns OK result code Use to changing wlan security parameters - #WLANSECURITY #WLANSECURITY Use to add hostapd.conf file. AT#WLANSECURITY =[[<wpa>],[<key_mg mt>,<pairwise>,<key >]] Set command allows changing WLAN security parameters. Relevant for AP mode only. <wpa> - security type 0 disable 1 wpa1 2 wpa2 3 wpa1 + wpa2 <key_mgmt> - security type 0 WPA-PSK 1 WPA-EAP 2 WPA-EAP and WPA-PSK <pairwise> - This controls wpa's data encryption 0 TKIP 1 CCMP 2 - TKIP and CCMP <key> - string type, the network's password AT#WLANSECURITY? AT#WLANSECURITY =? Read command reports the current value of the parameters Test command returns the supported range of values for parameters <wpa>,<key_mgmt>,<pairwise>,<key> in the format: #WLANSECURITY: (0-3),(0-2),"" 1VV Rev. 0 Page 16 of

17 Use to change the channel number and the WLAN protocol- # WLANPC #WLANPC Use to change the channel number and the protocol. AT#WLANPC=<mod e>,<num> Set command allow to change the AP channel number. Relevant for AP mode only. <mode> - protocol type 0 'b' 1 'g' 2 'n' (2.4 GHz) 3 'n' (5 GHz) 4 'ac' 5 a <num> - channel number NOTE: the channel can be selected automatically at run time by setting channel=0 AT# WLANPC? Read command returns the currently channel number and protocol in the format: #WLANPC : <mode>,<num> Example: at#wlanpc? #WLANPC: 1,12 AT#WLANPC=? Test command returns the supported range of values for parameter <mode>.code Display last error in detailed form. - #WLANCFGERROR #WLANCFGERROR display hostapd.conf output error AT#WLANCFGERRO Execution command will display last error in detailed form. R AT#WLANCFGERRO R=? Test command returns OK result code. 1VV Rev. 0 Page 17 of

18 Enable/Disable MAC address filter- # WLANMACMODE #WLANMACMODE Enable/Disable MAC address filtering AT# WLANMACMODE =<mode> Set command allow to enable/disable the MAC address filter. Relevant for AP mode only. <mode> - int type 0 = accept unless in deny list (default) 1 = deny unless in accept list 2 = use external RADIUS server (accept/deny lists are searched first) AT#WLANMACMOD E? Read command returns the currently mode in the format: #WLANMACMODE : <num> Example: at#wlanmacmode? #WLANMACMODE: 1 AT#WLANMACMOD E =? Test command returns the supported range of values for parameter <mode> Use to add/ remove MAC address to/from accept list - #WLANMACACCEPT #WLANMACACCEPT Use to add/ remove MAC address to/from accept list AT#WLANMACACC EPT=<mode>,<mac_ address> Set command allow to add/remove MAC address to/from accept list. Relevant for AP mode only. <mode> - int type 0 remove from accept list 1 add to accept list < mac_address > - string type, mac addres NOTE: mac address should be write with ':' between each Hexa number. Example 00:A0:C6:00:00:17 AT#WLANMACACC EPT? AT#WLANMACACC EPT =? Read command returns the accept list: Test command returns the supported range of values for parameters 1VV Rev. 0 Page 18 of

19 Use to add/remove MAC address to/from deny list - #WLANMACDENY #WLANMACDENY Use to add/remove MAC address to/from deny list AT#WLANMACDENY =<mode>,<mac_add ress> Set command allow to add/ remove MAC address to/from deny list. Relevant for AP mode only. <mode> - int type 0 remove from deny list 1 add to deny list < mac_address > - string type, mac addres NOTE: mac address should be write with ':' between each Hexa number. Example 00:A0:C6:00:00:17 AT#WLANMACDENY? AT#WLANMACDENY =? Read command returns the deny list: Test command returns the supported range of values for parameters Use to set the regulatory domain - #WLANCOUNTRYCODE #WLANCOUNTYCODE Use to set the regulatory domain AT#WLANCOUNTRY CODE=<country_co de > Set command allow to change the country code. Relevant for AP mode only. <country_code> - string type NOTE: This can limit available channels and transmit power. AT#WLANCOUNTRY CODE? Default: US Read command returns the currently country code in the format: #WLANCOUNTRYCODE: <string> Example: at#wlancountrycode? #WLANCOUNTRYCODE: US AT#WLANCOUNTRY CODE =? OK Test command return OK 1VV Rev. 0 Page 19 of

20 Enable/Disable WLAN unsolicited message - #WLANINDI #WLANINDI Enable/Disable WLAN unsolicited message AT#WLANINDI=[<sta te>] Set command enable/disable WLAN unsolicited message <state> - int type,status mode. 0 disable (factory default) 1 enable Note: need to be save on profiles AT#WLANINDI? Read command returns the currently WLAN status in the format: #WLANINDI: <state> AT#WLANINDI=? Where: <state> 0 off 1 on Test command returns the supported range of values for parameter <state> Get the device MAC address - #WLANMAC #WLANMAC Get the device MAC address AT#WLANMAC? Read command returns the device MAC address in the format: #WLANMAC: <string> Example: at#wlanmac? #WLANMAC: 00:A0:C6:00:00:17 OK 1VV Rev. 0 Page 20 of

21 Get the WLAN SW version - #WLANSWV #WLANSWV Get the WLAN SW version AT#WLANSWV? Read command returns the device MAC address in the format: #WLANSWV: <string> Example: at#wlanswv? #WLANSWV: OK 1VV Rev. 0 Page 21 of

22 5. DOCUMENT HISTORY Revision Date Changes First issue Added example commands in section 3.1 1VV Rev. 0 Page 22 of

23