Angry Kitchen Appliances: Phone Software Repository; README for phone

README


phone

Version 1.2

2000-08-01, Göran Larsson, http:/www.mitt-eget.com


What is it
----------

Phone is a program that can transfer phone book entries and melodies
between a Ericsson SH888, R320s, R310 phone and your computer. It
will probably work with T28s/T28sc/T28world/T28z and R380 as well.

Warranty
--------

THIS PROGRAM IS PROVIDED AS IS.
NO WARRANTY OF ANY KIND IS INCLUDED.
DON'T BLAME ME IF YOU BLOW UP YOUR PHONE.

License
-------

This software is distributed under the following terms:

* You may not sell the software.

* You may not port the software to any software environment
  originating from Microsoft or SCO.

Installation
------------

* The program ``tip'' is used to establish the communication link
  over the RS-232 port. The baudrate and port name must be
  configured before tip can be used.
  Configure tip by adding a line to the file /etc/remote that
  looks like the line below, but replace /dev/cum01 with the
  name of the serial port used to connect the SH888/R320s/R310.

	phone:dv=/dev/cum01:br#9600:pa=none:nt

* Connect the SH888/R320s/R310 through the RS-232 cable (provided with
  the SH888 or accessory DRS-10 for the R320s/R310) to the port you
  selected in /etc/remote.

  Note that the serial drivers in the SH888/R320s/R310 + RS-232 cable
  is not very strong and long cables are problematic. A 10 meter
  cable resulted in broken communications.

* Test the connection using tip.

	$ tip phone		<-- type this
	connected
	at+cbc			<-- type this
	+CBC: 0,99

	OK
	~.			<-- type this
	[EOT]
	$ 

* The program ``expect'' is used to control the dialogue
  between SH888/R320s/R310 and the phone script. Unless you have
  expect already installed you must get it, compile it, and
  install it. Get the expect package from <http://expect.nist.gov>.
  Edit the assignment to EXPECT in the phone script.

* Edit the assignment to AWK in the phone script. The default
  is nawk, but some Unix versions have awk as oawk, and nawk
  as awk and if so, then AWK should have awk as its value.
  Other probably working alternatives are gawk and mawk.

* Edit the assignment to SIM_last in the phone script. The
  default is 100 but should be set to the highest phone book
  index supported by your SIM.

* Edit the assignment to phone_has_modem in the phone script.
  Use "YES" for SH888 and R320s and "NO" for R310".

* Install the script in your path.


Use
---
	phone [-e] [-v] read phone [ start ] [ end ] >file
	phone [-e] [-v] read sim [ start ] [ end ] >file
	phone [-e] [-v] write phone <file
	phone [-e] [-v] write sim <file
	phone [-e] [-v] status phone
	phone [-e] [-v] status sim
	phone [-e] [-v] status network
	phone [-e] [-v] status networks
	phone [-e] [-v] read melody [ N ]
	phone [-e] [-v] play melody [ N ]
	phone [-e] [-v] write melody [ N ] [ "melody" ]
	phone [-e] [-v] set time [ "yy-mm-dd hh:mm:ss" ]

	Option -e will show the phone communication on error.
	Option -v will show the phone communication.

	start and end are start index and end index for phone book.

	melody is a phone melody using the Ericsson notation.

	SH888:
		p		pause
		#		raise half tone
		b		lower half tone
		+		raise one octave
		c d e f g a h	short tones
		C D E F G A H	long tones

	R320s:
		p		pause
		#		raise half tone
		(b)		lower half tone
		+		raise one octave
		c d e f g a b	short tones
		C D E F G A B	long tones

	N is 1 for SH888 and 1 to 4 for R320s. Default is 1.

Examples
--------

Read the phone book (sh888: ¤-numbers) from the phone:

	$ phone read phone > file	# read all entries
	Please wait...
	$ phone read phone 10 > file	# read from entry 10 and up
	Please wait...
	$ phone read phone 10 39 > file	# read from entry 10 to 39
	Please wait...

Read the phone book from the SIM:

	$ phone read sim > file		# read all entries
	Please wait...
	$ phone read sim 10 > file	# read from entry 10 and up
	Please wait...
	$ phone read sim 10 39 > file	# read from entry 10 to 39
	Please wait...

Write to the phone book (sh888: ¤-numbers) in the phone:

	$ phone write phone < file	# write phone book entries
	Please wait...
	$ echo "5 | 087654321 | Foo" | phone write phone

Write to the phone book in the SIM:

	$ phone write sim < file
	Please wait...
	$ echo "17 | 012345678 | Lorelei" | phone write sim

Erase an entry from the phone book in the phone or SIM:

	$ echo "5" | phone write phone
	$ echo "17" | phone write sim

Retrieve some information about the phone:

	$ phone status phone
	Battery charge: 100%
	Phone made by:  ERICSSON
	Phone model:    1101201-BV R320s
	Phone software: 000512 1617 CXC125235
	Modem made by:  Ericsson
	Modem model:    Ericsson R320 cable modem
	Modem software: 0004201407
	Phone IMEI:     TAC 520070, FAC 51, SNR 999999, CD 0 (520070519999990)
	Phone Book (phone)
	  first index:       1
	  last index:       99
	  limit on number:  80 digits
	  limit on text:    18 characters

Retrieve some information about the SIM:

	$ phone status sim
	SIM IMSI:       MCC 240, MNC 08, HLR 12, sub 99999999 (240081299999999)
	Phone Book (SIM)
	  first index:       1
	  last index:      100
	  limit on number:  80 digits
	  limit on text:    18 characters

Retrieve some information about the network:

	$ phone status network
	Signal strength: -59 dBm

Retrieve some information about networks:

	$ phone status networks
	Please wait...
	Network S EUROPOLITAN (S EURO) (24008) is current
	Network TELIA S (S TELIA) (24001) is forbidden
	Network S COMVIQ (S IQ) (24007) is forbidden

Read the currently programmed Own Melody from the phone:

	$ phone read melody
	"+Cppg#dpgpCppp+Cppg#dpgpCppp#AppagpapDppp"
	$ phone read melody 1
	"+Cppg#dpgpCppp+Cppg#dpgpCppp#AppagpapDppp"

Ask the phone to play the currently programmed Own Melody:

	$ phone play melody
	$ phone play melody 3

Write a new Own Melody to the phone:

	$ phone write melody "+Cppg#dpgpCppp+Cppg#dpgpCppp#AppagpapDppp"
	$ phone write melody 2 "+Cppg#dpgpCppp+Cppg#dpgpCppp#AppagpapDppp"

Set the date and time of the phone:

	$ phone set time "00/08/02,18:10:21"
	 "00/08/02,16:33:34"
	 "00/08/02,18:10:21"
	$ phone set time
	 "00/08/02,18:10:40"
	 "00/08/02,16:33:53"

Formats
-------

The format of the phone book file is:

	# comment
	index | number | text
  example:
	# Europolitan customer care
	10 | +46 708 222222       | Europolitan

Entries in the file will be merged during writing, so an index not
in the file will be unchanged in the phone/SIM. If you wish to delete
an entry, include the index in the file but leave the number and text
empty.

  example:
	12 | |
	13 |
	14

The phone number can be written with embedded spaces and dashes.
Embedded spaces and dashes will be removed before the phone number
is sent to the phone.

Notes
-----

Writing to SIM is slow, so don't be alarmed if it takes a while
to write the phone book list.

Asking about network status is also slow.
Links

Home | Software Repository | Software repository with programs for Ericsson GSM phones | Contact me