Skywire™ Beaglebone Black Cape User Manual
Contents
1. 38 NimbeLink I okywire Beagle Bone Black Cape User Manual NimbeLink Corp Published December 2014 NimbeLink Smart Simple Cellular PN 30019 REV 2 NimbeLink Corp All Rights Reserved 1 Contents 1 INTRODUCTION M O P 3 1 1 OVERVIEW et 3 1 2 IPRODWETIDESGRIPTION 2 22 222r cruore quema can i eui nq enge acea v queo suu nda deal nodus ade nta AEA EEE 3 1 3 ORDERABLE PARTS C M 4 L4 ADDITIONAL RESOURCES saiasicasecs sia useesesstesansaawnson causes 4 2 icixgahIcsxp iuddo 5 2 1 ORERATING MODES edes Copia Bee p uS a RENE ERR cncacendasecsvnacscecatashea TREE sad lan ga a E RR ai 5 2 1 1 Toy egere litere 5 2 2 IMOUNTINGYOUR CAPE cintcstccccacsacctcnstncccdecenccduasanecssaestcedansssdeacecatccknedaheeseaesdcedeatsandecdesnnecdnadanceaedesdeedvestueuncnsshenneas 6 2 3 SKYWIRE PEACEMENT secedere reeeeee eere dee res Pee speso bles veovensncedhdces re e ex eeu Pies b 7 2 4 UART CONFIGURATION e C CE2. 8 2S WSB CONNECTION e RER 12 2 6 DEVIGE 8 2 7 SENDINGA TEXT MESSAGE cerror esis ectasice canasstdccnasaadsanaeaca dendesedecnessid adnaestaacsenecd candied sunasa acanaseea CREER ER 8 2 8 JESTABLISHING A TCP IP CONNECTION 262 eite rote ibat e tette beu e seduces ehe ERR Ede ceu er e ep pe 12 2 9 SKYWIRE GPS GLONASS AND M2MLOCATE 12 PN 30019 REV 2 NimbeLink Corp Rights Reserved 2 1 Introduction 1 1 Overview This document is the user manual for the Skywire Beagle Bone Black Cape Throughout the document Skywire Beagle Bone Black Cape will often be referred to as the cape although it may be referred to by its full name The NimbeLink Skywire modem is available with bundled data plans from leading cellular carriers The Skywire cellular modem and antennas are sold separately Make sure you check the Nimbelink s Skywire Beaglebone Black Cape product page for the most up to date information 1 2 Product Description Connect the Beaglebone Black development platform to the Internet of Things loT quickly and easily with Nimbelink s Skywire Beaglebone Black Cape Whether you are a hobbyist or a developer preparing a product for launch Nimbelink s cape an
3. Skywire Cellular Modem Orient the Skywire Cellular Modems cellular U FL connectors with the two circles inside the Skywire Cellular Modem Socket footprint on the cape Check to make sure that all the pins are aligned with the headers then gently push the modem into the socket Using an U Fl connector tool connect the primary cellular antenna cable to the Skywire s primary cellular antenna connector X1 Attach the cellular antenna to the SMA jack attached to the primary cellular antenna cable Step 3 Power up and connect to the Beaglebone Black Plug in the 5V power supply 2 5A recommended to the Beaglebone Black LEDs D2 D3 and D14 will illuminate on your cape Open Tera Term and initiate a connection to the Beaglebone Black Step 4 Connect to the Skywire cellular modem The Skywire cellular modems on off pin are pulled to ground by default causing the Skywire to turn on The on off signal can be controlled by pin P8 8 please refer to the reference schematic for further information On devices running Debian 3 8 13Bone68 the device tree overlay will automatically load upon bootup The device tree overlay for the cape will configure the cape to initiate UART 2 for the XBee socket UART4 for the Skywire socket CAN1 and 2 GPIOS to control the Skywire s DTR and on off signals Check that there are no jumpers connected to J5 or J8 6 This will cause the Skywire sockets to connect to its default UART c
4. by issuing the following commands sudo apt get update sudo apt get install ppp Step Two Connect to the Skywire Cellular Modem via USB Connect to the Skywire Cellular modem via the capes USB hub by using the USB type A to mini B cable that was provided with the cape Plug the USB A connection into the Beaglebone and the USB mini B into the cape Issue the following command Isusb An output resembling the following should appear this confirms that the Beaglebone sees the USB devices root beaglebone lsusb Bus 001 Device 008 ID 0424 2514 Standard Microsystems Corp USB 2 0 Hub Bus 001 Device 001 ID 1d6b 0002 Linux Foundation 2 0 root hub Bus 002 Device 001 ID 1d6b 0002 Linux Foundation 2 0 root hub Bus 001 Device 009 ID 1bc7 1010 Device 008 is the onboard USB hub and device 009 is the Skywire cellular modem the device numbers may be different on your system If the Skywire and USB hub are not present in the Isusb response restart the Beaglebone Black PN 30019 REV 2 NimbeLink Corp Rights Reserved 13 Step Three Interface to the Skywire Cellular Modem The Skywire EVDO modem presents 4 USB devices dev ttyUSBO dev ttyUSB1 dev ttyUSB2 dev ttyUSB3 The device dev ttyUSB3 is the command and data interface to the EVDO modem To configure the PPP daemon for use with this Telit modem two files need to be created in the etc ppp peers directory First as superuser root create etc ppp peers verizon
5. Cape Schematic Nimbelink s Skywire Beaglebone Black Cape Github Nimbelink s Skywire 2G 1xRTT Product Page Nimbelink s Skywire 3G CDMA EVDO Product Page Telit s CE910 Hardware User Guide Telit s DE910 Hardware User Guide PN 30019 REV 2 NimbeLink Corp Rights Reserved 4 2 Getting Started 2 1 Operating modes 2 1 4 Introduction Nimbelink s Skywire Beaglebone Black Cape is designed to allow the cape to be compatible with as many Beaglebone Black capes as possible while still providing cellular connectivity Every cape will utilize different I O s from the Beaglebone To allow the Skywire cellular modem to always have a non conflicted communication path with the Beaglebone the Skywire s UART signal is routed to a MUX This allows the modem to communicate with the Beaglebone over any one of four different UART connections Alternatively the user can also communicate between the Skywire cellular modem and the Beaglebone via USB Upon initialization of the cape by the Device Tree overlay the default operating mode will set the I O connections as shown in Table 3 1 Table 3 1 Default Operating Mode Connections PIN Connection Connected Device P9 24 CAN1 RX CAN1 P9 26 CAN1 CAN1 P9 21 UART2 TX XBee Socket P9 22 UART2 RX XBee Socket P9 11 UARTA RX Skywire Socket P9 13 UARTA TX Skywire Socket P8 8 SKY ON OFF Skywire On Off Signal P8 9 SKY DTR Skywire DTR If the user wishes to use a differe
6. NimbeLink Corp All Rights Reserved 10 Reset Power and repeat steps 4 through 6 before continuing Step 9 Send SMS Message In the terminal program type the letters AT CMGF 1 Followed by the Enter key and the terminal should respond with OK Substitute the destination phone number for the example 5554443333 Then type AT CMGS 15554443333 Followed by the Enter key and the terminal should respond with gt At this point you can type a custom message keep to less than 160 characters To send the message press the CTRL and Z keys at the same time If successful the terminal should respond with CMGS xx Step 10 Receive SMS Message In the terminal program type the letters AT CMGF 1 Followed by the Enter key and the terminal should respond with OK Then type AT CMGL REC UNREAD Followed by the Enter key If the terminal responds with OK PN 30019 REV 2 NimbeLink Corp All Rights Reserved 11 Then there are no messages Otherwise the terminal responds with the first message in the form CMGL index message status address address text time stamp address type body length CR lt LF gt sms message body CR LF CMGL This is an example CMGL 0 REC UNREAD 555444333 20130925202238 SMS message 2 7 Establishing a TCP IP connection Please refer to the Skywire TCP Socket Examples available here 2 8 Skywire GPS GLONASS and m2mLocate Examples Please refer to
7. d your choice of NimbeLink Skywire plug in cellular modems will provide the cellular connectivity you need Cellular connectivity is just one of the capabilities Nimbelink s Beaglebone Black Cape offers including e Built in CAN transceivers for equipment and vehicle data connections e Built in socket for XBee modules for wireless communications e Nimbelink s EVDO and LTE Skywire modems provide GPS with a high speed cellular connection e Skywire s Verizon ODI certification eliminates the long wait for certification e Two additional USB A receptacles add flexibility e Nimbelink s optional bundled no contract cellular plans are easy and affordable PN 30019 REV 2 NimbeLink Corp Rights Reserved 3 1 3 Orderable Parts Table 1 1 Orderable Parts Number Description Manufacturer Carrier Network Type NL AB BBBC Skywire Beagle Bone Black Cape Nimbelink Skywire 1xRTT Cellular Modem Nimbelink Verizon NL SW 1XRTT V without data plan 2G Modem CDMA 1xRTT TG 30 8113 Primary amp Diversity Cellular Antenna Taoglas Skywire EVDO Cellular Modem Nimbelink Verizon NL SW EVDO V without Data plan 3G Modem CDMA EVDO 3G Primary Antenna GPS GLONASS Taoglas MA 301 A AB 001 Antenna for Skywire EVDO Antenna is a dual cellular amp GPS antenna 1 4 Additional Resources Nimbelink s Skywire Beaglebone Black Cape Product Page Nimbelink s Skywire Beaglebone Black Cape Device Tree Overlay Nimbelink s Skywire Beaglebone Black
8. nt UART to communicate with the Skywire or CANO they will need to unload the device tree overlay and reload the corresponding device tree overlays to use the I O s they desire PN 30019 REV 2 NimbeLink Corp All Rights Reserved 5 2 2 Mounting Your Cape The cape is designed to mount on top of the Beaglebone Black or another cape To mount the cape on the Beaglebone Black orient the notch on the left side cape with the Ethernet connector as shown below in figures 3 2 and 3 3 Carefully align the pins and press the cape down onto the Beaglebone s P8 and P9 connectors Figure 2 2 Removing a cape can be difficult Gently rock the cape back and forth to remove Attempting to remove the cape in one swift motion may damage the P8 and P9 pins PN 30019 REV 2 NimbeLink Corp Rights Reserved 6 2 3 Skywire Placement The Skywire Cellular modem is designed to be placed as shown below in figure 3 1 3 2 E 2 z Figure 2 3 To mount your Skywire Cellular modem follow these steps 1 Gatherthe following a Skywire Beaglebone Black Cape b Skywire Cellular Modem c U FL extractor tool Always use a U FL extractor tool when placing or removing U FL cables on the Skywire modem to avoid damaging the U FL connectors 2 Line up your Skywire s cellular U FL connector s with the circles inside the capes Skywire sockets footprint Depending on the type of Skywire Modem you have you migh
9. onnection UART4 The Skywire Cellular Modems have a default UART baud rate of 115200 Initiate the UART connection on the Beaglebone Black using picocom by issuing the following command picocom b 115200 dev ttyO4 PN 30019 REV 2 NimbeLink Corp Rights Reserved 9 Step 5 Test Serial Communication In the terminal program type the letters AT Followed by the enter key The terminal should respond with OK Step 6 Test Network Connectivity In the terminal program type the letters AT CREG Followed by the Enter key The terminal should respond with CREG 0 1 or CREG 0 5 For all other responses review network status responses online Step 7 Activate Modem NimbeLink provides reduced rate Verizon M2M data plans for Skywire products To activate a data plan send an email to S ireActivations NimbeLink com with your name a phone number to contact you and a list of all MEIDs you would like to activate A NimbeLink staff member will call you to activate the modules real time Skywire Cellular modems do not come with an active cellular plan Step 8 Send Modem Activation String In the terminal program type the letters ATD 22899 Followed by the Enter key and the module with begin the activation process This can take several minutes The terminal should respond with OK OTASP 0 OTASP 1 OTASP 2 NO CARRIER For all other responses review network status responses online PN 30019 REV 2
10. s now communicating to the internet via the Skywire Cellular modem Try pinging a website for example Ping google com To bring down the PPP connection issue the following command poff verizon PN 30019 REV 2 NimbeLink Corp Rights Reserved 15
11. t have one or two U FL connections 3 To avoid damage to the U FL connector an U FL removal tool should be used when attaching removing the U FL connector If your Skywire is using GPS attach the GPS antenna cable ANT1 to the bottom of the Skywire If you are not using your Skywire s GPS or if your Skywire does not support GPS continue to step 4 4 Carefully seat your Skywire into the capes Skywire socket J6 Take care to ensure that the pins are correctly aligned Failure to properly align the pins may damage your Skywire 5 Attach ANT3s U FL cable to the top U FL connector on the Skywire If you are using a Skywire with the cellular diversity antenna option attach ANT2s U FL cable to the bottom U FL connector PN 30019 REV 2 NimbeLink Corp Rights Reserved 7 2 4 UART Configuration By default the capes UART connection between the Skywire and the Beaglebone Black defaults to To begin using the cape no additional configuration is needed at the MUX s to enable the UART communication The Skywire defaults to an 115200 BAUD rate 0 bit data no parity and 1 stop bit The clear to send CTS and ready to send RTS signals are not implemented 2 5 Device Tree Overlay The capes device tree overlay is installed by default in the Debian 3 8 13 bone68 kernel The Debian kernel can be updated by issuing the following commands on your Beaglebone cd opt scripts tools git pull sudo
12. the Skywire GPS GLONASS and m2mLocate Examples available here 2 9 Point to Point Protocol PPP cellular internet via Skywire USB Connection Example The Skywire has a hardwired USB connection to the capes USB hub To interface with the Skywire via USB simply connect the capes upstream USB port to the Beaglebone s downstream USB port the USB A receptacle on the Beaglebone and the Skywire will be visible to the Beaglebone Current Linux distributions have USB devices drivers for the Skywire 3G CMDA EVDO modem Users using other modems via USB will need to add USB device descriptors to their Linux build This demonstration uses a Beaglebone Black running Debian 3 8 13 bone68 Skywire Beaglebone Black Cape Rev D Skywire 3G EVDO modem and a Taoglas TG 30 8113 Cellular antenna For the Skywire 3G EVDO modem we will use the USB interface to the modem which provides the greatest bandwidth and more reliable connection The USB connection eliminates issues concerning flow control often encountered with traditional UART connections and PPP protocol PN 30019 REV 2 NimbeLink Corp All Rights Reserved 12 We will connect the Skywire to the Beaglebone Black configure the PPP link and bring up a connection between the Beaglebone Black and the internet entirely over the cellular connection This example assumes the cape and Skywire have already been mounted to your Beaglebone Black Step one Install the PPP Install the PPP package
13. update kernel sh The device tree is also available for download from Nimbelink s S Beaglebone Black Cape Github Older Debian kernels that cannot be updated will need to add the capes information to the capemgr to make the capes device tree automatically load This can be done by adding CAPE NL AB BBBC 00D0 to etc default capemgr 2 6 Sending a Text Message The following is a demonstration on how to send a text message using the Skywire Beaglebone Black Cape This demonstration assumes the user has knowledge of how to connect to the Beaglebone Black and has a Beaglebone Black running Deiban 3 8 13 bone68 You will need the following for this demonstration e Nimbelink s Skywire Beaglebone Black Cape e Beagle Bone Black C e Terra Term or a terminal emulator of your choice on the user computer e Picocom or a terminal emulator of your choice installed on the Beaglebone Black e Skywire Cellular Modem with antenna This demonstration uses a 3G CDMA EVDO modem Part NL SW EVDO V 2 5A 5V Power Supply for the Beaglebone Black PN 30019 REV 2 NimbeLink Corp Rights Reserved 8 Step 1 Mount your cape on the Beaglebone Black Align your cape so the P9 P8 headers are lined up and the square cutout is aligned with the Beaglebone Blacks Ethernet port Then gently push the P9 P8 headers together take care to ensure that the pins are properly aligned and that you are not bending any pins Step 2 Connect your
14. with the following contents dev ttyUSB3 115200 connect usr sbin chat v f etc ppp peers verizon chat noauth defaultroute usepeerdns local debug updetach Although a serial port speed of 115200 is called out the actual serial speed on the USB connection is ignored and the interface runs as fast as the modem and the host is capable Next create etc ppp peers verizon chat with the following contents ATDT 777 CONNECT NOTE The Verizon chat file starts and ends with two apostrophes not quotations This completes configuration of the PPP daemon PN 30019 REV 2 NimbeLink Corp Rights Reserved 14 You are now ready to bring up the PPP link but may wish to bring down your Ethernet link first as you may encounter routing problems with two interfaces active simultaneously Step Four Activate the PPP link To bring up the PPP link issue the command pon verizon Confirm the link is active by issuing the following command ifconfig pppO This command should respond with the following root beaglebone ifconfig pppO Linkencap Point to Point Protocol inet addr 10 88 240 7 P t P 66 174 177 132 Mask 255 255 255 255 UP POINTOPOINT RUNNING NOARP MULTICAST MTU 1500 Metric 1 RX packets 12 errors 0 dropped 0 overruns 0 frame 0 TX packets 14 errors 0 dropped 0 overruns 0 carrier 0 collisions 0 txqueuelen 3 RX bytes 1342 1 3 KiB TX bytes 771 771 0 B The Beaglebone Black i
Download Pdf Manuals
Related Search