Showing posts with label mobile. Show all posts
Showing posts with label mobile. Show all posts

Monday, June 19, 2017

Convierte tu smartphone en un dispositivo IoT

Todos sabemos que un smartphone dispone de múltiples sensores como por ejemplo el acelerómetro, el giroscopio, el sensor de luz, el termómetro, el lector de huellas, etc.

Las aplicaciones clientes instaladas en los smartphones recogen los datos de los diferentes sensores para procesarlos internamente o enviarlas a un servidor IoT para analizar los datos y en algunos caso, devolver al dispositivo mensajes de vuelta

Bien, pues me he lanzado a comprobar que es posible y en menos de 30 minutos, usando un quick-starter y un tutorial (en el que está basado este artículo), voy a intentar convertir tu smartphone en un dispositivo sensor que conectado al servidor IBM IoT (Internet of Things), se usará para enviar/recibir datos y procesar/visualizar los datos del dispositivo en IBM Bluemix.

¿No os parece alucinante? utilizar un sensor de tu smartphone y procesar los datos que se obtienen... uhmm.. Imaginad cuando se le dedica tiempo a frikear esto lo que se puede hacer ;)
Bueno vamos a ello, la visión general de la arquitectura que voy a montar será la que muestra la siguiente imagen:




Es caso de uso de este post es simple, el smartphone se gira y envía la información a un servicio IoT (1) que lo procesa e envía un mensaje de vuelta (2) para que cambie el color de la pantalla del smartphone en función de la aceleración de giro. Los datos obtenidos del sensor se pueden explotar por una aplicaión cliente (3).

Para ello se usará el sensor acelerómetro, indispensable para medir la aceleración, la inclinación y la gravedad. Este sensor normalmente se usa cuando cambiamos el dispositivo de una posición vertical a horizontal y viceversa.

La comunicación entre el Smartphone y el servicio IoT se realiza mediante el protocolo MQTT (Message Queue Telemetry Transport). MQTT es un protocolo usado para la comunicación machine-to-machine (M2M) en IoT y está orientado a la comunicación de sensores debido a que consume muy poco ancho de banda. Puede ser utilizado en la mayoría de los dispositivos con pocos recursos: CPU, RAM, etc.

¿Qué se necesita?

  • Una cuenta en Bluemix, existe una versión trial de 30 días
  • Cloud Foundry CLI, interfaz de línea de comandos de Bluemix para descargar, modificar y reasignar aplicaciones y instancias de servicio de Cloud Foundry.
  • Teléfono móvil (smartphone) (Android)
Nota: Se puede usar telefónos móviles iOS, lo único que cambia es la aplicación cliente del dispositivo.

Paso 1 - Crear aplicación IoT

Este paso se describe el procedimiento para la creación de una aplicación en IoT que contiene un motor Node-RED que se usa para procesar los mensajes de de la aplicación IoT. También se crea un servicio de IoT para enviar y recibir mensajes MQTT.



1) Acceder a la cuenta de Bluemix
2) Pulsar en Catalog y en el filtro de búsqueda escribir “Internet of Things"
3) Pulsar en el Boilerplates de Internet of Things





4) Escribir el nombre de la aplicación IoT y pulsar Create

Se desplegarán y se conectarán los siguientes servicios:
  • Watson IoT Platform - Un kit de herramientas IoT que incluye administración de pasarelas, administración de dispositivos y acceso a aplicaciones. Mediante el uso de Watson IoT Platform, puede recopilar datos de dispositivos conectados y ejecutar analíticas en datos en tiempo real
  • IBM® SDK for Node.js para Bluemix® - Entorno de ejecución en el que Node-RED se ejecuta
  • IBM® Cloudant® NoSQL DB para Bluemix® - Base de datos en la que Node-RED almacena metadatos
  • Aplicación Node-RED - Una instancia de la aplicación Node-RED que incluye nodos diseñados para la plataforma Watson IoT

Paso 2 - Añadir dispositivo para enviar mensajes MQTT al servidor IoT

Este paso muestra el procedimiento para registrar y crear un tipo de dispositivo en la plataforma de Watson IoT.


1) Acceder a la consola de la aplicación IoT
2) Pulsar en el menú de IBM Bluemix en la parte superior izquierda de la pantalla
3) Seleccionar Services y después pulsar Dashboard
4) En la lista de servicios buscar el servicio IoT creado y pulsar sobre él
5) En la página inicial de la gestión del servicio pulsar Launch




6) Se muestra el panel de control del servidor IBM Internet of Things, que es un servicio independiente de Bluemix. Se asigna un ID de organización a la aplicación y se necesitará este ID más adelante al desarrollar la aplicación para dispositivos móviles.
7) Pulsar en el icono Devices





8) Pulsar en Add Devices
9) Crear un tipo de dispositivo que se llame Android y pulsar Next




10) Pulsar Next, para esta demo no es necesario información adicional del dispositivo
11) Pulsar Next
12) Pulsar Create para crear el tipo de dispositivo
13) Aparece la pantalla de añadir dispositivo. Seleccionar el tipo Android. Pulsar Next


14) Añadir el ID del dispositivo y pulsar Next
15) Dejar la información de los metadatos en blanco y pulsar Next
16) Crear una autenticación por defecto de tokens: secret123 y pulsar Next
17) Pulsar Add
18) Cerrar la ventana


Ya está listo para enviar mensajes MQTT desde un dispositivo al IBM IoT Server.

Paso 3 – Instalar y configurar la aplicación Android

Este paso muestra el procedimiento para instalar y configurar la aplicación cliente en un smartphone.

 
1) En el móvil, ir a Settings > Security. Debajo de Device Administration, activa Unknown sources. También se puede instalar .apk desde repositorios fuera del Google Play.
2) Abrir un navegador y descargar la aplicación de cliente desde la URL:
Se descarga el fichero : iot-starter_501_v2.apk
Nota: versión compilada con Android 5.0.1 y compatible con versiones superiores
3) Instalar la la aplicación iot-starter_501_v2.apk en el dispositivo móvil
4) Una vez instalada la aplicación, se ejecuta para terminar la configuración
Nota: No seguir el tutorial pulsando Skip Tutorial
5) Introducir los parámetros de configuración
  • Organization: El ID de la organización que se muestra en el servidor de IBM IoT server (cuando empieza la comunicación empieza a enviar mensajes MQTT al servidor IoT). Para este ejemplo, puflid para este tutorial
  • Device ID: ID con el cual se ha configurado el dispositivo
  • Auth Token: Clave secreta de autentificación.
6) Pulsar Activate Sensor. Ahora la aplicación empieza a recoger datos del sensor de aceleración del móvil y envía la información a el servidor IoT.
Nota: El código de la aplicación Android se puede descargar de Git:
https://github.com/ibm-watson-iot/iot-starter-for-android

Paso 4 – Verificar que los datos son enviados del móvil al servidor IoT

1) Volviendo al servidor IoT, ir a página Devices


2) Pulsar sobre el dispositivo y pulsar sobre algún evento recibido

  
Nota: Los mensajes que se envían desde el móvil están en formato JSON y contienen datos de aceleración y posición.

Paso 5 – Procesar los mensajes enviados en Node-RED

Esta sección mejorará la aplicación Bluemix IoT utilizando un flujo Node-RED para procesar mensajes desde el smartpohone y, a continuación, enviar mensajes al smartphone. El móvil reaccionará en estos mensajes cambiando el color de fondo en la aplicación.





Nota: Node-RED es una herramienta visual que facilita el procesamiento de mensajes de IoT.


1) Acceder a la consolad de la aplicación de Bluemix
2) Pulsar en el menú de IBM Bluemix en la parte superior izquierda de la pantalla
3) Pulsar Apps y después sobre el mismo menú pulsar Dashboard
4) En la lista de aplicaciones Cloud Foundry buscar la aplicación creada y pulsar el icono Open URL





Nota: La primera vez que se accede aparece un asistente de configuración de la seguridad del editor Node-RED. También se crea por defecto un flujo de trabajo con los objetos necesarios para interactuar con dispositivos IoT


5) Crear un nuevo flujo, copiar e importar desde el clipboard el siguiente código con una configuración por defecto:


[{"id":"215c6601.12d32a","type":"ibmiot in","authentication":"boundService","apiKey":"","inputType":"evt","deviceId":"","applicationId":"","deviceType":"","eventType":"accel","commandType":"","format":"json","name":"IBM IoT App In","service":"registered","allDevices":true,"allApplications":"","allDeviceTypes":true,"allEvents":"","allCommands":"","allFormats":"","x":264.1999969482422,"y":434.1999969482422,"z":"dc6a0ca6.7993b","wires":[["ce21edbb.320628","fdfdaaa2.a45678"]]},{"id":"ce21edbb.320628","type":"function","name":"calc color","func":"var accelZ = msg.payload.d.acceleration_z;\nvar r = 0.0;\nvar b = 0.0;\nvar g = 0.0;\nif (accelZ > 0) {\n\tg = Math.round(accelZ * 25);\n} else if (accelZ < 0) {\n\tr = 255.0;\n} else {\n\tr = 104;\n\tg = 109;\n\tb = 115;\n}\na = 1.0;\n\nmsg.eventOrCommandType = \"color\";\nmsg.payload = JSON.stringify({\"d\":{\"r\":r,\"b\":b,\"g\":g,\"alpha\":a}});\n\nreturn msg;","outputs":1,"noerr":0,"x":437.1999969482422,"y":430.1999969482422,"z":"dc6a0ca6.7993b","wires":[["9df37edb.5d4588"]]},{"id":"9df37edb.5d4588","type":"ibmiot out","authentication":"boundService","apiKey":"","outputType":"cmd","deviceId":"112233445566","deviceType":"Android","eventCommandType":"text","format":"json","data":"{\"d\":{\"value\":\"text\"}}","name":"IBM IoT App Out","service":"registered","x":629.1999969482422,"y":443.1999969482422,"z":"dc6a0ca6.7993b","wires":[]},{"id":"fdfdaaa2.a45678","type":"debug","name":"","active":false,"console":"false","complete":"false","x":442.1999969482422,"y":364.1999969482422,"z":"dc6a0ca6.7993b","wires":[]}]




6) Adaptar los parámetros específicos. Pulsar dos veces sobre el nodo IBM IoT App out. En la ventana emergente, introducir el ID del dispositivo y pulsar DONE
7) Pulsar Deploy para desplegar los nodos y activarlos automáticamente
8) Mover el smartphone para ver cómo cambia de color la pantalla dependiendo de la aceleración de giro.





9) En el editor Node-RED, pulsar en el rectángulo cerca del nodo msg.payload node, y pulsar el tabulador debug para activar las trazas. Los datos de las trazas enviados desde el dispositivo móvil son en formato JSON





10) Inspecciona el código del calculador del color. Pulsa dos veces sobre la función calc color
Ahora hay una comunicación bidireccional entre su smartphone y la aplicación de Bluemix.

Paso 6 - Crear una aplicación Bluemix para visualizar los datos del sensor

Este paso muestra el procedimiento para crear una aplicación auxiliar para visualizar los datos del sensor.




1) Descargar el código de la aplicación ejemplo:
  • https://github.com/ibm-watson-iot/rickshaw4iot
2) Ir al Dashboard de Bluemix
3) Crear aplicación. Pulsar Create App
4) Pulsar sobre la aplicaciones Cloud Foundry SDK for Node.js
5) Escribir el nombre de la aplicación. En este ejemplo iotvisualizerjif
6) Pulsar Create. En pocos minutos la aplicación se creará y estará en ejecución
7) Descomprimir la aplicación rickshaw4iot-0.2.0.zip
8) Editar el fichero de manifiesto manifest.yml y cambiar los parámetros host y name de la aplicación como se muestra en el ejemplo:

applications:
- disk_quota: 1024M
  host: iotvisualizerjif
  name: iotvisualizerjif
  command: node app.js
  path: .
  domain: mybluemix.net
  instances: 1
  memory: 128M

9) Desde la línea de comandos y dentro de la carpeta descomprimida del proyecto ejecutar los siguientes comandos:
 
& cf api https://api.ng.bluemix.net 

& cf login -u <your_bluemix_login_id>

cf login solo es requerido la primera vez

10) Desplegar la aplicación en Bluemix
 
& cf push

11) Realizar un Bind con la aplicación IoT creada. En el Dashboard de la aplicación Pulsar Connections y luego Connect Existing











12) Seleccionar el servicio creado en el ejemplo y pulsar Connect
13) Pulsar Restage para que la aplicación empieze a recibir mensajes del servidor IoT
14) Abrir la aplicación desde un navegador, en este ejemplo:
15) Selecciona el dispositivo a visualizar




Conclusiones

Pues funciona!!! :D
He convertido fácilmente mi smartphone en un dispositivo sensor, y lo he conectado al servidor IBM Internet of Things, para enviar y recibir datos en menos de 30 minutos.
¿Y tú? ¿lo has conseguido?



Friday, December 16, 2016

Clone Cordova application using MobileFirst CLI

Hi folk,

Recently a customer asked me to help them creating a process of cloning configuration from mobile Cordova applications, from one version to another, using the IBM MobileFirst™ PlatformCommand Line Interface (CLI). The idea is to be able to automate the process in its continuous integration software development.

Currently the tool offers the cloning procedure from the operations console:





But MFP command-line does not have "clone" functionality today :/, who has said fear? :)

You can transfer an application configuration from a one server to another by using command-line tools or a REST API.

So, I have created a cloning functionality using nodejs-based program and mfpdev commands with the following business logic:

1) Pull the application descriptor JSON File:

Retrieves an existing app configuration from the server. The configuration includes the contents of the application descriptor, which uniquely identifies the app to the server and other information that is specific to the app. 
The configuration files are provided as compressed files (.zip format). 

2) Unzip artifacts zip file:

The .zip files are placed in the directory appName/mobilefirst and named as follows:
appID-platform-version-artifacts.zip

where:
appID is the application name,  
platform is one of android, ios, or windows
version is the version level of your app. 
For Cordova apps, a separate .zip file is created for each target platform.

3) Add version Application-Descriptor JSON File:

The application descriptor file is a JSON file that contains the description and configuration of your application. When you run an app that connects to a MobileFirst Server instance, the app must be registered with that server and configured.

4) Zip new artifacts zip file:
The .zip files are placed in the directory appName/mobilefirst and named as follows:
appID-platform-newversion-artifacts.zip

5) Modify the version in configuracion file (config.xml)

The Cordova configuration file is a mandatory XML file that contains application metadata, and is stored in the root directory of the app. The file is automatically generated when you create a Cordova application.

Information about this file in the Apache Cordova config.xml documentation.

6) Register application

Registers your app with a MobileFirst Server.

7) Push application

This command sends the .zip file to the MobileFirst Server. The client properties file myapp1/app/src/main/assets/mfpclient.properties is modified to reflect that the server that the app is registered.

Example - Clone version 1.0.1 to 2.0.0:

I have an app registered with the following versions:



In the app directory run following command:




$ node cloneApp.js local mfp jif.example.hellocordova android 1.0.1 2.0.0

When the process is finished, the new registered version must be displayed:



The source code can be downloaded from:
https://github.com/jorgeiglesiasfernandez/CloneApp
Note: Application authenticity and web resources will not be cloned. If you import an application that includes authenticity data, and if the application itself has been recompiled since the authenticity data was generated, you must refresh the authenticity data. For more information, see Configuring the application-authenticity security check.

Cheers!

Monday, February 8, 2016

IBM MobileFirst Platform - Part II. Install the Mobile Test Workbench

Let's go! with the Mobile Test Workbench, if you have MobileFirst Studio installed (IBM MobileFirst Platform - Part I Install Developer Studio),  you can automate the functional testing of Android and iOS applications that were built with MobileFirst Studio.
  1. Start Eclipse, and then select Help > Eclipse Marketplace
  2. In the Find field, type MobileFirst Platform Test Workbench and click Go
  3. Click the Install button
  4. Select the features that you want to install, and then click Next.
  5. Click Next, and then review and accept the license terms, and then click Finish to begin the installation
  6. Follow the prompts to complete the installation
  7. Restart Eclipse IDE for the changes to take effect
Note: Testing Android applications with the Test Workbench requires a JDK. Be sure to add the path to the JDK in Eclipse under Window > Preferences > Java > Installed JREs, and set it as the default JRE by selecting its corresponding check box

When IBM MobileFirst Platform Test Workbench is installed, you can install the mobile test client for Android and the mobile test client for the iOS Simulator.

IBM MobileFirst Platform - Part I. Install Developer Studio

IBM MobileFirst Platform Studio is an Eclipse plug-in that helps you quickly build, run, and manage mobile web, hybrid, and native apps., allowing developers to perform all the coding and integration tasks that are required to develop a fully operational application ror a variety of mobile, tablet, desktop and web environments

I'll install the plug-in in my IBM Rational Software Architect Designer 9.5 based on Eclipse 4.4.2



Note: Ensure that your Eclipse workspace path does not contain any spaces, which can cause failures when apps are deployed to the internal development server, or when the MobileFirst Operations Console is started.
  1. Start Eclipse, and then select Help > Eclipse Marketplace.
  2. In the Find field, type MobileFirst Platform and click Go.
  3. Click the IBM MobileFirst Platform Studio Install button.
  4. IBM MobileFirst Platform Studio and all features are preselected. Confirm your selection and click Next.
    • Always select IBM MobileFirst Platform Studio
    • IBM Dojo Mobile Tools and IBM jQuery Mobile Tools are optional, select them based on your anticipated use 
  5. Review and accept the license terms, and then click Finish to begin the installation
  6. Follow the prompts to complete the installation
  7. Restart Eclipse IDE for the changes to take effect.
Note: If your Eclipse workbench has IBM Rational Team Concert™ V4.0 Eclipse Client already installed, you might need to clean the Eclipse environment before you use Studio.

First you have is the welcome page with some links to mobile features.

 
 Enjoy it and you can start to create mobile apps!