This commit is contained in:
WayenWeng 2017-06-23 09:54:44 +08:00
parent 90ea1672d5
commit 2e1417b777
6 changed files with 571 additions and 0 deletions

10
Makefile Normal file
View File

@ -0,0 +1,10 @@
all: deploy
build:
pxt build
deploy:
pxt deploy
test:
pxt test

63
README.md Normal file
View File

@ -0,0 +1,63 @@
# 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
let distance = Grove_Ultrasonic_Ranger.measureInCentimeters(DigitalPin.P0);
// Measure distance in inches, specify the signal pin
let distance = Grove_Ultrasonic_Ranger.measureInInches(DigitalPin.P0);
```
Grove - 4 digital display
```blocks
// Create a 4 Digital Display driver, specify the clk and data pin
let display = Grove_4_Digital_Display.create(DigitalPin.P0, DigitalPin.P1);
// Set the brightness level
display.set(BrightnessLevel.LEVEL_7);
// 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
display.bit(0, 1);
display.bit(1, 2)
display.bit(2, 3);
display.bit(3, 4)
```
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.)

417
main.ts Normal file
View File

@ -0,0 +1,417 @@
const initRegisterArray: number[] = [
0xEF, 0x00, 0x32, 0x29, 0x33, 0x01, 0x34, 0x00, 0x35, 0x01, 0x36, 0x00, 0x37, 0x07, 0x38, 0x17,
0x39, 0x06, 0x3A, 0x12, 0x3F, 0x00, 0x40, 0x02, 0x41, 0xFF, 0x42, 0x01, 0x46, 0x2D, 0x47, 0x0F,
0x48, 0x3C, 0x49, 0x00, 0x4A, 0x1E, 0x4B, 0x00, 0x4C, 0x20, 0x4D, 0x00, 0x4E, 0x1A, 0x4F, 0x14,
0x50, 0x00, 0x51, 0x10, 0x52, 0x00, 0x5C, 0x02, 0x5D, 0x00, 0x5E, 0x10, 0x5F, 0x3F, 0x60, 0x27,
0x61, 0x28, 0x62, 0x00, 0x63, 0x03, 0x64, 0xF7, 0x65, 0x03, 0x66, 0xD9, 0x67, 0x03, 0x68, 0x01,
0x69, 0xC8, 0x6A, 0x40, 0x6D, 0x04, 0x6E, 0x00, 0x6F, 0x00, 0x70, 0x80, 0x71, 0x00, 0x72, 0x00,
0x73, 0x00, 0x74, 0xF0, 0x75, 0x00, 0x80, 0x42, 0x81, 0x44, 0x82, 0x04, 0x83, 0x20, 0x84, 0x20,
0x85, 0x00, 0x86, 0x10, 0x87, 0x00, 0x88, 0x05, 0x89, 0x18, 0x8A, 0x10, 0x8B, 0x01, 0x8C, 0x37,
0x8D, 0x00, 0x8E, 0xF0, 0x8F, 0x81, 0x90, 0x06, 0x91, 0x06, 0x92, 0x1E, 0x93, 0x0D, 0x94, 0x0A,
0x95, 0x0A, 0x96, 0x0C, 0x97, 0x05, 0x98, 0x0A, 0x99, 0x41, 0x9A, 0x14, 0x9B, 0x0A, 0x9C, 0x3F,
0x9D, 0x33, 0x9E, 0xAE, 0x9F, 0xF9, 0xA0, 0x48, 0xA1, 0x13, 0xA2, 0x10, 0xA3, 0x08, 0xA4, 0x30,
0xA5, 0x19, 0xA6, 0x10, 0xA7, 0x08, 0xA8, 0x24, 0xA9, 0x04, 0xAA, 0x1E, 0xAB, 0x1E, 0xCC, 0x19,
0xCD, 0x0B, 0xCE, 0x13, 0xCF, 0x64, 0xD0, 0x21, 0xD1, 0x0F, 0xD2, 0x88, 0xE0, 0x01, 0xE1, 0x04,
0xE2, 0x41, 0xE3, 0xD6, 0xE4, 0x00, 0xE5, 0x0C, 0xE6, 0x0A, 0xE7, 0x00, 0xE8, 0x00, 0xE9, 0x00,
0xEE, 0x07, 0xEF, 0x01, 0x00, 0x1E, 0x01, 0x1E, 0x02, 0x0F, 0x03, 0x10, 0x04, 0x02, 0x05, 0x00,
0x06, 0xB0, 0x07, 0x04, 0x08, 0x0D, 0x09, 0x0E, 0x0A, 0x9C, 0x0B, 0x04, 0x0C, 0x05, 0x0D, 0x0F,
0x0E, 0x02, 0x0F, 0x12, 0x10, 0x02, 0x11, 0x02, 0x12, 0x00, 0x13, 0x01, 0x14, 0x05, 0x15, 0x07,
0x16, 0x05, 0x17, 0x07, 0x18, 0x01, 0x19, 0x04, 0x1A, 0x05, 0x1B, 0x0C, 0x1C, 0x2A, 0x1D, 0x01,
0x1E, 0x00, 0x21, 0x00, 0x22, 0x00, 0x23, 0x00, 0x25, 0x01, 0x26, 0x00, 0x27, 0x39, 0x28, 0x7F,
0x29, 0x08, 0x30, 0x03, 0x31, 0x00, 0x32, 0x1A, 0x33, 0x1A, 0x34, 0x07, 0x35, 0x07, 0x36, 0x01,
0x37, 0xFF, 0x38, 0x36, 0x39, 0x07, 0x3A, 0x00, 0x3E, 0xFF, 0x3F, 0x00, 0x40, 0x77, 0x41, 0x40,
0x42, 0x00, 0x43, 0x30, 0x44, 0xA0, 0x45, 0x5C, 0x46, 0x00, 0x47, 0x00, 0x48, 0x58, 0x4A, 0x1E,
0x4B, 0x1E, 0x4C, 0x00, 0x4D, 0x00, 0x4E, 0xA0, 0x4F, 0x80, 0x50, 0x00, 0x51, 0x00, 0x52, 0x00,
0x53, 0x00, 0x54, 0x00, 0x57, 0x80, 0x59, 0x10, 0x5A, 0x08, 0x5B, 0x94, 0x5C, 0xE8, 0x5D, 0x08,
0x5E, 0x3D, 0x5F, 0x99, 0x60, 0x45, 0x61, 0x40, 0x63, 0x2D, 0x64, 0x02, 0x65, 0x96, 0x66, 0x00,
0x67, 0x97, 0x68, 0x01, 0x69, 0xCD, 0x6A, 0x01, 0x6B, 0xB0, 0x6C, 0x04, 0x6D, 0x2C, 0x6E, 0x01,
0x6F, 0x32, 0x71, 0x00, 0x72, 0x01, 0x73, 0x35, 0x74, 0x00, 0x75, 0x33, 0x76, 0x31, 0x77, 0x01,
0x7C, 0x84, 0x7D, 0x03, 0x7E, 0x01
];
let TubeTab: number [] = [
0x3f, 0x06, 0x5b, 0x4f, 0x66, 0x6d, 0x7d, 0x07,
0x7f, 0x6f, 0x77, 0x7c, 0x39, 0x5e, 0x79, 0x71
];
/**
* Grove Gestures
*/
enum GroveGesture {
//% block=None
None = 0,
//% block=Right
Right = 1,
//% block=Left
Left = 2,
//% block=Up
Up = 3,
//% block=Down
Down = 4,
//% block=Forward
Forward = 5,
//% block=Backward
Backward = 6,
//% block=Clockwise
Clockwise = 7,
//% block=Anticlockwise
Anticlockwise = 8,
//% block=Wave
Wave = 9
}
/**
* Functions to operate Grove module.
*/
//% weight=10 color=#9F79EE icon="\uf108" block="Grove"
namespace grove {
const gestureEventId = 3100;
let lastGesture = GroveGesture.None;
let paj7620: PAJ7620 = undefined;
/**
* Do something when a gesture is detected by Grove - Gesture
* @param gesture type of gesture to detect
* @param handler code to run
*/
//% blockId=grove_gesture_create_event block="on Gesture|%gesture"
export function onGesture(gesture: GroveGesture, handler: Action) {
control.onEvent(gestureEventId, gesture, handler);
if (!paj7620) {
paj7620.init();
control.inBackground(() => {
const gesture = paj7620.read();
if (gesture != lastGesture) {
lastGesture = gesture;
control.raiseEvent(gestureEventId, lastGesture);
}
})
}
}
/**
* Create a new driver of Grove - Ultrasonic Sensor to measure distances in cm
* @param pin signal pin of ultrasonic ranger module
*/
//% blockId=grove_ultrasonic_centimeters block="Ultrasonic Sensor (in cm) at|%pin"
export function measureInCentimeters(pin: DigitalPin): number
{
let duration = 0;
let RangeInCentimeters = 0;
pins.digitalWritePin(pin, 0);
control.waitMicros(2);
pins.digitalWritePin(pin, 1);
control.waitMicros(5);
pins.digitalWritePin(pin, 0);
duration = pins.pulseIn(pin, PulseValue.High);
RangeInCentimeters = duration * 153 / 29 / 2 / 100;
return RangeInCentimeters;
}
/**
* Create a new driver Grove - Ultrasonic Sensor to measure distances in inch
* @param pin signal pin of ultrasonic ranger module
*/
//% blockId=grove_ultrasonic_inches block="Ultrasonic Sensor (in inch) at|%pin"
export function measureInInches(pin: DigitalPin): number
{
let duration = 0;
let RangeInCentimeters = 0;
pins.digitalWritePin(pin, 0);
control.waitMicros(2);
pins.digitalWritePin(pin, 1);
control.waitMicros(5);
pins.digitalWritePin(pin, 0);
duration = pins.pulseIn(pin, PulseValue.High);
RangeInCentimeters = duration * 153 / 74 / 2 / 100;
return RangeInCentimeters;
}
/**
* Create a new driver Grove - 4-Digit Display
* @param clkPin value of clk pin number
* @param dataPin value of data pin number
*/
//% blockId=grove_tm1637_create block="4-Digit Display at|%clkPin|and|%dataPin"
export function dislay(clkPin: DigitalPin, dataPin: DigitalPin): TM1637
{
let display = new TM1637();
display.clkPin = clkPin;
display.dataPin = dataPin;
display.brightnessLevel = 0;
display.pointFlag = false;
return display;
}
/**
*
*/
export class PAJ7620 {
private paj7620WriteReg(addr: number, cmd: number) {
let buf: Buffer = pins.createBuffer(2);
buf[0] = addr;
buf[1] = cmd;
pins.i2cWriteBuffer(0x73, buf, false);
}
private paj7620ReadReg(addr: number): number {
let buf: Buffer = pins.createBuffer(1);
buf[0] = addr;
pins.i2cWriteBuffer(0x73, buf, false);
buf = pins.i2cReadBuffer(0x73, 1, false);
return buf[0];
}
private paj7620SelectBank(bank: number) {
if (bank == 0) this.paj7620WriteReg(0xEF, 0);
else if (bank == 1) this.paj7620WriteReg(0xEF, 1);
}
private paj7620Init() {
let temp = 0;
this.paj7620SelectBank(0);
temp = this.paj7620ReadReg(0);
if (temp == 0x20) {
for (let i = 0; i < 438; i += 2) {
this.paj7620WriteReg(initRegisterArray[i], initRegisterArray[i + 1]);
}
}
this.paj7620SelectBank(0);
}
/**
* Create a new driver of Grove - Gesture
*/
//% blockId=grove_gesture_init block="%strip|initiate the Grove - Gesture"
//% advanced=true
init() {
this.paj7620Init();
basic.pause(200);
}
/**
* Detect and recognize the gestures from Grove - Gesture
*/
//% blockId=grove_gesture_read block="%strip|get gesture"
//% advanced=true
read(): number {
let data = 0, result = 0;
data = this.paj7620ReadReg(0x43);
switch (data) {
case 0x01:
result = GroveGesture.Right;
break;
case 0x02:
result = GroveGesture.Left;
break;
case 0x04:
result = GroveGesture.Up;
break;
case 0x08:
result = GroveGesture.Down;
break;
case 0x10:
result = GroveGesture.Forward;
break;
case 0x20:
result = GroveGesture.Backward;
break;
case 0x40:
result = GroveGesture.Clockwise;
break;
case 0x80:
result = GroveGesture.Anticlockwise;
break;
default:
data = this.paj7620ReadReg(0x44);
if (data == 0x01)
result = GroveGesture.Wave;
break;
}
return result;
}
}
/**
*
*/
export class TM1637
{
clkPin: DigitalPin;
dataPin: DigitalPin;
brightnessLevel: number;
pointFlag: boolean;
private writeByte(wrData: number)
{
for(let i = 0; i < 8; i ++)
{
pins.digitalWritePin(this.clkPin, 0);
if(wrData & 0x01)pins.digitalWritePin(this.dataPin, 1);
else pins.digitalWritePin(this.dataPin, 0);
wrData >>= 1;
pins.digitalWritePin(this.clkPin, 1);
}
pins.digitalWritePin(this.clkPin, 0); // Wait for ACK
pins.digitalWritePin(this.dataPin, 1);
pins.digitalWritePin(this.clkPin, 1);
}
private start()
{
pins.digitalWritePin(this.clkPin, 1);
pins.digitalWritePin(this.dataPin, 1);
pins.digitalWritePin(this.dataPin, 0);
pins.digitalWritePin(this.clkPin, 0);
}
private stop()
{
pins.digitalWritePin(this.clkPin, 0);
pins.digitalWritePin(this.dataPin, 0);
pins.digitalWritePin(this.clkPin, 1);
pins.digitalWritePin(this.dataPin, 1);
}
private coding(dispData: number): number
{
let pointData = 0;
if(this.pointFlag == true)pointData = 0x80;
else if(this.pointFlag == false)pointData = 0;
if(dispData == 0x7f)dispData = 0x00 + pointData;
else dispData = TubeTab[dispData] + pointData;
return dispData;
}
/**
* Show a 4 digits number on display
* @param dispData value of number
*/
//% blockId=grove_tm1637_display_number block="%strip|show number|%dispData"
show(dispData: number)
{
if(dispData < 10)
{
this.bit(3, dispData);
this.bit(2, 0x7f);
this.bit(1, 0x7f);
this.bit(0, 0x7f);
}
else if(dispData < 100)
{
this.bit(3, dispData % 10);
this.bit(2, (dispData / 10) % 10);
this.bit(1, 0x7f);
this.bit(0, 0x7f);
}
else if(dispData < 1000)
{
this.bit(3, dispData % 10);
this.bit(2, (dispData / 10) % 10);
this.bit(1, (dispData / 100) % 10);
this.bit(0, 0x7f);
}
else
{
this.bit(3, dispData % 10);
this.bit(2, (dispData / 10) % 10);
this.bit(1, (dispData / 100) % 10);
this.bit(0, (dispData / 1000) % 10);
}
}
/**
* Set the brightness level of display at from 0 to 7
* @param level value of brightness level
*/
//% blockId=grove_tm1637_set_display_level block="%strip|brightness level to|%level"
//% level.min=0 level.max=7
set(level: number)
{
this.brightnessLevel = level;
}
/**
* Show a single number from 0 to 9 at a specified digit of Grove - 4-Digit Display
* @param bitAddr value of bit number
* @param dispData value of number
*/
//% blockId=grove_tm1637_display_bit block="%strip|show single number|%dispData|at digit|%bitAddr"
//% bitAddr.min=0 bitAddr.max=3
//% dispData.min=0 dispData.max=9
//% advanced=true
bit(bitAddr: number, dispData: number)
{
let segData = 0;
segData = this.coding(dispData);
this.start();
this.writeByte(0x44);
this.stop();
this.start();
this.writeByte(bitAddr | 0xc0);
this.writeByte(segData);
this.stop();
this.start();
this.writeByte(0x88 + this.brightnessLevel);
this.stop();
}
/**
* Turn on or off the colon point on Grove - 4-Digit Display
* @param pointEn value of point switch
*/
//% blockId=grove_tm1637_display_point block="%strip|turn|%point|colon point"
//% advanced=true
point(point: boolean)
{
this.pointFlag = point;
}
/**
* Clear the display
*/
//% blockId=grove_tm1637_display_clear block="%strip|clear"
//% advanced=true
clear()
{
this.bit(0x00, 0x7f);
this.bit(0x01, 0x7f);
this.bit(0x02, 0x7f);
this.bit(0x03, 0x7f);
}
}
}

17
pxt.json Normal file
View File

@ -0,0 +1,17 @@
{
"name": "Grove",
"version": "0.1.0",
"description": "A Microsoft MakeCode package for Seeed Studio Grove module",
"license": "MIT",
"dependencies": {
"core": "*"
},
"files": [
"README.md",
"main.ts"
],
"testFiles": [
"test.ts"
],
"public": true
}

55
test.ts Normal file
View File

@ -0,0 +1,55 @@
grove.onGesture(GroveGesture.Up, () => {
basic.showString("U")
})
grove.onGesture(GroveGesture.Down, () => {
basic.showString("D")
})
grove.onGesture(GroveGesture.Right, () => {
basic.showString("R")
})
grove.onGesture(GroveGesture.Left, () => {
basic.showString("L")
})
grove.onGesture(GroveGesture.Wave, () => {
basic.showString("W")
})
grove.onGesture(GroveGesture.Clockwise, () => {
basic.showString("C")
})
grove.onGesture(GroveGesture.Anticlockwise, () => {
basic.showString("A")
})
{
let display = grove.dislay(DigitalPin.P2, DigitalPin.P16);
let data = 0;
display.point(true);
display.clear();
display.bit(3, 3);
basic.pause(500);
display.point(false);
display.clear();
display.bit(2, 2);
basic.pause(500);
display.point(true);
display.clear();
display.bit(1, 1);
basic.pause(500);
display.point(false);
display.clear();
display.bit(0, 0);
basic.pause(500);
display.set(7);
while(true)
{
display.show(data ++);
let distance = grove.measureInCentimeters(DigitalPin.P0);
basic.showNumber(distance);
basic.pause(500);
}
}

9
tsconfig.json Normal file
View File

@ -0,0 +1,9 @@
{
"compilerOptions": {
"target": "es5",
"noImplicitAny": true,
"outDir": "built",
"rootDir": "."
},
"exclude": ["pxt_modules/**/*test.ts"]
}