pxt-grove/README.md

64 lines
1.2 KiB
Markdown
Raw Normal View History

2017-06-23 03:54:44 +02:00
# Grove
A Microsoft MakeCode package for for Seeed Studio Grove module.
## Basic usage
Grove - Gesture
```blocks
// Create gesture events
grove.onGesture(GroveGesture.Up, () => {
basic.showString("Up")
})
grove.onGesture(GroveGesture.Down, () => {
basic.showString("Down")
})
```
Grove - Ultrasonic Ranger
```blocks
// Measure distance in centimeters, specify the signal pin
2017-06-28 07:39:51 +02:00
let distance = grove.measureInCentimeters(DigitalPin.P0);
2017-06-23 03:54:44 +02:00
// Measure distance in inches, specify the signal pin
2017-06-28 07:39:51 +02:00
let distance = grove.measureInInches(DigitalPin.P0);
2017-06-23 03:54:44 +02:00
```
Grove - 4 digital display
```blocks
// Create a 4 Digital Display driver, specify the clk and data pin
2017-06-28 07:39:51 +02:00
let display = grove.createDisplay(DigitalPin.P0, DigitalPin.P1);
2017-06-23 03:54:44 +02:00
// Set the brightness level
2017-06-28 07:39:51 +02:00
display.set(7);
2017-06-23 03:54:44 +02:00
// Start display value
display.show(1234);
```
## More operation
Grove - 4 digital display
```blocks
// After create a 4 Digital Display driver, it can display number "1234" one by one
2017-06-28 07:39:51 +02:00
display.bit(1, 0);
display.bit(2, 1)
display.bit(3, 2);
display.bit(4, 3)
2017-06-23 03:54:44 +02:00
```
Use ``point()`` to open or close point dispay.
Use ``clear()`` to clean display.
## License
MIT
## Supported targets
* for PXT/microbit
(The metadata above is needed for package search.)