motor.ts

/*！
 * @file pxt-micro-IOBOX/main.ts
 * @brief DFRobot's microbit motor drive makecode library.
 * @n [Get the module here](http://www.dfrobot.com.cn/index.php)
 * @n This is the microbit special motor drive library, which realizes control 
 *    of the eight-channel steering gear, two-step motor and four-way dc motor.
 *
 * @copyright	[DFRobot](http://www.dfrobot.com), 2016
 * @copyright	MIT Lesser General Public License
 *
 * @author [email](xin.li@dfrobot.com)
 * @version  V0.1
 * @date  2018-11-16
 */

/**
 * The user selects the 4-way dc motor.
 */
enum Motors {
    M1 = 0x00,
    M2 = 0x01,
    //% blockId="All" block="M1+M2"
    All = 0x02
}

/**
 * The user defines the motor rotation direction.
 */
enum Dir {
    //% blockId="CW" block="CW"
    CW = 0x00,
    //% blockId="CCW" block="CCW"
    CCW = 0x01
}
/**
 * The user defines the motor rotation direction.
 */
enum OnOff {
    //% blockId="ON" block="ON"
    ON = 0x01,
    //% blockId="OFF" block="OFF"
    OFF = 0x00
}

//% weight=10 color=#DF6721 icon="\uf013"
namespace keyboard {
    const address = 0x10

    /**
	 * Execute a motor
     * M1~M2.
     * speed(0~255).
    */
    //% weight=20
    //% blockId=motor_motorRun block="Motor|%index|dir|%Dir|speed|%speed"
    //% speed.min=0 speed.max=255
    //% index.fieldEditor="gridpicker" index.fieldOptions.columns=1
    //% direction.fieldEditor="gridpicker" direction.fieldOptions.columns=1
    export function motorRun(index: Motors, direction: Dir, speed: number): void {
        let buf = pins.createBuffer(3);
        if (index == 0) {
            buf[0] = 0x00;
            buf[1] = direction;
        }
        if (index == 1) {
            buf[0] = 0x02;
            buf[1] = direction;
        }
        buf[2] = speed;
        pins.i2cWriteBuffer(address, buf);
    }

    /**
	 * Stop the dc motor.
    */
    //% weight=19
    //% blockId=motor_motorStop block="Motor stop|%index"
    //% index.fieldEditor="gridpicker" index.fieldOptions.columns=1
    export function motorStop(index: Motors) {
        let buf = pins.createBuffer(3);
        buf[1] = 0;
        buf[2] = 0;
        if (index == 0) {
            buf[0] = 0x00;
        } else if (index == 1) {
            buf[0] = 0x02;
        } else {
            buf[0] = 0x00;
            pins.i2cWriteBuffer(address, buf);
            buf[0] = 0x02;
        }
        pins.i2cWriteBuffer(address, buf);
    }

    //% weight=17
    //% blockId=motor_vibrationMotor block="Vibration Motor |%on"
    export function vibrationMotor(on: OnOff): void {
        let buf = pins.createBuffer(2);
        buf[0] = 0x0A;
        if (on == 1) {
            buf[1] = 1;
        } else {
            buf[1] = 0;
        }
        pins.i2cWriteBuffer(address, buf);
    }
}