Cuttlefish: contrôle de l'environnement

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Cette page explique comment contrôler l'environnement d'un appareil Cuttlefish à l'aide de l'API REST ou de l'interface de ligne de commande. Par exemple, vous pouvez modifier le signal Wi-Fi ou mettre à jour la position GPS de l'appareil Cuttlefish.

Services

La commande cvd env fournit les services suivants pour contrôler l'environnement Cuttlefish :

Contrôler l'environnement à l'aide de l'API REST

Cette section explique comment contrôler l'environnement à l'aide de l'API Rest via le point de terminaison de service <https://localhost:1443>.

Lister les services ou méthodes disponibles

Pour obtenir la liste de tous les services, envoyez une requête GET à l'URL suivante avec un ID d'appareil.

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

Pour obtenir la liste de toutes les méthodes d'un service, envoyez une requête GET à l'URL suivante avec un ID d'appareil et le nom du service.

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

Pour obtenir des informations détaillées sur une méthode, telles que les types de messages de requête ou de réponse, envoyez une requête GET à l'URL suivante avec un ID d'appareil, un nom de service et le nom de la méthode.

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

Obtenir des informations détaillées sur les types de requêtes et de réponses

Pour obtenir des informations détaillées sur un type de message de requête ou de réponse, envoyez une requête GET à l'URL suivante avec un ID d'appareil, un nom de service et le type de message de requête ou de réponse. Cette commande affiche tous les noms et types de chaque champ du message. Vous pouvez ensuite utiliser ces informations pour rédiger Message proto au format JSON pour l'envoi d'une requête RPC.

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

Envoyer une requête RPC pour modifier l'environnement

Pour envoyer une requête RPC afin d'appeler une méthode d'un service avec un proto au format JSON, envoyez une requête POST à l'URL suivante avec un ID d'appareil : un service le nom et le nom de la méthode. Le proto au format JSON doit être inclus dans le corps.

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

Exemple de cas d'utilisation

Voici un exemple de cas d'utilisation de l'API REST pour modifier l'intensité du signal Wi-Fi en appelant SetTxpower.

1. Déterminer le nom du service, le nom de la méthode et le type de message de la requête nom permettant de modifier l'intensité du signal Wi-Fi.

   1. Pour obtenir la liste de tous les services disponibles, envoyez une requête GET au l'URL suivante.

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

      Voici un exemple de réponse.

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

   2. Obtenez la liste des méthodes pour WmediumdService en envoyant une requête GET à l'URL suivante.

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

      Voici un exemple de réponse.

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

   3. Pour obtenir des informations sur les types de messages de requête et de réponse pour la méthode SetTxpower, envoyez une requête GET à l'URL suivante.

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

      Voici un exemple de réponse.

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

2. Obtenir des informations détaillées sur la requête wmediumdserver.SetTxpowerRequest en envoyant une requête GET à l'URL suivante.

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

   Ceci est un exemple de réponse.

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

3. Envoyez une requête RPC au service WmediumdService pour modifier l'intensité du signal Wi-Fi au niveau souhaité en envoyant une requête POST à cette URL avec le corps de requête suivant.

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

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

   Ceci est un exemple de réponse.

   {}
   

Contrôler l'environnement à l'aide de la ligne de commande

Cette section décrit les sous-commandes disponibles pour la commande de ligne de commande cvd env. Pour en savoir plus, imprimez le message d'aide à l'aide de cvd help env.

Répertorier les services ou méthodes disponibles

Pour obtenir la liste de tous les services, utilisez cvd env ls sans aucun argument.

cvd env ls

Pour obtenir la liste de toutes les méthodes d'un service, incluez le nom du service en tant qu'argument.

cvd env ls SERVICE_NAME

Pour obtenir des informations détaillées telles que les types de messages de requête ou de réponse d'une méthode, incluez le nom du service et le nom de la méthode.

cvd env ls SERVICE_NAME METHOD_NAME

Obtenir des informations détaillées sur les types de requêtes et de réponses

Pour obtenir des informations détaillées sur un type de message de requête ou de réponse, utilisez la commande cvd env type. Cette commande imprime tous les noms et types de chaque champ du message. Vous pouvez ensuite utiliser ces informations pour écrire un fichier proto pour envoyer une requête RPC.

cvd env type SERVICE_NAME REQUEST_OR_RESPONSE_TYPE_NAME

Envoyer une requête RPC pour modifier l'environnement

Pour envoyer une requête RPC afin d'appeler une méthode d'un service avec un proto au format JSON, utilisez la commande cvd enc call. Lorsque la requête RPC se termine, l'interface affiche le message Rpc succeeded with OK status et, le cas échéant, une réponse message incluant les valeurs.

cvd env call SERVICE_NAME METHOD_NAME JSON_FORMATTED_PROTO

Exemple de cas d'utilisation

Voici un exemple de cas d'utilisation de la commande CLI cvd env pour modifier l'intensité du signal Wi-Fi en appelant SetTxpower.

1. Déterminer le nom du service, le nom de la méthode et le type de message de la requête nom permettant de modifier l'intensité du signal Wi-Fi.

   Obtenez la liste de tous les services disponibles.

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

   Obtenez la liste des méthodes pour WmediumdService.

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

   Permet d'obtenir des informations sur les types de messages de demande et de réponse pour le SetTxpower.

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

2. Obtenez des informations détaillées sur le type de message de requête wmediumdserver.SetTxpowerRequest.

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

3. Envoyez une requête RPC au service WmediumdService pour modifier l'intensité du signal Wi-Fi au niveau souhaité.

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