From 3b5353c23cccaaa1a428e807a8f06b34748bf17c Mon Sep 17 00:00:00 2001
From: Jonas Smedegaard <dr@jones.dk>
Date: Mon, 8 Aug 2016 18:51:40 +0200
Subject: Initial draft.

---
 TODO   | 16 ++++++++++++++++
 USE.md | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 84 insertions(+)
 create mode 100644 TODO
 create mode 100644 USE.md

diff --git a/TODO b/TODO
new file mode 100644
index 0000000..f75547c
--- /dev/null
+++ b/TODO
@@ -0,0 +1,16 @@
+  * Recommend Linphone on Android
+    (CSipSimple is old and unmaintained, does not support Opus or video,
+    and is rumored to hang and drain battery -
+    maybe esp. when switching between wifi and cellular).
+    * Linphone fails with TLS: Try with Letsencrypt instead of CAcert.org.
+    * Setup snippet (when it works):
+
+ 1. Install linphone from f-droid.
+ 2. Select "Use sip account"
+    * Enter username, password, "bitbase.dk", your full name (as display name).
+    * Leave "Transport" set to the default "TLS".
+    * Click "Login"
+ 3. Select "Settings" from main menu.
+    * Select "Network" submenu.
+    * Select "Media Encryption" and choose ZRTP.
+ 4. Optionally: Select "advanced" and "start at boot".
diff --git a/USE.md b/USE.md
new file mode 100644
index 0000000..a14af70
--- /dev/null
+++ b/USE.md
@@ -0,0 +1,68 @@
+# Voice over IP setup
+
+Your account supports making phone calls over the Internet -
+a.k.a. VoIP.
+
+## Account and sub-accounts
+
+Your "phone number" or VoIP address -
+what others use to call you -
+is the same as your email address.
+
+You can have multiple "phones" -
+places to make and receive calls -
+and each has their own sub-account.
+
+Example:
+
+  * Name: Jonas Smedegaard
+  * VoIP address: sip:jonas@bitbase.dk
+  * Phone account 1: jonas-cellphone
+  * Phone account 2: jonas-laptop
+  * Phone account 3: jonas-dect
+
+
+## Setup of a sub-account
+
+Some applications ask for the full address,
+some for username and domain separately.
+
+
+### CSipSimple on Android
+
+ 1. Install csipsimple from f-droid.
+ 2. Select "Use sip account"
+    * Enter username, password, "bitbase.dk", your full name (as display name).
+    * Leave "Transport" set to the default "TLS".
+    * Click "Login"
+ 3. Select "Settings" from main menu.
+    * Select "Network" submenu.
+    * Select "Media Encryption" and choose ZRTP.
+ 4. Optionally: Select "advanced" and "start at boot".
+
+
+## Making a call
+
+When your VoIP application is active,
+and registration with our server succeeds
+(see [setup]),
+you can initiate phone calls.
+
+### Test services
+
+Here are some test services you can try call:
+
+  * echo (or 9876): Repeats what you say, after a brief delay
+  * time: speaks the current time at the phone server
+  * helloworld: speaks "Hello World"
+  * recordsample: records what you say...
+  * playbacksample: plays back the most recently recorded sample
+
+
+## Receiving a call
+
+To receive calls,
+your VoIP application is active and registered continuously.
+
+Beware esp. on mobile devices
+that having VoIP active drains more battery.
-- 
cgit v1.2.3