# Transmisión de datos en la web

### Particle: procedimiento para transmitir los datos en la web

Estos son los pasos que deberá seguir a fin de configurar un dispositivo Particle para transmitir datos por la web (chords).

* [ ] Configure una cuenta en Particle. Al configurar la cuenta primaria o inicial, es mejor práctica configurar una cuenta genérica o de rol dentro de la organización primero y luego crear las cuentas de usuario individuales. De este modo, la cuenta organizacional podrá invitar a personas individuales y establecer los niveles de permiso para cada cuenta de usuario.
* [ ] Cree un «grupo» de productos para sus dispositivos (omita este paso si ya cuenta con un grupo).
* [ ] Registre cada dispositivo Particle en su grupo por medio de la aplicación de teléfono celular.
  * [ ] Después de instalar la aplicación Particle para iOS o Android, que es obligatoria, inicie sesión con las credenciales de su cuenta.
  * [ ] Siga las instrucciones en la guía de inicio rápido:
    * [ ] <https://docs.particle.io/community/photon-maker-kit-> workshop/ch1/#mobile-app-instructions
  * [ ] Conecte la antena al dispositivo y luego conecte el dispositivo a una fuente de energía.
  * [ ] Habilite bluetooth en su teléfono.
  * [ ] En la aplicación móvil Particle, agregue un dispositivo y siga las instrucciones en pantalla; la activación puede tardar varios minutos (recomendamos mantener el teléfono cerca del dispositivo mientras se conecte).
  * [ ] Una vez establecida la conexión, regrese a la consola de su cuenta en línea y pase a la sección con sus dispositivos (*My Devices*): la placa Particle nueva debería aparecer en la lista.
  * [ ] Haga clic en el nuevo dispositivo y copie el número de identificación (ID).
  * [ ] Navegue hasta su grupo en la sección de productos personales (*Personal Products*), haga clic en *Devices* (dispositivos) y luego en *Add Devices* para agregar dispositivos.
  * [ ] Elija *Add One Device* (agregar un dispositivo), pegue en el campo provisto el número de identificación que copió antes, haga clic en *Add* (agregar) ¡y ya está!
  * [ ] Compruebe la presencia del firmware: haga clic en el dispositivo, haga clic en *EDIT* (editar), haga clic en *Firmware*, seleccione la versión más reciente y, finalmente, haga clic en *SAVE* para guardar.
* [ ] Create a CHORDS site/instrument&#x20;
  * [ ] Create an account on CHORDS —> *admin* must update your permissions to create new sites and instruments&#x20;
  * [ ] Abra el portal CHORDS, pase a la pestaña *Sites* y haga clic en el botón *New Site* para comenzar a crear una estación nueva.
  * [ ] Introduzca un nombre y una descripción para la estación, así como su latitud, longitud y altitud, con una precisión de 10 metros; a continuación, configure el tipo de estación (*Site Type*) en *Atmosphere* (atmosférica) y, finalmente, haga clic en *Create Site* para crear la estación.
  * [ ] Cree un instrumento, para lo cual tiene dos opciones.
    * [ ] Opción 1
      * [ ] Abra la pestaña *Instrument* y haga clic en el botón *New Instrument* para crear un instrumento nuevo
      * [ ] Asigne un nombre al instrumento y elija *climatology/meteorology/atmosphere* (climatológico/meteorológico/atmosférico) en *Topic Category* (categoría temática). No hace falta cambiar ninguna de las demás opciones predeterminadas, haga clic en el botón *Create Instrument* para crear el instrumento.
      * [ ] Agregue todas las variables del instrumento.

<table data-full-width="true"><thead><tr><th width="137">Nombre corto</th><th width="218">Nombre</th><th width="153">Unidad</th><th width="162">Min/Máx (gráfica)</th><th>Propiedad medida Property</th></tr></thead><tbody><tr><td>bp1   </td><td>BMX280 Presión</td><td>hectopascales<br>hPa</td><td>/</td><td>Presión atmosférica</td></tr><tr><td>bt1</td><td>BMX280 Temperatura</td><td>grados Celsius degC</td><td>/</td><td>Temperatura</td></tr><tr><td>mt1</td><td>MCP9808 Temperatura</td><td>grados Celsius degC</td><td>/</td><td>Temperatura</td></tr><tr><td>ws</td><td>Velocidad del viento</td><td>metros por segundo<br>m/s</td><td>/</td><td>Velocidad del viento</td></tr><tr><td>wd</td><td>Dirección del viento</td><td><p>grados</p><p>deg</p></td><td>/</td><td>Ángulo de la dirección del viento</td></tr><tr><td>rg</td><td>Pluviómetro</td><td>milímetros<br>mm</td><td>/</td><td>Precipitación</td></tr><tr><td>sv1</td><td>SI1145 Radiación visible</td><td>vatios por metro cuadrado<br>W/m^2</td><td>/</td><td>Irradiancia descendente</td></tr><tr><td>si1</td><td>SI1145 Radiación infrarroja</td><td>vatios por metro cuadrado<br>W/m^2</td><td>/</td><td>Irradiancia descendente</td></tr><tr><td>su1</td><td>SI1145 Radiación ultravioleta</td><td>vatios por metro cuadrado<br>W/m^2</td><td>/</td><td>Irradiancia descendente</td></tr><tr><td>wg</td><td>Ráfagas</td><td>metros por segundo  <br>m/s</td><td>/</td><td>Velocidad del viento</td></tr><tr><td>wgd</td><td>Dirección de las ráfagas de viento</td><td>grados<br>deg</td><td>/</td><td>Ángulo de la dirección del viento</td></tr><tr><td>bcs</td><td>Condición actual de la batería</td><td><p>recuento</p><p>#</p></td><td>/</td><td>Estado de salud</td></tr><tr><td>bpc</td><td>Porcentaje de carga de la batería</td><td>porcentaje<br>%</td><td>/</td><td>Estado de salud</td></tr><tr><td>css</td><td>Fuerza de la señal celular</td><td>porcentaje<br>%</td><td>/</td><td>Estado de salud</td></tr><tr><td>hth</td><td>Salud del sistema de 16 bits</td><td><p>recuento</p><p>#</p></td><td>/</td><td>Estado de salud</td></tr><tr><td>bh1</td><td>BMX280 Humedad relativa</td><td>porcentaje<br>%</td><td>/</td><td>Humedad</td></tr><tr><td>cfr</td><td>Registro de errores de carga de la batería</td><td><p>recuento</p><p>#</p></td><td>/</td><td>Estado de salud</td></tr><tr><td>ht1</td><td>HTU21D Temperatura</td><td>grados Celsius degC</td><td>/</td><td>Temperatura</td></tr><tr><td>hh1</td><td>HTU21D Humedad relativa</td><td>porcentaje<br>%</td><td>/</td><td>Humedad</td></tr></tbody></table>

*

&#x20;  \* \[ ] Opción 2
\* \[ ] Abra la pestaña *Instrument* y busque el instrumento que va a clonar.
\* \[ ] Haga clic en el botón *Duplicate* (duplicar) en el extremo derecho junto al instrumento; al hacerlo, la pantalla se renovará y la copia aparecerá al final de la lista de instrumentos. Haga clic en ella para modificar el instrumento.
\* \[ ] Haga clic en el botón *Edit Instrument* (editar instrumento), asigne un nombre nuevo al instrumento y actualice el sitio también.

* [ ] Cree un *webhook* para **cada dispositivo** que se conectará al sitio web de chords: <https://docs.particle.io/tutorials/device-cloud/webhooks/>
  * [ ] Seleccione *New Integration* (nueva integración).
  * [ ] Seleccione *Webhook*.
  * [ ] Haga clic en la plantilla personalizada (*custom*).
  * [ ] Copie y pegue este código y sustituya los datos resaltados por las ID que desea usar:

```python
{
"event": "FS",
"deviceID": "e00fce68a25ae28bb94df8fb",
"url": "http://3d.chordsrt.com/measurements/url_create",
"requestType": "GET",
"noDefaults": true,
"rejectUnauthorized": false,
"query": {
    "key": "21DE6A8A",
    "instrument_id": "71",
    "at": "{{at}}",
    "hth": "{{hth}}",
    "bcs": "{{bcs}}",
    "bpc": "{{bpc}}",
    "cfr": "{{cfr}}",
    "css": "{{css}}",
    "bp1": "{{bp1}}",
    "bt1": "{{bt1}}",
    "bh1": "{{bh1}}",
    "hh1": "{{hh1}}",
    
    "ht1": "{{ht1}}",
    "sv1": "{{sv1}}",
    "si1": "{{si1}}",
    "su1": "{{su1}}",
    "mt1": "{{mt1}}",
    "rg": "{{rg}}",
    "rgs": "{{rgs}}",
    "ws": "{{ws}}",
    "wd": "{{wd}}",
    "wg": "{{wg}}",
    "wgd": "{{wgd}}",
    "sg1": "{{sg1}}",
    "sg1v": "{{sg1v}}",
    "sg1p1": "{{sg1p1}}",
    "sg1t1": "{{sg1t1}}",
    "sg1h1": "{{sg1h1}}",
    "sg1p2": "{{sg1p2}}",
    "sg1t2": "{{sg1t2}}",
    "sg1h2": "{{sg1h2}}",
    "bp2": "{{bp2}}",
    "bt2": "{{bt2}}",
    "bh2": "{{bh2}}",
    "mt2": "{{mt2}}"
    }
}
```

* [ ] Cargue el *firmware*.
* [ ] ¿Necesita rearrancar el dispositivo? Selecciónelo, busque *FUNCTIONS* abajo a la derecha, teclee *NOW* y haga clic en *Call*. El sistema contestará que la llamada fracasó, pero puede ignorar ese mensaje.

Enlace a tutoriales (en inglés):\
<https://docs.particle.io/tutorials/particle-hardware/>

Inicio rápido: Boron\
<https://docs.particle.io/quickstart/boron/>&#x20;

Particle 101 – Cómo reclamar un Particle Boron\
<https://www.youtube.com/watch?v=xymSayKBGbg>

Quick start: Workbench \
<https://docs.particle.io/quickstart/workbench/>

Visual Studio – Particle Workbench, primeros pasos:\
<https://blog.particle.io/get-started-with-particle-workbench/>&#x20;

Hoja de datos de la placa Boron LTE:\
<https://docs.particle.io/datasheets/boron/boron-datasheet/>&#x20;

Línea de comandos:\
<https://docs.particle.io/tutorials/developer-tools/cli/>&#x20;

Significado de los LED de estado de la placa Boron:\
<https://docs.particle.io/tutorials/device-os/led/boron/>&#x20;

Cuando la placa parpadea verde rápidamente, está tratando de conectarse a la red celular. Sketch no se ejecutará hasta que se complete la conexión a la red.

Cuando la placa está conectándose a la nube, parpadea cian rápidamente. Este estado se observa a menudo al conectar la placa a una red por primera vez, justo después de parpadear verde.&#x20;

Cuando la placa está conectada a la red celular pero no a la nube, parpadea verde lentamente.&#x20;

Cuando parpadea cian lentamente, la placa está conectada a internet. En este estado, se pueden hacer llamadas a funciones y se puede cargar código compilado.

Modos del sistema:\
<https://docs.particle.io/reference/device-os/firmware/boron/#system-modes>&#x20;

Cómo agregar usuarios a un grupo de productos:\
<https://docs.particle.io/tutorials/device-cloud/console/#adding-team-members>&#x20;

Rol y permisos de cada integrante del equipo:\
<https://docs.particle.io/tutorials/product-tools/team-access-controls/#sts=Roles>&#x20;