New paradigm for handling attached devices

examples/new_device_test.js

@@ -0,0 +1,57 @@
+/*
+ *
+ * This demonstrates connecting multiple hubs to your laptop. Once connected, all the hubs LED lights will cycle through the same colors simultaneously.
+ *
+ */
+
+const PoweredUP = require("..");
+
+const poweredUP = new PoweredUP.PoweredUP();
+poweredUP.scan(); // Start scanning for hubs
+
+console.log("Looking for Hubs...");
+
+poweredUP.on("discover", async (hub) => { // Wait to discover hubs
+
+    await hub.connect(); // Connect to hub
+    console.log(`Connected to ${hub.name}!`);
+
+    hub.on("attach", async (device) => {
+
+        console.log(`Attached device ${device.type} to ${device.port}`)
+
+        if (device instanceof PoweredUP.ControlPlusLargeMotor) {
+            const motor = device;
+
+            motor.on("rotate", (angle) => {
+                console.log(`Rotate ${angle}`);
+            });
+
+            await motor.rotateByAngle(9000, 50);
+            await motor.rotateByAngle(9000, -50);
+            await motor.rotateByAngle(9000, 50);
+            await motor.rotateByAngle(9000, -50);
+            motor.power(100);
+        }
+
+        if (device instanceof PoweredUP.ColorDistanceSensor) {
+            const sensor = device;
+            sensor.on("distance", (distance) => { // Adding an event handler for distance automatically subscribes to distance notifications
+                console.log(`Distance ${distance}`);
+            });
+            sensor.on("color", (color) => {
+                console.log(`Color ${color}`);
+            });
+        }
+
+        device.on("detach", () => {
+            console.log(`Detached device ${device.type} from ${device.port}`)
+        })
+
+    });
+
+    hub.on("disconnect", () => {
+        console.log("Hub disconnected");
+    })
+
+});

examples/winter_village_train.js

@@ -0,0 +1,60 @@
+/*
+ *
+ * This runs the train under our Christmas tree. It uses the 10254 Winter Holiday Train retrofitted with a Powered UP hub and train motor.
+ * It also uses a WeDo 2.0 hub with Powered UP distance sensor to detect the train approaching the station and slow it down.
+ * 
+ * Note that if you want to use this yourself you don't need to use a WeDo 2.0 hub, you can use any hub that can accept a distance or color/distance sensor.
+ * 
+ * The maximum speed of the train is set to a constant 50. A further improvement can be made by scaling the speed up according to the current battery voltage,
+ * so the speed doesn't slow as the battery starts dying.
+ *
+ */
+
+const PoweredUP = require("..");
+
+const poweredUP = new PoweredUP.PoweredUP();
+poweredUP.scan(); // Start scanning for hubs
+
+console.log("Looking for Hubs...");
+
+let train = null;
+let sensor = null;
+
+let ramping = false;
+
+poweredUP.on("discover", async (hub) => { // Wait to discover hubs
+
+    if (hub.name === "NK_Winter_Train") {
+        await hub.connect(); // Connect to hub
+        console.log(`Connected to train!`);
+        train = hub;
+    } else if (hub.name === "NK_Winter_Sensor") {
+        await hub.connect(); // Connect to hub
+        console.log(`Connected to sensor!`);
+        sensor = hub;
+
+        sensor.on("distance", (_, distance) => {
+            if (distance < 5 && !ramping) {
+                await stopTrain();
+            }
+        });
+
+    }
+
+    if (train && sensor) {
+        console.log("Train and sensor connected, starting!");
+        await startTrain();
+    }
+
+});
+
+const startTrain =  async () => {
+    ramping = true;
+    await train.rampMotorSpeed("A", 0, 50, 2000);
+    ramping = false;
+}
+
+const stopTrain = async () => {
+    ramping = true;
+    await train.rampMotorSpeed("A", 50, 0, 2000);
+}

src/basicmotor.ts

@@ -0,0 +1,41 @@
+import { Device } from "./device";
+import { Hub } from "./hub";
+
+import * as Consts from "./consts";
+
+import { mapSpeed } from "./utils";
+
+export class BasicMotor extends Device {
+
+
+    constructor (hub: Hub, portId: number, type: number = Consts.DeviceType.UNKNOWN) {
+        super(hub, portId, type);
+    }
+
+
+    /**
+     * Set the motor speed.
+     * @method BasicMotor#power
+     * @param {number} power For forward, a value between 1 - 100 should be set. For reverse, a value between -1 to -100. Stop is 0.
+     * @returns {Promise} Resolved upon successful completion of command.
+     */
+    public power (power: number) {
+        return new Promise((resolve) => {
+            const data = Buffer.from([0x81, this.portId, 0x11, 0x51, 0x00, mapSpeed(power)]);
+            this.send(data);
+            return resolve();
+        });
+    }
+
+
+    /**
+     * Fully (hard) stop the motor.
+     * @method BasicMotor#brake
+     * @returns {Promise} Resolved upon successful completion of command.
+     */
+    public brake () {
+        return this.power(127);
+    }
+
+
+}