Bluegiga Technologies WRAP Bedienungsanleitung

Access Server

User’s and Developer’s Guide

Bluegiga Technologies

Access Server: User’s and Developer’s Guide

by Bluegiga Technologies

Published 2007-07-20 (3.2)

Bluegiga Technologies reserves the right to alter the hardware, software, and/or speciﬁcations detailed herein at any time without

notice, and does not make any commitment to update the information contained herein. Bluegiga Technologies assumes no

responsibility for any errors which may appear in this manual. 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. iWRAP, WRAP THOR and WRAP Access Server are trademarks 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.

Table of Contents

1. Introduction to Access Server............................................................................................................1

1.1. Licenses and Warranty ............................................................................................................2

1.2. Bluegiga Technologies Contact Information ........................................................................2

2. Getting Started with Access Server..................................................................................................3

2.1. Powering Up .............................................................................................................................3

2.2. WWW Interface ........................................................................................................................4

2.3. Shell Prompt Access.................................................................................................................6

2.3.1. Management Console .................................................................................................7

2.3.2. Accessing Remotely.....................................................................................................8

2.3.3. Transferring Files to/from Access Server ................................................................8

2.4. Introduction to Conﬁguration................................................................................................9

2.5. Using the Setup WWW Interface...........................................................................................9

2.6. Using the setup Command Line Application ....................................................................17

2.7. Resetting a Conﬁguration .....................................................................................................18

2.8. Exporting and Importing Conﬁgurations...........................................................................18

3. Using the System ...............................................................................................................................19

3.1. Network Interfaces.................................................................................................................19

3.2. Bluetooth .................................................................................................................................19

3.2.1. iWRAP Password Protection ...................................................................................19

3.2.2. LAN Access Proﬁle....................................................................................................20

3.2.3. Serial Port Proﬁle .......................................................................................................20

3.2.4. Object Push and File Transfer Proﬁle......................................................................21

3.2.4.1. Incoming ObjP and FTP ...............................................................................21

3.2.4.2. Outgoing ObjP and FTP...............................................................................22

3.2.5. PAN Proﬁles ...............................................................................................................24

3.2.6. Changing the Bluetooth Range................................................................................24

3.2.7. btcli ..............................................................................................................................25

3.2.8. serialbluetooth............................................................................................................25

3.3. Compact Flash Cards.............................................................................................................25

3.3.1. Compact Flash GPRS Cards.....................................................................................25

3.3.2. Compact Flash GPS Card .........................................................................................26

3.3.3. Compact Flash Wi-Fi Cards......................................................................................26

3.4. USB Memory Dongles and Compact Flash Memory Cards ............................................26

3.5. Servers......................................................................................................................................27

3.5.1. Finder ..........................................................................................................................28

3.5.2. ObexSender ................................................................................................................29

3.5.3. SMS Gateway Server.................................................................................................29

3.5.4. User Level Watchdog ................................................................................................29

3.5.5. Remote Management ................................................................................................30

3.5.5.1. Overview........................................................................................................30

3.5.5.2. Management Packet Format........................................................................30

3.5.5.3. Management Packet Information File Format..........................................31

3.5.5.4. Management Operation Example: Hello World.......................................31

3.5.5.5. Management Operation Example: Software Update...............................32

3.5.5.6. Management Operation Example: IPQUERY ...........................................32

iii

3.5.5.7. Management Operation Example: Beep....................................................33

3.5.5.8. Management with USB Memory Dongle or Compact Flash Memory

Card ....................................................................................................................33

3.5.5.9. Listing and Uninstalling Software Component........................................33

3.5.6. FTP ...............................................................................................................................33

3.5.7. Web Server..................................................................................................................33

3.5.8. SNMP ..........................................................................................................................33

3.5.9. OpenVPN....................................................................................................................34

3.5.10. SSH.............................................................................................................................34

3.5.11. Telnet .........................................................................................................................34

3.5.12. NTP............................................................................................................................34

3.6. Utilities.....................................................................................................................................34

3.7. Real Time Clock......................................................................................................................39

3.8. Time Zone................................................................................................................................39

3.9. System Re-Install and Upgrade............................................................................................39

4. SPP-over-IP .........................................................................................................................................41

4.1. How SPP-over-IP Works .......................................................................................................41

4.1.1. Standard Operation...................................................................................................41

4.1.2. Repeater Operation ...................................................................................................42

4.1.3. SPP-over-IP over GPRS.............................................................................................42

4.1.4. Opening Connections from Access Server.............................................................43

4.1.5. SPP-over-IP and COM Ports ....................................................................................44

4.2. Conﬁguring SPP-over-IP.......................................................................................................44

4.2.1. Forwarding Incoming Connections ........................................................................45

4.2.2. Maintaining and Forwarding Outgoing Connections..........................................45

4.2.3. Repeater Conﬁguration ............................................................................................45

4.2.4. Wi-Fi Conﬁguration ..................................................................................................46

4.2.5. GPRS Conﬁguration..................................................................................................46

5. Obexsender .........................................................................................................................................47

5.1. Key Features............................................................................................................................47

5.2. Use Cases.................................................................................................................................47

5.2.1. Content Push ..............................................................................................................48

5.2.2. Content Pull................................................................................................................48

5.3. Conﬁguration..........................................................................................................................49

5.3.1. Uploading Files..........................................................................................................49

5.3.2. Conﬁguring Content Rules ......................................................................................50

5.3.3. How to Store Files Sent to Access Server ...............................................................50

5.4. Monitoring ObexSender........................................................................................................50

5.5. Bluetooth Device Database ...................................................................................................50

6. Software Development Kit ..............................................................................................................51

6.1. Introduction to SDK...............................................................................................................51

6.2. Installing SDK.........................................................................................................................51

6.2.1. Access Server Software Development Kit System Requirements ......................51

6.2.2. Questions Asked by the Install Script.....................................................................52

6.3. Creating Applications............................................................................................................52

6.3.1. Application Examples...............................................................................................52

6.3.1.1. Installing Examples.......................................................................................52

6.3.1.2. Running Examples........................................................................................53

6.3.2. Creating a New Project .............................................................................................54

6.3.3. Building from the Command Line..........................................................................54

6.3.4. Transferring an Application to Access Server .......................................................55

6.3.4.1. Transferring an Application Using SCP or SFTP......................................55

6.3.4.2. Using SSHFS ..................................................................................................55

6.3.4.3. Transferring an Application Using Terminal Software ...........................55

6.3.4.4. Using NFS Mount .........................................................................................56

6.3.4.5. Using CIFS Mount ........................................................................................56

6.3.5. Running an Application Transferred to Access Server ........................................56

6.3.6. Using GNU Project Debugger (GDB) .....................................................................57

6.3.7. Native SDK .................................................................................................................57

7. iWRAP - The Bluetooth API............................................................................................................59

7.1. Terms........................................................................................................................................59

7.2. Starting iWRAP ......................................................................................................................59

7.3. Writing iWRAP Applications ...............................................................................................59

7.3.1. Forklistener.................................................................................................................60

7.3.2. iWRAP Client .............................................................................................................60

7.4. btcli - iWRAP Command Line Interface Utility.................................................................60

7.5. iWRAP Commands................................................................................................................61

INFO ......................................................................................................................................61

QUIT ......................................................................................................................................62

SET .........................................................................................................................................63

SAVE ......................................................................................................................................73

LOAD ....................................................................................................................................74

PING......................................................................................................................................75

PONG ....................................................................................................................................76

ECHO ....................................................................................................................................77

LOCK.....................................................................................................................................78

UNLOCK ..............................................................................................................................79

SHUTDOWN........................................................................................................................80

SLEEP ....................................................................................................................................81

LOG .......................................................................................................................................82

7.6. Finding Bluetooth Devices....................................................................................................84

INQUIRY...............................................................................................................................84

NAME ...................................................................................................................................85

7.7. Bluetooth Connections ..........................................................................................................86

CALL .....................................................................................................................................86

CONNECT............................................................................................................................88

NO CARRIER.......................................................................................................................90

RING......................................................................................................................................91

RINGING..............................................................................................................................92

CLOSE ...................................................................................................................................93

LIST........................................................................................................................................94

RSSI........................................................................................................................................96

TXPOWER ............................................................................................................................97

BER.........................................................................................................................................98

CLOCK..................................................................................................................................99

STATUS ...............................................................................................................................100

7.8. Service Discovery .................................................................................................................101

SDPSEARCH......................................................................................................................101

SDPATTR ............................................................................................................................103

SDPQUERY.........................................................................................................................105

SDP bdaddr ........................................................................................................................106

SDP ADD ............................................................................................................................107

SDP DEL..............................................................................................................................108

SDP LIST .............................................................................................................................109

7.9. Example Sessions .................................................................................................................110

7.10. Error Codes .........................................................................................................................110

8. I/O API ...............................................................................................................................................114

8.1. Led and Buzzer API.............................................................................................................114

8.2. GPIO API...............................................................................................................................114

9. Finder Protocol .................................................................................................................................115

9.1. Finder Search Message ........................................................................................................115

9.2. Finder Reply Message .........................................................................................................115

10. Advanced Use Cases for Access Server .....................................................................................116

10.1. Making Access Server Secure...........................................................................................116

10.2. Saving Bluetooth Pairing Information Permanently.....................................................116

10.3. Digital Pen...........................................................................................................................116

10.4. OpenVPN ............................................................................................................................117

10.4.1. Prerequisites ...........................................................................................................117

10.4.2. Installing OpenVPN..............................................................................................117

10.4.3. Creating Certiﬁcates and Keys ............................................................................118

10.4.4. Creating Conﬁguration Files................................................................................120

10.4.4.1. Server Conﬁguration File.........................................................................120

10.4.4.2. Client Conﬁguration File .........................................................................122

10.4.5. Starting up VPN.....................................................................................................124

10.4.5.1. Starting up the Server...............................................................................124

10.4.5.2. Starting up the Client ...............................................................................125

11. Certiﬁcation Information and WEEE Compliance ..................................................................126

A. Directory Structure.........................................................................................................................129

B. Setup Options ..................................................................................................................................131

B.1. Security settings ...................................................................................................................131

B.2. Generic settings....................................................................................................................133

B.3. Network settings..................................................................................................................135

B.3.1. Default interface settings .......................................................................................136

B.3.2. Ethernet cable settings............................................................................................137

B.3.3. Wi-Fi settings ...........................................................................................................137

B.3.4. GPRS settings...........................................................................................................138

B.4. Applications..........................................................................................................................139

B.4.1. FTP server settings..................................................................................................140

B.4.2. ObexSender settings ...............................................................................................141

B.4.2.1. Timeouts and delays ..................................................................................143

B.4.2.2. Logging ........................................................................................................144

B.4.2.3. Delete log (conﬁrm)....................................................................................145

B.4.3. Connector settings...................................................................................................146

B.4.4. wpkgd settings ........................................................................................................147

B.4.5. SMS gateway settings .............................................................................................148

B.5. iWRAP settings ....................................................................................................................149

B.5.1. Bluetooth proﬁles ....................................................................................................152

B.5.1.1. LAN access proﬁle settings .......................................................................152

B.5.1.2. PAN user proﬁle settings...........................................................................153

B.5.1.3. PAN generic networking proﬁle settings................................................154

B.5.1.4. PAN network access point proﬁle settings .............................................155

B.5.1.5. Connection forwarding..............................................................................155

B.5.1.6. Serial port proﬁle settings .........................................................................155

B.5.1.7. Object push proﬁle settings.......................................................................157

B.5.1.8. File transfer proﬁle settings.......................................................................157

B.6. Advanced settings ...............................................................................................................158

B.6.1. Bluetooth commands..............................................................................................159

B.6.2. System information.................................................................................................159

B.6.3. Reboot system (conﬁrm) ........................................................................................160

B.7. Summary of Setup Options................................................................................................160

C. Open Source Software Licenses...................................................................................................166

D. Supported Hardware .....................................................................................................................171

vii

List of Tables

2-1. The Management Console Port Settings ........................................................................................7

3-1. Access Server Network Interfaces.................................................................................................19

3-2. obexserver’s metas ..........................................................................................................................21

3-3. Parameters for obexsender-put .....................................................................................................22

3-4. Errorlevels from obexsender-put ..................................................................................................23

3-5. Parameters for obexsender-inquiry ..............................................................................................24

3-6. Errorlevels from obexsender-inquiry ...........................................................................................24

3-7. Access Server Servers......................................................................................................................27

3-8. Access Server Utilities.....................................................................................................................34

6-1. Examples, Their Usage and Purpose............................................................................................53

7-1. Supported Parameters for iWRAP SET Command....................................................................63

7-1. SAVE parameters.............................................................................................................................73

7-1. Log bitmask descriptions ...............................................................................................................82

7-2. Log target options............................................................................................................................82

7-5. Supported Keywords for Replacing SDP UUIDs or Attributes..............................................101

7-1. SDP Response Formatting Characters........................................................................................103

7-7. iWRAP Errors.................................................................................................................................110

7-8. Errors Masks...................................................................................................................................111

7-9. HCI Error Codes ............................................................................................................................111

7-10. L2CAP Error Codes.....................................................................................................................112

7-11. SDP Error Codes..........................................................................................................................113

7-12. RFCOMM Error Codes ...............................................................................................................113

9-1. Finder Tuple Format......................................................................................................................115

9-2. Finder Tuple IDs ............................................................................................................................115

11-1. Excerpt of Table 1B of 47 CFR 1.1310........................................................................................127

C-1. Open Source Licenses in Access Server Software Components ............................................166

C-2. Access Server Open Source Software Components and Their Licences...............................166

D-1. Supported Hardware by Access Server ....................................................................................171

viii

Chapter 1. Introduction to Access Server

Bluegiga’s WRAP™ product family offers for device manufacturers, integrators, companies and

developers a simple and fast way to set-up wireless communication systems between standard

or proprietary devices, networks, machines and instruments.

Access Server is a cutting edge wireless Bluetooth router. It supports multiple communication

standards including Ethernet, WiFi, and GSM/GPRS enabling full media-independent TCP/IP

connectivity. Access Server is easy to deploy and manage in existing wired and wireless net-

works without compromising speed or security. For rapid deployment, Access Server conﬁg-

urations can easily be copied from one device to another by using USB memory dongles. The

device can be fully managed and upgraded remotely over SSH secured links. Large numbers of

Access Servers can easily be controlled using Bluegiga Solution Manager (BSM), a web-based

remote management and monitoring platform.

Access Server usage scenarios and applications:

•Point-of-sales systems

•Logistics and transportation systems

•Telemetry and machine-to-machine systems

•Medical and healthcare systems

•Fitness and sport telemetry systems

•Cable replacement

•Content and application distribution to mobile phones and PDAs

Access Server key features:

•Enables Bluetooth networking between multiple devices and networks

•Serves up to 21 simultaneous Bluetooth connections

•Offers an open platform for adding local applications

•Acts as a transparent router or bridge

•Supports all key communication medias:

•Bluetooth

•Ethernet

•WiFi, GSM and GPRS with a Compact Flash card

•USB and RS232

•Incorporates a packet ﬁltering ﬁrewall

•Is fast and easy to install

•Supports all relevant Bluetooth proﬁles and APIs

•100 meter range / Software conﬁgurable to support 10 meter range

•DHCP support for plug-and-play installation

•Uncompromised security: SSH, ﬁrewall, and 128 bit Bluetooth encryption

Chapter 1. Introduction to Access Server

•Simple and secure mounting accessory available

•Bluetooth, CE, and FCC certiﬁed

•Compliant with Bluetooth 1.1, 1.2 and 2.0 Speciﬁcation

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. It is also available on-line

at http://bluegiga.com/as/current/doc/eula.pdf. 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, equip-

ment, and media.

Some software components are licensed under the terms and conditions of an open source li-

cense. Details can be found in Appendix C. Upon request, Bluegiga will distribute a complete

machine-readable copy of the source of the aforementioned open source software components

during a period of three (3) years from the release date of the software. Delivery costs of the

source code will be charged from the party requesting the source code.

The Bluegiga WRAP Product Limited Warranty Statement is available on-line at

http://bluegiga.com/as/current/doc/warranty.pdf.

1.2. 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://bluegiga.com/as/ 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:

•Access Server product type

•Access Server product serial number

•Access Server software version

•End customer name

•Date of purchase

Andere Handbücher für WRAP

Inhaltsverzeichnis

Andere Bluegiga Technologies Server Handbücher

Bluegiga Technologies

Bluegiga Technologies WRAP Bedienungsanleitung

Beliebte Server Handbücher anderer Marken

HP AlphaServer ES47 Bedienungsanleitung

Dell

Dell PowerEdge R410 Bedienungsanleitung

PowerNAS

PowerNAS CMA Bedienungsanleitung

Supero

Supero FatTwin F617R3-FT Bedienungsanleitung

MSI

MSI P1-109N-L70 Bedienungsanleitung

Dell

Dell PowerEdge XE9640 Handbuch

Dell

Dell PS4100 Montageanleitung

EtroVISION

EtroVISION EV3151 Bedienungsanleitung

NEC

NEC Express5800/T110j Bedienungsanleitung

HP ProLiant Gen9 Bedienungsanleitung

Compaq

Compaq ProLiant 3000 Handbuch

Dell

Dell PowerEdge 3YPMN Bedienungsanleitung

iRobo

iRobo IPC2U Bedienungsanleitung

Nortel

Nortel 1000 Con?guration guide Bedienungsanleitung

Asus

Asus AP7500 Bedienungs- und Wartungshandbuch

Avid Technology

Avid Technology AirSpeed 5000 Bedienungsanleitung

HP Integrity rx2600 Installationsanleitung

Milestone

Milestone Husky IVO 350T Bedienungsanleitung