From ad83ee5575a18a5ec9aba4b8ffae22c7f46ad4a5 Mon Sep 17 00:00:00 2001 From: Matt Ranostay Date: Wed, 9 Jan 2019 16:06:47 -0800 Subject: binding: telephony: add initial README.md documentation Bug-AGL: SPEC-2104 Change-Id: If6f6d1b5cdf9a9956bc00170be766582365140fb Signed-off-by: Matt Ranostay --- README.md | 39 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 39 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..f4473c7 --- /dev/null +++ b/README.md @@ -0,0 +1,39 @@ +# Telephony Service + +## Overview + +Telephony service allows respective clients access to the Handsfree Profile via the oFono package + +## Verbs + +| Name | Description | JSON Response | +|---------------------|-------------------------------------------------|---------------------------------------------| +| subscribe | subscribe to telephony events | *Request:* {"value": "callStateChanged"} | +| unsubscribe | unsubscribe to telephony events | *Request:* {"value": "callStateChanged"} | +| dial | dial respective number | *Request:* {"value": "15035551212"} | +| hangup | hangup an active call or reject incoming call | | +| answer | answer incoming call | | + +## Events + +| Name | Description | JSON Event Data | +|---------------------|--------------------------------------|---------------------------------------------| +| callStateChanged | Call status change event | see callStateChanged event | +| dialingCall | Outgoing call events | {"colp": "3305551212"} | +| incomingCall | Incoming call events | {"clip": "3305551212"} | +| terminatedCall | Terminated call event | *empty JSON response* | + +### callStateChanged Event + +This event has one field called *parameter* with one of the following states (see **doc/voicecall-api.txt** in oFono for further reference): + +| Name | Description | +|----------------|-----------------------------------| +| active | Call is active | +| held | Call is on hold | +| dialing | Call is being dialed | +| alerting | Remote party is being alerted | +| incoming | Incoming call in progress | +| waiting | Call is waiting | +| disconnected | Call is disconnected | + -- cgit 1.2.3-korg