The ESC class constructs objects that represent a single ESC (Electronic Speed Control) component attached to the physical board. ESC objects are similar to Servo objects as they both use PWM pins to communicate with the physical ESC. Currently, this class assumes the ESC is pre-calibrated.

See also:

Parameters

  • pin A Number or String address for the ESC pin (PWM).

    var esc = new five.ESC(9);
    
  • Options An object of property parameters.

    PropertyTypeValue/ DescriptionDefaultRequired
    pinNumber, StringAny PWM Pin. The address of the PWM pin the ESC is attached toyes
    controllerStringDEFAULT, PCA9685. Controller interface type."DEFAULT"no
    pwmRangeArray[ min, max ] The pulse width range in microseconds.[1000, 2000]no
    deviceStringFORWARD, FORWARD_REVERSE. Device capability type."FORWARD"no
    neutralNumberNeutral point, usually the middle of the PWM range.Varies by deviceno

  • PCA9685 Options (controller: "PCA9685")

    PropertyTypeValue/DescriptionDefaultRequired
    addressNumberI2C device address.0x40no

Shape

Property NameDescriptionRead Only
idA user definable id value. Defaults to a generated uidNo
pinThe pin address that the ESC is attached toNo
valueThe value of the last/current speed.Yes

Component Initialization

Basic

new five.ESC(9);

ESC

ESC PCA9685

new five.ESC({
  controller: "PCA9685",
  pin: 1
});

ESC

Bidirectional

new five.ESC({
  pin: 9, 
  device: "FORWARD_REVERSE", 
});

ESC

Usage

Standard ESC

var five = require("johnny-five");
var board = new five.Board();

board.on("ready", function() {

  var esc = new five.ESC(11);
  
  board.loop(100, () => 
  esc.throttle();

});

API

  • speed(value) Deprecated. Use throttle(μs)
  • throttle(value) Throttle the speed of the ESC by setting a pulse in μs.

    var esc = new five.ESC(9);
    
    esc.throttle(1500); // 1500μs is half speed of a single direction or neutral of a bidirectional
    
  • brake() Brake the ESC

    var esc = new five.ESC(9);
    
    esc.brake();
    

Calibrating an ESC

This isn't a requirement, but if you experience issues with your ESCs, it might prove helpful

Load the following sketch onto your Arduino, via the Arduino IDE follow the instructions.

This requires that the ESC's power source is off or disconnected at the start of the calibration process. You will be prompted to turn on/reconnect the power during the process.

#include <Servo.h>

#define MAX_SIGNAL 2000
#define MIN_SIGNAL 1000
#define MOTOR_PIN 12

Servo motor;

void setup() {
  Serial.begin(9600);
  Serial.println("Program begin...");
  Serial.println("This program will calibrate the ESC.");

  motor.attach(MOTOR_PIN);

  Serial.println("Calibrating Maximum Signal");
  Serial.println("Turn on power source, then wait 2 seconds and press any key + <enter>");
  motor.writeMicroseconds(MAX_SIGNAL);

  // Wait for input
  while (!Serial.available());
  Serial.read();

  // Send min output
  Serial.println("Calibrating Minimum Signal");
  motor.writeMicroseconds(MIN_SIGNAL);

}

void loop() {  

}

Examples

Hi! The Johnny-Five community is building new projects every day. We made this newsletter to tell you about what's new, what's good, and what's next for Open Source robotics. Join us in exploring what we can make together.

Fork me on GitHub