iridium-phonebook

README

iridium-phonebook

This is a tool for managing your Iridium 9555 satellite phone's addressbook over a USB connection to your computer.

The phone exposes Hayes-like AT commands over a serial interface for all sorts of things, including managing the phone's addressbook.

This is known to work on a Mac. It should work on Linux and Windows too.

Installation

To install iridium-phonebook, with Go 1.16 or newer:

go install github.com/joeshaw/iridium-phonebook@latest

With Go 1.15 or older:

go get -u github.com/joeshaw/iridium-phonebook

Usage

USAGE
  iridium-phonebook <subcommand> [flags]

SUBCOMMANDS
  dump   Dump the Iridium phonebook in CSV format to stdout
  load   Load a CSV file info the Iridium phonebook, without replacing existing contacts
  clear  Delete all contacts from the Iridium phonebook

All commands require a -d <device> flag, for example:

iridium-phonebook dump -d /dev/cu.usbmodem1

Note that the load command does not do any kind of de-duplication, so if you dump and load the CSV without running clear you will end up with double contacts.

Known issues

My phone reliably crashes and reboots after loading about 10-20 contacts. Still working on tracking down why.

The phone sends contact information as UCS-2. For decoding UCS-2 is a strict subset of UTF-16, but not for encoding. UCS-2 is a fixed-width encoding, whereas UTF-16 is variable width with surrogate pairs. I am encoding as UTF-16 and things will break if you try to use a Unicode code point that requires a surrogate pair. So don't try to encode emoji or things will break.

License

Copyright 2021 Joe Shaw

iridium-phonebook is licensed under the MIT License. See the LICENSE file for details.