Documentation  |   Table of Contents   |  < Previous   |  Next >   |  Index

Table of Contents

Palm OS® Programmer's Companion

Volume II Communications


About This Document

Palm OS SDK Documentation

What This Volume Contains

Additional Resources

Conventions Used in This Guide

1 Object Exchange

About the Exchange Manager

Exchange Libraries

Typed Data Objects

Initializing the Exchange Socket Structure

Identifying the Exchange Library

Identifying the Type of Data

Registering for Data

General Registration Guidelines

Setting the Default Application

Registering to Receive Unwrapped Data

Sending Data

Sending a Single Object

Sending Multiple Objects

Implementing the Send Command

Receiving Data

Controlling the Exchange Dialog

Displaying a Preview

Receiving the Data

Sending and Receiving Databases

Sending a Database

Receiving a Database

Requesting Data

Sending a Get Request for a Single Object

Responding to a Get Request

Two-Way Communications

Requesting a URL

Sending and Receiving Locally

Interacting with the Launcher

Summary of Exchange Manager

2 Exchange Libraries

About Exchange Libraries

Exchange Libraries, Exchange Manager, and Applications

Palm OS Exchange Libraries

Exchange Library Components

The Exchange Library API

Dispatch Table

Implementing an Exchange Library

Required Functions

Registering with the Exchange Manager

Summary of Exchange Library

3 Personal Data Interchange

About Personal Data Interchange

About vObjects

Overview of vObject Structure

About the PDI Library

PDI Property and Parameter Types

The PDI Library Properties Dictionary

PDI Readers

PDI Writers

Format Compatibility

International Considerations

Features Not Yet Supported

Using the PDI Library

Accessing the PDI Library

Unloading the PDI Library

Creating a PDI Reader

Reading Properties

Reading Property Values

Creating a PDI Writer

Writing Properties

Writing Property Values

Specifying PDI Versions

Using UDA for Different Media

About the UDA Library

Using a PDI Reader - An Example

Using a PDI Writer - An Example

Summary of Personal Data Interchange

Summary of Unified Data Access Manager

4 Beaming (Infrared Communication)

IR Library

IrDA Stack

Accessing the IR Library

Summary of Beaming

5 Serial Communication

Serial Hardware

Byte Ordering

Serial Communications Architecture Hierarchy

The Serial Manager

Which Serial Manager Version To Use

Steps for Using the Serial Manager

Opening a Port

Closing a Port

Configuring the Port

Sending Data

Receiving Data

Serial Manager Tips and Tricks

Writing a Virtual Device Driver

The Connection Manager

The Serial Link Protocol

SLP Packet Structures

Transmitting an SLP Packet

Receiving an SLP Packet

The Serial Link Manager

Using the Serial Link Manager

Summary of Serial Communications

6 Bluetooth

Palm OS Bluetooth System

Bluetooth System Components

Implementation Overview


Usage Scenarios

Authentication and Encryption

Device Discovery

Piconet Support

Radio Power Management

Developing Bluetooth-Enabled Applications

Overview of the Bluetooth Library



Bluetooth Virtual Serial Driver

Opening the Serial Port

Palm-to-Palm Communication

How PalmOS Uses the Bluetooth Virtual Serial Driver

Bluetooth Exchange Library Support

Detecting the Bluetooth Exchange Library

Using the Exchange Manager With Bluetooth

ExgGet and ExgRequest

7 Network Communication

Net Library

About the Net Library

Net Library Usage Steps

Obtaining the Net Library's Reference Number

Setting Up Berkeley Socket API

Setup and Configuration Calls

Opening the Net Library

Closing the Net Library

Version Checking

Network I/O and Utility Calls

Berkeley Sockets API Functions

Extending the Network Login Script Support

Socket Notices

Internet Library

System Requirements

Initialization and Setup

Accessing Web Pages

Asynchronous Operation

Using the Low Level Calls

Cache Overview

Internet Library Network Configurations

Summary of Network Communication

8 Secure Sockets Layer (SSL)

SSL Library Architecture


Always-Used Attributes

Debugging and Informational Attributes

Advanced Protocol Attributes

Sample Code

9 Internet and Messaging Applications

Internet Access on Palm Powered Handhelds

Overview of Web Clipping Architecture

About Web Clipping Applications

Using the Viewer to Display Information

Sending Email Messages

Registering an Email Application

Sending Mail from the Viewer

Launching the Email Application for Editing

Adding an Email to the Outbox

Using Wireless Capabilities in Your Applications

System Version Checking

Wireless keyDownEvent Key Codes

Including Over-the-Air Characters

10 Telephony Manager

Telephony Service Types

Using the Telephony API

Accessing the Telephony Manager Library

Closing the Telephony Manager Library

Testing the Telephony Environment

Using Synchronous and Asynchronous Calls

Registering for Notifications

Using Data Structures With Variably-sized Fields

Summary of Telephony Manager