Simple access to buzz buzzers
npm install buzz-buzzersnpm install buzz-buzzersThen you can use this library like this:
js
var buzzBuzzers = require('buzzBuzzers');
var buzzers = buzzBuzzers(); // initialize buzzers// Get notified when a button is pressed
buzzers.onPress(function(ev) {
// ev is an object with two attributes:
// - controller: Number from 1 to 4
// - button: Number from 0 to 4. 0 is the big red button.
console.log('Button ' + ev.button + ' on controller ' + ev.controller + ' pressed');
});
// Get notified when a button is released
buzzers.onRelease(function(ev) {
console.log('Button ' + ev.button + ' on controller ' + ev.controller + ' released');
});
// Get notified whenever something changes
buzzers.onChange(function(state) {
// state is an array of booleans with all buttons
// false means the button is not pressed
// and true when a button is pressed
/* An example could look like this, in this case the second color button
of controller 2 was pressed and the big red button on controller four is pressed
[
false, false, false, false, false, // first controller
false, false, true, false, false, // second controller
false, false, false, false, false, // third controller
true, false, false, false, false // fourth controller
]
*/
});
// Get notified when an error happens
buzzers.onError(function(err) {
console.log('Error: ', err);
});
// Remove event listeners
// To remove a listener just call removeEventListener
// possible first parameter values are: press, release, change, error
buzzers.removeEventListener('press', callback);
// Make a buzzer light up
// this only works on the buzzers with an LED
buzzers.setLeds(true, false, false, false); // light up controller number 1
buzzers.setLeds(true, true, false, true); // light up all controllers except for number 3
`API
First you have to initialize the buzzers:
now has the following API:$3
Register a callback that is called whenever a button is pressed. It will be called with an event object in this format:`
{
controller: 1, // which controller/buzzer was used. Number form 1-4
button: 0 // Which button was pressed. Number from 0 to 4. 0 is the big red button
}
$3
Register a callback that is called whenever a button is released. It will be called with an event object in this format:
{
controller: 1, // which controller/buzzer was used. Number form 1-4
button: 0 // Which button was pressed. Number from 0 to 4. 0 is the big red button
}
$3
Register a callback that is called whenever any button changes it's state. Callback will be called with an array in the format
[
false, false, false, false, false, // buttons 0-4 of the first controller. true means pressed
false, false, true, false, false, // second controller
false, false, false, false, false, // third controller
true, false, false, false, false // fourth controller
]
$3
Register a callback that is called when an error happens$3
To light up the red LEDs of a buzzer. Pass in to switch a light on and false to switch it off. Note that this does not work on some older buzz-buzzers since they don't have an LED. For those devices onError will be called when you call setLedsHints on pairing the wireless buzz buzzers
First plug in the USB dongle. Next take your first controller and move the switch to the upper position and hold it like that until the blue led at the bottom lights up. Repeat this step for all controllers. When done press the button on your USB dongle and hold it until the blue LED lights up.
Then release the button and press it once more. Now you can start your node program to access the buzzer.Changelog
$3
- Some buzzer devices seem to use a different vendorId/productId and connecting the buzzers failed. Now is additionally searching for the name Buzz of connected usb devices if a device with could not be found by vendorId/productId. See: https://github.com/functino/buzz-buzzers/pull/3- Update of all dependencies
$3
Update of all dependencies.$3
Older devices (e.g. the non wireless version for playstation 2) don't allow lighting up the LEDs. Previously calling setLeds` lead to a crash - now we catch those cases and call the error callback.