readme

IRDA 1.0 标准协议源代码

***** IRDialer Application *****

Copyright (C) 2002-2003 Gerd Rausch, BlauLogic (http://blaulogic.com)
All rights reserved.

The IRDialer application is distributed under the license described in
the attached COPYRIGHT file.

The IRDialer application allows you to build a device that can dial the
telephone for you by accepting dialing requests from a PDA or any other
IrDA enabled device.

A simple circut diagram "circuit.ps", which was generated by the
"xcircuit" application is included in this distribution.
This circuit diagram illustrates one possible hardware interface for
the AT90S8515 MCU, using a Microchip MCP2120 for the IrDA signal coding,
and a Vishay TFDS4500 IrDA transceiver.

IRDialer accepts 3 different message formats:

* A simple "@dial" text message sent via IrOBEX, like the one generated
  by the freely available IRDial application for Palm OS compatible
  PDAs.
  You can find the IRDial application at http://blaulogic.com/irdial.shtml.

* A VCard compatible message sent via IrOBEX.
  If the VCard contains multiple phone numbers, the one marked as preferred
  is dialed.

* A Hayes-Modem compatible "AT" dialing command sent via IrCOMM,
  emulating the IrDA interface most mobile phone vendors have implemented.
  This option is only available for AVR chips with at least 16k-bytes of
  flash memory.

IRDialer features dialing rules that are stored in the EEPROM of the device.
These rules allow the device to shorten the dialing sequence for local
or long distance calls by cutting off the long distance or international prefix.
The also allow for the call-by-call carriers to be programmed, so the
user automatically selects the cheapest carrier depending on the number dialed.
The dialing rules are protected by an access code.
Dialing rules are simply beamed into the IRDialer device.
You can use the IRDial application to program a simple set of rules.

Here is a description of the dialing rules format:

* The file name has to end with ".txt".
* The first line of the text message sent must be "@rules".
* A line with the first non-whitespace character of "#"
  defines the access code.
  The access code is a number between "0" and "65534".
  The first time an access code is used, the access code is programmed
  into the EEPROM.
  If an access code has been used, each "@rules" message is checked
  against the access code, and if it does not match, the EEPROM
  rules are not updated.
* A line starting with "/" introduces a replacement rule
  The matching part of the replacement rule comes first, followed
  by another "/" followed by the part the match should be replaced
  with, followed by another "/".
  At the end of the rule, flags can be set or cleared.
  Flags "0" through "7" are available.
  You can set a flag with a "+" and clear it with a "-", followed
  by the flag number.
* Optionally each replacement rules starting with "/" can be prefixed by
  a number of flags that must match.
  A "+" with a number denotes a flag that must be set,
  a "-" with a number describes a flag that must be cleared for the
  following replacement rule that take place.
* A replacement rule starting with "/" can also be prefixed by a digit
  count. A "=" followed by a number describes the number of digits the
  phone number to be dialed must have in order for the following
  replacement rule to take place.
  Only characters between "0" and "9", the character "*" and "#" are
  counted.

Dialing rules example for the USA, for someone who lives in area code "415".
Each comment line starts with a "!" explaining the line above.
Do not include comment lines in the message being sent.
The device does handle them, but stops parsing instead.
----------------------------------------------------------------------
@rules

#12345
! The access code to this device is "12345".

/+/011/
! Replace a dialing number starting with "+" by
! the international dialing prefix for the USA, which is "011"

/=/1/
! If the area code is enclosed in parenthesis "(" ... ")",
! it is replaced by IRDialer with a "=" character
! Since most people do not include the long distance
! dialing prefix in parenthesis in the USA, we add it here

/1016868//
! Strip off the call-by-call number if it is already included
! in the dialing string

/0111/1/
! Remove international dialing sequence to the USA, since we already
! are in the USA

=10//1/
! If the number is 10 digits long, the user must have forgotten
! to include the longdistance dialing prefix.
! We simply prepend it here

/1415//
! If a long distance call ends up in our area, which is "415"
! we can simply strip if off

/1800/1800/+0
/1888/1888/+0
/1877/1877/+0
/1866/1866/+0
/1855/1855/+0
! We set flag "0" for well-known toll-free numbers to be used later

-0/1/10168681/
! If this is not a toll-free call, but still is a long-distance call
! we choose "1016868" as our long distance carrier

/011/1016868011/
! If this is an international call, we choose "1016868" as our carrier
----------------------------------------------------------------------