binding: bluetooth-map: add message composition support

Add message composition suppport for sending SMS/MMS messages in
bMessage format.

Bug-AGL: SPEC-2351
Change-Id: I5709c6619f44863e949ae61363f7d5fe54adcbfc
Signed-off-by: Matt Ranostay <matt.ranostay@konsulko.com>

1 files changed, 38 insertions, 2 deletions

diff --git a/README.md b/README.md
index c382e18..f84bccc 100644
--- a/README.md
+++ b/README.md
@@ -5,10 +5,16 @@
 Bluetooth MAP (Message Access Profile) service uses the respective profile support from BlueZ
 to enable message notifications from SMS/email/etc.
 
+### Important Notes
+
+Message composition isn't available on iOS devices due to respective security polices, and in
+turn isn't supported in Apple's implementation of the (MAP) Message Access Profile.
+
 ## Verbs
 
 | Name              | Description                              | JSON Response                             |
 |-------------------|------------------------------------------|-------------------------------------------|
+| compose           | send message                             | see **compose verb** section              |
 | subscribe         | subscribe to MAP service events          | *Request:* {"value": "notification"}      |
 | unsubscribe       | unsubscribe to MAP service events        | *Request:* {"value": "notification"}      |
 
@@ -19,6 +25,36 @@ to enable message notifications from SMS/email/etc.
 | notification      | report notification message              | see **notification event** section        |
 
 
+### compose verb
+
+Send a message (if supported) via MAP profile:
+
+<pre>
+{
+  "bmessage":
+    "BEGIN:BMSG\r\n
+     VERSION:1.0\r\n
+     TYPE:SMS_GSM\r\n
+     FOLDER:telecom/msg/outbox\r\n
+     BEGIN:BENV\r\n
+     BEGIN:VCARD\r\n
+     VERSION:2.1\r\n
+     TEL:+13605551212\r\n
+     END:VCARD\r\n
+     BEGIN:BBODY\r\n
+     CHARSET:UTF-8\r\n
+     LANGUAGE:UNKNOWN\r\n
+     LENGTH:48\r\n
+     BEGIN:MSG\r\n
+     Sounds good. See you then.\r\n
+     END:MSG\r\n
+     END:BBODY\r\n
+     END:BENV\r\n
+     END:BMSG\r\n
+    "
+}
+</pre>
+
 ### notification event
 
 <pre>
@@ -34,7 +70,7 @@ to enable message notifications from SMS/email/etc.
      VERSION:2.1\r\n
      FN;CHARSET=UTF-8:Satoshi Nakamoto\r\n
      N;CHARSET=UTF-8:Satoshi\r\n
-     TEL:\r\n
+     TEL:+13605551212\r\n
      END:VCARD\r\n
      BEGIN:BENV\r\n
      BEGIN:BBODY\r\n
@@ -42,7 +78,7 @@ to enable message notifications from SMS/email/etc.
      LANGUAGE:UNKNOWN\r\n
      LENGTH:46\r\n
      BEGIN:MSG\r\n
-     Meet at Victor 23 at 6p?
+     Meet at Victor 23 at 6p?\r\n
      END:MSG\r\n
      END:BBODY\r\n
      END:BENV\r\n