sparkfun / pxt-moto-bit

MakeCode package for the SparkFun Moto:Bit board - beta

Moto:bit

The package adds support for the moto:bit add-on board from SparkFun.

TODO: To use this package, go to https://pxt.microbit.org, click Add package and search for moto-bit.

~ hint

Not currently integrated into pxt. It must be manually added. This package is still under development and subject to changes.

~

Usage

The package adds support for the moto:bit add-on board from SparkFun.

• moto:bit
• Shadow Chasis
• Hobby Gearmotor
• Wheel Pair
• RedBot Sensor - Line Follower
• ine Follower Array
• RedBot Sensor - Mechanical Bumper
• Servo Extention Cable

Micro:bit Pins Used

The following micro:bit pins are used for analog and digital sensors, motor driving:

• P0 -- Analog Input 0
• P1 -- Analog Input 1
• P2 -- Analog Input 2
• P8 -- Digital Input/Output
• P12 -- Digital Input/Output
• P14 -- Digital Input/Output
• P15 -- Servo Motor
• P16 -- Servo Motor
• P19 -- motor driver - SCL
• P20 -- motor driver - SDA

Set Motor Speed

To set the speed and direction for a motor, place the |set motor| block. The block takes three parameters: motor select, direction, and speed.

• The motor select must be either Left or Right
• Direction must be either Forward or Reverse
• Speed is an integer value between 0 and 100

motobit.setMotorSpeed(Motor.Left, MotorDirection.Forward, 50)

Invert Motor Directon

When a motor turns opposite to the direction that was declared, the invert block may be used. The block accepts two parameters: motor select, and a boolean variable. When the boolean is set to true, the motor direction is inverted so that Forward no longer causes the motor to spin in Reverse, but rather Forward.

• The motor select must be either Left or Right
• Invert must be either true or false

motobit.invert(Motor.Left, true)

Enabling Motors

Regardless of the set motor speed, before the motors will turn on the switch on moto:bit must be set to "Run Motors", and the enable motors command must be set to ON

• Motor enable must be either On or Off.

motobit.enable(MotorPower.On)

Examples

Example: Receiving a packet of data over wireless

The following program reads a string to control the direction of two motors.

radio.onDataPacketReceived( ({ receivedNumber }) =>  {
    // Drive forward
    if (receivedNumber == 128) {
        led.plot(2, 0)
        motobit.setMotorSpeed(Motor.Left, MotorDirection.Forward, 50)
        motobit.setMotorSpeed(Motor.Right, MotorDirection.Forward, 50)
        motobit.enable(MotorPower.On)
    } else {
        led.unplot(2, 0)
    }
    // Turn left
    if (receivedNumber == 64) {
        led.plot(0, 2)
        motobit.setMotorSpeed(Motor.Left, MotorDirection.Reverse, 50)
        motobit.setMotorSpeed(Motor.Right, MotorDirection.Forward, 50)
        motobit.enable(MotorPower.On)
    } else {
        led.unplot(0, 2)
    }
    // Turn right
    if (receivedNumber == 32) {
        led.plot(4, 2)
        motobit.setMotorSpeed(Motor.Left, MotorDirection.Forward, 50)
        motobit.setMotorSpeed(Motor.Right, MotorDirection.Reverse, 50)
        motobit.enable(MotorPower.On)
    } else {
        led.unplot(4, 2)
    }
    // Drive in reverse
    if (receivedNumber == 16) {
        led.plot(2, 4)
        motobit.setMotorSpeed(Motor.Left, MotorDirection.Reverse, 50)
        motobit.setMotorSpeed(Motor.Right, MotorDirection.Reverse, 50)
        motobit.enable(MotorPower.On)
    } else {
        led.unplot(2, 4)
    }
    // Stop
    if (receivedNumber == 0) {
        motobit.enable(MotorPower.Off)
    }
})
radio.setGroup(13)

License

MIT

Supported targets

• for PXT/microbit

motobit=github:sparkfun/pxt-moto-bit

pxt-moto-bit's Issues

Adding package returns error

Adding https://github.com/sparkfun/pxt-moto-bit via URl or search returns a "network request failed" error

can't control motors independently

The code below causes BOTH left and right motors to spin. Switching to LEFT produces the same result. It seems that whichever motor I select, both motors spin.

`input.onButtonPressed(Button.A, function () {
motobit.enable(MotorPower.On)
motobit.setMotorSpeed(Motor.Right, MotorDirection.Forward, 50)
basic.pause(2000)
motobit.enable(MotorPower.Off)
})
basic.forever(function () {

})`

Description error

Error in the description, it says "... weather:bit board...", but It should say "... moto:bit board...".

icon.png should be light

Currently 2.45Mb, this image as light (kb) as possible.

Add travis-ci support

Would be great to enable Travis build on this repo as well.

Add release

Please use pxt bump to create a release for this package.