background image

USING LINUX WITH EV3 DEVICES

60

MultiConnect

®

PCIe MTPCIE-EV3 Developer Guide

Test Program()

The following simple C program is useful to test the modem issuing an AT command. The program opens the
/dev/ttyUSB0 interface and calls the write() and the read() function to send an AT command and receive the
subsequent output.

#include <stdio.h> /* Standard input/output definitions */
#include <string.h> /* String function definitions */
#include <unistd.h> /* UNIX standard function definitions */
#include <fcntl.h> /* File control definitions */
#include <errno.h> /* Error number definitions */
#include <termios.h> /* POSIX terminal control definitions */
#define USB "/dev/ttyUSB0"
#define BUFSIZE 1000
#define BAUDRATE B115200
int open_port(char *port)
{
struct termios options;
int fd;
fd = open(port, O_RDWR | O_NOCTTY | O_NDELAY);
if (fd == -1)
{
printf("open_port: Unable to open the port - ");
}
else
{
printf ( "Port %s with file descriptor=%i",port, fd);
fcntl(fd, F_SETFL, FNDELAY);
tcgetattr( fd, &options );
cfsetispeed( &options, BAUDRATE );
cfsetospeed( &options, BAUDRATE );
options.c_cflag |= ( CLOCAL | CREAD);
options.c_cflag &= ~(CSIZE | PARENB | CSTOPB | CSIZE);
options.c_cflag |= CS8;
options.c_cflag &= ~CRTSCTS;
options.c_lflag &= ~(ICANON | ECHO | ECHOE | ISIG);
options.c_iflag &= ~(IXON | IXOFF | IXANY | ICRNL | INLCR |
IGNCR);
options.c_oflag &= ~OPOST;
if ( tcsetattr( fd, TCSANOW, &options ) == -1 )
printf ("Error with tcsetattr = %s\n", strerror ( errno )
);
else
printf ( "%s\n", "succeed" );
}
return (fd);
}
int main()
{
int serialFD = open_port(USB);
char buf[BUFSIZE];

Summary of Contents for MultiConnect MTPCIE-EV3

Page 1: ...MultiConnect PCIe MTPCIE EV3 Developer Guide ...

Page 2: ...A PRODUCT OVER A CELLULAR COMMUNICATIONS NETWORK WILL BE UNINTERRUPTED TIMELY SECURE OR ERROR FREE NOR DOES MULTITECH WARRANT ANY CONNECTION OR ACCESSIBILITY TO ANY CELLULAR COMMUNICATIONS NETWORK MULTITECH WILL HAVE NO LIABILITY FOR ANY LOSSES DAMAGES OBLIGATIONS PENALTIES DEFICIENCIES LIABILITIES COSTS OR EXPENSES INCLUDING WITHOUT LIMITATION REASONABLE ATTORNEYS FEES RELATED TO TEMPORARY INABIL...

Page 3: ... Board 14 Chapter 5 Assembly Diagram 16 Top 16 Bottom 17 Chapter 6 Developer Board Block Diagram 18 Chapter 7 Developer Board Schematics 19 Chapter 8 Board Components 28 Chapter 9 Installing the Device and Antennas 30 Chapter 10 Attaching Power Supply Blades 31 Power Supply and Blades 31 Attaching the Blades 31 Chapter 11 Safety Notices and Warnings 32 Radio Frequency RF Safety 32 Sécurité relativ...

Page 4: ...ables GPS 41 Antenna System Cellular Devices 41 Notice regarding Compliance with FCC EU and Industry Canada Requirements for RF Exposure 41 EV DO and CDMA Antenna Information 41 Antenna Cable Information 42 GPS Antenna Specifications 42 OEM Integration 43 Chapter 16 Activation and Carrier Specific Information 45 Account Activation for Cellular Devices 45 Notice for Devices that Use Aeris Radios 45...

Page 5: ...CONTENTS MultiConnect PCIe MTPCIE EV3 Developer Guide 5 read 58 write 58 close 59 Test Program 60 Index 62 ...

Page 6: ...umber S000569 EV DO and CDMA AT Commands Reference Guide Configure the MTPCIE EV3 with EV DO AT Commands part number S000546 Product Build Options Product Description MTPCIE EV3 N2 EV DO Rev A Embedded Cellular Modem with GPS DE910 DUAL Sprint MTPCIE EV3 N16 EV DO Rev A Embedded Cellular Modem with GPS DE910 DUAL Aeris Developer Kit MTPCIE DK1 Developer Kit Note These units ship without network ac...

Page 7: ... USB cable 2 SMA to UFL antenna cables 1 for cellular 1 for GPS 1 RSMA to UFL antenna cable for Bluetooth Wi Fi Note For MTPCIE EV3 models your final product design needs to have approved Exceltek antenna For details refer to Antennas Cables and GPS Also note that the Bluetooth WiFi antenna is included in the Developer Kit for use other models MTPCIE EV3 does not include Bluetooth WiFi Antennas 1 ...

Page 8: ... O Unused 2 3 3Vaux I 3 3Vaux 3 SDIO_D1 I O Unused 4 GND Ground 5 SDIO_D2 I O Unused 6 BT_TXD I Unused 7 SDIO_D3 I O Unused 8 BT_RTS I Unused 9 GND Ground 10 BT_CTS O Unused 11 SDIO_CMD I O Unused 12 BT_RXD O Unused 13 SDIO_CLK I Unused 14 BT_EN I Unused 15 GND Ground 16 GPIO_2 I O Unused 17 WLAN_EN I Unused 18 GND Ground 19 WLAN_IRQ O Unused 20 3G_ONOFF I 3G Cellular On Off low active 21 GND Grou...

Page 9: ...I_TX O Unused 34 GND Ground 35 GND Ground 36 USB_D I O 3G USB Negative Data 37 GND Ground 38 USB_D I O 3G USB Positive Data 39 3 3Vaux I 3 3Vaux 40 GND Ground 41 3 3Vaux I 3 3Vaux 42 LED_WWAN O 3G Cellular STAT LED Output 43 GND Ground 44 DCD O Unused 45 CTS O Unused 46 GPIO_3 I O Unused 47 RTS I Unused 48 DTR I Unused 49 RXD O Unused 50 GND Ground 51 TXD I Unused 52 3 3Vaux I 3 3Vaux ...

Page 10: ... UIM_DATA 11 REFCLK I PCI Express reference clock 12 UIM_CLK I UIM_CLK 13 REFCLK I PCI Express reference clock 14 UIM_RESET I UIM_RESET 15 GND GND 16 UIM_VPP 0 UIM_VPP 17 Reserved Reserved 18 GND GND 19 Reserved Reserved 20 W_DISABLE I W_DISABLE 21 GND GND 22 PERST I PERST 23 PERn0 O PCI Express receiver differential pair signal 24 3 3Vaux I 3 3Vaux 25 PERp0 O PCI Express receiver differential pai...

Page 11: ...al 34 GND GND 35 GND GND 36 USB_D I O USB Negative Data 37 GND GND 38 USB_D I O USB Positive Data 39 3 3Vaux I 3 3Vaux 40 GND GND 41 3 3Vaux I 3 3Vaux 42 LED_WWAN O LED Output 43 GND GND 44 LED_WLAN O LED Output 45 Reserved Reserved 46 LED_WPAN O LED Output 47 Reserved Reserved 48 1 5V I 1 5V 49 Reserved Reserved 50 GND GND 51 Reserved Reserved 52 3 3Vaux I 3 3Vaux ...

Page 12: ...at must be met for use in specific environments Proper PC board layout component placement signal routing trace thickness and geometry and so on component selection composition value and tolerance interface connections and shielding are required for the board design to achieve desired modem performance and to attain EMI certification Other aspects of proper noise suppression engineering practices ...

Page 13: ... ANSI ESD S20 20 1999 a document for the Development of an Electrostatic Discharge Control for Protection of Electrical and Electronic Parts Assemblies and Equipment This document covers ESD Control Program Administrative Requirements ESD Training ESD Control Program Plan Technical Requirements grounding bonding systems personnel grooming protected areas packaging marking equipment and handling an...

Page 14: ...DEVELOPER BOARD 14 MultiConnect PCIe MTPCIE EV3 Developer Guide Chapter 4 Developer Board This developer board drawing shows the major board components ...

Page 15: ...DEVELOPER BOARD MultiConnect PCIe MTPCIE EV3 Developer Guide 15 ...

Page 16: ...ASSEMBLY DIAGRAM 16 MultiConnect PCIe MTPCIE EV3 Developer Guide Chapter 5 Assembly Diagram Top ...

Page 17: ...ASSEMBLY DIAGRAM MultiConnect PCIe MTPCIE EV3 Developer Guide 17 Bottom ...

Page 18: ...DEVELOPER BOARD BLOCK DIAGRAM 18 MultiConnect PCIe MTPCIE EV3 Developer Guide Chapter 6 Developer Board Block Diagram ...

Page 19: ...DEVELOPER BOARD SCHEMATICS MultiConnect PCIe MTPCIE EV3 Developer Guide 19 Chapter 7 Developer Board Schematics ...

Page 20: ...DEVELOPER BOARD SCHEMATICS 20 MultiConnect PCIe MTPCIE EV3 Developer Guide ...

Page 21: ...DEVELOPER BOARD SCHEMATICS MultiConnect PCIe MTPCIE EV3 Developer Guide 21 ...

Page 22: ...DEVELOPER BOARD SCHEMATICS 22 MultiConnect PCIe MTPCIE EV3 Developer Guide ...

Page 23: ...DEVELOPER BOARD SCHEMATICS MultiConnect PCIe MTPCIE EV3 Developer Guide 23 ...

Page 24: ...DEVELOPER BOARD SCHEMATICS 24 MultiConnect PCIe MTPCIE EV3 Developer Guide ...

Page 25: ...DEVELOPER BOARD SCHEMATICS MultiConnect PCIe MTPCIE EV3 Developer Guide 25 ...

Page 26: ...DEVELOPER BOARD SCHEMATICS 26 MultiConnect PCIe MTPCIE EV3 Developer Guide ...

Page 27: ...DEVELOPER BOARD SCHEMATICS MultiConnect PCIe MTPCIE EV3 Developer Guide 27 ...

Page 28: ... device Pins 2 3 jumpered select quad UART U20 connected to PCIe device All jumpers must be moved to the same position JP65 JP66 JP67 JP68 Selects serial connection for PCIe Bluetooth device Pins 1 2 jumpered select DB9 connector J14 connected to PCIe Bluetooth device Pins 2 3 jumpered select quad UART U20 connected to PCIe Bluetooth device All jumpers must be moved to the same position JP70 Probe...

Page 29: ... installed JP89 This jumper when installed connects power to PCIe device JP90 Not used by PCIe device This jumper when installed connects power to OCG E device When using Developer Kit with OCG E devices J6 Not used by PCIe device J23 Socket for installing PCIe device J8 J9 J10 J13 Oscilloscope probe ground connections S1 Not used by PCIe device S3 Reset button for PCIe device S4 Button for on off...

Page 30: ...as To install a device on the board 1 With the radio side down slide the device into the J23 connector 2 Press down until the device snaps into the X3 connector clips 3 Optional Snap cables onto the device s antenna connectors and attach the antennas to the cables Refer to the device s mechanical drawing for connector details ...

Page 31: ...ply with EU blade Power Supply with NAM blade Power Supply with UK blade Power Supply with AU NZ blade Attaching the Blades To attach a power supply blade 1 Remove the power supply cover not shown To do this slide the lock down and hold it while you lift off the cover 2 Insert the latch on the blade into the notch on the power supply 3 Slide the lock down and hold it while you press the blade in p...

Page 32: ...uipment may be in use Sécurité relative aux appareils à radiofréquence RF À cause du risque d interférences de radiofréquence RF il est important de respecter toutes les réglementations spéciales relatives aux équipements radio Suivez les conseils de sécurité ci dessous Utiliser l appareil à proximité d autres équipements électroniques peut causer des interférences si les équipements ne sont pas b...

Page 33: ...e or hazardous environments unless the model is specifically approved for such use The device may cause sparks Sparks in explosive areas could cause explosion or fire and may result in property damage severe injury and or death Do not expose your device to any extreme environment where the temperature or humidity is high Such exposure could result in damage to the device or fire Do not expose the ...

Page 34: ...and the body of users Qualification for distances closer than 20 cm portable operation would require re certification Wireless devices could generate radiation Other nearby electronic devices like microwave ovens may also generate additional radiation to the user causing a higher level of RF exposure ...

Page 35: ...kings and content This device complies with part 15 of the FCC Rules Operation is subject to the following two conditions 1 This device may not cause harmful interference and 2 this device must accept any interference received including interference that may cause undesired operation The label shown is larger than actual size 1 Multi Tech Model Identification 2 Multi Tech Ordering Part Number 3 ME...

Page 36: ... the receiver is connected Consult the dealer or an experienced radio TV technician for help Industry Canada Class B Notice This Class B digital apparatus meets all requirements of the Canadian Interference Causing Equipment Regulations Cet appareil numérique de la classe B respecte toutes les exigences du Reglement Canadien sur le matériel brouilleur This device complies with Industry Canada lice...

Page 37: ...roduct or on its packaging which indicates that this product must not be disposed of with other waste Instead it is the user s responsibility to dispose of their waste equipment by handing it over to a designated collection point for the recycling of waste electrical and electronic equipment The separate collection and recycling of your waste equipment at the time of disposal will help to conserve...

Page 38: ...rominated Diphenyl Ether PBDE 1000 PPM Environmental considerations Moisture Sensitivity Level MSL 1 Maximum Soldering temperature 260C in SMT reflow oven 1 Lead usage in some components is exempted by the following RoHS annex therefore higher lead concentration would be found in some modules 1000 PPM Resistors containing lead in a glass or ceramic matrix compound ...

Page 39: ...nated Biphenyl PBB Polybrominat ed Diphenyl Ether PBDE Printed Circuit Boards O O O O O O Resistors X O O O O O Capacitors X O O O O O Ferrite Beads O O O O O O Relays Opticals O O O O O O ICs O O O O O O Diodes Transistors O O O O O O Oscillators and Crystals X O O O O O Regulator O O O O O O Voltage Sensor O O O O O O Transformer O O O O O O Speaker O O O O O O Connectors O O O O O O LEDs O O O ...

Page 40: ...信息 有 有害 害 有 有毒 毒物 物质 质 元 元素 素 成 成分 分名 名称 称 铅 铅 PB 汞 汞 Hg 镉 镉 CD 六 六价 价铬 铬 CR6 多 多溴 溴联 联苯 苯 PBB 多 多溴 溴二 二苯 苯醚 醚 PBDE 印刷电路板 O O O O O O 电阻器 X O O O O O 电容器 X O O O O O 铁氧体磁环 O O O O O O 继电器 光学部件 O O O O O O ICs O O O O O O 二极管 晶体管 O O O O O O 振荡器和晶振 X O O O O O 调节器 O O O O O O 电压传感器 O O O O O O 变压器 O O O O O O 扬声器 O O O O O O 连接器 O O O O O O LEDs O O O O O O 螺丝 螺母以及其它五金件 X O O O O O 交流 直流电源 O O O O ...

Page 41: ...used consult user documentation for required antenna specifications Compliance of the device with the FCC EU and IC rules regarding RF Exposure was established and is given with the maximum antenna gain as specified above for a minimum distance of 20 cm between the devices radiating structures the antenna and the body of users Qualification for distances closer than 20 cm portable operation would ...

Page 42: ...on Coax SMA to UFL 8 5inch 216mm Multi Tech Part Number 45009575L Multi Tech ordering information Model Quantity CASMA UFL 1 1 CASMA UFL 10 10 CASMA UFL 50 50 Average Cable Loss The table shows the average cable loss for each cell band Band Loss 800 0 37 1900 0 63 GPS Antenna Specifications Manufacturer Trimble Description GPS Antenna with low noise amplifier Model Number 66800 52 Multi Tech Part ...

Page 43: ... does not produce heating effects causes no known adverse health effects Many studies of low level RF exposures have not found any biological effects Some studies have suggested that some biological effects might occur but such findings have not been confirmed by additional research has been tested and found to comply with FCC radiation exposure limits set forth for an uncontrolled environment and...

Page 44: ...e responsibility of the Grantee Note Host design configurations constituting a device for portable use 20 cm from human body require separate FCC IC approval Note Host devices incorporating unlicensed radio transmitters must be provided with the related antenna fixed mounted or if coming with an external antenna connector this connector must be of a non standard type In any case must an antenna be...

Page 45: ...es that Use Aeris Radios One component of your device is a radio A radio algorithm prevents your device from repeatedly attempting to connect to the network when the radio Cannot establish a packet data connection or Fails to access the application server When writing applications for your devices ensure that your applications do not interfere with the radio s connection retry algorithm If you fai...

Page 46: ...MECHANICAL DRAWING MTPCIE EV3 XX 46 MultiConnect PCIe MTPCIE EV3 Developer Guide Chapter 17 Mechanical Drawing MTPCIE EV3 xx ...

Page 47: ...wnlink 1 8 Mbps uplink Interface USB Interface USB 2 0 high speed compatible UART Interface 0 1 8V Physical Description Weight 0 4 oz 10 g Dimensions Refer to Mechanical Drawing for Dimensions Note With the form factor dimensions exceed the standard MiniPCIe maximum component height for top and bottom Connectors Antenna Connector 1 surface mount UFL connector for cellular 1 surface mount UFL conne...

Page 48: ...SMS GPS Standalone GPS gpsOne and gpsOneXTRA concurrent with GLONASS Acquisition Sensitivity 145 dBm Navigation Sensitivity 160 dBm Tracking Sensitivity 161 dBm TTF from cold start 32 s NMEA data Certifications and Compliance EMC Compliance FCC Part 15 Class B Radio Compliance FCC Part 22 FCC Part 24 RSS 132 RSS 133 Safety Compliance UL 60950 1 cUL 60950 1 ...

Page 49: ..._D0 1 8V SDIO can operate up to 25Mhz The SDIO traces to Host must be treated like a bus and the bus length shall be as short as possible Recommend adding series termination resistors on all the SDIO traces No Function 2 3 3Vaux I 3 3Vaux 3 SDIO_D1 I O Wi Fi SDIO_D1 1 8V No Function 4 GND Ground 5 SDIO_D2 I O Wi Fi SDIO_D2 1 8V No Function 6 BT_TXD I Bluetooth Transmit data 1 8V No Function 7 SDIO...

Page 50: ...O Wi Fi interrupt low active 1 8V Low active No Function 20 3G_ONOFF I 3G Cellular On Off low active 1 8V Minimum pulse is 200 μs up to 900 msec This short pulse can cause an unconditional radio shutdown There is no controlled disconnect from the network The radio restarts The radio takes 10 seconds to recover and finish starting Active Low Properly turn off and detach from the carrier network Low...

Page 51: ...ued No connect if not used 23 1 8V O 1 8V output 100mA output current at 1 8V No Function 24 3 3Vaux I 3 3Vaux 25 GPIO_1 I O Bluetooth General purpose I O 1 8V No connect No Function 26 GND Ground 27 GND Ground 28 3G_DVI_WA0 I O 3G Cellular digital voice control line 1 8V 29 GND Ground 30 3G_DVI_CLK I O 3G Cellular digital voice clock 1 8V 31 3G_DVI_RX I 3G Cellular digital voice receive 1 8V 32 R...

Page 52: ...off Slow blinking Period 3s Ton 0 3s Registered full service Permanently on a voice call is active 43 GND Ground 44 DCD O 3G Cellular UART DCD 1 8V 45 CTS O 3G Cellular UART CTS 1 8V 46 GPIO_3 I O 3G Celllular General purpose I O 1 8V AT GPIO 3 x x 47 RTS I 3G Cellular UART RTS 1 8V Avoid having any HIGH logic level signal applied to any 3G input digital pins when the 3G module is powered off or d...

Page 53: ...nt Amps Total Inrush Charge Measured in Millicoulombs 3 3 Volts US Cellular 0 055 0 792 0 844 2 75 EV DO 0 064 0 8 0 86 2 75 Note Inrush Current The input current during power up or a reset Powering Down Your Device CAUTION Failing to properly power down the device before removing power may corrupt your device s file system To properly power down your device use the following sequence 1 Issue the ...

Page 54: ...SPECIFICATIONS 54 MultiConnect PCIe MTPCIE EV3 Developer Guide Category Description Maximum output power CDMA 1x RTT EV DO 1x Rev 0 Rev A 24 dBm 1 dBm ...

Page 55: ...Example Step 1 Use a text editor to create a peer file containing the lines in the example below dev ttyACM0 may need to be something like dev ttyS0 for a serial build Save the file as etc ppp peers H5 peer Example peer file dev ttyACM0 connect usr sbin chat v f etc chatscripts H5 chat noipdefault usepeerdns defaultroute noauth Step 2 Use a text editor to create a chat script containing the lines ...

Page 56: ... 777 CONNECT Step 3 Use the following command line to start pppd pppd debug call EV3 peer This command line enables logging of debug information and tells pppd to use the peer file referenced by the call option After 20 30 seconds type ifconfig and check whether a ppp interface is listed If it is not then check syslog for pppd and chat events Normally pppd chat logging is written to var log syslog...

Page 57: ...ck syslog for pppd and chat events Normally pppd chat logging is written to var log syslog could vary depending on syslog configuration C Programming The following topics show all the functions that can be used from C source code to perform read write operations on the serial devices open The open function shall establish the connection between a file and a file descriptor The file descriptor is u...

Page 58: ...tination buffer pointer nbyte number of bytes that read attempts to read Returns The number of bytes actually read if the operation is completed successfully otherwise it is 1 Example Read sizeof read_buff bytes from the file associated with fd and stores them into read_buff char read_buff BUFF_LEN if read fd read_buff sizeof read_buff 0 Error Management Routine else Value Read write The write fun...

Page 59: ...with the open file descriptor fd char value_to_be_written dummy_write if write fd value_to_be_written strlen value_to_be_written 0 Error Management Routine else Value Written close The close function shall deallocate the file descriptor indicated by fildes To deallocate means to make the file descriptor available for return by subsequent calls to open or other functions that allocate file descript...

Page 60: ...control definitions define USB dev ttyUSB0 define BUFSIZE 1000 define BAUDRATE B115200 int open_port char port struct termios options int fd fd open port O_RDWR O_NOCTTY O_NDELAY if fd 1 printf open_port Unable to open the port else printf Port s with file descriptor i port fd fcntl fd F_SETFL FNDELAY tcgetattr fd options cfsetispeed options BAUDRATE cfsetospeed options BAUDRATE options c_cflag CL...

Page 61: ...UFSIZE printf The string is s n buf close serialFD return 0 The sleep instruction is required because the modem response after issuing the AT command is not immediate so you need to wait a bit before reading There are more efficient ways to do this for example you can put the read call in a while loop and exit when the read buffer contains a certain string ...

Page 62: ...ogramming close 59 open 57 read 58 test program 60 write 58 D developer board 14 device maintenance 33 drawing 46 E electrical characteristics 49 electromagnetic interference 12 electrostatic discharge 13 EMI 12 ESD 13 EV DO 35 antenna 41 F FCC grant notes 43 FCC Notice Class B 36 G GPS antenna 42 ground plane 12 H handling precautions due to ESD 13 hazardous substances 37 host labeling 43 I Indus...

Page 63: ...suppression 12 P PC board layout 12 pinout 49 pinout table 8 standard 10 power down 53 PTCRB 35 R radio frequency interference 32 RoHS 37 S safety RF interference 32 vehicle 32 safety standards 12 shutdown 53 specifications 47 sécurité interférences RF 32 U USB design consideration 13 user responsibility 33 V vehicle safety 32 ...

Reviews: