Code Monkey home page Code Monkey logo

j5-sparkfun-weather-shield's Introduction

SparkFun Weather Shield

Build Status

For use with Johnny-Five.

  • SparkFun Weather Shield DEV-13956, 13956 (Current)

    • Humidity/Temperature Sensor - Si7021
    • Barometric Pressure - MPL3115A2
    • Light Sensor - ALS-PT19
  • SparkFun Weather Shield DEV-12081, 12081 (Retired)

    • Humidity/Temperature Sensor - HTU21D
    • Barometric Pressure - MPL3115A2
    • Light Sensor - ALS-PT19
  • SparkFun Photon Weather Shield DEV-13674, 13674 (Current)

    • Humidity/Temperature Sensor - Si7021
    • Barometric Pressure - MPL3115A2
  • SparkFun Photon Weather Shield DEV-13630, 13630 (Retired)

    • Humidity/Temperature Sensor - HTU21D
    • Barometric Pressure - MPL3115A2

API & Documentation

For use with Particle Photon:

npm install johnny-five particle-io j5-sparkfun-weather-shield

For use with Arduino:

npm install johnny-five j5-sparkfun-weather-shield

Weather

The Weather class constructs objects that represent the built-in components of the shield.

  • Explicit Initialization, defaults "data" to 25ms intervals

    const weather = new Weather({
      variant: "DEV-13956",
    });
    
    ...or...
    
    const weather = new Weather({
      variant: "DEV-13674",
    });
  • Explicit Initialization, specify "data" to 200ms intervals

    const weather = new Weather({
      variant: "DEV-13956",
      period: 200
    });
    
    ...or...
    
    const weather = new Weather({
      variant: "DEV-13674",
      period: 200
    });

Parameters

Property Type Value(s)/Description Default Required Version
variant string "ARDUINO", "PHOTON" no yes v0.1.0-v1.0.0
variant string or number See Variants no yes v2.0.0+
elevation number Base elevation in meters (You can use whatismyelevation.com to find out the base elevation for your location) yes * yes
freq number Use period 25 (ms) no v0.1.0-v1.0.0
period number Milliseconds. The rate in milliseconds to emit the data event 25 (ms) no v2.0.0+

* If elevation is omitted, the value of the feet and meters properties will be null. When elevation is included, there is a 3 second calibration window before all values are reported.

Variants

Shield Product Name Variant Values Retired ?
SparkFun Weather Shield "DEV-13956", "DEV13956", 13956 No
SparkFun Weather Shield "DEV-12081", "DEV12081", 12081 Yes
SparkFun Photon Weather Shield "DEV-13674", "DEV13674", 13674 No
SparkFun Photon Weather Shield "DEV-13630", "DEV13630", 13630 Yes

Using the Arduino shield

(Without a specified elevation)

const five = require("johnny-five");
const Weather = require("j5-sparkfun-weather-shield")(five);
const board = new five.Board();

board.on("ready", () => {
  const weather = new Weather({
    variant: "DEV-13956",
    period: 200
  });

  weather.on("data", () => {
    const {
      celsius,
      fahrenheit,
      kelvin,
      pressure,
      relativeHumidity,
      lightLevel
    } = weather;

    console.log("celsius: %d°C", celsius);
    console.log("fahrenheit: %d°F", fahrenheit);
    console.log("kelvin: %d°K", kelvin);
    console.log("pressure: %d kPa", pressure);
    console.log("relativeHumidity: %d RH", relativeHumidity);
    console.log("lightLevel: %d%", lightLevel);
    console.log("----------------------------------------");
  });
});

(With a specified elevation)

const five = require("johnny-five");
const Weather = require("j5-sparkfun-weather-shield")(five);
const board = new five.Board();

board.on("ready", () => {
  const weather = new Weather({
    variant: "DEV-13956",
    period: 200, 
    // Set your base elevation with a value in meters,
    // as reported by http://www.whatismyelevation.com/.
    // `5` is the elevation (meters) of the
    // Bocoup office in downtown Boston
    elevation: 5,
  });

  // Including elevation for altitude readings will
  // incure an additional 3 second calibration time.
  weather.on("data", () => {
    const {
      celsius,
      fahrenheit,
      kelvin,
      pressure,
      feet,
      meters,
      relativeHumidity,
      lightLevel
    } = weather;

    console.log("celsius: %d°C", celsius);
    console.log("fahrenheit: %d°F", fahrenheit);
    console.log("kelvin: %d°K", kelvin);
    console.log("pressure: %d kPa", pressure);
    console.log("feet: %d'", feet);
    console.log("meters: %d", meters);
    console.log("relativeHumidity: %d RH", relativeHumidity);
    console.log("lightLevel: %d%", lightLevel);
    console.log("----------------------------------------");
  });
});

Using the Photon shield

(Without a specified elevation)

const Particle = require("particle-io");
const five = require("johnny-five");
const Weather = require("j5-sparkfun-weather-shield")(five);
const board = new five.Board({
  io: new Particle({
    token: process.env.PARTICLE_TOKEN,
    deviceId: process.env.PARTICLE_PHOTON_DEVICE_ID
  })
});

board.on("ready", function() {
  var weather = new Weather({
    variant: "DEV-13674",
    period: 200
  });

  weather.on("data", () => {
    const {
      celsius,
      fahrenheit,
      kelvin,
      pressure,
      relativeHumidity,
      lightLevel
    } = weather;

    console.log("celsius: %d°C", celsius);
    console.log("fahrenheit: %d°F", fahrenheit);
    console.log("kelvin: %d°K", kelvin);
    console.log("pressure: %d kPa", pressure);
    console.log("relativeHumidity: %d RH", relativeHumidity);
    console.log("lightLevel: %d%", lightLevel);
    console.log("----------------------------------------");
  });
});

(With a specified elevation)

const Particle = require("particle-io");
const five = require("johnny-five");
const Weather = require("j5-sparkfun-weather-shield")(five);
const board = new five.Board({
  io: new Particle({
    token: process.env.PARTICLE_TOKEN,
    deviceId: process.env.PARTICLE_PHOTON_DEVICE_ID
  })
});

board.on("ready", () => {
  const weather = new Weather({
    variant: "DEV-13674",
    period: 200,
    // Set your base elevation with a value in meters,
    // as reported by http://www.whatismyelevation.com/.
    // `5` is the elevation (meters) of the
    // Bocoup office in downtown Boston
    elevation: 5,  
  });

  // Including elevation for altitude readings will
  // incure an additional 3 second calibration time.
  weather.on("data", () => {
    const {
      celsius,
      fahrenheit,
      kelvin,
      pressure,
      feet,
      meters,
      relativeHumidity,
      lightLevel
    } = weather;

    console.log("celsius: %d°C", celsius);
    console.log("fahrenheit: %d°F", fahrenheit);
    console.log("kelvin: %d°K", kelvin);
    console.log("pressure: %d kPa", pressure);
    console.log("feet: %d'", feet);
    console.log("meters: %d", meters);
    console.log("relativeHumidity: %d RH", relativeHumidity);
    console.log("lightLevel: %d%", lightLevel);
    console.log("----------------------------------------");
  });
});

Convenient serialization for data payloads:

const weather = new Weather({
  variant: ...
});

weather.on("data", () => {
  console.log(JSON.stringify(weather, null, 2));
});

Produces:

{
  "celsius": 24,
  "fahrenheit": 75.2,
  "kelvin": 297.15,
  "pressure": 125.5,
  "feet": 3.28,
  "meters": 1,
  "relativeHumidity": 48,
  "lightLevel": 50
}

Since the Photon shield does not include the ALS-PT19 light sensor, the lightLevel property will always be null for that variant.

NOTE

The examples shown here are provided for illustration and do no specifically indicate variant support. This component class is expected to work with any variant that has I2C support.

j5-sparkfun-weather-shield's People

Contributors

rwaldron avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.