STA5-SmartLink-command-guidance.md

@@ -5,7 +5,7 @@
 - [APIs](#apis)
 - [SmartLink data format](#smartlink-data-format)
 - [SmartLink data base structure](#smartlink-data-base-structure)
-- [Command](#command)
+- [Common Command](#common-command)
   - [Subscribe](#subscribe)
   - [On Top Notification](#on-top-notification)
   - [On Top Notification for Android Auto](#on-top-notification-for-android-auto)
@@ -13,11 +13,14 @@
   - [Get Down](#get-down)
   - [Get WiFi status](#get-wifi-status)
   - [Return WiFi status](#return-wifi-status)
+- [Device Manager Command](#device-manager-command)
   - [Get device information](#get-device-information)
   - [Return device information](#return-device-information)
   - [Device Phone Link ON](#device-phone-link-on)
   - [Device Phone Link OFF](#device-phone-link-off)
   - [UI Phone Link software button](#ui-phone-link-software-button)
+  - [Get Phone Link connection status](#get-phone-link-connection-status)
+  - [Return Phone Link connection status](#return-phone-link-connection-status)
 - [VIP Socket](#vip-socket)
   - [Android Auto VIP Socket](#android-auto-vip-socket)
   - [CarPlay VIP Socket](#carplay-vip-socket)
@@ -85,7 +88,7 @@ if (ret < 0) {
 | btMacAddress[32]    | char      | 32 bytes    | Bluetooth MAC address. |
 | SupportedAPP        | int       | 4 bytess    | Refer to APP_TYPE.     |
 
-## Command
+## Common Command
 
 ### Subscribe
 - From APPs - Client
@@ -212,6 +215,8 @@ if (ret < 0) {
 | cmd         | E_RETURN_WIFI_STATUS_ON/E_RETURN_WIFI_STATUS_OFF |
 | len         | Total length of message in bytes(288).           |
 
+## Device Manager Command
+
 ### Get device information
 - From APPs - Client
 - To get the device info from SmartLink. Send below message to SmartLink.
@@ -309,6 +314,42 @@ if (ret < 0) {
 
 - From SmartLink: No return message.
 
+### Get Phone Link connection status
+- From APPs - Client
+- To get the Phone Link status from SmartLink. Send below message to SmartLink.
+
+| Data member | Value                                  |
+| ----------- | -------------------------------------- |
+| version     | SML_MAJOR_VERSION                      |
+| mode        | E_DELEGATE                             |
+| AppType     | Refer to type APP_TYPE.                |
+| state       | E_STATE_OK                             |
+| AppClientID | Client ID.                             |
+| srcAppName  | Source application name in string.     |
+| dstAppName  | "SML"                                  |
+| cmd         | E_REQ_GET_PHONE_LINK_STATUS            |
+| len         | Total length of message in bytes(288). |
+
+- From SmartLink: Returned message, refer next section(Return Phone Link connection status).
+
+### Return Phone Link connection status
+- From SmartLink - Server
+- Phone Link connection status returned from SmartLink:
+  - E_RETURN_PHONE_LINK_CONNECTION_ALLOW means Phone Link connection not exist, allow connection.
+  - E_RETURN_PHONE_LINK_CONNECTION_REJECT means Phone Link already exist, reject another connection.
+
+| Data member | Value                                                                      |
+| ----------- | -------------------------------------------------------------------------- |
+| version     | SML_MAJOR_VERSION                                                          |
+| mode        | E_DELEGATE                                                                 |
+| AppType     | Refer to type APP_TYPE.                                                    |
+| state       | E_STATE_OK                                                                 |
+| AppClientID | Client ID.                                                                 |
+| srcAppName  | "SML"                                                                      |
+| dstAppName  | Received Application name                                                  |
+| cmd         | E_RETURN_PHONE_LINK_CONNECTION_ALLOW/E_RETURN_PHONE_LINK_CONNECTION_REJECT |
+| len         | Total length of message in bytes(288).                                     |
+
 ## VIP Socket
 
 ### Android Auto VIP Socket