This repo contains code for Cisco IOx gps node module of Node-RED. The gps node is a function that outputs real-time gps data of IR800.
(For both gps and motion node modules, please check https://github.com/CiscoIOx/node-red-motion-node-for-iox)
- Docker deamon up and running.
- Cisco IR800 device.
- IOxCore 1.5.0 and IOxGPS 1.5.1 services running on the device.
- ioxclient installed.
(If you already have Docker image node0:1.0, you can skip this step.)
Build Docker image node0:1.0 using the following package:
https://github.com/CiscoIOx/node-red-slim-for-iox
Go to the root of this package (same path as Dockerfile) and run:
docker build -t gpsnode:1.0 .
Don't forget the . at the end. It means the current directory.
This will create a Docker image gpsnode:1.0 based on the previously built image node0:1.0.
Use the following command to build the IOx application package named package.tar.
ioxclient docker package gpsnode:1.0 .
Don't forget the . at the end.
Deploy the application onto IR800 using Local Manager or ioxclient.
For Local Manager option:
Access device Local Manager UI using the URL path https://:8443.
Deploy the app using the name nodered and the package package.tar that you created.
Activate the app with these configurations:
-
Choose
iox-nat0for network and1880:1880for custom port mapping. -
Choose
async1andasync0for device serial ports. -
The recommended resource profile is:
- CPU: 200 cpu-units
- Memory: 128 MB
- Disk: 10 MB
You can change the combination upon the consumption of your other apps. The memory should be no less.
Finally start the app.
For ioxclient option:
Run the following command to deploy, activate and start the app:
ioxclient app install nodered package.tar
ioxclient app activate --payload activation.json nodered
ioxclient app start nodered
The activation.json file is similar to the Sample Activation payload in GPS service introduction of IOx.
Open Node-RED interface at http://:1880.
Build a simple flow with inject, GPS IOx connector and debug nodes. Use timestamp as the payload of inject node.
Set Repeat to none and deploy.
Click the button at timestamp node once. You'll be able to see a set of gps data.
If you set Repeat to interval of every 2 seconds and deploy, you'll be able to see data streaming.
To stop data streaming, set Repeat back to none and deploy.
Enter IOx appconsole by:
ioxclient app console nodered
Run the following command to push flows file and credentials file to Local Manager.
sh /usr/src/node-red/gpsapp/getflows.sh
Go to Local Manager. Click Manage of the nodered app. Click App-DataDir tab, you'll see the flows_$(hostname).json and flows_$(hostname)_cred.json files from there. Download the files to get the flows in Node-RED of this device. The credentials are encrypted.
Go to the Local Manager of a different device. Or you can use Fog Director for multiple devices.
Upload flows_$(hostname).json and flows_$(hostname)_cred.json under App-DataDir tab. These two files should both be uploaded or not. They work in a pair. Use path flows.json and flowscred.json respectively to ensure that they will work on different types of devices.
Start the nodered app of this second device. You should be able to see the flows with credentials already set up.
Example flows are shown below.
By default, the credentialSecret in settings.js of the nodered app is set to cisco. If you want to use your own credentailSecret, create a file called cred.json and upload with path cred.json before you start the app in IOx:
{
"credentialSecret": "your own credentialSecret"
}
Make sure you have this cred.json file with the same credentialSecret for all your devices so that the flows_$(hostname)_cred.json file can be decrypted correctly.
Note that once you set credentialSecret you cannot change its value.
If you have questions, concerns, bug reports, etc., please file an issue in this repository's Issue Tracker.