Bluegiga Technologies WRAP Mode d’emploi

WRAP MULTIRADIO ACCESS SERVER

User’s and Developer’s Guide

Version 2.0.3

Monday, November 08, 2004

Bluegiga Technologies assumes no responsibility for any errors which may appear in this

manual. Furthermore, Bluegiga Technologies reserves the right to alter the hardware, software,

and/or specifications detailed herein at any time without notice, and does not make any

commitment to update the information contained herein. Bluegiga Technologies’ products are

not authorized for use as critical components in life support devices or systems.

The WRAP is a registered trademark of Bluegiga Technologies.

The Bluetooth trademark is owned by the Bluetooth SIG Inc., USA, and is licensed to Bluegiga

Technologies.

ARM and ARM9 are trademarks of ARM Ltd.

Linux is a trademark of Linus Torvalds.

All other trademarks listed herein belong to their respective owners.

2004-11-08

USER'S AND DEVELOPER'S GUIDE WRAP MULTIRADIO ACCESS SERVER

CONTENTS

1Introduction ....................................................................................................... 6

1.1 Licenses and Warranty ......................................................................................6

1.2 Certification Information ....................................................................................6

1.3 Bluegiga Technologies Contact Information ..........................................................9

2Controlling the Access Server ........................................................................... 10

2.1 Physical Interfaces.......................................................................................... 10

2.2 Shell Prompt Access........................................................................................ 11

2.2.1 Management Console ............................................................................... 11

2.2.2 Accessing Remotely.................................................................................. 12

2.3 Transferring Files to/from the Access Server....................................................... 12

3Configuration.................................................................................................... 14

3.1 Using the Setup Application.............................................................................. 14

3.1.1 Network Configuration .............................................................................. 14

3.1.2 Bluetooth Settings.................................................................................... 15

3.1.2.1 General Bluetooth Settings ................................................................. 15

3.1.2.2 LAN Access Profile Settings ................................................................. 16

3.1.2.3 Serial Port Profile Settings .................................................................. 16

3.1.2.4 OBEX Settings .................................................................................. 18

3.1.2.5 Personal Area Network Profile Settings ................................................. 19

3.1.3 Ramdisk Settings ..................................................................................... 19

3.1.4 System Logger Settings ............................................................................ 20

3.1.5 Web Server Settings................................................................................. 20

3.1.6 Install Point Settings ................................................................................ 20

3.1.7 SMS Gateway Settings.............................................................................. 20

3.2 /etc/rc.d/rc.local............................................................................................. 20

3.3 Resetting Configuration ................................................................................... 21

3.4 Advanced Configuration................................................................................... 21

4Using the System.............................................................................................. 22

4.1 Bluetooth ...................................................................................................... 22

4.1.1 Bluetooth Server Socket Interface Password Protection ................................. 22

4.1.2 LAN Access Profile.................................................................................... 22

4.1.3 Serial Port Profile ..................................................................................... 22

4.1.4 Object Push and File Transfer Profile ........................................................... 23

4.1.5 PAN Profile .............................................................................................. 24

4.1.6 Bluetooth Range Changing ........................................................................ 24

4.1.7 BTCLI - Bluetooth Server Command Line Interface Utility............................... 24

4.1.8 Serialbluetooth ........................................................................................ 24

4.2 Compact Flash GPRS Card................................................................................ 25

4.2.1 SIM Card’s PIN code ................................................................................. 25

4.2.2 GPRS Troubleshooting .............................................................................. 25

4.2.3 Console Message "serial_cs: ParseTuple: Bad CIS tuple"................................ 25

4.3 Compact Flash WLAN ...................................................................................... 26

4.3.1 Hostap Driver .......................................................................................... 26

4.3.2 Hermes Driver ......................................................................................... 26

4.3.3 General Configuration............................................................................... 27

4.4 Servers ......................................................................................................... 27

4.4.1 Web Server............................................................................................. 28

4.4.2 Install Point............................................................................................. 28

4.4.2.1 Install Point configuration ................................................................... 29

4.4.2.2 Install Point example configuration ...................................................... 29

4.4.3 SMS Gateway Server ................................................................................ 30

4.4.4 User Level Watchdog ................................................................................ 30

4.4.5 Remote Management................................................................................ 30

4.4.5.1 Overview.......................................................................................... 30

4.4.5.2 Management Packet Format ................................................................ 31

4.4.5.3 Management Packet Information File Format ......................................... 32

4.4.5.4 Management System Environment Variables ......................................... 32

USER'S AND DEVELOPER'S GUIDE WRAP MULTIRADIO ACCESS SERVER

4.4.5.5 Management Operation Example: IPQUERY ........................................... 32

4.4.5.6 Management Reply Packet Destination Definition ................................... 33

4.4.5.7 Management With USB Memory Dongle ................................................ 34

4.4.6 FTP ........................................................................................................ 34

4.4.7 SSH ....................................................................................................... 34

4.4.8 Telnet .................................................................................................... 34

4.5 Utilities ......................................................................................................... 34

4.6 Real Time Clock.............................................................................................. 37

4.7 Time Zone ..................................................................................................... 38

4.8 System Re-Install and Upgrade ........................................................................ 38

5Bluetooth Technology Overview ....................................................................... 39

5.1 Frequency Bands and Channel Arrangement ....................................................... 39

5.2 Power Considerations ...................................................................................... 40

5.3 Radio Frequency Propagation ........................................................................... 40

6Introduction to SDK.......................................................................................... 42

7Installing the WRAP Software Development Environment ................................ 43

7.1 WRAP Software Development Environment System Requirements ......................... 43

7.2 Questions Asked by the Install Script................................................................. 43

8Creating WRAP Applications ............................................................................. 45

8.1 Application Examples ...................................................................................... 45

8.1.1 Installing Examples .................................................................................. 45

8.1.2 Running Examples.................................................................................... 45

8.2 Creating a New Project .................................................................................... 47

8.3 Building From the Command Line...................................................................... 47

8.4 Transferring an Application to WRAP Hardware ................................................... 48

8.4.1 Transferring an Application to WRAP Using (S)FTP or SCP .............................. 48

8.4.2 Transferring an Application to WRAP Using Terminal Software ........................ 49

8.4.3 Using NFS mount ..................................................................................... 49

8.5 Running an Application Transferred to WRAP ...................................................... 49

8.6 Using Debugger (GDB/DDD) ............................................................................ 49

9Bluetooth Server Socket Interface.................................................................... 51

9.1 Terms ........................................................................................................... 51

9.2 Starting the Bluetooth Servers.......................................................................... 51

9.3 Basic Commands ............................................................................................ 51

9.3.1 Info ....................................................................................................... 53

9.3.2 Inquiry ................................................................................................... 54

9.3.3 Name ..................................................................................................... 55

9.3.4 Quit ....................................................................................................... 56

9.3.5 Set ........................................................................................................ 57

9.3.6 Ping ....................................................................................................... 63

9.3.7 Pong ...................................................................................................... 64

9.3.8 Shutdown ............................................................................................... 65

9.3.9 Sleep ..................................................................................................... 66

9.4 Connection Commands and Replies ................................................................... 67

9.4.1 Call ........................................................................................................ 67

9.4.2 Connect.................................................................................................. 69

9.4.3 No Carrier............................................................................................... 70

9.4.4 Ring....................................................................................................... 71

9.4.5 Close...................................................................................................... 72

9.4.6 List ........................................................................................................ 73

9.4.7 Status .................................................................................................... 74

9.5 Service Discovery ........................................................................................... 75

9.5.1 SDP bdaddr UUID .................................................................................... 76

9.5.2 SdpSearch .............................................................................................. 77

9.5.3 SdpAttr .................................................................................................. 78

9.5.4 SdpQuery ............................................................................................... 79

9.5.5 Sdp........................................................................................................ 80

9.6 Example Sessions ........................................................................................... 80

9.7 Error Codes ................................................................................................... 81

USER'S AND DEVELOPER'S GUIDE WRAP MULTIRADIO ACCESS SERVER

9.8 WRAP Obex Libraries....................................................................................... 86

9.8.1 libobex ................................................................................................... 86

9.8.2 libobexclient............................................................................................ 87

9.8.3 Obexbrowser........................................................................................... 88

10 I/O API ............................................................................................................ 90

10.1 LED/BUZZER API .......................................................................................... 90

10.2 GPIO API ..................................................................................................... 90

11 About Bluegiga ................................................................................................. 91

Appendix A – WRAP Directory Structure................................................................... 93

USER'S AND DEVELOPER'S GUIDE WRAP MULTIRADIO ACCESS SERVER

1 INTRODUCTION

WRAP™

Bluegiga's WRAP product family offers for device manufacturers, teleoperators, integrators,

enterprises and platform developers a simple and fast way to set-up wireless communication

systems between standard or proprietary mobile devices, networks, machines and

instruments.

WRAP™ Multiradio Access Server

WRAP™ Multiradio Access Server is a cutting edge wireless Bluetooth basestation supporting

WLAN, Ethernet and GSM/GPRS offering TCP/IP connectivity. It can be deployed into existing

wired or wireless networks without uncompromising the speed, security and ease of

installation and management. WRAP Multiradio Access Server is an open platform for creating

and hosting also local applications and content in the Access Server. Bluegiga also provides

several additional software packages for different purposes; embedded device's Bluetooth

networking, mobile phone TCP/IP connectivity and generic application installation for different

mobile handsets.

It has support for multiple Bluetooth radios (model 2291 has one and model 2293 has three

installed) with configurable range up to 100 meters (class 1), USB host and Compact Flash.

The WRAP Multiradio Access Server enables you to connect a variety of equipment directly to

networks. As a software platform, WRAP Multiradio Access Server runs Linux 2.4 in powerful

ARM processor and has free memory for runtime and persistent storage use of the user

applications.

1.1 LICENSES AND WARRANTY

Warning: Bluegiga Technologies is hereby willing to license the enclosed WRAP product and its

documentation under the condition that the terms and conditions described in the License

Agreement are understood and accepted. The License Agreement is supplied within every

WRAP product both in hard copy and soft copy (file \doc\WRAP_eula.pdf on the WRAP CD-

ROM). The use of the WRAP product will indicate your assent to the terms. If you do not agree

to these terms, Bluegiga Technologies will not license the software and documentation to you,

in which event you should return this complete package with all original materials, equipment,

and media.

The following software components: GCC compiler tool chain, Linux kernel, and Linux-userland

applications are licensed under the terms and conditions of the GPL General Public License (file

\doc\GPL.txt on the WRAP CD-ROM). Upon request, Bluegiga will distribute a complete

machine-readable copy of the source of the aforementioned software components during a

period of three (3) years from the order date of the product. Delivery costs of the source code

will be charged from the party requesting the source code.

The Bluegiga WRAP Product Limited Warranty Statement is located in the file

\doc\WRAP_warranty.pdf on the WRAP CD-ROM.

1.2 CERTIFICATION INFORMATION

The product is CE approved and Bluetooth qualified v.1.1. It has been measured against the

following specification standards: Radio spectrum Matters (R&TTE, Article 3.2) ETSI EN 300

328-2 v1.3.1. / EN 301 489-1/17, and FCC part 15.247. Supported Bluetooth profiles are:

GAP, SDAP, LAN client and server, SPP A and B, FTP client and server, ObjP client and server,

PAN-PANU, PAN-GN and PAN-NAP.

USER'S AND DEVELOPER'S GUIDE WRAP MULTIRADIO ACCESS SERVER

Hereby, Bluegiga Technologies declares that this WRAP Multiradio Access Server is in

compliance with the essential requirements and other relevant provisions of Directive

1999/5/EC.

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.

This equipment has been tested and found to comply with the limits for a Class B digital

device, pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable

protection against harmful interference in a residential installation. This equipment generates,

uses, and can radiate radio frequency energy and, if not installed and used in accordance with

the instructions, may cause harmful interference to radio communications. However, there is

no guarantee that interference will not occur in a particular installation. If this equipment does

cause harmful interference to radio or television reception, which can be determined by turning

the equipment off and on, the user is encouraged to try to correct the interference by 1 or

more of the following measures:

• Reorient or relocate the receiving antenna

• Increase the separation between the equipment and receiver

• Connect the equipment into an outlet on a circuit different from that to which the

receiver is connected

• Consult the dealer or an experienced radio or television technician for help

Warning: Changes or modifications made to this equipment not expressly approved by

Bluegiga Technologies Inc. may void the FCC authorization to operate this equipment.

The radiated output power of the WRAP Multiradio Access Server is far below the FCC radio

frequency exposure limits. Nevertheless, the WRAP Multiradio Access Server should be used in

such a manner that the potential for human contact during normal operation is minimized.

To meet the FCC’s exposure rules and regulations:

• The antenna(s) used for this transmitter must be installed to provide a separation

distance of at least 20 cm from all the persons.

• Any transmitter installed in the CF card slot must not exceed 4 W of e.i.r.p. To check if

a particular equipment complies with this restriction you need to know its FCC ID

number and visit the searching engine in FCC web site in the following Internet address,

where you can find the output power by the equipment in the grant of the equipment

https://gullfoss2.fcc.gov/prod/oet/cf/eas/reports/GenericSearch.cfm

If this link does not work properly please visit FCC website (http://www.fcc.gov) and

follow the following steeps to find the searching engine:

FCC website ÆOffice of Engineering Technology ÆEquipment Authorization Electronic

Filing ÆGeneric Search

Please notice that the output power listed in the grant uses different units depending on

the type of the equipment, e.g.:

USER'S AND DEVELOPER'S GUIDE WRAP MULTIRADIO ACCESS SERVER

1. The output power for 802.11a/b/g/h equipment or similar equipment approved

under §15.247 or §15.407 is listed as Conducted RF power. §15.247 or §15.407

limit the e.i.r.p. to 4 W, so this restriction is fulfilled.

2. The output power for Part 22 cellular equipment is listed as e.r.p. The

relationship between e.r.p. and e.i.r.p. is the following one:

e.i.r.p. = 1.64 x e.r.p.

3. The output power for Part 24 PCS equipment is listed as e.i.r.p.

4. For other type of equipment please consult the distributor in order to assure the

restriction is fulfilled.

Note: Definitions:

Effective Radiated Power (e.r.p.) (in a given direction): The product of the power supplied to

the antenna and its gain relative to half-wave dipole in a given direction.

Equivalent Isotropically Radiated Power (e.i.r.p.) (in a given direction): The product of the

power supplied to the antenna and its gain relative to an isotropic antenna.

The table below is excerpted from Table 1B of 47 CFR 1.1310 titled Limits for Maximum

Permissible Exposure (MPE), Limits for General Population/Uncontrolled Exposure:

Frequency Range (MHz) Power Density (mW/cm2)

300 – 1500 f/1500

1500 – 100 000 1.0

The equipment WRAP Multiradio Access Server transmits in the 2400 - 2483.5 MHz frequency

range, so the applicable MPE limit is 1 mW/cm2. The equipment can be provided with up to 4

Bluetooth modules WRAP THOR 2022-1-B2B (FCC ID: QOQWRAP2022-1-B2B):

Under the conditions stated above MPE limits can be guaranteed as the calculation below

shows:

Example 1:

15.247 or 15.407 Compact Flash Card with maximum allowed e.i.r.p. of 4W

Using equation from page 18 of OET Bulletin 65, Edition 97-01:

S = P·G/4πR2= Prad (e.i.r.p.)/4πR2

Where,

S = power density in mW/cm2(1 mW/cm2used for G)

P = power input to the antenna

G = power gain of the antenna in the direction of interest relative to an isotropic radiator

R = distance to the centre of radiation of the antenna in cm (20cm Prediction distance)

S Compact Flash card = Prad (e.i.r.p.) Compact Flash card /4πR2= 4000mW/4π(20cm)2

we obtain the following results:

S Compact Flash card = 0.795774mW/cm2

S Total = 4 x S module + S Compact Flash card = 4 x 0.003579mW/cm2+ 0.795774mW/cm2

USER'S AND DEVELOPER'S GUIDE WRAP MULTIRADIO ACCESS SERVER

S Total = 0.014316mW/cm2+ 0.795774mW/cm2= 0.795774mW/cm2< 1mW/cm2

Example 2:

Part 22 Compact Flash Card with maximum e.r.p. of 1.5 W (Category excluded of MPE

evaluation according to §2.1091)

Using equation from page 18 of OET Bulletin 65, Edition 97-01 and considering that e.i.r.p. =

1.64 x e.r.p.:

S Compact Flash card = Prad (e.i.r.p.) Compact Flash card /4πR2= 1500 x 1.64mW / 4π(20cm)2

S Compact Flash card = 0.489401mW/cm2

S Total = 4 x S module + S Compact Flash card = 4 x 0.003579mW/cm2+ 0.489401mW/cm2

S Total = 0.014316mW/cm2+ 0.489401mW/cm2= 0.503717mW/cm2< 1 mW/cm2

Example 3:

Part 24 Compact Flash Card with maximum e.r.p. of 3 W (Category excluded of MPE

evaluation according to §2.1091)

Using equation from page 18 of OET Bulletin 65, Edition 97-01 and considering that e.i.r.p. =

1.64 x e.r.p.:

S Compact Flash card = Prad (e.i.r.p.) Compact Flash card /4πR2= 3000 x 1.64mW / 4π(20cm)2

S Compact Flash card = 0.978803 mW/cm2

S Total = 4 x S module + S Compact Flash card = 4 x 0.003579mW/cm2+ 0.978803 mW/cm2

S Total = 0.014316mW/cm2+ 0.978803mW/cm2= 0.993119mW/cm2< 1mW/cm2

1.3 BLUEGIGA TECHNOLOGIES CONTACT INFORMATION

Please see http://www.bluegiga.com/ for news and latest product offers. For more information,

contact [email protected].

Please check http://www.bluegiga.com/techforum/ for software and documentation updates.

Please contact [email protected] if you need more technical support. To speed up the

processing of your support request, please include as detailed information on your product and

your problem situation as possible. Please begin your email with the following details:

• WRAP product type

• WRAP product serial number

• WRAP software version

• End customer name

• Date of purchase

USER'S AND DEVELOPER'S GUIDE WRAP MULTIRADIO ACCESS SERVER

2 CONTROLLING THE ACCESS SERVER

There is no graphical user interface for the WRAP Multiradio Access Server. All controlling

operations to the Access Server must be done either by entering commands and using

applications at Access Server shell prompt or by sending and/or retrieving files to/from the

Access Server. There are several ways to access the shell prompt and to transfer files.

2.1 PHYSICAL INTERFACES

The physical interfaces of the Access Server are described in Figure 1 and Figure 2.

Figure 1. WRAP Multiradio Access Server Connectors.

NOTE: The power adapter is the disconnection device, the socket-outlet shall be installed near

the equipment and shall be easy accessible. The power led (see Figure 2) is on when the

power adapter is connected.

Autres manuels pour WRAP

Table des matières

Autres manuels Bluegiga Technologies Serveur

Bluegiga Technologies

Bluegiga Technologies WRAP Mode d’emploi

Manuels Serveur populaires d'autres marques

HP AlphaServer ES47 Manuel utilisateur

Dell

Dell PowerEdge R410 Manuel utilisateur

PowerNAS

PowerNAS CMA Manuel utilisateur

Supero

Supero FatTwin F617R3-FT Manuel utilisateur

MSI

MSI P1-109N-L70 Manuel utilisateur

Dell

Dell PowerEdge XE9640 Manuel

Dell

Dell PS4100 Instructions de montage

EtroVISION

EtroVISION EV3151 Manuel utilisateur

NEC

NEC Express5800/T110j Manuel utilisateur

HP ProLiant Gen9 Manuel utilisateur

Compaq

Compaq ProLiant 3000 Manuel

Dell

Dell PowerEdge 3YPMN Manuel utilisateur

iRobo

iRobo IPC2U Manuel utilisateur

Nortel

Nortel 1000 Con?guration guide Manuel utilisateur

Asus

Asus AP7500 Manuel d'utilisation et d'entretien

Avid Technology

Avid Technology AirSpeed 5000 Manuel utilisateur

HP Integrity rx2600 Guide d'installation

Milestone

Milestone Husky IVO 350T Manuel utilisateur