soporte en línea

Protocolo Coap

Introduction

Coap es un protocolo ligero basado en UDP para comunicarse con dispositivos IP. Puede encontrar más información sobre coap aquí: http://coap.technology/.

Iniciar sesión and URL

Una vez que registremos un nuevo device, le proporcionaremos un par de sensorId y contraseña que deberá utilizar para conectar el dispositivo. La conexión está protegida mediante DTLSv1.2.

CoAP utiliza métodos similares a HTTP: POST/PUT para enviar datos, GET para solicitar datos, DELETE para eliminar.

Pilot Things implementa un conjunto de URL y consultas para facilitar la comunicación. La siguiente tabla resume las URL disponibles y su uso.

El esquema de URL es único por SensorID.

/telemetry

Establecer/obtener varias mediciones mediante JSON

PUT/POST, utilice el JSON para establecer varias mediciones

GET: devuelve un JSON con todos los valores de las mediciones

/telemetry/{measurementName}

Establecer/obtener una medición

Establecer u obtener el valor de la medición.

PUT/POST creará una nueva medición si no existe

/properties

Obtener el valor de la propiedad personalizada del objeto (Key = PropertyName)

No se admite el método POST/PUT

/cualquier otra URL

Establecer/obtener una medición

PUT/POST crea una medición con nombre = URL, valor = valor del payload

GET obtendría el valor usando nombre=URL

Example

El siguiente comando, mediante el cliente CoAP de Unix, enviará los valores de latitud y longitud al sensor cuyo id se indica después de la opción -u.

./coap-client -e "{ \"latitude\": \"35.9078\", \"longitude\": \"127.7669\" }" -m post coaps://coap.eu-west-1.amazonaws.com/telemetry -u <your sensor identity> -k <password>