The phebe project contains a command shell that performs common tasks on a phone connected to your computer: get usage stats, back-up the phonebook and contacts, as well as download and delete short messages. Communication is done through AT commands as specified by Sony-Ericsson.
The phebe shell needs to be told the device node that represents the phone to the operating system, and the BAUD rate the phone communicates at. These may be given in an ini-style configuration file, either system-wide at /etc/pheberc or in the user's home directory at ~/.pheberc, or as command line options.
Command line options override configuration files, and ~/.pheberc overrides /etc/pheberc. If any of device node and baud rate is not specified in one of the configuration files, it must be given on the command line. No useful default values are provided for these two settings.
Another option is the default national phone number prefix. This allows dealing with numbers that sometimes appear in national format and sometimes in international format, e.g. when looking up short message addresses in the phonebook. This option is not required.
A sample configuration file might look like this:
The corresponding command line options are defined as follows:
--help, -h show this help message and exit
--device=DEVICE, -d DEVICE
the device node
--baud-rate=BAUD_RATE, -b BAUD_RATE
the BAUD rate
--prefix=PREFIX, -p PREFIX
the default national phone number prefix
The information from the above configuration file might be specified in terms of command line options like this:
$ phebe --device=/dev/ttyACM0 --baud-rate=9600 --prefix=49
The following is a short description of what the commands provided by the phebe shell do and what their arguments mean.
Talk to your phone by issuing AT commands at a prompt and receiving the raw textual response from the device.
Prints a summary of how much of your phone's resources are used. This currently includes the used vs total number of entries in each of the phonebooks and SMS storages.
Prints the total number of stored short messages per contact (received plus sent).
Lists all entries from the phonebook storages named as command arguments, in the order they are indexed by the phone. Without arguments, lists the "ME" storage.
Lists entries grouped by contact, per storage. The output format is roughly ini-style.
Lists short messages from the "ME" SMS storage.
Arguments may be either storage indexes or index ranges (such as "14-23") of single messages to list. Without arguments, all messages are listed. If non-existent indexes are given explicitly or included in ranges given, they will be ignored.
Lists short messages from the "ME" SMS storage grouped into conversations with your contacts.
Arguments may be partial names; conversations with any matching contacts are listed. Without arguments, all conversations are listed. If a sender or recipient number cannot be resolved into a contact name using the phonebook, the number itself is used for the grouping.
Deletes short messages from your phone's "ME" SMS storage.
Command arguments are the same as for the messages command. Messages to be deleted will be listed first and deletion is guarded by a safety query.
Deletes short messages belonging to conversations with your contacts from your phone's "ME" SMS storage.
Command arguments are the same as for the conversations command. Messages to be deleted will be listed first and deletion is guarded by a safety query.
The phonebook, contacts, messages and conversations commands send their output to the default pager for convenient browsing. You can redirect the output to a file instead using the > operator known from system shells. To send a phonebook dump to a file instead of paging through it, for example, say:
(Cmd) phonebook > /tmp/phonebook.backup