ARTIK & ARTIK Cloud tutorial

• Setup an ARTIK device with resin.io & connect it to the internet.
• Connect our proximity sensor to our board. (If you don't have a sensor we'll randomly emit values to mimic a sensor).
• Connect to the ARTIK Cloud and push data to it.
• Prepare and push our code to our devices (You'll learn a few things about Docker and git if you aren't already familiar).

Getting Started

Setting Up Your Device

1. Flip the power switch off position.
2. Remove the SD Card.
3. Set the SW2 dip switches to 1:off and 2:off.

Connecting the sensor

.

Configuring Artik Cloud

  {
    "name": "reading",
    "type": "CUSTOM",
    "valueClass": "Integer",
    "isCollection": false,
    "tags": []
  }

Select the cog icon and generate a device token.

The code

# base-image for node on any machine using a template variable,
# see more about dockerfile templates here:https://docs.resin.io/pages/deployment/docker-templates
FROM resin/%%RESIN_MACHINE_NAME%%-node

Save source folder



RUN printf "%s\n" "${PWD##}" > SOURCEFOLDER



Move to /usr/src/app



WORKDIR /usr/src/app



Move package to filesystem



COPY "$SOURCEFOLDER/app/package.json" ./



Install NodeJS dependencies via NPM



RUN JOBS=MAX npm i --unsafe-perm --production && npm cache clean



Move app to filesystem



COPY "$SOURCEFOLDER/app/index.js" ./



Start app



CMD ["node", "/usr/src/app/index.js"]

1. We use resin's official base image. The %%RESIN_MACHINE_NAME%% allows us to dynamically pull images from resin.io's Dockerhub so it can be replaced automatically with artik5 or artik10 depending on which device you are using. Unsurprisingly it also has node pre-installed.
2. We run NPM install before adding the rest of our source, this allows us to make changes to our index.js without invalidating resin.io builder's cache of /node_modules. This is a performance enhancement so don't worry if it's not completely clear right now.
3. Everything before the CMD command runs on our builders, the complete container is then downloaded to the device and the CMD command is executed, starting our application.

function getReading(cb){
  // got a sensor ?
  read_adc0(function(reading){
	if (reading != 0) {
	  // sensor connected
	  cb(reading)
	} else {
	  // no sensor connected so generate a value
	  cb(generateRandomVal(sensor_threshold))
	}
  });
}

/*
Function that enables and reads proximity sensor
*/
function enable_proximity_sensor() {
  console.log('Monitoring for movement');


  setInterval(function() {
getReading(function(reading){
console.log('Sensor reading: ' + reading)
if (reading > sensor_threshold) {
console.log('pushing event to ARTIK Cloud');
push2ArtikCloud(reading);
}
})
}, poll_interval);
}

Push the code

git clone https://github.com/resin-io-projects/resin-artik-cloud-publisher && cd resin-artik-cloud-publisher

git add <resin-app-endpoint>

git push resin master

Conclusion

• We’ve taken an app and deployed it to a piece of hardware using a web-like workflow, futuristic high-five!
• We used Environment variables to remotely provide runtime configuration for the ARTIK devices.
• We poked our heads into the ARTIK Cloud and sent some basic event data.