j5-rc-receiver

0.0.4 • Public • Published

Receiver

Build Status

RC Receiver component plugin for Johnny-Five.

API & Documentation

Receiver

The Receiver class constructs objects that represent a single RC Receiver component.

var receiver = new Receiver();
 
receiver.on("change", function() {
  console.log(this.x, this.y);
});

Options

Property Type Value(s)/Description Default Required
address number Address for I2C device * 0x0A no
channels number Number of channels 6 no
channels array Array of channel names ** ** no
// Example of explicitly specified address
var receiver = new Receiver({
  address: 0x04
});

* The I2C address defaults to 0x0A, however digital pins 10 & 11 can be used to configure the address, according to the following table:

D11 D12 Address
0 0 0x0A
0 1 0x0B
1 0 0x0C
1 1 0x0D

** The built-in channel names are derived from the most commonly used names in the most common order:

  1. throttle
  2. aileron
  3. elevator
  4. rudder
  5. gear
  6. aux1
  7. aux2
  8. aux3

When channels: [...] are specified, the length is used to set the channel count and the names provided are used to override the above listed names.

Properties

Property Type Value(s)/Description
1-n number Each channel value is accessible via numeric channel property. These are NOT zero-indexed

Iterable/Iterator Protocol

For code running in Node.js 4.2.x or newer, Receiver objects implement the Iterable Protocol.

var receiver = new Receiver();
 
// Create a zero-indexed array of receiver's current values:
var array = Array.from(receiver);

Events

  • change Fired whenever any channel value changes.

  • change:[name] Fired whenever the channel matching [name] changes.

    receiver.on("change", function(change) {
      console.log("Channel(%d): %d", change.channel, change.value);
    });
    receiver.on("change:throttle", function(change) {
      console.log("Throttle: %d", change.value);
    });
  • data Fired as frequently as the hardware can be read.

Backpack Controller

Install Firmware

Using the Arduino IDE, install the firmware to your AVR based microcontroller of choice.

Assembly

RC Receiver, I2C Nano Backpack

Connect To I2C Capable Platform

Arduino UNO

RC Receiver, I2C Nano Backpack + Arduino Uno

var five = require("johnny-five");
var Receiver = require("j5-rc-receiver")(five);
var board = new five.Board();
 
board.on("ready", function() {
  var receiver = new Receiver();
 
  receiver.on("change", function(change) {
    console.log("Channel(%d): %d", change.channel, change.value);
  });
});

Tessel 2

RC Receiver, I2C Nano Backpack + Tessel 2

RC Receiver, I2C Mini Backpack + Tessel 2

var five = require("johnny-five");
var Receiver = require("j5-rc-receiver")(five);
var Tessel = require("tessel-io");
var board = new five.Board({
  io: new Tessel()
});
 
board.on("ready", function() {
  var receiver = new Receiver({
    // Tessel-IO allow omitting the bus when using Port A, 
    // but for illustrative purposes, we specify it here...
    bus: "A"
  });
 
  receiver.on("change", function(change) {
    console.log("Channel(%d): %d", change.channel, change.value);
  });
});

Intel Edison MiniBoard

RC Receiver, I2C Mini Backpack + Intel Edison MiniBoard

Intel Edison Arduino Board

RC Receiver, I2C Nano Backpack + Intel Edison Arduino Board

var five = require("johnny-five");
var Receiver = require("j5-rc-receiver")(five);
var Edison = require("edison-io");
var board = new five.Board({
  io: new Edison()
});
 
board.on("ready", function() {
  var receiver = new Receiver();
 
  receiver.on("pointermove", function() {
    console.log({ x: this.x, y: this.y });
  });
});

Flight Simulator

Coming soon?

NOTE

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

Package Sidebar

Install

npm i j5-rc-receiver

Weekly Downloads

2

Version

0.0.4

License

MIT

Last publish

Collaborators

  • rwaldron