Access Server

User's and Developer's Guide

Bluegiga Technologies

Table of Contents

1. Introduction to Access Server

1.1. Licenses and Warranty
1.2. Bluegiga Technologies Contact Information

2. Getting Started with Access Server

2.1. Powering Up

2.2. WWW Interface

2.3. Shell Prompt Access

2.3.1. Management Console
2.3.2. Accessing Remotely
2.3.3. Transferring Files to/from Access Server

2.4. Introduction to Configuration

2.5. Using the Setup WWW Interface

2.6. Using the setup Command Line Application

2.7. Resetting a Configuration

2.8. Exporting and Importing Configurations

3. Using the System

3.1. Network Interfaces

3.2. Bluetooth

3.2.1. iWRAP Password Protection
3.2.2. LAN Access Profile
3.2.3. Serial Port Profile
3.2.4. Object Push and File Transfer Profile
3.2.5. PAN Profiles
3.2.6. Changing the Bluetooth Range
3.2.7. BTCLI - iWRAP Command Line Interface Utility
3.2.8. serialbluetooth

3.3. Compact Flash Cards

3.3.1. Compact Flash GPRS Cards
3.3.2. Compact Flash GPS Card
3.3.3. Compact Flash Wi-Fi Cards

3.4. USB Memory Dongles and Compact Flash Memory Cards

3.5. Servers

3.5.1. Finder
3.5.2. ObexSender
3.5.3. SMS Gateway Server
3.5.4. User Level Watchdog
3.5.5. Remote Management
3.5.6. FTP
3.5.7. Web Server
3.5.8. SNMP
3.5.9. OpenVPN
3.5.10. SSH
3.5.11. Telnet
3.5.12. NTP

3.6. Utilities

3.7. Real Time Clock

3.8. Time Zone

3.9. System Re-Install and Upgrade

4. SPP-over-IP

4.1. How SPP-over-IP Works

4.1.1. Standard Operation
4.1.2. Repeater Operation
4.1.3. SPP-over-IP over GPRS
4.1.4. Opening Connections from Access Server
4.1.5. SPP-over-IP and COM Ports

4.2. Configuring SPP-over-IP

4.2.1. Preparations
4.2.2. Preparations
4.2.3. Repeater Configuration
4.2.4. Wi-Fi Configuration
4.2.5. GPRS Configuration

5. Obexsender

5.1. Key Features

5.2. Use Cases

5.2.1. Content Push
5.2.2. Content Pull

5.3. Configuration

5.3.1. Getting Started
5.3.2. Updating Obexsender
5.3.3. Ensuring Obexsender is Enabled
5.3.4. Basic Obexsender Configuration
5.3.5. Uploading Files
5.3.6. Advanced Obexsender Configuration
5.3.7. How to Store Files Sent to Access Server

5.4. Monitoring Obexsender

5.5. Troubleshooting and Known Issues

6. Software Development Kit

6.1. Introduction to SDK

6.2. Installing SDK

6.2.1. Access Server Software Development Environment System Requirements
6.2.2. Questions Asked by the Install Script

6.3. Creating Applications

6.3.1. Application Examples
6.3.2. Creating a New Project
6.3.3. Building from the Command Line
6.3.4. Transferring an Application to Access Server
6.3.5. Running an Application Transferred to Access Server
6.3.6. Using Debugger (GDB/DDD)
6.3.7. Native SDK

7. iWRAP - Bluetooth Interface

7.1. Terms

7.2. Starting the iWRAP Servers

7.3. Writing iWRAP Applications

7.3.1. Forklistener
7.3.2. iWRAP Client

7.4. Commands Controlling iWRAP

INFO -- Get basic info
QUIT -- Close iWRAP connection
SET -- Change parameters
SAVE -- Save iWRAP settings
LOAD -- Run iWRAP command script
PING -- Ask if the connection is alive
PONG -- Connection is alive
ECHO -- Send a message to other iWRAP clients
LOCK -- Lock other iWRAP clients
UNLOCK -- Unlock other iWRAP clients
SHUTDOWN -- Close iWRAP server
SLEEP -- Wait a second

7.5. Finding Bluetooth Devices

INQUIRY -- Search for other devices
NAME -- Find a friendly name

7.6. Making a Bluetooth Connection

CALL -- Connect to other device
CONNECT -- Connected to other device
NO CARRIER -- Disconnected from other device
RING -- Another device is calling you
RINGING -- Call in progress
CLOSE -- Disconnect
LIST -- List connections
STATUS -- Status of a connection

7.7. Service Discovery

SDPSEARCH -- Browse SDP Records
SDPATTR -- Browse SDP Records
SDPQUERY -- Browse SDP Records
SDP bdaddr -- Check devices SDP
SDP ADD -- Add entry to local SDP
SDP DEL -- Delete entry for local SDP
SDP LIST -- List local SDP

7.8. Example Sessions

7.9. Error Codes

8. I/O API

8.1. Led and Buzzer API
8.2. GPIO API

9. Advanced Use Cases for Access Server

9.1. Making Access Server Secure

9.2. Saving Bluetooth Pairing Information Permanently

9.3. Digital Pen

9.4. OpenVPN

9.4.1. Prerequisites
9.4.2. Installing OpenVPN
9.4.3. Creating Certificates and Keys
9.4.4. Creating Configuration Files
9.4.5. Starting up VPN

10. Certification Information and WEEE Compliance

A. Directory Structure

B. Setup Options

B.1. Security settings

B.2. Generic settings

B.3. Network settings

B.3.1. Default interface settings
B.3.2. Ethernet cable settings
B.3.3. Wi-Fi settings
B.3.4. GPRS settings

B.4. Applications

B.4.1. wpkgd settings
B.4.2. FTP server settings
B.4.3. ObexSender settings
B.4.4. SMS gateway settings

B.5. Bluetooth settings

B.5.1. Bluetooth profiles

B.6. Advanced settings

B.6.1. System information
B.6.2. Reboot system (confirm)

B.7. Summary of Setup Options

C. Open Source Software Licenses

D. Supported Hardware