Javascript Example

Device Compatibility


The Servo driver can set the angle of your servos through the pins of your MATRIX device.

Device Pinouts:

Available ZeroMQ Ports

  • Base port: 20045
  • Error port: 20047

Code Example

The following sections show how to implement a connection to each of the Servo driver's ports. You can download this example here.

Initial Variables

Before we go into connecting to each port, the variables defined below are needed in order to access the ZeroMQ and MATRIX Protocol Buffer libraries for Javascript. We also define a few helpful variables for easy references.

var zmq = require('zeromq');// Asynchronous Messaging Framework
var matrix_io = require('matrix-protos').matrix_io;// Protocol Buffers for MATRIX function
var matrix_ip = '';// Local IP
var matrix_servo_base_port = 20045;// Port for Servo driver

Base Port

Here is where the configuration for our servo example goes. Once we connect to the Base Port, We will pass a configuration to the servo driver. With this we can choose the pin we want to edit and the angle to set for it. This example will send random numbers to any servo attached to pin 0.

// Create a Pusher socket
var configSocket = zmq.socket('push');
// Connect Pusher to Base port
configSocket.connect('tcp://' + matrix_ip + ':' + matrix_servo_base_port);
// Create driver configuration
var config = matrix_io.malos.v1.driver.DriverConfig.create({
// Create servo configuration
    pin: 0,// Use pin 0
    angle: 0// Set angle 0
// Loop every second
// Pick number from 1-180
var angle = Math.floor(Math.random() * 180)+1;
// Set number as new random angle
config.servo.angle = angle;
// Log angle
// Send driver configuration
}, 1000);
Error Port

Connecting to the Error Port is optional, but highly recommended if you want to log any errors that occur within MATRIX CORE.

// Create a Subscriber socket
var errorSocket = zmq.socket('sub');
// Connect Subscriber to Error port
errorSocket.connect('tcp://' + matrix_ip + ':' + (matrix_servo_base_port + 2));
// Connect Subscriber to Error port
// On Message
errorSocket.on('message', function(error_message){
console.log('Error received: ' + error_message.toString('utf8'));// Log error