surfacing missing repeat parameter (#380)
* surfacing missing repeat parameter * updated docs
This commit is contained in:
parent
aac5bb8619
commit
37efefdcee
@ -4,7 +4,7 @@ Read one number from the specified 7-bit I2C address, in the specified
|
|||||||
number format.
|
number format.
|
||||||
|
|
||||||
```sig
|
```sig
|
||||||
pins.i2cReadNumber(0, NumberFormat.Int8LE);
|
pins.i2cReadNumber(0, NumberFormat.Int8LE, false);
|
||||||
```
|
```
|
||||||
|
|
||||||
### Parameters
|
### Parameters
|
||||||
@ -17,6 +17,7 @@ pins.i2cReadNumber(0, NumberFormat.Int8LE);
|
|||||||
* **Int** stands for "integer", and **UInt** stands for "unsigned integer".
|
* **Int** stands for "integer", and **UInt** stands for "unsigned integer".
|
||||||
* **LE** stands for "little-endian" and **BE** stands for "big-endian".
|
* **LE** stands for "little-endian" and **BE** stands for "big-endian".
|
||||||
* The number in each format name stands for the number of bits in the format.
|
* The number in each format name stands for the number of bits in the format.
|
||||||
|
* ``repeated`` repeated start, true - don't send stop at end
|
||||||
|
|
||||||
### Example
|
### Example
|
||||||
|
|
||||||
@ -24,7 +25,7 @@ The following example reads a number in big-endian, 16-bit, unsigned integer
|
|||||||
format from the 7-bit I2C address `32`.
|
format from the 7-bit I2C address `32`.
|
||||||
|
|
||||||
```blocks
|
```blocks
|
||||||
pins.i2cReadNumber(32, NumberFormat.UInt16BE);
|
pins.i2cReadNumber(32, NumberFormat.UInt16BE, false);
|
||||||
```
|
```
|
||||||
|
|
||||||
#### ~hint
|
#### ~hint
|
||||||
|
@ -4,7 +4,7 @@ Write the specified number to the specified 7-bit I2C address in the
|
|||||||
specified number format.
|
specified number format.
|
||||||
|
|
||||||
```sig
|
```sig
|
||||||
pins.i2cWriteNumber(0, 0, NumberFormat.Int8LE);
|
pins.i2cWriteNumber(0, 0, NumberFormat.Int8LE, true);
|
||||||
```
|
```
|
||||||
|
|
||||||
### Parameters
|
### Parameters
|
||||||
@ -18,6 +18,7 @@ pins.i2cWriteNumber(0, 0, NumberFormat.Int8LE);
|
|||||||
* **Int** stands for "integer", and **UInt** stands for "unsigned integer".
|
* **Int** stands for "integer", and **UInt** stands for "unsigned integer".
|
||||||
* **LE** stands for "little-endian" and **BE** stands for "big-endian".
|
* **LE** stands for "little-endian" and **BE** stands for "big-endian".
|
||||||
* The number in each format name stands for the number of bits in the format.
|
* The number in each format name stands for the number of bits in the format.
|
||||||
|
* ``repeated`` repeated start, true - don't send stop at end
|
||||||
|
|
||||||
### Example
|
### Example
|
||||||
|
|
||||||
|
@ -250,8 +250,8 @@
|
|||||||
"pins.analogWritePin|block": "analog write|pin %name|to %value",
|
"pins.analogWritePin|block": "analog write|pin %name|to %value",
|
||||||
"pins.digitalReadPin|block": "digital read|pin %name",
|
"pins.digitalReadPin|block": "digital read|pin %name",
|
||||||
"pins.digitalWritePin|block": "digital write|pin %name|to %value",
|
"pins.digitalWritePin|block": "digital write|pin %name|to %value",
|
||||||
"pins.i2cReadNumber|block": "i2c read number|at address %address|of format %format=i2c_sizeof",
|
"pins.i2cReadNumber|block": "i2c read number|at address %address|of format %format=i2c_sizeof|repeated %repeat",
|
||||||
"pins.i2cWriteNumber|block": "i2c write number|at address %address|with value %value|of format %format=i2c_sizeof",
|
"pins.i2cWriteNumber|block": "i2c write number|at address %address|with value %value|of format %format=i2c_sizeof|repeated %repeat",
|
||||||
"pins.map|block": "map %value|from low %fromLow|from high %fromHigh|to low %toLow|to high %toHigh",
|
"pins.map|block": "map %value|from low %fromLow|from high %fromHigh|to low %toLow|to high %toHigh",
|
||||||
"pins.onPulsed|block": "on|pin %pin|pulsed %pulse",
|
"pins.onPulsed|block": "on|pin %pin|pulsed %pulse",
|
||||||
"pins.pulseDuration|block": "pulse duration (µs)",
|
"pins.pulseDuration|block": "pulse duration (µs)",
|
||||||
|
@ -22,9 +22,9 @@ namespace pins {
|
|||||||
* Read one number from 7-bit I2C address.
|
* Read one number from 7-bit I2C address.
|
||||||
*/
|
*/
|
||||||
//% help=pins/i2c-read-number blockGap=8 advanced=true
|
//% help=pins/i2c-read-number blockGap=8 advanced=true
|
||||||
//% blockId=pins_i2c_readnumber block="i2c read number|at address %address|of format %format=i2c_sizeof" weight=7
|
//% blockId=pins_i2c_readnumber block="i2c read number|at address %address|of format %format=i2c_sizeof|repeated %repeat" weight=7
|
||||||
export function i2cReadNumber(address: number, format: NumberFormat): number {
|
export function i2cReadNumber(address: number, format: NumberFormat, repeated?: boolean): number {
|
||||||
let buf = pins.i2cReadBuffer(address, pins.sizeOf(format))
|
let buf = pins.i2cReadBuffer(address, pins.sizeOf(format), repeated)
|
||||||
return buf.getNumber(format, 0)
|
return buf.getNumber(format, 0)
|
||||||
}
|
}
|
||||||
|
|
||||||
@ -32,11 +32,11 @@ namespace pins {
|
|||||||
* Write one number to a 7-bit I2C address.
|
* Write one number to a 7-bit I2C address.
|
||||||
*/
|
*/
|
||||||
//% help=pins/i2c-write-number blockGap=8 advanced=true
|
//% help=pins/i2c-write-number blockGap=8 advanced=true
|
||||||
//% blockId=i2c_writenumber block="i2c write number|at address %address|with value %value|of format %format=i2c_sizeof" weight=6
|
//% blockId=i2c_writenumber block="i2c write number|at address %address|with value %value|of format %format=i2c_sizeof|repeated %repeat" weight=6
|
||||||
export function i2cWriteNumber(address: number, value: number, format: NumberFormat): void {
|
export function i2cWriteNumber(address: number, value: number, format: NumberFormat, repeated?: boolean): void {
|
||||||
let buf = createBuffer(pins.sizeOf(format))
|
let buf = createBuffer(pins.sizeOf(format))
|
||||||
buf.setNumber(format, 0, value)
|
buf.setNumber(format, 0, value)
|
||||||
pins.i2cWriteBuffer(address, buf)
|
pins.i2cWriteBuffer(address, buf, repeated)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
6
tests/i2c.ts
Normal file
6
tests/i2c.ts
Normal file
@ -0,0 +1,6 @@
|
|||||||
|
|
||||||
|
let item = pins.i2cReadNumber(123, NumberFormat.Int8LE)
|
||||||
|
pins.i2cWriteNumber(123, 0, NumberFormat.Int8LE)
|
||||||
|
|
||||||
|
let item2 = pins.i2cReadNumber(123, NumberFormat.Int8LE, true)
|
||||||
|
pins.i2cWriteNumber(123, 0, NumberFormat.Int8LE, true)
|
Loading…
Reference in New Issue
Block a user