Cuttlefish：環境控制

本頁說明如何在 Cuttlefish 裝置上控制環境 讀取及更新 Deployment 資源舉例來說，您可以修改 Wi-Fi 訊號或更新 Cuttlefish 裝置的 GPS 位置。

服務

cvd env 指令提供下列服務，以控制 Cuttlefish 環境：

服務 說明
GnssGrpcProxy 控管 Cuttlefish 地理位置功能的 GNSS。
OpenwrtControlService 控管 Openwrt，這是 Cuttlefish Wi-Fi 功能的虛擬 Wi-Fi AP 供應器。
WmediumdService 控制 Wmediumd，無線中型模擬器 兩個 Cuttlefish Wi-Fi 功能
CasimirControlService 控制 Casimir，這是外部 NFC 裝置的模擬器。

使用 REST API 控制環境

本節說明如何透過 <https://localhost:1443> 服務端點使用 Rest API 控制環境。

列出可用的服務或方法

如要取得所有服務的清單，請傳送 GET 要求至下列網址，並使用 裝置 ID。

https://localhost:1443/devices/DEVICE_ID/services

如要取得服務的所有方法清單，請將 GET 要求傳送至 造訪網址，其中的裝置 ID 和服務名稱。

https://localhost:1443/devices/DEVICE_ID/services/SERVICE_NAME

取得方法的詳細資訊 (例如要求或回應) 訊息類型，請將 GET 要求傳送至包含裝置 ID 的以下網址， 服務名稱和方法名稱

https://localhost:1443/devices/DEVICE_ID/services/SERVICE_NAME/METHOD_NAME

取得要求和回應類型的詳細資訊

如要取得要求或回覆訊息類型的詳細資訊，請傳送 GET 使用裝置 ID、服務名稱及 要求或回覆訊息類型這會列印出每個節點的所有名稱和類型 欄位。接著，您可以使用這些資訊編寫 JSON 格式的 Proto 訊息，以便傳送 RPC 要求。

https://localhost:1443/devices/DEVICE_ID/services/SERVICE_NAME/REQUEST_OR_RESPONSE_TYPE_NAME/type

傳送 RPC 要求以變更環境

如要傳送 RPC 要求，以 JSON 格式的 proto 呼叫服務的方法，請將 POST 要求傳送至下列網址，並附上裝置 ID、服務名稱和方法名稱。JSON 格式的 proto 必須包含在 

https://localhost:1443/devices/DEVICE_ID/services/SERVICE_NAME/METHOD_NAME

用途範例

以下是 Rest API 的用途範例，可透過呼叫 SetTxpower 修改 Wi-Fi 訊號強度。

  1. 決定用於修改 Wi-Fi 訊號強度的服務名稱、方法名稱和要求訊息類型名稱。

    1. 如要取得所有可用服務的清單，請將 GET 要求傳送至下列網址。

      https://localhost:1443/devices/cvd-1/services

      這是回應範例。

      {"services":["OpenwrtControlService","EchoService","GnssGrpcProxy","WmediumdService"]}

    2. 請將 GET 要求傳送至下列網址，取得 WmediumdService 的方法清單。

      https://localhost:1443/devices/cvd-1/services/WmediumdService

      這是回應範例。

      {"methods":["ListStations","LoadConfig","ReloadConfig","SetCivicloc","SetLci","SetPosition","SetSnr","SetTxpower","StartPcap","StopPcap"]}

    3. 將 GET 要求傳送至下列網址，即可取得 SetTxpower 方法的要求和回應訊息類型相關資訊。

      https://localhost:1443/devices/cvd-1/services/WmediumdService/SetTxpower

      以下是回覆範例。

      {"request_type_name":"wmediumdserver.SetTxpowerRequest","response_type_name":"google.protobuf.Empty"}

  2. 將 GET 要求傳送至下列網址，即可取得 wmediumdserver.SetTxpowerRequest 要求訊息類型的詳細資訊。

    https://localhost:1443/devices/cvd-1/services/WmediumdService/wmediumdserver.SetTxpowerRequest/type

    以下是回覆範例。

    message SetTxpowerRequest {
  string mac_address = 1;
  int32 tx_power = 2;
}

  3. 將 RPC 要求傳送至 WmediumdService 服務，藉由傳送 POST 要求至此網址，並附上以下要求主體，將 Wi-Fi 訊號強度修改為所需等級。

    https://localhost:1443/devices/cvd-1/services/WmediumdService/SetTxpower

    {"mac_address":"42:00:00:00:00:00", "tx_power":1}

    這是回應範例。

    {}

使用指令列控管環境

本節說明 cvd env CLI 指令可用的子指令。 詳情請參閱使用 cvd help env 列印說明訊息。

列出可用的服務或方法

如要取得所有服務的清單，請使用 cvd env ls 而不含任何引數。

cvd env ls

如要取得服務的所有方法清單，請將服務名稱做為引數。

cvd env ls SERVICE_NAME

如要取得詳細資訊 (例如方法的要求或回應訊息類型)，請加入服務名稱和方法名稱。

cvd env ls SERVICE_NAME METHOD_NAME

取得要求和回應類型的詳細資訊

如要取得要求或回應訊息類型的詳細資訊，請使用 cvd env type 指令。這個指令會列印訊息中每個欄位的所有名稱和類型。接著，您可以使用這些資訊來編寫 JSON 格式的 用於傳送遠端程序呼叫 (RPC) 要求的 proto 訊息。

cvd env type SERVICE_NAME REQUEST_OR_RESPONSE_TYPE_NAME

傳送 RPC 要求以變更環境

如要傳送 RPC 要求，以 JSON 格式 proto 呼叫服務方法， 使用 cvd enc call 指令RPC 要求終止時，介面會列印訊息 Rpc succeeded with OK status，如果可用，也會列印包含值的回應訊息。

cvd env call SERVICE_NAME METHOD_NAME JSON_FORMATTED_PROTO

用途範例

以下是 cvd env CLI 指令的用途範例，可透過呼叫 SetTxpower 修改 Wi-Fi 訊號強度。

  1. 決定用於修改 Wi-Fi 訊號強度的服務名稱、方法名稱和要求訊息類型名稱。

    取得所有可用服務的清單。

    cvd env ls
(Omitted)
{
  "services" :
  [
    "OpenwrtControlService",
    "EchoService",
    "GnssGrpcProxy",
    "WmediumdService"
  ]
}

    取得 WmediumdService 的方法清單。

    cvd env ls WmediumdService
(Omitted)
{
  "methods" :
  [
    "ListStations",
    "LoadConfig",
    "ReloadConfig",
    "SetCivicloc",
    "SetLci",
    "SetPosition",
    "SetSnr",
    "SetTxpower",
    "StartPcap",
    "StopPcap"
  ]
}

    取得 SetTxpower 方法。

    cvd env ls WmediumdService SetTxpower
(Omitted)
{
  "request_type" : "wmediumdserver.SetTxpowerRequest",
  "response_type" : "google.protobuf.Empty"
}

  2. 取得 wmediumdserver.SetTxpowerRequest 要求訊息類型的詳細資訊。

    cvd env type WmediumdService wmediumdserver.SetTxpowerRequest
(Omitted)
message SetTxpowerRequest {
  string mac_address = 1;
  int32 tx_power = 2;
}

  3. 將 RPC 要求傳送至 WmediumdService 服務，將 Wi-Fi 訊號強度修改為所需等級。

    cvd env call WmediumdService SetTxpower "{mac_address:'42:00:00:00:00:00', tx_power:1}"
(Omitted)
Rpc succeeded with OK status
{}