pxt-microbit 4.1.29 → 4.1.30
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/built/common-sim.d.ts +40 -0
- package/built/common-sim.js +93 -1
- package/built/editor.js +20 -4
- package/built/hexcache/{59d35551f2b44631972a3d427c94f81a3df457bfb6ba0fcf2a5807b139d9a32d.hex → 104bed2beca960d761185d436978a3436467a15b22c67b375bcd19c41f329866.hex} +3232 -3232
- package/built/hexcache/{15cf89efb10e1534aca2800db1c6d0d3ae906333f66684e7ae236bd69d5e6e50.hex → 2b2b36e6358c0084c241a1cb9e35fa02042257df3c415d242d9b736c24743a0f.hex} +2904 -2903
- package/built/hexcache/{e4cbdcaceec2f2ce3e23b0bd91cc6dee3dcc1a55867ad24124562b2a62325a49.hex → 3c61b581a0da61711d73a02a7ef4d13a5ff9e71d3626247f33704b8e31e2e656.hex} +10879 -10871
- package/built/hexcache/{f13cee981c6efbc97d49a7e4362956b88e3a61e457b65e49ee7d0bba51d641fd.hex → 82c722b4b5d65f525bfe0c8a1ee67c29cd8feeb26cf793c47a1ed68955bef498.hex} +10289 -10279
- package/built/target.js +41 -33
- package/built/target.json +41 -33
- package/built/targetlight.json +5 -5
- package/package.json +3 -3
package/built/target.json
CHANGED
|
@@ -2665,11 +2665,11 @@
|
|
|
2665
2665
|
},
|
|
2666
2666
|
"uploadDocs": true,
|
|
2667
2667
|
"versions": {
|
|
2668
|
-
"branch": "v4.1.
|
|
2669
|
-
"tag": "v4.1.
|
|
2670
|
-
"commits": "https://github.com/microsoft/pxt-microbit/commits/
|
|
2671
|
-
"target": "4.1.
|
|
2672
|
-
"pxt": "7.5.
|
|
2668
|
+
"branch": "v4.1.30",
|
|
2669
|
+
"tag": "v4.1.30",
|
|
2670
|
+
"commits": "https://github.com/microsoft/pxt-microbit/commits/12cf0a716b26eb4c198a8030c432fae97adf9aa2",
|
|
2671
|
+
"target": "4.1.30",
|
|
2672
|
+
"pxt": "7.5.27"
|
|
2673
2673
|
},
|
|
2674
2674
|
"blocksprj": {
|
|
2675
2675
|
"id": "blocksprj",
|
|
@@ -2723,7 +2723,7 @@
|
|
|
2723
2723
|
"basic.ts": "namespace basic {\n\n /**\n * Scroll a number on the screen. If the number fits on the screen (i.e. is a single digit), do not scroll.\n * @param interval speed of scroll; eg: 150, 100, 200, -100\n */\n //% help=basic/show-number\n //% weight=96\n //% blockId=device_show_number block=\"show|number %number\" blockGap=8\n //% async\n //% parts=\"ledmatrix\" interval.defl=150\n export function showNumber(value: number, interval?: number) {\n showString(Math.roundWithPrecision(value, 2).toString(), interval);\n }\n}\n\n/**\n * Pause for the specified time in milliseconds\n * @param ms how long to pause for, eg: 100, 200, 500, 1000, 2000\n */\nfunction pause(ms: number): void {\n basic.pause(ms);\n}\n\n/**\n * Repeats the code forever in the background. On each iteration, allows other codes to run.\n * @param body code to execute\n */\nfunction forever(a: () => void): void {\n basic.forever(a);\n}\n",
|
|
2724
2724
|
"buffer.cpp": "#include \"pxtbase.h\"\n#include <limits.h>\n\nusing namespace std;\n\n//% indexerGet=BufferMethods::getByte indexerSet=BufferMethods::setByte\nnamespace BufferMethods {\n//%\nuint8_t *getBytes(Buffer buf) {\n return buf->data;\n}\n\n//%\nint getByte(Buffer buf, int off) {\n if (buf && 0 <= off && off < buf->length)\n return buf->data[off];\n return 0;\n}\n\n//%\nvoid setByte(Buffer buf, int off, int v) {\n if (buf && 0 <= off && off < buf->length)\n buf->data[off] = v;\n}\n\n/**\n * Reads an unsigned byte at a particular location\n */\n//%\nint getUint8(Buffer buf, int off) {\n return getByte(buf, off);\n}\n\n/**\n * Returns false when the buffer can be written to.\n */\n//%\nbool isReadOnly(Buffer buf) {\n return buf->isReadOnly();\n}\n\n/**\n * Writes an unsigned byte at a particular location\n */\n//%\nvoid setUint8(Buffer buf, int off, int v) {\n setByte(buf, off, v);\n}\n\nint writeBuffer(Buffer buf, int dstOffset, Buffer src, int srcOffset = 0, int length = -1) {\n if (length < 0)\n length = src->length;\n\n if (srcOffset < 0 || dstOffset < 0 || dstOffset > buf->length)\n return -1;\n\n length = pxt::min(src->length - srcOffset, buf->length - dstOffset);\n\n if (length < 0)\n return -1;\n\n if (buf == src) {\n memmove(buf->data + dstOffset, src->data + srcOffset, length);\n } else {\n memcpy(buf->data + dstOffset, src->data + srcOffset, length);\n }\n\n return 0;\n}\n\n/**\n * Write a number in specified format in the buffer.\n */\n//%\nvoid setNumber(Buffer buf, NumberFormat format, int offset, TNumber value) {\n if (offset < 0)\n return;\n setNumberCore(buf->data + offset, buf->length - offset, format, value);\n}\n\n/**\n * Read a number in specified format from the buffer.\n */\n//%\nTNumber getNumber(Buffer buf, NumberFormat format, int offset) {\n if (offset < 0)\n return fromInt(0);\n return getNumberCore(buf->data + offset, buf->length - offset, format);\n}\n\n/** Returns the length of a Buffer object. */\n//% property\nint length(Buffer s) {\n return s->length;\n}\n\n/**\n * Fill (a fragment) of the buffer with given value.\n */\n//%\nvoid fill(Buffer buf, int value, int offset = 0, int length = -1) {\n if (offset < 0 || offset > buf->length)\n return; // DEVICE_INVALID_PARAMETER;\n if (length < 0)\n length = buf->length;\n length = pxt::min(length, buf->length - offset);\n memset(buf->data + offset, value, length);\n}\n\n/**\n * Return a copy of a fragment of a buffer.\n */\n//%\nBuffer slice(Buffer buf, int offset = 0, int length = -1) {\n offset = pxt::min((int)buf->length, offset);\n if (length < 0)\n length = buf->length;\n length = pxt::min(length, buf->length - offset);\n return mkBuffer(buf->data + offset, length);\n}\n\n/**\n * Shift buffer left in place, with zero padding.\n * @param offset number of bytes to shift; use negative value to shift right\n * @param start start offset in buffer. Default is 0.\n * @param length number of elements in buffer. If negative, length is set as the buffer length minus\n * start. eg: -1\n */\n//%\nvoid shift(Buffer buf, int offset, int start = 0, int length = -1) {\n if (length < 0)\n length = buf->length - start;\n if (start < 0 || start + length > buf->length || start + length < start || length == 0 ||\n offset == 0 || offset == INT_MIN)\n return;\n if (offset <= -length || offset >= length) {\n fill(buf, 0);\n return;\n }\n\n uint8_t *data = buf->data + start;\n if (offset < 0) {\n offset = -offset;\n memmove(data + offset, data, length - offset);\n memset(data, 0, offset);\n } else {\n length = length - offset;\n memmove(data, data + offset, length);\n memset(data + length, 0, offset);\n }\n}\n\n/**\n * Convert a buffer to string assuming UTF8 encoding\n */\n//%\nString toString(Buffer buf) {\n return mkString((char *)buf->data, buf->length);\n}\n\n/**\n * Convert a buffer to its hexadecimal representation.\n */\n//%\nString toHex(Buffer buf) {\n const char *hex = \"0123456789abcdef\";\n auto res = mkStringCore(NULL, buf->length * 2);\n for (int i = 0; i < buf->length; ++i) {\n res->ascii.data[i << 1] = hex[buf->data[i] >> 4];\n res->ascii.data[(i << 1) + 1] = hex[buf->data[i] & 0xf];\n }\n return res;\n}\n\n/**\n * Rotate buffer left in place.\n * @param offset number of bytes to shift; use negative value to shift right\n * @param start start offset in buffer. Default is 0.\n * @param length number of elements in buffer. If negative, length is set as the buffer length minus\n * start. eg: -1\n */\n//%\nvoid rotate(Buffer buf, int offset, int start = 0, int length = -1) {\n if (length < 0)\n length = buf->length - start;\n if (start < 0 || start + length > buf->length || start + length < start || length == 0 ||\n offset == 0 || offset == INT_MIN)\n return;\n\n if (offset < 0)\n offset += length << 8; // try to make it positive\n offset %= length;\n if (offset < 0)\n offset += length;\n\n uint8_t *data = buf->data + start;\n\n uint8_t *n_first = data + offset;\n uint8_t *first = data;\n uint8_t *next = n_first;\n uint8_t *last = data + length;\n\n while (first != next) {\n uint8_t tmp = *first;\n *first++ = *next;\n *next++ = tmp;\n if (next == last) {\n next = n_first;\n } else if (first == n_first) {\n n_first = next;\n }\n }\n}\n\n/**\n * Write contents of `src` at `dstOffset` in current buffer.\n */\n//%\nvoid write(Buffer buf, int dstOffset, Buffer src) {\n // srcOff and length not supported, we only do up to 4 args :/\n writeBuffer(buf, dstOffset, src, 0, -1);\n}\n\n/**\n * Compute k-bit FNV-1 non-cryptographic hash of the buffer.\n */\n//%\nuint32_t hash(Buffer buf, int bits) {\n if (bits < 1)\n return 0;\n uint32_t h = hash_fnv1(buf->data, buf->length);\n if (bits >= 32)\n return h;\n else\n return ((h ^ (h >> bits)) & ((1 << bits) - 1));\n}\n\n} // namespace BufferMethods\n\nbool BoxedBuffer::isInstance(TValue v) {\n return getAnyVTable(v) == &buffer_vt;\n}\n\n// The functions below are deprecated in control namespace, but they are referenced\n// in Buffer namespaces via explicit shim=...\nnamespace control {\n/**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n//% deprecated=1\nBuffer createBuffer(int size) {\n return mkBuffer(NULL, size);\n}\n\n/**\n * Create a new buffer with UTF8-encoded string\n * @param str the string to put in the buffer\n */\n//% deprecated=1\nBuffer createBufferFromUTF8(String str) {\n#if PXT_UTF8\n auto sz = toRealUTF8(str, NULL);\n auto r = mkBuffer(NULL, sz);\n toRealUTF8(str, r->data);\n return r;\n#else\n return mkBuffer((const uint8_t *)str->getUTF8Data(), str->getUTF8Size());\n#endif\n}\n} // namespace control\n\nnamespace pxt {\nstatic int writeBytes(uint8_t *dst, uint8_t *src, int length, bool swapBytes, int szLeft) {\n if (szLeft < length) {\n return -1;\n }\n\n if (swapBytes) {\n uint8_t *p = dst + length;\n for (int i = 0; i < length; ++i)\n *--p = src[i];\n } else {\n if (length == 4 && ((uintptr_t)dst & 3) == 0)\n *(uint32_t *)dst = *(uint32_t *)src;\n else if (length == 2 && ((uintptr_t)dst & 1) == 0)\n *(uint16_t *)dst = *(uint16_t *)src;\n else\n memcpy(dst, src, length);\n }\n\n return 0;\n}\n\nstatic int readBytes(uint8_t *src, uint8_t *dst, int length, bool swapBytes, int szLeft) {\n if (szLeft < length) {\n memset(dst, 0, length);\n return -1;\n }\n\n if (swapBytes) {\n uint8_t *p = src + length;\n for (int i = 0; i < length; ++i)\n dst[i] = *--p;\n } else {\n if (length == 4 && ((uintptr_t)src & 3) == 0)\n *(uint32_t *)dst = *(uint32_t *)src;\n else if (length == 2 && ((uintptr_t)src & 1) == 0)\n *(uint16_t *)dst = *(uint16_t *)src;\n else\n memcpy(dst, src, length);\n }\n\n return 0;\n}\n\nvoid setNumberCore(uint8_t *buf, int szLeft, NumberFormat format, TNumber value) {\n int8_t i8;\n uint8_t u8;\n int16_t i16;\n uint16_t u16;\n int32_t i32;\n uint32_t u32;\n float f32;\n double f64;\n\n// Assume little endian\n#define WRITEBYTES(isz, swap, toInt) \\\n isz = toInt(value); \\\n writeBytes(buf, (uint8_t *)&isz, sizeof(isz), swap, szLeft); \\\n break\n\n switch (format) {\n case NumberFormat::Int8LE:\n WRITEBYTES(i8, false, toInt);\n case NumberFormat::UInt8LE:\n WRITEBYTES(u8, false, toInt);\n case NumberFormat::Int16LE:\n WRITEBYTES(i16, false, toInt);\n case NumberFormat::UInt16LE:\n WRITEBYTES(u16, false, toInt);\n case NumberFormat::Int32LE:\n WRITEBYTES(i32, false, toInt);\n case NumberFormat::UInt32LE:\n WRITEBYTES(u32, false, toUInt);\n\n case NumberFormat::Int8BE:\n WRITEBYTES(i8, true, toInt);\n case NumberFormat::UInt8BE:\n WRITEBYTES(u8, true, toInt);\n case NumberFormat::Int16BE:\n WRITEBYTES(i16, true, toInt);\n case NumberFormat::UInt16BE:\n WRITEBYTES(u16, true, toInt);\n case NumberFormat::Int32BE:\n WRITEBYTES(i32, true, toInt);\n case NumberFormat::UInt32BE:\n WRITEBYTES(u32, true, toUInt);\n\n case NumberFormat::Float32LE:\n WRITEBYTES(f32, false, toFloat);\n case NumberFormat::Float32BE:\n WRITEBYTES(f32, true, toFloat);\n case NumberFormat::Float64LE:\n WRITEBYTES(f64, false, toDouble);\n case NumberFormat::Float64BE:\n WRITEBYTES(f64, true, toDouble);\n }\n}\n\nTNumber getNumberCore(uint8_t *buf, int szLeft, NumberFormat format) {\n int8_t i8;\n uint8_t u8;\n int16_t i16;\n uint16_t u16;\n int32_t i32;\n uint32_t u32;\n float f32;\n double f64;\n\n// Assume little endian\n#define READBYTES(isz, swap, conv) \\\n readBytes(buf, (uint8_t *)&isz, sizeof(isz), swap, szLeft); \\\n return conv(isz)\n\n switch (format) {\n case NumberFormat::Int8LE:\n READBYTES(i8, false, fromInt);\n case NumberFormat::UInt8LE:\n READBYTES(u8, false, fromInt);\n case NumberFormat::Int16LE:\n READBYTES(i16, false, fromInt);\n case NumberFormat::UInt16LE:\n READBYTES(u16, false, fromInt);\n case NumberFormat::Int32LE:\n READBYTES(i32, false, fromInt);\n case NumberFormat::UInt32LE:\n READBYTES(u32, false, fromUInt);\n\n case NumberFormat::Int8BE:\n READBYTES(i8, true, fromInt);\n case NumberFormat::UInt8BE:\n READBYTES(u8, true, fromInt);\n case NumberFormat::Int16BE:\n READBYTES(i16, true, fromInt);\n case NumberFormat::UInt16BE:\n READBYTES(u16, true, fromInt);\n case NumberFormat::Int32BE:\n READBYTES(i32, true, fromInt);\n case NumberFormat::UInt32BE:\n READBYTES(u32, true, fromUInt);\n\n case NumberFormat::Float32LE:\n READBYTES(f32, false, fromFloat);\n case NumberFormat::Float32BE:\n READBYTES(f32, true, fromFloat);\n case NumberFormat::Float64LE:\n READBYTES(f64, false, fromDouble);\n case NumberFormat::Float64BE:\n READBYTES(f64, true, fromDouble);\n }\n\n return 0;\n}\n} // namespace pxt\n",
|
|
2725
2725
|
"buffer.ts": "namespace pins {\n //% deprecated=1\n export function sizeOf(format: NumberFormat) {\n return Buffer.sizeOfNumberFormat(format)\n }\n\n //% deprecated=1\n export function createBufferFromArray(bytes: number[]) {\n return Buffer.fromArray(bytes)\n }\n\n //% deprecated=1\n export function packedSize(format: string) {\n return Buffer.packedSize(format)\n }\n\n //% deprecated=1\n export function packBuffer(format: string, nums: number[]) {\n return Buffer.pack(format, nums)\n }\n\n //% deprecated=1\n export function packIntoBuffer(format: string, buf: Buffer, offset: number, nums: number[]) {\n buf.packAt(offset, format, nums)\n }\n\n //% deprecated=1\n export function unpackBuffer(format: string, buf: Buffer, offset = 0) {\n return buf.unpack(format, offset)\n }\n\n //% deprecated=1\n export function concatBuffers(bufs: Buffer[]) {\n return Buffer.concat(bufs)\n }\n}\n\n// see http://msgpack.org/ for the spec\n// it currently only implements numbers and their sequances\n// once we handle any type and typeof expressions we can do more\n\nnamespace msgpack {\n function tagFormat(tag: number) {\n switch (tag) {\n case 0xCB: return NumberFormat.Float64BE\n case 0xCC: return NumberFormat.UInt8BE\n case 0xCD: return NumberFormat.UInt16BE\n case 0xCE: return NumberFormat.UInt32BE\n case 0xD0: return NumberFormat.Int8BE\n case 0xD1: return NumberFormat.Int16BE\n case 0xD2: return NumberFormat.Int32BE\n default:\n return null\n }\n }\n\n function packNumberCore(buf: Buffer, offset: number, num: number) {\n let tag = 0xCB\n if (num == (num << 0) || num == (num >>> 0)) {\n if (-31 <= num && num <= 127) {\n if (buf) buf[offset] = num\n return 1\n } else if (0 <= num) {\n if (num <= 0xff) {\n tag = 0xCC\n } else if (num <= 0xffff) {\n tag = 0xCD\n } else {\n tag = 0xCE\n }\n } else {\n if (-0x7f <= num) {\n tag = 0xD0\n } else if (-0x7fff <= num) {\n tag = 0xD1\n } else {\n tag = 0xD2\n }\n }\n }\n let fmt = tagFormat(tag)\n if (buf) {\n buf[offset] = tag\n buf.setNumber(fmt, offset + 1, num)\n }\n return pins.sizeOf(fmt) + 1\n }\n\n /**\n * Unpacks a buffer into a number array.\n */\n export function unpackNumberArray(buf: Buffer, offset = 0): number[] {\n let res: number[] = []\n\n while (offset < buf.length) {\n let fmt = tagFormat(buf[offset++])\n if (fmt === null) {\n let v = buf.getNumber(NumberFormat.Int8BE, offset - 1)\n if (-31 <= v && v <= 127)\n res.push(v)\n else\n return null\n } else {\n res.push(buf.getNumber(fmt, offset))\n offset += pins.sizeOf(fmt)\n }\n // padding at the end\n while (buf[offset] === 0xc1) offset++;\n }\n\n return res\n }\n\n /**\n * Pack a number array into a buffer.\n * @param nums the numbers to be packed\n */\n export function packNumberArray(nums: number[]): Buffer {\n let off = 0\n for (let n of nums) {\n off += packNumberCore(null, off, n)\n }\n let buf = Buffer.create(off)\n off = 0\n for (let n of nums) {\n off += packNumberCore(buf, off, n)\n }\n return buf\n }\n}\n\nnamespace helpers {\n export function bufferConcat(a: Buffer, b: Buffer) {\n const r = Buffer.create(a.length + b.length)\n r.write(0, a)\n r.write(a.length, b)\n return r\n }\n\n export function bufferEquals(l: Buffer, r: Buffer) {\n if (!l || !r) return !!l == !!r;\n if (l.length != r.length) return false;\n for (let i = 0; i < l.length; ++i) {\n if (l[i] != r[i])\n return false;\n }\n return true;\n }\n\n export function bufferIndexOf(a: Buffer, b: Buffer) {\n for (let i = 0; i <= a.length - b.length; ++i) {\n if (a[i] == b[0]) {\n let j = 0\n while (j < b.length) {\n if (a[i + j] != b[j])\n break\n j++\n }\n if (j >= b.length)\n return i\n }\n }\n return -1\n }\n\n export function bufferUnpack(buf: Buffer, format: string, offset?: number) {\n if (!offset) offset = 0\n let res: number[] = []\n Buffer.__packUnpackCore(format, res, buf, false, offset)\n return res\n }\n\n export function bufferPackAt(buf: Buffer, offset: number, format: string, nums: number[]) {\n Buffer.__packUnpackCore(format, nums, buf, true, offset)\n }\n\n export function bufferChunked(buf: Buffer, maxBytes: number) {\n if (buf.length <= maxBytes) return [buf]\n else {\n const r: Buffer[] = []\n for (let i = 0; i < buf.length; i += maxBytes)\n r.push(buf.slice(i, maxBytes))\n return r\n }\n }\n\n export function bufferToArray(buf: Buffer, format: NumberFormat) {\n const sz = Buffer.sizeOfNumberFormat(format)\n const len = buf.length - sz\n const r: number[] = []\n for (let i = 0; i <= len; i += sz)\n r.push(buf.getNumber(format, i))\n return r\n }\n\n export const _b64 = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/\"\n export function bufferToBase64(buf: Buffer) {\n const len = buf.length\n let r = \"\"\n for (let i = 0; i < len; i += 3) {\n const x0 = buf[i]\n r += _b64[x0 >> 2]\n if (i + 1 >= len) {\n r += _b64[(x0 & 3) << 4] + \"==\"\n } else {\n const x1 = buf[i + 1]\n r += _b64[(x0 & 3) << 4 | (x1 >> 4)]\n if (i + 2 >= len) {\n r += _b64[(x1 & 15) << 2] + \"=\"\n } else {\n const x2 = buf[i + 2]\n r += _b64[(x1 & 15) << 2 | (x2 >> 6)]\n r += _b64[x2 & 63]\n }\n }\n }\n return r\n }\n}\n\ninterface Buffer {\n [index: number]: number;\n\n /**\n * Return concatenation of current buffer and the given buffer\n */\n //% helper=bufferConcat\n concat(other: Buffer): Buffer;\n\n /**\n * Return position of other buffer in current buffer\n */\n //% helper=bufferIndexOf\n indexOf(other: Buffer): number;\n\n /**\n * Reads numbers from the buffer according to the format\n */\n //% helper=bufferUnpack\n unpack(format: string, offset?: number): number[];\n\n /**\n * Writes numbers to the buffer according to the format\n */\n //% helper=bufferPackAt\n packAt(offset: number, format: string, nums: number[]): void;\n\n /**\n * Returns true if this and the other buffer hold the same data\n */\n //% helper=bufferEquals\n equals(other: Buffer): boolean;\n\n /**\n * Splits buffer into parts no larger than specified\n */\n //% helper=bufferChunked\n chunked(maxSize: number): Buffer[];\n\n /**\n * Read contents of buffer as an array in specified format\n */\n //% helper=bufferToArray\n toArray(format: NumberFormat): number[];\n\n /**\n * Convert buffer to ASCII base64 encoding.\n */\n //% helper=bufferToBase64\n toBase64(): string;\n\n // rest defined in buffer.cpp\n}\n\nnamespace Buffer {\n /**\n * Allocate a new buffer.\n * @param size number of bytes in the buffer\n */\n //% shim=control::createBuffer\n export declare function create(size: number): Buffer;\n\n /**\n * Create a new buffer, decoding a hex string\n */\n export function fromHex(hex: string) {\n const hexStr = \"0123456789abcdef\"\n const res = Buffer.create(hex.length >> 1)\n hex = hex.toLowerCase()\n for (let i = 0; i < hex.length; i += 2) {\n const p0 = hexStr.indexOf(hex.charAt(i))\n const p1 = hexStr.indexOf(hex.charAt(i + 1))\n if (p0 < 0 || p1 < 0)\n throw \"Invalid hex\"\n res[i >> 1] = (p0 << 4) | p1\n }\n return res\n }\n\n function b64Idx(c: string) {\n if (c === undefined || c == \"=\") return -1\n\n // handle base64url\n if (c == \"-\") return 62\n if (c == \"_\") return 63\n\n const r = helpers._b64.indexOf(c)\n if (r < 0)\n throw \"Invalid Base64\"\n return r\n }\n\n function fromBase64Core(trg: Buffer, b64: string) {\n const len = b64.length\n let dp = 0\n for (let i = 0; i < len; i += 4) {\n const x0 = b64Idx(b64[i])\n const x1 = b64Idx(b64[i + 1])\n const x2 = b64Idx(b64[i + 2])\n const x3 = b64Idx(b64[i + 3])\n if (x0 < 0 || x1 < 0) throw \"Invalid Base64\"\n if (trg)\n trg[dp] = (x0 << 2) | (x1 >> 4)\n dp++\n if (x2 >= 0) {\n if (trg)\n trg[dp] = (x1 << 4) | (x2 >> 2)\n dp++\n if (x3 >= 0) {\n if (trg)\n trg[dp] = (x2 << 6) | x3\n dp++\n }\n } else {\n if (x3 >= 0 || i + 4 < len)\n throw \"Invalid Base64\"\n }\n }\n return dp\n }\n\n /**\n * Create a new buffer, decoding a Base64 string\n */\n export function fromBase64(b64: string) {\n const sz = fromBase64Core(null, b64)\n const res = create(sz)\n fromBase64Core(res, b64)\n return res\n }\n\n /**\n * Create a new buffer from an UTF8-encoded string\n * @param str the string to put in the buffer\n */\n //% shim=control::createBufferFromUTF8\n export declare function fromUTF8(str: string): Buffer;\n\n function chunkLen(s: string, off: number, maxlen: number) {\n let L = Math.idiv(maxlen, 3)\n let R = maxlen\n\n if (fromUTF8(s.slice(off, off + R)).length <= maxlen)\n return R\n\n while (L < R) {\n const m = (L + R) >> 1\n if (m == L)\n break\n const ll = fromUTF8(s.slice(off, off + m)).length\n if (ll <= maxlen)\n L = m\n else\n R = m\n }\n\n return L\n }\n\n export function chunkedFromUTF8(str: string, maxBytes: number) {\n if (maxBytes < 3)\n throw \"Oops\"\n const chunks: Buffer[] = []\n let pos = 0\n while (pos < str.length) {\n const len = chunkLen(str, pos, maxBytes)\n chunks.push(fromUTF8(str.slice(pos, pos + len)))\n pos += len\n }\n return chunks\n }\n\n /**\n * Create a new buffer initialized to bytes from given array.\n * @param bytes data to initialize with\n */\n export function fromArray(bytes: number[]) {\n let buf = Buffer.create(bytes.length)\n for (let i = 0; i < bytes.length; ++i)\n buf[i] = bytes[i]\n return buf\n }\n\n /**\n * Concatenates all buffers in the list\n */\n export function concat(buffers: Buffer[]) {\n let len = 0\n for (let b of buffers)\n len += b.length\n const r = Buffer.create(len)\n len = 0\n for (let b of buffers) {\n r.write(len, b)\n len += b.length\n }\n return r\n }\n\n // Python-like packing, see https://docs.python.org/3/library/struct.html\n\n export function packedSize(format: string) {\n return __packUnpackCore(format, null, null, true)\n }\n\n export function pack(format: string, nums: number[]) {\n let buf = Buffer.create(packedSize(format))\n __packUnpackCore(format, nums, buf, true)\n return buf\n }\n\n function getFormat(pychar: string, isBig: boolean) {\n switch (pychar) {\n case 'B':\n return NumberFormat.UInt8LE\n case 'b':\n return NumberFormat.Int8LE\n case 'H':\n return isBig ? NumberFormat.UInt16BE : NumberFormat.UInt16LE\n case 'h':\n return isBig ? NumberFormat.Int16BE : NumberFormat.Int16LE\n case 'I':\n case 'L':\n return isBig ? NumberFormat.UInt32BE : NumberFormat.UInt32LE\n case 'i':\n case 'l':\n return isBig ? NumberFormat.Int32BE : NumberFormat.Int32LE\n case 'f':\n return isBig ? NumberFormat.Float32BE : NumberFormat.Float32LE\n case 'd':\n return isBig ? NumberFormat.Float64BE : NumberFormat.Float64LE\n default:\n return null as NumberFormat\n }\n }\n\n function isDigit(ch: string) {\n const code = ch.charCodeAt(0)\n return 0x30 <= code && code <= 0x39\n }\n\n export function __packUnpackCore(format: string, nums: number[], buf: Buffer, isPack: boolean, off = 0) {\n let isBig = false\n let idx = 0\n for (let i = 0; i < format.length; ++i) {\n switch (format[i]) {\n case ' ':\n case '<':\n case '=':\n isBig = false\n break\n case '>':\n case '!':\n isBig = true\n break\n default:\n const i0 = i\n while (isDigit(format[i])) i++\n let reps = 1\n if (i0 != i)\n reps = parseInt(format.slice(i0, i))\n if (format[i] == 'x')\n off += reps\n else\n while (reps--) {\n let fmt = getFormat(format[i], isBig)\n if (fmt === null) {\n control.fail(\"Unsupported format character: \" + format[i])\n } else {\n if (buf) {\n if (isPack)\n buf.setNumber(fmt, off, nums[idx++])\n else\n nums.push(buf.getNumber(fmt, off))\n }\n\n off += sizeOfNumberFormat(fmt)\n }\n }\n break\n }\n }\n return off\n }\n\n /**\n * Get the size in bytes of specified number format.\n */\n export function sizeOfNumberFormat(format: NumberFormat) {\n switch (format) {\n case NumberFormat.Int8LE:\n case NumberFormat.UInt8LE:\n case NumberFormat.Int8BE:\n case NumberFormat.UInt8BE:\n return 1;\n case NumberFormat.Int16LE:\n case NumberFormat.UInt16LE:\n case NumberFormat.Int16BE:\n case NumberFormat.UInt16BE:\n return 2;\n case NumberFormat.Int32LE:\n case NumberFormat.Int32BE:\n case NumberFormat.UInt32BE:\n case NumberFormat.UInt32LE:\n case NumberFormat.Float32BE:\n case NumberFormat.Float32LE:\n return 4;\n case NumberFormat.Float64BE:\n case NumberFormat.Float64LE:\n return 8;\n }\n return 0;\n }\n}\n",
|
|
2726
|
-
"codal.cpp": "#include \"pxt.h\"\n#include <stdarg.h>\n\nPXT_ABI(__aeabi_dadd)\nPXT_ABI(__aeabi_dcmplt)\nPXT_ABI(__aeabi_dcmpgt)\nPXT_ABI(__aeabi_dsub)\nPXT_ABI(__aeabi_ddiv)\nPXT_ABI(__aeabi_dmul)\n\n#if MICROBIT_CODAL\nnamespace codal {\nint list_fibers(Fiber **dest) {\n int i = 0;\n for (Fiber *fib = codal::get_fiber_list(); fib; fib = fib->next) {\n if (dest)\n dest[i] = fib;\n i++;\n }\n return i;\n}\n\n} // namespace codal\n#endif\n\nextern \"C\" void target_panic(int error_code) {\n#if
|
|
2726
|
+
"codal.cpp": "#include \"pxt.h\"\n#include <stdarg.h>\n\nPXT_ABI(__aeabi_dadd)\nPXT_ABI(__aeabi_dcmplt)\nPXT_ABI(__aeabi_dcmpgt)\nPXT_ABI(__aeabi_dsub)\nPXT_ABI(__aeabi_ddiv)\nPXT_ABI(__aeabi_dmul)\n\n#if MICROBIT_CODAL\nnamespace codal {\nint list_fibers(Fiber **dest) {\n int i = 0;\n for (Fiber *fib = codal::get_fiber_list(); fib; fib = fib->next) {\n if (dest)\n dest[i] = fib;\n i++;\n }\n return i;\n}\n\n} // namespace codal\n#endif\n\nextern \"C\" void target_panic(int error_code) {\n#if MICROBIT_CODAL\n target_disable_irq();\n DMESG(\"PANIC %d\", error_code);\n pxt::dumpDmesg();\n#else\n // wait for serial to flush\n sleep_us(300000);\n#endif\n microbit_panic(error_code);\n}\n\n#if !MICROBIT_CODAL\nextern \"C\" void target_reset() {\n microbit_reset();\n}\n#endif\n\nuint32_t device_heap_size(uint8_t heap_index); // defined in microbit-dal\n\nnamespace pxt {\n\nMicroBit uBit;\nMicroBitEvent lastEvent;\nbool serialLoggingDisabled;\n\nvoid platform_init() {\n microbit_seed_random();\n int seed = microbit_random(0x7fffffff);\n DMESG(\"random seed: %d\", seed);\n seedRandom(seed);\n}\n\nvoid initMicrobitGC() {\n uBit.init();\n if (device_heap_size(1) > NON_GC_HEAP_RESERVATION + 4)\n gcPreAllocateBlock(device_heap_size(1) - NON_GC_HEAP_RESERVATION);\n}\n\nvoid platform_init();\nvoid usb_init();\n\nstruct FreeList {\n FreeList *next;\n};\n\nvoid dispatchForeground(MicroBitEvent e, void *action) {\n lastEvent = e;\n auto value = fromInt(e.value);\n runAction1((Action)action, value);\n}\n\nvoid deleteListener(MicroBitListener *l) {\n if (l->cb_param == (void (*)(MicroBitEvent, void *))dispatchForeground) {\n decr((Action)(l->cb_arg));\n unregisterGCPtr((Action)(l->cb_arg));\n }\n}\n\nstatic void initCodal() {\n // TODO!!!\n#ifndef MICROBIT_CODAL\n uBit.messageBus.setListenerDeletionCallback(deleteListener);\n#endif\n\n // repeat error 4 times and restart as needed\n microbit_panic_timeout(4);\n}\n\n// ---------------------------------------------------------------------------\n// An adapter for the API expected by the run-time.\n// ---------------------------------------------------------------------------\n\nvoid registerWithDal(int id, int event, Action a, int flags) {\n uBit.messageBus.ignore(id, event, dispatchForeground);\n uBit.messageBus.listen(id, event, dispatchForeground, a);\n incr(a);\n registerGCPtr(a);\n}\n\nvoid fiberDone(void *a) {\n decr((Action)a);\n unregisterGCPtr((Action)a);\n release_fiber();\n}\n\nvoid releaseFiber() {\n release_fiber();\n}\n\nvoid sleep_ms(unsigned ms) {\n fiber_sleep(ms);\n}\n\nvoid sleep_us(uint64_t us) {\n#if MICROBIT_CODAL\n target_wait_us(us);\n#else\n wait_us(us);\n#endif\n}\n\nvoid forever_stub(void *a) {\n while (true) {\n runAction0((Action)a);\n fiber_sleep(20);\n }\n}\n\nvoid runForever(Action a) {\n if (a != 0) {\n incr(a);\n registerGCPtr(a);\n create_fiber(forever_stub, (void *)a);\n }\n}\n\nvoid runInParallel(Action a) {\n if (a != 0) {\n incr(a);\n registerGCPtr(a);\n create_fiber((void (*)(void *))runAction0, (void *)a, fiberDone);\n }\n}\n\nvoid waitForEvent(int id, int event) {\n fiber_wait_for_event(id, event);\n}\n\nvoid initRuntime() {\n initCodal();\n platform_init();\n}\n\n//%\nunsigned afterProgramPage() {\n unsigned ptr = (unsigned)&bytecode[0];\n ptr += programSize();\n ptr = (ptr + (PAGE_SIZE - 1)) & ~(PAGE_SIZE - 1);\n return ptr;\n}\n\nint current_time_ms() {\n return system_timer_current_time();\n}\n\nstatic void logwriten(const char *msg, int l) {\n if (!serialLoggingDisabled)\n uBit.serial.send((uint8_t *)msg, l);\n}\n\nstatic void logwrite(const char *msg) {\n logwriten(msg, strlen(msg));\n}\n\nstatic void writeNum(char *buf, uint32_t n, bool full) {\n int i = 0;\n int sh = 28;\n while (sh >= 0) {\n int d = (n >> sh) & 0xf;\n if (full || d || sh == 0 || i) {\n buf[i++] = d > 9 ? 'A' + d - 10 : '0' + d;\n }\n sh -= 4;\n }\n buf[i] = 0;\n}\n\nstatic void logwritenum(uint32_t n, bool full, bool hex) {\n char buff[20];\n\n if (hex) {\n writeNum(buff, n, full);\n logwrite(\"0x\");\n } else {\n itoa(n, buff);\n }\n\n logwrite(buff);\n}\n\nvoid vdebuglog(const char *format, va_list ap) {\n const char *end = format;\n\n while (*end) {\n if (*end++ == '%') {\n logwriten(format, end - format - 1);\n uint32_t val = va_arg(ap, uint32_t);\n switch (*end++) {\n case 'c':\n logwriten((const char *)&val, 1);\n break;\n case 'd':\n logwritenum(val, false, false);\n break;\n case 'x':\n logwritenum(val, false, true);\n break;\n case 'p':\n case 'X':\n logwritenum(val, true, true);\n break;\n case 's':\n logwrite((char *)(void *)val);\n break;\n case '%':\n logwrite(\"%\");\n break;\n default:\n logwrite(\"???\");\n break;\n }\n format = end;\n }\n }\n logwriten(format, end - format);\n logwrite(\"\\n\");\n}\n\nvoid debuglog(const char *format, ...) {\n va_list arg;\n va_start(arg, format);\n vdebuglog(format, arg);\n va_end(arg);\n}\n\nvoid sendSerial(const char *data, int len) {\n logwriten(data, len);\n}\n\nThreadContext *getThreadContext() {\n if (!currentFiber)\n return NULL;\n return (ThreadContext *)currentFiber->user_data;\n}\n\nvoid setThreadContext(ThreadContext *ctx) {\n currentFiber->user_data = ctx;\n}\n\n#if !MICROBIT_CODAL\n#define tcb_get_stack_base(tcb) (tcb).stack_base\n#endif\n\nstatic void *threadAddressFor(Fiber *fib, void *sp) {\n if (fib == currentFiber)\n return sp;\n\n return (uint8_t *)sp + ((uint8_t *)fib->stack_top - (uint8_t *)tcb_get_stack_base(fib->tcb));\n}\n\nvoid gcProcessStacks(int flags) {\n // check scheduler is initialized\n if (!currentFiber) {\n // make sure we allocate something to at least initalize the memory allocator\n void *volatile p = xmalloc(1);\n xfree(p);\n return;\n }\n\n#ifdef MICROBIT_GET_FIBER_LIST_SUPPORTED\n for (Fiber *fib = get_fiber_list(); fib; fib = fib->next) {\n auto ctx = (ThreadContext *)fib->user_data;\n if (!ctx)\n continue;\n for (auto seg = &ctx->stack; seg; seg = seg->next) {\n auto ptr = (TValue *)threadAddressFor(fib, seg->top);\n auto end = (TValue *)threadAddressFor(fib, seg->bottom);\n if (flags & 2)\n DMESG(\"RS%d:%p/%d\", cnt++, ptr, end - ptr);\n // VLOG(\"mark: %p - %p\", ptr, end);\n while (ptr < end) {\n gcProcess(*ptr++);\n }\n }\n }\n#else\n int numFibers = list_fibers(NULL);\n Fiber **fibers = (Fiber **)xmalloc(sizeof(Fiber *) * numFibers);\n int num2 = list_fibers(fibers);\n if (numFibers != num2)\n oops(12);\n int cnt = 0;\n\n for (int i = 0; i < numFibers; ++i) {\n auto fib = fibers[i];\n auto ctx = (ThreadContext *)fib->user_data;\n if (!ctx)\n continue;\n for (auto seg = &ctx->stack; seg; seg = seg->next) {\n auto ptr = (TValue *)threadAddressFor(fib, seg->top);\n auto end = (TValue *)threadAddressFor(fib, seg->bottom);\n if (flags & 2) {\n DMESG(\"RS%d:%p/%d\", cnt, ptr, end - ptr);\n cnt++;\n }\n // VLOG(\"mark: %p - %p\", ptr, end);\n while (ptr < end) {\n gcProcess(*ptr++);\n }\n }\n }\n xfree(fibers);\n#endif\n}\n\n} // namespace pxt\n",
|
|
2727
2727
|
"configkeys.h": "#ifndef __PXT_CONFIGKEYS_H\n#define __PXT_CONFIGKEYS_H\n\n// used by pins.cpp to mask off the pin name from any config\n// lower 16 pins of value are the pin name\n#define CFG_PIN_NAME_MSK 0x0000ffff\n// upper 16 bits of value is any configuration of the pin.\n#define CFG_PIN_CONFIG_MSK 0xffff0000\n\n// begin optional pin configurations\n#define CFG_PIN_CONFIG_ACTIVE_LO 0x10000\n\n\n#define CFG_MAGIC0 0x1e9e10f1\n#define CFG_MAGIC1 0x20227a79\n\n// these define keys for getConfig() function\n#define CFG_PIN_ACCELEROMETER_INT 1\n#define CFG_PIN_ACCELEROMETER_SCL 2\n#define CFG_PIN_ACCELEROMETER_SDA 3\n#define CFG_PIN_BTN_A 4\n#define CFG_PIN_BTN_B 5\n#define CFG_PIN_BTN_SLIDE 6\n#define CFG_PIN_DOTSTAR_CLOCK 7\n#define CFG_PIN_DOTSTAR_DATA 8\n#define CFG_PIN_FLASH_CS 9\n#define CFG_PIN_FLASH_MISO 10\n#define CFG_PIN_FLASH_MOSI 11\n#define CFG_PIN_FLASH_SCK 12\n#define CFG_PIN_LED 13\n#define CFG_PIN_LIGHT 14\n#define CFG_PIN_MICROPHONE 15\n#define CFG_PIN_MIC_CLOCK 16\n#define CFG_PIN_MIC_DATA 17\n#define CFG_PIN_MISO 18\n#define CFG_PIN_MOSI 19\n// the preferred pin to drive an external neopixel strip\n#define CFG_PIN_NEOPIXEL 20\n#define CFG_PIN_RX 21\n#define CFG_PIN_RXLED 22\n#define CFG_PIN_SCK 23\n#define CFG_PIN_SCL 24\n#define CFG_PIN_SDA 25\n#define CFG_PIN_SPEAKER_AMP 26\n#define CFG_PIN_TEMPERATURE 27\n#define CFG_PIN_TX 28\n#define CFG_PIN_TXLED 29\n#define CFG_PIN_IR_OUT 30\n#define CFG_PIN_IR_IN 31\n#define CFG_PIN_DISPLAY_SCK 32\n#define CFG_PIN_DISPLAY_MISO 33\n#define CFG_PIN_DISPLAY_MOSI 34\n#define CFG_PIN_DISPLAY_CS 35\n#define CFG_PIN_DISPLAY_DC 36\n#define CFG_DISPLAY_WIDTH 37\n#define CFG_DISPLAY_HEIGHT 38\n#define CFG_DISPLAY_CFG0 39\n#define CFG_DISPLAY_CFG1 40\n#define CFG_DISPLAY_CFG2 41\n#define CFG_DISPLAY_CFG3 42\n#define CFG_PIN_DISPLAY_RST 43\n#define CFG_PIN_DISPLAY_BL 44\n#define CFG_PIN_SERVO_1 45\n#define CFG_PIN_SERVO_2 46\n#define CFG_PIN_BTN_LEFT 47\n#define CFG_PIN_BTN_RIGHT 48\n#define CFG_PIN_BTN_UP 49\n#define CFG_PIN_BTN_DOWN 50\n#define CFG_PIN_BTN_MENU 51\n#define CFG_PIN_LED_R 52\n#define CFG_PIN_LED_G 53\n#define CFG_PIN_LED_B 54\n#define CFG_PIN_LED1 55\n#define CFG_PIN_LED2 56\n#define CFG_PIN_LED3 57\n#define CFG_PIN_LED4 58\n#define CFG_SPEAKER_VOLUME 59\n\n#define CFG_PIN_JACK_TX 60\n#define CFG_PIN_JACK_SENSE 61\n#define CFG_PIN_JACK_HPEN 62\n#define CFG_PIN_JACK_BZEN 63\n#define CFG_PIN_JACK_PWREN 64\n#define CFG_PIN_JACK_SND 65\n#define CFG_PIN_JACK_BUSLED 66\n#define CFG_PIN_JACK_COMMLED 67\n\n#define CFG_PIN_BTN_SOFT_RESET 69\n#define CFG_ACCELEROMETER_TYPE 70\n#define CFG_PIN_BTNMX_LATCH 71\n#define CFG_PIN_BTNMX_CLOCK 72\n#define CFG_PIN_BTNMX_DATA 73\n#define CFG_PIN_BTN_MENU2 74\n#define CFG_PIN_BATTSENSE 75\n#define CFG_PIN_VIBRATION 76\n#define CFG_PIN_PWREN 77\n#define CFG_DISPLAY_TYPE 78\n\n#define CFG_PIN_ROTARY_ENCODER_A 79\n#define CFG_PIN_ROTARY_ENCODER_B 80\n\n#define CFG_ACCELEROMETER_SPACE 81\n\n#define CFG_PIN_WIFI_MOSI 82\n#define CFG_PIN_WIFI_MISO 83\n#define CFG_PIN_WIFI_SCK 84\n#define CFG_PIN_WIFI_TX 85\n#define CFG_PIN_WIFI_RX 86\n#define CFG_PIN_WIFI_CS 87\n#define CFG_PIN_WIFI_BUSY 88\n#define CFG_PIN_WIFI_RESET 89\n#define CFG_PIN_WIFI_GPIO0 90\n#define CFG_PIN_WIFI_AT_TX 91\n#define CFG_PIN_WIFI_AT_RX 92\n\n#define CFG_PIN_USB_POWER 93\n\n// default I2C address\n#define ACCELEROMETER_TYPE_LIS3DH 0x32\n#define ACCELEROMETER_TYPE_LIS3DH_ALT 0x30\n#define ACCELEROMETER_TYPE_MMA8453 0x38\n#define ACCELEROMETER_TYPE_FXOS8700 0x3C\n#define ACCELEROMETER_TYPE_MMA8653 0x3A\n#define ACCELEROMETER_TYPE_MSA300 0x4C\n#define ACCELEROMETER_TYPE_MPU6050 0x68\n\n#define DISPLAY_TYPE_ST7735 7735\n#define DISPLAY_TYPE_ILI9341 9341\n#define DISPLAY_TYPE_SMART 4242\n\n#define CFG_PIN_A0 100\n#define CFG_PIN_A1 101\n#define CFG_PIN_A2 102\n#define CFG_PIN_A3 103\n#define CFG_PIN_A4 104\n#define CFG_PIN_A5 105\n#define CFG_PIN_A6 106\n#define CFG_PIN_A7 107\n#define CFG_PIN_A8 108\n#define CFG_PIN_A9 109\n#define CFG_PIN_A10 110\n#define CFG_PIN_A11 111\n#define CFG_PIN_A12 112\n#define CFG_PIN_A13 113\n#define CFG_PIN_A14 114\n#define CFG_PIN_A15 115\n#define CFG_PIN_A16 116\n#define CFG_PIN_A17 117\n#define CFG_PIN_A18 118\n#define CFG_PIN_A19 119\n#define CFG_PIN_A20 120\n#define CFG_PIN_A21 121\n#define CFG_PIN_A22 122\n#define CFG_PIN_A23 123\n#define CFG_PIN_A24 124\n#define CFG_PIN_A25 125\n#define CFG_PIN_A26 126\n#define CFG_PIN_A27 127\n#define CFG_PIN_A28 128\n#define CFG_PIN_A29 129\n#define CFG_PIN_A30 130\n#define CFG_PIN_A31 131\n\n#define CFG_PIN_D0 150\n#define CFG_PIN_D1 151\n#define CFG_PIN_D2 152\n#define CFG_PIN_D3 153\n#define CFG_PIN_D4 154\n#define CFG_PIN_D5 155\n#define CFG_PIN_D6 156\n#define CFG_PIN_D7 157\n#define CFG_PIN_D8 158\n#define CFG_PIN_D9 159\n#define CFG_PIN_D10 160\n#define CFG_PIN_D11 161\n#define CFG_PIN_D12 162\n#define CFG_PIN_D13 163\n#define CFG_PIN_D14 164\n#define CFG_PIN_D15 165\n#define CFG_PIN_D16 166\n#define CFG_PIN_D17 167\n#define CFG_PIN_D18 168\n#define CFG_PIN_D19 169\n#define CFG_PIN_D20 170\n#define CFG_PIN_D21 171\n#define CFG_PIN_D22 172\n#define CFG_PIN_D23 173\n#define CFG_PIN_D24 174\n#define CFG_PIN_D25 175\n#define CFG_PIN_D26 176\n#define CFG_PIN_D27 177\n#define CFG_PIN_D28 178\n#define CFG_PIN_D29 179\n#define CFG_PIN_D30 180\n#define CFG_PIN_D31 181\n\n#define CFG_NUM_NEOPIXELS 200\n#define CFG_NUM_DOTSTARS 201\n#define CFG_DEFAULT_BUTTON_MODE 202\n#define CFG_SWD_ENABLED 203\n#define CFG_FLASH_BYTES 204\n#define CFG_RAM_BYTES 205\n#define CFG_SYSTEM_HEAP_BYTES 206\n#define CFG_LOW_MEM_SIMULATION_KB 207\n#define CFG_BOOTLOADER_BOARD_ID 208\n#define CFG_UF2_FAMILY 209\n#define CFG_PINS_PORT_SIZE 210\n#define CFG_BOOTLOADER_PROTECTION 211\n#define CFG_POWER_DEEPSLEEP_TIMEOUT 212\n#define CFG_ANALOG_BUTTON_THRESHOLD 213\n#define CFG_CPU_MHZ 214\n#define CFG_CONTROLLER_LIGHT_MAX_BRIGHTNESS 215\n#define CFG_ANALOG_JOYSTICK_MIN 216\n#define CFG_ANALOG_JOYSTICK_MAX 217\n#define CFG_TIMERS_TO_USE 218\n// configs to specify the onboard (built-in) dotstar or neopixel strips\n// some boards have a combination of dotstar, neopixel strips like neotrellis\n#define CFG_PIN_ONBOARD_DOTSTAR_CLOCK 219\n#define CFG_PIN_ONBOARD_DOTSTAR_DATA 220\n#define CFG_NUM_ONBOARD_DOTSTARS 221\n#define CFG_PIN_ONBOARD_NEOPIXEL 222\n#define CFG_NUM_ONBOARD_NEOPIXELS 223\n\n#define CFG_MATRIX_KEYPAD_MESSAGE_ID 239\n#define CFG_NUM_MATRIX_KEYPAD_ROWS 240\n#define CFG_PIN_MATRIX_KEYPAD_ROW0 241\n#define CFG_PIN_MATRIX_KEYPAD_ROW1 242\n#define CFG_PIN_MATRIX_KEYPAD_ROW2 243\n#define CFG_PIN_MATRIX_KEYPAD_ROW3 244\n#define CFG_PIN_MATRIX_KEYPAD_ROW4 245\n#define CFG_PIN_MATRIX_KEYPAD_ROW5 246\n#define CFG_PIN_MATRIX_KEYPAD_ROW6 247\n#define CFG_PIN_MATRIX_KEYPAD_ROW7 248\n#define CFG_NUM_MATRIX_KEYPAD_COLS 250\n#define CFG_PIN_MATRIX_KEYPAD_COL0 251\n#define CFG_PIN_MATRIX_KEYPAD_COL1 252\n#define CFG_PIN_MATRIX_KEYPAD_COL2 253\n#define CFG_PIN_MATRIX_KEYPAD_COL3 254\n#define CFG_PIN_MATRIX_KEYPAD_COL4 255\n#define CFG_PIN_MATRIX_KEYPAD_COL5 256\n#define CFG_PIN_MATRIX_KEYPAD_COL6 257\n#define CFG_PIN_MATRIX_KEYPAD_COL7 258\n\n#define CFG_PIN_B0 300\n#define CFG_PIN_B1 301\n#define CFG_PIN_B2 302\n#define CFG_PIN_B3 303\n#define CFG_PIN_B4 304\n#define CFG_PIN_B5 305\n#define CFG_PIN_B6 306\n#define CFG_PIN_B7 307\n#define CFG_PIN_B8 308\n#define CFG_PIN_B9 309\n#define CFG_PIN_B10 310\n#define CFG_PIN_B11 311\n#define CFG_PIN_B12 312\n#define CFG_PIN_B13 313\n#define CFG_PIN_B14 314\n#define CFG_PIN_B15 315\n#define CFG_PIN_B16 316\n#define CFG_PIN_B17 317\n#define CFG_PIN_B18 318\n#define CFG_PIN_B19 319\n#define CFG_PIN_B20 320\n#define CFG_PIN_B21 321\n#define CFG_PIN_B22 322\n#define CFG_PIN_B23 323\n#define CFG_PIN_B24 324\n#define CFG_PIN_B25 325\n#define CFG_PIN_B26 326\n#define CFG_PIN_B27 327\n#define CFG_PIN_B28 328\n#define CFG_PIN_B29 329\n#define CFG_PIN_B30 330\n#define CFG_PIN_B31 331\n\n#define CFG_PIN_C0 350\n#define CFG_PIN_C1 351\n#define CFG_PIN_C2 352\n#define CFG_PIN_C3 353\n#define CFG_PIN_C4 354\n#define CFG_PIN_C5 355\n#define CFG_PIN_C6 356\n#define CFG_PIN_C7 357\n#define CFG_PIN_C8 358\n#define CFG_PIN_C9 359\n#define CFG_PIN_C10 360\n#define CFG_PIN_C11 361\n#define CFG_PIN_C12 362\n#define CFG_PIN_C13 363\n#define CFG_PIN_C14 364\n#define CFG_PIN_C15 365\n#define CFG_PIN_C16 366\n#define CFG_PIN_C17 367\n#define CFG_PIN_C18 368\n#define CFG_PIN_C19 369\n#define CFG_PIN_C20 370\n#define CFG_PIN_C21 371\n#define CFG_PIN_C22 372\n#define CFG_PIN_C23 373\n#define CFG_PIN_C24 374\n#define CFG_PIN_C25 375\n#define CFG_PIN_C26 376\n#define CFG_PIN_C27 377\n#define CFG_PIN_C28 378\n#define CFG_PIN_C29 379\n#define CFG_PIN_C30 380\n#define CFG_PIN_C31 381\n\n#define CFG_PIN_P0 400\n#define CFG_PIN_P1 401\n#define CFG_PIN_P2 402\n#define CFG_PIN_P3 403\n#define CFG_PIN_P4 404\n#define CFG_PIN_P5 405\n#define CFG_PIN_P6 406\n#define CFG_PIN_P7 407\n#define CFG_PIN_P8 408\n#define CFG_PIN_P9 409\n#define CFG_PIN_P10 410\n#define CFG_PIN_P11 411\n#define CFG_PIN_P12 412\n#define CFG_PIN_P13 413\n#define CFG_PIN_P14 414\n#define CFG_PIN_P15 415\n#define CFG_PIN_P16 416\n#define CFG_PIN_P17 417\n#define CFG_PIN_P18 418\n#define CFG_PIN_P19 419\n#define CFG_PIN_P20 420\n#define CFG_PIN_P21 421\n#define CFG_PIN_P22 422\n#define CFG_PIN_P23 423\n#define CFG_PIN_P24 424\n#define CFG_PIN_P25 425\n#define CFG_PIN_P26 426\n#define CFG_PIN_P27 427\n#define CFG_PIN_P28 428\n#define CFG_PIN_P29 429\n#define CFG_PIN_P30 430\n#define CFG_PIN_P31 431\n#define CFG_PIN_P32 432\n#define CFG_PIN_P33 433\n#define CFG_PIN_P34 434\n#define CFG_PIN_P35 435\n#define CFG_PIN_P36 436\n#define CFG_PIN_P37 437\n#define CFG_PIN_P38 438\n#define CFG_PIN_P39 439\n#define CFG_PIN_P40 440\n#define CFG_PIN_P41 441\n#define CFG_PIN_P42 442\n#define CFG_PIN_P43 443\n#define CFG_PIN_P44 444\n#define CFG_PIN_P45 445\n#define CFG_PIN_P46 446\n#define CFG_PIN_P47 447\n#define CFG_PIN_P48 448\n#define CFG_PIN_P49 449\n#define CFG_PIN_P50 450\n#define CFG_PIN_P51 451\n#define CFG_PIN_P52 452\n#define CFG_PIN_P53 453\n#define CFG_PIN_P54 454\n#define CFG_PIN_P55 455\n#define CFG_PIN_P56 456\n#define CFG_PIN_P57 457\n#define CFG_PIN_P58 458\n#define CFG_PIN_P59 459\n#define CFG_PIN_P60 460\n#define CFG_PIN_P61 461\n#define CFG_PIN_P62 462\n#define CFG_PIN_P63 463\n\n#define CFG_PIN_LORA_MISO 1001\n#define CFG_PIN_LORA_MOSI 1002\n#define CFG_PIN_LORA_SCK 1003\n#define CFG_PIN_LORA_CS 1004\n#define CFG_PIN_LORA_BOOT 1005\n#define CFG_PIN_LORA_RESET 1006\n#define CFG_PIN_IRRXLED 1007\n#define CFG_PIN_IRTXLED 1008\n#define CFG_PIN_LCD_RESET 1009\n#define CFG_PIN_LCD_ENABLE 1010\n#define CFG_PIN_LCD_DATALINE4 1011\n#define CFG_PIN_LCD_DATALINE5 1012\n#define CFG_PIN_LCD_DATALINE6 1013\n#define CFG_PIN_LCD_DATALINE7 1014\n#define CFG_NUM_LCD_COLUMNS 1015\n#define CFG_NUM_LCD_ROWS 1016\n\n//RoboHAT MM1 pinout\n#define CFG_PIN_RCC0 1017\n#define CFG_PIN_RCC1 1018\n#define CFG_PIN_RCC2 1019\n#define CFG_PIN_RCC3 1020\n#define CFG_PIN_RCC4 1021\n#define CFG_PIN_RCC5 1022\n#define CFG_PIN_RCC6 1023\n#define CFG_PIN_RCC7 1024\n#define CFG_PIN_SERVO0 1025\n#define CFG_PIN_SERVO1 1026\n#define CFG_PIN_SERVO2 1027\n#define CFG_PIN_SERVO3 1028\n#define CFG_PIN_SERVO4 1029\n#define CFG_PIN_SERVO5 1030\n#define CFG_PIN_SERVO6 1031\n#define CFG_PIN_SERVO7 1032\n#define CFG_PIN_SERVO8 1033\n#define CFG_PIN_PI_TX 1034\n#define CFG_PIN_PI_RX 1035\n#define CFG_PIN_GPS_SDA 1036\n#define CFG_PIN_GPS_SCL 1037\n#define CFG_PIN_GPS_TX 1038\n#define CFG_PIN_GPS_RX 1039\n#define CFG_PIN_GROVE0 1040\n#define CFG_PIN_GROVE1 1041\n#define CFG_PIN_SS 1042\n\n// Adafruit Grand Central M4\n#define CFG_PIN_D33 183\n#define CFG_PIN_D34 184\n#define CFG_PIN_D35 185\n#define CFG_PIN_D36 186\n#define CFG_PIN_D37 187\n#define CFG_PIN_D38 188\n#define CFG_PIN_D39 189\n#define CFG_PIN_D40 190\n#define CFG_PIN_D41 191\n#define CFG_PIN_D42 192\n#define CFG_PIN_D43 193\n#define CFG_PIN_D44 194\n#define CFG_PIN_D45 195\n#define CFG_PIN_D46 196\n#define CFG_PIN_D47 197\n#define CFG_PIN_D48 198\n#define CFG_PIN_D49 199\n#define CFG_PIN_D50 259\n#define CFG_PIN_D51 260\n#define CFG_PIN_D52 261\n#define CFG_PIN_D53 262\n\n#define CFG_PIN_TX1 263\n#define CFG_PIN_TX2 264\n#define CFG_PIN_TX3 265\n#define CFG_PIN_RX1 266\n#define CFG_PIN_RX2 267\n#define CFG_PIN_RX3 268\n#define CFG_PIN_SCL1 269\n#define CFG_PIN_SDA1 270\n#define CFG_PIN_PCC_D0 271\n#define CFG_PIN_PCC_D1 272\n#define CFG_PIN_PCC_D2 273\n#define CFG_PIN_PCC_D3 274\n#define CFG_PIN_PCC_D4 275\n#define CFG_PIN_PCC_D5 276\n#define CFG_PIN_PCC_D6 277\n#define CFG_PIN_PCC_D7 278\n#define CFG_PIN_PCC_D8 279\n#define CFG_PIN_PCC_D9 280\n#define CFG_PIN_PCC_D10 281\n#define CFG_PIN_PCC_D11 282\n#define CFG_PIN_PCC_D12 283\n#define CFG_PIN_PCC_D13 284\n#define CFG_PIN_CC_DEN1 285\n#define CFG_PIN_CC_DEN2 286\n#define CFG_PIN_CC_CLK 287\n#define CFG_PIN_XCC_CLK 288\n\n\n#define CFG_PIN_JDPWR_PRE_SENSE 1100\n#define CFG_PIN_JDPWR_GND_SENSE 1101\n#define CFG_PIN_JDPWR_PULSE 1102\n#define CFG_PIN_JDPWR_OVERLOAD_LED 1103\n#define CFG_PIN_JDPWR_ENABLE 1104\n#define CFG_PIN_JDPWR_FAULT 1105\n\n#endif\n",
|
|
2728
2728
|
"console.ts": "/// <reference no-default-lib=\"true\"/>\n\nenum ConsolePriority {\n Debug = 0,\n Log = 1,\n Warning = 2,\n Error = 3,\n Silent = 4\n}\n\n/**\n * Reading and writing data to the console output.\n */\n//% weight=12 color=#002050 icon=\"\\uf120\"\n//% advanced=true\nnamespace console {\n type Listener = (priority: ConsolePriority, text: string) => void;\n\n /**\n * Minimum priority to send messages to listeners\n */\n export let minPriority = ConsolePriority.Log;\n\n let listeners: Listener[]\n\n export function add(priority: ConsolePriority, message: any) {\n if (priority < minPriority) return;\n let text = inspect(message);\n // add new line\n text += \"\\n\";\n control.__log(priority, text)\n // send to listeners\n if (listeners)\n for (let i = 0; i < listeners.length; ++i)\n listeners[i](priority, text);\n }\n\n export function debug(text: any) {\n add(ConsolePriority.Debug, text);\n }\n\n export function warn(text: any) {\n add(ConsolePriority.Warning, text);\n }\n\n export function error(text: any) {\n add(ConsolePriority.Error, text);\n }\n\n /**\n * Write a line of text to the console output.\n * @param value to send\n */\n //% weight=90\n //% help=console/log blockGap=8\n export function log(value: any): void {\n add(ConsolePriority.Log, value);\n }\n\n /**\n * Write a name:value pair as a line of text to the console output.\n * @param name name of the value stream, eg: \"x\"\n * @param value to write\n */\n //% weight=88 blockGap=8\n //% help=console/log-value\n export function logValue(name: any, value: any): void {\n log(name ? `${inspect(name)}: ${inspect(value)}` : `${inspect(value)}`)\n }\n\n /**\n * Convert any object or value to a string representation\n * @param obj value to be converted to a string\n * @param maxElements [optional] max number values in an object to include in output\n */\n export function inspect(obj: any, maxElements = 20): string {\n if (typeof obj == \"string\") {\n return obj;\n } else if (typeof obj == \"number\") {\n return \"\" + obj;\n } else if (Array.isArray(obj)) {\n const asArr = (obj as Array<string>);\n if (asArr.length <= maxElements) {\n return asArr.join(\",\");\n } else {\n return `${asArr.slice(0, maxElements).join(\",\")}...`;\n }\n } else {\n const asString = obj + \"\";\n if (asString != \"[object Object]\"\n && asString != \"[Object]\") { // on arcade at least, default toString is [Object] on hardware instead of standard\n return asString;\n }\n\n let keys = Object.keys(obj);\n const snipped = keys.length > maxElements;\n if (snipped) {\n keys = keys.slice(0, maxElements);\n }\n\n return `{${keys.reduce(\n (prev, currKey) => prev + `\\n ${currKey}: ${obj[currKey]}`,\n \"\"\n ) + (snipped ? \"\\n ...\" : \"\")\n }\n}`;\n }\n }\n\n /**\n * Adds a listener for the log messages\n * @param listener\n */\n //%\n export function addListener(listener: (priority: ConsolePriority, text: string) => void) {\n if (!listeners) listeners = []\n if (!listener || listeners.indexOf(listener) > -1) return;\n listeners.push(listener);\n }\n\n /**\n * Removes a listener\n * @param listener\n */\n //%\n export function removeListener(listener: (priority: ConsolePriority, text: string) => void) {\n if (!listener || !listeners) return;\n const i = listeners.indexOf(listener);\n if (i > -1)\n listeners.splice(i, 1);\n }\n}",
|
|
2729
2729
|
"control.cpp": "#include \"pxt.h\"\n\nextern uint32_t __StackTop;\n\n/**\n * How to create the event.\n */\nenum class EventCreationMode {\n /**\n * MicroBitEvent is initialised, and no further processing takes place.\n */\n CreateOnly = CREATE_ONLY,\n /**\n * MicroBitEvent is initialised, and its event handlers are immediately fired (not suitable for use in interrupts!).\n */\n CreateAndFire = CREATE_AND_FIRE,\n};\n\nconst char *MICROBIT_BOARD_VERSION[2] = { \"2.0\", \"2.X\" };\n\n// note the trailing '_' in names - otherwise we get conflict with the pre-processor\n// this trailing underscore is removed by enums.d.ts generation process\n\n// TODO shouldn't these be renamed to something more sensible anyways?\n\nenum EventBusSource {\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_BUTTON_A_ = MICROBIT_ID_BUTTON_A,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_BUTTON_B_ = MICROBIT_ID_BUTTON_B,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_BUTTON_AB_ = MICROBIT_ID_BUTTON_AB,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_RADIO_ = MICROBIT_ID_RADIO,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_GESTURE_ = MICROBIT_ID_GESTURE,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_ACCELEROMETER_ = MICROBIT_ID_ACCELEROMETER,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P0_ = MICROBIT_ID_IO_P0,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P1_ = MICROBIT_ID_IO_P1,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P2_ = MICROBIT_ID_IO_P2,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P3_ = MICROBIT_ID_IO_P3,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P4_ = MICROBIT_ID_IO_P4,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P5_ = MICROBIT_ID_IO_P5,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P6_ = MICROBIT_ID_IO_P6,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P7_ = MICROBIT_ID_IO_P7,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P8_ = MICROBIT_ID_IO_P8,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P9_ = MICROBIT_ID_IO_P9,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P10_ = MICROBIT_ID_IO_P10,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P11_ = MICROBIT_ID_IO_P11,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P12_ = MICROBIT_ID_IO_P12,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P13_ = MICROBIT_ID_IO_P13,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P14_ = MICROBIT_ID_IO_P14,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P15_ = MICROBIT_ID_IO_P15,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P16_ = MICROBIT_ID_IO_P16,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P19_ = MICROBIT_ID_IO_P19,\n //% blockIdentity=\"control.eventSourceId\"\n MICROBIT_ID_IO_P20_ = MICROBIT_ID_IO_P20,\n //% blockIdentity=\"control.eventSourceId\"\n MES_DEVICE_INFO_ID_ = MES_DEVICE_INFO_ID,\n //% blockIdentity=\"control.eventSourceId\"\n MES_SIGNAL_STRENGTH_ID_ = MES_SIGNAL_STRENGTH_ID,\n //% blockIdentity=\"control.eventSourceId\"\n MES_DPAD_CONTROLLER_ID_ = MES_DPAD_CONTROLLER_ID,\n //% blockIdentity=\"control.eventSourceId\"\n MES_BROADCAST_GENERAL_ID_ = MES_BROADCAST_GENERAL_ID,\n};\n\nenum EventBusValue {\n //% blockIdentity=\"control.eventValueId\"\n MICROBIT_EVT_ANY_ = MICROBIT_EVT_ANY,\n //% blockIdentity=\"control.eventValueId\"\n MICROBIT_BUTTON_EVT_DOWN_ = MICROBIT_BUTTON_EVT_DOWN,\n //% blockIdentity=\"control.eventValueId\"\n MICROBIT_BUTTON_EVT_UP_ = MICROBIT_BUTTON_EVT_UP,\n //% blockIdentity=\"control.eventValueId\"\n MICROBIT_BUTTON_EVT_CLICK_ = MICROBIT_BUTTON_EVT_CLICK,\n //% blockIdentity=\"control.eventValueId\"\n MICROBIT_RADIO_EVT_DATAGRAM_ = MICROBIT_RADIO_EVT_DATAGRAM,\n //% blockIdentity=\"control.eventValueId\"\n MICROBIT_ACCELEROMETER_EVT_DATA_UPDATE_ = MICROBIT_ACCELEROMETER_EVT_DATA_UPDATE,\n //% blockIdentity=\"control.eventValueId\"\n MICROBIT_PIN_EVT_RISE_ = MICROBIT_PIN_EVT_RISE,\n //% blockIdentity=\"control.eventValueId\"\n MICROBIT_PIN_EVT_FALL_ = MICROBIT_PIN_EVT_FALL,\n //% blockIdentity=\"control.eventValueId\"\n MICROBIT_PIN_EVT_PULSE_HI_ = MICROBIT_PIN_EVT_PULSE_HI,\n //% blockIdentity=\"control.eventValueId\"\n MICROBIT_PIN_EVT_PULSE_LO_ = MICROBIT_PIN_EVT_PULSE_LO,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_ALARM1_ = MES_ALERT_EVT_ALARM1,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_ALARM2_ = MES_ALERT_EVT_ALARM2,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_ALARM3_ = MES_ALERT_EVT_ALARM3,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_ALARM4_ = MES_ALERT_EVT_ALARM4,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_ALARM5_ = MES_ALERT_EVT_ALARM5,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_ALARM6_ = MES_ALERT_EVT_ALARM6,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_DISPLAY_TOAST_ = MES_ALERT_EVT_DISPLAY_TOAST,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_FIND_MY_PHONE_ = MES_ALERT_EVT_FIND_MY_PHONE,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_PLAY_RINGTONE_ = MES_ALERT_EVT_PLAY_RINGTONE,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_PLAY_SOUND_ = MES_ALERT_EVT_PLAY_SOUND,\n //% blockIdentity=\"control.eventValueId\"\n MES_ALERT_EVT_VIBRATE_ = MES_ALERT_EVT_VIBRATE,\n //% blockIdentity=\"control.eventValueId\"\n MES_CAMERA_EVT_LAUNCH_PHOTO_MODE_ = MES_CAMERA_EVT_LAUNCH_PHOTO_MODE,\n //% blockIdentity=\"control.eventValueId\"\n MES_CAMERA_EVT_LAUNCH_VIDEO_MODE_ = MES_CAMERA_EVT_LAUNCH_VIDEO_MODE,\n //% blockIdentity=\"control.eventValueId\"\n MES_CAMERA_EVT_START_VIDEO_CAPTURE_ = MES_CAMERA_EVT_START_VIDEO_CAPTURE,\n //% blockIdentity=\"control.eventValueId\"\n MES_CAMERA_EVT_STOP_PHOTO_MODE_ = MES_CAMERA_EVT_STOP_PHOTO_MODE,\n //% blockIdentity=\"control.eventValueId\"\n MES_CAMERA_EVT_STOP_VIDEO_CAPTURE_ = MES_CAMERA_EVT_STOP_VIDEO_CAPTURE,\n //% blockIdentity=\"control.eventValueId\"\n MES_CAMERA_EVT_STOP_VIDEO_MODE_ = MES_CAMERA_EVT_STOP_VIDEO_MODE,\n //% blockIdentity=\"control.eventValueId\"\n MES_CAMERA_EVT_TAKE_PHOTO_ = MES_CAMERA_EVT_TAKE_PHOTO,\n //% blockIdentity=\"control.eventValueId\"\n MES_CAMERA_EVT_TOGGLE_FRONT_REAR_ = MES_CAMERA_EVT_TOGGLE_FRONT_REAR,\n //% blockIdentity=\"control.eventValueId\"\n MES_DEVICE_DISPLAY_OFF_ = MES_DEVICE_DISPLAY_OFF,\n //% blockIdentity=\"control.eventValueId\"\n MES_DEVICE_DISPLAY_ON_ = MES_DEVICE_DISPLAY_ON,\n //% blockIdentity=\"control.eventValueId\"\n MES_DEVICE_GESTURE_DEVICE_SHAKEN_ = MES_DEVICE_GESTURE_DEVICE_SHAKEN,\n //% blockIdentity=\"control.eventValueId\"\n MES_DEVICE_INCOMING_CALL_ = MES_DEVICE_INCOMING_CALL,\n //% blockIdentity=\"control.eventValueId\"\n MES_DEVICE_INCOMING_MESSAGE_ = MES_DEVICE_INCOMING_MESSAGE,\n //% blockIdentity=\"control.eventValueId\"\n MES_DEVICE_ORIENTATION_LANDSCAPE_ = MES_DEVICE_ORIENTATION_LANDSCAPE,\n //% blockIdentity=\"control.eventValueId\"\n MES_DEVICE_ORIENTATION_PORTRAIT_ = MES_DEVICE_ORIENTATION_PORTRAIT,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_1_DOWN_ = MES_DPAD_BUTTON_1_DOWN,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_1_UP_ = MES_DPAD_BUTTON_1_UP,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_2_DOWN_ = MES_DPAD_BUTTON_2_DOWN,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_2_UP_ = MES_DPAD_BUTTON_2_UP,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_3_DOWN_ = MES_DPAD_BUTTON_3_DOWN,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_3_UP_ = MES_DPAD_BUTTON_3_UP,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_4_DOWN_ = MES_DPAD_BUTTON_4_DOWN,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_4_UP_ = MES_DPAD_BUTTON_4_UP,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_A_DOWN_ = MES_DPAD_BUTTON_A_DOWN,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_A_UP_ = MES_DPAD_BUTTON_A_UP,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_B_DOWN_ = MES_DPAD_BUTTON_B_DOWN,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_B_UP_ = MES_DPAD_BUTTON_B_UP,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_C_DOWN_ = MES_DPAD_BUTTON_C_DOWN,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_C_UP_ = MES_DPAD_BUTTON_C_UP,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_D_DOWN_ = MES_DPAD_BUTTON_D_DOWN,\n //% blockIdentity=\"control.eventValueId\"\n MES_DPAD_BUTTON_D_UP_ = MES_DPAD_BUTTON_D_UP,\n //% blockIdentity=\"control.eventValueId\"\n MES_REMOTE_CONTROL_EVT_FORWARD_ = MES_REMOTE_CONTROL_EVT_FORWARD,\n //% blockIdentity=\"control.eventValueId\"\n MES_REMOTE_CONTROL_EVT_NEXTTRACK_ = MES_REMOTE_CONTROL_EVT_NEXTTRACK,\n //% blockIdentity=\"control.eventValueId\"\n MES_REMOTE_CONTROL_EVT_PAUSE_ = MES_REMOTE_CONTROL_EVT_PAUSE,\n //% blockIdentity=\"control.eventValueId\"\n MES_REMOTE_CONTROL_EVT_PLAY_ = MES_REMOTE_CONTROL_EVT_PLAY,\n //% blockIdentity=\"control.eventValueId\"\n MES_REMOTE_CONTROL_EVT_PREVTRACK_ = MES_REMOTE_CONTROL_EVT_PREVTRACK,\n //% blockIdentity=\"control.eventValueId\"\n MES_REMOTE_CONTROL_EVT_REWIND_ = MES_REMOTE_CONTROL_EVT_REWIND,\n //% blockIdentity=\"control.eventValueId\"\n MES_REMOTE_CONTROL_EVT_STOP_ = MES_REMOTE_CONTROL_EVT_STOP,\n //% blockIdentity=\"control.eventValueId\"\n MES_REMOTE_CONTROL_EVT_VOLUMEDOWN_ = MES_REMOTE_CONTROL_EVT_VOLUMEDOWN,\n //% blockIdentity=\"control.eventValueId\"\n MES_REMOTE_CONTROL_EVT_VOLUMEUP_ = MES_REMOTE_CONTROL_EVT_VOLUMEUP,\n};\n\nenum EventFlags {\n //%\n QueueIfBusy = MESSAGE_BUS_LISTENER_QUEUE_IF_BUSY,\n //%\n DropIfBusy = MESSAGE_BUS_LISTENER_DROP_IF_BUSY,\n //%\n Reentrant = MESSAGE_BUS_LISTENER_REENTRANT\n};\n\n//% weight=1 color=\"#333333\"\n//% advanced=true\nnamespace control {\n void fiberDone(void *a)\n {\n decr((Action)a);\n release_fiber();\n }\n\n /**\n * Gets the number of milliseconds elapsed since power on.\n */\n //% help=control/millis weight=50\n //% blockId=control_running_time block=\"millis (ms)\"\n int millis() {\n return system_timer_current_time();\n }\n\n /**\n * Gets current time in microseconds. Overflows every ~18 minutes.\n */\n //%\n int micros() {\n return system_timer_current_time_us() & 0x3fffffff;\n }\n\n /**\n * Schedules code that run in the background.\n */\n //% help=control/in-background blockAllowMultiple=1 afterOnStart=true\n //% blockId=\"control_in_background\" block=\"run in background\" blockGap=8\n void inBackground(Action a) {\n runInParallel(a);\n }\n\n /**\n * Blocks the calling thread until the specified event is raised.\n */\n //% help=control/wait-for-event async\n //% blockId=control_wait_for_event block=\"wait for event|from %src|with value %value\"\n void waitForEvent(int src, int value) {\n pxt::waitForEvent(src, value);\n }\n\n /**\n * Resets the BBC micro:bit.\n */\n //% weight=30 async help=control/reset blockGap=8\n //% blockId=\"control_reset\" block=\"reset\"\n void reset() {\n microbit_reset();\n }\n\n /**\n * Blocks the current fiber for the given microseconds\n * @param micros number of micro-seconds to wait. eg: 4\n */\n //% help=control/wait-micros weight=29 async\n //% blockId=\"control_wait_us\" block=\"wait (µs)%micros\"\n //% micros.min=0 micros.max=6000\n void waitMicros(int micros) {\n sleep_us(micros);\n }\n\n /**\n * Raises an event in the event bus.\n * @param src ID of the MicroBit Component that generated the event e.g. MICROBIT_ID_BUTTON_A.\n * @param value Component specific code indicating the cause of the event.\n * @param mode optional definition of how the event should be processed after construction (default is CREATE_AND_FIRE).\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\" block=\"raise event|from source %src=control_event_source_id|with value %value=control_event_value_id\" blockExternalInputs=1\n //% help=control/raise-event\n //% mode.defl=CREATE_AND_FIRE\n void raiseEvent(int src, int value, EventCreationMode mode) {\n MicroBitEvent evt(src, value, (MicroBitEventLaunchMode)mode);\n }\n\n /**\n * Registers an event handler.\n */\n //% weight=20 blockGap=8 blockId=\"control_on_event\" block=\"on event|from %src=control_event_source_id|with value %value=control_event_value_id\"\n //% help=control/on-event\n //% blockExternalInputs=1\n void onEvent(int src, int value, Action handler, int flags = 0) {\n if (!flags) flags = ::EventFlags::QueueIfBusy;\n registerWithDal(src, value, handler, (int)flags);\n }\n\n /**\n * Gets the value of the last event executed on the bus\n */\n //% blockId=control_event_value\" block=\"event value\"\n //% help=control/event-value\n //% weight=18\n int eventValue() {\n return pxt::lastEvent.value;\n }\n\n /**\n * Gets the timestamp of the last event executed on the bus\n */\n //% blockId=control_event_timestamp\" block=\"event timestamp\"\n //% help=control/event-timestamp\n //% weight=19 blockGap=8\n int eventTimestamp() {\n return pxt::lastEvent.timestamp;\n }\n\n /**\n * Make a friendly name for the device based on its serial number\n */\n //% blockId=\"control_device_name\" block=\"device name\" weight=10 blockGap=8\n //% help=control/device-name\n //% advanced=true\n String deviceName() {\n return mkString(microbit_friendly_name(), -1);\n }\n\n /**\n * Returns the major version of the microbit\n */\n //% help=control/hardware-version\n String _hardwareVersion() {\n #if MICROBIT_CODAL\n MicroBitVersion v = uBit.power.getVersion();\n int versionIdx;\n switch (v.board) {\n case 0x9903:\n case 0x9904:\n versionIdx = 0;\n break;\n default:\n versionIdx = 1;\n break;\n }\n return mkString(MICROBIT_BOARD_VERSION[versionIdx], -1);\n #else\n return mkString(\"1.X\", 1);\n #endif\n }\n\n /**\n * Derive a unique, consistent serial number of this device from internal data.\n */\n //% blockId=\"control_device_serial_number\" block=\"device serial number\" weight=9\n //% help=control/device-serial-number\n //% advanced=true\n int deviceSerialNumber() {\n return microbit_serial_number();\n }\n\n /**\n * Derive a unique, consistent 64-bit serial number of this device from internal data.\n */\n //% help=control/device-long-serial-number\n //% advanced=true\n Buffer deviceLongSerialNumber() {\n return mkBuffer((uint8_t*)&NRF_FICR->DEVICEID[0], sizeof(uint64_t));\n }\n\n /**\n * Informs simulator/runtime of a MIDI message\n * Internal function to support the simulator.\n */\n //% part=midioutput blockHidden=1\n void __midiSend(Buffer buffer) {\n // this is a stub to support the simulator\n }\n\n /**\n *\n */\n //%\n void __log(int priority, String text) {\n if (NULL == text) return;\n pxt::sendSerial(text->getUTF8Data(), text->getUTF8Size());\n }\n\n\n\n/**\n* Allocates the next user notification event\n*/\n//% help=control/allocate-notify-event\nint allocateNotifyEvent() {\n#if MICROBIT_CODAL\n return ::allocateNotifyEvent();\n#else\n static int notifyEv = 1024;\n return ++notifyEv;\n#endif\n}\n\n/** Write a message to DMESG debugging buffer. */\n//%\nvoid dmesg(String s) {\n // this is no-op on v1\n DMESG(\"# %s\", s->getUTF8Data());\n}\n\n/** Write a message and value (pointer) to DMESG debugging buffer. */\n//%\nvoid dmesgPtr(String str, Object_ ptr) {\n // this is no-op on v1\n DMESG(\"# %s: %p\", str->getUTF8Data(), ptr);\n}\n\n//%\nuint32_t _ramSize()\n{\n return (uint32_t)&__StackTop & 0x1fffffff;\n}\n\n}\n",
|
|
@@ -2769,16 +2769,16 @@
|
|
|
2769
2769
|
"pxt-python.d.ts": "/// <reference no-default-lib=\"true\"/>\n\ndeclare namespace _py {\n interface Array {\n //% py2tsOverride=\"push($0)\"\n append(value: any): void;\n\n //% py2tsOverride=\"concat($0)\"\n extend(other: Array): void;\n\n //% py2tsOverride=\"insertAt($0, $1)\"\n insert(index: number, value: any): void;\n\n //% py2tsOverride=\"removeElement($0)\"\n remove(value: any): void;\n\n //% py2tsOverride=\"sort($0?)\"\n sort(sorter?: (a: any, b: any) => number): void;\n\n //% py2tsOverride=\"reverse()\"\n reverse(): void;\n\n //% py2tsOverride=\"slice()\"\n copy(): void;\n\n //% pyHelper=\"py_array_pop\"\n pop(index?: number): any;\n\n //% pyHelper=\"py_array_clear\"\n clear(): void;\n\n //% pyHelper=\"py_array_index\"\n index(value: any, start?: number, end?: number): number;\n\n //% pyHelper=\"py_array_count\"\n count(value: any): number;\n }\n\n interface String {\n //% pyHelper=\"py_string_capitalize\"\n capitalize(): string;\n\n //% pyHelper=\"py_string_casefold\"\n casefold(): string;\n\n //% pyHelper=\"py_string_center\"\n center(width: number, fillChar?: string): string;\n\n //% pyHelper=\"py_string_count\"\n count(sub: string, start?: number, end?: number): number;\n\n //% pyHelper=\"py_string_endswith\"\n endswith(suffix: string, start?: number, end?: number): boolean;\n\n //% pyHelper=\"py_string_find\"\n find(sub: string, start?: number, end?: number): number;\n\n //% pyHelper=\"py_string_index\"\n index(sub: string, start?: number, end?: number): number;\n\n //% pyHelper=\"py_string_isalnum\"\n isalnum(): boolean;\n\n //% pyHelper=\"py_string_isalpha\"\n isalpha(): boolean;\n\n //% pyHelper=\"py_string_isascii\"\n isascii(): boolean;\n\n //% pyHelper=\"py_string_isdigit\"\n isdigit(): boolean;\n\n //% pyHelper=\"py_string_isnumeric\"\n isnumeric(): boolean;\n\n //% pyHelper=\"py_string_isspace\"\n isspace(): boolean;\n\n //% pyHelper=\"py_string_isdecimal\"\n isdecimal(): boolean;\n\n //% pyHelper=\"py_string_isidentifier\"\n isidentifier(): boolean;\n\n //% pyHelper=\"py_string_islower\"\n islower(): boolean;\n\n //% pyHelper=\"py_string_isprintable\"\n isprintable(): boolean;\n\n //% pyHelper=\"py_string_istitle\"\n istitle(): boolean;\n\n //% pyHelper=\"py_string_isupper\"\n isupper(): boolean;\n\n //% pyHelper=\"py_string_join\"\n join(iterable: any[]): string;\n\n //% pyHelper=\"py_string_ljust\"\n ljust(width: number, fillChar?: string): string;\n\n //% pyHelper=\"py_string_lower\"\n lower(): string;\n\n //% pyHelper=\"py_string_lstrip\"\n lstrip(chars?: string): string;\n\n //% py2tsOverride=\"replace($0, $1)\"\n replace(oldString: string, newString: string): string;\n\n //% pyHelper=\"py_string_rfind\"\n rfind(sub: string, start?: number, end?: number): number;\n\n //% pyHelper=\"py_string_rindex\"\n rindex(sub: string, start?: number, end?: number): number;\n\n //% pyHelper=\"py_string_rjust\"\n rjust(width: number, fillChar?: string): string;\n\n //% pyHelper=\"py_string_rsplit\"\n rsplit(sep?: string, maxSplit?: number): string[];\n\n //% pyHelper=\"py_string_rstrip\"\n rstrip(chars?: string): string;\n\n //% pyHelper=\"py_string_split\"\n split(sep?: string, maxsplit?: number): string[];\n\n //% pyHelper=\"py_string_splitlines\"\n splitlines(keepends?: boolean): string[];\n\n //% pyHelper=\"py_string_startswith\"\n startswith(prefix: string, start?: number, end?: number): boolean;\n\n //% pyHelper=\"py_string_strip\"\n strip(chars?: string): string;\n\n //% pyHelper=\"py_string_swapcase\"\n swapcase(): string;\n\n //% pyHelper=\"py_string_title\"\n title(): string;\n\n //% pyHelper=\"py_string_upper\"\n upper(): string;\n\n //% pyHelper=\"py_string_zfill\"\n zfill(width: number): string;\n }\n\n interface Dict {\n clear(): void;\n copy(): void;\n get(key: string, defaultValue?: any): any;\n // items(): [string, any][];\n keys(): string[];\n pop(key: string, defaultValue?: any): any;\n // popitem(): [string, any];\n setdefault(key: string, defaultValue?: any): any;\n update(other: Dict): void;\n values(): any[];\n }\n\n interface Set {\n isdisjoint(other: Set): boolean;\n issubset(other: Set): boolean;\n issuperset(other: Set): boolean;\n union(other: Set): Set;\n intersection(other: Set): Set;\n difference(other: Set): Set;\n symmetric_difference(other: Set): Set;\n copy(): Set;\n update(other: Set): void;\n intersection_update(other: Set): void;\n difference_update(other: Set): void;\n symmetric_difference_update(other: Set): void;\n add(elem: any): void;\n remove(elem: any): void;\n discard(elem: any): void;\n pop(): any;\n clear(): void;\n }\n}",
|
|
2770
2770
|
"pxt.cpp": "#include \"pxtbase.h\"\n\nusing namespace std;\n\nnamespace pxt {\n\nAction mkAction(int totallen, RefAction *act) {\n check(getVTable(act)->classNo == BuiltInType::RefAction, PANIC_INVALID_BINARY_HEADER, 1);\n#ifdef PXT_VM\n check(act->initialLen <= totallen, PANIC_INVALID_BINARY_HEADER, 13);\n#endif\n\n if (totallen == 0) {\n return (TValue)act; // no closure needed\n }\n\n void *ptr = gcAllocate(sizeof(RefAction) + totallen * sizeof(void *));\n RefAction *r = new (ptr) RefAction();\n r->len = totallen;\n#ifdef PXT_VM\n r->numArgs = act->numArgs;\n r->initialLen = act->initialLen;\n r->flags = 0;\n#endif\n r->func = act->func;\n memset(r->fields, 0, r->len * sizeof(void *));\n\n MEMDBG(\"mkAction: start=%p => %p\", act, r);\n\n return (Action)r;\n}\n\nRefRecord *mkClassInstance(VTable *vtable) {\n intcheck(vtable->methods[0] == &RefRecord_destroy, PANIC_SIZE, 3);\n // intcheck(vtable->methods[1] == &RefRecord_print, PANIC_SIZE, 4);\n\n void *ptr = gcAllocate(vtable->numbytes);\n RefRecord *r = new (ptr) RefRecord(vtable);\n memset(r->fields, 0, vtable->numbytes - sizeof(RefRecord));\n MEMDBG(\"mkClass: vt=%p => %p\", vtable, r);\n return r;\n}\n\nTValue RefRecord::ld(int idx) {\n // intcheck((reflen == 255 ? 0 : reflen) <= idx && idx < len, PANIC_OUT_OF_BOUNDS, 1);\n return fields[idx];\n}\n\nTValue RefRecord::ldref(int idx) {\n // DMESG(\"LD %p len=%d reflen=%d idx=%d\", this, len, reflen, idx);\n // intcheck(0 <= idx && idx < reflen, PANIC_OUT_OF_BOUNDS, 2);\n return fields[idx];\n}\n\nvoid RefRecord::st(int idx, TValue v) {\n // intcheck((reflen == 255 ? 0 : reflen) <= idx && idx < len, PANIC_OUT_OF_BOUNDS, 3);\n fields[idx] = v;\n}\n\nvoid RefRecord::stref(int idx, TValue v) {\n // DMESG(\"ST %p len=%d reflen=%d idx=%d\", this, len, reflen, idx);\n // intcheck(0 <= idx && idx < reflen, PANIC_OUT_OF_BOUNDS, 4);\n fields[idx] = v;\n}\n\nvoid RefObject::destroyVT() {\n ((RefObjectMethod)getVTable(this)->methods[0])(this);\n}\n\n//%\nvoid deleteRefObject(RefObject *obj) {\n obj->destroyVT();\n}\n\nvoid RefObject::printVT() {\n ((RefObjectMethod)getVTable(this)->methods[1])(this);\n}\n\nvoid RefRecord_destroy(RefRecord *) {}\n\nvoid RefRecord_print(RefRecord *r) {\n DMESG(\"RefRecord %p size=%d bytes\", r, getVTable(r)->numbytes);\n}\n\nvoid Segment::set(unsigned i, TValue value) {\n if (i < size) {\n data[i] = value;\n } else if (i < Segment::MaxSize) {\n growByMin(i + 1);\n data[i] = value;\n } else {\n return;\n }\n if (length <= i) {\n length = i + 1;\n }\n\n#ifdef DEBUG_BUILD\n DMESG(\"In Segment::set\");\n this->print();\n#endif\n\n return;\n}\n\nstatic inline int growthFactor(int size) {\n if (size == 0) {\n return 4;\n }\n if (size < 64) {\n return size * 2; // Double\n }\n if (size < 512) {\n return size * 5 / 3; // Grow by 1.66 rate\n }\n // Grow by constant rate\n if ((unsigned)size + 256 < Segment::MaxSize)\n return size + 256;\n else\n return Segment::MaxSize;\n}\n\nvoid LLSegment::setLength(unsigned newLen) {\n if (newLen > Segment::MaxSize)\n return;\n\n if (newLen > size) {\n int newSize = growthFactor(size);\n if (newSize < (int)newLen)\n newSize = newLen;\n\n // this will throw if unable to allocate\n TValue *tmp = (TValue *)(xmalloc(newSize * sizeof(TValue)));\n\n // Copy existing data\n if (size) {\n memcpy(tmp, data, size * sizeof(TValue));\n }\n // fill the rest with default value\n memset(tmp + size, 0, (newSize - size) * sizeof(TValue));\n\n // free older segment;\n xfree(data);\n\n data = tmp;\n size = newSize;\n } else if (newLen < length) {\n memset(data + newLen, 0, (length - newLen) * sizeof(TValue));\n }\n\n length = newLen;\n}\n\nvoid LLSegment::set(unsigned idx, TValue v) {\n if (idx >= Segment::MaxSize)\n return;\n if (idx >= length)\n setLength(idx + 1);\n data[idx] = v;\n}\n\nTValue LLSegment::pop() {\n if (length > 0) {\n --length;\n TValue value = data[length];\n data[length] = 0;\n return value;\n }\n return 0;\n}\n\nvoid LLSegment::destroy() {\n length = size = 0;\n xfree(data);\n data = nullptr;\n}\n\nvoid Segment::growByMin(ramint_t minSize) {\n ramint_t newSize = max(minSize, (ramint_t)growthFactor(size));\n\n if (size < newSize) {\n // this will throw if unable to allocate\n TValue *tmp = (TValue *)(gcAllocateArray(newSize * sizeof(TValue)));\n\n // Copy existing data\n if (size)\n memcpy(tmp, data, size * sizeof(TValue));\n // fill the rest with default value\n memset(tmp + size, 0, (newSize - size) * sizeof(TValue));\n\n data = tmp;\n size = newSize;\n\n#ifdef DEBUG_BUILD\n DMESG(\"growBy - after reallocation\");\n this->print();\n#endif\n }\n // else { no shrinking yet; }\n return;\n}\n\nvoid Segment::ensure(ramint_t newSize) {\n if (newSize < size) {\n return;\n }\n growByMin(newSize);\n}\n\nvoid Segment::setLength(unsigned newLength) {\n if (newLength > size) {\n ensure(newLength);\n }\n length = newLength;\n return;\n}\n\nTValue Segment::pop() {\n#ifdef DEBUG_BUILD\n DMESG(\"In Segment::pop\");\n this->print();\n#endif\n\n if (length > 0) {\n --length;\n TValue value = data[length];\n data[length] = Segment::DefaultValue;\n return value;\n }\n return Segment::DefaultValue;\n}\n\n// this function removes an element at index i and shifts the rest of the elements to\n// left to fill the gap\nTValue Segment::remove(unsigned i) {\n#ifdef DEBUG_BUILD\n DMESG(\"In Segment::remove index:%d\", i);\n this->print();\n#endif\n if (i < length) {\n // value to return\n TValue ret = data[i];\n if (i + 1 < length) {\n // Move the rest of the elements to fill in the gap.\n memmove(data + i, data + i + 1, (length - i - 1) * sizeof(void *));\n }\n length--;\n data[length] = Segment::DefaultValue;\n#ifdef DEBUG_BUILD\n DMESG(\"After Segment::remove index:%d\", i);\n this->print();\n#endif\n return ret;\n }\n return Segment::DefaultValue;\n}\n\n// this function inserts element value at index i by shifting the rest of the elements right.\nvoid Segment::insert(unsigned i, TValue value) {\n#ifdef DEBUG_BUILD\n DMESG(\"In Segment::insert index:%d value:%d\", i, value);\n this->print();\n#endif\n\n if (i < length) {\n ensure(length + 1);\n\n // Move the rest of the elements to fill in the gap.\n memmove(data + i + 1, data + i, (length - i) * sizeof(void *));\n\n data[i] = value;\n length++;\n } else {\n // This is insert beyond the length, just call set which will adjust the length\n set(i, value);\n }\n#ifdef DEBUG_BUILD\n DMESG(\"After Segment::insert index:%d\", i);\n this->print();\n#endif\n}\n\nvoid Segment::print() {\n DMESG(\"Segment: %p, length: %d, size: %d\", data, (unsigned)length, (unsigned)size);\n for (unsigned i = 0; i < size; i++) {\n DMESG(\"-> %d\", (unsigned)(uintptr_t)data[i]);\n }\n}\n\nvoid Segment::destroy() {\n#ifdef DEBUG_BUILD\n DMESG(\"In Segment::destroy\");\n this->print();\n#endif\n length = size = 0;\n data = nullptr;\n}\n\nPXT_VTABLE_CTOR(RefCollection) {}\n\nvoid RefCollection::destroy(RefCollection *t) {\n t->head.destroy();\n}\n\nvoid RefCollection::print(RefCollection *t) {\n DMESG(\"RefCollection %p size=%d\", t, t->head.getLength());\n t->head.print();\n}\n\nPXT_VTABLE(RefAction, ValType::Function)\nRefAction::RefAction() : PXT_VTABLE_INIT(RefAction) {}\n\n// fields[] contain captured locals\nvoid RefAction::destroy(RefAction *t) {}\n\nvoid RefAction::print(RefAction *t) {\n#ifdef PXT_VM\n DMESG(\"RefAction %p pc=%X size=%d\", t, (uint32_t)t->func, t->len);\n#else\n DMESG(\"RefAction %p pc=%X size=%d\", t, (const uint8_t *)t->func - (const uint8_t *)bytecode,\n t->len);\n#endif\n}\n\nPXT_VTABLE_CTOR(RefRefLocal) {\n v = 0;\n}\n\nvoid RefRefLocal::print(RefRefLocal *t) {\n DMESG(\"RefRefLocal %p v=%p\", t, (void *)t->v);\n}\n\nvoid RefRefLocal::destroy(RefRefLocal *t) {\n decr(t->v);\n}\n\nPXT_VTABLE_CTOR(RefMap) {}\n\nvoid RefMap::destroy(RefMap *t) {\n t->keys.destroy();\n t->values.destroy();\n}\n\nint RefMap::findIdx(String key) {\n auto len = keys.getLength();\n auto data = (String *)keys.getData();\n\n // fast path\n for (unsigned i = 0; i < len; ++i) {\n if (data[i] == key)\n return i;\n }\n\n // slow path\n auto keylen = key->getUTF8Size();\n auto keydata = key->getUTF8Data();\n for (unsigned i = 0; i < len; ++i) {\n auto s = data[i];\n if (s->getUTF8Size() == keylen && memcmp(keydata, s->getUTF8Data(), keylen) == 0)\n return i;\n }\n\n return -1;\n}\n\nvoid RefMap::print(RefMap *t) {\n DMESG(\"RefMap %p size=%d\", t, t->keys.getLength());\n}\n\nvoid debugMemLeaks() {}\n\nvoid error(PXT_PANIC code, int subcode) {\n DMESG(\"Error: %d [%d]\", code, subcode);\n target_panic(code);\n}\n\n#ifndef PXT_VM\nuint16_t *bytecode;\n#endif\nTValue *globals;\n\nvoid checkStr(bool cond, const char *msg) {\n if (!cond) {\n while (true) {\n // uBit.display.scroll(msg, 100);\n // uBit.sleep(100);\n }\n }\n}\n\n#ifdef PXT_VM\nint templateHash() {\n return *(int*)&vmImg->infoHeader->hexHash;\n}\n\nint programHash() {\n return *(int*)&vmImg->infoHeader->programHash;\n}\n\nint getNumGlobals() {\n return (int)vmImg->infoHeader->allocGlobals;\n}\n\nString programName() {\n return mkString((char *)vmImg->infoHeader->name);\n}\n#else\nint templateHash() {\n return ((int *)bytecode)[4];\n}\n\nint programHash() {\n return ((int *)bytecode)[6];\n}\n\nint getNumGlobals() {\n return bytecode[16];\n}\n\nString programName() {\n return ((String *)bytecode)[15];\n}\n#endif\n\n#ifndef PXT_VM\nvoid variantNotSupported(const char *v) {\n DMESG(\"variant not supported: %s\", v);\n target_panic(PANIC_VARIANT_NOT_SUPPORTED);\n}\n\nvoid exec_binary(unsigned *pc) {\n // XXX re-enable once the calibration code is fixed and [editor/embedded.ts]\n // properly prepends a call to [internal_main].\n // ::touch_develop::internal_main();\n\n // unique group for radio based on source hash\n // ::touch_develop::micro_bit::radioDefaultGroup = programHash();\n\n unsigned ver = *pc++;\n checkStr(ver == 0x4210, \":( Bad runtime version\");\n\n bytecode = *((uint16_t **)pc++); // the actual bytecode is here\n\n if (((uint32_t *)bytecode)[0] == 0x923B8E71) {\n variantNotSupported((const char *)bytecode + 16);\n return;\n }\n\n globals = (TValue *)app_alloc(sizeof(TValue) * getNumGlobals());\n memset(globals, 0, sizeof(TValue) * getNumGlobals());\n\n // can be any valid address, best in RAM for speed\n globals[0] = (TValue)&globals;\n\n // just compare the first word\n // TODO\n checkStr(((uint32_t *)bytecode)[0] == 0x923B8E70 && (unsigned)templateHash() == *pc,\n \":( Failed partial flash\");\n\n uintptr_t startptr = (uintptr_t)bytecode;\n\n startptr += 64; // header\n\n initPerfCounters();\n\n initRuntime();\n\n runAction0((Action)startptr);\n\n pxt::releaseFiber();\n}\n\nvoid start() {\n exec_binary((unsigned *)functionsAndBytecode);\n}\n#endif\n\n} // namespace pxt\n\nnamespace Array_ {\n//%\nbool isArray(TValue arr) {\n auto vt = getAnyVTable(arr);\n return vt && vt->classNo == BuiltInType::RefCollection;\n}\n} // namespace Array_\n\nnamespace pxtrt {\n//% expose\nRefCollection *keysOf(TValue v) {\n auto r = NEW_GC(RefCollection);\n MEMDBG(\"mkColl[keys]: => %p\", r);\n if (getAnyVTable(v) != &RefMap_vtable)\n return r;\n auto rm = (RefMap *)v;\n auto len = rm->keys.getLength();\n if (!len)\n return r;\n registerGCObj(r);\n r->setLength(len);\n auto dst = r->getData();\n memcpy(dst, rm->keys.getData(), len * sizeof(TValue));\n unregisterGCObj(r);\n return r;\n}\n//% expose\nTValue mapDeleteByString(RefMap *map, String key) {\n if (getAnyVTable((TValue)map) != &RefMap_vtable)\n soft_panic(PANIC_DELETE_ON_CLASS);\n int i = map->findIdx(key);\n if (i >= 0) {\n map->keys.remove(i);\n map->values.remove(i);\n }\n return TAG_TRUE;\n}\n\n} // namespace pxtrt\n",
|
|
2771
2771
|
"pxt.h": "#ifndef __PXT_H\n#define __PXT_H\n\n//#define DEBUG_MEMLEAKS 1\n\n#pragma GCC diagnostic ignored \"-Wunused-parameter\"\n\n#include \"pxtbase.h\"\n\nnamespace pxt {\n\nclass RefMImage : public RefObject {\n public:\n ImageData *img;\n\n RefMImage(ImageData *d);\n void makeWritable();\n static void destroy(RefMImage *map);\n static void print(RefMImage *map);\n static void scan(RefMImage *t);\n static unsigned gcsize(RefMImage *t);\n};\n\n#define MSTR(s) ManagedString((s)->getUTF8Data(), (s)->getUTF8Size())\n\nstatic inline String PSTR(ManagedString s) {\n return mkString(s.toCharArray(), s.length());\n}\n\ntypedef uint32_t ImageLiteral_;\n\nstatic inline ImageData *imageBytes(ImageLiteral_ lit) {\n return (ImageData *)lit;\n}\n\n#if MICROBIT_CODAL\n// avoid clashes with codal-defined classes\n#define Image MImage\n#define Button MButton\n#endif\n\ntypedef MicroBitPin DevicePin;\n\ntypedef RefMImage *Image;\n\nextern MicroBit uBit;\nextern MicroBitEvent lastEvent;\nextern bool serialLoggingDisabled;\n\nMicroBitPin *getPin(int id);\n\nstatic inline int min_(int a, int b) {\n if (a < b)\n return a;\n else\n return b;\n}\n\nstatic inline int max_(int a, int b) {\n if (a > b)\n return a;\n else\n return b;\n}\n\nvoid initMicrobitGC();\n\n} // namespace pxt\n\nusing namespace pxt;\n\n#define DEVICE_EVT_ANY 0\n\n#undef PXT_MAIN\n#define PXT_MAIN \\\n int main() { \\\n pxt::initMicrobitGC(); \\\n pxt::start(); \\\n return 0; \\\n }\n\n#endif\n\n// vim: ts=2 sw=2 expandtab\n",
|
|
2772
|
-
"pxt.json": "{\n \"name\": \"core\",\n \"description\": \"The microbit core library\",\n \"dependencies\": {},\n \"files\": [\n \"README.md\",\n \"platform.h\",\n \"pxt.cpp\",\n \"pxt.h\",\n \"pxtbase.h\",\n \"pxtcore.h\",\n \"math.ts\",\n \"dal.d.ts\",\n \"enums.d.ts\",\n \"shims.d.ts\",\n \"pxt-core.d.ts\",\n \"core.cpp\",\n \"pxt-helpers.ts\",\n \"helpers.ts\",\n \"pxt-python.d.ts\",\n \"pxt-python-helpers.ts\",\n \"pinscompat.ts\",\n \"configkeys.h\",\n \"gc.cpp\",\n \"codal.cpp\",\n \"images.cpp\",\n \"basic.cpp\",\n \"basic.ts\",\n \"icons.ts\",\n \"icons.jres\",\n \"input.cpp\",\n \"input.ts\",\n \"gestures.jres\",\n \"control.ts\",\n \"control.cpp\",\n \"controlgc.cpp\",\n \"perfcounters.ts\",\n \"interval.ts\",\n \"gcstats.ts\",\n \"console.ts\",\n \"game.ts\",\n \"led.cpp\",\n \"led.ts\",\n \"music.cpp\",\n \"music.ts\",\n \"melodies.ts\",\n \"pins.cpp\",\n \"pins.ts\",\n \"serial.cpp\",\n \"serial.ts\",\n \"buffer.cpp\",\n \"buffer.ts\",\n \"json.ts\",\n \"poll.ts\",\n \"controlmessage.ts\",\n \"pxtparts.json\",\n \"advmath.cpp\",\n \"trig.cpp\",\n \"fixed.ts\",\n \"templates.ts\",\n \"sendbuffer.s\",\n \"sendbuffernrf52.s\",\n \"sendbufferbrightness.s\",\n \"light.cpp\",\n \"logo.cpp\",\n \"loops.ts\",\n \"touchmode.cpp\",\n \"soundexpressions.ts\",\n \"soundexpressions.cpp\",\n \"parts/speaker.svg\",\n \"parts/headphone.svg\"\n ],\n \"testFiles\": [],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2772
|
+
"pxt.json": "{\n \"name\": \"core\",\n \"description\": \"The microbit core library\",\n \"dependencies\": {},\n \"files\": [\n \"README.md\",\n \"platform.h\",\n \"pxt.cpp\",\n \"pxt.h\",\n \"pxtbase.h\",\n \"pxtcore.h\",\n \"math.ts\",\n \"dal.d.ts\",\n \"enums.d.ts\",\n \"shims.d.ts\",\n \"pxt-core.d.ts\",\n \"core.cpp\",\n \"pxt-helpers.ts\",\n \"helpers.ts\",\n \"pxt-python.d.ts\",\n \"pxt-python-helpers.ts\",\n \"pinscompat.ts\",\n \"configkeys.h\",\n \"gc.cpp\",\n \"codal.cpp\",\n \"images.cpp\",\n \"basic.cpp\",\n \"basic.ts\",\n \"icons.ts\",\n \"icons.jres\",\n \"input.cpp\",\n \"input.ts\",\n \"gestures.jres\",\n \"control.ts\",\n \"control.cpp\",\n \"controlgc.cpp\",\n \"perfcounters.ts\",\n \"interval.ts\",\n \"gcstats.ts\",\n \"console.ts\",\n \"game.ts\",\n \"led.cpp\",\n \"led.ts\",\n \"music.cpp\",\n \"music.ts\",\n \"melodies.ts\",\n \"pins.cpp\",\n \"pins.ts\",\n \"serial.cpp\",\n \"serial.ts\",\n \"buffer.cpp\",\n \"buffer.ts\",\n \"json.ts\",\n \"poll.ts\",\n \"controlmessage.ts\",\n \"pxtparts.json\",\n \"advmath.cpp\",\n \"trig.cpp\",\n \"fixed.ts\",\n \"templates.ts\",\n \"sendbuffer.s\",\n \"sendbuffernrf52.s\",\n \"sendbufferbrightness.s\",\n \"light.cpp\",\n \"logo.cpp\",\n \"loops.ts\",\n \"touchmode.cpp\",\n \"soundexpressions.ts\",\n \"soundexpressions.cpp\",\n \"parts/speaker.svg\",\n \"parts/headphone.svg\"\n ],\n \"testFiles\": [],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"dalDTS\": {\n \"compileServiceVariant\": \"mbcodal\",\n \"includeDirs\": [\n \"libraries/codal-core/inc\",\n \"libraries/codal-microbit-v2/inc\",\n \"libraries/codal-microbit-v2/model\",\n \"libraries/codal-microbit-v2/inc/compat\",\n \"pxtapp\"\n ],\n \"excludePrefix\": [\n \"USB_\",\n \"REQUEST_\",\n \"LIS3DH_\",\n \"FXOS8700_\",\n \"MMA8\",\n \"LSM303_\",\n \"MAG_\",\n \"MPU6050_\",\n \"REF_TAG_\",\n \"HF2_\",\n \"PXT_REF_TAG_\",\n \"MS_\",\n \"SCSI_\"\n ]\n },\n \"yotta\": {\n \"config\": {\n \"microbit-dal\": {\n \"fiber_user_data\": 1,\n \"pxt\": 1\n }\n },\n \"optionalConfig\": {\n \"microbit-dal\": {\n \"bluetooth\": {\n \"private_addressing\": 0,\n \"advertising_timeout\": 0,\n \"tx_power\": 6,\n \"dfu_service\": 1,\n \"event_service\": 1,\n \"device_info_service\": 1,\n \"eddystone_url\": 1,\n \"eddystone_uid\": 1,\n \"open\": 0,\n \"pairing_mode\": 1,\n \"whitelist\": 1,\n \"security_level\": \"SECURITY_MODE_ENCRYPTION_NO_MITM\",\n \"partial_flashing\": 1\n }\n }\n },\n \"userConfigs\": [\n {\n \"description\": \"No Pairing Required: Anyone can connect via Bluetooth.\",\n \"config\": {\n \"microbit-dal\": {\n \"bluetooth\": {\n \"open\": 1,\n \"whitelist\": 0,\n \"security_level\": null\n }\n }\n }\n },\n {\n \"description\": \"JustWorks pairing (default): Pairing is automatic once the pairing is initiated.\",\n \"config\": {\n \"microbit-dal\": {\n \"bluetooth\": {\n \"open\": 0,\n \"whitelist\": 1,\n \"security_level\": \"SECURITY_MODE_ENCRYPTION_NO_MITM\"\n }\n }\n }\n },\n {\n \"description\": \"Passkey pairing: Pairing requires 6 digit key to pair.\",\n \"config\": {\n \"microbit-dal\": {\n \"bluetooth\": {\n \"open\": 0,\n \"whitelist\": 1,\n \"security_level\": \"SECURITY_MODE_ENCRYPTION_WITH_MITM\"\n }\n }\n }\n }\n ]\n },\n \"partial\": true\n}\n",
|
|
2773
2773
|
"pxtbase.h": "#ifndef __PXTBASE_H\n#define __PXTBASE_H\n\n#pragma GCC diagnostic ignored \"-Wunused-parameter\"\n#pragma GCC diagnostic ignored \"-Wformat\"\n#pragma GCC diagnostic ignored \"-Warray-bounds\"\n\n// needed for gcc6; not sure why\n#undef min\n#undef max\n\n#define NOLOG(...) \\\n do { \\\n } while (0)\n\n#define MEMDBG NOLOG\n//#define MEMDBG DMESG\n#define MEMDBG2 NOLOG\n\n#include \"pxtconfig.h\"\n#include \"configkeys.h\"\n\n#ifndef PXT_UTF8\n#define PXT_UTF8 0\n#endif\n\n#if defined(PXT_VM)\n#include <stdint.h>\n#if UINTPTR_MAX == 0xffffffff\n#define PXT32 1\n#elif UINTPTR_MAX == 0xffffffffffffffff\n#define PXT64 1\n#else\n#error \"UINTPTR_MAX has invalid value\"\n#endif\n#endif\n\n#define intcheck(...) check(__VA_ARGS__)\n//#define intcheck(...) do {} while (0)\n\n#ifdef PXT_USE_FLOAT\n#define NUMBER float\n#else\n#define NUMBER double\n#endif\n\n#include <string.h>\n#include <stdint.h>\n#include <math.h>\n\n#ifdef POKY\nvoid *operator new(size_t size, void *ptr);\nvoid *operator new(size_t size);\n#else\n#include <new>\n#endif\n\n#include \"platform.h\"\n#include \"pxtcore.h\"\n\n#ifndef PXT_REGISTER_RESET\n#define PXT_REGISTER_RESET(fn) ((void)0)\n#endif\n\n#define PXT_REFCNT_FLASH 0xfffe\n\n#define CONCAT_1(a, b) a##b\n#define CONCAT_0(a, b) CONCAT_1(a, b)\n// already provided in some platforms, like mbedos\n#ifndef STATIC_ASSERT\n#define STATIC_ASSERT(e) enum { CONCAT_0(_static_assert_, __LINE__) = 1 / ((e) ? 1 : 0) };\n#endif\n\n#ifndef ramint_t\n// this type limits size of arrays\n#if defined(__linux__) || defined(PXT_VM)\n// TODO fix the inline array accesses to take note of this!\n#define ramint_t uint32_t\n#else\n#define ramint_t uint16_t\n#endif\n#endif\n\n#ifndef PXT_IN_ISR\n#define PXT_IN_ISR() (SCB->ICSR & SCB_ICSR_VECTACTIVE_Msk)\n#endif\n\n#ifdef POKY\ninline void *operator new(size_t, void *p) {\n return p;\n}\ninline void *operator new[](size_t, void *p) {\n return p;\n}\n#endif\n\nnamespace pxt {\n\ntemplate <typename T> inline const T &max(const T &a, const T &b) {\n if (a < b)\n return b;\n return a;\n}\n\ntemplate <typename T> inline const T &min(const T &a, const T &b) {\n if (a < b)\n return a;\n return b;\n}\n\ntemplate <typename T> inline void swap(T &a, T &b) {\n T tmp = a;\n a = b;\n b = tmp;\n}\n\n//\n// Tagged values (assume 4 bytes for now, Cortex-M0)\n//\nstruct TValueStruct {};\ntypedef TValueStruct *TValue;\n\ntypedef TValue TNumber;\ntypedef TValue Action;\ntypedef TValue ImageLiteral;\n\n// To be implemented by the target\nextern \"C\" void target_panic(int error_code);\nextern \"C\" void target_reset();\nvoid sleep_ms(unsigned ms);\nvoid sleep_us(uint64_t us);\nvoid releaseFiber();\nuint64_t current_time_us();\nint current_time_ms();\nvoid initRuntime();\nvoid initSystemTimer();\nvoid sendSerial(const char *data, int len);\nvoid setSendToUART(void (*f)(const char *, int));\nuint64_t getLongSerialNumber();\nvoid registerWithDal(int id, int event, Action a, int flags = 16); // EVENT_LISTENER_DEFAULT_FLAGS\nvoid runInParallel(Action a);\nvoid runForever(Action a);\nvoid waitForEvent(int id, int event);\n//%\nunsigned afterProgramPage();\n//%\nvoid dumpDmesg();\nuint32_t hash_fnv1(const void *data, unsigned len);\n\n// also defined DMESG macro\n// end\n\n#define TAGGED_SPECIAL(n) (TValue)(void *)((n << 2) | 2)\n#define TAG_FALSE TAGGED_SPECIAL(2) // 10\n#define TAG_TRUE TAGGED_SPECIAL(16) // 66\n#define TAG_UNDEFINED (TValue)0\n#define TAG_NULL TAGGED_SPECIAL(1) // 6\n#define TAG_NAN TAGGED_SPECIAL(3) // 14\n#define TAG_NUMBER(n) (TNumber)(void *)(((uintptr_t)(uint32_t)(n) << 1) | 1)\n#define TAG_NON_VALUE TAGGED_SPECIAL(4) // 18; doesn't represent any JS value\n\n#ifdef PXT_VM\ninline bool isEncodedDouble(uint64_t v) {\n return (v >> 48) != 0;\n}\n#endif\n\ninline bool isDouble(TValue v) {\n#ifdef PXT64\n return ((uintptr_t)v >> 48) != 0;\n#else\n (void)v;\n return false;\n#endif\n}\n\ninline bool isPointer(TValue v) {\n return !isDouble(v) && v != 0 && ((intptr_t)v & 3) == 0;\n}\n\ninline bool isTagged(TValue v) {\n return (!isDouble(v) && ((intptr_t)v & 3)) || !v;\n}\n\ninline bool isInt(TValue v) {\n return !isDouble(v) && ((intptr_t)v & 1);\n}\n\ninline bool isSpecial(TValue v) {\n return !isDouble(v) && ((intptr_t)v & 2);\n}\n\ninline bool bothNumbers(TValue a, TValue b) {\n return !isDouble(a) && !isDouble(b) && ((intptr_t)a & (intptr_t)b & 1);\n}\n\ninline int numValue(TValue n) {\n return (int)((intptr_t)n >> 1);\n}\n\ninline bool canBeTagged(int v) {\n (void)v;\n#ifdef PXT_BOX_DEBUG\n return false;\n#elif defined(PXT64)\n return true;\n#else\n return (v << 1) >> 1 == v;\n#endif\n}\n\n// see https://anniecherkaev.com/the-secret-life-of-nan\n\n#define NanBoxingOffset 0x1000000000000LL\n\ntemplate <typename TO, typename FROM> TO bitwise_cast(FROM in) {\n STATIC_ASSERT(sizeof(TO) == sizeof(FROM));\n union {\n FROM from;\n TO to;\n } u;\n u.from = in;\n return u.to;\n}\n\ninline double decodeDouble(uint64_t v) {\n return bitwise_cast<double>(v - NanBoxingOffset);\n}\n\n#ifdef PXT64\nSTATIC_ASSERT(sizeof(void *) == 8);\ninline double doubleVal(TValue v) {\n return bitwise_cast<double>((uint64_t)v - NanBoxingOffset);\n}\n\ninline TValue tvalueFromDouble(double d) {\n return (TValue)(bitwise_cast<uint64_t>(d) + NanBoxingOffset);\n}\n#else\nSTATIC_ASSERT(sizeof(void *) == 4);\n#endif\n\n// keep in sym with sim/control.ts\ntypedef enum {\n PANIC_CODAL_OOM = 20,\n PANIC_GC_OOM = 21,\n PANIC_GC_TOO_BIG_ALLOCATION = 22,\n PANIC_CODAL_HEAP_ERROR = 30,\n PANIC_CODAL_NULL_DEREFERENCE = 40,\n PANIC_CODAL_USB_ERROR = 50,\n PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR = 90,\n\n PANIC_INVALID_BINARY_HEADER = 901,\n PANIC_OUT_OF_BOUNDS = 902,\n PANIC_REF_DELETED = 903,\n PANIC_SIZE = 904,\n PANIC_INVALID_VTABLE = 905,\n PANIC_INTERNAL_ERROR = 906,\n PANIC_NO_SUCH_CONFIG = 907,\n PANIC_NO_SUCH_PIN = 908,\n PANIC_INVALID_ARGUMENT = 909,\n PANIC_MEMORY_LIMIT_EXCEEDED = 910,\n PANIC_SCREEN_ERROR = 911,\n PANIC_MISSING_PROPERTY = 912,\n PANIC_INVALID_IMAGE = 913,\n PANIC_CALLED_FROM_ISR = 914,\n PANIC_HEAP_DUMPED = 915,\n PANIC_STACK_OVERFLOW = 916,\n PANIC_BLOCKING_TO_STRING = 917,\n PANIC_VM_ERROR = 918,\n PANIC_SETTINGS_CLEARED = 920,\n PANIC_SETTINGS_OVERLOAD = 921,\n PANIC_SETTINGS_SECRET_MISSING = 922,\n PANIC_DELETE_ON_CLASS = 923,\n PANIC_OUT_OF_TIMERS = 924,\n PANIC_JACDAC = 925,\n PANIC_MICROPHONE_MISSING = 926,\n PANIC_VARIANT_NOT_SUPPORTED = 927,\n\n PANIC_CAST_FIRST = 980,\n PANIC_CAST_FROM_UNDEFINED = 980,\n PANIC_CAST_FROM_BOOLEAN = 981,\n PANIC_CAST_FROM_NUMBER = 982,\n PANIC_CAST_FROM_STRING = 983,\n PANIC_CAST_FROM_OBJECT = 984,\n PANIC_CAST_FROM_FUNCTION = 985,\n PANIC_CAST_FROM_NULL = 989,\n\n PANIC_UNHANDLED_EXCEPTION = 999,\n\n} PXT_PANIC;\n\nextern const uintptr_t functionsAndBytecode[];\nextern TValue *globals;\nextern uint16_t *bytecode;\nclass RefRecord;\n\n// Utility functions\n\ntypedef TValue (*RunActionType)(Action a, TValue arg0, TValue arg1, TValue arg2);\n\n#define asmRunAction3 ((RunActionType)(((uintptr_t *)bytecode)[12]))\n\nstatic inline TValue runAction3(Action a, TValue arg0, TValue arg1, TValue arg2) {\n return asmRunAction3(a, arg0, arg1, 0);\n}\nstatic inline TValue runAction2(Action a, TValue arg0, TValue arg1) {\n return asmRunAction3(a, arg0, arg1, 0);\n}\nstatic inline TValue runAction1(Action a, TValue arg0) {\n return asmRunAction3(a, arg0, 0, 0);\n}\nstatic inline TValue runAction0(Action a) {\n return asmRunAction3(a, 0, 0, 0);\n}\n\nclass RefAction;\nclass BoxedString;\nstruct VTable;\n\n//%\nAction mkAction(int totallen, RefAction *act);\n//% expose\nint templateHash();\n//% expose\nint programHash();\n//% expose\nBoxedString *programName();\n//% expose\nunsigned programSize();\n//%\nint getNumGlobals();\n//%\nRefRecord *mkClassInstance(VTable *vt);\n//%\nvoid debugMemLeaks();\n//%\nvoid anyPrint(TValue v);\n\n//%\nint getConfig(int key, int defl = -1);\n\n//%\nint toInt(TNumber v);\n//%\nunsigned toUInt(TNumber v);\n//%\nNUMBER toDouble(TNumber v);\n//%\nfloat toFloat(TNumber v);\n//%\nTNumber fromDouble(NUMBER r);\n//%\nTNumber fromFloat(float r);\n\n//%\nTNumber fromInt(int v);\n//%\nTNumber fromUInt(unsigned v);\n//%\nTValue fromBool(bool v);\n//%\nbool eq_bool(TValue a, TValue b);\n//%\nbool eqq_bool(TValue a, TValue b);\n\n//%\nvoid failedCast(TValue v, void *addr = NULL);\n//%\nvoid missingProperty(TValue v);\n\nvoid error(PXT_PANIC code, int subcode = 0);\nvoid exec_binary(unsigned *pc);\nvoid start();\n\nstruct HandlerBinding {\n HandlerBinding *next;\n int source;\n int value;\n Action action;\n#ifndef PXT_CODAL\n uint32_t flags;\n struct Event *pending;\n#endif\n};\nHandlerBinding *findBinding(int source, int value);\nHandlerBinding *nextBinding(HandlerBinding *curr, int source, int value);\nvoid setBinding(int source, int value, Action act);\n\n// Legacy stuff; should no longer be used\n//%\nTValue incr(TValue e);\n//%\nvoid decr(TValue e);\n\ninline TValue incr(TValue e) {\n return e;\n}\ninline void decr(TValue e) {}\n\nclass RefObject;\n\nstatic inline RefObject *incrRC(RefObject *r) {\n return r;\n}\nstatic inline void decrRC(RefObject *) {}\n\ninline void *ptrOfLiteral(int offset) {\n return &bytecode[offset];\n}\n\n// Checks if object is ref-counted, and has a custom PXT vtable in front\n// TODO\ninline bool isRefCounted(TValue e) {\n return isPointer(e);\n}\n\ninline void check(int cond, PXT_PANIC code, int subcode = 0) {\n if (!cond)\n error(code, subcode);\n}\n\ninline void oops(int subcode = 0) {\n target_panic(800 + subcode);\n}\n\nclass RefObject;\n\ntypedef void (*RefObjectMethod)(RefObject *self);\ntypedef unsigned (*RefObjectSizeMethod)(RefObject *self);\ntypedef void *PVoid;\ntypedef void **PPVoid;\n\ntypedef void *Object_;\n\n#define VTABLE_MAGIC 0xF9\n#define VTABLE_MAGIC2 0xF8\n\nenum class ValType : uint8_t {\n Undefined,\n Boolean,\n Number,\n String,\n Object,\n Function,\n};\n\n// keep in sync with pxt-core (search for the type name)\nenum class BuiltInType : uint16_t {\n BoxedString = 1,\n BoxedNumber = 2,\n BoxedBuffer = 3,\n RefAction = 4,\n RefImage = 5,\n RefCollection = 6,\n RefRefLocal = 7,\n RefMap = 8,\n RefMImage = 9, // microbit-specific\n MMap = 10, // linux, mostly ev3\n BoxedString_SkipList = 11, // used by VM bytecode representation only\n BoxedString_ASCII = 12, // ditto\n ZPin = 13,\n User0 = 16,\n};\n\nstruct VTable {\n uint16_t numbytes;\n ValType objectType;\n uint8_t magic;\n#ifdef PXT_VM\n uint16_t ifaceHashEntries;\n BuiltInType lastClassNo;\n#else\n PVoid *ifaceTable;\n#endif\n BuiltInType classNo;\n uint16_t reserved;\n uint32_t ifaceHashMult;\n\n // we only use the first few methods here; pxt will generate more\n PVoid methods[8];\n};\n\n//%\nextern const VTable string_inline_ascii_vt;\n#if PXT_UTF8\n//%\nextern const VTable string_inline_utf8_vt;\n//%\nextern const VTable string_cons_vt;\n//%\nextern const VTable string_skiplist16_vt;\n//%\nextern const VTable string_skiplist16_packed_vt;\n#endif\n//%\nextern const VTable buffer_vt;\n//%\nextern const VTable number_vt;\n//%\nextern const VTable RefAction_vtable;\n\n#ifndef PXT_IS_READONLY\n// assume ARM - ram addresses are 0x2000_0000+; flash is either 0x0+ or 0x0800_0000+\n#define PXT_IS_READONLY(v) (isTagged(v) || !((uintptr_t)v >> 28))\n#endif\n\ninline bool isReadOnly(TValue v) {\n return PXT_IS_READONLY(v);\n}\n\n// A base abstract class for ref-counted objects.\nclass RefObject {\n public:\n const VTable *vtable;\n\n RefObject(const VTable *vt) {\n#if defined(PXT32) && defined(PXT_VM) && !defined(PXT_ESP32)\n if ((uint32_t)vt & 0xf0000000)\n target_panic(PANIC_INVALID_VTABLE);\n#endif\n vtable = vt;\n }\n\n void destroyVT();\n void printVT();\n\n inline uintptr_t vt() { return (uintptr_t)vtable; }\n inline void setVT(uintptr_t v) { vtable = (const VTable *)v; }\n\n inline void ref() {}\n inline void unref() {}\n inline bool isReadOnly() { return pxt::isReadOnly((TValue)this); }\n};\n\nclass Segment {\n private:\n TValue *data;\n ramint_t length;\n ramint_t size;\n\n // this just gives max value of ramint_t\n void growByMin(ramint_t minSize);\n void ensure(ramint_t newSize);\n\n public:\n static constexpr ramint_t MaxSize = (((1U << (8 * sizeof(ramint_t) - 1)) - 1) << 1) + 1;\n static constexpr TValue DefaultValue = TAG_UNDEFINED; // == NULL\n\n Segment() : data(nullptr), length(0), size(0) {}\n\n TValue get(unsigned i) { return i < length ? data[i] : NULL; }\n void set(unsigned i, TValue value);\n\n unsigned getLength() { return length; };\n void setLength(unsigned newLength);\n\n void push(TValue value) { set(length, value); }\n TValue pop();\n\n TValue remove(unsigned i);\n void insert(unsigned i, TValue value);\n\n void destroy();\n\n void print();\n\n TValue *getData() { return data; }\n};\n\n// Low-Level segment using system malloc\nclass LLSegment {\n private:\n TValue *data;\n ramint_t length;\n ramint_t size;\n\n public:\n LLSegment() : data(nullptr), length(0), size(0) {}\n\n void set(unsigned idx, TValue v);\n void push(TValue value) { set(length, value); }\n TValue pop();\n void destroy();\n void setLength(unsigned newLen);\n\n TValue get(unsigned i) { return i < length ? data[i] : NULL; }\n unsigned getLength() { return length; };\n TValue *getData() { return data; }\n};\n\n// A ref-counted collection of either primitive or ref-counted objects (String, Image,\n// user-defined record, another collection)\nclass RefCollection : public RefObject {\n public:\n Segment head;\n\n RefCollection();\n\n static void destroy(RefCollection *coll);\n static void scan(RefCollection *coll);\n static unsigned gcsize(RefCollection *coll);\n static void print(RefCollection *coll);\n\n unsigned length() { return head.getLength(); }\n void setLength(unsigned newLength) { head.setLength(newLength); }\n TValue getAt(int i) { return head.get(i); }\n TValue *getData() { return head.getData(); }\n};\n\nclass RefMap : public RefObject {\n public:\n Segment keys;\n Segment values;\n\n RefMap();\n static void destroy(RefMap *map);\n static void scan(RefMap *map);\n static unsigned gcsize(RefMap *coll);\n static void print(RefMap *map);\n int findIdx(BoxedString *key);\n};\n\n// A ref-counted, user-defined JS object.\nclass RefRecord : public RefObject {\n public:\n // The object is allocated, so that there is space at the end for the fields.\n TValue fields[];\n\n RefRecord(VTable *v) : RefObject(v) {}\n\n TValue ld(int idx);\n TValue ldref(int idx);\n void st(int idx, TValue v);\n void stref(int idx, TValue v);\n};\n\nstatic inline VTable *getVTable(RefObject *r) {\n return (VTable *)(r->vt() & ~1);\n}\n\nstatic inline VTable *getAnyVTable(TValue v) {\n if (!isRefCounted(v))\n return NULL;\n auto vt = getVTable((RefObject *)v);\n if (vt->magic == VTABLE_MAGIC)\n return vt;\n return NULL;\n}\n\n// these are needed when constructing vtables for user-defined classes\n//%\nvoid RefRecord_destroy(RefRecord *r);\n//%\nvoid RefRecord_print(RefRecord *r);\n//%\nvoid RefRecord_scan(RefRecord *r);\n//%\nunsigned RefRecord_gcsize(RefRecord *r);\n\ntypedef TValue (*ActionCB)(TValue *captured, TValue arg0, TValue arg1, TValue arg2);\n\n// Ref-counted function pointer.\nclass RefAction : public RefObject {\n public:\n uint16_t len;\n uint16_t numArgs;\n#ifdef PXT_VM\n uint16_t initialLen;\n uint16_t flags;\n uintptr_t func;\n#else\n ActionCB func; // The function pointer\n#endif\n // fields[] contain captured locals\n TValue fields[];\n\n static void destroy(RefAction *act);\n static void scan(RefAction *act);\n static unsigned gcsize(RefAction *coll);\n static void print(RefAction *act);\n\n RefAction();\n\n inline void stCore(int idx, TValue v) {\n // DMESG(\"ST [%d] = %d \", idx, v); this->print();\n intcheck(0 <= idx && idx < len, PANIC_OUT_OF_BOUNDS, 10);\n intcheck(fields[idx] == 0, PANIC_OUT_OF_BOUNDS, 11); // only one assignment permitted\n fields[idx] = v;\n }\n};\n\n// These two are used to represent locals written from inside inline functions\nclass RefRefLocal : public RefObject {\n public:\n TValue v;\n static void destroy(RefRefLocal *l);\n static void scan(RefRefLocal *l);\n static unsigned gcsize(RefRefLocal *l);\n static void print(RefRefLocal *l);\n RefRefLocal();\n};\n\ntypedef int color;\n\n// note: this is hardcoded in PXT (hexfile.ts)\n\nclass BoxedNumber : public RefObject {\n public:\n NUMBER num;\n BoxedNumber() : RefObject(&number_vt) {}\n} __attribute__((packed));\n\nclass BoxedString : public RefObject {\n public:\n union {\n struct {\n uint16_t length; // ==size\n char data[0];\n } ascii;\n#if PXT_UTF8\n struct {\n uint16_t size;\n char data[0];\n } utf8;\n struct {\n BoxedString *left;\n BoxedString *right;\n } cons;\n struct {\n uint16_t size; // in bytes\n uint16_t length; // in characters\n uint16_t *list;\n } skip;\n struct {\n uint16_t size; // in bytes\n uint16_t length; // in characters\n uint16_t list[0];\n } skip_pack;\n#endif\n };\n\n#if PXT_UTF8\n uintptr_t runMethod(int idx) {\n return ((uintptr_t(*)(BoxedString *))vtable->methods[idx])(this);\n }\n const char *getUTF8Data() { return (const char *)runMethod(4); }\n uint32_t getUTF8Size() { return (uint32_t)runMethod(5); }\n // in characters\n uint32_t getLength() { return (uint32_t)runMethod(6); }\n const char *getUTF8DataAt(uint32_t pos) {\n auto meth = ((const char *(*)(BoxedString *, uint32_t))vtable->methods[7]);\n return meth(this, pos);\n }\n#else\n const char *getUTF8Data() { return ascii.data; }\n uint32_t getUTF8Size() { return ascii.length; }\n uint32_t getLength() { return ascii.length; }\n const char *getUTF8DataAt(uint32_t pos) { return pos < ascii.length ? ascii.data + pos : NULL; }\n#endif\n\n TNumber charCodeAt(int pos);\n\n BoxedString(const VTable *vt) : RefObject(vt) {}\n};\n\n// cross version compatible way of accessing string data\n#ifndef PXT_STRING_DATA\n#define PXT_STRING_DATA(str) str->getUTF8Data()\n#endif\n\n// cross version compatible way of accessing string length\n#ifndef PXT_STRING_DATA_LENGTH\n#define PXT_STRING_DATA_LENGTH(str) str->getUTF8Size()\n#endif\n\nclass BoxedBuffer : public RefObject {\n public:\n // data needs to be word-aligned, so we use 32 bits for length\n int length;\n uint8_t data[0];\n BoxedBuffer() : RefObject(&buffer_vt) {}\n\n static bool isInstance(TValue v);\n};\n\n// cross version compatible way of access data field\n#ifndef PXT_BUFFER_DATA\n#define PXT_BUFFER_DATA(buffer) buffer->data\n#endif\n\n// cross version compatible way of access data length\n#ifndef PXT_BUFFER_LENGTH\n#define PXT_BUFFER_LENGTH(buffer) buffer->length\n#endif\n\n#ifndef PXT_CREATE_BUFFER\n#define PXT_CREATE_BUFFER(data, len) pxt::mkBuffer(data, len)\n#endif\n\n// Legacy format:\n// the first byte of data indicates the format - currently 0xE1 or 0xE4 to 1 or 4 bit bitmaps\n// second byte indicates width in pixels\n// third byte indicates the height (which should also match the size of the buffer)\n// just like ordinary buffers, these can be layed out in flash\n\n// Current format:\n// 87 BB WW WW HH HH 00 00 DATA\n// that is: 0x87, 0x01 or 0x04 - bpp, width in little endian, height, 0x00, 0x00 followed by data\n// for 4 bpp images, rows are word-aligned (as in legacy)\n\n#define IMAGE_HEADER_MAGIC 0x87\n\nstruct ImageHeader {\n uint8_t magic;\n uint8_t bpp;\n uint16_t width;\n uint16_t height;\n uint16_t padding;\n uint8_t pixels[0];\n};\n\nclass RefImage : public RefObject {\n public:\n BoxedBuffer *buffer;\n uint32_t revision;\n\n RefImage(BoxedBuffer *buf);\n RefImage(uint32_t sz);\n\n void setBuffer(BoxedBuffer *b);\n\n uint8_t *data() { return buffer->data; }\n int length() { return (int)buffer->length; }\n\n ImageHeader *header() { return (ImageHeader *)buffer->data; }\n int pixLength() { return length() - sizeof(ImageHeader); }\n\n int width() { return header()->width; }\n int height() { return header()->height; }\n int wordHeight();\n int bpp() { return header()->bpp; }\n\n bool hasPadding() { return (height() & 0x7) != 0; }\n\n uint8_t *pix() { return header()->pixels; }\n\n int byteHeight() {\n if (bpp() == 1)\n return (height() + 7) >> 3;\n else if (bpp() == 4)\n return ((height() * 4 + 31) >> 5) << 2;\n else {\n oops(21);\n return -1;\n }\n }\n\n uint8_t *pix(int x, int y) {\n uint8_t *d = &pix()[byteHeight() * x];\n if (y) {\n if (bpp() == 1)\n d += y >> 3;\n else if (bpp() == 4)\n d += y >> 1;\n }\n return d;\n }\n\n uint8_t fillMask(color c);\n bool inRange(int x, int y);\n void clamp(int *x, int *y);\n void makeWritable();\n\n static void destroy(RefImage *t);\n static void scan(RefImage *t);\n static unsigned gcsize(RefImage *t);\n static void print(RefImage *t);\n};\n\nRefImage *mkImage(int w, int h, int bpp);\n\ntypedef BoxedBuffer *Buffer;\ntypedef BoxedString *String;\ntypedef RefImage *Image_;\n\nuint32_t toRealUTF8(String str, uint8_t *dst);\n\n// keep in sync with github/pxt/pxtsim/libgeneric.ts\nenum class NumberFormat {\n Int8LE = 1,\n UInt8LE,\n Int16LE,\n UInt16LE,\n Int32LE,\n Int8BE,\n UInt8BE,\n Int16BE,\n UInt16BE,\n Int32BE,\n\n UInt32LE,\n UInt32BE,\n Float32LE,\n Float64LE,\n Float32BE,\n Float64BE,\n};\n\n// this will, unlike mkStringCore, UTF8-canonicalize the data\nString mkString(const char *data, int len = -1);\n// data can be NULL in both cases\nBuffer mkBuffer(const void *data, int len);\nString mkStringCore(const char *data, int len = -1);\n\nTNumber getNumberCore(uint8_t *buf, int size, NumberFormat format);\nvoid setNumberCore(uint8_t *buf, int size, NumberFormat format, TNumber value);\n\nvoid seedRandom(unsigned seed);\nvoid seedAddRandom(unsigned seed);\n// max is inclusive\nunsigned getRandom(unsigned max);\n\nValType valType(TValue v);\n\n// this is equivalent to JS `throw v`; it will leave\n// the current function(s), all the way until the nearest try block and\n// ignore all destructors (think longjmp())\nvoid throwValue(TValue v);\n\nvoid registerGC(TValue *root, int numwords = 1);\nvoid unregisterGC(TValue *root, int numwords = 1);\nvoid registerGCPtr(TValue ptr);\nvoid unregisterGCPtr(TValue ptr);\nstatic inline void registerGCObj(RefObject *ptr) {\n registerGCPtr((TValue)ptr);\n}\nstatic inline void unregisterGCObj(RefObject *ptr) {\n unregisterGCPtr((TValue)ptr);\n}\nvoid gc(int flags);\n\nstruct StackSegment {\n void *top;\n void *bottom;\n StackSegment *next;\n};\n\n#define NUM_TRY_FRAME_REGS 3\nstruct TryFrame {\n TryFrame *parent;\n uintptr_t registers[NUM_TRY_FRAME_REGS];\n};\n\nstruct ThreadContext {\n TValue *globals;\n StackSegment stack;\n TryFrame *tryFrame;\n TValue thrownValue;\n#ifdef PXT_GC_THREAD_LIST\n ThreadContext *next;\n ThreadContext *prev;\n#endif\n};\n\n#ifdef PXT_GC_THREAD_LIST\nextern ThreadContext *threadContexts;\nvoid *threadAddressFor(ThreadContext *, void *sp);\n#endif\n\nvoid releaseThreadContext(ThreadContext *ctx);\nThreadContext *getThreadContext();\nvoid setThreadContext(ThreadContext *ctx);\n\n#ifndef PXT_GC_THREAD_LIST\nvoid gcProcessStacks(int flags);\n#endif\n\nvoid gcProcess(TValue v);\nvoid gcFreeze();\n\n#ifdef PXT_VM\nvoid gcStartup();\nvoid gcPreStartup();\n#endif\n\nvoid coreReset();\nvoid gcReset();\nvoid systemReset();\n\nvoid doNothing();\n\nvoid *gcAllocate(int numbytes);\nvoid *gcAllocateArray(int numbytes);\nextern \"C\" void *app_alloc(int numbytes);\nextern \"C\" void *app_free(void *ptr);\nextern \"C\" void *app_alloc_at(void *at, int numbytes);\nvoid gcPreAllocateBlock(uint32_t sz);\n\nint redirectSamples(int16_t *dst, int numsamples, int samplerate);\n\n#ifdef PXT64\n#define TOWORDS(bytes) (((bytes) + 7) >> 3)\n#else\n#define TOWORDS(bytes) (((bytes) + 3) >> 2)\n#endif\n\n#ifndef PXT_VM\n#define soft_panic target_panic\n#endif\n\nextern int debugFlags;\n\nenum class PerfCounters {\n GC,\n};\n\n#ifdef PXT_PROFILE\n#ifndef PERF_NOW\n#error \"missing platform timer support\"\n#endif\n\nstruct PerfCounter {\n uint32_t value;\n uint32_t numstops;\n uint32_t start;\n};\n\nextern struct PerfCounter *perfCounters;\n\nvoid initPerfCounters();\n//%\nvoid dumpPerfCounters();\n//%\nvoid startPerfCounter(PerfCounters n);\n//%\nvoid stopPerfCounter(PerfCounters n);\n#else\ninline void startPerfCounter(PerfCounters n) {}\ninline void stopPerfCounter(PerfCounters n) {}\ninline void initPerfCounters() {}\ninline void dumpPerfCounters() {}\n#endif\n\n// Handling of built-in string literals (like \"[Object]\", \"true\" etc.).\n\n// This has the same layout as BoxedString, but has statically allocated buffer\ntemplate <size_t N> struct BoxedStringLayout {\n const void *vtable;\n uint16_t size;\n const char data[N];\n};\n\ntemplate <size_t N> constexpr size_t _boxedStringLen(char const (&)[N]) {\n return N;\n}\n\n// strings defined here as used as (String)name\n#define PXT_DEF_STRING(name, val) \\\n const BoxedStringLayout<_boxedStringLen(val)> name[1] = { \\\n {&pxt::string_inline_ascii_vt, _boxedStringLen(val) - 1, val}};\n\n// bigger value - less memory, but slower\n// 16/20 keeps s.length and s.charCodeAt(i) at about 200 cycles (for actual unicode strings),\n// which is similar to amortized allocation time\n#define PXT_STRING_SKIP_INCR 16 // needs to be power of 2; needs to be kept in sync with compiler\n#define PXT_STRING_MIN_SKIP \\\n 20 // min. size of string to use skip list; static code has its own limit\n\n#define PXT_NUM_SKIP_ENTRIES(p) ((p)->skip.length / PXT_STRING_SKIP_INCR)\n#define PXT_SKIP_DATA_IND(p) ((const char *)(p->skip.list + PXT_NUM_SKIP_ENTRIES(p)))\n#define PXT_SKIP_DATA_PACK(p) ((const char *)(p->skip_pack.list + PXT_NUM_SKIP_ENTRIES(p)))\n\n} // namespace pxt\n\nusing namespace pxt;\n\nnamespace numops {\n//%\nString toString(TValue v);\n//%\nint toBool(TValue v);\n//%\nint toBoolDecr(TValue v);\n} // namespace numops\n\nnamespace pxt {\ninline bool toBoolQuick(TValue v) {\n if (v == TAG_TRUE)\n return true;\n if (v == TAG_FALSE || v == TAG_UNDEFINED || v == TAG_NULL)\n return false;\n return numops::toBool(v);\n}\n} // namespace pxt\n\nnamespace pxtrt {\n//%\nRefMap *mkMap();\n//%\nTValue mapGetByString(RefMap *map, String key);\n//%\nint lookupMapKey(String key);\n//%\nTValue mapGet(RefMap *map, unsigned key);\n//% expose\nvoid mapSetByString(RefMap *map, String key, TValue val);\n//%\nvoid mapSet(RefMap *map, unsigned key, TValue val);\n} // namespace pxtrt\n\nnamespace pins {\nBuffer createBuffer(int size);\n}\n\nnamespace String_ {\n//%\nint compare(String a, String b);\n} // namespace String_\n\nnamespace Array_ {\n//%\nRefCollection *mk();\n//%\nint length(RefCollection *c);\n//%\nvoid setLength(RefCollection *c, int newLength);\n//%\nvoid push(RefCollection *c, TValue x);\n//%\nTValue pop(RefCollection *c);\n//%\nTValue getAt(RefCollection *c, int x);\n//%\nvoid setAt(RefCollection *c, int x, TValue y);\n//%\nTValue removeAt(RefCollection *c, int x);\n//%\nvoid insertAt(RefCollection *c, int x, TValue value);\n//%\nint indexOf(RefCollection *c, TValue x, int start);\n//%\nbool removeElement(RefCollection *c, TValue x);\n} // namespace Array_\n\n#define NEW_GC(T, ...) new (gcAllocate(sizeof(T))) T(__VA_ARGS__)\n\n// The ARM Thumb generator in the JavaScript code is parsing\n// the hex file and looks for the magic numbers as present here.\n//\n// Then it fetches function pointer addresses from there.\n//\n// The vtable pointers are there, so that the ::emptyData for various types\n// can be patched with the right vtable.\n//\n#define PXT_SHIMS_BEGIN \\\n namespace pxt { \\\n const uintptr_t functionsAndBytecode[] \\\n __attribute__((aligned(0x20))) = {0x08010801, 0x42424242, 0x08010801, 0x8de9d83e,\n\n#define PXT_SHIMS_END \\\n } \\\n ; \\\n }\n\n#if !defined(X86_64) && !defined(PXT_VM)\n#pragma GCC diagnostic ignored \"-Wpmf-conversions\"\n#endif\n\n#ifdef PXT_VM\n#define DEF_VTABLE(name, tp, valtype, ...) \\\n const VTable name = {sizeof(tp), valtype, VTABLE_MAGIC, 0, BuiltInType::tp, BuiltInType::tp, \\\n 0, 0, {__VA_ARGS__}};\n#define DEF_VTABLE_EXT(name, tp, valtype, ...) \\\n const VTable name = {sizeof(tp), valtype, VTABLE_MAGIC2, 0, BuiltInType::tp, BuiltInType::tp, \\\n 0, 0, {__VA_ARGS__}};\n#else\n#define DEF_VTABLE(name, tp, valtype, ...) \\\n const VTable name = {sizeof(tp), valtype, VTABLE_MAGIC, 0, BuiltInType::tp, \\\n 0, 0, {__VA_ARGS__}};\n#define DEF_VTABLE_EXT(name, tp, valtype, ...) \\\n const VTable name = {sizeof(tp), valtype, VTABLE_MAGIC2, 0, BuiltInType::tp, \\\n 0, 0, {__VA_ARGS__}};\n#endif\n\n#define PXT_VTABLE(classname, valtp) \\\n DEF_VTABLE(classname##_vtable, classname, valtp, (void *)&classname::destroy, \\\n (void *)&classname::print, (void *)&classname::scan, (void *)&classname::gcsize)\n\n#define PXT_EXT_VTABLE(classname) \\\n static int classname##_gcsize() { return sizeof(classname); } \\\n DEF_VTABLE_EXT(classname##_vtable, classname, ValType::Object, (void *)&pxt::doNothing, \\\n (void *)&pxt::anyPrint, (void *)&pxt::doNothing, (void *)&classname##_gcsize)\n\n#define PXT_VTABLE_INIT(classname) RefObject(&classname##_vtable)\n\n#define PXT_VTABLE_CTOR(classname) \\\n PXT_VTABLE(classname, ValType::Object) \\\n classname::classname() : PXT_VTABLE_INIT(classname)\n\n#define PXT_MAIN \\\n int main() { \\\n pxt::start(); \\\n return 0; \\\n }\n\n#define PXT_FNPTR(x) (uintptr_t)(void *)(x)\n\n#define PXT_ABI(...)\n\n#define JOIN(a, b) a##b\n/// Defines getClassName() function to fetch the singleton\n#define SINGLETON(ClassName) \\\n static ClassName *JOIN(inst, ClassName); \\\n ClassName *JOIN(get, ClassName)() { \\\n if (!JOIN(inst, ClassName)) \\\n JOIN(inst, ClassName) = new ClassName(); \\\n return JOIN(inst, ClassName); \\\n }\n\n/// Defines getClassName() function to fetch the singleton if PIN present\n#define SINGLETON_IF_PIN(ClassName, pin) \\\n static ClassName *JOIN(inst, ClassName); \\\n ClassName *JOIN(get, ClassName)() { \\\n if (!JOIN(inst, ClassName) && LOOKUP_PIN(pin)) \\\n JOIN(inst, ClassName) = new ClassName(); \\\n return JOIN(inst, ClassName); \\\n }\n\n#ifdef PXT_VM\n#include \"vm.h\"\n#endif\n\n#endif\n",
|
|
2774
2774
|
"pxtcore.h": "#ifndef __PXTCORE_H\n#define __PXTCORE_H\n\n#include \"MicroBit.h\"\n#include \"MicroBitImage.h\"\n#include \"ManagedString.h\"\n#include \"ManagedType.h\"\n\nnamespace pxt {\nvoid debuglog(const char *format, ...);\n}\n\n// #define GC_GET_HEAP_SIZE() device_heap_size(0)\n#define xmalloc malloc\n#define xfree free\n\n#define GC_MAX_ALLOC_SIZE 9000\n\n#define NON_GC_HEAP_RESERVATION 1024\n\n#ifdef CODAL_CONFIG_H\n#define MICROBIT_CODAL 1\n#else\n#define MICROBIT_CODAL 0\n#define GC_BLOCK_SIZE 256\n#endif\n\n#if !MICROBIT_CODAL\n#undef DMESG\n#define DMESG NOLOG\n#endif\n\n#undef BYTES_TO_WORDS\n\n#endif\n",
|
|
2775
2775
|
"pxtparts.json": "{\n \"buttonpair\": {\n \"simulationBehavior\": \"buttonpair\",\n \"visual\": {\n \"builtIn\": \"buttonpair\",\n \"width\": 75,\n \"height\": 45,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 30,\n \"y\": 45\n },\n {\n \"x\": 45,\n \"y\": 0\n },\n {\n \"x\": 75,\n \"y\": 45\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"P14\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"P15\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"singleton\"\n },\n \"assembly\": [\n {\n \"part\": true\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n },\n {\n \"pinIndices\": [\n 2,\n 3\n ]\n }\n ]\n },\n \"microservo\": {\n \"simulationBehavior\": \"microservo\",\n \"visual\": {\n \"builtIn\": \"microservo\",\n \"width\": 74.85,\n \"height\": 200,\n \"pinDistance\": 10,\n \"pinLocations\": [\n {\n \"x\": 30,\n \"y\": 5\n },\n {\n \"x\": 37,\n \"y\": 5\n },\n {\n \"x\": 45,\n \"y\": 5\n }\n ]\n },\n \"numberOfPins\": 3,\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"croc\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"croc\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"croc\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiations\": [\n {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"pins.servoWritePin,pins.servoSetPulse,PwmOnlyPin.servoWrite,PwmOnlyPin.servoSetPulse,servos.Servo.setAngle,servos.Servo.run,servos.Servo.setPulse\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n }\n ],\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 2\n ]\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n }\n ]\n },\n \"neopixel\": {\n \"simulationBehavior\": \"neopixel\",\n \"visual\": {\n \"builtIn\": \"neopixel\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 19,\n \"y\": 0\n },\n {\n \"x\": 28,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 3,\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"croc\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"croc\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"croc\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"neopixel.create\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"pin\"\n },\n {\n \"partParameter\": \"mode\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 2\n ]\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n }\n ]\n },\n \"ledmatrix\": {\n \"visual\": {\n \"builtIn\": \"ledmatrix\",\n \"width\": 105,\n \"height\": 105,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 15,\n \"y\": 0\n },\n {\n \"x\": 30,\n \"y\": 0\n },\n {\n \"x\": 45,\n \"y\": 0\n },\n {\n \"x\": 105,\n \"y\": 105\n },\n {\n \"x\": 0,\n \"y\": 105\n },\n {\n \"x\": 15,\n \"y\": 105\n },\n {\n \"x\": 30,\n \"y\": 105\n },\n {\n \"x\": 45,\n \"y\": 105\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"ledmatrix\",\n \"numberOfPins\": 10,\n \"instantiation\": {\n \"kind\": \"singleton\"\n },\n \"pinDefinitions\": [\n {\n \"target\": \"P6\",\n \"style\": \"male\",\n \"orientation\": \"-Z\",\n \"colorGroup\": 0\n },\n {\n \"target\": \"P7\",\n \"style\": \"male\",\n \"orientation\": \"-Z\",\n \"colorGroup\": 0\n },\n {\n \"target\": \"P8\",\n \"style\": \"male\",\n \"orientation\": \"-Z\",\n \"colorGroup\": 0\n },\n {\n \"target\": \"P9\",\n \"style\": \"male\",\n \"orientation\": \"-Z\",\n \"colorGroup\": 0\n },\n {\n \"target\": \"P10\",\n \"style\": \"male\",\n \"orientation\": \"-Z\",\n \"colorGroup\": 0\n },\n {\n \"target\": \"P12\",\n \"style\": \"male\",\n \"orientation\": \"-Z\",\n \"colorGroup\": 1\n },\n {\n \"target\": \"P13\",\n \"style\": \"male\",\n \"orientation\": \"-Z\",\n \"colorGroup\": 1\n },\n {\n \"target\": \"P16\",\n \"style\": \"male\",\n \"orientation\": \"-Z\",\n \"colorGroup\": 1\n },\n {\n \"target\": \"P19\",\n \"style\": \"male\",\n \"orientation\": \"-Z\",\n \"colorGroup\": 1\n },\n {\n \"target\": \"P20\",\n \"style\": \"male\",\n \"orientation\": \"-Z\",\n \"colorGroup\": 1\n }\n ],\n \"assembly\": [\n {\n \"part\": true\n },\n {\n \"pinIndices\": [\n 0,\n 1,\n 2,\n 3,\n 4\n ]\n },\n {\n \"pinIndices\": [\n 5,\n 6,\n 7,\n 8,\n 9\n ]\n }\n ]\n },\n \"headphone\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"image\": \"parts/headphone.svg\",\n \"width\": 142,\n \"height\": 180,\n \"pinDistance\": 20,\n \"pinLocations\": [\n {\n \"x\": 17,\n \"y\": 11\n },\n {\n \"x\": 55,\n \"y\": 50\n }\n ]\n },\n \"pinDefinitions\": [\n {\n \"target\": \"P0\",\n \"style\": \"croc\",\n \"orientation\": \"Y\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"croc\",\n \"orientation\": \"Y\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"singleton\"\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"speaker\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"image\": \"parts/speaker.svg\",\n \"width\": 500,\n \"height\": 500,\n \"pinDistance\": 70,\n \"pinLocations\": [\n {\n \"x\": 180,\n \"y\": 135\n },\n {\n \"x\": 320,\n \"y\": 135\n }\n ]\n },\n \"pinDefinitions\": [\n {\n \"target\": \"P0\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"singleton\"\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n }\n}",
|
|
2776
2776
|
"sendbuffer.s": ".syntax unified\n.section .text.neopixel_send_buffer_core\n.global neopixel_send_buffer_core\n\nneopixel_send_buffer_core:\n push {r4,r5,r6,r7,lr}\n \n mov r4, r1 // ptr\n mov r5, r2 // len\n \n ldr r0, [r0, #8] // get mbed DigitalOut from MicroBitPin\n ldr r1, [r0, #4] // r1-mask for this pin\n ldr r2, [r0, #16] // r2-clraddr\n ldr r3, [r0, #12] // r3-setaddr\n \n b .start\n \n.nextbit: // C0\n str r1, [r3, #0] // pin := hi C2\n tst r6, r0 // C3\n bne .islate // C4\n str r1, [r2, #0] // pin := lo C6\n.islate:\n lsrs r6, r6, #1 // r6 >>= 1 C7\n bne .justbit // C8\n \n // not just a bit - need new byte\n adds r4, #1 // r4++ C9\n subs r5, #1 // r5-- C10\n bcc .stop // if (r5<0) goto .stop C11\n.start:\n movs r6, #0x80 // reset mask C12\n nop // C13\n\n.common: // C13\n str r1, [r2, #0] // pin := lo C15\n // always re-load byte - it just fits with the cycles better this way\n ldrb r0, [r4, #0] // r0 := *r4 C17\n b .nextbit // C20\n\n.justbit: // C10\n // no nops, branch taken is already 3 cycles\n b .common // C13\n\n.stop: \n str r1, [r2, #0] // pin := lo\n\n pop {r4,r5,r6,r7,pc}\n",
|
|
2777
2777
|
"sendbufferbrightness.s": ".syntax unified\r\n.section .text.neopixel_send_buffer_brightness_core\r\n.global neopixel_send_buffer_brightness_core\r\n\r\nneopixel_send_buffer_brightness_core:\r\n\r\n push {r4,r5,r6,r7,lr}\r\n \r\n mov r4, r1 // ptr\r\n mov r5, r2 // len\r\n mov r7, r3 // get the brightness figure\r\n \r\n ldr r0, [r0, #8] // get mbed DigitalOut from MicroBitPin\r\n ldr r1, [r0, #4] // r1-mask for this pin\r\n ldr r2, [r0, #16] // r2-clraddr\r\n ldr r3, [r0, #12] // r3-setaddr\r\n \r\n b .start\r\n \r\n.nextbit: // C0\r\n str r1, [r3, #0] // pin := hi C2\r\n tst r6, r0 // C3\r\n bne .islate // C4\r\n str r1, [r2, #0] // pin := lo C6\r\n.islate:\r\n lsrs r6, r6, #1 // r6 >>= 1 C7\r\n bne .justbit // C8\r\n \r\n // not just a bit - need new byte\r\n adds r4, #1 // r4++ C9\r\n subs r5, #1 // r5-- C10\r\n bcc .stop // if (r5<0) goto .stop C11\r\n.start:\r\n movs r6, #0x80 // reset mask C12\r\n ldrb r0, [r4, #0] // r0 := *r4 \r\n muls r0, r7 // hope we have single cycle multiplier...\r\n lsrs r0, r0, #8 // r0 >>= 8 following multiplication\r\n \r\n.common: // C13\r\n str r1, [r2, #0] // pin := lo C15\r\n nop // twiddle \r\n nop // twaddle\r\n \r\n b .nextbit // C20\r\n\r\n.justbit: // C10\r\n // no nops, branch taken is already 3 cycles\r\n b .common // C13\r\n\r\n.stop: \r\n str r1, [r2, #0] // pin := lo\r\n\r\n pop {r4,r5,r6,r7,pc}",
|
|
2778
2778
|
"sendbuffernrf52.s": ".syntax unified\n\n#ifndef NRF51\n\n// put it in RAM\n.section .data.neopixel_send_buffer_nrf52\n.global neopixel_send_buffer_nrf52\n.thumb\n.type neopixel_send_buffer_nrf52, %function\n\n\n\n\nneopixel_send_buffer_nrf52:\n push {r4,r5,r6,r7,lr}\n \n lsrs r7, r1, #20 // r7 - brightness\n ands r1, #0xff\n movs r4, #1\n lsls r1, r4, r1 // r1 - mask\n\n mov r4, r2 // ptr\n mov r5, r3 // len\n mov r3, r0 // port+0x500\n \n b .start\n.nextbit:\n str r1, [r3, #0x8] // pin := hi\n\n movs r2, #8\n tst r6, r0\n it eq\n movseq r2, #3\n\n.d1:\n subs r2, #1\n bne .d1\n\n str r1, [r3, #0xC] // pin := lo\n\n movs r2, #4\n tst r6, r0\n it eq\n movseq r2, #6\n\n lsrs r6, r6, #1 // r6 >>= 1 \n beq .reload\n\n nop\n nop\n nop\n\n.d0:\n subs r2, #1\n bne .d0\n\n b .nextbit\n\n.reload: \n subs r2, #2 // offset following operations\n.d2:\n subs r2, #1\n bne .d2\n\n // not just a bit - need new byte\n adds r4, #1 // r4++ \n subs r5, #1 // r5-- \n ble .stop // if (r5<=0) goto .stop \n.start:\n movs r6, #0x80 // reset mask\n ldrb r0, [r4, #0] // r0 := *r4 \n muls r0, r7 \n lsrs r0, r0, #8 // r0 >>= 8\n str r1, [r3, #0xC] // pin := lo \n b .nextbit //\n\n.stop: \n str r1, [r3, #0xC] // pin := lo\n\n pop {r4,r5,r6,r7,pc}\n\n#endif\n",
|
|
2779
|
-
"serial.cpp": "#include \"pxt.h\"\n\n#define MICROBIT_SERIAL_READ_BUFFER_LENGTH 64\n\n// make sure USB_TX and USB_RX don't overlap with other pin ids\n// also, 1001,1002 need to be kept in sync with getPin() function\nenum SerialPin {\n P0 = MICROBIT_ID_IO_P0,\n P1 = MICROBIT_ID_IO_P1,\n P2 = MICROBIT_ID_IO_P2,\n P8 = MICROBIT_ID_IO_P8,\n P12 = MICROBIT_ID_IO_P12,\n P13 = MICROBIT_ID_IO_P13,\n P14 = MICROBIT_ID_IO_P14,\n P15 = MICROBIT_ID_IO_P15,\n P16 = MICROBIT_ID_IO_P16,\n USB_TX = 1001,\n USB_RX = 1002\n};\n\nenum BaudRate {\n //% block=115200\n BaudRate115200 = 115200,\n //% block=57600\n BaudRate57600 = 57600,\n //% block=38400\n BaudRate38400 = 38400,\n //% block=31250\n BaudRate31250 = 31250,\n //% block=28800\n BaudRate28800 = 28800,\n //% block=19200\n BaudRate19200 = 19200,\n //% block=14400\n BaudRate14400 = 14400,\n //% block=9600\n BaudRate9600 = 9600,\n //% block=4800\n BaudRate4800 = 4800,\n //% block=2400\n BaudRate2400 = 2400,\n //% block=1200\n BaudRate1200 = 1200\n};\n\n//% weight=2 color=#002050 icon=\"\\uf287\"\n//% advanced=true\nnamespace serial {\n // note that at least one // followed by % is needed per declaration!\n\n /**\n * Read a line of text from the serial port and return the buffer when the delimiter is met.\n * @param delimiter text delimiter that separates each text chunk\n */\n //% help=serial/read-until\n //% blockId=serial_read_until block=\"serial|read until %delimiter=serial_delimiter_conv\"\n //% weight=19\n String readUntil(String delimiter) {\n return PSTR(uBit.serial.readUntil(MSTR(delimiter)));\n }\n\n /**\n * Read the buffered received data as a string\n */\n //% help=serial/read-string\n //% blockId=serial_read_buffer block=\"serial|read string\"\n //% weight=18\n String readString() {\n int n = uBit.serial.getRxBufferSize();\n if (n == 0) return mkString(\"\", 0);\n return PSTR(uBit.serial.read(n, MicroBitSerialMode::ASYNC));\n }\n\n /**\n * Register an event to be fired when one of the delimiter is matched.\n * @param delimiters the characters to match received characters against.\n */\n //% help=serial/on-data-received\n //% weight=18 blockId=serial_on_data_received block=\"serial|on data received %delimiters=serial_delimiter_conv\"\n void onDataReceived(String delimiters, Action body) {\n uBit.serial.eventOn(MSTR(delimiters));\n registerWithDal(MICROBIT_ID_SERIAL, MICROBIT_SERIAL_EVT_DELIM_MATCH, body);\n // lazy initialization of serial buffers\n uBit.serial.read(MicroBitSerialMode::ASYNC);\n }\n\n /**\n * Send a piece of text through the serial connection.\n */\n //% help=serial/write-string\n //% weight=87 blockGap=8\n //% blockId=serial_writestring block=\"serial|write string %text\"\n //% text.shadowOptions.toString=true\n void writeString(String text) {\n if (!text) return;\n\n uBit.serial.send(MSTR(text));\n }\n\n /**\n * Send a buffer through serial connection\n */\n //% blockId=serial_writebuffer block=\"serial|write buffer %buffer=serial_readbuffer\"\n //% help=serial/write-buffer advanced=true weight=6\n void writeBuffer(Buffer buffer) {\n if (!buffer) return;\n\n uBit.serial.send(buffer->data, buffer->length);\n }\n\n /**\n * Read multiple characters from the receive buffer. \n * If length is positive, pauses until enough characters are present.\n * @param length default buffer length\n */\n //% blockId=serial_readbuffer block=\"serial|read buffer %length\"\n //% help=serial/read-buffer advanced=true weight=5\n Buffer readBuffer(int length) {\n auto mode = SYNC_SLEEP;\n if (length <= 0) {\n length = uBit.serial.getRxBufferSize();\n mode = ASYNC;\n }\n\n auto buf = mkBuffer(NULL, length);\n auto res = buf;\n registerGCObj(buf); // make sure buffer is pinned, while we wait for data\n int read = uBit.serial.read(buf->data, buf->length, mode);\n if (read != length) {\n res = mkBuffer(buf->data, read);\n }\n unregisterGCObj(buf);\n\n return res;\n }\n\n bool tryResolvePin(SerialPin p, PinName& name) {\n switch(p) {\n#if !MICROBIT_CODAL\n case SerialPin::USB_TX: name = USBTX; return true;\n case SerialPin::USB_RX: name = USBRX; return true;\n#endif\n default: \n auto pin = getPin(p); \n if (NULL != pin) {\n name = (PinName)pin->name;\n return true;\n }\n }\n return false;\n }\n\n /**\n * Set the serial input and output to use pins instead of the USB connection.\n * @param tx the new transmission pin, eg: SerialPin.P0\n * @param rx the new reception pin, eg: SerialPin.P1\n * @param rate the new baud rate. eg: 115200\n */\n //% weight=10\n //% help=serial/redirect\n //% blockId=serial_redirect block=\"serial|redirect to|TX %tx|RX %rx|at baud rate %rate\"\n //% blockExternalInputs=1\n //% tx.fieldEditor=\"gridpicker\" tx.fieldOptions.columns=3\n //% tx.fieldOptions.tooltips=\"false\"\n //% rx.fieldEditor=\"gridpicker\" rx.fieldOptions.columns=3\n //% rx.fieldOptions.tooltips=\"false\"\n //% blockGap=8\n void redirect(SerialPin tx, SerialPin rx, BaudRate rate) {\n#if MICROBIT_CODAL\n if (getPin(tx) && getPin(rx))\n uBit.serial.redirect(*getPin(tx), *getPin(rx));\n uBit.serial.setBaud(rate);\n#else\n PinName txn;\n PinName rxn;\n if (tryResolvePin(tx, txn) && tryResolvePin(rx, rxn))\n uBit.serial.redirect(txn, rxn);\n uBit.serial.baud((int)rate);\n#endif\n }\n\n /**\n Set the baud rate of the serial port\n */\n //% weight=10\n //% blockId=serial_setbaudrate block=\"serial|set baud rate %rate\"\n //% blockGap=8 inlineInputMode=inline\n //% help=serial/set-baud-rate\n //% group=\"Configuration\" advanced=true\n void setBaudRate(BaudRate rate) {\n#if MICROBIT_CODAL\n uBit.serial.setBaud(rate);\n#else\n uBit.serial.baud((int)rate);\n#endif\n }\n\n\n /**\n * Direct the serial input and output to use the USB connection.\n */\n //% weight=9 help=serial/redirect-to-usb\n //% blockId=serial_redirect_to_usb block=\"serial|redirect to USB\"\n void redirectToUSB() {\n#if MICROBIT_CODAL\n uBit.serial.redirect(uBit.io.usbTx, uBit.io.usbRx);\n uBit.serial.setBaud(115200);\n#else\n uBit.serial.redirect(USBTX, USBRX);\n uBit.serial.baud(115200);\n#endif\n }\n\n /**\n * Sets the size of the RX buffer in bytes\n * @param size length of the rx buffer in bytes, eg: 32\n */\n //% help=serial/set-rx-buffer-size\n //% blockId=serialSetRxBufferSize block=\"serial set rx buffer size to $size\"\n //% advanced=true\n void setRxBufferSize(uint8_t size) {\n uBit.serial.setRxBufferSize(size);\n }\n\n /**\n * Sets the size of the TX buffer in bytes\n * @param size length of the tx buffer in bytes, eg: 32\n */\n //% help=serial/set-tx-buffer-size\n //% blockId=serialSetTxBufferSize block=\"serial set tx buffer size to $size\"\n //% advanced=true\n void setTxBufferSize(uint8_t size) {\n uBit.serial.setTxBufferSize(size);\n }\n}\n",
|
|
2779
|
+
"serial.cpp": "#include \"pxt.h\"\n\n#define MICROBIT_SERIAL_READ_BUFFER_LENGTH 64\n\n// make sure USB_TX and USB_RX don't overlap with other pin ids\n// also, 1001,1002 need to be kept in sync with getPin() function\nenum SerialPin {\n P0 = MICROBIT_ID_IO_P0,\n P1 = MICROBIT_ID_IO_P1,\n P2 = MICROBIT_ID_IO_P2,\n P8 = MICROBIT_ID_IO_P8,\n P12 = MICROBIT_ID_IO_P12,\n P13 = MICROBIT_ID_IO_P13,\n P14 = MICROBIT_ID_IO_P14,\n P15 = MICROBIT_ID_IO_P15,\n P16 = MICROBIT_ID_IO_P16,\n USB_TX = 1001,\n USB_RX = 1002\n};\n\nenum BaudRate {\n //% block=115200\n BaudRate115200 = 115200,\n //% block=57600\n BaudRate57600 = 57600,\n //% block=38400\n BaudRate38400 = 38400,\n //% block=31250\n BaudRate31250 = 31250,\n //% block=28800\n BaudRate28800 = 28800,\n //% block=19200\n BaudRate19200 = 19200,\n //% block=14400\n BaudRate14400 = 14400,\n //% block=9600\n BaudRate9600 = 9600,\n //% block=4800\n BaudRate4800 = 4800,\n //% block=2400\n BaudRate2400 = 2400,\n //% block=1200\n BaudRate1200 = 1200\n};\n\n//% weight=2 color=#002050 icon=\"\\uf287\"\n//% advanced=true\nnamespace serial {\n#if MICROBIT_CODAL\n bool is_redirected;\n#endif\n\n // note that at least one // followed by % is needed per declaration!\n\n /**\n * Read a line of text from the serial port and return the buffer when the delimiter is met.\n * @param delimiter text delimiter that separates each text chunk\n */\n //% help=serial/read-until\n //% blockId=serial_read_until block=\"serial|read until %delimiter=serial_delimiter_conv\"\n //% weight=19\n String readUntil(String delimiter) {\n return PSTR(uBit.serial.readUntil(MSTR(delimiter)));\n }\n\n /**\n * Read the buffered received data as a string\n */\n //% help=serial/read-string\n //% blockId=serial_read_buffer block=\"serial|read string\"\n //% weight=18\n String readString() {\n int n = uBit.serial.getRxBufferSize();\n if (n == 0) return mkString(\"\", 0);\n return PSTR(uBit.serial.read(n, MicroBitSerialMode::ASYNC));\n }\n\n /**\n * Register an event to be fired when one of the delimiter is matched.\n * @param delimiters the characters to match received characters against.\n */\n //% help=serial/on-data-received\n //% weight=18 blockId=serial_on_data_received block=\"serial|on data received %delimiters=serial_delimiter_conv\"\n void onDataReceived(String delimiters, Action body) {\n uBit.serial.eventOn(MSTR(delimiters));\n registerWithDal(MICROBIT_ID_SERIAL, MICROBIT_SERIAL_EVT_DELIM_MATCH, body);\n // lazy initialization of serial buffers\n uBit.serial.read(MicroBitSerialMode::ASYNC);\n }\n\n /**\n * Send a piece of text through the serial connection.\n */\n //% help=serial/write-string\n //% weight=87 blockGap=8\n //% blockId=serial_writestring block=\"serial|write string %text\"\n //% text.shadowOptions.toString=true\n void writeString(String text) {\n if (!text) return;\n\n uBit.serial.send(MSTR(text));\n }\n\n /**\n * Send a buffer through serial connection\n */\n //% blockId=serial_writebuffer block=\"serial|write buffer %buffer=serial_readbuffer\"\n //% help=serial/write-buffer advanced=true weight=6\n void writeBuffer(Buffer buffer) {\n if (!buffer) return;\n\n uBit.serial.send(buffer->data, buffer->length);\n }\n\n /**\n * Read multiple characters from the receive buffer. \n * If length is positive, pauses until enough characters are present.\n * @param length default buffer length\n */\n //% blockId=serial_readbuffer block=\"serial|read buffer %length\"\n //% help=serial/read-buffer advanced=true weight=5\n Buffer readBuffer(int length) {\n auto mode = SYNC_SLEEP;\n if (length <= 0) {\n length = uBit.serial.getRxBufferSize();\n mode = ASYNC;\n }\n\n auto buf = mkBuffer(NULL, length);\n auto res = buf;\n registerGCObj(buf); // make sure buffer is pinned, while we wait for data\n int read = uBit.serial.read(buf->data, buf->length, mode);\n if (read != length) {\n res = mkBuffer(buf->data, read);\n }\n unregisterGCObj(buf);\n\n return res;\n }\n\n bool tryResolvePin(SerialPin p, PinName& name) {\n switch(p) {\n#if !MICROBIT_CODAL\n case SerialPin::USB_TX: name = USBTX; return true;\n case SerialPin::USB_RX: name = USBRX; return true;\n#endif\n default: \n auto pin = getPin(p); \n if (NULL != pin) {\n name = (PinName)pin->name;\n return true;\n }\n }\n return false;\n }\n\n /**\n * Set the serial input and output to use pins instead of the USB connection.\n * @param tx the new transmission pin, eg: SerialPin.P0\n * @param rx the new reception pin, eg: SerialPin.P1\n * @param rate the new baud rate. eg: 115200\n */\n //% weight=10\n //% help=serial/redirect\n //% blockId=serial_redirect block=\"serial|redirect to|TX %tx|RX %rx|at baud rate %rate\"\n //% blockExternalInputs=1\n //% tx.fieldEditor=\"gridpicker\" tx.fieldOptions.columns=3\n //% tx.fieldOptions.tooltips=\"false\"\n //% rx.fieldEditor=\"gridpicker\" rx.fieldOptions.columns=3\n //% rx.fieldOptions.tooltips=\"false\"\n //% blockGap=8\n void redirect(SerialPin tx, SerialPin rx, BaudRate rate) {\n#if MICROBIT_CODAL\n if (getPin(tx) && getPin(rx)) {\n uBit.serial.redirect(*getPin(tx), *getPin(rx));\n is_redirected = 1;\n }\n uBit.serial.setBaud(rate);\n#else\n PinName txn;\n PinName rxn;\n if (tryResolvePin(tx, txn) && tryResolvePin(rx, rxn))\n uBit.serial.redirect(txn, rxn);\n uBit.serial.baud((int)rate);\n#endif\n }\n\n /**\n Set the baud rate of the serial port\n */\n //% weight=10\n //% blockId=serial_setbaudrate block=\"serial|set baud rate %rate\"\n //% blockGap=8 inlineInputMode=inline\n //% help=serial/set-baud-rate\n //% group=\"Configuration\" advanced=true\n void setBaudRate(BaudRate rate) {\n#if MICROBIT_CODAL\n uBit.serial.setBaud(rate);\n#else\n uBit.serial.baud((int)rate);\n#endif\n }\n\n\n /**\n * Direct the serial input and output to use the USB connection.\n */\n //% weight=9 help=serial/redirect-to-usb\n //% blockId=serial_redirect_to_usb block=\"serial|redirect to USB\"\n void redirectToUSB() {\n#if MICROBIT_CODAL\n is_redirected = false;\n uBit.serial.redirect(uBit.io.usbTx, uBit.io.usbRx);\n uBit.serial.setBaud(115200);\n#else\n uBit.serial.redirect(USBTX, USBRX);\n uBit.serial.baud(115200);\n#endif\n }\n\n /**\n * Sets the size of the RX buffer in bytes\n * @param size length of the rx buffer in bytes, eg: 32\n */\n //% help=serial/set-rx-buffer-size\n //% blockId=serialSetRxBufferSize block=\"serial set rx buffer size to $size\"\n //% advanced=true\n void setRxBufferSize(uint8_t size) {\n uBit.serial.setRxBufferSize(size);\n }\n\n /**\n * Sets the size of the TX buffer in bytes\n * @param size length of the tx buffer in bytes, eg: 32\n */\n //% help=serial/set-tx-buffer-size\n //% blockId=serialSetTxBufferSize block=\"serial set tx buffer size to $size\"\n //% advanced=true\n void setTxBufferSize(uint8_t size) {\n uBit.serial.setTxBufferSize(size);\n }\n\n /** Send DMESG debug buffer over serial. */\n //%\n void writeDmesg() {\n pxt::dumpDmesg();\n }\n}\n\nnamespace pxt {\n\nstatic void sendString(const char *c, int len) {\n while (len--)\n uBit.serial.putc(*c++);\n}\n\nvoid dumpDmesg() {\n#if MICROBIT_CODAL\n if (serial::is_redirected)\n return;\n unsigned len = codalLogStore.ptr;\n codalLogStore.ptr = 0;\n sendString(codalLogStore.buffer, len);\n#endif\n}\n\n}\n",
|
|
2780
2780
|
"serial.ts": "const enum Delimiters {\n //% block=\"new line (\\n)\"\n NewLine = 10,\n //% block=\",\"\n Comma = 44,\n //% block=\"$\"\n Dollar = 36,\n //% block=\":\"\n Colon = 58,\n //% block=\".\"\n Fullstop = 46,\n //% block=\"#\"\n Hash = 35,\n //% block=\"carriage return (\\r)\"\n CarriageReturn = 13,\n //% block=\"space\"\n Space = 32,\n //% block=\"tab (\\t)\"\n Tab = 9,\n //% block=\"|\"\n Pipe = 124,\n //% block=\";\"\n SemiColon = 59,\n}\n\n/**\n * Reading and writing data over a serial connection.\n */\n//% weight=2 color=#002050 icon=\"\\uf287\"\n//% advanced=true\nnamespace serial {\n /**\n * The string used to mark a new line, default is \\r\\n\n */\n export let NEW_LINE = \"\\r\\n\";\n export let NEW_LINE_DELIMITER: Delimiters = Delimiters.NewLine;\n let writeLinePadding = 32;\n\n /**\n * Print a line of text to the serial port\n * @param value to send over serial\n */\n //% weight=90\n //% help=serial/write-line blockGap=8\n //% blockId=serial_writeline block=\"serial|write line %text\"\n //% text.shadowOptions.toString=true\n export function writeLine(text: string): void {\n if (!text) text = \"\";\n serial.writeString(text);\n // pad data to the 32 byte boundary\n // to ensure apps receive the packet\n if (writeLinePadding > 0) {\n let r = (writeLinePadding - (text.length + NEW_LINE.length) % writeLinePadding) % writeLinePadding;\n for (let i = 0; i < r; ++i)\n serial.writeString(\" \");\n }\n serial.writeString(NEW_LINE);\n }\n\n /**\n * Sets the padding length for lines sent with \"write line\".\n * @param length the number of bytes alignment, eg: 0\n *\n */\n //% weight=1\n //% help=serial/set-write-line-padding\n //% blockId=serialWriteNewLinePadding block=\"serial set write line padding to $length\"\n //% advanced=true\n //% length.min=0 length.max=128\n export function setWriteLinePadding(length: number) {\n writeLinePadding = length | 0;\n }\n\n /**\n * Print a numeric value to the serial port\n */\n //% help=serial/write-number\n //% weight=89 blockGap=8\n //% blockId=serial_writenumber block=\"serial|write number %value\"\n export function writeNumber(value: number): void {\n writeString(value.toString());\n }\n\n /**\n * Print an array of numeric values as CSV to the serial port\n */\n //% help=serial/write-numbers\n //% weight=86\n //% blockId=serial_writenumbers block=\"serial|write numbers %values\"\n export function writeNumbers(values: number[]): void {\n if (!values) return;\n for (let i = 0; i < values.length; ++i) {\n if (i > 0) writeString(\",\");\n writeNumber(values[i]);\n }\n writeLine(\"\")\n }\n\n /**\n * Write a name:value pair as a line to the serial port.\n * @param name name of the value stream, eg: x\n * @param value to write\n */\n //% weight=88 blockGap=8\n //% help=serial/write-value\n //% blockId=serial_writevalue block=\"serial|write value %name|= %value\"\n export function writeValue(name: string, value: number): void {\n writeLine((name ? name + \":\" : \"\") + value);\n }\n\n /**\n * Read a line of text from the serial port.\n */\n //% help=serial/read-line\n //% blockId=serial_read_line block=\"serial|read line\"\n //% weight=20 blockGap=8\n export function readLine(): string {\n return serial.readUntil(delimiters(NEW_LINE_DELIMITER));\n }\n\n /**\n * Return the corresponding delimiter string\n */\n //% blockId=\"serial_delimiter_conv\" block=\"%del\"\n //% weight=1 blockHidden=true\n export function delimiters(del: Delimiters): string {\n return String.fromCharCode(del as number);\n }\n}\n",
|
|
2781
|
-
"shims.d.ts": "// Auto-generated. Do not edit.\n\n\n /**\n * Creation, manipulation and display of LED images.\n */\n //% color=#7600A8 weight=31 icon=\"\\uf03e\"\n //% advanced=true\ndeclare namespace images {\n\n /**\n * Creates an image that fits on the LED screen.\n */\n //% weight=75 help=images/create-image\n //% blockId=device_build_image block=\"create image\"\n //% parts=\"ledmatrix\" imageLiteral=1 shim=images::createImage\n function createImage(leds: string): Image;\n\n /**\n * Creates an image with 2 frames.\n */\n //% weight=74 help=images/create-big-image\n //% blockId=device_build_big_image block=\"create big image\" imageLiteral=2\n //% parts=\"ledmatrix\" shim=images::createBigImage\n function createBigImage(leds: string): Image;\n}\n\n\ndeclare interface Image {\n /**\n * Plots the image at a given column to the screen\n */\n //% help=images/plot-image\n //% parts=\"ledmatrix\" xOffset.defl=0 shim=ImageMethods::plotImage\n plotImage(xOffset?: int32): void;\n\n /**\n * Shows an frame from the image at offset ``x offset``.\n * @param xOffset column index to start displaying the image\n * @param interval time in milliseconds to pause after drawing\n */\n //% help=images/show-image weight=80 blockNamespace=images\n //% blockId=device_show_image_offset block=\"show image %sprite(myImage)|at offset %offset ||and interval (ms) %interval\"\n //%\n //% blockGap=8 parts=\"ledmatrix\" async interval.defl=400 shim=ImageMethods::showImage\n showImage(xOffset: int32, interval?: int32): void;\n\n /**\n * Draws the ``index``-th frame of the image on the screen.\n * @param xOffset column index to start displaying the image\n */\n //% help=images/plot-frame weight=80\n //% parts=\"ledmatrix\" shim=ImageMethods::plotFrame\n plotFrame(xOffset: int32): void;\n\n /**\n * Scrolls an image .\n * @param frameOffset x offset moved on each animation step, eg: 1, 2, 5\n * @param interval time between each animation step in milli seconds, eg: 200\n */\n //% help=images/scroll-image weight=79 async blockNamespace=images\n //% blockId=device_scroll_image\n //% block=\"scroll image %sprite(myImage)|with offset %frameoffset|and interval (ms) %delay\"\n //% blockGap=8 parts=\"ledmatrix\" shim=ImageMethods::scrollImage\n scrollImage(frameOffset: int32, interval: int32): void;\n\n /**\n * Sets all pixels off.\n */\n //% help=images/clear\n //% parts=\"ledmatrix\" shim=ImageMethods::clear\n clear(): void;\n\n /**\n * Sets a specific pixel brightness at a given position\n */\n //%\n //% parts=\"ledmatrix\" shim=ImageMethods::setPixelBrightness\n setPixelBrightness(x: int32, y: int32, value: int32): void;\n\n /**\n * Gets the pixel brightness ([0..255]) at a given position\n */\n //%\n //% parts=\"ledmatrix\" shim=ImageMethods::pixelBrightness\n pixelBrightness(x: int32, y: int32): int32;\n\n /**\n * Gets the width in columns\n */\n //% help=functions/width shim=ImageMethods::width\n width(): int32;\n\n /**\n * Gets the height in rows (always 5)\n */\n //% shim=ImageMethods::height\n height(): int32;\n\n /**\n * Set a pixel state at position ``(x,y)``\n * @param x pixel column\n * @param y pixel row\n * @param value pixel state\n */\n //% help=images/set-pixel\n //% parts=\"ledmatrix\" shim=ImageMethods::setPixel\n setPixel(x: int32, y: int32, value: boolean): void;\n\n /**\n * Get the pixel state at position ``(x,y)``\n * @param x pixel column\n * @param y pixel row\n */\n //% help=images/pixel\n //% parts=\"ledmatrix\" shim=ImageMethods::pixel\n pixel(x: int32, y: int32): boolean;\n\n /**\n * Show a particular frame of the image strip.\n * @param frame image frame to show\n */\n //% weight=70 help=images/show-frame\n //% parts=\"ledmatrix\" interval.defl=400 shim=ImageMethods::showFrame\n showFrame(frame: int32, interval?: int32): void;\n}\n\n\n /**\n * Provides access to basic micro:bit functionality.\n */\n //% color=#1E90FF weight=116 icon=\"\\uf00a\"\ndeclare namespace basic {\n\n /**\n * Draws an image on the LED screen.\n * @param leds the pattern of LED to turn on/off\n * @param interval time in milliseconds to pause after drawing\n */\n //% help=basic/show-leds\n //% weight=95 blockGap=8\n //% imageLiteral=1 async\n //% blockId=device_show_leds\n //% block=\"show leds\" icon=\"\\uf00a\"\n //% parts=\"ledmatrix\" interval.defl=400 shim=basic::showLeds\n function showLeds(leds: string, interval?: int32): void;\n\n /**\n * Display text on the display, one character at a time. If the string fits on the screen (i.e. is one letter), does not scroll.\n * @param text the text to scroll on the screen, eg: \"Hello!\"\n * @param interval how fast to shift characters; eg: 150, 100, 200, -100\n */\n //% help=basic/show-string\n //% weight=87 blockGap=16\n //% block=\"show|string %text\"\n //% async\n //% blockId=device_print_message\n //% parts=\"ledmatrix\"\n //% text.shadowOptions.toString=true interval.defl=150 shim=basic::showString\n function showString(text: string, interval?: int32): void;\n\n /**\n * Turn off all LEDs\n */\n //% help=basic/clear-screen weight=79\n //% blockId=device_clear_display block=\"clear screen\"\n //% parts=\"ledmatrix\" shim=basic::clearScreen\n function clearScreen(): void;\n\n /**\n * Shows a sequence of LED screens as an animation.\n * @param leds pattern of LEDs to turn on/off\n * @param interval time in milliseconds between each redraw\n */\n //% help=basic/show-animation imageLiteral=1 async\n //% parts=\"ledmatrix\" interval.defl=400 shim=basic::showAnimation\n function showAnimation(leds: string, interval?: int32): void;\n\n /**\n * Draws an image on the LED screen.\n * @param leds pattern of LEDs to turn on/off\n */\n //% help=basic/plot-leds weight=80\n //% parts=\"ledmatrix\" imageLiteral=1 shim=basic::plotLeds\n function plotLeds(leds: string): void;\n\n /**\n * Repeats the code forever in the background. On each iteration, allows other codes to run.\n * @param body code to execute\n */\n //% help=basic/forever weight=55 blockGap=16 blockAllowMultiple=1 afterOnStart=true\n //% blockId=device_forever block=\"forever\" icon=\"\\uf01e\" shim=basic::forever\n function forever(a: () => void): void;\n\n /**\n * Pause for the specified time in milliseconds\n * @param ms how long to pause for, eg: 100, 200, 500, 1000, 2000\n */\n //% help=basic/pause weight=54\n //% async block=\"pause (ms) %pause\" blockGap=16\n //% blockId=device_pause icon=\"\\uf110\"\n //% pause.shadow=timePicker shim=basic::pause\n function pause(ms: int32): void;\n}\n\n\n\n //% color=#D400D4 weight=111 icon=\"\\uf192\"\ndeclare namespace input {\n\n /**\n * Do something when a button (A, B or both A+B) is pushed down and released again.\n * @param button the button that needs to be pressed\n * @param body code to run when event is raised\n */\n //% help=input/on-button-pressed weight=85 blockGap=16\n //% blockId=device_button_event block=\"on button|%NAME|pressed\"\n //% parts=\"buttonpair\" shim=input::onButtonPressed\n function onButtonPressed(button: Button, body: () => void): void;\n\n /**\n * Do something when when a gesture is done (like shaking the micro:bit).\n * @param gesture the type of gesture to track, eg: Gesture.Shake\n * @param body code to run when gesture is raised\n */\n //% help=input/on-gesture weight=84 blockGap=16\n //% blockId=device_gesture_event block=\"on |%NAME\"\n //% parts=\"accelerometer\"\n //% NAME.fieldEditor=\"gestures\" NAME.fieldOptions.columns=4 shim=input::onGesture\n function onGesture(gesture: Gesture, body: () => void): void;\n\n /**\n * Tests if a gesture is currently detected.\n * @param gesture the type of gesture to detect, eg: Gesture.Shake\n */\n //% help=input/is-gesture weight=10 blockGap=8\n //% blockId=deviceisgesture block=\"is %gesture gesture\"\n //% parts=\"accelerometer\"\n //% gesture.fieldEditor=\"gestures\" gesture.fieldOptions.columns=4 shim=input::isGesture\n function isGesture(gesture: Gesture): boolean;\n\n /**\n * Do something when a pin is touched and released again (while also touching the GND pin).\n * @param name the pin that needs to be pressed, eg: TouchPin.P0\n * @param body the code to run when the pin is pressed\n */\n //% help=input/on-pin-pressed weight=83 blockGap=32\n //% blockId=device_pin_event block=\"on pin %name|pressed\" shim=input::onPinPressed\n function onPinPressed(name: TouchPin, body: () => void): void;\n\n /**\n * Do something when a pin is released.\n * @param name the pin that needs to be released, eg: TouchPin.P0\n * @param body the code to run when the pin is released\n */\n //% help=input/on-pin-released weight=6 blockGap=16\n //% blockId=device_pin_released block=\"on pin %NAME|released\"\n //% advanced=true shim=input::onPinReleased\n function onPinReleased(name: TouchPin, body: () => void): void;\n\n /**\n * Get the button state (pressed or not) for ``A`` and ``B``.\n * @param button the button to query the request, eg: Button.A\n */\n //% help=input/button-is-pressed weight=60\n //% block=\"button|%NAME|is pressed\"\n //% blockId=device_get_button2\n //% icon=\"\\uf192\" blockGap=8\n //% parts=\"buttonpair\" shim=input::buttonIsPressed\n function buttonIsPressed(button: Button): boolean;\n\n /**\n * Get the pin state (pressed or not). Requires to hold the ground to close the circuit.\n * @param name pin used to detect the touch, eg: TouchPin.P0\n */\n //% help=input/pin-is-pressed weight=58\n //% blockId=\"device_pin_is_pressed\" block=\"pin %NAME|is pressed\"\n //% blockGap=8 shim=input::pinIsPressed\n function pinIsPressed(name: TouchPin): boolean;\n\n /**\n * Get the acceleration value in milli-gravitys (when the board is laying flat with the screen up, x=0, y=0 and z=-1024)\n * @param dimension x, y, or z dimension, eg: Dimension.X\n */\n //% help=input/acceleration weight=58\n //% blockId=device_acceleration block=\"acceleration (mg)|%NAME\" blockGap=8\n //% parts=\"accelerometer\" shim=input::acceleration\n function acceleration(dimension: Dimension): int32;\n\n /**\n * Reads the light level applied to the LED screen in a range from ``0`` (dark) to ``255`` bright.\n */\n //% help=input/light-level weight=57\n //% blockId=device_get_light_level block=\"light level\" blockGap=8\n //% parts=\"ledmatrix\" shim=input::lightLevel\n function lightLevel(): int32;\n\n /**\n * Get the current compass heading in degrees.\n */\n //% help=input/compass-heading\n //% weight=56\n //% blockId=device_heading block=\"compass heading (°)\" blockGap=8\n //% parts=\"compass\" shim=input::compassHeading\n function compassHeading(): int32;\n\n /**\n * Gets the temperature in Celsius degrees (°C).\n */\n //% weight=55\n //% help=input/temperature\n //% blockId=device_temperature block=\"temperature (°C)\" blockGap=8\n //% parts=\"thermometer\" shim=input::temperature\n function temperature(): int32;\n\n /**\n * The pitch or roll of the device, rotation along the ``x-axis`` or ``y-axis``, in degrees.\n * @param kind pitch or roll\n */\n //% help=input/rotation weight=52\n //% blockId=device_get_rotation block=\"rotation (°)|%NAME\" blockGap=8\n //% parts=\"accelerometer\" advanced=true shim=input::rotation\n function rotation(kind: Rotation): int32;\n\n /**\n * Get the magnetic force value in ``micro-Teslas`` (``µT``). This function is not supported in the simulator.\n * @param dimension the x, y, or z dimension, eg: Dimension.X\n */\n //% help=input/magnetic-force weight=51\n //% blockId=device_get_magnetic_force block=\"magnetic force (µT)|%NAME\" blockGap=8\n //% parts=\"compass\"\n //% advanced=true shim=input::magneticForce\n function magneticForce(dimension: Dimension): number;\n\n /**\n * Obsolete, compass calibration is automatic.\n */\n //% help=input/calibrate-compass advanced=true\n //% blockId=\"input_compass_calibrate\" block=\"calibrate compass\"\n //% weight=45 shim=input::calibrateCompass\n function calibrateCompass(): void;\n\n /**\n * Sets the accelerometer sample range in gravities.\n * @param range a value describe the maximum strengh of acceleration measured\n */\n //% help=input/set-accelerometer-range\n //% blockId=device_set_accelerometer_range block=\"set accelerometer|range %range\"\n //% weight=5\n //% parts=\"accelerometer\"\n //% advanced=true shim=input::setAccelerometerRange\n function setAccelerometerRange(range: AcceleratorRange): void;\n}\n\n\n\n //% weight=1 color=\"#333333\"\n //% advanced=true\ndeclare namespace control {\n\n /**\n * Gets the number of milliseconds elapsed since power on.\n */\n //% help=control/millis weight=50\n //% blockId=control_running_time block=\"millis (ms)\" shim=control::millis\n function millis(): int32;\n\n /**\n * Gets current time in microseconds. Overflows every ~18 minutes.\n */\n //% shim=control::micros\n function micros(): int32;\n\n /**\n * Schedules code that run in the background.\n */\n //% help=control/in-background blockAllowMultiple=1 afterOnStart=true\n //% blockId=\"control_in_background\" block=\"run in background\" blockGap=8 shim=control::inBackground\n function inBackground(a: () => void): void;\n\n /**\n * Blocks the calling thread until the specified event is raised.\n */\n //% help=control/wait-for-event async\n //% blockId=control_wait_for_event block=\"wait for event|from %src|with value %value\" shim=control::waitForEvent\n function waitForEvent(src: int32, value: int32): void;\n\n /**\n * Resets the BBC micro:bit.\n */\n //% weight=30 async help=control/reset blockGap=8\n //% blockId=\"control_reset\" block=\"reset\" shim=control::reset\n function reset(): void;\n\n /**\n * Blocks the current fiber for the given microseconds\n * @param micros number of micro-seconds to wait. eg: 4\n */\n //% help=control/wait-micros weight=29 async\n //% blockId=\"control_wait_us\" block=\"wait (µs)%micros\"\n //% micros.min=0 micros.max=6000 shim=control::waitMicros\n function waitMicros(micros: int32): void;\n\n /**\n * Raises an event in the event bus.\n * @param src ID of the MicroBit Component that generated the event e.g. MICROBIT_ID_BUTTON_A.\n * @param value Component specific code indicating the cause of the event.\n * @param mode optional definition of how the event should be processed after construction (default is CREATE_AND_FIRE).\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\" block=\"raise event|from source %src=control_event_source_id|with value %value=control_event_value_id\" blockExternalInputs=1\n //% help=control/raise-event\n //% mode.defl=1 shim=control::raiseEvent\n function raiseEvent(src: int32, value: int32, mode?: EventCreationMode): void;\n\n /**\n * Registers an event handler.\n */\n //% weight=20 blockGap=8 blockId=\"control_on_event\" block=\"on event|from %src=control_event_source_id|with value %value=control_event_value_id\"\n //% help=control/on-event\n //% blockExternalInputs=1 flags.defl=0 shim=control::onEvent\n function onEvent(src: int32, value: int32, handler: () => void, flags?: int32): void;\n\n /**\n * Gets the value of the last event executed on the bus\n */\n //% blockId=control_event_value\" block=\"event value\"\n //% help=control/event-value\n //% weight=18 shim=control::eventValue\n function eventValue(): int32;\n\n /**\n * Gets the timestamp of the last event executed on the bus\n */\n //% blockId=control_event_timestamp\" block=\"event timestamp\"\n //% help=control/event-timestamp\n //% weight=19 blockGap=8 shim=control::eventTimestamp\n function eventTimestamp(): int32;\n\n /**\n * Make a friendly name for the device based on its serial number\n */\n //% blockId=\"control_device_name\" block=\"device name\" weight=10 blockGap=8\n //% help=control/device-name\n //% advanced=true shim=control::deviceName\n function deviceName(): string;\n\n /**\n * Returns the major version of the microbit\n */\n //% help=control/hardware-version shim=control::_hardwareVersion\n function _hardwareVersion(): string;\n\n /**\n * Derive a unique, consistent serial number of this device from internal data.\n */\n //% blockId=\"control_device_serial_number\" block=\"device serial number\" weight=9\n //% help=control/device-serial-number\n //% advanced=true shim=control::deviceSerialNumber\n function deviceSerialNumber(): int32;\n\n /**\n * Derive a unique, consistent 64-bit serial number of this device from internal data.\n */\n //% help=control/device-long-serial-number\n //% advanced=true shim=control::deviceLongSerialNumber\n function deviceLongSerialNumber(): Buffer;\n\n /**\n * Informs simulator/runtime of a MIDI message\n * Internal function to support the simulator.\n */\n //% part=midioutput blockHidden=1 shim=control::__midiSend\n function __midiSend(buffer: Buffer): void;\n\n /**\n *\n */\n //% shim=control::__log\n function __log(priority: int32, text: string): void;\n\n /**\n * Allocates the next user notification event\n */\n //% help=control/allocate-notify-event shim=control::allocateNotifyEvent\n function allocateNotifyEvent(): int32;\n\n /** Write a message to DMESG debugging buffer. */\n //% shim=control::dmesg\n function dmesg(s: string): void;\n\n /** Write a message and value (pointer) to DMESG debugging buffer. */\n //% shim=control::dmesgPtr\n function dmesgPtr(str: string, ptr: Object): void;\n}\ndeclare namespace control {\n\n /**\n * Force GC and dump basic information about heap.\n */\n //% shim=control::gc\n function gc(): void;\n\n /**\n * Force GC and halt waiting for debugger to do a full heap dump.\n */\n //% shim=control::heapDump\n function heapDump(): void;\n\n /**\n * Set flags used when connecting an external debugger.\n */\n //% shim=control::setDebugFlags\n function setDebugFlags(flags: int32): void;\n\n /**\n * Record a heap snapshot to debug memory leaks.\n */\n //% shim=control::heapSnapshot\n function heapSnapshot(): void;\n\n /**\n * Return true if profiling is enabled in the current build.\n */\n //% shim=control::profilingEnabled\n function profilingEnabled(): boolean;\n}\n\n\n\n //% color=#7600A8 weight=101 icon=\"\\uf205\"\ndeclare namespace led {\n\n /**\n * Turn on the specified LED using x, y coordinates (x is horizontal, y is vertical). (0,0) is upper left.\n * @param x the horizontal coordinate of the LED starting at 0\n * @param y the vertical coordinate of the LED starting at 0\n */\n //% help=led/plot weight=78\n //% blockId=device_plot block=\"plot|x %x|y %y\" blockGap=8\n //% parts=\"ledmatrix\"\n //% x.min=0 x.max=4 y.min=0 y.max=4\n //% x.fieldOptions.precision=1 y.fieldOptions.precision=1 shim=led::plot\n function plot(x: int32, y: int32): void;\n\n /**\n * Turn on the specified LED with specific brightness using x, y coordinates (x is horizontal, y is vertical). (0,0) is upper left.\n * @param x the horizontal coordinate of the LED starting at 0\n * @param y the vertical coordinate of the LED starting at 0\n * @param brightness the brightness from 0 (off) to 255 (bright), eg:255\n */\n //% help=led/plot-brightness weight=78\n //% blockId=device_plot_brightness block=\"plot|x %x|y %y|brightness %brightness\" blockGap=8\n //% parts=\"ledmatrix\"\n //% x.min=0 x.max=4 y.min=0 y.max=4 brightness.min=0 brightness.max=255\n //% x.fieldOptions.precision=1 y.fieldOptions.precision=1\n //% advanced=true shim=led::plotBrightness\n function plotBrightness(x: int32, y: int32, brightness: int32): void;\n\n /**\n * Turn off the specified LED using x, y coordinates (x is horizontal, y is vertical). (0,0) is upper left.\n * @param x the horizontal coordinate of the LED\n * @param y the vertical coordinate of the LED\n */\n //% help=led/unplot weight=77\n //% blockId=device_unplot block=\"unplot|x %x|y %y\" blockGap=8\n //% parts=\"ledmatrix\"\n //% x.min=0 x.max=4 y.min=0 y.max=4\n //% x.fieldOptions.precision=1 y.fieldOptions.precision=1 shim=led::unplot\n function unplot(x: int32, y: int32): void;\n\n /**\n * Get the brightness state of the specified LED using x, y coordinates. (0,0) is upper left.\n * @param x the horizontal coordinate of the LED\n * @param y the vertical coordinate of the LED\n */\n //% help=led/point-brightness weight=76\n //% blockId=device_point_brightness block=\"point|x %x|y %y brightness\"\n //% parts=\"ledmatrix\"\n //% x.min=0 x.max=4 y.min=0 y.max=4\n //% x.fieldOptions.precision=1 y.fieldOptions.precision=1\n //% advanced=true shim=led::pointBrightness\n function pointBrightness(x: int32, y: int32): int32;\n\n /**\n * Get the screen brightness from 0 (off) to 255 (full bright).\n */\n //% help=led/brightness weight=60\n //% blockId=device_get_brightness block=\"brightness\" blockGap=8\n //% parts=\"ledmatrix\"\n //% advanced=true shim=led::brightness\n function brightness(): int32;\n\n /**\n * Set the screen brightness from 0 (off) to 255 (full bright).\n * @param value the brightness value, eg:255, 127, 0\n */\n //% help=led/set-brightness weight=59\n //% blockId=device_set_brightness block=\"set brightness %value\"\n //% parts=\"ledmatrix\"\n //% advanced=true\n //% value.min=0 value.max=255 shim=led::setBrightness\n function setBrightness(value: int32): void;\n\n /**\n * Cancels the current animation and clears other pending animations.\n */\n //% weight=50 help=led/stop-animation\n //% blockId=device_stop_animation block=\"stop animation\"\n //% parts=\"ledmatrix\"\n //% advanced=true shim=led::stopAnimation\n function stopAnimation(): void;\n\n /**\n * Sets the display mode between black and white and greyscale for rendering LEDs.\n * @param mode mode the display mode in which the screen operates\n */\n //% weight=1 help=led/set-display-mode\n //% parts=\"ledmatrix\" advanced=true weight=1\n //% blockId=\"led_set_display_mode\" block=\"set display mode $mode\" shim=led::setDisplayMode\n function setDisplayMode(mode: DisplayMode): void;\n\n /**\n * Gets the current display mode\n */\n //% weight=1 parts=\"ledmatrix\" advanced=true shim=led::displayMode\n function displayMode(): DisplayMode;\n\n /**\n * Turns on or off the display\n */\n //% help=led/enable blockId=device_led_enable block=\"led enable %on\"\n //% advanced=true parts=\"ledmatrix\" shim=led::enable\n function enable(on: boolean): void;\n\n /**\n * Takes a screenshot of the LED screen and returns an image.\n */\n //% help=led/screenshot\n //% parts=\"ledmatrix\" shim=led::screenshot\n function screenshot(): Image;\n}\ndeclare namespace music {\n\n /**\n * Set the default output volume of the sound synthesizer.\n * @param volume the volume 0...255\n */\n //% blockId=synth_set_volume block=\"set volume %volume\"\n //% volume.min=0 volume.max=255\n //%\n //% help=music/set-volume\n //% weight=70\n //% group=\"Volume\"\n //% blockGap=8 volume.defl=127 shim=music::setVolume\n function setVolume(volume?: int32): void;\n\n /**\n * Returns the current output volume of the sound synthesizer.\n */\n //% blockId=synth_get_volume block=\"volume\"\n //% help=music/volume\n //% weight=69\n //% group=\"Volume\"\n //% blockGap=8 shim=music::volume\n function volume(): int32;\n\n /**\n * Turn the built-in speaker on or off.\n * Disabling the speaker resets the sound pin to the default of P0.\n * @param enabled whether the built-in speaker is enabled in addition to the sound pin\n */\n //% blockId=music_set_built_in_speaker_enable block=\"set built-in speaker $enabled\"\n //% group=\"micro:bit (V2)\"\n //% parts=builtinspeaker\n //% help=music/set-built-in-speaker-enabled\n //% enabled.shadow=toggleOnOff\n //% weight=0 shim=music::setBuiltInSpeakerEnabled\n function setBuiltInSpeakerEnabled(enabled: boolean): void;\n\n /**\n * Defines an optional sample level to generate during periods of silence.\n **/\n //% group=\"micro:bit (V2)\"\n //% help=music/set-silence-level\n //% level.min=0\n //% level.max=1024\n //%\n //% weight=1 level.defl=0 shim=music::setSilenceLevel\n function setSilenceLevel(level?: int32): void;\n}\ndeclare namespace pins {\n\n /**\n * Read the specified pin or connector as either 0 or 1\n * @param name pin to read from, eg: DigitalPin.P0\n */\n //% help=pins/digital-read-pin weight=30\n //% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\" shim=pins::digitalReadPin\n function digitalReadPin(name: DigitalPin): int32;\n\n /**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to, eg: DigitalPin.P0\n * @param value value to set on the pin, 1 eg,0\n */\n //% help=pins/digital-write-pin weight=29\n //% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value\"\n //% value.min=0 value.max=1\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\" shim=pins::digitalWritePin\n function digitalWritePin(name: DigitalPin, value: int32): void;\n\n /**\n * Read the connector value as analog, that is, as a value comprised between 0 and 1023.\n * @param name pin to write to, eg: AnalogPin.P0\n */\n //% help=pins/analog-read-pin weight=25\n //% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\" shim=pins::analogReadPin\n function analogReadPin(name: AnalogPin): int32;\n\n /**\n * Set the connector value as analog. Value must be comprised between 0 and 1023.\n * @param name pin name to write to, eg: AnalogPin.P0\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n //% help=pins/analog-write-pin weight=24\n //% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n //% value.min=0 value.max=1023\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\" shim=pins::analogWritePin\n function analogWritePin(name: AnalogPin, value: int32): void;\n\n /**\n * Configure the pulse-width modulation (PWM) period of the analog output in microseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has no effect.\n * @param name analog pin to set period to, eg: AnalogPin.P0\n * @param micros period in micro seconds. eg:20000\n */\n //% help=pins/analog-set-period weight=23 blockGap=8\n //% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%micros\"\n //% pin.fieldEditor=\"gridpicker\" pin.fieldOptions.columns=4\n //% pin.fieldOptions.tooltips=\"false\" shim=pins::analogSetPeriod\n function analogSetPeriod(name: AnalogPin, micros: int32): void;\n\n /**\n * Configure the pin as a digital input and generate an event when the pin is pulsed either high or low.\n * @param name digital pin to register to, eg: DigitalPin.P0\n * @param pulse the value of the pulse, eg: PulseValue.High\n */\n //% help=pins/on-pulsed advanced=true\n //% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n //% pin.fieldEditor=\"gridpicker\" pin.fieldOptions.columns=4\n //% pin.fieldOptions.tooltips=\"false\" pin.fieldOptions.width=\"250\"\n //% group=\"Pulse\"\n //% weight=25\n //% blockGap=8 shim=pins::onPulsed\n function onPulsed(name: DigitalPin, pulse: PulseValue, body: () => void): void;\n\n /**\n * Get the duration of the last pulse in microseconds. This function should be called from a ``onPulsed`` handler.\n */\n //% help=pins/pulse-duration advanced=true\n //% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n //% group=\"Pulse\"\n //% weight=24\n //% blockGap=8 shim=pins::pulseDuration\n function pulseDuration(): int32;\n\n /**\n * Return the duration of a pulse at a pin in microseconds.\n * @param name the pin which measures the pulse, eg: DigitalPin.P0\n * @param value the value of the pulse, eg: PulseValue.High\n * @param maximum duration in microseconds\n */\n //% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %value\"\n //% advanced=true\n //% help=pins/pulse-in\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\"\n //% group=\"Pulse\"\n //% weight=23\n //% blockGap=8 maxDuration.defl=2000000 shim=pins::pulseIn\n function pulseIn(name: DigitalPin, value: PulseValue, maxDuration?: int32): int32;\n\n /**\n * Write a value to the servo, controlling the shaft accordingly. On a standard servo, this will set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to, eg: AnalogPin.P0\n * @param value angle or rotation speed, eg:180,90,0\n */\n //% help=pins/servo-write-pin weight=20\n //% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value\" blockGap=8\n //% parts=microservo trackArgs=0\n //% value.min=0 value.max=180\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\"\n //% group=\"Servo\" shim=pins::servoWritePin\n function servoWritePin(name: AnalogPin, value: int32): void;\n\n /**\n * Specifies that a continuous servo is connected.\n */\n //% shim=pins::servoSetContinuous\n function servoSetContinuous(name: AnalogPin, value: boolean): void;\n\n /**\n * Configure the IO pin as an analog/pwm output and set a pulse width. The period is 20 ms period and the pulse width is set based on the value given in **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param micros pulse duration in micro seconds, eg:1500\n */\n //% help=pins/servo-set-pulse weight=19\n //% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %micros\"\n //% value.fieldEditor=\"gridpicker\" value.fieldOptions.columns=4\n //% value.fieldOptions.tooltips=\"false\" value.fieldOptions.width=\"250\"\n //% group=\"Servo\" shim=pins::servoSetPulse\n function servoSetPulse(name: AnalogPin, micros: int32): void;\n\n /**\n * Set the pin used when using analog pitch or music.\n * @param name pin to modulate pitch from\n */\n //% blockId=device_analog_set_pitch_pin block=\"analog set pitch pin %name\"\n //% help=pins/analog-set-pitch-pin advanced=true\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\"\n //% group=\"Pins\"\n //% weight=12\n //% blockGap=8 shim=pins::analogSetPitchPin\n function analogSetPitchPin(name: AnalogPin): void;\n\n /**\n * Sets the volume on the pitch pin\n * @param volume the intensity of the sound from 0..255\n */\n //% blockId=device_analog_set_pitch_volume block=\"analog set pitch volume $volume\"\n //% help=pins/analog-set-pitch-volume weight=3 advanced=true\n //% volume.min=0 volume.max=255\n //% deprecated shim=pins::analogSetPitchVolume\n function analogSetPitchVolume(volume: int32): void;\n\n /**\n * Gets the volume the pitch pin from 0..255\n */\n //% blockId=device_analog_pitch_volume block=\"analog pitch volume\"\n //% help=pins/analog-pitch-volume weight=3 advanced=true\n //% deprecated shim=pins::analogPitchVolume\n function analogPitchVolume(): int32;\n\n /**\n * Emit a plse-width modulation (PWM) signal to the current pitch pin. Use `analog set pitch pin` to define the pitch pin.\n * @param frequency frequency to modulate in Hz.\n * @param ms duration of the pitch in milli seconds.\n */\n //% blockId=device_analog_pitch block=\"analog pitch %frequency|for (ms) %ms\"\n //% help=pins/analog-pitch async advanced=true\n //% group=\"Pins\"\n //% weight=14\n //% blockGap=8 shim=pins::analogPitch\n function analogPitch(frequency: int32, ms: int32): void;\n\n /**\n * Configure the pull direction of of a pin.\n * @param name pin to set the pull mode on, eg: DigitalPin.P0\n * @param pull one of the mbed pull configurations, eg: PinPullMode.PullUp\n */\n //% help=pins/set-pull advanced=true\n //% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n //% pin.fieldEditor=\"gridpicker\" pin.fieldOptions.columns=4\n //% pin.fieldOptions.tooltips=\"false\" pin.fieldOptions.width=\"250\"\n //% group=\"Pins\"\n //% weight=15\n //% blockGap=8 shim=pins::setPull\n function setPull(name: DigitalPin, pull: PinPullMode): void;\n\n /**\n * Configure the events emitted by this pin. Events can be subscribed to\n * using ``control.onEvent()``.\n * @param name pin to set the event mode on, eg: DigitalPin.P0\n * @param type the type of events for this pin to emit, eg: PinEventType.Edge\n */\n //% help=pins/set-events advanced=true\n //% blockId=device_set_pin_events block=\"set pin %pin|to emit %type|events\"\n //% pin.fieldEditor=\"gridpicker\" pin.fieldOptions.columns=4\n //% pin.fieldOptions.tooltips=\"false\" pin.fieldOptions.width=\"250\"\n //% group=\"Pins\"\n //% weight=13\n //% blockGap=8 shim=pins::setEvents\n function setEvents(name: DigitalPin, type: PinEventType): void;\n\n /**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n //% shim=pins::createBuffer\n function createBuffer(size: int32): Buffer;\n\n /**\n * Set the matrix width for Neopixel strip (already assigned to a pin).\n * Should be used in conjunction with `set matrix width` from Neopixel package.\n * @param name pin of Neopixel strip, eg: DigitalPin.P1\n * @param value width of matrix (at least ``2``)\n */\n //% help=pins/neopixel-matrix-width advanced=true\n //% blockId=pin_neopixel_matrix_width block=\"neopixel matrix width|pin %pin %width\"\n //% pin.fieldEditor=\"gridpicker\" pin.fieldOptions.columns=4\n //% pin.fieldOptions.tooltips=\"false\" pin.fieldOptions.width=\"250\"\n //% width.min=2\n //% group=\"Pins\"\n //% weight=11\n //% blockGap=8 width.defl=5 shim=pins::setMatrixWidth\n function setMatrixWidth(pin: DigitalPin, width?: int32): void;\n\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=pins::i2cReadBuffer\n function i2cReadBuffer(address: int32, size: int32, repeat?: boolean): Buffer;\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=pins::i2cWriteBuffer\n function i2cWriteBuffer(address: int32, buf: Buffer, repeat?: boolean): int32;\n\n /**\n * Write to the SPI slave and return the response\n * @param value Data to be sent to the SPI slave\n */\n //% help=pins/spi-write advanced=true\n //% blockId=spi_write block=\"spi write %value\"\n //% group=\"SPI\"\n //% blockGap=8\n //% weight=53 shim=pins::spiWrite\n function spiWrite(value: int32): int32;\n\n /**\n * Write to and read from the SPI slave at the same time\n * @param command Data to be sent to the SPI slave (can be null)\n * @param response Data received from the SPI slave (can be null)\n */\n //% help=pins/spi-transfer argsNullable shim=pins::spiTransfer\n function spiTransfer(command: Buffer, response: Buffer): void;\n\n /**\n * Set the SPI frequency\n * @param frequency the clock frequency, eg: 1000000\n */\n //% help=pins/spi-frequency advanced=true\n //% blockId=spi_frequency block=\"spi frequency %frequency\"\n //% group=\"SPI\"\n //% blockGap=8\n //% weight=55 shim=pins::spiFrequency\n function spiFrequency(frequency: int32): void;\n\n /**\n * Set the SPI bits and mode\n * @param bits the number of bits, eg: 8\n * @param mode the mode, eg: 3\n */\n //% help=pins/spi-format advanced=true\n //% blockId=spi_format block=\"spi format|bits %bits|mode %mode\"\n //% group=\"SPI\"\n //% blockGap=8\n //% weight=54 shim=pins::spiFormat\n function spiFormat(bits: int32, mode: int32): void;\n\n /**\n * Set the MOSI, MISO, SCK pins used by the SPI connection\n *\n */\n //% help=pins/spi-pins advanced=true\n //% blockId=spi_pins block=\"spi set pins|MOSI %mosi|MISO %miso|SCK %sck\"\n //% mosi.fieldEditor=\"gridpicker\" mosi.fieldOptions.columns=4\n //% mosi.fieldOptions.tooltips=\"false\" mosi.fieldOptions.width=\"250\"\n //% miso.fieldEditor=\"gridpicker\" miso.fieldOptions.columns=4\n //% miso.fieldOptions.tooltips=\"false\" miso.fieldOptions.width=\"250\"\n //% sck.fieldEditor=\"gridpicker\" sck.fieldOptions.columns=4\n //% sck.fieldOptions.tooltips=\"false\" sck.fieldOptions.width=\"250\"\n //% group=\"SPI\"\n //% blockGap=8\n //% weight=51 shim=pins::spiPins\n function spiPins(mosi: DigitalPin, miso: DigitalPin, sck: DigitalPin): void;\n\n /**\n * Mounts a push button on the given pin\n */\n //% help=pins/push-button advanced=true shim=pins::pushButton\n function pushButton(pin: DigitalPin): void;\n\n /**\n * Set the pin used when producing sounds and melodies. Default is P0.\n * @param name pin to modulate pitch from\n */\n //% blockId=pin_set_audio_pin block=\"set audio pin $name\"\n //% help=pins/set-audio-pin\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\"\n //% weight=1\n //% blockGap=8 shim=pins::setAudioPin\n function setAudioPin(name: AnalogPin): void;\n\n /**\n * Sets whether or not audio will be output using a pin on the edge\n * connector.\n */\n //% blockId=pin_set_audio_pin_enabled\n //% block=\"set audio pin enabled $enabled\"\n //% weight=0 shim=pins::setAudioPinEnabled\n function setAudioPinEnabled(enabled: boolean): void;\n}\n\n\n\n //% weight=2 color=#002050 icon=\"\\uf287\"\n //% advanced=true\ndeclare namespace serial {\n\n /**\n * Read a line of text from the serial port and return the buffer when the delimiter is met.\n * @param delimiter text delimiter that separates each text chunk\n */\n //% help=serial/read-until\n //% blockId=serial_read_until block=\"serial|read until %delimiter=serial_delimiter_conv\"\n //% weight=19 shim=serial::readUntil\n function readUntil(delimiter: string): string;\n\n /**\n * Read the buffered received data as a string\n */\n //% help=serial/read-string\n //% blockId=serial_read_buffer block=\"serial|read string\"\n //% weight=18 shim=serial::readString\n function readString(): string;\n\n /**\n * Register an event to be fired when one of the delimiter is matched.\n * @param delimiters the characters to match received characters against.\n */\n //% help=serial/on-data-received\n //% weight=18 blockId=serial_on_data_received block=\"serial|on data received %delimiters=serial_delimiter_conv\" shim=serial::onDataReceived\n function onDataReceived(delimiters: string, body: () => void): void;\n\n /**\n * Send a piece of text through the serial connection.\n */\n //% help=serial/write-string\n //% weight=87 blockGap=8\n //% blockId=serial_writestring block=\"serial|write string %text\"\n //% text.shadowOptions.toString=true shim=serial::writeString\n function writeString(text: string): void;\n\n /**\n * Send a buffer through serial connection\n */\n //% blockId=serial_writebuffer block=\"serial|write buffer %buffer=serial_readbuffer\"\n //% help=serial/write-buffer advanced=true weight=6 shim=serial::writeBuffer\n function writeBuffer(buffer: Buffer): void;\n\n /**\n * Read multiple characters from the receive buffer. \n * If length is positive, pauses until enough characters are present.\n * @param length default buffer length\n */\n //% blockId=serial_readbuffer block=\"serial|read buffer %length\"\n //% help=serial/read-buffer advanced=true weight=5 shim=serial::readBuffer\n function readBuffer(length: int32): Buffer;\n\n /**\n * Set the serial input and output to use pins instead of the USB connection.\n * @param tx the new transmission pin, eg: SerialPin.P0\n * @param rx the new reception pin, eg: SerialPin.P1\n * @param rate the new baud rate. eg: 115200\n */\n //% weight=10\n //% help=serial/redirect\n //% blockId=serial_redirect block=\"serial|redirect to|TX %tx|RX %rx|at baud rate %rate\"\n //% blockExternalInputs=1\n //% tx.fieldEditor=\"gridpicker\" tx.fieldOptions.columns=3\n //% tx.fieldOptions.tooltips=\"false\"\n //% rx.fieldEditor=\"gridpicker\" rx.fieldOptions.columns=3\n //% rx.fieldOptions.tooltips=\"false\"\n //% blockGap=8 shim=serial::redirect\n function redirect(tx: SerialPin, rx: SerialPin, rate: BaudRate): void;\n\n /**\n Set the baud rate of the serial port\n */\n //% weight=10\n //% blockId=serial_setbaudrate block=\"serial|set baud rate %rate\"\n //% blockGap=8 inlineInputMode=inline\n //% help=serial/set-baud-rate\n //% group=\"Configuration\" advanced=true shim=serial::setBaudRate\n function setBaudRate(rate: BaudRate): void;\n\n /**\n * Direct the serial input and output to use the USB connection.\n */\n //% weight=9 help=serial/redirect-to-usb\n //% blockId=serial_redirect_to_usb block=\"serial|redirect to USB\" shim=serial::redirectToUSB\n function redirectToUSB(): void;\n\n /**\n * Sets the size of the RX buffer in bytes\n * @param size length of the rx buffer in bytes, eg: 32\n */\n //% help=serial/set-rx-buffer-size\n //% blockId=serialSetRxBufferSize block=\"serial set rx buffer size to $size\"\n //% advanced=true shim=serial::setRxBufferSize\n function setRxBufferSize(size: uint8): void;\n\n /**\n * Sets the size of the TX buffer in bytes\n * @param size length of the tx buffer in bytes, eg: 32\n */\n //% help=serial/set-tx-buffer-size\n //% blockId=serialSetTxBufferSize block=\"serial set tx buffer size to $size\"\n //% advanced=true shim=serial::setTxBufferSize\n function setTxBufferSize(size: uint8): void;\n}\n\n\n\n //% indexerGet=BufferMethods::getByte indexerSet=BufferMethods::setByte\ndeclare interface Buffer {\n /**\n * Reads an unsigned byte at a particular location\n */\n //% shim=BufferMethods::getUint8\n getUint8(off: int32): int32;\n\n /**\n * Returns false when the buffer can be written to.\n */\n //% shim=BufferMethods::isReadOnly\n isReadOnly(): boolean;\n\n /**\n * Writes an unsigned byte at a particular location\n */\n //% shim=BufferMethods::setUint8\n setUint8(off: int32, v: int32): void;\n\n /**\n * Write a number in specified format in the buffer.\n */\n //% shim=BufferMethods::setNumber\n setNumber(format: NumberFormat, offset: int32, value: number): void;\n\n /**\n * Read a number in specified format from the buffer.\n */\n //% shim=BufferMethods::getNumber\n getNumber(format: NumberFormat, offset: int32): number;\n\n /** Returns the length of a Buffer object. */\n //% property shim=BufferMethods::length\n length: int32;\n\n /**\n * Fill (a fragment) of the buffer with given value.\n */\n //% offset.defl=0 length.defl=-1 shim=BufferMethods::fill\n fill(value: int32, offset?: int32, length?: int32): void;\n\n /**\n * Return a copy of a fragment of a buffer.\n */\n //% offset.defl=0 length.defl=-1 shim=BufferMethods::slice\n slice(offset?: int32, length?: int32): Buffer;\n\n /**\n * Shift buffer left in place, with zero padding.\n * @param offset number of bytes to shift; use negative value to shift right\n * @param start start offset in buffer. Default is 0.\n * @param length number of elements in buffer. If negative, length is set as the buffer length minus\n * start. eg: -1\n */\n //% start.defl=0 length.defl=-1 shim=BufferMethods::shift\n shift(offset: int32, start?: int32, length?: int32): void;\n\n /**\n * Convert a buffer to string assuming UTF8 encoding\n */\n //% shim=BufferMethods::toString\n toString(): string;\n\n /**\n * Convert a buffer to its hexadecimal representation.\n */\n //% shim=BufferMethods::toHex\n toHex(): string;\n\n /**\n * Rotate buffer left in place.\n * @param offset number of bytes to shift; use negative value to shift right\n * @param start start offset in buffer. Default is 0.\n * @param length number of elements in buffer. If negative, length is set as the buffer length minus\n * start. eg: -1\n */\n //% start.defl=0 length.defl=-1 shim=BufferMethods::rotate\n rotate(offset: int32, start?: int32, length?: int32): void;\n\n /**\n * Write contents of `src` at `dstOffset` in current buffer.\n */\n //% shim=BufferMethods::write\n write(dstOffset: int32, src: Buffer): void;\n\n /**\n * Compute k-bit FNV-1 non-cryptographic hash of the buffer.\n */\n //% shim=BufferMethods::hash\n hash(bits: int32): uint32;\n}\ndeclare namespace control {\n\n /**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n //% deprecated=1 shim=control::createBuffer\n function createBuffer(size: int32): Buffer;\n\n /**\n * Create a new buffer with UTF8-encoded string\n * @param str the string to put in the buffer\n */\n //% deprecated=1 shim=control::createBufferFromUTF8\n function createBufferFromUTF8(str: string): Buffer;\n}\ndeclare namespace light {\n\n /**\n * Sends a color buffer to a light strip\n **/\n //% advanced=true shim=light::sendWS2812Buffer\n function sendWS2812Buffer(buf: Buffer, pin: int32): void;\n\n /**\n * Sends a color buffer to a light strip\n **/\n //% advanced=true shim=light::sendWS2812BufferWithBrightness\n function sendWS2812BufferWithBrightness(buf: Buffer, pin: int32, brightness: int32): void;\n\n /**\n * Sets the light mode of a pin\n **/\n //% advanced=true\n //% shim=light::setMode\n function setMode(pin: int32, mode: int32): void;\n}\ndeclare namespace input {\n\n /**\n * Do something when the logo is touched and released again.\n * @param body the code to run when the logo is pressed\n */\n //% weight=83 blockGap=32\n //% blockId=input_logo_event block=\"on logo $action\"\n //% group=\"micro:bit (V2)\"\n //% parts=\"logotouch\"\n //% help=\"input/on-logo-event\" shim=input::onLogoEvent\n function onLogoEvent(action: TouchButtonEvent, body: () => void): void;\n\n /**\n * Get the logo state (pressed or not).\n */\n //% weight=58\n //% blockId=\"input_logo_is_pressed\" block=\"logo is pressed\"\n //% blockGap=8\n //% group=\"micro:bit (V2)\"\n //% parts=\"logotouch\"\n //% help=\"input/logo-is-pressed\" shim=input::logoIsPressed\n function logoIsPressed(): boolean;\n}\ndeclare namespace pins {\n\n /**\n * Configure the touch detection for the pins and logo.\n * P0, P1, P2 use resistive touch by default.\n * The logo uses capacitative touch by default.\n * @param name target to change the touch mode for\n * @param mode the touch mode to use\n */\n //% weight=60\n //% blockId=device_touch_set_type block=\"set %name to touch mode %mode\"\n //% advanced=true\n //% group=\"micro:bit (V2)\"\n //% help=pins/touch-set-mode shim=pins::touchSetMode\n function touchSetMode(name: TouchTarget, mode: TouchTargetMode): void;\n}\ndeclare namespace music {\n\n /**\n * Internal use only\n **/\n //% async shim=music::__playSoundExpression\n function __playSoundExpression(nodes: string, waitTillDone: boolean): void;\n\n /**\n * Internal use only\n */\n //% shim=music::__stopSoundExpressions\n function __stopSoundExpressions(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
|
|
2781
|
+
"shims.d.ts": "// Auto-generated. Do not edit.\n\n\n /**\n * Creation, manipulation and display of LED images.\n */\n //% color=#7600A8 weight=31 icon=\"\\uf03e\"\n //% advanced=true\ndeclare namespace images {\n\n /**\n * Creates an image that fits on the LED screen.\n */\n //% weight=75 help=images/create-image\n //% blockId=device_build_image block=\"create image\"\n //% parts=\"ledmatrix\" imageLiteral=1 shim=images::createImage\n function createImage(leds: string): Image;\n\n /**\n * Creates an image with 2 frames.\n */\n //% weight=74 help=images/create-big-image\n //% blockId=device_build_big_image block=\"create big image\" imageLiteral=2\n //% parts=\"ledmatrix\" shim=images::createBigImage\n function createBigImage(leds: string): Image;\n}\n\n\ndeclare interface Image {\n /**\n * Plots the image at a given column to the screen\n */\n //% help=images/plot-image\n //% parts=\"ledmatrix\" xOffset.defl=0 shim=ImageMethods::plotImage\n plotImage(xOffset?: int32): void;\n\n /**\n * Shows an frame from the image at offset ``x offset``.\n * @param xOffset column index to start displaying the image\n * @param interval time in milliseconds to pause after drawing\n */\n //% help=images/show-image weight=80 blockNamespace=images\n //% blockId=device_show_image_offset block=\"show image %sprite(myImage)|at offset %offset ||and interval (ms) %interval\"\n //%\n //% blockGap=8 parts=\"ledmatrix\" async interval.defl=400 shim=ImageMethods::showImage\n showImage(xOffset: int32, interval?: int32): void;\n\n /**\n * Draws the ``index``-th frame of the image on the screen.\n * @param xOffset column index to start displaying the image\n */\n //% help=images/plot-frame weight=80\n //% parts=\"ledmatrix\" shim=ImageMethods::plotFrame\n plotFrame(xOffset: int32): void;\n\n /**\n * Scrolls an image .\n * @param frameOffset x offset moved on each animation step, eg: 1, 2, 5\n * @param interval time between each animation step in milli seconds, eg: 200\n */\n //% help=images/scroll-image weight=79 async blockNamespace=images\n //% blockId=device_scroll_image\n //% block=\"scroll image %sprite(myImage)|with offset %frameoffset|and interval (ms) %delay\"\n //% blockGap=8 parts=\"ledmatrix\" shim=ImageMethods::scrollImage\n scrollImage(frameOffset: int32, interval: int32): void;\n\n /**\n * Sets all pixels off.\n */\n //% help=images/clear\n //% parts=\"ledmatrix\" shim=ImageMethods::clear\n clear(): void;\n\n /**\n * Sets a specific pixel brightness at a given position\n */\n //%\n //% parts=\"ledmatrix\" shim=ImageMethods::setPixelBrightness\n setPixelBrightness(x: int32, y: int32, value: int32): void;\n\n /**\n * Gets the pixel brightness ([0..255]) at a given position\n */\n //%\n //% parts=\"ledmatrix\" shim=ImageMethods::pixelBrightness\n pixelBrightness(x: int32, y: int32): int32;\n\n /**\n * Gets the width in columns\n */\n //% help=functions/width shim=ImageMethods::width\n width(): int32;\n\n /**\n * Gets the height in rows (always 5)\n */\n //% shim=ImageMethods::height\n height(): int32;\n\n /**\n * Set a pixel state at position ``(x,y)``\n * @param x pixel column\n * @param y pixel row\n * @param value pixel state\n */\n //% help=images/set-pixel\n //% parts=\"ledmatrix\" shim=ImageMethods::setPixel\n setPixel(x: int32, y: int32, value: boolean): void;\n\n /**\n * Get the pixel state at position ``(x,y)``\n * @param x pixel column\n * @param y pixel row\n */\n //% help=images/pixel\n //% parts=\"ledmatrix\" shim=ImageMethods::pixel\n pixel(x: int32, y: int32): boolean;\n\n /**\n * Show a particular frame of the image strip.\n * @param frame image frame to show\n */\n //% weight=70 help=images/show-frame\n //% parts=\"ledmatrix\" interval.defl=400 shim=ImageMethods::showFrame\n showFrame(frame: int32, interval?: int32): void;\n}\n\n\n /**\n * Provides access to basic micro:bit functionality.\n */\n //% color=#1E90FF weight=116 icon=\"\\uf00a\"\ndeclare namespace basic {\n\n /**\n * Draws an image on the LED screen.\n * @param leds the pattern of LED to turn on/off\n * @param interval time in milliseconds to pause after drawing\n */\n //% help=basic/show-leds\n //% weight=95 blockGap=8\n //% imageLiteral=1 async\n //% blockId=device_show_leds\n //% block=\"show leds\" icon=\"\\uf00a\"\n //% parts=\"ledmatrix\" interval.defl=400 shim=basic::showLeds\n function showLeds(leds: string, interval?: int32): void;\n\n /**\n * Display text on the display, one character at a time. If the string fits on the screen (i.e. is one letter), does not scroll.\n * @param text the text to scroll on the screen, eg: \"Hello!\"\n * @param interval how fast to shift characters; eg: 150, 100, 200, -100\n */\n //% help=basic/show-string\n //% weight=87 blockGap=16\n //% block=\"show|string %text\"\n //% async\n //% blockId=device_print_message\n //% parts=\"ledmatrix\"\n //% text.shadowOptions.toString=true interval.defl=150 shim=basic::showString\n function showString(text: string, interval?: int32): void;\n\n /**\n * Turn off all LEDs\n */\n //% help=basic/clear-screen weight=79\n //% blockId=device_clear_display block=\"clear screen\"\n //% parts=\"ledmatrix\" shim=basic::clearScreen\n function clearScreen(): void;\n\n /**\n * Shows a sequence of LED screens as an animation.\n * @param leds pattern of LEDs to turn on/off\n * @param interval time in milliseconds between each redraw\n */\n //% help=basic/show-animation imageLiteral=1 async\n //% parts=\"ledmatrix\" interval.defl=400 shim=basic::showAnimation\n function showAnimation(leds: string, interval?: int32): void;\n\n /**\n * Draws an image on the LED screen.\n * @param leds pattern of LEDs to turn on/off\n */\n //% help=basic/plot-leds weight=80\n //% parts=\"ledmatrix\" imageLiteral=1 shim=basic::plotLeds\n function plotLeds(leds: string): void;\n\n /**\n * Repeats the code forever in the background. On each iteration, allows other codes to run.\n * @param body code to execute\n */\n //% help=basic/forever weight=55 blockGap=16 blockAllowMultiple=1 afterOnStart=true\n //% blockId=device_forever block=\"forever\" icon=\"\\uf01e\" shim=basic::forever\n function forever(a: () => void): void;\n\n /**\n * Pause for the specified time in milliseconds\n * @param ms how long to pause for, eg: 100, 200, 500, 1000, 2000\n */\n //% help=basic/pause weight=54\n //% async block=\"pause (ms) %pause\" blockGap=16\n //% blockId=device_pause icon=\"\\uf110\"\n //% pause.shadow=timePicker shim=basic::pause\n function pause(ms: int32): void;\n}\n\n\n\n //% color=#D400D4 weight=111 icon=\"\\uf192\"\ndeclare namespace input {\n\n /**\n * Do something when a button (A, B or both A+B) is pushed down and released again.\n * @param button the button that needs to be pressed\n * @param body code to run when event is raised\n */\n //% help=input/on-button-pressed weight=85 blockGap=16\n //% blockId=device_button_event block=\"on button|%NAME|pressed\"\n //% parts=\"buttonpair\" shim=input::onButtonPressed\n function onButtonPressed(button: Button, body: () => void): void;\n\n /**\n * Do something when when a gesture is done (like shaking the micro:bit).\n * @param gesture the type of gesture to track, eg: Gesture.Shake\n * @param body code to run when gesture is raised\n */\n //% help=input/on-gesture weight=84 blockGap=16\n //% blockId=device_gesture_event block=\"on |%NAME\"\n //% parts=\"accelerometer\"\n //% NAME.fieldEditor=\"gestures\" NAME.fieldOptions.columns=4 shim=input::onGesture\n function onGesture(gesture: Gesture, body: () => void): void;\n\n /**\n * Tests if a gesture is currently detected.\n * @param gesture the type of gesture to detect, eg: Gesture.Shake\n */\n //% help=input/is-gesture weight=10 blockGap=8\n //% blockId=deviceisgesture block=\"is %gesture gesture\"\n //% parts=\"accelerometer\"\n //% gesture.fieldEditor=\"gestures\" gesture.fieldOptions.columns=4 shim=input::isGesture\n function isGesture(gesture: Gesture): boolean;\n\n /**\n * Do something when a pin is touched and released again (while also touching the GND pin).\n * @param name the pin that needs to be pressed, eg: TouchPin.P0\n * @param body the code to run when the pin is pressed\n */\n //% help=input/on-pin-pressed weight=83 blockGap=32\n //% blockId=device_pin_event block=\"on pin %name|pressed\" shim=input::onPinPressed\n function onPinPressed(name: TouchPin, body: () => void): void;\n\n /**\n * Do something when a pin is released.\n * @param name the pin that needs to be released, eg: TouchPin.P0\n * @param body the code to run when the pin is released\n */\n //% help=input/on-pin-released weight=6 blockGap=16\n //% blockId=device_pin_released block=\"on pin %NAME|released\"\n //% advanced=true shim=input::onPinReleased\n function onPinReleased(name: TouchPin, body: () => void): void;\n\n /**\n * Get the button state (pressed or not) for ``A`` and ``B``.\n * @param button the button to query the request, eg: Button.A\n */\n //% help=input/button-is-pressed weight=60\n //% block=\"button|%NAME|is pressed\"\n //% blockId=device_get_button2\n //% icon=\"\\uf192\" blockGap=8\n //% parts=\"buttonpair\" shim=input::buttonIsPressed\n function buttonIsPressed(button: Button): boolean;\n\n /**\n * Get the pin state (pressed or not). Requires to hold the ground to close the circuit.\n * @param name pin used to detect the touch, eg: TouchPin.P0\n */\n //% help=input/pin-is-pressed weight=58\n //% blockId=\"device_pin_is_pressed\" block=\"pin %NAME|is pressed\"\n //% blockGap=8 shim=input::pinIsPressed\n function pinIsPressed(name: TouchPin): boolean;\n\n /**\n * Get the acceleration value in milli-gravitys (when the board is laying flat with the screen up, x=0, y=0 and z=-1024)\n * @param dimension x, y, or z dimension, eg: Dimension.X\n */\n //% help=input/acceleration weight=58\n //% blockId=device_acceleration block=\"acceleration (mg)|%NAME\" blockGap=8\n //% parts=\"accelerometer\" shim=input::acceleration\n function acceleration(dimension: Dimension): int32;\n\n /**\n * Reads the light level applied to the LED screen in a range from ``0`` (dark) to ``255`` bright.\n */\n //% help=input/light-level weight=57\n //% blockId=device_get_light_level block=\"light level\" blockGap=8\n //% parts=\"ledmatrix\" shim=input::lightLevel\n function lightLevel(): int32;\n\n /**\n * Get the current compass heading in degrees.\n */\n //% help=input/compass-heading\n //% weight=56\n //% blockId=device_heading block=\"compass heading (°)\" blockGap=8\n //% parts=\"compass\" shim=input::compassHeading\n function compassHeading(): int32;\n\n /**\n * Gets the temperature in Celsius degrees (°C).\n */\n //% weight=55\n //% help=input/temperature\n //% blockId=device_temperature block=\"temperature (°C)\" blockGap=8\n //% parts=\"thermometer\" shim=input::temperature\n function temperature(): int32;\n\n /**\n * The pitch or roll of the device, rotation along the ``x-axis`` or ``y-axis``, in degrees.\n * @param kind pitch or roll\n */\n //% help=input/rotation weight=52\n //% blockId=device_get_rotation block=\"rotation (°)|%NAME\" blockGap=8\n //% parts=\"accelerometer\" advanced=true shim=input::rotation\n function rotation(kind: Rotation): int32;\n\n /**\n * Get the magnetic force value in ``micro-Teslas`` (``µT``). This function is not supported in the simulator.\n * @param dimension the x, y, or z dimension, eg: Dimension.X\n */\n //% help=input/magnetic-force weight=51\n //% blockId=device_get_magnetic_force block=\"magnetic force (µT)|%NAME\" blockGap=8\n //% parts=\"compass\"\n //% advanced=true shim=input::magneticForce\n function magneticForce(dimension: Dimension): number;\n\n /**\n * Obsolete, compass calibration is automatic.\n */\n //% help=input/calibrate-compass advanced=true\n //% blockId=\"input_compass_calibrate\" block=\"calibrate compass\"\n //% weight=45 shim=input::calibrateCompass\n function calibrateCompass(): void;\n\n /**\n * Sets the accelerometer sample range in gravities.\n * @param range a value describe the maximum strengh of acceleration measured\n */\n //% help=input/set-accelerometer-range\n //% blockId=device_set_accelerometer_range block=\"set accelerometer|range %range\"\n //% weight=5\n //% parts=\"accelerometer\"\n //% advanced=true shim=input::setAccelerometerRange\n function setAccelerometerRange(range: AcceleratorRange): void;\n}\n\n\n\n //% weight=1 color=\"#333333\"\n //% advanced=true\ndeclare namespace control {\n\n /**\n * Gets the number of milliseconds elapsed since power on.\n */\n //% help=control/millis weight=50\n //% blockId=control_running_time block=\"millis (ms)\" shim=control::millis\n function millis(): int32;\n\n /**\n * Gets current time in microseconds. Overflows every ~18 minutes.\n */\n //% shim=control::micros\n function micros(): int32;\n\n /**\n * Schedules code that run in the background.\n */\n //% help=control/in-background blockAllowMultiple=1 afterOnStart=true\n //% blockId=\"control_in_background\" block=\"run in background\" blockGap=8 shim=control::inBackground\n function inBackground(a: () => void): void;\n\n /**\n * Blocks the calling thread until the specified event is raised.\n */\n //% help=control/wait-for-event async\n //% blockId=control_wait_for_event block=\"wait for event|from %src|with value %value\" shim=control::waitForEvent\n function waitForEvent(src: int32, value: int32): void;\n\n /**\n * Resets the BBC micro:bit.\n */\n //% weight=30 async help=control/reset blockGap=8\n //% blockId=\"control_reset\" block=\"reset\" shim=control::reset\n function reset(): void;\n\n /**\n * Blocks the current fiber for the given microseconds\n * @param micros number of micro-seconds to wait. eg: 4\n */\n //% help=control/wait-micros weight=29 async\n //% blockId=\"control_wait_us\" block=\"wait (µs)%micros\"\n //% micros.min=0 micros.max=6000 shim=control::waitMicros\n function waitMicros(micros: int32): void;\n\n /**\n * Raises an event in the event bus.\n * @param src ID of the MicroBit Component that generated the event e.g. MICROBIT_ID_BUTTON_A.\n * @param value Component specific code indicating the cause of the event.\n * @param mode optional definition of how the event should be processed after construction (default is CREATE_AND_FIRE).\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\" block=\"raise event|from source %src=control_event_source_id|with value %value=control_event_value_id\" blockExternalInputs=1\n //% help=control/raise-event\n //% mode.defl=1 shim=control::raiseEvent\n function raiseEvent(src: int32, value: int32, mode?: EventCreationMode): void;\n\n /**\n * Registers an event handler.\n */\n //% weight=20 blockGap=8 blockId=\"control_on_event\" block=\"on event|from %src=control_event_source_id|with value %value=control_event_value_id\"\n //% help=control/on-event\n //% blockExternalInputs=1 flags.defl=0 shim=control::onEvent\n function onEvent(src: int32, value: int32, handler: () => void, flags?: int32): void;\n\n /**\n * Gets the value of the last event executed on the bus\n */\n //% blockId=control_event_value\" block=\"event value\"\n //% help=control/event-value\n //% weight=18 shim=control::eventValue\n function eventValue(): int32;\n\n /**\n * Gets the timestamp of the last event executed on the bus\n */\n //% blockId=control_event_timestamp\" block=\"event timestamp\"\n //% help=control/event-timestamp\n //% weight=19 blockGap=8 shim=control::eventTimestamp\n function eventTimestamp(): int32;\n\n /**\n * Make a friendly name for the device based on its serial number\n */\n //% blockId=\"control_device_name\" block=\"device name\" weight=10 blockGap=8\n //% help=control/device-name\n //% advanced=true shim=control::deviceName\n function deviceName(): string;\n\n /**\n * Returns the major version of the microbit\n */\n //% help=control/hardware-version shim=control::_hardwareVersion\n function _hardwareVersion(): string;\n\n /**\n * Derive a unique, consistent serial number of this device from internal data.\n */\n //% blockId=\"control_device_serial_number\" block=\"device serial number\" weight=9\n //% help=control/device-serial-number\n //% advanced=true shim=control::deviceSerialNumber\n function deviceSerialNumber(): int32;\n\n /**\n * Derive a unique, consistent 64-bit serial number of this device from internal data.\n */\n //% help=control/device-long-serial-number\n //% advanced=true shim=control::deviceLongSerialNumber\n function deviceLongSerialNumber(): Buffer;\n\n /**\n * Informs simulator/runtime of a MIDI message\n * Internal function to support the simulator.\n */\n //% part=midioutput blockHidden=1 shim=control::__midiSend\n function __midiSend(buffer: Buffer): void;\n\n /**\n *\n */\n //% shim=control::__log\n function __log(priority: int32, text: string): void;\n\n /**\n * Allocates the next user notification event\n */\n //% help=control/allocate-notify-event shim=control::allocateNotifyEvent\n function allocateNotifyEvent(): int32;\n\n /** Write a message to DMESG debugging buffer. */\n //% shim=control::dmesg\n function dmesg(s: string): void;\n\n /** Write a message and value (pointer) to DMESG debugging buffer. */\n //% shim=control::dmesgPtr\n function dmesgPtr(str: string, ptr: Object): void;\n}\ndeclare namespace control {\n\n /**\n * Force GC and dump basic information about heap.\n */\n //% shim=control::gc\n function gc(): void;\n\n /**\n * Force GC and halt waiting for debugger to do a full heap dump.\n */\n //% shim=control::heapDump\n function heapDump(): void;\n\n /**\n * Set flags used when connecting an external debugger.\n */\n //% shim=control::setDebugFlags\n function setDebugFlags(flags: int32): void;\n\n /**\n * Record a heap snapshot to debug memory leaks.\n */\n //% shim=control::heapSnapshot\n function heapSnapshot(): void;\n\n /**\n * Return true if profiling is enabled in the current build.\n */\n //% shim=control::profilingEnabled\n function profilingEnabled(): boolean;\n}\n\n\n\n //% color=#7600A8 weight=101 icon=\"\\uf205\"\ndeclare namespace led {\n\n /**\n * Turn on the specified LED using x, y coordinates (x is horizontal, y is vertical). (0,0) is upper left.\n * @param x the horizontal coordinate of the LED starting at 0\n * @param y the vertical coordinate of the LED starting at 0\n */\n //% help=led/plot weight=78\n //% blockId=device_plot block=\"plot|x %x|y %y\" blockGap=8\n //% parts=\"ledmatrix\"\n //% x.min=0 x.max=4 y.min=0 y.max=4\n //% x.fieldOptions.precision=1 y.fieldOptions.precision=1 shim=led::plot\n function plot(x: int32, y: int32): void;\n\n /**\n * Turn on the specified LED with specific brightness using x, y coordinates (x is horizontal, y is vertical). (0,0) is upper left.\n * @param x the horizontal coordinate of the LED starting at 0\n * @param y the vertical coordinate of the LED starting at 0\n * @param brightness the brightness from 0 (off) to 255 (bright), eg:255\n */\n //% help=led/plot-brightness weight=78\n //% blockId=device_plot_brightness block=\"plot|x %x|y %y|brightness %brightness\" blockGap=8\n //% parts=\"ledmatrix\"\n //% x.min=0 x.max=4 y.min=0 y.max=4 brightness.min=0 brightness.max=255\n //% x.fieldOptions.precision=1 y.fieldOptions.precision=1\n //% advanced=true shim=led::plotBrightness\n function plotBrightness(x: int32, y: int32, brightness: int32): void;\n\n /**\n * Turn off the specified LED using x, y coordinates (x is horizontal, y is vertical). (0,0) is upper left.\n * @param x the horizontal coordinate of the LED\n * @param y the vertical coordinate of the LED\n */\n //% help=led/unplot weight=77\n //% blockId=device_unplot block=\"unplot|x %x|y %y\" blockGap=8\n //% parts=\"ledmatrix\"\n //% x.min=0 x.max=4 y.min=0 y.max=4\n //% x.fieldOptions.precision=1 y.fieldOptions.precision=1 shim=led::unplot\n function unplot(x: int32, y: int32): void;\n\n /**\n * Get the brightness state of the specified LED using x, y coordinates. (0,0) is upper left.\n * @param x the horizontal coordinate of the LED\n * @param y the vertical coordinate of the LED\n */\n //% help=led/point-brightness weight=76\n //% blockId=device_point_brightness block=\"point|x %x|y %y brightness\"\n //% parts=\"ledmatrix\"\n //% x.min=0 x.max=4 y.min=0 y.max=4\n //% x.fieldOptions.precision=1 y.fieldOptions.precision=1\n //% advanced=true shim=led::pointBrightness\n function pointBrightness(x: int32, y: int32): int32;\n\n /**\n * Get the screen brightness from 0 (off) to 255 (full bright).\n */\n //% help=led/brightness weight=60\n //% blockId=device_get_brightness block=\"brightness\" blockGap=8\n //% parts=\"ledmatrix\"\n //% advanced=true shim=led::brightness\n function brightness(): int32;\n\n /**\n * Set the screen brightness from 0 (off) to 255 (full bright).\n * @param value the brightness value, eg:255, 127, 0\n */\n //% help=led/set-brightness weight=59\n //% blockId=device_set_brightness block=\"set brightness %value\"\n //% parts=\"ledmatrix\"\n //% advanced=true\n //% value.min=0 value.max=255 shim=led::setBrightness\n function setBrightness(value: int32): void;\n\n /**\n * Cancels the current animation and clears other pending animations.\n */\n //% weight=50 help=led/stop-animation\n //% blockId=device_stop_animation block=\"stop animation\"\n //% parts=\"ledmatrix\"\n //% advanced=true shim=led::stopAnimation\n function stopAnimation(): void;\n\n /**\n * Sets the display mode between black and white and greyscale for rendering LEDs.\n * @param mode mode the display mode in which the screen operates\n */\n //% weight=1 help=led/set-display-mode\n //% parts=\"ledmatrix\" advanced=true weight=1\n //% blockId=\"led_set_display_mode\" block=\"set display mode $mode\" shim=led::setDisplayMode\n function setDisplayMode(mode: DisplayMode): void;\n\n /**\n * Gets the current display mode\n */\n //% weight=1 parts=\"ledmatrix\" advanced=true shim=led::displayMode\n function displayMode(): DisplayMode;\n\n /**\n * Turns on or off the display\n */\n //% help=led/enable blockId=device_led_enable block=\"led enable %on\"\n //% advanced=true parts=\"ledmatrix\" shim=led::enable\n function enable(on: boolean): void;\n\n /**\n * Takes a screenshot of the LED screen and returns an image.\n */\n //% help=led/screenshot\n //% parts=\"ledmatrix\" shim=led::screenshot\n function screenshot(): Image;\n}\ndeclare namespace music {\n\n /**\n * Set the default output volume of the sound synthesizer.\n * @param volume the volume 0...255\n */\n //% blockId=synth_set_volume block=\"set volume %volume\"\n //% volume.min=0 volume.max=255\n //%\n //% help=music/set-volume\n //% weight=70\n //% group=\"Volume\"\n //% blockGap=8 volume.defl=127 shim=music::setVolume\n function setVolume(volume?: int32): void;\n\n /**\n * Returns the current output volume of the sound synthesizer.\n */\n //% blockId=synth_get_volume block=\"volume\"\n //% help=music/volume\n //% weight=69\n //% group=\"Volume\"\n //% blockGap=8 shim=music::volume\n function volume(): int32;\n\n /**\n * Turn the built-in speaker on or off.\n * Disabling the speaker resets the sound pin to the default of P0.\n * @param enabled whether the built-in speaker is enabled in addition to the sound pin\n */\n //% blockId=music_set_built_in_speaker_enable block=\"set built-in speaker $enabled\"\n //% group=\"micro:bit (V2)\"\n //% parts=builtinspeaker\n //% help=music/set-built-in-speaker-enabled\n //% enabled.shadow=toggleOnOff\n //% weight=0 shim=music::setBuiltInSpeakerEnabled\n function setBuiltInSpeakerEnabled(enabled: boolean): void;\n\n /**\n * Defines an optional sample level to generate during periods of silence.\n **/\n //% group=\"micro:bit (V2)\"\n //% help=music/set-silence-level\n //% level.min=0\n //% level.max=1024\n //%\n //% weight=1 level.defl=0 shim=music::setSilenceLevel\n function setSilenceLevel(level?: int32): void;\n}\ndeclare namespace pins {\n\n /**\n * Read the specified pin or connector as either 0 or 1\n * @param name pin to read from, eg: DigitalPin.P0\n */\n //% help=pins/digital-read-pin weight=30\n //% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\" shim=pins::digitalReadPin\n function digitalReadPin(name: DigitalPin): int32;\n\n /**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to, eg: DigitalPin.P0\n * @param value value to set on the pin, 1 eg,0\n */\n //% help=pins/digital-write-pin weight=29\n //% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value\"\n //% value.min=0 value.max=1\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\" shim=pins::digitalWritePin\n function digitalWritePin(name: DigitalPin, value: int32): void;\n\n /**\n * Read the connector value as analog, that is, as a value comprised between 0 and 1023.\n * @param name pin to write to, eg: AnalogPin.P0\n */\n //% help=pins/analog-read-pin weight=25\n //% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\" shim=pins::analogReadPin\n function analogReadPin(name: AnalogPin): int32;\n\n /**\n * Set the connector value as analog. Value must be comprised between 0 and 1023.\n * @param name pin name to write to, eg: AnalogPin.P0\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n //% help=pins/analog-write-pin weight=24\n //% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n //% value.min=0 value.max=1023\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\" shim=pins::analogWritePin\n function analogWritePin(name: AnalogPin, value: int32): void;\n\n /**\n * Configure the pulse-width modulation (PWM) period of the analog output in microseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has no effect.\n * @param name analog pin to set period to, eg: AnalogPin.P0\n * @param micros period in micro seconds. eg:20000\n */\n //% help=pins/analog-set-period weight=23 blockGap=8\n //% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%micros\"\n //% pin.fieldEditor=\"gridpicker\" pin.fieldOptions.columns=4\n //% pin.fieldOptions.tooltips=\"false\" shim=pins::analogSetPeriod\n function analogSetPeriod(name: AnalogPin, micros: int32): void;\n\n /**\n * Configure the pin as a digital input and generate an event when the pin is pulsed either high or low.\n * @param name digital pin to register to, eg: DigitalPin.P0\n * @param pulse the value of the pulse, eg: PulseValue.High\n */\n //% help=pins/on-pulsed advanced=true\n //% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n //% pin.fieldEditor=\"gridpicker\" pin.fieldOptions.columns=4\n //% pin.fieldOptions.tooltips=\"false\" pin.fieldOptions.width=\"250\"\n //% group=\"Pulse\"\n //% weight=25\n //% blockGap=8 shim=pins::onPulsed\n function onPulsed(name: DigitalPin, pulse: PulseValue, body: () => void): void;\n\n /**\n * Get the duration of the last pulse in microseconds. This function should be called from a ``onPulsed`` handler.\n */\n //% help=pins/pulse-duration advanced=true\n //% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n //% group=\"Pulse\"\n //% weight=24\n //% blockGap=8 shim=pins::pulseDuration\n function pulseDuration(): int32;\n\n /**\n * Return the duration of a pulse at a pin in microseconds.\n * @param name the pin which measures the pulse, eg: DigitalPin.P0\n * @param value the value of the pulse, eg: PulseValue.High\n * @param maximum duration in microseconds\n */\n //% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %value\"\n //% advanced=true\n //% help=pins/pulse-in\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\"\n //% group=\"Pulse\"\n //% weight=23\n //% blockGap=8 maxDuration.defl=2000000 shim=pins::pulseIn\n function pulseIn(name: DigitalPin, value: PulseValue, maxDuration?: int32): int32;\n\n /**\n * Write a value to the servo, controlling the shaft accordingly. On a standard servo, this will set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to, eg: AnalogPin.P0\n * @param value angle or rotation speed, eg:180,90,0\n */\n //% help=pins/servo-write-pin weight=20\n //% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value\" blockGap=8\n //% parts=microservo trackArgs=0\n //% value.min=0 value.max=180\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\"\n //% group=\"Servo\" shim=pins::servoWritePin\n function servoWritePin(name: AnalogPin, value: int32): void;\n\n /**\n * Specifies that a continuous servo is connected.\n */\n //% shim=pins::servoSetContinuous\n function servoSetContinuous(name: AnalogPin, value: boolean): void;\n\n /**\n * Configure the IO pin as an analog/pwm output and set a pulse width. The period is 20 ms period and the pulse width is set based on the value given in **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param micros pulse duration in micro seconds, eg:1500\n */\n //% help=pins/servo-set-pulse weight=19\n //% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %micros\"\n //% value.fieldEditor=\"gridpicker\" value.fieldOptions.columns=4\n //% value.fieldOptions.tooltips=\"false\" value.fieldOptions.width=\"250\"\n //% group=\"Servo\" shim=pins::servoSetPulse\n function servoSetPulse(name: AnalogPin, micros: int32): void;\n\n /**\n * Set the pin used when using analog pitch or music.\n * @param name pin to modulate pitch from\n */\n //% blockId=device_analog_set_pitch_pin block=\"analog set pitch pin %name\"\n //% help=pins/analog-set-pitch-pin advanced=true\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\"\n //% group=\"Pins\"\n //% weight=12\n //% blockGap=8 shim=pins::analogSetPitchPin\n function analogSetPitchPin(name: AnalogPin): void;\n\n /**\n * Sets the volume on the pitch pin\n * @param volume the intensity of the sound from 0..255\n */\n //% blockId=device_analog_set_pitch_volume block=\"analog set pitch volume $volume\"\n //% help=pins/analog-set-pitch-volume weight=3 advanced=true\n //% volume.min=0 volume.max=255\n //% deprecated shim=pins::analogSetPitchVolume\n function analogSetPitchVolume(volume: int32): void;\n\n /**\n * Gets the volume the pitch pin from 0..255\n */\n //% blockId=device_analog_pitch_volume block=\"analog pitch volume\"\n //% help=pins/analog-pitch-volume weight=3 advanced=true\n //% deprecated shim=pins::analogPitchVolume\n function analogPitchVolume(): int32;\n\n /**\n * Emit a plse-width modulation (PWM) signal to the current pitch pin. Use `analog set pitch pin` to define the pitch pin.\n * @param frequency frequency to modulate in Hz.\n * @param ms duration of the pitch in milli seconds.\n */\n //% blockId=device_analog_pitch block=\"analog pitch %frequency|for (ms) %ms\"\n //% help=pins/analog-pitch async advanced=true\n //% group=\"Pins\"\n //% weight=14\n //% blockGap=8 shim=pins::analogPitch\n function analogPitch(frequency: int32, ms: int32): void;\n\n /**\n * Configure the pull direction of of a pin.\n * @param name pin to set the pull mode on, eg: DigitalPin.P0\n * @param pull one of the mbed pull configurations, eg: PinPullMode.PullUp\n */\n //% help=pins/set-pull advanced=true\n //% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n //% pin.fieldEditor=\"gridpicker\" pin.fieldOptions.columns=4\n //% pin.fieldOptions.tooltips=\"false\" pin.fieldOptions.width=\"250\"\n //% group=\"Pins\"\n //% weight=15\n //% blockGap=8 shim=pins::setPull\n function setPull(name: DigitalPin, pull: PinPullMode): void;\n\n /**\n * Configure the events emitted by this pin. Events can be subscribed to\n * using ``control.onEvent()``.\n * @param name pin to set the event mode on, eg: DigitalPin.P0\n * @param type the type of events for this pin to emit, eg: PinEventType.Edge\n */\n //% help=pins/set-events advanced=true\n //% blockId=device_set_pin_events block=\"set pin %pin|to emit %type|events\"\n //% pin.fieldEditor=\"gridpicker\" pin.fieldOptions.columns=4\n //% pin.fieldOptions.tooltips=\"false\" pin.fieldOptions.width=\"250\"\n //% group=\"Pins\"\n //% weight=13\n //% blockGap=8 shim=pins::setEvents\n function setEvents(name: DigitalPin, type: PinEventType): void;\n\n /**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n //% shim=pins::createBuffer\n function createBuffer(size: int32): Buffer;\n\n /**\n * Set the matrix width for Neopixel strip (already assigned to a pin).\n * Should be used in conjunction with `set matrix width` from Neopixel package.\n * @param name pin of Neopixel strip, eg: DigitalPin.P1\n * @param value width of matrix (at least ``2``)\n */\n //% help=pins/neopixel-matrix-width advanced=true\n //% blockId=pin_neopixel_matrix_width block=\"neopixel matrix width|pin %pin %width\"\n //% pin.fieldEditor=\"gridpicker\" pin.fieldOptions.columns=4\n //% pin.fieldOptions.tooltips=\"false\" pin.fieldOptions.width=\"250\"\n //% width.min=2\n //% group=\"Pins\"\n //% weight=11\n //% blockGap=8 width.defl=5 shim=pins::setMatrixWidth\n function setMatrixWidth(pin: DigitalPin, width?: int32): void;\n\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=pins::i2cReadBuffer\n function i2cReadBuffer(address: int32, size: int32, repeat?: boolean): Buffer;\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=pins::i2cWriteBuffer\n function i2cWriteBuffer(address: int32, buf: Buffer, repeat?: boolean): int32;\n\n /**\n * Write to the SPI slave and return the response\n * @param value Data to be sent to the SPI slave\n */\n //% help=pins/spi-write advanced=true\n //% blockId=spi_write block=\"spi write %value\"\n //% group=\"SPI\"\n //% blockGap=8\n //% weight=53 shim=pins::spiWrite\n function spiWrite(value: int32): int32;\n\n /**\n * Write to and read from the SPI slave at the same time\n * @param command Data to be sent to the SPI slave (can be null)\n * @param response Data received from the SPI slave (can be null)\n */\n //% help=pins/spi-transfer argsNullable shim=pins::spiTransfer\n function spiTransfer(command: Buffer, response: Buffer): void;\n\n /**\n * Set the SPI frequency\n * @param frequency the clock frequency, eg: 1000000\n */\n //% help=pins/spi-frequency advanced=true\n //% blockId=spi_frequency block=\"spi frequency %frequency\"\n //% group=\"SPI\"\n //% blockGap=8\n //% weight=55 shim=pins::spiFrequency\n function spiFrequency(frequency: int32): void;\n\n /**\n * Set the SPI bits and mode\n * @param bits the number of bits, eg: 8\n * @param mode the mode, eg: 3\n */\n //% help=pins/spi-format advanced=true\n //% blockId=spi_format block=\"spi format|bits %bits|mode %mode\"\n //% group=\"SPI\"\n //% blockGap=8\n //% weight=54 shim=pins::spiFormat\n function spiFormat(bits: int32, mode: int32): void;\n\n /**\n * Set the MOSI, MISO, SCK pins used by the SPI connection\n *\n */\n //% help=pins/spi-pins advanced=true\n //% blockId=spi_pins block=\"spi set pins|MOSI %mosi|MISO %miso|SCK %sck\"\n //% mosi.fieldEditor=\"gridpicker\" mosi.fieldOptions.columns=4\n //% mosi.fieldOptions.tooltips=\"false\" mosi.fieldOptions.width=\"250\"\n //% miso.fieldEditor=\"gridpicker\" miso.fieldOptions.columns=4\n //% miso.fieldOptions.tooltips=\"false\" miso.fieldOptions.width=\"250\"\n //% sck.fieldEditor=\"gridpicker\" sck.fieldOptions.columns=4\n //% sck.fieldOptions.tooltips=\"false\" sck.fieldOptions.width=\"250\"\n //% group=\"SPI\"\n //% blockGap=8\n //% weight=51 shim=pins::spiPins\n function spiPins(mosi: DigitalPin, miso: DigitalPin, sck: DigitalPin): void;\n\n /**\n * Mounts a push button on the given pin\n */\n //% help=pins/push-button advanced=true shim=pins::pushButton\n function pushButton(pin: DigitalPin): void;\n\n /**\n * Set the pin used when producing sounds and melodies. Default is P0.\n * @param name pin to modulate pitch from\n */\n //% blockId=pin_set_audio_pin block=\"set audio pin $name\"\n //% help=pins/set-audio-pin\n //% name.fieldEditor=\"gridpicker\" name.fieldOptions.columns=4\n //% name.fieldOptions.tooltips=\"false\" name.fieldOptions.width=\"250\"\n //% weight=1\n //% blockGap=8 shim=pins::setAudioPin\n function setAudioPin(name: AnalogPin): void;\n\n /**\n * Sets whether or not audio will be output using a pin on the edge\n * connector.\n */\n //% blockId=pin_set_audio_pin_enabled\n //% block=\"set audio pin enabled $enabled\"\n //% weight=0 shim=pins::setAudioPinEnabled\n function setAudioPinEnabled(enabled: boolean): void;\n}\n\n\n\n //% weight=2 color=#002050 icon=\"\\uf287\"\n //% advanced=true\ndeclare namespace serial {\n\n /**\n * Read a line of text from the serial port and return the buffer when the delimiter is met.\n * @param delimiter text delimiter that separates each text chunk\n */\n //% help=serial/read-until\n //% blockId=serial_read_until block=\"serial|read until %delimiter=serial_delimiter_conv\"\n //% weight=19 shim=serial::readUntil\n function readUntil(delimiter: string): string;\n\n /**\n * Read the buffered received data as a string\n */\n //% help=serial/read-string\n //% blockId=serial_read_buffer block=\"serial|read string\"\n //% weight=18 shim=serial::readString\n function readString(): string;\n\n /**\n * Register an event to be fired when one of the delimiter is matched.\n * @param delimiters the characters to match received characters against.\n */\n //% help=serial/on-data-received\n //% weight=18 blockId=serial_on_data_received block=\"serial|on data received %delimiters=serial_delimiter_conv\" shim=serial::onDataReceived\n function onDataReceived(delimiters: string, body: () => void): void;\n\n /**\n * Send a piece of text through the serial connection.\n */\n //% help=serial/write-string\n //% weight=87 blockGap=8\n //% blockId=serial_writestring block=\"serial|write string %text\"\n //% text.shadowOptions.toString=true shim=serial::writeString\n function writeString(text: string): void;\n\n /**\n * Send a buffer through serial connection\n */\n //% blockId=serial_writebuffer block=\"serial|write buffer %buffer=serial_readbuffer\"\n //% help=serial/write-buffer advanced=true weight=6 shim=serial::writeBuffer\n function writeBuffer(buffer: Buffer): void;\n\n /**\n * Read multiple characters from the receive buffer. \n * If length is positive, pauses until enough characters are present.\n * @param length default buffer length\n */\n //% blockId=serial_readbuffer block=\"serial|read buffer %length\"\n //% help=serial/read-buffer advanced=true weight=5 shim=serial::readBuffer\n function readBuffer(length: int32): Buffer;\n\n /**\n * Set the serial input and output to use pins instead of the USB connection.\n * @param tx the new transmission pin, eg: SerialPin.P0\n * @param rx the new reception pin, eg: SerialPin.P1\n * @param rate the new baud rate. eg: 115200\n */\n //% weight=10\n //% help=serial/redirect\n //% blockId=serial_redirect block=\"serial|redirect to|TX %tx|RX %rx|at baud rate %rate\"\n //% blockExternalInputs=1\n //% tx.fieldEditor=\"gridpicker\" tx.fieldOptions.columns=3\n //% tx.fieldOptions.tooltips=\"false\"\n //% rx.fieldEditor=\"gridpicker\" rx.fieldOptions.columns=3\n //% rx.fieldOptions.tooltips=\"false\"\n //% blockGap=8 shim=serial::redirect\n function redirect(tx: SerialPin, rx: SerialPin, rate: BaudRate): void;\n\n /**\n Set the baud rate of the serial port\n */\n //% weight=10\n //% blockId=serial_setbaudrate block=\"serial|set baud rate %rate\"\n //% blockGap=8 inlineInputMode=inline\n //% help=serial/set-baud-rate\n //% group=\"Configuration\" advanced=true shim=serial::setBaudRate\n function setBaudRate(rate: BaudRate): void;\n\n /**\n * Direct the serial input and output to use the USB connection.\n */\n //% weight=9 help=serial/redirect-to-usb\n //% blockId=serial_redirect_to_usb block=\"serial|redirect to USB\" shim=serial::redirectToUSB\n function redirectToUSB(): void;\n\n /**\n * Sets the size of the RX buffer in bytes\n * @param size length of the rx buffer in bytes, eg: 32\n */\n //% help=serial/set-rx-buffer-size\n //% blockId=serialSetRxBufferSize block=\"serial set rx buffer size to $size\"\n //% advanced=true shim=serial::setRxBufferSize\n function setRxBufferSize(size: uint8): void;\n\n /**\n * Sets the size of the TX buffer in bytes\n * @param size length of the tx buffer in bytes, eg: 32\n */\n //% help=serial/set-tx-buffer-size\n //% blockId=serialSetTxBufferSize block=\"serial set tx buffer size to $size\"\n //% advanced=true shim=serial::setTxBufferSize\n function setTxBufferSize(size: uint8): void;\n\n /** Send DMESG debug buffer over serial. */\n //% shim=serial::writeDmesg\n function writeDmesg(): void;\n}\n\n\n\n //% indexerGet=BufferMethods::getByte indexerSet=BufferMethods::setByte\ndeclare interface Buffer {\n /**\n * Reads an unsigned byte at a particular location\n */\n //% shim=BufferMethods::getUint8\n getUint8(off: int32): int32;\n\n /**\n * Returns false when the buffer can be written to.\n */\n //% shim=BufferMethods::isReadOnly\n isReadOnly(): boolean;\n\n /**\n * Writes an unsigned byte at a particular location\n */\n //% shim=BufferMethods::setUint8\n setUint8(off: int32, v: int32): void;\n\n /**\n * Write a number in specified format in the buffer.\n */\n //% shim=BufferMethods::setNumber\n setNumber(format: NumberFormat, offset: int32, value: number): void;\n\n /**\n * Read a number in specified format from the buffer.\n */\n //% shim=BufferMethods::getNumber\n getNumber(format: NumberFormat, offset: int32): number;\n\n /** Returns the length of a Buffer object. */\n //% property shim=BufferMethods::length\n length: int32;\n\n /**\n * Fill (a fragment) of the buffer with given value.\n */\n //% offset.defl=0 length.defl=-1 shim=BufferMethods::fill\n fill(value: int32, offset?: int32, length?: int32): void;\n\n /**\n * Return a copy of a fragment of a buffer.\n */\n //% offset.defl=0 length.defl=-1 shim=BufferMethods::slice\n slice(offset?: int32, length?: int32): Buffer;\n\n /**\n * Shift buffer left in place, with zero padding.\n * @param offset number of bytes to shift; use negative value to shift right\n * @param start start offset in buffer. Default is 0.\n * @param length number of elements in buffer. If negative, length is set as the buffer length minus\n * start. eg: -1\n */\n //% start.defl=0 length.defl=-1 shim=BufferMethods::shift\n shift(offset: int32, start?: int32, length?: int32): void;\n\n /**\n * Convert a buffer to string assuming UTF8 encoding\n */\n //% shim=BufferMethods::toString\n toString(): string;\n\n /**\n * Convert a buffer to its hexadecimal representation.\n */\n //% shim=BufferMethods::toHex\n toHex(): string;\n\n /**\n * Rotate buffer left in place.\n * @param offset number of bytes to shift; use negative value to shift right\n * @param start start offset in buffer. Default is 0.\n * @param length number of elements in buffer. If negative, length is set as the buffer length minus\n * start. eg: -1\n */\n //% start.defl=0 length.defl=-1 shim=BufferMethods::rotate\n rotate(offset: int32, start?: int32, length?: int32): void;\n\n /**\n * Write contents of `src` at `dstOffset` in current buffer.\n */\n //% shim=BufferMethods::write\n write(dstOffset: int32, src: Buffer): void;\n\n /**\n * Compute k-bit FNV-1 non-cryptographic hash of the buffer.\n */\n //% shim=BufferMethods::hash\n hash(bits: int32): uint32;\n}\ndeclare namespace control {\n\n /**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n //% deprecated=1 shim=control::createBuffer\n function createBuffer(size: int32): Buffer;\n\n /**\n * Create a new buffer with UTF8-encoded string\n * @param str the string to put in the buffer\n */\n //% deprecated=1 shim=control::createBufferFromUTF8\n function createBufferFromUTF8(str: string): Buffer;\n}\ndeclare namespace light {\n\n /**\n * Sends a color buffer to a light strip\n **/\n //% advanced=true shim=light::sendWS2812Buffer\n function sendWS2812Buffer(buf: Buffer, pin: int32): void;\n\n /**\n * Sends a color buffer to a light strip\n **/\n //% advanced=true shim=light::sendWS2812BufferWithBrightness\n function sendWS2812BufferWithBrightness(buf: Buffer, pin: int32, brightness: int32): void;\n\n /**\n * Sets the light mode of a pin\n **/\n //% advanced=true\n //% shim=light::setMode\n function setMode(pin: int32, mode: int32): void;\n}\ndeclare namespace input {\n\n /**\n * Do something when the logo is touched and released again.\n * @param body the code to run when the logo is pressed\n */\n //% weight=83 blockGap=32\n //% blockId=input_logo_event block=\"on logo $action\"\n //% group=\"micro:bit (V2)\"\n //% parts=\"logotouch\"\n //% help=\"input/on-logo-event\" shim=input::onLogoEvent\n function onLogoEvent(action: TouchButtonEvent, body: () => void): void;\n\n /**\n * Get the logo state (pressed or not).\n */\n //% weight=58\n //% blockId=\"input_logo_is_pressed\" block=\"logo is pressed\"\n //% blockGap=8\n //% group=\"micro:bit (V2)\"\n //% parts=\"logotouch\"\n //% help=\"input/logo-is-pressed\" shim=input::logoIsPressed\n function logoIsPressed(): boolean;\n}\ndeclare namespace pins {\n\n /**\n * Configure the touch detection for the pins and logo.\n * P0, P1, P2 use resistive touch by default.\n * The logo uses capacitative touch by default.\n * @param name target to change the touch mode for\n * @param mode the touch mode to use\n */\n //% weight=60\n //% blockId=device_touch_set_type block=\"set %name to touch mode %mode\"\n //% advanced=true\n //% group=\"micro:bit (V2)\"\n //% help=pins/touch-set-mode shim=pins::touchSetMode\n function touchSetMode(name: TouchTarget, mode: TouchTargetMode): void;\n}\ndeclare namespace music {\n\n /**\n * Internal use only\n **/\n //% async shim=music::__playSoundExpression\n function __playSoundExpression(nodes: string, waitTillDone: boolean): void;\n\n /**\n * Internal use only\n */\n //% shim=music::__stopSoundExpressions\n function __stopSoundExpressions(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
|
|
2782
2782
|
"soundexpressions.cpp": "#include \"pxt.h\"\r\n\r\nnamespace music {\r\n /**\r\n * Internal use only\r\n **/\r\n //% async\r\n void __playSoundExpression(String nodes, bool waitTillDone) {\r\n#if MICROBIT_CODAL\r\n if (waitTillDone)\r\n uBit.audio.soundExpressions.play(MSTR(nodes));\r\n else\r\n uBit.audio.soundExpressions.playAsync(MSTR(nodes));\r\n#else\r\n target_panic(PANIC_VARIANT_NOT_SUPPORTED);\r\n#endif\r\n }\r\n\r\n /**\r\n * Internal use only\r\n */\r\n //% \r\n void __stopSoundExpressions() {\r\n#if MICROBIT_CODAL\r\n uBit.audio.soundExpressions.stop();\r\n#endif\r\n }\r\n}",
|
|
2783
2783
|
"soundexpressions.ts": "/**\n * A sound expression.\n */\n//% fixedInstances\n//% blockNamespace=music\n//% group=\"micro:bit (V2)\"\nclass SoundExpression {\n constructor(private notes: string) {\n }\n\n /**\n * Starts to play a sound expression.\n */\n //% block=\"play sound $this\"\n //% weight=80\n //% blockGap=8\n //% help=music/play\n //% group=\"micro:bit (V2)\"\n //% parts=builtinspeaker\n //% deprecated=1\n play() {\n music.__playSoundExpression(this.notes, false)\n }\n\n /**\n * Plays a sound expression until finished\n */\n //% block=\"play sound $this until done\"\n //% weight=81\n //% blockGap=8\n //% help=music/play-until-done\n //% group=\"micro:bit (V2)\"\n //% parts=builtinspeaker\n //% deprecated=1\n playUntilDone() {\n music.__playSoundExpression(this.notes, true)\n }\n\n getNotes() {\n return this.notes;\n }\n}\n\nenum WaveShape {\n Sine = 0,\n Sawtooth = 1,\n Triangle = 2,\n Square = 3,\n Noise = 4\n}\n\nenum InterpolationCurve {\n Linear,\n Curve,\n Logarithmic\n}\n\nenum SoundExpressionEffect {\n None = 0,\n Vibrato = 1,\n Tremolo = 2,\n Warble = 3\n}\n\nenum SoundExpressionPlayMode {\n //% block=\"until done\"\n UntilDone,\n //% block=\"in background\"\n InBackground\n}\n\nnamespace soundExpression {\n //% fixedInstance whenUsed block=\"{id:soundexpression}giggle\"\n export const giggle = new SoundExpression(\"giggle\");\n //% fixedInstance whenUsed block=\"{id:soundexpression}happy\"\n export const happy = new SoundExpression(\"happy\");\n //% fixedInstance whenUsed block=\"{id:soundexpression}hello\"\n export const hello = new SoundExpression(\"hello\");\n //% fixedInstance whenUsed block=\"{id:soundexpression}mysterious\"\n export const mysterious = new SoundExpression(\"mysterious\");\n //% fixedInstance whenUsed block=\"{id:soundexpression}sad\"\n export const sad = new SoundExpression(\"sad\");\n //% fixedInstance whenUsed block=\"{id:soundexpression}slide\"\n export const slide = new SoundExpression(\"slide\");\n //% fixedInstance whenUsed block=\"{id:soundexpression}soaring\"\n export const soaring = new SoundExpression(\"soaring\");\n //% fixedInstance whenUsed block=\"{id:soundexpression}spring\"\n export const spring = new SoundExpression(\"spring\");\n //% fixedInstance whenUsed block=\"{id:soundexpression}twinkle\"\n export const twinkle = new SoundExpression(\"twinkle\");\n //% fixedInstance whenUsed block=\"{id:soundexpression}yawn\"\n export const yawn = new SoundExpression(\"yawn\");\n\n export enum InterpolationEffect {\n None = 0,\n Linear = 1,\n Curve = 2,\n ExponentialRising = 5,\n ExponentialFalling = 6,\n ArpeggioRisingMajor = 8,\n ArpeggioRisingMinor = 10,\n ArpeggioRisingDiminished = 12,\n ArpeggioRisingChromatic = 14,\n ArpeggioRisingWholeTone = 16,\n ArpeggioFallingMajor = 9,\n ArpeggioFallingMinor = 11,\n ArpeggioFallingDiminished = 13,\n ArpeggioFallingChromatic = 15,\n ArpeggioFallingWholeTone = 17,\n Logarithmic = 18\n }\n\n export class Sound {\n src: string;\n\n constructor() {\n this.src = \"000000000000000000000000000000000000000000000000000000000000000000000000\"\n }\n\n get wave(): WaveShape {\n return this.getValue(0, 1);\n }\n\n set wave(value: WaveShape) {\n this.setValue(0, Math.constrain(value, 0, 4), 1);\n }\n\n get volume() {\n return this.getValue(1, 4);\n }\n\n set volume(value: number) {\n this.setValue(1, Math.constrain(value, 0, 1023), 4);\n }\n\n get frequency() {\n return this.getValue(5, 4);\n }\n\n set frequency(value: number) {\n this.setValue(5, value, 4);\n }\n\n get duration() {\n return this.getValue(9, 4);\n }\n\n set duration(value: number) {\n this.setValue(9, value, 4);\n }\n\n get shape(): InterpolationEffect {\n return this.getValue(13, 2);\n }\n\n set shape(value: InterpolationEffect) {\n this.setValue(13, value, 2);\n }\n\n get endFrequency() {\n return this.getValue(18, 4);\n }\n\n set endFrequency(value: number) {\n this.setValue(18, value, 4);\n }\n\n get endVolume() {\n return this.getValue(26, 4);\n }\n\n set endVolume(value: number) {\n this.setValue(26, Math.constrain(value, 0, 1023), 4);\n }\n\n get steps() {\n return this.getValue(30, 4);\n }\n\n set steps(value: number) {\n this.setValue(30, value, 4);\n }\n\n get fx(): SoundExpressionEffect {\n return this.getValue(34, 2);\n }\n\n set fx(value: SoundExpressionEffect) {\n this.setValue(34, Math.constrain(value, 0, 3), 2);\n }\n\n get fxParam() {\n return this.getValue(36, 4);\n }\n\n set fxParam(value: number) {\n this.setValue(36, value, 4);\n }\n\n get fxnSteps() {\n return this.getValue(40, 4);\n }\n\n set fxnSteps(value: number) {\n this.setValue(40, value, 4);\n }\n\n get frequencyRandomness() {\n return this.getValue(44, 4);\n }\n\n set frequencyRandomness(value: number) {\n this.setValue(44, value, 4);\n }\n\n get endFrequencyRandomness() {\n return this.getValue(48, 4);\n }\n\n set endFrequencyRandomness(value: number) {\n this.setValue(48, value, 4);\n }\n\n get volumeRandomness() {\n return this.getValue(52, 4);\n }\n\n set volumeRandomness(value: number) {\n this.setValue(52, value, 4);\n }\n\n get endVolumeRandomness() {\n return this.getValue(56, 4);\n }\n\n set endVolumeRandomness(value: number) {\n this.setValue(56, value, 4);\n }\n\n get durationRandomness() {\n return this.getValue(60, 4);\n }\n\n set durationRandomness(value: number) {\n this.setValue(60, value, 4);\n }\n\n get fxParamRandomness() {\n return this.getValue(64, 4);\n }\n\n set fxParamRandomness(value: number) {\n this.setValue(64, value, 4);\n }\n\n get fxnStepsRandomness() {\n return this.getValue(68, 4);\n }\n\n set fxnStepsRandomness(value: number) {\n this.setValue(68, value, 4);\n }\n\n copy() {\n const result = new Sound();\n result.src = this.src.slice(0);\n return result;\n }\n\n protected setValue(offset: number, value: number, length: number) {\n value = Math.constrain(value | 0, 0, Math.pow(10, length) - 1);\n this.src = this.src.substr(0, offset) + formatNumber(value, length) + this.src.substr(offset + length);\n }\n\n protected getValue(offset: number, length: number) {\n return parseInt(this.src.substr(offset, length));\n }\n }\n\n function formatNumber(num: number, length: number) {\n let result = num + \"\";\n while (result.length < length) result = \"0\" + result;\n return result;\n }\n\n export function playSound(toPlay: Sound | Sound[]) {\n let src = \"\";\n if (Array.isArray(toPlay)) {\n src = (toPlay as Sound[]).map(s => s.src).join(\",\");\n }\n else {\n src = (toPlay as Sound).src;\n }\n\n new SoundExpression(src).playUntilDone();\n }\n}\n\nnamespace music {\n //% blockId=soundExpression_playSoundEffect\n //% block=\"play sound $sound $mode\"\n //% sound.shadow=soundExpression_createSoundEffect\n //% weight=100 help=music/play-sound-effect\n //% blockGap=8\n //% group=\"micro:bit (V2)\"\n export function playSoundEffect(sound: string, mode: SoundExpressionPlayMode) {\n if (mode === SoundExpressionPlayMode.InBackground) {\n new SoundExpression(sound).play();\n }\n else {\n new SoundExpression(sound).playUntilDone();\n }\n }\n\n //% blockId=soundExpression_createSoundEffect\n //% help=music/create-sound-effect\n //% block=\"$waveShape|| start frequency $startFrequency end frequency $endFrequency duration $duration start volume $startVolume end volume $endVolume effect $effect interpolation $interpolation\"\n //% waveShape.defl=WaveShape.Sine\n //% waveShape.fieldEditor=soundeffect\n //% startFrequency.defl=2000\n //% endFrequency.defl=0\n //% startVolume.defl=1023\n //% endVolume.defl=0\n //% duration.defl=500\n //% effect.defl=SoundExpressionEffect.None\n //% interpolation.defl=InterpolationCurve.Linear\n //% compileHiddenArguments=true\n //% inlineInputMode=\"variable\"\n //% group=\"micro:bit (V2)\"\n export function createSoundEffect(waveShape: WaveShape, startFrequency: number, endFrequency: number, startVolume: number, endVolume: number, duration: number, effect: SoundExpressionEffect, interpolation: InterpolationCurve): string {\n const sound = new soundExpression.Sound();\n sound.wave = waveShape;\n sound.frequency = startFrequency;\n sound.volume = startVolume;\n sound.endFrequency = endFrequency;\n sound.endVolume = endVolume;\n sound.duration = duration;\n sound.fx = effect;\n\n switch (interpolation) {\n case InterpolationCurve.Linear:\n sound.shape = soundExpression.InterpolationEffect.Linear;\n sound.steps = 128;\n break;\n case InterpolationCurve.Curve:\n sound.shape = soundExpression.InterpolationEffect.Curve;\n sound.steps = 90;\n break;\n case InterpolationCurve.Logarithmic:\n sound.shape = soundExpression.InterpolationEffect.Logarithmic;\n sound.steps = 90;\n break;\n }\n\n switch (sound.fx) {\n case SoundExpressionEffect.Vibrato:\n sound.fxnSteps = 512;\n sound.fxParam = 2;\n break;\n case SoundExpressionEffect.Tremolo:\n sound.fxnSteps = 900;\n sound.fxParam = 3;\n break;\n case SoundExpressionEffect.Warble:\n sound.fxnSteps = 700;\n sound.fxParam = 2;\n break;\n }\n\n return sound.src;\n }\n\n //% blockId=soundExpression_builtinSoundEffect\n //% block=\"$soundExpression\"\n //% blockGap=8\n //% group=\"micro:bit (V2)\"\n //% toolboxParent=soundExpression_playSoundEffect\n //% toolboxParentArgument=sound\n //% weight=102 help=music/builtin-sound-effect\n export function builtinSoundEffect(soundExpression: SoundExpression) {\n return soundExpression.getNotes();\n }\n}",
|
|
2784
2784
|
"templates.ts": "/**\n * Tagged hex literal converter\n */\n//% shim=@hex\nfunction hex(lits: any, ...args: any[]): Buffer { return null }\n",
|
|
@@ -2788,7 +2788,7 @@
|
|
|
2788
2788
|
"radio": {
|
|
2789
2789
|
"README.md": "# radio\n\nThe radio library.\n\n",
|
|
2790
2790
|
"enums.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace radio {\n}\n\n// Auto-generated. Do not edit. Really.\n",
|
|
2791
|
-
"pxt.json": "{\n \"name\": \"radio\",\n \"description\": \"The radio services\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"radio.cpp\",\n \"radio.ts\",\n \"targetoverrides.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2791
|
+
"pxt.json": "{\n \"name\": \"radio\",\n \"description\": \"The radio services\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"radio.cpp\",\n \"radio.ts\",\n \"targetoverrides.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"yotta\": {\n \"config\": {\n \"microbit-dal\": {\n \"bluetooth\": {\n \"enabled\": 0\n }\n }\n }\n },\n \"icon\": \"/static/libs/radio.png\"\n}\n",
|
|
2792
2792
|
"radio.cpp": "#include \"pxt.h\"\n\n// micro:bit dal\n#if defined(MICROBIT_H) \n\n#define CODAL_RADIO MicroBitRadio\n#define DEVICE_OK MICROBIT_OK\n#define DEVICE_NOT_SUPPORTED MICROBIT_NOT_SUPPORTED\n#define CODAL_EVENT MicroBitEvent\n#define CODAL_RADIO_MICROBIT_DAL 1\n\n// any other NRF52 board\n#elif defined(NRF52_SERIES)\n\n#include \"NRF52Radio.h\"\n#define CODAL_RADIO codal::NRF52Radio\n#define CODAL_EVENT codal::Event\n\n#endif\n\nusing namespace pxt;\n\n#ifndef MICROBIT_RADIO_MAX_PACKET_SIZE\n#define MICROBIT_RADIO_MAX_PACKET_SIZE 32\n#endif\n\n#ifndef DEVICE_RADIO_MAX_PACKET_SIZE\n#define DEVICE_RADIO_MAX_PACKET_SIZE MICROBIT_RADIO_MAX_PACKET_SIZE\n#endif\n\n#ifndef MICROBIT_ID_RADIO\n#define MICROBIT_ID_RADIO 29\n#endif\n\n#ifndef DEVICE_ID_RADIO\n#define DEVICE_ID_RADIO MICROBIT_ID_RADIO\n#endif\n\n#ifndef MICROBIT_RADIO_EVT_DATAGRAM\n#define MICROBIT_RADIO_EVT_DATAGRAM 1 // Event to signal that a new datagram has been received.\n#endif\n\n#ifndef DEVICE_RADIO_EVT_DATAGRAM\n#define DEVICE_RADIO_EVT_DATAGRAM MICROBIT_RADIO_EVT_DATAGRAM\n#endif\n\n//% color=#E3008C weight=96 icon=\"\\uf012\"\nnamespace radio {\n \n#if CODAL_RADIO_MICROBIT_DAL\n CODAL_RADIO* getRadio() {\n return &uBit.radio;\n }\n#elif defined(CODAL_RADIO)\nclass RadioWrap {\n CODAL_RADIO radio;\n public:\n RadioWrap() \n : radio()\n {}\n\n CODAL_RADIO* getRadio() {\n return &radio;\n }\n};\nSINGLETON(RadioWrap);\nCODAL_RADIO* getRadio() {\n auto wrap = getRadioWrap();\n if (NULL != wrap)\n return wrap->getRadio(); \n return NULL;\n}\n#endif // #else\n\n bool radioEnabled = false;\n bool init = false;\n int radioEnable() {\n#ifdef CODAL_RADIO\n auto radio = getRadio();\n if (NULL == radio) \n return DEVICE_NOT_SUPPORTED;\n\n if (init && !radioEnabled) {\n //If radio was explicitly disabled from a call to off API\n //We don't want to enable it here. User needs to call on API first.\n return DEVICE_NOT_SUPPORTED;\n }\n\n int r = radio->enable();\n if (r != DEVICE_OK) {\n target_panic(43);\n return r;\n }\n if (!init) {\n getRadio()->setGroup(0); //Default group zero. This used to be pxt::programHash()\n getRadio()->setTransmitPower(6); // start with high power by default\n init = true;\n }\n radioEnabled = true;\n return r;\n#else\n return DEVICE_NOT_SUPPORTED;\n#endif\n }\n\n /**\n * Disables the radio for use as a multipoint sender/receiver.\n * Disabling radio will help conserve battery power when it is not in use.\n */\n //% help=radio/off\n void off() {\n#ifdef CODAL_RADIO\n auto radio = getRadio();\n if (NULL == radio)\n return;\n\n int r = radio->disable();\n if (r != DEVICE_OK) {\n target_panic(43);\n } else {\n radioEnabled = false;\n }\n#else\n return;\n#endif\n }\n\n /**\n * Initialises the radio for use as a multipoint sender/receiver\n * Only useful when the radio.off() is used beforehand.\n */\n //% help=radio/on\n void on() {\n#ifdef CODAL_RADIO\n auto radio = getRadio();\n if (NULL == radio)\n return;\n\n int r = radio->enable();\n if (r != DEVICE_OK) {\n target_panic(43);\n } else {\n radioEnabled = true;\n }\n#else\n return;\n#endif\n }\n\n /**\n * Sends an event over radio to neigboring devices\n */\n //% blockId=radioRaiseEvent block=\"radio raise event|from source %src=control_event_source_id|with value %value=control_event_value_id\"\n //% blockExternalInputs=1\n //% advanced=true\n //% weight=1\n //% help=radio/raise-event\n void raiseEvent(int src, int value) {\n#ifdef CODAL_RADIO \n if (radioEnable() != DEVICE_OK) return;\n\n getRadio()->event.eventReceived(CODAL_EVENT(src, value, CREATE_ONLY));\n#endif \n }\n\n /**\n * Internal use only. Takes the next packet from the radio queue and returns its contents + RSSI in a Buffer.\n * @returns NULL if no packet available\n */\n //%\n Buffer readRawPacket() {\n#ifdef CODAL_RADIO \n if (radioEnable() != DEVICE_OK) return NULL;\n\n auto p = getRadio()->datagram.recv();\n#if CODAL_RADIO_MICROBIT_DAL\n if (p == PacketBuffer::EmptyPacket)\n return NULL;\n int rssi = p.getRSSI();\n auto length = p.length();\n auto bytes = p.getBytes();\n#else\n // TODO: RSSI support\n int rssi = -73; \n auto length = p.length();\n auto bytes = p.getBytes();\n if (length == 0)\n return NULL;\n#endif\n\n uint8_t buf[DEVICE_RADIO_MAX_PACKET_SIZE + sizeof(int)]; // packet length + rssi\n memset(buf, 0, sizeof(buf));\n memcpy(buf, bytes, length); // data\n memcpy(buf + DEVICE_RADIO_MAX_PACKET_SIZE, &rssi, sizeof(int)); // RSSi - assumes Int32LE layout\n return mkBuffer(buf, sizeof(buf));\n#else\n return NULL;\n#endif \n }\n\n /**\n * Internal use only. Sends a raw packet through the radio (assumes RSSI appened to packet)\n */\n //% async\n void sendRawPacket(Buffer msg) {\n#ifdef CODAL_RADIO \n if (radioEnable() != DEVICE_OK || NULL == msg) return;\n\n // don't send RSSI data; and make sure no buffer underflow\n int len = msg->length - sizeof(int);\n if (len > 0)\n getRadio()->datagram.send(msg->data, len);\n#endif \n }\n\n /**\n * Used internally by the library.\n */\n //% help=radio/on-data-received\n //% weight=0\n //% blockId=radio_datagram_received_event block=\"radio on data received\" blockGap=8\n //% deprecated=true blockHidden=1\n void onDataReceived(Action body) {\n#ifdef CODAL_RADIO \n if (radioEnable() != DEVICE_OK) return;\n\n registerWithDal(DEVICE_ID_RADIO, DEVICE_RADIO_EVT_DATAGRAM, body);\n getRadio()->datagram.recv(); // wake up read code\n#endif \n }\n\n /**\n * Sets the group id for radio communications. A micro:bit can only listen to one group ID at any time.\n * @param id the group id between ``0`` and ``255``, eg: 1\n */\n //% help=radio/set-group\n //% weight=100\n //% blockId=radio_set_group block=\"radio set group %ID\"\n //% id.min=0 id.max=255\n //% group=\"Group\"\n void setGroup(int id) {\n#ifdef CODAL_RADIO \n if (radioEnable() != DEVICE_OK) return;\n\n getRadio()->setGroup(id);\n#endif \n }\n\n /**\n * Change the output power level of the transmitter to the given value.\n * @param power a value in the range 0..7, where 0 is the lowest power and 7 is the highest. eg: 7\n */\n //% help=radio/set-transmit-power\n //% weight=9 blockGap=8\n //% blockId=radio_set_transmit_power block=\"radio set transmit power %power\"\n //% power.min=0 power.max=7\n //% advanced=true\n void setTransmitPower(int power) {\n#ifdef CODAL_RADIO \n if (radioEnable() != DEVICE_OK) return;\n\n getRadio()->setTransmitPower(power);\n#endif \n }\n\n /**\n * Change the transmission and reception band of the radio to the given channel\n * @param band a frequency band in the range 0 - 83. Each step is 1MHz wide, based at 2400MHz.\n **/\n //% help=radio/set-frequency-band\n //% weight=8 blockGap=8\n //% blockId=radio_set_frequency_band block=\"radio set frequency band %band\"\n //% band.min=0 band.max=83\n //% advanced=true\n void setFrequencyBand(int band) {\n#ifdef CODAL_RADIO \n if (radioEnable() != DEVICE_OK) return;\n getRadio()->setFrequencyBand(band);\n#endif \n }\n}\n",
|
|
2793
2793
|
"radio.ts": "\nenum RadioPacketProperty {\n //% blockIdentity=radio._packetProperty\n //% block=\"signal strength\"\n SignalStrength = 2,\n //% blockIdentity=radio._packetProperty\n //% block=\"time\"\n Time = 0,\n //% block=\"serial number\"\n //% blockIdentity=radio._packetProperty\n SerialNumber = 1\n}\n\n/**\n * Communicate data using radio packets\n */\n//% color=#E3008C weight=96 icon=\"\\uf012\" groups='[\"Group\", \"Broadcast\", \"Send\", \"Receive\"]'\nnamespace radio {\n\n // keep in sync with CODAL\n const RADIO_MAX_PACKET_SIZE = 32;\n const MAX_FIELD_DOUBLE_NAME_LENGTH = 8;\n const MAX_PAYLOAD_LENGTH = 20;\n const PACKET_PREFIX_LENGTH = 9;\n const VALUE_PACKET_NAME_LEN_OFFSET = 13;\n const DOUBLE_VALUE_PACKET_NAME_LEN_OFFSET = 17;\n\n // Packet Spec:\n // | 0 | 1 ... 4 | 5 ... 8 | 9 ... 28\n // ----------------------------------------------------------------\n // | packet type | system time | serial number | payload\n //\n // Serial number defaults to 0 unless enabled by user\n\n // payload: number (9 ... 12)\n export const PACKET_TYPE_NUMBER = 0;\n // payload: number (9 ... 12), name length (13), name (14 ... 26)\n export const PACKET_TYPE_VALUE = 1;\n // payload: string length (9), string (10 ... 28)\n export const PACKET_TYPE_STRING = 2;\n // payload: buffer length (9), buffer (10 ... 28)\n export const PACKET_TYPE_BUFFER = 3;\n // payload: number (9 ... 16)\n export const PACKET_TYPE_DOUBLE = 4;\n // payload: number (9 ... 16), name length (17), name (18 ... 26)\n export const PACKET_TYPE_DOUBLE_VALUE = 5;\n\n let transmittingSerial: boolean;\n let initialized = false;\n\n export let lastPacket: RadioPacket;\n let onReceivedNumberHandler: (receivedNumber: number) => void;\n let onReceivedValueHandler: (name: string, value: number) => void;\n let onReceivedStringHandler: (receivedString: string) => void;\n let onReceivedBufferHandler: (receivedBuffer: Buffer) => void;\n\n function init() {\n if (initialized) return;\n initialized = true;\n onDataReceived(handleDataReceived);\n }\n\n function handleDataReceived() {\n let buffer: Buffer = readRawPacket();\n while (buffer) {\n lastPacket = RadioPacket.getPacket(buffer);\n switch (lastPacket.packetType) {\n case PACKET_TYPE_NUMBER:\n case PACKET_TYPE_DOUBLE:\n if (onReceivedNumberHandler)\n onReceivedNumberHandler(lastPacket.numberPayload);\n break;\n case PACKET_TYPE_VALUE:\n case PACKET_TYPE_DOUBLE_VALUE:\n if (onReceivedValueHandler)\n onReceivedValueHandler(lastPacket.stringPayload, lastPacket.numberPayload);\n break;\n case PACKET_TYPE_BUFFER:\n if (onReceivedBufferHandler)\n onReceivedBufferHandler(lastPacket.bufferPayload);\n break;\n case PACKET_TYPE_STRING:\n if (onReceivedStringHandler)\n onReceivedStringHandler(lastPacket.stringPayload);\n break;\n }\n // read next packet if any\n buffer = readRawPacket();\n }\n }\n\n /**\n * Registers code to run when the radio receives a number.\n */\n //% help=radio/on-received-number\n //% blockId=radio_on_number_drag block=\"on radio received\" blockGap=16\n //% useLoc=\"radio.onDataPacketReceived\" draggableParameters=reporter\n //% group=\"Receive\"\n //% weight=20\n export function onReceivedNumber(cb: (receivedNumber: number) => void) {\n init();\n onReceivedNumberHandler = cb;\n }\n\n /**\n * Registers code to run when the radio receives a key value pair.\n */\n //% help=radio/on-received-value\n //% blockId=radio_on_value_drag block=\"on radio received\" blockGap=16\n //% useLoc=\"radio.onDataPacketReceived\" draggableParameters=reporter\n //% group=\"Receive\"\n //% weight=19\n export function onReceivedValue(cb: (name: string, value: number) => void) {\n init();\n onReceivedValueHandler = cb;\n }\n\n /**\n * Registers code to run when the radio receives a string.\n */\n //% help=radio/on-received-string\n //% blockId=radio_on_string_drag block=\"on radio received\" blockGap=16\n //% useLoc=\"radio.onDataPacketReceived\" draggableParameters=reporter\n //% group=\"Receive\"\n //% weight=18\n export function onReceivedString(cb: (receivedString: string) => void) {\n init();\n onReceivedStringHandler = cb;\n }\n\n /**\n * Registers code to run when the radio receives a buffer.\n */\n //% help=radio/on-received-buffer blockHidden=1\n //% blockId=radio_on_buffer_drag block=\"on radio received\" blockGap=16\n //% useLoc=\"radio.onDataPacketReceived\" draggableParameters=reporter\n export function onReceivedBuffer(cb: (receivedBuffer: Buffer) => void) {\n init();\n onReceivedBufferHandler = cb;\n }\n\n /**\n * Returns properties of the last radio packet received.\n * @param type the type of property to retrieve from the last packet\n */\n //% help=radio/received-packet\n //% blockGap=8\n //% blockId=radio_received_packet block=\"received packet %type=radio_packet_property\" blockGap=16\n //% group=\"Receive\"\n //% weight=16\n export function receivedPacket(type: number) {\n if (lastPacket) {\n switch (type) {\n case RadioPacketProperty.Time: return lastPacket.time;\n case RadioPacketProperty.SerialNumber: return lastPacket.serial;\n case RadioPacketProperty.SignalStrength: return lastPacket.signal;\n }\n }\n return 0;\n }\n\n /**\n * Gets a packet property.\n * @param type the packet property type, eg: PacketProperty.time\n */\n //% blockId=radio_packet_property block=\"%note\"\n //% shim=TD_ID blockHidden=1\n export function _packetProperty(type: RadioPacketProperty): number {\n return type;\n }\n\n export class RadioPacket {\n public static getPacket(data: Buffer) {\n if (!data) return undefined;\n // last 4 bytes is RSSi\n return new RadioPacket(data);\n }\n\n public static mkPacket(packetType: number) {\n const res = new RadioPacket();\n res.data[0] = packetType;\n return res;\n }\n\n private constructor(public readonly data?: Buffer) {\n if (!data) this.data = control.createBuffer(RADIO_MAX_PACKET_SIZE + 4);\n }\n\n get signal() {\n return this.data.getNumber(NumberFormat.Int32LE, this.data.length - 4);\n }\n\n get packetType() {\n return this.data[0];\n }\n\n get time() {\n return this.data.getNumber(NumberFormat.Int32LE, 1);\n }\n\n set time(val: number) {\n this.data.setNumber(NumberFormat.Int32LE, 1, val);\n }\n\n get serial() {\n return this.data.getNumber(NumberFormat.Int32LE, 5);\n }\n\n set serial(val: number) {\n this.data.setNumber(NumberFormat.Int32LE, 5, val);\n }\n\n get stringPayload() {\n const offset = getStringOffset(this.packetType) as number;\n return offset ? this.data.slice(offset + 1, this.data[offset]).toString() : undefined;\n }\n\n set stringPayload(val: string) {\n const offset = getStringOffset(this.packetType) as number;\n if (offset) {\n const buf = control.createBufferFromUTF8(truncateString(val, getMaxStringLength(this.packetType)));\n this.data[offset] = buf.length;\n this.data.write(offset + 1, buf);\n }\n }\n\n get numberPayload() {\n switch (this.packetType) {\n case PACKET_TYPE_NUMBER:\n case PACKET_TYPE_VALUE:\n return this.data.getNumber(NumberFormat.Int32LE, PACKET_PREFIX_LENGTH);\n case PACKET_TYPE_DOUBLE:\n case PACKET_TYPE_DOUBLE_VALUE:\n return this.data.getNumber(NumberFormat.Float64LE, PACKET_PREFIX_LENGTH);\n }\n return undefined;\n }\n\n set numberPayload(val: number) {\n switch (this.packetType) {\n case PACKET_TYPE_NUMBER:\n case PACKET_TYPE_VALUE:\n this.data.setNumber(NumberFormat.Int32LE, PACKET_PREFIX_LENGTH, val);\n break;\n case PACKET_TYPE_DOUBLE:\n case PACKET_TYPE_DOUBLE_VALUE:\n this.data.setNumber(NumberFormat.Float64LE, PACKET_PREFIX_LENGTH, val);\n break;\n }\n }\n\n get bufferPayload() {\n const len = this.data[PACKET_PREFIX_LENGTH];\n return this.data.slice(PACKET_PREFIX_LENGTH + 1, len);\n }\n\n set bufferPayload(b: Buffer) {\n const len = Math.min(b.length, MAX_PAYLOAD_LENGTH - 1);\n this.data[PACKET_PREFIX_LENGTH] = len;\n this.data.write(PACKET_PREFIX_LENGTH + 1, b.slice(0, len));\n }\n\n hasString() {\n return this.packetType === PACKET_TYPE_STRING ||\n this.packetType === PACKET_TYPE_VALUE ||\n this.packetType === PACKET_TYPE_DOUBLE_VALUE;\n }\n\n hasNumber() {\n return this.packetType === PACKET_TYPE_NUMBER ||\n this.packetType === PACKET_TYPE_DOUBLE ||\n this.packetType === PACKET_TYPE_VALUE ||\n this.packetType === PACKET_TYPE_DOUBLE_VALUE;\n }\n }\n\n /**\n * Broadcasts a number over radio to any connected micro:bit in the group.\n */\n //% help=radio/send-number\n //% weight=60\n //% blockId=radio_datagram_send block=\"radio send number %value\" blockGap=8\n //% group=\"Send\"\n export function sendNumber(value: number) {\n let packet: RadioPacket;\n\n if (value === (value | 0)) {\n packet = RadioPacket.mkPacket(PACKET_TYPE_NUMBER);\n }\n else {\n packet = RadioPacket.mkPacket(PACKET_TYPE_DOUBLE);\n }\n\n packet.numberPayload = value;\n sendPacket(packet);\n }\n\n /**\n * Broadcasts a name / value pair along with the device serial number\n * and running time to any connected micro:bit in the group. The name can\n * include no more than 8 characters.\n * @param name the field name (max 8 characters), eg: \"name\"\n * @param value the numeric value\n */\n //% help=radio/send-value\n //% weight=59\n //% blockId=radio_datagram_send_value block=\"radio send|value %name|= %value\" blockGap=8\n //% group=\"Send\"\n export function sendValue(name: string, value: number) {\n let packet: RadioPacket;\n\n if (value === (value | 0)) {\n packet = RadioPacket.mkPacket(PACKET_TYPE_VALUE);\n }\n else {\n packet = RadioPacket.mkPacket(PACKET_TYPE_DOUBLE_VALUE);\n }\n\n packet.numberPayload = value;\n packet.stringPayload = name;\n sendPacket(packet);\n }\n\n /**\n * Broadcasts a string along with the device serial number\n * and running time to any connected micro:bit in the group.\n */\n //% help=radio/send-string\n //% weight=58\n //% blockId=radio_datagram_send_string block=\"radio send string %msg\"\n //% msg.shadowOptions.toString=true\n //% group=\"Send\"\n export function sendString(value: string) {\n const packet = RadioPacket.mkPacket(PACKET_TYPE_STRING);\n packet.stringPayload = value;\n sendPacket(packet);\n }\n\n /**\n * Broadcasts a buffer (up to 19 bytes long) along with the device serial number\n * and running time to any connected micro:bit in the group.\n */\n //% help=radio/send-buffer\n //% weight=57\n //% advanced=true\n export function sendBuffer(msg: Buffer) {\n const packet = RadioPacket.mkPacket(PACKET_TYPE_BUFFER);\n packet.bufferPayload = msg;\n sendPacket(packet);\n }\n\n /**\n * Set the radio to transmit the serial number in each message.\n * @param transmit value indicating if the serial number is transmitted, eg: true\n */\n //% help=radio/set-transmit-serial-number\n //% weight=8 blockGap=8\n //% blockId=radio_set_transmit_serial_number block=\"radio set transmit serial number %transmit\"\n //% advanced=true\n export function setTransmitSerialNumber(transmit: boolean) {\n transmittingSerial = transmit;\n }\n\n function sendPacket(packet: RadioPacket) {\n packet.time = control.millis();\n packet.serial = transmittingSerial ? control.deviceSerialNumber() : 0;\n radio.sendRawPacket(packet.data);\n }\n\n function truncateString(str: string, bytes: number) {\n str = str.substr(0, bytes);\n let buff = control.createBufferFromUTF8(str);\n\n while (buff.length > bytes) {\n str = str.substr(0, str.length - 1);\n buff = control.createBufferFromUTF8(str);\n }\n\n return str;\n }\n\n function getStringOffset(packetType: number) {\n switch (packetType) {\n case PACKET_TYPE_STRING:\n return PACKET_PREFIX_LENGTH;\n case PACKET_TYPE_VALUE:\n return VALUE_PACKET_NAME_LEN_OFFSET;\n case PACKET_TYPE_DOUBLE_VALUE:\n return DOUBLE_VALUE_PACKET_NAME_LEN_OFFSET;\n default:\n return undefined;\n }\n }\n\n function getMaxStringLength(packetType: number) {\n switch (packetType) {\n case PACKET_TYPE_STRING:\n return MAX_PAYLOAD_LENGTH - 2;\n case PACKET_TYPE_VALUE:\n case PACKET_TYPE_DOUBLE_VALUE:\n return MAX_FIELD_DOUBLE_NAME_LENGTH;\n default:\n return undefined;\n }\n }\n}",
|
|
2794
2794
|
"shims.d.ts": "// Auto-generated. Do not edit.\n\n\n\n //% color=#E3008C weight=96 icon=\"\\uf012\"\ndeclare namespace radio {\n\n /**\n * Disables the radio for use as a multipoint sender/receiver.\n * Disabling radio will help conserve battery power when it is not in use.\n */\n //% help=radio/off shim=radio::off\n function off(): void;\n\n /**\n * Initialises the radio for use as a multipoint sender/receiver\n * Only useful when the radio.off() is used beforehand.\n */\n //% help=radio/on shim=radio::on\n function on(): void;\n\n /**\n * Sends an event over radio to neigboring devices\n */\n //% blockId=radioRaiseEvent block=\"radio raise event|from source %src=control_event_source_id|with value %value=control_event_value_id\"\n //% blockExternalInputs=1\n //% advanced=true\n //% weight=1\n //% help=radio/raise-event shim=radio::raiseEvent\n function raiseEvent(src: int32, value: int32): void;\n\n /**\n * Internal use only. Takes the next packet from the radio queue and returns its contents + RSSI in a Buffer.\n * @returns NULL if no packet available\n */\n //% shim=radio::readRawPacket\n function readRawPacket(): Buffer;\n\n /**\n * Internal use only. Sends a raw packet through the radio (assumes RSSI appened to packet)\n */\n //% async shim=radio::sendRawPacket\n function sendRawPacket(msg: Buffer): void;\n\n /**\n * Used internally by the library.\n */\n //% help=radio/on-data-received\n //% weight=0\n //% blockId=radio_datagram_received_event block=\"radio on data received\" blockGap=8\n //% deprecated=true blockHidden=1 shim=radio::onDataReceived\n function onDataReceived(body: () => void): void;\n\n /**\n * Sets the group id for radio communications. A micro:bit can only listen to one group ID at any time.\n * @param id the group id between ``0`` and ``255``, eg: 1\n */\n //% help=radio/set-group\n //% weight=100\n //% blockId=radio_set_group block=\"radio set group %ID\"\n //% id.min=0 id.max=255\n //% group=\"Group\" shim=radio::setGroup\n function setGroup(id: int32): void;\n\n /**\n * Change the output power level of the transmitter to the given value.\n * @param power a value in the range 0..7, where 0 is the lowest power and 7 is the highest. eg: 7\n */\n //% help=radio/set-transmit-power\n //% weight=9 blockGap=8\n //% blockId=radio_set_transmit_power block=\"radio set transmit power %power\"\n //% power.min=0 power.max=7\n //% advanced=true shim=radio::setTransmitPower\n function setTransmitPower(power: int32): void;\n\n /**\n * Change the transmission and reception band of the radio to the given channel\n * @param band a frequency band in the range 0 - 83. Each step is 1MHz wide, based at 2400MHz.\n **/\n //% help=radio/set-frequency-band\n //% weight=8 blockGap=8\n //% blockId=radio_set_frequency_band block=\"radio set frequency band %band\"\n //% band.min=0 band.max=83\n //% advanced=true shim=radio::setFrequencyBand\n function setFrequencyBand(band: int32): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
|
|
@@ -2799,7 +2799,7 @@
|
|
|
2799
2799
|
"devices.cpp": "#include \"pxt.h\"\n#include \"MESEvents.h\"\n\nusing namespace pxt;\n\nenum class MesCameraEvent {\n //% block=\"take photo\"\n TakePhoto = MES_CAMERA_EVT_TAKE_PHOTO,\n //% block=\"start video capture\"\n StartVideoCapture = MES_CAMERA_EVT_START_VIDEO_CAPTURE,\n //% block=\"stop video capture\"\n StopVideoCapture = MES_CAMERA_EVT_STOP_VIDEO_CAPTURE,\n //% block=\"toggle front-rear\"\n ToggleFrontRear = MES_CAMERA_EVT_TOGGLE_FRONT_REAR,\n //% block=\"launch photo mode\"\n LaunchPhotoMode = MES_CAMERA_EVT_LAUNCH_PHOTO_MODE,\n //% block=\"launch video mode\"\n LaunchVideoMode = MES_CAMERA_EVT_LAUNCH_VIDEO_MODE,\n //% block=\"stop photo mode\"\n StopPhotoMode = MES_CAMERA_EVT_STOP_PHOTO_MODE,\n //% block=\"stop video mode\"\n StopVideoMode = MES_CAMERA_EVT_STOP_VIDEO_MODE,\n};\n\nenum class MesAlertEvent {\n //% block=\"display toast\"\n DisplayToast = MES_ALERT_EVT_DISPLAY_TOAST,\n //% block=\"vibrate\"\n Vibrate = MES_ALERT_EVT_VIBRATE,\n //% block=\"play sound\"\n PlaySound = MES_ALERT_EVT_PLAY_SOUND,\n //% block=\"play ring tone\"\n PlayRingtone = MES_ALERT_EVT_PLAY_RINGTONE,\n //% block=\"find my phone\"\n FindMyPhone = MES_ALERT_EVT_FIND_MY_PHONE,\n //% block=\"ring alarm\"\n RingAlarm = MES_ALERT_EVT_ALARM1,\n //% block=\"ring alarm 2\"\n RingAlarm2 = MES_ALERT_EVT_ALARM2,\n //% block=\"ring alarm 3\"\n RingAlarm3 = MES_ALERT_EVT_ALARM3,\n //% block=\"ring alarm 4\"\n RingAlarm4 = MES_ALERT_EVT_ALARM4,\n //% block=\"ring alarm 5\"\n RingAlarm5 = MES_ALERT_EVT_ALARM5,\n //% block=\"ring alarm 6\"\n RingAlarm6 = MES_ALERT_EVT_ALARM6,\n};\n\nenum class MesDeviceInfo {\n //% block=\"incoming call\"\n IncomingCall = MES_DEVICE_INCOMING_CALL,\n //% block=\"incoming message\"\n IncomingMessage = MES_DEVICE_INCOMING_MESSAGE,\n //% block=\"orientation landscape\"\n OrientationLandscape = MES_DEVICE_ORIENTATION_LANDSCAPE,\n //% block=\"orientation portrait\"\n OrientationPortrait = MES_DEVICE_ORIENTATION_PORTRAIT,\n //% block=\"shaken\"\n Shaken = MES_DEVICE_GESTURE_DEVICE_SHAKEN,\n //% block=\"display off\"\n DisplayOff = MES_DEVICE_DISPLAY_OFF,\n //% block=\"display on\"\n DisplayOn = MES_DEVICE_DISPLAY_ON,\n};\n\nenum class MesRemoteControlEvent {\n //% block=\"play\"\n play = MES_REMOTE_CONTROL_EVT_PLAY,\n //% block=\"pause\"\n pause = MES_REMOTE_CONTROL_EVT_PAUSE,\n //% block=\"stop\"\n stop = MES_REMOTE_CONTROL_EVT_STOP,\n //% block=\"next track\"\n nextTrack = MES_REMOTE_CONTROL_EVT_NEXTTRACK,\n //% block=\"previous track\"\n previousTrack = MES_REMOTE_CONTROL_EVT_PREVTRACK,\n //% block=\"forward\"\n forward = MES_REMOTE_CONTROL_EVT_FORWARD,\n //% block=\"rewind\"\n rewind = MES_REMOTE_CONTROL_EVT_REWIND,\n //% block=\"volume up\"\n volumeUp = MES_REMOTE_CONTROL_EVT_VOLUMEUP,\n //% block=\"volume down\"\n volumeDown = MES_REMOTE_CONTROL_EVT_VOLUMEDOWN,\n};\n\n/**\n * Control a phone with the BBC micro:bit via Bluetooth.\n */\n//% color=#008272 weight=80 icon=\"\\uf10b\"\nnamespace devices {\n\n static int _signalStrength = -1;\n static void signalStrengthHandler(MicroBitEvent ev) { \n // keep in sync with MESEvents.h\n _signalStrength = ev.value - 1; \n }\n static void initSignalStrength() {\n if (_signalStrength < 0) {\n _signalStrength = 0;\n uBit.messageBus.listen(MES_SIGNAL_STRENGTH_ID, MICROBIT_EVT_ANY, signalStrengthHandler);\n } \n }\n \n /**\n * Returns the last signal strength reported by the paired device.\n */\n //% help=devices/signal-strength weight=24\n //% blockId=devices_signal_strength block=\"signal strength\" blockGap=14 icon=\"\\uf012\" blockGap=14\n int signalStrength() {\n initSignalStrength();\n return _signalStrength;\n }\n\n /**\n * Registers code to run when the device notifies about a change of signal strength.\n * @param body Code run when the signal strength changes.\n */\n //% weight=23 help=devices/on-signal-strength-changed\n //% blockId=devices_signal_strength_changed_event block=\"on signal strength changed\" icon=\"\\uf012\"\n void onSignalStrengthChanged(Action body) {\n initSignalStrength(); \n registerWithDal(MES_SIGNAL_STRENGTH_ID, MICROBIT_EVT_ANY, body);\n }\n}\n",
|
|
2800
2800
|
"devices.ts": "\nnamespace devices {\n /**\n * Sends a ``camera`` command to the parent device.\n * @param event event description\n */\n //% weight=30 help=devices/tell-camera-to\n //% blockId=devices_camera icon=\"\\uf030\" block=\"tell camera to|%property\" blockGap=8\n export function tellCameraTo(event: MesCameraEvent) {\n control.raiseEvent(DAL.MES_CAMERA_ID, event);\n }\n\n /**\n * Sends a ``remote control`` command to the parent device.\n * @param event event description\n */\n //% weight=29 help=devices/tell-remote-control-to\n //% blockId=devices_remote_control block=\"tell remote control to|%property\" blockGap=14 icon=\"\\uf144\"\n export function tellRemoteControlTo(event: MesRemoteControlEvent) {\n control.raiseEvent(DAL.MES_REMOTE_CONTROL_ID, event);\n }\n\n /**\n * Sends an ``alert`` command to the parent device.\n * @param event event description\n */\n //% weight=27 help=devices/raise-alert-to\n //% blockId=devices_alert block=\"raise alert to|%property\" icon=\"\\uf0f3\"\n export function raiseAlertTo(event: MesAlertEvent) {\n control.raiseEvent(DAL.MES_ALERTS_ID, event);\n }\n\n /**\n * Registers code to run when the device notifies about a particular event.\n * @param event event description\n * @param body code handler when event is triggered\n */\n //% help=devices/on-notified weight=26\n //% blockId=devices_device_info_event block=\"on notified|%event\" icon=\"\\uf10a\"\n export function onNotified(event: MesDeviceInfo, body: () => void) {\n control.onEvent(DAL.MES_DEVICE_INFO_ID, event, body);\n }\n\n /**\n * Register code to run when the micro:bit receives a command from the paired gamepad.\n * @param name button name\n * @param body code to run when button is pressed\n */\n //% help=devices/on-gamepad-button weight=40\n //% weight=25\n //% blockId=devices_gamepad_event block=\"on gamepad button|%NAME\" icon=\"\\uf11b\"\n export function onGamepadButton(name: MesDpadButtonInfo, body: () => void) {\n control.onEvent(DAL.MES_DPAD_CONTROLLER_ID, name, body);\n }\n}",
|
|
2801
2801
|
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum MesCameraEvent {\n //% block=\"take photo\"\n TakePhoto = 3, // MES_CAMERA_EVT_TAKE_PHOTO\n //% block=\"start video capture\"\n StartVideoCapture = 4, // MES_CAMERA_EVT_START_VIDEO_CAPTURE\n //% block=\"stop video capture\"\n StopVideoCapture = 5, // MES_CAMERA_EVT_STOP_VIDEO_CAPTURE\n //% block=\"toggle front-rear\"\n ToggleFrontRear = 8, // MES_CAMERA_EVT_TOGGLE_FRONT_REAR\n //% block=\"launch photo mode\"\n LaunchPhotoMode = 1, // MES_CAMERA_EVT_LAUNCH_PHOTO_MODE\n //% block=\"launch video mode\"\n LaunchVideoMode = 2, // MES_CAMERA_EVT_LAUNCH_VIDEO_MODE\n //% block=\"stop photo mode\"\n StopPhotoMode = 6, // MES_CAMERA_EVT_STOP_PHOTO_MODE\n //% block=\"stop video mode\"\n StopVideoMode = 7, // MES_CAMERA_EVT_STOP_VIDEO_MODE\n }\n\n\n declare const enum MesAlertEvent {\n //% block=\"display toast\"\n DisplayToast = 1, // MES_ALERT_EVT_DISPLAY_TOAST\n //% block=\"vibrate\"\n Vibrate = 2, // MES_ALERT_EVT_VIBRATE\n //% block=\"play sound\"\n PlaySound = 3, // MES_ALERT_EVT_PLAY_SOUND\n //% block=\"play ring tone\"\n PlayRingtone = 4, // MES_ALERT_EVT_PLAY_RINGTONE\n //% block=\"find my phone\"\n FindMyPhone = 5, // MES_ALERT_EVT_FIND_MY_PHONE\n //% block=\"ring alarm\"\n RingAlarm = 6, // MES_ALERT_EVT_ALARM1\n //% block=\"ring alarm 2\"\n RingAlarm2 = 7, // MES_ALERT_EVT_ALARM2\n //% block=\"ring alarm 3\"\n RingAlarm3 = 8, // MES_ALERT_EVT_ALARM3\n //% block=\"ring alarm 4\"\n RingAlarm4 = 9, // MES_ALERT_EVT_ALARM4\n //% block=\"ring alarm 5\"\n RingAlarm5 = 10, // MES_ALERT_EVT_ALARM5\n //% block=\"ring alarm 6\"\n RingAlarm6 = 11, // MES_ALERT_EVT_ALARM6\n }\n\n\n declare const enum MesDeviceInfo {\n //% block=\"incoming call\"\n IncomingCall = 7, // MES_DEVICE_INCOMING_CALL\n //% block=\"incoming message\"\n IncomingMessage = 8, // MES_DEVICE_INCOMING_MESSAGE\n //% block=\"orientation landscape\"\n OrientationLandscape = 1, // MES_DEVICE_ORIENTATION_LANDSCAPE\n //% block=\"orientation portrait\"\n OrientationPortrait = 2, // MES_DEVICE_ORIENTATION_PORTRAIT\n //% block=\"shaken\"\n Shaken = 4, // MES_DEVICE_GESTURE_DEVICE_SHAKEN\n //% block=\"display off\"\n DisplayOff = 5, // MES_DEVICE_DISPLAY_OFF\n //% block=\"display on\"\n DisplayOn = 6, // MES_DEVICE_DISPLAY_ON\n }\n\n\n declare const enum MesRemoteControlEvent {\n //% block=\"play\"\n play = 1, // MES_REMOTE_CONTROL_EVT_PLAY\n //% block=\"pause\"\n pause = 2, // MES_REMOTE_CONTROL_EVT_PAUSE\n //% block=\"stop\"\n stop = 3, // MES_REMOTE_CONTROL_EVT_STOP\n //% block=\"next track\"\n nextTrack = 4, // MES_REMOTE_CONTROL_EVT_NEXTTRACK\n //% block=\"previous track\"\n previousTrack = 5, // MES_REMOTE_CONTROL_EVT_PREVTRACK\n //% block=\"forward\"\n forward = 6, // MES_REMOTE_CONTROL_EVT_FORWARD\n //% block=\"rewind\"\n rewind = 7, // MES_REMOTE_CONTROL_EVT_REWIND\n //% block=\"volume up\"\n volumeUp = 8, // MES_REMOTE_CONTROL_EVT_VOLUMEUP\n //% block=\"volume down\"\n volumeDown = 9, // MES_REMOTE_CONTROL_EVT_VOLUMEDOWN\n }\ndeclare namespace devices {\n}\n\n// Auto-generated. Do not edit. Really.\n",
|
|
2802
|
-
"pxt.json": "{\n \"name\": \"devices\",\n \"description\": \"BETA - Camera, remote control and other Bluetooth services. App required.\",\n \"dependencies\": {\n \"core\": \"*\",\n \"bluetooth\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"enums.d.ts\",\n \"shims.d.ts\",\n \"devices.cpp\",\n \"devices.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2802
|
+
"pxt.json": "{\n \"name\": \"devices\",\n \"description\": \"BETA - Camera, remote control and other Bluetooth services. App required.\",\n \"dependencies\": {\n \"core\": \"*\",\n \"bluetooth\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"enums.d.ts\",\n \"shims.d.ts\",\n \"devices.cpp\",\n \"devices.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"icon\": \"./static/packages/devices/icon.png\",\n \"hidden\": true\n}\n",
|
|
2803
2803
|
"shims.d.ts": "// Auto-generated. Do not edit.\n\n\n /**\n * Control a phone with the BBC micro:bit via Bluetooth.\n */\n //% color=#008272 weight=80 icon=\"\\uf10b\"\ndeclare namespace devices {\n\n /**\n * Returns the last signal strength reported by the paired device.\n */\n //% help=devices/signal-strength weight=24\n //% blockId=devices_signal_strength block=\"signal strength\" blockGap=14 icon=\"\\uf012\" blockGap=14 shim=devices::signalStrength\n function signalStrength(): int32;\n\n /**\n * Registers code to run when the device notifies about a change of signal strength.\n * @param body Code run when the signal strength changes.\n */\n //% weight=23 help=devices/on-signal-strength-changed\n //% blockId=devices_signal_strength_changed_event block=\"on signal strength changed\" icon=\"\\uf012\" shim=devices::onSignalStrengthChanged\n function onSignalStrengthChanged(body: () => void): void;\n}\n\n// Auto-generated. Do not edit. Really.\n"
|
|
2804
2804
|
},
|
|
2805
2805
|
"bluetooth": {
|
|
@@ -2809,18 +2809,18 @@
|
|
|
2809
2809
|
"bluetooth.cpp": "#include \"pxt.h\"\n#include \"MESEvents.h\"\n#include \"MicroBitUARTService.h\"\n#include \"BLEHF2Service.h\"\n\nusing namespace pxt;\n\n/**\n * Support for additional Bluetooth services.\n */\n//% color=#0082FB weight=96 icon=\"\\uf294\"\nnamespace bluetooth {\n MicroBitUARTService *uart = NULL;\n BLEHF2Service* pHF2 = NULL;\n\n //%\n void __log(int priority, String msg) {\n if (NULL == pHF2)\n pHF2 = new BLEHF2Service(*uBit.ble);\n pHF2->sendSerial(msg->getUTF8Data(), msg->getUTF8Size(), false);\n }\n\n /**\n * Starts the Bluetooth accelerometer service\n */\n //% help=bluetooth/start-accelerometer-service\n //% blockId=bluetooth_start_accelerometer_service block=\"bluetooth accelerometer service\"\n //% parts=\"bluetooth\" weight=90 blockGap=8\n void startAccelerometerService() {\n new MicroBitAccelerometerService(*uBit.ble, uBit.accelerometer); \n } \n\n /**\n * Starts the Bluetooth button service\n */\n //% help=bluetooth/start-button-service\n //% blockId=bluetooth_start_button_service block=\"bluetooth button service\" blockGap=8\n //% parts=\"bluetooth\" weight=89\n void startButtonService() {\n new MicroBitButtonService(*uBit.ble); \n }\n\n /**\n * Starts the Bluetooth IO pin service.\n */\n //% help=bluetooth/start-io-pin-service\n //% blockId=bluetooth_start_io_pin_service block=\"bluetooth io pin service\" blockGap=8\n //% parts=\"bluetooth\" weight=88\n void startIOPinService() {\n new MicroBitIOPinService(*uBit.ble, uBit.io);\n }\n\n /**\n * Starts the Bluetooth LED service\n */\n //% help=bluetooth/start-led-service\n //% blockId=bluetooth_start_led_service block=\"bluetooth led service\" blockGap=8\n //% parts=\"bluetooth\" weight=87\n void startLEDService() {\n new MicroBitLEDService(*uBit.ble, uBit.display);\n }\n\n /**\n * Starts the Bluetooth temperature service\n */\n //% help=bluetooth/start-temperature-service\n //% blockId=bluetooth_start_temperature_service block=\"bluetooth temperature service\" blockGap=8\n //% parts=\"bluetooth\" weight=86\n void startTemperatureService() { \n new MicroBitTemperatureService(*uBit.ble, uBit.thermometer); \n }\n\n /**\n * Starts the Bluetooth magnetometer service\n */\n //% help=bluetooth/start-magnetometer-service\n //% blockId=bluetooth_start_magnetometer_service block=\"bluetooth magnetometer service\"\n //% parts=\"bluetooth\" weight=85\n void startMagnetometerService() { \n new MicroBitMagnetometerService(*uBit.ble, uBit.compass); \n }\n\n\n /**\n * Starts the Bluetooth UART service\n */\n //% help=bluetooth/start-uart-service\n //% blockId=bluetooth_start_uart_service block=\"bluetooth uart service\"\n //% parts=\"bluetooth\" advanced=true\n void startUartService() {\n if (uart) return;\n // 61 octet buffer size is 3 x (MTU - 3) + 1\n // MTU on nRF51822 is 23 octets. 3 are used by Attribute Protocol header data leaving 20 octets for payload\n // So we allow a RX buffer that can contain 3 x max length messages plus one octet for a terminator character\n uart = new MicroBitUARTService(*uBit.ble, 61, 60);\n }\n \n //%\n void uartWriteString(String data) {\n startUartService();\n \tuart->send(MSTR(data));\n } \n\n //%\n String uartReadUntil(String del) {\n startUartService();\n return PSTR(uart->readUntil(MSTR(del)));\n } \n\n\n /**\n * Sends a buffer of data via Bluetooth UART\n */\n //%\n void uartWriteBuffer(Buffer buffer) {\n startUartService();\n uart->send(buffer->data, buffer->length);\n }\n\n /**\n * Reads buffered UART data into a buffer\n */\n //%\n Buffer uartReadBuffer() {\n startUartService();\n int bytes = uart->rxBufferedSize();\n auto buffer = mkBuffer(NULL, bytes);\n auto res = buffer;\n registerGCObj(buffer);\n int read = uart->read(buffer->data, buffer->length);\n // read failed\n if (read < 0) {\n res = mkBuffer(NULL, 0);\n } else if (read != buffer->length) {\n // could not fill the buffer\n res = mkBuffer(buffer->data, read); \n }\n unregisterGCObj(buffer);\n return res;\n }\n\n /**\n * Registers an event to be fired when one of the delimiter is matched.\n * @param delimiters the characters to match received characters against.\n */\n //% help=bluetooth/on-uart-data-received\n //% weight=18 blockId=bluetooth_on_data_received block=\"bluetooth|on data received %delimiters=serial_delimiter_conv\"\n void onUartDataReceived(String delimiters, Action body) {\n startUartService();\n uart->eventOn(MSTR(delimiters));\n registerWithDal(MICROBIT_ID_BLE_UART, MICROBIT_UART_S_EVT_DELIM_MATCH, body);\n }\n\n /**\n * Register code to run when the micro:bit is connected to over Bluetooth\n * @param body Code to run when a Bluetooth connection is established\n */\n //% help=bluetooth/on-bluetooth-connected weight=20\n //% blockId=bluetooth_on_connected block=\"on bluetooth connected\" blockGap=8\n //% parts=\"bluetooth\"\n void onBluetoothConnected(Action body) {\n registerWithDal(MICROBIT_ID_BLE, MICROBIT_BLE_EVT_CONNECTED, body);\n } \n\n /**\n * Register code to run when a bluetooth connection to the micro:bit is lost\n * @param body Code to run when a Bluetooth connection is lost\n */\n //% help=bluetooth/on-bluetooth-disconnected weight=19\n //% blockId=bluetooth_on_disconnected block=\"on bluetooth disconnected\"\n //% parts=\"bluetooth\"\n void onBluetoothDisconnected(Action body) {\n registerWithDal(MICROBIT_ID_BLE, MICROBIT_BLE_EVT_DISCONNECTED, body);\n } \n\n const int8_t CALIBRATED_POWERS[] = {-49, -37, -33, -28, -25, -20, -15, -10};\n /**\n * Advertise an Eddystone URL\n\t* @param url the url to transmit. Must be no longer than the supported eddystone url length, eg: \"https://makecode.com\"\n\t* @param power power level between 0 and 7, eg: 7\n * @param connectable true to keep bluetooth connectable for other services, false otherwise.\n */\n //% blockId=eddystone_advertise_url block=\"bluetooth advertise url %url|with power %power|connectable %connectable\"\n //% parts=bluetooth weight=11 blockGap=8\n //% help=bluetooth/advertise-url blockExternalInputs=1\n //% hidden=1 deprecated=1\n void advertiseUrl(String url, int power, bool connectable) {\n#if CONFIG_ENABLED(MICROBIT_BLE_EDDYSTONE_URL)\n power = min(MICROBIT_BLE_POWER_LEVELS-1, max(0, power));\n int8_t level = CALIBRATED_POWERS[power];\n uBit.bleManager.advertiseEddystoneUrl(MSTR(url), level, connectable);\n uBit.bleManager.setTransmitPower(power);\n#endif\n }\n\n /**\n * Advertise an Eddystone UID\n\t* @param nsAndInstance 16 bytes buffer of namespace (bytes 0-9) and instance (bytes 10-15)\n\t* @param power power level between 0 and 7, eg: 7\n * @param connectable true to keep bluetooth connectable for other services, false otherwise.\n */\n //% parts=bluetooth weight=12 advanced=true deprecated=1\n void advertiseUidBuffer(Buffer nsAndInstance, int power, bool connectable) {\n#if CONFIG_ENABLED(MICROBIT_BLE_EDDYSTONE_UID) \n auto buf = nsAndInstance;\n if (buf->length != 16) return;\n\n power = min(MICROBIT_BLE_POWER_LEVELS-1, max(0, power));\n int8_t level = CALIBRATED_POWERS[power];\n uBit.bleManager.advertiseEddystoneUid((const char*)buf->data, (const char*)buf->data + 10, level, connectable);\n#endif\n }\n\n /**\n * Sets the bluetooth transmit power between 0 (minimal) and 7 (maximum).\n * @param power power level between 0 (minimal) and 7 (maximum), eg: 7.\n */\n //% parts=bluetooth weight=5 help=bluetooth/set-transmit-power advanced=true\n //% blockId=bluetooth_settransmitpower block=\"bluetooth set transmit power %power\"\n void setTransmitPower(int power) {\n uBit.bleManager.setTransmitPower(min(MICROBIT_BLE_POWER_LEVELS-1, max(0, power)));\n }\n\n /**\n * Stops advertising Eddystone end points\n */\n //% blockId=eddystone_stop_advertising block=\"bluetooth stop advertising\"\n //% parts=bluetooth weight=10\n //% help=bluetooth/stop-advertising advanced=true\n //% hidden=1 deprecated=1\n void stopAdvertising() {\n uBit.bleManager.stopAdvertising();\n } \n}",
|
|
2810
2810
|
"bluetooth.ts": "/// <reference no-default-lib=\"true\"/>\n/**\n * Support for additional Bluetooth services.\n */\n//% color=#007EF4 weight=96 icon=\"\\uf294\"\nnamespace bluetooth {\n export let NEW_LINE = \"\\r\\n\";\n\n /**\n * Internal use\n */\n //% shim=bluetooth::__log\n export function __log(priority: number, msg: string) {\n return;\n }\n console.addListener(function (_pri, msg) { __log(_pri, msg) });\n\n /**\n * Writes to the Bluetooth UART service buffer. From there the data is transmitted over Bluetooth to a connected device.\n */\n //% help=bluetooth/uart-write-string weight=80\n //% blockId=bluetooth_uart_write block=\"bluetooth uart|write string %data\" blockGap=8\n //% parts=\"bluetooth\" shim=bluetooth::uartWriteString advanced=true\n export function uartWriteString(data: string): void {\n console.log(data)\n }\n\n /**\n * Writes to the Bluetooth UART service buffer. From there the data is transmitted over Bluetooth to a connected device.\n */\n //% help=bluetooth/uart-write-line weight=79\n //% blockId=bluetooth_uart_line block=\"bluetooth uart|write line %data\" blockGap=8\n //% parts=\"bluetooth\" advanced=true\n export function uartWriteLine(data: string): void {\n uartWriteString(data + serial.NEW_LINE);\n }\n\n /**\n * Prints a numeric value to the serial\n */\n //% help=bluetooth/uart-write-number weight=79\n //% weight=89 blockGap=8 advanced=true\n //% blockId=bluetooth_uart_writenumber block=\"bluetooth uart|write number %value\"\n export function uartWriteNumber(value: number): void {\n uartWriteString(value.toString());\n }\n\n /**\n * Writes a ``name: value`` pair line to the serial.\n * @param name name of the value stream, eg: x\n * @param value to write\n */\n //% weight=88 weight=78\n //% help=bluetooth/uart-write-value advanced=true\n //% blockId=bluetooth_uart_writevalue block=\"bluetooth uart|write value %name|= %value\"\n export function uartWriteValue(name: string, value: number): void {\n uartWriteString((name ? name + \":\" : \"\") + value + NEW_LINE);\n }\n\n /**\n * Reads from the Bluetooth UART service buffer, returning its contents when the specified delimiter character is encountered.\n */\n //% help=bluetooth/uart-read-until weight=75\n //% blockId=bluetooth_uart_read block=\"bluetooth uart|read until %del=serial_delimiter_conv\"\n //% parts=\"bluetooth\" shim=bluetooth::uartReadUntil advanced=true\n export function uartReadUntil(del: string): string {\n // dummy implementation for simulator\n return \"\"\n }\n\n /**\n * Advertise an Eddystone UID\n * @param ns 4 last bytes of the namespace uid\n * @param instance 4 last bytes of the instance uid\n * @param power power level between 0 and 7, eg: 7\n * @param connectable true to keep bluetooth connectable for other services, false otherwise.\n */\n //% blockId=eddystone_advertise_uid block=\"bluetooth advertise UID|namespace (bytes 6-9)%ns|instance (bytes 2-6)%instance|with power %power|connectable %connectable\"\n //% parts=bluetooth weight=12 blockGap=8\n //% help=bluetooth/advertise-uid blockExternalInputs=1\n //% hidden=1 deprecated=1\n export function advertiseUid(ns: number, instance: number, power: number, connectable: boolean) {\n const buf = pins.createBuffer(16);\n buf.setNumber(NumberFormat.Int32BE, 6, ns);\n buf.setNumber(NumberFormat.Int32BE, 12, instance);\n bluetooth.advertiseUidBuffer(buf, power, connectable);\n }\n}\n",
|
|
2811
2811
|
"enums.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace bluetooth {\n}\n\n// Auto-generated. Do not edit. Really.\n",
|
|
2812
|
-
"pxt.json": "{\n \"name\": \"bluetooth\",\n \"description\": \"Bluetooth services\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"enums.d.ts\",\n \"shims.d.ts\",\n \"bluetooth.ts\",\n \"bluetooth.cpp\",\n \"BLEHF2Service.h\",\n \"BLEHF2Service.cpp\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2812
|
+
"pxt.json": "{\n \"name\": \"bluetooth\",\n \"description\": \"Bluetooth services\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"enums.d.ts\",\n \"shims.d.ts\",\n \"bluetooth.ts\",\n \"bluetooth.cpp\",\n \"BLEHF2Service.h\",\n \"BLEHF2Service.cpp\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"weight\": 10,\n \"searchOnly\": true,\n \"icon\": \"./static/packages/bluetooth/icon.png\",\n \"yotta\": {\n \"config\": {\n \"microbit-dal\": {\n \"bluetooth\": {\n \"enabled\": 1\n }\n }\n },\n \"optionalConfig\": {\n \"microbit-dal\": {\n \"stack_size\": 1280,\n \"gatt_table_size\": \"0x700\"\n }\n },\n \"userConfigs\": [\n {\n \"description\": \"Disable Bluetooth Event Service\",\n \"config\": {\n \"microbit-dal\": {\n \"bluetooth\": {\n \"event_service\": 0\n }\n }\n }\n }\n ]\n }\n}\n",
|
|
2813
2813
|
"shims.d.ts": "// Auto-generated. Do not edit.\n\n\n /**\n * Support for additional Bluetooth services.\n */\n //% color=#0082FB weight=96 icon=\"\\uf294\"\ndeclare namespace bluetooth {\n\n /**\n * Starts the Bluetooth accelerometer service\n */\n //% help=bluetooth/start-accelerometer-service\n //% blockId=bluetooth_start_accelerometer_service block=\"bluetooth accelerometer service\"\n //% parts=\"bluetooth\" weight=90 blockGap=8 shim=bluetooth::startAccelerometerService\n function startAccelerometerService(): void;\n\n /**\n * Starts the Bluetooth button service\n */\n //% help=bluetooth/start-button-service\n //% blockId=bluetooth_start_button_service block=\"bluetooth button service\" blockGap=8\n //% parts=\"bluetooth\" weight=89 shim=bluetooth::startButtonService\n function startButtonService(): void;\n\n /**\n * Starts the Bluetooth IO pin service.\n */\n //% help=bluetooth/start-io-pin-service\n //% blockId=bluetooth_start_io_pin_service block=\"bluetooth io pin service\" blockGap=8\n //% parts=\"bluetooth\" weight=88 shim=bluetooth::startIOPinService\n function startIOPinService(): void;\n\n /**\n * Starts the Bluetooth LED service\n */\n //% help=bluetooth/start-led-service\n //% blockId=bluetooth_start_led_service block=\"bluetooth led service\" blockGap=8\n //% parts=\"bluetooth\" weight=87 shim=bluetooth::startLEDService\n function startLEDService(): void;\n\n /**\n * Starts the Bluetooth temperature service\n */\n //% help=bluetooth/start-temperature-service\n //% blockId=bluetooth_start_temperature_service block=\"bluetooth temperature service\" blockGap=8\n //% parts=\"bluetooth\" weight=86 shim=bluetooth::startTemperatureService\n function startTemperatureService(): void;\n\n /**\n * Starts the Bluetooth magnetometer service\n */\n //% help=bluetooth/start-magnetometer-service\n //% blockId=bluetooth_start_magnetometer_service block=\"bluetooth magnetometer service\"\n //% parts=\"bluetooth\" weight=85 shim=bluetooth::startMagnetometerService\n function startMagnetometerService(): void;\n\n /**\n * Starts the Bluetooth UART service\n */\n //% help=bluetooth/start-uart-service\n //% blockId=bluetooth_start_uart_service block=\"bluetooth uart service\"\n //% parts=\"bluetooth\" advanced=true shim=bluetooth::startUartService\n function startUartService(): void;\n\n /**\n * Sends a buffer of data via Bluetooth UART\n */\n //% shim=bluetooth::uartWriteBuffer\n function uartWriteBuffer(buffer: Buffer): void;\n\n /**\n * Reads buffered UART data into a buffer\n */\n //% shim=bluetooth::uartReadBuffer\n function uartReadBuffer(): Buffer;\n\n /**\n * Registers an event to be fired when one of the delimiter is matched.\n * @param delimiters the characters to match received characters against.\n */\n //% help=bluetooth/on-uart-data-received\n //% weight=18 blockId=bluetooth_on_data_received block=\"bluetooth|on data received %delimiters=serial_delimiter_conv\" shim=bluetooth::onUartDataReceived\n function onUartDataReceived(delimiters: string, body: () => void): void;\n\n /**\n * Register code to run when the micro:bit is connected to over Bluetooth\n * @param body Code to run when a Bluetooth connection is established\n */\n //% help=bluetooth/on-bluetooth-connected weight=20\n //% blockId=bluetooth_on_connected block=\"on bluetooth connected\" blockGap=8\n //% parts=\"bluetooth\" shim=bluetooth::onBluetoothConnected\n function onBluetoothConnected(body: () => void): void;\n\n /**\n * Register code to run when a bluetooth connection to the micro:bit is lost\n * @param body Code to run when a Bluetooth connection is lost\n */\n //% help=bluetooth/on-bluetooth-disconnected weight=19\n //% blockId=bluetooth_on_disconnected block=\"on bluetooth disconnected\"\n //% parts=\"bluetooth\" shim=bluetooth::onBluetoothDisconnected\n function onBluetoothDisconnected(body: () => void): void;\n\n /**\n * Advertise an Eddystone URL\n * @param url the url to transmit. Must be no longer than the supported eddystone url length, eg: \"https://makecode.com\"\n * @param power power level between 0 and 7, eg: 7\n * @param connectable true to keep bluetooth connectable for other services, false otherwise.\n */\n //% blockId=eddystone_advertise_url block=\"bluetooth advertise url %url|with power %power|connectable %connectable\"\n //% parts=bluetooth weight=11 blockGap=8\n //% help=bluetooth/advertise-url blockExternalInputs=1\n //% hidden=1 deprecated=1 shim=bluetooth::advertiseUrl\n function advertiseUrl(url: string, power: int32, connectable: boolean): void;\n\n /**\n * Advertise an Eddystone UID\n * @param nsAndInstance 16 bytes buffer of namespace (bytes 0-9) and instance (bytes 10-15)\n * @param power power level between 0 and 7, eg: 7\n * @param connectable true to keep bluetooth connectable for other services, false otherwise.\n */\n //% parts=bluetooth weight=12 advanced=true deprecated=1 shim=bluetooth::advertiseUidBuffer\n function advertiseUidBuffer(nsAndInstance: Buffer, power: int32, connectable: boolean): void;\n\n /**\n * Sets the bluetooth transmit power between 0 (minimal) and 7 (maximum).\n * @param power power level between 0 (minimal) and 7 (maximum), eg: 7.\n */\n //% parts=bluetooth weight=5 help=bluetooth/set-transmit-power advanced=true\n //% blockId=bluetooth_settransmitpower block=\"bluetooth set transmit power %power\" shim=bluetooth::setTransmitPower\n function setTransmitPower(power: int32): void;\n\n /**\n * Stops advertising Eddystone end points\n */\n //% blockId=eddystone_stop_advertising block=\"bluetooth stop advertising\"\n //% parts=bluetooth weight=10\n //% help=bluetooth/stop-advertising advanced=true\n //% hidden=1 deprecated=1 shim=bluetooth::stopAdvertising\n function stopAdvertising(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n"
|
|
2814
2814
|
},
|
|
2815
2815
|
"servo": {
|
|
2816
2816
|
"README.md": "# Servo\n\nA small micro-servo library.",
|
|
2817
2817
|
"ns.ts": "/**\n * Control micro servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\"\nnamespace servos {\n}",
|
|
2818
|
-
"pxt.json": "{\n \"name\": \"servo\",\n \"description\": \"A micro-servo library\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"servo.ts\",\n \"ns.ts\",\n \"targetoverrides.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2818
|
+
"pxt.json": "{\n \"name\": \"servo\",\n \"description\": \"A micro-servo library\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"servo.ts\",\n \"ns.ts\",\n \"targetoverrides.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"icon\": \"/static/libs/servo.png\"\n}\n",
|
|
2819
2819
|
"servo.ts": "/**\n * Control micro servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\" blockGap=8\n//% groups='[\"Positional\", \"Continuous\", \"Configuration\"]'\nnamespace servos {\n //% fixedInstances\n export class Servo {\n private _minAngle: number;\n private _maxAngle: number;\n private _stopOnNeutral: boolean;\n private _angle: number;\n\n constructor() {\n this._angle = undefined;\n this._minAngle = 0;\n this._maxAngle = 180;\n this._stopOnNeutral = false;\n }\n\n private clampDegrees(degrees: number): number {\n degrees = degrees | 0;\n degrees = Math.clamp(this._minAngle, this._maxAngle, degrees);\n return degrees;\n }\n\n /**\n * Set the servo angle\n */\n //% weight=100 help=servos/set-angle\n //% blockId=servoservosetangle block=\"set %servo angle to %degrees=protractorPicker °\"\n //% degrees.defl=90\n //% servo.fieldEditor=\"gridpicker\"\n //% servo.fieldOptions.width=220\n //% servo.fieldOptions.columns=2\n //% blockGap=8\n //% parts=microservo trackArgs=0\n //% group=\"Positional\"\n setAngle(degrees: number) {\n degrees = this.clampDegrees(degrees);\n this.internalSetContinuous(false);\n this._angle = this.internalSetAngle(degrees);\n }\n\n get angle() {\n return this._angle || 90;\n }\n\n protected internalSetContinuous(continuous: boolean): void {\n\n }\n\n protected internalSetAngle(angle: number): number {\n return 0;\n }\n\n /**\n * Set the throttle on a continuous servo\n * @param speed the throttle of the motor from -100% to 100%\n */\n //% weight=99 help=servos/run\n //% blockId=servoservorun block=\"continuous %servo run at %speed=speedPicker \\\\%\"\n //% servo.fieldEditor=\"gridpicker\"\n //% servo.fieldOptions.width=220\n //% servo.fieldOptions.columns=2\n //% parts=microservo trackArgs=0\n //% group=\"Continuous\"\n //% blockGap=8\n run(speed: number): void {\n const degrees = this.clampDegrees(Math.map(speed, -100, 100, this._minAngle, this._maxAngle));\n const neutral = (this.maxAngle - this.minAngle) >> 1;\n this.internalSetContinuous(true);\n if (this._stopOnNeutral && degrees == neutral)\n this.stop();\n else\n this._angle = this.internalSetAngle(degrees);\n }\n\n /**\n * Set the pulse width to the servo in microseconds\n * @param micros the width of the pulse in microseconds\n */\n\n //% weight=10 help=servos/set-pulse\n //% blockId=servoservosetpulse block=\"set %servo pulse to %micros μs\"\n //% micros.min=500 micros.max=2500\n //% micros.defl=1500\n //% servo.fieldEditor=\"gridpicker\"\n //% servo.fieldOptions.width=220\n //% servo.fieldOptions.columns=2\n //% parts=microservo trackArgs=0\n //% group=\"Configuration\"\n //% blockGap=8\n setPulse(micros: number) {\n micros = micros | 0;\n micros = Math.clamp(500, 2500, micros);\n this.internalSetPulse(micros);\n }\n\n protected internalSetPulse(micros: number): void {\n\n }\n\n /**\n * Stop sending commands to the servo so that its rotation will stop at the current position.\n */\n // On a normal servo this will stop the servo where it is, rather than return it to neutral position.\n // It will also not provide any holding force.\n //% weight=10 help=servos/stop\n //% blockId=servoservostop block=\"stop %servo\"\n //% servo.fieldEditor=\"gridpicker\"\n //% servo.fieldOptions.width=220\n //% servo.fieldOptions.columns=2\n //% parts=microservo trackArgs=0\n //% group=\"Continuous\"\n //% blockGap=8\n stop() {\n if (this._angle !== undefined)\n this.internalStop();\n }\n\n /**\n * Gets the minimum angle for the servo\n */\n public get minAngle() {\n return this._minAngle;\n }\n\n /**\n * Gets the maximum angle for the servo\n */\n public get maxAngle() {\n return this._maxAngle;\n }\n\n /**\n * Set the possible rotation range angles for the servo between 0 and 180\n * @param minAngle the minimum angle from 0 to 90\n * @param maxAngle the maximum angle from 90 to 180\n */\n //% help=servos/set-range\n //% blockId=servosetrange block=\"set %servo range from %minAngle to %maxAngle\"\n //% minAngle.min=0 minAngle.max=90\n //% maxAngle.min=90 maxAngle.max=180 maxAngle.defl=180\n //% servo.fieldEditor=\"gridpicker\"\n //% servo.fieldOptions.width=220\n //% servo.fieldOptions.columns=2\n //% parts=microservo trackArgs=0\n //% group=\"Configuration\"\n //% blockGap=8\n public setRange(minAngle: number, maxAngle: number) {\n this._minAngle = Math.max(0, Math.min(90, minAngle | 0));\n this._maxAngle = Math.max(90, Math.min(180, maxAngle | 0));\n }\n\n /**\n * Set a servo stop mode so it will stop when the rotation angle is in the neutral position, 90 degrees.\n * @param on true to enable this mode\n */\n //% help=servos/set-stop-on-neutral\n //% blockId=servostoponneutral block=\"set %servo stop on neutral %enabled\"\n //% enabled.shadow=toggleOnOff\n //% group=\"Configuration\"\n //% blockGap=8\n //% servo.fieldEditor=\"gridpicker\"\n //% servo.fieldOptions.width=220\n //% servo.fieldOptions.columns=2\n public setStopOnNeutral(enabled: boolean) {\n this._stopOnNeutral = enabled;\n }\n\n protected internalStop() { }\n }\n\n export class PinServo extends Servo {\n private _pin: PwmOnlyPin;\n\n constructor(pin: PwmOnlyPin) {\n super();\n this._pin = pin;\n }\n\n protected internalSetAngle(angle: number): number {\n this._pin.servoWrite(angle);\n return angle;\n }\n\n protected internalSetContinuous(continuous: boolean): void {\n this._pin.servoSetContinuous(continuous);\n }\n\n protected internalSetPulse(micros: number): void {\n this._pin.servoSetPulse(micros);\n }\n\n protected internalStop() {\n this._pin.digitalRead();\n this._pin.setPull(PinPullMode.PullNone);\n }\n }\n}\n",
|
|
2820
2820
|
"targetoverrides.ts": "namespace servos {\n //% block=\"servo P0\" fixedInstance whenUsed\n export const P0 = new servos.PinServo(pins.P0);\n //% block=\"servo P1\" fixedInstance whenUsed\n export const P1 = new servos.PinServo(pins.P1);\n //% block=\"servo P2\" fixedInstance whenUsed\n export const P2 = new servos.PinServo(pins.P2);\n}"
|
|
2821
2821
|
},
|
|
2822
2822
|
"radio-broadcast": {
|
|
2823
|
-
"pxt.json": "{\n \"name\": \"radio-broadcast\",\n \"description\": \"Adds new blocks for message communication in the radio category\",\n \"dependencies\": {\n \"core\": \"*\",\n \"radio\": \"*\"\n },\n \"files\": [\n \"radio-broadcast.ts\"\n ],\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2823
|
+
"pxt.json": "{\n \"name\": \"radio-broadcast\",\n \"description\": \"Adds new blocks for message communication in the radio category\",\n \"dependencies\": {\n \"core\": \"*\",\n \"radio\": \"*\"\n },\n \"files\": [\n \"radio-broadcast.ts\"\n ],\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"icon\": \"/static/libs/radio-broadcast.png\"\n}\n",
|
|
2824
2824
|
"radio-broadcast.ts": "namespace radio {\n const BROADCAST_GENERAL_ID = 2000;\n\n /**\n * Gets the message code\n */\n //% blockHidden=1 shim=ENUM_GET\n //% blockId=radioMessageCode block=\"$msg\" enumInitialMembers=\"message1\"\n //% enumName=RadioMessage enumMemberName=msg enumPromptHint=\"e.g. Start, Stop, Jump...\"\n //% enumIsHash=1\n export function __message(msg: number): number {\n return msg;\n }\n\n /**\n * Broadcasts a message over radio\n * @param msg \n */\n //% blockId=radioBroadcastMessage block=\"radio send $msg\"\n //% msg.shadow=radioMessageCode draggableParameters\n //% weight=200\n //% blockGap=8\n //% help=radio/send-message\n //% group=\"Broadcast\"\n export function sendMessage(msg: number): void {\n // 0 is MICROBIT_EVT_ANY, shifting by 1\n radio.raiseEvent(BROADCAST_GENERAL_ID, msg + 1);\n }\n\n /**\n * Registers code to run for a particular message\n * @param msg \n * @param handler \n */\n //% blockId=radioOnMessageReceived block=\"on radio $msg received\"\n //% msg.shadow=radioMessageCode draggableParameters\n //% weight=199\n //% help=radio/on-received-message\n //% group=\"Broadcast\"\n export function onReceivedMessage(msg: number, handler: () => void) {\n control.onEvent(BROADCAST_GENERAL_ID, msg + 1, handler);\n }\n}"
|
|
2825
2825
|
},
|
|
2826
2826
|
"microphone": {
|
|
@@ -2828,7 +2828,7 @@
|
|
|
2828
2828
|
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum DetectedSound {\n //% block=\"loud\"\n Loud = 2,\n //% block=\"quiet\"\n Quiet = 1,\n }\n\n\n declare const enum SoundThreshold {\n //% block=\"loud\"\n Loud = 2,\n //% block=\"quiet\"\n Quiet = 1,\n }\n\n// Auto-generated. Do not edit. Really.\n",
|
|
2829
2829
|
"microphone.cpp": "#include \"pxt.h\"\n\n#if MICROBIT_CODAL\n#include \"LevelDetector.h\"\n#include \"LevelDetectorSPL.h\"\n#endif\n\n#define MICROPHONE_MIN 52.0f\n#define MICROPHONE_MAX 120.0f\n\nenum class DetectedSound {\n //% block=\"loud\"\n Loud = 2,\n //% block=\"quiet\"\n Quiet = 1\n};\n\nenum class SoundThreshold {\n //% block=\"loud\"\n Loud = 2,\n //% block=\"quiet\"\n Quiet = 1\n};\n\nnamespace pxt {\n#if MICROBIT_CODAL\n codal::LevelDetectorSPL* getMicrophoneLevel();\n#endif\n}\n\nnamespace input {\n\n/**\n* Registers an event that runs when a sound is detected\n*/\n//% help=input/on-sound\n//% blockId=input_on_sound block=\"on %sound sound\"\n//% parts=\"microphone\"\n//% weight=88 blockGap=12\n//% group=\"micro:bit (V2)\"\nvoid onSound(DetectedSound sound, Action handler) {\n#if MICROBIT_CODAL\n pxt::getMicrophoneLevel(); // wake up service\n const auto thresholdType = sound == DetectedSound::Loud ? LEVEL_THRESHOLD_HIGH : LEVEL_THRESHOLD_LOW;\n registerWithDal(DEVICE_ID_MICROPHONE, thresholdType, handler);\n#else\n target_panic(PANIC_VARIANT_NOT_SUPPORTED);\n#endif\n}\n\n/**\n* Reads the loudness through the microphone from 0 (silent) to 255 (loud)\n*/\n//% help=input/sound-level\n//% blockId=device_get_sound_level block=\"sound level\"\n//% parts=\"microphone\"\n//% weight=34 blockGap=8\n//% group=\"micro:bit (V2)\"\nint soundLevel() {\n#if MICROBIT_CODAL\n auto level = pxt::getMicrophoneLevel();\n if (NULL == level)\n return 0;\n const int micValue = level->getValue();\n const int scaled = max(MICROPHONE_MIN, min(micValue, MICROPHONE_MAX)) - MICROPHONE_MIN;\n return min(0xff, scaled * 0xff / (MICROPHONE_MAX - MICROPHONE_MIN));\n#else\n target_panic(PANIC_VARIANT_NOT_SUPPORTED);\n return 0;\n#endif\n}\n\n/**\n* Sets the threshold for a sound type.\n*/\n//% help=input/set-sound-threshold\n//% blockId=input_set_sound_threshold block=\"set %sound sound threshold to %value\"\n//% parts=\"microphone\"\n//% threshold.min=0 threshold.max=255 threshold.defl=128\n//% weight=14 blockGap=8\n//% advanced=true\n//% group=\"micro:bit (V2)\"\nvoid setSoundThreshold(SoundThreshold sound, int threshold) {\n#if MICROBIT_CODAL\n auto level = pxt::getMicrophoneLevel();\n if (NULL == level)\n return;\n\n threshold = max(0, min(0xff, threshold));\n const int scaled = MICROPHONE_MIN + threshold * (MICROPHONE_MAX - MICROPHONE_MIN) / 0xff;\n if (SoundThreshold::Loud == sound)\n level->setHighThreshold(scaled);\n else\n level->setLowThreshold(scaled);\n#else\n target_panic(PANIC_VARIANT_NOT_SUPPORTED);\n#endif\n}\n}",
|
|
2830
2830
|
"microphonehw.cpp": "// The fallback logic below still requires level detection.\n// It's only kept with a view to syncing with the common-packages in future.\n\n#include \"pxt.h\"\n\n#if MICROBIT_CODAL\n#include \"LevelDetector.h\"\n#include \"LevelDetectorSPL.h\"\n#include \"DataStream.h\"\n\n#ifndef MIC_DEVICE\n// STM?\nclass DummyDataSource : public codal::DataSource {\n public:\n DummyDataSource() {}\n};\nclass PanicPDM {\n public:\n uint8_t level;\n DummyDataSource source;\n codal::DataStream output;\n\n PanicPDM(Pin &sd, Pin &sck) : output(source) { target_panic(PANIC_MICROPHONE_MISSING); }\n void enable() {}\n void disable() {}\n};\n#define MIC_DEVICE PanicPDM\n#endif\n\n#ifndef MIC_INIT\n#define MIC_INIT \\\n : microphone(*LOOKUP_PIN(MIC_DATA), *LOOKUP_PIN(MIC_CLOCK)) \\\n , level(microphone.output, 95.0, 75.0, 9, 52, DEVICE_ID_MICROPHONE)\n#endif\n\n#ifndef MIC_ENABLE\n#define MIC_ENABLE microphone.enable()\n#endif\n\nnamespace pxt {\n\nclass WMicrophone {\n public:\n MIC_DEVICE microphone;\n LevelDetectorSPL level;\n WMicrophone() MIC_INIT { MIC_ENABLE; }\n};\nSINGLETON(WMicrophone);\n\ncodal::LevelDetectorSPL *getMicrophoneLevel() {\n auto wmic = getWMicrophone();\n return wmic ? &(wmic->level) : NULL;\n}\n\n} // namespace pxt\n#endif",
|
|
2831
|
-
"pxt.json": "{\n \"name\": \"microphone\",\n \"description\": \"The microphone library\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"microphone.cpp\",\n \"microphonehw.cpp\",\n \"enums.d.ts\",\n \"shims.d.ts\",\n \"targetoverrides.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2831
|
+
"pxt.json": "{\n \"name\": \"microphone\",\n \"description\": \"The microphone library\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"microphone.cpp\",\n \"microphonehw.cpp\",\n \"enums.d.ts\",\n \"shims.d.ts\",\n \"targetoverrides.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"icon\": \"/static/libs/microphone.png\"\n}\n",
|
|
2832
2832
|
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace input {\n\n /**\n * Registers an event that runs when a sound is detected\n */\n //% help=input/on-sound\n //% blockId=input_on_sound block=\"on %sound sound\"\n //% parts=\"microphone\"\n //% weight=88 blockGap=12\n //% group=\"micro:bit (V2)\" shim=input::onSound\n function onSound(sound: DetectedSound, handler: () => void): void;\n\n /**\n * Reads the loudness through the microphone from 0 (silent) to 255 (loud)\n */\n //% help=input/sound-level\n //% blockId=device_get_sound_level block=\"sound level\"\n //% parts=\"microphone\"\n //% weight=34 blockGap=8\n //% group=\"micro:bit (V2)\" shim=input::soundLevel\n function soundLevel(): int32;\n\n /**\n * Sets the threshold for a sound type.\n */\n //% help=input/set-sound-threshold\n //% blockId=input_set_sound_threshold block=\"set %sound sound threshold to %value\"\n //% parts=\"microphone\"\n //% threshold.min=0 threshold.max=255\n //% weight=14 blockGap=8\n //% advanced=true\n //% group=\"micro:bit (V2)\" threshold.defl=128 shim=input::setSoundThreshold\n function setSoundThreshold(sound: SoundThreshold, threshold?: int32): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
|
|
2833
2833
|
"targetoverrides.ts": "// target specific code",
|
|
2834
2834
|
"test.ts": "// tests"
|
|
@@ -2842,7 +2842,7 @@
|
|
|
2842
2842
|
"RP2040Flash.cpp": "#include \"pxt.h\"\n#include \"Flash.h\"\n\n//#define LOG DMESG\n#define LOG NOLOG\n\n#ifdef PICO_BOARD\n#include \"hardware/flash.h\"\n\n#define XIP_BIAS 0x10000000\n\nnamespace codal {\n\nint ZFlash::pageSize(uintptr_t address) {\n return FLASH_SECTOR_SIZE;\n}\n\nint ZFlash::totalSize() {\n#ifndef PICO_FLASH_SIZE_BYTES\n return 2*1024*1024;\n#else\n return PICO_FLASH_SIZE_BYTES;\n#endif\n}\n\nint ZFlash::erasePage(uintptr_t address) {\n // address should be aligned to 4096\n if (address % 4096 == 0){\n target_disable_irq();\n flash_range_erase(address - XIP_BIAS, FLASH_SECTOR_SIZE); \n target_enable_irq();\n }\n return 0;\n}\n\nint ZFlash::writeBytes(uintptr_t dst, const void *src, uint32_t len) {\n if (len != FLASH_PAGE_SIZE || (dst & (FLASH_PAGE_SIZE - 1))) return -1;\n // should be aligned to 256\n target_disable_irq();\n flash_range_program(dst - XIP_BIAS, (const uint8_t*)src, FLASH_PAGE_SIZE);\n target_enable_irq();\n \n return 0;\n}\n\n\n\n\n}\n\n#endif\n",
|
|
2843
2843
|
"SAMDFlash.cpp": "#include \"pxt.h\"\n#include \"Flash.h\"\n\n//#define LOG DMESG\n#define LOG NOLOG\n\n#if defined(SAMD51) || defined(SAMD21)\nnamespace codal {\n\n#ifdef SAMD51\n#define waitForLast() \\\n while (NVMCTRL->STATUS.bit.READY == 0) \\\n ;\n#else\n#define waitForLast() \\\n while (NVMCTRL->INTFLAG.bit.READY == 0) \\\n ;\n#endif\n\nstatic void unlock() {\n#ifdef SAMD51\n // see errata 2.14.1\n NVMCTRL->CTRLA.bit.CACHEDIS0 = true;\n NVMCTRL->CTRLA.bit.CACHEDIS1 = true;\n\n CMCC->CTRL.bit.CEN = 0;\n while (CMCC->SR.bit.CSTS) {\n }\n CMCC->MAINT0.bit.INVALL = 1;\n#endif\n}\n\nstatic void lock() {\n#ifdef SAMD51\n // re-enable cache\n NVMCTRL->CTRLA.bit.CACHEDIS0 = false;\n NVMCTRL->CTRLA.bit.CACHEDIS1 = false;\n\n // re-enable cortex-m cache - it's a separate one\n CMCC->CTRL.bit.CEN = 0;\n while (CMCC->SR.bit.CSTS) {\n }\n CMCC->MAINT0.bit.INVALL = 1;\n CMCC->CTRL.bit.CEN = 1;\n#endif\n}\n\nint ZFlash::totalSize() {\n return (8 << NVMCTRL->PARAM.bit.PSZ) * NVMCTRL->PARAM.bit.NVMP;\n}\n\n// this returns the size of \"page\" that can be erased (\"row\" in datasheet)\nint ZFlash::pageSize(uintptr_t address) {\n#ifdef SAMD51\n if (address < (uintptr_t)totalSize())\n return NVMCTRL_BLOCK_SIZE; // 8k\n#else\n if (address < (uintptr_t)totalSize())\n return 256;\n#endif\n target_panic(DEVICE_FLASH_ERROR);\n return 0;\n}\n\n#ifdef SAMD51\n#define CMD(D21, D51) NVMCTRL->CTRLB.reg = NVMCTRL_CTRLB_CMDEX_KEY | D51\n#else\n#define CMD(D21, D51) NVMCTRL->CTRLA.reg = NVMCTRL_CTRLA_CMDEX_KEY | D21\n#endif\n\nint ZFlash::erasePage(uintptr_t address) {\n LOG(\"Erase %x\", address);\n#ifdef SAMD51\n NVMCTRL->CTRLA.bit.WMODE = NVMCTRL_CTRLA_WMODE_MAN_Val;\n#else\n NVMCTRL->CTRLB.bit.MANW = 1;\n#endif\n waitForLast();\n unlock();\n#ifdef SAMD51\n NVMCTRL->ADDR.reg = address;\n#else\n // yeah... /2\n NVMCTRL->ADDR.reg = address / 2;\n#endif\n CMD(NVMCTRL_CTRLA_CMD_ER, NVMCTRL_CTRLB_CMD_EB);\n waitForLast();\n lock();\n return 0;\n}\n\n#if 0\n#define CHECK_ECC() \\\n if (NVMCTRL->INTFLAG.bit.ECCSE || NVMCTRL->INTFLAG.bit.ECCDE) \\\n return -10\n#else\n#define CHECK_ECC() ((void)0)\n#endif\n\nint ZFlash::writeBytes(uintptr_t dst, const void *src, uint32_t len) {\n#ifdef SAMD51\n CHECK_ECC();\n\n // only allow writing double word at a time\n if (len & 7)\n return -1;\n if (dst & 7)\n return -2;\n\n // every double-word can only be written once, otherwise we get ECC errors\n // and no, ECC cannot be disabled\n for (unsigned i = 0; i < (len >> 3); ++i)\n if (((uint64_t *)dst)[i] != 0xffffffffffffffff &&\n ((uint64_t *)src)[i] != 0xffffffffffffffff)\n return -3;\n#define WRITE_SIZE 16\n#else\n if ((dst & 3) || (len & 3))\n return -1;\n\n for (unsigned i = 0; i < len; ++i)\n if (((uint8_t *)dst)[i] != 0xff && ((uint8_t *)src)[i] != 0xff)\n return -3;\n#define WRITE_SIZE 64\n#endif\n\n uint32_t writeBuf[WRITE_SIZE >> 2];\n uint32_t idx = 0;\n\n waitForLast();\n unlock();\n __DMB();\n\n while (idx < len) {\n uint32_t off = dst & (WRITE_SIZE - 1);\n uint32_t n = WRITE_SIZE - off;\n if (n > len - idx)\n n = len - idx;\n uint32_t *sp;\n volatile uint32_t *dp;\n if (n != WRITE_SIZE) {\n memset(writeBuf, 0xff, WRITE_SIZE);\n memcpy((uint8_t *)writeBuf + off, src, n);\n sp = writeBuf;\n dp = (uint32_t *)(dst - off);\n } else {\n sp = (uint32_t *)src;\n dp = (uint32_t *)dst;\n }\n\n bool need = false;\n for (unsigned i = 0; i < (WRITE_SIZE >> 2); ++i)\n if (sp[i] != 0xffffffff) {\n need = true;\n break;\n }\n\n if (need) {\n CMD(NVMCTRL_CTRLA_CMD_PBC, NVMCTRL_CTRLB_CMD_PBC);\n waitForLast();\n\n uint32_t q = WRITE_SIZE >> 2;\n\n target_disable_irq();\n while (q--) {\n auto v = *sp++;\n *dp = v;\n dp++;\n }\n\n CMD(NVMCTRL_CTRLA_CMD_WP, NVMCTRL_CTRLB_CMD_WQW);\n target_enable_irq();\n waitForLast();\n }\n\n src = (uint8_t *)src + n;\n dst += n;\n idx += n;\n }\n\n CHECK_ECC();\n\n lock();\n\n return 0;\n}\n} // namespace codal\n#endif\n",
|
|
2844
2844
|
"STM32Flash.cpp": "#include \"pxt.h\"\n#include \"Flash.h\"\n\n//#define LOG DMESG\n#define LOG NOLOG\n\n#ifdef STM32F4\nnamespace codal {\nstatic void waitForLast() {\n while ((FLASH->SR & FLASH_SR_BSY) == FLASH_SR_BSY)\n ;\n}\n\nstatic void unlock() {\n FLASH->CR |= FLASH_CR_LOCK;\n FLASH->KEYR = FLASH_KEY1;\n FLASH->KEYR = FLASH_KEY2;\n}\n\nstatic void lock() {\n FLASH->CR |= FLASH_CR_LOCK;\n}\n\nint ZFlash::pageSize(uintptr_t address) {\n address |= 0x08000000;\n if (address < 0x08010000)\n return 16 * 1024;\n if (address < 0x08020000)\n return 64 * 1024;\n if (address < 0x08100000)\n return 128 * 1024;\n target_panic(DEVICE_FLASH_ERROR);\n return 0;\n}\n\nint ZFlash::totalSize() {\n return *((uint16_t *)0x1FFF7A22) * 1024;\n}\n\nint ZFlash::erasePage(uintptr_t address) {\n waitForLast();\n unlock();\n\n address |= 0x08000000;\n uintptr_t ptr = 0x08000000;\n int sectNum = 0;\n while (1) {\n ptr += pageSize(ptr);\n if (ptr > address)\n break;\n sectNum++;\n }\n\n FLASH->CR = FLASH_CR_PSIZE_1 | (sectNum << FLASH_CR_SNB_Pos) | FLASH_CR_SER;\n FLASH->CR |= FLASH_CR_STRT;\n\n waitForLast();\n\n FLASH->CR = FLASH_CR_PSIZE_1;\n lock();\n\n // cache flushing only required after erase, not programming (3.5.4)\n __HAL_FLASH_DATA_CACHE_DISABLE();\n __HAL_FLASH_DATA_CACHE_RESET();\n __HAL_FLASH_DATA_CACHE_ENABLE();\n\n // we skip instruction cache, as we're not expecting to erase that\n\n return 0;\n}\n\nint ZFlash::writeBytes(uintptr_t dst, const void *src, uint32_t len) {\n LOG(\"WR flash at %p len=%d\", (void *)dst, len);\n\n if ((dst & 3) || ((uintptr_t)src & 3) || (len & 3))\n return -1;\n\n for (unsigned i = 0; i < len; ++i)\n if (((uint8_t *)dst)[i] != 0xff && ((uint8_t *)src)[i] != 0xff)\n return -3;\n\n waitForLast();\n unlock();\n\n dst |= 0x08000000;\n\n FLASH->CR = FLASH_CR_PSIZE_1 | FLASH_CR_PG;\n\n volatile uint32_t *sp = (uint32_t *)src;\n volatile uint32_t *dp = (uint32_t *)dst;\n len >>= 2;\n\n while (len-- > 0) {\n uint32_t v = *sp++;\n if (v != 0xffffffff) {\n *dp++ = v;\n waitForLast();\n } else {\n dp++;\n }\n }\n\n FLASH->CR = FLASH_CR_PSIZE_1;\n lock();\n\n LOG(\"WR flash OK\");\n\n return 0;\n}\n} // namespace codal\n#endif\n",
|
|
2845
|
-
"pxt.json": "{\n \"name\": \"settings\",\n \"description\": \"Settings storage in internal flash\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"RAFFS.cpp\",\n \"RAFFS.h\",\n \"Flash.h\",\n \"STM32Flash.cpp\",\n \"SAMDFlash.cpp\",\n \"NRF52Flash.cpp\",\n \"RP2040Flash.cpp\",\n \"settings.cpp\",\n \"settings.ts\",\n \"shims.d.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2845
|
+
"pxt.json": "{\n \"name\": \"settings\",\n \"description\": \"Settings storage in internal flash\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"RAFFS.cpp\",\n \"RAFFS.h\",\n \"Flash.h\",\n \"STM32Flash.cpp\",\n \"SAMDFlash.cpp\",\n \"NRF52Flash.cpp\",\n \"RP2040Flash.cpp\",\n \"settings.cpp\",\n \"settings.ts\",\n \"shims.d.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"hidden\": true,\n \"disablesVariants\": [\n \"mbdal\"\n ]\n}\n",
|
|
2846
2846
|
"settings.cpp": "\n#include \"pxt.h\"\n#include \"RAFFS.h\"\n#include \"GhostFAT.h\"\n\nusing namespace pxt::raffs;\nusing namespace codal;\n\nnamespace settings {\n\n#if defined(SAMD21)\n#define SETTINGS_SIZE (2 * 1024)\n#else\n#define SETTINGS_SIZE (32 * 1024)\n#endif\n\nclass WStorage {\n public:\n CODAL_FLASH flash;\n FS fs;\n bool isMounted;\n\n WStorage()\n : flash(),\n#if defined(STM32F4)\n fs(flash, 0x8008000, SETTINGS_SIZE),\n#elif defined(SAMD51)\n fs(flash, 512 * 1024 - SETTINGS_SIZE, SETTINGS_SIZE),\n#elif defined(SAMD21)\n fs(flash, 256 * 1024 - SETTINGS_SIZE, SETTINGS_SIZE),\n#elif defined(NRF52_SERIES)\n#define NRF_BOOTLOADER_START *(uint32_t *)0x10001014\n fs(flash,\n 128 * 1024 < NRF_BOOTLOADER_START && NRF_BOOTLOADER_START < (uint32_t)flash.totalSize()\n ? NRF_BOOTLOADER_START - SETTINGS_SIZE\n : flash.totalSize() - SETTINGS_SIZE,\n SETTINGS_SIZE),\n#elif defined(PICO_BOARD)\n // XIP bias 0x10000000\n fs(flash, 0x10000000 + flash.totalSize() - SETTINGS_SIZE, SETTINGS_SIZE),\n#else\n fs(flash),\n#endif\n isMounted(false) {\n fs.minGCSpacing = 10000;\n }\n};\nSINGLETON(WStorage);\n\nstatic WStorage *mountedStorage() {\n auto s = getWStorage();\n if (s->fs.tryMount())\n return s;\n s->fs.exists(\"foobar\"); // forces mount and possibly format\n return s;\n}\n\n// large store is area for storing large binary objects, eg ML models\n// it may be already occupied by the user program, in which case largeStoreStart() will return 0\nsize_t largeStoreSize() {\n#if defined(SAMD21)\n return 64 * 1024;\n#else\n return 128 * 1024;\n#endif\n}\n\nuintptr_t largeStoreStart() {\n auto s = getWStorage();\n uintptr_t r;\n#if defined(STM32F4)\n r = 0x08000000 + s->flash.totalSize() - largeStoreSize();\n#else\n r = s->fs.baseAddr - s->fs.bytes - largeStoreSize();\n#endif\n\n if (r < afterProgramPage())\n return 0;\n\n return r;\n}\n\nCODAL_FLASH *largeStoreFlash() {\n return &getWStorage()->flash;\n}\n\n//%\nint _set(String key, Buffer data) {\n auto s = mountedStorage();\n return s->fs.write(key->getUTF8Data(), data->data, data->length);\n}\n\n//%\nint _remove(String key) {\n auto s = mountedStorage();\n return s->fs.remove(key->getUTF8Data());\n}\n\n//%\nbool _exists(String key) {\n auto s = mountedStorage();\n return s->fs.exists(key->getUTF8Data());\n}\n\n//%\nBuffer _get(String key) {\n auto s = mountedStorage();\n auto sz = s->fs.read(key->getUTF8Data(), NULL, 0);\n if (sz < 0)\n return NULL;\n auto ret = mkBuffer(NULL, sz);\n registerGCObj(ret);\n s->fs.read(NULL, ret->data, ret->length);\n unregisterGCObj(ret);\n return ret;\n}\n\nstatic bool isSystem(const char *fn) {\n return fn[0] == '#';\n}\n\n//%\nvoid _userClean() {\n auto s = mountedStorage();\n DMESG(\"clearing user files\");\n s->fs.forceGC(isSystem);\n // if system files take more than 25% of storage size, we reformat\n // it likely means user code has written some 'system' files\n if (s->fs.freeSize() < 3 * s->fs.totalSize() / 4) {\n s->fs.format();\n }\n}\n\n//%\nRefCollection *_list(String prefix) {\n auto st = mountedStorage();\n st->fs.dirRewind();\n auto res = Array_::mk();\n registerGCObj(res);\n\n auto prefData = prefix->getUTF8Data();\n auto prefLen = prefix->getUTF8Size();\n auto wantsInternal = prefData[0] == '#';\n\n for (;;) {\n auto d = st->fs.dirRead();\n if (!d)\n break;\n if (!wantsInternal && d->name[0] == '#')\n continue;\n if (memcmp(d->name, prefData, prefLen) != 0)\n continue;\n auto str = mkString(d->name, -1);\n registerGCObj(str);\n res->head.push((TValue)str);\n unregisterGCObj(str);\n }\n unregisterGCObj(res);\n return res;\n}\n\n} // namespace settings\n",
|
|
2847
2847
|
"settings.ts": "namespace settings {\n const RUN_KEY = \"#run\";\n const SCOPE_KEY = \"#scope\";\n const DEVICE_SECRETS_KEY = \"#secrets\";\n const SECRETS_KEY = \"__secrets\";\n\n //% shim=pxt::seedAddRandom\n declare function seedAddRandom(n: number): void;\n\n //% shim=settings::_set\n declare function _set(key: string, data: Buffer): int32;\n\n //% shim=settings::_remove\n declare function _remove(key: string): int32;\n\n //% shim=settings::_exists\n declare function _exists(key: string): boolean;\n\n //% shim=settings::_get\n declare function _get(key: string): Buffer;\n\n //% shim=settings::_userClean\n declare function _userClean(): void;\n\n //% shim=settings::_list\n declare function _list(prefix: string): string[];\n\n export function runNumber() {\n return readNumber(RUN_KEY) || 0\n }\n\n function setScope(scope: string) {\n if (!scope || scope.length > 100)\n control.panic(922)\n const currScope = readString(SCOPE_KEY)\n if (currScope != scope) {\n _userClean()\n writeString(SCOPE_KEY, scope)\n }\n }\n\n function initScopes() {\n const rn = runNumber() + 1\n writeNumber(RUN_KEY, rn)\n\n seedAddRandom(control.deviceSerialNumber() & 0x7fffffff)\n seedAddRandom(rn)\n\n setScope(control.programName())\n }\n\n initScopes()\n\n /** \n * Delete all non-system settings.\n */\n export function clear(): void {\n _userClean()\n }\n\n /**\n * Set named setting to a given buffer.\n */\n export function writeBuffer(key: string, value: Buffer) {\n if (_set(key, value)) {\n // if we're out of space, clear user storage\n _userClean()\n // and panic - reset should hopefully recreate needed files\n control.panic(920)\n }\n }\n\n /**\n * Set named settings to a given string.\n */\n export function writeString(key: string, value: string) {\n writeBuffer(key, control.createBufferFromUTF8(value))\n }\n\n /**\n * Set named settings to a given JSON object.\n */\n export function writeJSON(key: string, value: any) {\n writeString(key, JSON.stringify(value))\n }\n\n /**\n * Set named settings to a given number.\n */\n export function writeNumber(key: string, value: number) {\n writeBuffer(key, msgpack.packNumberArray([value]))\n }\n\n /**\n * Set named settings to a given array of numbers.\n */\n export function writeNumberArray(key: string, value: number[]) {\n writeBuffer(key, msgpack.packNumberArray(value))\n }\n\n /**\n * Read named setting as a buffer. Returns undefined when setting not found.\n */\n export function readBuffer(key: string) {\n return _get(key)\n }\n\n /**\n * Read named setting as a string.\n */\n export function readString(key: string) {\n const buf = readBuffer(key)\n if (!buf)\n return undefined\n else\n return buf.toString()\n }\n\n /**\n * Read named setting as a JSON object.\n */\n export function readJSON(key: string) {\n const s = readString(key)\n if (s)\n return JSON.parse(s)\n return undefined\n }\n\n /**\n * Read named setting as a number.\n */\n export function readNumber(key: string) {\n const buf = readBuffer(key)\n if (!buf)\n return undefined\n else {\n const nums = msgpack.unpackNumberArray(buf)\n if (nums && nums.length >= 1)\n return nums[0]\n return undefined\n }\n }\n\n /**\n * Read named setting as a number.\n */\n export function readNumberArray(key: string) {\n const buf = readBuffer(key)\n if (!buf)\n return undefined\n else\n return msgpack.unpackNumberArray(buf)\n }\n\n /**\n * Return a list of settings starting with a given prefix.\n */\n export function list(prefix?: string) {\n if (!prefix) prefix = \"\"\n return _list(prefix)\n }\n\n /**\n * Remove named setting.\n */\n export function remove(key: string) {\n _remove(key)\n }\n\n /**\n * Check if a named setting exists.\n */\n export function exists(key: string) {\n return _exists(key)\n }\n\n function clone(v: any): any {\n if (v == null) return null\n return JSON.parse(JSON.stringify(v))\n }\n\n function isKV(v: any) {\n return !!v && typeof v === \"object\" && !Array.isArray(v)\n }\n\n function jsonMergeFrom(trg: any, src: any) {\n if (!src) return;\n const keys = Object.keys(src)\n keys.forEach(k => {\n const srck = src[k];\n if (isKV(trg[k]) && isKV(srck))\n jsonMergeFrom(trg[k], srck);\n else\n trg[k] = clone(srck);\n });\n }\n\n //% fixedInstances\n export class SecretStore {\n constructor(private key: string) { }\n\n setSecret(name: string, value: any) {\n const secrets = this.readSecrets();\n secrets[name] = value;\n writeJSON(this.key, secrets);\n }\n\n updateSecret(name: string, value: any) {\n const secrets = this.readSecrets();\n const secret = secrets[name];\n if (secret === undefined)\n secrets[name] = value;\n else jsonMergeFrom(secret, value);\n writeJSON(this.key, secrets)\n }\n\n readSecret(name: string, ensure: boolean = false): any {\n const secrets = this.readSecrets();\n const secret = secrets[name];\n if (ensure && !secret)\n throw \"missing secret \" + name;\n return secret;\n }\n\n clearSecrets() {\n writeString(this.key, \"{}\");\n }\n\n readSecrets(): any {\n try {\n return readJSON(this.key) || {}\n } catch {\n control.dmesg(\"invalid secret format\")\n return {};\n }\n }\n }\n\n /**\n * Secrets shared by any program on the device\n */\n //% fixedInstance whenUsed block=\"device secrets\"\n export const deviceSecrets = new SecretStore(DEVICE_SECRETS_KEY);\n\n /**\n * Program secrets\n */\n //% fixedInstance whenUsed block=\"program secrets\"\n export const programSecrets = new SecretStore(SECRETS_KEY);\n}\n",
|
|
2848
2848
|
"shims.d.ts": "\n"
|
|
@@ -2851,19 +2851,19 @@
|
|
|
2851
2851
|
"README.md": "# datalog\n",
|
|
2852
2852
|
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum FlashLogTimeStampFormat\n {\n //% block=\"none\"\n None = 0,\n //% block=\"milliseconds\"\n Milliseconds = 1,\n //% block=\"seconds\"\n Seconds = 10,\n //% block=\"minutes\"\n Minutes = 600,\n //% block=\"hours\"\n Hours = 36000,\n //% block=\"days\"\n Days = 864000,\n }\ndeclare namespace flashlog {\n}\n\n// Auto-generated. Do not edit. Really.\n",
|
|
2853
2853
|
"flashlog.cpp": "#include \"pxt.h\"\n\n#if MICROBIT_CODAL\n#include \"MicroBitLog.h\"\n#endif\n\nenum class FlashLogTimeStampFormat\n{\n //% block=\"none\"\n None = 0,\n //% block=\"milliseconds\"\n Milliseconds = 1,\n //% block=\"seconds\"\n Seconds = 10,\n //% block=\"minutes\"\n Minutes = 600,\n //% block=\"hours\"\n Hours = 36000,\n //% block=\"days\"\n Days = 864000\n};\n\n/**\n * Storing structured data in flash.\n */\n//%\nnamespace flashlog {\n\n/**\n* Creates a new row in the log, ready to be populated by logData()\n**/\n//% help=flashlog/begin-row\n//% parts=\"flashlog\"\n//% blockGap=8\n//% group=\"micro:bit (V2)\"\nint beginRow() {\n#if MICROBIT_CODAL\n return uBit.log.beginRow();\n#else\n return DEVICE_NOT_SUPPORTED;\n#endif\n}\n\n/**\n* Populates the current row with the given key/value pair.\n**/\n//% help=flashlog/log-data\n//% parts=\"flashlog\"\n//% blockGap=8\n//% group=\"micro:bit (V2)\"\nint logData(String key, String value) {\n if (NULL == key || NULL == value)\n return DEVICE_INVALID_PARAMETER;\n#if MICROBIT_CODAL\n return uBit.log.logData(MSTR(key), MSTR(value));\n#else\n return DEVICE_NOT_SUPPORTED;\n#endif\n}\n\n/**\n* Inject the given row into the log as text, ignoring key/value pairs.\n**/\n//% help=flashlog/log-string\n//% parts=\"flashlog\"\n//% blockGap=8\n//% group=\"micro:bit (V2)\"\nint logString(String value) {\n if (NULL == value)\n return DEVICE_INVALID_PARAMETER;\n#if MICROBIT_CODAL\n return uBit.log.logString(MSTR(value));\n#else\n return DEVICE_NOT_SUPPORTED;\n#endif\n}\n\n/**\n* Complete a row in the log, and pushes to persistent storage.\n**/\n//% help=flashlog/end-row\n//% parts=\"flashlog\"\n//% blockGap=8\n//% group=\"micro:bit (V2)\"\nint endRow() {\n#if MICROBIT_CODAL\n return uBit.log.endRow();\n#else\n return DEVICE_NOT_SUPPORTED;\n#endif\n}\n\n/**\n* Resets all data stored in persistent storage.\n**/\n//% help=flashlog/clear\n//% parts=\"flashlog\"\n//% blockGap=8\n//% group=\"micro:bit (V2)\"\nvoid clear(bool fullErase) {\n#if MICROBIT_CODAL\n uBit.log.clear(fullErase);\n#endif\n}\n\n/**\n* Determines the format of the timestamp data to be added (if any).\n* If requested, time stamps will be automatically added to each row of data\n* as an integer value rounded down to the unit specified.\n*\n* @param format The format of timestamp to use.\n*/\n//% help=flashlog/set-timestamp\n//% parts=\"flashlog\"\n//% blockGap=8\n//% group=\"micro:bit (V2)\"\nvoid setTimeStamp(FlashLogTimeStampFormat format) {\n#if MICROBIT_CODAL\n return uBit.log.setTimeStamp((codal::TimeStampFormat)format);\n#endif\n}\n\n/**\n * Defines if data logging should also be streamed over the serial port.\n *\n * @param enable True to enable serial port streaming, false to disable.\n*/\n//% help=flashlog/set-serial-mirroring\n//% parts=\"flashlog\"\n//% blockGap=8\n//% group=\"micro:bit (V2)\"\nvoid setSerialMirroring(bool enable) {\n#if MICROBIT_CODAL\n return uBit.log.setSerialMirroring(enable);\n#endif\n}\n\n}\n",
|
|
2854
|
-
"pxt.json": "{\n \"name\": \"flashlog\",\n \"description\": \"Data logging to flash.\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"flashlog.cpp\",\n \"shims.d.ts\",\n \"enums.d.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2854
|
+
"pxt.json": "{\n \"name\": \"flashlog\",\n \"description\": \"Data logging to flash.\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"flashlog.cpp\",\n \"shims.d.ts\",\n \"enums.d.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"searchOnly\": true,\n \"disablesVariants\": [\n \"mbdal\"\n ],\n \"icon\": \"/static/libs/flashlog.png\"\n}\n",
|
|
2855
2855
|
"shims.d.ts": "// Auto-generated. Do not edit.\n\n\n /**\n * Storing structured data in flash.\n */\n //%\ndeclare namespace flashlog {\n\n /**\n * Creates a new row in the log, ready to be populated by logData()\n **/\n //% help=flashlog/begin-row\n //% parts=\"flashlog\"\n //% blockGap=8\n //% group=\"micro:bit (V2)\" shim=flashlog::beginRow\n function beginRow(): int32;\n\n /**\n * Populates the current row with the given key/value pair.\n **/\n //% help=flashlog/log-data\n //% parts=\"flashlog\"\n //% blockGap=8\n //% group=\"micro:bit (V2)\" shim=flashlog::logData\n function logData(key: string, value: string): int32;\n\n /**\n * Inject the given row into the log as text, ignoring key/value pairs.\n **/\n //% help=flashlog/log-string\n //% parts=\"flashlog\"\n //% blockGap=8\n //% group=\"micro:bit (V2)\" shim=flashlog::logString\n function logString(value: string): int32;\n\n /**\n * Complete a row in the log, and pushes to persistent storage.\n **/\n //% help=flashlog/end-row\n //% parts=\"flashlog\"\n //% blockGap=8\n //% group=\"micro:bit (V2)\" shim=flashlog::endRow\n function endRow(): int32;\n\n /**\n * Resets all data stored in persistent storage.\n **/\n //% help=flashlog/clear\n //% parts=\"flashlog\"\n //% blockGap=8\n //% group=\"micro:bit (V2)\" shim=flashlog::clear\n function clear(fullErase: boolean): void;\n\n /**\n * Determines the format of the timestamp data to be added (if any).\n * If requested, time stamps will be automatically added to each row of data\n * as an integer value rounded down to the unit specified.\n *\n * @param format The format of timestamp to use.\n */\n //% help=flashlog/set-timestamp\n //% parts=\"flashlog\"\n //% blockGap=8\n //% group=\"micro:bit (V2)\" shim=flashlog::setTimeStamp\n function setTimeStamp(format: FlashLogTimeStampFormat): void;\n\n /**\n * Defines if data logging should also be streamed over the serial port.\n *\n * @param enable True to enable serial port streaming, false to disable.\n */\n //% help=flashlog/set-serial-mirroring\n //% parts=\"flashlog\"\n //% blockGap=8\n //% group=\"micro:bit (V2)\" shim=flashlog::setSerialMirroring\n function setSerialMirroring(enable: boolean): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
|
|
2856
2856
|
"test.ts": "input.onButtonPressed(Button.AB, function() {\n flashlog.clear()\n})\nflashlog.setTimeStamp(FlashLogTimeStampFormat.Milliseconds)\nbasic.forever(function () {\n led.toggle(0, 0)\n const ax = input.acceleration(Dimension.X)\n\tflashlog.beginRow()\n flashlog.logData(`a.x`, ax)\n flashlog.logData(`a.y`, input.acceleration(Dimension.Y))\n flashlog.endRow()\n})\n"
|
|
2857
2857
|
},
|
|
2858
2858
|
"datalogger": {
|
|
2859
2859
|
"datalogger.ts": "/**\n * Log data to flash storage\n */\n//% block=\"Data Logger\"\n//% icon=\"\\uf0ce\"\n//% color=\"#378273\"\nnamespace datalogger {\n export enum DeleteType {\n //% block=\"fast\"\n Fast,\n //% block=\"full\"\n Full\n }\n\n let onLogFullHandler: () => void;\n let _disabled = false;\n\n let initialized = false;\n function init() {\n if (initialized)\n return;\n initialized = true;\n\n includeTimestamp(FlashLogTimeStampFormat.Seconds);\n mirrorToSerial(true);\n\n control.onEvent(DAL.MICROBIT_ID_LOG, DAL.MICROBIT_LOG_EVT_LOG_FULL, () => {\n _disabled = true;\n if (onLogFullHandler) {\n onLogFullHandler();\n } else {\n basic.showLeds(`\n # . . . #\n # # . # #\n . . . . .\n . # # # .\n # . . . #\n `);\n basic.pause(1000);\n basic.clearScreen();\n basic.showString(\"928\");\n }\n });\n }\n\n export class ColumnValue {\n public value: string;\n constructor(\n public column: string,\n value: any\n ) {\n this.value = \"\" + value;\n }\n }\n\n /**\n * A column and value to log to flash storage\n * @param column the column to set\n * @param value the value to set.\n * @returns A new value that can be stored in flash storage using log data\n */\n //% block=\"column $column value $value\"\n //% value.shadow=math_number\n //% blockId=dataloggercreatecolumnvalue\n //% group=\"micro:bit (V2)\"\n //% weight=80 help=datalogger/create-cv\n export function createCV(column: string, value: any): ColumnValue {\n return new ColumnValue(column, value);\n }\n\n /**\n * Log data to flash storage\n * @param data Array of data to be logged to flash storage\n */\n //% block=\"log data $data\"\n //% blockId=dataloggerlogdata\n //% data.shadow=lists_create_with\n //% data.defl=dataloggercreatecolumnvalue\n //% group=\"micro:bit (V2)\"\n //% weight=100 help=datalogger/log-data\n export function logData(data: ColumnValue[]): void {\n if (!data || !data.length)\n return;\n init();\n\n if (_disabled)\n return;\n\n flashlog.beginRow();\n for (const cv of data) {\n flashlog.logData(cv.column, cv.value);\n }\n flashlog.endRow();\n }\n\n /**\n * Set the columns for future data logging\n * @param cols Array of the columns that will be logged.\n */\n //% block=\"set columns $cols\"\n //% blockId=dataloggersetcolumns\n //% data.shadow=list_create_with\n //% group=\"micro:bit (V2)\"\n //% weight=70 help=datalogger/set-columns\n export function setColumns(cols: string[]): void {\n if (!cols)\n return;\n\n logData(cols.map(col => createCV(col, \"\")));\n }\n\n /**\n * Delete all existing logs, including column headers. By default this only marks the log as\n * overwriteable / deletable in the future.\n * @param deleteType optional set whether a deletion will be fast or full\n */\n //% block=\"delete log||$deleteType\"\n //% blockId=dataloggerdeletelog\n //% group=\"micro:bit (V2)\"\n //% weight=60 help=datalogger/delete-log\n export function deleteLog(deleteType?: DeleteType): void {\n init();\n flashlog.clear(deleteType === DeleteType.Full);\n _disabled = false;\n }\n\n /**\n * Register an event to run when no more data can be logged.\n * @param handler code to run when the log is full and no more data can be stored.\n */\n //% block=\"on log full\"\n //% blockId=\"on log full\"\n //% group=\"micro:bit (V2)\"\n //% weight=40 help=datalogger/on-log-full\n export function onLogFull(handler: () => void): void {\n init();\n onLogFullHandler = handler;\n }\n\n /**\n * Set the format for timestamps\n * @param format Format in which to show the timestamp. Setting FlashLogTimeStampFormat.None will disable the timestamp.\n */\n //% block=\"set timestamp $format\"\n //% blockId=dataloggertoggleincludetimestamp\n //% format.defl=FlashLogTimeStampFormat.None\n //% group=\"micro:bit (V2)\"\n //% weight=30 help=datalogger/include-timestamp\n export function includeTimestamp(format: FlashLogTimeStampFormat): void {\n init();\n flashlog.setTimeStamp(format);\n }\n\n /**\n * Set whether data is mirrored to serial or not.\n * @param on if true, data that is logged will be mirrored to serial\n */\n //% block=\"mirror data to serial $on\"\n //% blockId=dataloggertogglemirrortoserial\n //% on.shadow=toggleOnOff\n //% on.defl=false\n //% weight=25 help=datalogger/mirror-to-serial\n export function mirrorToSerial(on: boolean): void {\n // TODO:/note intentionally does not have group, as having the same group for all\n // blocks in a category causes the group to be elided.\n init();\n flashlog.setSerialMirroring(on);\n }\n}",
|
|
2860
|
-
"pxt.json": "{\n \"name\": \"datalogger\",\n \"description\": \"Data logging to flash memory. micro:bit (V2) only.\",\n \"dependencies\": {\n \"core\": \"*\",\n \"flashlog\": \"*\"\n },\n \"files\": [\n \"datalogger.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2860
|
+
"pxt.json": "{\n \"name\": \"datalogger\",\n \"description\": \"Data logging to flash memory. micro:bit (V2) only.\",\n \"dependencies\": {\n \"core\": \"*\",\n \"flashlog\": \"*\"\n },\n \"files\": [\n \"datalogger.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"disablesVariants\": [\n \"mbdal\"\n ],\n \"icon\": \"/static/libs/datalogger.png\"\n}\n"
|
|
2861
2861
|
},
|
|
2862
2862
|
"color": {
|
|
2863
2863
|
"README.md": "# Colors\n\nColor manipulation",
|
|
2864
2864
|
"colorbuffer.ts": "namespace color {\n export enum ColorBufferLayout {\n /**\n * 24bit RGB color\n */\n RGB,\n /**\n * 32bit RGB color with alpha\n */\n ARGB\n }\n\n /**\n * A buffer of colors\n */\n export class ColorBuffer {\n layout: ColorBufferLayout;\n buf: Buffer;\n\n constructor(length: number, layout?: ColorBufferLayout) {\n this.layout = layout || ColorBufferLayout.RGB;\n this.buf = control.createBuffer((length | 0) * this.stride);\n }\n\n static fromBuffer(buffer: Buffer, layout: ColorBufferLayout) {\n const b = new ColorBuffer(0, layout);\n b.buf = buffer.slice();\n return b;\n }\n\n get stride() {\n return this.layout == ColorBufferLayout.RGB ? 3 : 4;\n }\n\n get length() {\n return Math.idiv(this.buf.length, this.stride);\n }\n\n color(index: number): number {\n index = index | 0;\n if (index < 0 || index >= this.length)\n return -1;\n\n const s = this.stride;\n const start = index * s;\n let c = 0;\n for (let i = 0; i < s; ++i)\n c = (c << 8) | (this.buf[start + i] & 0xff);\n return c;\n }\n\n setColor(index: number, color: number) {\n index = index | 0;\n if (index < 0 || index >= this.length) return;\n\n const s = this.stride;\n const start = index * s;\n for (let i = s - 1; i >= 0; --i) {\n this.buf[start + i] = color & 0xff;\n color = color >> 8;\n }\n }\n\n slice(start?: number, length?: number): ColorBuffer {\n start = start | 0;\n if (start < 0)\n start = this.length - start;\n\n if (length == undefined)\n length = this.length;\n length = Math.min(length, this.length - start);\n\n const output = new ColorBuffer(length, this.layout);\n for (let i = 0; i < length; ++i) {\n output.setColor(i, this.color(start + i));\n }\n\n return output;\n }\n\n /**\n * Writes the content of the src color buffer starting at the start dstOffset in the current buffer\n * @param dstOffset\n * @param src\n */\n write(dstOffset: number, src: ColorBuffer): void {\n if (this.layout == src.layout) {\n const d = (dstOffset | 0) * this.stride;\n this.buf.write(d, src.buf);\n } else {\n // different color layout\n const n = Math.min(src.length, this.length - dstOffset);\n for (let i = 0; i < n; ++i)\n this.setColor(dstOffset + i, src.color(i));\n }\n }\n }\n\n /**\n * Converts an array of colors into a color buffer\n */\n export function createBuffer(colors: number[], layout?: ColorBufferLayout): color.ColorBuffer {\n const p = new ColorBuffer(colors.length, layout);\n const n = colors.length;\n for (let i = 0; i < n; i++) {\n p.setColor(i, colors[i]);\n }\n return p;\n }\n}",
|
|
2865
2865
|
"colors.ts": "/**\n * Well known colors\n */\nconst enum Colors {\n //% block=red\n //% blockIdentity=color.wellKnown\n Red = 0xFF0000,\n //% block=orange\n //% blockIdentity=color.wellKnown\n Orange = 0xFF7F00,\n //% block=yellow\n //% blockIdentity=color.wellKnown\n Yellow = 0xFFFF00,\n //% block=green\n //% blockIdentity=color.wellKnown\n Green = 0x00FF00,\n //% block=blue\n //% blockIdentity=color.wellKnown\n Blue = 0x0000FF,\n //% block=indigo\n //% blockIdentity=color.wellKnown\n Indigo = 0x4b0082,\n //% block=violet\n //% blockIdentity=color.wellKnown\n Violet = 0x8a2be2,\n //% block=purple\n //% blockIdentity=color.wellKnown\n Purple = 0xA033E5,\n //% block=pink\n //% blockIdentity=color.wellKnown\n Pink = 0xFF007F,\n //% block=white\n //% blockIdentity=color.wellKnown\n White = 0xFFFFFF,\n //% block=black\n //% blockIdentity=color.wellKnown\n Black = 0x000000\n}\n\n/**\n * Well known color hues\n */\nconst enum ColorHues {\n //% block=red\n Red = 0,\n //% block=orange\n Orange = 29,\n //% block=yellow\n Yellow = 43,\n //% block=green\n Green = 86,\n //% block=aqua\n Aqua = 125,\n //% block=blue\n Blue = 170,\n //% block=purple\n Purple = 191,\n //% block=magenta\n Magenta = 213,\n //% block=pink\n Pink = 234\n}\n\n/**\n * Color manipulation\n */\n//% advanced=1\nnamespace color {\n /**\n * Converts red, green, blue channels into a RGB color\n * @param red value of the red channel between 0 and 255. eg: 255\n * @param green value of the green channel between 0 and 255. eg: 255\n * @param blue value of the blue channel between 0 and 255. eg: 255\n */\n //% blockId=\"colorsrgb\" block=\"red %red|green %green|blue %blue\"\n //% red.min=0 red.max=255 green.min=0 green.max=255 blue.min=0 blue.max=255\n //% help=\"colors/rgb\"\n //% weight=19 blockGap=8\n //% blockHidden=true\n export function rgb(red: number, green: number, blue: number): number {\n return ((red & 0xFF) << 16) | ((green & 0xFF) << 8) | (blue & 0xFF);\n }\n\n export function argb(alpha: number, red: number, green: number, blue: number): number {\n return ((alpha & 0xFF) << 24) | ((red & 0xFF) << 16) | ((green & 0xFF) << 8) | (blue & 0xFF);\n }\n\n /**\n * Get the RGB value of a known color\n */\n //% blockId=colorscolors block=\"%color\"\n //% help=\"colors/well-known\"\n //% shim=TD_ID\n //% weight=20 blockGap=8\n //% blockHidden=true\n export function wellKnown(color: Colors): number {\n return color;\n }\n\n /**\n * Convert an HSV (hue, saturation, value) color to RGB\n * @param hue value of the hue channel between 0 and 255. eg: 255\n * @param sat value of the saturation channel between 0 and 255. eg: 255\n * @param val value of the value channel between 0 and 255. eg: 255\n */\n\n //% blockId=\"colorshsv\" block=\"hue %hue|sat %sat|val %val\"\n //% hue.min=0 hue.max=255 sat.min=0 sat.max=255 val.min=0 val.max=255\n //% help=\"colors/hsv\"\n //% weight=17\n //% blockHidden=true\n export function hsv(hue: number, sat: number = 255, val: number = 255): number {\n let h = (hue % 255) >> 0;\n if (h < 0) h += 255;\n // scale down to 0..192\n h = (h * 192 / 255) >> 0;\n\n //reference: based on FastLED's hsv2rgb rainbow algorithm [https://github.com/FastLED/FastLED](MIT)\n const invsat = 255 - sat;\n const brightness_floor = ((val * invsat) / 255) >> 0;\n const color_amplitude = val - brightness_floor;\n const section = (h / 0x40) >> 0; // [0..2]\n const offset = (h % 0x40) >> 0; // [0..63]\n\n const rampup = offset;\n const rampdown = (0x40 - 1) - offset;\n\n const rampup_amp_adj = ((rampup * color_amplitude) / (255 / 4)) >> 0;\n const rampdown_amp_adj = ((rampdown * color_amplitude) / (255 / 4)) >> 0;\n\n const rampup_adj_with_floor = (rampup_amp_adj + brightness_floor);\n const rampdown_adj_with_floor = (rampdown_amp_adj + brightness_floor);\n\n let r: number;\n let g: number;\n let b: number;\n if (section) {\n if (section == 1) {\n // section 1: 0x40..0x7F\n r = brightness_floor;\n g = rampdown_adj_with_floor;\n b = rampup_adj_with_floor;\n } else {\n // section 2; 0x80..0xBF\n r = rampup_adj_with_floor;\n g = brightness_floor;\n b = rampdown_adj_with_floor;\n }\n } else {\n // section 0: 0x00..0x3F\n r = rampdown_adj_with_floor;\n g = rampup_adj_with_floor;\n b = brightness_floor;\n }\n return rgb(r, g, b);\n }\n\n /**\n * Fade the color by the brightness\n * @param color color to fade\n * @param brightness the amount of brightness to apply to the color, eg: 128\n */\n //% blockId=\"colorsfade\" block=\"fade %color=neopixel_colors|by %brightness\"\n //% brightness.min=0 brightness.max=255\n //% help=\"light/fade\"\n //% group=\"Color\" weight=18 blockGap=8\n //% blockHidden=true\n export function fade(color: number, brightness: number): number {\n brightness = Math.max(0, Math.min(255, brightness >> 0));\n if (brightness < 255) {\n let red = unpackR(color);\n let green = unpackG(color);\n let blue = unpackB(color);\n\n red = (red * brightness) >> 8;\n green = (green * brightness) >> 8;\n blue = (blue * brightness) >> 8;\n\n color = rgb(red, green, blue);\n }\n return color;\n }\n\n export function blend(color: number, alpha: number, otherColor: number) {\n alpha = Math.max(0, Math.min(0xff, alpha | 0));\n const malpha = 0xff - alpha;\n const r = (unpackR(color) * malpha + unpackR(otherColor) * alpha) >> 8;\n const g = (unpackG(color) * malpha + unpackG(otherColor) * alpha) >> 8;\n const b = (unpackB(color) * malpha + unpackB(otherColor) * alpha) >> 8;\n return rgb(r, g, b);\n }\n\n export function gradient(startColor: number, endColor: number, steps: number): ColorBuffer {\n steps = Math.max(2, steps | 0);\n const b = new ColorBuffer(steps);\n b.setColor(0, startColor);\n b.setColor(b.length - 1, endColor);\n for (let i = 1; i < steps - 1; ++i) {\n const alpha = Math.idiv(0xff * i, steps);\n const c = blend(startColor, alpha, endColor);\n b.setColor(i, c);\n }\n return b;\n }\n\n export function unpackR(rgb: number): number {\n return (rgb >> 16) & 0xFF;\n }\n export function unpackG(rgb: number): number {\n return (rgb >> 8) & 0xFF;\n }\n export function unpackB(rgb: number): number {\n return (rgb >> 0) & 0xFF;\n }\n\n export function parseColor(color: string): number {\n switch (color) {\n case \"RED\":\n case \"red\":\n return Colors.Red;\n case \"GREEN\":\n case \"green\":\n return Colors.Green;\n case \"BLUE\":\n case \"blue\":\n return Colors.Blue;\n case \"WHITE\":\n case \"white\":\n return Colors.White;\n case \"ORANGE\":\n case \"orange\":\n return Colors.Orange;\n case \"PURPLE\":\n case \"purple\":\n return Colors.Purple;\n case \"YELLOW\":\n case \"yellow\":\n return Colors.Yellow;\n case \"PINK\":\n case \"pink\":\n return Colors.Pink;\n default:\n return parseInt(color) || 0;\n }\n }\n}",
|
|
2866
|
-
"pxt.json": "{\n \"name\": \"color\",\n \"description\": \"Color manipulation\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"colors.ts\",\n \"colorbuffer.ts\",\n \"README.md\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.
|
|
2866
|
+
"pxt.json": "{\n \"name\": \"color\",\n \"description\": \"Color manipulation\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"colors.ts\",\n \"colorbuffer.ts\",\n \"README.md\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"4.1.30\",\n \"pxt\": \"7.5.27\"\n },\n \"hidden\": true,\n \"weight\": 1,\n \"icon\": \"/static/libs/color.png\"\n}\n"
|
|
2867
2867
|
}
|
|
2868
2868
|
},
|
|
2869
2869
|
"apiInfo": {
|
|
@@ -12094,6 +12094,14 @@
|
|
|
12094
12094
|
],
|
|
12095
12095
|
"pyQName": "serial.set_tx_buffer_size"
|
|
12096
12096
|
},
|
|
12097
|
+
"serial.writeDmesg": {
|
|
12098
|
+
"kind": -3,
|
|
12099
|
+
"attributes": {
|
|
12100
|
+
"jsDoc": "Send DMESG debug buffer over serial."
|
|
12101
|
+
},
|
|
12102
|
+
"parameters": [],
|
|
12103
|
+
"pyQName": "serial.write_dmesg"
|
|
12104
|
+
},
|
|
12097
12105
|
"Buffer": {
|
|
12098
12106
|
"kind": 5,
|
|
12099
12107
|
"retType": ""
|
|
@@ -29194,7 +29202,7 @@
|
|
|
29194
29202
|
}
|
|
29195
29203
|
}
|
|
29196
29204
|
},
|
|
29197
|
-
"sha": "
|
|
29205
|
+
"sha": "8f209466a3fd8fe1e0ae41a2cd8d69122ab6e36d2430d8fafbb9436065fd1b5d"
|
|
29198
29206
|
},
|
|
29199
29207
|
"libs/radio": {
|
|
29200
29208
|
"apis": {
|
|
@@ -30643,7 +30651,7 @@
|
|
|
30643
30651
|
}
|
|
30644
30652
|
}
|
|
30645
30653
|
},
|
|
30646
|
-
"sha": "
|
|
30654
|
+
"sha": "0c5e23108bea7d63cd66ef2663dac8e96f0ec7edcfb9098c420ee1c34b1b051b"
|
|
30647
30655
|
},
|
|
30648
30656
|
"libs/devices": {
|
|
30649
30657
|
"apis": {
|
|
@@ -32690,7 +32698,7 @@
|
|
|
32690
32698
|
}
|
|
32691
32699
|
}
|
|
32692
32700
|
},
|
|
32693
|
-
"sha": "
|
|
32701
|
+
"sha": "85a98fe50f6d3cf5906b724c747ea2c463145b2bcfea503d8a158f896d9f6141"
|
|
32694
32702
|
},
|
|
32695
32703
|
"libs/bluetooth": {
|
|
32696
32704
|
"apis": {
|
|
@@ -33651,7 +33659,7 @@
|
|
|
33651
33659
|
}
|
|
33652
33660
|
}
|
|
33653
33661
|
},
|
|
33654
|
-
"sha": "
|
|
33662
|
+
"sha": "9b6c49add0433305dde3b45d6280ff89a7d4762946ee0ef8572b4b81cdaf5bf7"
|
|
33655
33663
|
},
|
|
33656
33664
|
"libs/servo": {
|
|
33657
33665
|
"apis": {
|
|
@@ -34293,7 +34301,7 @@
|
|
|
34293
34301
|
}
|
|
34294
34302
|
}
|
|
34295
34303
|
},
|
|
34296
|
-
"sha": "
|
|
34304
|
+
"sha": "84672086b7aaa34bb6f65e1d44f73d5bfb36d1d5c80e31a804129ce26e4e1232"
|
|
34297
34305
|
},
|
|
34298
34306
|
"libs/radio-broadcast": {
|
|
34299
34307
|
"apis": {
|
|
@@ -35887,7 +35895,7 @@
|
|
|
35887
35895
|
}
|
|
35888
35896
|
}
|
|
35889
35897
|
},
|
|
35890
|
-
"sha": "
|
|
35898
|
+
"sha": "a439b196ecbc34da8d00e29bcd2766fed2938d104a7e757d4392224c9fbee21a"
|
|
35891
35899
|
},
|
|
35892
35900
|
"libs/microphone": {
|
|
35893
35901
|
"apis": {
|
|
@@ -36165,7 +36173,7 @@
|
|
|
36165
36173
|
}
|
|
36166
36174
|
}
|
|
36167
36175
|
},
|
|
36168
|
-
"sha": "
|
|
36176
|
+
"sha": "3d49e17fe04a58dc14b1a4e814eb52cf040667d453a3df0c42c95f71cba3d7f6"
|
|
36169
36177
|
},
|
|
36170
36178
|
"libs/settings": {
|
|
36171
36179
|
"apis": {
|
|
@@ -36502,7 +36510,7 @@
|
|
|
36502
36510
|
}
|
|
36503
36511
|
}
|
|
36504
36512
|
},
|
|
36505
|
-
"sha": "
|
|
36513
|
+
"sha": "f8959fb4dc7a8bd5748e2808ec8c76bdc497a7cfacc7f6f329a0c7372f963708"
|
|
36506
36514
|
},
|
|
36507
36515
|
"libs/flashlog": {
|
|
36508
36516
|
"apis": {
|
|
@@ -36767,7 +36775,7 @@
|
|
|
36767
36775
|
}
|
|
36768
36776
|
}
|
|
36769
36777
|
},
|
|
36770
|
-
"sha": "
|
|
36778
|
+
"sha": "ca88ac31975e64c1ac0260f46f529cd7670b02936acc6f5758c144a1ee3c699d"
|
|
36771
36779
|
},
|
|
36772
36780
|
"libs/datalogger": {
|
|
36773
36781
|
"apis": {
|
|
@@ -37488,7 +37496,7 @@
|
|
|
37488
37496
|
}
|
|
37489
37497
|
}
|
|
37490
37498
|
},
|
|
37491
|
-
"sha": "
|
|
37499
|
+
"sha": "09987dc1183ef4c5f40f380fa328a825741fd4096c72ac01da26f3cccd25230a"
|
|
37492
37500
|
},
|
|
37493
37501
|
"libs/color": {
|
|
37494
37502
|
"apis": {
|
|
@@ -38600,7 +38608,7 @@
|
|
|
38600
38608
|
}
|
|
38601
38609
|
}
|
|
38602
38610
|
},
|
|
38603
|
-
"sha": "
|
|
38611
|
+
"sha": "6b4e93863cc345000efeda2c2d02cefd7e418b8aa76ac59b097459672be67d36"
|
|
38604
38612
|
},
|
|
38605
38613
|
"libs/blocksprj": {
|
|
38606
38614
|
"apis": {
|
|
@@ -40320,7 +40328,7 @@
|
|
|
40320
40328
|
}
|
|
40321
40329
|
}
|
|
40322
40330
|
},
|
|
40323
|
-
"sha": "
|
|
40331
|
+
"sha": "83febda978617ca6e8f25e2fe5c4662d6577f820676d4aaa92390c124d8def56"
|
|
40324
40332
|
},
|
|
40325
40333
|
"libs/bluetoothprj": {
|
|
40326
40334
|
"apis": {
|
|
@@ -41552,7 +41560,7 @@
|
|
|
41552
41560
|
}
|
|
41553
41561
|
}
|
|
41554
41562
|
},
|
|
41555
|
-
"sha": "
|
|
41563
|
+
"sha": "e42cd9181d578eb9da0361a1ffd8602d72ee53c70640a29c7a19ed1b146e1849"
|
|
41556
41564
|
},
|
|
41557
41565
|
"libs/tsprj": {
|
|
41558
41566
|
"apis": {
|
|
@@ -43272,7 +43280,7 @@
|
|
|
43272
43280
|
}
|
|
43273
43281
|
}
|
|
43274
43282
|
},
|
|
43275
|
-
"sha": "
|
|
43283
|
+
"sha": "def6a9046a3d1fca1b26c1d3c68cc6f8419b0683b58b55eb168483384e0bdff2"
|
|
43276
43284
|
}
|
|
43277
43285
|
}
|
|
43278
43286
|
}
|