{
"id": "maker",
"platformid": "codal",
"nickname": "maker",
"name": "MakeCode Maker (Cortex class)",
"title": "MakeCode Maker - Blocks / Javascript editor",
"description": "A Blocks / JavaScript code editor for MakeCode Maker Boards",
"corepkg": "core",
"bundleddirs": [
"libs/base",
"libs/base---light",
"libs/core",
"libs/core---stm32",
"libs/core---nrf52",
"libs/core---rp2040",
"libs/core---samd",
"libs/core---samd51",
"libs/core---esp32",
"libs/core---esp32s2",
"libs/screen---st7735",
"libs/pulse",
"libs/infrared",
"libs/game",
"libs/game---light",
"libs/mixer",
"libs/mixer---none",
"libs/mixer---samd",
"libs/mixer---stm32",
"libs/mixer---nrf52",
"libs/mixer---rp2040",
"libs/pixel",
"libs/buttons",
"libs/touch",
"libs/light",
"libs/tests",
"libs/gamepad",
"libs/mouse",
"libs/keyboard",
"libs/display",
"libs/servo",
"libs/storage",
"libs/serial",
"libs/datalogger",
"libs/lightsensor",
"libs/thermometer",
"libs/switch",
"libs/accelerometer",
"libs/microphone",
"libs/lora",
"libs/power",
"libs/lcd",
"libs/color",
"libs/color-sensor",
"libs/light-spectrum-sensor",
"libs/proximity",
"libs/feather",
"libs/edge-connector",
"libs/esp32",
"libs/net",
"libs/net-game",
"libs/wifi---esp32",
"libs/mqtt",
"libs/azureiot",
"libs/settings",
"libs/settings---esp32",
"libs/settings---files",
"libs/radio",
"libs/radio-broadcast",
"libs/matrix-keypad",
"libs/adafruit-feather-m0-express",
"libs/adafruit-feather-m4-express",
"libs/adafruit-feather-nrf52840-express",
"libs/nucleo-f411re",
"libs/adafruit-circuit-playground-express",
"libs/adafruit-circuit-playground-bluefruit",
"libs/adafruit-trinket-m0",
"libs/adafruit-metro-m0-express",
"libs/adafruit-metro-m4-express",
"libs/adafruit-itsybitsy-m0-express",
"libs/adafruit-itsybitsy-m4-express",
"libs/adafruit-itsybitsy-nrf52840-express",
"libs/adafruit-neotrellis-m4-express",
"libs/adafruit-gemma-m0",
"libs/robotics-masters-robohatmm1-m4",
"libs/adafruit-grand-central-m4-express",
"libs/xinabox-cc03",
"libs/xinabox-cs11",
"libs/arduino-zero",
"libs/arduino-mkr1000",
"libs/arduino-mkr1010",
"libs/arduino-mkr1300",
"libs/arduino-nano-33-ble-sense",
"libs/electroniccats-meow-meow",
"libs/electroniccats-escornabot-makech",
"libs/sparkfun-samd21-dev-breakout",
"libs/sparkfun-samd21-mini-breakout",
"libs/sparkfun-redboard-turbo",
"libs/sparkfun-lumidrive",
"libs/brain-nrf52840",
"libs/stitchkit",
"libs/machachi",
"libs/espressif-esp32-devkit-c",
"libs/rpi-pico",
"libs/jacdac-nrfbrain",
"libs/jacdac-brain-f4",
"libs/jacdac-brain-rp2040",
"libs/jacdac-iot-s2"
],
"serial": {
"useHF2": true,
"useEditor": true,
"log": true,
"editorTheme": {
"graphBackground": "#d9d9d9",
"lineColors": [
"#CC2936",
"#FFC914",
"#2EB7ED",
"#FB48C7",
"#08415C",
"#C200C0"
]
}
},
"simulator": {
"autoRun": true,
"streams": false,
"aspectRatio": 1,
"parts": true,
"partsAspectRatio": 0.69,
"dynamicBoardDefinition": true,
"messageSimulators": {
"jacdac": {
"url": "https://microsoft.github.io/jacdac-docs/tools/makecode-sim?webusb=0&parentOrigin=$PARENT_ORIGIN$",
"localHostUrl": "http://localhost:8000/tools/makecode-sim?webusb=0&parentOrigin=$PARENT_ORIGIN$",
"aspectRatio": 0.89,
"permanent": true
}
}
},
"cloud": {
"workspace": false,
"packages": true,
"sharing": true,
"thumbnails": true,
"publishing": true,
"importing": true,
"preferredPackages": [],
"githubPackages": true,
"cloudProviders": {
"github": {}
}
},
"runtime": {
"mathBlocks": true,
"loopsBlocks": true,
"logicBlocks": true,
"variablesBlocks": true,
"textBlocks": true,
"listsBlocks": true,
"functionBlocks": true,
"functionsOptions": {
"useNewFunctions": true,
"extraFunctionEditorTypes": []
},
"onStartNamespace": "loops",
"onStartColor": "#40bf4a",
"onStartWeight": 100,
"pauseUntilBlock": {},
"breakBlock": true,
"continueBlock": true,
"palette": [
"#000000",
"#ffffff",
"#ff2121",
"#ff93c4",
"#ff8135",
"#fff609",
"#249ca3",
"#78dc52",
"#003fad",
"#87f2ff",
"#8e2ec4",
"#a4839f",
"#5c406c",
"#e5cdc4",
"#91463d",
"#000000"
],
"screenSize": {
"width": 160,
"height": 120
}
},
"compile": {
"isNative": true,
"useUF2": true,
"webUSB": true,
"hasHex": true,
"saveAsPNG": true,
"deployDrives": ".*",
"deployFileMarker": "INFO_UF2.TXT",
"driveName": "DRIVE",
"openocdScript": "source [find interface/cmsis-dap.cfg]; set CHIPNAME at91samd21g18; source [find target/at91samdXX.cfg]",
"flashChecksumAddr": 8372,
"flashCodeAlign": 256,
"upgrades": [
{
"type": "package",
"map": {
"circuit-playground": "adafruit-circuit-playground"
}
}
],
"patches": {
"0.0.0 - 0.6.8": [
{
"type": "package",
"map": {
"arduino-mkr": "arduino-mkr1000"
}
}
]
},
"nativeType": "thumb",
"switches": {},
"jsRefCounting": false,
"utf8": true
},
"compileService": {
"buildEngine": "codal",
"codalTarget": {
"name": "missing",
"url": "https://github.com/microsoft/pxt-does-not-exist",
"branch": "v0",
"type": "git"
},
"codalBinary": "CIRCUIT_PLAYGROUND",
"yottaConfig": {
"pxt": {
"board": {
"id": "BOARD_ID_CPLAY"
}
}
},
"githubCorePackage": "lancaster-university/codal",
"gittag": "v0.9.0",
"serviceId": "codal2cp",
"dockerImage": "pext/yotta:latest"
},
"variants": {
"samd51": {
"compile": {
"hasHex": true,
"openocdScript": "source [find interface/cmsis-dap.cfg]; set CHIPNAME at91samd51g19; source [find target/atsame5x.cfg]",
"openocdScriptAlt": "source [find interface/stlink-v2.cfg]; set CPUTAPID 0x2ba01477; set CHIPNAME at91samd51g19; source [find target/at91samdXX.cfg]",
"ramSize": 196608,
"flashEnd": 524288,
"uf2Family": "0x55114460"
},
"compileService": {
"codalTarget": {
"name": "codal-itsybitsy-m4",
"url": "https://github.com/lancaster-university/codal-itsybitsy-m4",
"branch": "v0.2.7",
"type": "git"
},
"codalBinary": "ITSYBITSY_M4",
"serviceId": "codal2samd51"
}
},
"nrf52840": {
"serial": {
"useHF2": false
},
"compile": {
"openocdScript": "source [find interface/cmsis-dap.cfg]; source [find target/nrf52.cfg]",
"flashChecksumAddr": 0,
"webUSB": false,
"flashEnd": 1007616,
"uf2Family": "0xada52840"
},
"compileService": {
"codalTarget": {
"name": "codal-nrf52840-dk",
"url": "https://github.com/mmoskal/codal-nrf52840-dk",
"branch": "v1.1.8",
"type": "git"
},
"codalBinary": "NRF52840_DK",
"serviceId": "codal2nrf52840",
"dockerImage": "pext/yotta:latest",
"yottaConfig": {
"pxt": {
"board": {
"id": "BOARD_ID_NRF52840"
}
}
}
}
},
"nrf52833": {
"serial": {
"useHF2": true
},
"compile": {
"openocdScript": "source [find interface/cmsis-dap.cfg]; source [find target/nrf52.cfg]",
"flashChecksumAddr": 0,
"webUSB": true,
"flashEnd": 475136,
"uf2Family": "0xada52840"
},
"compileService": {
"codalTarget": {
"name": "codal-makeable",
"url": "https://github.com/jamesadevine/codal-makeable",
"branch": "v0.0.8",
"type": "git"
},
"codalBinary": "NRF52",
"serviceId": "codal2nrf52",
"dockerImage": "pext/yotta:latest",
"yottaConfig": {
"pxt": {
"board": {
"id": "BOARD_ID_NRF52833"
}
}
}
}
},
"stm32f103": {
"compile": {
"hasHex": true,
"openocdScript": "source [find interface/stlink-v2.cfg]; source [find target/stm32f1x.cfg]",
"uf2Family": "0x5ee21072",
"webUSB": false,
"flashChecksumAddr": 0,
"utf8": true
},
"compileService": {
"codalTarget": {
"name": "codal-jacdac-feather",
"url": "https://github.com/lancaster-university/codal-jacdac-feather",
"branch": "v1.1.2",
"type": "git"
},
"codalBinary": "STM32",
"serviceId": "codal2stm32",
"dockerImage": "pext/yotta:latest"
}
},
"stm32f401": {
"compile": {
"hasHex": true,
"openocdScript": "source [find interface/cmsis-dap.cfg]; source [find target/stm32f4x.cfg]",
"flashChecksumAddr": 0,
"flashEnd": 524288,
"uf2Family": "0x57755a57"
},
"compileService": {
"codalTarget": {
"name": "codal-big-brainpad",
"url": "https://github.com/lancaster-university/codal-big-brainpad",
"branch": "v1.3.4",
"type": "git"
},
"codalBinary": "STM32",
"serviceId": "codal2stm32",
"dockerImage": "pext/yotta:latest"
}
},
"samd21": {
"compile": {
"hasHex": true,
"openocdScript": "source [find interface/cmsis-dap.cfg]; set CHIPNAME at91samd21g18; source [find target/at91samdXX.cfg]",
"openocdScriptAlt": "source [find interface/stlink-v2.cfg]; set CPUTAPID 0x0bc11477; set CHIPNAME at91samd21g18; source [find target/at91samdXX.cfg]",
"flashEnd": 262144,
"uf2Family": "0x68ed2b88"
},
"compileService": {
"codalTarget": {
"name": "codal-circuit-playground",
"url": "https://github.com/lancaster-university/codal-circuit-playground",
"branch": "v2.0.4",
"type": "git"
},
"dockerImage": "pext/yotta:latest",
"codalBinary": "CIRCUIT_PLAYGROUND"
}
},
"esp32": {
"compile": {
"hasHex": true,
"useESP": true,
"useUF2": false,
"flashCodeAlign": 256,
"webUSB": false,
"nativeType": "vm",
"stackAlign": 2
},
"compileService": {
"buildEngine": "dockerespidf",
"dockerImage": "pext/esp:latest",
"dockerArgs": [],
"serviceId": "espidf"
}
},
"esp32s2": {
"compile": {
"hasHex": true,
"useESP": true,
"useUF2": true,
"flashCodeAlign": 256,
"webUSB": false,
"nativeType": "vm",
"uf2Family": "0xbfdd4eee",
"stackAlign": 2
},
"compileService": {
"buildEngine": "dockerespidf",
"dockerImage": "pext/esp:latest",
"dockerArgs": [],
"serviceId": "espidf"
}
},
"rp2040": {
"compile": {
"hasHex": true,
"openocdScript": "???",
"flashChecksumAddr": 0,
"flashEnd": 2097152,
"uf2Family": "0xe48bff56"
},
"compileService": {
"codalTarget": {
"name": "codal-pi-pico",
"url": "https://github.com/lancaster-university/codal-pi-pico",
"branch": "v0.0.10",
"type": "git"
},
"codalBinary": "PI-PICO",
"serviceId": "codal2pico",
"dockerImage": "pext/arm:gcc9"
}
}
},
"appTheme": {
"accentColor": "#ecf0f1",
"backgroundColor": "#ffffff",
"logoUrl": "https://github.com/microsoft/pxt-maker",
"logo": "@cdnUrl@/blob/78e4304c9678839a1c6e673528aa200003065f40/static/logo.svg",
"docsLogo": "@cdnUrl@/blob/78e4304c9678839a1c6e673528aa200003065f40/static/logo.svg",
"docsHeader": "Microsoft MakeCode Maker",
"portraitLogo": "@cdnUrl@/blob/78e4304c9678839a1c6e673528aa200003065f40/static/logo.svg",
"footerLogo": "@cdnUrl@/blob/78e4304c9678839a1c6e673528aa200003065f40/static/logo.svg",
"organization": "Microsoft MakeCode",
"organizationUrl": "https://makecode.com/",
"organizationLogo": "@cdnUrl@/blob/e6a56b2e978a522726c938cad286bf3d15aa7b51/static/Microsoft-logo_rgb_c-gray-square.png",
"organizationWideLogo": "@cdnUrl@/blob/cd1a7c2065a8aae2437d49888f9a7f35d77932d8/static/Microsoft-logo_rgb_c-gray.png",
"homeUrl": "https://maker.makecode.com/",
"embedUrl": "https://maker.makecode.com/",
"privacyUrl": "https://go.microsoft.com/fwlink/?LinkId=521839",
"termsOfUseUrl": "https://go.microsoft.com/fwlink/?LinkID=206977",
"githubUrl": "https://github.com/microsoft/pxt-maker",
"feedbackUrl": "https://forum.makecode.com/",
"betaUrl": "https://github.com/microsoft/pxt-maker",
"boardName": "board",
"homeScreenHero": "@cdnUrl@/blob/4fe4d3e3fc36749019b929a071ad2015815550b9/static/hero.jpg",
"debugger": true,
"print": true,
"chooseBoardOnNewProject": true,
"lightToc": true,
"instructions": true,
"docMenu": [
{
"name": "About",
"path": "/about"
},
{
"name": "Forum",
"path": "https://forum.makecode.com"
},
{
"name": "Boards",
"path": "/boards"
},
{
"name": "Blocks",
"path": "/blocks"
},
{
"name": "JavaScript",
"path": "/javascript"
},
{
"name": "Reference",
"path": "/reference"
},
{
"name": "GitHub",
"path": "https://github.com/microsoft/pxt-maker"
}
],
"invertedMenu": false,
"invertedToolbox": false,
"invertedMonaco": false,
"monacoToolbox": true,
"highContrast": true,
"greenScreen": true,
"blocksCollapsing": true,
"accessibleBlocks": true,
"simAnimationEnter": "fly right in",
"simAnimationExit": "fly right out",
"hasAudio": true,
"usbDocs": "/device/usb",
"disableBlockIcons": true,
"disableAPICache": true,
"blocklyOptions": {
"grid": {
"spacing": 20,
"length": 2,
"colour": "rgba(189, 195, 199, 0.20)",
"snap": true
}
},
"blockColors": {
"loops": "#40bf4a",
"logic": "#4cbfe6",
"math": "#9966ff",
"variables": "#FF6680",
"text": "#ffab19",
"advanced": "#00272B",
"functions": "#005a9e",
"arrays": "#8A1C7C"
},
"allowPackageExtensions": true,
"scriptManager": true,
"simScreenshot": true,
"simGif": true,
"qrCode": true,
"python": true,
"pythonToolbox": true,
"addNewTypeScriptFile": true,
"alwaysGithubItemBlocks": true,
"alwaysGithubItem": true,
"githubBlocksDiff": true,
"nameProjectFirst": true,
"showProjectSettings": true,
"selectLanguage": false,
"githubEditor": true,
"tutorialBlocksDiff": true,
"tutorialExplicitHints": true,
"chooseLanguageRestrictionOnNewProject": true,
"openProjectNewTab": true,
"errorList": true,
"TOC": [
{
"name": "About",
"path": "/about",
"subitems": []
},
{
"name": "FAQ",
"path": "/faq",
"subitems": []
},
{
"name": "Projects",
"path": "/projects",
"subitems": []
},
{
"name": "GitHub",
"path": "/github",
"subitems": []
},
{
"name": "Reference",
"path": "/reference",
"subitems": [
{
"name": "music",
"path": "/reference/music",
"subitems": []
},
{
"name": "pins",
"path": "/reference/pins",
"subitems": []
},
{
"name": "control",
"path": "/reference/control",
"subitems": []
},
{
"name": "serial",
"path": "/reference/serial",
"subitems": []
}
]
},
{
"name": "Blocks",
"path": "/blocks",
"subitems": [
{
"name": "On Start",
"path": "/blocks/on-start",
"subitems": []
},
{
"name": "Loops",
"path": "/blocks/loops",
"subitems": [
{
"name": "repeat",
"path": "/blocks/loops/repeat",
"subitems": []
},
{
"name": "for",
"path": "/blocks/loops/for",
"subitems": []
},
{
"name": "while",
"path": "/blocks/loops/while",
"subitems": []
},
{
"name": "for of",
"path": "/blocks/loops/for-of",
"subitems": []
}
]
},
{
"name": "Logic",
"path": "/blocks/logic",
"subitems": [
{
"name": "if",
"path": "/blocks/logic/if",
"subitems": []
},
{
"name": "Boolean",
"path": "/blocks/logic/boolean",
"subitems": []
}
]
},
{
"name": "Variables",
"path": "/blocks/variables",
"subitems": [
{
"name": "assign",
"path": "/blocks/variables/assign",
"subitems": []
},
{
"name": "change var",
"path": "/blocks/variables/change",
"subitems": []
},
{
"name": "var",
"path": "/blocks/variables/var",
"subitems": []
}
]
},
{
"name": "Math",
"path": "/blocks/math",
"subitems": []
},
{
"name": "JavaScript blocks",
"path": "/blocks/javascript-blocks",
"subitems": []
},
{
"name": "Custom blocks",
"path": "/blocks/custom",
"subitems": []
}
]
},
{
"name": "Python",
"path": "/python",
"subitems": [
{
"name": "Calling",
"path": "/python/call",
"subitems": []
},
{
"name": "Sequencing",
"path": "/python/sequence",
"subitems": []
},
{
"name": "Variables",
"path": "/python/variables",
"subitems": []
},
{
"name": "Operators",
"path": "/python/operators",
"subitems": []
},
{
"name": "Statements",
"path": "/python/statements",
"subitems": []
},
{
"name": "Functions",
"path": "/python/functions",
"subitems": []
},
{
"name": "Classes",
"path": "/python/classes",
"subitems": []
}
]
},
{
"name": "JavaScript",
"path": "/javascript",
"subitems": [
{
"name": "Calling",
"path": "/javascript/call",
"subitems": []
},
{
"name": "Sequencing",
"path": "/javascript/sequence",
"subitems": []
},
{
"name": "Variables",
"path": "/javascript/variables",
"subitems": []
},
{
"name": "Operators",
"path": "/javascript/operators",
"subitems": []
},
{
"name": "Statements",
"path": "/javascript/statements",
"subitems": []
},
{
"name": "Functions",
"path": "/javascript/functions",
"subitems": []
},
{
"name": "Types",
"path": "/javascript/types",
"subitems": []
},
{
"name": "Classes",
"path": "/javascript/classes",
"subitems": []
},
{
"name": "Interfaces",
"path": "/javascript/interfaces",
"subitems": []
},
{
"name": "Generics",
"path": "/javascript/generics",
"subitems": []
}
]
},
{
"name": "Types",
"path": "/types",
"subitems": [
{
"name": "Number",
"path": "/types/number",
"subitems": []
},
{
"name": "String",
"path": "/types/string",
"subitems": []
},
{
"name": "Boolean",
"path": "/types/boolean",
"subitems": []
},
{
"name": "Array",
"path": "/types/array",
"subitems": []
},
{
"name": "Function",
"path": "/types/function",
"subitems": []
}
]
},
{
"name": "Miscellaneous",
"path": "",
"subitems": [
{
"name": "About",
"path": "/about",
"subitems": []
},
{
"name": "Support",
"path": "/support",
"subitems": []
},
{
"name": "Translate",
"path": "/translate",
"subitems": []
},
{
"name": "Sharing projects",
"path": "/share",
"subitems": []
},
{
"name": "Offline support",
"path": "/offline",
"subitems": []
},
{
"name": "Save",
"path": "/save",
"subitems": []
}
]
},
{
"name": "Developers",
"path": "",
"subitems": [
{
"name": "Command Line Interface",
"path": "/cli",
"subitems": []
},
{
"name": "Visual Studio Code support",
"path": "/code",
"subitems": []
},
{
"name": "Blocks Embed",
"path": "/blocks-embed",
"subitems": []
}
]
}
],
"id": "maker",
"title": "MakeCode Maker - Blocks / Javascript editor",
"name": "MakeCode Maker (Cortex class)",
"description": "A Blocks / JavaScript code editor for MakeCode Maker Boards",
"htmlDocIncludes": {}
},
"ignoreDocsErrors": true,
"uploadDocs": false,
"versions": {
"branch": "v0.15.66",
"tag": "v0.15.66",
"commits": "https://github.com/microsoft/pxt-maker/commits/1439f19f93e7699d21b816a9b7ed60840b0d3924",
"target": "0.15.66",
"pxt": "8.1.1"
},
"blocksprj": {
"id": "blocksprj",
"config": {
"name": "{0}",
"dependencies": {
"adafruit-metro-m0-express": "*"
},
"description": "",
"files": [
"main.blocks",
"main.ts",
"README.md"
],
"additionalFilePaths": []
},
"files": {
"README.md": "",
"main.blocks": "\n \n \n",
"main.ts": "\n"
}
},
"tsprj": {
"id": "tsprj",
"config": {
"name": "{0}",
"dependencies": {
"adafruit-metro-m0-express": "*"
},
"description": "",
"files": [
"main.ts",
"README.md"
],
"additionalFilePaths": []
},
"files": {
"README.md": "",
"main.ts": "\n"
}
},
"bundledpkgs": {
"base": {
"README.md": "# base\n\nThe base library, shared by all C++ targets (not only Codal-based).\n\n\n",
"advmath.cpp": "#include \"pxtbase.h\"\n\nusing namespace std;\n\n#define SINGLE(op) return fromDouble(::op(toDouble(x)));\n\nnamespace Math_ {\n\n//%\nTNumber log2(TNumber x){SINGLE(log2)}\n//%\nTNumber exp(TNumber x){SINGLE(exp)}\n//%\nTNumber tanh(TNumber x){SINGLE(tanh)}\n//%\nTNumber sinh(TNumber x){SINGLE(sinh)}\n//%\nTNumber cosh(TNumber x){SINGLE(cosh)}\n//%\nTNumber atanh(TNumber x){SINGLE(atanh)}\n//%\nTNumber asinh(TNumber x){SINGLE(asinh)}\n//%\nTNumber acosh(TNumber x){SINGLE(acosh)}\n\n}",
"buffer.cpp": "#include \"pxtbase.h\"\n#include \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",
"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",
"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",
"console.ts": "/// \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 //% whenUsed\n const listeners: Listener[] = [\n function (priority: ConsolePriority, text: string) { control.__log(priority, text); }\n ];\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 // send to 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 //% blockId=console_log block=\"console log $value\"\n //% value.shadow=text\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 //% blockId=console_log_value block=\"console|log value %name|= %value\"\n //% name.shadow=text\n //% value.shadow=math_number\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);\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 `{${\n 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 (!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) return;\n const i = listeners.indexOf(listener);\n if (i > -1)\n listeners.splice(i, 1);\n }\n}",
"control.cpp": "#include \"pxtbase.h\"\n\n\nnamespace control {\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 current_time_ms();\n }\n\n /**\n * Gets current time in microseconds. Overflows every ~18 minutes.\n */\n //%\n int micros() {\n return current_time_us() & 0x3fffffff;\n }\n\n /**\n * Used internally\n */\n //%\n void internalOnEvent(int src, int value, Action handler, int flags = 16) {\n registerWithDal(src, value, handler, flags);\n }\n\n /**\n * Reset the device.\n */\n //% weight=30 async help=control/reset blockGap=8\n //% blockId=\"control_reset\" block=\"reset\"\n void reset() {\n target_reset();\n }\n\n /**\n * Block 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 void waitMicros(int micros) {\n sleep_us(micros);\n }\n\n /**\n * Run other code in the parallel.\n */\n //% help=control/run-in-parallel handlerStatement=1\n //% blockId=\"control_run_in_parallel\" block=\"run in parallel\" blockGap=8\n void runInParallel(Action a) {\n pxt::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 * 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 int deviceSerialNumber() {\n uint64_t serial_num = pxt::getLongSerialNumber();\n return hash_fnv1(&serial_num, sizeof(serial_num)) & 0x3fffffff;\n }\n\n /**\n * Derive a unique, consistent 64-bit serial number of this device from internal data.\n */\n //% blockId=\"control_device_long_serial_number\" block=\"device long serial number\" weight=9\n //% help=control/device-long-serial-number\n Buffer deviceLongSerialNumber() {\n uint64_t serial_num = pxt::getLongSerialNumber();\n return mkBuffer((uint8_t*)&serial_num, sizeof(uint64_t));\n }\n\n /**\n *\n */\n //%\n void __log(int prority, String text) {\n if (NULL == text) return;\n pxt::sendSerial(text->getUTF8Data(), text->getUTF8Size());\n }\n\n /**\n * Dump internal information about a value.\n */\n //%\n void dmesgValue(TValue v) {\n anyPrint(v);\n }\n}\n",
"control.ts": "/**\n* Program controls and events.\n*/\n//% weight=90 color=\"#FF5722\" icon=\"\\uf110\" advanced=true\nnamespace control {\n /**\n * Deprecated, use ``control.runInParallel`` instead.\n */\n //% deprecated=1 hidden=1 help=control/run-in-background blockAllowMultiple=1 afterOnStart=true\n //% blockId=\"control_run_in_background\" block=\"run in background\" blockGap=8 weight=0\n export function runInBackground(a: () => void) {\n control.runInParallel(a);\n }\n\n export const enum PXT_PANIC {\n CODAL_OOM = 20,\n GC_OOM = 21,\n GC_TOO_BIG_ALLOCATION = 22,\n CODAL_HEAP_ERROR = 30,\n CODAL_NULL_DEREFERENCE = 40,\n CODAL_USB_ERROR = 50,\n CODAL_HARDWARE_CONFIGURATION_ERROR = 90,\n\n INVALID_BINARY_HEADER = 901,\n OUT_OF_BOUNDS = 902,\n REF_DELETED = 903,\n SIZE = 904,\n INVALID_VTABLE = 905,\n INTERNAL_ERROR = 906,\n NO_SUCH_CONFIG = 907,\n NO_SUCH_PIN = 908,\n INVALID_ARGUMENT = 909,\n MEMORY_LIMIT_EXCEEDED = 910,\n SCREEN_ERROR = 911,\n MISSING_PROPERTY = 912,\n INVALID_IMAGE = 913,\n CALLED_FROM_ISR = 914,\n HEAP_DUMPED = 915,\n STACK_OVERFLOW = 916,\n BLOCKING_TO_STRING = 917,\n VM_ERROR = 918,\n SETTINGS_CLEARED = 920,\n SETTINGS_OVERLOAD = 921,\n SETTINGS_SECRET_MISSING = 922,\n DELETE_ON_CLASS = 923,\n\n CAST_FIRST = 980,\n CAST_FROM_UNDEFINED = 980,\n CAST_FROM_BOOLEAN = 981,\n CAST_FROM_NUMBER = 982,\n CAST_FROM_STRING = 983,\n CAST_FROM_OBJECT = 984,\n CAST_FROM_FUNCTION = 985,\n CAST_FROM_NULL = 989,\n\n UNHANDLED_EXCEPTION = 999,\n }\n /**\n * Display an error code and stop the program.\n * @param code an error number to display. eg: 5\n */\n //% help=control/panic weight=29\n //% blockId=\"control_panic\" block=\"panic %code\"\n //% shim=pxtrt::panic\n export function panic(code: number) { }\n\n /**\n * Display an error code and stop the program when the assertion is `false`.\n */\n //% help=control/assert weight=30\n //% blockId=\"control_assert\" block=\"assert %cond|with value %code\"\n export function assert(cond: boolean, code: number) {\n if (!cond) {\n fail(\"Assertion failed, code=\" + code)\n }\n }\n\n export function fail(message: string) {\n console.log(\"Fatal failure: \")\n console.log(message)\n dmesg(message)\n panic(108)\n }\n\n let _evSource = 0x8000\n export function allocateEventSource() {\n return ++_evSource\n }\n\n export class AnimationQueue {\n running: boolean;\n eventID: number;\n public interval: number;\n\n constructor() {\n this.running = false;\n this.eventID = control.allocateNotifyEvent();\n this.interval = 1;\n }\n\n /**\n * Runs 'render' in a loop until it returns false or the 'stop' function is called\n */\n runUntilDone(render: () => boolean) {\n const evid = this.eventID;\n\n // if other animation, wait for turn\n if (this.running)\n control.waitForEvent(DAL.DEVICE_ID_NOTIFY, evid);\n\n // check if the animation hasn't been cancelled since we've waiting\n if (this.isCancelled(evid))\n return;\n\n // run animation\n this.running = true;\n while (this.running\n && !this.isCancelled(evid)\n && render()) {\n pause(this.interval);\n }\n\n // check if the animation hasn't been cancelled since we've been waiting\n if (this.isCancelled(evid))\n return;\n\n // we're done\n this.running = false;\n // unblock 1 fiber\n control.raiseEvent(DAL.DEVICE_ID_NOTIFY_ONE, this.eventID);\n }\n\n isCancelled(evid: number) {\n return this.eventID !== evid;\n }\n\n /**\n * Cancels the current running animation and clears the queue\n */\n cancel() {\n if (this.running) {\n this.running = false;\n const evid = this.eventID;\n this.eventID = control.allocateNotifyEvent();\n // unblock fibers\n control.raiseEvent(DAL.DEVICE_ID_NOTIFY, evid);\n }\n }\n }\n\n //% shim=pxt::getConfig\n export declare function getConfigValue(key: int32, defl: int32): number;\n\n //% shim=pxt::programHash\n export declare function programHash(): number;\n\n //% shim=pxt::programName\n export declare function programName(): string;\n\n //% shim=control::_ramSize\n function _ramSize() {\n return 32 * 1024 * 1024;\n }\n\n /** Returns estimated size of memory in bytes. */\n export function ramSize() {\n return getConfigValue(DAL.CFG_RAM_BYTES, 0) || _ramSize();\n }\n\n /** Runs the function and returns run time in microseconds. */\n export function benchmark(f: () => void) {\n const t0 = micros()\n f()\n let t = micros() - t0\n if (t < 0)\n t += 0x3fffffff\n return t\n }\n}\n\n/**\n * Convert any value to text\n * @param value value to be converted to text\n */\n//% help=text/convert-to-text weight=1\n//% block=\"convert $value=math_number to text\"\n//% blockId=variable_to_text blockNamespace=\"text\"\nfunction convertToText(value: any): string {\n return \"\" + value;\n}\n",
"controlgc.cpp": "#include \"pxtbase.h\"\n\n\nnamespace control {\n /**\n * Force GC and dump basic information about heap.\n */\n //%\n void gc() {\n pxt::gc(1);\n }\n\n /**\n * Force GC and halt waiting for debugger to do a full heap dump.\n */\n //%\n void heapDump() {\n pxt::gc(2);\n soft_panic(PANIC_HEAP_DUMPED);\n }\n\n\n /**\n * Set flags used when connecting an external debugger.\n */\n //%\n void setDebugFlags(int flags) {\n debugFlags = flags;\n }\n\n /**\n * Record a heap snapshot to debug memory leaks.\n */\n //%\n void heapSnapshot() {\n // only in JS backend for now\n }\n\n /**\n * Return true if profiling is enabled in the current build.\n */\n //%\n bool profilingEnabled() {\n#ifdef PXT_PROFILE\n return true;\n#else\n return false;\n#endif\n }\n}\n",
"controlmessage.ts": "namespace control.simmessages {\n // these events are raised by JS simulator when messages come in\n export const CONTROL_MESSAGE_EVT_ID = 2999;\n export const CONTROL_MESSAGE_RECEIVED = 1;\n\n //% shim=pxt::sendMessage\n export declare function send(channel: string, message: Buffer, parentOnly?: boolean) : void;\n\n //% shim=pxt::peekMessageChannel\n declare function peekMessageChannel(): string;\n\n //% shim=pxt::readMessageData\n declare function readMessageData(): Buffer;\n\n let handlers: { [channel: string] : (msg: Buffer) => void}\n function consumeMessages() {\n while(true) {\n // peek channel of next message\n const channel = peekMessageChannel();\n if (!channel) break;\n // read next message\n const msg = readMessageData();\n // send to handler\n const handler = handlers && handlers[channel];\n if (handler)\n handler(msg);\n }\n }\n\n /**\n * Registers the handler for a message on a given channel\n **/\n export function onReceived(channel: string, handler: (msg: Buffer) => void) {\n if (!channel) return;\n\n if (!handlers)\n handlers = {};\n handlers[channel] = handler;\n control.onEvent(CONTROL_MESSAGE_EVT_ID, CONTROL_MESSAGE_RECEIVED, consumeMessages);\n }\n}",
"core.cpp": "#include \"pxtbase.h\"\n#include \n#include \n\nusing namespace std;\n\n#define p10(v) __builtin_powi(10, v)\n\n// try not to create cons-strings shorter than this\n#define SHORT_CONCAT_STRING 50\n\nnamespace pxt {\n\nPXT_DEF_STRING(emptyString, \"\")\n\nstatic HandlerBinding *handlerBindings;\n\nHandlerBinding *nextBinding(HandlerBinding *curr, int source, int value) {\n for (auto p = curr; p; p = p->next) {\n // DEVICE_ID_ANY == DEVICE_EXT_ANY == 0\n if ((p->source == source || p->source == 0) &&\n (value == -1 || p->value == value || p->value == 0)) {\n return p;\n }\n }\n return 0;\n}\n\nHandlerBinding *findBinding(int source, int value) {\n return nextBinding(handlerBindings, source, value);\n}\n\nvoid setBinding(int source, int value, Action act) {\n HandlerBinding *curr = NULL;\n for (auto p = handlerBindings; p; p = p->next) {\n if ((p->source == source) && (p->value == value)) {\n curr = p;\n break;\n }\n }\n if (curr) {\n curr->action = act;\n return;\n }\n curr = new (app_alloc(sizeof(HandlerBinding))) HandlerBinding();\n curr->next = handlerBindings;\n curr->source = source;\n curr->value = value;\n curr->action = act;\n registerGC(&curr->action);\n handlerBindings = curr;\n}\n\nvoid coreReset() {\n // these are allocated on GC heap, so they will go away together with the reset\n handlerBindings = NULL;\n}\n\nstruct EmptyBufferLayout {\n const void *vtable;\n // data needs to be word-aligned, so we use 32 bits for length\n int length;\n uint8_t data[1];\n};\n\nstatic const EmptyBufferLayout emptyBuffer[1] = {{&pxt::buffer_vt, 0, {0}}};\n\n#if PXT_UTF8\nint utf8Len(const char *data, int size) {\n int len = 0;\n for (int i = 0; i < size; ++i) {\n char c = data[i];\n len++;\n if ((c & 0x80) == 0x00) {\n // skip\n } else if ((c & 0xe0) == 0xc0) {\n i++;\n } else if ((c & 0xf0) == 0xe0) {\n i += 2;\n } else {\n // error; just skip\n }\n }\n return len;\n}\n\nconst char *utf8Skip(const char *data, int size, int skip) {\n int len = 0;\n for (int i = 0; i <= size; ++i) {\n char c = data[i];\n len++;\n if (len > skip)\n return data + i;\n if ((c & 0x80) == 0x00) {\n // skip\n } else if ((c & 0xe0) == 0xc0) {\n i++;\n } else if ((c & 0xf0) == 0xe0) {\n i += 2;\n } else {\n // error; just skip over\n }\n }\n return NULL;\n}\n\nstatic char *write3byte(char *dst, uint32_t charCode) {\n if (dst) {\n *dst++ = 0xe0 | (charCode >> 12);\n *dst++ = 0x80 | (0x3f & (charCode >> 6));\n *dst++ = 0x80 | (0x3f & (charCode >> 0));\n }\n return dst;\n}\n\nstatic char *write2byte(char *dst, uint32_t charCode) {\n if (dst) {\n *dst++ = 0xc0 | (charCode >> 6);\n *dst++ = 0x80 | (0x3f & charCode);\n }\n return dst;\n}\n\nstatic int utf8canon(char *dst, const char *data, int size) {\n int outsz = 0;\n for (int i = 0; i < size;) {\n uint8_t c = data[i];\n uint32_t charCode = c;\n if ((c & 0x80) == 0x00) {\n charCode = c;\n i++;\n } else if ((c & 0xe0) == 0xc0 && i + 1 < size && (data[i + 1] & 0xc0) == 0x80) {\n charCode = ((c & 0x1f) << 6) | (data[i + 1] & 0x3f);\n if (charCode < 0x80)\n goto error;\n else\n i += 2;\n } else if ((c & 0xf0) == 0xe0 && i + 2 < size && (data[i + 1] & 0xc0) == 0x80 &&\n (data[i + 2] & 0xc0) == 0x80) {\n charCode = ((c & 0x0f) << 12) | (data[i + 1] & 0x3f) << 6 | (data[i + 2] & 0x3f);\n // don't exclude surrogate pairs, since we're generating them\n if (charCode < 0x800 /*|| (0xd800 <= charCode && charCode <= 0xdfff)*/)\n goto error;\n else\n i += 3;\n } else if ((c & 0xf8) == 0xf0 && i + 3 < size && (data[i + 1] & 0xc0) == 0x80 &&\n (data[i + 2] & 0xc0) == 0x80 && (data[i + 3] & 0xc0) == 0x80) {\n charCode = ((c & 0x07) << 18) | (data[i + 1] & 0x3f) << 12 | (data[i + 2] & 0x3f) << 6 |\n (data[i + 3] & 0x3f);\n if (charCode < 0x10000 || charCode > 0x10ffff)\n goto error;\n else\n i += 4;\n } else {\n goto error;\n }\n\n if (charCode < 0x80) {\n outsz += 1;\n if (dst)\n *dst++ = charCode;\n } else if (charCode < 0x800) {\n outsz += 2;\n dst = write2byte(dst, charCode);\n } else if (charCode < 0x10000) {\n outsz += 3;\n dst = write3byte(dst, charCode);\n } else {\n outsz += 6; // a surrogate pair\n charCode -= 0x10000;\n dst = write3byte(dst, 0xd800 + (charCode >> 10));\n dst = write3byte(dst, 0xdc00 + (charCode & 0x3ff));\n }\n\n continue;\n\n error:\n i++;\n outsz += 2;\n dst = write2byte(dst, c);\n }\n return outsz;\n}\n\nstatic int utf8CharCode(const char *data) {\n unsigned char c = *data;\n if ((c & 0x80) == 0) {\n return c;\n } else if ((c & 0xe0) == 0xc0) {\n return ((c & 0x1f) << 6) | (data[1] & 0x3f);\n } else if ((c & 0xf0) == 0xe0) {\n return ((c & 0x0f) << 12) | (data[1] & 0x3f) << 6 | (data[2] & 0x3f);\n } else {\n return c; // error\n }\n}\n\nstatic bool isUTF8(const char *data, int len) {\n for (int i = 0; i < len; ++i) {\n if (data[i] & 0x80)\n return true;\n }\n return false;\n}\n\nstatic void setupSkipList(String r, const char *data, int packed) {\n char *dst = (char *)(packed ? PXT_SKIP_DATA_PACK(r) : PXT_SKIP_DATA_IND(r));\n auto len = r->skip.size;\n if (data)\n memcpy(dst, data, len);\n #pragma GCC diagnostic push\n #pragma GCC diagnostic ignored \"-Wstringop-overflow\"\n dst[len] = 0;\n #pragma GCC diagnostic pop\n const char *ptr = dst;\n auto skipEntries = PXT_NUM_SKIP_ENTRIES(r);\n auto lst = packed ? r->skip_pack.list : r->skip.list;\n for (int i = 0; i < skipEntries; ++i) {\n ptr = utf8Skip(ptr, (int)(len - (ptr - dst)), PXT_STRING_SKIP_INCR);\n if (!ptr)\n oops(80);\n lst[i] = ptr - dst;\n }\n}\n#endif\n\nString mkStringCore(const char *data, int len) {\n if (len < 0)\n len = (int)strlen(data);\n if (len == 0)\n return (String)emptyString;\n\n auto vt = &string_inline_ascii_vt;\n String r;\n\n#if PXT_UTF8\n if (data && isUTF8(data, len)) {\n vt = len >= PXT_STRING_MIN_SKIP ? &string_skiplist16_packed_vt : &string_inline_utf8_vt;\n }\n if (vt == &string_skiplist16_packed_vt) {\n int ulen = utf8Len(data, len);\n r = new (gcAllocate(sizeof(void *) + 2 + 2 + (ulen / PXT_STRING_SKIP_INCR) * 2 + len + 1))\n BoxedString(vt);\n r->skip_pack.size = len;\n r->skip_pack.length = ulen;\n setupSkipList(r, data, 1);\n } else\n#endif\n {\n // for ASCII and UTF8 the layout is the same\n r = new (gcAllocate(sizeof(void *) + 2 + len + 1)) BoxedString(vt);\n r->ascii.length = len;\n if (data)\n memcpy(r->ascii.data, data, len);\n r->ascii.data[len] = 0;\n }\n\n MEMDBG(\"mkString: len=%d => %p\", len, r);\n return r;\n}\n\nString mkString(const char *data, int len) {\n#if PXT_UTF8\n if (len < 0)\n len = (int)strlen(data);\n if (len == 0)\n return (String)emptyString;\n\n int sz = utf8canon(NULL, data, len);\n if (sz == len)\n return mkStringCore(data, len);\n // this could be optimized, but it only kicks in when the string isn't valid utf8\n // (or we need to introduce surrogate pairs) which is unlikely to be performance critical\n char *tmp = (char *)app_alloc(sz);\n utf8canon(tmp, data, len);\n auto r = mkStringCore(tmp, sz);\n app_free(tmp);\n return r;\n#else\n return mkStringCore(data, len);\n#endif\n}\n\n#if PXT_UTF8\n// This converts surrogate pairs, which are encoded as 2 characters of 3 bytes each\n// into a proper 4 byte utf-8 character.\nuint32_t toRealUTF8(String str, uint8_t *dst) {\n auto src = str->getUTF8Data();\n auto len = str->getUTF8Size();\n auto dlen = 0;\n\n for (unsigned i = 0; i < len; ++i) {\n if ((uint8_t)src[i] == 0xED && i + 5 < len) {\n auto c0 = utf8CharCode(src + i);\n auto c1 = utf8CharCode(src + i + 3);\n if (0xd800 <= c0 && c0 < 0xdc00 && 0xdc00 <= c1 && c1 < 0xe000) {\n i += 5;\n auto charCode = ((c0 - 0xd800) << 10) + (c1 - 0xdc00) + 0x10000;\n if (dst) {\n dst[dlen] = 0xf0 | (charCode >> 18);\n dst[dlen + 1] = 0x80 | (0x3f & (charCode >> 12));\n dst[dlen + 2] = 0x80 | (0x3f & (charCode >> 6));\n dst[dlen + 3] = 0x80 | (0x3f & (charCode >> 0));\n }\n dlen += 4;\n }\n } else {\n if (dst)\n dst[dlen] = src[i];\n dlen++;\n }\n }\n return dlen;\n}\n#endif\n\nBuffer mkBuffer(const void *data, int len) {\n if (len <= 0)\n return (Buffer)emptyBuffer;\n Buffer r = new (gcAllocate(sizeof(BoxedBuffer) + len)) BoxedBuffer();\n r->length = len;\n if (data)\n memcpy(r->data, data, len);\n else\n memset(r->data, 0, len);\n MEMDBG(\"mkBuffer: len=%d => %p\", len, r);\n return r;\n}\n\nstatic unsigned random_value = 0xC0DA1;\n\n//%\nvoid seedRandom(unsigned seed) {\n random_value = seed;\n}\n\n//% expose\nvoid seedAddRandom(unsigned seed) {\n random_value ^= 0xCA2557CB * seed;\n}\n\nunsigned getRandom(unsigned max) {\n unsigned m, result;\n\n do {\n m = (unsigned)max;\n result = 0;\n\n do {\n // Cycle the LFSR (Linear Feedback Shift Register).\n // We use an optimal sequence with a period of 2^32-1, as defined by Bruce Schneier here\n // (a true legend in the field!),\n // For those interested, it's documented in his paper:\n // \"Pseudo-Random Sequence Generator for 32-Bit CPUs: A fast, machine-independent\n // generator for 32-bit Microprocessors\"\n // https://www.schneier.com/paper-pseudorandom-sequence.html\n unsigned r = random_value;\n\n r = ((((r >> 31) ^ (r >> 6) ^ (r >> 4) ^ (r >> 2) ^ (r >> 1) ^ r) & 1) << 31) |\n (r >> 1);\n\n random_value = r;\n\n result = ((result << 1) | (r & 0x00000001));\n } while (m >>= 1);\n } while (result > (unsigned)max);\n\n return result;\n}\n\nTNumber BoxedString::charCodeAt(int pos) {\n#if PXT_UTF8\n auto ptr = this->getUTF8DataAt(pos);\n if (!ptr)\n return TAG_NAN;\n auto code = utf8CharCode(ptr);\n if (!code && ptr == this->getUTF8Data() + this->getUTF8Size())\n return TAG_NAN;\n return fromInt(code);\n#else\n if (0 <= pos && pos < this->ascii.length) {\n return fromInt(this->ascii.data[pos]);\n } else {\n return TAG_NAN;\n }\n#endif\n}\n\nPXT_DEF_STRING(sTrue, \"true\")\nPXT_DEF_STRING(sFalse, \"false\")\nPXT_DEF_STRING(sUndefined, \"undefined\")\nPXT_DEF_STRING(sNull, \"null\")\nPXT_DEF_STRING(sObject, \"[Object]\")\nPXT_DEF_STRING(sFunction, \"[Function]\")\nPXT_DEF_STRING(sNaN, \"NaN\")\nPXT_DEF_STRING(sInf, \"Infinity\")\nPXT_DEF_STRING(sMInf, \"-Infinity\")\n} // namespace pxt\n\n#ifndef X86_64\n\nnamespace String_ {\n\n//%\nString mkEmpty() {\n return (String)emptyString;\n}\n\n// TODO support var-args somehow?\n\n//%\nString fromCharCode(int code) {\n#if PXT_UTF8\n char buf[3];\n int len;\n code &= 0xffff; // JS semantics\n if (code < 0x80) {\n buf[0] = code;\n len = 1;\n } else if (code < 0x800) {\n buf[0] = 0xc0 | (code >> 6);\n buf[1] = 0x80 | ((code >> 0) & 0x3f);\n len = 2;\n } else {\n buf[0] = 0xe0 | (code >> 12);\n buf[1] = 0x80 | ((code >> 6) & 0x3f);\n buf[2] = 0x80 | ((code >> 0) & 0x3f);\n len = 3;\n }\n return mkStringCore(buf, len);\n#else\n char buf[] = {(char)code, 0};\n return mkStringCore(buf, 1);\n#endif\n}\n\n//%\nTNumber charCodeAt(String s, int pos) {\n if (!s)\n return TAG_NAN;\n return s->charCodeAt(pos);\n}\n\n//%\nString charAt(String s, int pos) {\n auto v = charCodeAt(s, pos);\n if (v == TAG_NAN)\n return mkEmpty();\n if (!isInt(v))\n oops(81);\n return fromCharCode(numValue(v));\n}\n\n#define IS_CONS(s) ((s)->vtable == &string_cons_vt)\n#define IS_EMPTY(s) ((s) == (String)emptyString)\n\n//%\nString concat(String s, String other) {\n if (!s)\n s = (String)sNull;\n if (!other)\n other = (String)sNull;\n if (IS_EMPTY(s))\n return other;\n if (IS_EMPTY(other))\n return s;\n\n uint32_t lenA, lenB;\n\n#if PXT_UTF8\n if (IS_CONS(s)) {\n // (s->cons.left + s->cons.right) + other = s->cons.left + (s->cons.right + other)\n if (IS_CONS(other) || IS_CONS(s->cons.right))\n goto mkCons;\n auto lenAR = s->cons.right->getUTF8Size();\n lenB = other->getUTF8Size(); // de-consify other\n if (lenAR + lenB > SHORT_CONCAT_STRING)\n goto mkCons;\n // if (s->cons.right + other) is short enough, use associativity\n // to construct a shallower tree; this should keep the live set reasonable\n // when someone decides to construct a long string by concatenating\n // single characters\n\n // allocate [r] first, and keep it alive\n String r = new (gcAllocate(3 * sizeof(void *))) BoxedString(&string_cons_vt);\n registerGCObj(r);\n r->cons.left = s->cons.left;\n // this concat() might trigger GC\n r->cons.right = concat(s->cons.right, other);\n unregisterGCObj(r);\n return r;\n }\n#endif\n\n lenA = s->getUTF8Size();\n lenB = other->getUTF8Size();\n#if PXT_UTF8\n if (lenA + lenB > SHORT_CONCAT_STRING)\n goto mkCons;\n#endif\n String r;\n {\n auto dataA = s->getUTF8Data();\n auto dataB = other->getUTF8Data();\n r = mkStringCore(NULL, lenA + lenB);\n auto dst = (char *)r->getUTF8Data();\n memcpy(dst, dataA, lenA);\n memcpy(dst + lenA, dataB, lenB);\n#if PXT_UTF8\n if (isUTF8(dst, lenA + lenB))\n r->vtable = &string_inline_utf8_vt;\n#endif\n return r;\n }\n\n#if PXT_UTF8\nmkCons:\n r = new (gcAllocate(3 * sizeof(void *))) BoxedString(&string_cons_vt);\n r->cons.left = s;\n r->cons.right = other;\n return r;\n#endif\n}\n\nint compare(String a, String b) {\n if (a == b)\n return 0;\n\n auto lenA = a->getUTF8Size();\n auto lenB = b->getUTF8Size();\n auto dataA = a->getUTF8Data();\n auto dataB = b->getUTF8Data();\n auto len = lenA < lenB ? lenA : lenB;\n\n // this also works for UTF8, provided canonical encoding\n // which is guaranteed by the constructor\n for (unsigned i = 0; i <= len; ++i) {\n unsigned char cA = dataA[i];\n unsigned char cB = dataB[i];\n if (cA == cB)\n continue;\n return cA < cB ? -1 : 1;\n }\n return 0;\n}\n\n//%\nint length(String s) {\n return s->getLength();\n}\n\n#define isspace(c) ((c) == ' ')\n#define iswhitespace(c) \\\n ((c) == 0x09 || (c) == 0x0B || (c) == 0x0C || (c) == 0x20 || (uint8_t)(c) == 0xA0 || \\\n (c) == 0x0A || (c) == 0x0D)\n\nNUMBER mystrtod(const char *p, char **endp) {\n while (iswhitespace(*p))\n p++;\n NUMBER m = 1;\n NUMBER v = 0;\n int dot = 0;\n int hasDigit = 0;\n if (*p == '+')\n p++;\n if (*p == '-') {\n m = -1;\n p++;\n }\n\n while (*p) {\n int c = *p - '0';\n if (0 <= c && c <= 9) {\n v *= 10;\n v += c;\n if (dot)\n m /= 10;\n hasDigit = 1;\n } else if (!dot && *p == '.') {\n dot = 1;\n } else if (!hasDigit) {\n return NAN;\n } else {\n break;\n }\n p++;\n }\n\n v *= m;\n\n if (*p == 'e' || *p == 'E') {\n p++;\n int pw = (int)strtol(p, endp, 10);\n v *= p10(pw);\n } else {\n *endp = (char *)p;\n }\n\n return v;\n}\n\n//%\nTNumber toNumber(String s) {\n // JSCHECK\n char *endptr;\n auto data = s->getUTF8Data();\n NUMBER v = mystrtod(data, &endptr);\n if (v == 0.0 || v == -0.0) {\n // nothing\n } else if (!isnormal(v))\n v = NAN;\n return fromDouble(v);\n}\n\n//%\nString substr(String s, int start, int length) {\n if (length <= 0)\n return mkEmpty();\n auto slen = (int)s->getLength();\n if (start < 0)\n start = pxt::max(slen + start, 0);\n length = pxt::min(length, slen - start);\n if (length <= 0)\n return mkEmpty();\n auto p = s->getUTF8DataAt(start);\n#if PXT_UTF8\n auto ep = s->getUTF8DataAt(start + length);\n if (ep == NULL)\n oops(82);\n return mkStringCore(p, (int)(ep - p));\n#else\n return mkStringCore(p, length);\n#endif\n}\n\n//%\nint indexOf(String s, String searchString, int start) {\n if (!s || !searchString)\n return -1;\n\n if (start < 0)\n start = 0;\n\n auto dataA0 = s->getUTF8Data();\n auto dataA = s->getUTF8DataAt(start);\n auto offset = dataA - dataA0;\n auto lenA = s->getUTF8Size() - offset;\n auto lenB = searchString->getUTF8Size();\n\n if (dataA == NULL || lenB > lenA)\n return -1;\n\n auto dataB = searchString->getUTF8Data();\n auto firstB = dataB[0];\n while (lenA >= lenB) {\n if (*dataA == firstB && !memcmp(dataA, dataB, lenB))\n#if PXT_UTF8\n return utf8Len(dataA0, (int)(dataA - dataA0));\n#else\n return dataA - dataA0;\n#endif\n dataA++;\n lenA--;\n }\n return -1;\n}\n\n//%\nint includes(String s, String searchString, int start) {\n return -1 != indexOf(s, searchString, start);\n}\n\n} // namespace String_\n\nnamespace Boolean_ {\n//%\nbool bang(bool v) {\n return v == 0;\n}\n} // namespace Boolean_\n\nnamespace pxt {\n\n// ES5 9.5, 9.6\nunsigned toUInt(TNumber v) {\n if (isInt(v))\n return numValue(v);\n if (isSpecial(v)) {\n if ((intptr_t)v >> 6)\n return 1;\n else\n return 0;\n }\n if (!v)\n return 0;\n\n NUMBER num = toDouble(v);\n if (!isnormal(num))\n return 0;\n#ifdef PXT_USE_FLOAT\n float rem = fmodf(truncf(num), 4294967296.0);\n#else\n double rem = fmod(trunc(num), 4294967296.0);\n#endif\n if (rem < 0.0)\n rem += 4294967296.0;\n return (unsigned)rem;\n}\nint toInt(TNumber v) {\n return (int)toUInt(v);\n}\n\nNUMBER toDouble(TNumber v) {\n if (v == TAG_NAN || v == TAG_UNDEFINED)\n return NAN;\n if (isTagged(v))\n return toInt(v);\n\n#ifdef PXT64\n if (isDouble(v))\n return doubleVal(v);\n#endif\n\n ValType t = valType(v);\n\n#ifndef PXT64\n if (t == ValType::Number) {\n BoxedNumber *p = (BoxedNumber *)v;\n return p->num;\n }\n#endif\n\n if (t == ValType::String) {\n // TODO avoid allocation\n auto tmp = String_::toNumber((String)v);\n auto r = toDouble(tmp);\n return r;\n } else {\n return NAN;\n }\n}\n\nfloat toFloat(TNumber v) {\n if (v == TAG_NAN || v == TAG_UNDEFINED)\n return NAN;\n // optimize for the int case - this will avoid software conversion when FPU is present\n if (isTagged(v))\n return toInt(v);\n return (float)toDouble(v);\n}\n\n#if !defined(PXT_HARD_FLOAT) && !defined(PXT_USE_FLOAT)\nunion NumberConv {\n double v;\n struct {\n uint32_t word0;\n uint32_t word1;\n };\n};\n\nstatic inline TValue doubleToInt(double x) {\n NumberConv cnv;\n cnv.v = x;\n\n if (cnv.word1 == 0 && cnv.word0 == 0)\n return TAG_NUMBER(0);\n\n auto ex = (int)((cnv.word1 << 1) >> 21) - 1023;\n\n // DMESG(\"v=%d/1000 %p %p %d\", (int)(x * 1000), cnv.word0, cnv.word1, ex);\n\n if (ex < 0 || ex > 29) {\n // the 'MININT' case\n if (ex == 30 && cnv.word0 == 0 && cnv.word1 == 0xC1D00000)\n return (TValue)(0x80000001);\n return NULL;\n }\n\n int32_t r;\n\n if (ex <= 20) {\n if (cnv.word0)\n return TAG_UNDEFINED;\n if (cnv.word1 << (ex + 12))\n return TAG_UNDEFINED;\n r = ((cnv.word1 << 11) | 0x80000000) >> (20 - ex + 11);\n } else {\n if (cnv.word0 << (ex - 20))\n return TAG_UNDEFINED;\n r = ((cnv.word1 << 11) | 0x80000000) >> (20 - ex + 11);\n r |= cnv.word0 >> (32 - (ex - 20));\n }\n\n if (cnv.word1 >> 31)\n return TAG_NUMBER(-r);\n else\n return TAG_NUMBER(r);\n}\n#else\nstatic inline TValue doubleToInt(NUMBER r) {\n#ifdef PXT64\n if ((int)r == r)\n return TAG_NUMBER((int)r);\n#else\n int ri = ((int)r) << 1;\n if ((ri >> 1) == r)\n return (TNumber)(uintptr_t)(ri | 1);\n#endif\n return TAG_UNDEFINED;\n}\n#endif\n\nTNumber fromDouble(NUMBER r) {\n#ifndef PXT_BOX_DEBUG\n auto i = doubleToInt(r);\n if (i)\n return i;\n#endif\n if (isnan(r))\n return TAG_NAN;\n#ifdef PXT64\n return tvalueFromDouble(r);\n#else\n BoxedNumber *p = NEW_GC(BoxedNumber);\n p->num = r;\n MEMDBG(\"mkNum: %d/1000 => %p\", (int)(r * 1000), p);\n return (TNumber)p;\n#endif\n}\n\nTNumber fromFloat(float r) {\n // TODO optimize\n return fromDouble(r);\n}\n\nTNumber fromInt(int v) {\n if (canBeTagged(v))\n return TAG_NUMBER(v);\n return fromDouble(v);\n}\n\nTNumber fromUInt(unsigned v) {\n#ifndef PXT_BOX_DEBUG\n if (v <= 0x3fffffff)\n return TAG_NUMBER(v);\n#endif\n return fromDouble(v);\n}\n\nTValue fromBool(bool v) {\n if (v)\n return TAG_TRUE;\n else\n return TAG_FALSE;\n}\n\nTNumber eqFixup(TNumber v) {\n if (v == TAG_NULL)\n return TAG_UNDEFINED;\n if (v == TAG_TRUE)\n return TAG_NUMBER(1);\n if (v == TAG_FALSE)\n return TAG_NUMBER(0);\n return v;\n}\n\nstatic inline bool eq_core(TValue a, TValue b, ValType ta) {\n#ifndef PXT_BOX_DEBUG\n auto aa = (intptr_t)a;\n auto bb = (intptr_t)b;\n\n // if at least one of the values is tagged, they are not equal\n if ((aa | bb) & 3)\n return false;\n#endif\n\n if (ta == ValType::String)\n return String_::compare((String)a, (String)b) == 0;\n else if (ta == ValType::Number)\n return toDouble(a) == toDouble(b);\n else\n return a == b;\n}\n\nbool eqq_bool(TValue a, TValue b) {\n if (a == TAG_NAN || b == TAG_NAN)\n return false;\n\n if (a == b)\n return true;\n\n if (bothNumbers(a, b))\n return false;\n\n ValType ta = valType(a);\n ValType tb = valType(b);\n\n if (ta != tb)\n return false;\n\n return eq_core(a, b, ta);\n}\n\nbool eq_bool(TValue a, TValue b) {\n if (a == TAG_NAN || b == TAG_NAN)\n return false;\n\n if (eqFixup(a) == eqFixup(b))\n return true;\n\n if (bothNumbers(a, b))\n return false;\n\n ValType ta = valType(a);\n ValType tb = valType(b);\n\n if ((ta == ValType::String && tb == ValType::Number) ||\n (tb == ValType::String && ta == ValType::Number))\n return toDouble(a) == toDouble(b);\n\n if (ta == ValType::Boolean) {\n a = eqFixup(a);\n ta = ValType::Number;\n }\n if (tb == ValType::Boolean) {\n b = eqFixup(b);\n tb = ValType::Number;\n }\n\n if (ta != tb)\n return false;\n\n return eq_core(a, b, ta);\n}\n\n// TODO move to assembly\n//%\nbool switch_eq(TValue a, TValue b) {\n if (eq_bool(a, b)) {\n return true;\n }\n return false;\n}\n\n} // namespace pxt\n\n#define NUMOP(op) return fromDouble(toDouble(a) op toDouble(b));\n#define BITOP(op) return fromInt(toInt(a) op toInt(b));\nnamespace numops {\n\nint toBool(TValue v) {\n if (isTagged(v)) {\n if (v == TAG_FALSE || v == TAG_UNDEFINED || v == TAG_NAN || v == TAG_NULL ||\n v == TAG_NUMBER(0))\n return 0;\n else\n return 1;\n }\n\n ValType t = valType(v);\n if (t == ValType::String) {\n String s = (String)v;\n if (IS_EMPTY(s))\n return 0;\n } else if (t == ValType::Number) {\n auto x = toDouble(v);\n if (isnan(x) || x == 0.0 || x == -0.0)\n return 0;\n else\n return 1;\n }\n\n return 1;\n}\n\nint toBoolDecr(TValue v) {\n if (v == TAG_TRUE)\n return 1;\n if (v == TAG_FALSE)\n return 0;\n return toBool(v);\n}\n\n// The integer, non-overflow case for add/sub/bit opts is handled in assembly\n\n#ifdef PXT_VM\n#define NUMOP2(op) \\\n if (bothNumbers(a, b)) { \\\n auto tmp = (int64_t)numValue(a) op(int64_t) numValue(b); \\\n if ((int)tmp == tmp) \\\n return TAG_NUMBER((int)tmp); \\\n } \\\n NUMOP(op)\n#else\n#define NUMOP2(op) NUMOP(op)\n#endif\n\n//%\nTNumber adds(TNumber a, TNumber b){NUMOP2(+)}\n\n//%\nTNumber subs(TNumber a, TNumber b){NUMOP2(-)}\n\n//%\nTNumber muls(TNumber a, TNumber b) {\n if (bothNumbers(a, b)) {\n#ifdef PXT64\n auto tmp = (int64_t)numValue(a) * (int64_t)numValue(b);\n if ((int)tmp == tmp)\n return TAG_NUMBER((int)tmp);\n#else\n int aa = (int)a;\n int bb = (int)b;\n // if both operands fit 15 bits, the result will not overflow int\n if ((aa >> 15 == 0 || aa >> 15 == -1) && (bb >> 15 == 0 || bb >> 15 == -1)) {\n // it may overflow 31 bit int though - use fromInt to convert properly\n return fromInt((aa >> 1) * (bb >> 1));\n }\n#endif\n }\n NUMOP(*)\n}\n\n//%\nTNumber div(TNumber a, TNumber b) {\n if (b == TAG_NUMBER(1))\n return a;\n NUMOP(/)\n}\n\n//%\nTNumber mod(TNumber a, TNumber b) {\n if (isInt(a) && isInt(b) && numValue(b))\n BITOP(%)\n return fromDouble(fmod(toDouble(a), toDouble(b)));\n}\n\n//%\nTNumber lsls(TNumber a, TNumber b) {\n return fromInt(toInt(a) << (toInt(b) & 0x1f));\n}\n\n//%\nTNumber lsrs(TNumber a, TNumber b) {\n return fromUInt(toUInt(a) >> (toUInt(b) & 0x1f));\n}\n\n//%\nTNumber asrs(TNumber a, TNumber b) {\n return fromInt(toInt(a) >> (toInt(b) & 0x1f));\n}\n\n//%\nTNumber eors(TNumber a, TNumber b){BITOP(^)}\n\n//%\nTNumber orrs(TNumber a, TNumber b){BITOP(|)}\n\n//%\nTNumber bnot(TNumber a) {\n return fromInt(~toInt(a));\n}\n\n//%\nTNumber ands(TNumber a, TNumber b) {\n BITOP(&)\n}\n\n#ifdef PXT64\n#define CMPOP_RAW(op, t, f) \\\n if (bothNumbers(a, b)) \\\n return numValue(a) op numValue(b) ? t : f; \\\n int cmp = valCompare(a, b); \\\n return cmp != -2 && cmp op 0 ? t : f;\n#else\n#define CMPOP_RAW(op, t, f) \\\n if (bothNumbers(a, b)) \\\n return (intptr_t)a op((intptr_t)b) ? t : f; \\\n int cmp = valCompare(a, b); \\\n return cmp != -2 && cmp op 0 ? t : f;\n#endif\n\n#define CMPOP(op) CMPOP_RAW(op, TAG_TRUE, TAG_FALSE)\n\n// 7.2.13 Abstract Relational Comparison\nstatic int valCompare(TValue a, TValue b) {\n if (a == TAG_NAN || b == TAG_NAN)\n return -2;\n\n ValType ta = valType(a);\n ValType tb = valType(b);\n\n if (ta == ValType::String && tb == ValType::String)\n return String_::compare((String)a, (String)b);\n\n if (a == b)\n return 0;\n\n auto da = toDouble(a);\n auto db = toDouble(b);\n\n if (isnan(da) || isnan(db))\n return -2;\n\n if (da < db)\n return -1;\n else if (da > db)\n return 1;\n else\n return 0;\n}\n\n//%\nbool lt_bool(TNumber a, TNumber b){CMPOP_RAW(<, true, false)}\n\n//%\nTNumber le(TNumber a, TNumber b){CMPOP(<=)}\n\n//%\nTNumber lt(TNumber a, TNumber b){CMPOP(<)}\n\n//%\nTNumber ge(TNumber a, TNumber b){CMPOP(>=)}\n\n//%\nTNumber gt(TNumber a, TNumber b){CMPOP(>)}\n\n//%\nTNumber eq(TNumber a, TNumber b) {\n return pxt::eq_bool(a, b) ? TAG_TRUE : TAG_FALSE;\n}\n\n//%\nTNumber neq(TNumber a, TNumber b) {\n return !pxt::eq_bool(a, b) ? TAG_TRUE : TAG_FALSE;\n}\n\n//%\nTNumber eqq(TNumber a, TNumber b) {\n return pxt::eqq_bool(a, b) ? TAG_TRUE : TAG_FALSE;\n}\n\n//%\nTNumber neqq(TNumber a, TNumber b) {\n return !pxt::eqq_bool(a, b) ? TAG_TRUE : TAG_FALSE;\n}\n\n// How many significant digits mycvt() should output.\n// This cannot be more than 15, as this is the most that can be accurately represented\n// in 64 bit double. Otherwise this code may crash.\n#define DIGITS 15\n\nstatic const uint64_t pows[] = {\n 1LL, 10LL, 100LL, 1000LL, 10000LL,\n 100000LL, 1000000LL, 10000000LL, 100000000LL, 1000000000LL,\n 10000000000LL, 100000000000LL, 1000000000000LL, 10000000000000LL, 100000000000000LL,\n};\n\n// The basic idea is we convert d to a 64 bit integer with DIGITS\n// digits, and then print it out, putting dot in the right place.\n\nvoid mycvt(NUMBER d, char *buf) {\n if (d < 0) {\n *buf++ = '-';\n d = -d;\n }\n\n if (!d) {\n *buf++ = '0';\n *buf++ = 0;\n return;\n }\n\n int pw = (int)log10(d);\n int e = 1;\n\n // if outside 1e-6 -- 1e21 range, we use the e-notation\n if (d < 1e-6 || d > 1e21) {\n // normalize number to 1.XYZ, save e, and reset pw\n if (pw < 0)\n d *= p10(-pw);\n else\n d /= p10(pw);\n e = pw;\n pw = 0;\n }\n\n int trailingZ = 0;\n int dotAfter = pw + 1; // at which position the dot should be in the number\n\n uint64_t dd;\n\n // normalize number to be integer with exactly DIGITS digits\n if (pw >= DIGITS) {\n // if the number is larger than DIGITS, we need trailing zeroes\n trailingZ = pw - DIGITS + 1;\n dd = (uint64_t)(d / p10(trailingZ) + 0.5);\n } else {\n dd = (uint64_t)(d * p10(DIGITS - pw - 1) + 0.5);\n }\n\n // if number is less than 1, we need 0.00...00 at the beginning\n if (dotAfter < 1) {\n *buf++ = '0';\n *buf++ = '.';\n int n = -dotAfter;\n while (n--)\n *buf++ = '0';\n }\n\n // now print out the actual number\n for (int i = DIGITS - 1; i >= 0; i--) {\n uint64_t q = pows[i];\n // this may be faster than fp-division and fmod(); or maybe not\n // anyways, it works\n int k = '0';\n while (dd >= q) {\n dd -= q;\n k++;\n }\n *buf++ = k;\n // if we're after dot, and what's left is zeroes, stop\n if (dd == 0 && (DIGITS - i) >= dotAfter)\n break;\n // print the dot, if we arrived at it\n if ((DIGITS - i) == dotAfter)\n *buf++ = '.';\n }\n\n // print out remaining trailing zeroes if any\n while (trailingZ-- > 0)\n *buf++ = '0';\n\n // if we used e-notation, handle that\n if (e != 1) {\n *buf++ = 'e';\n if (e > 0)\n *buf++ = '+';\n itoa(e, buf);\n } else {\n *buf = 0;\n }\n}\n\n#if 0\n//%\nTValue floatAsInt(TValue x) {\n return doubleToInt(toDouble(x));\n}\n\n//% shim=numops::floatAsInt\nfunction floatAsInt(v: number): number { return 0 }\n\nfunction testInt(i: number) {\n if (floatAsInt(i) != i)\n control.panic(101)\n if (floatAsInt(i + 0.5) != null)\n control.panic(102)\n if (floatAsInt(i + 0.00001) != null)\n control.panic(103)\n}\n\nfunction testFloat(i: number) {\n if (floatAsInt(i) != null)\n control.panic(104)\n}\n\nfunction testFloatAsInt() {\n for (let i = 0; i < 0xffff; ++i) {\n testInt(i)\n testInt(-i)\n testInt(i * 10000)\n testInt(i << 12)\n testInt(i + 0x3fff0001)\n testInt(-i - 0x3fff0002)\n testFloat(i + 0x3fffffff + 1)\n testFloat((i + 10000) * 1000000)\n }\n}\n#endif\n\nString toString(TValue v) {\n ValType t = valType(v);\n\n if (t == ValType::String) {\n return (String)v;\n } else if (t == ValType::Number) {\n char buf[64];\n\n if (isInt(v)) {\n itoa(numValue(v), buf);\n return mkStringCore(buf);\n }\n\n if (v == TAG_NAN)\n return (String)(void *)sNaN;\n\n auto x = toDouble(v);\n\n#ifdef PXT_BOX_DEBUG\n if (x == (int)x) {\n itoa((int)x, buf);\n return mkStringCore(buf);\n }\n#endif\n\n if (isinf(x)) {\n if (x < 0)\n return (String)(void *)sMInf;\n else\n return (String)(void *)sInf;\n } else if (isnan(x)) {\n return (String)(void *)sNaN;\n }\n mycvt(x, buf);\n\n return mkStringCore(buf);\n } else if (t == ValType::Function) {\n return (String)(void *)sFunction;\n } else {\n if (v == TAG_UNDEFINED)\n return (String)(void *)sUndefined;\n else if (v == TAG_FALSE)\n return (String)(void *)sFalse;\n else if (v == TAG_NAN)\n return (String)(void *)sNaN;\n else if (v == TAG_TRUE)\n return (String)(void *)sTrue;\n else if (v == TAG_NULL)\n return (String)(void *)sNull;\n return (String)(void *)sObject;\n }\n}\n\n} // namespace numops\n\nnamespace Math_ {\n//%\nTNumber pow(TNumber x, TNumber y) {\n#ifdef PXT_POWI\n // regular pow() from math.h is 4k of code\n return fromDouble(__builtin_powi(toDouble(x), toInt(y)));\n#else\n return fromDouble(::pow(toDouble(x), toDouble(y)));\n#endif\n}\n\nNUMBER randomDouble() {\n return getRandom(UINT_MAX) / ((NUMBER)UINT_MAX + 1) +\n getRandom(0xffffff) / ((NUMBER)UINT_MAX * 0xffffff);\n}\n\n//%\nTNumber random() {\n return fromDouble(randomDouble());\n}\n\n//%\nTNumber randomRange(TNumber min, TNumber max) {\n if (isInt(min) && isInt(max)) {\n int mini = numValue(min);\n int maxi = numValue(max);\n if (mini > maxi) {\n int temp = mini;\n mini = maxi;\n maxi = temp;\n }\n if (maxi == mini)\n return fromInt(mini);\n else\n return fromInt(mini + getRandom(maxi - mini));\n } else {\n auto mind = toDouble(min);\n auto maxd = toDouble(max);\n if (mind > maxd) {\n auto temp = mind;\n mind = maxd;\n maxd = temp;\n }\n if (maxd == mind)\n return fromDouble(mind);\n else {\n return fromDouble(mind + randomDouble() * (maxd - mind));\n }\n }\n}\n\n#define SINGLE(op) return fromDouble(::op(toDouble(x)));\n\n//%\nTNumber log(TNumber x){SINGLE(log)}\n\n//%\nTNumber log10(TNumber x){SINGLE(log10)}\n\n//%\nTNumber floor(TNumber x){SINGLE(floor)}\n\n//%\nTNumber ceil(TNumber x){SINGLE(ceil)}\n\n//%\nTNumber trunc(TNumber x){SINGLE(trunc)}\n\n//%\nTNumber round(TNumber x) {\n // In C++, round(-1.5) == -2, while in JS, round(-1.5) == -1. Align to the JS convention for\n // consistency between simulator and device. The following does rounding with ties (x.5) going\n // towards positive infinity.\n return fromDouble(::floor(toDouble(x) + 0.5));\n}\n\n//%\nint imul(int x, int y) {\n return x * y;\n}\n\n//%\nint idiv(int x, int y) {\n return x / y;\n}\n} // namespace Math_\n\nnamespace Array_ {\nRefCollection *mk() {\n auto r = NEW_GC(RefCollection);\n MEMDBG(\"mkColl: => %p\", r);\n return r;\n}\nint length(RefCollection *c) {\n return c->length();\n}\nvoid setLength(RefCollection *c, int newLength) {\n c->setLength(newLength);\n}\nvoid push(RefCollection *c, TValue x) {\n c->head.push(x);\n}\nTValue pop(RefCollection *c) {\n return c->head.pop();\n}\nTValue getAt(RefCollection *c, int x) {\n return c->head.get(x);\n}\nvoid setAt(RefCollection *c, int x, TValue y) {\n c->head.set(x, y);\n}\nTValue removeAt(RefCollection *c, int x) {\n return c->head.remove(x);\n}\nvoid insertAt(RefCollection *c, int x, TValue value) {\n c->head.insert(x, value);\n}\nint indexOf(RefCollection *c, TValue x, int start) {\n auto data = c->head.getData();\n auto len = c->head.getLength();\n for (unsigned i = 0; i < len; i++) {\n if (pxt::eq_bool(data[i], x)) {\n return (int)i;\n }\n }\n return -1;\n}\nbool removeElement(RefCollection *c, TValue x) {\n int idx = indexOf(c, x, 0);\n if (idx >= 0) {\n decr(removeAt(c, idx));\n return 1;\n }\n return 0;\n}\n} // namespace Array_\n\nnamespace pxt {\nint debugFlags;\n\n//%\nvoid *ptrOfLiteral(int offset);\n\n#ifdef PXT_VM\nunsigned programSize() {\n return 0;\n}\n#else\n//%\nunsigned programSize() {\n return bytecode[17] * 8;\n}\n#endif\n\nvoid deepSleep() __attribute__((weak));\n//%\nvoid deepSleep() {}\n\nint *getBootloaderConfigData() __attribute__((weak));\nint *getBootloaderConfigData() {\n return NULL;\n}\n\n//%\nint getConfig(int key, int defl) {\n#ifdef PXT_VM\n if (!vmImg)\n return defl;\n int *cfgData = vmImg->configData;\n#else\n int *cfgData = bytecode ? *(int **)&bytecode[18] : NULL;\n#endif\n\n if (cfgData) {\n for (int i = 0;; i += 2) {\n if (cfgData[i] == key)\n return cfgData[i + 1];\n if (cfgData[i] == 0)\n break;\n }\n }\n\n cfgData = getBootloaderConfigData();\n\n if (cfgData) {\n for (int i = 0;; i += 2) {\n if (cfgData[i] == key)\n return cfgData[i + 1];\n if (cfgData[i] == 0)\n break;\n }\n }\n\n return defl;\n}\n\n} // namespace pxt\n\nnamespace pxtrt {\n//%\nTValue ldlocRef(RefRefLocal *r) {\n return r->v;\n}\n\n//%\nvoid stlocRef(RefRefLocal *r, TValue v) {\n r->v = v;\n}\n\n//%\nRefRefLocal *mklocRef() {\n auto r = NEW_GC(RefRefLocal);\n MEMDBG(\"mklocRef: => %p\", r);\n return r;\n}\n\n// Store a captured local in a closure. It returns the action, so it can be chained.\n//%\nRefAction *stclo(RefAction *a, int idx, TValue v) {\n // DBG(\"STCLO \"); a->print(); DBG(\"@%d = %p\\n\", idx, (void*)v);\n a->stCore(idx, v);\n return a;\n}\n\n//%\nvoid panic(int code) {\n soft_panic(code);\n}\n\n//%\nString emptyToNull(String s) {\n if (!s || IS_EMPTY(s))\n return NULL;\n return s;\n}\n\n//%\nint ptrToBool(TValue p) {\n if (p) {\n decr(p);\n return 1;\n } else {\n return 0;\n }\n}\n\nRefMap *mkMap() {\n auto r = NEW_GC(RefMap);\n MEMDBG(\"mkMap: => %p\", r);\n return r;\n}\n\nTValue mapGetByString(RefMap *map, String key) {\n int i = map->findIdx(key);\n if (i < 0) {\n return 0;\n }\n return map->values.get(i);\n}\n\n#ifdef PXT_VM\n#define IFACE_MEMBER_NAMES vmImg->ifaceMemberNames\n#else\n#define IFACE_MEMBER_NAMES *(uintptr_t **)&bytecode[22]\n#endif\n\nint lookupMapKey(String key) {\n auto arr = IFACE_MEMBER_NAMES;\n auto len = *arr++;\n int l = 1U; // skip index 0 - it's invalid\n int r = (int)len - 1;\n auto ikey = (uintptr_t)key;\n if (arr[l] <= ikey && ikey <= arr[r]) {\n while (l <= r) {\n auto m = (l + r) >> 1;\n if (arr[m] == ikey)\n return m;\n else if (arr[m] < ikey)\n l = m + 1;\n else\n r = m - 1;\n }\n } else {\n while (l <= r) {\n int m = (l + r) >> 1;\n auto cmp = String_::compare((String)arr[m], key);\n if (cmp == 0)\n return m;\n else if (cmp < 0)\n l = m + 1;\n else\n r = m - 1;\n }\n }\n return 0;\n}\n\nTValue mapGet(RefMap *map, unsigned key) {\n auto arr = (String *)IFACE_MEMBER_NAMES;\n auto r = mapGetByString(map, arr[key + 1]);\n map->unref();\n return r;\n}\n\nvoid mapSetByString(RefMap *map, String key, TValue val) {\n int i = map->findIdx(key);\n if (i < 0) {\n map->keys.push((TValue)key);\n map->values.push(val);\n } else {\n map->values.set(i, val);\n }\n}\n\nvoid mapSet(RefMap *map, unsigned key, TValue val) {\n auto arr = (String *)IFACE_MEMBER_NAMES;\n mapSetByString(map, arr[key + 1], val);\n decr(val);\n map->unref();\n}\n\n//\n// Debugger\n//\n\n// This is only to be called once at the beginning of lambda function\n//%\nvoid *getGlobalsPtr() {\n#ifdef DEVICE_GROUP_ID_USER\n fiber_set_group(DEVICE_GROUP_ID_USER);\n#endif\n\n return globals;\n}\n\n//%\nvoid runtimeWarning(String s) {\n // noop for now\n}\n} // namespace pxtrt\n#endif\n\nnamespace pxt {\n\nvoid doNothing() {}\n\n//%\nValType valType(TValue v) {\n if (isTagged(v)) {\n if (!v)\n return ValType::Undefined;\n\n if (isInt(v) || v == TAG_NAN)\n return ValType::Number;\n if (v == TAG_TRUE || v == TAG_FALSE)\n return ValType::Boolean;\n else if (v == TAG_NULL)\n return ValType::Object;\n else {\n oops(1);\n return ValType::Object;\n }\n#ifdef PXT64\n } else if (isDouble(v)) {\n return ValType::Number;\n#endif\n } else {\n auto vt = getVTable((RefObject *)v);\n if (vt->magic == VTABLE_MAGIC)\n return vt->objectType;\n else\n return ValType::Object;\n }\n}\n\nPXT_DEF_STRING(sObjectTp, \"object\")\nPXT_DEF_STRING(sBooleanTp, \"boolean\")\nPXT_DEF_STRING(sStringTp, \"string\")\nPXT_DEF_STRING(sNumberTp, \"number\")\nPXT_DEF_STRING(sFunctionTp, \"function\")\nPXT_DEF_STRING(sUndefinedTp, \"undefined\")\n\n//% expose\nString typeOf(TValue v) {\n switch (valType(v)) {\n case ValType::Undefined:\n return (String)sUndefinedTp;\n case ValType::Boolean:\n return (String)sBooleanTp;\n case ValType::Number:\n return (String)sNumberTp;\n case ValType::String:\n return (String)sStringTp;\n case ValType::Object:\n return (String)sObjectTp;\n case ValType::Function:\n return (String)sFunctionTp;\n default:\n oops(2);\n return 0;\n }\n}\n\n// Maybe in future we will want separate print methods; for now ignore\nvoid anyPrint(TValue v) {\n if (valType(v) == ValType::Object) {\n if (isRefCounted(v)) {\n auto o = (RefObject *)v;\n auto vt = getVTable(o);\n auto meth = ((RefObjectMethod)vt->methods[1]);\n if ((void *)meth == (void *)&anyPrint)\n DMESG(\"[RefObject vt=%p cl=%d sz=%d]\", o->vtable, vt->classNo, vt->numbytes);\n else\n meth(o);\n } else {\n DMESG(\"[Native %p]\", v);\n }\n } else {\n#ifndef X86_64\n String s = numops::toString(v);\n DMESG(\"[%s %p = %s]\", pxt::typeOf(v)->getUTF8Data(), v, s->getUTF8Data());\n decr((TValue)s);\n#endif\n }\n}\n\nstatic void dtorDoNothing() {}\n\n#define PRIM_VTABLE(name, objectTp, tp, szexpr) \\\n static uint32_t name##_size(tp *p) { return TOWORDS(sizeof(tp) + szexpr); } \\\n DEF_VTABLE(name##_vt, tp, objectTp, (void *)&dtorDoNothing, (void *)&anyPrint, 0, \\\n (void *)&name##_size)\n\n#define NOOP ((void)0)\n\n#define STRING_VT(name, fix, scan, gcsize, data, utfsize, length, dataAt) \\\n static uint32_t name##_gcsize(BoxedString *p) { return TOWORDS(sizeof(void *) + (gcsize)); } \\\n static void name##_gcscan(BoxedString *p) { scan; } \\\n static const char *name##_data(BoxedString *p) { \\\n fix; \\\n return data; \\\n } \\\n static uint32_t name##_utfsize(BoxedString *p) { \\\n fix; \\\n return utfsize; \\\n } \\\n static uint32_t name##_length(BoxedString *p) { \\\n fix; \\\n return length; \\\n } \\\n static const char *name##_dataAt(BoxedString *p, uint32_t idx) { \\\n fix; \\\n return dataAt; \\\n } \\\n DEF_VTABLE(name##_vt, BoxedString, ValType::String, (void *)&dtorDoNothing, (void *)&anyPrint, \\\n (void *)&name##_gcscan, (void *)&name##_gcsize, (void *)&name##_data, \\\n (void *)&name##_utfsize, (void *)&name##_length, (void *)&name##_dataAt)\n\nvoid gcMarkArray(void *data);\nvoid gcScan(TValue v);\n\n#if PXT_UTF8\nstatic const char *skipLookup(BoxedString *p, uint32_t idx, int packed) {\n if (idx > p->skip.length)\n return NULL;\n auto ent = idx / PXT_STRING_SKIP_INCR;\n auto data = packed ? PXT_SKIP_DATA_PACK(p) : PXT_SKIP_DATA_IND(p);\n auto size = p->skip.size;\n if (ent) {\n auto off = packed ? p->skip_pack.list[ent - 1] : p->skip.list[ent - 1];\n data += off;\n size -= off;\n idx &= PXT_STRING_SKIP_INCR - 1;\n }\n return utf8Skip(data, size, idx);\n}\n\nextern LLSegment workQueue;\n\nstatic uint32_t fixSize(BoxedString *p, uint32_t *len) {\n uint32_t tlen = 0;\n uint32_t sz = 0;\n if (workQueue.getLength())\n oops(81);\n workQueue.push((TValue)p);\n while (workQueue.getLength()) {\n p = (BoxedString *)workQueue.pop();\n if (IS_CONS(p)) {\n workQueue.push((TValue)p->cons.right);\n workQueue.push((TValue)p->cons.left);\n } else {\n tlen += p->getLength();\n sz += p->getUTF8Size();\n }\n }\n *len = tlen;\n return sz;\n}\n\nstatic void fixCopy(BoxedString *p, char *dst) {\n if (workQueue.getLength())\n oops(81);\n\n workQueue.push((TValue)p);\n while (workQueue.getLength()) {\n p = (BoxedString *)workQueue.pop();\n if (IS_CONS(p)) {\n workQueue.push((TValue)p->cons.right);\n workQueue.push((TValue)p->cons.left);\n } else {\n auto sz = p->getUTF8Size();\n memcpy(dst, p->getUTF8Data(), sz);\n dst += sz;\n }\n }\n}\n\n// switches CONS representation into skip list representation\n// does not switch representation of CONS' children\nstatic void fixCons(BoxedString *r) {\n uint32_t length = 0;\n auto sz = fixSize(r, &length);\n auto numSkips = length / PXT_STRING_SKIP_INCR;\n // allocate first, while [r] still holds references to its children\n // because allocation might trigger GC\n auto data = (uint16_t *)gcAllocateArray(numSkips * 2 + sz + 1);\n // copy, while [r] is still cons\n fixCopy(r, (char *)(data + numSkips));\n // now, set [r] up properly\n r->vtable = &string_skiplist16_vt;\n r->skip.size = sz;\n r->skip.length = length;\n r->skip.list = data;\n setupSkipList(r, NULL, 0);\n}\n#endif\n\nSTRING_VT(string_inline_ascii, NOOP, NOOP, 2 + p->ascii.length + 1, p->ascii.data, p->ascii.length,\n p->ascii.length, idx <= p->ascii.length ? p->ascii.data + idx : NULL)\n#if PXT_UTF8\nSTRING_VT(string_inline_utf8, NOOP, NOOP, 2 + p->utf8.size + 1, p->utf8.data, p->utf8.size,\n utf8Len(p->utf8.data, p->utf8.size), utf8Skip(p->utf8.data, p->utf8.size, idx))\nSTRING_VT(string_skiplist16, NOOP, if (p->skip.list) gcMarkArray(p->skip.list), 2 * sizeof(void *),\n PXT_SKIP_DATA_IND(p), p->skip.size, p->skip.length, skipLookup(p, idx, 0))\nSTRING_VT(string_skiplist16_packed, NOOP, NOOP,\n 2 + 2 + PXT_NUM_SKIP_ENTRIES(p) * 2 + p->skip.size + 1, PXT_SKIP_DATA_PACK(p),\n p->skip.size, p->skip.length, skipLookup(p, idx, 1))\nSTRING_VT(string_cons, fixCons(p), (gcScan((TValue)p->cons.left), gcScan((TValue)p->cons.right)),\n 2 * sizeof(void *), PXT_SKIP_DATA_IND(p), p->skip.size, p->skip.length,\n skipLookup(p, idx, 0))\n#endif\n\nPRIM_VTABLE(number, ValType::Number, BoxedNumber, 0)\nPRIM_VTABLE(buffer, ValType::Object, BoxedBuffer, p->length)\n// PRIM_VTABLE(action, ValType::Function, RefAction, )\n\nvoid failedCast(TValue v, void *addr) {\n DMESG(\"failed type check for %p @%p\", v, addr);\n auto vt = getAnyVTable(v);\n if (vt) {\n DMESG(\"VT %p - objtype %d classNo %d\", vt, vt->objectType, vt->classNo);\n }\n\n int code;\n if (v == TAG_NULL)\n code = PANIC_CAST_FROM_NULL;\n else\n code = PANIC_CAST_FIRST + (int)valType(v);\n soft_panic(code);\n}\n\nvoid missingProperty(TValue v) {\n DMESG(\"missing property on %p\", v);\n soft_panic(PANIC_MISSING_PROPERTY);\n}\n\n#ifdef PXT_PROFILE\nstruct PerfCounter *perfCounters;\n\nstruct PerfCounterInfo {\n uint32_t numPerfCounters;\n char *perfCounterNames[0];\n};\n\n#define PERF_INFO ((PerfCounterInfo *)(((uintptr_t *)bytecode)[13]))\n\nvoid initPerfCounters() {\n auto n = PERF_INFO->numPerfCounters;\n perfCounters = new PerfCounter[n];\n memset(perfCounters, 0, n * sizeof(PerfCounter));\n}\n\nvoid dumpPerfCounters() {\n auto info = PERF_INFO;\n DMESG(\"calls,us,name\");\n for (uint32_t i = 0; i < info->numPerfCounters; ++i) {\n auto c = &perfCounters[i];\n DMESG(\"%d,%d,%s\", c->numstops, c->value, info->perfCounterNames[i]);\n }\n}\n\nvoid startPerfCounter(PerfCounters n) {\n if (!perfCounters)\n return;\n auto c = &perfCounters[(uint32_t)n];\n if (c->start)\n oops(50);\n c->start = PERF_NOW();\n}\n\nvoid stopPerfCounter(PerfCounters n) {\n if (!perfCounters)\n return;\n auto c = &perfCounters[(uint32_t)n];\n if (!c->start)\n oops(51);\n c->value += PERF_NOW() - c->start;\n c->start = 0;\n c->numstops++;\n}\n#endif\n\n// Exceptions\n\n#ifndef PXT_EXN_CTX\n#define PXT_EXN_CTX() getThreadContext()\n#endif\n\ntypedef void (*RestoreStateType)(TryFrame *, ThreadContext *);\n#ifndef pxt_restore_exception_state\n#define pxt_restore_exception_state ((RestoreStateType)(((uintptr_t *)bytecode)[14]))\n#endif\n\n//%\nTryFrame *beginTry() {\n auto ctx = PXT_EXN_CTX();\n auto frame = (TryFrame *)app_alloc(sizeof(TryFrame));\n frame->parent = ctx->tryFrame;\n ctx->tryFrame = frame;\n return frame;\n}\n\n//% expose\nvoid endTry() {\n auto ctx = PXT_EXN_CTX();\n auto f = ctx->tryFrame;\n if (!f)\n oops(51);\n ctx->tryFrame = f->parent;\n app_free(f);\n}\n\n//% expose\nvoid throwValue(TValue v) {\n auto ctx = PXT_EXN_CTX();\n auto f = ctx->tryFrame;\n if (!f) {\n DMESG(\"unhandled exception, value:\");\n anyPrint(v);\n soft_panic(PANIC_UNHANDLED_EXCEPTION);\n }\n ctx->tryFrame = f->parent;\n TryFrame copy = *f;\n app_free(f);\n ctx->thrownValue = v;\n pxt_restore_exception_state(©, ctx);\n}\n\n//% expose\nTValue getThrownValue() {\n auto ctx = PXT_EXN_CTX();\n auto v = ctx->thrownValue;\n ctx->thrownValue = TAG_NON_VALUE;\n if (v == TAG_NON_VALUE)\n oops(51);\n return v;\n}\n\n//% expose\nvoid endFinally() {\n auto ctx = PXT_EXN_CTX();\n if (ctx->thrownValue == TAG_NON_VALUE)\n return;\n throwValue(getThrownValue());\n}\n\n// https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function\nuint32_t hash_fnv1(const void *data, unsigned len) {\n const uint8_t *d = (const uint8_t *)data;\n uint32_t h = 0x811c9dc5;\n while (len--)\n h = (h * 0x1000193) ^ *d++;\n return h;\n}\n\n// redefined in melody.cpp\n__attribute__((weak)) int redirectSamples(int16_t *dst, int numsamples, int samplerate) {\n return 0;\n}\n\n} // namespace pxt\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum NumberFormat {\n Int8LE = 1,\n UInt8LE = 2,\n Int16LE = 3,\n UInt16LE = 4,\n Int32LE = 5,\n Int8BE = 6,\n UInt8BE = 7,\n Int16BE = 8,\n UInt16BE = 9,\n Int32BE = 10,\n\n UInt32LE = 11,\n UInt32BE = 12,\n Float32LE = 13,\n Float64LE = 14,\n Float32BE = 15,\n Float64BE = 16,\n }\n\n\n declare const enum PerfCounters {\n GC = 0,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"eventcontext.ts": "namespace control {\n /**\n * Run code when a registered event happens.\n * @param id the event compoent id\n * @param value the event value to match\n */\n //% weight=20 blockGap=8 blockId=\"control_on_event\" block=\"on event|from %src|with value %value\"\n //% blockExternalInputs=1\n //% help=\"control/on-event\"\n export function onEvent(src: number, value: number, handler: () => void, flags = 16) { // EVENT_LISTENER_DEFAULT_FLAGS\n const ctx = control.eventContext();\n if (!ctx)\n control.internalOnEvent(src, value, handler, flags);\n else\n ctx.registerHandler(src, value, handler, flags);\n }\n\n export class FrameCallback {\n order: number\n handler: () => void\n }\n\n class EventHandler {\n constructor(\n public src: number,\n public value: number,\n public handler: () => void,\n public flags: number\n ) { }\n\n register() {\n control.internalOnEvent(this.src, this.value, () => {\n if (this.handler) this.handler();\n }, this.flags)\n }\n\n unregister() {\n control.internalOnEvent(this.src, this.value, doNothing, this.flags);\n }\n }\n\n function doNothing() { }\n\n\n\n export class EventContext {\n private handlers: EventHandler[];\n private frameCallbacks: FrameCallback[];\n private frameWorker: number;\n private framesInSample: number;\n private timeInSample: number;\n public deltaTimeMillis: number;\n private prevTimeMillis: number;\n private idleCallbacks: (() => void)[];\n\n static lastStats: string;\n static onStats: (stats: string) => void;\n\n constructor() {\n this.handlers = [];\n this.framesInSample = 0;\n this.timeInSample = 0;\n this.deltaTimeMillis = 0;\n this.frameWorker = 0;\n this.idleCallbacks = undefined;\n if (!EventContext.lastStats) {\n EventContext.lastStats = \"\";\n }\n }\n\n get deltaTime() {\n return this.deltaTimeMillis / 1000;\n }\n\n private runCallbacks() {\n control.enablePerfCounter(\"all frame callbacks\")\n\n let loopStart = control.millis()\n this.deltaTimeMillis = loopStart - this.prevTimeMillis;\n this.prevTimeMillis = loopStart;\n for (let f of this.frameCallbacks) {\n f.handler()\n }\n let runtime = control.millis() - loopStart\n this.timeInSample += runtime\n this.framesInSample++\n if (this.timeInSample > 1000 || this.framesInSample > 30) {\n const fps = this.framesInSample / (this.timeInSample / 1000);\n EventContext.lastStats = `fps:${Math.round(fps)}`;\n if (fps < 99)\n EventContext.lastStats += \".\" + (Math.round(fps * 10) % 10)\n if (control.ramSize() > 2000000 && control.profilingEnabled()) {\n control.dmesg(`${(fps * 100) | 0}/100 fps - ${this.framesInSample} frames`)\n control.gc()\n control.dmesgPerfCounters()\n }\n this.timeInSample = 0\n this.framesInSample = 0\n }\n let delay = Math.max(1, 20 - runtime)\n\n return delay\n }\n\n private runningCallbacks: boolean;\n private registerFrameCallbacks() {\n if (!this.frameCallbacks) return;\n\n const worker = this.frameWorker;\n control.runInParallel(() => {\n if (this.runningCallbacks) {\n // this context is still running in a different fiber;\n // delay until the other fiber doing so has ceased.\n pauseUntil(() => !this.runningCallbacks);\n }\n this.runningCallbacks = true;\n\n this.framesInSample = 0;\n this.timeInSample = 0;\n this.deltaTimeMillis = 0;\n this.prevTimeMillis = control.millis();\n\n while (worker == this.frameWorker) {\n let delay = this.runCallbacks()\n pause(delay)\n }\n\n this.runningCallbacks = false;\n })\n }\n\n register() {\n for (const h of this.handlers)\n h.register();\n this.registerFrameCallbacks();\n }\n\n unregister() {\n for (const h of this.handlers)\n h.unregister();\n this.frameWorker++;\n }\n\n registerFrameHandler(order: number, handler: () => void): FrameCallback {\n if (!this.frameCallbacks) {\n this.frameCallbacks = [];\n this.registerFrameCallbacks();\n }\n\n const fn = new FrameCallback()\n fn.order = order\n fn.handler = handler\n for (let i = 0; i < this.frameCallbacks.length; ++i) {\n if (this.frameCallbacks[i].order > order) {\n this.frameCallbacks.insertAt(i, fn)\n return fn;\n }\n }\n this.frameCallbacks.push(fn);\n return fn;\n }\n\n unregisterFrameHandler(fn: FrameCallback) {\n if (!fn || !this.frameCallbacks) return;\n const i = this.frameCallbacks.indexOf(fn);\n if (i > -1)\n this.frameCallbacks.splice(i, 1);\n }\n\n registerHandler(src: number, value: number, handler: () => void, flags: number) {\n // already there?\n for (const h of this.handlers) {\n if (h.src == src && h.value == value) {\n h.flags = flags;\n h.handler = handler;\n return;\n }\n }\n // register and push\n const hn = new EventHandler(src, value, handler, flags);\n this.handlers.push(hn);\n hn.register();\n }\n\n addIdleHandler(handler: () => void) {\n if (!this.idleCallbacks) {\n this.idleCallbacks = [];\n this.registerHandler(15/*DAL.DEVICE_ID_SCHEDULER*/, 2/*DAL.DEVICE_SCHEDULER_EVT_IDLE*/, () => this.runIdleHandler(), 16);\n }\n this.idleCallbacks.push(handler);\n }\n\n removeIdleHandler(handler: () => void) {\n if (handler && this.idleCallbacks)\n this.idleCallbacks.removeElement(handler);\n }\n\n private runIdleHandler() {\n if (this.idleCallbacks) {\n const ics = this.idleCallbacks.slice(0);\n ics.forEach(ic => ic());\n }\n }\n }\n let eventContexts: EventContext[];\n\n /**\n * Gets the current event context if any\n */\n export function eventContext(): EventContext {\n return eventContexts ? eventContexts[eventContexts.length - 1] : undefined;\n }\n\n /**\n * Pushes a new event context and clears all handlers\n */\n export function pushEventContext(): EventContext {\n if (!eventContexts)\n eventContexts = [];\n\n // unregister previous context\n const ctx = eventContext();\n if (ctx) ctx.unregister();\n // register again\n const n = new EventContext();\n eventContexts.push(n);\n return n;\n }\n\n /**\n * Pops the current event context and restore handlers if any previous context\n */\n export function popEventContext() {\n if (!eventContexts) return;\n\n // clear current context\n const ctx = eventContexts.pop();\n if (!ctx) return;\n ctx.unregister();\n\n // register old context again\n const context = eventContexts[eventContexts.length - 1];\n if (context)\n context.register();\n else\n eventContexts = undefined;\n }\n\n let _idleCallbacks: (() => void)[];\n /**\n * Registers a function to run when the device is idling\n * @param handler\n */\n export function onIdle(handler: () => void) {\n if (!handler) return;\n\n const ctx = eventContext();\n if (ctx) ctx.addIdleHandler(handler);\n else {\n if (!_idleCallbacks) {\n _idleCallbacks = [];\n control.runInBackground(function () {\n while (_idleCallbacks) {\n _idleCallbacks.slice(0).forEach(cb => cb());\n pause(20);\n }\n })\n /*\n control.internalOnEvent(\n 15. // DAL.DEVICE_ID_SCHEDULER\n 2, // DAL.DEVICE_SCHEDULER_EVT_IDLE\n function() {\n pins.LED.digitalWrite(on = !on);\n if (_idleCallbacks)\n _idleCallbacks.slice(0).forEach(cb => cb());\n }, 192); // MESSAGE_BUS_LISTENER_IMMEDIATE\n */\n }\n _idleCallbacks.push(handler);\n }\n }\n\n export function removeIdleHandler(handler: () => void) {\n if (!handler) return;\n const ctx = eventContext();\n if (ctx) ctx.removeIdleHandler(handler);\n else if (_idleCallbacks) _idleCallbacks.removeElement(handler);\n }\n}",
"fixed.ts": "interface Fx8 {\n _dummyFx8: string;\n}\n\nfunction Fx8(v: number) {\n return ((v * 256) | 0) as any as Fx8\n}\n\nnamespace Fx {\n export const zeroFx8 = 0 as any as Fx8\n export const oneHalfFx8 = 128 as any as Fx8\n export const oneFx8 = 256 as any as Fx8\n export const twoFx8 = 512 as any as Fx8\n\n export function neg(a: Fx8) {\n return (-(a as any as number)) as any as Fx8\n }\n export function toIntShifted(a: Fx8, n: number) {\n return (a as any as number) >> (n + 8)\n }\n export function add(a: Fx8, b: Fx8) {\n return ((a as any as number) + (b as any as number)) as any as Fx8\n }\n export function iadd(a: number, b: Fx8) {\n return ((a << 8) + (b as any as number)) as any as Fx8\n }\n export function sub(a: Fx8, b: Fx8) {\n return ((a as any as number) - (b as any as number)) as any as Fx8\n }\n export function mul(a: Fx8, b: Fx8) {\n return (Math.imul((a as any as number), (b as any as number)) >> 8) as any as Fx8\n }\n export function imul(a: Fx8, b: number) {\n return Math.imul((a as any as number), (b as any as number)) as any as Fx8\n }\n export function div(a: Fx8, b: Fx8) {\n return Math.idiv((a as any as number) << 8, b as any as number) as any as Fx8\n }\n export function idiv(a: Fx8, b: number) {\n return Math.idiv((a as any as number), b) as any as Fx8\n }\n export function compare(a: Fx8, b: Fx8) {\n return (a as any as number) - (b as any as number)\n }\n export function abs(a: Fx8) {\n if ((a as any as number) < 0)\n return (-(a as any as number)) as any as Fx8\n else\n return a\n }\n export function min(a: Fx8, b: Fx8) {\n if (a < b)\n return a\n else\n return b\n }\n export function max(a: Fx8, b: Fx8) {\n if (a > b)\n return a\n else\n return b\n }\n export function floor(v: Fx8): Fx8 {\n return ((v as any as number) & ~0xff) as any as Fx8;\n }\n export function ceil(v: Fx8): Fx8 {\n return (v as any as number) & 0xff ? Fx.floor(Fx.add(v, Fx.oneFx8)) : v;\n }\n export function leftShift(a: Fx8, n: number) {\n return (a as any as number << n) as any as Fx8\n }\n export function rightShift(a: Fx8, n: number) {\n return (a as any as number >> n) as any as Fx8\n }\n export function toInt(v: Fx8) {\n return ((v as any as number) + 128) >> 8\n }\n export function toFloat(v: Fx8) {\n return (v as any as number) / 256\n }\n}",
"forever.ts": "/**\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=loops/forever weight=100 afterOnStart=true blockNamespace=\"loops\"\n//% blockId=forever block=\"forever\" blockAllowMultiple=1\nfunction forever(a: () => void): void {\n loops.forever(a);\n}\n\n// micro:bit compatibility\n// these functions allow some level of reuse\n// between micro:bit and other maker-style editors\nnamespace basic {\n export function forever(a: () => void) {\n loops.forever(a);\n }\n}",
"gc.cpp": "#include \"pxtbase.h\"\n\n#ifndef GC_BLOCK_SIZE\n#define GC_BLOCK_SIZE (1024 * 16)\n#endif\n\n#ifndef GC_MAX_ALLOC_SIZE\n#define GC_MAX_ALLOC_SIZE (GC_BLOCK_SIZE - 16)\n#endif\n\n#ifndef GC_ALLOC_BLOCK\n#define GC_ALLOC_BLOCK xmalloc\n#endif\n\n#ifdef PXT64\n#define HIGH_SHIFT 48\n#define BYTES_TO_WORDS(x) ((x) >> 3)\n#define WORDS_TO_BYTES(x) ((x) << 3)\n#define ALIGN_TO_WORD(x) (((x) + 7) & (~7ULL))\n#define VAR_BLOCK_WORDS(vt) ((uint32_t)(uint64_t)(vt) >> 2)\n#else\n#define HIGH_SHIFT 28\n#define BYTES_TO_WORDS(x) ((x) >> 2)\n#define WORDS_TO_BYTES(x) ((x) << 2)\n#define ALIGN_TO_WORD(x) (((x) + 3) & (~3U))\n#define VAR_BLOCK_WORDS(vt) (((uint32_t)(vt) << 4) >> (4 + 2))\n#endif\n\n#define FREE_MASK (1ULL << (HIGH_SHIFT + 3))\n#define ARRAY_MASK (1ULL << (HIGH_SHIFT + 2))\n#define PERMA_MASK (1ULL << (HIGH_SHIFT + 1))\n#define MARKED_MASK 0x1\n#define ANY_MARKED_MASK 0x3\n\n// the bit operations should be faster than loading large constants\n#define IS_FREE(vt) ((uintptr_t)(vt) >> (HIGH_SHIFT + 3))\n#define IS_ARRAY(vt) (((uintptr_t)(vt) >> (HIGH_SHIFT + 2)) & 1)\n#define IS_PERMA(vt) (((uintptr_t)(vt) >> (HIGH_SHIFT + 1)) & 1)\n#define IS_VAR_BLOCK(vt) ((uintptr_t)(vt) >> (HIGH_SHIFT + 2))\n#define IS_MARKED(vt) ((uintptr_t)(vt)&MARKED_MASK)\n#define IS_LIVE(vt) (IS_MARKED(vt) || (((uintptr_t)(vt) >> (HIGH_SHIFT)) == 0x6))\n\n//#define PXT_GC_DEBUG 1\n#ifndef PXT_GC_CHECKS\n#define PXT_GC_CHECKS 1\n#endif\n//#define PXT_GC_STRESS 1\n\n//#define PXT_GC_CHECKS 1\n\n#define MARK(v) \\\n do { \\\n GC_CHECK(inGCArea(v), 42); \\\n *(uintptr_t *)(v) |= MARKED_MASK; \\\n } while (0)\n\n#ifdef PXT_GC_DEBUG\n#define LOG DMESG\n#define VLOG DMESG\n#define VVLOG DMESG\n#else\n#define LOG NOLOG\n#define VLOG NOLOG\n#define VVLOG NOLOG\n#endif\n\n#ifdef PXT_GC_CHECKS\n#define GC_CHECK(cond, code) \\\n if (!(cond)) \\\n oops(code)\n#else\n#define GC_CHECK(cond, code) ((void)0)\n#endif\n\nnamespace pxt {\n\n// keep in sync with base/control.ts, function gcStats()\nstruct GCStats {\n uint32_t numGC;\n uint32_t numBlocks;\n uint32_t totalBytes;\n uint32_t lastFreeBytes;\n uint32_t lastMaxBlockBytes;\n uint32_t minFreeBytes;\n};\n\nstatic GCStats gcStats;\n\n//% expose\nBuffer getGCStats() {\n return mkBuffer((uint8_t *)&gcStats, sizeof(gcStats));\n}\n\n//%\nvoid popThreadContext(ThreadContext *ctx);\n//%\nThreadContext *pushThreadContext(void *sp, void *endSP);\n\nunsigned RefRecord_gcsize(RefRecord *r) {\n VTable *tbl = getVTable(r);\n return BYTES_TO_WORDS(tbl->numbytes);\n}\n\n#ifdef PXT_GC_THREAD_LIST\nThreadContext *threadContexts;\n#endif\n\n#define IN_GC_ALLOC 1\n#define IN_GC_COLLECT 2\n#define IN_GC_FREEZE 4\n#define IN_GC_PREALLOC 8\n\n#ifndef PXT_VM\nstatic TValue *tempRoot;\nstatic uint8_t tempRootLen;\n#endif\n\nuint8_t inGC;\n\nvoid popThreadContext(ThreadContext *ctx) {\n#ifndef PXT_VM\n VLOG(\"pop: %p\", ctx);\n\n if (!ctx)\n return;\n\n auto n = ctx->stack.next;\n if (n) {\n VLOG(\"seg %p\", n);\n ctx->stack.top = n->top;\n ctx->stack.bottom = n->bottom;\n ctx->stack.next = n->next;\n app_free(n);\n } else {\n#ifdef PXT_GC_THREAD_LIST\n if (ctx->next)\n ctx->next->prev = ctx->prev;\n if (ctx->prev)\n ctx->prev->next = ctx->next;\n else {\n if (threadContexts != ctx)\n oops(41);\n threadContexts = ctx->next;\n if (threadContexts)\n threadContexts->prev = NULL;\n }\n#endif\n app_free(ctx);\n setThreadContext(NULL);\n }\n#endif\n}\n\n#define ALLOC(tp) (tp *)app_alloc(sizeof(tp))\n\nThreadContext *pushThreadContext(void *sp, void *endSP) {\n#ifdef PXT_VM\n return NULL;\n#else\n if (PXT_IN_ISR())\n target_panic(PANIC_CALLED_FROM_ISR);\n\n auto curr = getThreadContext();\n tempRoot = (TValue *)endSP;\n tempRootLen = (uintptr_t *)sp - (uintptr_t *)endSP;\n if (curr) {\n#ifdef PXT_GC_THREAD_LIST\n#ifdef PXT_GC_DEBUG\n auto ok = false;\n for (auto p = threadContexts; p; p = p->next)\n if (p == curr) {\n ok = true;\n break;\n }\n if (!ok)\n oops(49);\n#endif\n#endif\n auto seg = ALLOC(StackSegment);\n VLOG(\"stack %p / %p\", seg, curr);\n seg->top = curr->stack.top;\n seg->bottom = curr->stack.bottom;\n seg->next = curr->stack.next;\n curr->stack.next = seg;\n } else {\n curr = ALLOC(ThreadContext);\n LOG(\"push: %p\", curr);\n curr->globals = globals;\n curr->stack.next = NULL;\n curr->thrownValue = TAG_NON_VALUE;\n curr->tryFrame = NULL;\n\n#ifdef PXT_GC_THREAD_LIST\n curr->next = threadContexts;\n curr->prev = NULL;\n if (curr->next)\n curr->next->prev = curr;\n threadContexts = curr;\n#endif\n setThreadContext(curr);\n }\n tempRootLen = 0;\n curr->stack.bottom = sp;\n curr->stack.top = NULL;\n return curr;\n#endif\n}\n\nclass RefBlock : public RefObject {\n public:\n RefBlock *nextFree;\n};\n\nstruct GCBlock {\n GCBlock *next;\n uint32_t blockSize;\n RefObject data[0];\n};\n\nstruct PendingArray {\n PendingArray *next;\n TValue *data;\n unsigned len;\n};\n\n#define PENDING_ARRAY_THR 100\n\nstatic PendingArray *pendingArrays;\nstatic LLSegment gcRoots;\nLLSegment workQueue; // (ab)used by consString making\nstatic GCBlock *firstBlock;\nstatic RefBlock *firstFree;\nstatic uint8_t *midPtr;\n\nstatic bool inGCArea(void *ptr) {\n for (auto block = firstBlock; block; block = block->next) {\n if ((void *)block->data <= ptr && ptr < (void *)((uint8_t *)block->data + block->blockSize))\n return true;\n }\n return false;\n}\n\n#define NO_MAGIC(vt) ((VTable *)vt)->magic != VTABLE_MAGIC\n#define VT(p) (*(uintptr_t *)(p))\n#define SKIP_PROCESSING(p) \\\n (isReadOnly(p) || (VT(p) & (ANY_MARKED_MASK | ARRAY_MASK)) || NO_MAGIC(VT(p)))\n\nvoid gcMarkArray(void *data) {\n auto segBl = (uintptr_t *)data - 1;\n GC_CHECK(!IS_MARKED(VT(segBl)), 47);\n MARK(segBl);\n}\n\nvoid gcScan(TValue v) {\n if (SKIP_PROCESSING(v))\n return;\n MARK(v);\n workQueue.push(v);\n}\n\nvoid gcScanMany(TValue *data, unsigned len) {\n // VLOG(\"scan: %p %d\", data, len);\n for (unsigned i = 0; i < len; ++i) {\n auto v = data[i];\n // VLOG(\"psh: %p %d %d\", v, isReadOnly(v), (*(uint32_t *)v & 1));\n if (SKIP_PROCESSING(v))\n continue;\n MARK(v);\n workQueue.push(v);\n if (workQueue.getLength() > PENDING_ARRAY_THR) {\n i++;\n // store rest of the work for later, when we have cleared the queue\n auto pa = (PendingArray *)xmalloc(sizeof(PendingArray));\n pa->next = pendingArrays;\n pa->data = data + i;\n pa->len = len - i;\n pendingArrays = pa;\n break;\n }\n }\n}\n\nvoid gcScanSegment(Segment &seg) {\n auto data = seg.getData();\n if (!data)\n return;\n VVLOG(\"seg %p %d\", data, seg.getLength());\n gcMarkArray(data);\n gcScanMany(data, seg.getLength());\n}\n\n#define getScanMethod(vt) ((RefObjectMethod)(((VTable *)(vt))->methods[2]))\n#define getSizeMethod(vt) ((RefObjectSizeMethod)(((VTable *)(vt))->methods[3]))\n\nvoid gcProcess(TValue v) {\n if (SKIP_PROCESSING(v))\n return;\n VVLOG(\"gcProcess: %p\", v);\n MARK(v);\n auto scan = getScanMethod(VT(v) & ~ANY_MARKED_MASK);\n if (scan)\n scan((RefObject *)v);\n for (;;) {\n while (workQueue.getLength()) {\n auto curr = (RefObject *)workQueue.pop();\n VVLOG(\" - %p\", curr);\n scan = getScanMethod(curr->vt() & ~ANY_MARKED_MASK);\n if (scan)\n scan(curr);\n }\n if (pendingArrays) {\n auto pa = pendingArrays;\n pendingArrays = pa->next;\n auto data = pa->data;\n auto len = pa->len;\n xfree(pa);\n gcScanMany(data, len);\n } else {\n break;\n }\n }\n}\n\nstatic void mark(int flags) {\n#ifdef PXT_GC_DEBUG\n flags |= 2;\n#endif\n auto data = gcRoots.getData();\n auto len = gcRoots.getLength();\n if (flags & 2) {\n DMESG(\"--MARK\");\n DMESG(\"RP:%p/%d\", data, len);\n }\n for (unsigned i = 0; i < len; ++i) {\n auto d = data[i];\n if ((uintptr_t)d & 1) {\n d = *(TValue *)((uintptr_t)d & ~1);\n }\n gcProcess(d);\n }\n\n#ifdef PXT_GC_THREAD_LIST\n for (auto ctx = threadContexts; ctx; ctx = ctx->next) {\n gcProcess(ctx->thrownValue);\n for (auto seg = &ctx->stack; seg; seg = seg->next) {\n auto ptr = (TValue *)threadAddressFor(ctx, seg->top);\n auto end = (TValue *)threadAddressFor(ctx, seg->bottom);\n VLOG(\"mark: %p - %p\", ptr, end);\n while (ptr < end) {\n gcProcess(*ptr++);\n }\n }\n }\n#else\n gcProcessStacks(flags);\n#endif\n\n if (globals) {\n#ifdef PXT_VM\n auto nonPtrs = vmImg->infoHeader->nonPointerGlobals;\n#else\n auto nonPtrs = bytecode[21];\n#endif\n len = getNumGlobals() - nonPtrs;\n data = globals + nonPtrs;\n if (flags & 2)\n DMESG(\"RG:%p/%d\", data, len);\n VLOG(\"globals: %p %d\", data, len);\n for (unsigned i = 0; i < len; ++i) {\n gcProcess(*data++);\n }\n }\n\n#ifndef PXT_VM\n data = tempRoot;\n len = tempRootLen;\n for (unsigned i = 0; i < len; ++i) {\n gcProcess(*data++);\n }\n#endif\n}\n\nstatic uint32_t getObjectSize(RefObject *o) {\n auto vt = o->vt() & ~ANY_MARKED_MASK;\n uint32_t r;\n GC_CHECK(vt != 0, 49);\n if (IS_VAR_BLOCK(vt)) {\n r = VAR_BLOCK_WORDS(vt);\n } else {\n auto sz = getSizeMethod(vt);\n // GC_CHECK(0x2000 <= (intptr_t)sz && (intptr_t)sz <= 0x100000, 47);\n r = sz(o);\n }\n GC_CHECK(1 <= r && (r <= BYTES_TO_WORDS(GC_MAX_ALLOC_SIZE) || IS_FREE(vt)), 41);\n return r;\n}\n\nstatic void setupFreeBlock(GCBlock *curr) {\n gcStats.numBlocks++;\n gcStats.totalBytes += curr->blockSize;\n curr->data[0].setVT(FREE_MASK | (TOWORDS(curr->blockSize) << 2));\n ((RefBlock *)curr->data)[0].nextFree = firstFree;\n firstFree = (RefBlock *)curr->data;\n midPtr = (uint8_t *)curr->data + curr->blockSize / 4;\n}\n\nstatic void linkFreeBlock(GCBlock *curr) {\n // blocks need to be sorted by address for midPtr to work\n if (!firstBlock || curr < firstBlock) {\n curr->next = firstBlock;\n firstBlock = curr;\n } else {\n for (auto p = firstBlock; p; p = p->next) {\n if (!p->next || curr < p->next) {\n curr->next = p->next;\n p->next = curr;\n break;\n }\n }\n }\n}\n\nvoid gcPreAllocateBlock(uint32_t sz) {\n auto curr = (GCBlock *)GC_ALLOC_BLOCK(sz);\n curr->blockSize = sz - sizeof(GCBlock);\n LOG(\"GC pre-alloc: %p\", curr);\n GC_CHECK((curr->blockSize & 3) == 0, 40);\n setupFreeBlock(curr);\n linkFreeBlock(curr);\n}\n\nstatic GCBlock *allocateBlockCore() {\n int sz = GC_BLOCK_SIZE;\n void *dummy = NULL;\n#ifdef GC_GET_HEAP_SIZE\n if (firstBlock) {\n#ifdef GC_STACK_BASE\n if (!firstBlock->next) {\n int memSize = getConfig(CFG_RAM_BYTES, 0);\n int codalEnd = GC_STACK_BASE;\n // round up to 1k - there is sometimes a few bytes below the stack\n codalEnd = (codalEnd + 1024) & ~1023;\n int codalSize = codalEnd & 0xffffff;\n sz = memSize - codalSize - 4;\n if (sz > 0) {\n auto curr = (GCBlock *)codalEnd;\n curr->blockSize = sz - sizeof(GCBlock);\n return curr;\n }\n }\n#endif\n gc(2); // dump roots\n soft_panic(PANIC_GC_OOM);\n }\n auto lowMem = getConfig(CFG_LOW_MEM_SIMULATION_KB, 0);\n auto sysHeapSize = getConfig(CFG_SYSTEM_HEAP_BYTES, 4 * 1024);\n auto heapSize = GC_GET_HEAP_SIZE();\n sz = heapSize - sysHeapSize;\n if (lowMem) {\n auto memIncrement = 32 * 1024;\n // get the memory size - assume it's increment of 32k,\n // and we don't statically allocate more than 32k\n auto memSize = ((heapSize + memIncrement - 1) / memIncrement) * memIncrement;\n int fillerSize = memSize - lowMem * 1024;\n if (fillerSize > 0) {\n dummy = GC_ALLOC_BLOCK(fillerSize);\n sz -= fillerSize;\n }\n }\n#endif\n auto curr = (GCBlock *)GC_ALLOC_BLOCK(sz);\n curr->blockSize = sz - sizeof(GCBlock);\n // make sure reference to allocated block is stored somewhere, otherwise\n // GCC optimizes out the call to GC_ALLOC_BLOCK\n curr->data[4].setVT((uintptr_t)dummy);\n return curr;\n}\n\n__attribute__((noinline)) static void allocateBlock() {\n auto curr = allocateBlockCore();\n DMESG(\"GC block %db @ %p\", curr->blockSize, curr);\n GC_CHECK((curr->blockSize & 3) == 0, 40);\n setupFreeBlock(curr);\n linkFreeBlock(curr);\n}\n\nstatic void sweep(int flags) {\n RefBlock *prevFreePtr = NULL;\n uint32_t freeSize = 0;\n uint32_t totalSize = 0;\n uint32_t maxFreeBlock = 0;\n firstFree = NULL;\n\n gcStats.numGC++;\n\n for (auto h = firstBlock; h; h = h->next) {\n auto d = h->data;\n auto words = BYTES_TO_WORDS(h->blockSize);\n auto end = d + words;\n totalSize += words;\n VLOG(\"sweep: %p - %p\", d, end);\n while (d < end) {\n if (IS_LIVE(d->vtable)) {\n VVLOG(\"Live %p\", d);\n d->setVT(d->vt() & ~MARKED_MASK);\n d += getObjectSize(d);\n } else {\n auto start = (RefBlock *)d;\n while (d < end) {\n if (IS_FREE(d->vtable)) {\n VVLOG(\"Free %p\", d);\n } else if (IS_LIVE(d->vtable)) {\n break;\n } else if (IS_ARRAY(d->vtable)) {\n VVLOG(\"Dead Arr %p\", d);\n } else {\n VVLOG(\"Dead Obj %p\", d);\n GC_CHECK(d->vtable->magic == VTABLE_MAGIC, 41);\n d->destroyVT();\n VVLOG(\"destroyed\");\n }\n d += getObjectSize(d);\n }\n auto sz = d - (RefObject *)start;\n freeSize += sz;\n if (sz > (int)maxFreeBlock)\n maxFreeBlock = sz;\n#ifdef PXT_GC_CHECKS\n memset((void *)start, 0xff, WORDS_TO_BYTES(sz));\n#endif\n start->setVT((sz << 2) | FREE_MASK);\n if (sz > 1) {\n start->nextFree = NULL;\n if (!prevFreePtr) {\n firstFree = start;\n } else {\n prevFreePtr->nextFree = start;\n }\n prevFreePtr = start;\n }\n }\n }\n }\n\n if (midPtr) {\n uint32_t currFree = 0;\n#ifdef PXT_ESP32\n auto limit = freeSize * 1 / 4;\n#else\n auto limit = freeSize * 1 / 2;\n#endif\n for (auto p = firstFree; p; p = p->nextFree) {\n auto len = VAR_BLOCK_WORDS(p->vtable);\n currFree += len;\n if (currFree > limit) {\n midPtr = (uint8_t *)p + ((limit - currFree + len) << 2);\n break;\n }\n }\n }\n\n freeSize = WORDS_TO_BYTES(freeSize);\n totalSize = WORDS_TO_BYTES(totalSize);\n maxFreeBlock = WORDS_TO_BYTES(maxFreeBlock);\n\n gcStats.lastFreeBytes = freeSize;\n gcStats.lastMaxBlockBytes = maxFreeBlock;\n\n if (gcStats.minFreeBytes == 0 || gcStats.minFreeBytes > freeSize)\n gcStats.minFreeBytes = freeSize;\n\n if (flags & 1)\n DMESG(\"GC %d/%d free; %d maxBlock\", freeSize, totalSize, maxFreeBlock);\n else\n LOG(\"GC %d/%d free; %d maxBlock\", freeSize, totalSize, maxFreeBlock);\n\n#ifndef GC_GET_HEAP_SIZE\n // if the heap is 90% full, allocate a new block\n if (freeSize * 10 <= totalSize) {\n allocateBlock();\n }\n#endif\n}\n\nvoid gc(int flags) {\n startPerfCounter(PerfCounters::GC);\n GC_CHECK(!(inGC & IN_GC_COLLECT), 40);\n inGC |= IN_GC_COLLECT;\n VLOG(\"GC mark\");\n mark(flags);\n VLOG(\"GC sweep\");\n sweep(flags);\n VLOG(\"GC done\");\n stopPerfCounter(PerfCounters::GC);\n inGC &= ~IN_GC_COLLECT;\n}\n\n#ifdef GC_GET_HEAP_SIZE\nextern \"C\" void free(void *ptr) {\n if (!ptr)\n return;\n if (inGCArea(ptr))\n app_free(ptr);\n else\n xfree(ptr);\n}\n\nextern \"C\" void *malloc(size_t sz) {\n if (PXT_IN_ISR() || inGC)\n return xmalloc(sz);\n else\n return app_alloc(sz);\n}\n\nextern \"C\" void *realloc(void *ptr, size_t size) {\n if (inGCArea(ptr)) {\n void *mem = malloc(size);\n\n if (ptr != NULL && mem != NULL) {\n auto r = (uintptr_t *)ptr;\n GC_CHECK((r[-1] >> (HIGH_SHIFT + 1)) == 3, 41);\n size_t blockSize = VAR_BLOCK_WORDS(r[-1]);\n memcpy(mem, ptr, min(blockSize * sizeof(void *), size));\n free(ptr);\n }\n\n return mem;\n } else {\n return device_realloc(ptr, size);\n }\n}\n#endif\n\nvoid *gcAllocateArray(int numbytes) {\n numbytes = ALIGN_TO_WORD(numbytes);\n numbytes += sizeof(void *);\n auto r = (uintptr_t *)gcAllocate(numbytes);\n *r = ARRAY_MASK | (TOWORDS(numbytes) << 2);\n return r + 1;\n}\n\nstatic void *gcAllocAt(void *hint, int numbytes) {\n gc(0);\n size_t numwords = BYTES_TO_WORDS(ALIGN_TO_WORD(numbytes));\n\n for (auto p = firstFree; p; p = p->nextFree) {\n GC_CHECK(!isReadOnly((TValue)p), 49);\n auto vt = p->vtable;\n GC_CHECK(IS_FREE(vt), 43);\n int offset = BYTES_TO_WORDS((uint8_t *)hint - (uint8_t *)p);\n int left = (int)(VAR_BLOCK_WORDS(vt) - numwords - offset);\n // we give ourselves some space here, so we don't get some strange overlaps\n if (offset >= 8 && left >= 8) {\n auto nf = (RefBlock *)((void **)p + numwords + offset);\n nf->setVT((left << 2) | FREE_MASK);\n nf->nextFree = p->nextFree;\n p->nextFree = nf;\n p->setVT((offset << 2) | FREE_MASK);\n p = (RefBlock *)((void **)p + offset);\n p->setVT(0);\n return p;\n }\n }\n\n return NULL;\n}\n\nvoid *app_alloc_at(void *at, int numbytes) {\n if (numbytes < 8)\n return NULL;\n if (!at)\n return NULL;\n\n numbytes = ALIGN_TO_WORD(numbytes) + sizeof(void *);\n auto r = (uintptr_t *)gcAllocAt((uintptr_t *)at - 1, numbytes);\n if (!r)\n return NULL;\n *r = ARRAY_MASK | PERMA_MASK | (TOWORDS(numbytes) << 2);\n gc(0);\n return r + 1;\n}\n\nvoid *app_alloc(int numbytes) {\n if (!numbytes)\n return NULL;\n\n // gc(0);\n auto r = (uintptr_t *)gcAllocateArray(numbytes);\n r[-1] |= PERMA_MASK;\n return r;\n}\n\nvoid *app_free(void *ptr) {\n auto r = (uintptr_t *)ptr;\n GC_CHECK((r[-1] >> (HIGH_SHIFT + 1)) == 3, 41);\n r[-1] |= FREE_MASK;\n return r;\n}\n\nvoid gcFreeze() {\n inGC |= IN_GC_FREEZE;\n}\n\nvoid gcReset() {\n inGC &= ~IN_GC_FREEZE;\n\n gcRoots.setLength(0);\n\n if (inGC)\n oops(41);\n\n if (workQueue.getLength())\n oops(41);\n\n memset(&gcStats, 0, sizeof(gcStats));\n firstFree = NULL;\n for (auto h = firstBlock; h; h = h->next) {\n setupFreeBlock(h);\n }\n}\n\n#ifdef PXT_VM\nvoid gcPreStartup() {\n inGC |= IN_GC_PREALLOC;\n}\n\nvoid gcStartup() {\n inGC &= ~IN_GC_PREALLOC;\n}\n#endif\n\nvoid *gcAllocate(int numbytes) {\n size_t numwords = BYTES_TO_WORDS(ALIGN_TO_WORD(numbytes));\n // VVLOG(\"alloc %d bytes %d words\", numbytes, numwords);\n\n if (numbytes > GC_MAX_ALLOC_SIZE)\n soft_panic(PANIC_GC_TOO_BIG_ALLOCATION);\n\n if (PXT_IN_ISR() || (inGC & (IN_GC_PREALLOC | IN_GC_ALLOC | IN_GC_COLLECT | IN_GC_FREEZE)))\n target_panic(PANIC_CALLED_FROM_ISR);\n\n inGC |= IN_GC_ALLOC;\n\n#if defined(PXT_GC_CHECKS) && !defined(PXT_VM)\n {\n auto curr = getThreadContext();\n if (curr && !curr->stack.top)\n oops(46);\n }\n#endif\n\n#ifdef PXT_GC_STRESS\n gc(0);\n#endif\n\n for (int i = 0;; ++i) {\n RefBlock *prev = NULL;\n for (auto p = firstFree; p; p = p->nextFree) {\n VVLOG(\"p=%p\", p);\n if (i == 0 && (uint8_t *)p > midPtr) {\n VLOG(\"past midptr %p; gc\", midPtr);\n break;\n }\n GC_CHECK(!isReadOnly((TValue)p), 49);\n auto vt = p->vtable;\n if (!IS_FREE(vt))\n oops(43);\n int left = (int)(VAR_BLOCK_WORDS(vt) - numwords);\n VVLOG(\"%p %d - %d = %d\", (void *)vt, (int)VAR_BLOCK_WORDS(vt), (int)numwords, left);\n if (left >= 0) {\n auto nf = (RefBlock *)((void **)p + numwords);\n auto nextFree = p->nextFree; // p and nf can overlap when allocating 4 bytes\n // VVLOG(\"nf=%p nef=%p\", nf, nextFree);\n if (left)\n nf->setVT((left << 2) | FREE_MASK);\n if (left >= 2) {\n nf->nextFree = nextFree;\n } else {\n nf = nextFree;\n }\n if (prev)\n prev->nextFree = nf;\n else\n firstFree = nf;\n p->setVT(0);\n VVLOG(\"GC=>%p %d %p -> %p,%p\", p, numwords, nf, nf ? nf->nextFree : 0,\n nf ? (void *)nf->vtable : 0);\n GC_CHECK(!nf || !nf->nextFree || !isReadOnly((TValue)nf->nextFree), 48);\n inGC &= ~IN_GC_ALLOC;\n return p;\n }\n prev = p;\n }\n\n // we didn't find anything, try GC\n if (i == 0)\n gc(0);\n // GC didn't help, try new block\n else if (i == 1) {\n DMESG(\"gcAlloc(%d) (%d/%d free; %d max block) -> new block\", numbytes,\n gcStats.lastFreeBytes, gcStats.totalBytes, gcStats.lastMaxBlockBytes);\n allocateBlock();\n } else\n // the block allocated was apparently too small\n soft_panic(PANIC_GC_OOM);\n }\n}\n\nstatic void removePtr(TValue v) {\n int len = gcRoots.getLength();\n auto data = gcRoots.getData();\n // scan from the back, as this is often used as a stack\n for (int i = len - 1; i >= 0; --i) {\n if (data[i] == v) {\n if (i == len - 1) {\n gcRoots.pop();\n } else {\n data[i] = gcRoots.pop();\n }\n return;\n }\n }\n oops(40);\n}\n\nvoid registerGC(TValue *root, int numwords) {\n if (!numwords)\n return;\n\n if (numwords > 1) {\n while (numwords-- > 0) {\n registerGC(root++, 1);\n }\n return;\n }\n\n gcRoots.push((TValue)((uintptr_t)root | 1));\n}\n\nvoid unregisterGC(TValue *root, int numwords) {\n if (!numwords)\n return;\n if (numwords > 1) {\n while (numwords-- > 0) {\n unregisterGC(root++, 1);\n }\n return;\n }\n\n removePtr((TValue)((uintptr_t)root | 1));\n}\n\nvoid registerGCPtr(TValue ptr) {\n if (isReadOnly(ptr))\n return;\n gcRoots.push(ptr);\n}\n\nvoid unregisterGCPtr(TValue ptr) {\n if (isReadOnly(ptr))\n return;\n removePtr(ptr);\n}\n\nvoid RefImage::scan(RefImage *t) {\n gcScan((TValue)t->buffer);\n}\n\nvoid RefCollection::scan(RefCollection *t) {\n gcScanSegment(t->head);\n}\n\nvoid RefAction::scan(RefAction *t) {\n gcScanMany(t->fields, t->len);\n}\n\nvoid RefRefLocal::scan(RefRefLocal *t) {\n gcScan(t->v);\n}\n\nvoid RefMap::scan(RefMap *t) {\n gcScanSegment(t->keys);\n gcScanSegment(t->values);\n}\n\nvoid RefRecord_scan(RefRecord *r) {\n VTable *tbl = getVTable(r);\n gcScanMany(r->fields, BYTES_TO_WORDS(tbl->numbytes - sizeof(RefRecord)));\n}\n\n#define SIZE(off) TOWORDS(sizeof(*t) + (off))\n\nunsigned RefImage::gcsize(RefImage *t) {\n return SIZE(0);\n}\n\nunsigned RefCollection::gcsize(RefCollection *t) {\n return SIZE(0);\n}\n\nunsigned RefAction::gcsize(RefAction *t) {\n return SIZE(WORDS_TO_BYTES(t->len));\n}\n\nunsigned RefRefLocal::gcsize(RefRefLocal *t) {\n return SIZE(0);\n}\n\nunsigned RefMap::gcsize(RefMap *t) {\n return SIZE(0);\n}\n\n} // namespace pxt\n",
"gcstats.ts": "namespace control {\n //% shim=pxt::getGCStats\n function getGCStats(): Buffer {\n return null\n }\n\n export interface GCStats {\n numGC: number;\n numBlocks: number;\n totalBytes: number;\n lastFreeBytes: number;\n lastMaxBlockBytes: number;\n minFreeBytes: number;\n }\n\n /**\n * Get various statistics about the garbage collector (GC)\n */\n export function gcStats(): GCStats {\n const buf = getGCStats()\n if (!buf)\n return null\n let off = 0\n const res: any = {}\n\n addField(\"numGC\")\n addField(\"numBlocks\")\n addField(\"totalBytes\")\n addField(\"lastFreeBytes\")\n addField(\"lastMaxBlockBytes\")\n addField(\"minFreeBytes\")\n\n return res\n\n function addField(name: string) {\n res[name] = buf.getNumber(NumberFormat.UInt32LE, off)\n off += 4\n }\n } \n}",
"interval.ts": "namespace control {\n export enum IntervalMode {\n Interval,\n Timeout,\n Immediate\n }\n\n let _intervals: Interval[] = undefined;\n class Interval {\n\n id: number;\n func: () => void;\n delay: number;\n mode: IntervalMode;\n\n constructor(func: () => void, delay: number, mode: IntervalMode) {\n this.id = _intervals.length == 0\n ? 1 : _intervals[_intervals.length - 1].id + 1;\n this.func = func;\n this.delay = delay;\n this.mode = mode;\n _intervals.push(this);\n\n control.runInParallel(() => this.work());\n }\n\n work() {\n // execute\n switch (this.mode) {\n case IntervalMode.Immediate:\n case IntervalMode.Timeout:\n if (this.delay > 0)\n pause(this.delay); // timeout\n if (this.delay >= 0) // immediate, timeout\n this.func();\n break;\n case IntervalMode.Interval:\n while (this.delay > 0) {\n pause(this.delay);\n // might have been cancelled during this duration\n if (this.delay > 0)\n this.func();\n }\n break;\n }\n // remove from interval array\n _intervals.removeElement(this);\n }\n\n cancel() {\n this.delay = -1;\n }\n }\n\n export function setInterval(func: () => void, delay: number, mode: IntervalMode): number {\n if (!func || delay < 0) return 0;\n if (!_intervals) _intervals = [];\n const interval = new Interval(func, delay, mode);\n return interval.id;\n }\n\n export function clearInterval(intervalId: number, mode: IntervalMode): void {\n if (!_intervals) return;\n for (let i = 0; i < _intervals.length; ++i) {\n const it = _intervals[i];\n if (it.id == intervalId && it.mode == mode) {\n it.cancel();\n break;\n }\n }\n }\n}",
"json.ts": "namespace JSON {\n export function parseIntRadix(s: string, base?: number) {\n if (base == null || base == 10) {\n return parseFloat(s) | 0\n }\n\n let m = false\n let r = 0\n for (let i = 0; i < s.length; ++i) {\n let c = s.charCodeAt(i)\n if (c == 0x20 || c == 10 || c == 13 || c == 9)\n continue\n if (r == 0 && !m && c == 0x2d) {\n m = true\n continue\n }\n\n let v = -1\n if (0x30 <= c && c <= 0x39)\n v = c - 0x30\n else {\n c |= 0x20\n if (0x61 <= c && c <= 0x7a)\n v = c - 0x61 + 10\n }\n\n if (0 <= v && v < base) {\n r *= base\n r += v\n } else {\n return undefined\n }\n }\n\n return m ? -r : r\n }\n\n\n class Parser {\n ptr: number\n s: string\n errorMsg: string\n\n error(msg: string) {\n if (!this.errorMsg) {\n this.errorMsg = msg + \" at position \" + this.ptr\n this.ptr = this.s.length\n }\n }\n\n skipWS() {\n for (; ;) {\n const c = this.nextChar()\n if (c == 0x20 || c == 0x0a || c == 0x0d || c == 0x09) {\n // OK\n } else {\n this.ptr--\n return c\n }\n }\n }\n\n nextChar() {\n if (this.ptr < this.s.length)\n return this.s.charCodeAt(this.ptr++)\n return 0\n }\n\n doString() {\n let r = \"\"\n this.ptr++\n for (; ;) {\n const c = this.s.charAt(this.ptr++)\n if (c == \"\\\"\")\n return r\n if (c == \"\\\\\") {\n let q = this.s.charAt(this.ptr++)\n if (q == \"b\") q = \"\\b\"\n else if (q == \"n\") q = \"\\n\"\n else if (q == \"r\") q = \"\\r\"\n else if (q == \"t\") q = \"\\t\"\n else if (q == \"u\") {\n q = String.fromCharCode(parseIntRadix(this.s.slice(this.ptr, this.ptr + 4), 16))\n this.ptr += 4\n }\n r += q\n } else {\n r += c\n }\n }\n }\n\n doArray(): any[] {\n const r = []\n this.ptr++\n for (; ;) {\n let c = this.skipWS()\n if (c == 0x5d) {\n this.ptr++\n return r\n }\n const v = this.value()\n if (this.errorMsg)\n return null\n r.push(v)\n c = this.skipWS()\n if (c == 0x2c) {\n this.ptr++\n continue\n }\n if (c == 0x5d)\n continue\n this.error(\"expecting comma\")\n }\n }\n\n doObject() {\n const r: any = {}\n this.ptr++\n for (; ;) {\n let c = this.skipWS()\n if (c == 0x7d) {\n this.ptr++\n return r\n }\n if (c != 0x22) {\n this.error(\"expecting key\")\n return r\n }\n const k = this.doString()\n c = this.skipWS()\n if (c != 0x3a) {\n this.error(\"expecting colon\")\n return r\n }\n this.ptr++\n const v = this.value()\n if (this.errorMsg)\n return null\n r[k] = v\n c = this.skipWS()\n if (c == 0x2c) {\n this.ptr++\n continue\n }\n if (c == 0x7d)\n continue\n this.error(\"expecting comma, got \" + String.fromCharCode(c))\n }\n }\n\n doNumber() {\n const beg = this.ptr\n for (; ;) {\n const c = this.nextChar()\n if ((0x30 <= c && c <= 0x39) || c == 0x2b || c == 0x2d || c == 0x2e || c == 0x45 || c == 0x65) {\n // one more\n } else {\n this.ptr--\n break\n }\n }\n const ss = this.s.slice(beg, this.ptr)\n if (ss.length == 0) {\n this.error(\"expecting number\")\n return 0\n }\n return parseFloat(ss)\n }\n\n checkKw(k: string) {\n if (this.s.slice(this.ptr, this.ptr + k.length) == k) {\n this.ptr += k.length\n return true\n }\n return false\n }\n\n value() {\n if (this.errorMsg)\n return null\n\n const c = this.skipWS()\n if (c == 0x7b)\n return this.doObject()\n else if (c == 0x5b)\n return this.doArray()\n else if ((0x30 <= c && c <= 0x39) || c == 0x2d)\n return this.doNumber()\n else if (c == 0x22)\n return this.doString()\n else if (c == 0x74 && this.checkKw(\"true\"))\n return true\n else if (c == 0x66 && this.checkKw(\"false\"))\n return false\n else if (c == 0x6e && this.checkKw(\"null\"))\n return null\n\n this.error(\"unexpected token\")\n return null\n }\n }\n\n class Stringifier {\n currIndent: string\n indentStep: string\n indent: number\n\n doString(s: string) {\n let r = \"\\\"\"\n for (let i = 0; i < s.length; ++i) {\n let c = s[i]\n if (c == \"\\n\") c = \"\\\\n\"\n else if (c == \"\\r\") c = \"\\\\r\"\n else if (c == \"\\t\") c = \"\\\\t\"\n else if (c == \"\\b\") c = \"\\\\b\"\n else if (c == \"\\\\\") c = \"\\\\\\\\\"\n else if (c == \"\\\"\") c = \"\\\\\\\"\"\n r += c\n }\n return r + \"\\\"\"\n }\n\n go(v: any) {\n const t = typeof v\n if (t == \"string\")\n return this.doString(v)\n else if (t == \"boolean\" || t == \"number\" || v == null)\n return \"\" + v\n else if (Array.isArray(v)) {\n const arr = v as any[]\n if (arr.length == 0)\n return \"[]\"\n else {\n let r = \"[\"\n if (this.indent) {\n this.currIndent += this.indentStep\n r += \"\\n\"\n }\n for (let i = 0; i < arr.length; ++i) {\n r += this.currIndent + this.go(arr[i])\n if (i != arr.length - 1)\n r += \",\"\n if (this.indent)\n r += \"\\n\"\n }\n if (this.indent)\n this.currIndent = this.currIndent.slice(this.indent)\n r += this.currIndent + \"]\"\n return r\n }\n } else {\n const keys = Object.keys(v)\n if (keys.length == 0)\n return \"{}\"\n\n let r = \"{\"\n if (this.indent) {\n this.currIndent += this.indentStep\n r += \"\\n\"\n }\n for (let i = 0; i < keys.length; ++i) {\n const k = keys[i]\n r += this.currIndent + this.doString(k)\n if (this.indent)\n r += \": \"\n else\n r += \":\"\n r += this.go(v[k])\n if (i != keys.length - 1)\n r += \",\"\n if (this.indent)\n r += \"\\n\"\n }\n if (this.indent)\n this.currIndent = this.currIndent.slice(this.indent)\n r += this.currIndent + \"}\"\n return r\n }\n }\n }\n\n /**\n * Converts a JavaScript value to a JavaScript Object Notation (JSON) string.\n * @param value A JavaScript value, usually an object or array, to be converted.\n * @param replacer Not supported; use null.\n * @param indent Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.\n */\n export function stringify(value: any, replacer: any = null, indent: number = 0) {\n const ss = new Stringifier()\n ss.currIndent = \"\"\n indent |= 0\n if (indent < 0) indent = 0\n if (indent > 10) indent = 10\n ss.indentStep = \"\"\n ss.currIndent = \"\"\n ss.indent = indent\n while (indent-- > 0)\n ss.indentStep += \" \"\n return ss.go(value)\n }\n\n\n /**\n * Converts a JavaScript Object Notation (JSON) string into an object.\n * @param text A valid JSON string.\n */\n export function parse(s: string) {\n const p = new Parser()\n p.ptr = 0\n p.s = s\n const r = p.value()\n if (p.skipWS()) {\n p.error(\"excessive input\")\n }\n if (p.errorMsg) {\n control.dmesg(\"Invalid JSON: \" + p.errorMsg)\n return undefined\n }\n return r\n }\n}\n",
"loops.cpp": "#include \"pxtbase.h\"\n\nnamespace loops {\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=loops/forever weight=100 afterOnStart=true deprecated=true\n//% blockId=forever_deprecated block=\"forever\" blockAllowMultiple=1\nvoid forever(Action a) {\n runForever(a);\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 */\n//% help=loops/pause weight=99 deprecated=true\n//% async block=\"pause %pause=timePicker|ms\"\n//% blockId=device_pause_deprecated\nvoid pause(int ms) {\n if (ms < 0) return;\n sleep_ms(ms);\n}\n\n}",
"math.ts": "namespace Math {\n\n export const E = 2.718281828459045;\n export const LN2 = 0.6931471805599453;\n export const LN10 = 2.302585092994046;\n export const LOG2E = 1.4426950408889634;\n export const LOG10E = 0.4342944819032518;\n export const PI = 3.141592653589793;\n export const SQRT1_2 = 0.7071067811865476;\n export const SQRT2 = 1.4142135623730951;\n\n /**\n * Re-maps a number from one range to another. That is, a value of ``from low`` would get mapped to ``to low``, a value of ``from high`` to ``to high``, values in-between to values in-between, etc.\n * @param value value to map in ranges\n * @param fromLow the lower bound of the value's current range\n * @param fromHigh the upper bound of the value's current range, eg: 1023\n * @param toLow the lower bound of the value's target range\n * @param toHigh the upper bound of the value's target range, eg: 4\n */\n //% help=math/map weight=10 blockGap=8\n //% blockId=math_map block=\"map %value|from low %fromLow|high %fromHigh|to low %toLow|high %toHigh\"\n //% inlineInputMode=inline\n export function map(value: number, fromLow: number, fromHigh: number, toLow: number, toHigh: number): number {\n return ((value - fromLow) * (toHigh - toLow)) / (fromHigh - fromLow) + toLow;\n } \n\n /**\n * Constrains a number to be within a range\n * @param x the number to constrain, all data types\n * @param y the lower end of the range, all data types\n * @param z the upper end of the range, all data types\n */\n //% help=math/constrain weight=11 blockGap=8\n //% blockId=\"math_constrain_value\" block=\"constrain %value|between %low|and %high\"\n export function constrain(value: number, low: number, high: number): number {\n return value < low ? low : value > high ? high : value;\n }\n\n const b_m16: number[] = [0, 49, 49, 41, 90, 27, 117, 10]\n /**\n * Returns the sine of an input angle. This is an 8-bit approximation.\n * @param theta input angle from 0-255\n */\n //% help=math/isin weight=11 advanced=true blockGap=8\n export function isin(theta: number) {\n //reference: based on FASTLed's sin approximation method: [https://github.com/FastLED/FastLED](MIT)\n let offset = theta;\n if( theta & 0x40 ) {\n offset = 255 - offset;\n }\n offset &= 0x3F; // 0..63\n\n let secoffset = offset & 0x0F; // 0..15\n if( theta & 0x40) secoffset++;\n\n let section = offset >> 4; // 0..3\n let s2 = section * 2;\n\n let b = b_m16[s2];\n let m16 = b_m16[s2+1];\n let mx = (m16 * secoffset) >> 4;\n \n let y = mx + b;\n if( theta & 0x80 ) y = -y;\n\n y += 128;\n\n return y;\n }\n\n /**\n * Returns the cosine of an input angle. This is an 8-bit approximation. \n * @param theta input angle from 0-255\n */\n //% help=math/icos weight=10 advanced=true blockGap=8\n export function icos(theta: number) {\n return isin(theta + 16384);\n }\n}\n\nnamespace Number {\n export const EPSILON = 2.220446049250313e-16;\n}",
"ns.ts": "\n/**\n * Respond to and read data from buttons and sensors.\n */\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\nnamespace input {\n}\n",
"pause.ts": "/**\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=loops/pause weight=99\n//% async block=\"pause %pause=timePicker|ms\"\n//% blockId=device_pause blockNamespace=\"loops\"\nfunction pause(ms: number): void {\n loops.pause(ms);\n}\n\n// micro:bit compatibility\n// these functions allow some level of reuse\n// between micro:bit and other maker-style editors\nnamespace basic {\n export function pause(millis: number) {\n loops.pause(millis);\n }\n}",
"perfcounters.ts": "namespace control {\n /**\n * Enable profiling for current function.\n */\n //% shim=TD_NOOP shimArgument=perfCounter\n export function enablePerfCounter(name?: string) { }\n\n /**\n * Dump values of profiling performance counters.\n */\n //% shim=pxt::dumpPerfCounters\n export function dmesgPerfCounters() { }\n}\n",
"poll.ts": "namespace control {\n class PollEvent {\n public eid: number;\n public vid: number;\n public start: number;\n public timeOut: number;\n public condition: () => boolean;\n public once: boolean;\n constructor(eid: number, vid: number, start: number, timeOut: number, condition: () => boolean, once: boolean) {\n this.eid = eid;\n this.vid = vid;\n this.start = start;\n this.timeOut = timeOut;\n this.condition = condition;\n this.once = once;\n }\n }\n\n let _pollEventQueue: PollEvent[] = undefined;\n\n function pollEvents() {\n while (_pollEventQueue.length > 0) {\n const now = control.millis();\n for (let i = 0; i < _pollEventQueue.length; ++i) {\n const ev = _pollEventQueue[i];\n if (ev.condition() || (ev.timeOut > 0 && now - ev.start > ev.timeOut)) {\n control.raiseEvent(ev.eid, ev.vid);\n if (ev.once) {\n _pollEventQueue.splice(i, 1);\n --i;\n }\n }\n }\n pause(50);\n }\n // release fiber\n _pollEventQueue = undefined;\n }\n\n export function __queuePollEvent(timeOut: number, condition: () => boolean, handler: () => void) {\n const ev = new PollEvent(\n DAL.DEVICE_ID_NOTIFY,\n control.allocateNotifyEvent(),\n control.millis(),\n timeOut,\n condition,\n !handler\n );\n\n // start polling fiber if needed\n if (!_pollEventQueue) {\n _pollEventQueue = [ev];\n control.runInParallel(pollEvents);\n }\n else {\n // add to the queue\n _pollEventQueue.push(ev)\n }\n\n // register event\n if (handler)\n control.onEvent(ev.eid, ev.vid, handler);\n else // or wait\n control.waitForEvent(ev.eid, ev.vid);\n } \n}\n\n/**\n * Busy wait for a condition to be true\n * @param condition condition to test for\n * @param timeOut if positive, maximum duration to wait for in milliseconds\n */\n//% blockId=\"pxt_pause_until\"\nfunction pauseUntil(condition: () => boolean, timeOut?: number): void {\n if (!condition || condition()) return; // optimistic path\n if (!timeOut) timeOut = 0;\n control.__queuePollEvent(timeOut, condition, undefined);\n}\n",
"pxt-core.d.ts": "/// \n\ninterface Array {\n /**\n * Get or set the length of an array. This number is one more than the index of the last element the array.\n */\n //% shim=Array_::length weight=84\n //% blockId=\"lists_length\" block=\"length of %VALUE\" blockBuiltin=true blockNamespace=\"arrays\"\n length: number;\n\n /**\n * Append a new element to an array.\n * @param items New elements of the Array.\n */\n //% help=arrays/push\n //% shim=Array_::push weight=50\n //% blockId=\"array_push\" block=\"%list| add value %value| to end\" blockNamespace=\"arrays\"\n //% group=\"Modify\"\n push(item: T): void;\n\n /**\n * Concatenates the values with another array.\n * @param arr The other array that is being concatenated with\n */\n //% helper=arrayConcat weight=40\n concat(arr: T[]): T[];\n\n /**\n * Remove the last element from an array and return it.\n */\n //% help=arrays/pop\n //% shim=Array_::pop weight=45\n //% blockId=\"array_pop\" block=\"get and remove last value from %list\" blockNamespace=\"arrays\"\n //% group=\"Read\"\n pop(): T;\n\n /**\n * Reverse the elements in an array. The first array element becomes the last, and the last array element becomes the first.\n */\n //% help=arrays/reverse\n //% helper=arrayReverse weight=10\n //% blockId=\"array_reverse\" block=\"reverse %list\" blockNamespace=\"arrays\"\n //% group=\"Operations\"\n reverse(): void;\n\n /**\n * Remove the first element from an array and return it. This method changes the length of the array.\n */\n //% help=arrays/shift\n //% helper=arrayShift weight=30\n //% blockId=\"array_shift\" block=\"get and remove first value from %list\" blockNamespace=\"arrays\"\n //% group=\"Read\"\n shift(): T;\n\n /**\n * Add one element to the beginning of an array and return the new length of the array.\n * @param element to insert at the start of the Array.\n */\n //% help=arrays/unshift\n //% helper=arrayUnshift weight=25\n //% blockId=\"array_unshift\" block=\"%list| insert %value| at beginning\" blockNamespace=\"arrays\"\n //% group=\"Modify\"\n //unshift(...values:T[]): number; //rest is not supported in our compiler yet.\n unshift(value: T): number;\n\n /**\n * Return a section of an array.\n * @param start The beginning of the specified portion of the array. eg: 0\n * @param end The end of the specified portion of the array. eg: 0\n */\n //% help=arrays/slice\n //% helper=arraySlice weight=41 blockNamespace=\"arrays\"\n slice(start?: number, end?: number): T[];\n\n /**\n * Remove elements from an array.\n * @param start The zero-based location in the array from which to start removing elements. eg: 0\n * @param deleteCount The number of elements to remove. eg: 0\n */\n //% helper=arraySplice weight=40\n splice(start: number, deleteCount: number): void;\n\n /**\n * joins all elements of an array into a string and returns this string.\n * @param sep the string separator\n */\n //% helper=arrayJoin weight=40\n join(sep?: string): string;\n\n /**\n * Tests whether at least one element in the array passes the test implemented by the provided function.\n * @param callbackfn A function that accepts up to two arguments. The some method calls the callbackfn function one time for each element in the array.\n */\n //% helper=arraySome weight=40\n some(callbackfn: (value: T, index: number) => boolean): boolean;\n\n /**\n * Tests whether all elements in the array pass the test implemented by the provided function.\n * @param callbackfn A function that accepts up to two arguments. The every method calls the callbackfn function one time for each element in the array.\n */\n //% helper=arrayEvery weight=40\n every(callbackfn: (value: T, index: number) => boolean): boolean;\n\n /**\n * Sort the elements of an array in place and returns the array. The sort is not necessarily stable.\n * @param specifies a function that defines the sort order. If omitted, the array is sorted according to the prmitive type\n */\n //% helper=arraySort weight=40\n sort(callbackfn?: (value1: T, value2: T) => number): T[];\n\n /**\n * Call a defined callback function on each element of an array, and return an array containing the results.\n * @param callbackfn A function that accepts up to two arguments. The map method calls the callbackfn function one time for each element in the array.\n */\n //% helper=arrayMap weight=40\n map(callbackfn: (value: T, index: number) => U): U[];\n\n /**\n * Call a defined callback function on each element of an array.\n * @param callbackfn A function that accepts up to two arguments. The forEach method calls the callbackfn function one time for each element in the array.\n */\n //% helper=arrayForEach weight=40\n forEach(callbackfn: (value: T, index: number) => void): void;\n\n /**\n * Return the elements of an array that meet the condition specified in a callback function.\n * @param callbackfn A function that accepts up to two arguments. The filter method calls the callbackfn function one time for each element in the array.\n */\n //% helper=arrayFilter weight=40\n filter(callbackfn: (value: T, index: number) => boolean): T[];\n\n /**\n * Fills all the elements of an array from a start index to an end index with a static value. The end index is not included.\n */\n //% helper=arrayFill weight=39\n fill(value: T, start?: number, end?: number): T[];\n\n /**\n * Returns the value of the first element in the array that satisfies the provided testing function. Otherwise undefined is returned.\n * @param callbackfn\n */\n //% helper=arrayFind weight=40\n find(callbackfn: (value: T, index: number) => boolean): T;\n\n /**\n * Call the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.\n * @param callbackfn A function that accepts up to three arguments. The reduce method calls the callbackfn function one time for each element in the array.\n * @param initialValue Initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an array value.\n */\n //% helper=arrayReduce weight=40\n reduce(callbackfn: (previousValue: U, currentValue: T, currentIndex: number) => U, initialValue: U): U;\n\n\n /** Remove the first occurence of an object. Returns true if removed. */\n //% shim=Array_::removeElement weight=48\n removeElement(element: T): boolean;\n\n /** Remove the element at a certain index. */\n //% help=arrays/remove-at\n //% shim=Array_::removeAt weight=47\n //% blockId=\"array_removeat\" block=\"%list| get and remove value at %index\" blockNamespace=\"arrays\"\n //% group=\"Read\"\n removeAt(index: number): T;\n\n /**\n * Insert the value at a particular index, increases length by 1\n * @param index the zero-based position in the list to insert the value, eg: 0\n * @param the value to insert, eg: 0\n */\n //% help=arrays/insert-at\n //% shim=Array_::insertAt weight=20\n //% blockId=\"array_insertAt\" block=\"%list| insert at %index| value %value\" blockNamespace=\"arrays\"\n //% group=\"Modify\"\n insertAt(index: number, value: T): void;\n\n /**\n * Return the index of the first occurrence of a value in an array.\n * @param item The value to locate in the array.\n * @param fromIndex The array index at which to begin the search. If fromIndex is omitted, the search starts at index 0.\n */\n //% help=arrays/index-of\n //% shim=Array_::indexOf weight=40\n //% blockId=\"array_indexof\" block=\"%list| find index of %value\" blockNamespace=\"arrays\"\n //% group=\"Operations\"\n indexOf(item: T, fromIndex?: number): number;\n\n /**\n * Get the value at a particular index\n * @param index the zero-based position in the list of the item, eg: 0\n */\n //% help=arrays/get\n //% shim=Array_::getAt weight=85\n get(index: number): T;\n\n /**\n * Store a value at a particular index\n * @param index the zero-based position in the list to store the value, eg: 0\n * @param value the value to insert, eg: 0\n */\n //% help=arrays/set\n //% shim=Array_::setAt weight=84\n set(index: number, value: T): void;\n\n /**\n * Return a random value from the array\n */\n //% help=arrays/pick-random\n //% helper=arrayPickRandom weight=25\n //% blockId=\"array_pickRandom\" block=\"get random value from %list\"\n //% blockNamespace=\"arrays\"\n //% group=\"Read\"\n _pickRandom(): T;\n\n [n: number]: T;\n\n /**\n * Add one element to the beginning of an array and return the new length of the array.\n * @param element to insert at the start of the Array.\n */\n //% help=arrays/unshift\n //% helper=arrayUnshift weight=24\n //% blockId=\"array_unshift_statement\" block=\"%list| insert %value| at beginning\" blockNamespace=\"arrays\"\n //% blockAliasFor=\"Array.unshift\"\n //% group=\"Modify\"\n _unshiftStatement(value: T): void;\n\n /**\n * Remove the last element from an array and return it.\n */\n //% help=arrays/pop\n //% shim=Array_::pop weight=44\n //% blockId=\"array_pop_statement\" block=\"remove last value from %list\" blockNamespace=\"arrays\"\n //% blockAliasFor=\"Array.pop\"\n //% group=\"Modify\"\n _popStatement(): void;\n\n /**\n * Remove the first element from an array and return it. This method changes the length of the array.\n */\n //% help=arrays/shift\n //% helper=arrayShift weight=29\n //% blockId=\"array_shift_statement\" block=\"remove first value from %list\" blockNamespace=\"arrays\"\n //% blockAliasFor=\"Array.shift\"\n //% group=\"Modify\"\n _shiftStatement(): void;\n\n /** Remove the element at a certain index. */\n //% help=arrays/remove-at\n //% shim=Array_::removeAt weight=14\n //% blockId=\"array_removeat_statement\" block=\"%list| remove value at %index\" blockNamespace=\"arrays\"\n //% blockAliasFor=\"Array.removeAt\"\n //% group=\"Modify\"\n _removeAtStatement(index: number): void;\n}\n\ndeclare interface String {\n // This block is currently disabled in favor of the built-in Blockly \"Create text with\" block, which compiles to \"\" + \"\"\n // Add % sign back to the block annotation to re-enable\n /**\n * Returns a string that contains the concatenation of two or more strings.\n * @param other The string to append to the end of the string.\n */\n //% shim=String_::concat weight=49\n //% blockId=\"string_concat\" blockNamespace=\"text\"\n // block=\"join %list=text|%other\"\n concat(other: string): string;\n\n /**\n * Return the character at the specified index.\n * @param index The zero-based index of the desired character.\n */\n //% shim=String_::charAt weight=48\n //% help=text/char-at\n //% blockId=\"string_get\" block=\"char from %this=text|at %pos\" blockNamespace=\"text\"\n charAt(index: number): string;\n\n /** Returns the length of a String object. */\n //% property shim=String_::length weight=47\n //% blockId=\"text_length\" block=\"length of %VALUE\" blockBuiltin=true blockNamespace=\"text\"\n length: number;\n\n /**\n * Return the Unicode value of the character at the specified location.\n * @param index The zero-based index of the desired character. If there is no character at the specified index, NaN is returned.\n */\n //% shim=String_::charCodeAt\n charCodeAt(index: number): number;\n\n /**\n * See how the order of characters in two strings is different (in ASCII encoding).\n * @param that String to compare to target string\n */\n //% shim=String_::compare\n //% help=text/compare\n //% blockId=\"string_compare\" block=\"compare %this=text| to %that\" blockNamespace=\"text\"\n compare(that: string): number;\n\n /**\n * Return a substring of the current string.\n * @param start first character index; can be negative from counting from the end, eg:0\n * @param length number of characters to extract, eg: 10\n */\n //% helper=stringSubstr\n //% help=text/substr\n //% blockId=\"string_substr\" block=\"substring of %this=text|from %start|of length %length\" blockNamespace=\"text\"\n substr(start: number, length?: number): string;\n\n /**\n * Return the current string with the first occurence of toReplace\n * replaced with the replacer\n * @param toReplace the substring to replace in the current string\n * @param replacer either the string that replaces toReplace in the current string,\n * or a function that accepts the substring and returns the replacement string.\n */\n //% helper=stringReplace\n replace(toReplace: string, replacer: string | ((sub: string) => string)): string;\n\n /**\n * Return the current string with each occurence of toReplace\n * replaced with the replacer\n * @param toReplace the substring to replace in the current string\n * @param replacer either the string that replaces toReplace in the current string,\n * or a function that accepts the substring and returns the replacement string.\n */\n //% helper=stringReplaceAll\n replaceAll(toReplace: string, replacer: string | ((sub: string) => string)): string;\n\n /**\n * Return a substring of the current string.\n * @param start first character index; can be negative from counting from the end, eg:0\n * @param end one-past-last character index\n */\n //% helper=stringSlice\n slice(start: number, end?: number): string;\n\n /** Returns a value indicating if the string is empty */\n //% helper=stringEmpty\n //% help=text/is-empty\n //% blockId=\"string_isempty\" blockNamespace=\"text\"\n //% block=\"%this=text| is empty\"\n isEmpty(): boolean;\n\n /**\n * Returns the position of the first occurrence of a specified value in a string.\n * @param searchValue the text to find\n * @param start optional start index for the search\n */\n //% shim=String_::indexOf\n //% help=text/index-of\n //% blockId=\"string_indexof\" blockNamespace=\"text\"\n //% block=\"%this=text|find index of %searchValue\"\n indexOf(searchValue: string, start?: number): number;\n\n /**\n * Determines whether a string contains the characters of a specified string.\n * @param searchValue the text to find\n * @param start optional start index for the search\n */\n //% shim=String_::includes\n //% help=text/includes\n //% blockId=\"string_includes\" blockNamespace=\"text\"\n //% block=\"%this=text|includes %searchValue\"\n includes(searchValue: string, start?: number): boolean;\n\n /**\n * Splits the string according to the separators\n * @param separator\n * @param limit\n */\n //% helper=stringSplit\n //% help=text/split\n //% blockId=\"string_split\" blockNamespace=\"text\"\n //% block=\"split %this=text|at %separator\"\n split(separator?: string, limit?: number): string[];\n\n /**\n * Return a substring of the current string with whitespace removed from both ends\n */\n //% helper=stringTrim\n trim(): string;\n\n /**\n * Converts the string to upper case characters.\n */\n //% helper=stringToUpperCase\n //% help=text/to-upper-case\n toUpperCase(): string;\n\n /**\n * Converts the string to lower case characters.\n */\n //% helper=stringToLowerCase\n //% help=text/to-lower-case\n toLowerCase(): string;\n\n [index: number]: string;\n}\n\n/**\n * Convert a string to a number.\n * @param s A string to convert into a number. eg: 123\n */\n//% shim=String_::toNumber\n//% help=text/parse-float\n//% blockId=\"string_parsefloat\" block=\"parse to number %text\" blockNamespace=\"text\"\n//% text.defl=\"123\"\ndeclare function parseFloat(text: string): number;\n\n/**\n * Returns a pseudorandom number between min and max included.\n * If both numbers are integral, the result is integral.\n * @param min the lower inclusive bound, eg: 0\n * @param max the upper inclusive bound, eg: 10\n */\n//% blockId=\"device_random\" block=\"pick random %min|to %limit\"\n//% blockNamespace=\"Math\"\n//% help=math/randint\n//% shim=Math_::randomRange\ndeclare function randint(min: number, max: number): number;\n\ninterface Object { }\ninterface Function {\n __assignableToFunction: Function;\n}\ninterface IArguments {\n __assignableToIArguments: IArguments;\n}\ninterface RegExp {\n __assignableToRegExp: RegExp;\n}\ntype TemplateStringsArray = Array;\n\ntype uint8 = number;\ntype uint16 = number;\ntype uint32 = number;\ntype int8 = number;\ntype int16 = number;\ntype int32 = number;\n\n\ndeclare interface Boolean {\n /**\n * Returns a string representation of an object.\n */\n //% shim=numops::toString\n toString(): string;\n}\n\n/**\n * Combine, split, and search text strings.\n*/\n//% blockNamespace=\"text\"\ndeclare namespace String {\n\n /**\n * Make a string from the given ASCII character code.\n */\n //% help=math/from-char-code\n //% shim=String_::fromCharCode weight=1\n //% blockNamespace=\"text\" blockId=\"stringFromCharCode\" block=\"text from char code %code\"\n function fromCharCode(code: number): string;\n}\n\ndeclare interface Number {\n /**\n * Returns a string representation of a number.\n */\n //% shim=numops::toString\n toString(): string;\n}\n\n/**\n * Add, remove, and replace items in lists.\n*/\n//% blockNamespace=\"Arrays\"\ndeclare namespace Array {\n /**\n * Check if a given object is an array.\n */\n //% shim=Array_::isArray\n function isArray(obj: any): boolean;\n}\n\ndeclare namespace Object {\n /**\n * Return the field names in an object.\n */\n //% shim=pxtrt::keysOf\n function keys(obj: any): string[];\n}\n\n/**\n * More complex operations with numbers.\n*/\ndeclare namespace Math {\n /**\n * Returns the value of a base expression taken to a specified power.\n * @param x The base value of the expression.\n * @param y The exponent value of the expression.\n */\n //% shim=Math_::pow\n function pow(x: number, y: number): number;\n\n /**\n * Returns a pseudorandom number between 0 and 1.\n */\n //% shim=Math_::random\n //% help=math/random\n function random(): number;\n\n /**\n * Returns a pseudorandom number between min and max included.\n * If both numbers are integral, the result is integral.\n * @param min the lower inclusive bound, eg: 0\n * @param max the upper inclusive bound, eg: 10\n */\n //% blockId=\"device_random_deprecated\" block=\"pick random %min|to %limit\"\n //% help=math/random-range deprecated\n //% shim=Math_::randomRange\n function randomRange(min: number, max: number): number;\n\n /**\n * Returns the natural logarithm (base e) of a number.\n * @param x A number\n */\n //% shim=Math_::log\n //% help=math\n function log(x: number): number;\n\n /**\n * Returns returns ``e^x``.\n * @param x A number\n */\n //% shim=Math_::exp\n //% help=math\n function exp(x: number): number;\n\n /**\n * Returns the sine of a number.\n * @param x An angle in radians\n */\n //% shim=Math_::sin\n //% help=math/trigonometry\n function sin(x: number): number;\n\n /**\n * Returns the cosine of a number.\n * @param x An angle in radians\n */\n //% shim=Math_::cos\n //% help=math/trigonometry\n function cos(x: number): number;\n\n /**\n * Returns the tangent of a number.\n * @param x An angle in radians\n */\n //% shim=Math_::tan\n //% help=math/trigonometry\n function tan(x: number): number;\n\n /**\n * Returns the arcsine (in radians) of a number\n * @param x A number\n */\n //% shim=Math_::asin\n //% help=math/trigonometry\n function asin(x: number): number;\n\n /**\n * Returns the arccosine (in radians) of a number\n * @param x A number\n */\n //% shim=Math_::acos\n //% help=math/trigonometry\n function acos(x: number): number;\n\n /**\n * Returns the arctangent (in radians) of a number\n * @param x A number\n */\n //% shim=Math_::atan\n //% help=math/trigonometry\n function atan(x: number): number;\n\n /**\n * Returns the arctangent of the quotient of its arguments.\n * @param y A number\n * @param x A number\n */\n //% shim=Math_::atan2\n //% help=math/trigonometry\n function atan2(y: number, x: number): number;\n\n /**\n * Returns the square root of a number.\n * @param x A numeric expression.\n */\n //% shim=Math_::sqrt\n //% help=math\n function sqrt(x: number): number;\n\n /**\n * Returns the smallest number greater than or equal to its numeric argument.\n * @param x A numeric expression.\n */\n //% shim=Math_::ceil\n //% help=math\n function ceil(x: number): number;\n\n /**\n * Returns the greatest number less than or equal to its numeric argument.\n * @param x A numeric expression.\n */\n //% shim=Math_::floor\n //% help=math\n function floor(x: number): number;\n\n /**\n * Returns the number with the decimal part truncated.\n * @param x A numeric expression.\n */\n //% shim=Math_::trunc\n //% help=math\n function trunc(x: number): number;\n\n /**\n * Returns a supplied numeric expression rounded to the nearest number.\n * @param x The value to be rounded to the nearest number.\n */\n //% shim=Math_::round\n //% help=math\n function round(x: number): number;\n\n /**\n * Returns the value of integer signed 32 bit multiplication of two numbers.\n * @param x The first number\n * @param y The second number\n */\n //% shim=Math_::imul\n //% help=math\n function imul(x: number, y: number): number;\n\n /**\n * Returns the value of integer signed 32 bit division of two numbers.\n * @param x The first number\n * @param y The second number\n */\n //% shim=Math_::idiv\n //% help=math\n function idiv(x: number, y: number): number;\n}\n\ndeclare namespace control {\n //% shim=_control::_onCodeStart\n export function _onCodeStart(arg: any): void;\n\n //% shim=_control::_onCodeStop\n export function _onCodeStop(arg: any): void;\n}",
"pxt-helpers.ts": "type Action = () => void;\n\n/**\n * Constant representing Not-A-Number.\n */\nconst NaN = 0 / 0\n\n/**\n * Constant representing positive infinity.\n */\nconst Infinity = 1 / 0\n\nfunction isNaN(x: number) {\n x = +x // convert to number\n return x !== x\n}\n\nnamespace Number {\n /**\n * Check if a given value is of type Number and it is a NaN.\n */\n export function isNaN(x: any): boolean {\n return typeof x == \"number\" && x !== x\n }\n}\n\n/**\n * A dictionary from string key to string values\n */\ninterface StringMap {\n [index: string]: string;\n}\n\n/**\n * Convert a string to an integer.\n * @param text A string to convert into an integral number. eg: \"123\"\n * @param radix optional A value between 2 and 36 that specifies the base of the number in text.\n * If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal.\n * All other strings are considered decimal.\n */\n//% help=text/parse-int\n//% blockId=\"string_parseint\" block=\"parse to integer %text\" blockNamespace=\"text\"\n//% text.defl=\"123\"\n//% blockHidden=1\nfunction parseInt(text: string, radix?: number): number {\n // roughly based on https://www.ecma-international.org/ecma-262/5.1/#sec-15.1.2.2\n // with some consideration for avoiding unnecessary slices where easy\n if (!text || (radix != null && (radix < 2 || radix > 36)))\n return NaN;\n\n let start = 0;\n while (start < text.length && helpers.isWhitespace(text.charCodeAt(start)))\n ++start;\n\n if (start === text.length)\n return NaN;\n\n const numberOffset = 48; // 0\n const numCount = 10;\n const letterOffset = 97; // a\n const letterCount = 26;\n const lowerCaseMask = 0x20;\n\n let sign = 1;\n switch (text.charAt(start)) {\n case \"-\":\n sign = -1;\n // fallthrough\n case \"+\":\n ++start;\n }\n\n if ((!radix || radix == 16)\n && \"0\" === text[start]\n && (\"x\" === text[start + 1] || \"X\" === text[start + 1])) {\n radix = 16;\n start += 2;\n } else if (!radix) {\n radix = 10;\n }\n\n let output = 0;\n let hasDigit = false;\n for (let i = start; i < text.length; ++i) {\n const code = text.charCodeAt(i) | lowerCaseMask;\n let val: number = undefined;\n\n if (code >= numberOffset && code < numberOffset + numCount)\n val = code - numberOffset;\n else if (code >= letterOffset && code < letterOffset + letterCount)\n val = numCount + code - letterOffset;\n\n if (val == undefined || val >= radix) {\n if (!hasDigit) {\n return NaN;\n }\n break;\n }\n hasDigit = true;\n output = output * radix + val;\n }\n\n return sign * output;\n}\n\nnamespace helpers {\n export function arrayFill(O: T[], value: T, start?: number, end?: number) {\n // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/fill\n // Steps 3-5.\n const len = O.length >>> 0;\n\n // Steps 6-7.\n const relativeStart = start === undefined ? 0 : start >> 0;\n\n // Step 8.\n let k = relativeStart < 0 ?\n Math.max(len + relativeStart, 0) :\n Math.min(relativeStart, len);\n\n // Steps 9-10.\n const relativeEnd = end === undefined ? len : end >> 0;\n\n // Step 11.\n const final = relativeEnd < 0 ?\n Math.max(len + relativeEnd, 0) :\n Math.min(relativeEnd, len);\n\n // Step 12.\n while (k < final) {\n O[k] = value;\n k++;\n }\n\n // Step 13.\n return O;\n }\n\n export function arraySplice(arr: T[], start: number, len: number) {\n if (start < 0) {\n return;\n }\n for (let i = 0; i < len; ++i) {\n arr.removeAt(start)\n }\n }\n\n export function arrayReverse(arr: T[]): void {\n let len = arr.length;\n for (let i = 0; i < len / 2; i++) {\n swap(arr, i, len - i - 1);\n }\n }\n\n export function arrayShift(arr: T[]): T {\n return arr.removeAt(0);\n }\n\n export function arrayJoin(arr: T[], sep?: string): string {\n if (sep === undefined || sep === null) {\n sep = \",\";\n }\n\n let r = \"\";\n let len = arr.length // caching this seems to match V8\n for (let i = 0; i < len; ++i) {\n if (i > 0 && sep)\n r += sep;\n r += (arr[i] === undefined || arr[i] === null) ? \"\" : arr[i];\n }\n return r;\n }\n\n /*TODO: Enable this multiple value unshift, after rest is enabled in our compiler.\n export function arrayUnshift(arr: T[], ...values: T[]) : number {\n for(let i = values.length; i > 0; --i) {\n arr.insertAt(0, values[i - 1]);\n }\n return arr.length;\n }\n */\n export function arrayUnshift(arr: T[], value: T): number {\n arr.insertAt(0, value);\n return arr.length;\n }\n\n function swap(arr: T[], i: number, j: number): void {\n let temp: T = arr[i];\n arr[i] = arr[j];\n arr[j] = temp;\n }\n\n function sortHelper(arr: T[], callbackfn?: (value1: T, value2: T) => number): T[] {\n if (arr.length <= 0 || !callbackfn) {\n return arr;\n }\n let len = arr.length;\n // simple selection sort.\n for (let i = 0; i < len - 1; ++i) {\n for (let j = i + 1; j < len; ++j) {\n if (callbackfn(arr[i], arr[j]) > 0) {\n swap(arr, i, j);\n }\n }\n }\n return arr;\n }\n\n export function arraySort(arr: T[], callbackfn?: (value1: T, value2: T) => number): T[] {\n if (!callbackfn && arr.length > 1) {\n callbackfn = (a, b) => {\n // default is sort as if the element were a string, with null < undefined\n const aIsUndef = a === undefined;\n const bIsUndef = b === undefined;\n if (aIsUndef && bIsUndef) return 0;\n else if (aIsUndef) return 1;\n else if (bIsUndef) return -1;\n\n const aIsNull = a === null;\n const bIsNull = b === null;\n if (aIsNull && bIsNull) return 0;\n else if (aIsNull) return 1;\n else if (bIsNull) return -1;\n\n return (a + \"\").compare(b + \"\");\n }\n }\n return sortHelper(arr, callbackfn);\n }\n\n export function arrayMap(arr: T[], callbackfn: (value: T, index: number) => U): U[] {\n let res: U[] = []\n let len = arr.length // caching this seems to match V8\n for (let i = 0; i < len; ++i) {\n res.push(callbackfn(arr[i], i))\n }\n return res\n }\n\n export function arraySome(arr: T[], callbackfn: (value: T, index: number) => boolean): boolean {\n let len = arr.length // caching this seems to match V8\n for (let i = 0; i < len; ++i)\n if (callbackfn(arr[i], i))\n return true;\n return false;\n }\n\n export function arrayEvery(arr: T[], callbackfn: (value: T, index: number) => boolean): boolean {\n let len = arr.length // caching this seems to match V8\n for (let i = 0; i < len; ++i)\n if (!callbackfn(arr[i], i))\n return false;\n return true;\n }\n\n export function arrayForEach(arr: T[], callbackfn: (value: T, index: number) => void): void {\n let len = arr.length // caching this seems to match V8\n for (let i = 0; i < len; ++i) {\n callbackfn(arr[i], i);\n }\n }\n\n export function arrayFilter(arr: T[], callbackfn: (value: T, index: number) => boolean): T[] {\n let res: T[] = []\n let len = arr.length\n for (let i = 0; i < len; ++i) {\n let v = arr[i] // need to cache\n if (callbackfn(v, i)) res.push(v)\n }\n return res\n }\n\n export function arrayFind(arr: T[], callbackfn: (value: T, index: number) => boolean): T {\n let len = arr.length\n for (let i = 0; i < len; ++i) {\n let v = arr[i] // need to cache\n if (callbackfn(v, i)) return v;\n }\n return undefined;\n }\n\n export function arrayReduce(arr: T[], callbackfn: (previousValue: U, currentValue: T, currentIndex: number) => U, initialValue: U): U {\n let len = arr.length\n for (let i = 0; i < len; ++i) {\n initialValue = callbackfn(initialValue, arr[i], i)\n }\n return initialValue\n }\n\n export function arrayConcat(arr: T[], otherArr: T[]): T[] {\n let out: T[] = [];\n for (let value of arr) {\n out.push(value);\n }\n for (let value of otherArr) {\n out.push(value);\n }\n return out;\n }\n\n export function arrayPickRandom(arr: T[]): T {\n return arr[Math.randomRange(0, arr.length - 1)];\n }\n\n export function arraySlice(arr: T[], start?: number, end?: number): T[] {\n // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/slice\n const res: T[] = [];\n const len = arr.length;\n\n if (start === undefined)\n start = 0;\n else if (start < 0)\n start = Math.max(len + start, 0);\n\n if (start > len)\n return res;\n\n if (end === undefined)\n end = len;\n else if (end < 0)\n end = len + end;\n\n if (end > len)\n end = len;\n\n for (let i = start; i < end; ++i) {\n res.push(arr[i]);\n }\n return res;\n }\n\n export function stringReplace(s: string, toReplace: string, replacer: string | ((sub: string) => string)) {\n toReplace = toReplace + \"\";\n const ind = s.indexOf(toReplace);\n if (ind == -1)\n return s;\n\n const begin = s.slice(0, ind);\n const end = s.slice(ind + toReplace.length);\n\n if (typeof replacer == \"string\" || !replacer) {\n return begin + replacer + end;\n } else {\n return begin + replacer(toReplace) + end;\n }\n }\n\n export function stringReplaceAll(s: string, toReplace: string, replacer: string | ((sub: string) => string)) {\n toReplace = toReplace + \"\";\n const split = s.split(toReplace);\n const empty = toReplace.isEmpty();\n\n let output = (empty ? applyReplace(toReplace, replacer) : \"\");\n\n if (split.length) {\n output += split[0];\n }\n\n for (let i = 1; i < split.length; ++i) {\n output += applyReplace(toReplace, replacer) + split[i];\n }\n\n if (!s.isEmpty() && empty) {\n output += applyReplace(toReplace, replacer);\n }\n\n return output;\n\n function applyReplace(r: string, replacer: string | ((sub: string) => string)): string {\n if (typeof replacer == \"string\" || !replacer) {\n return replacer as string;\n } else {\n return replacer(r);\n }\n }\n }\n\n //% shim=String_::substr\n declare function stringSubstrHelper(s: string, start: number, length?: number): string;\n\n export function stringSubstr(s: string, start: number, length?: number): string {\n length = length === undefined ? s.length : length || 0;\n return stringSubstrHelper(s, start, length);\n }\n\n export function stringSlice(s: string, start: number, end?: number): string {\n const len = s.length;\n\n if (start < 0) {\n start = Math.max(len + start, 0);\n }\n\n if (end === undefined) {\n end = len;\n } else if (end === null) {\n end = 0;\n }\n\n if (end < 0) {\n end = len + end;\n }\n\n return stringSubstrHelper(s, start, end - start);\n }\n\n // also note this doesn't handle unicode, but neither does JS (there's toLocaleUpperCase())\n export function stringToUpperCase(s: string): string {\n let r = \"\"\n let prev = 0\n for (let i = 0; i < s.length; i++) {\n const c = s.charCodeAt(i)\n if (97 <= c && c <= 122) {\n r += s.slice(prev, i) + String.fromCharCode(c - 32)\n prev = i + 1\n }\n }\n r += s.slice(prev)\n return r\n }\n\n // also note this doesn't handle unicode, but neither does JS (there's toLocaleLowerCase())\n export function stringToLowerCase(s: string): string {\n let r = \"\"\n let prev = 0\n for (let i = 0; i < s.length; i++) {\n const c = s.charCodeAt(i)\n if (65 <= c && c <= 90) {\n r += s.slice(prev, i) + String.fromCharCode(c + 32)\n prev = i + 1\n }\n }\n r += s.slice(prev)\n return r\n }\n\n export function stringSplit(S: string, separator?: string, limit?: number): string[] {\n // https://www.ecma-international.org/ecma-262/6.0/#sec-string.prototype.split\n const A: string[] = [];\n let lim = 0;\n if (limit === undefined)\n lim = (1 << 29) - 1; // spec says 1 << 53, leaving it at 29 for constant folding\n else if (limit < 0)\n lim = 0;\n else\n lim = limit | 0;\n const s = S.length;\n let p = 0;\n const R = separator;\n if (lim == 0)\n return A;\n if (separator === undefined) {\n A[0] = S;\n return A;\n }\n if (s == 0) {\n let z = splitMatch(S, 0, R);\n if (z > -1) return A;\n A[0] = S;\n return A;\n }\n let T: string;\n let q = p;\n while (q != s) {\n let e = splitMatch(S, q, R);\n if (e < 0) q++;\n else {\n if (e == p) q++;\n else {\n T = stringSlice(S, p, q);\n A.push(T);\n if (A.length == lim) return A;\n p = e;\n q = p;\n }\n }\n }\n T = stringSlice(S, p, q);\n A.push(T);\n return A;\n }\n\n function splitMatch(S: string, q: number, R: string): number {\n const r = R.length;\n const s = S.length;\n if (q + r > s) return -1;\n for (let i = 0; i < r; ++i) {\n if (S[q + i] != R[i])\n return -1;\n }\n return q + r;\n }\n\n export function stringTrim(s: string): string {\n let start = 0;\n let end = s.length - 1;\n\n while (start <= end && isWhitespace(s.charCodeAt(start)))\n ++start;\n\n while (end > start && isWhitespace(s.charCodeAt(end)))\n --end;\n return s.slice(start, end + 1);\n }\n\n export function isWhitespace(c: number): boolean {\n // https://www.ecma-international.org/ecma-262/6.0/#sec-white-space\n switch (c) {\n case 0x0009: // character tab\n case 0x000B: // line tab\n case 0x000C: // form feed\n case 0x0020: // space\n case 0x00A0: // no-break space\n case 0xFEFF: // zero width no break space\n case 0x000A: // line feed\n case 0x000D: // carriage return\n case 0x2028: // line separator\n case 0x2029: // paragraph separator\n return true;\n default:\n return false;\n }\n }\n\n export function stringEmpty(S: string): boolean {\n return !S;\n }\n}\n\nnamespace Math {\n export function clamp(min: number, max: number, value: number): number {\n return Math.min(max, Math.max(min, value));\n }\n\n /**\n * Returns the absolute value of a number (the value without regard to whether it is positive or negative).\n * For example, the absolute value of -5 is the same as the absolute value of 5.\n * @param x A numeric expression for which the absolute value is needed.\n */\n //% help=math/abs\n export function abs(x: number): number {\n return x < 0 ? -x : x;\n }\n\n /**\n * Returns the sign of the x, indicating whether x is positive, negative or zero.\n * @param x The numeric expression to test\n */\n export function sign(x: number): number {\n if (x == 0) return 0;\n if (x > 0) return 1;\n return -1;\n }\n\n /**\n * Returns the larger of two supplied numeric expressions.\n */\n //% help=math/max\n export function max(a: number, b: number): number {\n if (a >= b) return a;\n return b;\n }\n\n /**\n * Returns the smaller of two supplied numeric expressions.\n */\n //% help=math/min\n export function min(a: number, b: number): number {\n if (a <= b) return a;\n return b;\n }\n\n /**\n * Rounds ``x`` to a number with the given number of ``digits``\n * @param x the number to round\n * @param digits the number of resulting digits\n */\n //%\n export function roundWithPrecision(x: number, digits: number): number {\n digits = digits | 0;\n // invalid digits input\n if (digits <= 0) return Math.round(x);\n if (x == 0) return 0;\n let r = 0;\n do {\n const d = Math.pow(10, digits);\n r = Math.round(x * d) / d;\n digits++;\n } while (r == 0 && digits < 21);\n return r;\n }\n}\n\n\n//% blockHidden=1\nnamespace __internal {\n /**\n * A shim to render a boolean as a down/up toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleDownUp block=\"%down\"\n //% down.fieldEditor=toggledownup\n //% down.fieldOptions.decompileLiterals=true\n export function __downUp(down: boolean): boolean {\n return down;\n }\n\n /**\n * A shim to render a boolean as a up/down toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleUpDown block=\"%up\"\n //% up.fieldEditor=toggleupdown\n //% up.fieldOptions.decompileLiterals=true\n export function __upDown(up: boolean): boolean {\n return up;\n }\n\n /**\n * A shim to render a boolean as a high/low toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleHighLow block=\"%high\"\n //% high.fieldEditor=togglehighlow\n //% high.fieldOptions.decompileLiterals=true\n export function __highLow(high: boolean): boolean {\n return high;\n }\n\n /**\n * A shim to render a boolean as a on/off toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleOnOff block=\"%on\"\n //% on.fieldEditor=toggleonoff\n //% on.fieldOptions.decompileLiterals=true\n export function __onOff(on: boolean): boolean {\n return on;\n }\n\n /**\n * A shim to render a boolean as a yes/no toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleYesNo block=\"%yes\"\n //% yes.fieldEditor=toggleyesno\n //% yes.fieldOptions.decompileLiterals=true\n export function __yesNo(yes: boolean): boolean {\n return yes;\n }\n\n /**\n * A shim to render a boolean as a win/lose toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleWinLose block=\"%win\"\n //% win.fieldEditor=togglewinlose\n //% win.fieldOptions.decompileLiterals=true\n export function __winLose(win: boolean): boolean {\n return win;\n }\n\n /**\n * Get the color wheel field editor\n * @param color color, eg: #ff0000\n */\n //% blockId=colorNumberPicker block=\"%value\"\n //% blockHidden=true\n //% shim=TD_ID colorSecondary=\"#FFFFFF\"\n //% value.fieldEditor=\"colornumber\" value.fieldOptions.decompileLiterals=true\n //% value.defl='#ff0000'\n //% value.fieldOptions.colours='[\"#ff0000\",\"#ff8000\",\"#ffff00\",\"#ff9da5\",\"#00ff00\",\"#b09eff\",\"#00ffff\",\"#007fff\",\"#65471f\",\"#0000ff\",\"#7f00ff\",\"#ff0080\",\"#ff00ff\",\"#ffffff\",\"#999999\",\"#000000\"]'\n //% value.fieldOptions.columns=4 value.fieldOptions.className='rgbColorPicker'\n export function __colorNumberPicker(value: number) {\n return value;\n }\n\n /**\n * Get the color wheel field editor\n * @param value value between 0 to 255 to get a color value, eg: 10\n */\n //% blockId=colorWheelPicker block=\"%value\"\n //% blockHidden=true\n //% shim=TD_ID colorSecondary=\"#FFFFFF\"\n //% value.fieldEditor=\"colorwheel\" value.fieldOptions.decompileLiterals=true\n //% value.fieldOptions.sliderWidth='200'\n //% value.fieldOptions.min=0 value.fieldOptions.max=255\n export function __colorWheelPicker(value: number) {\n return value;\n }\n\n /**\n * Get the color wheel field editor using HSV values\n * @param value value between 0 to 255 to get a color value, eg: 10\n */\n //% blockId=colorWheelHsvPicker block=\"%value\"\n //% blockHidden=true\n //% shim=TD_ID colorSecondary=\"#FFFFFF\"\n //% value.fieldEditor=\"colorwheel\" value.fieldOptions.decompileLiterals=true\n //% value.fieldOptions.sliderWidth='200'\n //% value.fieldOptions.min=0 value.fieldOptions.max=255\n //% value.fieldOptions.channel=hsvfast\n export function __colorWheelHsvPicker(value: number) {\n return value;\n }\n\n /**\n * A speed picker\n * @param speed the speed, eg: 50\n */\n //% blockId=speedPicker block=\"%speed\" shim=TD_ID\n //% speed.fieldEditor=\"speed\" colorSecondary=\"#FFFFFF\"\n //% weight=0 blockHidden=1 speed.fieldOptions.decompileLiterals=1\n export function __speedPicker(speed: number): number {\n return speed;\n }\n\n /**\n * A turn ratio picker\n * @param turnratio the turn ratio, eg: 0\n */\n //% blockId=turnRatioPicker block=\"%turnratio\" shim=TD_ID\n //% turnratio.fieldEditor=\"turnratio\" colorSecondary=\"#FFFFFF\"\n //% weight=0 blockHidden=1 turnRatio.fieldOptions.decompileLiterals=1\n export function __turnRatioPicker(turnratio: number): number {\n return turnratio;\n }\n\n /**\n * A field editor that displays a protractor\n */\n //% blockId=protractorPicker block=\"%angle\"\n //% shim=TD_ID\n //% angle.fieldEditor=protractor\n //% angle.fieldOptions.decompileLiterals=1\n //% colorSecondary=\"#FFFFFF\"\n //% blockHidden=1\n export function __protractor(angle: number) {\n return angle;\n }\n\n /**\n * Get the time field editor\n * @param ms time duration in milliseconds, eg: 500, 1000\n */\n //% blockId=timePicker block=\"%ms\"\n //% blockHidden=true shim=TD_ID\n //% colorSecondary=\"#FFFFFF\"\n //% ms.fieldEditor=\"numberdropdown\" ms.fieldOptions.decompileLiterals=true\n //% ms.fieldOptions.data='[[\"100 ms\", 100], [\"200 ms\", 200], [\"500 ms\", 500], [\"1 second\", 1000], [\"2 seconds\", 2000], [\"5 seconds\", 5000]]'\n export function __timePicker(ms: number): number {\n return ms;\n }\n}\n",
"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",
"pxt.json": "{\n \"name\": \"base\",\n \"description\": \"The base library\",\n \"dependencies\": {},\n \"files\": [\n \"README.md\",\n \"pxt-core.d.ts\",\n \"pxt.cpp\",\n \"gc.cpp\",\n \"configkeys.h\",\n \"pxtbase.h\",\n \"core.cpp\",\n \"advmath.cpp\",\n \"trig.cpp\",\n \"pxt-helpers.ts\",\n \"fixed.ts\",\n \"buffer.cpp\",\n \"buffer.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"loops.cpp\",\n \"math.ts\",\n \"ns.ts\",\n \"control.cpp\",\n \"controlgc.cpp\",\n \"control.ts\",\n \"interval.ts\",\n \"gcstats.ts\",\n \"poll.ts\",\n \"console.ts\",\n \"json.ts\",\n \"templates.ts\",\n \"eventcontext.ts\",\n \"pause.ts\",\n \"forever.ts\",\n \"utfdecoder.ts\",\n \"scheduling.ts\",\n \"controlmessage.ts\",\n \"perfcounters.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"partial\": true,\n \"yotta\": {\n \"optionalConfig\": {\n \"PXT_GC_CHECKS\": 0\n },\n \"userConfigs\": [\n {\n \"description\": \"(Diagnostics) Garbage Collection checks.\",\n \"config\": {\n \"PXT_GC_CHECKS\": 1\n }\n }\n ]\n }\n}\n",
"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 \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 \n#include \n#include \n\n#ifdef POKY\nvoid *operator new(size_t size, void *ptr);\nvoid *operator new(size_t size);\n#else\n#include \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 inline const T &max(const T &a, const T &b) {\n if (a < b)\n return b;\n return a;\n}\n\ntemplate inline const T &min(const T &a, const T &b) {\n if (a < b)\n return a;\n return b;\n}\n\ntemplate 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 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(v - NanBoxingOffset);\n}\n\n#ifdef PXT64\nSTATIC_ASSERT(sizeof(void *) == 8);\ninline double doubleVal(TValue v) {\n return bitwise_cast((uint64_t)v - NanBoxingOffset);\n}\n\ninline TValue tvalueFromDouble(double d) {\n return (TValue)(bitwise_cast(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 struct BoxedStringLayout {\n const void *vtable;\n uint16_t size;\n const char data[N];\n};\n\ntemplate 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",
"scheduling.ts": "/**\n * Calls a function with a fixed time delay between each call to that function.\n * @param func \n * @param delay \n */\n//%\nfunction setInterval(func: () => void, delay: number): number {\n delay = Math.max(10, delay | 0);\n return control.setInterval(func, delay, control.IntervalMode.Interval);\n}\n\n/**\n * Cancels repeated action which was set up using setInterval().\n * @param intervalId \n */\n//%\nfunction clearInterval(intervalId: number) {\n control.clearInterval(intervalId, control.IntervalMode.Interval);\n}\n\n/**\n * Calls a function after specified delay.\n * @param func \n * @param delay \n */\n//%\nfunction setTimeout(func: () => void, delay: number): number {\n return control.setInterval(func, delay, control.IntervalMode.Timeout);\n}\n\n/**\n * Clears the delay set by setTimeout().\n * @param intervalId \n */\n//%\nfunction clearTimeout(intervalId: number) {\n control.clearInterval(intervalId, control.IntervalMode.Timeout);\n}\n\n/**\n * Calls a function as soon as possible.\n * @param func \n */\n//%\nfunction setImmediate(func: () => void): number {\n return control.setInterval(func, 0, control.IntervalMode.Immediate);\n}\n\n/**\n * Cancels the immediate actions.\n * @param intervalId \n */\n//%\nfunction clearImmediate(intervalId: number) {\n control.clearInterval(intervalId, control.IntervalMode.Immediate);\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\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 loops {\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=loops/forever weight=100 afterOnStart=true deprecated=true\n //% blockId=forever_deprecated block=\"forever\" blockAllowMultiple=1 shim=loops::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=loops/pause weight=99 deprecated=true\n //% async block=\"pause %pause=timePicker|ms\"\n //% blockId=device_pause_deprecated shim=loops::pause\n function pause(ms: int32): void;\n}\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 * Used internally\n */\n //% flags.defl=16 shim=control::internalOnEvent\n function internalOnEvent(src: int32, value: int32, handler: () => void, flags?: int32): void;\n\n /**\n * Reset the device.\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 * Block 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\" shim=control::waitMicros\n function waitMicros(micros: int32): void;\n\n /**\n * Run other code in the parallel.\n */\n //% help=control/run-in-parallel handlerStatement=1\n //% blockId=\"control_run_in_parallel\" block=\"run in parallel\" blockGap=8 shim=control::runInParallel\n function runInParallel(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 * 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 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 //% blockId=\"control_device_long_serial_number\" block=\"device long serial number\" weight=9\n //% help=control/device-long-serial-number shim=control::deviceLongSerialNumber\n function deviceLongSerialNumber(): Buffer;\n\n /**\n *\n */\n //% shim=control::__log\n function __log(prority: int32, text: string): void;\n\n /**\n * Dump internal information about a value.\n */\n //% shim=control::dmesgValue\n function dmesgValue(v: any): 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// Auto-generated. Do not edit. Really.\n",
"templates.ts": "/**\n * Tagged hex literal converter\n */\n//% shim=@hex\nfunction hex(lits: any, ...args: any[]): Buffer { return null }\n",
"test.ts": "let i = 1\nlet f = 0.5\nlet plus = i + f\nlet minus = i - f\n\nlet r = Math.random()\nlet ri = Math.randomRange(5, 10)\n\n\nfunction check(cond:boolean) { control.assert(cond, 108) }\n\ncheck(Buffer.pack(\"<2h\", [0x3412, 0x7856]).toHex() == \"12345678\")\ncheck(Buffer.pack(\">hh\", [0x3412, 0x7856]).toHex() == \"34127856\")\ncheck(Buffer.fromHex(\"F00d\").toHex() == \"f00d\")",
"trig.cpp": "#include \"pxtbase.h\"\n#include \n#include \n\nusing namespace std;\n\nnamespace Math_ {\n\n#define SINGLE(op) return fromDouble(::op(toDouble(x)));\n\n//%\nTNumber atan2(TNumber y, TNumber x) {\n return fromDouble(::atan2(toDouble(y), toDouble(x)));\n}\n\n//%\nTNumber tan(TNumber x){SINGLE(tan)}\n\n//%\nTNumber sin(TNumber x){SINGLE(sin)}\n\n//%\nTNumber cos(TNumber x){SINGLE(cos)}\n\n//%\nTNumber atan(TNumber x){SINGLE(atan)}\n\n//%\nTNumber asin(TNumber x){SINGLE(asin)}\n\n//%\nTNumber acos(TNumber x){SINGLE(acos)}\n\n//%\nTNumber sqrt(TNumber x){SINGLE(sqrt)}\n\n}",
"utfdecoder.ts": "class UTF8Decoder {\n private buf: Buffer;\n\n constructor() {\n this.buf = undefined;\n }\n\n add(buf: Buffer) {\n if (!buf || !buf.length) return;\n\n if (!this.buf)\n this.buf = buf;\n else {\n const b = control.createBuffer(this.buf.length + buf.length);\n b.write(0, this.buf);\n b.write(this.buf.length, buf);\n this.buf = b;\n }\n }\n\n decodeUntil(delimiter: number): string {\n if (!this.buf) return undefined;\n delimiter = delimiter | 0;\n let i = 0;\n for (; i < this.buf.length; ++i) {\n const c = this.buf[i];\n // skip multi-chars\n if ((c & 0xe0) == 0xc0)\n i += 1;\n else if ((c & 0xf0) == 0xe0)\n i += 2;\n else if (c == delimiter) {\n // found it\n break;\n }\n }\n\n if (i >= this.buf.length)\n return undefined;\n else {\n const s = this.buf.slice(0, i).toString();\n if (i + 1 == this.buf.length)\n this.buf = undefined;\n else\n this.buf = this.buf.slice(i + 1);\n return s;\n }\n }\n\n decode(): string {\n if (!this.buf) return \"\";\n\n // scan the end of the buffer for partial characters\n let length = 0;\n for (let i = this.buf.length - 1; i >= 0; i--) {\n const c = this.buf[i];\n if ((c & 0x80) == 0) {\n length = i + 1;\n break;\n }\n else if ((c & 0xe0) == 0xc0) {\n length = i + 2;\n break;\n }\n else if ((c & 0xf0) == 0xe0) {\n length = i + 3;\n break;\n }\n }\n // is last beyond the end?\n if (length == this.buf.length) {\n const s = this.buf.toString();\n this.buf = undefined;\n return s;\n } else if (length == 0) { // data yet\n return \"\";\n } else {\n const s = this.buf.slice(0, length).toString();\n this.buf = this.buf.slice(length);\n return s;\n }\n }\n}"
},
"base---light": {
"README.md": "# base\n\nThe base library, shared by all C++ targets (not only Codal-based).\n\n\n",
"advmath.cpp": "// skip",
"buffer.cpp": "#include \"pxtbase.h\"\n#include \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",
"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",
"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",
"console.ts": "/// \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 //% whenUsed\n const listeners: Listener[] = [\n function (priority: ConsolePriority, text: string) { control.__log(priority, text); }\n ];\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 // send to 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 //% blockId=console_log block=\"console log $value\"\n //% value.shadow=text\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 //% blockId=console_log_value block=\"console|log value %name|= %value\"\n //% name.shadow=text\n //% value.shadow=math_number\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);\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 `{${\n 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 (!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) return;\n const i = listeners.indexOf(listener);\n if (i > -1)\n listeners.splice(i, 1);\n }\n}",
"control.cpp": "#include \"pxtbase.h\"\n\n\nnamespace control {\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 current_time_ms();\n }\n\n /**\n * Gets current time in microseconds. Overflows every ~18 minutes.\n */\n //%\n int micros() {\n return current_time_us() & 0x3fffffff;\n }\n\n /**\n * Used internally\n */\n //%\n void internalOnEvent(int src, int value, Action handler, int flags = 16) {\n registerWithDal(src, value, handler, flags);\n }\n\n /**\n * Reset the device.\n */\n //% weight=30 async help=control/reset blockGap=8\n //% blockId=\"control_reset\" block=\"reset\"\n void reset() {\n target_reset();\n }\n\n /**\n * Block 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 void waitMicros(int micros) {\n sleep_us(micros);\n }\n\n /**\n * Run other code in the parallel.\n */\n //% help=control/run-in-parallel handlerStatement=1\n //% blockId=\"control_run_in_parallel\" block=\"run in parallel\" blockGap=8\n void runInParallel(Action a) {\n pxt::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 * 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 int deviceSerialNumber() {\n uint64_t serial_num = pxt::getLongSerialNumber();\n return hash_fnv1(&serial_num, sizeof(serial_num)) & 0x3fffffff;\n }\n\n /**\n * Derive a unique, consistent 64-bit serial number of this device from internal data.\n */\n //% blockId=\"control_device_long_serial_number\" block=\"device long serial number\" weight=9\n //% help=control/device-long-serial-number\n Buffer deviceLongSerialNumber() {\n uint64_t serial_num = pxt::getLongSerialNumber();\n return mkBuffer((uint8_t*)&serial_num, sizeof(uint64_t));\n }\n\n /**\n *\n */\n //%\n void __log(int prority, String text) {\n if (NULL == text) return;\n pxt::sendSerial(text->getUTF8Data(), text->getUTF8Size());\n }\n\n /**\n * Dump internal information about a value.\n */\n //%\n void dmesgValue(TValue v) {\n anyPrint(v);\n }\n}\n",
"control.ts": "/**\n* Program controls and events.\n*/\n//% weight=90 color=\"#FF5722\" icon=\"\\uf110\" advanced=true\nnamespace control {\n /**\n * Deprecated, use ``control.runInParallel`` instead.\n */\n //% deprecated=1 hidden=1 help=control/run-in-background blockAllowMultiple=1 afterOnStart=true\n //% blockId=\"control_run_in_background\" block=\"run in background\" blockGap=8 weight=0\n export function runInBackground(a: () => void) {\n control.runInParallel(a);\n }\n\n export const enum PXT_PANIC {\n CODAL_OOM = 20,\n GC_OOM = 21,\n GC_TOO_BIG_ALLOCATION = 22,\n CODAL_HEAP_ERROR = 30,\n CODAL_NULL_DEREFERENCE = 40,\n CODAL_USB_ERROR = 50,\n CODAL_HARDWARE_CONFIGURATION_ERROR = 90,\n\n INVALID_BINARY_HEADER = 901,\n OUT_OF_BOUNDS = 902,\n REF_DELETED = 903,\n SIZE = 904,\n INVALID_VTABLE = 905,\n INTERNAL_ERROR = 906,\n NO_SUCH_CONFIG = 907,\n NO_SUCH_PIN = 908,\n INVALID_ARGUMENT = 909,\n MEMORY_LIMIT_EXCEEDED = 910,\n SCREEN_ERROR = 911,\n MISSING_PROPERTY = 912,\n INVALID_IMAGE = 913,\n CALLED_FROM_ISR = 914,\n HEAP_DUMPED = 915,\n STACK_OVERFLOW = 916,\n BLOCKING_TO_STRING = 917,\n VM_ERROR = 918,\n SETTINGS_CLEARED = 920,\n SETTINGS_OVERLOAD = 921,\n SETTINGS_SECRET_MISSING = 922,\n DELETE_ON_CLASS = 923,\n\n CAST_FIRST = 980,\n CAST_FROM_UNDEFINED = 980,\n CAST_FROM_BOOLEAN = 981,\n CAST_FROM_NUMBER = 982,\n CAST_FROM_STRING = 983,\n CAST_FROM_OBJECT = 984,\n CAST_FROM_FUNCTION = 985,\n CAST_FROM_NULL = 989,\n\n UNHANDLED_EXCEPTION = 999,\n }\n /**\n * Display an error code and stop the program.\n * @param code an error number to display. eg: 5\n */\n //% help=control/panic weight=29\n //% blockId=\"control_panic\" block=\"panic %code\"\n //% shim=pxtrt::panic\n export function panic(code: number) { }\n\n /**\n * Display an error code and stop the program when the assertion is `false`.\n */\n //% help=control/assert weight=30\n //% blockId=\"control_assert\" block=\"assert %cond|with value %code\"\n export function assert(cond: boolean, code: number) {\n if (!cond) {\n fail(\"Assertion failed, code=\" + code)\n }\n }\n\n export function fail(message: string) {\n console.log(\"Fatal failure: \")\n console.log(message)\n dmesg(message)\n panic(108)\n }\n\n let _evSource = 0x8000\n export function allocateEventSource() {\n return ++_evSource\n }\n\n export class AnimationQueue {\n running: boolean;\n eventID: number;\n public interval: number;\n\n constructor() {\n this.running = false;\n this.eventID = control.allocateNotifyEvent();\n this.interval = 1;\n }\n\n /**\n * Runs 'render' in a loop until it returns false or the 'stop' function is called\n */\n runUntilDone(render: () => boolean) {\n const evid = this.eventID;\n\n // if other animation, wait for turn\n if (this.running)\n control.waitForEvent(DAL.DEVICE_ID_NOTIFY, evid);\n\n // check if the animation hasn't been cancelled since we've waiting\n if (this.isCancelled(evid))\n return;\n\n // run animation\n this.running = true;\n while (this.running\n && !this.isCancelled(evid)\n && render()) {\n pause(this.interval);\n }\n\n // check if the animation hasn't been cancelled since we've been waiting\n if (this.isCancelled(evid))\n return;\n\n // we're done\n this.running = false;\n // unblock 1 fiber\n control.raiseEvent(DAL.DEVICE_ID_NOTIFY_ONE, this.eventID);\n }\n\n isCancelled(evid: number) {\n return this.eventID !== evid;\n }\n\n /**\n * Cancels the current running animation and clears the queue\n */\n cancel() {\n if (this.running) {\n this.running = false;\n const evid = this.eventID;\n this.eventID = control.allocateNotifyEvent();\n // unblock fibers\n control.raiseEvent(DAL.DEVICE_ID_NOTIFY, evid);\n }\n }\n }\n\n //% shim=pxt::getConfig\n export declare function getConfigValue(key: int32, defl: int32): number;\n\n //% shim=pxt::programHash\n export declare function programHash(): number;\n\n //% shim=pxt::programName\n export declare function programName(): string;\n\n //% shim=control::_ramSize\n function _ramSize() {\n return 32 * 1024 * 1024;\n }\n\n /** Returns estimated size of memory in bytes. */\n export function ramSize() {\n return getConfigValue(DAL.CFG_RAM_BYTES, 0) || _ramSize();\n }\n\n /** Runs the function and returns run time in microseconds. */\n export function benchmark(f: () => void) {\n const t0 = micros()\n f()\n let t = micros() - t0\n if (t < 0)\n t += 0x3fffffff\n return t\n }\n}\n\n/**\n * Convert any value to text\n * @param value value to be converted to text\n */\n//% help=text/convert-to-text weight=1\n//% block=\"convert $value=math_number to text\"\n//% blockId=variable_to_text blockNamespace=\"text\"\nfunction convertToText(value: any): string {\n return \"\" + value;\n}\n",
"controlgc.cpp": "#include \"pxtbase.h\"\n\n\nnamespace control {\n /**\n * Force GC and dump basic information about heap.\n */\n //%\n void gc() {\n pxt::gc(1);\n }\n\n /**\n * Force GC and halt waiting for debugger to do a full heap dump.\n */\n //%\n void heapDump() {\n pxt::gc(2);\n soft_panic(PANIC_HEAP_DUMPED);\n }\n\n\n /**\n * Set flags used when connecting an external debugger.\n */\n //%\n void setDebugFlags(int flags) {\n debugFlags = flags;\n }\n\n /**\n * Record a heap snapshot to debug memory leaks.\n */\n //%\n void heapSnapshot() {\n // only in JS backend for now\n }\n\n /**\n * Return true if profiling is enabled in the current build.\n */\n //%\n bool profilingEnabled() {\n#ifdef PXT_PROFILE\n return true;\n#else\n return false;\n#endif\n }\n}\n",
"controlmessage.ts": "namespace control.simmessages {\n // these events are raised by JS simulator when messages come in\n export const CONTROL_MESSAGE_EVT_ID = 2999;\n export const CONTROL_MESSAGE_RECEIVED = 1;\n\n //% shim=pxt::sendMessage\n export declare function send(channel: string, message: Buffer, parentOnly?: boolean) : void;\n\n //% shim=pxt::peekMessageChannel\n declare function peekMessageChannel(): string;\n\n //% shim=pxt::readMessageData\n declare function readMessageData(): Buffer;\n\n let handlers: { [channel: string] : (msg: Buffer) => void}\n function consumeMessages() {\n while(true) {\n // peek channel of next message\n const channel = peekMessageChannel();\n if (!channel) break;\n // read next message\n const msg = readMessageData();\n // send to handler\n const handler = handlers && handlers[channel];\n if (handler)\n handler(msg);\n }\n }\n\n /**\n * Registers the handler for a message on a given channel\n **/\n export function onReceived(channel: string, handler: (msg: Buffer) => void) {\n if (!channel) return;\n\n if (!handlers)\n handlers = {};\n handlers[channel] = handler;\n control.onEvent(CONTROL_MESSAGE_EVT_ID, CONTROL_MESSAGE_RECEIVED, consumeMessages);\n }\n}",
"core.cpp": "#include \"pxtbase.h\"\n#include \n#include \n\nusing namespace std;\n\n#define p10(v) __builtin_powi(10, v)\n\n// try not to create cons-strings shorter than this\n#define SHORT_CONCAT_STRING 50\n\nnamespace pxt {\n\nPXT_DEF_STRING(emptyString, \"\")\n\nstatic HandlerBinding *handlerBindings;\n\nHandlerBinding *nextBinding(HandlerBinding *curr, int source, int value) {\n for (auto p = curr; p; p = p->next) {\n // DEVICE_ID_ANY == DEVICE_EXT_ANY == 0\n if ((p->source == source || p->source == 0) &&\n (value == -1 || p->value == value || p->value == 0)) {\n return p;\n }\n }\n return 0;\n}\n\nHandlerBinding *findBinding(int source, int value) {\n return nextBinding(handlerBindings, source, value);\n}\n\nvoid setBinding(int source, int value, Action act) {\n HandlerBinding *curr = NULL;\n for (auto p = handlerBindings; p; p = p->next) {\n if ((p->source == source) && (p->value == value)) {\n curr = p;\n break;\n }\n }\n if (curr) {\n curr->action = act;\n return;\n }\n curr = new (app_alloc(sizeof(HandlerBinding))) HandlerBinding();\n curr->next = handlerBindings;\n curr->source = source;\n curr->value = value;\n curr->action = act;\n registerGC(&curr->action);\n handlerBindings = curr;\n}\n\nvoid coreReset() {\n // these are allocated on GC heap, so they will go away together with the reset\n handlerBindings = NULL;\n}\n\nstruct EmptyBufferLayout {\n const void *vtable;\n // data needs to be word-aligned, so we use 32 bits for length\n int length;\n uint8_t data[1];\n};\n\nstatic const EmptyBufferLayout emptyBuffer[1] = {{&pxt::buffer_vt, 0, {0}}};\n\n#if PXT_UTF8\nint utf8Len(const char *data, int size) {\n int len = 0;\n for (int i = 0; i < size; ++i) {\n char c = data[i];\n len++;\n if ((c & 0x80) == 0x00) {\n // skip\n } else if ((c & 0xe0) == 0xc0) {\n i++;\n } else if ((c & 0xf0) == 0xe0) {\n i += 2;\n } else {\n // error; just skip\n }\n }\n return len;\n}\n\nconst char *utf8Skip(const char *data, int size, int skip) {\n int len = 0;\n for (int i = 0; i <= size; ++i) {\n char c = data[i];\n len++;\n if (len > skip)\n return data + i;\n if ((c & 0x80) == 0x00) {\n // skip\n } else if ((c & 0xe0) == 0xc0) {\n i++;\n } else if ((c & 0xf0) == 0xe0) {\n i += 2;\n } else {\n // error; just skip over\n }\n }\n return NULL;\n}\n\nstatic char *write3byte(char *dst, uint32_t charCode) {\n if (dst) {\n *dst++ = 0xe0 | (charCode >> 12);\n *dst++ = 0x80 | (0x3f & (charCode >> 6));\n *dst++ = 0x80 | (0x3f & (charCode >> 0));\n }\n return dst;\n}\n\nstatic char *write2byte(char *dst, uint32_t charCode) {\n if (dst) {\n *dst++ = 0xc0 | (charCode >> 6);\n *dst++ = 0x80 | (0x3f & charCode);\n }\n return dst;\n}\n\nstatic int utf8canon(char *dst, const char *data, int size) {\n int outsz = 0;\n for (int i = 0; i < size;) {\n uint8_t c = data[i];\n uint32_t charCode = c;\n if ((c & 0x80) == 0x00) {\n charCode = c;\n i++;\n } else if ((c & 0xe0) == 0xc0 && i + 1 < size && (data[i + 1] & 0xc0) == 0x80) {\n charCode = ((c & 0x1f) << 6) | (data[i + 1] & 0x3f);\n if (charCode < 0x80)\n goto error;\n else\n i += 2;\n } else if ((c & 0xf0) == 0xe0 && i + 2 < size && (data[i + 1] & 0xc0) == 0x80 &&\n (data[i + 2] & 0xc0) == 0x80) {\n charCode = ((c & 0x0f) << 12) | (data[i + 1] & 0x3f) << 6 | (data[i + 2] & 0x3f);\n // don't exclude surrogate pairs, since we're generating them\n if (charCode < 0x800 /*|| (0xd800 <= charCode && charCode <= 0xdfff)*/)\n goto error;\n else\n i += 3;\n } else if ((c & 0xf8) == 0xf0 && i + 3 < size && (data[i + 1] & 0xc0) == 0x80 &&\n (data[i + 2] & 0xc0) == 0x80 && (data[i + 3] & 0xc0) == 0x80) {\n charCode = ((c & 0x07) << 18) | (data[i + 1] & 0x3f) << 12 | (data[i + 2] & 0x3f) << 6 |\n (data[i + 3] & 0x3f);\n if (charCode < 0x10000 || charCode > 0x10ffff)\n goto error;\n else\n i += 4;\n } else {\n goto error;\n }\n\n if (charCode < 0x80) {\n outsz += 1;\n if (dst)\n *dst++ = charCode;\n } else if (charCode < 0x800) {\n outsz += 2;\n dst = write2byte(dst, charCode);\n } else if (charCode < 0x10000) {\n outsz += 3;\n dst = write3byte(dst, charCode);\n } else {\n outsz += 6; // a surrogate pair\n charCode -= 0x10000;\n dst = write3byte(dst, 0xd800 + (charCode >> 10));\n dst = write3byte(dst, 0xdc00 + (charCode & 0x3ff));\n }\n\n continue;\n\n error:\n i++;\n outsz += 2;\n dst = write2byte(dst, c);\n }\n return outsz;\n}\n\nstatic int utf8CharCode(const char *data) {\n unsigned char c = *data;\n if ((c & 0x80) == 0) {\n return c;\n } else if ((c & 0xe0) == 0xc0) {\n return ((c & 0x1f) << 6) | (data[1] & 0x3f);\n } else if ((c & 0xf0) == 0xe0) {\n return ((c & 0x0f) << 12) | (data[1] & 0x3f) << 6 | (data[2] & 0x3f);\n } else {\n return c; // error\n }\n}\n\nstatic bool isUTF8(const char *data, int len) {\n for (int i = 0; i < len; ++i) {\n if (data[i] & 0x80)\n return true;\n }\n return false;\n}\n\nstatic void setupSkipList(String r, const char *data, int packed) {\n char *dst = (char *)(packed ? PXT_SKIP_DATA_PACK(r) : PXT_SKIP_DATA_IND(r));\n auto len = r->skip.size;\n if (data)\n memcpy(dst, data, len);\n #pragma GCC diagnostic push\n #pragma GCC diagnostic ignored \"-Wstringop-overflow\"\n dst[len] = 0;\n #pragma GCC diagnostic pop\n const char *ptr = dst;\n auto skipEntries = PXT_NUM_SKIP_ENTRIES(r);\n auto lst = packed ? r->skip_pack.list : r->skip.list;\n for (int i = 0; i < skipEntries; ++i) {\n ptr = utf8Skip(ptr, (int)(len - (ptr - dst)), PXT_STRING_SKIP_INCR);\n if (!ptr)\n oops(80);\n lst[i] = ptr - dst;\n }\n}\n#endif\n\nString mkStringCore(const char *data, int len) {\n if (len < 0)\n len = (int)strlen(data);\n if (len == 0)\n return (String)emptyString;\n\n auto vt = &string_inline_ascii_vt;\n String r;\n\n#if PXT_UTF8\n if (data && isUTF8(data, len)) {\n vt = len >= PXT_STRING_MIN_SKIP ? &string_skiplist16_packed_vt : &string_inline_utf8_vt;\n }\n if (vt == &string_skiplist16_packed_vt) {\n int ulen = utf8Len(data, len);\n r = new (gcAllocate(sizeof(void *) + 2 + 2 + (ulen / PXT_STRING_SKIP_INCR) * 2 + len + 1))\n BoxedString(vt);\n r->skip_pack.size = len;\n r->skip_pack.length = ulen;\n setupSkipList(r, data, 1);\n } else\n#endif\n {\n // for ASCII and UTF8 the layout is the same\n r = new (gcAllocate(sizeof(void *) + 2 + len + 1)) BoxedString(vt);\n r->ascii.length = len;\n if (data)\n memcpy(r->ascii.data, data, len);\n r->ascii.data[len] = 0;\n }\n\n MEMDBG(\"mkString: len=%d => %p\", len, r);\n return r;\n}\n\nString mkString(const char *data, int len) {\n#if PXT_UTF8\n if (len < 0)\n len = (int)strlen(data);\n if (len == 0)\n return (String)emptyString;\n\n int sz = utf8canon(NULL, data, len);\n if (sz == len)\n return mkStringCore(data, len);\n // this could be optimized, but it only kicks in when the string isn't valid utf8\n // (or we need to introduce surrogate pairs) which is unlikely to be performance critical\n char *tmp = (char *)app_alloc(sz);\n utf8canon(tmp, data, len);\n auto r = mkStringCore(tmp, sz);\n app_free(tmp);\n return r;\n#else\n return mkStringCore(data, len);\n#endif\n}\n\n#if PXT_UTF8\n// This converts surrogate pairs, which are encoded as 2 characters of 3 bytes each\n// into a proper 4 byte utf-8 character.\nuint32_t toRealUTF8(String str, uint8_t *dst) {\n auto src = str->getUTF8Data();\n auto len = str->getUTF8Size();\n auto dlen = 0;\n\n for (unsigned i = 0; i < len; ++i) {\n if ((uint8_t)src[i] == 0xED && i + 5 < len) {\n auto c0 = utf8CharCode(src + i);\n auto c1 = utf8CharCode(src + i + 3);\n if (0xd800 <= c0 && c0 < 0xdc00 && 0xdc00 <= c1 && c1 < 0xe000) {\n i += 5;\n auto charCode = ((c0 - 0xd800) << 10) + (c1 - 0xdc00) + 0x10000;\n if (dst) {\n dst[dlen] = 0xf0 | (charCode >> 18);\n dst[dlen + 1] = 0x80 | (0x3f & (charCode >> 12));\n dst[dlen + 2] = 0x80 | (0x3f & (charCode >> 6));\n dst[dlen + 3] = 0x80 | (0x3f & (charCode >> 0));\n }\n dlen += 4;\n }\n } else {\n if (dst)\n dst[dlen] = src[i];\n dlen++;\n }\n }\n return dlen;\n}\n#endif\n\nBuffer mkBuffer(const void *data, int len) {\n if (len <= 0)\n return (Buffer)emptyBuffer;\n Buffer r = new (gcAllocate(sizeof(BoxedBuffer) + len)) BoxedBuffer();\n r->length = len;\n if (data)\n memcpy(r->data, data, len);\n else\n memset(r->data, 0, len);\n MEMDBG(\"mkBuffer: len=%d => %p\", len, r);\n return r;\n}\n\nstatic unsigned random_value = 0xC0DA1;\n\n//%\nvoid seedRandom(unsigned seed) {\n random_value = seed;\n}\n\n//% expose\nvoid seedAddRandom(unsigned seed) {\n random_value ^= 0xCA2557CB * seed;\n}\n\nunsigned getRandom(unsigned max) {\n unsigned m, result;\n\n do {\n m = (unsigned)max;\n result = 0;\n\n do {\n // Cycle the LFSR (Linear Feedback Shift Register).\n // We use an optimal sequence with a period of 2^32-1, as defined by Bruce Schneier here\n // (a true legend in the field!),\n // For those interested, it's documented in his paper:\n // \"Pseudo-Random Sequence Generator for 32-Bit CPUs: A fast, machine-independent\n // generator for 32-bit Microprocessors\"\n // https://www.schneier.com/paper-pseudorandom-sequence.html\n unsigned r = random_value;\n\n r = ((((r >> 31) ^ (r >> 6) ^ (r >> 4) ^ (r >> 2) ^ (r >> 1) ^ r) & 1) << 31) |\n (r >> 1);\n\n random_value = r;\n\n result = ((result << 1) | (r & 0x00000001));\n } while (m >>= 1);\n } while (result > (unsigned)max);\n\n return result;\n}\n\nTNumber BoxedString::charCodeAt(int pos) {\n#if PXT_UTF8\n auto ptr = this->getUTF8DataAt(pos);\n if (!ptr)\n return TAG_NAN;\n auto code = utf8CharCode(ptr);\n if (!code && ptr == this->getUTF8Data() + this->getUTF8Size())\n return TAG_NAN;\n return fromInt(code);\n#else\n if (0 <= pos && pos < this->ascii.length) {\n return fromInt(this->ascii.data[pos]);\n } else {\n return TAG_NAN;\n }\n#endif\n}\n\nPXT_DEF_STRING(sTrue, \"true\")\nPXT_DEF_STRING(sFalse, \"false\")\nPXT_DEF_STRING(sUndefined, \"undefined\")\nPXT_DEF_STRING(sNull, \"null\")\nPXT_DEF_STRING(sObject, \"[Object]\")\nPXT_DEF_STRING(sFunction, \"[Function]\")\nPXT_DEF_STRING(sNaN, \"NaN\")\nPXT_DEF_STRING(sInf, \"Infinity\")\nPXT_DEF_STRING(sMInf, \"-Infinity\")\n} // namespace pxt\n\n#ifndef X86_64\n\nnamespace String_ {\n\n//%\nString mkEmpty() {\n return (String)emptyString;\n}\n\n// TODO support var-args somehow?\n\n//%\nString fromCharCode(int code) {\n#if PXT_UTF8\n char buf[3];\n int len;\n code &= 0xffff; // JS semantics\n if (code < 0x80) {\n buf[0] = code;\n len = 1;\n } else if (code < 0x800) {\n buf[0] = 0xc0 | (code >> 6);\n buf[1] = 0x80 | ((code >> 0) & 0x3f);\n len = 2;\n } else {\n buf[0] = 0xe0 | (code >> 12);\n buf[1] = 0x80 | ((code >> 6) & 0x3f);\n buf[2] = 0x80 | ((code >> 0) & 0x3f);\n len = 3;\n }\n return mkStringCore(buf, len);\n#else\n char buf[] = {(char)code, 0};\n return mkStringCore(buf, 1);\n#endif\n}\n\n//%\nTNumber charCodeAt(String s, int pos) {\n if (!s)\n return TAG_NAN;\n return s->charCodeAt(pos);\n}\n\n//%\nString charAt(String s, int pos) {\n auto v = charCodeAt(s, pos);\n if (v == TAG_NAN)\n return mkEmpty();\n if (!isInt(v))\n oops(81);\n return fromCharCode(numValue(v));\n}\n\n#define IS_CONS(s) ((s)->vtable == &string_cons_vt)\n#define IS_EMPTY(s) ((s) == (String)emptyString)\n\n//%\nString concat(String s, String other) {\n if (!s)\n s = (String)sNull;\n if (!other)\n other = (String)sNull;\n if (IS_EMPTY(s))\n return other;\n if (IS_EMPTY(other))\n return s;\n\n uint32_t lenA, lenB;\n\n#if PXT_UTF8\n if (IS_CONS(s)) {\n // (s->cons.left + s->cons.right) + other = s->cons.left + (s->cons.right + other)\n if (IS_CONS(other) || IS_CONS(s->cons.right))\n goto mkCons;\n auto lenAR = s->cons.right->getUTF8Size();\n lenB = other->getUTF8Size(); // de-consify other\n if (lenAR + lenB > SHORT_CONCAT_STRING)\n goto mkCons;\n // if (s->cons.right + other) is short enough, use associativity\n // to construct a shallower tree; this should keep the live set reasonable\n // when someone decides to construct a long string by concatenating\n // single characters\n\n // allocate [r] first, and keep it alive\n String r = new (gcAllocate(3 * sizeof(void *))) BoxedString(&string_cons_vt);\n registerGCObj(r);\n r->cons.left = s->cons.left;\n // this concat() might trigger GC\n r->cons.right = concat(s->cons.right, other);\n unregisterGCObj(r);\n return r;\n }\n#endif\n\n lenA = s->getUTF8Size();\n lenB = other->getUTF8Size();\n#if PXT_UTF8\n if (lenA + lenB > SHORT_CONCAT_STRING)\n goto mkCons;\n#endif\n String r;\n {\n auto dataA = s->getUTF8Data();\n auto dataB = other->getUTF8Data();\n r = mkStringCore(NULL, lenA + lenB);\n auto dst = (char *)r->getUTF8Data();\n memcpy(dst, dataA, lenA);\n memcpy(dst + lenA, dataB, lenB);\n#if PXT_UTF8\n if (isUTF8(dst, lenA + lenB))\n r->vtable = &string_inline_utf8_vt;\n#endif\n return r;\n }\n\n#if PXT_UTF8\nmkCons:\n r = new (gcAllocate(3 * sizeof(void *))) BoxedString(&string_cons_vt);\n r->cons.left = s;\n r->cons.right = other;\n return r;\n#endif\n}\n\nint compare(String a, String b) {\n if (a == b)\n return 0;\n\n auto lenA = a->getUTF8Size();\n auto lenB = b->getUTF8Size();\n auto dataA = a->getUTF8Data();\n auto dataB = b->getUTF8Data();\n auto len = lenA < lenB ? lenA : lenB;\n\n // this also works for UTF8, provided canonical encoding\n // which is guaranteed by the constructor\n for (unsigned i = 0; i <= len; ++i) {\n unsigned char cA = dataA[i];\n unsigned char cB = dataB[i];\n if (cA == cB)\n continue;\n return cA < cB ? -1 : 1;\n }\n return 0;\n}\n\n//%\nint length(String s) {\n return s->getLength();\n}\n\n#define isspace(c) ((c) == ' ')\n#define iswhitespace(c) \\\n ((c) == 0x09 || (c) == 0x0B || (c) == 0x0C || (c) == 0x20 || (uint8_t)(c) == 0xA0 || \\\n (c) == 0x0A || (c) == 0x0D)\n\nNUMBER mystrtod(const char *p, char **endp) {\n while (iswhitespace(*p))\n p++;\n NUMBER m = 1;\n NUMBER v = 0;\n int dot = 0;\n int hasDigit = 0;\n if (*p == '+')\n p++;\n if (*p == '-') {\n m = -1;\n p++;\n }\n\n while (*p) {\n int c = *p - '0';\n if (0 <= c && c <= 9) {\n v *= 10;\n v += c;\n if (dot)\n m /= 10;\n hasDigit = 1;\n } else if (!dot && *p == '.') {\n dot = 1;\n } else if (!hasDigit) {\n return NAN;\n } else {\n break;\n }\n p++;\n }\n\n v *= m;\n\n if (*p == 'e' || *p == 'E') {\n p++;\n int pw = (int)strtol(p, endp, 10);\n v *= p10(pw);\n } else {\n *endp = (char *)p;\n }\n\n return v;\n}\n\n//%\nTNumber toNumber(String s) {\n // JSCHECK\n char *endptr;\n auto data = s->getUTF8Data();\n NUMBER v = mystrtod(data, &endptr);\n if (v == 0.0 || v == -0.0) {\n // nothing\n } else if (!isnormal(v))\n v = NAN;\n return fromDouble(v);\n}\n\n//%\nString substr(String s, int start, int length) {\n if (length <= 0)\n return mkEmpty();\n auto slen = (int)s->getLength();\n if (start < 0)\n start = pxt::max(slen + start, 0);\n length = pxt::min(length, slen - start);\n if (length <= 0)\n return mkEmpty();\n auto p = s->getUTF8DataAt(start);\n#if PXT_UTF8\n auto ep = s->getUTF8DataAt(start + length);\n if (ep == NULL)\n oops(82);\n return mkStringCore(p, (int)(ep - p));\n#else\n return mkStringCore(p, length);\n#endif\n}\n\n//%\nint indexOf(String s, String searchString, int start) {\n if (!s || !searchString)\n return -1;\n\n if (start < 0)\n start = 0;\n\n auto dataA0 = s->getUTF8Data();\n auto dataA = s->getUTF8DataAt(start);\n auto offset = dataA - dataA0;\n auto lenA = s->getUTF8Size() - offset;\n auto lenB = searchString->getUTF8Size();\n\n if (dataA == NULL || lenB > lenA)\n return -1;\n\n auto dataB = searchString->getUTF8Data();\n auto firstB = dataB[0];\n while (lenA >= lenB) {\n if (*dataA == firstB && !memcmp(dataA, dataB, lenB))\n#if PXT_UTF8\n return utf8Len(dataA0, (int)(dataA - dataA0));\n#else\n return dataA - dataA0;\n#endif\n dataA++;\n lenA--;\n }\n return -1;\n}\n\n//%\nint includes(String s, String searchString, int start) {\n return -1 != indexOf(s, searchString, start);\n}\n\n} // namespace String_\n\nnamespace Boolean_ {\n//%\nbool bang(bool v) {\n return v == 0;\n}\n} // namespace Boolean_\n\nnamespace pxt {\n\n// ES5 9.5, 9.6\nunsigned toUInt(TNumber v) {\n if (isInt(v))\n return numValue(v);\n if (isSpecial(v)) {\n if ((intptr_t)v >> 6)\n return 1;\n else\n return 0;\n }\n if (!v)\n return 0;\n\n NUMBER num = toDouble(v);\n if (!isnormal(num))\n return 0;\n#ifdef PXT_USE_FLOAT\n float rem = fmodf(truncf(num), 4294967296.0);\n#else\n double rem = fmod(trunc(num), 4294967296.0);\n#endif\n if (rem < 0.0)\n rem += 4294967296.0;\n return (unsigned)rem;\n}\nint toInt(TNumber v) {\n return (int)toUInt(v);\n}\n\nNUMBER toDouble(TNumber v) {\n if (v == TAG_NAN || v == TAG_UNDEFINED)\n return NAN;\n if (isTagged(v))\n return toInt(v);\n\n#ifdef PXT64\n if (isDouble(v))\n return doubleVal(v);\n#endif\n\n ValType t = valType(v);\n\n#ifndef PXT64\n if (t == ValType::Number) {\n BoxedNumber *p = (BoxedNumber *)v;\n return p->num;\n }\n#endif\n\n if (t == ValType::String) {\n // TODO avoid allocation\n auto tmp = String_::toNumber((String)v);\n auto r = toDouble(tmp);\n return r;\n } else {\n return NAN;\n }\n}\n\nfloat toFloat(TNumber v) {\n if (v == TAG_NAN || v == TAG_UNDEFINED)\n return NAN;\n // optimize for the int case - this will avoid software conversion when FPU is present\n if (isTagged(v))\n return toInt(v);\n return (float)toDouble(v);\n}\n\n#if !defined(PXT_HARD_FLOAT) && !defined(PXT_USE_FLOAT)\nunion NumberConv {\n double v;\n struct {\n uint32_t word0;\n uint32_t word1;\n };\n};\n\nstatic inline TValue doubleToInt(double x) {\n NumberConv cnv;\n cnv.v = x;\n\n if (cnv.word1 == 0 && cnv.word0 == 0)\n return TAG_NUMBER(0);\n\n auto ex = (int)((cnv.word1 << 1) >> 21) - 1023;\n\n // DMESG(\"v=%d/1000 %p %p %d\", (int)(x * 1000), cnv.word0, cnv.word1, ex);\n\n if (ex < 0 || ex > 29) {\n // the 'MININT' case\n if (ex == 30 && cnv.word0 == 0 && cnv.word1 == 0xC1D00000)\n return (TValue)(0x80000001);\n return NULL;\n }\n\n int32_t r;\n\n if (ex <= 20) {\n if (cnv.word0)\n return TAG_UNDEFINED;\n if (cnv.word1 << (ex + 12))\n return TAG_UNDEFINED;\n r = ((cnv.word1 << 11) | 0x80000000) >> (20 - ex + 11);\n } else {\n if (cnv.word0 << (ex - 20))\n return TAG_UNDEFINED;\n r = ((cnv.word1 << 11) | 0x80000000) >> (20 - ex + 11);\n r |= cnv.word0 >> (32 - (ex - 20));\n }\n\n if (cnv.word1 >> 31)\n return TAG_NUMBER(-r);\n else\n return TAG_NUMBER(r);\n}\n#else\nstatic inline TValue doubleToInt(NUMBER r) {\n#ifdef PXT64\n if ((int)r == r)\n return TAG_NUMBER((int)r);\n#else\n int ri = ((int)r) << 1;\n if ((ri >> 1) == r)\n return (TNumber)(uintptr_t)(ri | 1);\n#endif\n return TAG_UNDEFINED;\n}\n#endif\n\nTNumber fromDouble(NUMBER r) {\n#ifndef PXT_BOX_DEBUG\n auto i = doubleToInt(r);\n if (i)\n return i;\n#endif\n if (isnan(r))\n return TAG_NAN;\n#ifdef PXT64\n return tvalueFromDouble(r);\n#else\n BoxedNumber *p = NEW_GC(BoxedNumber);\n p->num = r;\n MEMDBG(\"mkNum: %d/1000 => %p\", (int)(r * 1000), p);\n return (TNumber)p;\n#endif\n}\n\nTNumber fromFloat(float r) {\n // TODO optimize\n return fromDouble(r);\n}\n\nTNumber fromInt(int v) {\n if (canBeTagged(v))\n return TAG_NUMBER(v);\n return fromDouble(v);\n}\n\nTNumber fromUInt(unsigned v) {\n#ifndef PXT_BOX_DEBUG\n if (v <= 0x3fffffff)\n return TAG_NUMBER(v);\n#endif\n return fromDouble(v);\n}\n\nTValue fromBool(bool v) {\n if (v)\n return TAG_TRUE;\n else\n return TAG_FALSE;\n}\n\nTNumber eqFixup(TNumber v) {\n if (v == TAG_NULL)\n return TAG_UNDEFINED;\n if (v == TAG_TRUE)\n return TAG_NUMBER(1);\n if (v == TAG_FALSE)\n return TAG_NUMBER(0);\n return v;\n}\n\nstatic inline bool eq_core(TValue a, TValue b, ValType ta) {\n#ifndef PXT_BOX_DEBUG\n auto aa = (intptr_t)a;\n auto bb = (intptr_t)b;\n\n // if at least one of the values is tagged, they are not equal\n if ((aa | bb) & 3)\n return false;\n#endif\n\n if (ta == ValType::String)\n return String_::compare((String)a, (String)b) == 0;\n else if (ta == ValType::Number)\n return toDouble(a) == toDouble(b);\n else\n return a == b;\n}\n\nbool eqq_bool(TValue a, TValue b) {\n if (a == TAG_NAN || b == TAG_NAN)\n return false;\n\n if (a == b)\n return true;\n\n if (bothNumbers(a, b))\n return false;\n\n ValType ta = valType(a);\n ValType tb = valType(b);\n\n if (ta != tb)\n return false;\n\n return eq_core(a, b, ta);\n}\n\nbool eq_bool(TValue a, TValue b) {\n if (a == TAG_NAN || b == TAG_NAN)\n return false;\n\n if (eqFixup(a) == eqFixup(b))\n return true;\n\n if (bothNumbers(a, b))\n return false;\n\n ValType ta = valType(a);\n ValType tb = valType(b);\n\n if ((ta == ValType::String && tb == ValType::Number) ||\n (tb == ValType::String && ta == ValType::Number))\n return toDouble(a) == toDouble(b);\n\n if (ta == ValType::Boolean) {\n a = eqFixup(a);\n ta = ValType::Number;\n }\n if (tb == ValType::Boolean) {\n b = eqFixup(b);\n tb = ValType::Number;\n }\n\n if (ta != tb)\n return false;\n\n return eq_core(a, b, ta);\n}\n\n// TODO move to assembly\n//%\nbool switch_eq(TValue a, TValue b) {\n if (eq_bool(a, b)) {\n return true;\n }\n return false;\n}\n\n} // namespace pxt\n\n#define NUMOP(op) return fromDouble(toDouble(a) op toDouble(b));\n#define BITOP(op) return fromInt(toInt(a) op toInt(b));\nnamespace numops {\n\nint toBool(TValue v) {\n if (isTagged(v)) {\n if (v == TAG_FALSE || v == TAG_UNDEFINED || v == TAG_NAN || v == TAG_NULL ||\n v == TAG_NUMBER(0))\n return 0;\n else\n return 1;\n }\n\n ValType t = valType(v);\n if (t == ValType::String) {\n String s = (String)v;\n if (IS_EMPTY(s))\n return 0;\n } else if (t == ValType::Number) {\n auto x = toDouble(v);\n if (isnan(x) || x == 0.0 || x == -0.0)\n return 0;\n else\n return 1;\n }\n\n return 1;\n}\n\nint toBoolDecr(TValue v) {\n if (v == TAG_TRUE)\n return 1;\n if (v == TAG_FALSE)\n return 0;\n return toBool(v);\n}\n\n// The integer, non-overflow case for add/sub/bit opts is handled in assembly\n\n#ifdef PXT_VM\n#define NUMOP2(op) \\\n if (bothNumbers(a, b)) { \\\n auto tmp = (int64_t)numValue(a) op(int64_t) numValue(b); \\\n if ((int)tmp == tmp) \\\n return TAG_NUMBER((int)tmp); \\\n } \\\n NUMOP(op)\n#else\n#define NUMOP2(op) NUMOP(op)\n#endif\n\n//%\nTNumber adds(TNumber a, TNumber b){NUMOP2(+)}\n\n//%\nTNumber subs(TNumber a, TNumber b){NUMOP2(-)}\n\n//%\nTNumber muls(TNumber a, TNumber b) {\n if (bothNumbers(a, b)) {\n#ifdef PXT64\n auto tmp = (int64_t)numValue(a) * (int64_t)numValue(b);\n if ((int)tmp == tmp)\n return TAG_NUMBER((int)tmp);\n#else\n int aa = (int)a;\n int bb = (int)b;\n // if both operands fit 15 bits, the result will not overflow int\n if ((aa >> 15 == 0 || aa >> 15 == -1) && (bb >> 15 == 0 || bb >> 15 == -1)) {\n // it may overflow 31 bit int though - use fromInt to convert properly\n return fromInt((aa >> 1) * (bb >> 1));\n }\n#endif\n }\n NUMOP(*)\n}\n\n//%\nTNumber div(TNumber a, TNumber b) {\n if (b == TAG_NUMBER(1))\n return a;\n NUMOP(/)\n}\n\n//%\nTNumber mod(TNumber a, TNumber b) {\n if (isInt(a) && isInt(b) && numValue(b))\n BITOP(%)\n return fromDouble(fmod(toDouble(a), toDouble(b)));\n}\n\n//%\nTNumber lsls(TNumber a, TNumber b) {\n return fromInt(toInt(a) << (toInt(b) & 0x1f));\n}\n\n//%\nTNumber lsrs(TNumber a, TNumber b) {\n return fromUInt(toUInt(a) >> (toUInt(b) & 0x1f));\n}\n\n//%\nTNumber asrs(TNumber a, TNumber b) {\n return fromInt(toInt(a) >> (toInt(b) & 0x1f));\n}\n\n//%\nTNumber eors(TNumber a, TNumber b){BITOP(^)}\n\n//%\nTNumber orrs(TNumber a, TNumber b){BITOP(|)}\n\n//%\nTNumber bnot(TNumber a) {\n return fromInt(~toInt(a));\n}\n\n//%\nTNumber ands(TNumber a, TNumber b) {\n BITOP(&)\n}\n\n#ifdef PXT64\n#define CMPOP_RAW(op, t, f) \\\n if (bothNumbers(a, b)) \\\n return numValue(a) op numValue(b) ? t : f; \\\n int cmp = valCompare(a, b); \\\n return cmp != -2 && cmp op 0 ? t : f;\n#else\n#define CMPOP_RAW(op, t, f) \\\n if (bothNumbers(a, b)) \\\n return (intptr_t)a op((intptr_t)b) ? t : f; \\\n int cmp = valCompare(a, b); \\\n return cmp != -2 && cmp op 0 ? t : f;\n#endif\n\n#define CMPOP(op) CMPOP_RAW(op, TAG_TRUE, TAG_FALSE)\n\n// 7.2.13 Abstract Relational Comparison\nstatic int valCompare(TValue a, TValue b) {\n if (a == TAG_NAN || b == TAG_NAN)\n return -2;\n\n ValType ta = valType(a);\n ValType tb = valType(b);\n\n if (ta == ValType::String && tb == ValType::String)\n return String_::compare((String)a, (String)b);\n\n if (a == b)\n return 0;\n\n auto da = toDouble(a);\n auto db = toDouble(b);\n\n if (isnan(da) || isnan(db))\n return -2;\n\n if (da < db)\n return -1;\n else if (da > db)\n return 1;\n else\n return 0;\n}\n\n//%\nbool lt_bool(TNumber a, TNumber b){CMPOP_RAW(<, true, false)}\n\n//%\nTNumber le(TNumber a, TNumber b){CMPOP(<=)}\n\n//%\nTNumber lt(TNumber a, TNumber b){CMPOP(<)}\n\n//%\nTNumber ge(TNumber a, TNumber b){CMPOP(>=)}\n\n//%\nTNumber gt(TNumber a, TNumber b){CMPOP(>)}\n\n//%\nTNumber eq(TNumber a, TNumber b) {\n return pxt::eq_bool(a, b) ? TAG_TRUE : TAG_FALSE;\n}\n\n//%\nTNumber neq(TNumber a, TNumber b) {\n return !pxt::eq_bool(a, b) ? TAG_TRUE : TAG_FALSE;\n}\n\n//%\nTNumber eqq(TNumber a, TNumber b) {\n return pxt::eqq_bool(a, b) ? TAG_TRUE : TAG_FALSE;\n}\n\n//%\nTNumber neqq(TNumber a, TNumber b) {\n return !pxt::eqq_bool(a, b) ? TAG_TRUE : TAG_FALSE;\n}\n\n// How many significant digits mycvt() should output.\n// This cannot be more than 15, as this is the most that can be accurately represented\n// in 64 bit double. Otherwise this code may crash.\n#define DIGITS 15\n\nstatic const uint64_t pows[] = {\n 1LL, 10LL, 100LL, 1000LL, 10000LL,\n 100000LL, 1000000LL, 10000000LL, 100000000LL, 1000000000LL,\n 10000000000LL, 100000000000LL, 1000000000000LL, 10000000000000LL, 100000000000000LL,\n};\n\n// The basic idea is we convert d to a 64 bit integer with DIGITS\n// digits, and then print it out, putting dot in the right place.\n\nvoid mycvt(NUMBER d, char *buf) {\n if (d < 0) {\n *buf++ = '-';\n d = -d;\n }\n\n if (!d) {\n *buf++ = '0';\n *buf++ = 0;\n return;\n }\n\n int pw = (int)log10(d);\n int e = 1;\n\n // if outside 1e-6 -- 1e21 range, we use the e-notation\n if (d < 1e-6 || d > 1e21) {\n // normalize number to 1.XYZ, save e, and reset pw\n if (pw < 0)\n d *= p10(-pw);\n else\n d /= p10(pw);\n e = pw;\n pw = 0;\n }\n\n int trailingZ = 0;\n int dotAfter = pw + 1; // at which position the dot should be in the number\n\n uint64_t dd;\n\n // normalize number to be integer with exactly DIGITS digits\n if (pw >= DIGITS) {\n // if the number is larger than DIGITS, we need trailing zeroes\n trailingZ = pw - DIGITS + 1;\n dd = (uint64_t)(d / p10(trailingZ) + 0.5);\n } else {\n dd = (uint64_t)(d * p10(DIGITS - pw - 1) + 0.5);\n }\n\n // if number is less than 1, we need 0.00...00 at the beginning\n if (dotAfter < 1) {\n *buf++ = '0';\n *buf++ = '.';\n int n = -dotAfter;\n while (n--)\n *buf++ = '0';\n }\n\n // now print out the actual number\n for (int i = DIGITS - 1; i >= 0; i--) {\n uint64_t q = pows[i];\n // this may be faster than fp-division and fmod(); or maybe not\n // anyways, it works\n int k = '0';\n while (dd >= q) {\n dd -= q;\n k++;\n }\n *buf++ = k;\n // if we're after dot, and what's left is zeroes, stop\n if (dd == 0 && (DIGITS - i) >= dotAfter)\n break;\n // print the dot, if we arrived at it\n if ((DIGITS - i) == dotAfter)\n *buf++ = '.';\n }\n\n // print out remaining trailing zeroes if any\n while (trailingZ-- > 0)\n *buf++ = '0';\n\n // if we used e-notation, handle that\n if (e != 1) {\n *buf++ = 'e';\n if (e > 0)\n *buf++ = '+';\n itoa(e, buf);\n } else {\n *buf = 0;\n }\n}\n\n#if 0\n//%\nTValue floatAsInt(TValue x) {\n return doubleToInt(toDouble(x));\n}\n\n//% shim=numops::floatAsInt\nfunction floatAsInt(v: number): number { return 0 }\n\nfunction testInt(i: number) {\n if (floatAsInt(i) != i)\n control.panic(101)\n if (floatAsInt(i + 0.5) != null)\n control.panic(102)\n if (floatAsInt(i + 0.00001) != null)\n control.panic(103)\n}\n\nfunction testFloat(i: number) {\n if (floatAsInt(i) != null)\n control.panic(104)\n}\n\nfunction testFloatAsInt() {\n for (let i = 0; i < 0xffff; ++i) {\n testInt(i)\n testInt(-i)\n testInt(i * 10000)\n testInt(i << 12)\n testInt(i + 0x3fff0001)\n testInt(-i - 0x3fff0002)\n testFloat(i + 0x3fffffff + 1)\n testFloat((i + 10000) * 1000000)\n }\n}\n#endif\n\nString toString(TValue v) {\n ValType t = valType(v);\n\n if (t == ValType::String) {\n return (String)v;\n } else if (t == ValType::Number) {\n char buf[64];\n\n if (isInt(v)) {\n itoa(numValue(v), buf);\n return mkStringCore(buf);\n }\n\n if (v == TAG_NAN)\n return (String)(void *)sNaN;\n\n auto x = toDouble(v);\n\n#ifdef PXT_BOX_DEBUG\n if (x == (int)x) {\n itoa((int)x, buf);\n return mkStringCore(buf);\n }\n#endif\n\n if (isinf(x)) {\n if (x < 0)\n return (String)(void *)sMInf;\n else\n return (String)(void *)sInf;\n } else if (isnan(x)) {\n return (String)(void *)sNaN;\n }\n mycvt(x, buf);\n\n return mkStringCore(buf);\n } else if (t == ValType::Function) {\n return (String)(void *)sFunction;\n } else {\n if (v == TAG_UNDEFINED)\n return (String)(void *)sUndefined;\n else if (v == TAG_FALSE)\n return (String)(void *)sFalse;\n else if (v == TAG_NAN)\n return (String)(void *)sNaN;\n else if (v == TAG_TRUE)\n return (String)(void *)sTrue;\n else if (v == TAG_NULL)\n return (String)(void *)sNull;\n return (String)(void *)sObject;\n }\n}\n\n} // namespace numops\n\nnamespace Math_ {\n//%\nTNumber pow(TNumber x, TNumber y) {\n#ifdef PXT_POWI\n // regular pow() from math.h is 4k of code\n return fromDouble(__builtin_powi(toDouble(x), toInt(y)));\n#else\n return fromDouble(::pow(toDouble(x), toDouble(y)));\n#endif\n}\n\nNUMBER randomDouble() {\n return getRandom(UINT_MAX) / ((NUMBER)UINT_MAX + 1) +\n getRandom(0xffffff) / ((NUMBER)UINT_MAX * 0xffffff);\n}\n\n//%\nTNumber random() {\n return fromDouble(randomDouble());\n}\n\n//%\nTNumber randomRange(TNumber min, TNumber max) {\n if (isInt(min) && isInt(max)) {\n int mini = numValue(min);\n int maxi = numValue(max);\n if (mini > maxi) {\n int temp = mini;\n mini = maxi;\n maxi = temp;\n }\n if (maxi == mini)\n return fromInt(mini);\n else\n return fromInt(mini + getRandom(maxi - mini));\n } else {\n auto mind = toDouble(min);\n auto maxd = toDouble(max);\n if (mind > maxd) {\n auto temp = mind;\n mind = maxd;\n maxd = temp;\n }\n if (maxd == mind)\n return fromDouble(mind);\n else {\n return fromDouble(mind + randomDouble() * (maxd - mind));\n }\n }\n}\n\n#define SINGLE(op) return fromDouble(::op(toDouble(x)));\n\n//%\nTNumber log(TNumber x){SINGLE(log)}\n\n//%\nTNumber log10(TNumber x){SINGLE(log10)}\n\n//%\nTNumber floor(TNumber x){SINGLE(floor)}\n\n//%\nTNumber ceil(TNumber x){SINGLE(ceil)}\n\n//%\nTNumber trunc(TNumber x){SINGLE(trunc)}\n\n//%\nTNumber round(TNumber x) {\n // In C++, round(-1.5) == -2, while in JS, round(-1.5) == -1. Align to the JS convention for\n // consistency between simulator and device. The following does rounding with ties (x.5) going\n // towards positive infinity.\n return fromDouble(::floor(toDouble(x) + 0.5));\n}\n\n//%\nint imul(int x, int y) {\n return x * y;\n}\n\n//%\nint idiv(int x, int y) {\n return x / y;\n}\n} // namespace Math_\n\nnamespace Array_ {\nRefCollection *mk() {\n auto r = NEW_GC(RefCollection);\n MEMDBG(\"mkColl: => %p\", r);\n return r;\n}\nint length(RefCollection *c) {\n return c->length();\n}\nvoid setLength(RefCollection *c, int newLength) {\n c->setLength(newLength);\n}\nvoid push(RefCollection *c, TValue x) {\n c->head.push(x);\n}\nTValue pop(RefCollection *c) {\n return c->head.pop();\n}\nTValue getAt(RefCollection *c, int x) {\n return c->head.get(x);\n}\nvoid setAt(RefCollection *c, int x, TValue y) {\n c->head.set(x, y);\n}\nTValue removeAt(RefCollection *c, int x) {\n return c->head.remove(x);\n}\nvoid insertAt(RefCollection *c, int x, TValue value) {\n c->head.insert(x, value);\n}\nint indexOf(RefCollection *c, TValue x, int start) {\n auto data = c->head.getData();\n auto len = c->head.getLength();\n for (unsigned i = 0; i < len; i++) {\n if (pxt::eq_bool(data[i], x)) {\n return (int)i;\n }\n }\n return -1;\n}\nbool removeElement(RefCollection *c, TValue x) {\n int idx = indexOf(c, x, 0);\n if (idx >= 0) {\n decr(removeAt(c, idx));\n return 1;\n }\n return 0;\n}\n} // namespace Array_\n\nnamespace pxt {\nint debugFlags;\n\n//%\nvoid *ptrOfLiteral(int offset);\n\n#ifdef PXT_VM\nunsigned programSize() {\n return 0;\n}\n#else\n//%\nunsigned programSize() {\n return bytecode[17] * 8;\n}\n#endif\n\nvoid deepSleep() __attribute__((weak));\n//%\nvoid deepSleep() {}\n\nint *getBootloaderConfigData() __attribute__((weak));\nint *getBootloaderConfigData() {\n return NULL;\n}\n\n//%\nint getConfig(int key, int defl) {\n#ifdef PXT_VM\n if (!vmImg)\n return defl;\n int *cfgData = vmImg->configData;\n#else\n int *cfgData = bytecode ? *(int **)&bytecode[18] : NULL;\n#endif\n\n if (cfgData) {\n for (int i = 0;; i += 2) {\n if (cfgData[i] == key)\n return cfgData[i + 1];\n if (cfgData[i] == 0)\n break;\n }\n }\n\n cfgData = getBootloaderConfigData();\n\n if (cfgData) {\n for (int i = 0;; i += 2) {\n if (cfgData[i] == key)\n return cfgData[i + 1];\n if (cfgData[i] == 0)\n break;\n }\n }\n\n return defl;\n}\n\n} // namespace pxt\n\nnamespace pxtrt {\n//%\nTValue ldlocRef(RefRefLocal *r) {\n return r->v;\n}\n\n//%\nvoid stlocRef(RefRefLocal *r, TValue v) {\n r->v = v;\n}\n\n//%\nRefRefLocal *mklocRef() {\n auto r = NEW_GC(RefRefLocal);\n MEMDBG(\"mklocRef: => %p\", r);\n return r;\n}\n\n// Store a captured local in a closure. It returns the action, so it can be chained.\n//%\nRefAction *stclo(RefAction *a, int idx, TValue v) {\n // DBG(\"STCLO \"); a->print(); DBG(\"@%d = %p\\n\", idx, (void*)v);\n a->stCore(idx, v);\n return a;\n}\n\n//%\nvoid panic(int code) {\n soft_panic(code);\n}\n\n//%\nString emptyToNull(String s) {\n if (!s || IS_EMPTY(s))\n return NULL;\n return s;\n}\n\n//%\nint ptrToBool(TValue p) {\n if (p) {\n decr(p);\n return 1;\n } else {\n return 0;\n }\n}\n\nRefMap *mkMap() {\n auto r = NEW_GC(RefMap);\n MEMDBG(\"mkMap: => %p\", r);\n return r;\n}\n\nTValue mapGetByString(RefMap *map, String key) {\n int i = map->findIdx(key);\n if (i < 0) {\n return 0;\n }\n return map->values.get(i);\n}\n\n#ifdef PXT_VM\n#define IFACE_MEMBER_NAMES vmImg->ifaceMemberNames\n#else\n#define IFACE_MEMBER_NAMES *(uintptr_t **)&bytecode[22]\n#endif\n\nint lookupMapKey(String key) {\n auto arr = IFACE_MEMBER_NAMES;\n auto len = *arr++;\n int l = 1U; // skip index 0 - it's invalid\n int r = (int)len - 1;\n auto ikey = (uintptr_t)key;\n if (arr[l] <= ikey && ikey <= arr[r]) {\n while (l <= r) {\n auto m = (l + r) >> 1;\n if (arr[m] == ikey)\n return m;\n else if (arr[m] < ikey)\n l = m + 1;\n else\n r = m - 1;\n }\n } else {\n while (l <= r) {\n int m = (l + r) >> 1;\n auto cmp = String_::compare((String)arr[m], key);\n if (cmp == 0)\n return m;\n else if (cmp < 0)\n l = m + 1;\n else\n r = m - 1;\n }\n }\n return 0;\n}\n\nTValue mapGet(RefMap *map, unsigned key) {\n auto arr = (String *)IFACE_MEMBER_NAMES;\n auto r = mapGetByString(map, arr[key + 1]);\n map->unref();\n return r;\n}\n\nvoid mapSetByString(RefMap *map, String key, TValue val) {\n int i = map->findIdx(key);\n if (i < 0) {\n map->keys.push((TValue)key);\n map->values.push(val);\n } else {\n map->values.set(i, val);\n }\n}\n\nvoid mapSet(RefMap *map, unsigned key, TValue val) {\n auto arr = (String *)IFACE_MEMBER_NAMES;\n mapSetByString(map, arr[key + 1], val);\n decr(val);\n map->unref();\n}\n\n//\n// Debugger\n//\n\n// This is only to be called once at the beginning of lambda function\n//%\nvoid *getGlobalsPtr() {\n#ifdef DEVICE_GROUP_ID_USER\n fiber_set_group(DEVICE_GROUP_ID_USER);\n#endif\n\n return globals;\n}\n\n//%\nvoid runtimeWarning(String s) {\n // noop for now\n}\n} // namespace pxtrt\n#endif\n\nnamespace pxt {\n\nvoid doNothing() {}\n\n//%\nValType valType(TValue v) {\n if (isTagged(v)) {\n if (!v)\n return ValType::Undefined;\n\n if (isInt(v) || v == TAG_NAN)\n return ValType::Number;\n if (v == TAG_TRUE || v == TAG_FALSE)\n return ValType::Boolean;\n else if (v == TAG_NULL)\n return ValType::Object;\n else {\n oops(1);\n return ValType::Object;\n }\n#ifdef PXT64\n } else if (isDouble(v)) {\n return ValType::Number;\n#endif\n } else {\n auto vt = getVTable((RefObject *)v);\n if (vt->magic == VTABLE_MAGIC)\n return vt->objectType;\n else\n return ValType::Object;\n }\n}\n\nPXT_DEF_STRING(sObjectTp, \"object\")\nPXT_DEF_STRING(sBooleanTp, \"boolean\")\nPXT_DEF_STRING(sStringTp, \"string\")\nPXT_DEF_STRING(sNumberTp, \"number\")\nPXT_DEF_STRING(sFunctionTp, \"function\")\nPXT_DEF_STRING(sUndefinedTp, \"undefined\")\n\n//% expose\nString typeOf(TValue v) {\n switch (valType(v)) {\n case ValType::Undefined:\n return (String)sUndefinedTp;\n case ValType::Boolean:\n return (String)sBooleanTp;\n case ValType::Number:\n return (String)sNumberTp;\n case ValType::String:\n return (String)sStringTp;\n case ValType::Object:\n return (String)sObjectTp;\n case ValType::Function:\n return (String)sFunctionTp;\n default:\n oops(2);\n return 0;\n }\n}\n\n// Maybe in future we will want separate print methods; for now ignore\nvoid anyPrint(TValue v) {\n if (valType(v) == ValType::Object) {\n if (isRefCounted(v)) {\n auto o = (RefObject *)v;\n auto vt = getVTable(o);\n auto meth = ((RefObjectMethod)vt->methods[1]);\n if ((void *)meth == (void *)&anyPrint)\n DMESG(\"[RefObject vt=%p cl=%d sz=%d]\", o->vtable, vt->classNo, vt->numbytes);\n else\n meth(o);\n } else {\n DMESG(\"[Native %p]\", v);\n }\n } else {\n#ifndef X86_64\n String s = numops::toString(v);\n DMESG(\"[%s %p = %s]\", pxt::typeOf(v)->getUTF8Data(), v, s->getUTF8Data());\n decr((TValue)s);\n#endif\n }\n}\n\nstatic void dtorDoNothing() {}\n\n#define PRIM_VTABLE(name, objectTp, tp, szexpr) \\\n static uint32_t name##_size(tp *p) { return TOWORDS(sizeof(tp) + szexpr); } \\\n DEF_VTABLE(name##_vt, tp, objectTp, (void *)&dtorDoNothing, (void *)&anyPrint, 0, \\\n (void *)&name##_size)\n\n#define NOOP ((void)0)\n\n#define STRING_VT(name, fix, scan, gcsize, data, utfsize, length, dataAt) \\\n static uint32_t name##_gcsize(BoxedString *p) { return TOWORDS(sizeof(void *) + (gcsize)); } \\\n static void name##_gcscan(BoxedString *p) { scan; } \\\n static const char *name##_data(BoxedString *p) { \\\n fix; \\\n return data; \\\n } \\\n static uint32_t name##_utfsize(BoxedString *p) { \\\n fix; \\\n return utfsize; \\\n } \\\n static uint32_t name##_length(BoxedString *p) { \\\n fix; \\\n return length; \\\n } \\\n static const char *name##_dataAt(BoxedString *p, uint32_t idx) { \\\n fix; \\\n return dataAt; \\\n } \\\n DEF_VTABLE(name##_vt, BoxedString, ValType::String, (void *)&dtorDoNothing, (void *)&anyPrint, \\\n (void *)&name##_gcscan, (void *)&name##_gcsize, (void *)&name##_data, \\\n (void *)&name##_utfsize, (void *)&name##_length, (void *)&name##_dataAt)\n\nvoid gcMarkArray(void *data);\nvoid gcScan(TValue v);\n\n#if PXT_UTF8\nstatic const char *skipLookup(BoxedString *p, uint32_t idx, int packed) {\n if (idx > p->skip.length)\n return NULL;\n auto ent = idx / PXT_STRING_SKIP_INCR;\n auto data = packed ? PXT_SKIP_DATA_PACK(p) : PXT_SKIP_DATA_IND(p);\n auto size = p->skip.size;\n if (ent) {\n auto off = packed ? p->skip_pack.list[ent - 1] : p->skip.list[ent - 1];\n data += off;\n size -= off;\n idx &= PXT_STRING_SKIP_INCR - 1;\n }\n return utf8Skip(data, size, idx);\n}\n\nextern LLSegment workQueue;\n\nstatic uint32_t fixSize(BoxedString *p, uint32_t *len) {\n uint32_t tlen = 0;\n uint32_t sz = 0;\n if (workQueue.getLength())\n oops(81);\n workQueue.push((TValue)p);\n while (workQueue.getLength()) {\n p = (BoxedString *)workQueue.pop();\n if (IS_CONS(p)) {\n workQueue.push((TValue)p->cons.right);\n workQueue.push((TValue)p->cons.left);\n } else {\n tlen += p->getLength();\n sz += p->getUTF8Size();\n }\n }\n *len = tlen;\n return sz;\n}\n\nstatic void fixCopy(BoxedString *p, char *dst) {\n if (workQueue.getLength())\n oops(81);\n\n workQueue.push((TValue)p);\n while (workQueue.getLength()) {\n p = (BoxedString *)workQueue.pop();\n if (IS_CONS(p)) {\n workQueue.push((TValue)p->cons.right);\n workQueue.push((TValue)p->cons.left);\n } else {\n auto sz = p->getUTF8Size();\n memcpy(dst, p->getUTF8Data(), sz);\n dst += sz;\n }\n }\n}\n\n// switches CONS representation into skip list representation\n// does not switch representation of CONS' children\nstatic void fixCons(BoxedString *r) {\n uint32_t length = 0;\n auto sz = fixSize(r, &length);\n auto numSkips = length / PXT_STRING_SKIP_INCR;\n // allocate first, while [r] still holds references to its children\n // because allocation might trigger GC\n auto data = (uint16_t *)gcAllocateArray(numSkips * 2 + sz + 1);\n // copy, while [r] is still cons\n fixCopy(r, (char *)(data + numSkips));\n // now, set [r] up properly\n r->vtable = &string_skiplist16_vt;\n r->skip.size = sz;\n r->skip.length = length;\n r->skip.list = data;\n setupSkipList(r, NULL, 0);\n}\n#endif\n\nSTRING_VT(string_inline_ascii, NOOP, NOOP, 2 + p->ascii.length + 1, p->ascii.data, p->ascii.length,\n p->ascii.length, idx <= p->ascii.length ? p->ascii.data + idx : NULL)\n#if PXT_UTF8\nSTRING_VT(string_inline_utf8, NOOP, NOOP, 2 + p->utf8.size + 1, p->utf8.data, p->utf8.size,\n utf8Len(p->utf8.data, p->utf8.size), utf8Skip(p->utf8.data, p->utf8.size, idx))\nSTRING_VT(string_skiplist16, NOOP, if (p->skip.list) gcMarkArray(p->skip.list), 2 * sizeof(void *),\n PXT_SKIP_DATA_IND(p), p->skip.size, p->skip.length, skipLookup(p, idx, 0))\nSTRING_VT(string_skiplist16_packed, NOOP, NOOP,\n 2 + 2 + PXT_NUM_SKIP_ENTRIES(p) * 2 + p->skip.size + 1, PXT_SKIP_DATA_PACK(p),\n p->skip.size, p->skip.length, skipLookup(p, idx, 1))\nSTRING_VT(string_cons, fixCons(p), (gcScan((TValue)p->cons.left), gcScan((TValue)p->cons.right)),\n 2 * sizeof(void *), PXT_SKIP_DATA_IND(p), p->skip.size, p->skip.length,\n skipLookup(p, idx, 0))\n#endif\n\nPRIM_VTABLE(number, ValType::Number, BoxedNumber, 0)\nPRIM_VTABLE(buffer, ValType::Object, BoxedBuffer, p->length)\n// PRIM_VTABLE(action, ValType::Function, RefAction, )\n\nvoid failedCast(TValue v, void *addr) {\n DMESG(\"failed type check for %p @%p\", v, addr);\n auto vt = getAnyVTable(v);\n if (vt) {\n DMESG(\"VT %p - objtype %d classNo %d\", vt, vt->objectType, vt->classNo);\n }\n\n int code;\n if (v == TAG_NULL)\n code = PANIC_CAST_FROM_NULL;\n else\n code = PANIC_CAST_FIRST + (int)valType(v);\n soft_panic(code);\n}\n\nvoid missingProperty(TValue v) {\n DMESG(\"missing property on %p\", v);\n soft_panic(PANIC_MISSING_PROPERTY);\n}\n\n#ifdef PXT_PROFILE\nstruct PerfCounter *perfCounters;\n\nstruct PerfCounterInfo {\n uint32_t numPerfCounters;\n char *perfCounterNames[0];\n};\n\n#define PERF_INFO ((PerfCounterInfo *)(((uintptr_t *)bytecode)[13]))\n\nvoid initPerfCounters() {\n auto n = PERF_INFO->numPerfCounters;\n perfCounters = new PerfCounter[n];\n memset(perfCounters, 0, n * sizeof(PerfCounter));\n}\n\nvoid dumpPerfCounters() {\n auto info = PERF_INFO;\n DMESG(\"calls,us,name\");\n for (uint32_t i = 0; i < info->numPerfCounters; ++i) {\n auto c = &perfCounters[i];\n DMESG(\"%d,%d,%s\", c->numstops, c->value, info->perfCounterNames[i]);\n }\n}\n\nvoid startPerfCounter(PerfCounters n) {\n if (!perfCounters)\n return;\n auto c = &perfCounters[(uint32_t)n];\n if (c->start)\n oops(50);\n c->start = PERF_NOW();\n}\n\nvoid stopPerfCounter(PerfCounters n) {\n if (!perfCounters)\n return;\n auto c = &perfCounters[(uint32_t)n];\n if (!c->start)\n oops(51);\n c->value += PERF_NOW() - c->start;\n c->start = 0;\n c->numstops++;\n}\n#endif\n\n// Exceptions\n\n#ifndef PXT_EXN_CTX\n#define PXT_EXN_CTX() getThreadContext()\n#endif\n\ntypedef void (*RestoreStateType)(TryFrame *, ThreadContext *);\n#ifndef pxt_restore_exception_state\n#define pxt_restore_exception_state ((RestoreStateType)(((uintptr_t *)bytecode)[14]))\n#endif\n\n//%\nTryFrame *beginTry() {\n auto ctx = PXT_EXN_CTX();\n auto frame = (TryFrame *)app_alloc(sizeof(TryFrame));\n frame->parent = ctx->tryFrame;\n ctx->tryFrame = frame;\n return frame;\n}\n\n//% expose\nvoid endTry() {\n auto ctx = PXT_EXN_CTX();\n auto f = ctx->tryFrame;\n if (!f)\n oops(51);\n ctx->tryFrame = f->parent;\n app_free(f);\n}\n\n//% expose\nvoid throwValue(TValue v) {\n auto ctx = PXT_EXN_CTX();\n auto f = ctx->tryFrame;\n if (!f) {\n DMESG(\"unhandled exception, value:\");\n anyPrint(v);\n soft_panic(PANIC_UNHANDLED_EXCEPTION);\n }\n ctx->tryFrame = f->parent;\n TryFrame copy = *f;\n app_free(f);\n ctx->thrownValue = v;\n pxt_restore_exception_state(©, ctx);\n}\n\n//% expose\nTValue getThrownValue() {\n auto ctx = PXT_EXN_CTX();\n auto v = ctx->thrownValue;\n ctx->thrownValue = TAG_NON_VALUE;\n if (v == TAG_NON_VALUE)\n oops(51);\n return v;\n}\n\n//% expose\nvoid endFinally() {\n auto ctx = PXT_EXN_CTX();\n if (ctx->thrownValue == TAG_NON_VALUE)\n return;\n throwValue(getThrownValue());\n}\n\n// https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function\nuint32_t hash_fnv1(const void *data, unsigned len) {\n const uint8_t *d = (const uint8_t *)data;\n uint32_t h = 0x811c9dc5;\n while (len--)\n h = (h * 0x1000193) ^ *d++;\n return h;\n}\n\n// redefined in melody.cpp\n__attribute__((weak)) int redirectSamples(int16_t *dst, int numsamples, int samplerate) {\n return 0;\n}\n\n} // namespace pxt\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum NumberFormat {\n Int8LE = 1,\n UInt8LE = 2,\n Int16LE = 3,\n UInt16LE = 4,\n Int32LE = 5,\n Int8BE = 6,\n UInt8BE = 7,\n Int16BE = 8,\n UInt16BE = 9,\n Int32BE = 10,\n\n UInt32LE = 11,\n UInt32BE = 12,\n Float32LE = 13,\n Float64LE = 14,\n Float32BE = 15,\n Float64BE = 16,\n }\n\n\n declare const enum PerfCounters {\n GC = 0,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"eventcontext.ts": "namespace control {\n /**\n * Run code when a registered event happens.\n * @param id the event compoent id\n * @param value the event value to match\n */\n //% weight=20 blockGap=8 blockId=\"control_on_event\" block=\"on event|from %src|with value %value\"\n //% blockExternalInputs=1\n //% help=\"control/on-event\"\n export function onEvent(src: number, value: number, handler: () => void, flags = 16) { // EVENT_LISTENER_DEFAULT_FLAGS\n const ctx = control.eventContext();\n if (!ctx)\n control.internalOnEvent(src, value, handler, flags);\n else\n ctx.registerHandler(src, value, handler, flags);\n }\n\n export class FrameCallback {\n order: number\n handler: () => void\n }\n\n class EventHandler {\n constructor(\n public src: number,\n public value: number,\n public handler: () => void,\n public flags: number\n ) { }\n\n register() {\n control.internalOnEvent(this.src, this.value, () => {\n if (this.handler) this.handler();\n }, this.flags)\n }\n\n unregister() {\n control.internalOnEvent(this.src, this.value, doNothing, this.flags);\n }\n }\n\n function doNothing() { }\n\n\n\n export class EventContext {\n private handlers: EventHandler[];\n private frameCallbacks: FrameCallback[];\n private frameWorker: number;\n private framesInSample: number;\n private timeInSample: number;\n public deltaTimeMillis: number;\n private prevTimeMillis: number;\n private idleCallbacks: (() => void)[];\n\n static lastStats: string;\n static onStats: (stats: string) => void;\n\n constructor() {\n this.handlers = [];\n this.framesInSample = 0;\n this.timeInSample = 0;\n this.deltaTimeMillis = 0;\n this.frameWorker = 0;\n this.idleCallbacks = undefined;\n if (!EventContext.lastStats) {\n EventContext.lastStats = \"\";\n }\n }\n\n get deltaTime() {\n return this.deltaTimeMillis / 1000;\n }\n\n private runCallbacks() {\n control.enablePerfCounter(\"all frame callbacks\")\n\n let loopStart = control.millis()\n this.deltaTimeMillis = loopStart - this.prevTimeMillis;\n this.prevTimeMillis = loopStart;\n for (let f of this.frameCallbacks) {\n f.handler()\n }\n let runtime = control.millis() - loopStart\n this.timeInSample += runtime\n this.framesInSample++\n if (this.timeInSample > 1000 || this.framesInSample > 30) {\n const fps = this.framesInSample / (this.timeInSample / 1000);\n EventContext.lastStats = `fps:${Math.round(fps)}`;\n if (fps < 99)\n EventContext.lastStats += \".\" + (Math.round(fps * 10) % 10)\n if (control.ramSize() > 2000000 && control.profilingEnabled()) {\n control.dmesg(`${(fps * 100) | 0}/100 fps - ${this.framesInSample} frames`)\n control.gc()\n control.dmesgPerfCounters()\n }\n this.timeInSample = 0\n this.framesInSample = 0\n }\n let delay = Math.max(1, 20 - runtime)\n\n return delay\n }\n\n private runningCallbacks: boolean;\n private registerFrameCallbacks() {\n if (!this.frameCallbacks) return;\n\n const worker = this.frameWorker;\n control.runInParallel(() => {\n if (this.runningCallbacks) {\n // this context is still running in a different fiber;\n // delay until the other fiber doing so has ceased.\n pauseUntil(() => !this.runningCallbacks);\n }\n this.runningCallbacks = true;\n\n this.framesInSample = 0;\n this.timeInSample = 0;\n this.deltaTimeMillis = 0;\n this.prevTimeMillis = control.millis();\n\n while (worker == this.frameWorker) {\n let delay = this.runCallbacks()\n pause(delay)\n }\n\n this.runningCallbacks = false;\n })\n }\n\n register() {\n for (const h of this.handlers)\n h.register();\n this.registerFrameCallbacks();\n }\n\n unregister() {\n for (const h of this.handlers)\n h.unregister();\n this.frameWorker++;\n }\n\n registerFrameHandler(order: number, handler: () => void): FrameCallback {\n if (!this.frameCallbacks) {\n this.frameCallbacks = [];\n this.registerFrameCallbacks();\n }\n\n const fn = new FrameCallback()\n fn.order = order\n fn.handler = handler\n for (let i = 0; i < this.frameCallbacks.length; ++i) {\n if (this.frameCallbacks[i].order > order) {\n this.frameCallbacks.insertAt(i, fn)\n return fn;\n }\n }\n this.frameCallbacks.push(fn);\n return fn;\n }\n\n unregisterFrameHandler(fn: FrameCallback) {\n if (!fn || !this.frameCallbacks) return;\n const i = this.frameCallbacks.indexOf(fn);\n if (i > -1)\n this.frameCallbacks.splice(i, 1);\n }\n\n registerHandler(src: number, value: number, handler: () => void, flags: number) {\n // already there?\n for (const h of this.handlers) {\n if (h.src == src && h.value == value) {\n h.flags = flags;\n h.handler = handler;\n return;\n }\n }\n // register and push\n const hn = new EventHandler(src, value, handler, flags);\n this.handlers.push(hn);\n hn.register();\n }\n\n addIdleHandler(handler: () => void) {\n if (!this.idleCallbacks) {\n this.idleCallbacks = [];\n this.registerHandler(15/*DAL.DEVICE_ID_SCHEDULER*/, 2/*DAL.DEVICE_SCHEDULER_EVT_IDLE*/, () => this.runIdleHandler(), 16);\n }\n this.idleCallbacks.push(handler);\n }\n\n removeIdleHandler(handler: () => void) {\n if (handler && this.idleCallbacks)\n this.idleCallbacks.removeElement(handler);\n }\n\n private runIdleHandler() {\n if (this.idleCallbacks) {\n const ics = this.idleCallbacks.slice(0);\n ics.forEach(ic => ic());\n }\n }\n }\n let eventContexts: EventContext[];\n\n /**\n * Gets the current event context if any\n */\n export function eventContext(): EventContext {\n return eventContexts ? eventContexts[eventContexts.length - 1] : undefined;\n }\n\n /**\n * Pushes a new event context and clears all handlers\n */\n export function pushEventContext(): EventContext {\n if (!eventContexts)\n eventContexts = [];\n\n // unregister previous context\n const ctx = eventContext();\n if (ctx) ctx.unregister();\n // register again\n const n = new EventContext();\n eventContexts.push(n);\n return n;\n }\n\n /**\n * Pops the current event context and restore handlers if any previous context\n */\n export function popEventContext() {\n if (!eventContexts) return;\n\n // clear current context\n const ctx = eventContexts.pop();\n if (!ctx) return;\n ctx.unregister();\n\n // register old context again\n const context = eventContexts[eventContexts.length - 1];\n if (context)\n context.register();\n else\n eventContexts = undefined;\n }\n\n let _idleCallbacks: (() => void)[];\n /**\n * Registers a function to run when the device is idling\n * @param handler\n */\n export function onIdle(handler: () => void) {\n if (!handler) return;\n\n const ctx = eventContext();\n if (ctx) ctx.addIdleHandler(handler);\n else {\n if (!_idleCallbacks) {\n _idleCallbacks = [];\n control.runInBackground(function () {\n while (_idleCallbacks) {\n _idleCallbacks.slice(0).forEach(cb => cb());\n pause(20);\n }\n })\n /*\n control.internalOnEvent(\n 15. // DAL.DEVICE_ID_SCHEDULER\n 2, // DAL.DEVICE_SCHEDULER_EVT_IDLE\n function() {\n pins.LED.digitalWrite(on = !on);\n if (_idleCallbacks)\n _idleCallbacks.slice(0).forEach(cb => cb());\n }, 192); // MESSAGE_BUS_LISTENER_IMMEDIATE\n */\n }\n _idleCallbacks.push(handler);\n }\n }\n\n export function removeIdleHandler(handler: () => void) {\n if (!handler) return;\n const ctx = eventContext();\n if (ctx) ctx.removeIdleHandler(handler);\n else if (_idleCallbacks) _idleCallbacks.removeElement(handler);\n }\n}",
"fixed.ts": "interface Fx8 {\n _dummyFx8: string;\n}\n\nfunction Fx8(v: number) {\n return ((v * 256) | 0) as any as Fx8\n}\n\nnamespace Fx {\n export const zeroFx8 = 0 as any as Fx8\n export const oneHalfFx8 = 128 as any as Fx8\n export const oneFx8 = 256 as any as Fx8\n export const twoFx8 = 512 as any as Fx8\n\n export function neg(a: Fx8) {\n return (-(a as any as number)) as any as Fx8\n }\n export function toIntShifted(a: Fx8, n: number) {\n return (a as any as number) >> (n + 8)\n }\n export function add(a: Fx8, b: Fx8) {\n return ((a as any as number) + (b as any as number)) as any as Fx8\n }\n export function iadd(a: number, b: Fx8) {\n return ((a << 8) + (b as any as number)) as any as Fx8\n }\n export function sub(a: Fx8, b: Fx8) {\n return ((a as any as number) - (b as any as number)) as any as Fx8\n }\n export function mul(a: Fx8, b: Fx8) {\n return (Math.imul((a as any as number), (b as any as number)) >> 8) as any as Fx8\n }\n export function imul(a: Fx8, b: number) {\n return Math.imul((a as any as number), (b as any as number)) as any as Fx8\n }\n export function div(a: Fx8, b: Fx8) {\n return Math.idiv((a as any as number) << 8, b as any as number) as any as Fx8\n }\n export function idiv(a: Fx8, b: number) {\n return Math.idiv((a as any as number), b) as any as Fx8\n }\n export function compare(a: Fx8, b: Fx8) {\n return (a as any as number) - (b as any as number)\n }\n export function abs(a: Fx8) {\n if ((a as any as number) < 0)\n return (-(a as any as number)) as any as Fx8\n else\n return a\n }\n export function min(a: Fx8, b: Fx8) {\n if (a < b)\n return a\n else\n return b\n }\n export function max(a: Fx8, b: Fx8) {\n if (a > b)\n return a\n else\n return b\n }\n export function floor(v: Fx8): Fx8 {\n return ((v as any as number) & ~0xff) as any as Fx8;\n }\n export function ceil(v: Fx8): Fx8 {\n return (v as any as number) & 0xff ? Fx.floor(Fx.add(v, Fx.oneFx8)) : v;\n }\n export function leftShift(a: Fx8, n: number) {\n return (a as any as number << n) as any as Fx8\n }\n export function rightShift(a: Fx8, n: number) {\n return (a as any as number >> n) as any as Fx8\n }\n export function toInt(v: Fx8) {\n return ((v as any as number) + 128) >> 8\n }\n export function toFloat(v: Fx8) {\n return (v as any as number) / 256\n }\n}",
"forever.ts": "/**\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=loops/forever weight=100 afterOnStart=true blockNamespace=\"loops\"\n//% blockId=forever block=\"forever\" blockAllowMultiple=1\nfunction forever(a: () => void): void {\n loops.forever(a);\n}\n\n// micro:bit compatibility\n// these functions allow some level of reuse\n// between micro:bit and other maker-style editors\nnamespace basic {\n export function forever(a: () => void) {\n loops.forever(a);\n }\n}",
"gc.cpp": "#include \"pxtbase.h\"\n\n#ifndef GC_BLOCK_SIZE\n#define GC_BLOCK_SIZE (1024 * 16)\n#endif\n\n#ifndef GC_MAX_ALLOC_SIZE\n#define GC_MAX_ALLOC_SIZE (GC_BLOCK_SIZE - 16)\n#endif\n\n#ifndef GC_ALLOC_BLOCK\n#define GC_ALLOC_BLOCK xmalloc\n#endif\n\n#ifdef PXT64\n#define HIGH_SHIFT 48\n#define BYTES_TO_WORDS(x) ((x) >> 3)\n#define WORDS_TO_BYTES(x) ((x) << 3)\n#define ALIGN_TO_WORD(x) (((x) + 7) & (~7ULL))\n#define VAR_BLOCK_WORDS(vt) ((uint32_t)(uint64_t)(vt) >> 2)\n#else\n#define HIGH_SHIFT 28\n#define BYTES_TO_WORDS(x) ((x) >> 2)\n#define WORDS_TO_BYTES(x) ((x) << 2)\n#define ALIGN_TO_WORD(x) (((x) + 3) & (~3U))\n#define VAR_BLOCK_WORDS(vt) (((uint32_t)(vt) << 4) >> (4 + 2))\n#endif\n\n#define FREE_MASK (1ULL << (HIGH_SHIFT + 3))\n#define ARRAY_MASK (1ULL << (HIGH_SHIFT + 2))\n#define PERMA_MASK (1ULL << (HIGH_SHIFT + 1))\n#define MARKED_MASK 0x1\n#define ANY_MARKED_MASK 0x3\n\n// the bit operations should be faster than loading large constants\n#define IS_FREE(vt) ((uintptr_t)(vt) >> (HIGH_SHIFT + 3))\n#define IS_ARRAY(vt) (((uintptr_t)(vt) >> (HIGH_SHIFT + 2)) & 1)\n#define IS_PERMA(vt) (((uintptr_t)(vt) >> (HIGH_SHIFT + 1)) & 1)\n#define IS_VAR_BLOCK(vt) ((uintptr_t)(vt) >> (HIGH_SHIFT + 2))\n#define IS_MARKED(vt) ((uintptr_t)(vt)&MARKED_MASK)\n#define IS_LIVE(vt) (IS_MARKED(vt) || (((uintptr_t)(vt) >> (HIGH_SHIFT)) == 0x6))\n\n//#define PXT_GC_DEBUG 1\n#ifndef PXT_GC_CHECKS\n#define PXT_GC_CHECKS 1\n#endif\n//#define PXT_GC_STRESS 1\n\n//#define PXT_GC_CHECKS 1\n\n#define MARK(v) \\\n do { \\\n GC_CHECK(inGCArea(v), 42); \\\n *(uintptr_t *)(v) |= MARKED_MASK; \\\n } while (0)\n\n#ifdef PXT_GC_DEBUG\n#define LOG DMESG\n#define VLOG DMESG\n#define VVLOG DMESG\n#else\n#define LOG NOLOG\n#define VLOG NOLOG\n#define VVLOG NOLOG\n#endif\n\n#ifdef PXT_GC_CHECKS\n#define GC_CHECK(cond, code) \\\n if (!(cond)) \\\n oops(code)\n#else\n#define GC_CHECK(cond, code) ((void)0)\n#endif\n\nnamespace pxt {\n\n// keep in sync with base/control.ts, function gcStats()\nstruct GCStats {\n uint32_t numGC;\n uint32_t numBlocks;\n uint32_t totalBytes;\n uint32_t lastFreeBytes;\n uint32_t lastMaxBlockBytes;\n uint32_t minFreeBytes;\n};\n\nstatic GCStats gcStats;\n\n//% expose\nBuffer getGCStats() {\n return mkBuffer((uint8_t *)&gcStats, sizeof(gcStats));\n}\n\n//%\nvoid popThreadContext(ThreadContext *ctx);\n//%\nThreadContext *pushThreadContext(void *sp, void *endSP);\n\nunsigned RefRecord_gcsize(RefRecord *r) {\n VTable *tbl = getVTable(r);\n return BYTES_TO_WORDS(tbl->numbytes);\n}\n\n#ifdef PXT_GC_THREAD_LIST\nThreadContext *threadContexts;\n#endif\n\n#define IN_GC_ALLOC 1\n#define IN_GC_COLLECT 2\n#define IN_GC_FREEZE 4\n#define IN_GC_PREALLOC 8\n\n#ifndef PXT_VM\nstatic TValue *tempRoot;\nstatic uint8_t tempRootLen;\n#endif\n\nuint8_t inGC;\n\nvoid popThreadContext(ThreadContext *ctx) {\n#ifndef PXT_VM\n VLOG(\"pop: %p\", ctx);\n\n if (!ctx)\n return;\n\n auto n = ctx->stack.next;\n if (n) {\n VLOG(\"seg %p\", n);\n ctx->stack.top = n->top;\n ctx->stack.bottom = n->bottom;\n ctx->stack.next = n->next;\n app_free(n);\n } else {\n#ifdef PXT_GC_THREAD_LIST\n if (ctx->next)\n ctx->next->prev = ctx->prev;\n if (ctx->prev)\n ctx->prev->next = ctx->next;\n else {\n if (threadContexts != ctx)\n oops(41);\n threadContexts = ctx->next;\n if (threadContexts)\n threadContexts->prev = NULL;\n }\n#endif\n app_free(ctx);\n setThreadContext(NULL);\n }\n#endif\n}\n\n#define ALLOC(tp) (tp *)app_alloc(sizeof(tp))\n\nThreadContext *pushThreadContext(void *sp, void *endSP) {\n#ifdef PXT_VM\n return NULL;\n#else\n if (PXT_IN_ISR())\n target_panic(PANIC_CALLED_FROM_ISR);\n\n auto curr = getThreadContext();\n tempRoot = (TValue *)endSP;\n tempRootLen = (uintptr_t *)sp - (uintptr_t *)endSP;\n if (curr) {\n#ifdef PXT_GC_THREAD_LIST\n#ifdef PXT_GC_DEBUG\n auto ok = false;\n for (auto p = threadContexts; p; p = p->next)\n if (p == curr) {\n ok = true;\n break;\n }\n if (!ok)\n oops(49);\n#endif\n#endif\n auto seg = ALLOC(StackSegment);\n VLOG(\"stack %p / %p\", seg, curr);\n seg->top = curr->stack.top;\n seg->bottom = curr->stack.bottom;\n seg->next = curr->stack.next;\n curr->stack.next = seg;\n } else {\n curr = ALLOC(ThreadContext);\n LOG(\"push: %p\", curr);\n curr->globals = globals;\n curr->stack.next = NULL;\n curr->thrownValue = TAG_NON_VALUE;\n curr->tryFrame = NULL;\n\n#ifdef PXT_GC_THREAD_LIST\n curr->next = threadContexts;\n curr->prev = NULL;\n if (curr->next)\n curr->next->prev = curr;\n threadContexts = curr;\n#endif\n setThreadContext(curr);\n }\n tempRootLen = 0;\n curr->stack.bottom = sp;\n curr->stack.top = NULL;\n return curr;\n#endif\n}\n\nclass RefBlock : public RefObject {\n public:\n RefBlock *nextFree;\n};\n\nstruct GCBlock {\n GCBlock *next;\n uint32_t blockSize;\n RefObject data[0];\n};\n\nstruct PendingArray {\n PendingArray *next;\n TValue *data;\n unsigned len;\n};\n\n#define PENDING_ARRAY_THR 100\n\nstatic PendingArray *pendingArrays;\nstatic LLSegment gcRoots;\nLLSegment workQueue; // (ab)used by consString making\nstatic GCBlock *firstBlock;\nstatic RefBlock *firstFree;\nstatic uint8_t *midPtr;\n\nstatic bool inGCArea(void *ptr) {\n for (auto block = firstBlock; block; block = block->next) {\n if ((void *)block->data <= ptr && ptr < (void *)((uint8_t *)block->data + block->blockSize))\n return true;\n }\n return false;\n}\n\n#define NO_MAGIC(vt) ((VTable *)vt)->magic != VTABLE_MAGIC\n#define VT(p) (*(uintptr_t *)(p))\n#define SKIP_PROCESSING(p) \\\n (isReadOnly(p) || (VT(p) & (ANY_MARKED_MASK | ARRAY_MASK)) || NO_MAGIC(VT(p)))\n\nvoid gcMarkArray(void *data) {\n auto segBl = (uintptr_t *)data - 1;\n GC_CHECK(!IS_MARKED(VT(segBl)), 47);\n MARK(segBl);\n}\n\nvoid gcScan(TValue v) {\n if (SKIP_PROCESSING(v))\n return;\n MARK(v);\n workQueue.push(v);\n}\n\nvoid gcScanMany(TValue *data, unsigned len) {\n // VLOG(\"scan: %p %d\", data, len);\n for (unsigned i = 0; i < len; ++i) {\n auto v = data[i];\n // VLOG(\"psh: %p %d %d\", v, isReadOnly(v), (*(uint32_t *)v & 1));\n if (SKIP_PROCESSING(v))\n continue;\n MARK(v);\n workQueue.push(v);\n if (workQueue.getLength() > PENDING_ARRAY_THR) {\n i++;\n // store rest of the work for later, when we have cleared the queue\n auto pa = (PendingArray *)xmalloc(sizeof(PendingArray));\n pa->next = pendingArrays;\n pa->data = data + i;\n pa->len = len - i;\n pendingArrays = pa;\n break;\n }\n }\n}\n\nvoid gcScanSegment(Segment &seg) {\n auto data = seg.getData();\n if (!data)\n return;\n VVLOG(\"seg %p %d\", data, seg.getLength());\n gcMarkArray(data);\n gcScanMany(data, seg.getLength());\n}\n\n#define getScanMethod(vt) ((RefObjectMethod)(((VTable *)(vt))->methods[2]))\n#define getSizeMethod(vt) ((RefObjectSizeMethod)(((VTable *)(vt))->methods[3]))\n\nvoid gcProcess(TValue v) {\n if (SKIP_PROCESSING(v))\n return;\n VVLOG(\"gcProcess: %p\", v);\n MARK(v);\n auto scan = getScanMethod(VT(v) & ~ANY_MARKED_MASK);\n if (scan)\n scan((RefObject *)v);\n for (;;) {\n while (workQueue.getLength()) {\n auto curr = (RefObject *)workQueue.pop();\n VVLOG(\" - %p\", curr);\n scan = getScanMethod(curr->vt() & ~ANY_MARKED_MASK);\n if (scan)\n scan(curr);\n }\n if (pendingArrays) {\n auto pa = pendingArrays;\n pendingArrays = pa->next;\n auto data = pa->data;\n auto len = pa->len;\n xfree(pa);\n gcScanMany(data, len);\n } else {\n break;\n }\n }\n}\n\nstatic void mark(int flags) {\n#ifdef PXT_GC_DEBUG\n flags |= 2;\n#endif\n auto data = gcRoots.getData();\n auto len = gcRoots.getLength();\n if (flags & 2) {\n DMESG(\"--MARK\");\n DMESG(\"RP:%p/%d\", data, len);\n }\n for (unsigned i = 0; i < len; ++i) {\n auto d = data[i];\n if ((uintptr_t)d & 1) {\n d = *(TValue *)((uintptr_t)d & ~1);\n }\n gcProcess(d);\n }\n\n#ifdef PXT_GC_THREAD_LIST\n for (auto ctx = threadContexts; ctx; ctx = ctx->next) {\n gcProcess(ctx->thrownValue);\n for (auto seg = &ctx->stack; seg; seg = seg->next) {\n auto ptr = (TValue *)threadAddressFor(ctx, seg->top);\n auto end = (TValue *)threadAddressFor(ctx, seg->bottom);\n VLOG(\"mark: %p - %p\", ptr, end);\n while (ptr < end) {\n gcProcess(*ptr++);\n }\n }\n }\n#else\n gcProcessStacks(flags);\n#endif\n\n if (globals) {\n#ifdef PXT_VM\n auto nonPtrs = vmImg->infoHeader->nonPointerGlobals;\n#else\n auto nonPtrs = bytecode[21];\n#endif\n len = getNumGlobals() - nonPtrs;\n data = globals + nonPtrs;\n if (flags & 2)\n DMESG(\"RG:%p/%d\", data, len);\n VLOG(\"globals: %p %d\", data, len);\n for (unsigned i = 0; i < len; ++i) {\n gcProcess(*data++);\n }\n }\n\n#ifndef PXT_VM\n data = tempRoot;\n len = tempRootLen;\n for (unsigned i = 0; i < len; ++i) {\n gcProcess(*data++);\n }\n#endif\n}\n\nstatic uint32_t getObjectSize(RefObject *o) {\n auto vt = o->vt() & ~ANY_MARKED_MASK;\n uint32_t r;\n GC_CHECK(vt != 0, 49);\n if (IS_VAR_BLOCK(vt)) {\n r = VAR_BLOCK_WORDS(vt);\n } else {\n auto sz = getSizeMethod(vt);\n // GC_CHECK(0x2000 <= (intptr_t)sz && (intptr_t)sz <= 0x100000, 47);\n r = sz(o);\n }\n GC_CHECK(1 <= r && (r <= BYTES_TO_WORDS(GC_MAX_ALLOC_SIZE) || IS_FREE(vt)), 41);\n return r;\n}\n\nstatic void setupFreeBlock(GCBlock *curr) {\n gcStats.numBlocks++;\n gcStats.totalBytes += curr->blockSize;\n curr->data[0].setVT(FREE_MASK | (TOWORDS(curr->blockSize) << 2));\n ((RefBlock *)curr->data)[0].nextFree = firstFree;\n firstFree = (RefBlock *)curr->data;\n midPtr = (uint8_t *)curr->data + curr->blockSize / 4;\n}\n\nstatic void linkFreeBlock(GCBlock *curr) {\n // blocks need to be sorted by address for midPtr to work\n if (!firstBlock || curr < firstBlock) {\n curr->next = firstBlock;\n firstBlock = curr;\n } else {\n for (auto p = firstBlock; p; p = p->next) {\n if (!p->next || curr < p->next) {\n curr->next = p->next;\n p->next = curr;\n break;\n }\n }\n }\n}\n\nvoid gcPreAllocateBlock(uint32_t sz) {\n auto curr = (GCBlock *)GC_ALLOC_BLOCK(sz);\n curr->blockSize = sz - sizeof(GCBlock);\n LOG(\"GC pre-alloc: %p\", curr);\n GC_CHECK((curr->blockSize & 3) == 0, 40);\n setupFreeBlock(curr);\n linkFreeBlock(curr);\n}\n\nstatic GCBlock *allocateBlockCore() {\n int sz = GC_BLOCK_SIZE;\n void *dummy = NULL;\n#ifdef GC_GET_HEAP_SIZE\n if (firstBlock) {\n#ifdef GC_STACK_BASE\n if (!firstBlock->next) {\n int memSize = getConfig(CFG_RAM_BYTES, 0);\n int codalEnd = GC_STACK_BASE;\n // round up to 1k - there is sometimes a few bytes below the stack\n codalEnd = (codalEnd + 1024) & ~1023;\n int codalSize = codalEnd & 0xffffff;\n sz = memSize - codalSize - 4;\n if (sz > 0) {\n auto curr = (GCBlock *)codalEnd;\n curr->blockSize = sz - sizeof(GCBlock);\n return curr;\n }\n }\n#endif\n gc(2); // dump roots\n soft_panic(PANIC_GC_OOM);\n }\n auto lowMem = getConfig(CFG_LOW_MEM_SIMULATION_KB, 0);\n auto sysHeapSize = getConfig(CFG_SYSTEM_HEAP_BYTES, 4 * 1024);\n auto heapSize = GC_GET_HEAP_SIZE();\n sz = heapSize - sysHeapSize;\n if (lowMem) {\n auto memIncrement = 32 * 1024;\n // get the memory size - assume it's increment of 32k,\n // and we don't statically allocate more than 32k\n auto memSize = ((heapSize + memIncrement - 1) / memIncrement) * memIncrement;\n int fillerSize = memSize - lowMem * 1024;\n if (fillerSize > 0) {\n dummy = GC_ALLOC_BLOCK(fillerSize);\n sz -= fillerSize;\n }\n }\n#endif\n auto curr = (GCBlock *)GC_ALLOC_BLOCK(sz);\n curr->blockSize = sz - sizeof(GCBlock);\n // make sure reference to allocated block is stored somewhere, otherwise\n // GCC optimizes out the call to GC_ALLOC_BLOCK\n curr->data[4].setVT((uintptr_t)dummy);\n return curr;\n}\n\n__attribute__((noinline)) static void allocateBlock() {\n auto curr = allocateBlockCore();\n DMESG(\"GC block %db @ %p\", curr->blockSize, curr);\n GC_CHECK((curr->blockSize & 3) == 0, 40);\n setupFreeBlock(curr);\n linkFreeBlock(curr);\n}\n\nstatic void sweep(int flags) {\n RefBlock *prevFreePtr = NULL;\n uint32_t freeSize = 0;\n uint32_t totalSize = 0;\n uint32_t maxFreeBlock = 0;\n firstFree = NULL;\n\n gcStats.numGC++;\n\n for (auto h = firstBlock; h; h = h->next) {\n auto d = h->data;\n auto words = BYTES_TO_WORDS(h->blockSize);\n auto end = d + words;\n totalSize += words;\n VLOG(\"sweep: %p - %p\", d, end);\n while (d < end) {\n if (IS_LIVE(d->vtable)) {\n VVLOG(\"Live %p\", d);\n d->setVT(d->vt() & ~MARKED_MASK);\n d += getObjectSize(d);\n } else {\n auto start = (RefBlock *)d;\n while (d < end) {\n if (IS_FREE(d->vtable)) {\n VVLOG(\"Free %p\", d);\n } else if (IS_LIVE(d->vtable)) {\n break;\n } else if (IS_ARRAY(d->vtable)) {\n VVLOG(\"Dead Arr %p\", d);\n } else {\n VVLOG(\"Dead Obj %p\", d);\n GC_CHECK(d->vtable->magic == VTABLE_MAGIC, 41);\n d->destroyVT();\n VVLOG(\"destroyed\");\n }\n d += getObjectSize(d);\n }\n auto sz = d - (RefObject *)start;\n freeSize += sz;\n if (sz > (int)maxFreeBlock)\n maxFreeBlock = sz;\n#ifdef PXT_GC_CHECKS\n memset((void *)start, 0xff, WORDS_TO_BYTES(sz));\n#endif\n start->setVT((sz << 2) | FREE_MASK);\n if (sz > 1) {\n start->nextFree = NULL;\n if (!prevFreePtr) {\n firstFree = start;\n } else {\n prevFreePtr->nextFree = start;\n }\n prevFreePtr = start;\n }\n }\n }\n }\n\n if (midPtr) {\n uint32_t currFree = 0;\n#ifdef PXT_ESP32\n auto limit = freeSize * 1 / 4;\n#else\n auto limit = freeSize * 1 / 2;\n#endif\n for (auto p = firstFree; p; p = p->nextFree) {\n auto len = VAR_BLOCK_WORDS(p->vtable);\n currFree += len;\n if (currFree > limit) {\n midPtr = (uint8_t *)p + ((limit - currFree + len) << 2);\n break;\n }\n }\n }\n\n freeSize = WORDS_TO_BYTES(freeSize);\n totalSize = WORDS_TO_BYTES(totalSize);\n maxFreeBlock = WORDS_TO_BYTES(maxFreeBlock);\n\n gcStats.lastFreeBytes = freeSize;\n gcStats.lastMaxBlockBytes = maxFreeBlock;\n\n if (gcStats.minFreeBytes == 0 || gcStats.minFreeBytes > freeSize)\n gcStats.minFreeBytes = freeSize;\n\n if (flags & 1)\n DMESG(\"GC %d/%d free; %d maxBlock\", freeSize, totalSize, maxFreeBlock);\n else\n LOG(\"GC %d/%d free; %d maxBlock\", freeSize, totalSize, maxFreeBlock);\n\n#ifndef GC_GET_HEAP_SIZE\n // if the heap is 90% full, allocate a new block\n if (freeSize * 10 <= totalSize) {\n allocateBlock();\n }\n#endif\n}\n\nvoid gc(int flags) {\n startPerfCounter(PerfCounters::GC);\n GC_CHECK(!(inGC & IN_GC_COLLECT), 40);\n inGC |= IN_GC_COLLECT;\n VLOG(\"GC mark\");\n mark(flags);\n VLOG(\"GC sweep\");\n sweep(flags);\n VLOG(\"GC done\");\n stopPerfCounter(PerfCounters::GC);\n inGC &= ~IN_GC_COLLECT;\n}\n\n#ifdef GC_GET_HEAP_SIZE\nextern \"C\" void free(void *ptr) {\n if (!ptr)\n return;\n if (inGCArea(ptr))\n app_free(ptr);\n else\n xfree(ptr);\n}\n\nextern \"C\" void *malloc(size_t sz) {\n if (PXT_IN_ISR() || inGC)\n return xmalloc(sz);\n else\n return app_alloc(sz);\n}\n\nextern \"C\" void *realloc(void *ptr, size_t size) {\n if (inGCArea(ptr)) {\n void *mem = malloc(size);\n\n if (ptr != NULL && mem != NULL) {\n auto r = (uintptr_t *)ptr;\n GC_CHECK((r[-1] >> (HIGH_SHIFT + 1)) == 3, 41);\n size_t blockSize = VAR_BLOCK_WORDS(r[-1]);\n memcpy(mem, ptr, min(blockSize * sizeof(void *), size));\n free(ptr);\n }\n\n return mem;\n } else {\n return device_realloc(ptr, size);\n }\n}\n#endif\n\nvoid *gcAllocateArray(int numbytes) {\n numbytes = ALIGN_TO_WORD(numbytes);\n numbytes += sizeof(void *);\n auto r = (uintptr_t *)gcAllocate(numbytes);\n *r = ARRAY_MASK | (TOWORDS(numbytes) << 2);\n return r + 1;\n}\n\nstatic void *gcAllocAt(void *hint, int numbytes) {\n gc(0);\n size_t numwords = BYTES_TO_WORDS(ALIGN_TO_WORD(numbytes));\n\n for (auto p = firstFree; p; p = p->nextFree) {\n GC_CHECK(!isReadOnly((TValue)p), 49);\n auto vt = p->vtable;\n GC_CHECK(IS_FREE(vt), 43);\n int offset = BYTES_TO_WORDS((uint8_t *)hint - (uint8_t *)p);\n int left = (int)(VAR_BLOCK_WORDS(vt) - numwords - offset);\n // we give ourselves some space here, so we don't get some strange overlaps\n if (offset >= 8 && left >= 8) {\n auto nf = (RefBlock *)((void **)p + numwords + offset);\n nf->setVT((left << 2) | FREE_MASK);\n nf->nextFree = p->nextFree;\n p->nextFree = nf;\n p->setVT((offset << 2) | FREE_MASK);\n p = (RefBlock *)((void **)p + offset);\n p->setVT(0);\n return p;\n }\n }\n\n return NULL;\n}\n\nvoid *app_alloc_at(void *at, int numbytes) {\n if (numbytes < 8)\n return NULL;\n if (!at)\n return NULL;\n\n numbytes = ALIGN_TO_WORD(numbytes) + sizeof(void *);\n auto r = (uintptr_t *)gcAllocAt((uintptr_t *)at - 1, numbytes);\n if (!r)\n return NULL;\n *r = ARRAY_MASK | PERMA_MASK | (TOWORDS(numbytes) << 2);\n gc(0);\n return r + 1;\n}\n\nvoid *app_alloc(int numbytes) {\n if (!numbytes)\n return NULL;\n\n // gc(0);\n auto r = (uintptr_t *)gcAllocateArray(numbytes);\n r[-1] |= PERMA_MASK;\n return r;\n}\n\nvoid *app_free(void *ptr) {\n auto r = (uintptr_t *)ptr;\n GC_CHECK((r[-1] >> (HIGH_SHIFT + 1)) == 3, 41);\n r[-1] |= FREE_MASK;\n return r;\n}\n\nvoid gcFreeze() {\n inGC |= IN_GC_FREEZE;\n}\n\nvoid gcReset() {\n inGC &= ~IN_GC_FREEZE;\n\n gcRoots.setLength(0);\n\n if (inGC)\n oops(41);\n\n if (workQueue.getLength())\n oops(41);\n\n memset(&gcStats, 0, sizeof(gcStats));\n firstFree = NULL;\n for (auto h = firstBlock; h; h = h->next) {\n setupFreeBlock(h);\n }\n}\n\n#ifdef PXT_VM\nvoid gcPreStartup() {\n inGC |= IN_GC_PREALLOC;\n}\n\nvoid gcStartup() {\n inGC &= ~IN_GC_PREALLOC;\n}\n#endif\n\nvoid *gcAllocate(int numbytes) {\n size_t numwords = BYTES_TO_WORDS(ALIGN_TO_WORD(numbytes));\n // VVLOG(\"alloc %d bytes %d words\", numbytes, numwords);\n\n if (numbytes > GC_MAX_ALLOC_SIZE)\n soft_panic(PANIC_GC_TOO_BIG_ALLOCATION);\n\n if (PXT_IN_ISR() || (inGC & (IN_GC_PREALLOC | IN_GC_ALLOC | IN_GC_COLLECT | IN_GC_FREEZE)))\n target_panic(PANIC_CALLED_FROM_ISR);\n\n inGC |= IN_GC_ALLOC;\n\n#if defined(PXT_GC_CHECKS) && !defined(PXT_VM)\n {\n auto curr = getThreadContext();\n if (curr && !curr->stack.top)\n oops(46);\n }\n#endif\n\n#ifdef PXT_GC_STRESS\n gc(0);\n#endif\n\n for (int i = 0;; ++i) {\n RefBlock *prev = NULL;\n for (auto p = firstFree; p; p = p->nextFree) {\n VVLOG(\"p=%p\", p);\n if (i == 0 && (uint8_t *)p > midPtr) {\n VLOG(\"past midptr %p; gc\", midPtr);\n break;\n }\n GC_CHECK(!isReadOnly((TValue)p), 49);\n auto vt = p->vtable;\n if (!IS_FREE(vt))\n oops(43);\n int left = (int)(VAR_BLOCK_WORDS(vt) - numwords);\n VVLOG(\"%p %d - %d = %d\", (void *)vt, (int)VAR_BLOCK_WORDS(vt), (int)numwords, left);\n if (left >= 0) {\n auto nf = (RefBlock *)((void **)p + numwords);\n auto nextFree = p->nextFree; // p and nf can overlap when allocating 4 bytes\n // VVLOG(\"nf=%p nef=%p\", nf, nextFree);\n if (left)\n nf->setVT((left << 2) | FREE_MASK);\n if (left >= 2) {\n nf->nextFree = nextFree;\n } else {\n nf = nextFree;\n }\n if (prev)\n prev->nextFree = nf;\n else\n firstFree = nf;\n p->setVT(0);\n VVLOG(\"GC=>%p %d %p -> %p,%p\", p, numwords, nf, nf ? nf->nextFree : 0,\n nf ? (void *)nf->vtable : 0);\n GC_CHECK(!nf || !nf->nextFree || !isReadOnly((TValue)nf->nextFree), 48);\n inGC &= ~IN_GC_ALLOC;\n return p;\n }\n prev = p;\n }\n\n // we didn't find anything, try GC\n if (i == 0)\n gc(0);\n // GC didn't help, try new block\n else if (i == 1) {\n DMESG(\"gcAlloc(%d) (%d/%d free; %d max block) -> new block\", numbytes,\n gcStats.lastFreeBytes, gcStats.totalBytes, gcStats.lastMaxBlockBytes);\n allocateBlock();\n } else\n // the block allocated was apparently too small\n soft_panic(PANIC_GC_OOM);\n }\n}\n\nstatic void removePtr(TValue v) {\n int len = gcRoots.getLength();\n auto data = gcRoots.getData();\n // scan from the back, as this is often used as a stack\n for (int i = len - 1; i >= 0; --i) {\n if (data[i] == v) {\n if (i == len - 1) {\n gcRoots.pop();\n } else {\n data[i] = gcRoots.pop();\n }\n return;\n }\n }\n oops(40);\n}\n\nvoid registerGC(TValue *root, int numwords) {\n if (!numwords)\n return;\n\n if (numwords > 1) {\n while (numwords-- > 0) {\n registerGC(root++, 1);\n }\n return;\n }\n\n gcRoots.push((TValue)((uintptr_t)root | 1));\n}\n\nvoid unregisterGC(TValue *root, int numwords) {\n if (!numwords)\n return;\n if (numwords > 1) {\n while (numwords-- > 0) {\n unregisterGC(root++, 1);\n }\n return;\n }\n\n removePtr((TValue)((uintptr_t)root | 1));\n}\n\nvoid registerGCPtr(TValue ptr) {\n if (isReadOnly(ptr))\n return;\n gcRoots.push(ptr);\n}\n\nvoid unregisterGCPtr(TValue ptr) {\n if (isReadOnly(ptr))\n return;\n removePtr(ptr);\n}\n\nvoid RefImage::scan(RefImage *t) {\n gcScan((TValue)t->buffer);\n}\n\nvoid RefCollection::scan(RefCollection *t) {\n gcScanSegment(t->head);\n}\n\nvoid RefAction::scan(RefAction *t) {\n gcScanMany(t->fields, t->len);\n}\n\nvoid RefRefLocal::scan(RefRefLocal *t) {\n gcScan(t->v);\n}\n\nvoid RefMap::scan(RefMap *t) {\n gcScanSegment(t->keys);\n gcScanSegment(t->values);\n}\n\nvoid RefRecord_scan(RefRecord *r) {\n VTable *tbl = getVTable(r);\n gcScanMany(r->fields, BYTES_TO_WORDS(tbl->numbytes - sizeof(RefRecord)));\n}\n\n#define SIZE(off) TOWORDS(sizeof(*t) + (off))\n\nunsigned RefImage::gcsize(RefImage *t) {\n return SIZE(0);\n}\n\nunsigned RefCollection::gcsize(RefCollection *t) {\n return SIZE(0);\n}\n\nunsigned RefAction::gcsize(RefAction *t) {\n return SIZE(WORDS_TO_BYTES(t->len));\n}\n\nunsigned RefRefLocal::gcsize(RefRefLocal *t) {\n return SIZE(0);\n}\n\nunsigned RefMap::gcsize(RefMap *t) {\n return SIZE(0);\n}\n\n} // namespace pxt\n",
"gcstats.ts": "namespace control {\n //% shim=pxt::getGCStats\n function getGCStats(): Buffer {\n return null\n }\n\n export interface GCStats {\n numGC: number;\n numBlocks: number;\n totalBytes: number;\n lastFreeBytes: number;\n lastMaxBlockBytes: number;\n minFreeBytes: number;\n }\n\n /**\n * Get various statistics about the garbage collector (GC)\n */\n export function gcStats(): GCStats {\n const buf = getGCStats()\n if (!buf)\n return null\n let off = 0\n const res: any = {}\n\n addField(\"numGC\")\n addField(\"numBlocks\")\n addField(\"totalBytes\")\n addField(\"lastFreeBytes\")\n addField(\"lastMaxBlockBytes\")\n addField(\"minFreeBytes\")\n\n return res\n\n function addField(name: string) {\n res[name] = buf.getNumber(NumberFormat.UInt32LE, off)\n off += 4\n }\n } \n}",
"interval.ts": "namespace control {\n export enum IntervalMode {\n Interval,\n Timeout,\n Immediate\n }\n\n let _intervals: Interval[] = undefined;\n class Interval {\n\n id: number;\n func: () => void;\n delay: number;\n mode: IntervalMode;\n\n constructor(func: () => void, delay: number, mode: IntervalMode) {\n this.id = _intervals.length == 0\n ? 1 : _intervals[_intervals.length - 1].id + 1;\n this.func = func;\n this.delay = delay;\n this.mode = mode;\n _intervals.push(this);\n\n control.runInParallel(() => this.work());\n }\n\n work() {\n // execute\n switch (this.mode) {\n case IntervalMode.Immediate:\n case IntervalMode.Timeout:\n if (this.delay > 0)\n pause(this.delay); // timeout\n if (this.delay >= 0) // immediate, timeout\n this.func();\n break;\n case IntervalMode.Interval:\n while (this.delay > 0) {\n pause(this.delay);\n // might have been cancelled during this duration\n if (this.delay > 0)\n this.func();\n }\n break;\n }\n // remove from interval array\n _intervals.removeElement(this);\n }\n\n cancel() {\n this.delay = -1;\n }\n }\n\n export function setInterval(func: () => void, delay: number, mode: IntervalMode): number {\n if (!func || delay < 0) return 0;\n if (!_intervals) _intervals = [];\n const interval = new Interval(func, delay, mode);\n return interval.id;\n }\n\n export function clearInterval(intervalId: number, mode: IntervalMode): void {\n if (!_intervals) return;\n for (let i = 0; i < _intervals.length; ++i) {\n const it = _intervals[i];\n if (it.id == intervalId && it.mode == mode) {\n it.cancel();\n break;\n }\n }\n }\n}",
"json.ts": "namespace JSON {\n export function parseIntRadix(s: string, base?: number) {\n if (base == null || base == 10) {\n return parseFloat(s) | 0\n }\n\n let m = false\n let r = 0\n for (let i = 0; i < s.length; ++i) {\n let c = s.charCodeAt(i)\n if (c == 0x20 || c == 10 || c == 13 || c == 9)\n continue\n if (r == 0 && !m && c == 0x2d) {\n m = true\n continue\n }\n\n let v = -1\n if (0x30 <= c && c <= 0x39)\n v = c - 0x30\n else {\n c |= 0x20\n if (0x61 <= c && c <= 0x7a)\n v = c - 0x61 + 10\n }\n\n if (0 <= v && v < base) {\n r *= base\n r += v\n } else {\n return undefined\n }\n }\n\n return m ? -r : r\n }\n\n\n class Parser {\n ptr: number\n s: string\n errorMsg: string\n\n error(msg: string) {\n if (!this.errorMsg) {\n this.errorMsg = msg + \" at position \" + this.ptr\n this.ptr = this.s.length\n }\n }\n\n skipWS() {\n for (; ;) {\n const c = this.nextChar()\n if (c == 0x20 || c == 0x0a || c == 0x0d || c == 0x09) {\n // OK\n } else {\n this.ptr--\n return c\n }\n }\n }\n\n nextChar() {\n if (this.ptr < this.s.length)\n return this.s.charCodeAt(this.ptr++)\n return 0\n }\n\n doString() {\n let r = \"\"\n this.ptr++\n for (; ;) {\n const c = this.s.charAt(this.ptr++)\n if (c == \"\\\"\")\n return r\n if (c == \"\\\\\") {\n let q = this.s.charAt(this.ptr++)\n if (q == \"b\") q = \"\\b\"\n else if (q == \"n\") q = \"\\n\"\n else if (q == \"r\") q = \"\\r\"\n else if (q == \"t\") q = \"\\t\"\n else if (q == \"u\") {\n q = String.fromCharCode(parseIntRadix(this.s.slice(this.ptr, this.ptr + 4), 16))\n this.ptr += 4\n }\n r += q\n } else {\n r += c\n }\n }\n }\n\n doArray(): any[] {\n const r = []\n this.ptr++\n for (; ;) {\n let c = this.skipWS()\n if (c == 0x5d) {\n this.ptr++\n return r\n }\n const v = this.value()\n if (this.errorMsg)\n return null\n r.push(v)\n c = this.skipWS()\n if (c == 0x2c) {\n this.ptr++\n continue\n }\n if (c == 0x5d)\n continue\n this.error(\"expecting comma\")\n }\n }\n\n doObject() {\n const r: any = {}\n this.ptr++\n for (; ;) {\n let c = this.skipWS()\n if (c == 0x7d) {\n this.ptr++\n return r\n }\n if (c != 0x22) {\n this.error(\"expecting key\")\n return r\n }\n const k = this.doString()\n c = this.skipWS()\n if (c != 0x3a) {\n this.error(\"expecting colon\")\n return r\n }\n this.ptr++\n const v = this.value()\n if (this.errorMsg)\n return null\n r[k] = v\n c = this.skipWS()\n if (c == 0x2c) {\n this.ptr++\n continue\n }\n if (c == 0x7d)\n continue\n this.error(\"expecting comma, got \" + String.fromCharCode(c))\n }\n }\n\n doNumber() {\n const beg = this.ptr\n for (; ;) {\n const c = this.nextChar()\n if ((0x30 <= c && c <= 0x39) || c == 0x2b || c == 0x2d || c == 0x2e || c == 0x45 || c == 0x65) {\n // one more\n } else {\n this.ptr--\n break\n }\n }\n const ss = this.s.slice(beg, this.ptr)\n if (ss.length == 0) {\n this.error(\"expecting number\")\n return 0\n }\n return parseFloat(ss)\n }\n\n checkKw(k: string) {\n if (this.s.slice(this.ptr, this.ptr + k.length) == k) {\n this.ptr += k.length\n return true\n }\n return false\n }\n\n value() {\n if (this.errorMsg)\n return null\n\n const c = this.skipWS()\n if (c == 0x7b)\n return this.doObject()\n else if (c == 0x5b)\n return this.doArray()\n else if ((0x30 <= c && c <= 0x39) || c == 0x2d)\n return this.doNumber()\n else if (c == 0x22)\n return this.doString()\n else if (c == 0x74 && this.checkKw(\"true\"))\n return true\n else if (c == 0x66 && this.checkKw(\"false\"))\n return false\n else if (c == 0x6e && this.checkKw(\"null\"))\n return null\n\n this.error(\"unexpected token\")\n return null\n }\n }\n\n class Stringifier {\n currIndent: string\n indentStep: string\n indent: number\n\n doString(s: string) {\n let r = \"\\\"\"\n for (let i = 0; i < s.length; ++i) {\n let c = s[i]\n if (c == \"\\n\") c = \"\\\\n\"\n else if (c == \"\\r\") c = \"\\\\r\"\n else if (c == \"\\t\") c = \"\\\\t\"\n else if (c == \"\\b\") c = \"\\\\b\"\n else if (c == \"\\\\\") c = \"\\\\\\\\\"\n else if (c == \"\\\"\") c = \"\\\\\\\"\"\n r += c\n }\n return r + \"\\\"\"\n }\n\n go(v: any) {\n const t = typeof v\n if (t == \"string\")\n return this.doString(v)\n else if (t == \"boolean\" || t == \"number\" || v == null)\n return \"\" + v\n else if (Array.isArray(v)) {\n const arr = v as any[]\n if (arr.length == 0)\n return \"[]\"\n else {\n let r = \"[\"\n if (this.indent) {\n this.currIndent += this.indentStep\n r += \"\\n\"\n }\n for (let i = 0; i < arr.length; ++i) {\n r += this.currIndent + this.go(arr[i])\n if (i != arr.length - 1)\n r += \",\"\n if (this.indent)\n r += \"\\n\"\n }\n if (this.indent)\n this.currIndent = this.currIndent.slice(this.indent)\n r += this.currIndent + \"]\"\n return r\n }\n } else {\n const keys = Object.keys(v)\n if (keys.length == 0)\n return \"{}\"\n\n let r = \"{\"\n if (this.indent) {\n this.currIndent += this.indentStep\n r += \"\\n\"\n }\n for (let i = 0; i < keys.length; ++i) {\n const k = keys[i]\n r += this.currIndent + this.doString(k)\n if (this.indent)\n r += \": \"\n else\n r += \":\"\n r += this.go(v[k])\n if (i != keys.length - 1)\n r += \",\"\n if (this.indent)\n r += \"\\n\"\n }\n if (this.indent)\n this.currIndent = this.currIndent.slice(this.indent)\n r += this.currIndent + \"}\"\n return r\n }\n }\n }\n\n /**\n * Converts a JavaScript value to a JavaScript Object Notation (JSON) string.\n * @param value A JavaScript value, usually an object or array, to be converted.\n * @param replacer Not supported; use null.\n * @param indent Adds indentation, white space, and line break characters to the return-value JSON text to make it easier to read.\n */\n export function stringify(value: any, replacer: any = null, indent: number = 0) {\n const ss = new Stringifier()\n ss.currIndent = \"\"\n indent |= 0\n if (indent < 0) indent = 0\n if (indent > 10) indent = 10\n ss.indentStep = \"\"\n ss.currIndent = \"\"\n ss.indent = indent\n while (indent-- > 0)\n ss.indentStep += \" \"\n return ss.go(value)\n }\n\n\n /**\n * Converts a JavaScript Object Notation (JSON) string into an object.\n * @param text A valid JSON string.\n */\n export function parse(s: string) {\n const p = new Parser()\n p.ptr = 0\n p.s = s\n const r = p.value()\n if (p.skipWS()) {\n p.error(\"excessive input\")\n }\n if (p.errorMsg) {\n control.dmesg(\"Invalid JSON: \" + p.errorMsg)\n return undefined\n }\n return r\n }\n}\n",
"loops.cpp": "#include \"pxtbase.h\"\n\nnamespace loops {\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=loops/forever weight=100 afterOnStart=true deprecated=true\n//% blockId=forever_deprecated block=\"forever\" blockAllowMultiple=1\nvoid forever(Action a) {\n runForever(a);\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 */\n//% help=loops/pause weight=99 deprecated=true\n//% async block=\"pause %pause=timePicker|ms\"\n//% blockId=device_pause_deprecated\nvoid pause(int ms) {\n if (ms < 0) return;\n sleep_ms(ms);\n}\n\n}",
"math.ts": "namespace Math {\n\n export const E = 2.718281828459045;\n export const LN2 = 0.6931471805599453;\n export const LN10 = 2.302585092994046;\n export const LOG2E = 1.4426950408889634;\n export const LOG10E = 0.4342944819032518;\n export const PI = 3.141592653589793;\n export const SQRT1_2 = 0.7071067811865476;\n export const SQRT2 = 1.4142135623730951;\n\n /**\n * Re-maps a number from one range to another. That is, a value of ``from low`` would get mapped to ``to low``, a value of ``from high`` to ``to high``, values in-between to values in-between, etc.\n * @param value value to map in ranges\n * @param fromLow the lower bound of the value's current range\n * @param fromHigh the upper bound of the value's current range, eg: 1023\n * @param toLow the lower bound of the value's target range\n * @param toHigh the upper bound of the value's target range, eg: 4\n */\n //% help=math/map weight=10 blockGap=8\n //% blockId=math_map block=\"map %value|from low %fromLow|high %fromHigh|to low %toLow|high %toHigh\"\n //% inlineInputMode=inline\n export function map(value: number, fromLow: number, fromHigh: number, toLow: number, toHigh: number): number {\n return ((value - fromLow) * (toHigh - toLow)) / (fromHigh - fromLow) + toLow;\n } \n\n /**\n * Constrains a number to be within a range\n * @param x the number to constrain, all data types\n * @param y the lower end of the range, all data types\n * @param z the upper end of the range, all data types\n */\n //% help=math/constrain weight=11 blockGap=8\n //% blockId=\"math_constrain_value\" block=\"constrain %value|between %low|and %high\"\n export function constrain(value: number, low: number, high: number): number {\n return value < low ? low : value > high ? high : value;\n }\n\n const b_m16: number[] = [0, 49, 49, 41, 90, 27, 117, 10]\n /**\n * Returns the sine of an input angle. This is an 8-bit approximation.\n * @param theta input angle from 0-255\n */\n //% help=math/isin weight=11 advanced=true blockGap=8\n export function isin(theta: number) {\n //reference: based on FASTLed's sin approximation method: [https://github.com/FastLED/FastLED](MIT)\n let offset = theta;\n if( theta & 0x40 ) {\n offset = 255 - offset;\n }\n offset &= 0x3F; // 0..63\n\n let secoffset = offset & 0x0F; // 0..15\n if( theta & 0x40) secoffset++;\n\n let section = offset >> 4; // 0..3\n let s2 = section * 2;\n\n let b = b_m16[s2];\n let m16 = b_m16[s2+1];\n let mx = (m16 * secoffset) >> 4;\n \n let y = mx + b;\n if( theta & 0x80 ) y = -y;\n\n y += 128;\n\n return y;\n }\n\n /**\n * Returns the cosine of an input angle. This is an 8-bit approximation. \n * @param theta input angle from 0-255\n */\n //% help=math/icos weight=10 advanced=true blockGap=8\n export function icos(theta: number) {\n return isin(theta + 16384);\n }\n}\n\nnamespace Number {\n export const EPSILON = 2.220446049250313e-16;\n}",
"ns.ts": "\n/**\n * Respond to and read data from buttons and sensors.\n */\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\nnamespace input {\n}\n",
"pause.ts": "/**\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=loops/pause weight=99\n//% async block=\"pause %pause=timePicker|ms\"\n//% blockId=device_pause blockNamespace=\"loops\"\nfunction pause(ms: number): void {\n loops.pause(ms);\n}\n\n// micro:bit compatibility\n// these functions allow some level of reuse\n// between micro:bit and other maker-style editors\nnamespace basic {\n export function pause(millis: number) {\n loops.pause(millis);\n }\n}",
"perfcounters.ts": "namespace control {\n /**\n * Enable profiling for current function.\n */\n //% shim=TD_NOOP shimArgument=perfCounter\n export function enablePerfCounter(name?: string) { }\n\n /**\n * Dump values of profiling performance counters.\n */\n //% shim=pxt::dumpPerfCounters\n export function dmesgPerfCounters() { }\n}\n",
"poll.ts": "namespace control {\n class PollEvent {\n public eid: number;\n public vid: number;\n public start: number;\n public timeOut: number;\n public condition: () => boolean;\n public once: boolean;\n constructor(eid: number, vid: number, start: number, timeOut: number, condition: () => boolean, once: boolean) {\n this.eid = eid;\n this.vid = vid;\n this.start = start;\n this.timeOut = timeOut;\n this.condition = condition;\n this.once = once;\n }\n }\n\n let _pollEventQueue: PollEvent[] = undefined;\n\n function pollEvents() {\n while (_pollEventQueue.length > 0) {\n const now = control.millis();\n for (let i = 0; i < _pollEventQueue.length; ++i) {\n const ev = _pollEventQueue[i];\n if (ev.condition() || (ev.timeOut > 0 && now - ev.start > ev.timeOut)) {\n control.raiseEvent(ev.eid, ev.vid);\n if (ev.once) {\n _pollEventQueue.splice(i, 1);\n --i;\n }\n }\n }\n pause(50);\n }\n // release fiber\n _pollEventQueue = undefined;\n }\n\n export function __queuePollEvent(timeOut: number, condition: () => boolean, handler: () => void) {\n const ev = new PollEvent(\n DAL.DEVICE_ID_NOTIFY,\n control.allocateNotifyEvent(),\n control.millis(),\n timeOut,\n condition,\n !handler\n );\n\n // start polling fiber if needed\n if (!_pollEventQueue) {\n _pollEventQueue = [ev];\n control.runInParallel(pollEvents);\n }\n else {\n // add to the queue\n _pollEventQueue.push(ev)\n }\n\n // register event\n if (handler)\n control.onEvent(ev.eid, ev.vid, handler);\n else // or wait\n control.waitForEvent(ev.eid, ev.vid);\n } \n}\n\n/**\n * Busy wait for a condition to be true\n * @param condition condition to test for\n * @param timeOut if positive, maximum duration to wait for in milliseconds\n */\n//% blockId=\"pxt_pause_until\"\nfunction pauseUntil(condition: () => boolean, timeOut?: number): void {\n if (!condition || condition()) return; // optimistic path\n if (!timeOut) timeOut = 0;\n control.__queuePollEvent(timeOut, condition, undefined);\n}\n",
"pxt-core.d.ts": "/// \n\ninterface Array {\n /**\n * Get or set the length of an array. This number is one more than the index of the last element the array.\n */\n //% shim=Array_::length weight=84\n //% blockId=\"lists_length\" block=\"length of %VALUE\" blockBuiltin=true blockNamespace=\"arrays\"\n length: number;\n\n /**\n * Append a new element to an array.\n * @param items New elements of the Array.\n */\n //% help=arrays/push\n //% shim=Array_::push weight=50\n //% blockId=\"array_push\" block=\"%list| add value %value| to end\" blockNamespace=\"arrays\"\n //% group=\"Modify\"\n push(item: T): void;\n\n /**\n * Concatenates the values with another array.\n * @param arr The other array that is being concatenated with\n */\n //% helper=arrayConcat weight=40\n concat(arr: T[]): T[];\n\n /**\n * Remove the last element from an array and return it.\n */\n //% help=arrays/pop\n //% shim=Array_::pop weight=45\n //% blockId=\"array_pop\" block=\"get and remove last value from %list\" blockNamespace=\"arrays\"\n //% group=\"Read\"\n pop(): T;\n\n /**\n * Reverse the elements in an array. The first array element becomes the last, and the last array element becomes the first.\n */\n //% help=arrays/reverse\n //% helper=arrayReverse weight=10\n //% blockId=\"array_reverse\" block=\"reverse %list\" blockNamespace=\"arrays\"\n //% group=\"Operations\"\n reverse(): void;\n\n /**\n * Remove the first element from an array and return it. This method changes the length of the array.\n */\n //% help=arrays/shift\n //% helper=arrayShift weight=30\n //% blockId=\"array_shift\" block=\"get and remove first value from %list\" blockNamespace=\"arrays\"\n //% group=\"Read\"\n shift(): T;\n\n /**\n * Add one element to the beginning of an array and return the new length of the array.\n * @param element to insert at the start of the Array.\n */\n //% help=arrays/unshift\n //% helper=arrayUnshift weight=25\n //% blockId=\"array_unshift\" block=\"%list| insert %value| at beginning\" blockNamespace=\"arrays\"\n //% group=\"Modify\"\n //unshift(...values:T[]): number; //rest is not supported in our compiler yet.\n unshift(value: T): number;\n\n /**\n * Return a section of an array.\n * @param start The beginning of the specified portion of the array. eg: 0\n * @param end The end of the specified portion of the array. eg: 0\n */\n //% help=arrays/slice\n //% helper=arraySlice weight=41 blockNamespace=\"arrays\"\n slice(start?: number, end?: number): T[];\n\n /**\n * Remove elements from an array.\n * @param start The zero-based location in the array from which to start removing elements. eg: 0\n * @param deleteCount The number of elements to remove. eg: 0\n */\n //% helper=arraySplice weight=40\n splice(start: number, deleteCount: number): void;\n\n /**\n * joins all elements of an array into a string and returns this string.\n * @param sep the string separator\n */\n //% helper=arrayJoin weight=40\n join(sep?: string): string;\n\n /**\n * Tests whether at least one element in the array passes the test implemented by the provided function.\n * @param callbackfn A function that accepts up to two arguments. The some method calls the callbackfn function one time for each element in the array.\n */\n //% helper=arraySome weight=40\n some(callbackfn: (value: T, index: number) => boolean): boolean;\n\n /**\n * Tests whether all elements in the array pass the test implemented by the provided function.\n * @param callbackfn A function that accepts up to two arguments. The every method calls the callbackfn function one time for each element in the array.\n */\n //% helper=arrayEvery weight=40\n every(callbackfn: (value: T, index: number) => boolean): boolean;\n\n /**\n * Sort the elements of an array in place and returns the array. The sort is not necessarily stable.\n * @param specifies a function that defines the sort order. If omitted, the array is sorted according to the prmitive type\n */\n //% helper=arraySort weight=40\n sort(callbackfn?: (value1: T, value2: T) => number): T[];\n\n /**\n * Call a defined callback function on each element of an array, and return an array containing the results.\n * @param callbackfn A function that accepts up to two arguments. The map method calls the callbackfn function one time for each element in the array.\n */\n //% helper=arrayMap weight=40\n map(callbackfn: (value: T, index: number) => U): U[];\n\n /**\n * Call a defined callback function on each element of an array.\n * @param callbackfn A function that accepts up to two arguments. The forEach method calls the callbackfn function one time for each element in the array.\n */\n //% helper=arrayForEach weight=40\n forEach(callbackfn: (value: T, index: number) => void): void;\n\n /**\n * Return the elements of an array that meet the condition specified in a callback function.\n * @param callbackfn A function that accepts up to two arguments. The filter method calls the callbackfn function one time for each element in the array.\n */\n //% helper=arrayFilter weight=40\n filter(callbackfn: (value: T, index: number) => boolean): T[];\n\n /**\n * Fills all the elements of an array from a start index to an end index with a static value. The end index is not included.\n */\n //% helper=arrayFill weight=39\n fill(value: T, start?: number, end?: number): T[];\n\n /**\n * Returns the value of the first element in the array that satisfies the provided testing function. Otherwise undefined is returned.\n * @param callbackfn\n */\n //% helper=arrayFind weight=40\n find(callbackfn: (value: T, index: number) => boolean): T;\n\n /**\n * Call the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.\n * @param callbackfn A function that accepts up to three arguments. The reduce method calls the callbackfn function one time for each element in the array.\n * @param initialValue Initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an array value.\n */\n //% helper=arrayReduce weight=40\n reduce(callbackfn: (previousValue: U, currentValue: T, currentIndex: number) => U, initialValue: U): U;\n\n\n /** Remove the first occurence of an object. Returns true if removed. */\n //% shim=Array_::removeElement weight=48\n removeElement(element: T): boolean;\n\n /** Remove the element at a certain index. */\n //% help=arrays/remove-at\n //% shim=Array_::removeAt weight=47\n //% blockId=\"array_removeat\" block=\"%list| get and remove value at %index\" blockNamespace=\"arrays\"\n //% group=\"Read\"\n removeAt(index: number): T;\n\n /**\n * Insert the value at a particular index, increases length by 1\n * @param index the zero-based position in the list to insert the value, eg: 0\n * @param the value to insert, eg: 0\n */\n //% help=arrays/insert-at\n //% shim=Array_::insertAt weight=20\n //% blockId=\"array_insertAt\" block=\"%list| insert at %index| value %value\" blockNamespace=\"arrays\"\n //% group=\"Modify\"\n insertAt(index: number, value: T): void;\n\n /**\n * Return the index of the first occurrence of a value in an array.\n * @param item The value to locate in the array.\n * @param fromIndex The array index at which to begin the search. If fromIndex is omitted, the search starts at index 0.\n */\n //% help=arrays/index-of\n //% shim=Array_::indexOf weight=40\n //% blockId=\"array_indexof\" block=\"%list| find index of %value\" blockNamespace=\"arrays\"\n //% group=\"Operations\"\n indexOf(item: T, fromIndex?: number): number;\n\n /**\n * Get the value at a particular index\n * @param index the zero-based position in the list of the item, eg: 0\n */\n //% help=arrays/get\n //% shim=Array_::getAt weight=85\n get(index: number): T;\n\n /**\n * Store a value at a particular index\n * @param index the zero-based position in the list to store the value, eg: 0\n * @param value the value to insert, eg: 0\n */\n //% help=arrays/set\n //% shim=Array_::setAt weight=84\n set(index: number, value: T): void;\n\n /**\n * Return a random value from the array\n */\n //% help=arrays/pick-random\n //% helper=arrayPickRandom weight=25\n //% blockId=\"array_pickRandom\" block=\"get random value from %list\"\n //% blockNamespace=\"arrays\"\n //% group=\"Read\"\n _pickRandom(): T;\n\n [n: number]: T;\n\n /**\n * Add one element to the beginning of an array and return the new length of the array.\n * @param element to insert at the start of the Array.\n */\n //% help=arrays/unshift\n //% helper=arrayUnshift weight=24\n //% blockId=\"array_unshift_statement\" block=\"%list| insert %value| at beginning\" blockNamespace=\"arrays\"\n //% blockAliasFor=\"Array.unshift\"\n //% group=\"Modify\"\n _unshiftStatement(value: T): void;\n\n /**\n * Remove the last element from an array and return it.\n */\n //% help=arrays/pop\n //% shim=Array_::pop weight=44\n //% blockId=\"array_pop_statement\" block=\"remove last value from %list\" blockNamespace=\"arrays\"\n //% blockAliasFor=\"Array.pop\"\n //% group=\"Modify\"\n _popStatement(): void;\n\n /**\n * Remove the first element from an array and return it. This method changes the length of the array.\n */\n //% help=arrays/shift\n //% helper=arrayShift weight=29\n //% blockId=\"array_shift_statement\" block=\"remove first value from %list\" blockNamespace=\"arrays\"\n //% blockAliasFor=\"Array.shift\"\n //% group=\"Modify\"\n _shiftStatement(): void;\n\n /** Remove the element at a certain index. */\n //% help=arrays/remove-at\n //% shim=Array_::removeAt weight=14\n //% blockId=\"array_removeat_statement\" block=\"%list| remove value at %index\" blockNamespace=\"arrays\"\n //% blockAliasFor=\"Array.removeAt\"\n //% group=\"Modify\"\n _removeAtStatement(index: number): void;\n}\n\ndeclare interface String {\n // This block is currently disabled in favor of the built-in Blockly \"Create text with\" block, which compiles to \"\" + \"\"\n // Add % sign back to the block annotation to re-enable\n /**\n * Returns a string that contains the concatenation of two or more strings.\n * @param other The string to append to the end of the string.\n */\n //% shim=String_::concat weight=49\n //% blockId=\"string_concat\" blockNamespace=\"text\"\n // block=\"join %list=text|%other\"\n concat(other: string): string;\n\n /**\n * Return the character at the specified index.\n * @param index The zero-based index of the desired character.\n */\n //% shim=String_::charAt weight=48\n //% help=text/char-at\n //% blockId=\"string_get\" block=\"char from %this=text|at %pos\" blockNamespace=\"text\"\n charAt(index: number): string;\n\n /** Returns the length of a String object. */\n //% property shim=String_::length weight=47\n //% blockId=\"text_length\" block=\"length of %VALUE\" blockBuiltin=true blockNamespace=\"text\"\n length: number;\n\n /**\n * Return the Unicode value of the character at the specified location.\n * @param index The zero-based index of the desired character. If there is no character at the specified index, NaN is returned.\n */\n //% shim=String_::charCodeAt\n charCodeAt(index: number): number;\n\n /**\n * See how the order of characters in two strings is different (in ASCII encoding).\n * @param that String to compare to target string\n */\n //% shim=String_::compare\n //% help=text/compare\n //% blockId=\"string_compare\" block=\"compare %this=text| to %that\" blockNamespace=\"text\"\n compare(that: string): number;\n\n /**\n * Return a substring of the current string.\n * @param start first character index; can be negative from counting from the end, eg:0\n * @param length number of characters to extract, eg: 10\n */\n //% helper=stringSubstr\n //% help=text/substr\n //% blockId=\"string_substr\" block=\"substring of %this=text|from %start|of length %length\" blockNamespace=\"text\"\n substr(start: number, length?: number): string;\n\n /**\n * Return the current string with the first occurence of toReplace\n * replaced with the replacer\n * @param toReplace the substring to replace in the current string\n * @param replacer either the string that replaces toReplace in the current string,\n * or a function that accepts the substring and returns the replacement string.\n */\n //% helper=stringReplace\n replace(toReplace: string, replacer: string | ((sub: string) => string)): string;\n\n /**\n * Return the current string with each occurence of toReplace\n * replaced with the replacer\n * @param toReplace the substring to replace in the current string\n * @param replacer either the string that replaces toReplace in the current string,\n * or a function that accepts the substring and returns the replacement string.\n */\n //% helper=stringReplaceAll\n replaceAll(toReplace: string, replacer: string | ((sub: string) => string)): string;\n\n /**\n * Return a substring of the current string.\n * @param start first character index; can be negative from counting from the end, eg:0\n * @param end one-past-last character index\n */\n //% helper=stringSlice\n slice(start: number, end?: number): string;\n\n /** Returns a value indicating if the string is empty */\n //% helper=stringEmpty\n //% help=text/is-empty\n //% blockId=\"string_isempty\" blockNamespace=\"text\"\n //% block=\"%this=text| is empty\"\n isEmpty(): boolean;\n\n /**\n * Returns the position of the first occurrence of a specified value in a string.\n * @param searchValue the text to find\n * @param start optional start index for the search\n */\n //% shim=String_::indexOf\n //% help=text/index-of\n //% blockId=\"string_indexof\" blockNamespace=\"text\"\n //% block=\"%this=text|find index of %searchValue\"\n indexOf(searchValue: string, start?: number): number;\n\n /**\n * Determines whether a string contains the characters of a specified string.\n * @param searchValue the text to find\n * @param start optional start index for the search\n */\n //% shim=String_::includes\n //% help=text/includes\n //% blockId=\"string_includes\" blockNamespace=\"text\"\n //% block=\"%this=text|includes %searchValue\"\n includes(searchValue: string, start?: number): boolean;\n\n /**\n * Splits the string according to the separators\n * @param separator\n * @param limit\n */\n //% helper=stringSplit\n //% help=text/split\n //% blockId=\"string_split\" blockNamespace=\"text\"\n //% block=\"split %this=text|at %separator\"\n split(separator?: string, limit?: number): string[];\n\n /**\n * Return a substring of the current string with whitespace removed from both ends\n */\n //% helper=stringTrim\n trim(): string;\n\n /**\n * Converts the string to upper case characters.\n */\n //% helper=stringToUpperCase\n //% help=text/to-upper-case\n toUpperCase(): string;\n\n /**\n * Converts the string to lower case characters.\n */\n //% helper=stringToLowerCase\n //% help=text/to-lower-case\n toLowerCase(): string;\n\n [index: number]: string;\n}\n\n/**\n * Convert a string to a number.\n * @param s A string to convert into a number. eg: 123\n */\n//% shim=String_::toNumber\n//% help=text/parse-float\n//% blockId=\"string_parsefloat\" block=\"parse to number %text\" blockNamespace=\"text\"\n//% text.defl=\"123\"\ndeclare function parseFloat(text: string): number;\n\n/**\n * Returns a pseudorandom number between min and max included.\n * If both numbers are integral, the result is integral.\n * @param min the lower inclusive bound, eg: 0\n * @param max the upper inclusive bound, eg: 10\n */\n//% blockId=\"device_random\" block=\"pick random %min|to %limit\"\n//% blockNamespace=\"Math\"\n//% help=math/randint\n//% shim=Math_::randomRange\ndeclare function randint(min: number, max: number): number;\n\ninterface Object { }\ninterface Function {\n __assignableToFunction: Function;\n}\ninterface IArguments {\n __assignableToIArguments: IArguments;\n}\ninterface RegExp {\n __assignableToRegExp: RegExp;\n}\ntype TemplateStringsArray = Array;\n\ntype uint8 = number;\ntype uint16 = number;\ntype uint32 = number;\ntype int8 = number;\ntype int16 = number;\ntype int32 = number;\n\n\ndeclare interface Boolean {\n /**\n * Returns a string representation of an object.\n */\n //% shim=numops::toString\n toString(): string;\n}\n\n/**\n * Combine, split, and search text strings.\n*/\n//% blockNamespace=\"text\"\ndeclare namespace String {\n\n /**\n * Make a string from the given ASCII character code.\n */\n //% help=math/from-char-code\n //% shim=String_::fromCharCode weight=1\n //% blockNamespace=\"text\" blockId=\"stringFromCharCode\" block=\"text from char code %code\"\n function fromCharCode(code: number): string;\n}\n\ndeclare interface Number {\n /**\n * Returns a string representation of a number.\n */\n //% shim=numops::toString\n toString(): string;\n}\n\n/**\n * Add, remove, and replace items in lists.\n*/\n//% blockNamespace=\"Arrays\"\ndeclare namespace Array {\n /**\n * Check if a given object is an array.\n */\n //% shim=Array_::isArray\n function isArray(obj: any): boolean;\n}\n\ndeclare namespace Object {\n /**\n * Return the field names in an object.\n */\n //% shim=pxtrt::keysOf\n function keys(obj: any): string[];\n}\n\n/**\n * More complex operations with numbers.\n*/\ndeclare namespace Math {\n /**\n * Returns the value of a base expression taken to a specified power.\n * @param x The base value of the expression.\n * @param y The exponent value of the expression.\n */\n //% shim=Math_::pow\n function pow(x: number, y: number): number;\n\n /**\n * Returns a pseudorandom number between 0 and 1.\n */\n //% shim=Math_::random\n //% help=math/random\n function random(): number;\n\n /**\n * Returns a pseudorandom number between min and max included.\n * If both numbers are integral, the result is integral.\n * @param min the lower inclusive bound, eg: 0\n * @param max the upper inclusive bound, eg: 10\n */\n //% blockId=\"device_random_deprecated\" block=\"pick random %min|to %limit\"\n //% help=math/random-range deprecated\n //% shim=Math_::randomRange\n function randomRange(min: number, max: number): number;\n\n /**\n * Returns the natural logarithm (base e) of a number.\n * @param x A number\n */\n //% shim=Math_::log\n //% help=math\n function log(x: number): number;\n\n /**\n * Returns returns ``e^x``.\n * @param x A number\n */\n //% shim=Math_::exp\n //% help=math\n function exp(x: number): number;\n\n /**\n * Returns the sine of a number.\n * @param x An angle in radians\n */\n //% shim=Math_::sin\n //% help=math/trigonometry\n function sin(x: number): number;\n\n /**\n * Returns the cosine of a number.\n * @param x An angle in radians\n */\n //% shim=Math_::cos\n //% help=math/trigonometry\n function cos(x: number): number;\n\n /**\n * Returns the tangent of a number.\n * @param x An angle in radians\n */\n //% shim=Math_::tan\n //% help=math/trigonometry\n function tan(x: number): number;\n\n /**\n * Returns the arcsine (in radians) of a number\n * @param x A number\n */\n //% shim=Math_::asin\n //% help=math/trigonometry\n function asin(x: number): number;\n\n /**\n * Returns the arccosine (in radians) of a number\n * @param x A number\n */\n //% shim=Math_::acos\n //% help=math/trigonometry\n function acos(x: number): number;\n\n /**\n * Returns the arctangent (in radians) of a number\n * @param x A number\n */\n //% shim=Math_::atan\n //% help=math/trigonometry\n function atan(x: number): number;\n\n /**\n * Returns the arctangent of the quotient of its arguments.\n * @param y A number\n * @param x A number\n */\n //% shim=Math_::atan2\n //% help=math/trigonometry\n function atan2(y: number, x: number): number;\n\n /**\n * Returns the square root of a number.\n * @param x A numeric expression.\n */\n //% shim=Math_::sqrt\n //% help=math\n function sqrt(x: number): number;\n\n /**\n * Returns the smallest number greater than or equal to its numeric argument.\n * @param x A numeric expression.\n */\n //% shim=Math_::ceil\n //% help=math\n function ceil(x: number): number;\n\n /**\n * Returns the greatest number less than or equal to its numeric argument.\n * @param x A numeric expression.\n */\n //% shim=Math_::floor\n //% help=math\n function floor(x: number): number;\n\n /**\n * Returns the number with the decimal part truncated.\n * @param x A numeric expression.\n */\n //% shim=Math_::trunc\n //% help=math\n function trunc(x: number): number;\n\n /**\n * Returns a supplied numeric expression rounded to the nearest number.\n * @param x The value to be rounded to the nearest number.\n */\n //% shim=Math_::round\n //% help=math\n function round(x: number): number;\n\n /**\n * Returns the value of integer signed 32 bit multiplication of two numbers.\n * @param x The first number\n * @param y The second number\n */\n //% shim=Math_::imul\n //% help=math\n function imul(x: number, y: number): number;\n\n /**\n * Returns the value of integer signed 32 bit division of two numbers.\n * @param x The first number\n * @param y The second number\n */\n //% shim=Math_::idiv\n //% help=math\n function idiv(x: number, y: number): number;\n}\n\ndeclare namespace control {\n //% shim=_control::_onCodeStart\n export function _onCodeStart(arg: any): void;\n\n //% shim=_control::_onCodeStop\n export function _onCodeStop(arg: any): void;\n}",
"pxt-helpers.ts": "type Action = () => void;\n\n/**\n * Constant representing Not-A-Number.\n */\nconst NaN = 0 / 0\n\n/**\n * Constant representing positive infinity.\n */\nconst Infinity = 1 / 0\n\nfunction isNaN(x: number) {\n x = +x // convert to number\n return x !== x\n}\n\nnamespace Number {\n /**\n * Check if a given value is of type Number and it is a NaN.\n */\n export function isNaN(x: any): boolean {\n return typeof x == \"number\" && x !== x\n }\n}\n\n/**\n * A dictionary from string key to string values\n */\ninterface StringMap {\n [index: string]: string;\n}\n\n/**\n * Convert a string to an integer.\n * @param text A string to convert into an integral number. eg: \"123\"\n * @param radix optional A value between 2 and 36 that specifies the base of the number in text.\n * If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal.\n * All other strings are considered decimal.\n */\n//% help=text/parse-int\n//% blockId=\"string_parseint\" block=\"parse to integer %text\" blockNamespace=\"text\"\n//% text.defl=\"123\"\n//% blockHidden=1\nfunction parseInt(text: string, radix?: number): number {\n // roughly based on https://www.ecma-international.org/ecma-262/5.1/#sec-15.1.2.2\n // with some consideration for avoiding unnecessary slices where easy\n if (!text || (radix != null && (radix < 2 || radix > 36)))\n return NaN;\n\n let start = 0;\n while (start < text.length && helpers.isWhitespace(text.charCodeAt(start)))\n ++start;\n\n if (start === text.length)\n return NaN;\n\n const numberOffset = 48; // 0\n const numCount = 10;\n const letterOffset = 97; // a\n const letterCount = 26;\n const lowerCaseMask = 0x20;\n\n let sign = 1;\n switch (text.charAt(start)) {\n case \"-\":\n sign = -1;\n // fallthrough\n case \"+\":\n ++start;\n }\n\n if ((!radix || radix == 16)\n && \"0\" === text[start]\n && (\"x\" === text[start + 1] || \"X\" === text[start + 1])) {\n radix = 16;\n start += 2;\n } else if (!radix) {\n radix = 10;\n }\n\n let output = 0;\n let hasDigit = false;\n for (let i = start; i < text.length; ++i) {\n const code = text.charCodeAt(i) | lowerCaseMask;\n let val: number = undefined;\n\n if (code >= numberOffset && code < numberOffset + numCount)\n val = code - numberOffset;\n else if (code >= letterOffset && code < letterOffset + letterCount)\n val = numCount + code - letterOffset;\n\n if (val == undefined || val >= radix) {\n if (!hasDigit) {\n return NaN;\n }\n break;\n }\n hasDigit = true;\n output = output * radix + val;\n }\n\n return sign * output;\n}\n\nnamespace helpers {\n export function arrayFill(O: T[], value: T, start?: number, end?: number) {\n // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/fill\n // Steps 3-5.\n const len = O.length >>> 0;\n\n // Steps 6-7.\n const relativeStart = start === undefined ? 0 : start >> 0;\n\n // Step 8.\n let k = relativeStart < 0 ?\n Math.max(len + relativeStart, 0) :\n Math.min(relativeStart, len);\n\n // Steps 9-10.\n const relativeEnd = end === undefined ? len : end >> 0;\n\n // Step 11.\n const final = relativeEnd < 0 ?\n Math.max(len + relativeEnd, 0) :\n Math.min(relativeEnd, len);\n\n // Step 12.\n while (k < final) {\n O[k] = value;\n k++;\n }\n\n // Step 13.\n return O;\n }\n\n export function arraySplice(arr: T[], start: number, len: number) {\n if (start < 0) {\n return;\n }\n for (let i = 0; i < len; ++i) {\n arr.removeAt(start)\n }\n }\n\n export function arrayReverse(arr: T[]): void {\n let len = arr.length;\n for (let i = 0; i < len / 2; i++) {\n swap(arr, i, len - i - 1);\n }\n }\n\n export function arrayShift(arr: T[]): T {\n return arr.removeAt(0);\n }\n\n export function arrayJoin(arr: T[], sep?: string): string {\n if (sep === undefined || sep === null) {\n sep = \",\";\n }\n\n let r = \"\";\n let len = arr.length // caching this seems to match V8\n for (let i = 0; i < len; ++i) {\n if (i > 0 && sep)\n r += sep;\n r += (arr[i] === undefined || arr[i] === null) ? \"\" : arr[i];\n }\n return r;\n }\n\n /*TODO: Enable this multiple value unshift, after rest is enabled in our compiler.\n export function arrayUnshift(arr: T[], ...values: T[]) : number {\n for(let i = values.length; i > 0; --i) {\n arr.insertAt(0, values[i - 1]);\n }\n return arr.length;\n }\n */\n export function arrayUnshift(arr: T[], value: T): number {\n arr.insertAt(0, value);\n return arr.length;\n }\n\n function swap(arr: T[], i: number, j: number): void {\n let temp: T = arr[i];\n arr[i] = arr[j];\n arr[j] = temp;\n }\n\n function sortHelper(arr: T[], callbackfn?: (value1: T, value2: T) => number): T[] {\n if (arr.length <= 0 || !callbackfn) {\n return arr;\n }\n let len = arr.length;\n // simple selection sort.\n for (let i = 0; i < len - 1; ++i) {\n for (let j = i + 1; j < len; ++j) {\n if (callbackfn(arr[i], arr[j]) > 0) {\n swap(arr, i, j);\n }\n }\n }\n return arr;\n }\n\n export function arraySort(arr: T[], callbackfn?: (value1: T, value2: T) => number): T[] {\n if (!callbackfn && arr.length > 1) {\n callbackfn = (a, b) => {\n // default is sort as if the element were a string, with null < undefined\n const aIsUndef = a === undefined;\n const bIsUndef = b === undefined;\n if (aIsUndef && bIsUndef) return 0;\n else if (aIsUndef) return 1;\n else if (bIsUndef) return -1;\n\n const aIsNull = a === null;\n const bIsNull = b === null;\n if (aIsNull && bIsNull) return 0;\n else if (aIsNull) return 1;\n else if (bIsNull) return -1;\n\n return (a + \"\").compare(b + \"\");\n }\n }\n return sortHelper(arr, callbackfn);\n }\n\n export function arrayMap(arr: T[], callbackfn: (value: T, index: number) => U): U[] {\n let res: U[] = []\n let len = arr.length // caching this seems to match V8\n for (let i = 0; i < len; ++i) {\n res.push(callbackfn(arr[i], i))\n }\n return res\n }\n\n export function arraySome(arr: T[], callbackfn: (value: T, index: number) => boolean): boolean {\n let len = arr.length // caching this seems to match V8\n for (let i = 0; i < len; ++i)\n if (callbackfn(arr[i], i))\n return true;\n return false;\n }\n\n export function arrayEvery(arr: T[], callbackfn: (value: T, index: number) => boolean): boolean {\n let len = arr.length // caching this seems to match V8\n for (let i = 0; i < len; ++i)\n if (!callbackfn(arr[i], i))\n return false;\n return true;\n }\n\n export function arrayForEach(arr: T[], callbackfn: (value: T, index: number) => void): void {\n let len = arr.length // caching this seems to match V8\n for (let i = 0; i < len; ++i) {\n callbackfn(arr[i], i);\n }\n }\n\n export function arrayFilter(arr: T[], callbackfn: (value: T, index: number) => boolean): T[] {\n let res: T[] = []\n let len = arr.length\n for (let i = 0; i < len; ++i) {\n let v = arr[i] // need to cache\n if (callbackfn(v, i)) res.push(v)\n }\n return res\n }\n\n export function arrayFind(arr: T[], callbackfn: (value: T, index: number) => boolean): T {\n let len = arr.length\n for (let i = 0; i < len; ++i) {\n let v = arr[i] // need to cache\n if (callbackfn(v, i)) return v;\n }\n return undefined;\n }\n\n export function arrayReduce(arr: T[], callbackfn: (previousValue: U, currentValue: T, currentIndex: number) => U, initialValue: U): U {\n let len = arr.length\n for (let i = 0; i < len; ++i) {\n initialValue = callbackfn(initialValue, arr[i], i)\n }\n return initialValue\n }\n\n export function arrayConcat(arr: T[], otherArr: T[]): T[] {\n let out: T[] = [];\n for (let value of arr) {\n out.push(value);\n }\n for (let value of otherArr) {\n out.push(value);\n }\n return out;\n }\n\n export function arrayPickRandom(arr: T[]): T {\n return arr[Math.randomRange(0, arr.length - 1)];\n }\n\n export function arraySlice(arr: T[], start?: number, end?: number): T[] {\n // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/slice\n const res: T[] = [];\n const len = arr.length;\n\n if (start === undefined)\n start = 0;\n else if (start < 0)\n start = Math.max(len + start, 0);\n\n if (start > len)\n return res;\n\n if (end === undefined)\n end = len;\n else if (end < 0)\n end = len + end;\n\n if (end > len)\n end = len;\n\n for (let i = start; i < end; ++i) {\n res.push(arr[i]);\n }\n return res;\n }\n\n export function stringReplace(s: string, toReplace: string, replacer: string | ((sub: string) => string)) {\n toReplace = toReplace + \"\";\n const ind = s.indexOf(toReplace);\n if (ind == -1)\n return s;\n\n const begin = s.slice(0, ind);\n const end = s.slice(ind + toReplace.length);\n\n if (typeof replacer == \"string\" || !replacer) {\n return begin + replacer + end;\n } else {\n return begin + replacer(toReplace) + end;\n }\n }\n\n export function stringReplaceAll(s: string, toReplace: string, replacer: string | ((sub: string) => string)) {\n toReplace = toReplace + \"\";\n const split = s.split(toReplace);\n const empty = toReplace.isEmpty();\n\n let output = (empty ? applyReplace(toReplace, replacer) : \"\");\n\n if (split.length) {\n output += split[0];\n }\n\n for (let i = 1; i < split.length; ++i) {\n output += applyReplace(toReplace, replacer) + split[i];\n }\n\n if (!s.isEmpty() && empty) {\n output += applyReplace(toReplace, replacer);\n }\n\n return output;\n\n function applyReplace(r: string, replacer: string | ((sub: string) => string)): string {\n if (typeof replacer == \"string\" || !replacer) {\n return replacer as string;\n } else {\n return replacer(r);\n }\n }\n }\n\n //% shim=String_::substr\n declare function stringSubstrHelper(s: string, start: number, length?: number): string;\n\n export function stringSubstr(s: string, start: number, length?: number): string {\n length = length === undefined ? s.length : length || 0;\n return stringSubstrHelper(s, start, length);\n }\n\n export function stringSlice(s: string, start: number, end?: number): string {\n const len = s.length;\n\n if (start < 0) {\n start = Math.max(len + start, 0);\n }\n\n if (end === undefined) {\n end = len;\n } else if (end === null) {\n end = 0;\n }\n\n if (end < 0) {\n end = len + end;\n }\n\n return stringSubstrHelper(s, start, end - start);\n }\n\n // also note this doesn't handle unicode, but neither does JS (there's toLocaleUpperCase())\n export function stringToUpperCase(s: string): string {\n let r = \"\"\n let prev = 0\n for (let i = 0; i < s.length; i++) {\n const c = s.charCodeAt(i)\n if (97 <= c && c <= 122) {\n r += s.slice(prev, i) + String.fromCharCode(c - 32)\n prev = i + 1\n }\n }\n r += s.slice(prev)\n return r\n }\n\n // also note this doesn't handle unicode, but neither does JS (there's toLocaleLowerCase())\n export function stringToLowerCase(s: string): string {\n let r = \"\"\n let prev = 0\n for (let i = 0; i < s.length; i++) {\n const c = s.charCodeAt(i)\n if (65 <= c && c <= 90) {\n r += s.slice(prev, i) + String.fromCharCode(c + 32)\n prev = i + 1\n }\n }\n r += s.slice(prev)\n return r\n }\n\n export function stringSplit(S: string, separator?: string, limit?: number): string[] {\n // https://www.ecma-international.org/ecma-262/6.0/#sec-string.prototype.split\n const A: string[] = [];\n let lim = 0;\n if (limit === undefined)\n lim = (1 << 29) - 1; // spec says 1 << 53, leaving it at 29 for constant folding\n else if (limit < 0)\n lim = 0;\n else\n lim = limit | 0;\n const s = S.length;\n let p = 0;\n const R = separator;\n if (lim == 0)\n return A;\n if (separator === undefined) {\n A[0] = S;\n return A;\n }\n if (s == 0) {\n let z = splitMatch(S, 0, R);\n if (z > -1) return A;\n A[0] = S;\n return A;\n }\n let T: string;\n let q = p;\n while (q != s) {\n let e = splitMatch(S, q, R);\n if (e < 0) q++;\n else {\n if (e == p) q++;\n else {\n T = stringSlice(S, p, q);\n A.push(T);\n if (A.length == lim) return A;\n p = e;\n q = p;\n }\n }\n }\n T = stringSlice(S, p, q);\n A.push(T);\n return A;\n }\n\n function splitMatch(S: string, q: number, R: string): number {\n const r = R.length;\n const s = S.length;\n if (q + r > s) return -1;\n for (let i = 0; i < r; ++i) {\n if (S[q + i] != R[i])\n return -1;\n }\n return q + r;\n }\n\n export function stringTrim(s: string): string {\n let start = 0;\n let end = s.length - 1;\n\n while (start <= end && isWhitespace(s.charCodeAt(start)))\n ++start;\n\n while (end > start && isWhitespace(s.charCodeAt(end)))\n --end;\n return s.slice(start, end + 1);\n }\n\n export function isWhitespace(c: number): boolean {\n // https://www.ecma-international.org/ecma-262/6.0/#sec-white-space\n switch (c) {\n case 0x0009: // character tab\n case 0x000B: // line tab\n case 0x000C: // form feed\n case 0x0020: // space\n case 0x00A0: // no-break space\n case 0xFEFF: // zero width no break space\n case 0x000A: // line feed\n case 0x000D: // carriage return\n case 0x2028: // line separator\n case 0x2029: // paragraph separator\n return true;\n default:\n return false;\n }\n }\n\n export function stringEmpty(S: string): boolean {\n return !S;\n }\n}\n\nnamespace Math {\n export function clamp(min: number, max: number, value: number): number {\n return Math.min(max, Math.max(min, value));\n }\n\n /**\n * Returns the absolute value of a number (the value without regard to whether it is positive or negative).\n * For example, the absolute value of -5 is the same as the absolute value of 5.\n * @param x A numeric expression for which the absolute value is needed.\n */\n //% help=math/abs\n export function abs(x: number): number {\n return x < 0 ? -x : x;\n }\n\n /**\n * Returns the sign of the x, indicating whether x is positive, negative or zero.\n * @param x The numeric expression to test\n */\n export function sign(x: number): number {\n if (x == 0) return 0;\n if (x > 0) return 1;\n return -1;\n }\n\n /**\n * Returns the larger of two supplied numeric expressions.\n */\n //% help=math/max\n export function max(a: number, b: number): number {\n if (a >= b) return a;\n return b;\n }\n\n /**\n * Returns the smaller of two supplied numeric expressions.\n */\n //% help=math/min\n export function min(a: number, b: number): number {\n if (a <= b) return a;\n return b;\n }\n\n /**\n * Rounds ``x`` to a number with the given number of ``digits``\n * @param x the number to round\n * @param digits the number of resulting digits\n */\n //%\n export function roundWithPrecision(x: number, digits: number): number {\n digits = digits | 0;\n // invalid digits input\n if (digits <= 0) return Math.round(x);\n if (x == 0) return 0;\n let r = 0;\n do {\n const d = Math.pow(10, digits);\n r = Math.round(x * d) / d;\n digits++;\n } while (r == 0 && digits < 21);\n return r;\n }\n}\n\n\n//% blockHidden=1\nnamespace __internal {\n /**\n * A shim to render a boolean as a down/up toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleDownUp block=\"%down\"\n //% down.fieldEditor=toggledownup\n //% down.fieldOptions.decompileLiterals=true\n export function __downUp(down: boolean): boolean {\n return down;\n }\n\n /**\n * A shim to render a boolean as a up/down toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleUpDown block=\"%up\"\n //% up.fieldEditor=toggleupdown\n //% up.fieldOptions.decompileLiterals=true\n export function __upDown(up: boolean): boolean {\n return up;\n }\n\n /**\n * A shim to render a boolean as a high/low toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleHighLow block=\"%high\"\n //% high.fieldEditor=togglehighlow\n //% high.fieldOptions.decompileLiterals=true\n export function __highLow(high: boolean): boolean {\n return high;\n }\n\n /**\n * A shim to render a boolean as a on/off toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleOnOff block=\"%on\"\n //% on.fieldEditor=toggleonoff\n //% on.fieldOptions.decompileLiterals=true\n export function __onOff(on: boolean): boolean {\n return on;\n }\n\n /**\n * A shim to render a boolean as a yes/no toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleYesNo block=\"%yes\"\n //% yes.fieldEditor=toggleyesno\n //% yes.fieldOptions.decompileLiterals=true\n export function __yesNo(yes: boolean): boolean {\n return yes;\n }\n\n /**\n * A shim to render a boolean as a win/lose toggle\n */\n //% shim=TD_ID blockHidden=1\n //% blockId=toggleWinLose block=\"%win\"\n //% win.fieldEditor=togglewinlose\n //% win.fieldOptions.decompileLiterals=true\n export function __winLose(win: boolean): boolean {\n return win;\n }\n\n /**\n * Get the color wheel field editor\n * @param color color, eg: #ff0000\n */\n //% blockId=colorNumberPicker block=\"%value\"\n //% blockHidden=true\n //% shim=TD_ID colorSecondary=\"#FFFFFF\"\n //% value.fieldEditor=\"colornumber\" value.fieldOptions.decompileLiterals=true\n //% value.defl='#ff0000'\n //% value.fieldOptions.colours='[\"#ff0000\",\"#ff8000\",\"#ffff00\",\"#ff9da5\",\"#00ff00\",\"#b09eff\",\"#00ffff\",\"#007fff\",\"#65471f\",\"#0000ff\",\"#7f00ff\",\"#ff0080\",\"#ff00ff\",\"#ffffff\",\"#999999\",\"#000000\"]'\n //% value.fieldOptions.columns=4 value.fieldOptions.className='rgbColorPicker'\n export function __colorNumberPicker(value: number) {\n return value;\n }\n\n /**\n * Get the color wheel field editor\n * @param value value between 0 to 255 to get a color value, eg: 10\n */\n //% blockId=colorWheelPicker block=\"%value\"\n //% blockHidden=true\n //% shim=TD_ID colorSecondary=\"#FFFFFF\"\n //% value.fieldEditor=\"colorwheel\" value.fieldOptions.decompileLiterals=true\n //% value.fieldOptions.sliderWidth='200'\n //% value.fieldOptions.min=0 value.fieldOptions.max=255\n export function __colorWheelPicker(value: number) {\n return value;\n }\n\n /**\n * Get the color wheel field editor using HSV values\n * @param value value between 0 to 255 to get a color value, eg: 10\n */\n //% blockId=colorWheelHsvPicker block=\"%value\"\n //% blockHidden=true\n //% shim=TD_ID colorSecondary=\"#FFFFFF\"\n //% value.fieldEditor=\"colorwheel\" value.fieldOptions.decompileLiterals=true\n //% value.fieldOptions.sliderWidth='200'\n //% value.fieldOptions.min=0 value.fieldOptions.max=255\n //% value.fieldOptions.channel=hsvfast\n export function __colorWheelHsvPicker(value: number) {\n return value;\n }\n\n /**\n * A speed picker\n * @param speed the speed, eg: 50\n */\n //% blockId=speedPicker block=\"%speed\" shim=TD_ID\n //% speed.fieldEditor=\"speed\" colorSecondary=\"#FFFFFF\"\n //% weight=0 blockHidden=1 speed.fieldOptions.decompileLiterals=1\n export function __speedPicker(speed: number): number {\n return speed;\n }\n\n /**\n * A turn ratio picker\n * @param turnratio the turn ratio, eg: 0\n */\n //% blockId=turnRatioPicker block=\"%turnratio\" shim=TD_ID\n //% turnratio.fieldEditor=\"turnratio\" colorSecondary=\"#FFFFFF\"\n //% weight=0 blockHidden=1 turnRatio.fieldOptions.decompileLiterals=1\n export function __turnRatioPicker(turnratio: number): number {\n return turnratio;\n }\n\n /**\n * A field editor that displays a protractor\n */\n //% blockId=protractorPicker block=\"%angle\"\n //% shim=TD_ID\n //% angle.fieldEditor=protractor\n //% angle.fieldOptions.decompileLiterals=1\n //% colorSecondary=\"#FFFFFF\"\n //% blockHidden=1\n export function __protractor(angle: number) {\n return angle;\n }\n\n /**\n * Get the time field editor\n * @param ms time duration in milliseconds, eg: 500, 1000\n */\n //% blockId=timePicker block=\"%ms\"\n //% blockHidden=true shim=TD_ID\n //% colorSecondary=\"#FFFFFF\"\n //% ms.fieldEditor=\"numberdropdown\" ms.fieldOptions.decompileLiterals=true\n //% ms.fieldOptions.data='[[\"100 ms\", 100], [\"200 ms\", 200], [\"500 ms\", 500], [\"1 second\", 1000], [\"2 seconds\", 2000], [\"5 seconds\", 5000]]'\n export function __timePicker(ms: number): number {\n return ms;\n }\n}\n",
"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",
"pxt.json": "{\n \"name\": \"base\",\n \"description\": \"The base library\",\n \"dependencies\": {},\n \"files\": [\n \"README.md\",\n \"pxt-core.d.ts\",\n \"pxt.cpp\",\n \"gc.cpp\",\n \"configkeys.h\",\n \"pxtbase.h\",\n \"core.cpp\",\n \"advmath.cpp\",\n \"trig.cpp\",\n \"pxt-helpers.ts\",\n \"fixed.ts\",\n \"buffer.cpp\",\n \"buffer.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"loops.cpp\",\n \"math.ts\",\n \"ns.ts\",\n \"control.cpp\",\n \"controlgc.cpp\",\n \"control.ts\",\n \"interval.ts\",\n \"gcstats.ts\",\n \"poll.ts\",\n \"console.ts\",\n \"json.ts\",\n \"templates.ts\",\n \"eventcontext.ts\",\n \"pause.ts\",\n \"forever.ts\",\n \"utfdecoder.ts\",\n \"scheduling.ts\",\n \"controlmessage.ts\",\n \"perfcounters.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"partial\": \"true\",\n \"yotta\": {\n \"config\": {\n \"PXT_POWI\": 1\n }\n }\n}\n",
"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 \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 \n#include \n#include \n\n#ifdef POKY\nvoid *operator new(size_t size, void *ptr);\nvoid *operator new(size_t size);\n#else\n#include \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 inline const T &max(const T &a, const T &b) {\n if (a < b)\n return b;\n return a;\n}\n\ntemplate inline const T &min(const T &a, const T &b) {\n if (a < b)\n return a;\n return b;\n}\n\ntemplate 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 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(v - NanBoxingOffset);\n}\n\n#ifdef PXT64\nSTATIC_ASSERT(sizeof(void *) == 8);\ninline double doubleVal(TValue v) {\n return bitwise_cast((uint64_t)v - NanBoxingOffset);\n}\n\ninline TValue tvalueFromDouble(double d) {\n return (TValue)(bitwise_cast(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 struct BoxedStringLayout {\n const void *vtable;\n uint16_t size;\n const char data[N];\n};\n\ntemplate 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",
"scheduling.ts": "/**\n * Calls a function with a fixed time delay between each call to that function.\n * @param func \n * @param delay \n */\n//%\nfunction setInterval(func: () => void, delay: number): number {\n delay = Math.max(10, delay | 0);\n return control.setInterval(func, delay, control.IntervalMode.Interval);\n}\n\n/**\n * Cancels repeated action which was set up using setInterval().\n * @param intervalId \n */\n//%\nfunction clearInterval(intervalId: number) {\n control.clearInterval(intervalId, control.IntervalMode.Interval);\n}\n\n/**\n * Calls a function after specified delay.\n * @param func \n * @param delay \n */\n//%\nfunction setTimeout(func: () => void, delay: number): number {\n return control.setInterval(func, delay, control.IntervalMode.Timeout);\n}\n\n/**\n * Clears the delay set by setTimeout().\n * @param intervalId \n */\n//%\nfunction clearTimeout(intervalId: number) {\n control.clearInterval(intervalId, control.IntervalMode.Timeout);\n}\n\n/**\n * Calls a function as soon as possible.\n * @param func \n */\n//%\nfunction setImmediate(func: () => void): number {\n return control.setInterval(func, 0, control.IntervalMode.Immediate);\n}\n\n/**\n * Cancels the immediate actions.\n * @param intervalId \n */\n//%\nfunction clearImmediate(intervalId: number) {\n control.clearInterval(intervalId, control.IntervalMode.Immediate);\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\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 loops {\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=loops/forever weight=100 afterOnStart=true deprecated=true\n //% blockId=forever_deprecated block=\"forever\" blockAllowMultiple=1 shim=loops::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=loops/pause weight=99 deprecated=true\n //% async block=\"pause %pause=timePicker|ms\"\n //% blockId=device_pause_deprecated shim=loops::pause\n function pause(ms: int32): void;\n}\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 * Used internally\n */\n //% flags.defl=16 shim=control::internalOnEvent\n function internalOnEvent(src: int32, value: int32, handler: () => void, flags?: int32): void;\n\n /**\n * Reset the device.\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 * Block 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\" shim=control::waitMicros\n function waitMicros(micros: int32): void;\n\n /**\n * Run other code in the parallel.\n */\n //% help=control/run-in-parallel handlerStatement=1\n //% blockId=\"control_run_in_parallel\" block=\"run in parallel\" blockGap=8 shim=control::runInParallel\n function runInParallel(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 * 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 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 //% blockId=\"control_device_long_serial_number\" block=\"device long serial number\" weight=9\n //% help=control/device-long-serial-number shim=control::deviceLongSerialNumber\n function deviceLongSerialNumber(): Buffer;\n\n /**\n *\n */\n //% shim=control::__log\n function __log(prority: int32, text: string): void;\n\n /**\n * Dump internal information about a value.\n */\n //% shim=control::dmesgValue\n function dmesgValue(v: any): 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// Auto-generated. Do not edit. Really.\n",
"templates.ts": "/**\n * Tagged hex literal converter\n */\n//% shim=@hex\nfunction hex(lits: any, ...args: any[]): Buffer { return null }\n",
"test.ts": "let i = 1\nlet f = 0.5\nlet plus = i + f\nlet minus = i - f\n\nlet r = Math.random()\nlet ri = Math.randomRange(5, 10)\n\n\nfunction check(cond:boolean) { control.assert(cond, 108) }\n\ncheck(Buffer.pack(\"<2h\", [0x3412, 0x7856]).toHex() == \"12345678\")\ncheck(Buffer.pack(\">hh\", [0x3412, 0x7856]).toHex() == \"34127856\")\ncheck(Buffer.fromHex(\"F00d\").toHex() == \"f00d\")",
"trig.cpp": "// skip",
"utfdecoder.ts": "class UTF8Decoder {\n private buf: Buffer;\n\n constructor() {\n this.buf = undefined;\n }\n\n add(buf: Buffer) {\n if (!buf || !buf.length) return;\n\n if (!this.buf)\n this.buf = buf;\n else {\n const b = control.createBuffer(this.buf.length + buf.length);\n b.write(0, this.buf);\n b.write(this.buf.length, buf);\n this.buf = b;\n }\n }\n\n decodeUntil(delimiter: number): string {\n if (!this.buf) return undefined;\n delimiter = delimiter | 0;\n let i = 0;\n for (; i < this.buf.length; ++i) {\n const c = this.buf[i];\n // skip multi-chars\n if ((c & 0xe0) == 0xc0)\n i += 1;\n else if ((c & 0xf0) == 0xe0)\n i += 2;\n else if (c == delimiter) {\n // found it\n break;\n }\n }\n\n if (i >= this.buf.length)\n return undefined;\n else {\n const s = this.buf.slice(0, i).toString();\n if (i + 1 == this.buf.length)\n this.buf = undefined;\n else\n this.buf = this.buf.slice(i + 1);\n return s;\n }\n }\n\n decode(): string {\n if (!this.buf) return \"\";\n\n // scan the end of the buffer for partial characters\n let length = 0;\n for (let i = this.buf.length - 1; i >= 0; i--) {\n const c = this.buf[i];\n if ((c & 0x80) == 0) {\n length = i + 1;\n break;\n }\n else if ((c & 0xe0) == 0xc0) {\n length = i + 2;\n break;\n }\n else if ((c & 0xf0) == 0xe0) {\n length = i + 3;\n break;\n }\n }\n // is last beyond the end?\n if (length == this.buf.length) {\n const s = this.buf.toString();\n this.buf = undefined;\n return s;\n } else if (length == 0) { // data yet\n return \"\";\n } else {\n const s = this.buf.slice(0, length).toString();\n this.buf = this.buf.slice(length);\n return s;\n }\n }\n}"
},
"core": {
"README.md": "# core\n\nThe core library for Codal-based targets.\n\n",
"codal.cpp": "#include \"pxt.h\"\n#include \"LowLevelTimer.h\"\nusing namespace codal;\n\nvoid cpu_clock_init(void);\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#ifdef DEVICE_GET_FIBER_LIST_AVAILABLE\n// newer codal-core has get_fiber_list() but not list_fibers()\nnamespace codal {\n/*\n * Return all current fibers.\n *\n * @param dest If non-null, it points to an array of pointers to fibers to store results in.\n *\n * @return the number of fibers (potentially) stored\n */\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\nnamespace pxt {\n\nvoid platform_init();\nvoid usb_init();\n\n// The first two word are used to tell the bootloader that a single reset should start the\n// bootloader and the MSD device, not us.\n// The rest is reserved for partial flashing checksums.\n__attribute__((section(\".binmeta\"))) __attribute__((used)) const uint32_t pxt_binmeta[] = {\n 0x87eeb07c, 0x87eeb07c, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n};\n\nEvent lastEvent;\nMessageBus devMessageBus;\ncodal::CodalDevice device;\n\nstruct FreeList {\n FreeList *next;\n};\n\nstatic void commInit() {\n int commSize = bytecode[20];\n if (!commSize)\n return;\n\n void *r = app_alloc_at((void *)PXT_COMM_BASE, commSize);\n DMESG(\"comm %d -> %p\", commSize, r);\n if (!r)\n target_panic(20);\n}\n\nstatic void initCodal() {\n cpu_clock_init();\n\n commInit();\n\n // Bring up fiber scheduler.\n scheduler_init(devMessageBus);\n\n // We probably don't need that - components are initialized when one obtains\n // the reference to it.\n // devMessageBus.listen(DEVICE_ID_MESSAGE_BUS_LISTENER, DEVICE_EVT_ANY, this,\n // &CircuitPlayground::onListenerRegisteredEvent);\n\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; i++) {\n if (CodalComponent::components[i])\n CodalComponent::components[i]->init();\n }\n\n usb_init();\n\n auto led = LOOKUP_PIN(LED);\n if (led) {\n led->setDigitalValue(0);\n }\n}\n\n// ---------------------------------------------------------------------------\n// An adapter for the API expected by the run-time.\n// ---------------------------------------------------------------------------\n\n// We have the invariant that if [dispatchEvent] is registered against the DAL\n// for a given event, then [handlersMap] contains a valid entry for that\n// event.\nvoid dispatchEvent(Event e) {\n lastEvent = e;\n\n auto curr = findBinding(e.source, e.value);\n auto value = fromInt(e.value);\n while (curr) {\n runAction1(curr->action, value);\n curr = nextBinding(curr->next, e.source, e.value);\n }\n}\n\nvoid registerWithDal(int id, int event, Action a, int flags) {\n // first time?\n if (!findBinding(id, event)) {\n devMessageBus.listen(id, event, dispatchEvent, flags);\n if (event == 0) {\n // we're registering for all events on given ID\n // need to remove old listeners for specific events\n auto curr = findBinding(id, -1);\n while (curr) {\n devMessageBus.ignore(id, curr->value, dispatchEvent);\n curr = nextBinding(curr->next, id, -1);\n }\n }\n }\n setBinding(id, event, a);\n}\n\nvoid fiberDone(void *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 target_wait_us(us);\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 registerGCPtr(a);\n create_fiber(forever_stub, (void *)a);\n }\n}\n\nvoid runInParallel(Action a) {\n if (a != 0) {\n registerGCPtr(a);\n create_fiber((void (*)(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 initSystemTimer();\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\nuint64_t getLongSerialNumber() {\n return device.getSerialNumber();\n}\n\nint current_time_ms() {\n return system_timer_current_time();\n}\n\nuint64_t current_time_us() {\n return system_timer_current_time_us();\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\nstatic void *threadAddressFor(codal::Fiber *fib, void *sp) {\n if (fib == currentFiber)\n return sp;\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 int numFibers = codal::list_fibers(NULL);\n codal::Fiber **fibers = (codal::Fiber **)xmalloc(sizeof(codal::Fiber *) * numFibers);\n int num2 = codal::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 gcProcess(ctx->thrownValue);\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 xfree(fibers);\n}\n\nLowLevelTimer *getJACDACTimer() {\n static LowLevelTimer *jacdacTimer;\n if (!jacdacTimer) {\n jacdacTimer = allocateTimer();\n jacdacTimer->setIRQPriority(1);\n }\n return jacdacTimer;\n}\nvoid initSystemTimer() {\n new CODAL_TIMER(*allocateTimer());\n}\n\n} // namespace pxt\n",
"control.cpp": "#include \"pxt.h\"\n\n#if defined(NRF52_SERIES) || defined(PICO_BOARD)\n#define _estack __StackTop \n#endif\nextern uint32_t _estack;\n\nnamespace control {\n\n/**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n//% weight=21 blockGap=12 blockId=\"control_raise_event\"\n//% help=control/raise-event\n//% block=\"raise event|from %src|with value %value\" blockExternalInputs=1\nvoid raiseEvent(int src, int value) {\n Event evt(src, value);\n}\n\n/**\n* Determine the version of system software currently running.\n*/\n//% blockId=\"control_device_dal_version\" block=\"device dal version\"\n//% help=control/device-dal-version\nString deviceDalVersion() {\n return mkString(device.getVersion());\n}\n\n/**\n* Allocates the next user notification event\n*/\n//% help=control/allocate-notify-event\nint allocateNotifyEvent() {\n return ::allocateNotifyEvent();\n}\n\n/** Write a message to DMESG debugging buffer. */\n//%\nvoid dmesg(String s) {\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 DMESG(\"# %s: %p\", str->getUTF8Data(), ptr);\n}\n\n//%\nuint32_t _ramSize()\n{\n return (uint32_t)&_estack & 0x1fffffff;\n}\n\n}\n",
"dal.d.ts": "// Auto-generated. Do not edit.\ndeclare const enum DAL {\n // /libraries/codal-core/inc/JACDAC/JDPhysicalLayer.h\n Receiving = 0,\n Transmitting = 1,\n Error = 2,\n Unknown = 3,\n ListeningForPulse = 0,\n ErrorRecovery = 1,\n Off = 2,\n Continuation = 0,\n // /libraries/codal-core/inc/JACDAC/JDServiceClasses.h\n STATIC_CLASS_START = 0,\n STATIC_CLASS_END = 16777215,\n DYNAMIC_CLASS_END = 4294967295,\n // /libraries/codal-core/inc/core/CodalComponent.h\n DEVICE_ID_BUTTON_A = 1,\n DEVICE_ID_BUTTON_B = 2,\n DEVICE_ID_BUTTON_AB = 3,\n DEVICE_ID_BUTTON_RESET = 4,\n DEVICE_ID_ACCELEROMETER = 5,\n DEVICE_ID_COMPASS = 6,\n DEVICE_ID_DISPLAY = 7,\n DEVICE_ID_THERMOMETER = 8,\n DEVICE_ID_RADIO = 9,\n DEVICE_ID_RADIO_DATA_READY = 10,\n DEVICE_ID_MULTIBUTTON_ATTACH = 11,\n DEVICE_ID_SERIAL = 12,\n DEVICE_ID_GESTURE = 13,\n DEVICE_ID_SYSTEM_TIMER = 14,\n DEVICE_ID_SCHEDULER = 15,\n DEVICE_ID_COMPONENT = 16,\n DEVICE_ID_LIGHT_SENSOR = 17,\n DEVICE_ID_TOUCH_SENSOR = 18,\n DEVICE_ID_SYSTEM_DAC = 19,\n DEVICE_ID_SYSTEM_MICROPHONE = 20,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR = 21,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR_SPL = 22,\n DEVICE_ID_MSC = 23,\n DEVICE_ID_SPI = 24,\n DEVICE_ID_DISTANCE = 25,\n DEVICE_ID_GYROSCOPE = 26,\n DEVICE_ID_HUMIDITY = 27,\n DEVICE_ID_PRESSURE = 28,\n DEVICE_ID_SINGLE_WIRE_SERIAL = 29,\n DEVICE_ID_JACDAC = 30,\n DEVICE_ID_JACDAC_PHYS = 31,\n DEVICE_ID_JACDAC_CONTROL_SERVICE = 32,\n DEVICE_ID_JACDAC_CONFIGURATION_SERVICE = 33,\n DEVICE_ID_IO_P0 = 100,\n DEVICE_ID_MESSAGE_BUS_LISTENER = 1021,\n DEVICE_ID_NOTIFY_ONE = 1022,\n DEVICE_ID_NOTIFY = 1023,\n DEVICE_ID_BUTTON_UP = 2000,\n DEVICE_ID_BUTTON_DOWN = 2001,\n DEVICE_ID_BUTTON_LEFT = 2002,\n DEVICE_ID_BUTTON_RIGHT = 2003,\n DEVICE_ID_JD_DYNAMIC_ID = 3000,\n DEVICE_COMPONENT_RUNNING = 4096,\n DEVICE_COMPONENT_STATUS_SYSTEM_TICK = 8192,\n DEVICE_COMPONENT_STATUS_IDLE_TICK = 16384,\n DEVICE_COMPONENT_LISTENERS_CONFIGURED = 1,\n DEVICE_COMPONENT_EVT_SYSTEM_TICK = 1,\n // /libraries/codal-core/inc/core/CodalFiber.h\n DEVICE_SCHEDULER_RUNNING = 1,\n DEVICE_SCHEDULER_IDLE = 2,\n DEVICE_FIBER_FLAG_FOB = 1,\n DEVICE_FIBER_FLAG_PARENT = 2,\n DEVICE_FIBER_FLAG_CHILD = 4,\n DEVICE_FIBER_FLAG_DO_NOT_PAGE = 8,\n DEVICE_SCHEDULER_EVT_TICK = 1,\n DEVICE_SCHEDULER_EVT_IDLE = 2,\n // /libraries/codal-core/inc/core/CodalListener.h\n MESSAGE_BUS_LISTENER_PARAMETERISED = 1,\n MESSAGE_BUS_LISTENER_METHOD = 2,\n MESSAGE_BUS_LISTENER_BUSY = 4,\n MESSAGE_BUS_LISTENER_REENTRANT = 8,\n MESSAGE_BUS_LISTENER_QUEUE_IF_BUSY = 16,\n MESSAGE_BUS_LISTENER_DROP_IF_BUSY = 32,\n MESSAGE_BUS_LISTENER_NONBLOCKING = 64,\n MESSAGE_BUS_LISTENER_URGENT = 128,\n MESSAGE_BUS_LISTENER_DELETING = 32768,\n MESSAGE_BUS_LISTENER_IMMEDIATE = 192,\n // /libraries/codal-core/inc/core/ErrorNo.h\n DEVICE_OK = 0,\n DEVICE_INVALID_PARAMETER = -1001,\n DEVICE_NOT_SUPPORTED = -1002,\n DEVICE_CALIBRATION_IN_PROGRESS = -1003,\n DEVICE_CALIBRATION_REQUIRED = -1004,\n DEVICE_NO_RESOURCES = -1005,\n DEVICE_BUSY = -1006,\n DEVICE_CANCELLED = -1007,\n DEVICE_I2C_ERROR = -1010,\n DEVICE_SERIAL_IN_USE = -1011,\n DEVICE_NO_DATA = -1012,\n DEVICE_NOT_IMPLEMENTED = -1013,\n DEVICE_SPI_ERROR = -1014,\n DEVICE_INVALID_STATE = -1015,\n DEVICE_OOM = 20,\n DEVICE_HEAP_ERROR = 30,\n DEVICE_NULL_DEREFERENCE = 40,\n DEVICE_USB_ERROR = 50,\n DEVICE_JACDAC_ERROR = 60,\n DEVICE_HARDWARE_CONFIGURATION_ERROR = 90,\n // /libraries/codal-core/inc/core/NotifyEvents.h\n DISPLAY_EVT_FREE = 1,\n CODAL_SERIAL_EVT_TX_EMPTY = 2,\n BLE_EVT_SERIAL_TX_EMPTY = 3,\n ARCADE_PLAYER_JOIN_RESULT = 4,\n DEVICE_NOTIFY_USER_EVENT_BASE = 1024,\n // /libraries/codal-core/inc/driver-models/AbstractButton.h\n DEVICE_BUTTON_EVT_DOWN = 1,\n DEVICE_BUTTON_EVT_UP = 2,\n DEVICE_BUTTON_EVT_CLICK = 3,\n DEVICE_BUTTON_EVT_LONG_CLICK = 4,\n DEVICE_BUTTON_EVT_HOLD = 5,\n DEVICE_BUTTON_EVT_DOUBLE_CLICK = 6,\n DEVICE_BUTTON_LONG_CLICK_TIME = 1000,\n DEVICE_BUTTON_HOLD_TIME = 1500,\n DEVICE_BUTTON_STATE = 1,\n DEVICE_BUTTON_STATE_HOLD_TRIGGERED = 2,\n DEVICE_BUTTON_STATE_CLICK = 4,\n DEVICE_BUTTON_STATE_LONG_CLICK = 8,\n DEVICE_BUTTON_SIGMA_MIN = 0,\n DEVICE_BUTTON_SIGMA_MAX = 12,\n DEVICE_BUTTON_SIGMA_THRESH_HI = 8,\n DEVICE_BUTTON_SIGMA_THRESH_LO = 2,\n DEVICE_BUTTON_DOUBLE_CLICK_THRESH = 50,\n DEVICE_BUTTON_SIMPLE_EVENTS = 0,\n DEVICE_BUTTON_ALL_EVENTS = 1,\n ACTIVE_LOW = 0,\n ACTIVE_HIGH = 1,\n // /libraries/codal-core/inc/driver-models/Accelerometer.h\n ACCELEROMETER_IMU_DATA_VALID = 2,\n ACCELEROMETER_EVT_DATA_UPDATE = 1,\n ACCELEROMETER_EVT_NONE = 0,\n ACCELEROMETER_EVT_TILT_UP = 1,\n ACCELEROMETER_EVT_TILT_DOWN = 2,\n ACCELEROMETER_EVT_TILT_LEFT = 3,\n ACCELEROMETER_EVT_TILT_RIGHT = 4,\n ACCELEROMETER_EVT_FACE_UP = 5,\n ACCELEROMETER_EVT_FACE_DOWN = 6,\n ACCELEROMETER_EVT_FREEFALL = 7,\n ACCELEROMETER_EVT_3G = 8,\n ACCELEROMETER_EVT_6G = 9,\n ACCELEROMETER_EVT_8G = 10,\n ACCELEROMETER_EVT_SHAKE = 11,\n ACCELEROMETER_EVT_2G = 12,\n ACCELEROMETER_REST_TOLERANCE = 200,\n ACCELEROMETER_TILT_TOLERANCE = 200,\n ACCELEROMETER_FREEFALL_TOLERANCE = 400,\n ACCELEROMETER_SHAKE_TOLERANCE = 400,\n ACCELEROMETER_2G_TOLERANCE = 2048,\n ACCELEROMETER_3G_TOLERANCE = 3072,\n ACCELEROMETER_6G_TOLERANCE = 6144,\n ACCELEROMETER_8G_TOLERANCE = 8192,\n ACCELEROMETER_GESTURE_DAMPING = 5,\n ACCELEROMETER_SHAKE_DAMPING = 10,\n ACCELEROMETER_SHAKE_RTX = 30,\n ACCELEROMETER_SHAKE_COUNT_THRESHOLD = 4,\n // /libraries/codal-core/inc/driver-models/Compass.h\n COMPASS_STATUS_RUNNING = 1,\n COMPASS_STATUS_CALIBRATED = 2,\n COMPASS_STATUS_CALIBRATING = 4,\n COMPASS_STATUS_ADDED_TO_IDLE = 8,\n COMPASS_EVT_DATA_UPDATE = 1,\n COMPASS_EVT_CONFIG_NEEDED = 2,\n COMPASS_EVT_CALIBRATE = 3,\n COMPASS_EVT_CALIBRATION_NEEDED = 4,\n // /libraries/codal-core/inc/driver-models/Gyroscope.h\n GYROSCOPE_IMU_DATA_VALID = 2,\n GYROSCOPE_EVT_DATA_UPDATE = 1,\n // /libraries/codal-core/inc/driver-models/LowLevelTimer.h\n TimerModeTimer = 0,\n TimerModeCounter = 1,\n TimerModeAlternateFunction = 2,\n BitMode8 = 0,\n BitMode16 = 1,\n BitMode24 = 2,\n BitMode32 = 3,\n // /libraries/codal-core/inc/driver-models/Pin.h\n IO_STATUS_DIGITAL_IN = 1,\n IO_STATUS_DIGITAL_OUT = 2,\n IO_STATUS_ANALOG_IN = 4,\n IO_STATUS_ANALOG_OUT = 8,\n IO_STATUS_TOUCH_IN = 16,\n IO_STATUS_EVENT_ON_EDGE = 32,\n IO_STATUS_EVENT_PULSE_ON_EDGE = 64,\n IO_STATUS_INTERRUPT_ON_EDGE = 128,\n DEVICE_PIN_MAX_OUTPUT = 1023,\n DEVICE_PIN_MAX_SERVO_RANGE = 180,\n DEVICE_PIN_DEFAULT_SERVO_RANGE = 2000,\n DEVICE_PIN_DEFAULT_SERVO_CENTER = 1500,\n DEVICE_PIN_EVENT_NONE = 0,\n DEVICE_PIN_INTERRUPT_ON_EDGE = 1,\n DEVICE_PIN_EVENT_ON_EDGE = 2,\n DEVICE_PIN_EVENT_ON_PULSE = 3,\n DEVICE_PIN_EVENT_ON_TOUCH = 4,\n DEVICE_PIN_EVT_RISE = 2,\n DEVICE_PIN_EVT_FALL = 3,\n DEVICE_PIN_EVT_PULSE_HI = 4,\n DEVICE_PIN_EVT_PULSE_LO = 5,\n PIN_CAPABILITY_DIGITAL = 1,\n PIN_CAPABILITY_ANALOG = 2,\n PIN_CAPABILITY_AD = 3,\n PIN_CAPABILITY_ALL = 3,\n None = 0,\n Down = 1,\n Up = 2,\n // /libraries/codal-core/inc/driver-models/Radio.h\n RADIO_EVT_DATA_READY = 2,\n // /libraries/codal-core/inc/driver-models/SPIFlash.h\n SPIFLASH_PAGE_SIZE = 256,\n SPIFLASH_SMALL_ROW_PAGES = 16,\n SPIFLASH_BIG_ROW_PAGES = 256,\n // /libraries/codal-core/inc/driver-models/Sensor.h\n SENSOR_THRESHOLD_LOW = 1,\n SENSOR_THRESHOLD_HIGH = 2,\n SENSOR_UPDATE_NEEDED = 3,\n SENSOR_INITIALISED = 1,\n SENSOR_HIGH_THRESHOLD_PASSED = 2,\n SENSOR_LOW_THRESHOLD_PASSED = 4,\n SENSOR_LOW_THRESHOLD_ENABLED = 8,\n SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n SENSOR_DEFAULT_SENSITIVITY = 868,\n SENSOR_DEFAULT_SAMPLE_PERIOD = 500,\n // /libraries/codal-core/inc/driver-models/Serial.h\n CODAL_SERIAL_DEFAULT_BAUD_RATE = 115200,\n CODAL_SERIAL_DEFAULT_BUFFER_SIZE = 20,\n CODAL_SERIAL_EVT_DELIM_MATCH = 1,\n CODAL_SERIAL_EVT_HEAD_MATCH = 2,\n CODAL_SERIAL_EVT_RX_FULL = 3,\n CODAL_SERIAL_EVT_DATA_RECEIVED = 4,\n CODAL_SERIAL_STATUS_RX_IN_USE = 1,\n CODAL_SERIAL_STATUS_TX_IN_USE = 2,\n CODAL_SERIAL_STATUS_RX_BUFF_INIT = 4,\n CODAL_SERIAL_STATUS_TX_BUFF_INIT = 8,\n CODAL_SERIAL_STATUS_RXD = 16,\n ASYNC = 0,\n SYNC_SPINWAIT = 1,\n SYNC_SLEEP = 2,\n RxInterrupt = 0,\n TxInterrupt = 1,\n // /libraries/codal-core/inc/driver-models/SingleWireSerial.h\n SWS_EVT_DATA_RECEIVED = 1,\n SWS_EVT_DATA_SENT = 2,\n SWS_EVT_ERROR = 3,\n SWS_EVT_DATA_DROPPED = 4,\n SingleWireRx = 0,\n SingleWireTx = 1,\n SingleWireDisconnected = 2,\n // /libraries/codal-core/inc/driver-models/Timer.h\n CODAL_TIMER_DEFAULT_EVENT_LIST_SIZE = 10,\n // /libraries/codal-core/inc/drivers/AnalogSensor.h\n ANALOG_THRESHOLD_LOW = 1,\n ANALOG_THRESHOLD_HIGH = 2,\n ANALOG_SENSOR_UPDATE_NEEDED = 3,\n ANALOG_SENSOR_INITIALISED = 1,\n ANALOG_SENSOR_HIGH_THRESHOLD_PASSED = 2,\n ANALOG_SENSOR_LOW_THRESHOLD_PASSED = 4,\n ANALOG_SENSOR_LOW_THRESHOLD_ENABLED = 8,\n ANALOG_SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n // /libraries/codal-core/inc/drivers/AnimatedDisplay.h\n DISPLAY_EVT_ANIMATION_COMPLETE = 1,\n DISPLAY_DEFAULT_AUTOCLEAR = 1,\n DISPLAY_SPACING = 1,\n DISPLAY_ANIMATE_DEFAULT_POS = -255,\n DISPLAY_DEFAULT_SCROLL_SPEED = 120,\n DISPLAY_DEFAULT_SCROLL_STRIDE = -1,\n DISPLAY_DEFAULT_PRINT_SPEED = 400,\n ANIMATION_MODE_NONE = 0,\n ANIMATION_MODE_STOPPED = 1,\n ANIMATION_MODE_SCROLL_TEXT = 2,\n ANIMATION_MODE_PRINT_TEXT = 3,\n ANIMATION_MODE_SCROLL_IMAGE = 4,\n ANIMATION_MODE_ANIMATE_IMAGE = 5,\n ANIMATION_MODE_ANIMATE_IMAGE_WITH_CLEAR = 6,\n ANIMATION_MODE_PRINT_CHARACTER = 7,\n // /libraries/codal-core/inc/drivers/FAT.h\n FAT_RESERVED_SECTORS = 1,\n FAT_ROOT_DIR_SECTORS = 4,\n // /libraries/codal-core/inc/drivers/HID.h\n HID_REQUEST_GET_REPORT = 1,\n HID_REQUEST_GET_IDLE = 2,\n HID_REQUEST_GET_PROTOCOL = 3,\n HID_REQUEST_SET_REPORT = 9,\n HID_REQUEST_SET_IDLE = 10,\n HID_REQUEST_SET_PROTOCOL = 11,\n // /libraries/codal-core/inc/drivers/HIDKeyboard.h\n HID_KEYBOARD_NUM_REPORTS = 3,\n HID_KEYBOARD_REPORT_GENERIC = 1,\n HID_KEYBOARD_REPORT_CONSUMER = 2,\n HID_KEYBOARD_KEYSTATE_SIZE_GENERIC = 8,\n HID_KEYBOARD_KEYSTATE_SIZE_CONSUMER = 2,\n HID_KEYBOARD_MODIFIER_OFFSET = 2,\n HID_KEYBOARD_DELAY_DEFAULT = 10,\n PressKey = 0,\n ReleaseKey = 1,\n // /libraries/codal-core/inc/drivers/KeyMap.h\n KEYMAP_ALL_KEYS_UP_Val = 1,\n KEYMAP_ALL_KEYS_UP_POS = 28,\n KEYMAP_NORMAL_KEY_Val = 0,\n KEYMAP_MODIFIER_KEY_Val = 1,\n KEYMAP_MODIFIER_POS = 29,\n KEYMAP_MEDIA_KEY_Val = 1,\n KEYMAP_MEDIA_POS = 30,\n KEYMAP_KEY_UP_Val = 0,\n KEYMAP_KEY_DOWN_Val = 1,\n KEYMAP_KEY_DOWN_POS = 31,\n // /libraries/codal-core/inc/drivers/KeyValueStorage.h\n DEVICE_KEY_VALUE_STORE_OFFSET = 4,\n KEY_VALUE_STORAGE_MAGIC = 49370,\n KEY_VALUE_STORAGE_BLOCK_SIZE = 48,\n KEY_VALUE_STORAGE_KEY_SIZE = 16,\n KEY_VALUE_STORAGE_SCRATCH_WORD_SIZE = 64,\n KEY_VALUE_STORAGE_MAX_PAIRS = 5,\n // /libraries/codal-core/inc/drivers/LEDMatrix.h\n LED_MATRIX_GREYSCALE_BIT_DEPTH = 8,\n LED_MATRIX_EVT_LIGHT_SENSE = 2,\n LED_MATRIX_EVT_FRAME_TIMEOUT = 3,\n LED_MATRIX_MINIMUM_BRIGHTNESS = 1,\n LED_MATRIX_MAXIMUM_BRIGHTNESS = 255,\n LED_MATRIX_DEFAULT_BRIGHTNESS = 255,\n DISPLAY_MODE_BLACK_AND_WHITE = 0,\n DISPLAY_MODE_GREYSCALE = 1,\n DISPLAY_MODE_BLACK_AND_WHITE_LIGHT_SENSE = 2,\n MATRIX_DISPLAY_ROTATION_0 = 0,\n MATRIX_DISPLAY_ROTATION_90 = 1,\n MATRIX_DISPLAY_ROTATION_180 = 2,\n MATRIX_DISPLAY_ROTATION_270 = 3,\n NO_CONN = 0,\n // /libraries/codal-core/inc/drivers/MMA8653.h\n MICROBIT_ACCEL_PITCH_ROLL_VALID = 2,\n MICROBIT_ACCEL_ADDED_TO_IDLE = 4,\n // /libraries/codal-core/inc/drivers/MultiButton.h\n MULTI_BUTTON_STATE_1 = 1,\n MULTI_BUTTON_STATE_2 = 2,\n MULTI_BUTTON_HOLD_TRIGGERED_1 = 4,\n MULTI_BUTTON_HOLD_TRIGGERED_2 = 8,\n MULTI_BUTTON_SUPRESSED_1 = 16,\n MULTI_BUTTON_SUPRESSED_2 = 32,\n MULTI_BUTTON_ATTACHED = 64,\n // /libraries/codal-core/inc/drivers/TouchButton.h\n TOUCH_BUTTON_CALIBRATION_PERIOD = 10,\n TOUCH_BUTTON_CALIBRATION_LINEAR_OFFSET = 2,\n TOUCH_BUTTON_CALIBRATION_PERCENTAGE_OFFSET = 5,\n TOUCH_BUTTON_CALIBRATING = 16,\n // /libraries/codal-core/inc/drivers/TouchSensor.h\n TOUCH_SENSOR_MAX_BUTTONS = 10,\n TOUCH_SENSOR_SAMPLE_PERIOD = 50,\n TOUCH_SENSE_SAMPLE_MAX = 1000,\n TOUCH_SENSOR_UPDATE_NEEDED = 1,\n // /libraries/codal-core/inc/drivers/USBJACDAC.h\n JACDAC_USB_STATUS_CLEAR_TO_SEND = 2,\n // /libraries/codal-core/inc/drivers/USB_HID_Keys.h\n KEY_MOD_LCTRL = 1,\n KEY_MOD_LSHIFT = 2,\n KEY_MOD_LALT = 4,\n KEY_MOD_LMETA = 8,\n KEY_MOD_RCTRL = 16,\n KEY_MOD_RSHIFT = 32,\n KEY_MOD_RALT = 64,\n KEY_MOD_RMETA = 128,\n KEY_NONE = 0,\n KEY_ERR_OVF = 1,\n KEY_A = 4,\n KEY_B = 5,\n KEY_C = 6,\n KEY_D = 7,\n KEY_E = 8,\n KEY_F = 9,\n KEY_G = 10,\n KEY_H = 11,\n KEY_I = 12,\n KEY_J = 13,\n KEY_K = 14,\n KEY_L = 15,\n KEY_M = 16,\n KEY_N = 17,\n KEY_O = 18,\n KEY_P = 19,\n KEY_Q = 20,\n KEY_R = 21,\n KEY_S = 22,\n KEY_T = 23,\n KEY_U = 24,\n KEY_V = 25,\n KEY_W = 26,\n KEY_X = 27,\n KEY_Y = 28,\n KEY_Z = 29,\n KEY_1 = 30,\n KEY_2 = 31,\n KEY_3 = 32,\n KEY_4 = 33,\n KEY_5 = 34,\n KEY_6 = 35,\n KEY_7 = 36,\n KEY_8 = 37,\n KEY_9 = 38,\n KEY_0 = 39,\n KEY_ENTER = 40,\n KEY_ESC = 41,\n KEY_BACKSPACE = 42,\n KEY_TAB = 43,\n KEY_SPACE = 44,\n KEY_MINUS = 45,\n KEY_EQUAL = 46,\n KEY_LEFTBRACE = 47,\n KEY_RIGHTBRACE = 48,\n KEY_BACKSLASH = 49,\n KEY_HASHTILDE = 50,\n KEY_SEMICOLON = 51,\n KEY_APOSTROPHE = 52,\n KEY_GRAVE = 53,\n KEY_COMMA = 54,\n KEY_DOT = 55,\n KEY_SLASH = 56,\n KEY_CAPSLOCK = 57,\n KEY_F1 = 58,\n KEY_F2 = 59,\n KEY_F3 = 60,\n KEY_F4 = 61,\n KEY_F5 = 62,\n KEY_F6 = 63,\n KEY_F7 = 64,\n KEY_F8 = 65,\n KEY_F9 = 66,\n KEY_F10 = 67,\n KEY_F11 = 68,\n KEY_F12 = 69,\n KEY_SYSRQ = 70,\n KEY_SCROLLLOCK = 71,\n KEY_PAUSE = 72,\n KEY_INSERT = 73,\n KEY_HOME = 74,\n KEY_PAGEUP = 75,\n KEY_DELETE = 76,\n KEY_END = 77,\n KEY_PAGEDOWN = 78,\n KEY_RIGHT = 79,\n KEY_LEFT = 80,\n KEY_DOWN = 81,\n KEY_UP = 82,\n KEY_NUMLOCK = 83,\n KEY_KPSLASH = 84,\n KEY_KPASTERISK = 85,\n KEY_KPMINUS = 86,\n KEY_KPPLUS = 87,\n KEY_KPENTER = 88,\n KEY_KP1 = 89,\n KEY_KP2 = 90,\n KEY_KP3 = 91,\n KEY_KP4 = 92,\n KEY_KP5 = 93,\n KEY_KP6 = 94,\n KEY_KP7 = 95,\n KEY_KP8 = 96,\n KEY_KP9 = 97,\n KEY_KP0 = 98,\n KEY_KPDOT = 99,\n KEY_102ND = 100,\n KEY_COMPOSE = 101,\n KEY_POWER = 102,\n KEY_KPEQUAL = 103,\n KEY_F13 = 104,\n KEY_F14 = 105,\n KEY_F15 = 106,\n KEY_F16 = 107,\n KEY_F17 = 108,\n KEY_F18 = 109,\n KEY_F19 = 110,\n KEY_F20 = 111,\n KEY_F21 = 112,\n KEY_F22 = 113,\n KEY_F23 = 114,\n KEY_F24 = 115,\n KEY_OPEN = 116,\n KEY_HELP = 117,\n KEY_PROPS = 118,\n KEY_FRONT = 119,\n KEY_STOP = 120,\n KEY_AGAIN = 121,\n KEY_UNDO = 122,\n KEY_CUT = 123,\n KEY_COPY = 124,\n KEY_PASTE = 125,\n KEY_FIND = 126,\n KEY_MUTE = 127,\n KEY_VOLUMEUP = 128,\n KEY_VOLUMEDOWN = 129,\n KEY_KPCOMMA = 133,\n KEY_RO = 135,\n KEY_KATAKANAHIRAGANA = 136,\n KEY_YEN = 137,\n KEY_HENKAN = 138,\n KEY_MUHENKAN = 139,\n KEY_KPJPCOMMA = 140,\n KEY_HANGEUL = 144,\n KEY_HANJA = 145,\n KEY_KATAKANA = 146,\n KEY_HIRAGANA = 147,\n KEY_ZENKAKUHANKAKU = 148,\n KEY_KPLEFTPAREN = 182,\n KEY_KPRIGHTPAREN = 183,\n KEY_LEFTCTRL = 224,\n KEY_LEFTSHIFT = 225,\n KEY_LEFTALT = 226,\n KEY_LEFTMETA = 227,\n KEY_RIGHTCTRL = 228,\n KEY_RIGHTSHIFT = 229,\n KEY_RIGHTALT = 230,\n KEY_RIGHTMETA = 231,\n KEY_MEDIA_PLAYPAUSE = 232,\n KEY_MEDIA_STOPCD = 233,\n KEY_MEDIA_PREVIOUSSONG = 234,\n KEY_MEDIA_NEXTSONG = 235,\n KEY_MEDIA_EJECTCD = 236,\n KEY_MEDIA_VOLUMEUP = 237,\n KEY_MEDIA_VOLUMEDOWN = 238,\n KEY_MEDIA_MUTE = 239,\n KEY_MEDIA_WWW = 240,\n KEY_MEDIA_BACK = 241,\n KEY_MEDIA_FORWARD = 242,\n KEY_MEDIA_STOP = 243,\n KEY_MEDIA_FIND = 244,\n KEY_MEDIA_SCROLLUP = 245,\n KEY_MEDIA_SCROLLDOWN = 246,\n KEY_MEDIA_EDIT = 247,\n KEY_MEDIA_SLEEP = 248,\n KEY_MEDIA_COFFEE = 249,\n KEY_MEDIA_REFRESH = 250,\n KEY_MEDIA_CALC = 251,\n // /libraries/codal-core/inc/drivers/uf2format.h\n UF2FORMAT_H = 1,\n APP_START_ADDRESS = 8192,\n UF2_FLAG_NOFLASH = 1,\n // /libraries/codal-core/inc/streams/DataStream.h\n DATASTREAM_MAXIMUM_BUFFERS = 1,\n // /libraries/codal-core/inc/streams/LevelDetector.h\n LEVEL_THRESHOLD_LOW = 1,\n LEVEL_THRESHOLD_HIGH = 2,\n LEVEL_DETECTOR_INITIALISED = 1,\n LEVEL_DETECTOR_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/LevelDetectorSPL.h\n LEVEL_DETECTOR_SPL_INITIALISED = 1,\n LEVEL_DETECTOR_SPL_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_SPL_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_SPL_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/Synthesizer.h\n SYNTHESIZER_SAMPLE_RATE = 44100,\n TONE_WIDTH = 1024,\n // /libraries/codal-core/inc/types/BitmapFont.h\n BITMAP_FONT_WIDTH = 5,\n BITMAP_FONT_HEIGHT = 5,\n BITMAP_FONT_ASCII_START = 32,\n BITMAP_FONT_ASCII_END = 126,\n // /libraries/codal-core/inc/types/CoordinateSystem.h\n COORDINATE_SPACE_ROTATED_0 = 0,\n COORDINATE_SPACE_ROTATED_90 = 1,\n COORDINATE_SPACE_ROTATED_180 = 2,\n COORDINATE_SPACE_ROTATED_270 = 3,\n RAW = 0,\n SIMPLE_CARTESIAN = 1,\n NORTH_EAST_DOWN = 2,\n NORTH_EAST_UP = 3,\n // /libraries/codal-core/inc/types/Event.h\n DEVICE_ID_ANY = 0,\n DEVICE_EVT_ANY = 0,\n CREATE_ONLY = 0,\n CREATE_AND_FIRE = 1,\n DEVICE_EVENT_DEFAULT_LAUNCH_MODE = 1,\n // /libraries/codal-core/inc/types/RefCounted.h\n REF_TAG_STRING = 1,\n REF_TAG_BUFFER = 2,\n REF_TAG_IMAGE = 3,\n REF_TAG_USER = 32,\n // /pxtapp/accelerometer/axis.h\n ACC_SYSTEM = 3,\n ACC_ROTATION = 0,\n // /pxtapp/configkeys.h\n CFG_PIN_NAME_MSK = 65535,\n CFG_PIN_CONFIG_MSK = 4294901760,\n CFG_PIN_CONFIG_ACTIVE_LO = 65536,\n CFG_MAGIC0 = 513675505,\n CFG_MAGIC1 = 539130489,\n CFG_PIN_ACCELEROMETER_INT = 1,\n CFG_PIN_ACCELEROMETER_SCL = 2,\n CFG_PIN_ACCELEROMETER_SDA = 3,\n CFG_PIN_BTN_A = 4,\n CFG_PIN_BTN_B = 5,\n CFG_PIN_BTN_SLIDE = 6,\n CFG_PIN_DOTSTAR_CLOCK = 7,\n CFG_PIN_DOTSTAR_DATA = 8,\n CFG_PIN_FLASH_CS = 9,\n CFG_PIN_FLASH_MISO = 10,\n CFG_PIN_FLASH_MOSI = 11,\n CFG_PIN_FLASH_SCK = 12,\n CFG_PIN_LED = 13,\n CFG_PIN_LIGHT = 14,\n CFG_PIN_MICROPHONE = 15,\n CFG_PIN_MIC_CLOCK = 16,\n CFG_PIN_MIC_DATA = 17,\n CFG_PIN_MISO = 18,\n CFG_PIN_MOSI = 19,\n CFG_PIN_NEOPIXEL = 20,\n CFG_PIN_RX = 21,\n CFG_PIN_RXLED = 22,\n CFG_PIN_SCK = 23,\n CFG_PIN_SCL = 24,\n CFG_PIN_SDA = 25,\n CFG_PIN_SPEAKER_AMP = 26,\n CFG_PIN_TEMPERATURE = 27,\n CFG_PIN_TX = 28,\n CFG_PIN_TXLED = 29,\n CFG_PIN_IR_OUT = 30,\n CFG_PIN_IR_IN = 31,\n CFG_PIN_DISPLAY_SCK = 32,\n CFG_PIN_DISPLAY_MISO = 33,\n CFG_PIN_DISPLAY_MOSI = 34,\n CFG_PIN_DISPLAY_CS = 35,\n CFG_PIN_DISPLAY_DC = 36,\n CFG_DISPLAY_WIDTH = 37,\n CFG_DISPLAY_HEIGHT = 38,\n CFG_DISPLAY_CFG0 = 39,\n CFG_DISPLAY_CFG1 = 40,\n CFG_DISPLAY_CFG2 = 41,\n CFG_DISPLAY_CFG3 = 42,\n CFG_PIN_DISPLAY_RST = 43,\n CFG_PIN_DISPLAY_BL = 44,\n CFG_PIN_SERVO_1 = 45,\n CFG_PIN_SERVO_2 = 46,\n CFG_PIN_BTN_LEFT = 47,\n CFG_PIN_BTN_RIGHT = 48,\n CFG_PIN_BTN_UP = 49,\n CFG_PIN_BTN_DOWN = 50,\n CFG_PIN_BTN_MENU = 51,\n CFG_PIN_LED_R = 52,\n CFG_PIN_LED_G = 53,\n CFG_PIN_LED_B = 54,\n CFG_PIN_LED1 = 55,\n CFG_PIN_LED2 = 56,\n CFG_PIN_LED3 = 57,\n CFG_PIN_LED4 = 58,\n CFG_SPEAKER_VOLUME = 59,\n CFG_PIN_JACK_TX = 60,\n CFG_PIN_JACK_SENSE = 61,\n CFG_PIN_JACK_HPEN = 62,\n CFG_PIN_JACK_BZEN = 63,\n CFG_PIN_JACK_PWREN = 64,\n CFG_PIN_JACK_SND = 65,\n CFG_PIN_JACK_BUSLED = 66,\n CFG_PIN_JACK_COMMLED = 67,\n CFG_PIN_BTN_SOFT_RESET = 69,\n CFG_ACCELEROMETER_TYPE = 70,\n CFG_PIN_BTNMX_LATCH = 71,\n CFG_PIN_BTNMX_CLOCK = 72,\n CFG_PIN_BTNMX_DATA = 73,\n CFG_PIN_BTN_MENU2 = 74,\n CFG_PIN_BATTSENSE = 75,\n CFG_PIN_VIBRATION = 76,\n CFG_PIN_PWREN = 77,\n CFG_DISPLAY_TYPE = 78,\n CFG_PIN_ROTARY_ENCODER_A = 79,\n CFG_PIN_ROTARY_ENCODER_B = 80,\n CFG_ACCELEROMETER_SPACE = 81,\n CFG_PIN_WIFI_MOSI = 82,\n CFG_PIN_WIFI_MISO = 83,\n CFG_PIN_WIFI_SCK = 84,\n CFG_PIN_WIFI_TX = 85,\n CFG_PIN_WIFI_RX = 86,\n CFG_PIN_WIFI_CS = 87,\n CFG_PIN_WIFI_BUSY = 88,\n CFG_PIN_WIFI_RESET = 89,\n CFG_PIN_WIFI_GPIO0 = 90,\n CFG_PIN_WIFI_AT_TX = 91,\n CFG_PIN_WIFI_AT_RX = 92,\n CFG_PIN_USB_POWER = 93,\n ACCELEROMETER_TYPE_LIS3DH = 50,\n ACCELEROMETER_TYPE_LIS3DH_ALT = 48,\n ACCELEROMETER_TYPE_MMA8453 = 56,\n ACCELEROMETER_TYPE_FXOS8700 = 60,\n ACCELEROMETER_TYPE_MMA8653 = 58,\n ACCELEROMETER_TYPE_MSA300 = 76,\n ACCELEROMETER_TYPE_MPU6050 = 104,\n DISPLAY_TYPE_ST7735 = 7735,\n DISPLAY_TYPE_ILI9341 = 9341,\n DISPLAY_TYPE_SMART = 4242,\n CFG_PIN_A0 = 100,\n CFG_PIN_A1 = 101,\n CFG_PIN_A2 = 102,\n CFG_PIN_A3 = 103,\n CFG_PIN_A4 = 104,\n CFG_PIN_A5 = 105,\n CFG_PIN_A6 = 106,\n CFG_PIN_A7 = 107,\n CFG_PIN_A8 = 108,\n CFG_PIN_A9 = 109,\n CFG_PIN_A10 = 110,\n CFG_PIN_A11 = 111,\n CFG_PIN_A12 = 112,\n CFG_PIN_A13 = 113,\n CFG_PIN_A14 = 114,\n CFG_PIN_A15 = 115,\n CFG_PIN_A16 = 116,\n CFG_PIN_A17 = 117,\n CFG_PIN_A18 = 118,\n CFG_PIN_A19 = 119,\n CFG_PIN_A20 = 120,\n CFG_PIN_A21 = 121,\n CFG_PIN_A22 = 122,\n CFG_PIN_A23 = 123,\n CFG_PIN_A24 = 124,\n CFG_PIN_A25 = 125,\n CFG_PIN_A26 = 126,\n CFG_PIN_A27 = 127,\n CFG_PIN_A28 = 128,\n CFG_PIN_A29 = 129,\n CFG_PIN_A30 = 130,\n CFG_PIN_A31 = 131,\n CFG_PIN_D0 = 150,\n CFG_PIN_D1 = 151,\n CFG_PIN_D2 = 152,\n CFG_PIN_D3 = 153,\n CFG_PIN_D4 = 154,\n CFG_PIN_D5 = 155,\n CFG_PIN_D6 = 156,\n CFG_PIN_D7 = 157,\n CFG_PIN_D8 = 158,\n CFG_PIN_D9 = 159,\n CFG_PIN_D10 = 160,\n CFG_PIN_D11 = 161,\n CFG_PIN_D12 = 162,\n CFG_PIN_D13 = 163,\n CFG_PIN_D14 = 164,\n CFG_PIN_D15 = 165,\n CFG_PIN_D16 = 166,\n CFG_PIN_D17 = 167,\n CFG_PIN_D18 = 168,\n CFG_PIN_D19 = 169,\n CFG_PIN_D20 = 170,\n CFG_PIN_D21 = 171,\n CFG_PIN_D22 = 172,\n CFG_PIN_D23 = 173,\n CFG_PIN_D24 = 174,\n CFG_PIN_D25 = 175,\n CFG_PIN_D26 = 176,\n CFG_PIN_D27 = 177,\n CFG_PIN_D28 = 178,\n CFG_PIN_D29 = 179,\n CFG_PIN_D30 = 180,\n CFG_PIN_D31 = 181,\n CFG_NUM_NEOPIXELS = 200,\n CFG_NUM_DOTSTARS = 201,\n CFG_DEFAULT_BUTTON_MODE = 202,\n CFG_SWD_ENABLED = 203,\n CFG_FLASH_BYTES = 204,\n CFG_RAM_BYTES = 205,\n CFG_SYSTEM_HEAP_BYTES = 206,\n CFG_LOW_MEM_SIMULATION_KB = 207,\n CFG_BOOTLOADER_BOARD_ID = 208,\n CFG_UF2_FAMILY = 209,\n CFG_PINS_PORT_SIZE = 210,\n CFG_BOOTLOADER_PROTECTION = 211,\n CFG_POWER_DEEPSLEEP_TIMEOUT = 212,\n CFG_ANALOG_BUTTON_THRESHOLD = 213,\n CFG_CPU_MHZ = 214,\n CFG_CONTROLLER_LIGHT_MAX_BRIGHTNESS = 215,\n CFG_ANALOG_JOYSTICK_MIN = 216,\n CFG_ANALOG_JOYSTICK_MAX = 217,\n CFG_TIMERS_TO_USE = 218,\n CFG_PIN_ONBOARD_DOTSTAR_CLOCK = 219,\n CFG_PIN_ONBOARD_DOTSTAR_DATA = 220,\n CFG_NUM_ONBOARD_DOTSTARS = 221,\n CFG_PIN_ONBOARD_NEOPIXEL = 222,\n CFG_NUM_ONBOARD_NEOPIXELS = 223,\n CFG_MATRIX_KEYPAD_MESSAGE_ID = 239,\n CFG_NUM_MATRIX_KEYPAD_ROWS = 240,\n CFG_PIN_MATRIX_KEYPAD_ROW0 = 241,\n CFG_PIN_MATRIX_KEYPAD_ROW1 = 242,\n CFG_PIN_MATRIX_KEYPAD_ROW2 = 243,\n CFG_PIN_MATRIX_KEYPAD_ROW3 = 244,\n CFG_PIN_MATRIX_KEYPAD_ROW4 = 245,\n CFG_PIN_MATRIX_KEYPAD_ROW5 = 246,\n CFG_PIN_MATRIX_KEYPAD_ROW6 = 247,\n CFG_PIN_MATRIX_KEYPAD_ROW7 = 248,\n CFG_NUM_MATRIX_KEYPAD_COLS = 250,\n CFG_PIN_MATRIX_KEYPAD_COL0 = 251,\n CFG_PIN_MATRIX_KEYPAD_COL1 = 252,\n CFG_PIN_MATRIX_KEYPAD_COL2 = 253,\n CFG_PIN_MATRIX_KEYPAD_COL3 = 254,\n CFG_PIN_MATRIX_KEYPAD_COL4 = 255,\n CFG_PIN_MATRIX_KEYPAD_COL5 = 256,\n CFG_PIN_MATRIX_KEYPAD_COL6 = 257,\n CFG_PIN_MATRIX_KEYPAD_COL7 = 258,\n CFG_PIN_B0 = 300,\n CFG_PIN_B1 = 301,\n CFG_PIN_B2 = 302,\n CFG_PIN_B3 = 303,\n CFG_PIN_B4 = 304,\n CFG_PIN_B5 = 305,\n CFG_PIN_B6 = 306,\n CFG_PIN_B7 = 307,\n CFG_PIN_B8 = 308,\n CFG_PIN_B9 = 309,\n CFG_PIN_B10 = 310,\n CFG_PIN_B11 = 311,\n CFG_PIN_B12 = 312,\n CFG_PIN_B13 = 313,\n CFG_PIN_B14 = 314,\n CFG_PIN_B15 = 315,\n CFG_PIN_B16 = 316,\n CFG_PIN_B17 = 317,\n CFG_PIN_B18 = 318,\n CFG_PIN_B19 = 319,\n CFG_PIN_B20 = 320,\n CFG_PIN_B21 = 321,\n CFG_PIN_B22 = 322,\n CFG_PIN_B23 = 323,\n CFG_PIN_B24 = 324,\n CFG_PIN_B25 = 325,\n CFG_PIN_B26 = 326,\n CFG_PIN_B27 = 327,\n CFG_PIN_B28 = 328,\n CFG_PIN_B29 = 329,\n CFG_PIN_B30 = 330,\n CFG_PIN_B31 = 331,\n CFG_PIN_C0 = 350,\n CFG_PIN_C1 = 351,\n CFG_PIN_C2 = 352,\n CFG_PIN_C3 = 353,\n CFG_PIN_C4 = 354,\n CFG_PIN_C5 = 355,\n CFG_PIN_C6 = 356,\n CFG_PIN_C7 = 357,\n CFG_PIN_C8 = 358,\n CFG_PIN_C9 = 359,\n CFG_PIN_C10 = 360,\n CFG_PIN_C11 = 361,\n CFG_PIN_C12 = 362,\n CFG_PIN_C13 = 363,\n CFG_PIN_C14 = 364,\n CFG_PIN_C15 = 365,\n CFG_PIN_C16 = 366,\n CFG_PIN_C17 = 367,\n CFG_PIN_C18 = 368,\n CFG_PIN_C19 = 369,\n CFG_PIN_C20 = 370,\n CFG_PIN_C21 = 371,\n CFG_PIN_C22 = 372,\n CFG_PIN_C23 = 373,\n CFG_PIN_C24 = 374,\n CFG_PIN_C25 = 375,\n CFG_PIN_C26 = 376,\n CFG_PIN_C27 = 377,\n CFG_PIN_C28 = 378,\n CFG_PIN_C29 = 379,\n CFG_PIN_C30 = 380,\n CFG_PIN_C31 = 381,\n CFG_PIN_P0 = 400,\n CFG_PIN_P1 = 401,\n CFG_PIN_P2 = 402,\n CFG_PIN_P3 = 403,\n CFG_PIN_P4 = 404,\n CFG_PIN_P5 = 405,\n CFG_PIN_P6 = 406,\n CFG_PIN_P7 = 407,\n CFG_PIN_P8 = 408,\n CFG_PIN_P9 = 409,\n CFG_PIN_P10 = 410,\n CFG_PIN_P11 = 411,\n CFG_PIN_P12 = 412,\n CFG_PIN_P13 = 413,\n CFG_PIN_P14 = 414,\n CFG_PIN_P15 = 415,\n CFG_PIN_P16 = 416,\n CFG_PIN_P17 = 417,\n CFG_PIN_P18 = 418,\n CFG_PIN_P19 = 419,\n CFG_PIN_P20 = 420,\n CFG_PIN_P21 = 421,\n CFG_PIN_P22 = 422,\n CFG_PIN_P23 = 423,\n CFG_PIN_P24 = 424,\n CFG_PIN_P25 = 425,\n CFG_PIN_P26 = 426,\n CFG_PIN_P27 = 427,\n CFG_PIN_P28 = 428,\n CFG_PIN_P29 = 429,\n CFG_PIN_P30 = 430,\n CFG_PIN_P31 = 431,\n CFG_PIN_LORA_MISO = 1001,\n CFG_PIN_LORA_MOSI = 1002,\n CFG_PIN_LORA_SCK = 1003,\n CFG_PIN_LORA_CS = 1004,\n CFG_PIN_LORA_BOOT = 1005,\n CFG_PIN_LORA_RESET = 1006,\n CFG_PIN_IRRXLED = 1007,\n CFG_PIN_IRTXLED = 1008,\n CFG_PIN_LCD_RESET = 1009,\n CFG_PIN_LCD_ENABLE = 1010,\n CFG_PIN_LCD_DATALINE4 = 1011,\n CFG_PIN_LCD_DATALINE5 = 1012,\n CFG_PIN_LCD_DATALINE6 = 1013,\n CFG_PIN_LCD_DATALINE7 = 1014,\n CFG_NUM_LCD_COLUMNS = 1015,\n CFG_NUM_LCD_ROWS = 1016,\n CFG_PIN_RCC0 = 1017,\n CFG_PIN_RCC1 = 1018,\n CFG_PIN_RCC2 = 1019,\n CFG_PIN_RCC3 = 1020,\n CFG_PIN_RCC4 = 1021,\n CFG_PIN_RCC5 = 1022,\n CFG_PIN_RCC6 = 1023,\n CFG_PIN_RCC7 = 1024,\n CFG_PIN_SERVO0 = 1025,\n CFG_PIN_SERVO1 = 1026,\n CFG_PIN_SERVO2 = 1027,\n CFG_PIN_SERVO3 = 1028,\n CFG_PIN_SERVO4 = 1029,\n CFG_PIN_SERVO5 = 1030,\n CFG_PIN_SERVO6 = 1031,\n CFG_PIN_SERVO7 = 1032,\n CFG_PIN_SERVO8 = 1033,\n CFG_PIN_PI_TX = 1034,\n CFG_PIN_PI_RX = 1035,\n CFG_PIN_GPS_SDA = 1036,\n CFG_PIN_GPS_SCL = 1037,\n CFG_PIN_GPS_TX = 1038,\n CFG_PIN_GPS_RX = 1039,\n CFG_PIN_GROVE0 = 1040,\n CFG_PIN_GROVE1 = 1041,\n CFG_PIN_SS = 1042,\n // /pxtapp/hf2dbg.h\n HF2DBG_H = 1,\n // /pxtapp/jacdac/jdprotocol.h\n JDSPI_MAGIC = 31437,\n JDSPI_MAGIC_NOOP = 46029,\n // /pxtapp/mixer---samd/melody.h\n SW_TRIANGLE = 1,\n SW_SAWTOOTH = 2,\n SW_SINE = 3,\n SW_NOISE = 5,\n SW_SQUARE_10 = 11,\n SW_SQUARE_50 = 15,\n CODAL = 1,\n MAX_SOUNDS = 5,\n Waiting = 0,\n Playing = 1,\n Done = 2,\n // /pxtapp/pins.h\n BUTTON_ACTIVE_HIGH_PULL_DOWN = 17,\n BUTTON_ACTIVE_HIGH_PULL_UP = 33,\n BUTTON_ACTIVE_HIGH_PULL_NONE = 49,\n BUTTON_ACTIVE_LOW_PULL_DOWN = 16,\n BUTTON_ACTIVE_LOW_PULL_UP = 32,\n BUTTON_ACTIVE_LOW_PULL_NONE = 48,\n // /pxtapp/platform.h\n PAGE_SIZE = 512,\n BOOTLOADER_START = 0,\n DEV_NUM_PINS = 64,\n PXT_74HC165 = 1,\n IMAGE_BITS = 4,\n PA00 = 0,\n PA01 = 1,\n PA02 = 2,\n PA03 = 3,\n PA04 = 4,\n PA05 = 5,\n PA06 = 6,\n PA07 = 7,\n PA08 = 8,\n PA09 = 9,\n PA10 = 10,\n PA11 = 11,\n PA12 = 12,\n PA13 = 13,\n PA14 = 14,\n PA15 = 15,\n PA16 = 16,\n PA17 = 17,\n PA18 = 18,\n PA19 = 19,\n PA20 = 20,\n PA21 = 21,\n PA22 = 22,\n PA23 = 23,\n PA24 = 24,\n PA25 = 25,\n PA26 = 26,\n PA27 = 27,\n PA28 = 28,\n PA29 = 29,\n PA30 = 30,\n PA31 = 31,\n PB00 = 32,\n PB01 = 33,\n PB02 = 34,\n PB03 = 35,\n PB04 = 36,\n PB05 = 37,\n PB06 = 38,\n PB07 = 39,\n PB08 = 40,\n PB09 = 41,\n PB10 = 42,\n PB11 = 43,\n PB12 = 44,\n PB13 = 45,\n PB14 = 46,\n PB15 = 47,\n PB16 = 48,\n PB17 = 49,\n PB18 = 50,\n PB19 = 51,\n PB20 = 52,\n PB21 = 53,\n PB22 = 54,\n PB23 = 55,\n PB24 = 56,\n PB25 = 57,\n PB26 = 58,\n PB27 = 59,\n PB28 = 60,\n PB29 = 61,\n PB30 = 62,\n PB31 = 63,\n // /pxtapp/pxt.h\n DEVICE_ID_BUTTON_SLIDE = 3000,\n DEVICE_ID_MICROPHONE = 3001,\n DEVICE_ID_FIRST_BUTTON = 4000,\n DEVICE_ID_FIRST_TOUCHBUTTON = 4100,\n PXT_INTERNAL_KEY_UP = 2050,\n PXT_INTERNAL_KEY_DOWN = 2051,\n // /pxtapp/pxtbase.h\n PXT32 = 1,\n PXT64 = 1,\n PXT_REFCNT_FLASH = 65534,\n VTABLE_MAGIC = 249,\n Undefined = 0,\n Boolean = 1,\n Number = 2,\n String = 3,\n Object = 4,\n Function = 5,\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,\n MMap = 10,\n User0 = 16,\n PXT_IOS_HEAP_ALLOC_BITS = 20,\n IMAGE_HEADER_MAGIC = 135,\n Int8LE = 1,\n UInt8LE = 2,\n Int16LE = 3,\n UInt16LE = 4,\n Int32LE = 5,\n Int8BE = 6,\n UInt8BE = 7,\n Int16BE = 8,\n UInt16BE = 9,\n Int32BE = 10,\n UInt32LE = 11,\n UInt32BE = 12,\n Float32LE = 13,\n Float64LE = 14,\n Float32BE = 15,\n Float64BE = 16,\n NUM_TRY_FRAME_REGS = 3,\n GC = 0,\n // /pxtapp/pxtconfig.h\n PXT_UF2_FAMILY = 1760373640,\n // /pxtapp/serial/serial-common.h\n BaudRate115200 = 115200,\n BaudRate57600 = 57600,\n BaudRate38400 = 38400,\n BaudRate31250 = 31250,\n BaudRate28800 = 28800,\n BaudRate19200 = 19200,\n BaudRate14400 = 14400,\n BaudRate9600 = 9600,\n BaudRate4800 = 4800,\n BaudRate2400 = 2400,\n BaudRate1200 = 1200,\n BaudRate300 = 300,\n DataReceived = 4,\n RxBufferFull = 3,\n NewLine = 10,\n Comma = 44,\n Dollar = 36,\n Colon = 58,\n Fullstop = 46,\n Hash = 35,\n SemiColumn = 59,\n Space = 32,\n Tab = 9,\n Pipe = 124,\n // /pxtapp/settings/RAFFS.h\n RAFFS_FOLLOWING_MASK = 32768,\n RAFFS_FLASH_BUFFER_SIZE = 64,\n // /pxtapp/thermometer/target_temperature.h\n TEMPERATURE_NOMINAL_VALUE = 25,\n TEMPERATURE_NOMINAL_READING = 10000,\n TEMPERATURE_BETA = 3380,\n TEMPERATURE_SERIES_RESISTOR = 10000,\n // /pxtapp/uf2hid.h\n UF2_HID_H = 1,\n}\n",
"dmac.cpp": "#include \"dmac.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nSINGLETON(WDMAC);\n#endif\n\n}",
"dmac.h": "#ifndef __DMAC_H\n#define __DMAC_H\n\n#include \"pxt.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nclass WDMAC {\n public:\n CODAL_DMAC dmac;\n\n WDMAC() {}\n};\n\nWDMAC* getWDMAC();\n#endif\n\n}\n\n#endif",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum PulseValue {\n //% block=high\n High = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=low\n Low = 5, // DEVICE_PIN_EVT_PULSE_LO\n }\n\n\n declare const enum PinEvent {\n //% block=\"pulse high\"\n PulseHigh = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=\"pulse low\"\n PulseLow = 5, // DEVICE_PIN_EVT_PULSE_LO\n //% block=\"rise\"\n Rise = 2, // DEVICE_PIN_EVT_RISE\n //% block=\"fall\"\n Fall = 3, // DEVICE_PIN_EVT_FALL\n }\n\n\n declare const enum PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"hf2.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#ifndef USB_HANDOVER\n#define USB_HANDOVER 1\n#endif\n\n#if USB_HANDOVER\n#define UF2_DEFINE_HANDOVER 1\n#endif\n\n#include \"uf2format.h\"\n\nstatic void *stackCopy;\nstatic uint32_t stackSize;\n\n//#define LOG DMESG\n#define LOG(...) ((void)0)\n\nstatic volatile bool resume = false;\n\nusing namespace codal;\n\n#ifdef HF2_HID\nstatic const char hidDescriptor[] = {\n 0x06, 0x97, 0xFF, // usage page vendor 0x97 (usage 0xff97 0x0001)\n 0x09, 0x01, // usage 1\n 0xA1, 0x01, // collection - application\n 0x15, 0x00, // logical min 0\n 0x26, 0xFF, 0x00, // logical max 255\n 0x75, 8, // report size 8\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x81, 0x02, // input: data, variable, absolute\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x91, 0x02, // output: data, variable, absolute\n 0x95, 1, // report count 1\n 0x09, 0x01, // usage 1\n 0xB1, 0x02, // feature: data, variable, absolute\n 0xC0, // end\n};\n\nstatic const HIDReportDescriptor reportDesc = {\n 9,\n 0x21, // HID\n 0x100, // hidbcd 1.00\n 0x00, // country code\n 0x01, // num desc\n 0x22, // report desc type\n sizeof(hidDescriptor), // size of 0x22\n};\n\nstatic const InterfaceInfo ifaceInfoHID = {\n &reportDesc,\n sizeof(reportDesc),\n 1,\n {\n 2, // numEndpoints\n 0x03, /// class code - HID\n 0x00, // subclass\n 0x00, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_INTERRUPT, 1},\n {USB_EP_TYPE_INTERRUPT, 1},\n};\n#endif\n\nstatic const InterfaceInfo ifaceInfoEP = {\n NULL,\n 0,\n 2,\n {\n 2, // numEndpoints\n 0xff, /// class code - vendor-specific\n 42, // subclass\n 1, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_BULK, 0},\n {USB_EP_TYPE_BULK, 0},\n};\n\nint HF2::stdRequest(UsbEndpointIn &ctrl, USBSetup &setup) {\n#ifdef HF2_HID\n if (!useHID)\n return DEVICE_NOT_SUPPORTED;\n if (setup.bRequest == USB_REQ_GET_DESCRIPTOR) {\n if (setup.wValueH == 0x21) {\n InterfaceDescriptor tmp;\n fillInterfaceInfo(&tmp);\n return ctrl.write(&tmp, sizeof(tmp));\n } else if (setup.wValueH == 0x22) {\n return ctrl.write(hidDescriptor, sizeof(hidDescriptor));\n }\n }\n#endif\n return DEVICE_NOT_SUPPORTED;\n}\n\n// same as in microbit\n#define CTRL_GET_REPORT 0x01\n#define CTRL_SET_REPORT 0x09\n#define CTRL_OUT_REPORT_H 0x2\n#define CTRL_IN_REPORT_H 0x1\n\nvoid HF2::sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend) {\n if (!CodalUSB::usbInstance->isInitialised())\n return;\n\n uint32_t buf[64 / 4]; // aligned\n\n if (prepend + 1)\n size += 4;\n\n target_disable_irq();\n while (size > 0) {\n memset(buf + 1, 0, 60);\n int s = 63;\n if (size <= 63) {\n s = size;\n buf[0] = flag;\n } else {\n buf[0] = flag == HF2_FLAG_CMDPKT_LAST ? HF2_FLAG_CMDPKT_BODY : flag;\n }\n buf[0] |= s;\n uint8_t *dst = (uint8_t *)buf;\n dst++;\n if (prepend + 1) {\n memcpy(dst, &prepend, 4);\n prepend = -1;\n dst += 4;\n s -= 4;\n size -= 4;\n }\n memcpy(dst, data, s);\n data = (const uint8_t *)data + s;\n size -= s;\n\n in->write(buf, sizeof(buf));\n }\n target_enable_irq();\n}\n\nconst InterfaceInfo *HF2::getInterfaceInfo() {\n#ifdef HF2_HID\n if (useHID)\n return &ifaceInfoHID;\n#endif\n return &ifaceInfoEP;\n}\n\nint HF2::sendEvent(uint32_t evId, const void *data, int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, evId);\n return 0;\n}\n\nint HF2::sendSerial(const void *data, int size, int isError) {\n if (!gotSomePacket)\n return DEVICE_OK;\n\n sendBuffer(isError ? HF2_FLAG_SERIAL_ERR : HF2_FLAG_SERIAL_OUT, data, size);\n\n return 0;\n}\n\n// Receive HF2 message\n// Does not block. Will store intermediate data in pkt.\n// `serial` flag is cleared if we got a command message.\nint HF2::recv() {\n uint8_t buf[64];\n\n int len = out->read(buf, sizeof(buf));\n // DMESG(\"HF2 read: %d\", len);\n\n if (len <= 0)\n return len;\n\n uint8_t tag = buf[0];\n // serial packets not allowed when in middle of command packet\n usb_assert(pkt.size == 0 || !(tag & HF2_FLAG_SERIAL_OUT));\n int size = tag & HF2_SIZE_MASK;\n usb_assert(pkt.size + size <= (int)sizeof(pkt.buf));\n memcpy(pkt.buf + pkt.size, buf + 1, size);\n pkt.size += size;\n tag &= HF2_FLAG_MASK;\n if (tag != HF2_FLAG_CMDPKT_BODY) {\n if (tag == HF2_FLAG_CMDPKT_LAST)\n pkt.serial = 0;\n else if (tag == HF2_FLAG_SERIAL_OUT)\n pkt.serial = 1;\n else\n pkt.serial = 2;\n int sz = pkt.size;\n pkt.size = 0;\n return sz;\n }\n return 0;\n}\n\nint HF2::sendResponse(int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, pkt.buf, 4 + size);\n return 0;\n}\n\nint HF2::sendResponseWithData(const void *data, int size) {\n if (size <= (int)sizeof(pkt.buf) - 4) {\n memcpy(pkt.resp.data8, data, size);\n return sendResponse(size);\n } else {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, pkt.resp.eventId);\n return 0;\n }\n}\n\nstatic void copy_words(void *dst0, const void *src0, uint32_t n_words) {\n uint32_t *dst = (uint32_t *)dst0;\n const uint32_t *src = (const uint32_t *)src0;\n while (n_words--)\n *dst++ = *src++;\n}\n\n#ifndef QUICK_BOOT\n#ifdef SAMD21\n#define DBL_TAP_PTR ((volatile uint32_t *)(HMCRAMC0_ADDR + HMCRAMC0_SIZE - 4))\n#endif\n#ifdef SAMD51\n#define DBL_TAP_PTR ((volatile uint32_t *)(HSRAM_ADDR + HSRAM_SIZE - 4))\n#endif\n#if defined(NRF52840) || defined(NRF52833)\n#define DBL_TAP_PTR ((volatile uint32_t*)0x20007F7C)\n#endif\n#define DBL_TAP_MAGIC_QUICK_BOOT 0xf02669ef\n#define QUICK_BOOT(v) *DBL_TAP_PTR = v ? DBL_TAP_MAGIC_QUICK_BOOT : 0\n#endif\n\nstatic HF2 *jdLogger;\nstatic void jdLog(const uint8_t *frame) {\n jdLogger->sendEvent(HF2_EV_JDS_PACKET, frame, frame[2] + 12);\n}\n\nint HF2::endpointRequest() {\n int sz = recv();\n\n if (!sz)\n return 0;\n\n uint32_t tmp;\n\n if (pkt.serial) {\n // TODO raise some event?\n return 0;\n }\n\n LOG(\"HF2 sz=%d CMD=%x\", sz, pkt.buf32[0]);\n\n // one has to be careful dealing with these, as they share memory\n HF2_Command *cmd = &pkt.cmd;\n HF2_Response *resp = &pkt.resp;\n\n uint32_t cmdId = cmd->command_id;\n resp->tag = cmd->tag;\n resp->status16 = HF2_STATUS_OK;\n\n#define checkDataSize(str, add) usb_assert(sz == 8 + (int)sizeof(cmd->str) + (int)(add))\n\n lastExchange = current_time_ms();\n gotSomePacket = true;\n\n switch (cmdId) {\n case HF2_CMD_INFO:\n return sendResponseWithData(uf2_info(), strlen(uf2_info()));\n\n case HF2_CMD_BININFO:\n resp->bininfo.mode = HF2_MODE_USERSPACE;\n resp->bininfo.flash_page_size = 0;\n resp->bininfo.flash_num_pages = 0;\n resp->bininfo.max_message_size = sizeof(pkt.buf);\n resp->bininfo.uf2_family = PXT_UF2_FAMILY;\n return sendResponse(sizeof(resp->bininfo));\n\n case HF2_DBG_RESTART:\n *HF2_DBG_MAGIC_PTR = HF2_DBG_MAGIC_START;\n target_reset();\n break;\n\n case HF2_CMD_RESET_INTO_APP:\n QUICK_BOOT(1);\n NVIC_SystemReset();\n break;\n case HF2_CMD_RESET_INTO_BOOTLOADER:\n QUICK_BOOT(0);\n NVIC_SystemReset();\n break;\n\n#if USB_HANDOVER\n case HF2_CMD_START_FLASH:\n sendResponse(0);\n hf2_handover(in->ep);\n usb_assert(0); // should not be reached\n break;\n#endif\n\n case HF2_CMD_WRITE_WORDS:\n checkDataSize(write_words, cmd->write_words.num_words << 2);\n copy_words((void *)cmd->write_words.target_addr, cmd->write_words.words,\n cmd->write_words.num_words);\n break;\n\n case HF2_CMD_READ_WORDS:\n checkDataSize(read_words, 0);\n tmp = cmd->read_words.num_words;\n usb_assert(tmp <= sizeof(pkt.buf) / 4 - 1);\n copy_words(resp->data32, (void *)cmd->read_words.target_addr, tmp);\n return sendResponse(tmp << 2);\n\n case HF2_CMD_DMESG:\n#if DEVICE_DMESG_BUFFER_SIZE > 0\n return sendResponseWithData(codalLogStore.buffer, codalLogStore.ptr);\n#else\n break;\n#endif\n\n case HF2_DBG_GET_GLOBAL_STATE: {\n HF2_GLOBAL_STATE_Result gstate = {\n .num_globals = (uint32_t)getNumGlobals(), //\n .globals_addr = (uint32_t)globals,\n };\n return sendResponseWithData(&gstate, sizeof(gstate));\n }\n\n case HF2_DBG_RESUME:\n globals[0] = (TValue)cmd->data32[0];\n resume = true;\n return sendResponse(0);\n\n case HF2_DBG_GET_STACK:\n return sendResponseWithData(stackCopy, stackSize);\n\n case HF2_CMD_JDS_CONFIG:\n if (cmd->data8[0]) {\n jdLogger = this;\n pxt::logJDFrame = jdLog;\n } else {\n pxt::logJDFrame = NULL;\n }\n return sendResponse(0);\n\n case HF2_CMD_JDS_SEND:\n if (pxt::sendJDFrame) {\n pxt::sendJDFrame(cmd->data8);\n return sendResponse(0);\n } else {\n resp->status16 = HF2_STATUS_INVALID_STATE;\n return sendResponse(0);\n }\n\n default:\n // command not understood\n resp->status16 = HF2_STATUS_INVALID_CMD;\n break;\n }\n\n return sendResponse(0);\n}\n\nHF2::HF2(HF2_Buffer &p) : gotSomePacket(false), ctrlWaiting(false), pkt(p), useHID(false) {\n lastExchange = 0;\n}\n\nstatic const InterfaceInfo dummyIfaceInfo = {\n NULL,\n 0,\n 0,\n {\n 0, // numEndpoints\n 0xff, /// class code - vendor-specific\n 0xff, // subclass\n 0xff, // protocol\n 0x00, // string\n 0x00, // alt\n },\n {0, 0},\n {0, 0},\n};\n\nconst InterfaceInfo *DummyIface::getInterfaceInfo() {\n return &dummyIfaceInfo;\n}\n\n//\n//\n// Debugger\n//\n//\n\nstruct ExceptionContext {\n uint32_t excReturn; // 0xFFFFFFF9\n uint32_t r0;\n uint32_t r1;\n uint32_t r2;\n uint32_t r3;\n uint32_t r12;\n uint32_t lr;\n uint32_t faultInstrAddr;\n uint32_t psr;\n};\n\nstruct Paused_Data {\n uint32_t pc;\n};\nstatic Paused_Data pausedData;\n\nvoid bkptPaused() {\n\n// waiting for https://github.com/lancaster-university/codal/pull/14\n#ifdef DEVICE_GROUP_ID_USER\n // the loop below counts as \"system\" task, and we don't want to pause ourselves\n fiber_set_group(DEVICE_GROUP_ID_SYSTEM);\n // pause everyone else\n fiber_pause_group(DEVICE_GROUP_ID_USER);\n#endif\n\n while (!resume) {\n // DMESG(\"BKPT\");\n hf2.pkt.resp.eventId = HF2_EV_DBG_PAUSED;\n hf2.sendResponseWithData(&pausedData, sizeof(pausedData));\n // TODO use an event\n for (int i = 0; i < 20; ++i) {\n if (resume)\n break;\n fiber_sleep(50);\n }\n }\n\n if (stackCopy) {\n xfree(stackCopy);\n stackCopy = NULL;\n }\n\n#ifdef DEVICE_GROUP_ID_USER\n fiber_resume_group(DEVICE_GROUP_ID_USER);\n // go back to user mode\n fiber_set_group(DEVICE_GROUP_ID_USER);\n#endif\n\n resume = false;\n}\n\nextern \"C\" void handleHardFault(ExceptionContext *ectx) {\n auto instr = (uint16_t *)ectx->faultInstrAddr;\n\n DMESG(\"FLT %p\", instr);\n\n if (ectx->faultInstrAddr & 0x80000000) {\n ectx->faultInstrAddr &= ~0x80000000;\n // switch to step-over mode\n globals[0] = (TValue)3;\n return;\n }\n\n DMESG(\"BB %p %p %p lr=%p r0=%p\", instr[-1], instr[0], instr[1], ectx->lr, ectx->r0);\n\n if (instr[0] == 0x6840) {\n // ldr r0, [r0, #4] -- entry breakpoint\n ectx->faultInstrAddr += 2;\n // we're being ask for step-over mode\n if (ectx->r0 == 3) {\n // switch to debugger-attached-no-stepping mode\n globals[0] = (TValue)0;\n ectx->lr |= 0x80000000;\n }\n return;\n }\n\n if (instr[0] == 0x6800) {\n // ldr r0, [r0, #0]\n ectx->lr = ectx->faultInstrAddr + 3; // next instruction + thumb mode\n pausedData.pc = ectx->faultInstrAddr + 2;\n void *ssp = (void *)(ectx + 1);\n stackSize = DEVICE_STACK_BASE - (uint32_t)ssp;\n if (stackCopy)\n xfree(stackCopy);\n stackCopy = xmalloc(stackSize);\n memcpy(stackCopy, ssp, stackSize);\n ectx->faultInstrAddr = ((uint32_t)(&bkptPaused) & (~1U));\n return;\n }\n\n while (1) {\n }\n}\n\nextern \"C\" void HardFault_Handler(void) {\n asm(\"push {lr}; mov r0, sp; bl handleHardFault; pop {pc}\");\n}\n\n#endif",
"hf2.h": "#ifndef DEVICE_HF2_H\n#define DEVICE_HF2_H\n\n#if CONFIG_ENABLED(DEVICE_USB)\n\n#include \"HID.h\"\n#include \"uf2hid.h\"\n\n// 260 bytes needed for biggest JD packets (with overheads)\n#define HF2_BUF_SIZE 260\n\ntypedef struct {\n uint16_t size;\n uint8_t serial;\n union {\n uint8_t buf[HF2_BUF_SIZE];\n uint32_t buf32[HF2_BUF_SIZE / 4];\n uint16_t buf16[HF2_BUF_SIZE / 2];\n HF2_Command cmd;\n HF2_Response resp;\n };\n} HF2_Buffer;\n\nclass HF2 : public CodalUSBInterface {\n bool gotSomePacket;\n bool ctrlWaiting;\n uint32_t lastExchange;\n\n public:\n HF2_Buffer &pkt;\n\n bool useHID;\n\n int sendResponse(int size);\n int recv();\n int sendResponseWithData(const void *data, int size);\n int sendEvent(uint32_t evId, const void *data, int size);\n void sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend = -1);\n\n HF2(HF2_Buffer &pkt);\n virtual int endpointRequest();\n virtual int stdRequest(UsbEndpointIn &ctrl, USBSetup &setup);\n virtual const InterfaceInfo *getInterfaceInfo();\n int sendSerial(const void *data, int size, int isError = 0);\n\n virtual bool enableWebUSB() { return !useHID; }\n};\n\nclass DummyIface : public CodalUSBInterface {\n public:\n virtual const InterfaceInfo *getInterfaceInfo();\n};\n\n#endif\n\n#endif\n",
"hf2dbg.h": "#ifndef HF2DBG_H\n#define HF2DBG_H 1\n\n// we use a location at the top of the stack to store a magic value\n// which causes us to stop at the very first break point in the program\n#define HF2_DBG_MAGIC_PTR ((uint32_t *)(DEVICE_STACK_BASE - (DEVICE_STACK_SIZE - 4)))\n#define HF2_DBG_MAGIC_START 0xf0ebac7f\n\n#define HF2_DBG_GET_GLOBAL_STATE 0x53fc66e0\nstruct HF2_GLOBAL_STATE_Result {\n uint32_t num_globals;\n uint32_t globals_addr;\n};\n\n#define HF2_DBG_RESTART 0x1120bd93\n#define HF2_DBG_RESUME 0x27a55931\n#define HF2_EV_DBG_PAUSED 0x3692f9fd\n#define HF2_DBG_GET_STACK 0x70901510\n\n#endif\n",
"i2c.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n#include \"CodalDmesg.h\"\n#include \"configkeys.h\"\n\n#ifdef CODAL_I2C\n\nnamespace pins {\n\nclass CodalI2CProxy {\nprivate:\n DevicePin* sda;\n DevicePin* scl;\n CODAL_I2C i2c;\npublic:\n CodalI2CProxy* next;\npublic:\n CodalI2CProxy(DevicePin* _sda, DevicePin* _scl)\n : sda(_sda)\n , scl(_scl)\n , i2c(*_sda, *_scl) \n , next(NULL)\n {\n\n }\n\n CODAL_I2C* getI2C() {\n return &(this->i2c);\n }\n \n bool matchPins(DevicePin* sda, DevicePin* scl) {\n return this->sda == sda && this->scl == scl;\n }\n\n Buffer readBuffer(int address, int size, bool repeat = false)\n {\n Buffer buf = mkBuffer(NULL, size);\n registerGCObj(buf);\n int status = this->i2c.read(address << 1, buf->data, size, repeat);\n unregisterGCObj(buf);\n if (status != ErrorCode::DEVICE_OK) {\n buf = 0;\n }\n return buf;\n }\n\n int writeBuffer(int address, Buffer buf, bool repeat = false)\n {\n return this->i2c.write(address << 1, buf->data, buf->length, repeat);\n }\n};\n\n}\n\nnamespace I2CMethods {\n/**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n//%\nBuffer readBuffer(I2C_ i2c, int address, int size, bool repeat = false)\n{\n return i2c->readBuffer(address, size, repeat);\n}\n\n/**\n * Write bytes to a 7-bit I2C `address`.\n */\n//%\nint writeBuffer(I2C_ i2c, int address, Buffer buf, bool repeat = false)\n{\n return i2c->writeBuffer(address, buf, repeat);\n}\n\n}\n\nnamespace pins {\n\nstatic I2C_ i2cs(NULL);\n/**\n* Opens a Serial communication driver\n*/\n//% help=pins/create-i2c\n//% parts=i2c\nI2C_ createI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n // pick up defaults\n if (!sda || !scl) {\n DMESG(\"i2c: lookup default pins\");\n sda = LOOKUP_PIN(SDA);\n scl = LOOKUP_PIN(SCL);\n }\n\n // lookup existing devices\n auto dev = i2cs;\n while(dev) {\n if (dev->matchPins(sda, scl)) {\n DMESG(\"i2c: found existing i2c\");\n return dev;\n }\n dev = dev->next;\n }\n\n // allocate new one\n DMESG(\"i2c: mounting on new device\");\n auto ser = new CodalI2CProxy(sda, scl);\n // push in list\n ser->next = i2cs;\n i2cs = ser;\n return ser;\n}\n\n}\n\nnamespace pxt {\n CODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n auto i2c = pins::createI2C(sda, scl);\n return i2c->getI2C();\n }\n}\n\n#endif",
"i2c.ts": "namespace pins {\n /**\n * Read one number from an I2C address.\n */\n //% help=pins/i2c-read-number weight=5 group=\"i2c\" inlineInputMode=\"external\"\n //% blockId=pins_i2c_readnumber block=\"i2c read number at address %address|of format %format|repeated %repeated\"\n export function i2cReadNumber(address: number, format: NumberFormat, repeated?: boolean): number {\n const buf = pins.i2cReadBuffer(address, pins.sizeOf(format), repeated)\n if (!buf)\n return undefined\n return buf.getNumber(format, 0)\n }\n\n /**\n * Write one number to an I2C address.\n */\n //% help=pins/i2c-write-number weight=4 group=\"i2c\"\n //% blockId=i2c_writenumber block=\"i2c write number|at address %address|with value %value|of format %format|repeated %repeated\"\n export function i2cWriteNumber(address: number, value: number, format?: NumberFormat, repeated?: boolean): void {\n if (format == undefined)\n format = NumberFormat.UInt8LE;\n const buf = control.createBuffer(pins.sizeOf(format))\n buf.setNumber(format, 0, value)\n pins.i2cWriteBuffer(address, buf, repeated)\n }\n\n /**\n * Write a value in a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param value value to write\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-write-register\n //% blockId=i2c_writereg block=\"i2c write register|at address $address|at register $register|value $value\"\n export function i2cWriteRegister(address: number, register: number, value: number, valueFormat?: NumberFormat): void {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n const valueSize = pins.sizeOf(valueFormat);\n const buf = control.createBuffer(1 + valueSize);\n buf.setNumber(NumberFormat.UInt8LE, 0, register);\n buf.setNumber(valueFormat, 1, value);\n pins.i2cWriteBuffer(address, buf);\n }\n\n /**\n * Read the value from a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-read-register\n //% blockId=i2c_readreg block=\"i2c read register|at address $address|at register $register\"\n export function i2cReadRegister(address: number, register: number, valueFormat?: NumberFormat): number {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n pins.i2cWriteNumber(address, register, NumberFormat.UInt8LE);\n return pins.i2cReadNumber(address, valueFormat);\n }\n\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //%\n export function i2cReadBuffer(address: number, size: number, repeat: boolean = false): Buffer {\n return pins.i2c().readBuffer(address, size, repeat);\n }\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //%\n export function i2cWriteBuffer(address: number, buf: Buffer, repeat: boolean = false): number {\n return pins.i2c().writeBuffer(address, buf, repeat);\n }\n\n let _i2c: I2C;\n /**\n * Gets the default I2C bus\n */\n //%\n export function i2c(): I2C {\n if (!_i2c) {\n const sda = pins.pinByCfg(DAL.CFG_PIN_SDA);\n const scl = pins.pinByCfg(DAL.CFG_PIN_SCL);\n _i2c = pins.createI2C(sda, scl); \n }\n return _i2c; \n }\n\n export class I2CDevice {\n public address: number;\n public bus: I2C;\n private _hasError: boolean;\n constructor(address: number, bus?: I2C) {\n this.address = address;\n this.bus = bus || i2c();\n }\n public readInto(buf: Buffer, repeat = false, start = 0, end: number = null) {\n if (end === null)\n end = buf.length\n if (start >= end)\n return\n let res = this.bus.readBuffer(this.address, end - start, repeat)\n if (!res) {\n this._hasError = true\n return\n }\n buf.write(start, res)\n }\n public write(buf: Buffer, repeat = false) {\n let res = this.bus.writeBuffer(this.address, buf, repeat)\n if (res) {\n this._hasError = true\n }\n }\n public begin(): I2CDevice {\n this._hasError = false;\n return this;\n }\n public end() {\n }\n public ok() {\n return !this._hasError\n }\n\n public transfer(command: Buffer, response: Buffer, responseStart?: number, responseEnd?: number) {\n this.begin();\n if (command)\n this.write(command);\n if (response)\n this.readInto(response, false, responseStart, responseEnd);\n this.end();\n } \n }\n}\n",
"keyvaluestorage.cpp": "#include \"pxt.h\"\n#include \"KeyValueStorage.h\"\n\nnamespace pxt {\n\nclass WKeyValueStorage {\n#ifdef CODAL_NVMCONTROLLER\n CODAL_NVMCONTROLLER controller;\n#else\n NVMController controller;\n#endif\n KeyValueStorage storage;\n public:\n\n WKeyValueStorage()\n : controller()\n , storage(controller) {\n }\n\n bool isSupported() {\n#ifdef CODAL_NVMCONTROLLER\n return true;\n#else\n return false;\n#endif\n }\n\n int put(String key, Buffer data) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n return storage.put(mkey, data->data, data->length);\n#else\n return -1;\n#endif\n }\n\n Buffer get(String key) {\n#ifdef CODAL_NVMCONTROLLER\n Buffer buf = NULL;\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n auto entry = storage.get(mkey);\n if (entry) {\n buf = mkBuffer(entry->value, sizeof(entry->value));\n free(entry);\n }\n return buf;\n#else\n return NULL;\n#endif\n }\n\n void remove(String key) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n storage.remove(mkey);\n#endif\n }\n\n void clear() {\n#ifdef CODAL_NVMCONTROLLER\n storage.wipe();\n#endif\n }\n};\nSINGLETON(WKeyValueStorage);\n\n}\n\nnamespace configStorage {\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //%\n void setBuffer(String key, Buffer value) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->put(key, value);\n }\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //%\n Buffer getBuffer(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n return kvm->get(key);\n }\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //%\n void removeItem(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->remove(key);\n }\n\n /**\n * Clears the local storage\n */\n //%\n void clear() {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->clear();\n }\n}\n",
"keyvaluestorage.ts": "namespace configStorage {\n /**\n * Stores the value at the key entry\n * @param key identifier of the key (max 16 characters)\n * @param value identifier of the value (max 32 characters)\n */\n export function setItem(key: string, value: string) {\n if (value == null)\n configStorage.removeItem(key);\n else\n {\n let idx = 0;\n let buf = control.createBuffer(value.length + 1);\n buf[idx++] = value.length;\n let valBuf = control.createBufferFromUTF8(value);\n\n for (let i = 0; i < valBuf.length; i++)\n buf[idx++] = valBuf[i];\n\n configStorage.setBuffer(key, buf);\n }\n }\n\n /**\n * Retrieves the value at the key entry\n * @param key identifier of the key (max 16 characters)\n */\n export function getItem(key: string): string {\n const buf = configStorage.getBuffer(key);\n\n if (!buf)\n return undefined;\n\n let idx = 0;\n let count = buf[idx++];\n const retBuf = control.createBuffer(count);\n\n for (let i = 0; i < count; i++)\n retBuf[i] = buf[idx++];\n\n return retBuf.toString();\n }\n}\n",
"leveldetector.ts": "namespace pins {\n export class LevelDetector {\n public id: number;\n public min: number;\n public max: number;\n public lowThreshold: number;\n public highThreshold: number;\n private transition: number;\n private transitionMs: number;\n private _level: number;\n private _state: number;\n public onHigh: () => void;\n public onLow: () => void;\n public onNeutral: () => void;\n public transitionWindow: number;\n // minimum duration (ms) between events\n public transitionInterval: number;\n\n static LEVEL_THRESHOLD_NEUTRAL = 0;\n\n constructor(id: number,\n min: number, max: number,\n lowThreshold: number, highThreshold: number) {\n this.id = id;\n this.min = min;\n this.max = max;\n this.lowThreshold = lowThreshold;\n this.highThreshold = highThreshold;\n this.transitionWindow = 4;\n this.transitionInterval = 0;\n\n this.onHigh = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_HIGH);\n this.onLow = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_LOW);\n this.onNeutral = undefined;\n\n this.reset();\n }\n\n reset() {\n this.transition = 0;\n this.transitionMs = 0;\n this._level = Math.ceil((this.highThreshold - this.lowThreshold) / 2);\n this._state = LevelDetector.LEVEL_THRESHOLD_NEUTRAL;\n }\n\n get level(): number {\n return this._level;\n }\n\n set level(level: number) {\n this._level = this.clampValue(level);\n\n if (this._level >= this.highThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_HIGH);\n }\n else if (this._level <= this.lowThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_LOW);\n }\n else {\n this.setState(LevelDetector.LEVEL_THRESHOLD_NEUTRAL);\n }\n }\n\n public setLowThreshold(value: number) {\n this.lowThreshold = this.clampValue(value);\n this.reset();\n }\n\n public setHighThreshold(value: number) {\n this.highThreshold = this.clampValue(value);\n this.reset();\n }\n\n private clampValue(value: number) {\n if (value < this.min) {\n return this.min;\n }\n else if (value > this.max) {\n return this.max;\n }\n return value;\n }\n\n private setState(state: number) {\n // not enough samples to change\n if (this._state === state \n || (this.transition++ < this.transitionWindow)\n || (control.millis() - this.transitionMs) < this.transitionInterval) {\n return;\n }\n\n this.transition = 0;\n this.transitionMs = control.millis();\n this._state = state;\n switch (state) {\n case DAL.LEVEL_THRESHOLD_HIGH:\n if (this.onHigh) this.onHigh();\n break;\n case DAL.LEVEL_THRESHOLD_LOW:\n if (this.onLow) this.onLow();\n break;\n case LevelDetector.LEVEL_THRESHOLD_NEUTRAL:\n if (this.onNeutral) this.onNeutral();\n break;\n }\n }\n }\n}",
"light.cpp": "#include \"light.h\"\n\n// WS2812B timings, datasheet v1\n// 0 - 0.25-0.55us hi 0.70-1.00us low\n// 1 - 0.65-0.95us hi 0.30-0.60us low\n// datasheet v5\n// 0 - 0.22-0.38us hi 0.58-1.00us low 1-3\n// 1 - 0.58-1.00us hi 0.58-1.00us low 3-2\n\n#define SPI_SUPPORTED 1\n\n#if defined(NRF52_SERIES)\n#define BIT_EXPANSION 5\n#define SPI_FREQ 4000000\n#else\n#define BIT_EXPANSION 3\n#define SPI_FREQ 2400000\n#endif\n\n#if defined(SAMD21) || defined(SAMD51) || defined(STM32F4) || defined(NRF52_SERIES)\n#include \"neopixel.h\"\n#define BITBANG_SUPPORTED 1\n#else\n#define BITBANG_SUPPORTED 0\n#endif\n\n#define NEOPIXEL_MIN_LENGTH_FOR_SPI 24\n#define DOTSTAR_MIN_LENGTH_FOR_SPI 24\n\n#define LIGHTMODE_RGB 1\n#define LIGHTMODE_RGBW 2\n#define LIGHTMODE_RGB_RGB 3\n#define LIGHTMODE_DOTSTAR 4\n\nnamespace light {\nbool isValidMOSIPin(DigitalInOutPin pin) {\n if (!pin)\n return false;\n\n#if SAMD51\n return ZSPI::isValidMOSIPin(*pin);\n#elif defined(NRF52_SERIES)\n return true;\n#else\n // TODO: support for SPI neopixels\n // default SPI pins supported for now\n return pin == LOOKUP_PIN(MOSI);\n#endif\n}\n\n// SPI\nvoid spiNeopixelSendBuffer(DevicePin *pin, const uint8_t *data, unsigned size) {\n int32_t iptr = 0, optr = 120;\n uint32_t len = optr + size * BIT_EXPANSION + 120;\n uint8_t *expBuf = new uint8_t[len];\n memset(expBuf, 0, len);\n uint8_t imask = 0x80;\n uint8_t omask = 0x80;\n\n#define WR(k) \\\n if (k) \\\n expBuf[optr] |= omask; \\\n omask >>= 1; \\\n if (!omask) { \\\n omask = 0x80; \\\n optr++; \\\n }\n\n while (iptr < (int)size) {\n#if BIT_EXPANSION == 3\n WR(1);\n WR(data[iptr] & imask);\n WR(0);\n#elif BIT_EXPANSION == 5\n WR(1);\n if (data[iptr] & imask) {\n WR(1);\n WR(1);\n } else {\n WR(0);\n }\n WR(0);\n WR(0);\n#else\n#error \"invalid BIT_EXPANSION\"\n#endif\n\n imask >>= 1;\n if (!imask) {\n imask = 0x80;\n iptr++;\n }\n }\n\n auto spi = pxt::getSPI(pin, NULL, NULL);\n spi->setFrequency(SPI_FREQ);\n spi->transfer(expBuf, len, NULL, 0);\n delete expBuf;\n}\n\nvoid neopixelSendData(DevicePin *pin, int mode, const uint8_t *data, unsigned length) {\n if (!pin || !length)\n return;\n\n#if BITBANG_SUPPORTED\n if (SPI_SUPPORTED && length > NEOPIXEL_MIN_LENGTH_FOR_SPI && isValidMOSIPin(pin))\n spiNeopixelSendBuffer(pin, data, length);\n else\n neopixel_send_buffer(*pin, data, length);\n#else\n if (isValidMOSIPin(pin)) {\n spiNeopixelSendBuffer(pin, data, length);\n }\n#endif\n}\n\nvoid bitBangDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n // first frame of zeroes\n data->setDigitalValue(0);\n for (unsigned i = 0; i < 32; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n\n // data stream\n for (unsigned i = 0; i < length; ++i) {\n auto x = buf[i];\n for (uint8_t j = 0x80; j != 0; j >>= 1) {\n data->setDigitalValue(x & j ? 1 : 0);\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n }\n // https://cpldcpu.wordpress.com/2016/12/13/sk9822-a-clone-of-the-apa102/\n // reset frame\n // data->setDigitalValue(0);\n // for (unsigned i = 0; i < 32 ; ++i) {\n // clk->setDigitalValue(1);\n // clk->setDigitalValue(0);\n //}\n\n // https://cpldcpu.wordpress.com/2014/11/30/understanding-the-apa102-superled/\n data->setDigitalValue(1);\n unsigned n = 32;\n for (unsigned i = 0; i < n; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n}\n\nstatic uint8_t ZERO_FRAME[4];\nstatic uint8_t ONE_FRAME[] = {1, 1, 1, 1};\nvoid spiDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n auto spi = pxt::getSPI(data, NULL, clk);\n\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // initial frame\n spi->transfer(buf, length, NULL, 0);\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // reset frame\n for (unsigned i = 0; i < (length >> 3); i += 32)\n spi->transfer(ONE_FRAME, sizeof(ONE_FRAME), NULL, 0); // final frame\n}\n\nvoid dotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n if (!data || !clk || !buf || !length)\n return;\n\n if (length > DOTSTAR_MIN_LENGTH_FOR_SPI && isValidMOSIPin(data))\n spiDotStarSendData(data, clk, mode, buf, length);\n else\n bitBangDotStarSendData(data, clk, mode, buf, length);\n}\n\nvoid sendBuffer(DevicePin *data, DevicePin *clk, int mode, Buffer buf) {\n if (!data || !buf || !buf->length)\n return;\n\n if (mode == LIGHTMODE_DOTSTAR)\n light::dotStarSendData(data, clk, mode, buf->data, buf->length);\n else\n light::neopixelSendData(data, mode, buf->data, buf->length);\n}\n\nvoid clear() {\n auto neopix = LOOKUP_PIN(NEOPIXEL);\n auto neonum = getConfig(CFG_NUM_NEOPIXELS, 0);\n if (neopix && neonum >= 0) {\n auto n = 3 * neonum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n light::neopixelSendData(neopix, 0x100, off, sizeof(off));\n }\n\n auto data = LOOKUP_PIN(DOTSTAR_DATA);\n auto clk = LOOKUP_PIN(DOTSTAR_CLOCK);\n auto dsnum = getConfig(CFG_NUM_DOTSTARS, 0);\n if (data && clk && dsnum > 0) {\n auto n = 4 * dsnum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n for (int i = 0; i < n; i += 4)\n off[i] = 0xe0;\n bitBangDotStarSendData(data, clk, 0x100, off, sizeof(off));\n }\n}\n\n} // namespace light\n",
"light.h": "#ifndef __PXT_LIGHT_H\n#define __PXT_LIGHT_H\n\n#include \"pxt.h\"\n\nnamespace light {\n /**\n * Clear onboard neopixels\n */\n void clear();\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //%\n void sendBuffer(DigitalInOutPin data, DigitalInOutPin clk, int mode, Buffer buf);\n\n void neopixelSendData(DevicePin* pin, int mode, const uint8_t* data, unsigned length);\n}\n\n#endif",
"ns.ts": "/**\n * Events and data from sensors.\n */\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\n//% groups='[\"other\", \"More\"]'\nnamespace input {\n}\n\n/**\n * Servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\"\nnamespace servos {\n\n}\n\n/**\n * A Joint Asynchronous Communications, Device Agnostic Control.\n */\n//% color=\"#E79251\" weight=1 icon=\"\\uf185\"\n//% groups='[\"Broadcast\", \"Console\", \"Control\"]'\n//% blockGap=8\nnamespace jacdac {\n\n}",
"pins.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\nstatic DevicePin **pinPtrs;\nstatic uint8_t numPinPtrs;\nstatic uint8_t pinPos[DEV_NUM_PINS];\n\n//%\nDevicePin *getPin(int id) {\n\n id &= CFG_PIN_NAME_MSK;\n\n if (id >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n\n // we could use lookupComponent() here - it would be slightly slower\n\n int ptr = pinPos[id];\n if (ptr == 0) {\n pinPtrs = (DevicePin **)realloc(pinPtrs, (numPinPtrs + 1) * sizeof(void *));\n bool isAnalog = IS_ANALOG_PIN(id);\n // GCTODO\n pinPtrs[numPinPtrs++] =\n new DevicePin(DEVICE_ID_IO_P0 + id, (PinName)id,\n isAnalog ? PIN_CAPABILITY_AD : PIN_CAPABILITY_DIGITAL);\n ptr = numPinPtrs;\n pinPos[id] = ptr;\n }\n return pinPtrs[ptr - 1];\n}\n\n//%\nDevicePin *getPinCfg(int key) {\n int p = getConfig(key, -1);\n if (p == -1)\n DMESG(\"no pin cfg: %d\", key);\n return getPin(p);\n}\n\nvoid linkPin(int from, int to) {\n if (from < 0 || from >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n getPin(to);\n pinPos[from] = pinPos[to];\n}\n\n//%\nDevicePin *lookupPin(int pinName) {\n if (pinName < 0 || pinName == 0xff)\n return NULL;\n pinName &= CFG_PIN_NAME_MSK;\n return getPin(pinName);\n}\n\n//%\nDevicePin *lookupPinCfg(int key) {\n return lookupPin(getConfig(key));\n}\n\nCodalComponent *lookupComponent(int id) {\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; ++i) {\n if (CodalComponent::components[i] && CodalComponent::components[i]->id == id)\n return CodalComponent::components[i];\n }\n return NULL;\n}\n\n} // namespace pxt\n\nnamespace pins {\n/**\n* Get a pin by configuration id (DAL.CFG_PIN...)\n*/\n//%\nDigitalInOutPin pinByCfg(int key) {\n return pxt::lookupPinCfg(key);\n}\n\n/**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n//%\nBuffer createBuffer(int size) {\n return mkBuffer(NULL, size);\n}\n\n/**\n * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n//% help=pins/pulse-duration blockGap=8\n//% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n//% weight=19\nint pulseDuration() {\n return pxt::lastEvent.timestamp;\n}\n} // namespace pins\n",
"pins.h": "#ifndef __PXT_PINS_H\n#define __PXT_PINS_H\n\n#define BUTTON_ACTIVE_HIGH_PULL_DOWN (ACTIVE_HIGH | 0x10)\n#define BUTTON_ACTIVE_HIGH_PULL_UP (ACTIVE_HIGH | 0x20)\n#define BUTTON_ACTIVE_HIGH_PULL_NONE (ACTIVE_HIGH | 0x30)\n#define BUTTON_ACTIVE_LOW_PULL_DOWN (ACTIVE_LOW | 0x10)\n#define BUTTON_ACTIVE_LOW_PULL_UP (ACTIVE_LOW | 0x20)\n#define BUTTON_ACTIVE_LOW_PULL_NONE (ACTIVE_LOW | 0x30)\n\n#define PIN(name) ((PinName)pxt::getConfig(CFG_PIN_##name, -1))\n#define LOOKUP_PIN(name) pxt::lookupPin(PIN(name))\n\n// these can be overridden in platform.h\n#ifndef CODAL_PIN\n#define CODAL_PIN CODAL_MBED::Pin\n#endif\n\n#ifndef CODAL_TIMER\n#define CODAL_TIMER CODAL_MBED::Timer\n#endif\n\n#ifndef CODAL_SPI\n#define CODAL_SPI CODAL_MBED::SPI\n#endif\n\n#ifndef CODAL_SERIAL\n#define CODAL_SERIAL CODAL_MBED::Serial\n#endif\n\n#ifndef IS_ANALOG_PIN\n#define IS_ANALOG_PIN(id) ((DEV_ANALOG_PINS >> (id)) & 1)\n#endif\n\ntypedef CODAL_PIN DevicePin;\n\ntypedef DevicePin *DigitalInOutPin;\ntypedef DevicePin *AnalogInOutPin;\ntypedef DevicePin *AnalogInPin;\ntypedef DevicePin *AnalogOutPin;\ntypedef DevicePin *PwmPin;\ntypedef DevicePin *PwmOnlyPin;\ntypedef Button *Button_;\n\nnamespace pxt {\nDevicePin *getPin(int id);\nDevicePin *getPinCfg(int key);\nDevicePin *lookupPin(int pinName);\nDevicePin *lookupPinCfg(int key);\nvoid linkPin(int from, int to);\nCodalComponent *lookupComponent(int id);\n}\n\n#define PINOP(op) name->op\n\n#endif\n",
"pins.ts": "//% noRefCounting fixedInstances\ninterface DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogOutPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInOutPin extends AnalogInPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmOnlyPin extends DigitalInOutPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmPin extends PwmOnlyPin, AnalogInOutPin {\n}\n\n/**\n * Control currents in Pins for analog/digital signals, servos, i2c, ...\n */\n//% color=#A80000 weight=85 icon=\"\\uf140\" advanced=true\n//% groups='[\"other\", \"Servo\", \"i2c\"]'\nnamespace pins {\n}",
"pinsAnalog.cpp": "#include \"pxt.h\"\n\nnamespace AnalogInPinMethods {\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\n */\n//% help=pins/analog-read weight=53\n//% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nint analogRead(AnalogInPin name) {\n return PINOP(getAnalogValue());\n}\n}\n\nnamespace AnalogOutPinMethods {\nvoid analogWrite(AnalogOutPin name, int value) __attribute__ ((weak));\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\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n//% help=pins/analog-write weight=52\n//% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.min=0 value.max=1023\nvoid analogWrite(AnalogOutPin name, int value) {\n PINOP(setAnalogValue(value));\n}\n}",
"pinsDigital.cpp": "#include \"pxt.h\"\n\nenum class PulseValue {\n //% block=high\n High = DEVICE_PIN_EVT_PULSE_HI,\n //% block=low\n Low = DEVICE_PIN_EVT_PULSE_LO\n};\n\nenum class PinEvent {\n //% block=\"pulse high\"\n PulseHigh = DEVICE_PIN_EVT_PULSE_HI,\n //% block=\"pulse low\"\n PulseLow = DEVICE_PIN_EVT_PULSE_LO,\n //% block=\"rise\"\n Rise = DEVICE_PIN_EVT_RISE,\n //% block=\"fall\"\n Fall = DEVICE_PIN_EVT_FALL,\n};\n\nenum class PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2\n};\n\nnamespace DigitalInOutPinMethods {\n/**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n//% help=pins/digital-read weight=61\n//% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nbool digitalRead(DigitalInOutPin name) {\n return PINOP(getDigitalValue()) != 0;\n}\n\n/**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n//% help=pins/digital-write weight=60\n//% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid digitalWrite(DigitalInOutPin name, bool value) {\n PINOP(setDigitalValue(value));\n}\n\n/**\n* Make this pin a digital input, and create events where the timestamp is the duration\n* that this pin was either ``high`` or ``low``.\n*/\n//% help=pins/on-pulsed weight=16 blockGap=8\n//% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\n//% deprecated=1 hidden=1\nvoid onPulsed(DigitalInOutPin pin, PulseValue pulse, Action body) {\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)pulse, body);\n}\n\n/**\n* Register code to run when a pin event occurs. \n*/\n//% help=pins/on-event weight=20 blockGap=8\n//% blockId=pinsonevent block=\"on|pin %pin|%event\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nvoid onEvent(DigitalInOutPin pin, PinEvent event, Action body) {\n switch(event) {\n case PinEvent::PulseHigh:\n case PinEvent::PulseLow:\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)event, body);\n break;\n case PinEvent::Rise:\n case PinEvent::Fall:\n pin->eventOn(DEVICE_PIN_EVENT_ON_EDGE);\n registerWithDal(pin->id, (int)event, body);\n break; \n } \n}\n\n/**\n* Return the duration of a pulse in microseconds\n* @param name the pin which measures the pulse\n* @param value the value of the pulse (default high)\n* @param maximum duration in micro-seconds\n*/\n//% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n//% weight=18 blockGap=8\n//% help=\"pins/pulse-in\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nint pulseIn(DigitalInOutPin pin, PulseValue value, int maxDuration = 2000000) {\n int pulse = PulseValue::High == value ? 1 : 0;\n uint64_t tick = system_timer_current_time_us();\n uint64_t maxd = (uint64_t)maxDuration;\n while (pin->getDigitalValue() != pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n\n uint64_t start = system_timer_current_time_us();\n while (pin->getDigitalValue() == pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n uint64_t end = system_timer_current_time_us();\n return end - start;\n}\n\n/**\n* Set the pull direction of this pin.\n* @param name pin to set the pull mode on\n* @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n*/\n//% help=pins/set-pull weight=17 blockGap=8\n//% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid setPull(DigitalInOutPin name, PinPullMode pull) {\n PullMode m = pull == PinPullMode::PullDown ? PullMode::Down : pull == PinPullMode::PullUp\n ? PullMode::Up\n : PullMode::None;\n PINOP(setPull(m));\n}\n\n}\n\n#ifdef PXT_CODAL\n\nnamespace pxt {\n\nstatic void waitABit() {\n // for (int i = 0; i < 10; ++i)\n // asm volatile(\"nop\");\n}\n\nclass ButtonMultiplexer : public CodalComponent {\n public:\n Pin &latch;\n Pin &clock;\n Pin &data;\n uint32_t state;\n uint32_t invMask;\n uint16_t buttonIdPerBit[8];\n bool enabled;\n\n ButtonMultiplexer(uint16_t id)\n : latch(*LOOKUP_PIN(BTNMX_LATCH)), clock(*LOOKUP_PIN(BTNMX_CLOCK)),\n data(*LOOKUP_PIN(BTNMX_DATA)) {\n this->id = id;\n this->status |= DEVICE_COMPONENT_STATUS_SYSTEM_TICK;\n\n state = 0;\n invMask = 0;\n enabled = true;\n\n memset(buttonIdPerBit, 0, sizeof(buttonIdPerBit));\n\n data.getDigitalValue(PullMode::Down);\n latch.setDigitalValue(1);\n clock.setDigitalValue(1);\n }\n\n void disable() {\n data.getDigitalValue(PullMode::None);\n latch.getDigitalValue(PullMode::None);\n clock.getDigitalValue(PullMode::None);\n enabled = false;\n }\n\n bool isButtonPressed(int id) {\n for (int i = 0; i < 8; ++i) {\n if (buttonIdPerBit[i] == id)\n return (state & (1 << i)) != 0;\n }\n return false;\n }\n\n uint32_t readBits(int bits) {\n latch.setDigitalValue(0);\n waitABit();\n latch.setDigitalValue(1);\n waitABit();\n\n uint32_t state = 0;\n for (int i = 0; i < bits; i++) {\n state <<= 1;\n if (data.getDigitalValue(PullMode::Down))\n state |= 1;\n\n clock.setDigitalValue(0);\n waitABit();\n clock.setDigitalValue(1);\n waitABit();\n }\n\n return state;\n }\n\n virtual void periodicCallback() override {\n if (!enabled)\n return;\n\n uint32_t newState = readBits(8);\n newState ^= invMask;\n if (newState == state)\n return;\n\n for (int i = 0; i < 8; ++i) {\n uint32_t mask = 1 << i;\n if (!buttonIdPerBit[i])\n continue;\n int ev = 0;\n if (!(state & mask) && (newState & mask))\n ev = PXT_INTERNAL_KEY_DOWN;\n else if ((state & mask) && !(newState & mask))\n ev = PXT_INTERNAL_KEY_UP;\n if (ev) {\n Event(ev, buttonIdPerBit[i]);\n Event(ev, 0); // any key\n }\n }\n\n state = newState;\n }\n};\n\nstatic ButtonMultiplexer *btnMultiplexer;\nButtonMultiplexer *getMultiplexer() {\n if (!btnMultiplexer)\n btnMultiplexer = new ButtonMultiplexer(DEVICE_ID_FIRST_BUTTON);\n return btnMultiplexer;\n}\n\nint registerMultiplexedButton(int pin, int buttonId) {\n if (1050 <= pin && pin < 1058) {\n pin -= 50;\n getMultiplexer()->invMask |= 1 << (pin - 1000);\n }\n if (1000 <= pin && pin < 1008) {\n getMultiplexer()->buttonIdPerBit[pin - 1000] = buttonId;\n return 1;\n }\n return 0;\n}\n\nint multiplexedButtonIsPressed(int btnId) {\n if (btnMultiplexer)\n return btnMultiplexer->isButtonPressed(btnId) ? 512 : 0;\n return 0;\n}\n\n//% expose\nuint32_t readButtonMultiplexer(int bits) {\n if (!LOOKUP_PIN(BTNMX_CLOCK))\n return 0;\n return getMultiplexer()->readBits(bits);\n}\n\nvoid disableButtonMultiplexer() {\n if (LOOKUP_PIN(BTNMX_CLOCK)) {\n getMultiplexer()->disable();\n }\n}\n\n}\n\n#endif\n",
"pinsPWM.cpp": "#include \"pxt.h\"\n\nnamespace PwmPinMethods {\n}\n\nnamespace PwmOnlyPinMethods {\n\n/**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n//% help=pins/analog-set-period weight=51\n//% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid analogSetPeriod(PwmOnlyPin name, int period) {\n PINOP(setAnalogPeriodUs(period));\n}\n\n/**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n//% help=pins/servo-write weight=41 group=\"Servo\"\n//% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n//% parts=microservo trackArgs=0\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.defl=90\nvoid servoWrite(PwmOnlyPin name, int value) {\n PINOP(setServoValue(value));\n}\n\n/**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n//% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n//% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n//% parts=microservo blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid servoSetPulse(PwmOnlyPin name, int duration) {\n PINOP(setServoPulseUs(duration));\n}\n\n/**\n* Indicates if the servo is running continuously\n*/\n//% blockHidden=1\nvoid servoSetContinuous(PwmOnlyPin name, bool continuous) {\n // used by simulator\n}\n\n}",
"pinscompat.ts": "// filled in by microbit",
"platform.cpp": "#include \"pxt.h\"\n#include \"light.h\"\n\nnamespace pxt {\n\nCODAL_TIMER devTimer;\n\nstatic void initRandomSeed() {\n int seed = 0xC0DA1;\n auto pinTemp = LOOKUP_PIN(TEMPERATURE);\n if (pinTemp)\n seed *= pinTemp->getAnalogValue();\n auto pinLight = LOOKUP_PIN(LIGHT);\n if (pinLight)\n seed *= pinLight->getAnalogValue();\n seedRandom(seed);\n}\n\nstatic void remapSwdPin(int pinCfg, int fallback) {\n int pinName = getConfig(pinCfg);\n if (pinName == PA30 || pinName == PA31) {\n if (getConfig(CFG_SWD_ENABLED, 0)) {\n linkPin(pinName, fallback);\n } else {\n PORT->Group[pinName / 32].PINCFG[pinName % 32].reg = (uint8_t)PORT_PINCFG_INEN;\n }\n }\n}\n\nstatic void initSwdPins() {\n remapSwdPin(CFG_PIN_NEOPIXEL, PIN(D0));\n remapSwdPin(CFG_PIN_RXLED, PIN(D1));\n remapSwdPin(CFG_PIN_SPEAKER_AMP, PIN(D2));\n}\n\nvoid platform_init() {\n initSwdPins();\n initRandomSeed();\n light::clear();\n\n if (*HF2_DBG_MAGIC_PTR == HF2_DBG_MAGIC_START) {\n *HF2_DBG_MAGIC_PTR = 0;\n // this will cause alignment fault at the first breakpoint\n globals[0] = (TValue)1;\n }\n}\n\n} // namespace pxt\n",
"platform.h": "#ifndef __PXT_PLATFORM_H\n#define __PXT_PLATFORM_H\n\n// This is specific for SAMD21, to be replaced in other Codal targets.\n\n#include \"CapTouchButton.h\"\n#include \"Image.h\"\n#include \"MbedTimer.h\"\n#include \"MbedI2C.h\"\n#include \"MbedPin.h\"\n#include \"MbedSPI.h\"\n#include \"MbedSerial.h\"\n#include \"MultiButton.h\"\n#include \"CPlayI2C.h\"\n\n#include \"SAMD21DMAC.h\"\n\n// Analog Pins, all SAMD21: PA02-PA11 PB00-PB09 (some pins not connected)\n// 2 ports times 32 pins in each\n#define DEV_NUM_PINS 64\n// pins marked with AIN and PTC in the data sheet\n#define DEV_ANALOG_PINS 0x3ff00000ffcULL\n\n#define PAGE_SIZE 256\n\n#define CODAL_DMAC SAMD21DMAC\n\n// this is codal::_mbed for both mbed and mbedos now\n#define CODAL_MBED codal::_mbed\n\n#define CODAL_I2C codal::CPlayI2C\n\n#ifndef IMAGE_BITS\n#define IMAGE_BITS 1\n#endif\n\n#ifdef JUST_FOR_DAL_D_TS_CPP_WILL_IGNORE\n#define PA00 0\n#define PA01 1\n#define PA02 2\n#define PA03 3\n#define PA04 4\n#define PA05 5\n#define PA06 6\n#define PA07 7\n#define PA08 8\n#define PA09 9\n#define PA10 10\n#define PA11 11\n#define PA12 12\n#define PA13 13\n#define PA14 14\n#define PA15 15\n#define PA16 16\n#define PA17 17\n#define PA18 18\n#define PA19 19\n#define PA20 20\n#define PA21 21\n#define PA22 22\n#define PA23 23\n#define PA24 24\n#define PA25 25\n#define PA26 26\n#define PA27 27\n#define PA28 28\n#define PA29 29\n#define PA30 30\n#define PA31 31\n#define PB00 32\n#define PB01 33\n#define PB02 34\n#define PB03 35\n#define PB04 36\n#define PB05 37\n#define PB06 38\n#define PB07 39\n#define PB08 40\n#define PB09 41\n#define PB10 42\n#define PB11 43\n#define PB12 44\n#define PB13 45\n#define PB14 46\n#define PB15 47\n#define PB16 48\n#define PB17 49\n#define PB18 50\n#define PB19 51\n#define PB20 52\n#define PB21 53\n#define PB22 54\n#define PB23 55\n#define PB24 56\n#define PB25 57\n#define PB26 58\n#define PB27 59\n#define PB28 60\n#define PB29 61\n#define PB30 62\n#define PB31 63\n#endif\n\n#endif\n",
"pxt.h": "#ifndef __PXT_H\n#define __PXT_H\n\n#include \"pxtbase.h\"\n\n#include \"CodalConfig.h\"\n#include \"CodalHeapAllocator.h\"\n#include \"CodalDevice.h\"\n#include \"CodalDmesg.h\"\n#include \"ErrorNo.h\"\n#include \"Timer.h\"\n#include \"Matrix4.h\"\n#include \"CodalCompat.h\"\n#include \"CodalComponent.h\"\n#include \"ManagedType.h\"\n#include \"Event.h\"\n#include \"NotifyEvents.h\"\n#include \"Button.h\"\n#include \"CodalFiber.h\"\n#include \"MessageBus.h\"\n#include \"MultiButton.h\"\n\nusing namespace codal;\n\n// codal::ManagedString compat\n#define MSTR(s) codal::ManagedString((s)->data, (s)->length)\n#define PSTR(s) mkString((s).toCharArray(), (s).length())\n\n#include \"pins.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"hf2.h\"\n#include \"hf2dbg.h\"\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n#include \"HIDMouse.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n#include \"HIDKeyboard.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n#include \"HIDJoystick.h\"\n#endif\n#endif\n\n#define PXT_COMM_BASE 0x20002000 // 8k in\n\nnamespace pxt {\n\n#if CONFIG_ENABLED(DEVICE_USB)\nextern CodalUSB usb;\nextern HF2 hf2;\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nextern USBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nextern USBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nextern USBHIDJoystick joystick;\n#endif\n#endif\n\n// Utility functions\nextern Event lastEvent;\nextern CODAL_TIMER devTimer;\nextern MessageBus devMessageBus;\nextern codal::CodalDevice device;\n\nvoid set_usb_strings(const char *uf2_info);\nextern void (*logJDFrame)(const uint8_t *data);\nextern void (*sendJDFrame)(const uint8_t *data);\n\nstatic inline void raiseEvent(int src, int val) {\n Event(src, val);\n}\n\n} // namespace pxt\n\nnamespace pins {\nclass CodalSPIProxy;\nclass CodalI2CProxy;\n} // namespace pins\n\ntypedef pins::CodalI2CProxy* I2C_;\ntypedef pins::CodalSPIProxy* SPI_;\n\nnamespace pxt {\ncodal::LowLevelTimer *allocateTimer();\n\n#ifdef CODAL_I2C\nCODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl);\n#endif\nCODAL_SPI* getSPI(DigitalInOutPin mosi, DigitalInOutPin miso, DigitalInOutPin sck);\n#ifdef CODAL_JACDAC_WIRE_SERIAL\nLowLevelTimer* getJACDACTimer();\n#endif\nclass PressureButton;\nuint32_t readButtonMultiplexer(int bits);\nvoid disableButtonMultiplexer();\n}\n\nnamespace serial {\nclass CodalSerialDeviceProxy;\n}\n\ntypedef serial::CodalSerialDeviceProxy* SerialDevice;\n\nnamespace jacdac {\nclass JDProxyDriver;\n} // namespace network\n\ntypedef jacdac::JDProxyDriver* JacDacDriverStatus;\n\n#define DEVICE_ID_BUTTON_SLIDE 3000\n#define DEVICE_ID_MICROPHONE 3001\n#define DEVICE_ID_FIRST_BUTTON 4000\n#define DEVICE_ID_FIRST_TOUCHBUTTON 4100\n\n#define PXT_INTERNAL_KEY_UP 2050\n#define PXT_INTERNAL_KEY_DOWN 2051\n\n#endif\n",
"pxt.json": "{\n \"name\": \"core\",\n \"description\": \"The core library for Codal-based targets\",\n \"dependencies\": {\n \"base\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"dal.d.ts\",\n \"codal.cpp\",\n \"usb.cpp\",\n \"pxt.h\",\n \"platform.h\",\n \"platform.cpp\",\n \"pxtcore.h\",\n \"pins.h\",\n \"pins.cpp\",\n \"pinsAnalog.cpp\",\n \"pinsDigital.cpp\",\n \"pinsPWM.cpp\",\n \"pins.ts\",\n \"pinscompat.ts\",\n \"control.cpp\",\n \"i2c.cpp\",\n \"i2c.ts\",\n \"spi.cpp\",\n \"spi.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"hf2.cpp\",\n \"hf2.h\",\n \"hf2dbg.h\",\n \"uf2format.h\",\n \"uf2hid.h\",\n \"ns.ts\",\n \"dmac.cpp\",\n \"dmac.h\",\n \"timer.ts\",\n \"light.cpp\",\n \"light.h\",\n \"keyvaluestorage.cpp\",\n \"keyvaluestorage.ts\",\n \"leveldetector.ts\",\n \"pxtparts.json\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"yotta\": {\n \"config\": {\n \"codal\": {\n \"component_count\": 64,\n \"dmesg_buffer_size\": 1024\n }\n }\n },\n \"dalDTS\": {\n \"includeDirs\": [\n \"libraries/codal-core/inc\",\n \"pxtapp\"\n ],\n \"excludePrefix\": [\n \"JD_\",\n \"USB_\",\n \"REQUEST_\",\n \"LIS3DH_\",\n \"FXOS8700_\",\n \"HF2_\",\n \"PXT_REF_TAG_\",\n \"MS_\",\n \"SCSI_\",\n \"MAG_\",\n \"MAG3\",\n \"MPU6\",\n \"MADCTL\",\n \"MMA8\"\n ]\n }\n}\n",
"pxtcore.h": "#ifndef __PXTCORE_H\n#define __PXTCORE_H\n\n#include \"CodalDmesg.h\"\n#include \"CodalHeapAllocator.h\"\n\n#define PXT_CODAL 1\n\n#define itoa(a, b) codal::itoa(a, b)\n\n#define GC_GET_HEAP_SIZE() device_heap_size(0)\n#define GC_STACK_BASE DEVICE_STACK_BASE\n#define xmalloc device_malloc\n#define xfree device_free\n\n// on most devices we allocate the entire heap at once, so large allocs should work\n// if they don't you just get the regular out of memory instead of alloc too large\n#define GC_MAX_ALLOC_SIZE (128 * 1024)\n\n#endif\n",
"pxtparts.json": "{\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\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createStrip,light.createNeoPixelStrip\",\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 \"dotstar\": {\n \"simulationBehavior\": \"dotstar\",\n \"visual\": {\n \"builtIn\": \"dotstar\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 1\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createAPA102Strip\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"dataPin\"\n },\n {\n \"pinInstantiationIdx\": 1,\n \"partParameter\": \"clkPin\"\n },\n {\n \"partParameter\": \"mode\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n },\n \"pixels\": {\n \"simulationBehavior\": \"pixels\",\n \"visual\": { \n \"builtIn\": \"pixels\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"MOSI\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"SCK\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\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, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n }, \n \"buttons\": {\n \"simulationBehavior\": \"buttons\",\n \"visual\": {\n \"builtIn\": \"buttons\",\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 },\n \"numberOfPins\": 2,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"Button.onEvent,Button.isPressed,Button.wasPressed\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"button\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n }\n ]\n },\n \"slideswitch\": {\n \"numberOfPins\": 3,\n \"simulationBehavior\": \"slideswitch\",\n \"visual\": {\n \"builtIn\": \"slideswitch\",\n \"width\": 100,\n \"height\": 100,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 30,\n \"y\": 0\n },\n {\n \"x\": 45,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalRead,DigitalInOutPin.onPulsed,DigitalInOutPin.onEvent\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"pin\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\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 \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"PwmOnlyPin.servoWrite,servos.Servo.setAngle,servos.Servo.run,servos.Servo.setPulse\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\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 \"led\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"analogled\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogOutPin.analogWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"photocell\": {\n \"numberOfPins\": 3,\n \"visual\": {\n \"builtIn\": \"photocell\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 15,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"photocell\",\n \"pinDefinitions\": [\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogInPin.analogRead\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n }\n}",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace light {\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //% shim=light::sendBuffer\n function sendBuffer(data: DigitalInOutPin, clk: DigitalInOutPin, mode: int32, buf: Buffer): void;\n}\ndeclare namespace control {\n\n /**\n * Determines if the USB has been enumerated.\n */\n //% shim=control::isUSBInitialized\n function isUSBInitialized(): boolean;\n}\ndeclare namespace pins {\n\n /**\n * Get a pin by configuration id (DAL.CFG_PIN...)\n */\n //% shim=pins::pinByCfg\n function pinByCfg(key: int32): DigitalInOutPin;\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 * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n //% help=pins/pulse-duration blockGap=8\n //% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n //% weight=19 shim=pins::pulseDuration\n function pulseDuration(): int32;\n}\n\n\ndeclare interface AnalogInPin {\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\n */\n //% help=pins/analog-read weight=53\n //% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=AnalogInPinMethods::analogRead\n analogRead(): int32;\n}\n\n\ndeclare interface AnalogOutPin {\n /**\n * Set the connector value as analog. Value must be comprised between 0 and 1023.\n * @param name pin name to write to\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n //% help=pins/analog-write weight=52\n //% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.min=0 value.max=1023 shim=AnalogOutPinMethods::analogWrite\n analogWrite(value: int32): void;\n}\n\n\ndeclare interface DigitalInOutPin {\n /**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n //% help=pins/digital-read weight=61\n //% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalRead\n digitalRead(): boolean;\n\n /**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n //% help=pins/digital-write weight=60\n //% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalWrite\n digitalWrite(value: boolean): void;\n\n /**\n * Make this pin a digital input, and create events where the timestamp is the duration\n * that this pin was either ``high`` or ``low``.\n */\n //% help=pins/on-pulsed weight=16 blockGap=8\n //% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4\n //% deprecated=1 hidden=1 shim=DigitalInOutPinMethods::onPulsed\n onPulsed(pulse: PulseValue, body: () => void): void;\n\n /**\n * Register code to run when a pin event occurs. \n */\n //% help=pins/on-event weight=20 blockGap=8\n //% blockId=pinsonevent block=\"on|pin %pin|%event\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 shim=DigitalInOutPinMethods::onEvent\n onEvent(event: PinEvent, body: () => void): void;\n\n /**\n * Return the duration of a pulse in microseconds\n * @param name the pin which measures the pulse\n * @param value the value of the pulse (default high)\n * @param maximum duration in micro-seconds\n */\n //% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n //% weight=18 blockGap=8\n //% help=\"pins/pulse-in\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 maxDuration.defl=2000000 shim=DigitalInOutPinMethods::pulseIn\n pulseIn(value: PulseValue, maxDuration?: int32): int32;\n\n /**\n * Set the pull direction of this pin.\n * @param name pin to set the pull mode on\n * @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n */\n //% help=pins/set-pull weight=17 blockGap=8\n //% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::setPull\n setPull(pull: PinPullMode): void;\n}\n\n\ndeclare interface PwmPin {}\n\n\ndeclare interface PwmOnlyPin {\n /**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n //% help=pins/analog-set-period weight=51\n //% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::analogSetPeriod\n analogSetPeriod(period: int32): void;\n\n /**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n //% help=pins/servo-write weight=41 group=\"Servo\"\n //% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n //% parts=microservo trackArgs=0\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.defl=90 shim=PwmOnlyPinMethods::servoWrite\n servoWrite(value?: int32): void;\n\n /**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n //% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n //% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n //% parts=microservo blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::servoSetPulse\n servoSetPulse(duration: int32): void;\n\n /**\n * Indicates if the servo is running continuously\n */\n //% blockHidden=1 shim=PwmOnlyPinMethods::servoSetContinuous\n servoSetContinuous(continuous: boolean): void;\n}\ndeclare namespace control {\n\n /**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\"\n //% help=control/raise-event\n //% block=\"raise event|from %src|with value %value\" blockExternalInputs=1 shim=control::raiseEvent\n function raiseEvent(src: int32, value: int32): void;\n\n /**\n * Determine the version of system software currently running.\n */\n //% blockId=\"control_device_dal_version\" block=\"device dal version\"\n //% help=control/device-dal-version shim=control::deviceDalVersion\n function deviceDalVersion(): string;\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}\n\n\ndeclare interface I2C {\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::readBuffer\n readBuffer(address: int32, size: int32, repeat?: boolean): Buffer;\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::writeBuffer\n writeBuffer(address: int32, buf: Buffer, repeat?: boolean): int32;\n}\ndeclare namespace pins {\n\n /**\n * Opens a Serial communication driver\n */\n //% help=pins/create-i2c\n //% parts=i2c shim=pins::createI2C\n function createI2C(sda: DigitalInOutPin, scl: DigitalInOutPin): I2C;\n}\ndeclare namespace pins {\n\n /**\n * Opens a SPI driver\n */\n //% help=pins/create-spi\n //% parts=spi shim=pins::createSPI\n function createSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin): SPI;\n\n /**\n * Opens a slave SPI driver\n */\n //% parts=spi shim=pins::createSlaveSPI\n function createSlaveSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin, csPin: DigitalInOutPin): SPI;\n}\n\n\ndeclare interface SPI {\n /**\n * Write to the SPI bus\n */\n //% shim=SPIMethods::write\n write(value: int32): int32;\n\n /**\n * Transfer buffers over the SPI bus\n */\n //% argsNullable shim=SPIMethods::transfer\n transfer(command: Buffer, response: Buffer): void;\n\n /**\n * Sets the SPI clock frequency\n */\n //% shim=SPIMethods::setFrequency\n setFrequency(frequency: int32): void;\n\n /**\n * Sets the SPI bus mode\n */\n //% shim=SPIMethods::setMode\n setMode(mode: int32): void;\n}\ndeclare namespace configStorage {\n\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //% shim=configStorage::setBuffer\n function setBuffer(key: string, value: Buffer): void;\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::getBuffer\n function getBuffer(key: string): Buffer;\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::removeItem\n function removeItem(key: string): void;\n\n /**\n * Clears the local storage\n */\n //% shim=configStorage::clear\n function clear(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"spi.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n\nnamespace pins {\n\nclass CodalSPIProxy {\nprivate:\n DevicePin* mosi; \n DevicePin* miso; \n DevicePin* sck;\n CODAL_SPI spi;\npublic:\n CodalSPIProxy* next;\n\npublic:\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck) \n , next(NULL)\n {\n }\n\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck, DevicePin* _cs)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck, _cs) \n , next(NULL)\n {\n }\n#endif\n\n CODAL_SPI* getSPI() {\n return &spi;\n }\n\n bool matchPins(DevicePin* mosi, DevicePin* miso, DevicePin* sck) {\n return this->mosi == mosi && this->miso == miso && this->sck == sck;\n }\n\n int write(int value) {\n return spi.write(value);\n }\n\n void transfer(Buffer command, Buffer response) {\n auto cdata = NULL == command ? NULL : command->data;\n auto clength = NULL == command ? 0 : command->length;\n auto rdata = NULL == response ? NULL : response->data;\n auto rlength = NULL == response ? 0 : response->length;\n spi.transfer(cdata, clength, rdata, rlength);\n }\n\n void setFrequency(int frequency) {\n spi.setFrequency(frequency);\n }\n\n void setMode(int mode) {\n spi.setMode(mode);\n }\n};\n\nSPI_ spis(NULL);\n\n/**\n* Opens a SPI driver\n*/\n//% help=pins/create-spi\n//% parts=spi\nSPI_ createSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto dev = spis;\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin);\n ser->next = spis;\n spis = ser;\n return ser;\n}\n\n/**\n* Opens a slave SPI driver\n*/\n//% parts=spi\nSPI_ createSlaveSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin, DigitalInOutPin csPin) {\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n auto dev = spis;\n if (!csPin)\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin, csPin);\n ser->next = spis;\n spis = ser;\n return ser;\n#else\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n return NULL;\n#endif\n}\n\n}\n\nnamespace pxt {\n\nCODAL_SPI* getSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto spi = pins::createSPI(mosiPin, misoPin, sckPin);\n return spi->getSPI();\n}\n\n}\n\nnamespace SPIMethods {\n\n/**\n* Write to the SPI bus\n*/\n//%\nint write(SPI_ device, int value) {\n return device->write(value);\n}\n\n/**\n* Transfer buffers over the SPI bus\n*/\n//% argsNullable\nvoid transfer(SPI_ device, Buffer command, Buffer response) {\n if (!device)\n soft_panic(PANIC_CAST_FROM_NULL);\n if (!command && !response)\n return;\n device->transfer(command, response);\n}\n\n/**\n* Sets the SPI clock frequency\n*/\n//%\nvoid setFrequency(SPI_ device, int frequency) {\n device->setFrequency(frequency);\n}\n\n/**\n* Sets the SPI bus mode\n*/\n//%\nvoid setMode(SPI_ device, int mode) {\n device->setMode(mode);\n}\n\n}\n",
"spi.ts": "namespace pins {\n\n let _spi: SPI;\n /**\n * Gets the default SPI driver\n */\n //%\n export function spi() {\n if (!_spi) {\n const mosi = pins.pinByCfg(DAL.CFG_PIN_MOSI);\n const miso = pins.pinByCfg(DAL.CFG_PIN_MISO);\n const sck = pins.pinByCfg(DAL.CFG_PIN_SCK);\n _spi = pins.createSPI(mosi, miso, sck);\n }\n return _spi;\n }\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 weight=5 advanced=true\n //% blockId=spi_write block=\"spi write %value\"\n export function spiWrite(value: number) {\n return spi().write(value);\n }\n\n /**\n * Write a given command to SPI bus, and at the same time read the response.\n */\n //% help=pins/spi-transfer weight=4 advanced=true\n //% blockId=spi_transfer block=\"spi transfer %command into %response\"\n export function spiTransfer(command: Buffer, response: Buffer) {\n spi().transfer(command, response);\n }\n\n /**\n * Set the SPI frequency\n * @param frequency the clock frequency, eg: 1000000\n */\n //% help=pins/spi-frequency weight=4 advanced=true\n //% blockId=spi_frequency block=\"spi frequency %frequency\"\n export function spiFrequency(frequency: number) {\n spi().setFrequency(frequency);\n }\n\n /**\n * Set the SPI signal mode\n * @param mode the mode, eg: 3\n */\n //% help=pins/spi-mode weight=3 advanced=true\n //% blockId=spi_mode block=\"spi mode %mode\"\n export function spiMode(mode: number) {\n spi().setMode(mode);\n }\n}",
"test.ts": "let i = 1\nlet f = 0.5\nlet plus = i + f\nlet minus = i - f\n\nlet r = Math.random()\nlet ri = Math.randomRange(5, 10)\n\n",
"timer.ts": "namespace control {\n /**\n * A timer\n */\n //% fixedInstances\n export class Timer {\n start: number;\n\n constructor() {\n this.start = control.millis();\n }\n\n /**\n * Gets the elapsed time in millis since the last reset\n */\n //% blockId=timerMillis block=\"%timer|millis\"\n millis(): number {\n return control.millis() - this.start;\n }\n\n /**\n * Gets the elapsed time in seconds since the last reset\n */\n //% blockId=timerSeconds block=\"%timer|seconds\"\n seconds(): number {\n return this.millis() / 1000;\n }\n\n /**\n * Resets the timer\n */\n //% blockId=timerRest block=\"%timer|reset\"\n reset() {\n this.start = control.millis();\n }\n\n /**\n * Pauses until the timer reaches the given amount of milliseconds\n * @param ms how long to pause for, eg: 5, 100, 200, 500, 1000, 2000\n */\n //% blockId=timerPauseUntil block=\"%timer|pause until (ms) %ms\"\n pauseUntil(ms: number) {\n const remaining = this.millis() - ms;\n pause(Math.max(0, remaining));\n }\n }\n\n //% whenUsed fixedInstance block=\"timer 1\"\n export const timer1 = new Timer();\n //% whenUsed fixedInstance block=\"timer 2\"\n export const timer2 = new Timer();\n //% whenUsed fixedInstance block=\"timer 3\"\n export const timer3 = new Timer();\n //% whenUsed fixedInstance block=\"timer 4\"\n export const timer4 = new Timer();\n //% whenUsed fixedInstance block=\"timer 5\"\n export const timer5 = new Timer();\n //% whenUsed fixedInstance block=\"timer 6\"\n export const timer6 = new Timer();\n //% whenUsed fixedInstance block=\"timer 7\"\n export const timer7 = new Timer();\n //% whenUsed fixedInstance block=\"timer 8\"\n export const timer8 = new Timer();\n}",
"uf2format.h": "#ifndef UF2FORMAT_H\n#define UF2FORMAT_H 1\n\n#include \n#include \n\n// All entries are little endian.\n\n#ifndef BOOTLOADER_START\n#define BOOTLOADER_START 0x0\n#endif\n\n#ifndef BOOTLOADER_END\n#define BOOTLOADER_END 0x2000\n#endif\n\n#ifndef UF2_BINFO\n#define UF2_BINFO ((UF2_BInfo *)(BOOTLOADER_END - sizeof(UF2_BInfo)))\n#endif\n\n#ifndef UF2_INFO_TXT\n#define UF2_INFO_TXT UF2_BINFO->info_uf2\n#endif\n\n\n#define UF2_MAGIC_START0 0x0A324655UL // \"UF2\\n\"\n#define UF2_MAGIC_START1 0x9E5D5157UL // Randomly selected\n#define UF2_MAGIC_END 0x0AB16F30UL // Ditto\n\n// If set, the block is \"comment\" and should not be flashed to the device\n#define UF2_FLAG_NOFLASH 0x00000001\n\ntypedef struct {\n // 32 byte header\n uint32_t magicStart0;\n uint32_t magicStart1;\n uint32_t flags;\n uint32_t targetAddr;\n uint32_t payloadSize;\n uint32_t blockNo;\n uint32_t numBlocks;\n uint32_t reserved;\n\n // raw data;\n uint8_t data[476];\n\n // store magic also at the end to limit damage from partial block reads\n uint32_t magicEnd;\n} UF2_Block;\n\ntypedef struct {\n uint8_t version;\n uint8_t ep_in;\n uint8_t ep_out;\n uint8_t reserved0;\n uint32_t cbw_tag;\n uint32_t blocks_remaining;\n uint8_t *buffer;\n} UF2_HandoverArgs;\n\ntypedef void (*UF2_MSC_Handover_Handler)(UF2_HandoverArgs *handover);\ntypedef void (*UF2_HID_Handover_Handler)(int ep);\n\n// this is required to be exactly 16 bytes long by the linker script\ntypedef struct {\n void *reserved0;\n UF2_HID_Handover_Handler handoverHID;\n UF2_MSC_Handover_Handler handoverMSC;\n const char *info_uf2;\n} UF2_BInfo;\n\nstatic inline bool is_uf2_block(void *data) {\n UF2_Block *bl = (UF2_Block *)data;\n return bl->magicStart0 == UF2_MAGIC_START0 && bl->magicStart1 == UF2_MAGIC_START1 &&\n bl->magicEnd == UF2_MAGIC_END;\n}\n\nstatic inline bool in_uf2_bootloader_space(const void *addr) {\n return (BOOTLOADER_START + 0x100) <= (uint32_t)addr && (uint32_t)addr < (BOOTLOADER_END);\n}\n\nstatic inline const char *uf2_info(void) {\n if (in_uf2_bootloader_space(UF2_INFO_TXT))\n return UF2_INFO_TXT;\n return \"N/A\";\n}\n\n#ifdef UF2_DEFINE_HANDOVER\nstatic inline void hf2_handover(uint8_t ep) {\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_HID_Handover_Handler fn = UF2_BINFO->handoverHID;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n // Pass control to bootloader; never returns\n fn(ep & 0xf);\n }\n}\n\nstatic inline void check_uf2_handover(uint8_t *buffer, uint32_t blocks_remaining, uint8_t ep_in,\n uint8_t ep_out, uint32_t cbw_tag) {\n if (!is_uf2_block(buffer))\n return;\n\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_MSC_Handover_Handler fn = UF2_BINFO->handoverMSC;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n UF2_HandoverArgs hand = {\n 1, ep_in, ep_out, 0, cbw_tag, blocks_remaining, buffer,\n };\n // Pass control to bootloader; never returns\n fn(&hand);\n }\n}\n#endif\n\n#endif\n",
"uf2hid.h": "#ifndef UF2_HID_H\n#define UF2_HID_H 1\n\n#define HF2_CMD_BININFO 0x0001\n// no arguments\n#define HF2_MODE_BOOTLOADER 0x01\n#define HF2_MODE_USERSPACE 0x02\nstruct HF2_BININFO_Result {\n uint32_t mode;\n uint32_t flash_page_size;\n uint32_t flash_num_pages;\n uint32_t max_message_size;\n uint32_t uf2_family;\n};\n\n#define HF2_CMD_INFO 0x0002\n// no arguments\n// results is utf8 character array\n\n#define HF2_CMD_RESET_INTO_APP 0x0003\n// no arguments, no result\n\n#define HF2_CMD_RESET_INTO_BOOTLOADER 0x0004\n// no arguments, no result\n\n#define HF2_CMD_START_FLASH 0x0005\n// no arguments, no result\n\n#define HF2_CMD_WRITE_FLASH_PAGE 0x0006\nstruct HF2_WRITE_FLASH_PAGE_Command {\n uint32_t target_addr;\n uint32_t data[0];\n};\n// no result\n\n#define HF2_CMD_CHKSUM_PAGES 0x0007\nstruct HF2_CHKSUM_PAGES_Command {\n uint32_t target_addr;\n uint32_t num_pages;\n};\nstruct HF2_CHKSUM_PAGES_Result {\n uint16_t chksums[0 /* num_pages */];\n};\n\n#define HF2_CMD_READ_WORDS 0x0008\nstruct HF2_READ_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n};\nstruct HF2_READ_WORDS_Result {\n uint32_t words[0 /* num_words */];\n};\n\n#define HF2_CMD_WRITE_WORDS 0x0009\nstruct HF2_WRITE_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n uint32_t words[0 /* num_words */];\n};\n// no result\n\n#define HF2_CMD_DMESG 0x0010\n// no arguments\n// results is utf8 character array\n\n#define HF2_EV_MASK 0x800000\n\n#define HF2_CMD_JDS_CONFIG 0x0020\n#define HF2_CMD_JDS_SEND 0x0021\n#define HF2_EV_JDS_PACKET 0x800020\n\ntypedef struct {\n uint32_t command_id;\n uint16_t tag;\n uint8_t reserved0;\n uint8_t reserved1;\n\n union {\n struct HF2_WRITE_FLASH_PAGE_Command write_flash_page;\n struct HF2_WRITE_WORDS_Command write_words;\n struct HF2_READ_WORDS_Command read_words;\n struct HF2_CHKSUM_PAGES_Command chksum_pages;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Command;\n\ntypedef struct {\n union {\n uint32_t eventId;\n struct {\n uint16_t tag;\n union {\n struct {\n uint8_t status;\n uint8_t status_info;\n };\n uint16_t status16;\n };\n };\n };\n union {\n struct HF2_BININFO_Result bininfo;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Response;\n\n#define HF2_FLAG_SERIAL_OUT 0x80\n#define HF2_FLAG_SERIAL_ERR 0xC0\n#define HF2_FLAG_CMDPKT_LAST 0x40\n#define HF2_FLAG_CMDPKT_BODY 0x00\n#define HF2_FLAG_MASK 0xC0\n#define HF2_SIZE_MASK 63\n\n#define HF2_STATUS_OK 0x00\n#define HF2_STATUS_INVALID_CMD 0x01\n#define HF2_STATUS_INVALID_STATE 0x02\n\n#endif\n",
"usb.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"uf2format.h\"\n\nnamespace pxt {\nCodalUSB usb;\n\n// share the buffer; we will crash anyway if someone talks to us over both at the same time\nHF2_Buffer hf2buf;\nHF2 hf2(hf2buf);\n#ifdef HF2_HID\nHF2 hf2hid(hf2buf);\n#endif\nDummyIface dummyIface;\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nUSBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nUSBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nUSBHIDJoystick joystick;\n#endif\n\nstatic const DeviceDescriptor device_desc = {\n 0x12, // bLength\n 0x01, // bDescriptorType\n 0x0210, // bcdUSBL\n\n // Class etc specified per-interface\n 0x00, 0x00, 0x00,\n\n 0x40, // bMaxPacketSize0\n USB_DEFAULT_VID, USB_DEFAULT_PID,\n 0x4202, // bcdDevice - leave unchanged for the HF2 to work\n 0x01, // iManufacturer\n 0x02, // iProduct\n 0x03, // SerialNumber\n 0x01 // bNumConfigs\n};\n\nstatic void start_usb() {\n // start USB with a delay, so that user code can add new interfaces if needed\n // (eg USB HID keyboard, or MSC)\n fiber_sleep(500);\n usb.start();\n}\n\nvoid platform_usb_init() __attribute__((weak));\nvoid platform_usb_init() {}\n\nvoid set_usb_strings(const char *uf2_info) {\n static const char *string_descriptors[3];\n static char serial[12];\n itoa(target_get_serial() & 0x7fffffff, serial);\n\n auto model = strstr(uf2_info, \"Model: \");\n if (model) {\n model += 7;\n auto end = model;\n while (*end && *end != '\\n' && *end != '\\r')\n end++;\n auto len = end - model;\n auto dev = (char *)app_alloc(len + 10);\n memcpy(dev, model, len);\n strcpy(dev + len, \" (app)\");\n // try to split into manufacturer and\n auto sep = strstr(dev, \" / \");\n if (sep) {\n *sep = '\\0';\n string_descriptors[0] = dev;\n string_descriptors[1] = sep + 3;\n } else {\n string_descriptors[0] = dev;\n string_descriptors[1] = dev;\n }\n } else {\n string_descriptors[0] = \"Unknown Corp.\";\n string_descriptors[1] = \"PXT Device (app)\";\n }\n\n string_descriptors[2] = serial;\n usb.stringDescriptors = string_descriptors;\n}\n\nvoid usb_init() {\n usb.deviceDescriptor = &device_desc;\n set_usb_strings(UF2_INFO_TXT);\n\n platform_usb_init();\n\n usb.add(hf2);\n\n#ifdef HF2_HID\n hf2hid.useHID = true;\n usb.add(hf2hid);\n#else\n // the WINUSB descriptors don't seem to work if there's only one interface\n // so we add a dummy interface\n usb.add(dummyIface);\n#endif\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n usb.add(mouse);\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n usb.add(keyboard);\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n usb.add(joystick);\n#endif\n\n create_fiber(start_usb);\n}\n\n} // namespace pxt\n\n#else\nnamespace pxt {\nvoid usb_init() {}\n} // namespace pxt\n#endif\n\nnamespace control {\n/**\n * Determines if the USB has been enumerated.\n */\n//%\nbool isUSBInitialized() {\n#if CONFIG_ENABLED(DEVICE_USB)\n return pxt::usb.isInitialised();\n#else\n return false;\n#endif\n}\n} // namespace control\n\nnamespace pxt {\nstatic void (*pSendToUART)(const char *data, int len) = NULL;\nvoid setSendToUART(void (*f)(const char *, int)) {\n pSendToUART = f;\n}\n\nvoid sendSerial(const char *data, int len) {\n#if CONFIG_ENABLED(DEVICE_USB)\n hf2.sendSerial(data, len);\n#if HF2_HID\n hf2hid.sendSerial(data, len);\n#endif\n#endif\n if (pSendToUART)\n pSendToUART(data, len);\n}\n\nvoid dumpDmesg() {\n sendSerial(\"\\nDMESG:\\n\", 8);\n sendSerial(codalLogStore.buffer, codalLogStore.ptr);\n sendSerial(\"\\n\\n\", 2);\n}\n\nvoid (*logJDFrame)(const uint8_t *data);\nvoid (*sendJDFrame)(const uint8_t *data);\n\n} // namespace pxt\n"
},
"core---stm32": {
"README.md": "# core\n\nThe core library for Codal-based targets.\n\n",
"codal.cpp": "#include \"pxt.h\"\n#include \"LowLevelTimer.h\"\nusing namespace codal;\n\nvoid cpu_clock_init(void);\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#ifdef DEVICE_GET_FIBER_LIST_AVAILABLE\n// newer codal-core has get_fiber_list() but not list_fibers()\nnamespace codal {\n/*\n * Return all current fibers.\n *\n * @param dest If non-null, it points to an array of pointers to fibers to store results in.\n *\n * @return the number of fibers (potentially) stored\n */\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\nnamespace pxt {\n\nvoid platform_init();\nvoid usb_init();\n\n// The first two word are used to tell the bootloader that a single reset should start the\n// bootloader and the MSD device, not us.\n// The rest is reserved for partial flashing checksums.\n__attribute__((section(\".binmeta\"))) __attribute__((used)) const uint32_t pxt_binmeta[] = {\n 0x87eeb07c, 0x87eeb07c, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n};\n\nEvent lastEvent;\nMessageBus devMessageBus;\ncodal::CodalDevice device;\n\nstruct FreeList {\n FreeList *next;\n};\n\nstatic void commInit() {\n int commSize = bytecode[20];\n if (!commSize)\n return;\n\n void *r = app_alloc_at((void *)PXT_COMM_BASE, commSize);\n DMESG(\"comm %d -> %p\", commSize, r);\n if (!r)\n target_panic(20);\n}\n\nstatic void initCodal() {\n cpu_clock_init();\n\n commInit();\n\n // Bring up fiber scheduler.\n scheduler_init(devMessageBus);\n\n // We probably don't need that - components are initialized when one obtains\n // the reference to it.\n // devMessageBus.listen(DEVICE_ID_MESSAGE_BUS_LISTENER, DEVICE_EVT_ANY, this,\n // &CircuitPlayground::onListenerRegisteredEvent);\n\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; i++) {\n if (CodalComponent::components[i])\n CodalComponent::components[i]->init();\n }\n\n usb_init();\n\n auto led = LOOKUP_PIN(LED);\n if (led) {\n led->setDigitalValue(0);\n }\n}\n\n// ---------------------------------------------------------------------------\n// An adapter for the API expected by the run-time.\n// ---------------------------------------------------------------------------\n\n// We have the invariant that if [dispatchEvent] is registered against the DAL\n// for a given event, then [handlersMap] contains a valid entry for that\n// event.\nvoid dispatchEvent(Event e) {\n lastEvent = e;\n\n auto curr = findBinding(e.source, e.value);\n auto value = fromInt(e.value);\n while (curr) {\n runAction1(curr->action, value);\n curr = nextBinding(curr->next, e.source, e.value);\n }\n}\n\nvoid registerWithDal(int id, int event, Action a, int flags) {\n // first time?\n if (!findBinding(id, event)) {\n devMessageBus.listen(id, event, dispatchEvent, flags);\n if (event == 0) {\n // we're registering for all events on given ID\n // need to remove old listeners for specific events\n auto curr = findBinding(id, -1);\n while (curr) {\n devMessageBus.ignore(id, curr->value, dispatchEvent);\n curr = nextBinding(curr->next, id, -1);\n }\n }\n }\n setBinding(id, event, a);\n}\n\nvoid fiberDone(void *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 target_wait_us(us);\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 registerGCPtr(a);\n create_fiber(forever_stub, (void *)a);\n }\n}\n\nvoid runInParallel(Action a) {\n if (a != 0) {\n registerGCPtr(a);\n create_fiber((void (*)(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 initSystemTimer();\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\nuint64_t getLongSerialNumber() {\n return device.getSerialNumber();\n}\n\nint current_time_ms() {\n return system_timer_current_time();\n}\n\nuint64_t current_time_us() {\n return system_timer_current_time_us();\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\nstatic void *threadAddressFor(codal::Fiber *fib, void *sp) {\n if (fib == currentFiber)\n return sp;\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 int numFibers = codal::list_fibers(NULL);\n codal::Fiber **fibers = (codal::Fiber **)xmalloc(sizeof(codal::Fiber *) * numFibers);\n int num2 = codal::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 gcProcess(ctx->thrownValue);\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 xfree(fibers);\n}\n\nLowLevelTimer *getJACDACTimer() {\n static LowLevelTimer *jacdacTimer;\n if (!jacdacTimer) {\n jacdacTimer = allocateTimer();\n jacdacTimer->setIRQPriority(1);\n }\n return jacdacTimer;\n}\nvoid initSystemTimer() {\n new CODAL_TIMER(*allocateTimer());\n}\n\n} // namespace pxt\n",
"control.cpp": "#include \"pxt.h\"\n\n#if defined(NRF52_SERIES) || defined(PICO_BOARD)\n#define _estack __StackTop \n#endif\nextern uint32_t _estack;\n\nnamespace control {\n\n/**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n//% weight=21 blockGap=12 blockId=\"control_raise_event\"\n//% help=control/raise-event\n//% block=\"raise event|from %src|with value %value\" blockExternalInputs=1\nvoid raiseEvent(int src, int value) {\n Event evt(src, value);\n}\n\n/**\n* Determine the version of system software currently running.\n*/\n//% blockId=\"control_device_dal_version\" block=\"device dal version\"\n//% help=control/device-dal-version\nString deviceDalVersion() {\n return mkString(device.getVersion());\n}\n\n/**\n* Allocates the next user notification event\n*/\n//% help=control/allocate-notify-event\nint allocateNotifyEvent() {\n return ::allocateNotifyEvent();\n}\n\n/** Write a message to DMESG debugging buffer. */\n//%\nvoid dmesg(String s) {\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 DMESG(\"# %s: %p\", str->getUTF8Data(), ptr);\n}\n\n//%\nuint32_t _ramSize()\n{\n return (uint32_t)&_estack & 0x1fffffff;\n}\n\n}\n",
"dal.d.ts": "// Auto-generated. Do not edit.\ndeclare const enum DAL {\n // /libraries/codal-core/inc/core/CodalComponent.h\n DEVICE_ID_BUTTON_A = 1,\n DEVICE_ID_BUTTON_B = 2,\n DEVICE_ID_BUTTON_AB = 3,\n DEVICE_ID_BUTTON_RESET = 4,\n DEVICE_ID_ACCELEROMETER = 5,\n DEVICE_ID_COMPASS = 6,\n DEVICE_ID_DISPLAY = 7,\n DEVICE_ID_THERMOMETER = 8,\n DEVICE_ID_RADIO = 9,\n DEVICE_ID_RADIO_DATA_READY = 10,\n DEVICE_ID_MULTIBUTTON_ATTACH = 11,\n DEVICE_ID_SERIAL = 12,\n DEVICE_ID_GESTURE = 13,\n DEVICE_ID_SYSTEM_TIMER = 14,\n DEVICE_ID_SCHEDULER = 15,\n DEVICE_ID_COMPONENT = 16,\n DEVICE_ID_LIGHT_SENSOR = 17,\n DEVICE_ID_TOUCH_SENSOR = 18,\n DEVICE_ID_SYSTEM_DAC = 19,\n DEVICE_ID_SYSTEM_MICROPHONE = 20,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR = 21,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR_SPL = 22,\n DEVICE_ID_MSC = 23,\n DEVICE_ID_SPI = 24,\n DEVICE_ID_DISTANCE = 25,\n DEVICE_ID_GYROSCOPE = 26,\n DEVICE_ID_HUMIDITY = 27,\n DEVICE_ID_PRESSURE = 28,\n DEVICE_ID_SINGLE_WIRE_SERIAL = 29,\n DEVICE_ID_JACDAC = 30,\n DEVICE_ID_JACDAC_PHYS = 31,\n DEVICE_ID_JACDAC_CONTROL_SERVICE = 32,\n DEVICE_ID_JACDAC_CONFIGURATION_SERVICE = 33,\n DEVICE_ID_SYSTEM_ADC = 34,\n DEVICE_ID_PULSE_IN = 35,\n DEVICE_ID_USB = 36,\n DEVICE_ID_IO_P0 = 100,\n DEVICE_ID_MESSAGE_BUS_LISTENER = 1021,\n DEVICE_ID_NOTIFY_ONE = 1022,\n DEVICE_ID_NOTIFY = 1023,\n DEVICE_ID_BUTTON_UP = 2000,\n DEVICE_ID_BUTTON_DOWN = 2001,\n DEVICE_ID_BUTTON_LEFT = 2002,\n DEVICE_ID_BUTTON_RIGHT = 2003,\n DEVICE_ID_JD_DYNAMIC_ID = 3000,\n DEVICE_COMPONENT_RUNNING = 4096,\n DEVICE_COMPONENT_STATUS_SYSTEM_TICK = 8192,\n DEVICE_COMPONENT_STATUS_IDLE_TICK = 16384,\n DEVICE_COMPONENT_LISTENERS_CONFIGURED = 1,\n DEVICE_COMPONENT_EVT_SYSTEM_TICK = 1,\n // /libraries/codal-core/inc/core/CodalFiber.h\n DEVICE_SCHEDULER_RUNNING = 1,\n DEVICE_SCHEDULER_IDLE = 2,\n DEVICE_SCHEDULER_DEEPSLEEP = 4,\n DEVICE_FIBER_FLAG_FOB = 1,\n DEVICE_FIBER_FLAG_PARENT = 2,\n DEVICE_FIBER_FLAG_CHILD = 4,\n DEVICE_FIBER_FLAG_DO_NOT_PAGE = 8,\n DEVICE_SCHEDULER_EVT_TICK = 1,\n DEVICE_SCHEDULER_EVT_IDLE = 2,\n DEVICE_GET_FIBER_LIST_AVAILABLE = 1,\n // /libraries/codal-core/inc/core/CodalListener.h\n MESSAGE_BUS_LISTENER_PARAMETERISED = 1,\n MESSAGE_BUS_LISTENER_METHOD = 2,\n MESSAGE_BUS_LISTENER_BUSY = 4,\n MESSAGE_BUS_LISTENER_REENTRANT = 8,\n MESSAGE_BUS_LISTENER_QUEUE_IF_BUSY = 16,\n MESSAGE_BUS_LISTENER_DROP_IF_BUSY = 32,\n MESSAGE_BUS_LISTENER_NONBLOCKING = 64,\n MESSAGE_BUS_LISTENER_URGENT = 128,\n MESSAGE_BUS_LISTENER_DELETING = 32768,\n MESSAGE_BUS_LISTENER_IMMEDIATE = 192,\n // /libraries/codal-core/inc/core/ErrorNo.h\n DEVICE_OK = 0,\n DEVICE_INVALID_PARAMETER = -1001,\n DEVICE_NOT_SUPPORTED = -1002,\n DEVICE_CALIBRATION_IN_PROGRESS = -1003,\n DEVICE_CALIBRATION_REQUIRED = -1004,\n DEVICE_NO_RESOURCES = -1005,\n DEVICE_BUSY = -1006,\n DEVICE_CANCELLED = -1007,\n DEVICE_I2C_ERROR = -1010,\n DEVICE_SERIAL_IN_USE = -1011,\n DEVICE_NO_DATA = -1012,\n DEVICE_NOT_IMPLEMENTED = -1013,\n DEVICE_SPI_ERROR = -1014,\n DEVICE_INVALID_STATE = -1015,\n DEVICE_OOM = 20,\n DEVICE_HEAP_ERROR = 30,\n DEVICE_NULL_DEREFERENCE = 40,\n DEVICE_USB_ERROR = 50,\n DEVICE_JACDAC_ERROR = 60,\n DEVICE_CPU_SDK = 70,\n DEVICE_HARDWARE_CONFIGURATION_ERROR = 90,\n // /libraries/codal-core/inc/core/NotifyEvents.h\n DISPLAY_EVT_FREE = 1,\n CODAL_SERIAL_EVT_TX_EMPTY = 2,\n BLE_EVT_SERIAL_TX_EMPTY = 3,\n ARCADE_PLAYER_JOIN_RESULT = 4,\n POWER_EVT_CANCEL_DEEPSLEEP = 5,\n DEVICE_NOTIFY_USER_EVENT_BASE = 1024,\n // /libraries/codal-core/inc/driver-models/AbstractButton.h\n DEVICE_BUTTON_EVT_DOWN = 1,\n DEVICE_BUTTON_EVT_UP = 2,\n DEVICE_BUTTON_EVT_CLICK = 3,\n DEVICE_BUTTON_EVT_LONG_CLICK = 4,\n DEVICE_BUTTON_EVT_HOLD = 5,\n DEVICE_BUTTON_EVT_DOUBLE_CLICK = 6,\n DEVICE_BUTTON_LONG_CLICK_TIME = 1000,\n DEVICE_BUTTON_HOLD_TIME = 1500,\n DEVICE_BUTTON_STATE = 1,\n DEVICE_BUTTON_STATE_HOLD_TRIGGERED = 2,\n DEVICE_BUTTON_STATE_CLICK = 4,\n DEVICE_BUTTON_STATE_LONG_CLICK = 8,\n DEVICE_BUTTON_SIGMA_MIN = 0,\n DEVICE_BUTTON_SIGMA_MAX = 12,\n DEVICE_BUTTON_SIGMA_THRESH_HI = 8,\n DEVICE_BUTTON_SIGMA_THRESH_LO = 2,\n DEVICE_BUTTON_DOUBLE_CLICK_THRESH = 50,\n DEVICE_BUTTON_SIMPLE_EVENTS = 0,\n DEVICE_BUTTON_ALL_EVENTS = 1,\n ACTIVE_LOW = 0,\n ACTIVE_HIGH = 1,\n // /libraries/codal-core/inc/driver-models/Accelerometer.h\n ACCELEROMETER_IMU_DATA_VALID = 2,\n ACCELEROMETER_EVT_DATA_UPDATE = 1,\n ACCELEROMETER_EVT_NONE = 0,\n ACCELEROMETER_EVT_TILT_UP = 1,\n ACCELEROMETER_EVT_TILT_DOWN = 2,\n ACCELEROMETER_EVT_TILT_LEFT = 3,\n ACCELEROMETER_EVT_TILT_RIGHT = 4,\n ACCELEROMETER_EVT_FACE_UP = 5,\n ACCELEROMETER_EVT_FACE_DOWN = 6,\n ACCELEROMETER_EVT_FREEFALL = 7,\n ACCELEROMETER_EVT_3G = 8,\n ACCELEROMETER_EVT_6G = 9,\n ACCELEROMETER_EVT_8G = 10,\n ACCELEROMETER_EVT_SHAKE = 11,\n ACCELEROMETER_EVT_2G = 12,\n ACCELEROMETER_REST_TOLERANCE = 200,\n ACCELEROMETER_TILT_TOLERANCE = 200,\n ACCELEROMETER_FREEFALL_TOLERANCE = 400,\n ACCELEROMETER_SHAKE_TOLERANCE = 400,\n ACCELEROMETER_2G_TOLERANCE = 2048,\n ACCELEROMETER_3G_TOLERANCE = 3072,\n ACCELEROMETER_6G_TOLERANCE = 6144,\n ACCELEROMETER_8G_TOLERANCE = 8192,\n ACCELEROMETER_GESTURE_DAMPING = 5,\n ACCELEROMETER_SHAKE_DAMPING = 10,\n ACCELEROMETER_SHAKE_RTX = 30,\n ACCELEROMETER_SHAKE_COUNT_THRESHOLD = 4,\n // /libraries/codal-core/inc/driver-models/Compass.h\n COMPASS_STATUS_RUNNING = 1,\n COMPASS_STATUS_CALIBRATED = 2,\n COMPASS_STATUS_CALIBRATING = 4,\n COMPASS_STATUS_ADDED_TO_IDLE = 8,\n COMPASS_EVT_DATA_UPDATE = 1,\n COMPASS_EVT_CONFIG_NEEDED = 2,\n COMPASS_EVT_CALIBRATE = 3,\n COMPASS_EVT_CALIBRATION_NEEDED = 4,\n // /libraries/codal-core/inc/driver-models/Gyroscope.h\n GYROSCOPE_IMU_DATA_VALID = 2,\n GYROSCOPE_EVT_DATA_UPDATE = 1,\n // /libraries/codal-core/inc/driver-models/LowLevelTimer.h\n CODAL_LOWLEVELTIMER_STATUS_SLEEP_IRQENABLE = 1,\n TimerModeTimer = 0,\n TimerModeCounter = 1,\n TimerModeAlternateFunction = 2,\n BitMode8 = 0,\n BitMode16 = 1,\n BitMode24 = 2,\n BitMode32 = 3,\n // /libraries/codal-core/inc/driver-models/Pin.h\n IO_STATUS_DIGITAL_IN = 1,\n IO_STATUS_DIGITAL_OUT = 2,\n IO_STATUS_ANALOG_IN = 4,\n IO_STATUS_ANALOG_OUT = 8,\n IO_STATUS_TOUCH_IN = 16,\n IO_STATUS_EVENT_ON_EDGE = 32,\n IO_STATUS_EVENT_PULSE_ON_EDGE = 64,\n IO_STATUS_INTERRUPT_ON_EDGE = 128,\n IO_STATUS_ACTIVE_HI = 256,\n IO_STATUS_WAKE_ON_ACTIVE = 512,\n DEVICE_PIN_MAX_OUTPUT = 1023,\n DEVICE_PIN_MAX_SERVO_RANGE = 180,\n DEVICE_PIN_DEFAULT_SERVO_RANGE = 2000,\n DEVICE_PIN_DEFAULT_SERVO_CENTER = 1500,\n DEVICE_PIN_EVENT_NONE = 0,\n DEVICE_PIN_INTERRUPT_ON_EDGE = 1,\n DEVICE_PIN_EVENT_ON_EDGE = 2,\n DEVICE_PIN_EVENT_ON_PULSE = 3,\n DEVICE_PIN_EVENT_ON_TOUCH = 4,\n DEVICE_PIN_EVT_RISE = 2,\n DEVICE_PIN_EVT_FALL = 3,\n DEVICE_PIN_EVT_PULSE_HI = 4,\n DEVICE_PIN_EVT_PULSE_LO = 5,\n PIN_CAPABILITY_DIGITAL = 1,\n PIN_CAPABILITY_ANALOG = 2,\n PIN_CAPABILITY_AD = 3,\n PIN_CAPABILITY_ALL = 3,\n None = 0,\n Down = 1,\n Up = 2,\n // /libraries/codal-core/inc/driver-models/Radio.h\n RADIO_EVT_DATA_READY = 2,\n // /libraries/codal-core/inc/driver-models/SPIFlash.h\n SPIFLASH_PAGE_SIZE = 256,\n SPIFLASH_SMALL_ROW_PAGES = 16,\n SPIFLASH_BIG_ROW_PAGES = 256,\n // /libraries/codal-core/inc/driver-models/Sensor.h\n SENSOR_THRESHOLD_LOW = 1,\n SENSOR_THRESHOLD_HIGH = 2,\n SENSOR_UPDATE_NEEDED = 3,\n SENSOR_INITIALISED = 1,\n SENSOR_HIGH_THRESHOLD_PASSED = 2,\n SENSOR_LOW_THRESHOLD_PASSED = 4,\n SENSOR_LOW_THRESHOLD_ENABLED = 8,\n SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n SENSOR_DEFAULT_SENSITIVITY = 868,\n SENSOR_DEFAULT_SAMPLE_PERIOD = 500,\n // /libraries/codal-core/inc/driver-models/Serial.h\n CODAL_SERIAL_DEFAULT_BAUD_RATE = 115200,\n CODAL_SERIAL_DEFAULT_BUFFER_SIZE = 20,\n CODAL_SERIAL_EVT_DELIM_MATCH = 1,\n CODAL_SERIAL_EVT_HEAD_MATCH = 2,\n CODAL_SERIAL_EVT_RX_FULL = 3,\n CODAL_SERIAL_EVT_DATA_RECEIVED = 4,\n CODAL_SERIAL_STATUS_RX_IN_USE = 1,\n CODAL_SERIAL_STATUS_TX_IN_USE = 2,\n CODAL_SERIAL_STATUS_RX_BUFF_INIT = 4,\n CODAL_SERIAL_STATUS_TX_BUFF_INIT = 8,\n CODAL_SERIAL_STATUS_RXD = 16,\n CODAL_SERIAL_STATUS_DEEPSLEEP = 32,\n ASYNC = 0,\n SYNC_SPINWAIT = 1,\n SYNC_SLEEP = 2,\n RxInterrupt = 0,\n TxInterrupt = 1,\n // /libraries/codal-core/inc/driver-models/SingleWireSerial.h\n SWS_EVT_DATA_RECEIVED = 1,\n SWS_EVT_DATA_SENT = 2,\n SWS_EVT_ERROR = 3,\n SWS_EVT_DATA_DROPPED = 4,\n SingleWireRx = 0,\n SingleWireTx = 1,\n SingleWireDisconnected = 2,\n // /libraries/codal-core/inc/driver-models/Timer.h\n CODAL_TIMER_DEFAULT_EVENT_LIST_SIZE = 10,\n CODAL_TIMER_EVENT_FLAGS_NONE = 0,\n CODAL_TIMER_EVENT_FLAGS_WAKEUP = 1,\n // /libraries/codal-core/inc/drivers/AnalogSensor.h\n ANALOG_THRESHOLD_LOW = 1,\n ANALOG_THRESHOLD_HIGH = 2,\n ANALOG_SENSOR_UPDATE_NEEDED = 3,\n ANALOG_SENSOR_INITIALISED = 1,\n ANALOG_SENSOR_HIGH_THRESHOLD_PASSED = 2,\n ANALOG_SENSOR_LOW_THRESHOLD_PASSED = 4,\n ANALOG_SENSOR_LOW_THRESHOLD_ENABLED = 8,\n ANALOG_SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n // /libraries/codal-core/inc/drivers/AnimatedDisplay.h\n DISPLAY_EVT_ANIMATION_COMPLETE = 1,\n DISPLAY_DEFAULT_AUTOCLEAR = 1,\n DISPLAY_SPACING = 1,\n DISPLAY_ANIMATE_DEFAULT_POS = -255,\n DISPLAY_DEFAULT_SCROLL_SPEED = 120,\n DISPLAY_DEFAULT_SCROLL_STRIDE = -1,\n DISPLAY_DEFAULT_PRINT_SPEED = 400,\n ANIMATION_MODE_NONE = 0,\n ANIMATION_MODE_STOPPED = 1,\n ANIMATION_MODE_SCROLL_TEXT = 2,\n ANIMATION_MODE_PRINT_TEXT = 3,\n ANIMATION_MODE_SCROLL_IMAGE = 4,\n ANIMATION_MODE_ANIMATE_IMAGE = 5,\n ANIMATION_MODE_ANIMATE_IMAGE_WITH_CLEAR = 6,\n ANIMATION_MODE_PRINT_CHARACTER = 7,\n // /libraries/codal-core/inc/drivers/FAT.h\n FAT_RESERVED_SECTORS = 1,\n FAT_ROOT_DIR_SECTORS = 4,\n // /libraries/codal-core/inc/drivers/HID.h\n HID_REQUEST_GET_REPORT = 1,\n HID_REQUEST_GET_IDLE = 2,\n HID_REQUEST_GET_PROTOCOL = 3,\n HID_REQUEST_SET_REPORT = 9,\n HID_REQUEST_SET_IDLE = 10,\n HID_REQUEST_SET_PROTOCOL = 11,\n // /libraries/codal-core/inc/drivers/HIDKeyboard.h\n HID_KEYBOARD_NUM_REPORTS = 3,\n HID_KEYBOARD_REPORT_GENERIC = 1,\n HID_KEYBOARD_REPORT_CONSUMER = 2,\n HID_KEYBOARD_KEYSTATE_SIZE_GENERIC = 8,\n HID_KEYBOARD_KEYSTATE_SIZE_CONSUMER = 2,\n HID_KEYBOARD_MODIFIER_OFFSET = 2,\n HID_KEYBOARD_DELAY_DEFAULT = 10,\n PressKey = 0,\n ReleaseKey = 1,\n // /libraries/codal-core/inc/drivers/KeyMap.h\n KEYMAP_ALL_KEYS_UP_Val = 1,\n KEYMAP_ALL_KEYS_UP_POS = 28,\n KEYMAP_NORMAL_KEY_Val = 0,\n KEYMAP_MODIFIER_KEY_Val = 1,\n KEYMAP_MODIFIER_POS = 29,\n KEYMAP_MEDIA_KEY_Val = 1,\n KEYMAP_MEDIA_POS = 30,\n KEYMAP_KEY_UP_Val = 0,\n KEYMAP_KEY_DOWN_Val = 1,\n KEYMAP_KEY_DOWN_POS = 31,\n // /libraries/codal-core/inc/drivers/KeyValueStorage.h\n DEVICE_KEY_VALUE_STORE_OFFSET = -4,\n KEY_VALUE_STORAGE_MAGIC = 789921,\n KEY_VALUE_STORAGE_BLOCK_SIZE = 48,\n KEY_VALUE_STORAGE_KEY_SIZE = 16,\n KEY_VALUE_STORAGE_SCRATCH_WORD_SIZE = 64,\n KEY_VALUE_STORAGE_MAX_PAIRS = 5,\n // /libraries/codal-core/inc/drivers/LEDMatrix.h\n LED_MATRIX_GREYSCALE_BIT_DEPTH = 8,\n LED_MATRIX_EVT_LIGHT_SENSE = 2,\n LED_MATRIX_EVT_FRAME_TIMEOUT = 3,\n LED_MATRIX_MINIMUM_BRIGHTNESS = 1,\n LED_MATRIX_MAXIMUM_BRIGHTNESS = 255,\n LED_MATRIX_DEFAULT_BRIGHTNESS = 255,\n DISPLAY_MODE_BLACK_AND_WHITE = 0,\n DISPLAY_MODE_GREYSCALE = 1,\n DISPLAY_MODE_BLACK_AND_WHITE_LIGHT_SENSE = 2,\n DISPLAY_MODE_GREYSCALE_LIGHT_SENSE = 3,\n MATRIX_DISPLAY_ROTATION_0 = 0,\n MATRIX_DISPLAY_ROTATION_90 = 1,\n MATRIX_DISPLAY_ROTATION_180 = 2,\n MATRIX_DISPLAY_ROTATION_270 = 3,\n NO_CONN = 0,\n // /libraries/codal-core/inc/drivers/LSM303Accelerometer.h\n LSM303_A_DEFAULT_ADDR = 50,\n LSM303_STATUS_REG_AUX_A = 7,\n LSM303_OUT_TEMP_L_A = 12,\n LSM303_OUT_TEMP_H_A = 13,\n LSM303_INT_COUNTER_REG_A = 14,\n LSM303_WHO_AM_I_A = 15,\n LSM303_TEMP_CFG_REG_A = 31,\n LSM303_CTRL_REG1_A = 32,\n LSM303_CTRL_REG2_A = 33,\n LSM303_CTRL_REG3_A = 34,\n LSM303_CTRL_REG4_A = 35,\n LSM303_CTRL_REG5_A = 36,\n LSM303_CTRL_REG6_A = 37,\n LSM303_DATACAPTURE_A = 38,\n LSM303_STATUS_REG_A = 39,\n LSM303_OUT_X_L_A = 40,\n LSM303_OUT_X_H_A = 41,\n LSM303_OUT_Y_L_A = 42,\n LSM303_OUT_Y_H_A = 43,\n LSM303_OUT_Z_L_A = 44,\n LSM303_OUT_Z_H_A = 45,\n LSM303_FIFO_CTRL_REG_A = 46,\n LSM303_FIFO_SRC_REG_A = 47,\n LSM303_INT1_CFG_A = 48,\n LSM303_INT1_SRC_A = 49,\n LSM303_INT1_THS_A = 50,\n LSM303_INT1_DURATION_A = 51,\n LSM303_INT2_CFG_A = 52,\n LSM303_INT2_SRC_A = 53,\n LSM303_INT2_THS_A = 54,\n LSM303_INT2_DURATION_A = 55,\n LSM303_CLICK_CFG_A = 56,\n LSM303_CLICK_SRC_A = 57,\n LSM303_CLICK_THS_A = 58,\n LSM303_TIME_LIMIT_A = 59,\n LSM303_TIME_LATENCY_A = 60,\n LSM303_TIME_WINDOW_A = 61,\n LSM303_ACT_THS_A = 62,\n LSM303_ACT_DUR_A = 63,\n LSM303_A_WHOAMI_VAL = 51,\n LSM303_A_STATUS_DATA_READY = 8,\n LSM303_A_STATUS_ENABLED = 256,\n LSM303_A_STATUS_SLEEPING = 512,\n // /libraries/codal-core/inc/drivers/LSM303Magnetometer.h\n LSM303_M_WHOAMI_VAL = 64,\n LSM303_M_DEFAULT_ADDR = 60,\n LSM303_OFFSET_X_REG_L_M = 69,\n LSM303_OFFSET_X_REG_H_M = 70,\n LSM303_OFFSET_Y_REG_L_M = 71,\n LSM303_OFFSET_Y_REG_H_M = 72,\n LSM303_OFFSET_Z_REG_L_M = 73,\n LSM303_OFFSET_Z_REG_H_M = 74,\n LSM303_WHO_AM_I_M = 79,\n LSM303_CFG_REG_A_M = 96,\n LSM303_CFG_REG_B_M = 97,\n LSM303_CFG_REG_C_M = 98,\n LSM303_INT_CRTL_REG_M = 99,\n LSM303_INT_SOURCE_REG_M = 100,\n LSM303_INT_THS_L_REG_M = 101,\n LSM303_INT_THS_H_REG_M = 102,\n LSM303_STATUS_REG_M = 103,\n LSM303_OUTX_L_REG_M = 104,\n LSM303_OUTX_H_REG_M = 105,\n LSM303_OUTY_L_REG_M = 106,\n LSM303_OUTY_H_REG_M = 107,\n LSM303_OUTZ_L_REG_M = 108,\n LSM303_OUTZ_H_REG_M = 109,\n LSM303_M_STATUS_DATA_READY = 8,\n LSM303_M_STATUS_ENABLED = 256,\n LSM303_M_STATUS_SLEEPING = 512,\n // /libraries/codal-core/inc/drivers/MultiButton.h\n MULTI_BUTTON_STATE_1 = 1,\n MULTI_BUTTON_STATE_2 = 2,\n MULTI_BUTTON_HOLD_TRIGGERED_1 = 4,\n MULTI_BUTTON_HOLD_TRIGGERED_2 = 8,\n MULTI_BUTTON_SUPRESSED_1 = 16,\n MULTI_BUTTON_SUPRESSED_2 = 32,\n MULTI_BUTTON_ATTACHED = 64,\n // /libraries/codal-core/inc/drivers/PulseIn.h\n DEVICE_EVT_PULSE_IN_TIMEOUT = 10000,\n // /libraries/codal-core/inc/drivers/TouchButton.h\n TOUCH_BUTTON_CALIBRATION_LINEAR_OFFSET = 2,\n TOUCH_BUTTON_CALIBRATION_PERCENTAGE_OFFSET = 5,\n TOUCH_BUTTON_SENSITIVITY = 10,\n TOUCH_BUTTON_CALIBRATION_PERIOD = 10,\n TOUCH_BUTTON_CALIBRATING = 16,\n // /libraries/codal-core/inc/drivers/TouchSensor.h\n TOUCH_SENSOR_MAX_BUTTONS = 10,\n TOUCH_SENSOR_SAMPLE_PERIOD = 50,\n TOUCH_SENSE_SAMPLE_MAX = 1000,\n TOUCH_SENSOR_UPDATE_NEEDED = 1,\n // /libraries/codal-core/inc/drivers/USB_HID_Keys.h\n KEY_MOD_LCTRL = 1,\n KEY_MOD_LSHIFT = 2,\n KEY_MOD_LALT = 4,\n KEY_MOD_LMETA = 8,\n KEY_MOD_RCTRL = 16,\n KEY_MOD_RSHIFT = 32,\n KEY_MOD_RALT = 64,\n KEY_MOD_RMETA = 128,\n KEY_NONE = 0,\n KEY_ERR_OVF = 1,\n KEY_A = 4,\n KEY_B = 5,\n KEY_C = 6,\n KEY_D = 7,\n KEY_E = 8,\n KEY_F = 9,\n KEY_G = 10,\n KEY_H = 11,\n KEY_I = 12,\n KEY_J = 13,\n KEY_K = 14,\n KEY_L = 15,\n KEY_M = 16,\n KEY_N = 17,\n KEY_O = 18,\n KEY_P = 19,\n KEY_Q = 20,\n KEY_R = 21,\n KEY_S = 22,\n KEY_T = 23,\n KEY_U = 24,\n KEY_V = 25,\n KEY_W = 26,\n KEY_X = 27,\n KEY_Y = 28,\n KEY_Z = 29,\n KEY_1 = 30,\n KEY_2 = 31,\n KEY_3 = 32,\n KEY_4 = 33,\n KEY_5 = 34,\n KEY_6 = 35,\n KEY_7 = 36,\n KEY_8 = 37,\n KEY_9 = 38,\n KEY_0 = 39,\n KEY_ENTER = 40,\n KEY_ESC = 41,\n KEY_BACKSPACE = 42,\n KEY_TAB = 43,\n KEY_SPACE = 44,\n KEY_MINUS = 45,\n KEY_EQUAL = 46,\n KEY_LEFTBRACE = 47,\n KEY_RIGHTBRACE = 48,\n KEY_BACKSLASH = 49,\n KEY_HASHTILDE = 50,\n KEY_SEMICOLON = 51,\n KEY_APOSTROPHE = 52,\n KEY_GRAVE = 53,\n KEY_COMMA = 54,\n KEY_DOT = 55,\n KEY_SLASH = 56,\n KEY_CAPSLOCK = 57,\n KEY_F1 = 58,\n KEY_F2 = 59,\n KEY_F3 = 60,\n KEY_F4 = 61,\n KEY_F5 = 62,\n KEY_F6 = 63,\n KEY_F7 = 64,\n KEY_F8 = 65,\n KEY_F9 = 66,\n KEY_F10 = 67,\n KEY_F11 = 68,\n KEY_F12 = 69,\n KEY_SYSRQ = 70,\n KEY_SCROLLLOCK = 71,\n KEY_PAUSE = 72,\n KEY_INSERT = 73,\n KEY_HOME = 74,\n KEY_PAGEUP = 75,\n KEY_DELETE = 76,\n KEY_END = 77,\n KEY_PAGEDOWN = 78,\n KEY_RIGHT = 79,\n KEY_LEFT = 80,\n KEY_DOWN = 81,\n KEY_UP = 82,\n KEY_NUMLOCK = 83,\n KEY_KPSLASH = 84,\n KEY_KPASTERISK = 85,\n KEY_KPMINUS = 86,\n KEY_KPPLUS = 87,\n KEY_KPENTER = 88,\n KEY_KP1 = 89,\n KEY_KP2 = 90,\n KEY_KP3 = 91,\n KEY_KP4 = 92,\n KEY_KP5 = 93,\n KEY_KP6 = 94,\n KEY_KP7 = 95,\n KEY_KP8 = 96,\n KEY_KP9 = 97,\n KEY_KP0 = 98,\n KEY_KPDOT = 99,\n KEY_102ND = 100,\n KEY_COMPOSE = 101,\n KEY_POWER = 102,\n KEY_KPEQUAL = 103,\n KEY_F13 = 104,\n KEY_F14 = 105,\n KEY_F15 = 106,\n KEY_F16 = 107,\n KEY_F17 = 108,\n KEY_F18 = 109,\n KEY_F19 = 110,\n KEY_F20 = 111,\n KEY_F21 = 112,\n KEY_F22 = 113,\n KEY_F23 = 114,\n KEY_F24 = 115,\n KEY_OPEN = 116,\n KEY_HELP = 117,\n KEY_PROPS = 118,\n KEY_FRONT = 119,\n KEY_STOP = 120,\n KEY_AGAIN = 121,\n KEY_UNDO = 122,\n KEY_CUT = 123,\n KEY_COPY = 124,\n KEY_PASTE = 125,\n KEY_FIND = 126,\n KEY_MUTE = 127,\n KEY_VOLUMEUP = 128,\n KEY_VOLUMEDOWN = 129,\n KEY_KPCOMMA = 133,\n KEY_RO = 135,\n KEY_KATAKANAHIRAGANA = 136,\n KEY_YEN = 137,\n KEY_HENKAN = 138,\n KEY_MUHENKAN = 139,\n KEY_KPJPCOMMA = 140,\n KEY_HANGEUL = 144,\n KEY_HANJA = 145,\n KEY_KATAKANA = 146,\n KEY_HIRAGANA = 147,\n KEY_ZENKAKUHANKAKU = 148,\n KEY_KPLEFTPAREN = 182,\n KEY_KPRIGHTPAREN = 183,\n KEY_LEFTCTRL = 224,\n KEY_LEFTSHIFT = 225,\n KEY_LEFTALT = 226,\n KEY_LEFTMETA = 227,\n KEY_RIGHTCTRL = 228,\n KEY_RIGHTSHIFT = 229,\n KEY_RIGHTALT = 230,\n KEY_RIGHTMETA = 231,\n KEY_MEDIA_PLAYPAUSE = 232,\n KEY_MEDIA_STOPCD = 233,\n KEY_MEDIA_PREVIOUSSONG = 234,\n KEY_MEDIA_NEXTSONG = 235,\n KEY_MEDIA_EJECTCD = 236,\n KEY_MEDIA_VOLUMEUP = 237,\n KEY_MEDIA_VOLUMEDOWN = 238,\n KEY_MEDIA_MUTE = 239,\n KEY_MEDIA_WWW = 240,\n KEY_MEDIA_BACK = 241,\n KEY_MEDIA_FORWARD = 242,\n KEY_MEDIA_STOP = 243,\n KEY_MEDIA_FIND = 244,\n KEY_MEDIA_SCROLLUP = 245,\n KEY_MEDIA_SCROLLDOWN = 246,\n KEY_MEDIA_EDIT = 247,\n KEY_MEDIA_SLEEP = 248,\n KEY_MEDIA_COFFEE = 249,\n KEY_MEDIA_REFRESH = 250,\n KEY_MEDIA_CALC = 251,\n // /libraries/codal-core/inc/drivers/uf2format.h\n UF2FORMAT_H = 1,\n APP_START_ADDRESS = 8192,\n UF2_FLAG_NOFLASH = 1,\n // /libraries/codal-core/inc/streams/DataStream.h\n DATASTREAM_MAXIMUM_BUFFERS = 1,\n DATASTREAM_FORMAT_UNKNOWN = 0,\n DATASTREAM_FORMAT_8BIT_UNSIGNED = 1,\n DATASTREAM_FORMAT_8BIT_SIGNED = 2,\n DATASTREAM_FORMAT_16BIT_UNSIGNED = 3,\n DATASTREAM_FORMAT_16BIT_SIGNED = 4,\n DATASTREAM_FORMAT_24BIT_UNSIGNED = 5,\n DATASTREAM_FORMAT_24BIT_SIGNED = 6,\n DATASTREAM_FORMAT_32BIT_UNSIGNED = 7,\n DATASTREAM_FORMAT_32BIT_SIGNED = 8,\n // /libraries/codal-core/inc/streams/LevelDetector.h\n LEVEL_THRESHOLD_LOW = 1,\n LEVEL_THRESHOLD_HIGH = 2,\n LEVEL_DETECTOR_INITIALISED = 1,\n LEVEL_DETECTOR_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/LevelDetectorSPL.h\n LEVEL_DETECTOR_SPL_INITIALISED = 1,\n LEVEL_DETECTOR_SPL_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_SPL_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_SPL_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/MemorySource.h\n MEMORY_SOURCE_DEFAULT_MAX_BUFFER = 256,\n // /libraries/codal-core/inc/streams/Synthesizer.h\n SYNTHESIZER_SAMPLE_RATE = 44100,\n TONE_WIDTH = 1024,\n // /libraries/codal-core/inc/types/BitmapFont.h\n BITMAP_FONT_WIDTH = 5,\n BITMAP_FONT_HEIGHT = 5,\n BITMAP_FONT_ASCII_START = 32,\n BITMAP_FONT_ASCII_END = 126,\n // /libraries/codal-core/inc/types/CoordinateSystem.h\n COORDINATE_SPACE_ROTATED_0 = 0,\n COORDINATE_SPACE_ROTATED_90 = 1,\n COORDINATE_SPACE_ROTATED_180 = 2,\n COORDINATE_SPACE_ROTATED_270 = 3,\n RAW = 0,\n SIMPLE_CARTESIAN = 1,\n NORTH_EAST_DOWN = 2,\n EAST_NORTH_UP = 3,\n NORTH_EAST_UP = 3,\n // /libraries/codal-core/inc/types/Event.h\n DEVICE_ID_ANY = 0,\n DEVICE_EVT_ANY = 0,\n CREATE_ONLY = 0,\n CREATE_AND_FIRE = 1,\n DEVICE_EVENT_DEFAULT_LAUNCH_MODE = 1,\n // /libraries/codal-core/inc/types/ManagedBuffer.h\n Zero = 1,\n // /libraries/codal-core/inc/types/RefCounted.h\n REF_TAG_STRING = 1,\n REF_TAG_BUFFER = 2,\n REF_TAG_IMAGE = 3,\n REF_TAG_USER = 32,\n // /pxtapp/configkeys.h\n CFG_PIN_NAME_MSK = 65535,\n CFG_PIN_CONFIG_MSK = 4294901760,\n CFG_PIN_CONFIG_ACTIVE_LO = 65536,\n CFG_MAGIC0 = 513675505,\n CFG_MAGIC1 = 539130489,\n CFG_PIN_ACCELEROMETER_INT = 1,\n CFG_PIN_ACCELEROMETER_SCL = 2,\n CFG_PIN_ACCELEROMETER_SDA = 3,\n CFG_PIN_BTN_A = 4,\n CFG_PIN_BTN_B = 5,\n CFG_PIN_BTN_SLIDE = 6,\n CFG_PIN_DOTSTAR_CLOCK = 7,\n CFG_PIN_DOTSTAR_DATA = 8,\n CFG_PIN_FLASH_CS = 9,\n CFG_PIN_FLASH_MISO = 10,\n CFG_PIN_FLASH_MOSI = 11,\n CFG_PIN_FLASH_SCK = 12,\n CFG_PIN_LED = 13,\n CFG_PIN_LIGHT = 14,\n CFG_PIN_MICROPHONE = 15,\n CFG_PIN_MIC_CLOCK = 16,\n CFG_PIN_MIC_DATA = 17,\n CFG_PIN_MISO = 18,\n CFG_PIN_MOSI = 19,\n CFG_PIN_NEOPIXEL = 20,\n CFG_PIN_RX = 21,\n CFG_PIN_RXLED = 22,\n CFG_PIN_SCK = 23,\n CFG_PIN_SCL = 24,\n CFG_PIN_SDA = 25,\n CFG_PIN_SPEAKER_AMP = 26,\n CFG_PIN_TEMPERATURE = 27,\n CFG_PIN_TX = 28,\n CFG_PIN_TXLED = 29,\n CFG_PIN_IR_OUT = 30,\n CFG_PIN_IR_IN = 31,\n CFG_PIN_DISPLAY_SCK = 32,\n CFG_PIN_DISPLAY_MISO = 33,\n CFG_PIN_DISPLAY_MOSI = 34,\n CFG_PIN_DISPLAY_CS = 35,\n CFG_PIN_DISPLAY_DC = 36,\n CFG_DISPLAY_WIDTH = 37,\n CFG_DISPLAY_HEIGHT = 38,\n CFG_DISPLAY_CFG0 = 39,\n CFG_DISPLAY_CFG1 = 40,\n CFG_DISPLAY_CFG2 = 41,\n CFG_DISPLAY_CFG3 = 42,\n CFG_PIN_DISPLAY_RST = 43,\n CFG_PIN_DISPLAY_BL = 44,\n CFG_PIN_SERVO_1 = 45,\n CFG_PIN_SERVO_2 = 46,\n CFG_PIN_BTN_LEFT = 47,\n CFG_PIN_BTN_RIGHT = 48,\n CFG_PIN_BTN_UP = 49,\n CFG_PIN_BTN_DOWN = 50,\n CFG_PIN_BTN_MENU = 51,\n CFG_PIN_LED_R = 52,\n CFG_PIN_LED_G = 53,\n CFG_PIN_LED_B = 54,\n CFG_PIN_LED1 = 55,\n CFG_PIN_LED2 = 56,\n CFG_PIN_LED3 = 57,\n CFG_PIN_LED4 = 58,\n CFG_SPEAKER_VOLUME = 59,\n CFG_PIN_JACK_TX = 60,\n CFG_PIN_JACK_SENSE = 61,\n CFG_PIN_JACK_HPEN = 62,\n CFG_PIN_JACK_BZEN = 63,\n CFG_PIN_JACK_PWREN = 64,\n CFG_PIN_JACK_SND = 65,\n CFG_PIN_JACK_BUSLED = 66,\n CFG_PIN_JACK_COMMLED = 67,\n CFG_PIN_BTN_SOFT_RESET = 69,\n CFG_ACCELEROMETER_TYPE = 70,\n CFG_PIN_BTNMX_LATCH = 71,\n CFG_PIN_BTNMX_CLOCK = 72,\n CFG_PIN_BTNMX_DATA = 73,\n CFG_PIN_BTN_MENU2 = 74,\n CFG_PIN_BATTSENSE = 75,\n CFG_PIN_VIBRATION = 76,\n CFG_PIN_PWREN = 77,\n CFG_DISPLAY_TYPE = 78,\n CFG_PIN_ROTARY_ENCODER_A = 79,\n CFG_PIN_ROTARY_ENCODER_B = 80,\n CFG_ACCELEROMETER_SPACE = 81,\n CFG_PIN_WIFI_MOSI = 82,\n CFG_PIN_WIFI_MISO = 83,\n CFG_PIN_WIFI_SCK = 84,\n CFG_PIN_WIFI_TX = 85,\n CFG_PIN_WIFI_RX = 86,\n CFG_PIN_WIFI_CS = 87,\n CFG_PIN_WIFI_BUSY = 88,\n CFG_PIN_WIFI_RESET = 89,\n CFG_PIN_WIFI_GPIO0 = 90,\n CFG_PIN_WIFI_AT_TX = 91,\n CFG_PIN_WIFI_AT_RX = 92,\n CFG_PIN_USB_POWER = 93,\n ACCELEROMETER_TYPE_LIS3DH = 50,\n ACCELEROMETER_TYPE_LIS3DH_ALT = 48,\n ACCELEROMETER_TYPE_MMA8453 = 56,\n ACCELEROMETER_TYPE_FXOS8700 = 60,\n ACCELEROMETER_TYPE_MMA8653 = 58,\n ACCELEROMETER_TYPE_MSA300 = 76,\n ACCELEROMETER_TYPE_MPU6050 = 104,\n DISPLAY_TYPE_ST7735 = 7735,\n DISPLAY_TYPE_ILI9341 = 9341,\n DISPLAY_TYPE_SMART = 4242,\n CFG_PIN_A0 = 100,\n CFG_PIN_A1 = 101,\n CFG_PIN_A2 = 102,\n CFG_PIN_A3 = 103,\n CFG_PIN_A4 = 104,\n CFG_PIN_A5 = 105,\n CFG_PIN_A6 = 106,\n CFG_PIN_A7 = 107,\n CFG_PIN_A8 = 108,\n CFG_PIN_A9 = 109,\n CFG_PIN_A10 = 110,\n CFG_PIN_A11 = 111,\n CFG_PIN_A12 = 112,\n CFG_PIN_A13 = 113,\n CFG_PIN_A14 = 114,\n CFG_PIN_A15 = 115,\n CFG_PIN_A16 = 116,\n CFG_PIN_A17 = 117,\n CFG_PIN_A18 = 118,\n CFG_PIN_A19 = 119,\n CFG_PIN_A20 = 120,\n CFG_PIN_A21 = 121,\n CFG_PIN_A22 = 122,\n CFG_PIN_A23 = 123,\n CFG_PIN_A24 = 124,\n CFG_PIN_A25 = 125,\n CFG_PIN_A26 = 126,\n CFG_PIN_A27 = 127,\n CFG_PIN_A28 = 128,\n CFG_PIN_A29 = 129,\n CFG_PIN_A30 = 130,\n CFG_PIN_A31 = 131,\n CFG_PIN_D0 = 150,\n CFG_PIN_D1 = 151,\n CFG_PIN_D2 = 152,\n CFG_PIN_D3 = 153,\n CFG_PIN_D4 = 154,\n CFG_PIN_D5 = 155,\n CFG_PIN_D6 = 156,\n CFG_PIN_D7 = 157,\n CFG_PIN_D8 = 158,\n CFG_PIN_D9 = 159,\n CFG_PIN_D10 = 160,\n CFG_PIN_D11 = 161,\n CFG_PIN_D12 = 162,\n CFG_PIN_D13 = 163,\n CFG_PIN_D14 = 164,\n CFG_PIN_D15 = 165,\n CFG_PIN_D16 = 166,\n CFG_PIN_D17 = 167,\n CFG_PIN_D18 = 168,\n CFG_PIN_D19 = 169,\n CFG_PIN_D20 = 170,\n CFG_PIN_D21 = 171,\n CFG_PIN_D22 = 172,\n CFG_PIN_D23 = 173,\n CFG_PIN_D24 = 174,\n CFG_PIN_D25 = 175,\n CFG_PIN_D26 = 176,\n CFG_PIN_D27 = 177,\n CFG_PIN_D28 = 178,\n CFG_PIN_D29 = 179,\n CFG_PIN_D30 = 180,\n CFG_PIN_D31 = 181,\n CFG_NUM_NEOPIXELS = 200,\n CFG_NUM_DOTSTARS = 201,\n CFG_DEFAULT_BUTTON_MODE = 202,\n CFG_SWD_ENABLED = 203,\n CFG_FLASH_BYTES = 204,\n CFG_RAM_BYTES = 205,\n CFG_SYSTEM_HEAP_BYTES = 206,\n CFG_LOW_MEM_SIMULATION_KB = 207,\n CFG_BOOTLOADER_BOARD_ID = 208,\n CFG_UF2_FAMILY = 209,\n CFG_PINS_PORT_SIZE = 210,\n CFG_BOOTLOADER_PROTECTION = 211,\n CFG_POWER_DEEPSLEEP_TIMEOUT = 212,\n CFG_ANALOG_BUTTON_THRESHOLD = 213,\n CFG_CPU_MHZ = 214,\n CFG_CONTROLLER_LIGHT_MAX_BRIGHTNESS = 215,\n CFG_ANALOG_JOYSTICK_MIN = 216,\n CFG_ANALOG_JOYSTICK_MAX = 217,\n CFG_TIMERS_TO_USE = 218,\n CFG_PIN_ONBOARD_DOTSTAR_CLOCK = 219,\n CFG_PIN_ONBOARD_DOTSTAR_DATA = 220,\n CFG_NUM_ONBOARD_DOTSTARS = 221,\n CFG_PIN_ONBOARD_NEOPIXEL = 222,\n CFG_NUM_ONBOARD_NEOPIXELS = 223,\n CFG_MATRIX_KEYPAD_MESSAGE_ID = 239,\n CFG_NUM_MATRIX_KEYPAD_ROWS = 240,\n CFG_PIN_MATRIX_KEYPAD_ROW0 = 241,\n CFG_PIN_MATRIX_KEYPAD_ROW1 = 242,\n CFG_PIN_MATRIX_KEYPAD_ROW2 = 243,\n CFG_PIN_MATRIX_KEYPAD_ROW3 = 244,\n CFG_PIN_MATRIX_KEYPAD_ROW4 = 245,\n CFG_PIN_MATRIX_KEYPAD_ROW5 = 246,\n CFG_PIN_MATRIX_KEYPAD_ROW6 = 247,\n CFG_PIN_MATRIX_KEYPAD_ROW7 = 248,\n CFG_NUM_MATRIX_KEYPAD_COLS = 250,\n CFG_PIN_MATRIX_KEYPAD_COL0 = 251,\n CFG_PIN_MATRIX_KEYPAD_COL1 = 252,\n CFG_PIN_MATRIX_KEYPAD_COL2 = 253,\n CFG_PIN_MATRIX_KEYPAD_COL3 = 254,\n CFG_PIN_MATRIX_KEYPAD_COL4 = 255,\n CFG_PIN_MATRIX_KEYPAD_COL5 = 256,\n CFG_PIN_MATRIX_KEYPAD_COL6 = 257,\n CFG_PIN_MATRIX_KEYPAD_COL7 = 258,\n CFG_PIN_B0 = 300,\n CFG_PIN_B1 = 301,\n CFG_PIN_B2 = 302,\n CFG_PIN_B3 = 303,\n CFG_PIN_B4 = 304,\n CFG_PIN_B5 = 305,\n CFG_PIN_B6 = 306,\n CFG_PIN_B7 = 307,\n CFG_PIN_B8 = 308,\n CFG_PIN_B9 = 309,\n CFG_PIN_B10 = 310,\n CFG_PIN_B11 = 311,\n CFG_PIN_B12 = 312,\n CFG_PIN_B13 = 313,\n CFG_PIN_B14 = 314,\n CFG_PIN_B15 = 315,\n CFG_PIN_B16 = 316,\n CFG_PIN_B17 = 317,\n CFG_PIN_B18 = 318,\n CFG_PIN_B19 = 319,\n CFG_PIN_B20 = 320,\n CFG_PIN_B21 = 321,\n CFG_PIN_B22 = 322,\n CFG_PIN_B23 = 323,\n CFG_PIN_B24 = 324,\n CFG_PIN_B25 = 325,\n CFG_PIN_B26 = 326,\n CFG_PIN_B27 = 327,\n CFG_PIN_B28 = 328,\n CFG_PIN_B29 = 329,\n CFG_PIN_B30 = 330,\n CFG_PIN_B31 = 331,\n CFG_PIN_C0 = 350,\n CFG_PIN_C1 = 351,\n CFG_PIN_C2 = 352,\n CFG_PIN_C3 = 353,\n CFG_PIN_C4 = 354,\n CFG_PIN_C5 = 355,\n CFG_PIN_C6 = 356,\n CFG_PIN_C7 = 357,\n CFG_PIN_C8 = 358,\n CFG_PIN_C9 = 359,\n CFG_PIN_C10 = 360,\n CFG_PIN_C11 = 361,\n CFG_PIN_C12 = 362,\n CFG_PIN_C13 = 363,\n CFG_PIN_C14 = 364,\n CFG_PIN_C15 = 365,\n CFG_PIN_C16 = 366,\n CFG_PIN_C17 = 367,\n CFG_PIN_C18 = 368,\n CFG_PIN_C19 = 369,\n CFG_PIN_C20 = 370,\n CFG_PIN_C21 = 371,\n CFG_PIN_C22 = 372,\n CFG_PIN_C23 = 373,\n CFG_PIN_C24 = 374,\n CFG_PIN_C25 = 375,\n CFG_PIN_C26 = 376,\n CFG_PIN_C27 = 377,\n CFG_PIN_C28 = 378,\n CFG_PIN_C29 = 379,\n CFG_PIN_C30 = 380,\n CFG_PIN_C31 = 381,\n CFG_PIN_P0 = 400,\n CFG_PIN_P1 = 401,\n CFG_PIN_P2 = 402,\n CFG_PIN_P3 = 403,\n CFG_PIN_P4 = 404,\n CFG_PIN_P5 = 405,\n CFG_PIN_P6 = 406,\n CFG_PIN_P7 = 407,\n CFG_PIN_P8 = 408,\n CFG_PIN_P9 = 409,\n CFG_PIN_P10 = 410,\n CFG_PIN_P11 = 411,\n CFG_PIN_P12 = 412,\n CFG_PIN_P13 = 413,\n CFG_PIN_P14 = 414,\n CFG_PIN_P15 = 415,\n CFG_PIN_P16 = 416,\n CFG_PIN_P17 = 417,\n CFG_PIN_P18 = 418,\n CFG_PIN_P19 = 419,\n CFG_PIN_P20 = 420,\n CFG_PIN_P21 = 421,\n CFG_PIN_P22 = 422,\n CFG_PIN_P23 = 423,\n CFG_PIN_P24 = 424,\n CFG_PIN_P25 = 425,\n CFG_PIN_P26 = 426,\n CFG_PIN_P27 = 427,\n CFG_PIN_P28 = 428,\n CFG_PIN_P29 = 429,\n CFG_PIN_P30 = 430,\n CFG_PIN_P31 = 431,\n CFG_PIN_P32 = 432,\n CFG_PIN_P33 = 433,\n CFG_PIN_P34 = 434,\n CFG_PIN_P35 = 435,\n CFG_PIN_P36 = 436,\n CFG_PIN_P37 = 437,\n CFG_PIN_P38 = 438,\n CFG_PIN_P39 = 439,\n CFG_PIN_P40 = 440,\n CFG_PIN_P41 = 441,\n CFG_PIN_P42 = 442,\n CFG_PIN_P43 = 443,\n CFG_PIN_P44 = 444,\n CFG_PIN_P45 = 445,\n CFG_PIN_P46 = 446,\n CFG_PIN_P47 = 447,\n CFG_PIN_P48 = 448,\n CFG_PIN_P49 = 449,\n CFG_PIN_P50 = 450,\n CFG_PIN_P51 = 451,\n CFG_PIN_P52 = 452,\n CFG_PIN_P53 = 453,\n CFG_PIN_P54 = 454,\n CFG_PIN_P55 = 455,\n CFG_PIN_P56 = 456,\n CFG_PIN_P57 = 457,\n CFG_PIN_P58 = 458,\n CFG_PIN_P59 = 459,\n CFG_PIN_P60 = 460,\n CFG_PIN_P61 = 461,\n CFG_PIN_P62 = 462,\n CFG_PIN_P63 = 463,\n CFG_PIN_LORA_MISO = 1001,\n CFG_PIN_LORA_MOSI = 1002,\n CFG_PIN_LORA_SCK = 1003,\n CFG_PIN_LORA_CS = 1004,\n CFG_PIN_LORA_BOOT = 1005,\n CFG_PIN_LORA_RESET = 1006,\n CFG_PIN_IRRXLED = 1007,\n CFG_PIN_IRTXLED = 1008,\n CFG_PIN_LCD_RESET = 1009,\n CFG_PIN_LCD_ENABLE = 1010,\n CFG_PIN_LCD_DATALINE4 = 1011,\n CFG_PIN_LCD_DATALINE5 = 1012,\n CFG_PIN_LCD_DATALINE6 = 1013,\n CFG_PIN_LCD_DATALINE7 = 1014,\n CFG_NUM_LCD_COLUMNS = 1015,\n CFG_NUM_LCD_ROWS = 1016,\n CFG_PIN_RCC0 = 1017,\n CFG_PIN_RCC1 = 1018,\n CFG_PIN_RCC2 = 1019,\n CFG_PIN_RCC3 = 1020,\n CFG_PIN_RCC4 = 1021,\n CFG_PIN_RCC5 = 1022,\n CFG_PIN_RCC6 = 1023,\n CFG_PIN_RCC7 = 1024,\n CFG_PIN_SERVO0 = 1025,\n CFG_PIN_SERVO1 = 1026,\n CFG_PIN_SERVO2 = 1027,\n CFG_PIN_SERVO3 = 1028,\n CFG_PIN_SERVO4 = 1029,\n CFG_PIN_SERVO5 = 1030,\n CFG_PIN_SERVO6 = 1031,\n CFG_PIN_SERVO7 = 1032,\n CFG_PIN_SERVO8 = 1033,\n CFG_PIN_PI_TX = 1034,\n CFG_PIN_PI_RX = 1035,\n CFG_PIN_GPS_SDA = 1036,\n CFG_PIN_GPS_SCL = 1037,\n CFG_PIN_GPS_TX = 1038,\n CFG_PIN_GPS_RX = 1039,\n CFG_PIN_GROVE0 = 1040,\n CFG_PIN_GROVE1 = 1041,\n CFG_PIN_SS = 1042,\n CFG_PIN_D33 = 183,\n CFG_PIN_D34 = 184,\n CFG_PIN_D35 = 185,\n CFG_PIN_D36 = 186,\n CFG_PIN_D37 = 187,\n CFG_PIN_D38 = 188,\n CFG_PIN_D39 = 189,\n CFG_PIN_D40 = 190,\n CFG_PIN_D41 = 191,\n CFG_PIN_D42 = 192,\n CFG_PIN_D43 = 193,\n CFG_PIN_D44 = 194,\n CFG_PIN_D45 = 195,\n CFG_PIN_D46 = 196,\n CFG_PIN_D47 = 197,\n CFG_PIN_D48 = 198,\n CFG_PIN_D49 = 199,\n CFG_PIN_D50 = 259,\n CFG_PIN_D51 = 260,\n CFG_PIN_D52 = 261,\n CFG_PIN_D53 = 262,\n CFG_PIN_TX1 = 263,\n CFG_PIN_TX2 = 264,\n CFG_PIN_TX3 = 265,\n CFG_PIN_RX1 = 266,\n CFG_PIN_RX2 = 267,\n CFG_PIN_RX3 = 268,\n CFG_PIN_SCL1 = 269,\n CFG_PIN_SDA1 = 270,\n CFG_PIN_PCC_D0 = 271,\n CFG_PIN_PCC_D1 = 272,\n CFG_PIN_PCC_D2 = 273,\n CFG_PIN_PCC_D3 = 274,\n CFG_PIN_PCC_D4 = 275,\n CFG_PIN_PCC_D5 = 276,\n CFG_PIN_PCC_D6 = 277,\n CFG_PIN_PCC_D7 = 278,\n CFG_PIN_PCC_D8 = 279,\n CFG_PIN_PCC_D9 = 280,\n CFG_PIN_PCC_D10 = 281,\n CFG_PIN_PCC_D11 = 282,\n CFG_PIN_PCC_D12 = 283,\n CFG_PIN_PCC_D13 = 284,\n CFG_PIN_CC_DEN1 = 285,\n CFG_PIN_CC_DEN2 = 286,\n CFG_PIN_CC_CLK = 287,\n CFG_PIN_XCC_CLK = 288,\n CFG_PIN_JDPWR_PRE_SENSE = 1100,\n CFG_PIN_JDPWR_GND_SENSE = 1101,\n CFG_PIN_JDPWR_PULSE = 1102,\n CFG_PIN_JDPWR_OVERLOAD_LED = 1103,\n CFG_PIN_JDPWR_ENABLE = 1104,\n CFG_PIN_JDPWR_FAULT = 1105,\n // /pxtapp/hf2dbg.h\n HF2DBG_H = 1,\n // /pxtapp/pins.h\n BUTTON_ACTIVE_HIGH_PULL_DOWN = 17,\n BUTTON_ACTIVE_HIGH_PULL_UP = 33,\n BUTTON_ACTIVE_HIGH_PULL_NONE = 49,\n BUTTON_ACTIVE_LOW_PULL_DOWN = 16,\n BUTTON_ACTIVE_LOW_PULL_UP = 32,\n BUTTON_ACTIVE_LOW_PULL_NONE = 48,\n // /pxtapp/platform.h\n SETTINGS_MAGIC_0 = 273114691,\n SETTINGS_MAGIC_1 = 781864998,\n BOOT_RTC_SIGNATURE = 1906448503,\n APP_RTC_SIGNATURE = 614608146,\n PAGE_SIZE = 1024,\n DEV_NUM_PINS = 64,\n CODAL_PIN = 13,\n IMAGE_BITS = 4,\n PA_0 = 0,\n PA_1 = 1,\n PA_2 = 2,\n PA_3 = 3,\n PA_4 = 4,\n PA_5 = 5,\n PA_6 = 6,\n PA_7 = 7,\n PA_8 = 8,\n PA_9 = 9,\n PA_10 = 10,\n PA_11 = 11,\n PA_12 = 12,\n PA_13 = 13,\n PA_14 = 14,\n PA_15 = 15,\n PB_0 = 16,\n PB_1 = 17,\n PB_2 = 18,\n PB_3 = 19,\n PB_4 = 20,\n PB_5 = 21,\n PB_6 = 22,\n PB_7 = 23,\n PB_8 = 24,\n PB_9 = 25,\n PB_10 = 26,\n PB_11 = 27,\n PB_12 = 28,\n PB_13 = 29,\n PB_14 = 30,\n PB_15 = 31,\n PC_0 = 32,\n PC_1 = 33,\n PC_2 = 34,\n PC_3 = 35,\n PC_4 = 36,\n PC_5 = 37,\n PC_6 = 38,\n PC_7 = 39,\n PC_8 = 40,\n PC_9 = 41,\n PC_10 = 42,\n PC_11 = 43,\n PC_12 = 44,\n PC_13 = 45,\n PC_14 = 46,\n PC_15 = 47,\n PD_0 = 48,\n PD_1 = 49,\n PD_2 = 50,\n PD_3 = 51,\n PD_4 = 52,\n PD_5 = 53,\n PD_6 = 54,\n PD_7 = 55,\n PD_8 = 56,\n PD_9 = 57,\n PD_10 = 58,\n PD_11 = 59,\n PD_12 = 60,\n PD_13 = 61,\n PD_14 = 62,\n PD_15 = 63,\n // /pxtapp/pxt.h\n PXT_COMM_BASE = 536879104,\n PXT_CODAL = 1,\n DEVICE_ID_BUTTON_SLIDE = 3000,\n DEVICE_ID_MICROPHONE = 3001,\n DEVICE_ID_FIRST_BUTTON = 4000,\n DEVICE_ID_FIRST_TOUCHBUTTON = 4100,\n PXT_INTERNAL_KEY_UP = 2050,\n PXT_INTERNAL_KEY_DOWN = 2051,\n // /pxtapp/pxtbase.h\n PXT32 = 1,\n PXT64 = 1,\n PXT_REFCNT_FLASH = 65534,\n VTABLE_MAGIC = 249,\n VTABLE_MAGIC2 = 248,\n Undefined = 0,\n Boolean = 1,\n Number = 2,\n String = 3,\n Object = 4,\n Function = 5,\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,\n MMap = 10,\n BoxedString_SkipList = 11,\n BoxedString_ASCII = 12,\n ZPin = 13,\n User0 = 16,\n IMAGE_HEADER_MAGIC = 135,\n Int8LE = 1,\n UInt8LE = 2,\n Int16LE = 3,\n UInt16LE = 4,\n Int32LE = 5,\n Int8BE = 6,\n UInt8BE = 7,\n Int16BE = 8,\n UInt16BE = 9,\n Int32BE = 10,\n UInt32LE = 11,\n UInt32BE = 12,\n Float32LE = 13,\n Float64LE = 14,\n Float32BE = 15,\n Float64BE = 16,\n NUM_TRY_FRAME_REGS = 3,\n GC = 0,\n PXT_STRING_SKIP_INCR = 16,\n // /pxtapp/pxtconfig.h\n PXT_UF2_FAMILY = 1467308631,\n // /pxtapp/settings/Flash.h\n DEVICE_FLASH_ERROR = 922,\n // /pxtapp/settings/RAFFS.h\n RAFFS_FOLLOWING_MASK = 32768,\n // /pxtapp/uf2hid.h\n UF2_HID_H = 1,\n}\n",
"dmac.cpp": "#include \"dmac.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nSINGLETON(WDMAC);\n#endif\n\n}",
"dmac.h": "#ifndef __DMAC_H\n#define __DMAC_H\n\n#include \"pxt.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nclass WDMAC {\n public:\n CODAL_DMAC dmac;\n\n WDMAC() {}\n};\n\nWDMAC* getWDMAC();\n#endif\n\n}\n\n#endif",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum PulseValue {\n //% block=high\n High = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=low\n Low = 5, // DEVICE_PIN_EVT_PULSE_LO\n }\n\n\n declare const enum PinEvent {\n //% block=\"pulse high\"\n PulseHigh = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=\"pulse low\"\n PulseLow = 5, // DEVICE_PIN_EVT_PULSE_LO\n //% block=\"rise\"\n Rise = 2, // DEVICE_PIN_EVT_RISE\n //% block=\"fall\"\n Fall = 3, // DEVICE_PIN_EVT_FALL\n }\n\n\n declare const enum PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"hf2.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#ifndef USB_HANDOVER\n#define USB_HANDOVER 1\n#endif\n\n#if USB_HANDOVER\n#define UF2_DEFINE_HANDOVER 1\n#endif\n\n#include \"uf2format.h\"\n\nstatic void *stackCopy;\nstatic uint32_t stackSize;\n\n//#define LOG DMESG\n#define LOG(...) ((void)0)\n\nstatic volatile bool resume = false;\n\nusing namespace codal;\n\n#ifdef HF2_HID\nstatic const char hidDescriptor[] = {\n 0x06, 0x97, 0xFF, // usage page vendor 0x97 (usage 0xff97 0x0001)\n 0x09, 0x01, // usage 1\n 0xA1, 0x01, // collection - application\n 0x15, 0x00, // logical min 0\n 0x26, 0xFF, 0x00, // logical max 255\n 0x75, 8, // report size 8\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x81, 0x02, // input: data, variable, absolute\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x91, 0x02, // output: data, variable, absolute\n 0x95, 1, // report count 1\n 0x09, 0x01, // usage 1\n 0xB1, 0x02, // feature: data, variable, absolute\n 0xC0, // end\n};\n\nstatic const HIDReportDescriptor reportDesc = {\n 9,\n 0x21, // HID\n 0x100, // hidbcd 1.00\n 0x00, // country code\n 0x01, // num desc\n 0x22, // report desc type\n sizeof(hidDescriptor), // size of 0x22\n};\n\nstatic const InterfaceInfo ifaceInfoHID = {\n &reportDesc,\n sizeof(reportDesc),\n 1,\n {\n 2, // numEndpoints\n 0x03, /// class code - HID\n 0x00, // subclass\n 0x00, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_INTERRUPT, 1},\n {USB_EP_TYPE_INTERRUPT, 1},\n};\n#endif\n\nstatic const InterfaceInfo ifaceInfoEP = {\n NULL,\n 0,\n 2,\n {\n 2, // numEndpoints\n 0xff, /// class code - vendor-specific\n 42, // subclass\n 1, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_BULK, 0},\n {USB_EP_TYPE_BULK, 0},\n};\n\nint HF2::stdRequest(UsbEndpointIn &ctrl, USBSetup &setup) {\n#ifdef HF2_HID\n if (!useHID)\n return DEVICE_NOT_SUPPORTED;\n if (setup.bRequest == USB_REQ_GET_DESCRIPTOR) {\n if (setup.wValueH == 0x21) {\n InterfaceDescriptor tmp;\n fillInterfaceInfo(&tmp);\n return ctrl.write(&tmp, sizeof(tmp));\n } else if (setup.wValueH == 0x22) {\n return ctrl.write(hidDescriptor, sizeof(hidDescriptor));\n }\n }\n#endif\n return DEVICE_NOT_SUPPORTED;\n}\n\n// same as in microbit\n#define CTRL_GET_REPORT 0x01\n#define CTRL_SET_REPORT 0x09\n#define CTRL_OUT_REPORT_H 0x2\n#define CTRL_IN_REPORT_H 0x1\n\nvoid HF2::sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend) {\n if (!CodalUSB::usbInstance->isInitialised())\n return;\n\n uint32_t buf[64 / 4]; // aligned\n\n if (prepend + 1)\n size += 4;\n\n target_disable_irq();\n while (size > 0) {\n memset(buf + 1, 0, 60);\n int s = 63;\n if (size <= 63) {\n s = size;\n buf[0] = flag;\n } else {\n buf[0] = flag == HF2_FLAG_CMDPKT_LAST ? HF2_FLAG_CMDPKT_BODY : flag;\n }\n buf[0] |= s;\n uint8_t *dst = (uint8_t *)buf;\n dst++;\n if (prepend + 1) {\n memcpy(dst, &prepend, 4);\n prepend = -1;\n dst += 4;\n s -= 4;\n size -= 4;\n }\n memcpy(dst, data, s);\n data = (const uint8_t *)data + s;\n size -= s;\n\n in->write(buf, sizeof(buf));\n }\n target_enable_irq();\n}\n\nconst InterfaceInfo *HF2::getInterfaceInfo() {\n#ifdef HF2_HID\n if (useHID)\n return &ifaceInfoHID;\n#endif\n return &ifaceInfoEP;\n}\n\nint HF2::sendEvent(uint32_t evId, const void *data, int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, evId);\n return 0;\n}\n\nint HF2::sendSerial(const void *data, int size, int isError) {\n if (!gotSomePacket)\n return DEVICE_OK;\n\n sendBuffer(isError ? HF2_FLAG_SERIAL_ERR : HF2_FLAG_SERIAL_OUT, data, size);\n\n return 0;\n}\n\n// Receive HF2 message\n// Does not block. Will store intermediate data in pkt.\n// `serial` flag is cleared if we got a command message.\nint HF2::recv() {\n uint8_t buf[64];\n\n int len = out->read(buf, sizeof(buf));\n // DMESG(\"HF2 read: %d\", len);\n\n if (len <= 0)\n return len;\n\n uint8_t tag = buf[0];\n // serial packets not allowed when in middle of command packet\n usb_assert(pkt.size == 0 || !(tag & HF2_FLAG_SERIAL_OUT));\n int size = tag & HF2_SIZE_MASK;\n usb_assert(pkt.size + size <= (int)sizeof(pkt.buf));\n memcpy(pkt.buf + pkt.size, buf + 1, size);\n pkt.size += size;\n tag &= HF2_FLAG_MASK;\n if (tag != HF2_FLAG_CMDPKT_BODY) {\n if (tag == HF2_FLAG_CMDPKT_LAST)\n pkt.serial = 0;\n else if (tag == HF2_FLAG_SERIAL_OUT)\n pkt.serial = 1;\n else\n pkt.serial = 2;\n int sz = pkt.size;\n pkt.size = 0;\n return sz;\n }\n return 0;\n}\n\nint HF2::sendResponse(int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, pkt.buf, 4 + size);\n return 0;\n}\n\nint HF2::sendResponseWithData(const void *data, int size) {\n if (size <= (int)sizeof(pkt.buf) - 4) {\n memcpy(pkt.resp.data8, data, size);\n return sendResponse(size);\n } else {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, pkt.resp.eventId);\n return 0;\n }\n}\n\nstatic void copy_words(void *dst0, const void *src0, uint32_t n_words) {\n uint32_t *dst = (uint32_t *)dst0;\n const uint32_t *src = (const uint32_t *)src0;\n while (n_words--)\n *dst++ = *src++;\n}\n\n#ifndef QUICK_BOOT\n#ifdef SAMD21\n#define DBL_TAP_PTR ((volatile uint32_t *)(HMCRAMC0_ADDR + HMCRAMC0_SIZE - 4))\n#endif\n#ifdef SAMD51\n#define DBL_TAP_PTR ((volatile uint32_t *)(HSRAM_ADDR + HSRAM_SIZE - 4))\n#endif\n#if defined(NRF52840) || defined(NRF52833)\n#define DBL_TAP_PTR ((volatile uint32_t*)0x20007F7C)\n#endif\n#define DBL_TAP_MAGIC_QUICK_BOOT 0xf02669ef\n#define QUICK_BOOT(v) *DBL_TAP_PTR = v ? DBL_TAP_MAGIC_QUICK_BOOT : 0\n#endif\n\nstatic HF2 *jdLogger;\nstatic void jdLog(const uint8_t *frame) {\n jdLogger->sendEvent(HF2_EV_JDS_PACKET, frame, frame[2] + 12);\n}\n\nint HF2::endpointRequest() {\n int sz = recv();\n\n if (!sz)\n return 0;\n\n uint32_t tmp;\n\n if (pkt.serial) {\n // TODO raise some event?\n return 0;\n }\n\n LOG(\"HF2 sz=%d CMD=%x\", sz, pkt.buf32[0]);\n\n // one has to be careful dealing with these, as they share memory\n HF2_Command *cmd = &pkt.cmd;\n HF2_Response *resp = &pkt.resp;\n\n uint32_t cmdId = cmd->command_id;\n resp->tag = cmd->tag;\n resp->status16 = HF2_STATUS_OK;\n\n#define checkDataSize(str, add) usb_assert(sz == 8 + (int)sizeof(cmd->str) + (int)(add))\n\n lastExchange = current_time_ms();\n gotSomePacket = true;\n\n switch (cmdId) {\n case HF2_CMD_INFO:\n return sendResponseWithData(uf2_info(), strlen(uf2_info()));\n\n case HF2_CMD_BININFO:\n resp->bininfo.mode = HF2_MODE_USERSPACE;\n resp->bininfo.flash_page_size = 0;\n resp->bininfo.flash_num_pages = 0;\n resp->bininfo.max_message_size = sizeof(pkt.buf);\n resp->bininfo.uf2_family = PXT_UF2_FAMILY;\n return sendResponse(sizeof(resp->bininfo));\n\n case HF2_DBG_RESTART:\n *HF2_DBG_MAGIC_PTR = HF2_DBG_MAGIC_START;\n target_reset();\n break;\n\n case HF2_CMD_RESET_INTO_APP:\n QUICK_BOOT(1);\n NVIC_SystemReset();\n break;\n case HF2_CMD_RESET_INTO_BOOTLOADER:\n QUICK_BOOT(0);\n NVIC_SystemReset();\n break;\n\n#if USB_HANDOVER\n case HF2_CMD_START_FLASH:\n sendResponse(0);\n hf2_handover(in->ep);\n usb_assert(0); // should not be reached\n break;\n#endif\n\n case HF2_CMD_WRITE_WORDS:\n checkDataSize(write_words, cmd->write_words.num_words << 2);\n copy_words((void *)cmd->write_words.target_addr, cmd->write_words.words,\n cmd->write_words.num_words);\n break;\n\n case HF2_CMD_READ_WORDS:\n checkDataSize(read_words, 0);\n tmp = cmd->read_words.num_words;\n usb_assert(tmp <= sizeof(pkt.buf) / 4 - 1);\n copy_words(resp->data32, (void *)cmd->read_words.target_addr, tmp);\n return sendResponse(tmp << 2);\n\n case HF2_CMD_DMESG:\n#if DEVICE_DMESG_BUFFER_SIZE > 0\n return sendResponseWithData(codalLogStore.buffer, codalLogStore.ptr);\n#else\n break;\n#endif\n\n case HF2_DBG_GET_GLOBAL_STATE: {\n HF2_GLOBAL_STATE_Result gstate = {\n .num_globals = (uint32_t)getNumGlobals(), //\n .globals_addr = (uint32_t)globals,\n };\n return sendResponseWithData(&gstate, sizeof(gstate));\n }\n\n case HF2_DBG_RESUME:\n globals[0] = (TValue)cmd->data32[0];\n resume = true;\n return sendResponse(0);\n\n case HF2_DBG_GET_STACK:\n return sendResponseWithData(stackCopy, stackSize);\n\n case HF2_CMD_JDS_CONFIG:\n if (cmd->data8[0]) {\n jdLogger = this;\n pxt::logJDFrame = jdLog;\n } else {\n pxt::logJDFrame = NULL;\n }\n return sendResponse(0);\n\n case HF2_CMD_JDS_SEND:\n if (pxt::sendJDFrame) {\n pxt::sendJDFrame(cmd->data8);\n return sendResponse(0);\n } else {\n resp->status16 = HF2_STATUS_INVALID_STATE;\n return sendResponse(0);\n }\n\n default:\n // command not understood\n resp->status16 = HF2_STATUS_INVALID_CMD;\n break;\n }\n\n return sendResponse(0);\n}\n\nHF2::HF2(HF2_Buffer &p) : gotSomePacket(false), ctrlWaiting(false), pkt(p), useHID(false) {\n lastExchange = 0;\n}\n\nstatic const InterfaceInfo dummyIfaceInfo = {\n NULL,\n 0,\n 0,\n {\n 0, // numEndpoints\n 0xff, /// class code - vendor-specific\n 0xff, // subclass\n 0xff, // protocol\n 0x00, // string\n 0x00, // alt\n },\n {0, 0},\n {0, 0},\n};\n\nconst InterfaceInfo *DummyIface::getInterfaceInfo() {\n return &dummyIfaceInfo;\n}\n\n//\n//\n// Debugger\n//\n//\n\nstruct ExceptionContext {\n uint32_t excReturn; // 0xFFFFFFF9\n uint32_t r0;\n uint32_t r1;\n uint32_t r2;\n uint32_t r3;\n uint32_t r12;\n uint32_t lr;\n uint32_t faultInstrAddr;\n uint32_t psr;\n};\n\nstruct Paused_Data {\n uint32_t pc;\n};\nstatic Paused_Data pausedData;\n\nvoid bkptPaused() {\n\n// waiting for https://github.com/lancaster-university/codal/pull/14\n#ifdef DEVICE_GROUP_ID_USER\n // the loop below counts as \"system\" task, and we don't want to pause ourselves\n fiber_set_group(DEVICE_GROUP_ID_SYSTEM);\n // pause everyone else\n fiber_pause_group(DEVICE_GROUP_ID_USER);\n#endif\n\n while (!resume) {\n // DMESG(\"BKPT\");\n hf2.pkt.resp.eventId = HF2_EV_DBG_PAUSED;\n hf2.sendResponseWithData(&pausedData, sizeof(pausedData));\n // TODO use an event\n for (int i = 0; i < 20; ++i) {\n if (resume)\n break;\n fiber_sleep(50);\n }\n }\n\n if (stackCopy) {\n xfree(stackCopy);\n stackCopy = NULL;\n }\n\n#ifdef DEVICE_GROUP_ID_USER\n fiber_resume_group(DEVICE_GROUP_ID_USER);\n // go back to user mode\n fiber_set_group(DEVICE_GROUP_ID_USER);\n#endif\n\n resume = false;\n}\n\nextern \"C\" void handleHardFault(ExceptionContext *ectx) {\n auto instr = (uint16_t *)ectx->faultInstrAddr;\n\n DMESG(\"FLT %p\", instr);\n\n if (ectx->faultInstrAddr & 0x80000000) {\n ectx->faultInstrAddr &= ~0x80000000;\n // switch to step-over mode\n globals[0] = (TValue)3;\n return;\n }\n\n DMESG(\"BB %p %p %p lr=%p r0=%p\", instr[-1], instr[0], instr[1], ectx->lr, ectx->r0);\n\n if (instr[0] == 0x6840) {\n // ldr r0, [r0, #4] -- entry breakpoint\n ectx->faultInstrAddr += 2;\n // we're being ask for step-over mode\n if (ectx->r0 == 3) {\n // switch to debugger-attached-no-stepping mode\n globals[0] = (TValue)0;\n ectx->lr |= 0x80000000;\n }\n return;\n }\n\n if (instr[0] == 0x6800) {\n // ldr r0, [r0, #0]\n ectx->lr = ectx->faultInstrAddr + 3; // next instruction + thumb mode\n pausedData.pc = ectx->faultInstrAddr + 2;\n void *ssp = (void *)(ectx + 1);\n stackSize = DEVICE_STACK_BASE - (uint32_t)ssp;\n if (stackCopy)\n xfree(stackCopy);\n stackCopy = xmalloc(stackSize);\n memcpy(stackCopy, ssp, stackSize);\n ectx->faultInstrAddr = ((uint32_t)(&bkptPaused) & (~1U));\n return;\n }\n\n while (1) {\n }\n}\n\nextern \"C\" void HardFault_Handler(void) {\n asm(\"push {lr}; mov r0, sp; bl handleHardFault; pop {pc}\");\n}\n\n#endif",
"hf2.h": "#ifndef DEVICE_HF2_H\n#define DEVICE_HF2_H\n\n#if CONFIG_ENABLED(DEVICE_USB)\n\n#include \"HID.h\"\n#include \"uf2hid.h\"\n\n// 260 bytes needed for biggest JD packets (with overheads)\n#define HF2_BUF_SIZE 260\n\ntypedef struct {\n uint16_t size;\n uint8_t serial;\n union {\n uint8_t buf[HF2_BUF_SIZE];\n uint32_t buf32[HF2_BUF_SIZE / 4];\n uint16_t buf16[HF2_BUF_SIZE / 2];\n HF2_Command cmd;\n HF2_Response resp;\n };\n} HF2_Buffer;\n\nclass HF2 : public CodalUSBInterface {\n bool gotSomePacket;\n bool ctrlWaiting;\n uint32_t lastExchange;\n\n public:\n HF2_Buffer &pkt;\n\n bool useHID;\n\n int sendResponse(int size);\n int recv();\n int sendResponseWithData(const void *data, int size);\n int sendEvent(uint32_t evId, const void *data, int size);\n void sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend = -1);\n\n HF2(HF2_Buffer &pkt);\n virtual int endpointRequest();\n virtual int stdRequest(UsbEndpointIn &ctrl, USBSetup &setup);\n virtual const InterfaceInfo *getInterfaceInfo();\n int sendSerial(const void *data, int size, int isError = 0);\n\n virtual bool enableWebUSB() { return !useHID; }\n};\n\nclass DummyIface : public CodalUSBInterface {\n public:\n virtual const InterfaceInfo *getInterfaceInfo();\n};\n\n#endif\n\n#endif\n",
"hf2dbg.h": "#ifndef HF2DBG_H\n#define HF2DBG_H 1\n\n// we use a location at the top of the stack to store a magic value\n// which causes us to stop at the very first break point in the program\n#define HF2_DBG_MAGIC_PTR ((uint32_t *)(DEVICE_STACK_BASE - (DEVICE_STACK_SIZE - 4)))\n#define HF2_DBG_MAGIC_START 0xf0ebac7f\n\n#define HF2_DBG_GET_GLOBAL_STATE 0x53fc66e0\nstruct HF2_GLOBAL_STATE_Result {\n uint32_t num_globals;\n uint32_t globals_addr;\n};\n\n#define HF2_DBG_RESTART 0x1120bd93\n#define HF2_DBG_RESUME 0x27a55931\n#define HF2_EV_DBG_PAUSED 0x3692f9fd\n#define HF2_DBG_GET_STACK 0x70901510\n\n#endif\n",
"i2c.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n#include \"CodalDmesg.h\"\n#include \"configkeys.h\"\n\n#ifdef CODAL_I2C\n\nnamespace pins {\n\nclass CodalI2CProxy {\nprivate:\n DevicePin* sda;\n DevicePin* scl;\n CODAL_I2C i2c;\npublic:\n CodalI2CProxy* next;\npublic:\n CodalI2CProxy(DevicePin* _sda, DevicePin* _scl)\n : sda(_sda)\n , scl(_scl)\n , i2c(*_sda, *_scl) \n , next(NULL)\n {\n\n }\n\n CODAL_I2C* getI2C() {\n return &(this->i2c);\n }\n \n bool matchPins(DevicePin* sda, DevicePin* scl) {\n return this->sda == sda && this->scl == scl;\n }\n\n Buffer readBuffer(int address, int size, bool repeat = false)\n {\n Buffer buf = mkBuffer(NULL, size);\n registerGCObj(buf);\n int status = this->i2c.read(address << 1, buf->data, size, repeat);\n unregisterGCObj(buf);\n if (status != ErrorCode::DEVICE_OK) {\n buf = 0;\n }\n return buf;\n }\n\n int writeBuffer(int address, Buffer buf, bool repeat = false)\n {\n return this->i2c.write(address << 1, buf->data, buf->length, repeat);\n }\n};\n\n}\n\nnamespace I2CMethods {\n/**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n//%\nBuffer readBuffer(I2C_ i2c, int address, int size, bool repeat = false)\n{\n return i2c->readBuffer(address, size, repeat);\n}\n\n/**\n * Write bytes to a 7-bit I2C `address`.\n */\n//%\nint writeBuffer(I2C_ i2c, int address, Buffer buf, bool repeat = false)\n{\n return i2c->writeBuffer(address, buf, repeat);\n}\n\n}\n\nnamespace pins {\n\nstatic I2C_ i2cs(NULL);\n/**\n* Opens a Serial communication driver\n*/\n//% help=pins/create-i2c\n//% parts=i2c\nI2C_ createI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n // pick up defaults\n if (!sda || !scl) {\n DMESG(\"i2c: lookup default pins\");\n sda = LOOKUP_PIN(SDA);\n scl = LOOKUP_PIN(SCL);\n }\n\n // lookup existing devices\n auto dev = i2cs;\n while(dev) {\n if (dev->matchPins(sda, scl)) {\n DMESG(\"i2c: found existing i2c\");\n return dev;\n }\n dev = dev->next;\n }\n\n // allocate new one\n DMESG(\"i2c: mounting on new device\");\n auto ser = new CodalI2CProxy(sda, scl);\n // push in list\n ser->next = i2cs;\n i2cs = ser;\n return ser;\n}\n\n}\n\nnamespace pxt {\n CODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n auto i2c = pins::createI2C(sda, scl);\n return i2c->getI2C();\n }\n}\n\n#endif",
"i2c.ts": "namespace pins {\n /**\n * Read one number from an I2C address.\n */\n //% help=pins/i2c-read-number weight=5 group=\"i2c\" inlineInputMode=\"external\"\n //% blockId=pins_i2c_readnumber block=\"i2c read number at address %address|of format %format|repeated %repeated\"\n export function i2cReadNumber(address: number, format: NumberFormat, repeated?: boolean): number {\n const buf = pins.i2cReadBuffer(address, pins.sizeOf(format), repeated)\n if (!buf)\n return undefined\n return buf.getNumber(format, 0)\n }\n\n /**\n * Write one number to an I2C address.\n */\n //% help=pins/i2c-write-number weight=4 group=\"i2c\"\n //% blockId=i2c_writenumber block=\"i2c write number|at address %address|with value %value|of format %format|repeated %repeated\"\n export function i2cWriteNumber(address: number, value: number, format?: NumberFormat, repeated?: boolean): void {\n if (format == undefined)\n format = NumberFormat.UInt8LE;\n const buf = control.createBuffer(pins.sizeOf(format))\n buf.setNumber(format, 0, value)\n pins.i2cWriteBuffer(address, buf, repeated)\n }\n\n /**\n * Write a value in a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param value value to write\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-write-register\n //% blockId=i2c_writereg block=\"i2c write register|at address $address|at register $register|value $value\"\n export function i2cWriteRegister(address: number, register: number, value: number, valueFormat?: NumberFormat): void {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n const valueSize = pins.sizeOf(valueFormat);\n const buf = control.createBuffer(1 + valueSize);\n buf.setNumber(NumberFormat.UInt8LE, 0, register);\n buf.setNumber(valueFormat, 1, value);\n pins.i2cWriteBuffer(address, buf);\n }\n\n /**\n * Read the value from a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-read-register\n //% blockId=i2c_readreg block=\"i2c read register|at address $address|at register $register\"\n export function i2cReadRegister(address: number, register: number, valueFormat?: NumberFormat): number {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n pins.i2cWriteNumber(address, register, NumberFormat.UInt8LE);\n return pins.i2cReadNumber(address, valueFormat);\n }\n\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //%\n export function i2cReadBuffer(address: number, size: number, repeat: boolean = false): Buffer {\n return pins.i2c().readBuffer(address, size, repeat);\n }\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //%\n export function i2cWriteBuffer(address: number, buf: Buffer, repeat: boolean = false): number {\n return pins.i2c().writeBuffer(address, buf, repeat);\n }\n\n let _i2c: I2C;\n /**\n * Gets the default I2C bus\n */\n //%\n export function i2c(): I2C {\n if (!_i2c) {\n const sda = pins.pinByCfg(DAL.CFG_PIN_SDA);\n const scl = pins.pinByCfg(DAL.CFG_PIN_SCL);\n _i2c = pins.createI2C(sda, scl); \n }\n return _i2c; \n }\n\n export class I2CDevice {\n public address: number;\n public bus: I2C;\n private _hasError: boolean;\n constructor(address: number, bus?: I2C) {\n this.address = address;\n this.bus = bus || i2c();\n }\n public readInto(buf: Buffer, repeat = false, start = 0, end: number = null) {\n if (end === null)\n end = buf.length\n if (start >= end)\n return\n let res = this.bus.readBuffer(this.address, end - start, repeat)\n if (!res) {\n this._hasError = true\n return\n }\n buf.write(start, res)\n }\n public write(buf: Buffer, repeat = false) {\n let res = this.bus.writeBuffer(this.address, buf, repeat)\n if (res) {\n this._hasError = true\n }\n }\n public begin(): I2CDevice {\n this._hasError = false;\n return this;\n }\n public end() {\n }\n public ok() {\n return !this._hasError\n }\n\n public transfer(command: Buffer, response: Buffer, responseStart?: number, responseEnd?: number) {\n this.begin();\n if (command)\n this.write(command);\n if (response)\n this.readInto(response, false, responseStart, responseEnd);\n this.end();\n } \n }\n}\n",
"keyvaluestorage.cpp": "#include \"pxt.h\"\n#include \"KeyValueStorage.h\"\n\nnamespace pxt {\n\nclass WKeyValueStorage {\n#ifdef CODAL_NVMCONTROLLER\n CODAL_NVMCONTROLLER controller;\n#else\n NVMController controller;\n#endif\n KeyValueStorage storage;\n public:\n\n WKeyValueStorage()\n : controller()\n , storage(controller) {\n }\n\n bool isSupported() {\n#ifdef CODAL_NVMCONTROLLER\n return true;\n#else\n return false;\n#endif\n }\n\n int put(String key, Buffer data) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n return storage.put(mkey, data->data, data->length);\n#else\n return -1;\n#endif\n }\n\n Buffer get(String key) {\n#ifdef CODAL_NVMCONTROLLER\n Buffer buf = NULL;\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n auto entry = storage.get(mkey);\n if (entry) {\n buf = mkBuffer(entry->value, sizeof(entry->value));\n free(entry);\n }\n return buf;\n#else\n return NULL;\n#endif\n }\n\n void remove(String key) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n storage.remove(mkey);\n#endif\n }\n\n void clear() {\n#ifdef CODAL_NVMCONTROLLER\n storage.wipe();\n#endif\n }\n};\nSINGLETON(WKeyValueStorage);\n\n}\n\nnamespace configStorage {\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //%\n void setBuffer(String key, Buffer value) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->put(key, value);\n }\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //%\n Buffer getBuffer(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n return kvm->get(key);\n }\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //%\n void removeItem(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->remove(key);\n }\n\n /**\n * Clears the local storage\n */\n //%\n void clear() {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->clear();\n }\n}\n",
"keyvaluestorage.ts": "namespace configStorage {\n /**\n * Stores the value at the key entry\n * @param key identifier of the key (max 16 characters)\n * @param value identifier of the value (max 32 characters)\n */\n export function setItem(key: string, value: string) {\n if (value == null)\n configStorage.removeItem(key);\n else\n {\n let idx = 0;\n let buf = control.createBuffer(value.length + 1);\n buf[idx++] = value.length;\n let valBuf = control.createBufferFromUTF8(value);\n\n for (let i = 0; i < valBuf.length; i++)\n buf[idx++] = valBuf[i];\n\n configStorage.setBuffer(key, buf);\n }\n }\n\n /**\n * Retrieves the value at the key entry\n * @param key identifier of the key (max 16 characters)\n */\n export function getItem(key: string): string {\n const buf = configStorage.getBuffer(key);\n\n if (!buf)\n return undefined;\n\n let idx = 0;\n let count = buf[idx++];\n const retBuf = control.createBuffer(count);\n\n for (let i = 0; i < count; i++)\n retBuf[i] = buf[idx++];\n\n return retBuf.toString();\n }\n}\n",
"leveldetector.ts": "namespace pins {\n export class LevelDetector {\n public id: number;\n public min: number;\n public max: number;\n public lowThreshold: number;\n public highThreshold: number;\n private transition: number;\n private transitionMs: number;\n private _level: number;\n private _state: number;\n public onHigh: () => void;\n public onLow: () => void;\n public onNeutral: () => void;\n public transitionWindow: number;\n // minimum duration (ms) between events\n public transitionInterval: number;\n\n static LEVEL_THRESHOLD_NEUTRAL = 0;\n\n constructor(id: number,\n min: number, max: number,\n lowThreshold: number, highThreshold: number) {\n this.id = id;\n this.min = min;\n this.max = max;\n this.lowThreshold = lowThreshold;\n this.highThreshold = highThreshold;\n this.transitionWindow = 4;\n this.transitionInterval = 0;\n\n this.onHigh = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_HIGH);\n this.onLow = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_LOW);\n this.onNeutral = undefined;\n\n this.reset();\n }\n\n reset() {\n this.transition = 0;\n this.transitionMs = 0;\n this._level = Math.ceil((this.highThreshold - this.lowThreshold) / 2);\n this._state = LevelDetector.LEVEL_THRESHOLD_NEUTRAL;\n }\n\n get level(): number {\n return this._level;\n }\n\n set level(level: number) {\n this._level = this.clampValue(level);\n\n if (this._level >= this.highThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_HIGH);\n }\n else if (this._level <= this.lowThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_LOW);\n }\n else {\n this.setState(LevelDetector.LEVEL_THRESHOLD_NEUTRAL);\n }\n }\n\n public setLowThreshold(value: number) {\n this.lowThreshold = this.clampValue(value);\n this.reset();\n }\n\n public setHighThreshold(value: number) {\n this.highThreshold = this.clampValue(value);\n this.reset();\n }\n\n private clampValue(value: number) {\n if (value < this.min) {\n return this.min;\n }\n else if (value > this.max) {\n return this.max;\n }\n return value;\n }\n\n private setState(state: number) {\n // not enough samples to change\n if (this._state === state \n || (this.transition++ < this.transitionWindow)\n || (control.millis() - this.transitionMs) < this.transitionInterval) {\n return;\n }\n\n this.transition = 0;\n this.transitionMs = control.millis();\n this._state = state;\n switch (state) {\n case DAL.LEVEL_THRESHOLD_HIGH:\n if (this.onHigh) this.onHigh();\n break;\n case DAL.LEVEL_THRESHOLD_LOW:\n if (this.onLow) this.onLow();\n break;\n case LevelDetector.LEVEL_THRESHOLD_NEUTRAL:\n if (this.onNeutral) this.onNeutral();\n break;\n }\n }\n }\n}",
"light.cpp": "#include \"light.h\"\n\n// WS2812B timings, datasheet v1\n// 0 - 0.25-0.55us hi 0.70-1.00us low\n// 1 - 0.65-0.95us hi 0.30-0.60us low\n// datasheet v5\n// 0 - 0.22-0.38us hi 0.58-1.00us low 1-3\n// 1 - 0.58-1.00us hi 0.58-1.00us low 3-2\n\n#define SPI_SUPPORTED 1\n\n#if defined(NRF52_SERIES)\n#define BIT_EXPANSION 5\n#define SPI_FREQ 4000000\n#else\n#define BIT_EXPANSION 3\n#define SPI_FREQ 2400000\n#endif\n\n#if defined(SAMD21) || defined(SAMD51) || defined(STM32F4) || defined(NRF52_SERIES)\n#include \"neopixel.h\"\n#define BITBANG_SUPPORTED 1\n#else\n#define BITBANG_SUPPORTED 0\n#endif\n\n#define NEOPIXEL_MIN_LENGTH_FOR_SPI 24\n#define DOTSTAR_MIN_LENGTH_FOR_SPI 24\n\n#define LIGHTMODE_RGB 1\n#define LIGHTMODE_RGBW 2\n#define LIGHTMODE_RGB_RGB 3\n#define LIGHTMODE_DOTSTAR 4\n\nnamespace light {\nbool isValidMOSIPin(DigitalInOutPin pin) {\n if (!pin)\n return false;\n\n#if SAMD51\n return ZSPI::isValidMOSIPin(*pin);\n#elif defined(NRF52_SERIES)\n return true;\n#else\n // TODO: support for SPI neopixels\n // default SPI pins supported for now\n return pin == LOOKUP_PIN(MOSI);\n#endif\n}\n\n// SPI\nvoid spiNeopixelSendBuffer(DevicePin *pin, const uint8_t *data, unsigned size) {\n int32_t iptr = 0, optr = 120;\n uint32_t len = optr + size * BIT_EXPANSION + 120;\n uint8_t *expBuf = new uint8_t[len];\n memset(expBuf, 0, len);\n uint8_t imask = 0x80;\n uint8_t omask = 0x80;\n\n#define WR(k) \\\n if (k) \\\n expBuf[optr] |= omask; \\\n omask >>= 1; \\\n if (!omask) { \\\n omask = 0x80; \\\n optr++; \\\n }\n\n while (iptr < (int)size) {\n#if BIT_EXPANSION == 3\n WR(1);\n WR(data[iptr] & imask);\n WR(0);\n#elif BIT_EXPANSION == 5\n WR(1);\n if (data[iptr] & imask) {\n WR(1);\n WR(1);\n } else {\n WR(0);\n }\n WR(0);\n WR(0);\n#else\n#error \"invalid BIT_EXPANSION\"\n#endif\n\n imask >>= 1;\n if (!imask) {\n imask = 0x80;\n iptr++;\n }\n }\n\n auto spi = pxt::getSPI(pin, NULL, NULL);\n spi->setFrequency(SPI_FREQ);\n spi->transfer(expBuf, len, NULL, 0);\n delete expBuf;\n}\n\nvoid neopixelSendData(DevicePin *pin, int mode, const uint8_t *data, unsigned length) {\n if (!pin || !length)\n return;\n\n#if BITBANG_SUPPORTED\n if (SPI_SUPPORTED && length > NEOPIXEL_MIN_LENGTH_FOR_SPI && isValidMOSIPin(pin))\n spiNeopixelSendBuffer(pin, data, length);\n else\n neopixel_send_buffer(*pin, data, length);\n#else\n if (isValidMOSIPin(pin)) {\n spiNeopixelSendBuffer(pin, data, length);\n }\n#endif\n}\n\nvoid bitBangDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n // first frame of zeroes\n data->setDigitalValue(0);\n for (unsigned i = 0; i < 32; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n\n // data stream\n for (unsigned i = 0; i < length; ++i) {\n auto x = buf[i];\n for (uint8_t j = 0x80; j != 0; j >>= 1) {\n data->setDigitalValue(x & j ? 1 : 0);\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n }\n // https://cpldcpu.wordpress.com/2016/12/13/sk9822-a-clone-of-the-apa102/\n // reset frame\n // data->setDigitalValue(0);\n // for (unsigned i = 0; i < 32 ; ++i) {\n // clk->setDigitalValue(1);\n // clk->setDigitalValue(0);\n //}\n\n // https://cpldcpu.wordpress.com/2014/11/30/understanding-the-apa102-superled/\n data->setDigitalValue(1);\n unsigned n = 32;\n for (unsigned i = 0; i < n; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n}\n\nstatic uint8_t ZERO_FRAME[4];\nstatic uint8_t ONE_FRAME[] = {1, 1, 1, 1};\nvoid spiDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n auto spi = pxt::getSPI(data, NULL, clk);\n\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // initial frame\n spi->transfer(buf, length, NULL, 0);\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // reset frame\n for (unsigned i = 0; i < (length >> 3); i += 32)\n spi->transfer(ONE_FRAME, sizeof(ONE_FRAME), NULL, 0); // final frame\n}\n\nvoid dotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n if (!data || !clk || !buf || !length)\n return;\n\n if (length > DOTSTAR_MIN_LENGTH_FOR_SPI && isValidMOSIPin(data))\n spiDotStarSendData(data, clk, mode, buf, length);\n else\n bitBangDotStarSendData(data, clk, mode, buf, length);\n}\n\nvoid sendBuffer(DevicePin *data, DevicePin *clk, int mode, Buffer buf) {\n if (!data || !buf || !buf->length)\n return;\n\n if (mode == LIGHTMODE_DOTSTAR)\n light::dotStarSendData(data, clk, mode, buf->data, buf->length);\n else\n light::neopixelSendData(data, mode, buf->data, buf->length);\n}\n\nvoid clear() {\n auto neopix = LOOKUP_PIN(NEOPIXEL);\n auto neonum = getConfig(CFG_NUM_NEOPIXELS, 0);\n if (neopix && neonum >= 0) {\n auto n = 3 * neonum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n light::neopixelSendData(neopix, 0x100, off, sizeof(off));\n }\n\n auto data = LOOKUP_PIN(DOTSTAR_DATA);\n auto clk = LOOKUP_PIN(DOTSTAR_CLOCK);\n auto dsnum = getConfig(CFG_NUM_DOTSTARS, 0);\n if (data && clk && dsnum > 0) {\n auto n = 4 * dsnum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n for (int i = 0; i < n; i += 4)\n off[i] = 0xe0;\n bitBangDotStarSendData(data, clk, 0x100, off, sizeof(off));\n }\n}\n\n} // namespace light\n",
"light.h": "#ifndef __PXT_LIGHT_H\n#define __PXT_LIGHT_H\n\n#include \"pxt.h\"\n\nnamespace light {\n /**\n * Clear onboard neopixels\n */\n void clear();\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //%\n void sendBuffer(DigitalInOutPin data, DigitalInOutPin clk, int mode, Buffer buf);\n\n void neopixelSendData(DevicePin* pin, int mode, const uint8_t* data, unsigned length);\n}\n\n#endif",
"ns.ts": "/**\n * Events and data from sensors.\n */\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\n//% groups='[\"other\", \"More\"]'\nnamespace input {\n}\n\n/**\n * Servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\"\nnamespace servos {\n\n}\n\n/**\n * A Joint Asynchronous Communications, Device Agnostic Control.\n */\n//% color=\"#E79251\" weight=1 icon=\"\\uf185\"\n//% groups='[\"Broadcast\", \"Console\", \"Control\"]'\n//% blockGap=8\nnamespace jacdac {\n\n}",
"pins.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\nstatic DevicePin **pinPtrs;\nstatic uint8_t numPinPtrs;\nstatic uint8_t pinPos[DEV_NUM_PINS];\n\n//%\nDevicePin *getPin(int id) {\n\n id &= CFG_PIN_NAME_MSK;\n\n if (id >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n\n // we could use lookupComponent() here - it would be slightly slower\n\n int ptr = pinPos[id];\n if (ptr == 0) {\n pinPtrs = (DevicePin **)realloc(pinPtrs, (numPinPtrs + 1) * sizeof(void *));\n bool isAnalog = IS_ANALOG_PIN(id);\n // GCTODO\n pinPtrs[numPinPtrs++] =\n new DevicePin(DEVICE_ID_IO_P0 + id, (PinName)id,\n isAnalog ? PIN_CAPABILITY_AD : PIN_CAPABILITY_DIGITAL);\n ptr = numPinPtrs;\n pinPos[id] = ptr;\n }\n return pinPtrs[ptr - 1];\n}\n\n//%\nDevicePin *getPinCfg(int key) {\n int p = getConfig(key, -1);\n if (p == -1)\n DMESG(\"no pin cfg: %d\", key);\n return getPin(p);\n}\n\nvoid linkPin(int from, int to) {\n if (from < 0 || from >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n getPin(to);\n pinPos[from] = pinPos[to];\n}\n\n//%\nDevicePin *lookupPin(int pinName) {\n if (pinName < 0 || pinName == 0xff)\n return NULL;\n pinName &= CFG_PIN_NAME_MSK;\n return getPin(pinName);\n}\n\n//%\nDevicePin *lookupPinCfg(int key) {\n return lookupPin(getConfig(key));\n}\n\nCodalComponent *lookupComponent(int id) {\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; ++i) {\n if (CodalComponent::components[i] && CodalComponent::components[i]->id == id)\n return CodalComponent::components[i];\n }\n return NULL;\n}\n\n} // namespace pxt\n\nnamespace pins {\n/**\n* Get a pin by configuration id (DAL.CFG_PIN...)\n*/\n//%\nDigitalInOutPin pinByCfg(int key) {\n return pxt::lookupPinCfg(key);\n}\n\n/**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n//%\nBuffer createBuffer(int size) {\n return mkBuffer(NULL, size);\n}\n\n/**\n * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n//% help=pins/pulse-duration blockGap=8\n//% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n//% weight=19\nint pulseDuration() {\n return pxt::lastEvent.timestamp;\n}\n} // namespace pins\n",
"pins.h": "#ifndef __PXT_PINS_H\n#define __PXT_PINS_H\n\n#define BUTTON_ACTIVE_HIGH_PULL_DOWN (ACTIVE_HIGH | 0x10)\n#define BUTTON_ACTIVE_HIGH_PULL_UP (ACTIVE_HIGH | 0x20)\n#define BUTTON_ACTIVE_HIGH_PULL_NONE (ACTIVE_HIGH | 0x30)\n#define BUTTON_ACTIVE_LOW_PULL_DOWN (ACTIVE_LOW | 0x10)\n#define BUTTON_ACTIVE_LOW_PULL_UP (ACTIVE_LOW | 0x20)\n#define BUTTON_ACTIVE_LOW_PULL_NONE (ACTIVE_LOW | 0x30)\n\n#define PIN(name) ((PinName)pxt::getConfig(CFG_PIN_##name, -1))\n#define LOOKUP_PIN(name) pxt::lookupPin(PIN(name))\n\n// these can be overridden in platform.h\n#ifndef CODAL_PIN\n#define CODAL_PIN CODAL_MBED::Pin\n#endif\n\n#ifndef CODAL_TIMER\n#define CODAL_TIMER CODAL_MBED::Timer\n#endif\n\n#ifndef CODAL_SPI\n#define CODAL_SPI CODAL_MBED::SPI\n#endif\n\n#ifndef CODAL_SERIAL\n#define CODAL_SERIAL CODAL_MBED::Serial\n#endif\n\n#ifndef IS_ANALOG_PIN\n#define IS_ANALOG_PIN(id) ((DEV_ANALOG_PINS >> (id)) & 1)\n#endif\n\ntypedef CODAL_PIN DevicePin;\n\ntypedef DevicePin *DigitalInOutPin;\ntypedef DevicePin *AnalogInOutPin;\ntypedef DevicePin *AnalogInPin;\ntypedef DevicePin *AnalogOutPin;\ntypedef DevicePin *PwmPin;\ntypedef DevicePin *PwmOnlyPin;\ntypedef Button *Button_;\n\nnamespace pxt {\nDevicePin *getPin(int id);\nDevicePin *getPinCfg(int key);\nDevicePin *lookupPin(int pinName);\nDevicePin *lookupPinCfg(int key);\nvoid linkPin(int from, int to);\nCodalComponent *lookupComponent(int id);\n}\n\n#define PINOP(op) name->op\n\n#endif\n",
"pins.ts": "//% noRefCounting fixedInstances\ninterface DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogOutPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInOutPin extends AnalogInPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmOnlyPin extends DigitalInOutPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmPin extends PwmOnlyPin, AnalogInOutPin {\n}\n\n/**\n * Control currents in Pins for analog/digital signals, servos, i2c, ...\n */\n//% color=#A80000 weight=85 icon=\"\\uf140\" advanced=true\n//% groups='[\"other\", \"Servo\", \"i2c\"]'\nnamespace pins {\n}",
"pinsAnalog.cpp": "#include \"pxt.h\"\n\nnamespace AnalogInPinMethods {\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\n */\n//% help=pins/analog-read weight=53\n//% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nint analogRead(AnalogInPin name) {\n return PINOP(getAnalogValue());\n}\n}\n\nnamespace AnalogOutPinMethods {\nvoid analogWrite(AnalogOutPin name, int value) __attribute__ ((weak));\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\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n//% help=pins/analog-write weight=52\n//% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.min=0 value.max=1023\nvoid analogWrite(AnalogOutPin name, int value) {\n PINOP(setAnalogValue(value));\n}\n}",
"pinsDigital.cpp": "#include \"pxt.h\"\n\nenum class PulseValue {\n //% block=high\n High = DEVICE_PIN_EVT_PULSE_HI,\n //% block=low\n Low = DEVICE_PIN_EVT_PULSE_LO\n};\n\nenum class PinEvent {\n //% block=\"pulse high\"\n PulseHigh = DEVICE_PIN_EVT_PULSE_HI,\n //% block=\"pulse low\"\n PulseLow = DEVICE_PIN_EVT_PULSE_LO,\n //% block=\"rise\"\n Rise = DEVICE_PIN_EVT_RISE,\n //% block=\"fall\"\n Fall = DEVICE_PIN_EVT_FALL,\n};\n\nenum class PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2\n};\n\nnamespace DigitalInOutPinMethods {\n/**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n//% help=pins/digital-read weight=61\n//% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nbool digitalRead(DigitalInOutPin name) {\n return PINOP(getDigitalValue()) != 0;\n}\n\n/**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n//% help=pins/digital-write weight=60\n//% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid digitalWrite(DigitalInOutPin name, bool value) {\n PINOP(setDigitalValue(value));\n}\n\n/**\n* Make this pin a digital input, and create events where the timestamp is the duration\n* that this pin was either ``high`` or ``low``.\n*/\n//% help=pins/on-pulsed weight=16 blockGap=8\n//% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\n//% deprecated=1 hidden=1\nvoid onPulsed(DigitalInOutPin pin, PulseValue pulse, Action body) {\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)pulse, body);\n}\n\n/**\n* Register code to run when a pin event occurs. \n*/\n//% help=pins/on-event weight=20 blockGap=8\n//% blockId=pinsonevent block=\"on|pin %pin|%event\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nvoid onEvent(DigitalInOutPin pin, PinEvent event, Action body) {\n switch(event) {\n case PinEvent::PulseHigh:\n case PinEvent::PulseLow:\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)event, body);\n break;\n case PinEvent::Rise:\n case PinEvent::Fall:\n pin->eventOn(DEVICE_PIN_EVENT_ON_EDGE);\n registerWithDal(pin->id, (int)event, body);\n break; \n } \n}\n\n/**\n* Return the duration of a pulse in microseconds\n* @param name the pin which measures the pulse\n* @param value the value of the pulse (default high)\n* @param maximum duration in micro-seconds\n*/\n//% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n//% weight=18 blockGap=8\n//% help=\"pins/pulse-in\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nint pulseIn(DigitalInOutPin pin, PulseValue value, int maxDuration = 2000000) {\n int pulse = PulseValue::High == value ? 1 : 0;\n uint64_t tick = system_timer_current_time_us();\n uint64_t maxd = (uint64_t)maxDuration;\n while (pin->getDigitalValue() != pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n\n uint64_t start = system_timer_current_time_us();\n while (pin->getDigitalValue() == pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n uint64_t end = system_timer_current_time_us();\n return end - start;\n}\n\n/**\n* Set the pull direction of this pin.\n* @param name pin to set the pull mode on\n* @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n*/\n//% help=pins/set-pull weight=17 blockGap=8\n//% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid setPull(DigitalInOutPin name, PinPullMode pull) {\n PullMode m = pull == PinPullMode::PullDown ? PullMode::Down : pull == PinPullMode::PullUp\n ? PullMode::Up\n : PullMode::None;\n PINOP(setPull(m));\n}\n\n}\n\n#ifdef PXT_CODAL\n\nnamespace pxt {\n\nstatic void waitABit() {\n // for (int i = 0; i < 10; ++i)\n // asm volatile(\"nop\");\n}\n\nclass ButtonMultiplexer : public CodalComponent {\n public:\n Pin &latch;\n Pin &clock;\n Pin &data;\n uint32_t state;\n uint32_t invMask;\n uint16_t buttonIdPerBit[8];\n bool enabled;\n\n ButtonMultiplexer(uint16_t id)\n : latch(*LOOKUP_PIN(BTNMX_LATCH)), clock(*LOOKUP_PIN(BTNMX_CLOCK)),\n data(*LOOKUP_PIN(BTNMX_DATA)) {\n this->id = id;\n this->status |= DEVICE_COMPONENT_STATUS_SYSTEM_TICK;\n\n state = 0;\n invMask = 0;\n enabled = true;\n\n memset(buttonIdPerBit, 0, sizeof(buttonIdPerBit));\n\n data.getDigitalValue(PullMode::Down);\n latch.setDigitalValue(1);\n clock.setDigitalValue(1);\n }\n\n void disable() {\n data.getDigitalValue(PullMode::None);\n latch.getDigitalValue(PullMode::None);\n clock.getDigitalValue(PullMode::None);\n enabled = false;\n }\n\n bool isButtonPressed(int id) {\n for (int i = 0; i < 8; ++i) {\n if (buttonIdPerBit[i] == id)\n return (state & (1 << i)) != 0;\n }\n return false;\n }\n\n uint32_t readBits(int bits) {\n latch.setDigitalValue(0);\n waitABit();\n latch.setDigitalValue(1);\n waitABit();\n\n uint32_t state = 0;\n for (int i = 0; i < bits; i++) {\n state <<= 1;\n if (data.getDigitalValue(PullMode::Down))\n state |= 1;\n\n clock.setDigitalValue(0);\n waitABit();\n clock.setDigitalValue(1);\n waitABit();\n }\n\n return state;\n }\n\n virtual void periodicCallback() override {\n if (!enabled)\n return;\n\n uint32_t newState = readBits(8);\n newState ^= invMask;\n if (newState == state)\n return;\n\n for (int i = 0; i < 8; ++i) {\n uint32_t mask = 1 << i;\n if (!buttonIdPerBit[i])\n continue;\n int ev = 0;\n if (!(state & mask) && (newState & mask))\n ev = PXT_INTERNAL_KEY_DOWN;\n else if ((state & mask) && !(newState & mask))\n ev = PXT_INTERNAL_KEY_UP;\n if (ev) {\n Event(ev, buttonIdPerBit[i]);\n Event(ev, 0); // any key\n }\n }\n\n state = newState;\n }\n};\n\nstatic ButtonMultiplexer *btnMultiplexer;\nButtonMultiplexer *getMultiplexer() {\n if (!btnMultiplexer)\n btnMultiplexer = new ButtonMultiplexer(DEVICE_ID_FIRST_BUTTON);\n return btnMultiplexer;\n}\n\nint registerMultiplexedButton(int pin, int buttonId) {\n if (1050 <= pin && pin < 1058) {\n pin -= 50;\n getMultiplexer()->invMask |= 1 << (pin - 1000);\n }\n if (1000 <= pin && pin < 1008) {\n getMultiplexer()->buttonIdPerBit[pin - 1000] = buttonId;\n return 1;\n }\n return 0;\n}\n\nint multiplexedButtonIsPressed(int btnId) {\n if (btnMultiplexer)\n return btnMultiplexer->isButtonPressed(btnId) ? 512 : 0;\n return 0;\n}\n\n//% expose\nuint32_t readButtonMultiplexer(int bits) {\n if (!LOOKUP_PIN(BTNMX_CLOCK))\n return 0;\n return getMultiplexer()->readBits(bits);\n}\n\nvoid disableButtonMultiplexer() {\n if (LOOKUP_PIN(BTNMX_CLOCK)) {\n getMultiplexer()->disable();\n }\n}\n\n}\n\n#endif\n",
"pinsPWM.cpp": "#include \"pxt.h\"\n\nnamespace PwmPinMethods {\n}\n\nnamespace PwmOnlyPinMethods {\n\n/**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n//% help=pins/analog-set-period weight=51\n//% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid analogSetPeriod(PwmOnlyPin name, int period) {\n PINOP(setAnalogPeriodUs(period));\n}\n\n/**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n//% help=pins/servo-write weight=41 group=\"Servo\"\n//% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n//% parts=microservo trackArgs=0\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.defl=90\nvoid servoWrite(PwmOnlyPin name, int value) {\n PINOP(setServoValue(value));\n}\n\n/**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n//% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n//% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n//% parts=microservo blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid servoSetPulse(PwmOnlyPin name, int duration) {\n PINOP(setServoPulseUs(duration));\n}\n\n/**\n* Indicates if the servo is running continuously\n*/\n//% blockHidden=1\nvoid servoSetContinuous(PwmOnlyPin name, bool continuous) {\n // used by simulator\n}\n\n}",
"pinscompat.ts": "// filled in by microbit",
"platform.cpp": "#include \"pxt.h\"\n#include \"STMLowLevelTimer.h\"\n#include \"Accelerometer.h\"\n#include \"light.h\"\n\nnamespace pxt {\n\nstruct TimerConfig {\n uint8_t id;\n uint8_t irqn;\n TIM_TypeDef *addr;\n};\n\n#define TIM1_IRQn TIM1_CC_IRQn\n#ifdef STM32F4\n#define TIM9_IRQn TIM1_BRK_TIM9_IRQn\n#define TIM10_IRQn TIM1_UP_TIM10_IRQn\n#define TIM11_IRQn TIM1_TRG_COM_TIM11_IRQn\n#endif\n\n#define DEF_TIM(n) \\\n { 0x10 + n, TIM##n##_IRQn, TIM##n }\n\nstatic const TimerConfig timers[] = {\n#ifdef TIM1\n DEF_TIM(1),\n#endif\n#ifdef TIM2\n DEF_TIM(2),\n#endif\n#ifdef TIM3\n DEF_TIM(3),\n#endif\n#ifdef TIM4\n DEF_TIM(4),\n#endif\n#ifdef TIM5\n DEF_TIM(5),\n#endif\n#ifdef TIM6\n DEF_TIM(6),\n#endif\n#ifdef TIM7\n DEF_TIM(7),\n#endif\n#ifdef TIM8\n DEF_TIM(8),\n#endif\n#ifdef TIM9\n DEF_TIM(9),\n#endif\n#ifdef TIM10\n DEF_TIM(10),\n#endif\n#ifdef TIM11\n DEF_TIM(11),\n#endif\n#ifdef TIM12\n DEF_TIM(12),\n#endif\n#ifdef TIM13\n DEF_TIM(13),\n#endif\n#ifdef TIM14\n DEF_TIM(14),\n#endif\n#ifdef TIM15\n DEF_TIM(15),\n#endif\n{0,0,0}\n};\n\n#ifdef STM32F1\n#define DEF_TIMERS 0x14120000 // TIM4 TIM2\n#else\n#define DEF_TIMERS 0x15120000 // TIM5 TIM2\n#endif\n\nstatic uint32_t usedTimers;\nstatic int timerIdx(uint8_t id) {\n for (unsigned i = 0; timers[i].id; i++) {\n if (id == timers[i].id)\n return i;\n }\n return -1;\n}\nLowLevelTimer *allocateTimer() {\n uint32_t timersToUse = getConfig(CFG_TIMERS_TO_USE, DEF_TIMERS);\n for (int shift = 24; shift >= 0; shift -= 8) {\n uint8_t tcId = (timersToUse >> shift) & 0xff;\n int idx = timerIdx(tcId);\n if (idx < 0 || (usedTimers & (1 << idx)))\n continue;\n auto dev = timers[idx].addr;\n if (dev->CR1 & TIM_CR1_CEN)\n continue;\n usedTimers |= 1 << idx;\n DMESG(\"allocate TIM%d\", tcId - 0x10);\n return new STMLowLevelTimer(dev, timers[idx].irqn);\n }\n\n soft_panic(PANIC_OUT_OF_TIMERS);\n return NULL;\n}\n\n\nvoid initAccelRandom();\n#ifdef STM32F4\nextern \"C\" void apply_clock_init(RCC_OscInitTypeDef *oscInit, RCC_ClkInitTypeDef *clkConfig,\n uint32_t flashLatency) {\n\n int mhz = getConfig(CFG_CPU_MHZ, 84);\n\n if (mhz >= 216) {\n oscInit->PLL.PLLN = 432;\n oscInit->PLL.PLLP = RCC_PLLP_DIV2;\n oscInit->PLL.PLLQ = 9;\n flashLatency = FLASH_LATENCY_6;\n } else if (mhz >= 192) {\n oscInit->PLL.PLLN = 384;\n oscInit->PLL.PLLP = RCC_PLLP_DIV2;\n oscInit->PLL.PLLQ = 8;\n flashLatency = FLASH_LATENCY_6;\n } else if (mhz >= 168) {\n oscInit->PLL.PLLN = 336;\n oscInit->PLL.PLLP = RCC_PLLP_DIV2;\n oscInit->PLL.PLLQ = 7;\n flashLatency = FLASH_LATENCY_5;\n } else if (mhz >= 144) {\n oscInit->PLL.PLLN = 288;\n oscInit->PLL.PLLP = RCC_PLLP_DIV2;\n oscInit->PLL.PLLQ = 6;\n flashLatency = FLASH_LATENCY_5;\n } else if (mhz >= 108) {\n oscInit->PLL.PLLN = 432;\n oscInit->PLL.PLLP = RCC_PLLP_DIV4;\n oscInit->PLL.PLLQ = 9;\n flashLatency = FLASH_LATENCY_4;\n } else if (mhz >= 96) {\n oscInit->PLL.PLLN = 384;\n oscInit->PLL.PLLP = RCC_PLLP_DIV4;\n oscInit->PLL.PLLQ = 8;\n flashLatency = FLASH_LATENCY_3;\n } else if (mhz >= 84) {\n // this is the default from codal\n oscInit->PLL.PLLN = 336;\n oscInit->PLL.PLLP = RCC_PLLP_DIV4;\n oscInit->PLL.PLLQ = 7;\n flashLatency = FLASH_LATENCY_2;\n } else {\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n }\n\n DMESG(\"CPU clock: %dMHz -> %dMHz\", mhz,\n oscInit->PLL.PLLN / (oscInit->PLL.PLLP == RCC_PLLP_DIV4 ? 4 : 2));\n\n if (mhz > 108) {\n clkConfig->APB1CLKDivider = RCC_HCLK_DIV4;\n clkConfig->APB2CLKDivider = RCC_HCLK_DIV2;\n } else {\n clkConfig->APB1CLKDivider = RCC_HCLK_DIV2;\n clkConfig->APB2CLKDivider = RCC_HCLK_DIV1;\n }\n\n HAL_RCC_OscConfig(oscInit);\n HAL_RCC_ClockConfig(clkConfig, flashLatency);\n}\n#endif\n\n// Disable seeding random from accelerometer. We now store random\n// seed in internal flash, so it's different on every reset, and\n// accelerometer sometimes have bugs, so better not enable them unless\n// requested.\nstatic void initRandomSeed() {\n#if 0\n if (getConfig(CFG_ACCELEROMETER_TYPE, -1) != -1) {\n initAccelRandom();\n }\n#endif\n}\n\nstatic void set_if_present(int cfg, int val) {\n auto snd = pxt::lookupPinCfg(cfg);\n if (snd)\n snd->setDigitalValue(val);\n}\n\n//%\nvoid deepSleep() {\n // this in particular puts accelerometer to sleep, which the bootloader\n // doesn't do\n CodalComponent::setAllSleep(true);\n\n#ifdef STM32F4\n // ask bootloader to do the deep sleeping\n QUICK_BOOT(1);\n RTC->BKP1R = 0x10b37889;\n NVIC_SystemReset();\n#endif\n}\n\nvoid platformSendSerial(const char *data, int len) {\n /*\n if (!serial) {\n serial = new codal::_mbed::Serial(USBTX, NC);\n serial->baud(9600);\n }\n serial->send((uint8_t*)data, len);\n */\n}\n\nvoid platform_init() {\n initRandomSeed();\n setSendToUART(platformSendSerial);\n light::clear();\n\n // make sure sound doesn't draw power before enabled\n set_if_present(CFG_PIN_JACK_SND, 0);\n set_if_present(CFG_PIN_JACK_HPEN, 0);\n set_if_present(CFG_PIN_JACK_BZEN, 1);\n\n /*\n if (*HF2_DBG_MAGIC_PTR == HF2_DBG_MAGIC_START) {\n *HF2_DBG_MAGIC_PTR = 0;\n // this will cause alignment fault at the first breakpoint\n globals[0] = (TValue)1;\n }\n */\n}\n\nint *getBootloaderConfigData() {\n#ifdef STM32F4\n auto config_data = (uint32_t)(UF2_BINFO->configValues);\n if (config_data && (config_data & 3) == 0) {\n auto p = (uint32_t *)config_data - 4;\n if (p[0] == CFG_MAGIC0 && p[1] == CFG_MAGIC1)\n return (int *)p + 4;\n }\n#endif\n\n return NULL;\n}\n\n#define STM32_UUID ((uint32_t *)0x1FFF7A10)\n\nstatic void writeHex(char *buf, uint32_t n) {\n int i = 0;\n int sh = 28;\n while (sh >= 0) {\n int d = (n >> sh) & 0xf;\n buf[i++] = d > 9 ? 'A' + d - 10 : '0' + d;\n sh -= 4;\n }\n buf[i] = 0;\n}\n\nvoid platform_usb_init() {\n#if CONFIG_ENABLED(DEVICE_USB)\n static char serial_number[25];\n\n writeHex(serial_number, STM32_UUID[0]);\n writeHex(serial_number + 8, STM32_UUID[1]);\n writeHex(serial_number + 16, STM32_UUID[2]);\n\n usb.stringDescriptors[2] = serial_number;\n#endif\n}\n\n} // namespace pxt\n\nvoid cpu_clock_init() {}\n",
"platform.h": "#ifndef __PXT_PLATFORM_H\n#define __PXT_PLATFORM_H\n\n#include \"Image.h\"\n#include \"MultiButton.h\"\n#include \"ZPin.h\"\n#include \"Timer.h\"\n#include \"ZSPI.h\"\n#include \"ZI2C.h\"\n#include \"ZSingleWireSerial.h\"\n\n#include \"pinmap.h\"\n\n#define BOOTLOADER_START 0x08000000\n#define BOOTLOADER_END 0x08008000\n\n#ifdef STM32F4\n#define SETTINGS_MAGIC_0 0x10476643\n#define SETTINGS_MAGIC_1 0x2e9a5026\n\nstruct F4_Settings {\n uint32_t magic0;\n uint32_t magic1;\n int *configValues;\n uint32_t hseValue;\n const char *info_uf2;\n const char *manufacturer;\n const char *device;\n uint32_t reserved[16 - 7];\n};\n\n#define UF2_BINFO ((F4_Settings *)(BOOTLOADER_END - sizeof(F4_Settings)))\n#define UF2_INFO_TXT UF2_BINFO->info_uf2\n#define USB_HANDOVER 0\n\n#define BOOT_RTC_SIGNATURE 0x71a21877\n#define APP_RTC_SIGNATURE 0x24a22d12\n#define HF2_RTC_SIGNATURE 0x39a63a78\n#define QUICK_BOOT(v) \\\n do { \\\n RTC->BKP0R = v ? APP_RTC_SIGNATURE : HF2_RTC_SIGNATURE; \\\n } while (0)\n#else\n#define QUICK_BOOT(v) ((void)0)\n#endif\n\n#define PAGE_SIZE 1024 // not really\n\n#define DEV_NUM_PINS 64\n\n#ifdef STM32F1\n#define DEV_PWM_PINS 0b111100000011101100001110111000111111001110LL\n#else\n#define DEV_PWM_PINS 0b111100000011100111111110111000111111101111LL\n#endif\n\n// CCCCCCCCCCCCCCCCBBBBBBBBBBBBBBBBAAAAAAAAAAAAAAAA\n// fedcba9876543210fedcba9876543210fedcba9876543210\n#define DEV_AIN_PINS 0b000011111100000000000000110000000011111111LL\n\n// Codal doesn't yet distinguish between PWM and AIN\n#define DEV_ANALOG_PINS (DEV_PWM_PINS | DEV_AIN_PINS)\n\n#define CODAL_PIN ZPin\n#define CODAL_TIMER Timer\n#define CODAL_SPI ZSPI\n#define CODAL_I2C ZI2C\n#define CODAL_JACDAC_WIRE_SERIAL codal::ZSingleWireSerial\n\n#define PERF_NOW() (TIM5->CNT)\n\n#define IMAGE_BITS 4\n\n\n// The parameters below needs tuning!\n\n#ifdef JUST_FOR_DAL_D_TS_CPP_WILL_IGNORE\n#define PA_0 0x00\n#define PA_1 0x01\n#define PA_2 0x02\n#define PA_3 0x03\n#define PA_4 0x04\n#define PA_5 0x05\n#define PA_6 0x06\n#define PA_7 0x07\n#define PA_8 0x08\n#define PA_9 0x09\n#define PA_10 0x0A\n#define PA_11 0x0B\n#define PA_12 0x0C\n#define PA_13 0x0D\n#define PA_14 0x0E\n#define PA_15 0x0F\n\n#define PB_0 0x10\n#define PB_1 0x11\n#define PB_2 0x12\n#define PB_3 0x13\n#define PB_4 0x14\n#define PB_5 0x15\n#define PB_6 0x16\n#define PB_7 0x17\n#define PB_8 0x18\n#define PB_9 0x19\n#define PB_10 0x1A\n#define PB_11 0x1B\n#define PB_12 0x1C\n#define PB_13 0x1D\n#define PB_14 0x1E\n#define PB_15 0x1F\n\n#define PC_0 0x20\n#define PC_1 0x21\n#define PC_2 0x22\n#define PC_3 0x23\n#define PC_4 0x24\n#define PC_5 0x25\n#define PC_6 0x26\n#define PC_7 0x27\n#define PC_8 0x28\n#define PC_9 0x29\n#define PC_10 0x2A\n#define PC_11 0x2B\n#define PC_12 0x2C\n#define PC_13 0x2D\n#define PC_14 0x2E\n#define PC_15 0x2F\n\n#define PD_0 0x30\n#define PD_1 0x31\n#define PD_2 0x32\n#define PD_3 0x33\n#define PD_4 0x34\n#define PD_5 0x35\n#define PD_6 0x36\n#define PD_7 0x37\n#define PD_8 0x38\n#define PD_9 0x39\n#define PD_10 0x3A\n#define PD_11 0x3B\n#define PD_12 0x3C\n#define PD_13 0x3D\n#define PD_14 0x3E\n#define PD_15 0x3F\n#endif\n\n#endif",
"pxt.h": "#ifndef __PXT_H\n#define __PXT_H\n\n#include \"pxtbase.h\"\n\n#include \"CodalConfig.h\"\n#include \"CodalHeapAllocator.h\"\n#include \"CodalDevice.h\"\n#include \"CodalDmesg.h\"\n#include \"ErrorNo.h\"\n#include \"Timer.h\"\n#include \"Matrix4.h\"\n#include \"CodalCompat.h\"\n#include \"CodalComponent.h\"\n#include \"ManagedType.h\"\n#include \"Event.h\"\n#include \"NotifyEvents.h\"\n#include \"Button.h\"\n#include \"CodalFiber.h\"\n#include \"MessageBus.h\"\n#include \"MultiButton.h\"\n\nusing namespace codal;\n\n// codal::ManagedString compat\n#define MSTR(s) codal::ManagedString((s)->data, (s)->length)\n#define PSTR(s) mkString((s).toCharArray(), (s).length())\n\n#include \"pins.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"hf2.h\"\n#include \"hf2dbg.h\"\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n#include \"HIDMouse.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n#include \"HIDKeyboard.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n#include \"HIDJoystick.h\"\n#endif\n#endif\n\n#define PXT_COMM_BASE 0x20002000 // 8k in\n\nnamespace pxt {\n\n#if CONFIG_ENABLED(DEVICE_USB)\nextern CodalUSB usb;\nextern HF2 hf2;\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nextern USBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nextern USBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nextern USBHIDJoystick joystick;\n#endif\n#endif\n\n// Utility functions\nextern Event lastEvent;\nextern CODAL_TIMER devTimer;\nextern MessageBus devMessageBus;\nextern codal::CodalDevice device;\n\nvoid set_usb_strings(const char *uf2_info);\nextern void (*logJDFrame)(const uint8_t *data);\nextern void (*sendJDFrame)(const uint8_t *data);\n\nstatic inline void raiseEvent(int src, int val) {\n Event(src, val);\n}\n\n} // namespace pxt\n\nnamespace pins {\nclass CodalSPIProxy;\nclass CodalI2CProxy;\n} // namespace pins\n\ntypedef pins::CodalI2CProxy* I2C_;\ntypedef pins::CodalSPIProxy* SPI_;\n\nnamespace pxt {\ncodal::LowLevelTimer *allocateTimer();\n\n#ifdef CODAL_I2C\nCODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl);\n#endif\nCODAL_SPI* getSPI(DigitalInOutPin mosi, DigitalInOutPin miso, DigitalInOutPin sck);\n#ifdef CODAL_JACDAC_WIRE_SERIAL\nLowLevelTimer* getJACDACTimer();\n#endif\nclass PressureButton;\nuint32_t readButtonMultiplexer(int bits);\nvoid disableButtonMultiplexer();\n}\n\nnamespace serial {\nclass CodalSerialDeviceProxy;\n}\n\ntypedef serial::CodalSerialDeviceProxy* SerialDevice;\n\nnamespace jacdac {\nclass JDProxyDriver;\n} // namespace network\n\ntypedef jacdac::JDProxyDriver* JacDacDriverStatus;\n\n#define DEVICE_ID_BUTTON_SLIDE 3000\n#define DEVICE_ID_MICROPHONE 3001\n#define DEVICE_ID_FIRST_BUTTON 4000\n#define DEVICE_ID_FIRST_TOUCHBUTTON 4100\n\n#define PXT_INTERNAL_KEY_UP 2050\n#define PXT_INTERNAL_KEY_DOWN 2051\n\n#endif\n",
"pxt.json": "{\n \"name\": \"core---stm32\",\n \"description\": \"The core library for Codal-based targets\",\n \"dependencies\": {\n \"base\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"dal.d.ts\",\n \"codal.cpp\",\n \"usb.cpp\",\n \"pxt.h\",\n \"platform.h\",\n \"platform.cpp\",\n \"pxtcore.h\",\n \"pins.h\",\n \"pins.cpp\",\n \"pinsAnalog.cpp\",\n \"pinsDigital.cpp\",\n \"pinsPWM.cpp\",\n \"pins.ts\",\n \"pinscompat.ts\",\n \"control.cpp\",\n \"i2c.cpp\",\n \"i2c.ts\",\n \"spi.cpp\",\n \"spi.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"hf2.cpp\",\n \"hf2.h\",\n \"hf2dbg.h\",\n \"uf2format.h\",\n \"uf2hid.h\",\n \"ns.ts\",\n \"dmac.cpp\",\n \"dmac.h\",\n \"timer.ts\",\n \"light.cpp\",\n \"light.h\",\n \"keyvaluestorage.cpp\",\n \"keyvaluestorage.ts\",\n \"leveldetector.ts\",\n \"pxtparts.json\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"yotta\": {\n \"config\": {\n \"codal\": {\n \"component_count\": 64,\n \"dmesg_buffer_size\": 1024\n }\n }\n },\n \"dalDTS\": {\n \"includeDirs\": [\n \"libraries/codal-core/inc\",\n \"pxtapp\"\n ],\n \"excludePrefix\": [\n \"JD_\",\n \"USB_\",\n \"REQUEST_\",\n \"LIS3DH_\",\n \"FXOS8700_\",\n \"HF2_\",\n \"PXT_REF_TAG_\",\n \"MS_\",\n \"SCSI_\",\n \"MAG_\",\n \"MAG3\",\n \"MPU6\",\n \"MADCTL\",\n \"MMA8\"\n ]\n }\n}\n",
"pxtcore.h": "#ifndef __PXTCORE_H\n#define __PXTCORE_H\n\n#include \"CodalDmesg.h\"\n#include \"CodalHeapAllocator.h\"\n\n#define PXT_CODAL 1\n\n#define itoa(a, b) codal::itoa(a, b)\n\n#define GC_GET_HEAP_SIZE() device_heap_size(0)\n#define GC_STACK_BASE DEVICE_STACK_BASE\n#define xmalloc device_malloc\n#define xfree device_free\n\n// on most devices we allocate the entire heap at once, so large allocs should work\n// if they don't you just get the regular out of memory instead of alloc too large\n#define GC_MAX_ALLOC_SIZE (128 * 1024)\n\n#endif\n",
"pxtparts.json": "{\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\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createStrip,light.createNeoPixelStrip\",\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 \"dotstar\": {\n \"simulationBehavior\": \"dotstar\",\n \"visual\": {\n \"builtIn\": \"dotstar\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 1\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createAPA102Strip\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"dataPin\"\n },\n {\n \"pinInstantiationIdx\": 1,\n \"partParameter\": \"clkPin\"\n },\n {\n \"partParameter\": \"mode\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n },\n \"pixels\": {\n \"simulationBehavior\": \"pixels\",\n \"visual\": { \n \"builtIn\": \"pixels\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"MOSI\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"SCK\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\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, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n }, \n \"buttons\": {\n \"simulationBehavior\": \"buttons\",\n \"visual\": {\n \"builtIn\": \"buttons\",\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 },\n \"numberOfPins\": 2,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"Button.onEvent,Button.isPressed,Button.wasPressed\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"button\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n }\n ]\n },\n \"slideswitch\": {\n \"numberOfPins\": 3,\n \"simulationBehavior\": \"slideswitch\",\n \"visual\": {\n \"builtIn\": \"slideswitch\",\n \"width\": 100,\n \"height\": 100,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 30,\n \"y\": 0\n },\n {\n \"x\": 45,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalRead,DigitalInOutPin.onPulsed,DigitalInOutPin.onEvent\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"pin\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\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 \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"PwmOnlyPin.servoWrite,servos.Servo.setAngle,servos.Servo.run,servos.Servo.setPulse\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\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 \"led\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"analogled\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogOutPin.analogWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"photocell\": {\n \"numberOfPins\": 3,\n \"visual\": {\n \"builtIn\": \"photocell\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 15,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"photocell\",\n \"pinDefinitions\": [\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogInPin.analogRead\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n }\n}",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace light {\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //% shim=light::sendBuffer\n function sendBuffer(data: DigitalInOutPin, clk: DigitalInOutPin, mode: int32, buf: Buffer): void;\n}\ndeclare namespace control {\n\n /**\n * Determines if the USB has been enumerated.\n */\n //% shim=control::isUSBInitialized\n function isUSBInitialized(): boolean;\n}\ndeclare namespace pins {\n\n /**\n * Get a pin by configuration id (DAL.CFG_PIN...)\n */\n //% shim=pins::pinByCfg\n function pinByCfg(key: int32): DigitalInOutPin;\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 * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n //% help=pins/pulse-duration blockGap=8\n //% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n //% weight=19 shim=pins::pulseDuration\n function pulseDuration(): int32;\n}\n\n\ndeclare interface AnalogInPin {\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\n */\n //% help=pins/analog-read weight=53\n //% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=AnalogInPinMethods::analogRead\n analogRead(): int32;\n}\n\n\ndeclare interface AnalogOutPin {\n /**\n * Set the connector value as analog. Value must be comprised between 0 and 1023.\n * @param name pin name to write to\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n //% help=pins/analog-write weight=52\n //% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.min=0 value.max=1023 shim=AnalogOutPinMethods::analogWrite\n analogWrite(value: int32): void;\n}\n\n\ndeclare interface DigitalInOutPin {\n /**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n //% help=pins/digital-read weight=61\n //% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalRead\n digitalRead(): boolean;\n\n /**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n //% help=pins/digital-write weight=60\n //% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalWrite\n digitalWrite(value: boolean): void;\n\n /**\n * Make this pin a digital input, and create events where the timestamp is the duration\n * that this pin was either ``high`` or ``low``.\n */\n //% help=pins/on-pulsed weight=16 blockGap=8\n //% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4\n //% deprecated=1 hidden=1 shim=DigitalInOutPinMethods::onPulsed\n onPulsed(pulse: PulseValue, body: () => void): void;\n\n /**\n * Register code to run when a pin event occurs. \n */\n //% help=pins/on-event weight=20 blockGap=8\n //% blockId=pinsonevent block=\"on|pin %pin|%event\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 shim=DigitalInOutPinMethods::onEvent\n onEvent(event: PinEvent, body: () => void): void;\n\n /**\n * Return the duration of a pulse in microseconds\n * @param name the pin which measures the pulse\n * @param value the value of the pulse (default high)\n * @param maximum duration in micro-seconds\n */\n //% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n //% weight=18 blockGap=8\n //% help=\"pins/pulse-in\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 maxDuration.defl=2000000 shim=DigitalInOutPinMethods::pulseIn\n pulseIn(value: PulseValue, maxDuration?: int32): int32;\n\n /**\n * Set the pull direction of this pin.\n * @param name pin to set the pull mode on\n * @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n */\n //% help=pins/set-pull weight=17 blockGap=8\n //% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::setPull\n setPull(pull: PinPullMode): void;\n}\n\n\ndeclare interface PwmPin {}\n\n\ndeclare interface PwmOnlyPin {\n /**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n //% help=pins/analog-set-period weight=51\n //% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::analogSetPeriod\n analogSetPeriod(period: int32): void;\n\n /**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n //% help=pins/servo-write weight=41 group=\"Servo\"\n //% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n //% parts=microservo trackArgs=0\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.defl=90 shim=PwmOnlyPinMethods::servoWrite\n servoWrite(value?: int32): void;\n\n /**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n //% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n //% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n //% parts=microservo blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::servoSetPulse\n servoSetPulse(duration: int32): void;\n\n /**\n * Indicates if the servo is running continuously\n */\n //% blockHidden=1 shim=PwmOnlyPinMethods::servoSetContinuous\n servoSetContinuous(continuous: boolean): void;\n}\ndeclare namespace control {\n\n /**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\"\n //% help=control/raise-event\n //% block=\"raise event|from %src|with value %value\" blockExternalInputs=1 shim=control::raiseEvent\n function raiseEvent(src: int32, value: int32): void;\n\n /**\n * Determine the version of system software currently running.\n */\n //% blockId=\"control_device_dal_version\" block=\"device dal version\"\n //% help=control/device-dal-version shim=control::deviceDalVersion\n function deviceDalVersion(): string;\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}\n\n\ndeclare interface I2C {\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::readBuffer\n readBuffer(address: int32, size: int32, repeat?: boolean): Buffer;\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::writeBuffer\n writeBuffer(address: int32, buf: Buffer, repeat?: boolean): int32;\n}\ndeclare namespace pins {\n\n /**\n * Opens a Serial communication driver\n */\n //% help=pins/create-i2c\n //% parts=i2c shim=pins::createI2C\n function createI2C(sda: DigitalInOutPin, scl: DigitalInOutPin): I2C;\n}\ndeclare namespace pins {\n\n /**\n * Opens a SPI driver\n */\n //% help=pins/create-spi\n //% parts=spi shim=pins::createSPI\n function createSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin): SPI;\n\n /**\n * Opens a slave SPI driver\n */\n //% parts=spi shim=pins::createSlaveSPI\n function createSlaveSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin, csPin: DigitalInOutPin): SPI;\n}\n\n\ndeclare interface SPI {\n /**\n * Write to the SPI bus\n */\n //% shim=SPIMethods::write\n write(value: int32): int32;\n\n /**\n * Transfer buffers over the SPI bus\n */\n //% argsNullable shim=SPIMethods::transfer\n transfer(command: Buffer, response: Buffer): void;\n\n /**\n * Sets the SPI clock frequency\n */\n //% shim=SPIMethods::setFrequency\n setFrequency(frequency: int32): void;\n\n /**\n * Sets the SPI bus mode\n */\n //% shim=SPIMethods::setMode\n setMode(mode: int32): void;\n}\ndeclare namespace configStorage {\n\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //% shim=configStorage::setBuffer\n function setBuffer(key: string, value: Buffer): void;\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::getBuffer\n function getBuffer(key: string): Buffer;\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::removeItem\n function removeItem(key: string): void;\n\n /**\n * Clears the local storage\n */\n //% shim=configStorage::clear\n function clear(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"spi.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n\nnamespace pins {\n\nclass CodalSPIProxy {\nprivate:\n DevicePin* mosi; \n DevicePin* miso; \n DevicePin* sck;\n CODAL_SPI spi;\npublic:\n CodalSPIProxy* next;\n\npublic:\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck) \n , next(NULL)\n {\n }\n\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck, DevicePin* _cs)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck, _cs) \n , next(NULL)\n {\n }\n#endif\n\n CODAL_SPI* getSPI() {\n return &spi;\n }\n\n bool matchPins(DevicePin* mosi, DevicePin* miso, DevicePin* sck) {\n return this->mosi == mosi && this->miso == miso && this->sck == sck;\n }\n\n int write(int value) {\n return spi.write(value);\n }\n\n void transfer(Buffer command, Buffer response) {\n auto cdata = NULL == command ? NULL : command->data;\n auto clength = NULL == command ? 0 : command->length;\n auto rdata = NULL == response ? NULL : response->data;\n auto rlength = NULL == response ? 0 : response->length;\n spi.transfer(cdata, clength, rdata, rlength);\n }\n\n void setFrequency(int frequency) {\n spi.setFrequency(frequency);\n }\n\n void setMode(int mode) {\n spi.setMode(mode);\n }\n};\n\nSPI_ spis(NULL);\n\n/**\n* Opens a SPI driver\n*/\n//% help=pins/create-spi\n//% parts=spi\nSPI_ createSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto dev = spis;\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin);\n ser->next = spis;\n spis = ser;\n return ser;\n}\n\n/**\n* Opens a slave SPI driver\n*/\n//% parts=spi\nSPI_ createSlaveSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin, DigitalInOutPin csPin) {\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n auto dev = spis;\n if (!csPin)\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin, csPin);\n ser->next = spis;\n spis = ser;\n return ser;\n#else\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n return NULL;\n#endif\n}\n\n}\n\nnamespace pxt {\n\nCODAL_SPI* getSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto spi = pins::createSPI(mosiPin, misoPin, sckPin);\n return spi->getSPI();\n}\n\n}\n\nnamespace SPIMethods {\n\n/**\n* Write to the SPI bus\n*/\n//%\nint write(SPI_ device, int value) {\n return device->write(value);\n}\n\n/**\n* Transfer buffers over the SPI bus\n*/\n//% argsNullable\nvoid transfer(SPI_ device, Buffer command, Buffer response) {\n if (!device)\n soft_panic(PANIC_CAST_FROM_NULL);\n if (!command && !response)\n return;\n device->transfer(command, response);\n}\n\n/**\n* Sets the SPI clock frequency\n*/\n//%\nvoid setFrequency(SPI_ device, int frequency) {\n device->setFrequency(frequency);\n}\n\n/**\n* Sets the SPI bus mode\n*/\n//%\nvoid setMode(SPI_ device, int mode) {\n device->setMode(mode);\n}\n\n}\n",
"spi.ts": "namespace pins {\n\n let _spi: SPI;\n /**\n * Gets the default SPI driver\n */\n //%\n export function spi() {\n if (!_spi) {\n const mosi = pins.pinByCfg(DAL.CFG_PIN_MOSI);\n const miso = pins.pinByCfg(DAL.CFG_PIN_MISO);\n const sck = pins.pinByCfg(DAL.CFG_PIN_SCK);\n _spi = pins.createSPI(mosi, miso, sck);\n }\n return _spi;\n }\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 weight=5 advanced=true\n //% blockId=spi_write block=\"spi write %value\"\n export function spiWrite(value: number) {\n return spi().write(value);\n }\n\n /**\n * Write a given command to SPI bus, and at the same time read the response.\n */\n //% help=pins/spi-transfer weight=4 advanced=true\n //% blockId=spi_transfer block=\"spi transfer %command into %response\"\n export function spiTransfer(command: Buffer, response: Buffer) {\n spi().transfer(command, response);\n }\n\n /**\n * Set the SPI frequency\n * @param frequency the clock frequency, eg: 1000000\n */\n //% help=pins/spi-frequency weight=4 advanced=true\n //% blockId=spi_frequency block=\"spi frequency %frequency\"\n export function spiFrequency(frequency: number) {\n spi().setFrequency(frequency);\n }\n\n /**\n * Set the SPI signal mode\n * @param mode the mode, eg: 3\n */\n //% help=pins/spi-mode weight=3 advanced=true\n //% blockId=spi_mode block=\"spi mode %mode\"\n export function spiMode(mode: number) {\n spi().setMode(mode);\n }\n}",
"test.ts": "let i = 1\nlet f = 0.5\nlet plus = i + f\nlet minus = i - f\n\nlet r = Math.random()\nlet ri = Math.randomRange(5, 10)\n\n",
"timer.ts": "namespace control {\n /**\n * A timer\n */\n //% fixedInstances\n export class Timer {\n start: number;\n\n constructor() {\n this.start = control.millis();\n }\n\n /**\n * Gets the elapsed time in millis since the last reset\n */\n //% blockId=timerMillis block=\"%timer|millis\"\n millis(): number {\n return control.millis() - this.start;\n }\n\n /**\n * Gets the elapsed time in seconds since the last reset\n */\n //% blockId=timerSeconds block=\"%timer|seconds\"\n seconds(): number {\n return this.millis() / 1000;\n }\n\n /**\n * Resets the timer\n */\n //% blockId=timerRest block=\"%timer|reset\"\n reset() {\n this.start = control.millis();\n }\n\n /**\n * Pauses until the timer reaches the given amount of milliseconds\n * @param ms how long to pause for, eg: 5, 100, 200, 500, 1000, 2000\n */\n //% blockId=timerPauseUntil block=\"%timer|pause until (ms) %ms\"\n pauseUntil(ms: number) {\n const remaining = this.millis() - ms;\n pause(Math.max(0, remaining));\n }\n }\n\n //% whenUsed fixedInstance block=\"timer 1\"\n export const timer1 = new Timer();\n //% whenUsed fixedInstance block=\"timer 2\"\n export const timer2 = new Timer();\n //% whenUsed fixedInstance block=\"timer 3\"\n export const timer3 = new Timer();\n //% whenUsed fixedInstance block=\"timer 4\"\n export const timer4 = new Timer();\n //% whenUsed fixedInstance block=\"timer 5\"\n export const timer5 = new Timer();\n //% whenUsed fixedInstance block=\"timer 6\"\n export const timer6 = new Timer();\n //% whenUsed fixedInstance block=\"timer 7\"\n export const timer7 = new Timer();\n //% whenUsed fixedInstance block=\"timer 8\"\n export const timer8 = new Timer();\n}",
"uf2format.h": "#ifndef UF2FORMAT_H\n#define UF2FORMAT_H 1\n\n#include \n#include \n\n// All entries are little endian.\n\n#ifndef BOOTLOADER_START\n#define BOOTLOADER_START 0x0\n#endif\n\n#ifndef BOOTLOADER_END\n#define BOOTLOADER_END 0x2000\n#endif\n\n#ifndef UF2_BINFO\n#define UF2_BINFO ((UF2_BInfo *)(BOOTLOADER_END - sizeof(UF2_BInfo)))\n#endif\n\n#ifndef UF2_INFO_TXT\n#define UF2_INFO_TXT UF2_BINFO->info_uf2\n#endif\n\n\n#define UF2_MAGIC_START0 0x0A324655UL // \"UF2\\n\"\n#define UF2_MAGIC_START1 0x9E5D5157UL // Randomly selected\n#define UF2_MAGIC_END 0x0AB16F30UL // Ditto\n\n// If set, the block is \"comment\" and should not be flashed to the device\n#define UF2_FLAG_NOFLASH 0x00000001\n\ntypedef struct {\n // 32 byte header\n uint32_t magicStart0;\n uint32_t magicStart1;\n uint32_t flags;\n uint32_t targetAddr;\n uint32_t payloadSize;\n uint32_t blockNo;\n uint32_t numBlocks;\n uint32_t reserved;\n\n // raw data;\n uint8_t data[476];\n\n // store magic also at the end to limit damage from partial block reads\n uint32_t magicEnd;\n} UF2_Block;\n\ntypedef struct {\n uint8_t version;\n uint8_t ep_in;\n uint8_t ep_out;\n uint8_t reserved0;\n uint32_t cbw_tag;\n uint32_t blocks_remaining;\n uint8_t *buffer;\n} UF2_HandoverArgs;\n\ntypedef void (*UF2_MSC_Handover_Handler)(UF2_HandoverArgs *handover);\ntypedef void (*UF2_HID_Handover_Handler)(int ep);\n\n// this is required to be exactly 16 bytes long by the linker script\ntypedef struct {\n void *reserved0;\n UF2_HID_Handover_Handler handoverHID;\n UF2_MSC_Handover_Handler handoverMSC;\n const char *info_uf2;\n} UF2_BInfo;\n\nstatic inline bool is_uf2_block(void *data) {\n UF2_Block *bl = (UF2_Block *)data;\n return bl->magicStart0 == UF2_MAGIC_START0 && bl->magicStart1 == UF2_MAGIC_START1 &&\n bl->magicEnd == UF2_MAGIC_END;\n}\n\nstatic inline bool in_uf2_bootloader_space(const void *addr) {\n return (BOOTLOADER_START + 0x100) <= (uint32_t)addr && (uint32_t)addr < (BOOTLOADER_END);\n}\n\nstatic inline const char *uf2_info(void) {\n if (in_uf2_bootloader_space(UF2_INFO_TXT))\n return UF2_INFO_TXT;\n return \"N/A\";\n}\n\n#ifdef UF2_DEFINE_HANDOVER\nstatic inline void hf2_handover(uint8_t ep) {\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_HID_Handover_Handler fn = UF2_BINFO->handoverHID;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n // Pass control to bootloader; never returns\n fn(ep & 0xf);\n }\n}\n\nstatic inline void check_uf2_handover(uint8_t *buffer, uint32_t blocks_remaining, uint8_t ep_in,\n uint8_t ep_out, uint32_t cbw_tag) {\n if (!is_uf2_block(buffer))\n return;\n\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_MSC_Handover_Handler fn = UF2_BINFO->handoverMSC;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n UF2_HandoverArgs hand = {\n 1, ep_in, ep_out, 0, cbw_tag, blocks_remaining, buffer,\n };\n // Pass control to bootloader; never returns\n fn(&hand);\n }\n}\n#endif\n\n#endif\n",
"uf2hid.h": "#ifndef UF2_HID_H\n#define UF2_HID_H 1\n\n#define HF2_CMD_BININFO 0x0001\n// no arguments\n#define HF2_MODE_BOOTLOADER 0x01\n#define HF2_MODE_USERSPACE 0x02\nstruct HF2_BININFO_Result {\n uint32_t mode;\n uint32_t flash_page_size;\n uint32_t flash_num_pages;\n uint32_t max_message_size;\n uint32_t uf2_family;\n};\n\n#define HF2_CMD_INFO 0x0002\n// no arguments\n// results is utf8 character array\n\n#define HF2_CMD_RESET_INTO_APP 0x0003\n// no arguments, no result\n\n#define HF2_CMD_RESET_INTO_BOOTLOADER 0x0004\n// no arguments, no result\n\n#define HF2_CMD_START_FLASH 0x0005\n// no arguments, no result\n\n#define HF2_CMD_WRITE_FLASH_PAGE 0x0006\nstruct HF2_WRITE_FLASH_PAGE_Command {\n uint32_t target_addr;\n uint32_t data[0];\n};\n// no result\n\n#define HF2_CMD_CHKSUM_PAGES 0x0007\nstruct HF2_CHKSUM_PAGES_Command {\n uint32_t target_addr;\n uint32_t num_pages;\n};\nstruct HF2_CHKSUM_PAGES_Result {\n uint16_t chksums[0 /* num_pages */];\n};\n\n#define HF2_CMD_READ_WORDS 0x0008\nstruct HF2_READ_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n};\nstruct HF2_READ_WORDS_Result {\n uint32_t words[0 /* num_words */];\n};\n\n#define HF2_CMD_WRITE_WORDS 0x0009\nstruct HF2_WRITE_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n uint32_t words[0 /* num_words */];\n};\n// no result\n\n#define HF2_CMD_DMESG 0x0010\n// no arguments\n// results is utf8 character array\n\n#define HF2_EV_MASK 0x800000\n\n#define HF2_CMD_JDS_CONFIG 0x0020\n#define HF2_CMD_JDS_SEND 0x0021\n#define HF2_EV_JDS_PACKET 0x800020\n\ntypedef struct {\n uint32_t command_id;\n uint16_t tag;\n uint8_t reserved0;\n uint8_t reserved1;\n\n union {\n struct HF2_WRITE_FLASH_PAGE_Command write_flash_page;\n struct HF2_WRITE_WORDS_Command write_words;\n struct HF2_READ_WORDS_Command read_words;\n struct HF2_CHKSUM_PAGES_Command chksum_pages;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Command;\n\ntypedef struct {\n union {\n uint32_t eventId;\n struct {\n uint16_t tag;\n union {\n struct {\n uint8_t status;\n uint8_t status_info;\n };\n uint16_t status16;\n };\n };\n };\n union {\n struct HF2_BININFO_Result bininfo;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Response;\n\n#define HF2_FLAG_SERIAL_OUT 0x80\n#define HF2_FLAG_SERIAL_ERR 0xC0\n#define HF2_FLAG_CMDPKT_LAST 0x40\n#define HF2_FLAG_CMDPKT_BODY 0x00\n#define HF2_FLAG_MASK 0xC0\n#define HF2_SIZE_MASK 63\n\n#define HF2_STATUS_OK 0x00\n#define HF2_STATUS_INVALID_CMD 0x01\n#define HF2_STATUS_INVALID_STATE 0x02\n\n#endif\n",
"usb.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"uf2format.h\"\n\nnamespace pxt {\nCodalUSB usb;\n\n// share the buffer; we will crash anyway if someone talks to us over both at the same time\nHF2_Buffer hf2buf;\nHF2 hf2(hf2buf);\n#ifdef HF2_HID\nHF2 hf2hid(hf2buf);\n#endif\nDummyIface dummyIface;\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nUSBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nUSBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nUSBHIDJoystick joystick;\n#endif\n\nstatic const DeviceDescriptor device_desc = {\n 0x12, // bLength\n 0x01, // bDescriptorType\n 0x0210, // bcdUSBL\n\n // Class etc specified per-interface\n 0x00, 0x00, 0x00,\n\n 0x40, // bMaxPacketSize0\n USB_DEFAULT_VID, USB_DEFAULT_PID,\n 0x4202, // bcdDevice - leave unchanged for the HF2 to work\n 0x01, // iManufacturer\n 0x02, // iProduct\n 0x03, // SerialNumber\n 0x01 // bNumConfigs\n};\n\nstatic void start_usb() {\n // start USB with a delay, so that user code can add new interfaces if needed\n // (eg USB HID keyboard, or MSC)\n fiber_sleep(500);\n usb.start();\n}\n\nvoid platform_usb_init() __attribute__((weak));\nvoid platform_usb_init() {}\n\nvoid set_usb_strings(const char *uf2_info) {\n static const char *string_descriptors[3];\n static char serial[12];\n itoa(target_get_serial() & 0x7fffffff, serial);\n\n auto model = strstr(uf2_info, \"Model: \");\n if (model) {\n model += 7;\n auto end = model;\n while (*end && *end != '\\n' && *end != '\\r')\n end++;\n auto len = end - model;\n auto dev = (char *)app_alloc(len + 10);\n memcpy(dev, model, len);\n strcpy(dev + len, \" (app)\");\n // try to split into manufacturer and\n auto sep = strstr(dev, \" / \");\n if (sep) {\n *sep = '\\0';\n string_descriptors[0] = dev;\n string_descriptors[1] = sep + 3;\n } else {\n string_descriptors[0] = dev;\n string_descriptors[1] = dev;\n }\n } else {\n string_descriptors[0] = \"Unknown Corp.\";\n string_descriptors[1] = \"PXT Device (app)\";\n }\n\n string_descriptors[2] = serial;\n usb.stringDescriptors = string_descriptors;\n}\n\nvoid usb_init() {\n usb.deviceDescriptor = &device_desc;\n set_usb_strings(UF2_INFO_TXT);\n\n platform_usb_init();\n\n usb.add(hf2);\n\n#ifdef HF2_HID\n hf2hid.useHID = true;\n usb.add(hf2hid);\n#else\n // the WINUSB descriptors don't seem to work if there's only one interface\n // so we add a dummy interface\n usb.add(dummyIface);\n#endif\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n usb.add(mouse);\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n usb.add(keyboard);\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n usb.add(joystick);\n#endif\n\n create_fiber(start_usb);\n}\n\n} // namespace pxt\n\n#else\nnamespace pxt {\nvoid usb_init() {}\n} // namespace pxt\n#endif\n\nnamespace control {\n/**\n * Determines if the USB has been enumerated.\n */\n//%\nbool isUSBInitialized() {\n#if CONFIG_ENABLED(DEVICE_USB)\n return pxt::usb.isInitialised();\n#else\n return false;\n#endif\n}\n} // namespace control\n\nnamespace pxt {\nstatic void (*pSendToUART)(const char *data, int len) = NULL;\nvoid setSendToUART(void (*f)(const char *, int)) {\n pSendToUART = f;\n}\n\nvoid sendSerial(const char *data, int len) {\n#if CONFIG_ENABLED(DEVICE_USB)\n hf2.sendSerial(data, len);\n#if HF2_HID\n hf2hid.sendSerial(data, len);\n#endif\n#endif\n if (pSendToUART)\n pSendToUART(data, len);\n}\n\nvoid dumpDmesg() {\n sendSerial(\"\\nDMESG:\\n\", 8);\n sendSerial(codalLogStore.buffer, codalLogStore.ptr);\n sendSerial(\"\\n\\n\", 2);\n}\n\nvoid (*logJDFrame)(const uint8_t *data);\nvoid (*sendJDFrame)(const uint8_t *data);\n\n} // namespace pxt\n"
},
"core---nrf52": {
"README.md": "# core\n\nThe core library for Codal-based targets.\n\n",
"codal.cpp": "#include \"pxt.h\"\n#include \"LowLevelTimer.h\"\nusing namespace codal;\n\nvoid cpu_clock_init(void);\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#ifdef DEVICE_GET_FIBER_LIST_AVAILABLE\n// newer codal-core has get_fiber_list() but not list_fibers()\nnamespace codal {\n/*\n * Return all current fibers.\n *\n * @param dest If non-null, it points to an array of pointers to fibers to store results in.\n *\n * @return the number of fibers (potentially) stored\n */\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\nnamespace pxt {\n\nvoid platform_init();\nvoid usb_init();\n\n// The first two word are used to tell the bootloader that a single reset should start the\n// bootloader and the MSD device, not us.\n// The rest is reserved for partial flashing checksums.\n__attribute__((section(\".binmeta\"))) __attribute__((used)) const uint32_t pxt_binmeta[] = {\n 0x87eeb07c, 0x87eeb07c, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n};\n\nEvent lastEvent;\nMessageBus devMessageBus;\ncodal::CodalDevice device;\n\nstruct FreeList {\n FreeList *next;\n};\n\nstatic void commInit() {\n int commSize = bytecode[20];\n if (!commSize)\n return;\n\n void *r = app_alloc_at((void *)PXT_COMM_BASE, commSize);\n DMESG(\"comm %d -> %p\", commSize, r);\n if (!r)\n target_panic(20);\n}\n\nstatic void initCodal() {\n cpu_clock_init();\n\n commInit();\n\n // Bring up fiber scheduler.\n scheduler_init(devMessageBus);\n\n // We probably don't need that - components are initialized when one obtains\n // the reference to it.\n // devMessageBus.listen(DEVICE_ID_MESSAGE_BUS_LISTENER, DEVICE_EVT_ANY, this,\n // &CircuitPlayground::onListenerRegisteredEvent);\n\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; i++) {\n if (CodalComponent::components[i])\n CodalComponent::components[i]->init();\n }\n\n usb_init();\n\n auto led = LOOKUP_PIN(LED);\n if (led) {\n led->setDigitalValue(0);\n }\n}\n\n// ---------------------------------------------------------------------------\n// An adapter for the API expected by the run-time.\n// ---------------------------------------------------------------------------\n\n// We have the invariant that if [dispatchEvent] is registered against the DAL\n// for a given event, then [handlersMap] contains a valid entry for that\n// event.\nvoid dispatchEvent(Event e) {\n lastEvent = e;\n\n auto curr = findBinding(e.source, e.value);\n auto value = fromInt(e.value);\n while (curr) {\n runAction1(curr->action, value);\n curr = nextBinding(curr->next, e.source, e.value);\n }\n}\n\nvoid registerWithDal(int id, int event, Action a, int flags) {\n // first time?\n if (!findBinding(id, event)) {\n devMessageBus.listen(id, event, dispatchEvent, flags);\n if (event == 0) {\n // we're registering for all events on given ID\n // need to remove old listeners for specific events\n auto curr = findBinding(id, -1);\n while (curr) {\n devMessageBus.ignore(id, curr->value, dispatchEvent);\n curr = nextBinding(curr->next, id, -1);\n }\n }\n }\n setBinding(id, event, a);\n}\n\nvoid fiberDone(void *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 target_wait_us(us);\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 registerGCPtr(a);\n create_fiber(forever_stub, (void *)a);\n }\n}\n\nvoid runInParallel(Action a) {\n if (a != 0) {\n registerGCPtr(a);\n create_fiber((void (*)(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 initSystemTimer();\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\nuint64_t getLongSerialNumber() {\n return device.getSerialNumber();\n}\n\nint current_time_ms() {\n return system_timer_current_time();\n}\n\nuint64_t current_time_us() {\n return system_timer_current_time_us();\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\nstatic void *threadAddressFor(codal::Fiber *fib, void *sp) {\n if (fib == currentFiber)\n return sp;\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 int numFibers = codal::list_fibers(NULL);\n codal::Fiber **fibers = (codal::Fiber **)xmalloc(sizeof(codal::Fiber *) * numFibers);\n int num2 = codal::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 gcProcess(ctx->thrownValue);\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 xfree(fibers);\n}\n\nLowLevelTimer *getJACDACTimer() {\n static LowLevelTimer *jacdacTimer;\n if (!jacdacTimer) {\n jacdacTimer = allocateTimer();\n jacdacTimer->setIRQPriority(1);\n }\n return jacdacTimer;\n}\nvoid initSystemTimer() {\n new CODAL_TIMER(*allocateTimer());\n}\n\n} // namespace pxt\n",
"control.cpp": "#include \"pxt.h\"\n\n#if defined(NRF52_SERIES) || defined(PICO_BOARD)\n#define _estack __StackTop \n#endif\nextern uint32_t _estack;\n\nnamespace control {\n\n/**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n//% weight=21 blockGap=12 blockId=\"control_raise_event\"\n//% help=control/raise-event\n//% block=\"raise event|from %src|with value %value\" blockExternalInputs=1\nvoid raiseEvent(int src, int value) {\n Event evt(src, value);\n}\n\n/**\n* Determine the version of system software currently running.\n*/\n//% blockId=\"control_device_dal_version\" block=\"device dal version\"\n//% help=control/device-dal-version\nString deviceDalVersion() {\n return mkString(device.getVersion());\n}\n\n/**\n* Allocates the next user notification event\n*/\n//% help=control/allocate-notify-event\nint allocateNotifyEvent() {\n return ::allocateNotifyEvent();\n}\n\n/** Write a message to DMESG debugging buffer. */\n//%\nvoid dmesg(String s) {\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 DMESG(\"# %s: %p\", str->getUTF8Data(), ptr);\n}\n\n//%\nuint32_t _ramSize()\n{\n return (uint32_t)&_estack & 0x1fffffff;\n}\n\n}\n",
"dal.d.ts": "// Auto-generated. Do not edit.\ndeclare const enum DAL {\n // /libraries/codal-core/inc/JACDAC/JDPhysicalLayer.h\n Receiving = 0,\n Transmitting = 1,\n Error = 2,\n Unknown = 3,\n ListeningForPulse = 0,\n ErrorRecovery = 1,\n Off = 2,\n Continuation = 0,\n // /libraries/codal-core/inc/JACDAC/JDServiceClasses.h\n STATIC_CLASS_START = 0,\n STATIC_CLASS_END = 16777215,\n DYNAMIC_CLASS_END = 4294967295,\n // /libraries/codal-core/inc/core/CodalComponent.h\n DEVICE_ID_BUTTON_A = 1,\n DEVICE_ID_BUTTON_B = 2,\n DEVICE_ID_BUTTON_AB = 3,\n DEVICE_ID_BUTTON_RESET = 4,\n DEVICE_ID_ACCELEROMETER = 5,\n DEVICE_ID_COMPASS = 6,\n DEVICE_ID_DISPLAY = 7,\n DEVICE_ID_THERMOMETER = 8,\n DEVICE_ID_RADIO = 9,\n DEVICE_ID_RADIO_DATA_READY = 10,\n DEVICE_ID_MULTIBUTTON_ATTACH = 11,\n DEVICE_ID_SERIAL = 12,\n DEVICE_ID_GESTURE = 13,\n DEVICE_ID_SYSTEM_TIMER = 14,\n DEVICE_ID_SCHEDULER = 15,\n DEVICE_ID_COMPONENT = 16,\n DEVICE_ID_LIGHT_SENSOR = 17,\n DEVICE_ID_TOUCH_SENSOR = 18,\n DEVICE_ID_SYSTEM_DAC = 19,\n DEVICE_ID_SYSTEM_MICROPHONE = 20,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR = 21,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR_SPL = 22,\n DEVICE_ID_MSC = 23,\n DEVICE_ID_SPI = 24,\n DEVICE_ID_DISTANCE = 25,\n DEVICE_ID_GYROSCOPE = 26,\n DEVICE_ID_HUMIDITY = 27,\n DEVICE_ID_PRESSURE = 28,\n DEVICE_ID_SINGLE_WIRE_SERIAL = 29,\n DEVICE_ID_JACDAC = 30,\n DEVICE_ID_JACDAC_PHYS = 31,\n DEVICE_ID_JACDAC_CONTROL_SERVICE = 32,\n DEVICE_ID_JACDAC_CONFIGURATION_SERVICE = 33,\n DEVICE_ID_IO_P0 = 100,\n DEVICE_ID_MESSAGE_BUS_LISTENER = 1021,\n DEVICE_ID_NOTIFY_ONE = 1022,\n DEVICE_ID_NOTIFY = 1023,\n DEVICE_ID_BUTTON_UP = 2000,\n DEVICE_ID_BUTTON_DOWN = 2001,\n DEVICE_ID_BUTTON_LEFT = 2002,\n DEVICE_ID_BUTTON_RIGHT = 2003,\n DEVICE_ID_JD_DYNAMIC_ID = 3000,\n DEVICE_COMPONENT_RUNNING = 4096,\n DEVICE_COMPONENT_STATUS_SYSTEM_TICK = 8192,\n DEVICE_COMPONENT_STATUS_IDLE_TICK = 16384,\n DEVICE_COMPONENT_LISTENERS_CONFIGURED = 1,\n DEVICE_COMPONENT_EVT_SYSTEM_TICK = 1,\n // /libraries/codal-core/inc/core/CodalFiber.h\n DEVICE_SCHEDULER_RUNNING = 1,\n DEVICE_SCHEDULER_IDLE = 2,\n DEVICE_FIBER_FLAG_FOB = 1,\n DEVICE_FIBER_FLAG_PARENT = 2,\n DEVICE_FIBER_FLAG_CHILD = 4,\n DEVICE_FIBER_FLAG_DO_NOT_PAGE = 8,\n DEVICE_SCHEDULER_EVT_TICK = 1,\n DEVICE_SCHEDULER_EVT_IDLE = 2,\n // /libraries/codal-core/inc/core/CodalListener.h\n MESSAGE_BUS_LISTENER_PARAMETERISED = 1,\n MESSAGE_BUS_LISTENER_METHOD = 2,\n MESSAGE_BUS_LISTENER_BUSY = 4,\n MESSAGE_BUS_LISTENER_REENTRANT = 8,\n MESSAGE_BUS_LISTENER_QUEUE_IF_BUSY = 16,\n MESSAGE_BUS_LISTENER_DROP_IF_BUSY = 32,\n MESSAGE_BUS_LISTENER_NONBLOCKING = 64,\n MESSAGE_BUS_LISTENER_URGENT = 128,\n MESSAGE_BUS_LISTENER_DELETING = 32768,\n MESSAGE_BUS_LISTENER_IMMEDIATE = 192,\n // /libraries/codal-core/inc/core/ErrorNo.h\n DEVICE_OK = 0,\n DEVICE_INVALID_PARAMETER = -1001,\n DEVICE_NOT_SUPPORTED = -1002,\n DEVICE_CALIBRATION_IN_PROGRESS = -1003,\n DEVICE_CALIBRATION_REQUIRED = -1004,\n DEVICE_NO_RESOURCES = -1005,\n DEVICE_BUSY = -1006,\n DEVICE_CANCELLED = -1007,\n DEVICE_I2C_ERROR = -1010,\n DEVICE_SERIAL_IN_USE = -1011,\n DEVICE_NO_DATA = -1012,\n DEVICE_NOT_IMPLEMENTED = -1013,\n DEVICE_SPI_ERROR = -1014,\n DEVICE_INVALID_STATE = -1015,\n DEVICE_OOM = 20,\n DEVICE_HEAP_ERROR = 30,\n DEVICE_NULL_DEREFERENCE = 40,\n DEVICE_USB_ERROR = 50,\n DEVICE_JACDAC_ERROR = 60,\n DEVICE_HARDWARE_CONFIGURATION_ERROR = 90,\n // /libraries/codal-core/inc/core/NotifyEvents.h\n DISPLAY_EVT_FREE = 1,\n CODAL_SERIAL_EVT_TX_EMPTY = 2,\n BLE_EVT_SERIAL_TX_EMPTY = 3,\n ARCADE_PLAYER_JOIN_RESULT = 4,\n DEVICE_NOTIFY_USER_EVENT_BASE = 1024,\n // /libraries/codal-core/inc/driver-models/AbstractButton.h\n DEVICE_BUTTON_EVT_DOWN = 1,\n DEVICE_BUTTON_EVT_UP = 2,\n DEVICE_BUTTON_EVT_CLICK = 3,\n DEVICE_BUTTON_EVT_LONG_CLICK = 4,\n DEVICE_BUTTON_EVT_HOLD = 5,\n DEVICE_BUTTON_EVT_DOUBLE_CLICK = 6,\n DEVICE_BUTTON_LONG_CLICK_TIME = 1000,\n DEVICE_BUTTON_HOLD_TIME = 1500,\n DEVICE_BUTTON_STATE = 1,\n DEVICE_BUTTON_STATE_HOLD_TRIGGERED = 2,\n DEVICE_BUTTON_STATE_CLICK = 4,\n DEVICE_BUTTON_STATE_LONG_CLICK = 8,\n DEVICE_BUTTON_SIGMA_MIN = 0,\n DEVICE_BUTTON_SIGMA_MAX = 12,\n DEVICE_BUTTON_SIGMA_THRESH_HI = 8,\n DEVICE_BUTTON_SIGMA_THRESH_LO = 2,\n DEVICE_BUTTON_DOUBLE_CLICK_THRESH = 50,\n DEVICE_BUTTON_SIMPLE_EVENTS = 0,\n DEVICE_BUTTON_ALL_EVENTS = 1,\n ACTIVE_LOW = 0,\n ACTIVE_HIGH = 1,\n // /libraries/codal-core/inc/driver-models/Accelerometer.h\n ACCELEROMETER_IMU_DATA_VALID = 2,\n ACCELEROMETER_EVT_DATA_UPDATE = 1,\n ACCELEROMETER_EVT_NONE = 0,\n ACCELEROMETER_EVT_TILT_UP = 1,\n ACCELEROMETER_EVT_TILT_DOWN = 2,\n ACCELEROMETER_EVT_TILT_LEFT = 3,\n ACCELEROMETER_EVT_TILT_RIGHT = 4,\n ACCELEROMETER_EVT_FACE_UP = 5,\n ACCELEROMETER_EVT_FACE_DOWN = 6,\n ACCELEROMETER_EVT_FREEFALL = 7,\n ACCELEROMETER_EVT_3G = 8,\n ACCELEROMETER_EVT_6G = 9,\n ACCELEROMETER_EVT_8G = 10,\n ACCELEROMETER_EVT_SHAKE = 11,\n ACCELEROMETER_EVT_2G = 12,\n ACCELEROMETER_REST_TOLERANCE = 200,\n ACCELEROMETER_TILT_TOLERANCE = 200,\n ACCELEROMETER_FREEFALL_TOLERANCE = 400,\n ACCELEROMETER_SHAKE_TOLERANCE = 400,\n ACCELEROMETER_2G_TOLERANCE = 2048,\n ACCELEROMETER_3G_TOLERANCE = 3072,\n ACCELEROMETER_6G_TOLERANCE = 6144,\n ACCELEROMETER_8G_TOLERANCE = 8192,\n ACCELEROMETER_GESTURE_DAMPING = 5,\n ACCELEROMETER_SHAKE_DAMPING = 10,\n ACCELEROMETER_SHAKE_RTX = 30,\n ACCELEROMETER_SHAKE_COUNT_THRESHOLD = 4,\n // /libraries/codal-core/inc/driver-models/Compass.h\n COMPASS_STATUS_RUNNING = 1,\n COMPASS_STATUS_CALIBRATED = 2,\n COMPASS_STATUS_CALIBRATING = 4,\n COMPASS_STATUS_ADDED_TO_IDLE = 8,\n COMPASS_EVT_DATA_UPDATE = 1,\n COMPASS_EVT_CONFIG_NEEDED = 2,\n COMPASS_EVT_CALIBRATE = 3,\n COMPASS_EVT_CALIBRATION_NEEDED = 4,\n // /libraries/codal-core/inc/driver-models/Gyroscope.h\n GYROSCOPE_IMU_DATA_VALID = 2,\n GYROSCOPE_EVT_DATA_UPDATE = 1,\n // /libraries/codal-core/inc/driver-models/LowLevelTimer.h\n TimerModeTimer = 0,\n TimerModeCounter = 1,\n TimerModeAlternateFunction = 2,\n BitMode8 = 0,\n BitMode16 = 1,\n BitMode24 = 2,\n BitMode32 = 3,\n // /libraries/codal-core/inc/driver-models/Pin.h\n IO_STATUS_DIGITAL_IN = 1,\n IO_STATUS_DIGITAL_OUT = 2,\n IO_STATUS_ANALOG_IN = 4,\n IO_STATUS_ANALOG_OUT = 8,\n IO_STATUS_TOUCH_IN = 16,\n IO_STATUS_EVENT_ON_EDGE = 32,\n IO_STATUS_EVENT_PULSE_ON_EDGE = 64,\n IO_STATUS_INTERRUPT_ON_EDGE = 128,\n DEVICE_PIN_MAX_OUTPUT = 1023,\n DEVICE_PIN_MAX_SERVO_RANGE = 180,\n DEVICE_PIN_DEFAULT_SERVO_RANGE = 2000,\n DEVICE_PIN_DEFAULT_SERVO_CENTER = 1500,\n DEVICE_PIN_EVENT_NONE = 0,\n DEVICE_PIN_INTERRUPT_ON_EDGE = 1,\n DEVICE_PIN_EVENT_ON_EDGE = 2,\n DEVICE_PIN_EVENT_ON_PULSE = 3,\n DEVICE_PIN_EVENT_ON_TOUCH = 4,\n DEVICE_PIN_EVT_RISE = 2,\n DEVICE_PIN_EVT_FALL = 3,\n DEVICE_PIN_EVT_PULSE_HI = 4,\n DEVICE_PIN_EVT_PULSE_LO = 5,\n PIN_CAPABILITY_DIGITAL = 1,\n PIN_CAPABILITY_ANALOG = 2,\n PIN_CAPABILITY_AD = 3,\n PIN_CAPABILITY_ALL = 3,\n None = 0,\n Down = 1,\n Up = 2,\n // /libraries/codal-core/inc/driver-models/Radio.h\n RADIO_EVT_DATA_READY = 2,\n // /libraries/codal-core/inc/driver-models/SPIFlash.h\n SPIFLASH_PAGE_SIZE = 256,\n SPIFLASH_SMALL_ROW_PAGES = 16,\n SPIFLASH_BIG_ROW_PAGES = 256,\n // /libraries/codal-core/inc/driver-models/Sensor.h\n SENSOR_THRESHOLD_LOW = 1,\n SENSOR_THRESHOLD_HIGH = 2,\n SENSOR_UPDATE_NEEDED = 3,\n SENSOR_INITIALISED = 1,\n SENSOR_HIGH_THRESHOLD_PASSED = 2,\n SENSOR_LOW_THRESHOLD_PASSED = 4,\n SENSOR_LOW_THRESHOLD_ENABLED = 8,\n SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n SENSOR_DEFAULT_SENSITIVITY = 868,\n SENSOR_DEFAULT_SAMPLE_PERIOD = 500,\n // /libraries/codal-core/inc/driver-models/Serial.h\n CODAL_SERIAL_DEFAULT_BAUD_RATE = 115200,\n CODAL_SERIAL_DEFAULT_BUFFER_SIZE = 20,\n CODAL_SERIAL_EVT_DELIM_MATCH = 1,\n CODAL_SERIAL_EVT_HEAD_MATCH = 2,\n CODAL_SERIAL_EVT_RX_FULL = 3,\n CODAL_SERIAL_EVT_DATA_RECEIVED = 4,\n CODAL_SERIAL_STATUS_RX_IN_USE = 1,\n CODAL_SERIAL_STATUS_TX_IN_USE = 2,\n CODAL_SERIAL_STATUS_RX_BUFF_INIT = 4,\n CODAL_SERIAL_STATUS_TX_BUFF_INIT = 8,\n CODAL_SERIAL_STATUS_RXD = 16,\n ASYNC = 0,\n SYNC_SPINWAIT = 1,\n SYNC_SLEEP = 2,\n RxInterrupt = 0,\n TxInterrupt = 1,\n // /libraries/codal-core/inc/driver-models/SingleWireSerial.h\n SWS_EVT_DATA_RECEIVED = 1,\n SWS_EVT_DATA_SENT = 2,\n SWS_EVT_ERROR = 3,\n SWS_EVT_DATA_DROPPED = 4,\n SingleWireRx = 0,\n SingleWireTx = 1,\n SingleWireDisconnected = 2,\n // /libraries/codal-core/inc/driver-models/Timer.h\n CODAL_TIMER_DEFAULT_EVENT_LIST_SIZE = 10,\n // /libraries/codal-core/inc/drivers/AnalogSensor.h\n ANALOG_THRESHOLD_LOW = 1,\n ANALOG_THRESHOLD_HIGH = 2,\n ANALOG_SENSOR_UPDATE_NEEDED = 3,\n ANALOG_SENSOR_INITIALISED = 1,\n ANALOG_SENSOR_HIGH_THRESHOLD_PASSED = 2,\n ANALOG_SENSOR_LOW_THRESHOLD_PASSED = 4,\n ANALOG_SENSOR_LOW_THRESHOLD_ENABLED = 8,\n ANALOG_SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n // /libraries/codal-core/inc/drivers/AnimatedDisplay.h\n DISPLAY_EVT_ANIMATION_COMPLETE = 1,\n DISPLAY_DEFAULT_AUTOCLEAR = 1,\n DISPLAY_SPACING = 1,\n DISPLAY_ANIMATE_DEFAULT_POS = -255,\n DISPLAY_DEFAULT_SCROLL_SPEED = 120,\n DISPLAY_DEFAULT_SCROLL_STRIDE = -1,\n DISPLAY_DEFAULT_PRINT_SPEED = 400,\n ANIMATION_MODE_NONE = 0,\n ANIMATION_MODE_STOPPED = 1,\n ANIMATION_MODE_SCROLL_TEXT = 2,\n ANIMATION_MODE_PRINT_TEXT = 3,\n ANIMATION_MODE_SCROLL_IMAGE = 4,\n ANIMATION_MODE_ANIMATE_IMAGE = 5,\n ANIMATION_MODE_ANIMATE_IMAGE_WITH_CLEAR = 6,\n ANIMATION_MODE_PRINT_CHARACTER = 7,\n // /libraries/codal-core/inc/drivers/FAT.h\n FAT_RESERVED_SECTORS = 1,\n FAT_ROOT_DIR_SECTORS = 4,\n // /libraries/codal-core/inc/drivers/HID.h\n HID_REQUEST_GET_REPORT = 1,\n HID_REQUEST_GET_IDLE = 2,\n HID_REQUEST_GET_PROTOCOL = 3,\n HID_REQUEST_SET_REPORT = 9,\n HID_REQUEST_SET_IDLE = 10,\n HID_REQUEST_SET_PROTOCOL = 11,\n // /libraries/codal-core/inc/drivers/HIDKeyboard.h\n HID_KEYBOARD_NUM_REPORTS = 3,\n HID_KEYBOARD_REPORT_GENERIC = 1,\n HID_KEYBOARD_REPORT_CONSUMER = 2,\n HID_KEYBOARD_KEYSTATE_SIZE_GENERIC = 8,\n HID_KEYBOARD_KEYSTATE_SIZE_CONSUMER = 2,\n HID_KEYBOARD_MODIFIER_OFFSET = 2,\n HID_KEYBOARD_DELAY_DEFAULT = 10,\n PressKey = 0,\n ReleaseKey = 1,\n // /libraries/codal-core/inc/drivers/KeyMap.h\n KEYMAP_ALL_KEYS_UP_Val = 1,\n KEYMAP_ALL_KEYS_UP_POS = 28,\n KEYMAP_NORMAL_KEY_Val = 0,\n KEYMAP_MODIFIER_KEY_Val = 1,\n KEYMAP_MODIFIER_POS = 29,\n KEYMAP_MEDIA_KEY_Val = 1,\n KEYMAP_MEDIA_POS = 30,\n KEYMAP_KEY_UP_Val = 0,\n KEYMAP_KEY_DOWN_Val = 1,\n KEYMAP_KEY_DOWN_POS = 31,\n // /libraries/codal-core/inc/drivers/KeyValueStorage.h\n DEVICE_KEY_VALUE_STORE_OFFSET = 4,\n KEY_VALUE_STORAGE_MAGIC = 49370,\n KEY_VALUE_STORAGE_BLOCK_SIZE = 48,\n KEY_VALUE_STORAGE_KEY_SIZE = 16,\n KEY_VALUE_STORAGE_SCRATCH_WORD_SIZE = 64,\n KEY_VALUE_STORAGE_MAX_PAIRS = 5,\n // /libraries/codal-core/inc/drivers/LEDMatrix.h\n LED_MATRIX_GREYSCALE_BIT_DEPTH = 8,\n LED_MATRIX_EVT_LIGHT_SENSE = 2,\n LED_MATRIX_EVT_FRAME_TIMEOUT = 3,\n LED_MATRIX_MINIMUM_BRIGHTNESS = 1,\n LED_MATRIX_MAXIMUM_BRIGHTNESS = 255,\n LED_MATRIX_DEFAULT_BRIGHTNESS = 255,\n DISPLAY_MODE_BLACK_AND_WHITE = 0,\n DISPLAY_MODE_GREYSCALE = 1,\n DISPLAY_MODE_BLACK_AND_WHITE_LIGHT_SENSE = 2,\n MATRIX_DISPLAY_ROTATION_0 = 0,\n MATRIX_DISPLAY_ROTATION_90 = 1,\n MATRIX_DISPLAY_ROTATION_180 = 2,\n MATRIX_DISPLAY_ROTATION_270 = 3,\n NO_CONN = 0,\n // /libraries/codal-core/inc/drivers/MMA8653.h\n MICROBIT_ACCEL_PITCH_ROLL_VALID = 2,\n MICROBIT_ACCEL_ADDED_TO_IDLE = 4,\n // /libraries/codal-core/inc/drivers/MultiButton.h\n MULTI_BUTTON_STATE_1 = 1,\n MULTI_BUTTON_STATE_2 = 2,\n MULTI_BUTTON_HOLD_TRIGGERED_1 = 4,\n MULTI_BUTTON_HOLD_TRIGGERED_2 = 8,\n MULTI_BUTTON_SUPRESSED_1 = 16,\n MULTI_BUTTON_SUPRESSED_2 = 32,\n MULTI_BUTTON_ATTACHED = 64,\n // /libraries/codal-core/inc/drivers/TouchButton.h\n TOUCH_BUTTON_CALIBRATION_PERIOD = 10,\n TOUCH_BUTTON_CALIBRATION_LINEAR_OFFSET = 2,\n TOUCH_BUTTON_CALIBRATION_PERCENTAGE_OFFSET = 5,\n TOUCH_BUTTON_CALIBRATING = 16,\n // /libraries/codal-core/inc/drivers/TouchSensor.h\n TOUCH_SENSOR_MAX_BUTTONS = 10,\n TOUCH_SENSOR_SAMPLE_PERIOD = 50,\n TOUCH_SENSE_SAMPLE_MAX = 1000,\n TOUCH_SENSOR_UPDATE_NEEDED = 1,\n // /libraries/codal-core/inc/drivers/USBJACDAC.h\n JACDAC_USB_STATUS_CLEAR_TO_SEND = 2,\n // /libraries/codal-core/inc/drivers/USB_HID_Keys.h\n KEY_MOD_LCTRL = 1,\n KEY_MOD_LSHIFT = 2,\n KEY_MOD_LALT = 4,\n KEY_MOD_LMETA = 8,\n KEY_MOD_RCTRL = 16,\n KEY_MOD_RSHIFT = 32,\n KEY_MOD_RALT = 64,\n KEY_MOD_RMETA = 128,\n KEY_NONE = 0,\n KEY_ERR_OVF = 1,\n KEY_A = 4,\n KEY_B = 5,\n KEY_C = 6,\n KEY_D = 7,\n KEY_E = 8,\n KEY_F = 9,\n KEY_G = 10,\n KEY_H = 11,\n KEY_I = 12,\n KEY_J = 13,\n KEY_K = 14,\n KEY_L = 15,\n KEY_M = 16,\n KEY_N = 17,\n KEY_O = 18,\n KEY_P = 19,\n KEY_Q = 20,\n KEY_R = 21,\n KEY_S = 22,\n KEY_T = 23,\n KEY_U = 24,\n KEY_V = 25,\n KEY_W = 26,\n KEY_X = 27,\n KEY_Y = 28,\n KEY_Z = 29,\n KEY_1 = 30,\n KEY_2 = 31,\n KEY_3 = 32,\n KEY_4 = 33,\n KEY_5 = 34,\n KEY_6 = 35,\n KEY_7 = 36,\n KEY_8 = 37,\n KEY_9 = 38,\n KEY_0 = 39,\n KEY_ENTER = 40,\n KEY_ESC = 41,\n KEY_BACKSPACE = 42,\n KEY_TAB = 43,\n KEY_SPACE = 44,\n KEY_MINUS = 45,\n KEY_EQUAL = 46,\n KEY_LEFTBRACE = 47,\n KEY_RIGHTBRACE = 48,\n KEY_BACKSLASH = 49,\n KEY_HASHTILDE = 50,\n KEY_SEMICOLON = 51,\n KEY_APOSTROPHE = 52,\n KEY_GRAVE = 53,\n KEY_COMMA = 54,\n KEY_DOT = 55,\n KEY_SLASH = 56,\n KEY_CAPSLOCK = 57,\n KEY_F1 = 58,\n KEY_F2 = 59,\n KEY_F3 = 60,\n KEY_F4 = 61,\n KEY_F5 = 62,\n KEY_F6 = 63,\n KEY_F7 = 64,\n KEY_F8 = 65,\n KEY_F9 = 66,\n KEY_F10 = 67,\n KEY_F11 = 68,\n KEY_F12 = 69,\n KEY_SYSRQ = 70,\n KEY_SCROLLLOCK = 71,\n KEY_PAUSE = 72,\n KEY_INSERT = 73,\n KEY_HOME = 74,\n KEY_PAGEUP = 75,\n KEY_DELETE = 76,\n KEY_END = 77,\n KEY_PAGEDOWN = 78,\n KEY_RIGHT = 79,\n KEY_LEFT = 80,\n KEY_DOWN = 81,\n KEY_UP = 82,\n KEY_NUMLOCK = 83,\n KEY_KPSLASH = 84,\n KEY_KPASTERISK = 85,\n KEY_KPMINUS = 86,\n KEY_KPPLUS = 87,\n KEY_KPENTER = 88,\n KEY_KP1 = 89,\n KEY_KP2 = 90,\n KEY_KP3 = 91,\n KEY_KP4 = 92,\n KEY_KP5 = 93,\n KEY_KP6 = 94,\n KEY_KP7 = 95,\n KEY_KP8 = 96,\n KEY_KP9 = 97,\n KEY_KP0 = 98,\n KEY_KPDOT = 99,\n KEY_102ND = 100,\n KEY_COMPOSE = 101,\n KEY_POWER = 102,\n KEY_KPEQUAL = 103,\n KEY_F13 = 104,\n KEY_F14 = 105,\n KEY_F15 = 106,\n KEY_F16 = 107,\n KEY_F17 = 108,\n KEY_F18 = 109,\n KEY_F19 = 110,\n KEY_F20 = 111,\n KEY_F21 = 112,\n KEY_F22 = 113,\n KEY_F23 = 114,\n KEY_F24 = 115,\n KEY_OPEN = 116,\n KEY_HELP = 117,\n KEY_PROPS = 118,\n KEY_FRONT = 119,\n KEY_STOP = 120,\n KEY_AGAIN = 121,\n KEY_UNDO = 122,\n KEY_CUT = 123,\n KEY_COPY = 124,\n KEY_PASTE = 125,\n KEY_FIND = 126,\n KEY_MUTE = 127,\n KEY_VOLUMEUP = 128,\n KEY_VOLUMEDOWN = 129,\n KEY_KPCOMMA = 133,\n KEY_RO = 135,\n KEY_KATAKANAHIRAGANA = 136,\n KEY_YEN = 137,\n KEY_HENKAN = 138,\n KEY_MUHENKAN = 139,\n KEY_KPJPCOMMA = 140,\n KEY_HANGEUL = 144,\n KEY_HANJA = 145,\n KEY_KATAKANA = 146,\n KEY_HIRAGANA = 147,\n KEY_ZENKAKUHANKAKU = 148,\n KEY_KPLEFTPAREN = 182,\n KEY_KPRIGHTPAREN = 183,\n KEY_LEFTCTRL = 224,\n KEY_LEFTSHIFT = 225,\n KEY_LEFTALT = 226,\n KEY_LEFTMETA = 227,\n KEY_RIGHTCTRL = 228,\n KEY_RIGHTSHIFT = 229,\n KEY_RIGHTALT = 230,\n KEY_RIGHTMETA = 231,\n KEY_MEDIA_PLAYPAUSE = 232,\n KEY_MEDIA_STOPCD = 233,\n KEY_MEDIA_PREVIOUSSONG = 234,\n KEY_MEDIA_NEXTSONG = 235,\n KEY_MEDIA_EJECTCD = 236,\n KEY_MEDIA_VOLUMEUP = 237,\n KEY_MEDIA_VOLUMEDOWN = 238,\n KEY_MEDIA_MUTE = 239,\n KEY_MEDIA_WWW = 240,\n KEY_MEDIA_BACK = 241,\n KEY_MEDIA_FORWARD = 242,\n KEY_MEDIA_STOP = 243,\n KEY_MEDIA_FIND = 244,\n KEY_MEDIA_SCROLLUP = 245,\n KEY_MEDIA_SCROLLDOWN = 246,\n KEY_MEDIA_EDIT = 247,\n KEY_MEDIA_SLEEP = 248,\n KEY_MEDIA_COFFEE = 249,\n KEY_MEDIA_REFRESH = 250,\n KEY_MEDIA_CALC = 251,\n // /libraries/codal-core/inc/drivers/uf2format.h\n UF2FORMAT_H = 1,\n APP_START_ADDRESS = 8192,\n UF2_FLAG_NOFLASH = 1,\n // /libraries/codal-core/inc/streams/DataStream.h\n DATASTREAM_MAXIMUM_BUFFERS = 1,\n // /libraries/codal-core/inc/streams/LevelDetector.h\n LEVEL_THRESHOLD_LOW = 1,\n LEVEL_THRESHOLD_HIGH = 2,\n LEVEL_DETECTOR_INITIALISED = 1,\n LEVEL_DETECTOR_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/LevelDetectorSPL.h\n LEVEL_DETECTOR_SPL_INITIALISED = 1,\n LEVEL_DETECTOR_SPL_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_SPL_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_SPL_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/MemorySource.h\n MEMORY_SOURCE_MAX_BUFFER = 256,\n // /libraries/codal-core/inc/streams/Synthesizer.h\n SYNTHESIZER_SAMPLE_RATE = 44100,\n TONE_WIDTH = 1024,\n // /libraries/codal-core/inc/types/BitmapFont.h\n BITMAP_FONT_WIDTH = 5,\n BITMAP_FONT_HEIGHT = 5,\n BITMAP_FONT_ASCII_START = 32,\n BITMAP_FONT_ASCII_END = 126,\n // /libraries/codal-core/inc/types/CoordinateSystem.h\n COORDINATE_SPACE_ROTATED_0 = 0,\n COORDINATE_SPACE_ROTATED_90 = 1,\n COORDINATE_SPACE_ROTATED_180 = 2,\n COORDINATE_SPACE_ROTATED_270 = 3,\n RAW = 0,\n SIMPLE_CARTESIAN = 1,\n NORTH_EAST_DOWN = 2,\n NORTH_EAST_UP = 3,\n // /libraries/codal-core/inc/types/Event.h\n DEVICE_ID_ANY = 0,\n DEVICE_EVT_ANY = 0,\n CREATE_ONLY = 0,\n CREATE_AND_FIRE = 1,\n DEVICE_EVENT_DEFAULT_LAUNCH_MODE = 1,\n // /libraries/codal-core/inc/types/RefCounted.h\n REF_TAG_STRING = 1,\n REF_TAG_BUFFER = 2,\n REF_TAG_IMAGE = 3,\n REF_TAG_USER = 32,\n // /pxtapp/accelerometer/axis.h\n ACC_SYSTEM = 3,\n ACC_ROTATION = 0,\n // /pxtapp/configkeys.h\n CFG_PIN_NAME_MSK = 65535,\n CFG_PIN_CONFIG_MSK = 4294901760,\n CFG_PIN_CONFIG_ACTIVE_LO = 65536,\n CFG_MAGIC0 = 513675505,\n CFG_MAGIC1 = 539130489,\n CFG_PIN_ACCELEROMETER_INT = 1,\n CFG_PIN_ACCELEROMETER_SCL = 2,\n CFG_PIN_ACCELEROMETER_SDA = 3,\n CFG_PIN_BTN_A = 4,\n CFG_PIN_BTN_B = 5,\n CFG_PIN_BTN_SLIDE = 6,\n CFG_PIN_DOTSTAR_CLOCK = 7,\n CFG_PIN_DOTSTAR_DATA = 8,\n CFG_PIN_FLASH_CS = 9,\n CFG_PIN_FLASH_MISO = 10,\n CFG_PIN_FLASH_MOSI = 11,\n CFG_PIN_FLASH_SCK = 12,\n CFG_PIN_LED = 13,\n CFG_PIN_LIGHT = 14,\n CFG_PIN_MICROPHONE = 15,\n CFG_PIN_MIC_CLOCK = 16,\n CFG_PIN_MIC_DATA = 17,\n CFG_PIN_MISO = 18,\n CFG_PIN_MOSI = 19,\n CFG_PIN_NEOPIXEL = 20,\n CFG_PIN_RX = 21,\n CFG_PIN_RXLED = 22,\n CFG_PIN_SCK = 23,\n CFG_PIN_SCL = 24,\n CFG_PIN_SDA = 25,\n CFG_PIN_SPEAKER_AMP = 26,\n CFG_PIN_TEMPERATURE = 27,\n CFG_PIN_TX = 28,\n CFG_PIN_TXLED = 29,\n CFG_PIN_IR_OUT = 30,\n CFG_PIN_IR_IN = 31,\n CFG_PIN_DISPLAY_SCK = 32,\n CFG_PIN_DISPLAY_MISO = 33,\n CFG_PIN_DISPLAY_MOSI = 34,\n CFG_PIN_DISPLAY_CS = 35,\n CFG_PIN_DISPLAY_DC = 36,\n CFG_DISPLAY_WIDTH = 37,\n CFG_DISPLAY_HEIGHT = 38,\n CFG_DISPLAY_CFG0 = 39,\n CFG_DISPLAY_CFG1 = 40,\n CFG_DISPLAY_CFG2 = 41,\n CFG_DISPLAY_CFG3 = 42,\n CFG_PIN_DISPLAY_RST = 43,\n CFG_PIN_DISPLAY_BL = 44,\n CFG_PIN_SERVO_1 = 45,\n CFG_PIN_SERVO_2 = 46,\n CFG_PIN_BTN_LEFT = 47,\n CFG_PIN_BTN_RIGHT = 48,\n CFG_PIN_BTN_UP = 49,\n CFG_PIN_BTN_DOWN = 50,\n CFG_PIN_BTN_MENU = 51,\n CFG_PIN_LED_R = 52,\n CFG_PIN_LED_G = 53,\n CFG_PIN_LED_B = 54,\n CFG_PIN_LED1 = 55,\n CFG_PIN_LED2 = 56,\n CFG_PIN_LED3 = 57,\n CFG_PIN_LED4 = 58,\n CFG_SPEAKER_VOLUME = 59,\n CFG_PIN_JACK_TX = 60,\n CFG_PIN_JACK_SENSE = 61,\n CFG_PIN_JACK_HPEN = 62,\n CFG_PIN_JACK_BZEN = 63,\n CFG_PIN_JACK_PWREN = 64,\n CFG_PIN_JACK_SND = 65,\n CFG_PIN_JACK_BUSLED = 66,\n CFG_PIN_JACK_COMMLED = 67,\n CFG_PIN_BTN_SOFT_RESET = 69,\n CFG_ACCELEROMETER_TYPE = 70,\n CFG_PIN_BTNMX_LATCH = 71,\n CFG_PIN_BTNMX_CLOCK = 72,\n CFG_PIN_BTNMX_DATA = 73,\n CFG_PIN_BTN_MENU2 = 74,\n CFG_PIN_BATTSENSE = 75,\n CFG_PIN_VIBRATION = 76,\n CFG_PIN_PWREN = 77,\n CFG_DISPLAY_TYPE = 78,\n CFG_PIN_ROTARY_ENCODER_A = 79,\n CFG_PIN_ROTARY_ENCODER_B = 80,\n CFG_ACCELEROMETER_SPACE = 81,\n CFG_PIN_WIFI_MOSI = 82,\n CFG_PIN_WIFI_MISO = 83,\n CFG_PIN_WIFI_SCK = 84,\n CFG_PIN_WIFI_TX = 85,\n CFG_PIN_WIFI_RX = 86,\n CFG_PIN_WIFI_CS = 87,\n CFG_PIN_WIFI_BUSY = 88,\n CFG_PIN_WIFI_RESET = 89,\n CFG_PIN_WIFI_GPIO0 = 90,\n CFG_PIN_WIFI_AT_TX = 91,\n CFG_PIN_WIFI_AT_RX = 92,\n CFG_PIN_USB_POWER = 93,\n ACCELEROMETER_TYPE_LIS3DH = 50,\n ACCELEROMETER_TYPE_LIS3DH_ALT = 48,\n ACCELEROMETER_TYPE_MMA8453 = 56,\n ACCELEROMETER_TYPE_FXOS8700 = 60,\n ACCELEROMETER_TYPE_MMA8653 = 58,\n ACCELEROMETER_TYPE_MSA300 = 76,\n ACCELEROMETER_TYPE_MPU6050 = 104,\n DISPLAY_TYPE_ST7735 = 7735,\n DISPLAY_TYPE_ILI9341 = 9341,\n DISPLAY_TYPE_SMART = 4242,\n CFG_PIN_A0 = 100,\n CFG_PIN_A1 = 101,\n CFG_PIN_A2 = 102,\n CFG_PIN_A3 = 103,\n CFG_PIN_A4 = 104,\n CFG_PIN_A5 = 105,\n CFG_PIN_A6 = 106,\n CFG_PIN_A7 = 107,\n CFG_PIN_A8 = 108,\n CFG_PIN_A9 = 109,\n CFG_PIN_A10 = 110,\n CFG_PIN_A11 = 111,\n CFG_PIN_A12 = 112,\n CFG_PIN_A13 = 113,\n CFG_PIN_A14 = 114,\n CFG_PIN_A15 = 115,\n CFG_PIN_A16 = 116,\n CFG_PIN_A17 = 117,\n CFG_PIN_A18 = 118,\n CFG_PIN_A19 = 119,\n CFG_PIN_A20 = 120,\n CFG_PIN_A21 = 121,\n CFG_PIN_A22 = 122,\n CFG_PIN_A23 = 123,\n CFG_PIN_A24 = 124,\n CFG_PIN_A25 = 125,\n CFG_PIN_A26 = 126,\n CFG_PIN_A27 = 127,\n CFG_PIN_A28 = 128,\n CFG_PIN_A29 = 129,\n CFG_PIN_A30 = 130,\n CFG_PIN_A31 = 131,\n CFG_PIN_D0 = 150,\n CFG_PIN_D1 = 151,\n CFG_PIN_D2 = 152,\n CFG_PIN_D3 = 153,\n CFG_PIN_D4 = 154,\n CFG_PIN_D5 = 155,\n CFG_PIN_D6 = 156,\n CFG_PIN_D7 = 157,\n CFG_PIN_D8 = 158,\n CFG_PIN_D9 = 159,\n CFG_PIN_D10 = 160,\n CFG_PIN_D11 = 161,\n CFG_PIN_D12 = 162,\n CFG_PIN_D13 = 163,\n CFG_PIN_D14 = 164,\n CFG_PIN_D15 = 165,\n CFG_PIN_D16 = 166,\n CFG_PIN_D17 = 167,\n CFG_PIN_D18 = 168,\n CFG_PIN_D19 = 169,\n CFG_PIN_D20 = 170,\n CFG_PIN_D21 = 171,\n CFG_PIN_D22 = 172,\n CFG_PIN_D23 = 173,\n CFG_PIN_D24 = 174,\n CFG_PIN_D25 = 175,\n CFG_PIN_D26 = 176,\n CFG_PIN_D27 = 177,\n CFG_PIN_D28 = 178,\n CFG_PIN_D29 = 179,\n CFG_PIN_D30 = 180,\n CFG_PIN_D31 = 181,\n CFG_NUM_NEOPIXELS = 200,\n CFG_NUM_DOTSTARS = 201,\n CFG_DEFAULT_BUTTON_MODE = 202,\n CFG_SWD_ENABLED = 203,\n CFG_FLASH_BYTES = 204,\n CFG_RAM_BYTES = 205,\n CFG_SYSTEM_HEAP_BYTES = 206,\n CFG_LOW_MEM_SIMULATION_KB = 207,\n CFG_BOOTLOADER_BOARD_ID = 208,\n CFG_UF2_FAMILY = 209,\n CFG_PINS_PORT_SIZE = 210,\n CFG_BOOTLOADER_PROTECTION = 211,\n CFG_POWER_DEEPSLEEP_TIMEOUT = 212,\n CFG_ANALOG_BUTTON_THRESHOLD = 213,\n CFG_CPU_MHZ = 214,\n CFG_CONTROLLER_LIGHT_MAX_BRIGHTNESS = 215,\n CFG_ANALOG_JOYSTICK_MIN = 216,\n CFG_ANALOG_JOYSTICK_MAX = 217,\n CFG_TIMERS_TO_USE = 218,\n CFG_PIN_ONBOARD_DOTSTAR_CLOCK = 219,\n CFG_PIN_ONBOARD_DOTSTAR_DATA = 220,\n CFG_NUM_ONBOARD_DOTSTARS = 221,\n CFG_PIN_ONBOARD_NEOPIXEL = 222,\n CFG_NUM_ONBOARD_NEOPIXELS = 223,\n CFG_MATRIX_KEYPAD_MESSAGE_ID = 239,\n CFG_NUM_MATRIX_KEYPAD_ROWS = 240,\n CFG_PIN_MATRIX_KEYPAD_ROW0 = 241,\n CFG_PIN_MATRIX_KEYPAD_ROW1 = 242,\n CFG_PIN_MATRIX_KEYPAD_ROW2 = 243,\n CFG_PIN_MATRIX_KEYPAD_ROW3 = 244,\n CFG_PIN_MATRIX_KEYPAD_ROW4 = 245,\n CFG_PIN_MATRIX_KEYPAD_ROW5 = 246,\n CFG_PIN_MATRIX_KEYPAD_ROW6 = 247,\n CFG_PIN_MATRIX_KEYPAD_ROW7 = 248,\n CFG_NUM_MATRIX_KEYPAD_COLS = 250,\n CFG_PIN_MATRIX_KEYPAD_COL0 = 251,\n CFG_PIN_MATRIX_KEYPAD_COL1 = 252,\n CFG_PIN_MATRIX_KEYPAD_COL2 = 253,\n CFG_PIN_MATRIX_KEYPAD_COL3 = 254,\n CFG_PIN_MATRIX_KEYPAD_COL4 = 255,\n CFG_PIN_MATRIX_KEYPAD_COL5 = 256,\n CFG_PIN_MATRIX_KEYPAD_COL6 = 257,\n CFG_PIN_MATRIX_KEYPAD_COL7 = 258,\n CFG_PIN_B0 = 300,\n CFG_PIN_B1 = 301,\n CFG_PIN_B2 = 302,\n CFG_PIN_B3 = 303,\n CFG_PIN_B4 = 304,\n CFG_PIN_B5 = 305,\n CFG_PIN_B6 = 306,\n CFG_PIN_B7 = 307,\n CFG_PIN_B8 = 308,\n CFG_PIN_B9 = 309,\n CFG_PIN_B10 = 310,\n CFG_PIN_B11 = 311,\n CFG_PIN_B12 = 312,\n CFG_PIN_B13 = 313,\n CFG_PIN_B14 = 314,\n CFG_PIN_B15 = 315,\n CFG_PIN_B16 = 316,\n CFG_PIN_B17 = 317,\n CFG_PIN_B18 = 318,\n CFG_PIN_B19 = 319,\n CFG_PIN_B20 = 320,\n CFG_PIN_B21 = 321,\n CFG_PIN_B22 = 322,\n CFG_PIN_B23 = 323,\n CFG_PIN_B24 = 324,\n CFG_PIN_B25 = 325,\n CFG_PIN_B26 = 326,\n CFG_PIN_B27 = 327,\n CFG_PIN_B28 = 328,\n CFG_PIN_B29 = 329,\n CFG_PIN_B30 = 330,\n CFG_PIN_B31 = 331,\n CFG_PIN_C0 = 350,\n CFG_PIN_C1 = 351,\n CFG_PIN_C2 = 352,\n CFG_PIN_C3 = 353,\n CFG_PIN_C4 = 354,\n CFG_PIN_C5 = 355,\n CFG_PIN_C6 = 356,\n CFG_PIN_C7 = 357,\n CFG_PIN_C8 = 358,\n CFG_PIN_C9 = 359,\n CFG_PIN_C10 = 360,\n CFG_PIN_C11 = 361,\n CFG_PIN_C12 = 362,\n CFG_PIN_C13 = 363,\n CFG_PIN_C14 = 364,\n CFG_PIN_C15 = 365,\n CFG_PIN_C16 = 366,\n CFG_PIN_C17 = 367,\n CFG_PIN_C18 = 368,\n CFG_PIN_C19 = 369,\n CFG_PIN_C20 = 370,\n CFG_PIN_C21 = 371,\n CFG_PIN_C22 = 372,\n CFG_PIN_C23 = 373,\n CFG_PIN_C24 = 374,\n CFG_PIN_C25 = 375,\n CFG_PIN_C26 = 376,\n CFG_PIN_C27 = 377,\n CFG_PIN_C28 = 378,\n CFG_PIN_C29 = 379,\n CFG_PIN_C30 = 380,\n CFG_PIN_C31 = 381,\n CFG_PIN_P0 = 400,\n CFG_PIN_P1 = 401,\n CFG_PIN_P2 = 402,\n CFG_PIN_P3 = 403,\n CFG_PIN_P4 = 404,\n CFG_PIN_P5 = 405,\n CFG_PIN_P6 = 406,\n CFG_PIN_P7 = 407,\n CFG_PIN_P8 = 408,\n CFG_PIN_P9 = 409,\n CFG_PIN_P10 = 410,\n CFG_PIN_P11 = 411,\n CFG_PIN_P12 = 412,\n CFG_PIN_P13 = 413,\n CFG_PIN_P14 = 414,\n CFG_PIN_P15 = 415,\n CFG_PIN_P16 = 416,\n CFG_PIN_P17 = 417,\n CFG_PIN_P18 = 418,\n CFG_PIN_P19 = 419,\n CFG_PIN_P20 = 420,\n CFG_PIN_P21 = 421,\n CFG_PIN_P22 = 422,\n CFG_PIN_P23 = 423,\n CFG_PIN_P24 = 424,\n CFG_PIN_P25 = 425,\n CFG_PIN_P26 = 426,\n CFG_PIN_P27 = 427,\n CFG_PIN_P28 = 428,\n CFG_PIN_P29 = 429,\n CFG_PIN_P30 = 430,\n CFG_PIN_P31 = 431,\n CFG_PIN_LORA_MISO = 1001,\n CFG_PIN_LORA_MOSI = 1002,\n CFG_PIN_LORA_SCK = 1003,\n CFG_PIN_LORA_CS = 1004,\n CFG_PIN_LORA_BOOT = 1005,\n CFG_PIN_LORA_RESET = 1006,\n CFG_PIN_IRRXLED = 1007,\n CFG_PIN_IRTXLED = 1008,\n CFG_PIN_LCD_RESET = 1009,\n CFG_PIN_LCD_ENABLE = 1010,\n CFG_PIN_LCD_DATALINE4 = 1011,\n CFG_PIN_LCD_DATALINE5 = 1012,\n CFG_PIN_LCD_DATALINE6 = 1013,\n CFG_PIN_LCD_DATALINE7 = 1014,\n CFG_NUM_LCD_COLUMNS = 1015,\n CFG_NUM_LCD_ROWS = 1016,\n CFG_PIN_RCC0 = 1017,\n CFG_PIN_RCC1 = 1018,\n CFG_PIN_RCC2 = 1019,\n CFG_PIN_RCC3 = 1020,\n CFG_PIN_RCC4 = 1021,\n CFG_PIN_RCC5 = 1022,\n CFG_PIN_RCC6 = 1023,\n CFG_PIN_RCC7 = 1024,\n CFG_PIN_SERVO0 = 1025,\n CFG_PIN_SERVO1 = 1026,\n CFG_PIN_SERVO2 = 1027,\n CFG_PIN_SERVO3 = 1028,\n CFG_PIN_SERVO4 = 1029,\n CFG_PIN_SERVO5 = 1030,\n CFG_PIN_SERVO6 = 1031,\n CFG_PIN_SERVO7 = 1032,\n CFG_PIN_SERVO8 = 1033,\n CFG_PIN_PI_TX = 1034,\n CFG_PIN_PI_RX = 1035,\n CFG_PIN_GPS_SDA = 1036,\n CFG_PIN_GPS_SCL = 1037,\n CFG_PIN_GPS_TX = 1038,\n CFG_PIN_GPS_RX = 1039,\n CFG_PIN_GROVE0 = 1040,\n CFG_PIN_GROVE1 = 1041,\n CFG_PIN_SS = 1042,\n CFG_PIN_JDPWR_PRE_SENSE = 1100,\n CFG_PIN_JDPWR_GND_SENSE = 1101,\n CFG_PIN_JDPWR_PULSE = 1102,\n CFG_PIN_JDPWR_OVERLOAD_LED = 1103,\n CFG_PIN_JDPWR_ENABLE = 1104,\n CFG_PIN_JDPWR_FAULT = 1105,\n // /pxtapp/hf2dbg.h\n HF2DBG_H = 1,\n // /pxtapp/jacdac-services/jdprotocol.h\n JDSPI_MAGIC = 31437,\n JDSPI_MAGIC_NOOP = 46029,\n // /pxtapp/mixer---nrf52/melody.h\n OUTPUT_BITS = 10,\n SW_TRIANGLE = 1,\n SW_SAWTOOTH = 2,\n SW_SINE = 3,\n SW_TUNEDNOISE = 4,\n SW_NOISE = 5,\n SW_SQUARE_10 = 11,\n SW_SQUARE_50 = 15,\n SW_SQUARE_CYCLE_16 = 16,\n SW_SQUARE_CYCLE_32 = 17,\n SW_SQUARE_CYCLE_64 = 18,\n CODAL = 1,\n MAX_SOUNDS = 5,\n Waiting = 0,\n Playing = 1,\n Done = 2,\n // /pxtapp/pins.h\n BUTTON_ACTIVE_HIGH_PULL_DOWN = 17,\n BUTTON_ACTIVE_HIGH_PULL_UP = 33,\n BUTTON_ACTIVE_HIGH_PULL_NONE = 49,\n BUTTON_ACTIVE_LOW_PULL_DOWN = 16,\n BUTTON_ACTIVE_LOW_PULL_UP = 32,\n BUTTON_ACTIVE_LOW_PULL_NONE = 48,\n // /pxtapp/platform.h\n PAGE_SIZE = 4096,\n IMAGE_BITS = 4,\n DEFAULT_NEOPIXEL_PIN = 0,\n TEMPERATURE_NOMINAL_VALUE = 25,\n TEMPERATURE_NOMINAL_READING = 10000,\n TEMPERATURE_BETA = 3380,\n TEMPERATURE_SERIES_RESISTOR = 10000,\n LIGHTSENSOR_SENSITIVITY = 868,\n LIGHTSENSOR_LOW_THRESHOLD = 128,\n LIGHTSENSOR_HIGH_THRESHOLD = 896,\n P0_0 = 0,\n P0_1 = 1,\n P0_2 = 2,\n P0_3 = 3,\n P0_4 = 4,\n P0_5 = 5,\n P0_6 = 6,\n P0_7 = 7,\n P0_8 = 8,\n P0_9 = 9,\n P0_10 = 10,\n P0_11 = 11,\n P0_12 = 12,\n P0_13 = 13,\n P0_14 = 14,\n P0_15 = 15,\n P0_16 = 16,\n P0_17 = 17,\n P0_18 = 18,\n P0_19 = 19,\n P0_20 = 20,\n P0_21 = 21,\n P0_22 = 22,\n P0_23 = 23,\n P0_24 = 24,\n P0_25 = 25,\n P0_26 = 26,\n P0_27 = 27,\n P0_28 = 28,\n P0_29 = 29,\n P0_30 = 30,\n P0_31 = 31,\n P1_0 = 32,\n P1_1 = 33,\n P1_2 = 34,\n P1_3 = 35,\n P1_4 = 36,\n P1_5 = 37,\n P1_6 = 38,\n P1_7 = 39,\n P1_8 = 40,\n P1_9 = 41,\n P1_10 = 42,\n P1_11 = 43,\n P1_12 = 44,\n P1_13 = 45,\n P1_14 = 46,\n P1_15 = 47,\n P1_16 = 48,\n P1_17 = 49,\n P1_18 = 50,\n P1_19 = 51,\n P1_20 = 52,\n P1_21 = 53,\n P1_22 = 54,\n P1_23 = 55,\n P1_24 = 56,\n P1_25 = 57,\n P1_26 = 58,\n P1_27 = 59,\n P1_28 = 60,\n P1_29 = 61,\n P1_30 = 62,\n P1_31 = 63,\n // /pxtapp/pxt.h\n PXT_COMM_BASE = 536879104,\n DEVICE_ID_BUTTON_SLIDE = 3000,\n DEVICE_ID_MICROPHONE = 3001,\n DEVICE_ID_FIRST_BUTTON = 4000,\n DEVICE_ID_FIRST_TOUCHBUTTON = 4100,\n PXT_INTERNAL_KEY_UP = 2050,\n PXT_INTERNAL_KEY_DOWN = 2051,\n // /pxtapp/pxtbase.h\n PXT32 = 1,\n PXT64 = 1,\n PXT_REFCNT_FLASH = 65534,\n VTABLE_MAGIC = 249,\n Undefined = 0,\n Boolean = 1,\n Number = 2,\n String = 3,\n Object = 4,\n Function = 5,\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,\n MMap = 10,\n User0 = 16,\n PXT_IOS_HEAP_ALLOC_BITS = 20,\n IMAGE_HEADER_MAGIC = 135,\n Int8LE = 1,\n UInt8LE = 2,\n Int16LE = 3,\n UInt16LE = 4,\n Int32LE = 5,\n Int8BE = 6,\n UInt8BE = 7,\n Int16BE = 8,\n UInt16BE = 9,\n Int32BE = 10,\n UInt32LE = 11,\n UInt32BE = 12,\n Float32LE = 13,\n Float64LE = 14,\n Float32BE = 15,\n Float64BE = 16,\n NUM_TRY_FRAME_REGS = 3,\n GC = 0,\n // /pxtapp/pxtconfig.h\n PXT_UF2_FAMILY = 2913282112,\n // /pxtapp/settings/Flash.h\n DEVICE_FLASH_ERROR = 922,\n // /pxtapp/settings/RAFFS.h\n RAFFS_FOLLOWING_MASK = 32768,\n RAFFS_FLASH_BUFFER_SIZE = 64,\n // /pxtapp/uf2format.h\n BOOTLOADER_START = 0,\n BOOTLOADER_END = 8192,\n // /pxtapp/uf2hid.h\n UF2_HID_H = 1,\n}\n",
"dmac.cpp": "#include \"dmac.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nSINGLETON(WDMAC);\n#endif\n\n}",
"dmac.h": "#ifndef __DMAC_H\n#define __DMAC_H\n\n#include \"pxt.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nclass WDMAC {\n public:\n CODAL_DMAC dmac;\n\n WDMAC() {}\n};\n\nWDMAC* getWDMAC();\n#endif\n\n}\n\n#endif",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum PulseValue {\n //% block=high\n High = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=low\n Low = 5, // DEVICE_PIN_EVT_PULSE_LO\n }\n\n\n declare const enum PinEvent {\n //% block=\"pulse high\"\n PulseHigh = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=\"pulse low\"\n PulseLow = 5, // DEVICE_PIN_EVT_PULSE_LO\n //% block=\"rise\"\n Rise = 2, // DEVICE_PIN_EVT_RISE\n //% block=\"fall\"\n Fall = 3, // DEVICE_PIN_EVT_FALL\n }\n\n\n declare const enum PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"hf2.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#ifndef USB_HANDOVER\n#define USB_HANDOVER 1\n#endif\n\n#if USB_HANDOVER\n#define UF2_DEFINE_HANDOVER 1\n#endif\n\n#include \"uf2format.h\"\n\nstatic void *stackCopy;\nstatic uint32_t stackSize;\n\n//#define LOG DMESG\n#define LOG(...) ((void)0)\n\nstatic volatile bool resume = false;\n\nusing namespace codal;\n\n#ifdef HF2_HID\nstatic const char hidDescriptor[] = {\n 0x06, 0x97, 0xFF, // usage page vendor 0x97 (usage 0xff97 0x0001)\n 0x09, 0x01, // usage 1\n 0xA1, 0x01, // collection - application\n 0x15, 0x00, // logical min 0\n 0x26, 0xFF, 0x00, // logical max 255\n 0x75, 8, // report size 8\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x81, 0x02, // input: data, variable, absolute\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x91, 0x02, // output: data, variable, absolute\n 0x95, 1, // report count 1\n 0x09, 0x01, // usage 1\n 0xB1, 0x02, // feature: data, variable, absolute\n 0xC0, // end\n};\n\nstatic const HIDReportDescriptor reportDesc = {\n 9,\n 0x21, // HID\n 0x100, // hidbcd 1.00\n 0x00, // country code\n 0x01, // num desc\n 0x22, // report desc type\n sizeof(hidDescriptor), // size of 0x22\n};\n\nstatic const InterfaceInfo ifaceInfoHID = {\n &reportDesc,\n sizeof(reportDesc),\n 1,\n {\n 2, // numEndpoints\n 0x03, /// class code - HID\n 0x00, // subclass\n 0x00, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_INTERRUPT, 1},\n {USB_EP_TYPE_INTERRUPT, 1},\n};\n#endif\n\nstatic const InterfaceInfo ifaceInfoEP = {\n NULL,\n 0,\n 2,\n {\n 2, // numEndpoints\n 0xff, /// class code - vendor-specific\n 42, // subclass\n 1, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_BULK, 0},\n {USB_EP_TYPE_BULK, 0},\n};\n\nint HF2::stdRequest(UsbEndpointIn &ctrl, USBSetup &setup) {\n#ifdef HF2_HID\n if (!useHID)\n return DEVICE_NOT_SUPPORTED;\n if (setup.bRequest == USB_REQ_GET_DESCRIPTOR) {\n if (setup.wValueH == 0x21) {\n InterfaceDescriptor tmp;\n fillInterfaceInfo(&tmp);\n return ctrl.write(&tmp, sizeof(tmp));\n } else if (setup.wValueH == 0x22) {\n return ctrl.write(hidDescriptor, sizeof(hidDescriptor));\n }\n }\n#endif\n return DEVICE_NOT_SUPPORTED;\n}\n\n// same as in microbit\n#define CTRL_GET_REPORT 0x01\n#define CTRL_SET_REPORT 0x09\n#define CTRL_OUT_REPORT_H 0x2\n#define CTRL_IN_REPORT_H 0x1\n\nvoid HF2::sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend) {\n if (!CodalUSB::usbInstance->isInitialised())\n return;\n\n uint32_t buf[64 / 4]; // aligned\n\n if (prepend + 1)\n size += 4;\n\n target_disable_irq();\n while (size > 0) {\n memset(buf + 1, 0, 60);\n int s = 63;\n if (size <= 63) {\n s = size;\n buf[0] = flag;\n } else {\n buf[0] = flag == HF2_FLAG_CMDPKT_LAST ? HF2_FLAG_CMDPKT_BODY : flag;\n }\n buf[0] |= s;\n uint8_t *dst = (uint8_t *)buf;\n dst++;\n if (prepend + 1) {\n memcpy(dst, &prepend, 4);\n prepend = -1;\n dst += 4;\n s -= 4;\n size -= 4;\n }\n memcpy(dst, data, s);\n data = (const uint8_t *)data + s;\n size -= s;\n\n in->write(buf, sizeof(buf));\n }\n target_enable_irq();\n}\n\nconst InterfaceInfo *HF2::getInterfaceInfo() {\n#ifdef HF2_HID\n if (useHID)\n return &ifaceInfoHID;\n#endif\n return &ifaceInfoEP;\n}\n\nint HF2::sendEvent(uint32_t evId, const void *data, int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, evId);\n return 0;\n}\n\nint HF2::sendSerial(const void *data, int size, int isError) {\n if (!gotSomePacket)\n return DEVICE_OK;\n\n sendBuffer(isError ? HF2_FLAG_SERIAL_ERR : HF2_FLAG_SERIAL_OUT, data, size);\n\n return 0;\n}\n\n// Receive HF2 message\n// Does not block. Will store intermediate data in pkt.\n// `serial` flag is cleared if we got a command message.\nint HF2::recv() {\n uint8_t buf[64];\n\n int len = out->read(buf, sizeof(buf));\n // DMESG(\"HF2 read: %d\", len);\n\n if (len <= 0)\n return len;\n\n uint8_t tag = buf[0];\n // serial packets not allowed when in middle of command packet\n usb_assert(pkt.size == 0 || !(tag & HF2_FLAG_SERIAL_OUT));\n int size = tag & HF2_SIZE_MASK;\n usb_assert(pkt.size + size <= (int)sizeof(pkt.buf));\n memcpy(pkt.buf + pkt.size, buf + 1, size);\n pkt.size += size;\n tag &= HF2_FLAG_MASK;\n if (tag != HF2_FLAG_CMDPKT_BODY) {\n if (tag == HF2_FLAG_CMDPKT_LAST)\n pkt.serial = 0;\n else if (tag == HF2_FLAG_SERIAL_OUT)\n pkt.serial = 1;\n else\n pkt.serial = 2;\n int sz = pkt.size;\n pkt.size = 0;\n return sz;\n }\n return 0;\n}\n\nint HF2::sendResponse(int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, pkt.buf, 4 + size);\n return 0;\n}\n\nint HF2::sendResponseWithData(const void *data, int size) {\n if (size <= (int)sizeof(pkt.buf) - 4) {\n memcpy(pkt.resp.data8, data, size);\n return sendResponse(size);\n } else {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, pkt.resp.eventId);\n return 0;\n }\n}\n\nstatic void copy_words(void *dst0, const void *src0, uint32_t n_words) {\n uint32_t *dst = (uint32_t *)dst0;\n const uint32_t *src = (const uint32_t *)src0;\n while (n_words--)\n *dst++ = *src++;\n}\n\n#ifndef QUICK_BOOT\n#ifdef SAMD21\n#define DBL_TAP_PTR ((volatile uint32_t *)(HMCRAMC0_ADDR + HMCRAMC0_SIZE - 4))\n#endif\n#ifdef SAMD51\n#define DBL_TAP_PTR ((volatile uint32_t *)(HSRAM_ADDR + HSRAM_SIZE - 4))\n#endif\n#if defined(NRF52840) || defined(NRF52833)\n#define DBL_TAP_PTR ((volatile uint32_t*)0x20007F7C)\n#endif\n#define DBL_TAP_MAGIC_QUICK_BOOT 0xf02669ef\n#define QUICK_BOOT(v) *DBL_TAP_PTR = v ? DBL_TAP_MAGIC_QUICK_BOOT : 0\n#endif\n\nstatic HF2 *jdLogger;\nstatic void jdLog(const uint8_t *frame) {\n jdLogger->sendEvent(HF2_EV_JDS_PACKET, frame, frame[2] + 12);\n}\n\nint HF2::endpointRequest() {\n int sz = recv();\n\n if (!sz)\n return 0;\n\n uint32_t tmp;\n\n if (pkt.serial) {\n // TODO raise some event?\n return 0;\n }\n\n LOG(\"HF2 sz=%d CMD=%x\", sz, pkt.buf32[0]);\n\n // one has to be careful dealing with these, as they share memory\n HF2_Command *cmd = &pkt.cmd;\n HF2_Response *resp = &pkt.resp;\n\n uint32_t cmdId = cmd->command_id;\n resp->tag = cmd->tag;\n resp->status16 = HF2_STATUS_OK;\n\n#define checkDataSize(str, add) usb_assert(sz == 8 + (int)sizeof(cmd->str) + (int)(add))\n\n lastExchange = current_time_ms();\n gotSomePacket = true;\n\n switch (cmdId) {\n case HF2_CMD_INFO:\n return sendResponseWithData(uf2_info(), strlen(uf2_info()));\n\n case HF2_CMD_BININFO:\n resp->bininfo.mode = HF2_MODE_USERSPACE;\n resp->bininfo.flash_page_size = 0;\n resp->bininfo.flash_num_pages = 0;\n resp->bininfo.max_message_size = sizeof(pkt.buf);\n resp->bininfo.uf2_family = PXT_UF2_FAMILY;\n return sendResponse(sizeof(resp->bininfo));\n\n case HF2_DBG_RESTART:\n *HF2_DBG_MAGIC_PTR = HF2_DBG_MAGIC_START;\n target_reset();\n break;\n\n case HF2_CMD_RESET_INTO_APP:\n QUICK_BOOT(1);\n NVIC_SystemReset();\n break;\n case HF2_CMD_RESET_INTO_BOOTLOADER:\n QUICK_BOOT(0);\n NVIC_SystemReset();\n break;\n\n#if USB_HANDOVER\n case HF2_CMD_START_FLASH:\n sendResponse(0);\n hf2_handover(in->ep);\n usb_assert(0); // should not be reached\n break;\n#endif\n\n case HF2_CMD_WRITE_WORDS:\n checkDataSize(write_words, cmd->write_words.num_words << 2);\n copy_words((void *)cmd->write_words.target_addr, cmd->write_words.words,\n cmd->write_words.num_words);\n break;\n\n case HF2_CMD_READ_WORDS:\n checkDataSize(read_words, 0);\n tmp = cmd->read_words.num_words;\n usb_assert(tmp <= sizeof(pkt.buf) / 4 - 1);\n copy_words(resp->data32, (void *)cmd->read_words.target_addr, tmp);\n return sendResponse(tmp << 2);\n\n case HF2_CMD_DMESG:\n#if DEVICE_DMESG_BUFFER_SIZE > 0\n return sendResponseWithData(codalLogStore.buffer, codalLogStore.ptr);\n#else\n break;\n#endif\n\n case HF2_DBG_GET_GLOBAL_STATE: {\n HF2_GLOBAL_STATE_Result gstate = {\n .num_globals = (uint32_t)getNumGlobals(), //\n .globals_addr = (uint32_t)globals,\n };\n return sendResponseWithData(&gstate, sizeof(gstate));\n }\n\n case HF2_DBG_RESUME:\n globals[0] = (TValue)cmd->data32[0];\n resume = true;\n return sendResponse(0);\n\n case HF2_DBG_GET_STACK:\n return sendResponseWithData(stackCopy, stackSize);\n\n case HF2_CMD_JDS_CONFIG:\n if (cmd->data8[0]) {\n jdLogger = this;\n pxt::logJDFrame = jdLog;\n } else {\n pxt::logJDFrame = NULL;\n }\n return sendResponse(0);\n\n case HF2_CMD_JDS_SEND:\n if (pxt::sendJDFrame) {\n pxt::sendJDFrame(cmd->data8);\n return sendResponse(0);\n } else {\n resp->status16 = HF2_STATUS_INVALID_STATE;\n return sendResponse(0);\n }\n\n default:\n // command not understood\n resp->status16 = HF2_STATUS_INVALID_CMD;\n break;\n }\n\n return sendResponse(0);\n}\n\nHF2::HF2(HF2_Buffer &p) : gotSomePacket(false), ctrlWaiting(false), pkt(p), useHID(false) {\n lastExchange = 0;\n}\n\nstatic const InterfaceInfo dummyIfaceInfo = {\n NULL,\n 0,\n 0,\n {\n 0, // numEndpoints\n 0xff, /// class code - vendor-specific\n 0xff, // subclass\n 0xff, // protocol\n 0x00, // string\n 0x00, // alt\n },\n {0, 0},\n {0, 0},\n};\n\nconst InterfaceInfo *DummyIface::getInterfaceInfo() {\n return &dummyIfaceInfo;\n}\n\n//\n//\n// Debugger\n//\n//\n\nstruct ExceptionContext {\n uint32_t excReturn; // 0xFFFFFFF9\n uint32_t r0;\n uint32_t r1;\n uint32_t r2;\n uint32_t r3;\n uint32_t r12;\n uint32_t lr;\n uint32_t faultInstrAddr;\n uint32_t psr;\n};\n\nstruct Paused_Data {\n uint32_t pc;\n};\nstatic Paused_Data pausedData;\n\nvoid bkptPaused() {\n\n// waiting for https://github.com/lancaster-university/codal/pull/14\n#ifdef DEVICE_GROUP_ID_USER\n // the loop below counts as \"system\" task, and we don't want to pause ourselves\n fiber_set_group(DEVICE_GROUP_ID_SYSTEM);\n // pause everyone else\n fiber_pause_group(DEVICE_GROUP_ID_USER);\n#endif\n\n while (!resume) {\n // DMESG(\"BKPT\");\n hf2.pkt.resp.eventId = HF2_EV_DBG_PAUSED;\n hf2.sendResponseWithData(&pausedData, sizeof(pausedData));\n // TODO use an event\n for (int i = 0; i < 20; ++i) {\n if (resume)\n break;\n fiber_sleep(50);\n }\n }\n\n if (stackCopy) {\n xfree(stackCopy);\n stackCopy = NULL;\n }\n\n#ifdef DEVICE_GROUP_ID_USER\n fiber_resume_group(DEVICE_GROUP_ID_USER);\n // go back to user mode\n fiber_set_group(DEVICE_GROUP_ID_USER);\n#endif\n\n resume = false;\n}\n\nextern \"C\" void handleHardFault(ExceptionContext *ectx) {\n auto instr = (uint16_t *)ectx->faultInstrAddr;\n\n DMESG(\"FLT %p\", instr);\n\n if (ectx->faultInstrAddr & 0x80000000) {\n ectx->faultInstrAddr &= ~0x80000000;\n // switch to step-over mode\n globals[0] = (TValue)3;\n return;\n }\n\n DMESG(\"BB %p %p %p lr=%p r0=%p\", instr[-1], instr[0], instr[1], ectx->lr, ectx->r0);\n\n if (instr[0] == 0x6840) {\n // ldr r0, [r0, #4] -- entry breakpoint\n ectx->faultInstrAddr += 2;\n // we're being ask for step-over mode\n if (ectx->r0 == 3) {\n // switch to debugger-attached-no-stepping mode\n globals[0] = (TValue)0;\n ectx->lr |= 0x80000000;\n }\n return;\n }\n\n if (instr[0] == 0x6800) {\n // ldr r0, [r0, #0]\n ectx->lr = ectx->faultInstrAddr + 3; // next instruction + thumb mode\n pausedData.pc = ectx->faultInstrAddr + 2;\n void *ssp = (void *)(ectx + 1);\n stackSize = DEVICE_STACK_BASE - (uint32_t)ssp;\n if (stackCopy)\n xfree(stackCopy);\n stackCopy = xmalloc(stackSize);\n memcpy(stackCopy, ssp, stackSize);\n ectx->faultInstrAddr = ((uint32_t)(&bkptPaused) & (~1U));\n return;\n }\n\n while (1) {\n }\n}\n\nextern \"C\" void HardFault_Handler(void) {\n asm(\"push {lr}; mov r0, sp; bl handleHardFault; pop {pc}\");\n}\n\n#endif",
"hf2.h": "#ifndef DEVICE_HF2_H\n#define DEVICE_HF2_H\n\n#if CONFIG_ENABLED(DEVICE_USB)\n\n#include \"HID.h\"\n#include \"uf2hid.h\"\n\n// 260 bytes needed for biggest JD packets (with overheads)\n#define HF2_BUF_SIZE 260\n\ntypedef struct {\n uint16_t size;\n uint8_t serial;\n union {\n uint8_t buf[HF2_BUF_SIZE];\n uint32_t buf32[HF2_BUF_SIZE / 4];\n uint16_t buf16[HF2_BUF_SIZE / 2];\n HF2_Command cmd;\n HF2_Response resp;\n };\n} HF2_Buffer;\n\nclass HF2 : public CodalUSBInterface {\n bool gotSomePacket;\n bool ctrlWaiting;\n uint32_t lastExchange;\n\n public:\n HF2_Buffer &pkt;\n\n bool useHID;\n\n int sendResponse(int size);\n int recv();\n int sendResponseWithData(const void *data, int size);\n int sendEvent(uint32_t evId, const void *data, int size);\n void sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend = -1);\n\n HF2(HF2_Buffer &pkt);\n virtual int endpointRequest();\n virtual int stdRequest(UsbEndpointIn &ctrl, USBSetup &setup);\n virtual const InterfaceInfo *getInterfaceInfo();\n int sendSerial(const void *data, int size, int isError = 0);\n\n virtual bool enableWebUSB() { return !useHID; }\n};\n\nclass DummyIface : public CodalUSBInterface {\n public:\n virtual const InterfaceInfo *getInterfaceInfo();\n};\n\n#endif\n\n#endif\n",
"hf2dbg.h": "#ifndef HF2DBG_H\n#define HF2DBG_H 1\n\n// we use a location at the top of the stack to store a magic value\n// which causes us to stop at the very first break point in the program\n#define HF2_DBG_MAGIC_PTR ((uint32_t *)(DEVICE_STACK_BASE - (DEVICE_STACK_SIZE - 4)))\n#define HF2_DBG_MAGIC_START 0xf0ebac7f\n\n#define HF2_DBG_GET_GLOBAL_STATE 0x53fc66e0\nstruct HF2_GLOBAL_STATE_Result {\n uint32_t num_globals;\n uint32_t globals_addr;\n};\n\n#define HF2_DBG_RESTART 0x1120bd93\n#define HF2_DBG_RESUME 0x27a55931\n#define HF2_EV_DBG_PAUSED 0x3692f9fd\n#define HF2_DBG_GET_STACK 0x70901510\n\n#endif\n",
"i2c.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n#include \"CodalDmesg.h\"\n#include \"configkeys.h\"\n\n#ifdef CODAL_I2C\n\nnamespace pins {\n\nclass CodalI2CProxy {\nprivate:\n DevicePin* sda;\n DevicePin* scl;\n CODAL_I2C i2c;\npublic:\n CodalI2CProxy* next;\npublic:\n CodalI2CProxy(DevicePin* _sda, DevicePin* _scl)\n : sda(_sda)\n , scl(_scl)\n , i2c(*_sda, *_scl) \n , next(NULL)\n {\n\n }\n\n CODAL_I2C* getI2C() {\n return &(this->i2c);\n }\n \n bool matchPins(DevicePin* sda, DevicePin* scl) {\n return this->sda == sda && this->scl == scl;\n }\n\n Buffer readBuffer(int address, int size, bool repeat = false)\n {\n Buffer buf = mkBuffer(NULL, size);\n registerGCObj(buf);\n int status = this->i2c.read(address << 1, buf->data, size, repeat);\n unregisterGCObj(buf);\n if (status != ErrorCode::DEVICE_OK) {\n buf = 0;\n }\n return buf;\n }\n\n int writeBuffer(int address, Buffer buf, bool repeat = false)\n {\n return this->i2c.write(address << 1, buf->data, buf->length, repeat);\n }\n};\n\n}\n\nnamespace I2CMethods {\n/**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n//%\nBuffer readBuffer(I2C_ i2c, int address, int size, bool repeat = false)\n{\n return i2c->readBuffer(address, size, repeat);\n}\n\n/**\n * Write bytes to a 7-bit I2C `address`.\n */\n//%\nint writeBuffer(I2C_ i2c, int address, Buffer buf, bool repeat = false)\n{\n return i2c->writeBuffer(address, buf, repeat);\n}\n\n}\n\nnamespace pins {\n\nstatic I2C_ i2cs(NULL);\n/**\n* Opens a Serial communication driver\n*/\n//% help=pins/create-i2c\n//% parts=i2c\nI2C_ createI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n // pick up defaults\n if (!sda || !scl) {\n DMESG(\"i2c: lookup default pins\");\n sda = LOOKUP_PIN(SDA);\n scl = LOOKUP_PIN(SCL);\n }\n\n // lookup existing devices\n auto dev = i2cs;\n while(dev) {\n if (dev->matchPins(sda, scl)) {\n DMESG(\"i2c: found existing i2c\");\n return dev;\n }\n dev = dev->next;\n }\n\n // allocate new one\n DMESG(\"i2c: mounting on new device\");\n auto ser = new CodalI2CProxy(sda, scl);\n // push in list\n ser->next = i2cs;\n i2cs = ser;\n return ser;\n}\n\n}\n\nnamespace pxt {\n CODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n auto i2c = pins::createI2C(sda, scl);\n return i2c->getI2C();\n }\n}\n\n#endif",
"i2c.ts": "namespace pins {\n /**\n * Read one number from an I2C address.\n */\n //% help=pins/i2c-read-number weight=5 group=\"i2c\" inlineInputMode=\"external\"\n //% blockId=pins_i2c_readnumber block=\"i2c read number at address %address|of format %format|repeated %repeated\"\n export function i2cReadNumber(address: number, format: NumberFormat, repeated?: boolean): number {\n const buf = pins.i2cReadBuffer(address, pins.sizeOf(format), repeated)\n if (!buf)\n return undefined\n return buf.getNumber(format, 0)\n }\n\n /**\n * Write one number to an I2C address.\n */\n //% help=pins/i2c-write-number weight=4 group=\"i2c\"\n //% blockId=i2c_writenumber block=\"i2c write number|at address %address|with value %value|of format %format|repeated %repeated\"\n export function i2cWriteNumber(address: number, value: number, format?: NumberFormat, repeated?: boolean): void {\n if (format == undefined)\n format = NumberFormat.UInt8LE;\n const buf = control.createBuffer(pins.sizeOf(format))\n buf.setNumber(format, 0, value)\n pins.i2cWriteBuffer(address, buf, repeated)\n }\n\n /**\n * Write a value in a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param value value to write\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-write-register\n //% blockId=i2c_writereg block=\"i2c write register|at address $address|at register $register|value $value\"\n export function i2cWriteRegister(address: number, register: number, value: number, valueFormat?: NumberFormat): void {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n const valueSize = pins.sizeOf(valueFormat);\n const buf = control.createBuffer(1 + valueSize);\n buf.setNumber(NumberFormat.UInt8LE, 0, register);\n buf.setNumber(valueFormat, 1, value);\n pins.i2cWriteBuffer(address, buf);\n }\n\n /**\n * Read the value from a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-read-register\n //% blockId=i2c_readreg block=\"i2c read register|at address $address|at register $register\"\n export function i2cReadRegister(address: number, register: number, valueFormat?: NumberFormat): number {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n pins.i2cWriteNumber(address, register, NumberFormat.UInt8LE);\n return pins.i2cReadNumber(address, valueFormat);\n }\n\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //%\n export function i2cReadBuffer(address: number, size: number, repeat: boolean = false): Buffer {\n return pins.i2c().readBuffer(address, size, repeat);\n }\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //%\n export function i2cWriteBuffer(address: number, buf: Buffer, repeat: boolean = false): number {\n return pins.i2c().writeBuffer(address, buf, repeat);\n }\n\n let _i2c: I2C;\n /**\n * Gets the default I2C bus\n */\n //%\n export function i2c(): I2C {\n if (!_i2c) {\n const sda = pins.pinByCfg(DAL.CFG_PIN_SDA);\n const scl = pins.pinByCfg(DAL.CFG_PIN_SCL);\n _i2c = pins.createI2C(sda, scl); \n }\n return _i2c; \n }\n\n export class I2CDevice {\n public address: number;\n public bus: I2C;\n private _hasError: boolean;\n constructor(address: number, bus?: I2C) {\n this.address = address;\n this.bus = bus || i2c();\n }\n public readInto(buf: Buffer, repeat = false, start = 0, end: number = null) {\n if (end === null)\n end = buf.length\n if (start >= end)\n return\n let res = this.bus.readBuffer(this.address, end - start, repeat)\n if (!res) {\n this._hasError = true\n return\n }\n buf.write(start, res)\n }\n public write(buf: Buffer, repeat = false) {\n let res = this.bus.writeBuffer(this.address, buf, repeat)\n if (res) {\n this._hasError = true\n }\n }\n public begin(): I2CDevice {\n this._hasError = false;\n return this;\n }\n public end() {\n }\n public ok() {\n return !this._hasError\n }\n\n public transfer(command: Buffer, response: Buffer, responseStart?: number, responseEnd?: number) {\n this.begin();\n if (command)\n this.write(command);\n if (response)\n this.readInto(response, false, responseStart, responseEnd);\n this.end();\n } \n }\n}\n",
"keyvaluestorage.cpp": "#include \"pxt.h\"\n#include \"KeyValueStorage.h\"\n\nnamespace pxt {\n\nclass WKeyValueStorage {\n#ifdef CODAL_NVMCONTROLLER\n CODAL_NVMCONTROLLER controller;\n#else\n NVMController controller;\n#endif\n KeyValueStorage storage;\n public:\n\n WKeyValueStorage()\n : controller()\n , storage(controller) {\n }\n\n bool isSupported() {\n#ifdef CODAL_NVMCONTROLLER\n return true;\n#else\n return false;\n#endif\n }\n\n int put(String key, Buffer data) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n return storage.put(mkey, data->data, data->length);\n#else\n return -1;\n#endif\n }\n\n Buffer get(String key) {\n#ifdef CODAL_NVMCONTROLLER\n Buffer buf = NULL;\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n auto entry = storage.get(mkey);\n if (entry) {\n buf = mkBuffer(entry->value, sizeof(entry->value));\n free(entry);\n }\n return buf;\n#else\n return NULL;\n#endif\n }\n\n void remove(String key) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n storage.remove(mkey);\n#endif\n }\n\n void clear() {\n#ifdef CODAL_NVMCONTROLLER\n storage.wipe();\n#endif\n }\n};\nSINGLETON(WKeyValueStorage);\n\n}\n\nnamespace configStorage {\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //%\n void setBuffer(String key, Buffer value) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->put(key, value);\n }\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //%\n Buffer getBuffer(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n return kvm->get(key);\n }\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //%\n void removeItem(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->remove(key);\n }\n\n /**\n * Clears the local storage\n */\n //%\n void clear() {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->clear();\n }\n}\n",
"keyvaluestorage.ts": "namespace configStorage {\n /**\n * Stores the value at the key entry\n * @param key identifier of the key (max 16 characters)\n * @param value identifier of the value (max 32 characters)\n */\n export function setItem(key: string, value: string) {\n if (value == null)\n configStorage.removeItem(key);\n else\n {\n let idx = 0;\n let buf = control.createBuffer(value.length + 1);\n buf[idx++] = value.length;\n let valBuf = control.createBufferFromUTF8(value);\n\n for (let i = 0; i < valBuf.length; i++)\n buf[idx++] = valBuf[i];\n\n configStorage.setBuffer(key, buf);\n }\n }\n\n /**\n * Retrieves the value at the key entry\n * @param key identifier of the key (max 16 characters)\n */\n export function getItem(key: string): string {\n const buf = configStorage.getBuffer(key);\n\n if (!buf)\n return undefined;\n\n let idx = 0;\n let count = buf[idx++];\n const retBuf = control.createBuffer(count);\n\n for (let i = 0; i < count; i++)\n retBuf[i] = buf[idx++];\n\n return retBuf.toString();\n }\n}\n",
"leveldetector.ts": "namespace pins {\n export class LevelDetector {\n public id: number;\n public min: number;\n public max: number;\n public lowThreshold: number;\n public highThreshold: number;\n private transition: number;\n private transitionMs: number;\n private _level: number;\n private _state: number;\n public onHigh: () => void;\n public onLow: () => void;\n public onNeutral: () => void;\n public transitionWindow: number;\n // minimum duration (ms) between events\n public transitionInterval: number;\n\n static LEVEL_THRESHOLD_NEUTRAL = 0;\n\n constructor(id: number,\n min: number, max: number,\n lowThreshold: number, highThreshold: number) {\n this.id = id;\n this.min = min;\n this.max = max;\n this.lowThreshold = lowThreshold;\n this.highThreshold = highThreshold;\n this.transitionWindow = 4;\n this.transitionInterval = 0;\n\n this.onHigh = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_HIGH);\n this.onLow = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_LOW);\n this.onNeutral = undefined;\n\n this.reset();\n }\n\n reset() {\n this.transition = 0;\n this.transitionMs = 0;\n this._level = Math.ceil((this.highThreshold - this.lowThreshold) / 2);\n this._state = LevelDetector.LEVEL_THRESHOLD_NEUTRAL;\n }\n\n get level(): number {\n return this._level;\n }\n\n set level(level: number) {\n this._level = this.clampValue(level);\n\n if (this._level >= this.highThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_HIGH);\n }\n else if (this._level <= this.lowThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_LOW);\n }\n else {\n this.setState(LevelDetector.LEVEL_THRESHOLD_NEUTRAL);\n }\n }\n\n public setLowThreshold(value: number) {\n this.lowThreshold = this.clampValue(value);\n this.reset();\n }\n\n public setHighThreshold(value: number) {\n this.highThreshold = this.clampValue(value);\n this.reset();\n }\n\n private clampValue(value: number) {\n if (value < this.min) {\n return this.min;\n }\n else if (value > this.max) {\n return this.max;\n }\n return value;\n }\n\n private setState(state: number) {\n // not enough samples to change\n if (this._state === state \n || (this.transition++ < this.transitionWindow)\n || (control.millis() - this.transitionMs) < this.transitionInterval) {\n return;\n }\n\n this.transition = 0;\n this.transitionMs = control.millis();\n this._state = state;\n switch (state) {\n case DAL.LEVEL_THRESHOLD_HIGH:\n if (this.onHigh) this.onHigh();\n break;\n case DAL.LEVEL_THRESHOLD_LOW:\n if (this.onLow) this.onLow();\n break;\n case LevelDetector.LEVEL_THRESHOLD_NEUTRAL:\n if (this.onNeutral) this.onNeutral();\n break;\n }\n }\n }\n}",
"light.cpp": "#include \"light.h\"\n\n// WS2812B timings, datasheet v1\n// 0 - 0.25-0.55us hi 0.70-1.00us low\n// 1 - 0.65-0.95us hi 0.30-0.60us low\n// datasheet v5\n// 0 - 0.22-0.38us hi 0.58-1.00us low 1-3\n// 1 - 0.58-1.00us hi 0.58-1.00us low 3-2\n\n#define SPI_SUPPORTED 1\n\n#if defined(NRF52_SERIES)\n#define BIT_EXPANSION 5\n#define SPI_FREQ 4000000\n#else\n#define BIT_EXPANSION 3\n#define SPI_FREQ 2400000\n#endif\n\n#if defined(SAMD21) || defined(SAMD51) || defined(STM32F4) || defined(NRF52_SERIES)\n#include \"neopixel.h\"\n#define BITBANG_SUPPORTED 1\n#else\n#define BITBANG_SUPPORTED 0\n#endif\n\n#define NEOPIXEL_MIN_LENGTH_FOR_SPI 24\n#define DOTSTAR_MIN_LENGTH_FOR_SPI 24\n\n#define LIGHTMODE_RGB 1\n#define LIGHTMODE_RGBW 2\n#define LIGHTMODE_RGB_RGB 3\n#define LIGHTMODE_DOTSTAR 4\n\nnamespace light {\nbool isValidMOSIPin(DigitalInOutPin pin) {\n if (!pin)\n return false;\n\n#if SAMD51\n return ZSPI::isValidMOSIPin(*pin);\n#elif defined(NRF52_SERIES)\n return true;\n#else\n // TODO: support for SPI neopixels\n // default SPI pins supported for now\n return pin == LOOKUP_PIN(MOSI);\n#endif\n}\n\n// SPI\nvoid spiNeopixelSendBuffer(DevicePin *pin, const uint8_t *data, unsigned size) {\n int32_t iptr = 0, optr = 120;\n uint32_t len = optr + size * BIT_EXPANSION + 120;\n uint8_t *expBuf = new uint8_t[len];\n memset(expBuf, 0, len);\n uint8_t imask = 0x80;\n uint8_t omask = 0x80;\n\n#define WR(k) \\\n if (k) \\\n expBuf[optr] |= omask; \\\n omask >>= 1; \\\n if (!omask) { \\\n omask = 0x80; \\\n optr++; \\\n }\n\n while (iptr < (int)size) {\n#if BIT_EXPANSION == 3\n WR(1);\n WR(data[iptr] & imask);\n WR(0);\n#elif BIT_EXPANSION == 5\n WR(1);\n if (data[iptr] & imask) {\n WR(1);\n WR(1);\n } else {\n WR(0);\n }\n WR(0);\n WR(0);\n#else\n#error \"invalid BIT_EXPANSION\"\n#endif\n\n imask >>= 1;\n if (!imask) {\n imask = 0x80;\n iptr++;\n }\n }\n\n auto spi = pxt::getSPI(pin, NULL, NULL);\n spi->setFrequency(SPI_FREQ);\n spi->transfer(expBuf, len, NULL, 0);\n delete expBuf;\n}\n\nvoid neopixelSendData(DevicePin *pin, int mode, const uint8_t *data, unsigned length) {\n if (!pin || !length)\n return;\n\n#if BITBANG_SUPPORTED\n if (SPI_SUPPORTED && length > NEOPIXEL_MIN_LENGTH_FOR_SPI && isValidMOSIPin(pin))\n spiNeopixelSendBuffer(pin, data, length);\n else\n neopixel_send_buffer(*pin, data, length);\n#else\n if (isValidMOSIPin(pin)) {\n spiNeopixelSendBuffer(pin, data, length);\n }\n#endif\n}\n\nvoid bitBangDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n // first frame of zeroes\n data->setDigitalValue(0);\n for (unsigned i = 0; i < 32; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n\n // data stream\n for (unsigned i = 0; i < length; ++i) {\n auto x = buf[i];\n for (uint8_t j = 0x80; j != 0; j >>= 1) {\n data->setDigitalValue(x & j ? 1 : 0);\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n }\n // https://cpldcpu.wordpress.com/2016/12/13/sk9822-a-clone-of-the-apa102/\n // reset frame\n // data->setDigitalValue(0);\n // for (unsigned i = 0; i < 32 ; ++i) {\n // clk->setDigitalValue(1);\n // clk->setDigitalValue(0);\n //}\n\n // https://cpldcpu.wordpress.com/2014/11/30/understanding-the-apa102-superled/\n data->setDigitalValue(1);\n unsigned n = 32;\n for (unsigned i = 0; i < n; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n}\n\nstatic uint8_t ZERO_FRAME[4];\nstatic uint8_t ONE_FRAME[] = {1, 1, 1, 1};\nvoid spiDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n auto spi = pxt::getSPI(data, NULL, clk);\n\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // initial frame\n spi->transfer(buf, length, NULL, 0);\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // reset frame\n for (unsigned i = 0; i < (length >> 3); i += 32)\n spi->transfer(ONE_FRAME, sizeof(ONE_FRAME), NULL, 0); // final frame\n}\n\nvoid dotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n if (!data || !clk || !buf || !length)\n return;\n\n if (length > DOTSTAR_MIN_LENGTH_FOR_SPI && isValidMOSIPin(data))\n spiDotStarSendData(data, clk, mode, buf, length);\n else\n bitBangDotStarSendData(data, clk, mode, buf, length);\n}\n\nvoid sendBuffer(DevicePin *data, DevicePin *clk, int mode, Buffer buf) {\n if (!data || !buf || !buf->length)\n return;\n\n if (mode == LIGHTMODE_DOTSTAR)\n light::dotStarSendData(data, clk, mode, buf->data, buf->length);\n else\n light::neopixelSendData(data, mode, buf->data, buf->length);\n}\n\nvoid clear() {\n auto neopix = LOOKUP_PIN(NEOPIXEL);\n auto neonum = getConfig(CFG_NUM_NEOPIXELS, 0);\n if (neopix && neonum >= 0) {\n auto n = 3 * neonum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n light::neopixelSendData(neopix, 0x100, off, sizeof(off));\n }\n\n auto data = LOOKUP_PIN(DOTSTAR_DATA);\n auto clk = LOOKUP_PIN(DOTSTAR_CLOCK);\n auto dsnum = getConfig(CFG_NUM_DOTSTARS, 0);\n if (data && clk && dsnum > 0) {\n auto n = 4 * dsnum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n for (int i = 0; i < n; i += 4)\n off[i] = 0xe0;\n bitBangDotStarSendData(data, clk, 0x100, off, sizeof(off));\n }\n}\n\n} // namespace light\n",
"light.h": "#ifndef __PXT_LIGHT_H\n#define __PXT_LIGHT_H\n\n#include \"pxt.h\"\n\nnamespace light {\n /**\n * Clear onboard neopixels\n */\n void clear();\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //%\n void sendBuffer(DigitalInOutPin data, DigitalInOutPin clk, int mode, Buffer buf);\n\n void neopixelSendData(DevicePin* pin, int mode, const uint8_t* data, unsigned length);\n}\n\n#endif",
"ns.ts": "/**\n * Events and data from sensors.\n */\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\n//% groups='[\"other\", \"More\"]'\nnamespace input {\n}\n\n/**\n * Servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\"\nnamespace servos {\n\n}\n\n/**\n * A Joint Asynchronous Communications, Device Agnostic Control.\n */\n//% color=\"#E79251\" weight=1 icon=\"\\uf185\"\n//% groups='[\"Broadcast\", \"Console\", \"Control\"]'\n//% blockGap=8\nnamespace jacdac {\n\n}",
"pins.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\nstatic DevicePin **pinPtrs;\nstatic uint8_t numPinPtrs;\nstatic uint8_t pinPos[DEV_NUM_PINS];\n\n//%\nDevicePin *getPin(int id) {\n\n id &= CFG_PIN_NAME_MSK;\n\n if (id >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n\n // we could use lookupComponent() here - it would be slightly slower\n\n int ptr = pinPos[id];\n if (ptr == 0) {\n pinPtrs = (DevicePin **)realloc(pinPtrs, (numPinPtrs + 1) * sizeof(void *));\n bool isAnalog = IS_ANALOG_PIN(id);\n // GCTODO\n pinPtrs[numPinPtrs++] =\n new DevicePin(DEVICE_ID_IO_P0 + id, (PinName)id,\n isAnalog ? PIN_CAPABILITY_AD : PIN_CAPABILITY_DIGITAL);\n ptr = numPinPtrs;\n pinPos[id] = ptr;\n }\n return pinPtrs[ptr - 1];\n}\n\n//%\nDevicePin *getPinCfg(int key) {\n int p = getConfig(key, -1);\n if (p == -1)\n DMESG(\"no pin cfg: %d\", key);\n return getPin(p);\n}\n\nvoid linkPin(int from, int to) {\n if (from < 0 || from >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n getPin(to);\n pinPos[from] = pinPos[to];\n}\n\n//%\nDevicePin *lookupPin(int pinName) {\n if (pinName < 0 || pinName == 0xff)\n return NULL;\n pinName &= CFG_PIN_NAME_MSK;\n return getPin(pinName);\n}\n\n//%\nDevicePin *lookupPinCfg(int key) {\n return lookupPin(getConfig(key));\n}\n\nCodalComponent *lookupComponent(int id) {\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; ++i) {\n if (CodalComponent::components[i] && CodalComponent::components[i]->id == id)\n return CodalComponent::components[i];\n }\n return NULL;\n}\n\n} // namespace pxt\n\nnamespace pins {\n/**\n* Get a pin by configuration id (DAL.CFG_PIN...)\n*/\n//%\nDigitalInOutPin pinByCfg(int key) {\n return pxt::lookupPinCfg(key);\n}\n\n/**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n//%\nBuffer createBuffer(int size) {\n return mkBuffer(NULL, size);\n}\n\n/**\n * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n//% help=pins/pulse-duration blockGap=8\n//% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n//% weight=19\nint pulseDuration() {\n return pxt::lastEvent.timestamp;\n}\n} // namespace pins\n",
"pins.h": "#ifndef __PXT_PINS_H\n#define __PXT_PINS_H\n\n#define BUTTON_ACTIVE_HIGH_PULL_DOWN (ACTIVE_HIGH | 0x10)\n#define BUTTON_ACTIVE_HIGH_PULL_UP (ACTIVE_HIGH | 0x20)\n#define BUTTON_ACTIVE_HIGH_PULL_NONE (ACTIVE_HIGH | 0x30)\n#define BUTTON_ACTIVE_LOW_PULL_DOWN (ACTIVE_LOW | 0x10)\n#define BUTTON_ACTIVE_LOW_PULL_UP (ACTIVE_LOW | 0x20)\n#define BUTTON_ACTIVE_LOW_PULL_NONE (ACTIVE_LOW | 0x30)\n\n#define PIN(name) ((PinName)pxt::getConfig(CFG_PIN_##name, -1))\n#define LOOKUP_PIN(name) pxt::lookupPin(PIN(name))\n\n// these can be overridden in platform.h\n#ifndef CODAL_PIN\n#define CODAL_PIN CODAL_MBED::Pin\n#endif\n\n#ifndef CODAL_TIMER\n#define CODAL_TIMER CODAL_MBED::Timer\n#endif\n\n#ifndef CODAL_SPI\n#define CODAL_SPI CODAL_MBED::SPI\n#endif\n\n#ifndef CODAL_SERIAL\n#define CODAL_SERIAL CODAL_MBED::Serial\n#endif\n\n#ifndef IS_ANALOG_PIN\n#define IS_ANALOG_PIN(id) ((DEV_ANALOG_PINS >> (id)) & 1)\n#endif\n\ntypedef CODAL_PIN DevicePin;\n\ntypedef DevicePin *DigitalInOutPin;\ntypedef DevicePin *AnalogInOutPin;\ntypedef DevicePin *AnalogInPin;\ntypedef DevicePin *AnalogOutPin;\ntypedef DevicePin *PwmPin;\ntypedef DevicePin *PwmOnlyPin;\ntypedef Button *Button_;\n\nnamespace pxt {\nDevicePin *getPin(int id);\nDevicePin *getPinCfg(int key);\nDevicePin *lookupPin(int pinName);\nDevicePin *lookupPinCfg(int key);\nvoid linkPin(int from, int to);\nCodalComponent *lookupComponent(int id);\n}\n\n#define PINOP(op) name->op\n\n#endif\n",
"pins.ts": "//% noRefCounting fixedInstances\ninterface DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogOutPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInOutPin extends AnalogInPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmOnlyPin extends DigitalInOutPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmPin extends PwmOnlyPin, AnalogInOutPin {\n}\n\n/**\n * Control currents in Pins for analog/digital signals, servos, i2c, ...\n */\n//% color=#A80000 weight=85 icon=\"\\uf140\" advanced=true\n//% groups='[\"other\", \"Servo\", \"i2c\"]'\nnamespace pins {\n}",
"pinsAnalog.cpp": "#include \"pxt.h\"\n\nnamespace AnalogInPinMethods {\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\n */\n//% help=pins/analog-read weight=53\n//% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nint analogRead(AnalogInPin name) {\n return PINOP(getAnalogValue());\n}\n}\n\nnamespace AnalogOutPinMethods {\nvoid analogWrite(AnalogOutPin name, int value) __attribute__ ((weak));\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\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n//% help=pins/analog-write weight=52\n//% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.min=0 value.max=1023\nvoid analogWrite(AnalogOutPin name, int value) {\n PINOP(setAnalogValue(value));\n}\n}",
"pinsDigital.cpp": "#include \"pxt.h\"\n\nenum class PulseValue {\n //% block=high\n High = DEVICE_PIN_EVT_PULSE_HI,\n //% block=low\n Low = DEVICE_PIN_EVT_PULSE_LO\n};\n\nenum class PinEvent {\n //% block=\"pulse high\"\n PulseHigh = DEVICE_PIN_EVT_PULSE_HI,\n //% block=\"pulse low\"\n PulseLow = DEVICE_PIN_EVT_PULSE_LO,\n //% block=\"rise\"\n Rise = DEVICE_PIN_EVT_RISE,\n //% block=\"fall\"\n Fall = DEVICE_PIN_EVT_FALL,\n};\n\nenum class PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2\n};\n\nnamespace DigitalInOutPinMethods {\n/**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n//% help=pins/digital-read weight=61\n//% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nbool digitalRead(DigitalInOutPin name) {\n return PINOP(getDigitalValue()) != 0;\n}\n\n/**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n//% help=pins/digital-write weight=60\n//% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid digitalWrite(DigitalInOutPin name, bool value) {\n PINOP(setDigitalValue(value));\n}\n\n/**\n* Make this pin a digital input, and create events where the timestamp is the duration\n* that this pin was either ``high`` or ``low``.\n*/\n//% help=pins/on-pulsed weight=16 blockGap=8\n//% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\n//% deprecated=1 hidden=1\nvoid onPulsed(DigitalInOutPin pin, PulseValue pulse, Action body) {\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)pulse, body);\n}\n\n/**\n* Register code to run when a pin event occurs. \n*/\n//% help=pins/on-event weight=20 blockGap=8\n//% blockId=pinsonevent block=\"on|pin %pin|%event\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nvoid onEvent(DigitalInOutPin pin, PinEvent event, Action body) {\n switch(event) {\n case PinEvent::PulseHigh:\n case PinEvent::PulseLow:\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)event, body);\n break;\n case PinEvent::Rise:\n case PinEvent::Fall:\n pin->eventOn(DEVICE_PIN_EVENT_ON_EDGE);\n registerWithDal(pin->id, (int)event, body);\n break; \n } \n}\n\n/**\n* Return the duration of a pulse in microseconds\n* @param name the pin which measures the pulse\n* @param value the value of the pulse (default high)\n* @param maximum duration in micro-seconds\n*/\n//% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n//% weight=18 blockGap=8\n//% help=\"pins/pulse-in\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nint pulseIn(DigitalInOutPin pin, PulseValue value, int maxDuration = 2000000) {\n int pulse = PulseValue::High == value ? 1 : 0;\n uint64_t tick = system_timer_current_time_us();\n uint64_t maxd = (uint64_t)maxDuration;\n while (pin->getDigitalValue() != pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n\n uint64_t start = system_timer_current_time_us();\n while (pin->getDigitalValue() == pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n uint64_t end = system_timer_current_time_us();\n return end - start;\n}\n\n/**\n* Set the pull direction of this pin.\n* @param name pin to set the pull mode on\n* @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n*/\n//% help=pins/set-pull weight=17 blockGap=8\n//% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid setPull(DigitalInOutPin name, PinPullMode pull) {\n PullMode m = pull == PinPullMode::PullDown ? PullMode::Down : pull == PinPullMode::PullUp\n ? PullMode::Up\n : PullMode::None;\n PINOP(setPull(m));\n}\n\n}\n\n#ifdef PXT_CODAL\n\nnamespace pxt {\n\nstatic void waitABit() {\n // for (int i = 0; i < 10; ++i)\n // asm volatile(\"nop\");\n}\n\nclass ButtonMultiplexer : public CodalComponent {\n public:\n Pin &latch;\n Pin &clock;\n Pin &data;\n uint32_t state;\n uint32_t invMask;\n uint16_t buttonIdPerBit[8];\n bool enabled;\n\n ButtonMultiplexer(uint16_t id)\n : latch(*LOOKUP_PIN(BTNMX_LATCH)), clock(*LOOKUP_PIN(BTNMX_CLOCK)),\n data(*LOOKUP_PIN(BTNMX_DATA)) {\n this->id = id;\n this->status |= DEVICE_COMPONENT_STATUS_SYSTEM_TICK;\n\n state = 0;\n invMask = 0;\n enabled = true;\n\n memset(buttonIdPerBit, 0, sizeof(buttonIdPerBit));\n\n data.getDigitalValue(PullMode::Down);\n latch.setDigitalValue(1);\n clock.setDigitalValue(1);\n }\n\n void disable() {\n data.getDigitalValue(PullMode::None);\n latch.getDigitalValue(PullMode::None);\n clock.getDigitalValue(PullMode::None);\n enabled = false;\n }\n\n bool isButtonPressed(int id) {\n for (int i = 0; i < 8; ++i) {\n if (buttonIdPerBit[i] == id)\n return (state & (1 << i)) != 0;\n }\n return false;\n }\n\n uint32_t readBits(int bits) {\n latch.setDigitalValue(0);\n waitABit();\n latch.setDigitalValue(1);\n waitABit();\n\n uint32_t state = 0;\n for (int i = 0; i < bits; i++) {\n state <<= 1;\n if (data.getDigitalValue(PullMode::Down))\n state |= 1;\n\n clock.setDigitalValue(0);\n waitABit();\n clock.setDigitalValue(1);\n waitABit();\n }\n\n return state;\n }\n\n virtual void periodicCallback() override {\n if (!enabled)\n return;\n\n uint32_t newState = readBits(8);\n newState ^= invMask;\n if (newState == state)\n return;\n\n for (int i = 0; i < 8; ++i) {\n uint32_t mask = 1 << i;\n if (!buttonIdPerBit[i])\n continue;\n int ev = 0;\n if (!(state & mask) && (newState & mask))\n ev = PXT_INTERNAL_KEY_DOWN;\n else if ((state & mask) && !(newState & mask))\n ev = PXT_INTERNAL_KEY_UP;\n if (ev) {\n Event(ev, buttonIdPerBit[i]);\n Event(ev, 0); // any key\n }\n }\n\n state = newState;\n }\n};\n\nstatic ButtonMultiplexer *btnMultiplexer;\nButtonMultiplexer *getMultiplexer() {\n if (!btnMultiplexer)\n btnMultiplexer = new ButtonMultiplexer(DEVICE_ID_FIRST_BUTTON);\n return btnMultiplexer;\n}\n\nint registerMultiplexedButton(int pin, int buttonId) {\n if (1050 <= pin && pin < 1058) {\n pin -= 50;\n getMultiplexer()->invMask |= 1 << (pin - 1000);\n }\n if (1000 <= pin && pin < 1008) {\n getMultiplexer()->buttonIdPerBit[pin - 1000] = buttonId;\n return 1;\n }\n return 0;\n}\n\nint multiplexedButtonIsPressed(int btnId) {\n if (btnMultiplexer)\n return btnMultiplexer->isButtonPressed(btnId) ? 512 : 0;\n return 0;\n}\n\n//% expose\nuint32_t readButtonMultiplexer(int bits) {\n if (!LOOKUP_PIN(BTNMX_CLOCK))\n return 0;\n return getMultiplexer()->readBits(bits);\n}\n\nvoid disableButtonMultiplexer() {\n if (LOOKUP_PIN(BTNMX_CLOCK)) {\n getMultiplexer()->disable();\n }\n}\n\n}\n\n#endif\n",
"pinsPWM.cpp": "#include \"pxt.h\"\n\nnamespace PwmPinMethods {\n}\n\nnamespace PwmOnlyPinMethods {\n\n/**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n//% help=pins/analog-set-period weight=51\n//% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid analogSetPeriod(PwmOnlyPin name, int period) {\n PINOP(setAnalogPeriodUs(period));\n}\n\n/**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n//% help=pins/servo-write weight=41 group=\"Servo\"\n//% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n//% parts=microservo trackArgs=0\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.defl=90\nvoid servoWrite(PwmOnlyPin name, int value) {\n PINOP(setServoValue(value));\n}\n\n/**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n//% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n//% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n//% parts=microservo blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid servoSetPulse(PwmOnlyPin name, int duration) {\n PINOP(setServoPulseUs(duration));\n}\n\n/**\n* Indicates if the servo is running continuously\n*/\n//% blockHidden=1\nvoid servoSetContinuous(PwmOnlyPin name, bool continuous) {\n // used by simulator\n}\n\n}",
"pinscompat.ts": "// filled in by microbit",
"platform.cpp": "#include \"pxt.h\"\n\n#include \"NRFLowLevelTimer.h\"\n\nnamespace pxt {\n\nstruct TimerConfig {\n uint8_t id;\n IRQn_Type irqn;\n NRF_TIMER_Type *addr;\n};\n\n#define DEF_TIM(n) \\\n { 0x10 + n, TIMER##n##_IRQn, NRF_TIMER##n }\n\nstatic const TimerConfig timers[] = {\n#ifdef NRF_TIMER0\n DEF_TIM(0),\n#endif\n#ifdef NRF_TIMER1\n DEF_TIM(1),\n#endif\n#ifdef NRF_TIMER2\n DEF_TIM(2),\n#endif\n#ifdef NRF_TIMER3\n DEF_TIM(3),\n#endif\n#ifdef NRF_TIMER4\n DEF_TIM(4),\n#endif\n#ifdef NRF_TIMER5\n DEF_TIM(5),\n#endif\n#ifdef NRF_TIMER6\n DEF_TIM(6),\n#endif\n {0, (IRQn_Type)0, 0}};\n\n#define DEF_TIMERS 0x11121013 // TIMER1 TIMER2 TIMER0 TIMER3\n\nstatic uint32_t usedTimers;\nstatic int timerIdx(uint8_t id) {\n for (unsigned i = 0; timers[i].id; i++) {\n if (id == timers[i].id)\n return i;\n }\n return -1;\n}\nLowLevelTimer *allocateTimer() {\n uint32_t timersToUse = getConfig(CFG_TIMERS_TO_USE, DEF_TIMERS);\n for (int shift = 24; shift >= 0; shift -= 8) {\n uint8_t tcId = (timersToUse >> shift) & 0xff;\n int idx = timerIdx(tcId);\n if (idx < 0 || (usedTimers & (1 << idx)))\n continue;\n auto dev = timers[idx].addr;\n if (dev->INTENSET) // any irqs enabled?\n continue; // then we won't allocate it\n usedTimers |= 1 << idx;\n DMESG(\"allocate TIMER%d\", tcId - 0x10);\n return new NRFLowLevelTimer(dev, timers[idx].irqn);\n }\n\n soft_panic(PANIC_OUT_OF_TIMERS);\n return NULL;\n}\n\nstatic void initRandomSeed() {\n int seed = 0xC0DA1;\n /*\n auto pinTemp = LOOKUP_PIN(TEMPERATURE);\n if (pinTemp)\n seed *= pinTemp->getAnalogValue();\n auto pinLight = LOOKUP_PIN(LIGHT);\n if (pinLight)\n seed *= pinLight->getAnalogValue();\n */\n seedRandom(seed);\n}\n\n#if defined(NRF52840) || defined(NRF52833)\n#define IS_3_3_V() ((NRF_UICR->REGOUT0 & 7) == 5)\n#else\n#define IS_3_3_V() 1\n#endif\n\nstatic void disableNFConPins() {\n // Ensure NFC pins are configured as GPIO. If not, update the non-volatile UICR.\n if (NRF_UICR->NFCPINS || !IS_3_3_V()) {\n DMESG(\"RESET UICR\\n\");\n // Enable Flash Writes\n NRF_NVMC->CONFIG = (NVMC_CONFIG_WEN_Wen << NVMC_CONFIG_WEN_Pos);\n while (NRF_NVMC->READY == NVMC_READY_READY_Busy)\n ;\n\n // Configure PINS for GPIO use.\n if (NRF_UICR->NFCPINS)\n NRF_UICR->NFCPINS = 0;\n\n#if defined(NRF52840) || defined(NRF52833)\n // Set VDD to 3.3V\n if ((NRF_UICR->REGOUT0 & 7) != 5)\n NRF_UICR->REGOUT0 = (NRF_UICR->REGOUT0 & ~7) | 5;\n#endif\n\n // Disable Flash Writes\n NRF_NVMC->CONFIG = (NVMC_CONFIG_WEN_Ren << NVMC_CONFIG_WEN_Pos);\n while (NRF_NVMC->READY == NVMC_READY_READY_Busy)\n ;\n\n // Reset, so the changes can take effect.\n NVIC_SystemReset();\n }\n}\n\nvoid deepSleep() {\n NRF_POWER->SYSTEMOFF = 1;\n}\n\nvoid platform_init() {\n initRandomSeed();\n\n disableNFConPins(); // this is needed when P0_9 and P0_10 are to be used as regular pins\n\n /*\n if (*HF2_DBG_MAGIC_PTR == HF2_DBG_MAGIC_START) {\n *HF2_DBG_MAGIC_PTR = 0;\n // this will cause alignment fault at the first breakpoint\n globals[0] = (TValue)1;\n }\n */\n}\n\nint *getBootloaderConfigData() {\n#ifdef NRF52840\n auto p = (volatile uint32_t *)0x000fd800;\n if (p[0] == CFG_MAGIC0 && p[1] == CFG_MAGIC1)\n return (int *)p + 4;\n#endif\n\n return NULL;\n}\n\n} // namespace pxt\n\nvoid cpu_clock_init() {\n // missing in Codal\n}\n",
"platform.h": "#ifndef __PXT_PLATFORM_H\n#define __PXT_PLATFORM_H\n\n#include \"Image.h\"\n#include \"NRF52SPI.h\"\n#include \"NRF52I2C.h\"\n#include \"NRF52Pin.h\"\n#include \"NRF52PWM.h\"\n#include \"NRF52Serial.h\"\n#include \"NRF52PDM.h\"\n#include \"Timer.h\"\n#include \"MultiButton.h\"\n\n#define PAGE_SIZE 4096\n#define MIC_DEVICE NRF52PDM\n\n#if defined(NRF52840) || defined(NRF52833)\n#define DEV_NUM_PINS 48\n#else\n#define DEV_NUM_PINS 32\n#endif\n\n#define DEV_PWM_PINS 0x0000ffffffffULL // all pins are PWM pins it seems\n#define DEV_AIN_PINS 0x0000f000001fULL\n\n// Codal doesn't yet distinguish between PWM and AIN\n#define DEV_ANALOG_PINS (DEV_PWM_PINS | DEV_AIN_PINS)\n\n#define CODAL_PIN NRF52Pin\n#define CODAL_SPI NRF52SPI\n#define CODAL_I2C NRF52I2C\n#define CODAL_TIMER Timer\n#define CODAL_SERIAL NRF52Serial\n\n#define IMAGE_BITS 4\n\ntypedef uint8_t PinName;\n\n#define DEFAULT_NEOPIXEL_PIN P0_0\n\n// The parameters below needs tuning!\n\n/*\n * @param nominalValue The value (in SI units) of a nominal position.\n * @param nominalReading The raw reading from the sensor at the nominal position.\n * @param beta The Steinhart-Hart Beta constant for the device\n * @param seriesResistor The value (in ohms) of the resistor in series with the sensor.\n * @param zeroOffset Optional zero offset applied to all SI units (e.g. 273.15 for temperature\n * sensing in C vs Kelvin).\n */\n\n#define TEMPERATURE_NOMINAL_VALUE 25\n#define TEMPERATURE_NOMINAL_READING 10000\n#define TEMPERATURE_BETA 3380\n#define TEMPERATURE_SERIES_RESISTOR 10000\n#define TEMPERATURE_ZERO_OFFSET 273.5\n\n#define LIGHTSENSOR_SENSITIVITY 868 // codal has 912 now\n#define LIGHTSENSOR_LOW_THRESHOLD 128\n#define LIGHTSENSOR_HIGH_THRESHOLD 896\n\n\n#define P0_0 0\n#define P0_1 1\n#define P0_2 2\n#define P0_3 3\n#define P0_4 4\n#define P0_5 5\n#define P0_6 6\n#define P0_7 7\n#define P0_8 8\n#define P0_9 9\n#define P0_10 10\n#define P0_11 11\n#define P0_12 12\n#define P0_13 13\n#define P0_14 14\n#define P0_15 15\n#define P0_16 16\n#define P0_17 17\n#define P0_18 18\n#define P0_19 19\n#define P0_20 20\n#define P0_21 21\n#define P0_22 22\n#define P0_23 23\n#define P0_24 24\n#define P0_25 25\n#define P0_26 26\n#define P0_27 27\n#define P0_28 28\n#define P0_29 29\n#define P0_30 30\n#define P0_31 31\n#define P1_0 32\n#define P1_1 33\n#define P1_2 34\n#define P1_3 35\n#define P1_4 36\n#define P1_5 37\n#define P1_6 38\n#define P1_7 39\n#define P1_8 40\n#define P1_9 41\n#define P1_10 42\n#define P1_11 43\n#define P1_12 44\n#define P1_13 45\n#define P1_14 46\n#define P1_15 47\n#define P1_16 48\n#define P1_17 49\n#define P1_18 50\n#define P1_19 51\n#define P1_20 52\n#define P1_21 53\n#define P1_22 54\n#define P1_23 55\n#define P1_24 56\n#define P1_25 57\n#define P1_26 58\n#define P1_27 59\n#define P1_28 60\n#define P1_29 61\n#define P1_30 62\n#define P1_31 63\n\n#endif\n",
"pxt.h": "#ifndef __PXT_H\n#define __PXT_H\n\n#include \"pxtbase.h\"\n\n#include \"CodalConfig.h\"\n#include \"CodalHeapAllocator.h\"\n#include \"CodalDevice.h\"\n#include \"CodalDmesg.h\"\n#include \"ErrorNo.h\"\n#include \"Timer.h\"\n#include \"Matrix4.h\"\n#include \"CodalCompat.h\"\n#include \"CodalComponent.h\"\n#include \"ManagedType.h\"\n#include \"Event.h\"\n#include \"NotifyEvents.h\"\n#include \"Button.h\"\n#include \"CodalFiber.h\"\n#include \"MessageBus.h\"\n#include \"MultiButton.h\"\n\nusing namespace codal;\n\n// codal::ManagedString compat\n#define MSTR(s) codal::ManagedString((s)->data, (s)->length)\n#define PSTR(s) mkString((s).toCharArray(), (s).length())\n\n#include \"pins.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"hf2.h\"\n#include \"hf2dbg.h\"\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n#include \"HIDMouse.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n#include \"HIDKeyboard.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n#include \"HIDJoystick.h\"\n#endif\n#endif\n\n#define PXT_COMM_BASE 0x20002000 // 8k in\n\nnamespace pxt {\n\n#if CONFIG_ENABLED(DEVICE_USB)\nextern CodalUSB usb;\nextern HF2 hf2;\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nextern USBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nextern USBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nextern USBHIDJoystick joystick;\n#endif\n#endif\n\n// Utility functions\nextern Event lastEvent;\nextern CODAL_TIMER devTimer;\nextern MessageBus devMessageBus;\nextern codal::CodalDevice device;\n\nvoid set_usb_strings(const char *uf2_info);\nextern void (*logJDFrame)(const uint8_t *data);\nextern void (*sendJDFrame)(const uint8_t *data);\n\nstatic inline void raiseEvent(int src, int val) {\n Event(src, val);\n}\n\n} // namespace pxt\n\nnamespace pins {\nclass CodalSPIProxy;\nclass CodalI2CProxy;\n} // namespace pins\n\ntypedef pins::CodalI2CProxy* I2C_;\ntypedef pins::CodalSPIProxy* SPI_;\n\nnamespace pxt {\ncodal::LowLevelTimer *allocateTimer();\n\n#ifdef CODAL_I2C\nCODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl);\n#endif\nCODAL_SPI* getSPI(DigitalInOutPin mosi, DigitalInOutPin miso, DigitalInOutPin sck);\n#ifdef CODAL_JACDAC_WIRE_SERIAL\nLowLevelTimer* getJACDACTimer();\n#endif\nclass PressureButton;\nuint32_t readButtonMultiplexer(int bits);\nvoid disableButtonMultiplexer();\n}\n\nnamespace serial {\nclass CodalSerialDeviceProxy;\n}\n\ntypedef serial::CodalSerialDeviceProxy* SerialDevice;\n\nnamespace jacdac {\nclass JDProxyDriver;\n} // namespace network\n\ntypedef jacdac::JDProxyDriver* JacDacDriverStatus;\n\n#define DEVICE_ID_BUTTON_SLIDE 3000\n#define DEVICE_ID_MICROPHONE 3001\n#define DEVICE_ID_FIRST_BUTTON 4000\n#define DEVICE_ID_FIRST_TOUCHBUTTON 4100\n\n#define PXT_INTERNAL_KEY_UP 2050\n#define PXT_INTERNAL_KEY_DOWN 2051\n\n#endif\n",
"pxt.json": "{\n \"name\": \"core---nrf52\",\n \"description\": \"The core library for Codal-based targets\",\n \"dependencies\": {\n \"base\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"dal.d.ts\",\n \"codal.cpp\",\n \"usb.cpp\",\n \"pxt.h\",\n \"platform.h\",\n \"platform.cpp\",\n \"pxtcore.h\",\n \"pins.h\",\n \"pins.cpp\",\n \"pinsAnalog.cpp\",\n \"pinsDigital.cpp\",\n \"pinsPWM.cpp\",\n \"pins.ts\",\n \"pinscompat.ts\",\n \"control.cpp\",\n \"i2c.cpp\",\n \"i2c.ts\",\n \"spi.cpp\",\n \"spi.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"hf2.cpp\",\n \"hf2.h\",\n \"hf2dbg.h\",\n \"uf2format.h\",\n \"uf2hid.h\",\n \"ns.ts\",\n \"dmac.cpp\",\n \"dmac.h\",\n \"timer.ts\",\n \"light.cpp\",\n \"light.h\",\n \"keyvaluestorage.cpp\",\n \"keyvaluestorage.ts\",\n \"leveldetector.ts\",\n \"pxtparts.json\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"cppDependencies\": {\n \"accelerometer\": \"file:../accelerometer\",\n \"buttons\": \"file:../buttons\",\n \"light\": \"file:../light\",\n \"lightsensor\": \"file:../lightsensor\",\n \"screen---st7735\": \"file:../screen---st7735\",\n \"switch\": \"file:../switch\",\n \"thermometer\": \"file:../thermometer\",\n \"lcd\": \"file:../lcd\",\n \"mixer---nrf52\": \"file:../mixer---nrf52\"\n },\n \"yotta\": {\n \"config\": {\n \"codal\": {\n \"component_count\": 64,\n \"dmesg_buffer_size\": 1024\n }\n }\n },\n \"dalDTS\": {\n \"includeDirs\": [\n \"libraries/codal-core/inc\",\n \"pxtapp\"\n ],\n \"excludePrefix\": [\n \"JD_\",\n \"USB_\",\n \"REQUEST_\",\n \"LIS3DH_\",\n \"FXOS8700_\",\n \"HF2_\",\n \"PXT_REF_TAG_\",\n \"MS_\",\n \"SCSI_\",\n \"MAG_\",\n \"MAG3\",\n \"MPU6\",\n \"MADCTL\",\n \"MMA8\"\n ]\n }\n}\n",
"pxtcore.h": "#ifndef __PXTCORE_H\n#define __PXTCORE_H\n\n#include \"CodalDmesg.h\"\n#include \"CodalHeapAllocator.h\"\n\n#define PXT_CODAL 1\n\n#define itoa(a, b) codal::itoa(a, b)\n\n#define GC_GET_HEAP_SIZE() device_heap_size(0)\n#define GC_STACK_BASE DEVICE_STACK_BASE\n#define xmalloc device_malloc\n#define xfree device_free\n\n// on most devices we allocate the entire heap at once, so large allocs should work\n// if they don't you just get the regular out of memory instead of alloc too large\n#define GC_MAX_ALLOC_SIZE (128 * 1024)\n\n#endif\n",
"pxtparts.json": "{\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\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createStrip,light.createNeoPixelStrip\",\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 \"dotstar\": {\n \"simulationBehavior\": \"dotstar\",\n \"visual\": {\n \"builtIn\": \"dotstar\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 1\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createAPA102Strip\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"dataPin\"\n },\n {\n \"pinInstantiationIdx\": 1,\n \"partParameter\": \"clkPin\"\n },\n {\n \"partParameter\": \"mode\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n },\n \"pixels\": {\n \"simulationBehavior\": \"pixels\",\n \"visual\": { \n \"builtIn\": \"pixels\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"MOSI\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"SCK\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\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, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n }, \n \"buttons\": {\n \"simulationBehavior\": \"buttons\",\n \"visual\": {\n \"builtIn\": \"buttons\",\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 },\n \"numberOfPins\": 2,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"Button.onEvent,Button.isPressed,Button.wasPressed\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"button\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n }\n ]\n },\n \"slideswitch\": {\n \"numberOfPins\": 3,\n \"simulationBehavior\": \"slideswitch\",\n \"visual\": {\n \"builtIn\": \"slideswitch\",\n \"width\": 100,\n \"height\": 100,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 30,\n \"y\": 0\n },\n {\n \"x\": 45,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalRead,DigitalInOutPin.onPulsed,DigitalInOutPin.onEvent\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"pin\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\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 \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"PwmOnlyPin.servoWrite,servos.Servo.setAngle,servos.Servo.run,servos.Servo.setPulse\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\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 \"led\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"analogled\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogOutPin.analogWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"photocell\": {\n \"numberOfPins\": 3,\n \"visual\": {\n \"builtIn\": \"photocell\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 15,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"photocell\",\n \"pinDefinitions\": [\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogInPin.analogRead\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n }\n}",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace light {\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //% shim=light::sendBuffer\n function sendBuffer(data: DigitalInOutPin, clk: DigitalInOutPin, mode: int32, buf: Buffer): void;\n}\ndeclare namespace control {\n\n /**\n * Determines if the USB has been enumerated.\n */\n //% shim=control::isUSBInitialized\n function isUSBInitialized(): boolean;\n}\ndeclare namespace pins {\n\n /**\n * Get a pin by configuration id (DAL.CFG_PIN...)\n */\n //% shim=pins::pinByCfg\n function pinByCfg(key: int32): DigitalInOutPin;\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 * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n //% help=pins/pulse-duration blockGap=8\n //% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n //% weight=19 shim=pins::pulseDuration\n function pulseDuration(): int32;\n}\n\n\ndeclare interface AnalogInPin {\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\n */\n //% help=pins/analog-read weight=53\n //% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=AnalogInPinMethods::analogRead\n analogRead(): int32;\n}\n\n\ndeclare interface AnalogOutPin {\n /**\n * Set the connector value as analog. Value must be comprised between 0 and 1023.\n * @param name pin name to write to\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n //% help=pins/analog-write weight=52\n //% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.min=0 value.max=1023 shim=AnalogOutPinMethods::analogWrite\n analogWrite(value: int32): void;\n}\n\n\ndeclare interface DigitalInOutPin {\n /**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n //% help=pins/digital-read weight=61\n //% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalRead\n digitalRead(): boolean;\n\n /**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n //% help=pins/digital-write weight=60\n //% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalWrite\n digitalWrite(value: boolean): void;\n\n /**\n * Make this pin a digital input, and create events where the timestamp is the duration\n * that this pin was either ``high`` or ``low``.\n */\n //% help=pins/on-pulsed weight=16 blockGap=8\n //% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4\n //% deprecated=1 hidden=1 shim=DigitalInOutPinMethods::onPulsed\n onPulsed(pulse: PulseValue, body: () => void): void;\n\n /**\n * Register code to run when a pin event occurs. \n */\n //% help=pins/on-event weight=20 blockGap=8\n //% blockId=pinsonevent block=\"on|pin %pin|%event\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 shim=DigitalInOutPinMethods::onEvent\n onEvent(event: PinEvent, body: () => void): void;\n\n /**\n * Return the duration of a pulse in microseconds\n * @param name the pin which measures the pulse\n * @param value the value of the pulse (default high)\n * @param maximum duration in micro-seconds\n */\n //% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n //% weight=18 blockGap=8\n //% help=\"pins/pulse-in\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 maxDuration.defl=2000000 shim=DigitalInOutPinMethods::pulseIn\n pulseIn(value: PulseValue, maxDuration?: int32): int32;\n\n /**\n * Set the pull direction of this pin.\n * @param name pin to set the pull mode on\n * @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n */\n //% help=pins/set-pull weight=17 blockGap=8\n //% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::setPull\n setPull(pull: PinPullMode): void;\n}\n\n\ndeclare interface PwmPin {}\n\n\ndeclare interface PwmOnlyPin {\n /**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n //% help=pins/analog-set-period weight=51\n //% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::analogSetPeriod\n analogSetPeriod(period: int32): void;\n\n /**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n //% help=pins/servo-write weight=41 group=\"Servo\"\n //% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n //% parts=microservo trackArgs=0\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.defl=90 shim=PwmOnlyPinMethods::servoWrite\n servoWrite(value?: int32): void;\n\n /**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n //% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n //% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n //% parts=microservo blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::servoSetPulse\n servoSetPulse(duration: int32): void;\n\n /**\n * Indicates if the servo is running continuously\n */\n //% blockHidden=1 shim=PwmOnlyPinMethods::servoSetContinuous\n servoSetContinuous(continuous: boolean): void;\n}\ndeclare namespace control {\n\n /**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\"\n //% help=control/raise-event\n //% block=\"raise event|from %src|with value %value\" blockExternalInputs=1 shim=control::raiseEvent\n function raiseEvent(src: int32, value: int32): void;\n\n /**\n * Determine the version of system software currently running.\n */\n //% blockId=\"control_device_dal_version\" block=\"device dal version\"\n //% help=control/device-dal-version shim=control::deviceDalVersion\n function deviceDalVersion(): string;\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}\n\n\ndeclare interface I2C {\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::readBuffer\n readBuffer(address: int32, size: int32, repeat?: boolean): Buffer;\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::writeBuffer\n writeBuffer(address: int32, buf: Buffer, repeat?: boolean): int32;\n}\ndeclare namespace pins {\n\n /**\n * Opens a Serial communication driver\n */\n //% help=pins/create-i2c\n //% parts=i2c shim=pins::createI2C\n function createI2C(sda: DigitalInOutPin, scl: DigitalInOutPin): I2C;\n}\ndeclare namespace pins {\n\n /**\n * Opens a SPI driver\n */\n //% help=pins/create-spi\n //% parts=spi shim=pins::createSPI\n function createSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin): SPI;\n\n /**\n * Opens a slave SPI driver\n */\n //% parts=spi shim=pins::createSlaveSPI\n function createSlaveSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin, csPin: DigitalInOutPin): SPI;\n}\n\n\ndeclare interface SPI {\n /**\n * Write to the SPI bus\n */\n //% shim=SPIMethods::write\n write(value: int32): int32;\n\n /**\n * Transfer buffers over the SPI bus\n */\n //% argsNullable shim=SPIMethods::transfer\n transfer(command: Buffer, response: Buffer): void;\n\n /**\n * Sets the SPI clock frequency\n */\n //% shim=SPIMethods::setFrequency\n setFrequency(frequency: int32): void;\n\n /**\n * Sets the SPI bus mode\n */\n //% shim=SPIMethods::setMode\n setMode(mode: int32): void;\n}\ndeclare namespace configStorage {\n\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //% shim=configStorage::setBuffer\n function setBuffer(key: string, value: Buffer): void;\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::getBuffer\n function getBuffer(key: string): Buffer;\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::removeItem\n function removeItem(key: string): void;\n\n /**\n * Clears the local storage\n */\n //% shim=configStorage::clear\n function clear(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"spi.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n\nnamespace pins {\n\nclass CodalSPIProxy {\nprivate:\n DevicePin* mosi; \n DevicePin* miso; \n DevicePin* sck;\n CODAL_SPI spi;\npublic:\n CodalSPIProxy* next;\n\npublic:\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck) \n , next(NULL)\n {\n }\n\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck, DevicePin* _cs)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck, _cs) \n , next(NULL)\n {\n }\n#endif\n\n CODAL_SPI* getSPI() {\n return &spi;\n }\n\n bool matchPins(DevicePin* mosi, DevicePin* miso, DevicePin* sck) {\n return this->mosi == mosi && this->miso == miso && this->sck == sck;\n }\n\n int write(int value) {\n return spi.write(value);\n }\n\n void transfer(Buffer command, Buffer response) {\n auto cdata = NULL == command ? NULL : command->data;\n auto clength = NULL == command ? 0 : command->length;\n auto rdata = NULL == response ? NULL : response->data;\n auto rlength = NULL == response ? 0 : response->length;\n spi.transfer(cdata, clength, rdata, rlength);\n }\n\n void setFrequency(int frequency) {\n spi.setFrequency(frequency);\n }\n\n void setMode(int mode) {\n spi.setMode(mode);\n }\n};\n\nSPI_ spis(NULL);\n\n/**\n* Opens a SPI driver\n*/\n//% help=pins/create-spi\n//% parts=spi\nSPI_ createSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto dev = spis;\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin);\n ser->next = spis;\n spis = ser;\n return ser;\n}\n\n/**\n* Opens a slave SPI driver\n*/\n//% parts=spi\nSPI_ createSlaveSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin, DigitalInOutPin csPin) {\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n auto dev = spis;\n if (!csPin)\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin, csPin);\n ser->next = spis;\n spis = ser;\n return ser;\n#else\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n return NULL;\n#endif\n}\n\n}\n\nnamespace pxt {\n\nCODAL_SPI* getSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto spi = pins::createSPI(mosiPin, misoPin, sckPin);\n return spi->getSPI();\n}\n\n}\n\nnamespace SPIMethods {\n\n/**\n* Write to the SPI bus\n*/\n//%\nint write(SPI_ device, int value) {\n return device->write(value);\n}\n\n/**\n* Transfer buffers over the SPI bus\n*/\n//% argsNullable\nvoid transfer(SPI_ device, Buffer command, Buffer response) {\n if (!device)\n soft_panic(PANIC_CAST_FROM_NULL);\n if (!command && !response)\n return;\n device->transfer(command, response);\n}\n\n/**\n* Sets the SPI clock frequency\n*/\n//%\nvoid setFrequency(SPI_ device, int frequency) {\n device->setFrequency(frequency);\n}\n\n/**\n* Sets the SPI bus mode\n*/\n//%\nvoid setMode(SPI_ device, int mode) {\n device->setMode(mode);\n}\n\n}\n",
"spi.ts": "namespace pins {\n\n let _spi: SPI;\n /**\n * Gets the default SPI driver\n */\n //%\n export function spi() {\n if (!_spi) {\n const mosi = pins.pinByCfg(DAL.CFG_PIN_MOSI);\n const miso = pins.pinByCfg(DAL.CFG_PIN_MISO);\n const sck = pins.pinByCfg(DAL.CFG_PIN_SCK);\n _spi = pins.createSPI(mosi, miso, sck);\n }\n return _spi;\n }\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 weight=5 advanced=true\n //% blockId=spi_write block=\"spi write %value\"\n export function spiWrite(value: number) {\n return spi().write(value);\n }\n\n /**\n * Write a given command to SPI bus, and at the same time read the response.\n */\n //% help=pins/spi-transfer weight=4 advanced=true\n //% blockId=spi_transfer block=\"spi transfer %command into %response\"\n export function spiTransfer(command: Buffer, response: Buffer) {\n spi().transfer(command, response);\n }\n\n /**\n * Set the SPI frequency\n * @param frequency the clock frequency, eg: 1000000\n */\n //% help=pins/spi-frequency weight=4 advanced=true\n //% blockId=spi_frequency block=\"spi frequency %frequency\"\n export function spiFrequency(frequency: number) {\n spi().setFrequency(frequency);\n }\n\n /**\n * Set the SPI signal mode\n * @param mode the mode, eg: 3\n */\n //% help=pins/spi-mode weight=3 advanced=true\n //% blockId=spi_mode block=\"spi mode %mode\"\n export function spiMode(mode: number) {\n spi().setMode(mode);\n }\n}",
"test.ts": "let i = 1\nlet f = 0.5\nlet plus = i + f\nlet minus = i - f\n\nlet r = Math.random()\nlet ri = Math.randomRange(5, 10)\n\n",
"timer.ts": "namespace control {\n /**\n * A timer\n */\n //% fixedInstances\n export class Timer {\n start: number;\n\n constructor() {\n this.start = control.millis();\n }\n\n /**\n * Gets the elapsed time in millis since the last reset\n */\n //% blockId=timerMillis block=\"%timer|millis\"\n millis(): number {\n return control.millis() - this.start;\n }\n\n /**\n * Gets the elapsed time in seconds since the last reset\n */\n //% blockId=timerSeconds block=\"%timer|seconds\"\n seconds(): number {\n return this.millis() / 1000;\n }\n\n /**\n * Resets the timer\n */\n //% blockId=timerRest block=\"%timer|reset\"\n reset() {\n this.start = control.millis();\n }\n\n /**\n * Pauses until the timer reaches the given amount of milliseconds\n * @param ms how long to pause for, eg: 5, 100, 200, 500, 1000, 2000\n */\n //% blockId=timerPauseUntil block=\"%timer|pause until (ms) %ms\"\n pauseUntil(ms: number) {\n const remaining = this.millis() - ms;\n pause(Math.max(0, remaining));\n }\n }\n\n //% whenUsed fixedInstance block=\"timer 1\"\n export const timer1 = new Timer();\n //% whenUsed fixedInstance block=\"timer 2\"\n export const timer2 = new Timer();\n //% whenUsed fixedInstance block=\"timer 3\"\n export const timer3 = new Timer();\n //% whenUsed fixedInstance block=\"timer 4\"\n export const timer4 = new Timer();\n //% whenUsed fixedInstance block=\"timer 5\"\n export const timer5 = new Timer();\n //% whenUsed fixedInstance block=\"timer 6\"\n export const timer6 = new Timer();\n //% whenUsed fixedInstance block=\"timer 7\"\n export const timer7 = new Timer();\n //% whenUsed fixedInstance block=\"timer 8\"\n export const timer8 = new Timer();\n}",
"uf2format.h": "#ifndef UF2FORMAT_H\n#define UF2FORMAT_H 1\n\n#include \n#include \n\n// All entries are little endian.\n\n#ifndef BOOTLOADER_START\n#define BOOTLOADER_START 0x0\n#endif\n\n#ifndef BOOTLOADER_END\n#define BOOTLOADER_END 0x2000\n#endif\n\n#ifndef UF2_BINFO\n#define UF2_BINFO ((UF2_BInfo *)(BOOTLOADER_END - sizeof(UF2_BInfo)))\n#endif\n\n#ifndef UF2_INFO_TXT\n#define UF2_INFO_TXT UF2_BINFO->info_uf2\n#endif\n\n\n#define UF2_MAGIC_START0 0x0A324655UL // \"UF2\\n\"\n#define UF2_MAGIC_START1 0x9E5D5157UL // Randomly selected\n#define UF2_MAGIC_END 0x0AB16F30UL // Ditto\n\n// If set, the block is \"comment\" and should not be flashed to the device\n#define UF2_FLAG_NOFLASH 0x00000001\n\ntypedef struct {\n // 32 byte header\n uint32_t magicStart0;\n uint32_t magicStart1;\n uint32_t flags;\n uint32_t targetAddr;\n uint32_t payloadSize;\n uint32_t blockNo;\n uint32_t numBlocks;\n uint32_t reserved;\n\n // raw data;\n uint8_t data[476];\n\n // store magic also at the end to limit damage from partial block reads\n uint32_t magicEnd;\n} UF2_Block;\n\ntypedef struct {\n uint8_t version;\n uint8_t ep_in;\n uint8_t ep_out;\n uint8_t reserved0;\n uint32_t cbw_tag;\n uint32_t blocks_remaining;\n uint8_t *buffer;\n} UF2_HandoverArgs;\n\ntypedef void (*UF2_MSC_Handover_Handler)(UF2_HandoverArgs *handover);\ntypedef void (*UF2_HID_Handover_Handler)(int ep);\n\n// this is required to be exactly 16 bytes long by the linker script\ntypedef struct {\n void *reserved0;\n UF2_HID_Handover_Handler handoverHID;\n UF2_MSC_Handover_Handler handoverMSC;\n const char *info_uf2;\n} UF2_BInfo;\n\nstatic inline bool is_uf2_block(void *data) {\n UF2_Block *bl = (UF2_Block *)data;\n return bl->magicStart0 == UF2_MAGIC_START0 && bl->magicStart1 == UF2_MAGIC_START1 &&\n bl->magicEnd == UF2_MAGIC_END;\n}\n\nstatic inline bool in_uf2_bootloader_space(const void *addr) {\n return (BOOTLOADER_START + 0x100) <= (uint32_t)addr && (uint32_t)addr < (BOOTLOADER_END);\n}\n\nstatic inline const char *uf2_info(void) {\n if (in_uf2_bootloader_space(UF2_INFO_TXT))\n return UF2_INFO_TXT;\n return \"N/A\";\n}\n\n#ifdef UF2_DEFINE_HANDOVER\nstatic inline void hf2_handover(uint8_t ep) {\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_HID_Handover_Handler fn = UF2_BINFO->handoverHID;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n // Pass control to bootloader; never returns\n fn(ep & 0xf);\n }\n}\n\nstatic inline void check_uf2_handover(uint8_t *buffer, uint32_t blocks_remaining, uint8_t ep_in,\n uint8_t ep_out, uint32_t cbw_tag) {\n if (!is_uf2_block(buffer))\n return;\n\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_MSC_Handover_Handler fn = UF2_BINFO->handoverMSC;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n UF2_HandoverArgs hand = {\n 1, ep_in, ep_out, 0, cbw_tag, blocks_remaining, buffer,\n };\n // Pass control to bootloader; never returns\n fn(&hand);\n }\n}\n#endif\n\n#endif\n",
"uf2hid.h": "#ifndef UF2_HID_H\n#define UF2_HID_H 1\n\n#define HF2_CMD_BININFO 0x0001\n// no arguments\n#define HF2_MODE_BOOTLOADER 0x01\n#define HF2_MODE_USERSPACE 0x02\nstruct HF2_BININFO_Result {\n uint32_t mode;\n uint32_t flash_page_size;\n uint32_t flash_num_pages;\n uint32_t max_message_size;\n uint32_t uf2_family;\n};\n\n#define HF2_CMD_INFO 0x0002\n// no arguments\n// results is utf8 character array\n\n#define HF2_CMD_RESET_INTO_APP 0x0003\n// no arguments, no result\n\n#define HF2_CMD_RESET_INTO_BOOTLOADER 0x0004\n// no arguments, no result\n\n#define HF2_CMD_START_FLASH 0x0005\n// no arguments, no result\n\n#define HF2_CMD_WRITE_FLASH_PAGE 0x0006\nstruct HF2_WRITE_FLASH_PAGE_Command {\n uint32_t target_addr;\n uint32_t data[0];\n};\n// no result\n\n#define HF2_CMD_CHKSUM_PAGES 0x0007\nstruct HF2_CHKSUM_PAGES_Command {\n uint32_t target_addr;\n uint32_t num_pages;\n};\nstruct HF2_CHKSUM_PAGES_Result {\n uint16_t chksums[0 /* num_pages */];\n};\n\n#define HF2_CMD_READ_WORDS 0x0008\nstruct HF2_READ_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n};\nstruct HF2_READ_WORDS_Result {\n uint32_t words[0 /* num_words */];\n};\n\n#define HF2_CMD_WRITE_WORDS 0x0009\nstruct HF2_WRITE_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n uint32_t words[0 /* num_words */];\n};\n// no result\n\n#define HF2_CMD_DMESG 0x0010\n// no arguments\n// results is utf8 character array\n\n#define HF2_EV_MASK 0x800000\n\n#define HF2_CMD_JDS_CONFIG 0x0020\n#define HF2_CMD_JDS_SEND 0x0021\n#define HF2_EV_JDS_PACKET 0x800020\n\ntypedef struct {\n uint32_t command_id;\n uint16_t tag;\n uint8_t reserved0;\n uint8_t reserved1;\n\n union {\n struct HF2_WRITE_FLASH_PAGE_Command write_flash_page;\n struct HF2_WRITE_WORDS_Command write_words;\n struct HF2_READ_WORDS_Command read_words;\n struct HF2_CHKSUM_PAGES_Command chksum_pages;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Command;\n\ntypedef struct {\n union {\n uint32_t eventId;\n struct {\n uint16_t tag;\n union {\n struct {\n uint8_t status;\n uint8_t status_info;\n };\n uint16_t status16;\n };\n };\n };\n union {\n struct HF2_BININFO_Result bininfo;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Response;\n\n#define HF2_FLAG_SERIAL_OUT 0x80\n#define HF2_FLAG_SERIAL_ERR 0xC0\n#define HF2_FLAG_CMDPKT_LAST 0x40\n#define HF2_FLAG_CMDPKT_BODY 0x00\n#define HF2_FLAG_MASK 0xC0\n#define HF2_SIZE_MASK 63\n\n#define HF2_STATUS_OK 0x00\n#define HF2_STATUS_INVALID_CMD 0x01\n#define HF2_STATUS_INVALID_STATE 0x02\n\n#endif\n",
"usb.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"uf2format.h\"\n\nnamespace pxt {\nCodalUSB usb;\n\n// share the buffer; we will crash anyway if someone talks to us over both at the same time\nHF2_Buffer hf2buf;\nHF2 hf2(hf2buf);\n#ifdef HF2_HID\nHF2 hf2hid(hf2buf);\n#endif\nDummyIface dummyIface;\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nUSBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nUSBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nUSBHIDJoystick joystick;\n#endif\n\nstatic const DeviceDescriptor device_desc = {\n 0x12, // bLength\n 0x01, // bDescriptorType\n 0x0210, // bcdUSBL\n\n // Class etc specified per-interface\n 0x00, 0x00, 0x00,\n\n 0x40, // bMaxPacketSize0\n USB_DEFAULT_VID, USB_DEFAULT_PID,\n 0x4202, // bcdDevice - leave unchanged for the HF2 to work\n 0x01, // iManufacturer\n 0x02, // iProduct\n 0x03, // SerialNumber\n 0x01 // bNumConfigs\n};\n\nstatic void start_usb() {\n // start USB with a delay, so that user code can add new interfaces if needed\n // (eg USB HID keyboard, or MSC)\n fiber_sleep(500);\n usb.start();\n}\n\nvoid platform_usb_init() __attribute__((weak));\nvoid platform_usb_init() {}\n\nvoid set_usb_strings(const char *uf2_info) {\n static const char *string_descriptors[3];\n static char serial[12];\n itoa(target_get_serial() & 0x7fffffff, serial);\n\n auto model = strstr(uf2_info, \"Model: \");\n if (model) {\n model += 7;\n auto end = model;\n while (*end && *end != '\\n' && *end != '\\r')\n end++;\n auto len = end - model;\n auto dev = (char *)app_alloc(len + 10);\n memcpy(dev, model, len);\n strcpy(dev + len, \" (app)\");\n // try to split into manufacturer and\n auto sep = strstr(dev, \" / \");\n if (sep) {\n *sep = '\\0';\n string_descriptors[0] = dev;\n string_descriptors[1] = sep + 3;\n } else {\n string_descriptors[0] = dev;\n string_descriptors[1] = dev;\n }\n } else {\n string_descriptors[0] = \"Unknown Corp.\";\n string_descriptors[1] = \"PXT Device (app)\";\n }\n\n string_descriptors[2] = serial;\n usb.stringDescriptors = string_descriptors;\n}\n\nvoid usb_init() {\n usb.deviceDescriptor = &device_desc;\n set_usb_strings(UF2_INFO_TXT);\n\n platform_usb_init();\n\n usb.add(hf2);\n\n#ifdef HF2_HID\n hf2hid.useHID = true;\n usb.add(hf2hid);\n#else\n // the WINUSB descriptors don't seem to work if there's only one interface\n // so we add a dummy interface\n usb.add(dummyIface);\n#endif\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n usb.add(mouse);\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n usb.add(keyboard);\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n usb.add(joystick);\n#endif\n\n create_fiber(start_usb);\n}\n\n} // namespace pxt\n\n#else\nnamespace pxt {\nvoid usb_init() {}\n} // namespace pxt\n#endif\n\nnamespace control {\n/**\n * Determines if the USB has been enumerated.\n */\n//%\nbool isUSBInitialized() {\n#if CONFIG_ENABLED(DEVICE_USB)\n return pxt::usb.isInitialised();\n#else\n return false;\n#endif\n}\n} // namespace control\n\nnamespace pxt {\nstatic void (*pSendToUART)(const char *data, int len) = NULL;\nvoid setSendToUART(void (*f)(const char *, int)) {\n pSendToUART = f;\n}\n\nvoid sendSerial(const char *data, int len) {\n#if CONFIG_ENABLED(DEVICE_USB)\n hf2.sendSerial(data, len);\n#if HF2_HID\n hf2hid.sendSerial(data, len);\n#endif\n#endif\n if (pSendToUART)\n pSendToUART(data, len);\n}\n\nvoid dumpDmesg() {\n sendSerial(\"\\nDMESG:\\n\", 8);\n sendSerial(codalLogStore.buffer, codalLogStore.ptr);\n sendSerial(\"\\n\\n\", 2);\n}\n\nvoid (*logJDFrame)(const uint8_t *data);\nvoid (*sendJDFrame)(const uint8_t *data);\n\n} // namespace pxt\n"
},
"core---rp2040": {
"README.md": "# core\n\nThe core library for Codal-based targets.\n\n",
"codal.cpp": "#include \"pxt.h\"\n#include \"LowLevelTimer.h\"\nusing namespace codal;\n\nvoid cpu_clock_init(void);\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#ifdef DEVICE_GET_FIBER_LIST_AVAILABLE\n// newer codal-core has get_fiber_list() but not list_fibers()\nnamespace codal {\n/*\n * Return all current fibers.\n *\n * @param dest If non-null, it points to an array of pointers to fibers to store results in.\n *\n * @return the number of fibers (potentially) stored\n */\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\nnamespace pxt {\n\nvoid platform_init();\nvoid usb_init();\n\n// The first two word are used to tell the bootloader that a single reset should start the\n// bootloader and the MSD device, not us.\n// The rest is reserved for partial flashing checksums.\n__attribute__((section(\".binmeta\"))) __attribute__((used)) const uint32_t pxt_binmeta[] = {\n 0x87eeb07c, 0x87eeb07c, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n};\n\nEvent lastEvent;\nMessageBus devMessageBus;\ncodal::CodalDevice device;\n\nstruct FreeList {\n FreeList *next;\n};\n\nstatic void commInit() {\n int commSize = bytecode[20];\n if (!commSize)\n return;\n\n void *r = app_alloc_at((void *)PXT_COMM_BASE, commSize);\n DMESG(\"comm %d -> %p\", commSize, r);\n if (!r)\n target_panic(20);\n}\n\nstatic void initCodal() {\n cpu_clock_init();\n\n commInit();\n\n // Bring up fiber scheduler.\n scheduler_init(devMessageBus);\n\n // We probably don't need that - components are initialized when one obtains\n // the reference to it.\n // devMessageBus.listen(DEVICE_ID_MESSAGE_BUS_LISTENER, DEVICE_EVT_ANY, this,\n // &CircuitPlayground::onListenerRegisteredEvent);\n\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; i++) {\n if (CodalComponent::components[i])\n CodalComponent::components[i]->init();\n }\n\n usb_init();\n\n auto led = LOOKUP_PIN(LED);\n if (led) {\n led->setDigitalValue(0);\n }\n}\n\n// ---------------------------------------------------------------------------\n// An adapter for the API expected by the run-time.\n// ---------------------------------------------------------------------------\n\n// We have the invariant that if [dispatchEvent] is registered against the DAL\n// for a given event, then [handlersMap] contains a valid entry for that\n// event.\nvoid dispatchEvent(Event e) {\n lastEvent = e;\n\n auto curr = findBinding(e.source, e.value);\n auto value = fromInt(e.value);\n while (curr) {\n runAction1(curr->action, value);\n curr = nextBinding(curr->next, e.source, e.value);\n }\n}\n\nvoid registerWithDal(int id, int event, Action a, int flags) {\n // first time?\n if (!findBinding(id, event)) {\n devMessageBus.listen(id, event, dispatchEvent, flags);\n if (event == 0) {\n // we're registering for all events on given ID\n // need to remove old listeners for specific events\n auto curr = findBinding(id, -1);\n while (curr) {\n devMessageBus.ignore(id, curr->value, dispatchEvent);\n curr = nextBinding(curr->next, id, -1);\n }\n }\n }\n setBinding(id, event, a);\n}\n\nvoid fiberDone(void *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 target_wait_us(us);\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 registerGCPtr(a);\n create_fiber(forever_stub, (void *)a);\n }\n}\n\nvoid runInParallel(Action a) {\n if (a != 0) {\n registerGCPtr(a);\n create_fiber((void (*)(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 initSystemTimer();\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\nuint64_t getLongSerialNumber() {\n return device.getSerialNumber();\n}\n\nint current_time_ms() {\n return system_timer_current_time();\n}\n\nuint64_t current_time_us() {\n return system_timer_current_time_us();\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\nstatic void *threadAddressFor(codal::Fiber *fib, void *sp) {\n if (fib == currentFiber)\n return sp;\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 int numFibers = codal::list_fibers(NULL);\n codal::Fiber **fibers = (codal::Fiber **)xmalloc(sizeof(codal::Fiber *) * numFibers);\n int num2 = codal::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 gcProcess(ctx->thrownValue);\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 xfree(fibers);\n}\n\nLowLevelTimer *getJACDACTimer() {\n static LowLevelTimer *jacdacTimer;\n if (!jacdacTimer) {\n jacdacTimer = allocateTimer();\n jacdacTimer->setIRQPriority(1);\n }\n return jacdacTimer;\n}\nvoid initSystemTimer() {\n new CODAL_TIMER(*allocateTimer());\n}\n\n} // namespace pxt\n",
"control.cpp": "#include \"pxt.h\"\n\n#if defined(NRF52_SERIES) || defined(PICO_BOARD)\n#define _estack __StackTop \n#endif\nextern uint32_t _estack;\n\nnamespace control {\n\n/**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n//% weight=21 blockGap=12 blockId=\"control_raise_event\"\n//% help=control/raise-event\n//% block=\"raise event|from %src|with value %value\" blockExternalInputs=1\nvoid raiseEvent(int src, int value) {\n Event evt(src, value);\n}\n\n/**\n* Determine the version of system software currently running.\n*/\n//% blockId=\"control_device_dal_version\" block=\"device dal version\"\n//% help=control/device-dal-version\nString deviceDalVersion() {\n return mkString(device.getVersion());\n}\n\n/**\n* Allocates the next user notification event\n*/\n//% help=control/allocate-notify-event\nint allocateNotifyEvent() {\n return ::allocateNotifyEvent();\n}\n\n/** Write a message to DMESG debugging buffer. */\n//%\nvoid dmesg(String s) {\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 DMESG(\"# %s: %p\", str->getUTF8Data(), ptr);\n}\n\n//%\nuint32_t _ramSize()\n{\n return (uint32_t)&_estack & 0x1fffffff;\n}\n\n}\n",
"dal.d.ts": "// Auto-generated. Do not edit.\ndeclare const enum DAL {\n // /libraries/codal-core/inc/core/CodalComponent.h\n DEVICE_ID_BUTTON_A = 1,\n DEVICE_ID_BUTTON_B = 2,\n DEVICE_ID_BUTTON_AB = 3,\n DEVICE_ID_BUTTON_RESET = 4,\n DEVICE_ID_ACCELEROMETER = 5,\n DEVICE_ID_COMPASS = 6,\n DEVICE_ID_DISPLAY = 7,\n DEVICE_ID_THERMOMETER = 8,\n DEVICE_ID_RADIO = 9,\n DEVICE_ID_RADIO_DATA_READY = 10,\n DEVICE_ID_MULTIBUTTON_ATTACH = 11,\n DEVICE_ID_SERIAL = 12,\n DEVICE_ID_GESTURE = 13,\n DEVICE_ID_SYSTEM_TIMER = 14,\n DEVICE_ID_SCHEDULER = 15,\n DEVICE_ID_COMPONENT = 16,\n DEVICE_ID_LIGHT_SENSOR = 17,\n DEVICE_ID_TOUCH_SENSOR = 18,\n DEVICE_ID_SYSTEM_DAC = 19,\n DEVICE_ID_SYSTEM_MICROPHONE = 20,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR = 21,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR_SPL = 22,\n DEVICE_ID_MSC = 23,\n DEVICE_ID_SPI = 24,\n DEVICE_ID_DISTANCE = 25,\n DEVICE_ID_GYROSCOPE = 26,\n DEVICE_ID_HUMIDITY = 27,\n DEVICE_ID_PRESSURE = 28,\n DEVICE_ID_SINGLE_WIRE_SERIAL = 29,\n DEVICE_ID_JACDAC = 30,\n DEVICE_ID_JACDAC_PHYS = 31,\n DEVICE_ID_JACDAC_CONTROL_SERVICE = 32,\n DEVICE_ID_JACDAC_CONFIGURATION_SERVICE = 33,\n DEVICE_ID_SYSTEM_ADC = 34,\n DEVICE_ID_PULSE_IN = 35,\n DEVICE_ID_USB = 36,\n DEVICE_ID_IO_P0 = 100,\n DEVICE_ID_MESSAGE_BUS_LISTENER = 1021,\n DEVICE_ID_NOTIFY_ONE = 1022,\n DEVICE_ID_NOTIFY = 1023,\n DEVICE_ID_BUTTON_UP = 2000,\n DEVICE_ID_BUTTON_DOWN = 2001,\n DEVICE_ID_BUTTON_LEFT = 2002,\n DEVICE_ID_BUTTON_RIGHT = 2003,\n DEVICE_ID_JD_DYNAMIC_ID = 3000,\n DEVICE_COMPONENT_RUNNING = 4096,\n DEVICE_COMPONENT_STATUS_SYSTEM_TICK = 8192,\n DEVICE_COMPONENT_STATUS_IDLE_TICK = 16384,\n DEVICE_COMPONENT_LISTENERS_CONFIGURED = 1,\n DEVICE_COMPONENT_EVT_SYSTEM_TICK = 1,\n // /libraries/codal-core/inc/core/CodalFiber.h\n DEVICE_SCHEDULER_RUNNING = 1,\n DEVICE_SCHEDULER_IDLE = 2,\n DEVICE_SCHEDULER_DEEPSLEEP = 4,\n DEVICE_FIBER_FLAG_FOB = 1,\n DEVICE_FIBER_FLAG_PARENT = 2,\n DEVICE_FIBER_FLAG_CHILD = 4,\n DEVICE_FIBER_FLAG_DO_NOT_PAGE = 8,\n DEVICE_SCHEDULER_EVT_TICK = 1,\n DEVICE_SCHEDULER_EVT_IDLE = 2,\n DEVICE_GET_FIBER_LIST_AVAILABLE = 1,\n // /libraries/codal-core/inc/core/CodalListener.h\n MESSAGE_BUS_LISTENER_PARAMETERISED = 1,\n MESSAGE_BUS_LISTENER_METHOD = 2,\n MESSAGE_BUS_LISTENER_BUSY = 4,\n MESSAGE_BUS_LISTENER_REENTRANT = 8,\n MESSAGE_BUS_LISTENER_QUEUE_IF_BUSY = 16,\n MESSAGE_BUS_LISTENER_DROP_IF_BUSY = 32,\n MESSAGE_BUS_LISTENER_NONBLOCKING = 64,\n MESSAGE_BUS_LISTENER_URGENT = 128,\n MESSAGE_BUS_LISTENER_DELETING = 32768,\n MESSAGE_BUS_LISTENER_IMMEDIATE = 192,\n // /libraries/codal-core/inc/core/ErrorNo.h\n DEVICE_OK = 0,\n DEVICE_INVALID_PARAMETER = -1001,\n DEVICE_NOT_SUPPORTED = -1002,\n DEVICE_CALIBRATION_IN_PROGRESS = -1003,\n DEVICE_CALIBRATION_REQUIRED = -1004,\n DEVICE_NO_RESOURCES = -1005,\n DEVICE_BUSY = -1006,\n DEVICE_CANCELLED = -1007,\n DEVICE_I2C_ERROR = -1010,\n DEVICE_SERIAL_IN_USE = -1011,\n DEVICE_NO_DATA = -1012,\n DEVICE_NOT_IMPLEMENTED = -1013,\n DEVICE_SPI_ERROR = -1014,\n DEVICE_INVALID_STATE = -1015,\n DEVICE_OOM = 20,\n DEVICE_HEAP_ERROR = 30,\n DEVICE_NULL_DEREFERENCE = 40,\n DEVICE_USB_ERROR = 50,\n DEVICE_JACDAC_ERROR = 60,\n DEVICE_CPU_SDK = 70,\n DEVICE_HARDWARE_CONFIGURATION_ERROR = 90,\n // /libraries/codal-core/inc/core/NotifyEvents.h\n DISPLAY_EVT_FREE = 1,\n CODAL_SERIAL_EVT_TX_EMPTY = 2,\n BLE_EVT_SERIAL_TX_EMPTY = 3,\n ARCADE_PLAYER_JOIN_RESULT = 4,\n POWER_EVT_CANCEL_DEEPSLEEP = 5,\n DEVICE_NOTIFY_USER_EVENT_BASE = 1024,\n // /libraries/codal-core/inc/driver-models/AbstractButton.h\n DEVICE_BUTTON_EVT_DOWN = 1,\n DEVICE_BUTTON_EVT_UP = 2,\n DEVICE_BUTTON_EVT_CLICK = 3,\n DEVICE_BUTTON_EVT_LONG_CLICK = 4,\n DEVICE_BUTTON_EVT_HOLD = 5,\n DEVICE_BUTTON_EVT_DOUBLE_CLICK = 6,\n DEVICE_BUTTON_LONG_CLICK_TIME = 1000,\n DEVICE_BUTTON_HOLD_TIME = 1500,\n DEVICE_BUTTON_STATE = 1,\n DEVICE_BUTTON_STATE_HOLD_TRIGGERED = 2,\n DEVICE_BUTTON_STATE_CLICK = 4,\n DEVICE_BUTTON_STATE_LONG_CLICK = 8,\n DEVICE_BUTTON_SIGMA_MIN = 0,\n DEVICE_BUTTON_SIGMA_MAX = 12,\n DEVICE_BUTTON_SIGMA_THRESH_HI = 8,\n DEVICE_BUTTON_SIGMA_THRESH_LO = 2,\n DEVICE_BUTTON_DOUBLE_CLICK_THRESH = 50,\n DEVICE_BUTTON_SIMPLE_EVENTS = 0,\n DEVICE_BUTTON_ALL_EVENTS = 1,\n ACTIVE_LOW = 0,\n ACTIVE_HIGH = 1,\n // /libraries/codal-core/inc/driver-models/Accelerometer.h\n ACCELEROMETER_IMU_DATA_VALID = 2,\n ACCELEROMETER_EVT_DATA_UPDATE = 1,\n ACCELEROMETER_EVT_NONE = 0,\n ACCELEROMETER_EVT_TILT_UP = 1,\n ACCELEROMETER_EVT_TILT_DOWN = 2,\n ACCELEROMETER_EVT_TILT_LEFT = 3,\n ACCELEROMETER_EVT_TILT_RIGHT = 4,\n ACCELEROMETER_EVT_FACE_UP = 5,\n ACCELEROMETER_EVT_FACE_DOWN = 6,\n ACCELEROMETER_EVT_FREEFALL = 7,\n ACCELEROMETER_EVT_3G = 8,\n ACCELEROMETER_EVT_6G = 9,\n ACCELEROMETER_EVT_8G = 10,\n ACCELEROMETER_EVT_SHAKE = 11,\n ACCELEROMETER_EVT_2G = 12,\n ACCELEROMETER_REST_TOLERANCE = 200,\n ACCELEROMETER_TILT_TOLERANCE = 200,\n ACCELEROMETER_FREEFALL_TOLERANCE = 400,\n ACCELEROMETER_SHAKE_TOLERANCE = 400,\n ACCELEROMETER_2G_TOLERANCE = 2048,\n ACCELEROMETER_3G_TOLERANCE = 3072,\n ACCELEROMETER_6G_TOLERANCE = 6144,\n ACCELEROMETER_8G_TOLERANCE = 8192,\n ACCELEROMETER_GESTURE_DAMPING = 5,\n ACCELEROMETER_SHAKE_DAMPING = 10,\n ACCELEROMETER_SHAKE_RTX = 30,\n ACCELEROMETER_SHAKE_COUNT_THRESHOLD = 4,\n // /libraries/codal-core/inc/driver-models/Compass.h\n COMPASS_STATUS_RUNNING = 1,\n COMPASS_STATUS_CALIBRATED = 2,\n COMPASS_STATUS_CALIBRATING = 4,\n COMPASS_STATUS_ADDED_TO_IDLE = 8,\n COMPASS_EVT_DATA_UPDATE = 1,\n COMPASS_EVT_CONFIG_NEEDED = 2,\n COMPASS_EVT_CALIBRATE = 3,\n COMPASS_EVT_CALIBRATION_NEEDED = 4,\n // /libraries/codal-core/inc/driver-models/Gyroscope.h\n GYROSCOPE_IMU_DATA_VALID = 2,\n GYROSCOPE_EVT_DATA_UPDATE = 1,\n // /libraries/codal-core/inc/driver-models/LowLevelTimer.h\n CODAL_LOWLEVELTIMER_STATUS_SLEEP_IRQENABLE = 1,\n TimerModeTimer = 0,\n TimerModeCounter = 1,\n TimerModeAlternateFunction = 2,\n BitMode8 = 0,\n BitMode16 = 1,\n BitMode24 = 2,\n BitMode32 = 3,\n // /libraries/codal-core/inc/driver-models/Pin.h\n IO_STATUS_DIGITAL_IN = 1,\n IO_STATUS_DIGITAL_OUT = 2,\n IO_STATUS_ANALOG_IN = 4,\n IO_STATUS_ANALOG_OUT = 8,\n IO_STATUS_TOUCH_IN = 16,\n IO_STATUS_EVENT_ON_EDGE = 32,\n IO_STATUS_EVENT_PULSE_ON_EDGE = 64,\n IO_STATUS_INTERRUPT_ON_EDGE = 128,\n IO_STATUS_ACTIVE_HI = 256,\n IO_STATUS_WAKE_ON_ACTIVE = 512,\n DEVICE_PIN_MAX_OUTPUT = 1023,\n DEVICE_PIN_MAX_SERVO_RANGE = 180,\n DEVICE_PIN_DEFAULT_SERVO_RANGE = 2000,\n DEVICE_PIN_DEFAULT_SERVO_CENTER = 1500,\n DEVICE_PIN_EVENT_NONE = 0,\n DEVICE_PIN_INTERRUPT_ON_EDGE = 1,\n DEVICE_PIN_EVENT_ON_EDGE = 2,\n DEVICE_PIN_EVENT_ON_PULSE = 3,\n DEVICE_PIN_EVENT_ON_TOUCH = 4,\n DEVICE_PIN_EVT_RISE = 2,\n DEVICE_PIN_EVT_FALL = 3,\n DEVICE_PIN_EVT_PULSE_HI = 4,\n DEVICE_PIN_EVT_PULSE_LO = 5,\n PIN_CAPABILITY_DIGITAL = 1,\n PIN_CAPABILITY_ANALOG = 2,\n PIN_CAPABILITY_AD = 3,\n PIN_CAPABILITY_ALL = 3,\n None = 0,\n Down = 1,\n Up = 2,\n // /libraries/codal-core/inc/driver-models/Radio.h\n RADIO_EVT_DATA_READY = 2,\n // /libraries/codal-core/inc/driver-models/SPIFlash.h\n SPIFLASH_PAGE_SIZE = 256,\n SPIFLASH_SMALL_ROW_PAGES = 16,\n SPIFLASH_BIG_ROW_PAGES = 256,\n // /libraries/codal-core/inc/driver-models/Sensor.h\n SENSOR_THRESHOLD_LOW = 1,\n SENSOR_THRESHOLD_HIGH = 2,\n SENSOR_UPDATE_NEEDED = 3,\n SENSOR_INITIALISED = 1,\n SENSOR_HIGH_THRESHOLD_PASSED = 2,\n SENSOR_LOW_THRESHOLD_PASSED = 4,\n SENSOR_LOW_THRESHOLD_ENABLED = 8,\n SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n SENSOR_DEFAULT_SENSITIVITY = 868,\n SENSOR_DEFAULT_SAMPLE_PERIOD = 500,\n // /libraries/codal-core/inc/driver-models/Serial.h\n CODAL_SERIAL_DEFAULT_BAUD_RATE = 115200,\n CODAL_SERIAL_DEFAULT_BUFFER_SIZE = 20,\n CODAL_SERIAL_EVT_DELIM_MATCH = 1,\n CODAL_SERIAL_EVT_HEAD_MATCH = 2,\n CODAL_SERIAL_EVT_RX_FULL = 3,\n CODAL_SERIAL_EVT_DATA_RECEIVED = 4,\n CODAL_SERIAL_STATUS_RX_IN_USE = 1,\n CODAL_SERIAL_STATUS_TX_IN_USE = 2,\n CODAL_SERIAL_STATUS_RX_BUFF_INIT = 4,\n CODAL_SERIAL_STATUS_TX_BUFF_INIT = 8,\n CODAL_SERIAL_STATUS_RXD = 16,\n CODAL_SERIAL_STATUS_DEEPSLEEP = 32,\n ASYNC = 0,\n SYNC_SPINWAIT = 1,\n SYNC_SLEEP = 2,\n RxInterrupt = 0,\n TxInterrupt = 1,\n // /libraries/codal-core/inc/driver-models/SingleWireSerial.h\n SWS_EVT_DATA_RECEIVED = 1,\n SWS_EVT_DATA_SENT = 2,\n SWS_EVT_ERROR = 3,\n SWS_EVT_DATA_DROPPED = 4,\n SingleWireRx = 0,\n SingleWireTx = 1,\n SingleWireDisconnected = 2,\n // /libraries/codal-core/inc/driver-models/Timer.h\n CODAL_TIMER_DEFAULT_EVENT_LIST_SIZE = 10,\n CODAL_TIMER_EVENT_FLAGS_NONE = 0,\n CODAL_TIMER_EVENT_FLAGS_WAKEUP = 1,\n // /libraries/codal-core/inc/drivers/AnalogSensor.h\n ANALOG_THRESHOLD_LOW = 1,\n ANALOG_THRESHOLD_HIGH = 2,\n ANALOG_SENSOR_UPDATE_NEEDED = 3,\n ANALOG_SENSOR_INITIALISED = 1,\n ANALOG_SENSOR_HIGH_THRESHOLD_PASSED = 2,\n ANALOG_SENSOR_LOW_THRESHOLD_PASSED = 4,\n ANALOG_SENSOR_LOW_THRESHOLD_ENABLED = 8,\n ANALOG_SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n // /libraries/codal-core/inc/drivers/AnimatedDisplay.h\n DISPLAY_EVT_ANIMATION_COMPLETE = 1,\n DISPLAY_DEFAULT_AUTOCLEAR = 1,\n DISPLAY_SPACING = 1,\n DISPLAY_ANIMATE_DEFAULT_POS = -255,\n DISPLAY_DEFAULT_SCROLL_SPEED = 120,\n DISPLAY_DEFAULT_SCROLL_STRIDE = -1,\n DISPLAY_DEFAULT_PRINT_SPEED = 400,\n ANIMATION_MODE_NONE = 0,\n ANIMATION_MODE_STOPPED = 1,\n ANIMATION_MODE_SCROLL_TEXT = 2,\n ANIMATION_MODE_PRINT_TEXT = 3,\n ANIMATION_MODE_SCROLL_IMAGE = 4,\n ANIMATION_MODE_ANIMATE_IMAGE = 5,\n ANIMATION_MODE_ANIMATE_IMAGE_WITH_CLEAR = 6,\n ANIMATION_MODE_PRINT_CHARACTER = 7,\n // /libraries/codal-core/inc/drivers/FAT.h\n FAT_RESERVED_SECTORS = 1,\n FAT_ROOT_DIR_SECTORS = 4,\n // /libraries/codal-core/inc/drivers/HID.h\n HID_REQUEST_GET_REPORT = 1,\n HID_REQUEST_GET_IDLE = 2,\n HID_REQUEST_GET_PROTOCOL = 3,\n HID_REQUEST_SET_REPORT = 9,\n HID_REQUEST_SET_IDLE = 10,\n HID_REQUEST_SET_PROTOCOL = 11,\n // /libraries/codal-core/inc/drivers/HIDKeyboard.h\n HID_KEYBOARD_NUM_REPORTS = 3,\n HID_KEYBOARD_REPORT_GENERIC = 1,\n HID_KEYBOARD_REPORT_CONSUMER = 2,\n HID_KEYBOARD_KEYSTATE_SIZE_GENERIC = 8,\n HID_KEYBOARD_KEYSTATE_SIZE_CONSUMER = 2,\n HID_KEYBOARD_MODIFIER_OFFSET = 2,\n HID_KEYBOARD_DELAY_DEFAULT = 10,\n PressKey = 0,\n ReleaseKey = 1,\n // /libraries/codal-core/inc/drivers/KeyMap.h\n KEYMAP_ALL_KEYS_UP_Val = 1,\n KEYMAP_ALL_KEYS_UP_POS = 28,\n KEYMAP_NORMAL_KEY_Val = 0,\n KEYMAP_MODIFIER_KEY_Val = 1,\n KEYMAP_MODIFIER_POS = 29,\n KEYMAP_MEDIA_KEY_Val = 1,\n KEYMAP_MEDIA_POS = 30,\n KEYMAP_KEY_UP_Val = 0,\n KEYMAP_KEY_DOWN_Val = 1,\n KEYMAP_KEY_DOWN_POS = 31,\n // /libraries/codal-core/inc/drivers/KeyValueStorage.h\n DEVICE_KEY_VALUE_STORE_OFFSET = -4,\n KEY_VALUE_STORAGE_MAGIC = 789921,\n KEY_VALUE_STORAGE_BLOCK_SIZE = 48,\n KEY_VALUE_STORAGE_KEY_SIZE = 16,\n KEY_VALUE_STORAGE_SCRATCH_WORD_SIZE = 64,\n KEY_VALUE_STORAGE_MAX_PAIRS = 5,\n // /libraries/codal-core/inc/drivers/LEDMatrix.h\n LED_MATRIX_GREYSCALE_BIT_DEPTH = 8,\n LED_MATRIX_EVT_LIGHT_SENSE = 2,\n LED_MATRIX_EVT_FRAME_TIMEOUT = 3,\n LED_MATRIX_MINIMUM_BRIGHTNESS = 1,\n LED_MATRIX_MAXIMUM_BRIGHTNESS = 255,\n LED_MATRIX_DEFAULT_BRIGHTNESS = 255,\n DISPLAY_MODE_BLACK_AND_WHITE = 0,\n DISPLAY_MODE_GREYSCALE = 1,\n DISPLAY_MODE_BLACK_AND_WHITE_LIGHT_SENSE = 2,\n DISPLAY_MODE_GREYSCALE_LIGHT_SENSE = 3,\n MATRIX_DISPLAY_ROTATION_0 = 0,\n MATRIX_DISPLAY_ROTATION_90 = 1,\n MATRIX_DISPLAY_ROTATION_180 = 2,\n MATRIX_DISPLAY_ROTATION_270 = 3,\n NO_CONN = 0,\n // /libraries/codal-core/inc/drivers/LSM303Accelerometer.h\n LSM303_A_DEFAULT_ADDR = 50,\n LSM303_STATUS_REG_AUX_A = 7,\n LSM303_OUT_TEMP_L_A = 12,\n LSM303_OUT_TEMP_H_A = 13,\n LSM303_INT_COUNTER_REG_A = 14,\n LSM303_WHO_AM_I_A = 15,\n LSM303_TEMP_CFG_REG_A = 31,\n LSM303_CTRL_REG1_A = 32,\n LSM303_CTRL_REG2_A = 33,\n LSM303_CTRL_REG3_A = 34,\n LSM303_CTRL_REG4_A = 35,\n LSM303_CTRL_REG5_A = 36,\n LSM303_CTRL_REG6_A = 37,\n LSM303_DATACAPTURE_A = 38,\n LSM303_STATUS_REG_A = 39,\n LSM303_OUT_X_L_A = 40,\n LSM303_OUT_X_H_A = 41,\n LSM303_OUT_Y_L_A = 42,\n LSM303_OUT_Y_H_A = 43,\n LSM303_OUT_Z_L_A = 44,\n LSM303_OUT_Z_H_A = 45,\n LSM303_FIFO_CTRL_REG_A = 46,\n LSM303_FIFO_SRC_REG_A = 47,\n LSM303_INT1_CFG_A = 48,\n LSM303_INT1_SRC_A = 49,\n LSM303_INT1_THS_A = 50,\n LSM303_INT1_DURATION_A = 51,\n LSM303_INT2_CFG_A = 52,\n LSM303_INT2_SRC_A = 53,\n LSM303_INT2_THS_A = 54,\n LSM303_INT2_DURATION_A = 55,\n LSM303_CLICK_CFG_A = 56,\n LSM303_CLICK_SRC_A = 57,\n LSM303_CLICK_THS_A = 58,\n LSM303_TIME_LIMIT_A = 59,\n LSM303_TIME_LATENCY_A = 60,\n LSM303_TIME_WINDOW_A = 61,\n LSM303_ACT_THS_A = 62,\n LSM303_ACT_DUR_A = 63,\n LSM303_A_WHOAMI_VAL = 51,\n LSM303_A_STATUS_DATA_READY = 8,\n LSM303_A_STATUS_ENABLED = 256,\n LSM303_A_STATUS_SLEEPING = 512,\n // /libraries/codal-core/inc/drivers/LSM303Magnetometer.h\n LSM303_M_WHOAMI_VAL = 64,\n LSM303_M_DEFAULT_ADDR = 60,\n LSM303_OFFSET_X_REG_L_M = 69,\n LSM303_OFFSET_X_REG_H_M = 70,\n LSM303_OFFSET_Y_REG_L_M = 71,\n LSM303_OFFSET_Y_REG_H_M = 72,\n LSM303_OFFSET_Z_REG_L_M = 73,\n LSM303_OFFSET_Z_REG_H_M = 74,\n LSM303_WHO_AM_I_M = 79,\n LSM303_CFG_REG_A_M = 96,\n LSM303_CFG_REG_B_M = 97,\n LSM303_CFG_REG_C_M = 98,\n LSM303_INT_CRTL_REG_M = 99,\n LSM303_INT_SOURCE_REG_M = 100,\n LSM303_INT_THS_L_REG_M = 101,\n LSM303_INT_THS_H_REG_M = 102,\n LSM303_STATUS_REG_M = 103,\n LSM303_OUTX_L_REG_M = 104,\n LSM303_OUTX_H_REG_M = 105,\n LSM303_OUTY_L_REG_M = 106,\n LSM303_OUTY_H_REG_M = 107,\n LSM303_OUTZ_L_REG_M = 108,\n LSM303_OUTZ_H_REG_M = 109,\n LSM303_M_STATUS_DATA_READY = 8,\n LSM303_M_STATUS_ENABLED = 256,\n LSM303_M_STATUS_SLEEPING = 512,\n // /libraries/codal-core/inc/drivers/MultiButton.h\n MULTI_BUTTON_STATE_1 = 1,\n MULTI_BUTTON_STATE_2 = 2,\n MULTI_BUTTON_HOLD_TRIGGERED_1 = 4,\n MULTI_BUTTON_HOLD_TRIGGERED_2 = 8,\n MULTI_BUTTON_SUPRESSED_1 = 16,\n MULTI_BUTTON_SUPRESSED_2 = 32,\n MULTI_BUTTON_ATTACHED = 64,\n // /libraries/codal-core/inc/drivers/PulseIn.h\n DEVICE_EVT_PULSE_IN_TIMEOUT = 10000,\n // /libraries/codal-core/inc/drivers/TouchButton.h\n TOUCH_BUTTON_CALIBRATION_LINEAR_OFFSET = 2,\n TOUCH_BUTTON_CALIBRATION_PERCENTAGE_OFFSET = 5,\n TOUCH_BUTTON_SENSITIVITY = 10,\n TOUCH_BUTTON_CALIBRATION_PERIOD = 10,\n TOUCH_BUTTON_CALIBRATING = 16,\n // /libraries/codal-core/inc/drivers/TouchSensor.h\n TOUCH_SENSOR_MAX_BUTTONS = 10,\n TOUCH_SENSOR_SAMPLE_PERIOD = 50,\n TOUCH_SENSE_SAMPLE_MAX = 1000,\n TOUCH_SENSOR_UPDATE_NEEDED = 1,\n // /libraries/codal-core/inc/drivers/USB_HID_Keys.h\n KEY_MOD_LCTRL = 1,\n KEY_MOD_LSHIFT = 2,\n KEY_MOD_LALT = 4,\n KEY_MOD_LMETA = 8,\n KEY_MOD_RCTRL = 16,\n KEY_MOD_RSHIFT = 32,\n KEY_MOD_RALT = 64,\n KEY_MOD_RMETA = 128,\n KEY_NONE = 0,\n KEY_ERR_OVF = 1,\n KEY_A = 4,\n KEY_B = 5,\n KEY_C = 6,\n KEY_D = 7,\n KEY_E = 8,\n KEY_F = 9,\n KEY_G = 10,\n KEY_H = 11,\n KEY_I = 12,\n KEY_J = 13,\n KEY_K = 14,\n KEY_L = 15,\n KEY_M = 16,\n KEY_N = 17,\n KEY_O = 18,\n KEY_P = 19,\n KEY_Q = 20,\n KEY_R = 21,\n KEY_S = 22,\n KEY_T = 23,\n KEY_U = 24,\n KEY_V = 25,\n KEY_W = 26,\n KEY_X = 27,\n KEY_Y = 28,\n KEY_Z = 29,\n KEY_1 = 30,\n KEY_2 = 31,\n KEY_3 = 32,\n KEY_4 = 33,\n KEY_5 = 34,\n KEY_6 = 35,\n KEY_7 = 36,\n KEY_8 = 37,\n KEY_9 = 38,\n KEY_0 = 39,\n KEY_ENTER = 40,\n KEY_ESC = 41,\n KEY_BACKSPACE = 42,\n KEY_TAB = 43,\n KEY_SPACE = 44,\n KEY_MINUS = 45,\n KEY_EQUAL = 46,\n KEY_LEFTBRACE = 47,\n KEY_RIGHTBRACE = 48,\n KEY_BACKSLASH = 49,\n KEY_HASHTILDE = 50,\n KEY_SEMICOLON = 51,\n KEY_APOSTROPHE = 52,\n KEY_GRAVE = 53,\n KEY_COMMA = 54,\n KEY_DOT = 55,\n KEY_SLASH = 56,\n KEY_CAPSLOCK = 57,\n KEY_F1 = 58,\n KEY_F2 = 59,\n KEY_F3 = 60,\n KEY_F4 = 61,\n KEY_F5 = 62,\n KEY_F6 = 63,\n KEY_F7 = 64,\n KEY_F8 = 65,\n KEY_F9 = 66,\n KEY_F10 = 67,\n KEY_F11 = 68,\n KEY_F12 = 69,\n KEY_SYSRQ = 70,\n KEY_SCROLLLOCK = 71,\n KEY_PAUSE = 72,\n KEY_INSERT = 73,\n KEY_HOME = 74,\n KEY_PAGEUP = 75,\n KEY_DELETE = 76,\n KEY_END = 77,\n KEY_PAGEDOWN = 78,\n KEY_RIGHT = 79,\n KEY_LEFT = 80,\n KEY_DOWN = 81,\n KEY_UP = 82,\n KEY_NUMLOCK = 83,\n KEY_KPSLASH = 84,\n KEY_KPASTERISK = 85,\n KEY_KPMINUS = 86,\n KEY_KPPLUS = 87,\n KEY_KPENTER = 88,\n KEY_KP1 = 89,\n KEY_KP2 = 90,\n KEY_KP3 = 91,\n KEY_KP4 = 92,\n KEY_KP5 = 93,\n KEY_KP6 = 94,\n KEY_KP7 = 95,\n KEY_KP8 = 96,\n KEY_KP9 = 97,\n KEY_KP0 = 98,\n KEY_KPDOT = 99,\n KEY_102ND = 100,\n KEY_COMPOSE = 101,\n KEY_POWER = 102,\n KEY_KPEQUAL = 103,\n KEY_F13 = 104,\n KEY_F14 = 105,\n KEY_F15 = 106,\n KEY_F16 = 107,\n KEY_F17 = 108,\n KEY_F18 = 109,\n KEY_F19 = 110,\n KEY_F20 = 111,\n KEY_F21 = 112,\n KEY_F22 = 113,\n KEY_F23 = 114,\n KEY_F24 = 115,\n KEY_OPEN = 116,\n KEY_HELP = 117,\n KEY_PROPS = 118,\n KEY_FRONT = 119,\n KEY_STOP = 120,\n KEY_AGAIN = 121,\n KEY_UNDO = 122,\n KEY_CUT = 123,\n KEY_COPY = 124,\n KEY_PASTE = 125,\n KEY_FIND = 126,\n KEY_MUTE = 127,\n KEY_VOLUMEUP = 128,\n KEY_VOLUMEDOWN = 129,\n KEY_KPCOMMA = 133,\n KEY_RO = 135,\n KEY_KATAKANAHIRAGANA = 136,\n KEY_YEN = 137,\n KEY_HENKAN = 138,\n KEY_MUHENKAN = 139,\n KEY_KPJPCOMMA = 140,\n KEY_HANGEUL = 144,\n KEY_HANJA = 145,\n KEY_KATAKANA = 146,\n KEY_HIRAGANA = 147,\n KEY_ZENKAKUHANKAKU = 148,\n KEY_KPLEFTPAREN = 182,\n KEY_KPRIGHTPAREN = 183,\n KEY_LEFTCTRL = 224,\n KEY_LEFTSHIFT = 225,\n KEY_LEFTALT = 226,\n KEY_LEFTMETA = 227,\n KEY_RIGHTCTRL = 228,\n KEY_RIGHTSHIFT = 229,\n KEY_RIGHTALT = 230,\n KEY_RIGHTMETA = 231,\n KEY_MEDIA_PLAYPAUSE = 232,\n KEY_MEDIA_STOPCD = 233,\n KEY_MEDIA_PREVIOUSSONG = 234,\n KEY_MEDIA_NEXTSONG = 235,\n KEY_MEDIA_EJECTCD = 236,\n KEY_MEDIA_VOLUMEUP = 237,\n KEY_MEDIA_VOLUMEDOWN = 238,\n KEY_MEDIA_MUTE = 239,\n KEY_MEDIA_WWW = 240,\n KEY_MEDIA_BACK = 241,\n KEY_MEDIA_FORWARD = 242,\n KEY_MEDIA_STOP = 243,\n KEY_MEDIA_FIND = 244,\n KEY_MEDIA_SCROLLUP = 245,\n KEY_MEDIA_SCROLLDOWN = 246,\n KEY_MEDIA_EDIT = 247,\n KEY_MEDIA_SLEEP = 248,\n KEY_MEDIA_COFFEE = 249,\n KEY_MEDIA_REFRESH = 250,\n KEY_MEDIA_CALC = 251,\n // /libraries/codal-core/inc/drivers/uf2format.h\n UF2FORMAT_H = 1,\n APP_START_ADDRESS = 8192,\n UF2_FLAG_NOFLASH = 1,\n // /libraries/codal-core/inc/streams/DataStream.h\n DATASTREAM_MAXIMUM_BUFFERS = 1,\n DATASTREAM_FORMAT_UNKNOWN = 0,\n DATASTREAM_FORMAT_8BIT_UNSIGNED = 1,\n DATASTREAM_FORMAT_8BIT_SIGNED = 2,\n DATASTREAM_FORMAT_16BIT_UNSIGNED = 3,\n DATASTREAM_FORMAT_16BIT_SIGNED = 4,\n DATASTREAM_FORMAT_24BIT_UNSIGNED = 5,\n DATASTREAM_FORMAT_24BIT_SIGNED = 6,\n DATASTREAM_FORMAT_32BIT_UNSIGNED = 7,\n DATASTREAM_FORMAT_32BIT_SIGNED = 8,\n // /libraries/codal-core/inc/streams/LevelDetector.h\n LEVEL_THRESHOLD_LOW = 1,\n LEVEL_THRESHOLD_HIGH = 2,\n LEVEL_DETECTOR_INITIALISED = 1,\n LEVEL_DETECTOR_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/LevelDetectorSPL.h\n LEVEL_DETECTOR_SPL_INITIALISED = 1,\n LEVEL_DETECTOR_SPL_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_SPL_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_SPL_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/MemorySource.h\n MEMORY_SOURCE_DEFAULT_MAX_BUFFER = 256,\n // /libraries/codal-core/inc/streams/Synthesizer.h\n SYNTHESIZER_SAMPLE_RATE = 44100,\n TONE_WIDTH = 1024,\n // /libraries/codal-core/inc/types/BitmapFont.h\n BITMAP_FONT_WIDTH = 5,\n BITMAP_FONT_HEIGHT = 5,\n BITMAP_FONT_ASCII_START = 32,\n BITMAP_FONT_ASCII_END = 126,\n // /libraries/codal-core/inc/types/CoordinateSystem.h\n COORDINATE_SPACE_ROTATED_0 = 0,\n COORDINATE_SPACE_ROTATED_90 = 1,\n COORDINATE_SPACE_ROTATED_180 = 2,\n COORDINATE_SPACE_ROTATED_270 = 3,\n RAW = 0,\n SIMPLE_CARTESIAN = 1,\n NORTH_EAST_DOWN = 2,\n EAST_NORTH_UP = 3,\n NORTH_EAST_UP = 3,\n // /libraries/codal-core/inc/types/Event.h\n DEVICE_ID_ANY = 0,\n DEVICE_EVT_ANY = 0,\n CREATE_ONLY = 0,\n CREATE_AND_FIRE = 1,\n DEVICE_EVENT_DEFAULT_LAUNCH_MODE = 1,\n // /libraries/codal-core/inc/types/ManagedBuffer.h\n Zero = 1,\n // /libraries/codal-core/inc/types/RefCounted.h\n REF_TAG_STRING = 1,\n REF_TAG_BUFFER = 2,\n REF_TAG_IMAGE = 3,\n REF_TAG_USER = 32,\n // /pxtapp/accelerometer/axis.h\n ACC_SYSTEM = 3,\n ACC_ROTATION = 0,\n // /pxtapp/configkeys.h\n CFG_PIN_NAME_MSK = 65535,\n CFG_PIN_CONFIG_MSK = 4294901760,\n CFG_PIN_CONFIG_ACTIVE_LO = 65536,\n CFG_MAGIC0 = 513675505,\n CFG_MAGIC1 = 539130489,\n CFG_PIN_ACCELEROMETER_INT = 1,\n CFG_PIN_ACCELEROMETER_SCL = 2,\n CFG_PIN_ACCELEROMETER_SDA = 3,\n CFG_PIN_BTN_A = 4,\n CFG_PIN_BTN_B = 5,\n CFG_PIN_BTN_SLIDE = 6,\n CFG_PIN_DOTSTAR_CLOCK = 7,\n CFG_PIN_DOTSTAR_DATA = 8,\n CFG_PIN_FLASH_CS = 9,\n CFG_PIN_FLASH_MISO = 10,\n CFG_PIN_FLASH_MOSI = 11,\n CFG_PIN_FLASH_SCK = 12,\n CFG_PIN_LED = 13,\n CFG_PIN_LIGHT = 14,\n CFG_PIN_MICROPHONE = 15,\n CFG_PIN_MIC_CLOCK = 16,\n CFG_PIN_MIC_DATA = 17,\n CFG_PIN_MISO = 18,\n CFG_PIN_MOSI = 19,\n CFG_PIN_NEOPIXEL = 20,\n CFG_PIN_RX = 21,\n CFG_PIN_RXLED = 22,\n CFG_PIN_SCK = 23,\n CFG_PIN_SCL = 24,\n CFG_PIN_SDA = 25,\n CFG_PIN_SPEAKER_AMP = 26,\n CFG_PIN_TEMPERATURE = 27,\n CFG_PIN_TX = 28,\n CFG_PIN_TXLED = 29,\n CFG_PIN_IR_OUT = 30,\n CFG_PIN_IR_IN = 31,\n CFG_PIN_DISPLAY_SCK = 32,\n CFG_PIN_DISPLAY_MISO = 33,\n CFG_PIN_DISPLAY_MOSI = 34,\n CFG_PIN_DISPLAY_CS = 35,\n CFG_PIN_DISPLAY_DC = 36,\n CFG_DISPLAY_WIDTH = 37,\n CFG_DISPLAY_HEIGHT = 38,\n CFG_DISPLAY_CFG0 = 39,\n CFG_DISPLAY_CFG1 = 40,\n CFG_DISPLAY_CFG2 = 41,\n CFG_DISPLAY_CFG3 = 42,\n CFG_PIN_DISPLAY_RST = 43,\n CFG_PIN_DISPLAY_BL = 44,\n CFG_PIN_SERVO_1 = 45,\n CFG_PIN_SERVO_2 = 46,\n CFG_PIN_BTN_LEFT = 47,\n CFG_PIN_BTN_RIGHT = 48,\n CFG_PIN_BTN_UP = 49,\n CFG_PIN_BTN_DOWN = 50,\n CFG_PIN_BTN_MENU = 51,\n CFG_PIN_LED_R = 52,\n CFG_PIN_LED_G = 53,\n CFG_PIN_LED_B = 54,\n CFG_PIN_LED1 = 55,\n CFG_PIN_LED2 = 56,\n CFG_PIN_LED3 = 57,\n CFG_PIN_LED4 = 58,\n CFG_SPEAKER_VOLUME = 59,\n CFG_PIN_JACK_TX = 60,\n CFG_PIN_JACK_SENSE = 61,\n CFG_PIN_JACK_HPEN = 62,\n CFG_PIN_JACK_BZEN = 63,\n CFG_PIN_JACK_PWREN = 64,\n CFG_PIN_JACK_SND = 65,\n CFG_PIN_JACK_BUSLED = 66,\n CFG_PIN_JACK_COMMLED = 67,\n CFG_PIN_BTN_SOFT_RESET = 69,\n CFG_ACCELEROMETER_TYPE = 70,\n CFG_PIN_BTNMX_LATCH = 71,\n CFG_PIN_BTNMX_CLOCK = 72,\n CFG_PIN_BTNMX_DATA = 73,\n CFG_PIN_BTN_MENU2 = 74,\n CFG_PIN_BATTSENSE = 75,\n CFG_PIN_VIBRATION = 76,\n CFG_PIN_PWREN = 77,\n CFG_DISPLAY_TYPE = 78,\n CFG_PIN_ROTARY_ENCODER_A = 79,\n CFG_PIN_ROTARY_ENCODER_B = 80,\n CFG_ACCELEROMETER_SPACE = 81,\n CFG_PIN_WIFI_MOSI = 82,\n CFG_PIN_WIFI_MISO = 83,\n CFG_PIN_WIFI_SCK = 84,\n CFG_PIN_WIFI_TX = 85,\n CFG_PIN_WIFI_RX = 86,\n CFG_PIN_WIFI_CS = 87,\n CFG_PIN_WIFI_BUSY = 88,\n CFG_PIN_WIFI_RESET = 89,\n CFG_PIN_WIFI_GPIO0 = 90,\n CFG_PIN_WIFI_AT_TX = 91,\n CFG_PIN_WIFI_AT_RX = 92,\n CFG_PIN_USB_POWER = 93,\n ACCELEROMETER_TYPE_LIS3DH = 50,\n ACCELEROMETER_TYPE_LIS3DH_ALT = 48,\n ACCELEROMETER_TYPE_MMA8453 = 56,\n ACCELEROMETER_TYPE_FXOS8700 = 60,\n ACCELEROMETER_TYPE_MMA8653 = 58,\n ACCELEROMETER_TYPE_MSA300 = 76,\n ACCELEROMETER_TYPE_MPU6050 = 104,\n DISPLAY_TYPE_ST7735 = 7735,\n DISPLAY_TYPE_ILI9341 = 9341,\n DISPLAY_TYPE_SMART = 4242,\n CFG_PIN_A0 = 100,\n CFG_PIN_A1 = 101,\n CFG_PIN_A2 = 102,\n CFG_PIN_A3 = 103,\n CFG_PIN_A4 = 104,\n CFG_PIN_A5 = 105,\n CFG_PIN_A6 = 106,\n CFG_PIN_A7 = 107,\n CFG_PIN_A8 = 108,\n CFG_PIN_A9 = 109,\n CFG_PIN_A10 = 110,\n CFG_PIN_A11 = 111,\n CFG_PIN_A12 = 112,\n CFG_PIN_A13 = 113,\n CFG_PIN_A14 = 114,\n CFG_PIN_A15 = 115,\n CFG_PIN_A16 = 116,\n CFG_PIN_A17 = 117,\n CFG_PIN_A18 = 118,\n CFG_PIN_A19 = 119,\n CFG_PIN_A20 = 120,\n CFG_PIN_A21 = 121,\n CFG_PIN_A22 = 122,\n CFG_PIN_A23 = 123,\n CFG_PIN_A24 = 124,\n CFG_PIN_A25 = 125,\n CFG_PIN_A26 = 126,\n CFG_PIN_A27 = 127,\n CFG_PIN_A28 = 128,\n CFG_PIN_A29 = 129,\n CFG_PIN_A30 = 130,\n CFG_PIN_A31 = 131,\n CFG_PIN_D0 = 150,\n CFG_PIN_D1 = 151,\n CFG_PIN_D2 = 152,\n CFG_PIN_D3 = 153,\n CFG_PIN_D4 = 154,\n CFG_PIN_D5 = 155,\n CFG_PIN_D6 = 156,\n CFG_PIN_D7 = 157,\n CFG_PIN_D8 = 158,\n CFG_PIN_D9 = 159,\n CFG_PIN_D10 = 160,\n CFG_PIN_D11 = 161,\n CFG_PIN_D12 = 162,\n CFG_PIN_D13 = 163,\n CFG_PIN_D14 = 164,\n CFG_PIN_D15 = 165,\n CFG_PIN_D16 = 166,\n CFG_PIN_D17 = 167,\n CFG_PIN_D18 = 168,\n CFG_PIN_D19 = 169,\n CFG_PIN_D20 = 170,\n CFG_PIN_D21 = 171,\n CFG_PIN_D22 = 172,\n CFG_PIN_D23 = 173,\n CFG_PIN_D24 = 174,\n CFG_PIN_D25 = 175,\n CFG_PIN_D26 = 176,\n CFG_PIN_D27 = 177,\n CFG_PIN_D28 = 178,\n CFG_PIN_D29 = 179,\n CFG_PIN_D30 = 180,\n CFG_PIN_D31 = 181,\n CFG_NUM_NEOPIXELS = 200,\n CFG_NUM_DOTSTARS = 201,\n CFG_DEFAULT_BUTTON_MODE = 202,\n CFG_SWD_ENABLED = 203,\n CFG_FLASH_BYTES = 204,\n CFG_RAM_BYTES = 205,\n CFG_SYSTEM_HEAP_BYTES = 206,\n CFG_LOW_MEM_SIMULATION_KB = 207,\n CFG_BOOTLOADER_BOARD_ID = 208,\n CFG_UF2_FAMILY = 209,\n CFG_PINS_PORT_SIZE = 210,\n CFG_BOOTLOADER_PROTECTION = 211,\n CFG_POWER_DEEPSLEEP_TIMEOUT = 212,\n CFG_ANALOG_BUTTON_THRESHOLD = 213,\n CFG_CPU_MHZ = 214,\n CFG_CONTROLLER_LIGHT_MAX_BRIGHTNESS = 215,\n CFG_ANALOG_JOYSTICK_MIN = 216,\n CFG_ANALOG_JOYSTICK_MAX = 217,\n CFG_TIMERS_TO_USE = 218,\n CFG_PIN_ONBOARD_DOTSTAR_CLOCK = 219,\n CFG_PIN_ONBOARD_DOTSTAR_DATA = 220,\n CFG_NUM_ONBOARD_DOTSTARS = 221,\n CFG_PIN_ONBOARD_NEOPIXEL = 222,\n CFG_NUM_ONBOARD_NEOPIXELS = 223,\n CFG_MATRIX_KEYPAD_MESSAGE_ID = 239,\n CFG_NUM_MATRIX_KEYPAD_ROWS = 240,\n CFG_PIN_MATRIX_KEYPAD_ROW0 = 241,\n CFG_PIN_MATRIX_KEYPAD_ROW1 = 242,\n CFG_PIN_MATRIX_KEYPAD_ROW2 = 243,\n CFG_PIN_MATRIX_KEYPAD_ROW3 = 244,\n CFG_PIN_MATRIX_KEYPAD_ROW4 = 245,\n CFG_PIN_MATRIX_KEYPAD_ROW5 = 246,\n CFG_PIN_MATRIX_KEYPAD_ROW6 = 247,\n CFG_PIN_MATRIX_KEYPAD_ROW7 = 248,\n CFG_NUM_MATRIX_KEYPAD_COLS = 250,\n CFG_PIN_MATRIX_KEYPAD_COL0 = 251,\n CFG_PIN_MATRIX_KEYPAD_COL1 = 252,\n CFG_PIN_MATRIX_KEYPAD_COL2 = 253,\n CFG_PIN_MATRIX_KEYPAD_COL3 = 254,\n CFG_PIN_MATRIX_KEYPAD_COL4 = 255,\n CFG_PIN_MATRIX_KEYPAD_COL5 = 256,\n CFG_PIN_MATRIX_KEYPAD_COL6 = 257,\n CFG_PIN_MATRIX_KEYPAD_COL7 = 258,\n CFG_PIN_B0 = 300,\n CFG_PIN_B1 = 301,\n CFG_PIN_B2 = 302,\n CFG_PIN_B3 = 303,\n CFG_PIN_B4 = 304,\n CFG_PIN_B5 = 305,\n CFG_PIN_B6 = 306,\n CFG_PIN_B7 = 307,\n CFG_PIN_B8 = 308,\n CFG_PIN_B9 = 309,\n CFG_PIN_B10 = 310,\n CFG_PIN_B11 = 311,\n CFG_PIN_B12 = 312,\n CFG_PIN_B13 = 313,\n CFG_PIN_B14 = 314,\n CFG_PIN_B15 = 315,\n CFG_PIN_B16 = 316,\n CFG_PIN_B17 = 317,\n CFG_PIN_B18 = 318,\n CFG_PIN_B19 = 319,\n CFG_PIN_B20 = 320,\n CFG_PIN_B21 = 321,\n CFG_PIN_B22 = 322,\n CFG_PIN_B23 = 323,\n CFG_PIN_B24 = 324,\n CFG_PIN_B25 = 325,\n CFG_PIN_B26 = 326,\n CFG_PIN_B27 = 327,\n CFG_PIN_B28 = 328,\n CFG_PIN_B29 = 329,\n CFG_PIN_B30 = 330,\n CFG_PIN_B31 = 331,\n CFG_PIN_C0 = 350,\n CFG_PIN_C1 = 351,\n CFG_PIN_C2 = 352,\n CFG_PIN_C3 = 353,\n CFG_PIN_C4 = 354,\n CFG_PIN_C5 = 355,\n CFG_PIN_C6 = 356,\n CFG_PIN_C7 = 357,\n CFG_PIN_C8 = 358,\n CFG_PIN_C9 = 359,\n CFG_PIN_C10 = 360,\n CFG_PIN_C11 = 361,\n CFG_PIN_C12 = 362,\n CFG_PIN_C13 = 363,\n CFG_PIN_C14 = 364,\n CFG_PIN_C15 = 365,\n CFG_PIN_C16 = 366,\n CFG_PIN_C17 = 367,\n CFG_PIN_C18 = 368,\n CFG_PIN_C19 = 369,\n CFG_PIN_C20 = 370,\n CFG_PIN_C21 = 371,\n CFG_PIN_C22 = 372,\n CFG_PIN_C23 = 373,\n CFG_PIN_C24 = 374,\n CFG_PIN_C25 = 375,\n CFG_PIN_C26 = 376,\n CFG_PIN_C27 = 377,\n CFG_PIN_C28 = 378,\n CFG_PIN_C29 = 379,\n CFG_PIN_C30 = 380,\n CFG_PIN_C31 = 381,\n CFG_PIN_P0 = 400,\n CFG_PIN_P1 = 401,\n CFG_PIN_P2 = 402,\n CFG_PIN_P3 = 403,\n CFG_PIN_P4 = 404,\n CFG_PIN_P5 = 405,\n CFG_PIN_P6 = 406,\n CFG_PIN_P7 = 407,\n CFG_PIN_P8 = 408,\n CFG_PIN_P9 = 409,\n CFG_PIN_P10 = 410,\n CFG_PIN_P11 = 411,\n CFG_PIN_P12 = 412,\n CFG_PIN_P13 = 413,\n CFG_PIN_P14 = 414,\n CFG_PIN_P15 = 415,\n CFG_PIN_P16 = 416,\n CFG_PIN_P17 = 417,\n CFG_PIN_P18 = 418,\n CFG_PIN_P19 = 419,\n CFG_PIN_P20 = 420,\n CFG_PIN_P21 = 421,\n CFG_PIN_P22 = 422,\n CFG_PIN_P23 = 423,\n CFG_PIN_P24 = 424,\n CFG_PIN_P25 = 425,\n CFG_PIN_P26 = 426,\n CFG_PIN_P27 = 427,\n CFG_PIN_P28 = 428,\n CFG_PIN_P29 = 429,\n CFG_PIN_P30 = 430,\n CFG_PIN_P31 = 431,\n CFG_PIN_P32 = 432,\n CFG_PIN_P33 = 433,\n CFG_PIN_P34 = 434,\n CFG_PIN_P35 = 435,\n CFG_PIN_P36 = 436,\n CFG_PIN_P37 = 437,\n CFG_PIN_P38 = 438,\n CFG_PIN_P39 = 439,\n CFG_PIN_P40 = 440,\n CFG_PIN_P41 = 441,\n CFG_PIN_P42 = 442,\n CFG_PIN_P43 = 443,\n CFG_PIN_P44 = 444,\n CFG_PIN_P45 = 445,\n CFG_PIN_P46 = 446,\n CFG_PIN_P47 = 447,\n CFG_PIN_P48 = 448,\n CFG_PIN_P49 = 449,\n CFG_PIN_P50 = 450,\n CFG_PIN_P51 = 451,\n CFG_PIN_P52 = 452,\n CFG_PIN_P53 = 453,\n CFG_PIN_P54 = 454,\n CFG_PIN_P55 = 455,\n CFG_PIN_P56 = 456,\n CFG_PIN_P57 = 457,\n CFG_PIN_P58 = 458,\n CFG_PIN_P59 = 459,\n CFG_PIN_P60 = 460,\n CFG_PIN_P61 = 461,\n CFG_PIN_P62 = 462,\n CFG_PIN_P63 = 463,\n CFG_PIN_LORA_MISO = 1001,\n CFG_PIN_LORA_MOSI = 1002,\n CFG_PIN_LORA_SCK = 1003,\n CFG_PIN_LORA_CS = 1004,\n CFG_PIN_LORA_BOOT = 1005,\n CFG_PIN_LORA_RESET = 1006,\n CFG_PIN_IRRXLED = 1007,\n CFG_PIN_IRTXLED = 1008,\n CFG_PIN_LCD_RESET = 1009,\n CFG_PIN_LCD_ENABLE = 1010,\n CFG_PIN_LCD_DATALINE4 = 1011,\n CFG_PIN_LCD_DATALINE5 = 1012,\n CFG_PIN_LCD_DATALINE6 = 1013,\n CFG_PIN_LCD_DATALINE7 = 1014,\n CFG_NUM_LCD_COLUMNS = 1015,\n CFG_NUM_LCD_ROWS = 1016,\n CFG_PIN_RCC0 = 1017,\n CFG_PIN_RCC1 = 1018,\n CFG_PIN_RCC2 = 1019,\n CFG_PIN_RCC3 = 1020,\n CFG_PIN_RCC4 = 1021,\n CFG_PIN_RCC5 = 1022,\n CFG_PIN_RCC6 = 1023,\n CFG_PIN_RCC7 = 1024,\n CFG_PIN_SERVO0 = 1025,\n CFG_PIN_SERVO1 = 1026,\n CFG_PIN_SERVO2 = 1027,\n CFG_PIN_SERVO3 = 1028,\n CFG_PIN_SERVO4 = 1029,\n CFG_PIN_SERVO5 = 1030,\n CFG_PIN_SERVO6 = 1031,\n CFG_PIN_SERVO7 = 1032,\n CFG_PIN_SERVO8 = 1033,\n CFG_PIN_PI_TX = 1034,\n CFG_PIN_PI_RX = 1035,\n CFG_PIN_GPS_SDA = 1036,\n CFG_PIN_GPS_SCL = 1037,\n CFG_PIN_GPS_TX = 1038,\n CFG_PIN_GPS_RX = 1039,\n CFG_PIN_GROVE0 = 1040,\n CFG_PIN_GROVE1 = 1041,\n CFG_PIN_SS = 1042,\n CFG_PIN_D33 = 183,\n CFG_PIN_D34 = 184,\n CFG_PIN_D35 = 185,\n CFG_PIN_D36 = 186,\n CFG_PIN_D37 = 187,\n CFG_PIN_D38 = 188,\n CFG_PIN_D39 = 189,\n CFG_PIN_D40 = 190,\n CFG_PIN_D41 = 191,\n CFG_PIN_D42 = 192,\n CFG_PIN_D43 = 193,\n CFG_PIN_D44 = 194,\n CFG_PIN_D45 = 195,\n CFG_PIN_D46 = 196,\n CFG_PIN_D47 = 197,\n CFG_PIN_D48 = 198,\n CFG_PIN_D49 = 199,\n CFG_PIN_D50 = 259,\n CFG_PIN_D51 = 260,\n CFG_PIN_D52 = 261,\n CFG_PIN_D53 = 262,\n CFG_PIN_TX1 = 263,\n CFG_PIN_TX2 = 264,\n CFG_PIN_TX3 = 265,\n CFG_PIN_RX1 = 266,\n CFG_PIN_RX2 = 267,\n CFG_PIN_RX3 = 268,\n CFG_PIN_SCL1 = 269,\n CFG_PIN_SDA1 = 270,\n CFG_PIN_PCC_D0 = 271,\n CFG_PIN_PCC_D1 = 272,\n CFG_PIN_PCC_D2 = 273,\n CFG_PIN_PCC_D3 = 274,\n CFG_PIN_PCC_D4 = 275,\n CFG_PIN_PCC_D5 = 276,\n CFG_PIN_PCC_D6 = 277,\n CFG_PIN_PCC_D7 = 278,\n CFG_PIN_PCC_D8 = 279,\n CFG_PIN_PCC_D9 = 280,\n CFG_PIN_PCC_D10 = 281,\n CFG_PIN_PCC_D11 = 282,\n CFG_PIN_PCC_D12 = 283,\n CFG_PIN_PCC_D13 = 284,\n CFG_PIN_CC_DEN1 = 285,\n CFG_PIN_CC_DEN2 = 286,\n CFG_PIN_CC_CLK = 287,\n CFG_PIN_XCC_CLK = 288,\n CFG_PIN_JDPWR_PRE_SENSE = 1100,\n CFG_PIN_JDPWR_GND_SENSE = 1101,\n CFG_PIN_JDPWR_PULSE = 1102,\n CFG_PIN_JDPWR_OVERLOAD_LED = 1103,\n CFG_PIN_JDPWR_ENABLE = 1104,\n CFG_PIN_JDPWR_FAULT = 1105,\n // /pxtapp/hf2dbg.h\n HF2DBG_H = 1,\n // /pxtapp/mixer---rp2040/melody.h\n OUTPUT_BITS = 10,\n SW_TRIANGLE = 1,\n SW_SAWTOOTH = 2,\n SW_SINE = 3,\n SW_TUNEDNOISE = 4,\n SW_NOISE = 5,\n SW_SQUARE_10 = 11,\n SW_SQUARE_50 = 15,\n SW_SQUARE_CYCLE_16 = 16,\n SW_SQUARE_CYCLE_32 = 17,\n SW_SQUARE_CYCLE_64 = 18,\n CODAL = 1,\n MAX_SOUNDS = 5,\n Waiting = 0,\n Playing = 1,\n Done = 2,\n // /pxtapp/pins.h\n BUTTON_ACTIVE_HIGH_PULL_DOWN = 17,\n BUTTON_ACTIVE_HIGH_PULL_UP = 33,\n BUTTON_ACTIVE_HIGH_PULL_NONE = 49,\n BUTTON_ACTIVE_LOW_PULL_DOWN = 16,\n BUTTON_ACTIVE_LOW_PULL_UP = 32,\n BUTTON_ACTIVE_LOW_PULL_NONE = 48,\n // /pxtapp/platform.h\n IMAGE_BITS = 4,\n PAGE_SIZE = 256,\n DEV_NUM_PINS = 30,\n DEV_PWM_PINS = 1073741823,\n DEV_AIN_PINS = 1006632960,\n DEV_ANALOG_PINS = 1073741823,\n P0 = 0,\n P1 = 1,\n P2 = 2,\n P3 = 3,\n P4 = 4,\n P5 = 5,\n P6 = 6,\n P7 = 7,\n P8 = 8,\n P9 = 9,\n P10 = 10,\n P11 = 11,\n P12 = 12,\n P13 = 13,\n P14 = 14,\n P15 = 15,\n P16 = 16,\n P17 = 17,\n P18 = 18,\n P19 = 19,\n P20 = 20,\n P21 = 21,\n P22 = 22,\n P23 = 23,\n P24 = 24,\n P25 = 25,\n P26 = 26,\n P27 = 27,\n P28 = 28,\n P29 = 29,\n P30 = 30,\n // /pxtapp/pxt.h\n PXT_COMM_BASE = 536879104,\n PXT_CODAL = 1,\n DEVICE_ID_BUTTON_SLIDE = 3000,\n DEVICE_ID_MICROPHONE = 3001,\n DEVICE_ID_FIRST_BUTTON = 4000,\n DEVICE_ID_FIRST_TOUCHBUTTON = 4100,\n PXT_INTERNAL_KEY_UP = 2050,\n PXT_INTERNAL_KEY_DOWN = 2051,\n // /pxtapp/pxtbase.h\n PXT32 = 1,\n PXT64 = 1,\n PXT_REFCNT_FLASH = 65534,\n VTABLE_MAGIC = 249,\n VTABLE_MAGIC2 = 248,\n Undefined = 0,\n Boolean = 1,\n Number = 2,\n String = 3,\n Object = 4,\n Function = 5,\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,\n MMap = 10,\n BoxedString_SkipList = 11,\n BoxedString_ASCII = 12,\n ZPin = 13,\n User0 = 16,\n IMAGE_HEADER_MAGIC = 135,\n Int8LE = 1,\n UInt8LE = 2,\n Int16LE = 3,\n UInt16LE = 4,\n Int32LE = 5,\n Int8BE = 6,\n UInt8BE = 7,\n Int16BE = 8,\n UInt16BE = 9,\n Int32BE = 10,\n UInt32LE = 11,\n UInt32BE = 12,\n Float32LE = 13,\n Float64LE = 14,\n Float32BE = 15,\n Float64BE = 16,\n NUM_TRY_FRAME_REGS = 3,\n GC = 0,\n PXT_STRING_SKIP_INCR = 16,\n // /pxtapp/pxtconfig.h\n PXT_UF2_FAMILY = 3834380118,\n // /pxtapp/screen---st7735/arcadegamepad.h\n _JACDAC_SPEC_ARCADE_GAMEPAD_H = 1,\n // /pxtapp/screen---st7735/arcadesound.h\n _JACDAC_SPEC_ARCADE_SOUND_H = 1,\n // /pxtapp/screen---st7735/indexedscreen.h\n _JACDAC_SPEC_INDEXED_SCREEN_H = 1,\n // /pxtapp/screen---st7735/jdprotocol.h\n JDSPI_MAGIC = 31437,\n JDSPI_MAGIC_NOOP = 46029,\n // /pxtapp/thermometer/target_temperature.h\n TEMPERATURE_NOMINAL_VALUE = 25,\n TEMPERATURE_NOMINAL_READING = 10000,\n TEMPERATURE_BETA = 3380,\n TEMPERATURE_SERIES_RESISTOR = 10000,\n // /pxtapp/uf2format.h\n BOOTLOADER_START = 0,\n BOOTLOADER_END = 8192,\n // /pxtapp/uf2hid.h\n UF2_HID_H = 1,\n}\n",
"dmac.cpp": "#include \"dmac.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nSINGLETON(WDMAC);\n#endif\n\n}",
"dmac.h": "#ifndef __DMAC_H\n#define __DMAC_H\n\n#include \"pxt.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nclass WDMAC {\n public:\n CODAL_DMAC dmac;\n\n WDMAC() {}\n};\n\nWDMAC* getWDMAC();\n#endif\n\n}\n\n#endif",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum PulseValue {\n //% block=high\n High = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=low\n Low = 5, // DEVICE_PIN_EVT_PULSE_LO\n }\n\n\n declare const enum PinEvent {\n //% block=\"pulse high\"\n PulseHigh = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=\"pulse low\"\n PulseLow = 5, // DEVICE_PIN_EVT_PULSE_LO\n //% block=\"rise\"\n Rise = 2, // DEVICE_PIN_EVT_RISE\n //% block=\"fall\"\n Fall = 3, // DEVICE_PIN_EVT_FALL\n }\n\n\n declare const enum PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"hf2.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#ifndef USB_HANDOVER\n#define USB_HANDOVER 1\n#endif\n\n#if USB_HANDOVER\n#define UF2_DEFINE_HANDOVER 1\n#endif\n\n#include \"uf2format.h\"\n\nstatic void *stackCopy;\nstatic uint32_t stackSize;\n\n//#define LOG DMESG\n#define LOG(...) ((void)0)\n\nstatic volatile bool resume = false;\n\nusing namespace codal;\n\n#ifdef HF2_HID\nstatic const char hidDescriptor[] = {\n 0x06, 0x97, 0xFF, // usage page vendor 0x97 (usage 0xff97 0x0001)\n 0x09, 0x01, // usage 1\n 0xA1, 0x01, // collection - application\n 0x15, 0x00, // logical min 0\n 0x26, 0xFF, 0x00, // logical max 255\n 0x75, 8, // report size 8\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x81, 0x02, // input: data, variable, absolute\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x91, 0x02, // output: data, variable, absolute\n 0x95, 1, // report count 1\n 0x09, 0x01, // usage 1\n 0xB1, 0x02, // feature: data, variable, absolute\n 0xC0, // end\n};\n\nstatic const HIDReportDescriptor reportDesc = {\n 9,\n 0x21, // HID\n 0x100, // hidbcd 1.00\n 0x00, // country code\n 0x01, // num desc\n 0x22, // report desc type\n sizeof(hidDescriptor), // size of 0x22\n};\n\nstatic const InterfaceInfo ifaceInfoHID = {\n &reportDesc,\n sizeof(reportDesc),\n 1,\n {\n 2, // numEndpoints\n 0x03, /// class code - HID\n 0x00, // subclass\n 0x00, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_INTERRUPT, 1},\n {USB_EP_TYPE_INTERRUPT, 1},\n};\n#endif\n\nstatic const InterfaceInfo ifaceInfoEP = {\n NULL,\n 0,\n 2,\n {\n 2, // numEndpoints\n 0xff, /// class code - vendor-specific\n 42, // subclass\n 1, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_BULK, 0},\n {USB_EP_TYPE_BULK, 0},\n};\n\nint HF2::stdRequest(UsbEndpointIn &ctrl, USBSetup &setup) {\n#ifdef HF2_HID\n if (!useHID)\n return DEVICE_NOT_SUPPORTED;\n if (setup.bRequest == USB_REQ_GET_DESCRIPTOR) {\n if (setup.wValueH == 0x21) {\n InterfaceDescriptor tmp;\n fillInterfaceInfo(&tmp);\n return ctrl.write(&tmp, sizeof(tmp));\n } else if (setup.wValueH == 0x22) {\n return ctrl.write(hidDescriptor, sizeof(hidDescriptor));\n }\n }\n#endif\n return DEVICE_NOT_SUPPORTED;\n}\n\n// same as in microbit\n#define CTRL_GET_REPORT 0x01\n#define CTRL_SET_REPORT 0x09\n#define CTRL_OUT_REPORT_H 0x2\n#define CTRL_IN_REPORT_H 0x1\n\nvoid HF2::sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend) {\n if (!CodalUSB::usbInstance->isInitialised())\n return;\n\n uint32_t buf[64 / 4]; // aligned\n\n if (prepend + 1)\n size += 4;\n\n target_disable_irq();\n while (size > 0) {\n memset(buf + 1, 0, 60);\n int s = 63;\n if (size <= 63) {\n s = size;\n buf[0] = flag;\n } else {\n buf[0] = flag == HF2_FLAG_CMDPKT_LAST ? HF2_FLAG_CMDPKT_BODY : flag;\n }\n buf[0] |= s;\n uint8_t *dst = (uint8_t *)buf;\n dst++;\n if (prepend + 1) {\n memcpy(dst, &prepend, 4);\n prepend = -1;\n dst += 4;\n s -= 4;\n size -= 4;\n }\n memcpy(dst, data, s);\n data = (const uint8_t *)data + s;\n size -= s;\n\n in->write(buf, sizeof(buf));\n }\n target_enable_irq();\n}\n\nconst InterfaceInfo *HF2::getInterfaceInfo() {\n#ifdef HF2_HID\n if (useHID)\n return &ifaceInfoHID;\n#endif\n return &ifaceInfoEP;\n}\n\nint HF2::sendEvent(uint32_t evId, const void *data, int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, evId);\n return 0;\n}\n\nint HF2::sendSerial(const void *data, int size, int isError) {\n if (!gotSomePacket)\n return DEVICE_OK;\n\n sendBuffer(isError ? HF2_FLAG_SERIAL_ERR : HF2_FLAG_SERIAL_OUT, data, size);\n\n return 0;\n}\n\n// Receive HF2 message\n// Does not block. Will store intermediate data in pkt.\n// `serial` flag is cleared if we got a command message.\nint HF2::recv() {\n uint8_t buf[64];\n\n int len = out->read(buf, sizeof(buf));\n // DMESG(\"HF2 read: %d\", len);\n\n if (len <= 0)\n return len;\n\n uint8_t tag = buf[0];\n // serial packets not allowed when in middle of command packet\n usb_assert(pkt.size == 0 || !(tag & HF2_FLAG_SERIAL_OUT));\n int size = tag & HF2_SIZE_MASK;\n usb_assert(pkt.size + size <= (int)sizeof(pkt.buf));\n memcpy(pkt.buf + pkt.size, buf + 1, size);\n pkt.size += size;\n tag &= HF2_FLAG_MASK;\n if (tag != HF2_FLAG_CMDPKT_BODY) {\n if (tag == HF2_FLAG_CMDPKT_LAST)\n pkt.serial = 0;\n else if (tag == HF2_FLAG_SERIAL_OUT)\n pkt.serial = 1;\n else\n pkt.serial = 2;\n int sz = pkt.size;\n pkt.size = 0;\n return sz;\n }\n return 0;\n}\n\nint HF2::sendResponse(int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, pkt.buf, 4 + size);\n return 0;\n}\n\nint HF2::sendResponseWithData(const void *data, int size) {\n if (size <= (int)sizeof(pkt.buf) - 4) {\n memcpy(pkt.resp.data8, data, size);\n return sendResponse(size);\n } else {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, pkt.resp.eventId);\n return 0;\n }\n}\n\nstatic void copy_words(void *dst0, const void *src0, uint32_t n_words) {\n uint32_t *dst = (uint32_t *)dst0;\n const uint32_t *src = (const uint32_t *)src0;\n while (n_words--)\n *dst++ = *src++;\n}\n\n#ifndef QUICK_BOOT\n#ifdef SAMD21\n#define DBL_TAP_PTR ((volatile uint32_t *)(HMCRAMC0_ADDR + HMCRAMC0_SIZE - 4))\n#endif\n#ifdef SAMD51\n#define DBL_TAP_PTR ((volatile uint32_t *)(HSRAM_ADDR + HSRAM_SIZE - 4))\n#endif\n#if defined(NRF52840) || defined(NRF52833)\n#define DBL_TAP_PTR ((volatile uint32_t*)0x20007F7C)\n#endif\n#define DBL_TAP_MAGIC_QUICK_BOOT 0xf02669ef\n#define QUICK_BOOT(v) *DBL_TAP_PTR = v ? DBL_TAP_MAGIC_QUICK_BOOT : 0\n#endif\n\nstatic HF2 *jdLogger;\nstatic void jdLog(const uint8_t *frame) {\n jdLogger->sendEvent(HF2_EV_JDS_PACKET, frame, frame[2] + 12);\n}\n\nint HF2::endpointRequest() {\n int sz = recv();\n\n if (!sz)\n return 0;\n\n uint32_t tmp;\n\n if (pkt.serial) {\n // TODO raise some event?\n return 0;\n }\n\n LOG(\"HF2 sz=%d CMD=%x\", sz, pkt.buf32[0]);\n\n // one has to be careful dealing with these, as they share memory\n HF2_Command *cmd = &pkt.cmd;\n HF2_Response *resp = &pkt.resp;\n\n uint32_t cmdId = cmd->command_id;\n resp->tag = cmd->tag;\n resp->status16 = HF2_STATUS_OK;\n\n#define checkDataSize(str, add) usb_assert(sz == 8 + (int)sizeof(cmd->str) + (int)(add))\n\n lastExchange = current_time_ms();\n gotSomePacket = true;\n\n switch (cmdId) {\n case HF2_CMD_INFO:\n return sendResponseWithData(uf2_info(), strlen(uf2_info()));\n\n case HF2_CMD_BININFO:\n resp->bininfo.mode = HF2_MODE_USERSPACE;\n resp->bininfo.flash_page_size = 0;\n resp->bininfo.flash_num_pages = 0;\n resp->bininfo.max_message_size = sizeof(pkt.buf);\n resp->bininfo.uf2_family = PXT_UF2_FAMILY;\n return sendResponse(sizeof(resp->bininfo));\n\n case HF2_DBG_RESTART:\n *HF2_DBG_MAGIC_PTR = HF2_DBG_MAGIC_START;\n target_reset();\n break;\n\n case HF2_CMD_RESET_INTO_APP:\n QUICK_BOOT(1);\n NVIC_SystemReset();\n break;\n case HF2_CMD_RESET_INTO_BOOTLOADER:\n QUICK_BOOT(0);\n NVIC_SystemReset();\n break;\n\n#if USB_HANDOVER\n case HF2_CMD_START_FLASH:\n sendResponse(0);\n hf2_handover(in->ep);\n usb_assert(0); // should not be reached\n break;\n#endif\n\n case HF2_CMD_WRITE_WORDS:\n checkDataSize(write_words, cmd->write_words.num_words << 2);\n copy_words((void *)cmd->write_words.target_addr, cmd->write_words.words,\n cmd->write_words.num_words);\n break;\n\n case HF2_CMD_READ_WORDS:\n checkDataSize(read_words, 0);\n tmp = cmd->read_words.num_words;\n usb_assert(tmp <= sizeof(pkt.buf) / 4 - 1);\n copy_words(resp->data32, (void *)cmd->read_words.target_addr, tmp);\n return sendResponse(tmp << 2);\n\n case HF2_CMD_DMESG:\n#if DEVICE_DMESG_BUFFER_SIZE > 0\n return sendResponseWithData(codalLogStore.buffer, codalLogStore.ptr);\n#else\n break;\n#endif\n\n case HF2_DBG_GET_GLOBAL_STATE: {\n HF2_GLOBAL_STATE_Result gstate = {\n .num_globals = (uint32_t)getNumGlobals(), //\n .globals_addr = (uint32_t)globals,\n };\n return sendResponseWithData(&gstate, sizeof(gstate));\n }\n\n case HF2_DBG_RESUME:\n globals[0] = (TValue)cmd->data32[0];\n resume = true;\n return sendResponse(0);\n\n case HF2_DBG_GET_STACK:\n return sendResponseWithData(stackCopy, stackSize);\n\n case HF2_CMD_JDS_CONFIG:\n if (cmd->data8[0]) {\n jdLogger = this;\n pxt::logJDFrame = jdLog;\n } else {\n pxt::logJDFrame = NULL;\n }\n return sendResponse(0);\n\n case HF2_CMD_JDS_SEND:\n if (pxt::sendJDFrame) {\n pxt::sendJDFrame(cmd->data8);\n return sendResponse(0);\n } else {\n resp->status16 = HF2_STATUS_INVALID_STATE;\n return sendResponse(0);\n }\n\n default:\n // command not understood\n resp->status16 = HF2_STATUS_INVALID_CMD;\n break;\n }\n\n return sendResponse(0);\n}\n\nHF2::HF2(HF2_Buffer &p) : gotSomePacket(false), ctrlWaiting(false), pkt(p), useHID(false) {\n lastExchange = 0;\n}\n\nstatic const InterfaceInfo dummyIfaceInfo = {\n NULL,\n 0,\n 0,\n {\n 0, // numEndpoints\n 0xff, /// class code - vendor-specific\n 0xff, // subclass\n 0xff, // protocol\n 0x00, // string\n 0x00, // alt\n },\n {0, 0},\n {0, 0},\n};\n\nconst InterfaceInfo *DummyIface::getInterfaceInfo() {\n return &dummyIfaceInfo;\n}\n\n//\n//\n// Debugger\n//\n//\n\nstruct ExceptionContext {\n uint32_t excReturn; // 0xFFFFFFF9\n uint32_t r0;\n uint32_t r1;\n uint32_t r2;\n uint32_t r3;\n uint32_t r12;\n uint32_t lr;\n uint32_t faultInstrAddr;\n uint32_t psr;\n};\n\nstruct Paused_Data {\n uint32_t pc;\n};\nstatic Paused_Data pausedData;\n\nvoid bkptPaused() {\n\n// waiting for https://github.com/lancaster-university/codal/pull/14\n#ifdef DEVICE_GROUP_ID_USER\n // the loop below counts as \"system\" task, and we don't want to pause ourselves\n fiber_set_group(DEVICE_GROUP_ID_SYSTEM);\n // pause everyone else\n fiber_pause_group(DEVICE_GROUP_ID_USER);\n#endif\n\n while (!resume) {\n // DMESG(\"BKPT\");\n hf2.pkt.resp.eventId = HF2_EV_DBG_PAUSED;\n hf2.sendResponseWithData(&pausedData, sizeof(pausedData));\n // TODO use an event\n for (int i = 0; i < 20; ++i) {\n if (resume)\n break;\n fiber_sleep(50);\n }\n }\n\n if (stackCopy) {\n xfree(stackCopy);\n stackCopy = NULL;\n }\n\n#ifdef DEVICE_GROUP_ID_USER\n fiber_resume_group(DEVICE_GROUP_ID_USER);\n // go back to user mode\n fiber_set_group(DEVICE_GROUP_ID_USER);\n#endif\n\n resume = false;\n}\n\nextern \"C\" void handleHardFault(ExceptionContext *ectx) {\n auto instr = (uint16_t *)ectx->faultInstrAddr;\n\n DMESG(\"FLT %p\", instr);\n\n if (ectx->faultInstrAddr & 0x80000000) {\n ectx->faultInstrAddr &= ~0x80000000;\n // switch to step-over mode\n globals[0] = (TValue)3;\n return;\n }\n\n DMESG(\"BB %p %p %p lr=%p r0=%p\", instr[-1], instr[0], instr[1], ectx->lr, ectx->r0);\n\n if (instr[0] == 0x6840) {\n // ldr r0, [r0, #4] -- entry breakpoint\n ectx->faultInstrAddr += 2;\n // we're being ask for step-over mode\n if (ectx->r0 == 3) {\n // switch to debugger-attached-no-stepping mode\n globals[0] = (TValue)0;\n ectx->lr |= 0x80000000;\n }\n return;\n }\n\n if (instr[0] == 0x6800) {\n // ldr r0, [r0, #0]\n ectx->lr = ectx->faultInstrAddr + 3; // next instruction + thumb mode\n pausedData.pc = ectx->faultInstrAddr + 2;\n void *ssp = (void *)(ectx + 1);\n stackSize = DEVICE_STACK_BASE - (uint32_t)ssp;\n if (stackCopy)\n xfree(stackCopy);\n stackCopy = xmalloc(stackSize);\n memcpy(stackCopy, ssp, stackSize);\n ectx->faultInstrAddr = ((uint32_t)(&bkptPaused) & (~1U));\n return;\n }\n\n while (1) {\n }\n}\n\nextern \"C\" void HardFault_Handler(void) {\n asm(\"push {lr}; mov r0, sp; bl handleHardFault; pop {pc}\");\n}\n\n#endif",
"hf2.h": "#ifndef DEVICE_HF2_H\n#define DEVICE_HF2_H\n\n#if CONFIG_ENABLED(DEVICE_USB)\n\n#include \"HID.h\"\n#include \"uf2hid.h\"\n\n// 260 bytes needed for biggest JD packets (with overheads)\n#define HF2_BUF_SIZE 260\n\ntypedef struct {\n uint16_t size;\n uint8_t serial;\n union {\n uint8_t buf[HF2_BUF_SIZE];\n uint32_t buf32[HF2_BUF_SIZE / 4];\n uint16_t buf16[HF2_BUF_SIZE / 2];\n HF2_Command cmd;\n HF2_Response resp;\n };\n} HF2_Buffer;\n\nclass HF2 : public CodalUSBInterface {\n bool gotSomePacket;\n bool ctrlWaiting;\n uint32_t lastExchange;\n\n public:\n HF2_Buffer &pkt;\n\n bool useHID;\n\n int sendResponse(int size);\n int recv();\n int sendResponseWithData(const void *data, int size);\n int sendEvent(uint32_t evId, const void *data, int size);\n void sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend = -1);\n\n HF2(HF2_Buffer &pkt);\n virtual int endpointRequest();\n virtual int stdRequest(UsbEndpointIn &ctrl, USBSetup &setup);\n virtual const InterfaceInfo *getInterfaceInfo();\n int sendSerial(const void *data, int size, int isError = 0);\n\n virtual bool enableWebUSB() { return !useHID; }\n};\n\nclass DummyIface : public CodalUSBInterface {\n public:\n virtual const InterfaceInfo *getInterfaceInfo();\n};\n\n#endif\n\n#endif\n",
"hf2dbg.h": "#ifndef HF2DBG_H\n#define HF2DBG_H 1\n\n// we use a location at the top of the stack to store a magic value\n// which causes us to stop at the very first break point in the program\n#define HF2_DBG_MAGIC_PTR ((uint32_t *)(DEVICE_STACK_BASE - (DEVICE_STACK_SIZE - 4)))\n#define HF2_DBG_MAGIC_START 0xf0ebac7f\n\n#define HF2_DBG_GET_GLOBAL_STATE 0x53fc66e0\nstruct HF2_GLOBAL_STATE_Result {\n uint32_t num_globals;\n uint32_t globals_addr;\n};\n\n#define HF2_DBG_RESTART 0x1120bd93\n#define HF2_DBG_RESUME 0x27a55931\n#define HF2_EV_DBG_PAUSED 0x3692f9fd\n#define HF2_DBG_GET_STACK 0x70901510\n\n#endif\n",
"i2c.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n#include \"CodalDmesg.h\"\n#include \"configkeys.h\"\n\n#ifdef CODAL_I2C\n\nnamespace pins {\n\nclass CodalI2CProxy {\nprivate:\n DevicePin* sda;\n DevicePin* scl;\n CODAL_I2C i2c;\npublic:\n CodalI2CProxy* next;\npublic:\n CodalI2CProxy(DevicePin* _sda, DevicePin* _scl)\n : sda(_sda)\n , scl(_scl)\n , i2c(*_sda, *_scl) \n , next(NULL)\n {\n\n }\n\n CODAL_I2C* getI2C() {\n return &(this->i2c);\n }\n \n bool matchPins(DevicePin* sda, DevicePin* scl) {\n return this->sda == sda && this->scl == scl;\n }\n\n Buffer readBuffer(int address, int size, bool repeat = false)\n {\n Buffer buf = mkBuffer(NULL, size);\n registerGCObj(buf);\n int status = this->i2c.read(address << 1, buf->data, size, repeat);\n unregisterGCObj(buf);\n if (status != ErrorCode::DEVICE_OK) {\n buf = 0;\n }\n return buf;\n }\n\n int writeBuffer(int address, Buffer buf, bool repeat = false)\n {\n return this->i2c.write(address << 1, buf->data, buf->length, repeat);\n }\n};\n\n}\n\nnamespace I2CMethods {\n/**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n//%\nBuffer readBuffer(I2C_ i2c, int address, int size, bool repeat = false)\n{\n return i2c->readBuffer(address, size, repeat);\n}\n\n/**\n * Write bytes to a 7-bit I2C `address`.\n */\n//%\nint writeBuffer(I2C_ i2c, int address, Buffer buf, bool repeat = false)\n{\n return i2c->writeBuffer(address, buf, repeat);\n}\n\n}\n\nnamespace pins {\n\nstatic I2C_ i2cs(NULL);\n/**\n* Opens a Serial communication driver\n*/\n//% help=pins/create-i2c\n//% parts=i2c\nI2C_ createI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n // pick up defaults\n if (!sda || !scl) {\n DMESG(\"i2c: lookup default pins\");\n sda = LOOKUP_PIN(SDA);\n scl = LOOKUP_PIN(SCL);\n }\n\n // lookup existing devices\n auto dev = i2cs;\n while(dev) {\n if (dev->matchPins(sda, scl)) {\n DMESG(\"i2c: found existing i2c\");\n return dev;\n }\n dev = dev->next;\n }\n\n // allocate new one\n DMESG(\"i2c: mounting on new device\");\n auto ser = new CodalI2CProxy(sda, scl);\n // push in list\n ser->next = i2cs;\n i2cs = ser;\n return ser;\n}\n\n}\n\nnamespace pxt {\n CODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n auto i2c = pins::createI2C(sda, scl);\n return i2c->getI2C();\n }\n}\n\n#endif",
"i2c.ts": "namespace pins {\n /**\n * Read one number from an I2C address.\n */\n //% help=pins/i2c-read-number weight=5 group=\"i2c\" inlineInputMode=\"external\"\n //% blockId=pins_i2c_readnumber block=\"i2c read number at address %address|of format %format|repeated %repeated\"\n export function i2cReadNumber(address: number, format: NumberFormat, repeated?: boolean): number {\n const buf = pins.i2cReadBuffer(address, pins.sizeOf(format), repeated)\n if (!buf)\n return undefined\n return buf.getNumber(format, 0)\n }\n\n /**\n * Write one number to an I2C address.\n */\n //% help=pins/i2c-write-number weight=4 group=\"i2c\"\n //% blockId=i2c_writenumber block=\"i2c write number|at address %address|with value %value|of format %format|repeated %repeated\"\n export function i2cWriteNumber(address: number, value: number, format?: NumberFormat, repeated?: boolean): void {\n if (format == undefined)\n format = NumberFormat.UInt8LE;\n const buf = control.createBuffer(pins.sizeOf(format))\n buf.setNumber(format, 0, value)\n pins.i2cWriteBuffer(address, buf, repeated)\n }\n\n /**\n * Write a value in a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param value value to write\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-write-register\n //% blockId=i2c_writereg block=\"i2c write register|at address $address|at register $register|value $value\"\n export function i2cWriteRegister(address: number, register: number, value: number, valueFormat?: NumberFormat): void {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n const valueSize = pins.sizeOf(valueFormat);\n const buf = control.createBuffer(1 + valueSize);\n buf.setNumber(NumberFormat.UInt8LE, 0, register);\n buf.setNumber(valueFormat, 1, value);\n pins.i2cWriteBuffer(address, buf);\n }\n\n /**\n * Read the value from a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-read-register\n //% blockId=i2c_readreg block=\"i2c read register|at address $address|at register $register\"\n export function i2cReadRegister(address: number, register: number, valueFormat?: NumberFormat): number {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n pins.i2cWriteNumber(address, register, NumberFormat.UInt8LE);\n return pins.i2cReadNumber(address, valueFormat);\n }\n\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //%\n export function i2cReadBuffer(address: number, size: number, repeat: boolean = false): Buffer {\n return pins.i2c().readBuffer(address, size, repeat);\n }\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //%\n export function i2cWriteBuffer(address: number, buf: Buffer, repeat: boolean = false): number {\n return pins.i2c().writeBuffer(address, buf, repeat);\n }\n\n let _i2c: I2C;\n /**\n * Gets the default I2C bus\n */\n //%\n export function i2c(): I2C {\n if (!_i2c) {\n const sda = pins.pinByCfg(DAL.CFG_PIN_SDA);\n const scl = pins.pinByCfg(DAL.CFG_PIN_SCL);\n _i2c = pins.createI2C(sda, scl); \n }\n return _i2c; \n }\n\n export class I2CDevice {\n public address: number;\n public bus: I2C;\n private _hasError: boolean;\n constructor(address: number, bus?: I2C) {\n this.address = address;\n this.bus = bus || i2c();\n }\n public readInto(buf: Buffer, repeat = false, start = 0, end: number = null) {\n if (end === null)\n end = buf.length\n if (start >= end)\n return\n let res = this.bus.readBuffer(this.address, end - start, repeat)\n if (!res) {\n this._hasError = true\n return\n }\n buf.write(start, res)\n }\n public write(buf: Buffer, repeat = false) {\n let res = this.bus.writeBuffer(this.address, buf, repeat)\n if (res) {\n this._hasError = true\n }\n }\n public begin(): I2CDevice {\n this._hasError = false;\n return this;\n }\n public end() {\n }\n public ok() {\n return !this._hasError\n }\n\n public transfer(command: Buffer, response: Buffer, responseStart?: number, responseEnd?: number) {\n this.begin();\n if (command)\n this.write(command);\n if (response)\n this.readInto(response, false, responseStart, responseEnd);\n this.end();\n } \n }\n}\n",
"keyvaluestorage.cpp": "#include \"pxt.h\"\n#include \"KeyValueStorage.h\"\n\nnamespace pxt {\n\nclass WKeyValueStorage {\n#ifdef CODAL_NVMCONTROLLER\n CODAL_NVMCONTROLLER controller;\n#else\n NVMController controller;\n#endif\n KeyValueStorage storage;\n public:\n\n WKeyValueStorage()\n : controller()\n , storage(controller) {\n }\n\n bool isSupported() {\n#ifdef CODAL_NVMCONTROLLER\n return true;\n#else\n return false;\n#endif\n }\n\n int put(String key, Buffer data) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n return storage.put(mkey, data->data, data->length);\n#else\n return -1;\n#endif\n }\n\n Buffer get(String key) {\n#ifdef CODAL_NVMCONTROLLER\n Buffer buf = NULL;\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n auto entry = storage.get(mkey);\n if (entry) {\n buf = mkBuffer(entry->value, sizeof(entry->value));\n free(entry);\n }\n return buf;\n#else\n return NULL;\n#endif\n }\n\n void remove(String key) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n storage.remove(mkey);\n#endif\n }\n\n void clear() {\n#ifdef CODAL_NVMCONTROLLER\n storage.wipe();\n#endif\n }\n};\nSINGLETON(WKeyValueStorage);\n\n}\n\nnamespace configStorage {\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //%\n void setBuffer(String key, Buffer value) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->put(key, value);\n }\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //%\n Buffer getBuffer(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n return kvm->get(key);\n }\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //%\n void removeItem(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->remove(key);\n }\n\n /**\n * Clears the local storage\n */\n //%\n void clear() {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->clear();\n }\n}\n",
"keyvaluestorage.ts": "namespace configStorage {\n /**\n * Stores the value at the key entry\n * @param key identifier of the key (max 16 characters)\n * @param value identifier of the value (max 32 characters)\n */\n export function setItem(key: string, value: string) {\n if (value == null)\n configStorage.removeItem(key);\n else\n {\n let idx = 0;\n let buf = control.createBuffer(value.length + 1);\n buf[idx++] = value.length;\n let valBuf = control.createBufferFromUTF8(value);\n\n for (let i = 0; i < valBuf.length; i++)\n buf[idx++] = valBuf[i];\n\n configStorage.setBuffer(key, buf);\n }\n }\n\n /**\n * Retrieves the value at the key entry\n * @param key identifier of the key (max 16 characters)\n */\n export function getItem(key: string): string {\n const buf = configStorage.getBuffer(key);\n\n if (!buf)\n return undefined;\n\n let idx = 0;\n let count = buf[idx++];\n const retBuf = control.createBuffer(count);\n\n for (let i = 0; i < count; i++)\n retBuf[i] = buf[idx++];\n\n return retBuf.toString();\n }\n}\n",
"leveldetector.ts": "namespace pins {\n export class LevelDetector {\n public id: number;\n public min: number;\n public max: number;\n public lowThreshold: number;\n public highThreshold: number;\n private transition: number;\n private transitionMs: number;\n private _level: number;\n private _state: number;\n public onHigh: () => void;\n public onLow: () => void;\n public onNeutral: () => void;\n public transitionWindow: number;\n // minimum duration (ms) between events\n public transitionInterval: number;\n\n static LEVEL_THRESHOLD_NEUTRAL = 0;\n\n constructor(id: number,\n min: number, max: number,\n lowThreshold: number, highThreshold: number) {\n this.id = id;\n this.min = min;\n this.max = max;\n this.lowThreshold = lowThreshold;\n this.highThreshold = highThreshold;\n this.transitionWindow = 4;\n this.transitionInterval = 0;\n\n this.onHigh = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_HIGH);\n this.onLow = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_LOW);\n this.onNeutral = undefined;\n\n this.reset();\n }\n\n reset() {\n this.transition = 0;\n this.transitionMs = 0;\n this._level = Math.ceil((this.highThreshold - this.lowThreshold) / 2);\n this._state = LevelDetector.LEVEL_THRESHOLD_NEUTRAL;\n }\n\n get level(): number {\n return this._level;\n }\n\n set level(level: number) {\n this._level = this.clampValue(level);\n\n if (this._level >= this.highThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_HIGH);\n }\n else if (this._level <= this.lowThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_LOW);\n }\n else {\n this.setState(LevelDetector.LEVEL_THRESHOLD_NEUTRAL);\n }\n }\n\n public setLowThreshold(value: number) {\n this.lowThreshold = this.clampValue(value);\n this.reset();\n }\n\n public setHighThreshold(value: number) {\n this.highThreshold = this.clampValue(value);\n this.reset();\n }\n\n private clampValue(value: number) {\n if (value < this.min) {\n return this.min;\n }\n else if (value > this.max) {\n return this.max;\n }\n return value;\n }\n\n private setState(state: number) {\n // not enough samples to change\n if (this._state === state \n || (this.transition++ < this.transitionWindow)\n || (control.millis() - this.transitionMs) < this.transitionInterval) {\n return;\n }\n\n this.transition = 0;\n this.transitionMs = control.millis();\n this._state = state;\n switch (state) {\n case DAL.LEVEL_THRESHOLD_HIGH:\n if (this.onHigh) this.onHigh();\n break;\n case DAL.LEVEL_THRESHOLD_LOW:\n if (this.onLow) this.onLow();\n break;\n case LevelDetector.LEVEL_THRESHOLD_NEUTRAL:\n if (this.onNeutral) this.onNeutral();\n break;\n }\n }\n }\n}",
"light.cpp": "#include \"light.h\"\n\n// WS2812B timings, datasheet v1\n// 0 - 0.25-0.55us hi 0.70-1.00us low\n// 1 - 0.65-0.95us hi 0.30-0.60us low\n// datasheet v5\n// 0 - 0.22-0.38us hi 0.58-1.00us low 1-3\n// 1 - 0.58-1.00us hi 0.58-1.00us low 3-2\n\n#define SPI_SUPPORTED 1\n\n#if defined(NRF52_SERIES)\n#define BIT_EXPANSION 5\n#define SPI_FREQ 4000000\n#else\n#define BIT_EXPANSION 3\n#define SPI_FREQ 2400000\n#endif\n\n#if defined(SAMD21) || defined(SAMD51) || defined(STM32F4) || defined(NRF52_SERIES)\n#include \"neopixel.h\"\n#define BITBANG_SUPPORTED 1\n#else\n#define BITBANG_SUPPORTED 0\n#endif\n\n#define NEOPIXEL_MIN_LENGTH_FOR_SPI 24\n#define DOTSTAR_MIN_LENGTH_FOR_SPI 24\n\n#define LIGHTMODE_RGB 1\n#define LIGHTMODE_RGBW 2\n#define LIGHTMODE_RGB_RGB 3\n#define LIGHTMODE_DOTSTAR 4\n\nnamespace light {\nbool isValidMOSIPin(DigitalInOutPin pin) {\n if (!pin)\n return false;\n\n#if SAMD51\n return ZSPI::isValidMOSIPin(*pin);\n#elif defined(NRF52_SERIES)\n return true;\n#else\n // TODO: support for SPI neopixels\n // default SPI pins supported for now\n return pin == LOOKUP_PIN(MOSI);\n#endif\n}\n\n// SPI\nvoid spiNeopixelSendBuffer(DevicePin *pin, const uint8_t *data, unsigned size) {\n int32_t iptr = 0, optr = 120;\n uint32_t len = optr + size * BIT_EXPANSION + 120;\n uint8_t *expBuf = new uint8_t[len];\n memset(expBuf, 0, len);\n uint8_t imask = 0x80;\n uint8_t omask = 0x80;\n\n#define WR(k) \\\n if (k) \\\n expBuf[optr] |= omask; \\\n omask >>= 1; \\\n if (!omask) { \\\n omask = 0x80; \\\n optr++; \\\n }\n\n while (iptr < (int)size) {\n#if BIT_EXPANSION == 3\n WR(1);\n WR(data[iptr] & imask);\n WR(0);\n#elif BIT_EXPANSION == 5\n WR(1);\n if (data[iptr] & imask) {\n WR(1);\n WR(1);\n } else {\n WR(0);\n }\n WR(0);\n WR(0);\n#else\n#error \"invalid BIT_EXPANSION\"\n#endif\n\n imask >>= 1;\n if (!imask) {\n imask = 0x80;\n iptr++;\n }\n }\n\n auto spi = pxt::getSPI(pin, NULL, NULL);\n spi->setFrequency(SPI_FREQ);\n spi->transfer(expBuf, len, NULL, 0);\n delete expBuf;\n}\n\nvoid neopixelSendData(DevicePin *pin, int mode, const uint8_t *data, unsigned length) {\n if (!pin || !length)\n return;\n\n#if BITBANG_SUPPORTED\n if (SPI_SUPPORTED && length > NEOPIXEL_MIN_LENGTH_FOR_SPI && isValidMOSIPin(pin))\n spiNeopixelSendBuffer(pin, data, length);\n else\n neopixel_send_buffer(*pin, data, length);\n#else\n if (isValidMOSIPin(pin)) {\n spiNeopixelSendBuffer(pin, data, length);\n }\n#endif\n}\n\nvoid bitBangDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n // first frame of zeroes\n data->setDigitalValue(0);\n for (unsigned i = 0; i < 32; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n\n // data stream\n for (unsigned i = 0; i < length; ++i) {\n auto x = buf[i];\n for (uint8_t j = 0x80; j != 0; j >>= 1) {\n data->setDigitalValue(x & j ? 1 : 0);\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n }\n // https://cpldcpu.wordpress.com/2016/12/13/sk9822-a-clone-of-the-apa102/\n // reset frame\n // data->setDigitalValue(0);\n // for (unsigned i = 0; i < 32 ; ++i) {\n // clk->setDigitalValue(1);\n // clk->setDigitalValue(0);\n //}\n\n // https://cpldcpu.wordpress.com/2014/11/30/understanding-the-apa102-superled/\n data->setDigitalValue(1);\n unsigned n = 32;\n for (unsigned i = 0; i < n; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n}\n\nstatic uint8_t ZERO_FRAME[4];\nstatic uint8_t ONE_FRAME[] = {1, 1, 1, 1};\nvoid spiDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n auto spi = pxt::getSPI(data, NULL, clk);\n\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // initial frame\n spi->transfer(buf, length, NULL, 0);\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // reset frame\n for (unsigned i = 0; i < (length >> 3); i += 32)\n spi->transfer(ONE_FRAME, sizeof(ONE_FRAME), NULL, 0); // final frame\n}\n\nvoid dotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n if (!data || !clk || !buf || !length)\n return;\n\n if (length > DOTSTAR_MIN_LENGTH_FOR_SPI && isValidMOSIPin(data))\n spiDotStarSendData(data, clk, mode, buf, length);\n else\n bitBangDotStarSendData(data, clk, mode, buf, length);\n}\n\nvoid sendBuffer(DevicePin *data, DevicePin *clk, int mode, Buffer buf) {\n if (!data || !buf || !buf->length)\n return;\n\n if (mode == LIGHTMODE_DOTSTAR)\n light::dotStarSendData(data, clk, mode, buf->data, buf->length);\n else\n light::neopixelSendData(data, mode, buf->data, buf->length);\n}\n\nvoid clear() {\n auto neopix = LOOKUP_PIN(NEOPIXEL);\n auto neonum = getConfig(CFG_NUM_NEOPIXELS, 0);\n if (neopix && neonum >= 0) {\n auto n = 3 * neonum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n light::neopixelSendData(neopix, 0x100, off, sizeof(off));\n }\n\n auto data = LOOKUP_PIN(DOTSTAR_DATA);\n auto clk = LOOKUP_PIN(DOTSTAR_CLOCK);\n auto dsnum = getConfig(CFG_NUM_DOTSTARS, 0);\n if (data && clk && dsnum > 0) {\n auto n = 4 * dsnum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n for (int i = 0; i < n; i += 4)\n off[i] = 0xe0;\n bitBangDotStarSendData(data, clk, 0x100, off, sizeof(off));\n }\n}\n\n} // namespace light\n",
"light.h": "#ifndef __PXT_LIGHT_H\n#define __PXT_LIGHT_H\n\n#include \"pxt.h\"\n\nnamespace light {\n /**\n * Clear onboard neopixels\n */\n void clear();\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //%\n void sendBuffer(DigitalInOutPin data, DigitalInOutPin clk, int mode, Buffer buf);\n\n void neopixelSendData(DevicePin* pin, int mode, const uint8_t* data, unsigned length);\n}\n\n#endif",
"ns.ts": "/**\n * Events and data from sensors.\n */\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\n//% groups='[\"other\", \"More\"]'\nnamespace input {\n}\n\n/**\n * Servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\"\nnamespace servos {\n\n}\n\n/**\n * A Joint Asynchronous Communications, Device Agnostic Control.\n */\n//% color=\"#E79251\" weight=1 icon=\"\\uf185\"\n//% groups='[\"Broadcast\", \"Console\", \"Control\"]'\n//% blockGap=8\nnamespace jacdac {\n\n}",
"pins.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\nstatic DevicePin **pinPtrs;\nstatic uint8_t numPinPtrs;\nstatic uint8_t pinPos[DEV_NUM_PINS];\n\n//%\nDevicePin *getPin(int id) {\n\n id &= CFG_PIN_NAME_MSK;\n\n if (id >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n\n // we could use lookupComponent() here - it would be slightly slower\n\n int ptr = pinPos[id];\n if (ptr == 0) {\n pinPtrs = (DevicePin **)realloc(pinPtrs, (numPinPtrs + 1) * sizeof(void *));\n bool isAnalog = IS_ANALOG_PIN(id);\n // GCTODO\n pinPtrs[numPinPtrs++] =\n new DevicePin(DEVICE_ID_IO_P0 + id, (PinName)id,\n isAnalog ? PIN_CAPABILITY_AD : PIN_CAPABILITY_DIGITAL);\n ptr = numPinPtrs;\n pinPos[id] = ptr;\n }\n return pinPtrs[ptr - 1];\n}\n\n//%\nDevicePin *getPinCfg(int key) {\n int p = getConfig(key, -1);\n if (p == -1)\n DMESG(\"no pin cfg: %d\", key);\n return getPin(p);\n}\n\nvoid linkPin(int from, int to) {\n if (from < 0 || from >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n getPin(to);\n pinPos[from] = pinPos[to];\n}\n\n//%\nDevicePin *lookupPin(int pinName) {\n if (pinName < 0 || pinName == 0xff)\n return NULL;\n pinName &= CFG_PIN_NAME_MSK;\n return getPin(pinName);\n}\n\n//%\nDevicePin *lookupPinCfg(int key) {\n return lookupPin(getConfig(key));\n}\n\nCodalComponent *lookupComponent(int id) {\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; ++i) {\n if (CodalComponent::components[i] && CodalComponent::components[i]->id == id)\n return CodalComponent::components[i];\n }\n return NULL;\n}\n\n} // namespace pxt\n\nnamespace pins {\n/**\n* Get a pin by configuration id (DAL.CFG_PIN...)\n*/\n//%\nDigitalInOutPin pinByCfg(int key) {\n return pxt::lookupPinCfg(key);\n}\n\n/**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n//%\nBuffer createBuffer(int size) {\n return mkBuffer(NULL, size);\n}\n\n/**\n * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n//% help=pins/pulse-duration blockGap=8\n//% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n//% weight=19\nint pulseDuration() {\n return pxt::lastEvent.timestamp;\n}\n} // namespace pins\n",
"pins.h": "#ifndef __PXT_PINS_H\n#define __PXT_PINS_H\n\n#define BUTTON_ACTIVE_HIGH_PULL_DOWN (ACTIVE_HIGH | 0x10)\n#define BUTTON_ACTIVE_HIGH_PULL_UP (ACTIVE_HIGH | 0x20)\n#define BUTTON_ACTIVE_HIGH_PULL_NONE (ACTIVE_HIGH | 0x30)\n#define BUTTON_ACTIVE_LOW_PULL_DOWN (ACTIVE_LOW | 0x10)\n#define BUTTON_ACTIVE_LOW_PULL_UP (ACTIVE_LOW | 0x20)\n#define BUTTON_ACTIVE_LOW_PULL_NONE (ACTIVE_LOW | 0x30)\n\n#define PIN(name) ((PinName)pxt::getConfig(CFG_PIN_##name, -1))\n#define LOOKUP_PIN(name) pxt::lookupPin(PIN(name))\n\n// these can be overridden in platform.h\n#ifndef CODAL_PIN\n#define CODAL_PIN CODAL_MBED::Pin\n#endif\n\n#ifndef CODAL_TIMER\n#define CODAL_TIMER CODAL_MBED::Timer\n#endif\n\n#ifndef CODAL_SPI\n#define CODAL_SPI CODAL_MBED::SPI\n#endif\n\n#ifndef CODAL_SERIAL\n#define CODAL_SERIAL CODAL_MBED::Serial\n#endif\n\n#ifndef IS_ANALOG_PIN\n#define IS_ANALOG_PIN(id) ((DEV_ANALOG_PINS >> (id)) & 1)\n#endif\n\ntypedef CODAL_PIN DevicePin;\n\ntypedef DevicePin *DigitalInOutPin;\ntypedef DevicePin *AnalogInOutPin;\ntypedef DevicePin *AnalogInPin;\ntypedef DevicePin *AnalogOutPin;\ntypedef DevicePin *PwmPin;\ntypedef DevicePin *PwmOnlyPin;\ntypedef Button *Button_;\n\nnamespace pxt {\nDevicePin *getPin(int id);\nDevicePin *getPinCfg(int key);\nDevicePin *lookupPin(int pinName);\nDevicePin *lookupPinCfg(int key);\nvoid linkPin(int from, int to);\nCodalComponent *lookupComponent(int id);\n}\n\n#define PINOP(op) name->op\n\n#endif\n",
"pins.ts": "//% noRefCounting fixedInstances\ninterface DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogOutPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInOutPin extends AnalogInPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmOnlyPin extends DigitalInOutPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmPin extends PwmOnlyPin, AnalogInOutPin {\n}\n\n/**\n * Control currents in Pins for analog/digital signals, servos, i2c, ...\n */\n//% color=#A80000 weight=85 icon=\"\\uf140\" advanced=true\n//% groups='[\"other\", \"Servo\", \"i2c\"]'\nnamespace pins {\n}",
"pinsAnalog.cpp": "#include \"pxt.h\"\n\nnamespace AnalogInPinMethods {\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\n */\n//% help=pins/analog-read weight=53\n//% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nint analogRead(AnalogInPin name) {\n return PINOP(getAnalogValue());\n}\n}\n\nnamespace AnalogOutPinMethods {\nvoid analogWrite(AnalogOutPin name, int value) __attribute__ ((weak));\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\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n//% help=pins/analog-write weight=52\n//% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.min=0 value.max=1023\nvoid analogWrite(AnalogOutPin name, int value) {\n PINOP(setAnalogValue(value));\n}\n}",
"pinsDigital.cpp": "#include \"pxt.h\"\n\nenum class PulseValue {\n //% block=high\n High = DEVICE_PIN_EVT_PULSE_HI,\n //% block=low\n Low = DEVICE_PIN_EVT_PULSE_LO\n};\n\nenum class PinEvent {\n //% block=\"pulse high\"\n PulseHigh = DEVICE_PIN_EVT_PULSE_HI,\n //% block=\"pulse low\"\n PulseLow = DEVICE_PIN_EVT_PULSE_LO,\n //% block=\"rise\"\n Rise = DEVICE_PIN_EVT_RISE,\n //% block=\"fall\"\n Fall = DEVICE_PIN_EVT_FALL,\n};\n\nenum class PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2\n};\n\nnamespace DigitalInOutPinMethods {\n/**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n//% help=pins/digital-read weight=61\n//% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nbool digitalRead(DigitalInOutPin name) {\n return PINOP(getDigitalValue()) != 0;\n}\n\n/**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n//% help=pins/digital-write weight=60\n//% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid digitalWrite(DigitalInOutPin name, bool value) {\n PINOP(setDigitalValue(value));\n}\n\n/**\n* Make this pin a digital input, and create events where the timestamp is the duration\n* that this pin was either ``high`` or ``low``.\n*/\n//% help=pins/on-pulsed weight=16 blockGap=8\n//% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\n//% deprecated=1 hidden=1\nvoid onPulsed(DigitalInOutPin pin, PulseValue pulse, Action body) {\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)pulse, body);\n}\n\n/**\n* Register code to run when a pin event occurs. \n*/\n//% help=pins/on-event weight=20 blockGap=8\n//% blockId=pinsonevent block=\"on|pin %pin|%event\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nvoid onEvent(DigitalInOutPin pin, PinEvent event, Action body) {\n switch(event) {\n case PinEvent::PulseHigh:\n case PinEvent::PulseLow:\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)event, body);\n break;\n case PinEvent::Rise:\n case PinEvent::Fall:\n pin->eventOn(DEVICE_PIN_EVENT_ON_EDGE);\n registerWithDal(pin->id, (int)event, body);\n break; \n } \n}\n\n/**\n* Return the duration of a pulse in microseconds\n* @param name the pin which measures the pulse\n* @param value the value of the pulse (default high)\n* @param maximum duration in micro-seconds\n*/\n//% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n//% weight=18 blockGap=8\n//% help=\"pins/pulse-in\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nint pulseIn(DigitalInOutPin pin, PulseValue value, int maxDuration = 2000000) {\n int pulse = PulseValue::High == value ? 1 : 0;\n uint64_t tick = system_timer_current_time_us();\n uint64_t maxd = (uint64_t)maxDuration;\n while (pin->getDigitalValue() != pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n\n uint64_t start = system_timer_current_time_us();\n while (pin->getDigitalValue() == pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n uint64_t end = system_timer_current_time_us();\n return end - start;\n}\n\n/**\n* Set the pull direction of this pin.\n* @param name pin to set the pull mode on\n* @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n*/\n//% help=pins/set-pull weight=17 blockGap=8\n//% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid setPull(DigitalInOutPin name, PinPullMode pull) {\n PullMode m = pull == PinPullMode::PullDown ? PullMode::Down : pull == PinPullMode::PullUp\n ? PullMode::Up\n : PullMode::None;\n PINOP(setPull(m));\n}\n\n}\n\n#ifdef PXT_CODAL\n\nnamespace pxt {\n\nstatic void waitABit() {\n // for (int i = 0; i < 10; ++i)\n // asm volatile(\"nop\");\n}\n\nclass ButtonMultiplexer : public CodalComponent {\n public:\n Pin &latch;\n Pin &clock;\n Pin &data;\n uint32_t state;\n uint32_t invMask;\n uint16_t buttonIdPerBit[8];\n bool enabled;\n\n ButtonMultiplexer(uint16_t id)\n : latch(*LOOKUP_PIN(BTNMX_LATCH)), clock(*LOOKUP_PIN(BTNMX_CLOCK)),\n data(*LOOKUP_PIN(BTNMX_DATA)) {\n this->id = id;\n this->status |= DEVICE_COMPONENT_STATUS_SYSTEM_TICK;\n\n state = 0;\n invMask = 0;\n enabled = true;\n\n memset(buttonIdPerBit, 0, sizeof(buttonIdPerBit));\n\n data.getDigitalValue(PullMode::Down);\n latch.setDigitalValue(1);\n clock.setDigitalValue(1);\n }\n\n void disable() {\n data.getDigitalValue(PullMode::None);\n latch.getDigitalValue(PullMode::None);\n clock.getDigitalValue(PullMode::None);\n enabled = false;\n }\n\n bool isButtonPressed(int id) {\n for (int i = 0; i < 8; ++i) {\n if (buttonIdPerBit[i] == id)\n return (state & (1 << i)) != 0;\n }\n return false;\n }\n\n uint32_t readBits(int bits) {\n latch.setDigitalValue(0);\n waitABit();\n latch.setDigitalValue(1);\n waitABit();\n\n uint32_t state = 0;\n for (int i = 0; i < bits; i++) {\n state <<= 1;\n if (data.getDigitalValue(PullMode::Down))\n state |= 1;\n\n clock.setDigitalValue(0);\n waitABit();\n clock.setDigitalValue(1);\n waitABit();\n }\n\n return state;\n }\n\n virtual void periodicCallback() override {\n if (!enabled)\n return;\n\n uint32_t newState = readBits(8);\n newState ^= invMask;\n if (newState == state)\n return;\n\n for (int i = 0; i < 8; ++i) {\n uint32_t mask = 1 << i;\n if (!buttonIdPerBit[i])\n continue;\n int ev = 0;\n if (!(state & mask) && (newState & mask))\n ev = PXT_INTERNAL_KEY_DOWN;\n else if ((state & mask) && !(newState & mask))\n ev = PXT_INTERNAL_KEY_UP;\n if (ev) {\n Event(ev, buttonIdPerBit[i]);\n Event(ev, 0); // any key\n }\n }\n\n state = newState;\n }\n};\n\nstatic ButtonMultiplexer *btnMultiplexer;\nButtonMultiplexer *getMultiplexer() {\n if (!btnMultiplexer)\n btnMultiplexer = new ButtonMultiplexer(DEVICE_ID_FIRST_BUTTON);\n return btnMultiplexer;\n}\n\nint registerMultiplexedButton(int pin, int buttonId) {\n if (1050 <= pin && pin < 1058) {\n pin -= 50;\n getMultiplexer()->invMask |= 1 << (pin - 1000);\n }\n if (1000 <= pin && pin < 1008) {\n getMultiplexer()->buttonIdPerBit[pin - 1000] = buttonId;\n return 1;\n }\n return 0;\n}\n\nint multiplexedButtonIsPressed(int btnId) {\n if (btnMultiplexer)\n return btnMultiplexer->isButtonPressed(btnId) ? 512 : 0;\n return 0;\n}\n\n//% expose\nuint32_t readButtonMultiplexer(int bits) {\n if (!LOOKUP_PIN(BTNMX_CLOCK))\n return 0;\n return getMultiplexer()->readBits(bits);\n}\n\nvoid disableButtonMultiplexer() {\n if (LOOKUP_PIN(BTNMX_CLOCK)) {\n getMultiplexer()->disable();\n }\n}\n\n}\n\n#endif\n",
"pinsPWM.cpp": "#include \"pxt.h\"\n\nnamespace PwmPinMethods {\n}\n\nnamespace PwmOnlyPinMethods {\n\n/**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n//% help=pins/analog-set-period weight=51\n//% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid analogSetPeriod(PwmOnlyPin name, int period) {\n PINOP(setAnalogPeriodUs(period));\n}\n\n/**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n//% help=pins/servo-write weight=41 group=\"Servo\"\n//% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n//% parts=microservo trackArgs=0\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.defl=90\nvoid servoWrite(PwmOnlyPin name, int value) {\n PINOP(setServoValue(value));\n}\n\n/**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n//% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n//% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n//% parts=microservo blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid servoSetPulse(PwmOnlyPin name, int duration) {\n PINOP(setServoPulseUs(duration));\n}\n\n/**\n* Indicates if the servo is running continuously\n*/\n//% blockHidden=1\nvoid servoSetContinuous(PwmOnlyPin name, bool continuous) {\n // used by simulator\n}\n\n}",
"pinscompat.ts": "// filled in by microbit",
"platform.cpp": "#include \"pxt.h\"\n\n#include \"RP2040LowLevelTimer.h\"\n\n#include \"hardware/pll.h\"\n#include \"hardware/clocks.h\"\n\nnamespace pxt {\n\nLowLevelTimer *allocateTimer() {\n // TODO: add config to low level timer\n return new RP2040LowLevelTimer();\n}\n\nstatic void initRandomSeed() {\n uint32_t f_rosc = frequency_count_khz(CLOCKS_FC0_SRC_VALUE_ROSC_CLKSRC);\n seedRandom(f_rosc);\n}\n\nvoid deepSleep() {\n\n}\n\nvoid platform_init() {\n initRandomSeed();\n\n}\n\n} // namespace pxt\n\nvoid cpu_clock_init() {\n // missing in Codal\n}\n",
"platform.h": "#ifndef __PXT_PLATFORM_H\n#define __PXT_PLATFORM_H\n\n#include \"Image.h\"\n#include \"Timer.h\"\n\n#include \"RP2040.h\"\n#include \"RP2040Pin.h\"\n#include \"RP2040Spi.h\"\n#include \"RP2040I2C.h\"\n#include \"RP2040PWM.h\"\n\n#define IMAGE_BITS 4\n\n#define PAGE_SIZE 256\n#define DEV_NUM_PINS 30\n\n// all pins with pwm output\n#define DEV_PWM_PINS 0x3FFFFFFF\n// 26~29 has adc input\n#define DEV_AIN_PINS 0x3C000000\n\n// Codal doesn't yet distinguish between PWM and AIN\n#define DEV_ANALOG_PINS (DEV_PWM_PINS | DEV_AIN_PINS)\n\n#define CODAL_PIN RP2040Pin\n#define CODAL_SPI RP2040SPI\n#define CODAL_I2C RP2040I2C\n#define CODAL_TIMER Timer\n\n#define QUICK_BOOT(v) ((void)0) // not supported\n#define UF2_INFO_TXT \"UF2 Bootloader v1.0\\nModel: Raspberry Pi RP2\\nBoard-ID: RPI-RP2\"\n\ntypedef uint8_t PinName;\n\n// XIP range in 0x1000_0000 ~ 0x1100_0000\n#define PXT_IS_READONLY(v) (isTagged(v) || ((uintptr_t)v & 0x10000000))\n\n#define P0 0\n#define P1 1\n#define P2 2\n#define P3 3\n#define P4 4\n#define P5 5\n#define P6 6\n#define P7 7\n#define P8 8\n#define P9 9\n#define P10 10\n#define P11 11\n#define P12 12\n#define P13 13\n#define P14 14\n#define P15 15\n#define P16 16\n#define P17 17\n#define P18 18\n#define P19 19\n#define P20 20\n#define P21 21\n#define P22 22\n#define P23 23\n#define P24 24\n#define P25 25\n#define P26 26\n#define P27 27\n#define P28 28\n#define P29 29\n#define P30 30\n\n#endif",
"pxt.h": "#ifndef __PXT_H\n#define __PXT_H\n\n#include \"pxtbase.h\"\n\n#include \"CodalConfig.h\"\n#include \"CodalHeapAllocator.h\"\n#include \"CodalDevice.h\"\n#include \"CodalDmesg.h\"\n#include \"ErrorNo.h\"\n#include \"Timer.h\"\n#include \"Matrix4.h\"\n#include \"CodalCompat.h\"\n#include \"CodalComponent.h\"\n#include \"ManagedType.h\"\n#include \"Event.h\"\n#include \"NotifyEvents.h\"\n#include \"Button.h\"\n#include \"CodalFiber.h\"\n#include \"MessageBus.h\"\n#include \"MultiButton.h\"\n\nusing namespace codal;\n\n// codal::ManagedString compat\n#define MSTR(s) codal::ManagedString((s)->data, (s)->length)\n#define PSTR(s) mkString((s).toCharArray(), (s).length())\n\n#include \"pins.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"hf2.h\"\n#include \"hf2dbg.h\"\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n#include \"HIDMouse.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n#include \"HIDKeyboard.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n#include \"HIDJoystick.h\"\n#endif\n#endif\n\n#define PXT_COMM_BASE 0x20002000 // 8k in\n\nnamespace pxt {\n\n#if CONFIG_ENABLED(DEVICE_USB)\nextern CodalUSB usb;\nextern HF2 hf2;\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nextern USBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nextern USBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nextern USBHIDJoystick joystick;\n#endif\n#endif\n\n// Utility functions\nextern Event lastEvent;\nextern CODAL_TIMER devTimer;\nextern MessageBus devMessageBus;\nextern codal::CodalDevice device;\n\nvoid set_usb_strings(const char *uf2_info);\nextern void (*logJDFrame)(const uint8_t *data);\nextern void (*sendJDFrame)(const uint8_t *data);\n\nstatic inline void raiseEvent(int src, int val) {\n Event(src, val);\n}\n\n} // namespace pxt\n\nnamespace pins {\nclass CodalSPIProxy;\nclass CodalI2CProxy;\n} // namespace pins\n\ntypedef pins::CodalI2CProxy* I2C_;\ntypedef pins::CodalSPIProxy* SPI_;\n\nnamespace pxt {\ncodal::LowLevelTimer *allocateTimer();\n\n#ifdef CODAL_I2C\nCODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl);\n#endif\nCODAL_SPI* getSPI(DigitalInOutPin mosi, DigitalInOutPin miso, DigitalInOutPin sck);\n#ifdef CODAL_JACDAC_WIRE_SERIAL\nLowLevelTimer* getJACDACTimer();\n#endif\nclass PressureButton;\nuint32_t readButtonMultiplexer(int bits);\nvoid disableButtonMultiplexer();\n}\n\nnamespace serial {\nclass CodalSerialDeviceProxy;\n}\n\ntypedef serial::CodalSerialDeviceProxy* SerialDevice;\n\nnamespace jacdac {\nclass JDProxyDriver;\n} // namespace network\n\ntypedef jacdac::JDProxyDriver* JacDacDriverStatus;\n\n#define DEVICE_ID_BUTTON_SLIDE 3000\n#define DEVICE_ID_MICROPHONE 3001\n#define DEVICE_ID_FIRST_BUTTON 4000\n#define DEVICE_ID_FIRST_TOUCHBUTTON 4100\n\n#define PXT_INTERNAL_KEY_UP 2050\n#define PXT_INTERNAL_KEY_DOWN 2051\n\n#endif\n",
"pxt.json": "{\n \"name\": \"core---rp2040\",\n \"description\": \"The core library for Codal-based targets\",\n \"dependencies\": {\n \"base\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"dal.d.ts\",\n \"codal.cpp\",\n \"usb.cpp\",\n \"pxt.h\",\n \"platform.h\",\n \"platform.cpp\",\n \"pxtcore.h\",\n \"pins.h\",\n \"pins.cpp\",\n \"pinsAnalog.cpp\",\n \"pinsDigital.cpp\",\n \"pinsPWM.cpp\",\n \"pins.ts\",\n \"pinscompat.ts\",\n \"control.cpp\",\n \"i2c.cpp\",\n \"i2c.ts\",\n \"spi.cpp\",\n \"spi.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"hf2.cpp\",\n \"hf2.h\",\n \"hf2dbg.h\",\n \"uf2format.h\",\n \"uf2hid.h\",\n \"ns.ts\",\n \"dmac.cpp\",\n \"dmac.h\",\n \"timer.ts\",\n \"light.cpp\",\n \"light.h\",\n \"keyvaluestorage.cpp\",\n \"keyvaluestorage.ts\",\n \"leveldetector.ts\",\n \"pxtparts.json\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"cppDependencies\": {\n \"accelerometer\": \"file:../accelerometer\",\n \"buttons\": \"file:../buttons\",\n \"light\": \"file:../light\",\n \"lightsensor\": \"file:../lightsensor\",\n \"screen---st7735\": \"file:../screen---st7735\",\n \"switch\": \"file:../switch\",\n \"thermometer\": \"file:../thermometer\",\n \"lcd\": \"file:../lcd\",\n \"mixer---rp2040\": \"file:../mixer---rp2040\"\n },\n \"yotta\": {\n \"config\": {\n \"codal\": {\n \"component_count\": 64,\n \"dmesg_buffer_size\": 1024\n }\n }\n },\n \"dalDTS\": {\n \"includeDirs\": [\n \"libraries/codal-core/inc\",\n \"pxtapp\"\n ],\n \"excludePrefix\": [\n \"JD_\",\n \"USB_\",\n \"REQUEST_\",\n \"LIS3DH_\",\n \"FXOS8700_\",\n \"HF2_\",\n \"PXT_REF_TAG_\",\n \"MS_\",\n \"SCSI_\",\n \"MAG_\",\n \"MAG3\",\n \"MPU6\",\n \"MADCTL\",\n \"MMA8\"\n ]\n }\n}\n",
"pxtcore.h": "#ifndef __PXTCORE_H\n#define __PXTCORE_H\n\n#include \"CodalDmesg.h\"\n#include \"CodalHeapAllocator.h\"\n\n#define PXT_CODAL 1\n\n#define itoa(a, b) codal::itoa(a, b)\n\n#define GC_GET_HEAP_SIZE() device_heap_size(0)\n#define GC_STACK_BASE DEVICE_STACK_BASE\n#define xmalloc device_malloc\n#define xfree device_free\n\n// on most devices we allocate the entire heap at once, so large allocs should work\n// if they don't you just get the regular out of memory instead of alloc too large\n#define GC_MAX_ALLOC_SIZE (128 * 1024)\n\n#endif\n",
"pxtparts.json": "{\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\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createStrip,light.createNeoPixelStrip\",\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 \"dotstar\": {\n \"simulationBehavior\": \"dotstar\",\n \"visual\": {\n \"builtIn\": \"dotstar\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 1\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createAPA102Strip\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"dataPin\"\n },\n {\n \"pinInstantiationIdx\": 1,\n \"partParameter\": \"clkPin\"\n },\n {\n \"partParameter\": \"mode\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n },\n \"pixels\": {\n \"simulationBehavior\": \"pixels\",\n \"visual\": { \n \"builtIn\": \"pixels\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"MOSI\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"SCK\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\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, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n }, \n \"buttons\": {\n \"simulationBehavior\": \"buttons\",\n \"visual\": {\n \"builtIn\": \"buttons\",\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 },\n \"numberOfPins\": 2,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"Button.onEvent,Button.isPressed,Button.wasPressed\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"button\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n }\n ]\n },\n \"slideswitch\": {\n \"numberOfPins\": 3,\n \"simulationBehavior\": \"slideswitch\",\n \"visual\": {\n \"builtIn\": \"slideswitch\",\n \"width\": 100,\n \"height\": 100,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 30,\n \"y\": 0\n },\n {\n \"x\": 45,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalRead,DigitalInOutPin.onPulsed,DigitalInOutPin.onEvent\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"pin\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\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 \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"PwmOnlyPin.servoWrite,servos.Servo.setAngle,servos.Servo.run,servos.Servo.setPulse\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\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 \"led\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"analogled\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogOutPin.analogWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"photocell\": {\n \"numberOfPins\": 3,\n \"visual\": {\n \"builtIn\": \"photocell\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 15,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"photocell\",\n \"pinDefinitions\": [\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogInPin.analogRead\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n }\n}",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace light {\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //% shim=light::sendBuffer\n function sendBuffer(data: DigitalInOutPin, clk: DigitalInOutPin, mode: int32, buf: Buffer): void;\n}\ndeclare namespace control {\n\n /**\n * Determines if the USB has been enumerated.\n */\n //% shim=control::isUSBInitialized\n function isUSBInitialized(): boolean;\n}\ndeclare namespace pins {\n\n /**\n * Get a pin by configuration id (DAL.CFG_PIN...)\n */\n //% shim=pins::pinByCfg\n function pinByCfg(key: int32): DigitalInOutPin;\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 * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n //% help=pins/pulse-duration blockGap=8\n //% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n //% weight=19 shim=pins::pulseDuration\n function pulseDuration(): int32;\n}\n\n\ndeclare interface AnalogInPin {\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\n */\n //% help=pins/analog-read weight=53\n //% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=AnalogInPinMethods::analogRead\n analogRead(): int32;\n}\n\n\ndeclare interface AnalogOutPin {\n /**\n * Set the connector value as analog. Value must be comprised between 0 and 1023.\n * @param name pin name to write to\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n //% help=pins/analog-write weight=52\n //% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.min=0 value.max=1023 shim=AnalogOutPinMethods::analogWrite\n analogWrite(value: int32): void;\n}\n\n\ndeclare interface DigitalInOutPin {\n /**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n //% help=pins/digital-read weight=61\n //% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalRead\n digitalRead(): boolean;\n\n /**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n //% help=pins/digital-write weight=60\n //% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalWrite\n digitalWrite(value: boolean): void;\n\n /**\n * Make this pin a digital input, and create events where the timestamp is the duration\n * that this pin was either ``high`` or ``low``.\n */\n //% help=pins/on-pulsed weight=16 blockGap=8\n //% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4\n //% deprecated=1 hidden=1 shim=DigitalInOutPinMethods::onPulsed\n onPulsed(pulse: PulseValue, body: () => void): void;\n\n /**\n * Register code to run when a pin event occurs. \n */\n //% help=pins/on-event weight=20 blockGap=8\n //% blockId=pinsonevent block=\"on|pin %pin|%event\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 shim=DigitalInOutPinMethods::onEvent\n onEvent(event: PinEvent, body: () => void): void;\n\n /**\n * Return the duration of a pulse in microseconds\n * @param name the pin which measures the pulse\n * @param value the value of the pulse (default high)\n * @param maximum duration in micro-seconds\n */\n //% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n //% weight=18 blockGap=8\n //% help=\"pins/pulse-in\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 maxDuration.defl=2000000 shim=DigitalInOutPinMethods::pulseIn\n pulseIn(value: PulseValue, maxDuration?: int32): int32;\n\n /**\n * Set the pull direction of this pin.\n * @param name pin to set the pull mode on\n * @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n */\n //% help=pins/set-pull weight=17 blockGap=8\n //% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::setPull\n setPull(pull: PinPullMode): void;\n}\n\n\ndeclare interface PwmPin {}\n\n\ndeclare interface PwmOnlyPin {\n /**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n //% help=pins/analog-set-period weight=51\n //% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::analogSetPeriod\n analogSetPeriod(period: int32): void;\n\n /**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n //% help=pins/servo-write weight=41 group=\"Servo\"\n //% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n //% parts=microservo trackArgs=0\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.defl=90 shim=PwmOnlyPinMethods::servoWrite\n servoWrite(value?: int32): void;\n\n /**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n //% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n //% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n //% parts=microservo blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::servoSetPulse\n servoSetPulse(duration: int32): void;\n\n /**\n * Indicates if the servo is running continuously\n */\n //% blockHidden=1 shim=PwmOnlyPinMethods::servoSetContinuous\n servoSetContinuous(continuous: boolean): void;\n}\ndeclare namespace control {\n\n /**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\"\n //% help=control/raise-event\n //% block=\"raise event|from %src|with value %value\" blockExternalInputs=1 shim=control::raiseEvent\n function raiseEvent(src: int32, value: int32): void;\n\n /**\n * Determine the version of system software currently running.\n */\n //% blockId=\"control_device_dal_version\" block=\"device dal version\"\n //% help=control/device-dal-version shim=control::deviceDalVersion\n function deviceDalVersion(): string;\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}\n\n\ndeclare interface I2C {\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::readBuffer\n readBuffer(address: int32, size: int32, repeat?: boolean): Buffer;\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::writeBuffer\n writeBuffer(address: int32, buf: Buffer, repeat?: boolean): int32;\n}\ndeclare namespace pins {\n\n /**\n * Opens a Serial communication driver\n */\n //% help=pins/create-i2c\n //% parts=i2c shim=pins::createI2C\n function createI2C(sda: DigitalInOutPin, scl: DigitalInOutPin): I2C;\n}\ndeclare namespace pins {\n\n /**\n * Opens a SPI driver\n */\n //% help=pins/create-spi\n //% parts=spi shim=pins::createSPI\n function createSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin): SPI;\n\n /**\n * Opens a slave SPI driver\n */\n //% parts=spi shim=pins::createSlaveSPI\n function createSlaveSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin, csPin: DigitalInOutPin): SPI;\n}\n\n\ndeclare interface SPI {\n /**\n * Write to the SPI bus\n */\n //% shim=SPIMethods::write\n write(value: int32): int32;\n\n /**\n * Transfer buffers over the SPI bus\n */\n //% argsNullable shim=SPIMethods::transfer\n transfer(command: Buffer, response: Buffer): void;\n\n /**\n * Sets the SPI clock frequency\n */\n //% shim=SPIMethods::setFrequency\n setFrequency(frequency: int32): void;\n\n /**\n * Sets the SPI bus mode\n */\n //% shim=SPIMethods::setMode\n setMode(mode: int32): void;\n}\ndeclare namespace configStorage {\n\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //% shim=configStorage::setBuffer\n function setBuffer(key: string, value: Buffer): void;\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::getBuffer\n function getBuffer(key: string): Buffer;\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::removeItem\n function removeItem(key: string): void;\n\n /**\n * Clears the local storage\n */\n //% shim=configStorage::clear\n function clear(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"spi.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n\nnamespace pins {\n\nclass CodalSPIProxy {\nprivate:\n DevicePin* mosi; \n DevicePin* miso; \n DevicePin* sck;\n CODAL_SPI spi;\npublic:\n CodalSPIProxy* next;\n\npublic:\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck) \n , next(NULL)\n {\n }\n\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck, DevicePin* _cs)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck, _cs) \n , next(NULL)\n {\n }\n#endif\n\n CODAL_SPI* getSPI() {\n return &spi;\n }\n\n bool matchPins(DevicePin* mosi, DevicePin* miso, DevicePin* sck) {\n return this->mosi == mosi && this->miso == miso && this->sck == sck;\n }\n\n int write(int value) {\n return spi.write(value);\n }\n\n void transfer(Buffer command, Buffer response) {\n auto cdata = NULL == command ? NULL : command->data;\n auto clength = NULL == command ? 0 : command->length;\n auto rdata = NULL == response ? NULL : response->data;\n auto rlength = NULL == response ? 0 : response->length;\n spi.transfer(cdata, clength, rdata, rlength);\n }\n\n void setFrequency(int frequency) {\n spi.setFrequency(frequency);\n }\n\n void setMode(int mode) {\n spi.setMode(mode);\n }\n};\n\nSPI_ spis(NULL);\n\n/**\n* Opens a SPI driver\n*/\n//% help=pins/create-spi\n//% parts=spi\nSPI_ createSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto dev = spis;\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin);\n ser->next = spis;\n spis = ser;\n return ser;\n}\n\n/**\n* Opens a slave SPI driver\n*/\n//% parts=spi\nSPI_ createSlaveSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin, DigitalInOutPin csPin) {\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n auto dev = spis;\n if (!csPin)\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin, csPin);\n ser->next = spis;\n spis = ser;\n return ser;\n#else\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n return NULL;\n#endif\n}\n\n}\n\nnamespace pxt {\n\nCODAL_SPI* getSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto spi = pins::createSPI(mosiPin, misoPin, sckPin);\n return spi->getSPI();\n}\n\n}\n\nnamespace SPIMethods {\n\n/**\n* Write to the SPI bus\n*/\n//%\nint write(SPI_ device, int value) {\n return device->write(value);\n}\n\n/**\n* Transfer buffers over the SPI bus\n*/\n//% argsNullable\nvoid transfer(SPI_ device, Buffer command, Buffer response) {\n if (!device)\n soft_panic(PANIC_CAST_FROM_NULL);\n if (!command && !response)\n return;\n device->transfer(command, response);\n}\n\n/**\n* Sets the SPI clock frequency\n*/\n//%\nvoid setFrequency(SPI_ device, int frequency) {\n device->setFrequency(frequency);\n}\n\n/**\n* Sets the SPI bus mode\n*/\n//%\nvoid setMode(SPI_ device, int mode) {\n device->setMode(mode);\n}\n\n}\n",
"spi.ts": "namespace pins {\n\n let _spi: SPI;\n /**\n * Gets the default SPI driver\n */\n //%\n export function spi() {\n if (!_spi) {\n const mosi = pins.pinByCfg(DAL.CFG_PIN_MOSI);\n const miso = pins.pinByCfg(DAL.CFG_PIN_MISO);\n const sck = pins.pinByCfg(DAL.CFG_PIN_SCK);\n _spi = pins.createSPI(mosi, miso, sck);\n }\n return _spi;\n }\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 weight=5 advanced=true\n //% blockId=spi_write block=\"spi write %value\"\n export function spiWrite(value: number) {\n return spi().write(value);\n }\n\n /**\n * Write a given command to SPI bus, and at the same time read the response.\n */\n //% help=pins/spi-transfer weight=4 advanced=true\n //% blockId=spi_transfer block=\"spi transfer %command into %response\"\n export function spiTransfer(command: Buffer, response: Buffer) {\n spi().transfer(command, response);\n }\n\n /**\n * Set the SPI frequency\n * @param frequency the clock frequency, eg: 1000000\n */\n //% help=pins/spi-frequency weight=4 advanced=true\n //% blockId=spi_frequency block=\"spi frequency %frequency\"\n export function spiFrequency(frequency: number) {\n spi().setFrequency(frequency);\n }\n\n /**\n * Set the SPI signal mode\n * @param mode the mode, eg: 3\n */\n //% help=pins/spi-mode weight=3 advanced=true\n //% blockId=spi_mode block=\"spi mode %mode\"\n export function spiMode(mode: number) {\n spi().setMode(mode);\n }\n}",
"test.ts": "let i = 1\nlet f = 0.5\nlet plus = i + f\nlet minus = i - f\n\nlet r = Math.random()\nlet ri = Math.randomRange(5, 10)\n\n",
"timer.ts": "namespace control {\n /**\n * A timer\n */\n //% fixedInstances\n export class Timer {\n start: number;\n\n constructor() {\n this.start = control.millis();\n }\n\n /**\n * Gets the elapsed time in millis since the last reset\n */\n //% blockId=timerMillis block=\"%timer|millis\"\n millis(): number {\n return control.millis() - this.start;\n }\n\n /**\n * Gets the elapsed time in seconds since the last reset\n */\n //% blockId=timerSeconds block=\"%timer|seconds\"\n seconds(): number {\n return this.millis() / 1000;\n }\n\n /**\n * Resets the timer\n */\n //% blockId=timerRest block=\"%timer|reset\"\n reset() {\n this.start = control.millis();\n }\n\n /**\n * Pauses until the timer reaches the given amount of milliseconds\n * @param ms how long to pause for, eg: 5, 100, 200, 500, 1000, 2000\n */\n //% blockId=timerPauseUntil block=\"%timer|pause until (ms) %ms\"\n pauseUntil(ms: number) {\n const remaining = this.millis() - ms;\n pause(Math.max(0, remaining));\n }\n }\n\n //% whenUsed fixedInstance block=\"timer 1\"\n export const timer1 = new Timer();\n //% whenUsed fixedInstance block=\"timer 2\"\n export const timer2 = new Timer();\n //% whenUsed fixedInstance block=\"timer 3\"\n export const timer3 = new Timer();\n //% whenUsed fixedInstance block=\"timer 4\"\n export const timer4 = new Timer();\n //% whenUsed fixedInstance block=\"timer 5\"\n export const timer5 = new Timer();\n //% whenUsed fixedInstance block=\"timer 6\"\n export const timer6 = new Timer();\n //% whenUsed fixedInstance block=\"timer 7\"\n export const timer7 = new Timer();\n //% whenUsed fixedInstance block=\"timer 8\"\n export const timer8 = new Timer();\n}",
"uf2format.h": "#ifndef UF2FORMAT_H\n#define UF2FORMAT_H 1\n\n#include \n#include \n\n// All entries are little endian.\n\n#ifndef BOOTLOADER_START\n#define BOOTLOADER_START 0x0\n#endif\n\n#ifndef BOOTLOADER_END\n#define BOOTLOADER_END 0x2000\n#endif\n\n#ifndef UF2_BINFO\n#define UF2_BINFO ((UF2_BInfo *)(BOOTLOADER_END - sizeof(UF2_BInfo)))\n#endif\n\n#ifndef UF2_INFO_TXT\n#define UF2_INFO_TXT UF2_BINFO->info_uf2\n#endif\n\n\n#define UF2_MAGIC_START0 0x0A324655UL // \"UF2\\n\"\n#define UF2_MAGIC_START1 0x9E5D5157UL // Randomly selected\n#define UF2_MAGIC_END 0x0AB16F30UL // Ditto\n\n// If set, the block is \"comment\" and should not be flashed to the device\n#define UF2_FLAG_NOFLASH 0x00000001\n\ntypedef struct {\n // 32 byte header\n uint32_t magicStart0;\n uint32_t magicStart1;\n uint32_t flags;\n uint32_t targetAddr;\n uint32_t payloadSize;\n uint32_t blockNo;\n uint32_t numBlocks;\n uint32_t reserved;\n\n // raw data;\n uint8_t data[476];\n\n // store magic also at the end to limit damage from partial block reads\n uint32_t magicEnd;\n} UF2_Block;\n\ntypedef struct {\n uint8_t version;\n uint8_t ep_in;\n uint8_t ep_out;\n uint8_t reserved0;\n uint32_t cbw_tag;\n uint32_t blocks_remaining;\n uint8_t *buffer;\n} UF2_HandoverArgs;\n\ntypedef void (*UF2_MSC_Handover_Handler)(UF2_HandoverArgs *handover);\ntypedef void (*UF2_HID_Handover_Handler)(int ep);\n\n// this is required to be exactly 16 bytes long by the linker script\ntypedef struct {\n void *reserved0;\n UF2_HID_Handover_Handler handoverHID;\n UF2_MSC_Handover_Handler handoverMSC;\n const char *info_uf2;\n} UF2_BInfo;\n\nstatic inline bool is_uf2_block(void *data) {\n UF2_Block *bl = (UF2_Block *)data;\n return bl->magicStart0 == UF2_MAGIC_START0 && bl->magicStart1 == UF2_MAGIC_START1 &&\n bl->magicEnd == UF2_MAGIC_END;\n}\n\nstatic inline bool in_uf2_bootloader_space(const void *addr) {\n return (BOOTLOADER_START + 0x100) <= (uint32_t)addr && (uint32_t)addr < (BOOTLOADER_END);\n}\n\nstatic inline const char *uf2_info(void) {\n if (in_uf2_bootloader_space(UF2_INFO_TXT))\n return UF2_INFO_TXT;\n return \"N/A\";\n}\n\n#ifdef UF2_DEFINE_HANDOVER\nstatic inline void hf2_handover(uint8_t ep) {\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_HID_Handover_Handler fn = UF2_BINFO->handoverHID;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n // Pass control to bootloader; never returns\n fn(ep & 0xf);\n }\n}\n\nstatic inline void check_uf2_handover(uint8_t *buffer, uint32_t blocks_remaining, uint8_t ep_in,\n uint8_t ep_out, uint32_t cbw_tag) {\n if (!is_uf2_block(buffer))\n return;\n\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_MSC_Handover_Handler fn = UF2_BINFO->handoverMSC;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n UF2_HandoverArgs hand = {\n 1, ep_in, ep_out, 0, cbw_tag, blocks_remaining, buffer,\n };\n // Pass control to bootloader; never returns\n fn(&hand);\n }\n}\n#endif\n\n#endif\n",
"uf2hid.h": "#ifndef UF2_HID_H\n#define UF2_HID_H 1\n\n#define HF2_CMD_BININFO 0x0001\n// no arguments\n#define HF2_MODE_BOOTLOADER 0x01\n#define HF2_MODE_USERSPACE 0x02\nstruct HF2_BININFO_Result {\n uint32_t mode;\n uint32_t flash_page_size;\n uint32_t flash_num_pages;\n uint32_t max_message_size;\n uint32_t uf2_family;\n};\n\n#define HF2_CMD_INFO 0x0002\n// no arguments\n// results is utf8 character array\n\n#define HF2_CMD_RESET_INTO_APP 0x0003\n// no arguments, no result\n\n#define HF2_CMD_RESET_INTO_BOOTLOADER 0x0004\n// no arguments, no result\n\n#define HF2_CMD_START_FLASH 0x0005\n// no arguments, no result\n\n#define HF2_CMD_WRITE_FLASH_PAGE 0x0006\nstruct HF2_WRITE_FLASH_PAGE_Command {\n uint32_t target_addr;\n uint32_t data[0];\n};\n// no result\n\n#define HF2_CMD_CHKSUM_PAGES 0x0007\nstruct HF2_CHKSUM_PAGES_Command {\n uint32_t target_addr;\n uint32_t num_pages;\n};\nstruct HF2_CHKSUM_PAGES_Result {\n uint16_t chksums[0 /* num_pages */];\n};\n\n#define HF2_CMD_READ_WORDS 0x0008\nstruct HF2_READ_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n};\nstruct HF2_READ_WORDS_Result {\n uint32_t words[0 /* num_words */];\n};\n\n#define HF2_CMD_WRITE_WORDS 0x0009\nstruct HF2_WRITE_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n uint32_t words[0 /* num_words */];\n};\n// no result\n\n#define HF2_CMD_DMESG 0x0010\n// no arguments\n// results is utf8 character array\n\n#define HF2_EV_MASK 0x800000\n\n#define HF2_CMD_JDS_CONFIG 0x0020\n#define HF2_CMD_JDS_SEND 0x0021\n#define HF2_EV_JDS_PACKET 0x800020\n\ntypedef struct {\n uint32_t command_id;\n uint16_t tag;\n uint8_t reserved0;\n uint8_t reserved1;\n\n union {\n struct HF2_WRITE_FLASH_PAGE_Command write_flash_page;\n struct HF2_WRITE_WORDS_Command write_words;\n struct HF2_READ_WORDS_Command read_words;\n struct HF2_CHKSUM_PAGES_Command chksum_pages;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Command;\n\ntypedef struct {\n union {\n uint32_t eventId;\n struct {\n uint16_t tag;\n union {\n struct {\n uint8_t status;\n uint8_t status_info;\n };\n uint16_t status16;\n };\n };\n };\n union {\n struct HF2_BININFO_Result bininfo;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Response;\n\n#define HF2_FLAG_SERIAL_OUT 0x80\n#define HF2_FLAG_SERIAL_ERR 0xC0\n#define HF2_FLAG_CMDPKT_LAST 0x40\n#define HF2_FLAG_CMDPKT_BODY 0x00\n#define HF2_FLAG_MASK 0xC0\n#define HF2_SIZE_MASK 63\n\n#define HF2_STATUS_OK 0x00\n#define HF2_STATUS_INVALID_CMD 0x01\n#define HF2_STATUS_INVALID_STATE 0x02\n\n#endif\n",
"usb.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"uf2format.h\"\n\nnamespace pxt {\nCodalUSB usb;\n\n// share the buffer; we will crash anyway if someone talks to us over both at the same time\nHF2_Buffer hf2buf;\nHF2 hf2(hf2buf);\n#ifdef HF2_HID\nHF2 hf2hid(hf2buf);\n#endif\nDummyIface dummyIface;\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nUSBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nUSBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nUSBHIDJoystick joystick;\n#endif\n\nstatic const DeviceDescriptor device_desc = {\n 0x12, // bLength\n 0x01, // bDescriptorType\n 0x0210, // bcdUSBL\n\n // Class etc specified per-interface\n 0x00, 0x00, 0x00,\n\n 0x40, // bMaxPacketSize0\n USB_DEFAULT_VID, USB_DEFAULT_PID,\n 0x4202, // bcdDevice - leave unchanged for the HF2 to work\n 0x01, // iManufacturer\n 0x02, // iProduct\n 0x03, // SerialNumber\n 0x01 // bNumConfigs\n};\n\nstatic void start_usb() {\n // start USB with a delay, so that user code can add new interfaces if needed\n // (eg USB HID keyboard, or MSC)\n fiber_sleep(500);\n usb.start();\n}\n\nvoid platform_usb_init() __attribute__((weak));\nvoid platform_usb_init() {}\n\nvoid set_usb_strings(const char *uf2_info) {\n static const char *string_descriptors[3];\n static char serial[12];\n itoa(target_get_serial() & 0x7fffffff, serial);\n\n auto model = strstr(uf2_info, \"Model: \");\n if (model) {\n model += 7;\n auto end = model;\n while (*end && *end != '\\n' && *end != '\\r')\n end++;\n auto len = end - model;\n auto dev = (char *)app_alloc(len + 10);\n memcpy(dev, model, len);\n strcpy(dev + len, \" (app)\");\n // try to split into manufacturer and\n auto sep = strstr(dev, \" / \");\n if (sep) {\n *sep = '\\0';\n string_descriptors[0] = dev;\n string_descriptors[1] = sep + 3;\n } else {\n string_descriptors[0] = dev;\n string_descriptors[1] = dev;\n }\n } else {\n string_descriptors[0] = \"Unknown Corp.\";\n string_descriptors[1] = \"PXT Device (app)\";\n }\n\n string_descriptors[2] = serial;\n usb.stringDescriptors = string_descriptors;\n}\n\nvoid usb_init() {\n usb.deviceDescriptor = &device_desc;\n set_usb_strings(UF2_INFO_TXT);\n\n platform_usb_init();\n\n usb.add(hf2);\n\n#ifdef HF2_HID\n hf2hid.useHID = true;\n usb.add(hf2hid);\n#else\n // the WINUSB descriptors don't seem to work if there's only one interface\n // so we add a dummy interface\n usb.add(dummyIface);\n#endif\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n usb.add(mouse);\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n usb.add(keyboard);\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n usb.add(joystick);\n#endif\n\n create_fiber(start_usb);\n}\n\n} // namespace pxt\n\n#else\nnamespace pxt {\nvoid usb_init() {}\n} // namespace pxt\n#endif\n\nnamespace control {\n/**\n * Determines if the USB has been enumerated.\n */\n//%\nbool isUSBInitialized() {\n#if CONFIG_ENABLED(DEVICE_USB)\n return pxt::usb.isInitialised();\n#else\n return false;\n#endif\n}\n} // namespace control\n\nnamespace pxt {\nstatic void (*pSendToUART)(const char *data, int len) = NULL;\nvoid setSendToUART(void (*f)(const char *, int)) {\n pSendToUART = f;\n}\n\nvoid sendSerial(const char *data, int len) {\n#if CONFIG_ENABLED(DEVICE_USB)\n hf2.sendSerial(data, len);\n#if HF2_HID\n hf2hid.sendSerial(data, len);\n#endif\n#endif\n if (pSendToUART)\n pSendToUART(data, len);\n}\n\nvoid dumpDmesg() {\n sendSerial(\"\\nDMESG:\\n\", 8);\n sendSerial(codalLogStore.buffer, codalLogStore.ptr);\n sendSerial(\"\\n\\n\", 2);\n}\n\nvoid (*logJDFrame)(const uint8_t *data);\nvoid (*sendJDFrame)(const uint8_t *data);\n\n} // namespace pxt\n"
},
"core---samd": {
"README.md": "# core\n\nThe core library for Codal-based targets.\n\n",
"codal.cpp": "#include \"pxt.h\"\n#include \"LowLevelTimer.h\"\nusing namespace codal;\n\nvoid cpu_clock_init(void);\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#ifdef DEVICE_GET_FIBER_LIST_AVAILABLE\n// newer codal-core has get_fiber_list() but not list_fibers()\nnamespace codal {\n/*\n * Return all current fibers.\n *\n * @param dest If non-null, it points to an array of pointers to fibers to store results in.\n *\n * @return the number of fibers (potentially) stored\n */\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\nnamespace pxt {\n\nvoid platform_init();\nvoid usb_init();\n\n// The first two word are used to tell the bootloader that a single reset should start the\n// bootloader and the MSD device, not us.\n// The rest is reserved for partial flashing checksums.\n__attribute__((section(\".binmeta\"))) __attribute__((used)) const uint32_t pxt_binmeta[] = {\n 0x87eeb07c, 0x87eeb07c, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n};\n\nEvent lastEvent;\nMessageBus devMessageBus;\ncodal::CodalDevice device;\n\nstruct FreeList {\n FreeList *next;\n};\n\nstatic void commInit() {\n int commSize = bytecode[20];\n if (!commSize)\n return;\n\n void *r = app_alloc_at((void *)PXT_COMM_BASE, commSize);\n DMESG(\"comm %d -> %p\", commSize, r);\n if (!r)\n target_panic(20);\n}\n\nstatic void initCodal() {\n cpu_clock_init();\n\n commInit();\n\n // Bring up fiber scheduler.\n scheduler_init(devMessageBus);\n\n // We probably don't need that - components are initialized when one obtains\n // the reference to it.\n // devMessageBus.listen(DEVICE_ID_MESSAGE_BUS_LISTENER, DEVICE_EVT_ANY, this,\n // &CircuitPlayground::onListenerRegisteredEvent);\n\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; i++) {\n if (CodalComponent::components[i])\n CodalComponent::components[i]->init();\n }\n\n usb_init();\n\n auto led = LOOKUP_PIN(LED);\n if (led) {\n led->setDigitalValue(0);\n }\n}\n\n// ---------------------------------------------------------------------------\n// An adapter for the API expected by the run-time.\n// ---------------------------------------------------------------------------\n\n// We have the invariant that if [dispatchEvent] is registered against the DAL\n// for a given event, then [handlersMap] contains a valid entry for that\n// event.\nvoid dispatchEvent(Event e) {\n lastEvent = e;\n\n auto curr = findBinding(e.source, e.value);\n auto value = fromInt(e.value);\n while (curr) {\n runAction1(curr->action, value);\n curr = nextBinding(curr->next, e.source, e.value);\n }\n}\n\nvoid registerWithDal(int id, int event, Action a, int flags) {\n // first time?\n if (!findBinding(id, event)) {\n devMessageBus.listen(id, event, dispatchEvent, flags);\n if (event == 0) {\n // we're registering for all events on given ID\n // need to remove old listeners for specific events\n auto curr = findBinding(id, -1);\n while (curr) {\n devMessageBus.ignore(id, curr->value, dispatchEvent);\n curr = nextBinding(curr->next, id, -1);\n }\n }\n }\n setBinding(id, event, a);\n}\n\nvoid fiberDone(void *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 target_wait_us(us);\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 registerGCPtr(a);\n create_fiber(forever_stub, (void *)a);\n }\n}\n\nvoid runInParallel(Action a) {\n if (a != 0) {\n registerGCPtr(a);\n create_fiber((void (*)(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 initSystemTimer();\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\nuint64_t getLongSerialNumber() {\n return device.getSerialNumber();\n}\n\nint current_time_ms() {\n return system_timer_current_time();\n}\n\nuint64_t current_time_us() {\n return system_timer_current_time_us();\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\nstatic void *threadAddressFor(codal::Fiber *fib, void *sp) {\n if (fib == currentFiber)\n return sp;\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 int numFibers = codal::list_fibers(NULL);\n codal::Fiber **fibers = (codal::Fiber **)xmalloc(sizeof(codal::Fiber *) * numFibers);\n int num2 = codal::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 gcProcess(ctx->thrownValue);\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 xfree(fibers);\n}\n\nLowLevelTimer *getJACDACTimer() {\n static LowLevelTimer *jacdacTimer;\n if (!jacdacTimer) {\n jacdacTimer = allocateTimer();\n jacdacTimer->setIRQPriority(1);\n }\n return jacdacTimer;\n}\nvoid initSystemTimer() {\n new CODAL_TIMER(*allocateTimer());\n}\n\n} // namespace pxt\n",
"control.cpp": "#include \"pxt.h\"\n\n#if defined(NRF52_SERIES) || defined(PICO_BOARD)\n#define _estack __StackTop \n#endif\nextern uint32_t _estack;\n\nnamespace control {\n\n/**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n//% weight=21 blockGap=12 blockId=\"control_raise_event\"\n//% help=control/raise-event\n//% block=\"raise event|from %src|with value %value\" blockExternalInputs=1\nvoid raiseEvent(int src, int value) {\n Event evt(src, value);\n}\n\n/**\n* Determine the version of system software currently running.\n*/\n//% blockId=\"control_device_dal_version\" block=\"device dal version\"\n//% help=control/device-dal-version\nString deviceDalVersion() {\n return mkString(device.getVersion());\n}\n\n/**\n* Allocates the next user notification event\n*/\n//% help=control/allocate-notify-event\nint allocateNotifyEvent() {\n return ::allocateNotifyEvent();\n}\n\n/** Write a message to DMESG debugging buffer. */\n//%\nvoid dmesg(String s) {\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 DMESG(\"# %s: %p\", str->getUTF8Data(), ptr);\n}\n\n//%\nuint32_t _ramSize()\n{\n return (uint32_t)&_estack & 0x1fffffff;\n}\n\n}\n",
"dal.d.ts": "// Auto-generated. Do not edit.\ndeclare const enum DAL {\n // /libraries/codal-core/inc/JACDAC/JDPhysicalLayer.h\n Receiving = 0,\n Transmitting = 1,\n Error = 2,\n Unknown = 3,\n ListeningForPulse = 0,\n ErrorRecovery = 1,\n Off = 2,\n Continuation = 0,\n // /libraries/codal-core/inc/JACDAC/JDServiceClasses.h\n STATIC_CLASS_START = 0,\n STATIC_CLASS_END = 16777215,\n DYNAMIC_CLASS_END = 4294967295,\n // /libraries/codal-core/inc/core/CodalComponent.h\n DEVICE_ID_BUTTON_A = 1,\n DEVICE_ID_BUTTON_B = 2,\n DEVICE_ID_BUTTON_AB = 3,\n DEVICE_ID_BUTTON_RESET = 4,\n DEVICE_ID_ACCELEROMETER = 5,\n DEVICE_ID_COMPASS = 6,\n DEVICE_ID_DISPLAY = 7,\n DEVICE_ID_THERMOMETER = 8,\n DEVICE_ID_RADIO = 9,\n DEVICE_ID_RADIO_DATA_READY = 10,\n DEVICE_ID_MULTIBUTTON_ATTACH = 11,\n DEVICE_ID_SERIAL = 12,\n DEVICE_ID_GESTURE = 13,\n DEVICE_ID_SYSTEM_TIMER = 14,\n DEVICE_ID_SCHEDULER = 15,\n DEVICE_ID_COMPONENT = 16,\n DEVICE_ID_LIGHT_SENSOR = 17,\n DEVICE_ID_TOUCH_SENSOR = 18,\n DEVICE_ID_SYSTEM_DAC = 19,\n DEVICE_ID_SYSTEM_MICROPHONE = 20,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR = 21,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR_SPL = 22,\n DEVICE_ID_MSC = 23,\n DEVICE_ID_SPI = 24,\n DEVICE_ID_DISTANCE = 25,\n DEVICE_ID_GYROSCOPE = 26,\n DEVICE_ID_HUMIDITY = 27,\n DEVICE_ID_PRESSURE = 28,\n DEVICE_ID_SINGLE_WIRE_SERIAL = 29,\n DEVICE_ID_JACDAC = 30,\n DEVICE_ID_JACDAC_PHYS = 31,\n DEVICE_ID_JACDAC_CONTROL_SERVICE = 32,\n DEVICE_ID_JACDAC_CONFIGURATION_SERVICE = 33,\n DEVICE_ID_IO_P0 = 100,\n DEVICE_ID_MESSAGE_BUS_LISTENER = 1021,\n DEVICE_ID_NOTIFY_ONE = 1022,\n DEVICE_ID_NOTIFY = 1023,\n DEVICE_ID_BUTTON_UP = 2000,\n DEVICE_ID_BUTTON_DOWN = 2001,\n DEVICE_ID_BUTTON_LEFT = 2002,\n DEVICE_ID_BUTTON_RIGHT = 2003,\n DEVICE_ID_JD_DYNAMIC_ID = 3000,\n DEVICE_COMPONENT_RUNNING = 4096,\n DEVICE_COMPONENT_STATUS_SYSTEM_TICK = 8192,\n DEVICE_COMPONENT_STATUS_IDLE_TICK = 16384,\n DEVICE_COMPONENT_LISTENERS_CONFIGURED = 1,\n DEVICE_COMPONENT_EVT_SYSTEM_TICK = 1,\n // /libraries/codal-core/inc/core/CodalFiber.h\n DEVICE_SCHEDULER_RUNNING = 1,\n DEVICE_SCHEDULER_IDLE = 2,\n DEVICE_FIBER_FLAG_FOB = 1,\n DEVICE_FIBER_FLAG_PARENT = 2,\n DEVICE_FIBER_FLAG_CHILD = 4,\n DEVICE_FIBER_FLAG_DO_NOT_PAGE = 8,\n DEVICE_SCHEDULER_EVT_TICK = 1,\n DEVICE_SCHEDULER_EVT_IDLE = 2,\n // /libraries/codal-core/inc/core/CodalListener.h\n MESSAGE_BUS_LISTENER_PARAMETERISED = 1,\n MESSAGE_BUS_LISTENER_METHOD = 2,\n MESSAGE_BUS_LISTENER_BUSY = 4,\n MESSAGE_BUS_LISTENER_REENTRANT = 8,\n MESSAGE_BUS_LISTENER_QUEUE_IF_BUSY = 16,\n MESSAGE_BUS_LISTENER_DROP_IF_BUSY = 32,\n MESSAGE_BUS_LISTENER_NONBLOCKING = 64,\n MESSAGE_BUS_LISTENER_URGENT = 128,\n MESSAGE_BUS_LISTENER_DELETING = 32768,\n MESSAGE_BUS_LISTENER_IMMEDIATE = 192,\n // /libraries/codal-core/inc/core/ErrorNo.h\n DEVICE_OK = 0,\n DEVICE_INVALID_PARAMETER = -1001,\n DEVICE_NOT_SUPPORTED = -1002,\n DEVICE_CALIBRATION_IN_PROGRESS = -1003,\n DEVICE_CALIBRATION_REQUIRED = -1004,\n DEVICE_NO_RESOURCES = -1005,\n DEVICE_BUSY = -1006,\n DEVICE_CANCELLED = -1007,\n DEVICE_I2C_ERROR = -1010,\n DEVICE_SERIAL_IN_USE = -1011,\n DEVICE_NO_DATA = -1012,\n DEVICE_NOT_IMPLEMENTED = -1013,\n DEVICE_SPI_ERROR = -1014,\n DEVICE_INVALID_STATE = -1015,\n DEVICE_OOM = 20,\n DEVICE_HEAP_ERROR = 30,\n DEVICE_NULL_DEREFERENCE = 40,\n DEVICE_USB_ERROR = 50,\n DEVICE_JACDAC_ERROR = 60,\n DEVICE_HARDWARE_CONFIGURATION_ERROR = 90,\n // /libraries/codal-core/inc/core/NotifyEvents.h\n DISPLAY_EVT_FREE = 1,\n CODAL_SERIAL_EVT_TX_EMPTY = 2,\n BLE_EVT_SERIAL_TX_EMPTY = 3,\n ARCADE_PLAYER_JOIN_RESULT = 4,\n DEVICE_NOTIFY_USER_EVENT_BASE = 1024,\n // /libraries/codal-core/inc/driver-models/AbstractButton.h\n DEVICE_BUTTON_EVT_DOWN = 1,\n DEVICE_BUTTON_EVT_UP = 2,\n DEVICE_BUTTON_EVT_CLICK = 3,\n DEVICE_BUTTON_EVT_LONG_CLICK = 4,\n DEVICE_BUTTON_EVT_HOLD = 5,\n DEVICE_BUTTON_EVT_DOUBLE_CLICK = 6,\n DEVICE_BUTTON_LONG_CLICK_TIME = 1000,\n DEVICE_BUTTON_HOLD_TIME = 1500,\n DEVICE_BUTTON_STATE = 1,\n DEVICE_BUTTON_STATE_HOLD_TRIGGERED = 2,\n DEVICE_BUTTON_STATE_CLICK = 4,\n DEVICE_BUTTON_STATE_LONG_CLICK = 8,\n DEVICE_BUTTON_SIGMA_MIN = 0,\n DEVICE_BUTTON_SIGMA_MAX = 12,\n DEVICE_BUTTON_SIGMA_THRESH_HI = 8,\n DEVICE_BUTTON_SIGMA_THRESH_LO = 2,\n DEVICE_BUTTON_DOUBLE_CLICK_THRESH = 50,\n DEVICE_BUTTON_SIMPLE_EVENTS = 0,\n DEVICE_BUTTON_ALL_EVENTS = 1,\n ACTIVE_LOW = 0,\n ACTIVE_HIGH = 1,\n // /libraries/codal-core/inc/driver-models/Accelerometer.h\n ACCELEROMETER_IMU_DATA_VALID = 2,\n ACCELEROMETER_EVT_DATA_UPDATE = 1,\n ACCELEROMETER_EVT_NONE = 0,\n ACCELEROMETER_EVT_TILT_UP = 1,\n ACCELEROMETER_EVT_TILT_DOWN = 2,\n ACCELEROMETER_EVT_TILT_LEFT = 3,\n ACCELEROMETER_EVT_TILT_RIGHT = 4,\n ACCELEROMETER_EVT_FACE_UP = 5,\n ACCELEROMETER_EVT_FACE_DOWN = 6,\n ACCELEROMETER_EVT_FREEFALL = 7,\n ACCELEROMETER_EVT_3G = 8,\n ACCELEROMETER_EVT_6G = 9,\n ACCELEROMETER_EVT_8G = 10,\n ACCELEROMETER_EVT_SHAKE = 11,\n ACCELEROMETER_EVT_2G = 12,\n ACCELEROMETER_REST_TOLERANCE = 200,\n ACCELEROMETER_TILT_TOLERANCE = 200,\n ACCELEROMETER_FREEFALL_TOLERANCE = 400,\n ACCELEROMETER_SHAKE_TOLERANCE = 400,\n ACCELEROMETER_2G_TOLERANCE = 2048,\n ACCELEROMETER_3G_TOLERANCE = 3072,\n ACCELEROMETER_6G_TOLERANCE = 6144,\n ACCELEROMETER_8G_TOLERANCE = 8192,\n ACCELEROMETER_GESTURE_DAMPING = 5,\n ACCELEROMETER_SHAKE_DAMPING = 10,\n ACCELEROMETER_SHAKE_RTX = 30,\n ACCELEROMETER_SHAKE_COUNT_THRESHOLD = 4,\n // /libraries/codal-core/inc/driver-models/Compass.h\n COMPASS_STATUS_RUNNING = 1,\n COMPASS_STATUS_CALIBRATED = 2,\n COMPASS_STATUS_CALIBRATING = 4,\n COMPASS_STATUS_ADDED_TO_IDLE = 8,\n COMPASS_EVT_DATA_UPDATE = 1,\n COMPASS_EVT_CONFIG_NEEDED = 2,\n COMPASS_EVT_CALIBRATE = 3,\n COMPASS_EVT_CALIBRATION_NEEDED = 4,\n // /libraries/codal-core/inc/driver-models/Gyroscope.h\n GYROSCOPE_IMU_DATA_VALID = 2,\n GYROSCOPE_EVT_DATA_UPDATE = 1,\n // /libraries/codal-core/inc/driver-models/LowLevelTimer.h\n TimerModeTimer = 0,\n TimerModeCounter = 1,\n TimerModeAlternateFunction = 2,\n BitMode8 = 0,\n BitMode16 = 1,\n BitMode24 = 2,\n BitMode32 = 3,\n // /libraries/codal-core/inc/driver-models/Pin.h\n IO_STATUS_DIGITAL_IN = 1,\n IO_STATUS_DIGITAL_OUT = 2,\n IO_STATUS_ANALOG_IN = 4,\n IO_STATUS_ANALOG_OUT = 8,\n IO_STATUS_TOUCH_IN = 16,\n IO_STATUS_EVENT_ON_EDGE = 32,\n IO_STATUS_EVENT_PULSE_ON_EDGE = 64,\n IO_STATUS_INTERRUPT_ON_EDGE = 128,\n DEVICE_PIN_MAX_OUTPUT = 1023,\n DEVICE_PIN_MAX_SERVO_RANGE = 180,\n DEVICE_PIN_DEFAULT_SERVO_RANGE = 2000,\n DEVICE_PIN_DEFAULT_SERVO_CENTER = 1500,\n DEVICE_PIN_EVENT_NONE = 0,\n DEVICE_PIN_INTERRUPT_ON_EDGE = 1,\n DEVICE_PIN_EVENT_ON_EDGE = 2,\n DEVICE_PIN_EVENT_ON_PULSE = 3,\n DEVICE_PIN_EVENT_ON_TOUCH = 4,\n DEVICE_PIN_EVT_RISE = 2,\n DEVICE_PIN_EVT_FALL = 3,\n DEVICE_PIN_EVT_PULSE_HI = 4,\n DEVICE_PIN_EVT_PULSE_LO = 5,\n PIN_CAPABILITY_DIGITAL = 1,\n PIN_CAPABILITY_ANALOG = 2,\n PIN_CAPABILITY_AD = 3,\n PIN_CAPABILITY_ALL = 3,\n None = 0,\n Down = 1,\n Up = 2,\n // /libraries/codal-core/inc/driver-models/Radio.h\n RADIO_EVT_DATA_READY = 2,\n // /libraries/codal-core/inc/driver-models/SPIFlash.h\n SPIFLASH_PAGE_SIZE = 256,\n SPIFLASH_SMALL_ROW_PAGES = 16,\n SPIFLASH_BIG_ROW_PAGES = 256,\n // /libraries/codal-core/inc/driver-models/Sensor.h\n SENSOR_THRESHOLD_LOW = 1,\n SENSOR_THRESHOLD_HIGH = 2,\n SENSOR_UPDATE_NEEDED = 3,\n SENSOR_INITIALISED = 1,\n SENSOR_HIGH_THRESHOLD_PASSED = 2,\n SENSOR_LOW_THRESHOLD_PASSED = 4,\n SENSOR_LOW_THRESHOLD_ENABLED = 8,\n SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n SENSOR_DEFAULT_SENSITIVITY = 868,\n SENSOR_DEFAULT_SAMPLE_PERIOD = 500,\n // /libraries/codal-core/inc/driver-models/Serial.h\n CODAL_SERIAL_DEFAULT_BAUD_RATE = 115200,\n CODAL_SERIAL_DEFAULT_BUFFER_SIZE = 20,\n CODAL_SERIAL_EVT_DELIM_MATCH = 1,\n CODAL_SERIAL_EVT_HEAD_MATCH = 2,\n CODAL_SERIAL_EVT_RX_FULL = 3,\n CODAL_SERIAL_EVT_DATA_RECEIVED = 4,\n CODAL_SERIAL_STATUS_RX_IN_USE = 1,\n CODAL_SERIAL_STATUS_TX_IN_USE = 2,\n CODAL_SERIAL_STATUS_RX_BUFF_INIT = 4,\n CODAL_SERIAL_STATUS_TX_BUFF_INIT = 8,\n CODAL_SERIAL_STATUS_RXD = 16,\n ASYNC = 0,\n SYNC_SPINWAIT = 1,\n SYNC_SLEEP = 2,\n RxInterrupt = 0,\n TxInterrupt = 1,\n // /libraries/codal-core/inc/driver-models/SingleWireSerial.h\n SWS_EVT_DATA_RECEIVED = 1,\n SWS_EVT_DATA_SENT = 2,\n SWS_EVT_ERROR = 3,\n SWS_EVT_DATA_DROPPED = 4,\n SingleWireRx = 0,\n SingleWireTx = 1,\n SingleWireDisconnected = 2,\n // /libraries/codal-core/inc/driver-models/Timer.h\n CODAL_TIMER_DEFAULT_EVENT_LIST_SIZE = 10,\n // /libraries/codal-core/inc/drivers/AnalogSensor.h\n ANALOG_THRESHOLD_LOW = 1,\n ANALOG_THRESHOLD_HIGH = 2,\n ANALOG_SENSOR_UPDATE_NEEDED = 3,\n ANALOG_SENSOR_INITIALISED = 1,\n ANALOG_SENSOR_HIGH_THRESHOLD_PASSED = 2,\n ANALOG_SENSOR_LOW_THRESHOLD_PASSED = 4,\n ANALOG_SENSOR_LOW_THRESHOLD_ENABLED = 8,\n ANALOG_SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n // /libraries/codal-core/inc/drivers/AnimatedDisplay.h\n DISPLAY_EVT_ANIMATION_COMPLETE = 1,\n DISPLAY_DEFAULT_AUTOCLEAR = 1,\n DISPLAY_SPACING = 1,\n DISPLAY_ANIMATE_DEFAULT_POS = -255,\n DISPLAY_DEFAULT_SCROLL_SPEED = 120,\n DISPLAY_DEFAULT_SCROLL_STRIDE = -1,\n DISPLAY_DEFAULT_PRINT_SPEED = 400,\n ANIMATION_MODE_NONE = 0,\n ANIMATION_MODE_STOPPED = 1,\n ANIMATION_MODE_SCROLL_TEXT = 2,\n ANIMATION_MODE_PRINT_TEXT = 3,\n ANIMATION_MODE_SCROLL_IMAGE = 4,\n ANIMATION_MODE_ANIMATE_IMAGE = 5,\n ANIMATION_MODE_ANIMATE_IMAGE_WITH_CLEAR = 6,\n ANIMATION_MODE_PRINT_CHARACTER = 7,\n // /libraries/codal-core/inc/drivers/FAT.h\n FAT_RESERVED_SECTORS = 1,\n FAT_ROOT_DIR_SECTORS = 4,\n // /libraries/codal-core/inc/drivers/HID.h\n HID_REQUEST_GET_REPORT = 1,\n HID_REQUEST_GET_IDLE = 2,\n HID_REQUEST_GET_PROTOCOL = 3,\n HID_REQUEST_SET_REPORT = 9,\n HID_REQUEST_SET_IDLE = 10,\n HID_REQUEST_SET_PROTOCOL = 11,\n // /libraries/codal-core/inc/drivers/HIDKeyboard.h\n HID_KEYBOARD_NUM_REPORTS = 3,\n HID_KEYBOARD_REPORT_GENERIC = 1,\n HID_KEYBOARD_REPORT_CONSUMER = 2,\n HID_KEYBOARD_KEYSTATE_SIZE_GENERIC = 8,\n HID_KEYBOARD_KEYSTATE_SIZE_CONSUMER = 2,\n HID_KEYBOARD_MODIFIER_OFFSET = 2,\n HID_KEYBOARD_DELAY_DEFAULT = 10,\n PressKey = 0,\n ReleaseKey = 1,\n // /libraries/codal-core/inc/drivers/KeyMap.h\n KEYMAP_ALL_KEYS_UP_Val = 1,\n KEYMAP_ALL_KEYS_UP_POS = 28,\n KEYMAP_NORMAL_KEY_Val = 0,\n KEYMAP_MODIFIER_KEY_Val = 1,\n KEYMAP_MODIFIER_POS = 29,\n KEYMAP_MEDIA_KEY_Val = 1,\n KEYMAP_MEDIA_POS = 30,\n KEYMAP_KEY_UP_Val = 0,\n KEYMAP_KEY_DOWN_Val = 1,\n KEYMAP_KEY_DOWN_POS = 31,\n // /libraries/codal-core/inc/drivers/KeyValueStorage.h\n DEVICE_KEY_VALUE_STORE_OFFSET = 4,\n KEY_VALUE_STORAGE_MAGIC = 49370,\n KEY_VALUE_STORAGE_BLOCK_SIZE = 48,\n KEY_VALUE_STORAGE_KEY_SIZE = 16,\n KEY_VALUE_STORAGE_SCRATCH_WORD_SIZE = 64,\n KEY_VALUE_STORAGE_MAX_PAIRS = 5,\n // /libraries/codal-core/inc/drivers/LEDMatrix.h\n LED_MATRIX_GREYSCALE_BIT_DEPTH = 8,\n LED_MATRIX_EVT_LIGHT_SENSE = 2,\n LED_MATRIX_EVT_FRAME_TIMEOUT = 3,\n LED_MATRIX_MINIMUM_BRIGHTNESS = 1,\n LED_MATRIX_MAXIMUM_BRIGHTNESS = 255,\n LED_MATRIX_DEFAULT_BRIGHTNESS = 255,\n DISPLAY_MODE_BLACK_AND_WHITE = 0,\n DISPLAY_MODE_GREYSCALE = 1,\n DISPLAY_MODE_BLACK_AND_WHITE_LIGHT_SENSE = 2,\n MATRIX_DISPLAY_ROTATION_0 = 0,\n MATRIX_DISPLAY_ROTATION_90 = 1,\n MATRIX_DISPLAY_ROTATION_180 = 2,\n MATRIX_DISPLAY_ROTATION_270 = 3,\n NO_CONN = 0,\n // /libraries/codal-core/inc/drivers/MMA8653.h\n MICROBIT_ACCEL_PITCH_ROLL_VALID = 2,\n MICROBIT_ACCEL_ADDED_TO_IDLE = 4,\n // /libraries/codal-core/inc/drivers/MultiButton.h\n MULTI_BUTTON_STATE_1 = 1,\n MULTI_BUTTON_STATE_2 = 2,\n MULTI_BUTTON_HOLD_TRIGGERED_1 = 4,\n MULTI_BUTTON_HOLD_TRIGGERED_2 = 8,\n MULTI_BUTTON_SUPRESSED_1 = 16,\n MULTI_BUTTON_SUPRESSED_2 = 32,\n MULTI_BUTTON_ATTACHED = 64,\n // /libraries/codal-core/inc/drivers/TouchButton.h\n TOUCH_BUTTON_CALIBRATION_PERIOD = 10,\n TOUCH_BUTTON_CALIBRATION_LINEAR_OFFSET = 2,\n TOUCH_BUTTON_CALIBRATION_PERCENTAGE_OFFSET = 5,\n TOUCH_BUTTON_CALIBRATING = 16,\n // /libraries/codal-core/inc/drivers/TouchSensor.h\n TOUCH_SENSOR_MAX_BUTTONS = 10,\n TOUCH_SENSOR_SAMPLE_PERIOD = 50,\n TOUCH_SENSE_SAMPLE_MAX = 1000,\n TOUCH_SENSOR_UPDATE_NEEDED = 1,\n // /libraries/codal-core/inc/drivers/USBJACDAC.h\n JACDAC_USB_STATUS_CLEAR_TO_SEND = 2,\n // /libraries/codal-core/inc/drivers/USB_HID_Keys.h\n KEY_MOD_LCTRL = 1,\n KEY_MOD_LSHIFT = 2,\n KEY_MOD_LALT = 4,\n KEY_MOD_LMETA = 8,\n KEY_MOD_RCTRL = 16,\n KEY_MOD_RSHIFT = 32,\n KEY_MOD_RALT = 64,\n KEY_MOD_RMETA = 128,\n KEY_NONE = 0,\n KEY_ERR_OVF = 1,\n KEY_A = 4,\n KEY_B = 5,\n KEY_C = 6,\n KEY_D = 7,\n KEY_E = 8,\n KEY_F = 9,\n KEY_G = 10,\n KEY_H = 11,\n KEY_I = 12,\n KEY_J = 13,\n KEY_K = 14,\n KEY_L = 15,\n KEY_M = 16,\n KEY_N = 17,\n KEY_O = 18,\n KEY_P = 19,\n KEY_Q = 20,\n KEY_R = 21,\n KEY_S = 22,\n KEY_T = 23,\n KEY_U = 24,\n KEY_V = 25,\n KEY_W = 26,\n KEY_X = 27,\n KEY_Y = 28,\n KEY_Z = 29,\n KEY_1 = 30,\n KEY_2 = 31,\n KEY_3 = 32,\n KEY_4 = 33,\n KEY_5 = 34,\n KEY_6 = 35,\n KEY_7 = 36,\n KEY_8 = 37,\n KEY_9 = 38,\n KEY_0 = 39,\n KEY_ENTER = 40,\n KEY_ESC = 41,\n KEY_BACKSPACE = 42,\n KEY_TAB = 43,\n KEY_SPACE = 44,\n KEY_MINUS = 45,\n KEY_EQUAL = 46,\n KEY_LEFTBRACE = 47,\n KEY_RIGHTBRACE = 48,\n KEY_BACKSLASH = 49,\n KEY_HASHTILDE = 50,\n KEY_SEMICOLON = 51,\n KEY_APOSTROPHE = 52,\n KEY_GRAVE = 53,\n KEY_COMMA = 54,\n KEY_DOT = 55,\n KEY_SLASH = 56,\n KEY_CAPSLOCK = 57,\n KEY_F1 = 58,\n KEY_F2 = 59,\n KEY_F3 = 60,\n KEY_F4 = 61,\n KEY_F5 = 62,\n KEY_F6 = 63,\n KEY_F7 = 64,\n KEY_F8 = 65,\n KEY_F9 = 66,\n KEY_F10 = 67,\n KEY_F11 = 68,\n KEY_F12 = 69,\n KEY_SYSRQ = 70,\n KEY_SCROLLLOCK = 71,\n KEY_PAUSE = 72,\n KEY_INSERT = 73,\n KEY_HOME = 74,\n KEY_PAGEUP = 75,\n KEY_DELETE = 76,\n KEY_END = 77,\n KEY_PAGEDOWN = 78,\n KEY_RIGHT = 79,\n KEY_LEFT = 80,\n KEY_DOWN = 81,\n KEY_UP = 82,\n KEY_NUMLOCK = 83,\n KEY_KPSLASH = 84,\n KEY_KPASTERISK = 85,\n KEY_KPMINUS = 86,\n KEY_KPPLUS = 87,\n KEY_KPENTER = 88,\n KEY_KP1 = 89,\n KEY_KP2 = 90,\n KEY_KP3 = 91,\n KEY_KP4 = 92,\n KEY_KP5 = 93,\n KEY_KP6 = 94,\n KEY_KP7 = 95,\n KEY_KP8 = 96,\n KEY_KP9 = 97,\n KEY_KP0 = 98,\n KEY_KPDOT = 99,\n KEY_102ND = 100,\n KEY_COMPOSE = 101,\n KEY_POWER = 102,\n KEY_KPEQUAL = 103,\n KEY_F13 = 104,\n KEY_F14 = 105,\n KEY_F15 = 106,\n KEY_F16 = 107,\n KEY_F17 = 108,\n KEY_F18 = 109,\n KEY_F19 = 110,\n KEY_F20 = 111,\n KEY_F21 = 112,\n KEY_F22 = 113,\n KEY_F23 = 114,\n KEY_F24 = 115,\n KEY_OPEN = 116,\n KEY_HELP = 117,\n KEY_PROPS = 118,\n KEY_FRONT = 119,\n KEY_STOP = 120,\n KEY_AGAIN = 121,\n KEY_UNDO = 122,\n KEY_CUT = 123,\n KEY_COPY = 124,\n KEY_PASTE = 125,\n KEY_FIND = 126,\n KEY_MUTE = 127,\n KEY_VOLUMEUP = 128,\n KEY_VOLUMEDOWN = 129,\n KEY_KPCOMMA = 133,\n KEY_RO = 135,\n KEY_KATAKANAHIRAGANA = 136,\n KEY_YEN = 137,\n KEY_HENKAN = 138,\n KEY_MUHENKAN = 139,\n KEY_KPJPCOMMA = 140,\n KEY_HANGEUL = 144,\n KEY_HANJA = 145,\n KEY_KATAKANA = 146,\n KEY_HIRAGANA = 147,\n KEY_ZENKAKUHANKAKU = 148,\n KEY_KPLEFTPAREN = 182,\n KEY_KPRIGHTPAREN = 183,\n KEY_LEFTCTRL = 224,\n KEY_LEFTSHIFT = 225,\n KEY_LEFTALT = 226,\n KEY_LEFTMETA = 227,\n KEY_RIGHTCTRL = 228,\n KEY_RIGHTSHIFT = 229,\n KEY_RIGHTALT = 230,\n KEY_RIGHTMETA = 231,\n KEY_MEDIA_PLAYPAUSE = 232,\n KEY_MEDIA_STOPCD = 233,\n KEY_MEDIA_PREVIOUSSONG = 234,\n KEY_MEDIA_NEXTSONG = 235,\n KEY_MEDIA_EJECTCD = 236,\n KEY_MEDIA_VOLUMEUP = 237,\n KEY_MEDIA_VOLUMEDOWN = 238,\n KEY_MEDIA_MUTE = 239,\n KEY_MEDIA_WWW = 240,\n KEY_MEDIA_BACK = 241,\n KEY_MEDIA_FORWARD = 242,\n KEY_MEDIA_STOP = 243,\n KEY_MEDIA_FIND = 244,\n KEY_MEDIA_SCROLLUP = 245,\n KEY_MEDIA_SCROLLDOWN = 246,\n KEY_MEDIA_EDIT = 247,\n KEY_MEDIA_SLEEP = 248,\n KEY_MEDIA_COFFEE = 249,\n KEY_MEDIA_REFRESH = 250,\n KEY_MEDIA_CALC = 251,\n // /libraries/codal-core/inc/drivers/uf2format.h\n UF2FORMAT_H = 1,\n APP_START_ADDRESS = 8192,\n UF2_FLAG_NOFLASH = 1,\n // /libraries/codal-core/inc/streams/DataStream.h\n DATASTREAM_MAXIMUM_BUFFERS = 1,\n // /libraries/codal-core/inc/streams/LevelDetector.h\n LEVEL_THRESHOLD_LOW = 1,\n LEVEL_THRESHOLD_HIGH = 2,\n LEVEL_DETECTOR_INITIALISED = 1,\n LEVEL_DETECTOR_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/LevelDetectorSPL.h\n LEVEL_DETECTOR_SPL_INITIALISED = 1,\n LEVEL_DETECTOR_SPL_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_SPL_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_SPL_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/Synthesizer.h\n SYNTHESIZER_SAMPLE_RATE = 44100,\n TONE_WIDTH = 1024,\n // /libraries/codal-core/inc/types/BitmapFont.h\n BITMAP_FONT_WIDTH = 5,\n BITMAP_FONT_HEIGHT = 5,\n BITMAP_FONT_ASCII_START = 32,\n BITMAP_FONT_ASCII_END = 126,\n // /libraries/codal-core/inc/types/CoordinateSystem.h\n COORDINATE_SPACE_ROTATED_0 = 0,\n COORDINATE_SPACE_ROTATED_90 = 1,\n COORDINATE_SPACE_ROTATED_180 = 2,\n COORDINATE_SPACE_ROTATED_270 = 3,\n RAW = 0,\n SIMPLE_CARTESIAN = 1,\n NORTH_EAST_DOWN = 2,\n NORTH_EAST_UP = 3,\n // /libraries/codal-core/inc/types/Event.h\n DEVICE_ID_ANY = 0,\n DEVICE_EVT_ANY = 0,\n CREATE_ONLY = 0,\n CREATE_AND_FIRE = 1,\n DEVICE_EVENT_DEFAULT_LAUNCH_MODE = 1,\n // /libraries/codal-core/inc/types/RefCounted.h\n REF_TAG_STRING = 1,\n REF_TAG_BUFFER = 2,\n REF_TAG_IMAGE = 3,\n REF_TAG_USER = 32,\n // /pxtapp/accelerometer/axis.h\n ACC_SYSTEM = 3,\n ACC_ROTATION = 0,\n // /pxtapp/configkeys.h\n CFG_PIN_NAME_MSK = 65535,\n CFG_PIN_CONFIG_MSK = 4294901760,\n CFG_PIN_CONFIG_ACTIVE_LO = 65536,\n CFG_MAGIC0 = 513675505,\n CFG_MAGIC1 = 539130489,\n CFG_PIN_ACCELEROMETER_INT = 1,\n CFG_PIN_ACCELEROMETER_SCL = 2,\n CFG_PIN_ACCELEROMETER_SDA = 3,\n CFG_PIN_BTN_A = 4,\n CFG_PIN_BTN_B = 5,\n CFG_PIN_BTN_SLIDE = 6,\n CFG_PIN_DOTSTAR_CLOCK = 7,\n CFG_PIN_DOTSTAR_DATA = 8,\n CFG_PIN_FLASH_CS = 9,\n CFG_PIN_FLASH_MISO = 10,\n CFG_PIN_FLASH_MOSI = 11,\n CFG_PIN_FLASH_SCK = 12,\n CFG_PIN_LED = 13,\n CFG_PIN_LIGHT = 14,\n CFG_PIN_MICROPHONE = 15,\n CFG_PIN_MIC_CLOCK = 16,\n CFG_PIN_MIC_DATA = 17,\n CFG_PIN_MISO = 18,\n CFG_PIN_MOSI = 19,\n CFG_PIN_NEOPIXEL = 20,\n CFG_PIN_RX = 21,\n CFG_PIN_RXLED = 22,\n CFG_PIN_SCK = 23,\n CFG_PIN_SCL = 24,\n CFG_PIN_SDA = 25,\n CFG_PIN_SPEAKER_AMP = 26,\n CFG_PIN_TEMPERATURE = 27,\n CFG_PIN_TX = 28,\n CFG_PIN_TXLED = 29,\n CFG_PIN_IR_OUT = 30,\n CFG_PIN_IR_IN = 31,\n CFG_PIN_DISPLAY_SCK = 32,\n CFG_PIN_DISPLAY_MISO = 33,\n CFG_PIN_DISPLAY_MOSI = 34,\n CFG_PIN_DISPLAY_CS = 35,\n CFG_PIN_DISPLAY_DC = 36,\n CFG_DISPLAY_WIDTH = 37,\n CFG_DISPLAY_HEIGHT = 38,\n CFG_DISPLAY_CFG0 = 39,\n CFG_DISPLAY_CFG1 = 40,\n CFG_DISPLAY_CFG2 = 41,\n CFG_DISPLAY_CFG3 = 42,\n CFG_PIN_DISPLAY_RST = 43,\n CFG_PIN_DISPLAY_BL = 44,\n CFG_PIN_SERVO_1 = 45,\n CFG_PIN_SERVO_2 = 46,\n CFG_PIN_BTN_LEFT = 47,\n CFG_PIN_BTN_RIGHT = 48,\n CFG_PIN_BTN_UP = 49,\n CFG_PIN_BTN_DOWN = 50,\n CFG_PIN_BTN_MENU = 51,\n CFG_PIN_LED_R = 52,\n CFG_PIN_LED_G = 53,\n CFG_PIN_LED_B = 54,\n CFG_PIN_LED1 = 55,\n CFG_PIN_LED2 = 56,\n CFG_PIN_LED3 = 57,\n CFG_PIN_LED4 = 58,\n CFG_SPEAKER_VOLUME = 59,\n CFG_PIN_JACK_TX = 60,\n CFG_PIN_JACK_SENSE = 61,\n CFG_PIN_JACK_HPEN = 62,\n CFG_PIN_JACK_BZEN = 63,\n CFG_PIN_JACK_PWREN = 64,\n CFG_PIN_JACK_SND = 65,\n CFG_PIN_JACK_BUSLED = 66,\n CFG_PIN_JACK_COMMLED = 67,\n CFG_PIN_BTN_SOFT_RESET = 69,\n CFG_ACCELEROMETER_TYPE = 70,\n CFG_PIN_BTNMX_LATCH = 71,\n CFG_PIN_BTNMX_CLOCK = 72,\n CFG_PIN_BTNMX_DATA = 73,\n CFG_PIN_BTN_MENU2 = 74,\n CFG_PIN_BATTSENSE = 75,\n CFG_PIN_VIBRATION = 76,\n CFG_PIN_PWREN = 77,\n CFG_DISPLAY_TYPE = 78,\n CFG_PIN_ROTARY_ENCODER_A = 79,\n CFG_PIN_ROTARY_ENCODER_B = 80,\n CFG_ACCELEROMETER_SPACE = 81,\n CFG_PIN_WIFI_MOSI = 82,\n CFG_PIN_WIFI_MISO = 83,\n CFG_PIN_WIFI_SCK = 84,\n CFG_PIN_WIFI_TX = 85,\n CFG_PIN_WIFI_RX = 86,\n CFG_PIN_WIFI_CS = 87,\n CFG_PIN_WIFI_BUSY = 88,\n CFG_PIN_WIFI_RESET = 89,\n CFG_PIN_WIFI_GPIO0 = 90,\n CFG_PIN_WIFI_AT_TX = 91,\n CFG_PIN_WIFI_AT_RX = 92,\n CFG_PIN_USB_POWER = 93,\n ACCELEROMETER_TYPE_LIS3DH = 50,\n ACCELEROMETER_TYPE_LIS3DH_ALT = 48,\n ACCELEROMETER_TYPE_MMA8453 = 56,\n ACCELEROMETER_TYPE_FXOS8700 = 60,\n ACCELEROMETER_TYPE_MMA8653 = 58,\n ACCELEROMETER_TYPE_MSA300 = 76,\n ACCELEROMETER_TYPE_MPU6050 = 104,\n DISPLAY_TYPE_ST7735 = 7735,\n DISPLAY_TYPE_ILI9341 = 9341,\n DISPLAY_TYPE_SMART = 4242,\n CFG_PIN_A0 = 100,\n CFG_PIN_A1 = 101,\n CFG_PIN_A2 = 102,\n CFG_PIN_A3 = 103,\n CFG_PIN_A4 = 104,\n CFG_PIN_A5 = 105,\n CFG_PIN_A6 = 106,\n CFG_PIN_A7 = 107,\n CFG_PIN_A8 = 108,\n CFG_PIN_A9 = 109,\n CFG_PIN_A10 = 110,\n CFG_PIN_A11 = 111,\n CFG_PIN_A12 = 112,\n CFG_PIN_A13 = 113,\n CFG_PIN_A14 = 114,\n CFG_PIN_A15 = 115,\n CFG_PIN_A16 = 116,\n CFG_PIN_A17 = 117,\n CFG_PIN_A18 = 118,\n CFG_PIN_A19 = 119,\n CFG_PIN_A20 = 120,\n CFG_PIN_A21 = 121,\n CFG_PIN_A22 = 122,\n CFG_PIN_A23 = 123,\n CFG_PIN_A24 = 124,\n CFG_PIN_A25 = 125,\n CFG_PIN_A26 = 126,\n CFG_PIN_A27 = 127,\n CFG_PIN_A28 = 128,\n CFG_PIN_A29 = 129,\n CFG_PIN_A30 = 130,\n CFG_PIN_A31 = 131,\n CFG_PIN_D0 = 150,\n CFG_PIN_D1 = 151,\n CFG_PIN_D2 = 152,\n CFG_PIN_D3 = 153,\n CFG_PIN_D4 = 154,\n CFG_PIN_D5 = 155,\n CFG_PIN_D6 = 156,\n CFG_PIN_D7 = 157,\n CFG_PIN_D8 = 158,\n CFG_PIN_D9 = 159,\n CFG_PIN_D10 = 160,\n CFG_PIN_D11 = 161,\n CFG_PIN_D12 = 162,\n CFG_PIN_D13 = 163,\n CFG_PIN_D14 = 164,\n CFG_PIN_D15 = 165,\n CFG_PIN_D16 = 166,\n CFG_PIN_D17 = 167,\n CFG_PIN_D18 = 168,\n CFG_PIN_D19 = 169,\n CFG_PIN_D20 = 170,\n CFG_PIN_D21 = 171,\n CFG_PIN_D22 = 172,\n CFG_PIN_D23 = 173,\n CFG_PIN_D24 = 174,\n CFG_PIN_D25 = 175,\n CFG_PIN_D26 = 176,\n CFG_PIN_D27 = 177,\n CFG_PIN_D28 = 178,\n CFG_PIN_D29 = 179,\n CFG_PIN_D30 = 180,\n CFG_PIN_D31 = 181,\n CFG_NUM_NEOPIXELS = 200,\n CFG_NUM_DOTSTARS = 201,\n CFG_DEFAULT_BUTTON_MODE = 202,\n CFG_SWD_ENABLED = 203,\n CFG_FLASH_BYTES = 204,\n CFG_RAM_BYTES = 205,\n CFG_SYSTEM_HEAP_BYTES = 206,\n CFG_LOW_MEM_SIMULATION_KB = 207,\n CFG_BOOTLOADER_BOARD_ID = 208,\n CFG_UF2_FAMILY = 209,\n CFG_PINS_PORT_SIZE = 210,\n CFG_BOOTLOADER_PROTECTION = 211,\n CFG_POWER_DEEPSLEEP_TIMEOUT = 212,\n CFG_ANALOG_BUTTON_THRESHOLD = 213,\n CFG_CPU_MHZ = 214,\n CFG_CONTROLLER_LIGHT_MAX_BRIGHTNESS = 215,\n CFG_ANALOG_JOYSTICK_MIN = 216,\n CFG_ANALOG_JOYSTICK_MAX = 217,\n CFG_TIMERS_TO_USE = 218,\n CFG_PIN_ONBOARD_DOTSTAR_CLOCK = 219,\n CFG_PIN_ONBOARD_DOTSTAR_DATA = 220,\n CFG_NUM_ONBOARD_DOTSTARS = 221,\n CFG_PIN_ONBOARD_NEOPIXEL = 222,\n CFG_NUM_ONBOARD_NEOPIXELS = 223,\n CFG_MATRIX_KEYPAD_MESSAGE_ID = 239,\n CFG_NUM_MATRIX_KEYPAD_ROWS = 240,\n CFG_PIN_MATRIX_KEYPAD_ROW0 = 241,\n CFG_PIN_MATRIX_KEYPAD_ROW1 = 242,\n CFG_PIN_MATRIX_KEYPAD_ROW2 = 243,\n CFG_PIN_MATRIX_KEYPAD_ROW3 = 244,\n CFG_PIN_MATRIX_KEYPAD_ROW4 = 245,\n CFG_PIN_MATRIX_KEYPAD_ROW5 = 246,\n CFG_PIN_MATRIX_KEYPAD_ROW6 = 247,\n CFG_PIN_MATRIX_KEYPAD_ROW7 = 248,\n CFG_NUM_MATRIX_KEYPAD_COLS = 250,\n CFG_PIN_MATRIX_KEYPAD_COL0 = 251,\n CFG_PIN_MATRIX_KEYPAD_COL1 = 252,\n CFG_PIN_MATRIX_KEYPAD_COL2 = 253,\n CFG_PIN_MATRIX_KEYPAD_COL3 = 254,\n CFG_PIN_MATRIX_KEYPAD_COL4 = 255,\n CFG_PIN_MATRIX_KEYPAD_COL5 = 256,\n CFG_PIN_MATRIX_KEYPAD_COL6 = 257,\n CFG_PIN_MATRIX_KEYPAD_COL7 = 258,\n CFG_PIN_B0 = 300,\n CFG_PIN_B1 = 301,\n CFG_PIN_B2 = 302,\n CFG_PIN_B3 = 303,\n CFG_PIN_B4 = 304,\n CFG_PIN_B5 = 305,\n CFG_PIN_B6 = 306,\n CFG_PIN_B7 = 307,\n CFG_PIN_B8 = 308,\n CFG_PIN_B9 = 309,\n CFG_PIN_B10 = 310,\n CFG_PIN_B11 = 311,\n CFG_PIN_B12 = 312,\n CFG_PIN_B13 = 313,\n CFG_PIN_B14 = 314,\n CFG_PIN_B15 = 315,\n CFG_PIN_B16 = 316,\n CFG_PIN_B17 = 317,\n CFG_PIN_B18 = 318,\n CFG_PIN_B19 = 319,\n CFG_PIN_B20 = 320,\n CFG_PIN_B21 = 321,\n CFG_PIN_B22 = 322,\n CFG_PIN_B23 = 323,\n CFG_PIN_B24 = 324,\n CFG_PIN_B25 = 325,\n CFG_PIN_B26 = 326,\n CFG_PIN_B27 = 327,\n CFG_PIN_B28 = 328,\n CFG_PIN_B29 = 329,\n CFG_PIN_B30 = 330,\n CFG_PIN_B31 = 331,\n CFG_PIN_C0 = 350,\n CFG_PIN_C1 = 351,\n CFG_PIN_C2 = 352,\n CFG_PIN_C3 = 353,\n CFG_PIN_C4 = 354,\n CFG_PIN_C5 = 355,\n CFG_PIN_C6 = 356,\n CFG_PIN_C7 = 357,\n CFG_PIN_C8 = 358,\n CFG_PIN_C9 = 359,\n CFG_PIN_C10 = 360,\n CFG_PIN_C11 = 361,\n CFG_PIN_C12 = 362,\n CFG_PIN_C13 = 363,\n CFG_PIN_C14 = 364,\n CFG_PIN_C15 = 365,\n CFG_PIN_C16 = 366,\n CFG_PIN_C17 = 367,\n CFG_PIN_C18 = 368,\n CFG_PIN_C19 = 369,\n CFG_PIN_C20 = 370,\n CFG_PIN_C21 = 371,\n CFG_PIN_C22 = 372,\n CFG_PIN_C23 = 373,\n CFG_PIN_C24 = 374,\n CFG_PIN_C25 = 375,\n CFG_PIN_C26 = 376,\n CFG_PIN_C27 = 377,\n CFG_PIN_C28 = 378,\n CFG_PIN_C29 = 379,\n CFG_PIN_C30 = 380,\n CFG_PIN_C31 = 381,\n CFG_PIN_P0 = 400,\n CFG_PIN_P1 = 401,\n CFG_PIN_P2 = 402,\n CFG_PIN_P3 = 403,\n CFG_PIN_P4 = 404,\n CFG_PIN_P5 = 405,\n CFG_PIN_P6 = 406,\n CFG_PIN_P7 = 407,\n CFG_PIN_P8 = 408,\n CFG_PIN_P9 = 409,\n CFG_PIN_P10 = 410,\n CFG_PIN_P11 = 411,\n CFG_PIN_P12 = 412,\n CFG_PIN_P13 = 413,\n CFG_PIN_P14 = 414,\n CFG_PIN_P15 = 415,\n CFG_PIN_P16 = 416,\n CFG_PIN_P17 = 417,\n CFG_PIN_P18 = 418,\n CFG_PIN_P19 = 419,\n CFG_PIN_P20 = 420,\n CFG_PIN_P21 = 421,\n CFG_PIN_P22 = 422,\n CFG_PIN_P23 = 423,\n CFG_PIN_P24 = 424,\n CFG_PIN_P25 = 425,\n CFG_PIN_P26 = 426,\n CFG_PIN_P27 = 427,\n CFG_PIN_P28 = 428,\n CFG_PIN_P29 = 429,\n CFG_PIN_P30 = 430,\n CFG_PIN_P31 = 431,\n CFG_PIN_LORA_MISO = 1001,\n CFG_PIN_LORA_MOSI = 1002,\n CFG_PIN_LORA_SCK = 1003,\n CFG_PIN_LORA_CS = 1004,\n CFG_PIN_LORA_BOOT = 1005,\n CFG_PIN_LORA_RESET = 1006,\n CFG_PIN_IRRXLED = 1007,\n CFG_PIN_IRTXLED = 1008,\n CFG_PIN_LCD_RESET = 1009,\n CFG_PIN_LCD_ENABLE = 1010,\n CFG_PIN_LCD_DATALINE4 = 1011,\n CFG_PIN_LCD_DATALINE5 = 1012,\n CFG_PIN_LCD_DATALINE6 = 1013,\n CFG_PIN_LCD_DATALINE7 = 1014,\n CFG_NUM_LCD_COLUMNS = 1015,\n CFG_NUM_LCD_ROWS = 1016,\n CFG_PIN_RCC0 = 1017,\n CFG_PIN_RCC1 = 1018,\n CFG_PIN_RCC2 = 1019,\n CFG_PIN_RCC3 = 1020,\n CFG_PIN_RCC4 = 1021,\n CFG_PIN_RCC5 = 1022,\n CFG_PIN_RCC6 = 1023,\n CFG_PIN_RCC7 = 1024,\n CFG_PIN_SERVO0 = 1025,\n CFG_PIN_SERVO1 = 1026,\n CFG_PIN_SERVO2 = 1027,\n CFG_PIN_SERVO3 = 1028,\n CFG_PIN_SERVO4 = 1029,\n CFG_PIN_SERVO5 = 1030,\n CFG_PIN_SERVO6 = 1031,\n CFG_PIN_SERVO7 = 1032,\n CFG_PIN_SERVO8 = 1033,\n CFG_PIN_PI_TX = 1034,\n CFG_PIN_PI_RX = 1035,\n CFG_PIN_GPS_SDA = 1036,\n CFG_PIN_GPS_SCL = 1037,\n CFG_PIN_GPS_TX = 1038,\n CFG_PIN_GPS_RX = 1039,\n CFG_PIN_GROVE0 = 1040,\n CFG_PIN_GROVE1 = 1041,\n CFG_PIN_SS = 1042,\n // /pxtapp/hf2dbg.h\n HF2DBG_H = 1,\n // /pxtapp/jacdac/jdprotocol.h\n JDSPI_MAGIC = 31437,\n JDSPI_MAGIC_NOOP = 46029,\n // /pxtapp/mixer---samd/melody.h\n SW_TRIANGLE = 1,\n SW_SAWTOOTH = 2,\n SW_SINE = 3,\n SW_NOISE = 5,\n SW_SQUARE_10 = 11,\n SW_SQUARE_50 = 15,\n CODAL = 1,\n MAX_SOUNDS = 5,\n Waiting = 0,\n Playing = 1,\n Done = 2,\n // /pxtapp/pins.h\n BUTTON_ACTIVE_HIGH_PULL_DOWN = 17,\n BUTTON_ACTIVE_HIGH_PULL_UP = 33,\n BUTTON_ACTIVE_HIGH_PULL_NONE = 49,\n BUTTON_ACTIVE_LOW_PULL_DOWN = 16,\n BUTTON_ACTIVE_LOW_PULL_UP = 32,\n BUTTON_ACTIVE_LOW_PULL_NONE = 48,\n // /pxtapp/platform.h\n PAGE_SIZE = 512,\n BOOTLOADER_START = 0,\n DEV_NUM_PINS = 64,\n PXT_74HC165 = 1,\n IMAGE_BITS = 4,\n PA00 = 0,\n PA01 = 1,\n PA02 = 2,\n PA03 = 3,\n PA04 = 4,\n PA05 = 5,\n PA06 = 6,\n PA07 = 7,\n PA08 = 8,\n PA09 = 9,\n PA10 = 10,\n PA11 = 11,\n PA12 = 12,\n PA13 = 13,\n PA14 = 14,\n PA15 = 15,\n PA16 = 16,\n PA17 = 17,\n PA18 = 18,\n PA19 = 19,\n PA20 = 20,\n PA21 = 21,\n PA22 = 22,\n PA23 = 23,\n PA24 = 24,\n PA25 = 25,\n PA26 = 26,\n PA27 = 27,\n PA28 = 28,\n PA29 = 29,\n PA30 = 30,\n PA31 = 31,\n PB00 = 32,\n PB01 = 33,\n PB02 = 34,\n PB03 = 35,\n PB04 = 36,\n PB05 = 37,\n PB06 = 38,\n PB07 = 39,\n PB08 = 40,\n PB09 = 41,\n PB10 = 42,\n PB11 = 43,\n PB12 = 44,\n PB13 = 45,\n PB14 = 46,\n PB15 = 47,\n PB16 = 48,\n PB17 = 49,\n PB18 = 50,\n PB19 = 51,\n PB20 = 52,\n PB21 = 53,\n PB22 = 54,\n PB23 = 55,\n PB24 = 56,\n PB25 = 57,\n PB26 = 58,\n PB27 = 59,\n PB28 = 60,\n PB29 = 61,\n PB30 = 62,\n PB31 = 63,\n // /pxtapp/pxt.h\n DEVICE_ID_BUTTON_SLIDE = 3000,\n DEVICE_ID_MICROPHONE = 3001,\n DEVICE_ID_FIRST_BUTTON = 4000,\n DEVICE_ID_FIRST_TOUCHBUTTON = 4100,\n PXT_INTERNAL_KEY_UP = 2050,\n PXT_INTERNAL_KEY_DOWN = 2051,\n // /pxtapp/pxtbase.h\n PXT32 = 1,\n PXT64 = 1,\n PXT_REFCNT_FLASH = 65534,\n VTABLE_MAGIC = 249,\n Undefined = 0,\n Boolean = 1,\n Number = 2,\n String = 3,\n Object = 4,\n Function = 5,\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,\n MMap = 10,\n User0 = 16,\n PXT_IOS_HEAP_ALLOC_BITS = 20,\n IMAGE_HEADER_MAGIC = 135,\n Int8LE = 1,\n UInt8LE = 2,\n Int16LE = 3,\n UInt16LE = 4,\n Int32LE = 5,\n Int8BE = 6,\n UInt8BE = 7,\n Int16BE = 8,\n UInt16BE = 9,\n Int32BE = 10,\n UInt32LE = 11,\n UInt32BE = 12,\n Float32LE = 13,\n Float64LE = 14,\n Float32BE = 15,\n Float64BE = 16,\n NUM_TRY_FRAME_REGS = 3,\n GC = 0,\n // /pxtapp/pxtconfig.h\n PXT_UF2_FAMILY = 1760373640,\n // /pxtapp/serial/serial-common.h\n BaudRate115200 = 115200,\n BaudRate57600 = 57600,\n BaudRate38400 = 38400,\n BaudRate31250 = 31250,\n BaudRate28800 = 28800,\n BaudRate19200 = 19200,\n BaudRate14400 = 14400,\n BaudRate9600 = 9600,\n BaudRate4800 = 4800,\n BaudRate2400 = 2400,\n BaudRate1200 = 1200,\n BaudRate300 = 300,\n DataReceived = 4,\n RxBufferFull = 3,\n NewLine = 10,\n Comma = 44,\n Dollar = 36,\n Colon = 58,\n Fullstop = 46,\n Hash = 35,\n SemiColumn = 59,\n Space = 32,\n Tab = 9,\n Pipe = 124,\n // /pxtapp/settings/RAFFS.h\n RAFFS_FOLLOWING_MASK = 32768,\n RAFFS_FLASH_BUFFER_SIZE = 64,\n // /pxtapp/thermometer/target_temperature.h\n TEMPERATURE_NOMINAL_VALUE = 25,\n TEMPERATURE_NOMINAL_READING = 10000,\n TEMPERATURE_BETA = 3380,\n TEMPERATURE_SERIES_RESISTOR = 10000,\n // /pxtapp/uf2hid.h\n UF2_HID_H = 1,\n}\n",
"dmac.cpp": "#include \"dmac.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nSINGLETON(WDMAC);\n#endif\n\n}",
"dmac.h": "#ifndef __DMAC_H\n#define __DMAC_H\n\n#include \"pxt.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nclass WDMAC {\n public:\n CODAL_DMAC dmac;\n\n WDMAC() {}\n};\n\nWDMAC* getWDMAC();\n#endif\n\n}\n\n#endif",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum PulseValue {\n //% block=high\n High = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=low\n Low = 5, // DEVICE_PIN_EVT_PULSE_LO\n }\n\n\n declare const enum PinEvent {\n //% block=\"pulse high\"\n PulseHigh = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=\"pulse low\"\n PulseLow = 5, // DEVICE_PIN_EVT_PULSE_LO\n //% block=\"rise\"\n Rise = 2, // DEVICE_PIN_EVT_RISE\n //% block=\"fall\"\n Fall = 3, // DEVICE_PIN_EVT_FALL\n }\n\n\n declare const enum PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"hf2.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#ifndef USB_HANDOVER\n#define USB_HANDOVER 1\n#endif\n\n#if USB_HANDOVER\n#define UF2_DEFINE_HANDOVER 1\n#endif\n\n#include \"uf2format.h\"\n\nstatic void *stackCopy;\nstatic uint32_t stackSize;\n\n//#define LOG DMESG\n#define LOG(...) ((void)0)\n\nstatic volatile bool resume = false;\n\nusing namespace codal;\n\n#ifdef HF2_HID\nstatic const char hidDescriptor[] = {\n 0x06, 0x97, 0xFF, // usage page vendor 0x97 (usage 0xff97 0x0001)\n 0x09, 0x01, // usage 1\n 0xA1, 0x01, // collection - application\n 0x15, 0x00, // logical min 0\n 0x26, 0xFF, 0x00, // logical max 255\n 0x75, 8, // report size 8\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x81, 0x02, // input: data, variable, absolute\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x91, 0x02, // output: data, variable, absolute\n 0x95, 1, // report count 1\n 0x09, 0x01, // usage 1\n 0xB1, 0x02, // feature: data, variable, absolute\n 0xC0, // end\n};\n\nstatic const HIDReportDescriptor reportDesc = {\n 9,\n 0x21, // HID\n 0x100, // hidbcd 1.00\n 0x00, // country code\n 0x01, // num desc\n 0x22, // report desc type\n sizeof(hidDescriptor), // size of 0x22\n};\n\nstatic const InterfaceInfo ifaceInfoHID = {\n &reportDesc,\n sizeof(reportDesc),\n 1,\n {\n 2, // numEndpoints\n 0x03, /// class code - HID\n 0x00, // subclass\n 0x00, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_INTERRUPT, 1},\n {USB_EP_TYPE_INTERRUPT, 1},\n};\n#endif\n\nstatic const InterfaceInfo ifaceInfoEP = {\n NULL,\n 0,\n 2,\n {\n 2, // numEndpoints\n 0xff, /// class code - vendor-specific\n 42, // subclass\n 1, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_BULK, 0},\n {USB_EP_TYPE_BULK, 0},\n};\n\nint HF2::stdRequest(UsbEndpointIn &ctrl, USBSetup &setup) {\n#ifdef HF2_HID\n if (!useHID)\n return DEVICE_NOT_SUPPORTED;\n if (setup.bRequest == USB_REQ_GET_DESCRIPTOR) {\n if (setup.wValueH == 0x21) {\n InterfaceDescriptor tmp;\n fillInterfaceInfo(&tmp);\n return ctrl.write(&tmp, sizeof(tmp));\n } else if (setup.wValueH == 0x22) {\n return ctrl.write(hidDescriptor, sizeof(hidDescriptor));\n }\n }\n#endif\n return DEVICE_NOT_SUPPORTED;\n}\n\n// same as in microbit\n#define CTRL_GET_REPORT 0x01\n#define CTRL_SET_REPORT 0x09\n#define CTRL_OUT_REPORT_H 0x2\n#define CTRL_IN_REPORT_H 0x1\n\nvoid HF2::sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend) {\n if (!CodalUSB::usbInstance->isInitialised())\n return;\n\n uint32_t buf[64 / 4]; // aligned\n\n if (prepend + 1)\n size += 4;\n\n target_disable_irq();\n while (size > 0) {\n memset(buf + 1, 0, 60);\n int s = 63;\n if (size <= 63) {\n s = size;\n buf[0] = flag;\n } else {\n buf[0] = flag == HF2_FLAG_CMDPKT_LAST ? HF2_FLAG_CMDPKT_BODY : flag;\n }\n buf[0] |= s;\n uint8_t *dst = (uint8_t *)buf;\n dst++;\n if (prepend + 1) {\n memcpy(dst, &prepend, 4);\n prepend = -1;\n dst += 4;\n s -= 4;\n size -= 4;\n }\n memcpy(dst, data, s);\n data = (const uint8_t *)data + s;\n size -= s;\n\n in->write(buf, sizeof(buf));\n }\n target_enable_irq();\n}\n\nconst InterfaceInfo *HF2::getInterfaceInfo() {\n#ifdef HF2_HID\n if (useHID)\n return &ifaceInfoHID;\n#endif\n return &ifaceInfoEP;\n}\n\nint HF2::sendEvent(uint32_t evId, const void *data, int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, evId);\n return 0;\n}\n\nint HF2::sendSerial(const void *data, int size, int isError) {\n if (!gotSomePacket)\n return DEVICE_OK;\n\n sendBuffer(isError ? HF2_FLAG_SERIAL_ERR : HF2_FLAG_SERIAL_OUT, data, size);\n\n return 0;\n}\n\n// Receive HF2 message\n// Does not block. Will store intermediate data in pkt.\n// `serial` flag is cleared if we got a command message.\nint HF2::recv() {\n uint8_t buf[64];\n\n int len = out->read(buf, sizeof(buf));\n // DMESG(\"HF2 read: %d\", len);\n\n if (len <= 0)\n return len;\n\n uint8_t tag = buf[0];\n // serial packets not allowed when in middle of command packet\n usb_assert(pkt.size == 0 || !(tag & HF2_FLAG_SERIAL_OUT));\n int size = tag & HF2_SIZE_MASK;\n usb_assert(pkt.size + size <= (int)sizeof(pkt.buf));\n memcpy(pkt.buf + pkt.size, buf + 1, size);\n pkt.size += size;\n tag &= HF2_FLAG_MASK;\n if (tag != HF2_FLAG_CMDPKT_BODY) {\n if (tag == HF2_FLAG_CMDPKT_LAST)\n pkt.serial = 0;\n else if (tag == HF2_FLAG_SERIAL_OUT)\n pkt.serial = 1;\n else\n pkt.serial = 2;\n int sz = pkt.size;\n pkt.size = 0;\n return sz;\n }\n return 0;\n}\n\nint HF2::sendResponse(int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, pkt.buf, 4 + size);\n return 0;\n}\n\nint HF2::sendResponseWithData(const void *data, int size) {\n if (size <= (int)sizeof(pkt.buf) - 4) {\n memcpy(pkt.resp.data8, data, size);\n return sendResponse(size);\n } else {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, pkt.resp.eventId);\n return 0;\n }\n}\n\nstatic void copy_words(void *dst0, const void *src0, uint32_t n_words) {\n uint32_t *dst = (uint32_t *)dst0;\n const uint32_t *src = (const uint32_t *)src0;\n while (n_words--)\n *dst++ = *src++;\n}\n\n#ifndef QUICK_BOOT\n#ifdef SAMD21\n#define DBL_TAP_PTR ((volatile uint32_t *)(HMCRAMC0_ADDR + HMCRAMC0_SIZE - 4))\n#endif\n#ifdef SAMD51\n#define DBL_TAP_PTR ((volatile uint32_t *)(HSRAM_ADDR + HSRAM_SIZE - 4))\n#endif\n#if defined(NRF52840) || defined(NRF52833)\n#define DBL_TAP_PTR ((volatile uint32_t*)0x20007F7C)\n#endif\n#define DBL_TAP_MAGIC_QUICK_BOOT 0xf02669ef\n#define QUICK_BOOT(v) *DBL_TAP_PTR = v ? DBL_TAP_MAGIC_QUICK_BOOT : 0\n#endif\n\nstatic HF2 *jdLogger;\nstatic void jdLog(const uint8_t *frame) {\n jdLogger->sendEvent(HF2_EV_JDS_PACKET, frame, frame[2] + 12);\n}\n\nint HF2::endpointRequest() {\n int sz = recv();\n\n if (!sz)\n return 0;\n\n uint32_t tmp;\n\n if (pkt.serial) {\n // TODO raise some event?\n return 0;\n }\n\n LOG(\"HF2 sz=%d CMD=%x\", sz, pkt.buf32[0]);\n\n // one has to be careful dealing with these, as they share memory\n HF2_Command *cmd = &pkt.cmd;\n HF2_Response *resp = &pkt.resp;\n\n uint32_t cmdId = cmd->command_id;\n resp->tag = cmd->tag;\n resp->status16 = HF2_STATUS_OK;\n\n#define checkDataSize(str, add) usb_assert(sz == 8 + (int)sizeof(cmd->str) + (int)(add))\n\n lastExchange = current_time_ms();\n gotSomePacket = true;\n\n switch (cmdId) {\n case HF2_CMD_INFO:\n return sendResponseWithData(uf2_info(), strlen(uf2_info()));\n\n case HF2_CMD_BININFO:\n resp->bininfo.mode = HF2_MODE_USERSPACE;\n resp->bininfo.flash_page_size = 0;\n resp->bininfo.flash_num_pages = 0;\n resp->bininfo.max_message_size = sizeof(pkt.buf);\n resp->bininfo.uf2_family = PXT_UF2_FAMILY;\n return sendResponse(sizeof(resp->bininfo));\n\n case HF2_DBG_RESTART:\n *HF2_DBG_MAGIC_PTR = HF2_DBG_MAGIC_START;\n target_reset();\n break;\n\n case HF2_CMD_RESET_INTO_APP:\n QUICK_BOOT(1);\n NVIC_SystemReset();\n break;\n case HF2_CMD_RESET_INTO_BOOTLOADER:\n QUICK_BOOT(0);\n NVIC_SystemReset();\n break;\n\n#if USB_HANDOVER\n case HF2_CMD_START_FLASH:\n sendResponse(0);\n hf2_handover(in->ep);\n usb_assert(0); // should not be reached\n break;\n#endif\n\n case HF2_CMD_WRITE_WORDS:\n checkDataSize(write_words, cmd->write_words.num_words << 2);\n copy_words((void *)cmd->write_words.target_addr, cmd->write_words.words,\n cmd->write_words.num_words);\n break;\n\n case HF2_CMD_READ_WORDS:\n checkDataSize(read_words, 0);\n tmp = cmd->read_words.num_words;\n usb_assert(tmp <= sizeof(pkt.buf) / 4 - 1);\n copy_words(resp->data32, (void *)cmd->read_words.target_addr, tmp);\n return sendResponse(tmp << 2);\n\n case HF2_CMD_DMESG:\n#if DEVICE_DMESG_BUFFER_SIZE > 0\n return sendResponseWithData(codalLogStore.buffer, codalLogStore.ptr);\n#else\n break;\n#endif\n\n case HF2_DBG_GET_GLOBAL_STATE: {\n HF2_GLOBAL_STATE_Result gstate = {\n .num_globals = (uint32_t)getNumGlobals(), //\n .globals_addr = (uint32_t)globals,\n };\n return sendResponseWithData(&gstate, sizeof(gstate));\n }\n\n case HF2_DBG_RESUME:\n globals[0] = (TValue)cmd->data32[0];\n resume = true;\n return sendResponse(0);\n\n case HF2_DBG_GET_STACK:\n return sendResponseWithData(stackCopy, stackSize);\n\n case HF2_CMD_JDS_CONFIG:\n if (cmd->data8[0]) {\n jdLogger = this;\n pxt::logJDFrame = jdLog;\n } else {\n pxt::logJDFrame = NULL;\n }\n return sendResponse(0);\n\n case HF2_CMD_JDS_SEND:\n if (pxt::sendJDFrame) {\n pxt::sendJDFrame(cmd->data8);\n return sendResponse(0);\n } else {\n resp->status16 = HF2_STATUS_INVALID_STATE;\n return sendResponse(0);\n }\n\n default:\n // command not understood\n resp->status16 = HF2_STATUS_INVALID_CMD;\n break;\n }\n\n return sendResponse(0);\n}\n\nHF2::HF2(HF2_Buffer &p) : gotSomePacket(false), ctrlWaiting(false), pkt(p), useHID(false) {\n lastExchange = 0;\n}\n\nstatic const InterfaceInfo dummyIfaceInfo = {\n NULL,\n 0,\n 0,\n {\n 0, // numEndpoints\n 0xff, /// class code - vendor-specific\n 0xff, // subclass\n 0xff, // protocol\n 0x00, // string\n 0x00, // alt\n },\n {0, 0},\n {0, 0},\n};\n\nconst InterfaceInfo *DummyIface::getInterfaceInfo() {\n return &dummyIfaceInfo;\n}\n\n//\n//\n// Debugger\n//\n//\n\nstruct ExceptionContext {\n uint32_t excReturn; // 0xFFFFFFF9\n uint32_t r0;\n uint32_t r1;\n uint32_t r2;\n uint32_t r3;\n uint32_t r12;\n uint32_t lr;\n uint32_t faultInstrAddr;\n uint32_t psr;\n};\n\nstruct Paused_Data {\n uint32_t pc;\n};\nstatic Paused_Data pausedData;\n\nvoid bkptPaused() {\n\n// waiting for https://github.com/lancaster-university/codal/pull/14\n#ifdef DEVICE_GROUP_ID_USER\n // the loop below counts as \"system\" task, and we don't want to pause ourselves\n fiber_set_group(DEVICE_GROUP_ID_SYSTEM);\n // pause everyone else\n fiber_pause_group(DEVICE_GROUP_ID_USER);\n#endif\n\n while (!resume) {\n // DMESG(\"BKPT\");\n hf2.pkt.resp.eventId = HF2_EV_DBG_PAUSED;\n hf2.sendResponseWithData(&pausedData, sizeof(pausedData));\n // TODO use an event\n for (int i = 0; i < 20; ++i) {\n if (resume)\n break;\n fiber_sleep(50);\n }\n }\n\n if (stackCopy) {\n xfree(stackCopy);\n stackCopy = NULL;\n }\n\n#ifdef DEVICE_GROUP_ID_USER\n fiber_resume_group(DEVICE_GROUP_ID_USER);\n // go back to user mode\n fiber_set_group(DEVICE_GROUP_ID_USER);\n#endif\n\n resume = false;\n}\n\nextern \"C\" void handleHardFault(ExceptionContext *ectx) {\n auto instr = (uint16_t *)ectx->faultInstrAddr;\n\n DMESG(\"FLT %p\", instr);\n\n if (ectx->faultInstrAddr & 0x80000000) {\n ectx->faultInstrAddr &= ~0x80000000;\n // switch to step-over mode\n globals[0] = (TValue)3;\n return;\n }\n\n DMESG(\"BB %p %p %p lr=%p r0=%p\", instr[-1], instr[0], instr[1], ectx->lr, ectx->r0);\n\n if (instr[0] == 0x6840) {\n // ldr r0, [r0, #4] -- entry breakpoint\n ectx->faultInstrAddr += 2;\n // we're being ask for step-over mode\n if (ectx->r0 == 3) {\n // switch to debugger-attached-no-stepping mode\n globals[0] = (TValue)0;\n ectx->lr |= 0x80000000;\n }\n return;\n }\n\n if (instr[0] == 0x6800) {\n // ldr r0, [r0, #0]\n ectx->lr = ectx->faultInstrAddr + 3; // next instruction + thumb mode\n pausedData.pc = ectx->faultInstrAddr + 2;\n void *ssp = (void *)(ectx + 1);\n stackSize = DEVICE_STACK_BASE - (uint32_t)ssp;\n if (stackCopy)\n xfree(stackCopy);\n stackCopy = xmalloc(stackSize);\n memcpy(stackCopy, ssp, stackSize);\n ectx->faultInstrAddr = ((uint32_t)(&bkptPaused) & (~1U));\n return;\n }\n\n while (1) {\n }\n}\n\nextern \"C\" void HardFault_Handler(void) {\n asm(\"push {lr}; mov r0, sp; bl handleHardFault; pop {pc}\");\n}\n\n#endif",
"hf2.h": "#ifndef DEVICE_HF2_H\n#define DEVICE_HF2_H\n\n#if CONFIG_ENABLED(DEVICE_USB)\n\n#include \"HID.h\"\n#include \"uf2hid.h\"\n\n// 260 bytes needed for biggest JD packets (with overheads)\n#define HF2_BUF_SIZE 260\n\ntypedef struct {\n uint16_t size;\n uint8_t serial;\n union {\n uint8_t buf[HF2_BUF_SIZE];\n uint32_t buf32[HF2_BUF_SIZE / 4];\n uint16_t buf16[HF2_BUF_SIZE / 2];\n HF2_Command cmd;\n HF2_Response resp;\n };\n} HF2_Buffer;\n\nclass HF2 : public CodalUSBInterface {\n bool gotSomePacket;\n bool ctrlWaiting;\n uint32_t lastExchange;\n\n public:\n HF2_Buffer &pkt;\n\n bool useHID;\n\n int sendResponse(int size);\n int recv();\n int sendResponseWithData(const void *data, int size);\n int sendEvent(uint32_t evId, const void *data, int size);\n void sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend = -1);\n\n HF2(HF2_Buffer &pkt);\n virtual int endpointRequest();\n virtual int stdRequest(UsbEndpointIn &ctrl, USBSetup &setup);\n virtual const InterfaceInfo *getInterfaceInfo();\n int sendSerial(const void *data, int size, int isError = 0);\n\n virtual bool enableWebUSB() { return !useHID; }\n};\n\nclass DummyIface : public CodalUSBInterface {\n public:\n virtual const InterfaceInfo *getInterfaceInfo();\n};\n\n#endif\n\n#endif\n",
"hf2dbg.h": "#ifndef HF2DBG_H\n#define HF2DBG_H 1\n\n// we use a location at the top of the stack to store a magic value\n// which causes us to stop at the very first break point in the program\n#define HF2_DBG_MAGIC_PTR ((uint32_t *)(DEVICE_STACK_BASE - (DEVICE_STACK_SIZE - 4)))\n#define HF2_DBG_MAGIC_START 0xf0ebac7f\n\n#define HF2_DBG_GET_GLOBAL_STATE 0x53fc66e0\nstruct HF2_GLOBAL_STATE_Result {\n uint32_t num_globals;\n uint32_t globals_addr;\n};\n\n#define HF2_DBG_RESTART 0x1120bd93\n#define HF2_DBG_RESUME 0x27a55931\n#define HF2_EV_DBG_PAUSED 0x3692f9fd\n#define HF2_DBG_GET_STACK 0x70901510\n\n#endif\n",
"i2c.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n#include \"CodalDmesg.h\"\n#include \"configkeys.h\"\n\n#ifdef CODAL_I2C\n\nnamespace pins {\n\nclass CodalI2CProxy {\nprivate:\n DevicePin* sda;\n DevicePin* scl;\n CODAL_I2C i2c;\npublic:\n CodalI2CProxy* next;\npublic:\n CodalI2CProxy(DevicePin* _sda, DevicePin* _scl)\n : sda(_sda)\n , scl(_scl)\n , i2c(*_sda, *_scl) \n , next(NULL)\n {\n\n }\n\n CODAL_I2C* getI2C() {\n return &(this->i2c);\n }\n \n bool matchPins(DevicePin* sda, DevicePin* scl) {\n return this->sda == sda && this->scl == scl;\n }\n\n Buffer readBuffer(int address, int size, bool repeat = false)\n {\n Buffer buf = mkBuffer(NULL, size);\n registerGCObj(buf);\n int status = this->i2c.read(address << 1, buf->data, size, repeat);\n unregisterGCObj(buf);\n if (status != ErrorCode::DEVICE_OK) {\n buf = 0;\n }\n return buf;\n }\n\n int writeBuffer(int address, Buffer buf, bool repeat = false)\n {\n return this->i2c.write(address << 1, buf->data, buf->length, repeat);\n }\n};\n\n}\n\nnamespace I2CMethods {\n/**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n//%\nBuffer readBuffer(I2C_ i2c, int address, int size, bool repeat = false)\n{\n return i2c->readBuffer(address, size, repeat);\n}\n\n/**\n * Write bytes to a 7-bit I2C `address`.\n */\n//%\nint writeBuffer(I2C_ i2c, int address, Buffer buf, bool repeat = false)\n{\n return i2c->writeBuffer(address, buf, repeat);\n}\n\n}\n\nnamespace pins {\n\nstatic I2C_ i2cs(NULL);\n/**\n* Opens a Serial communication driver\n*/\n//% help=pins/create-i2c\n//% parts=i2c\nI2C_ createI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n // pick up defaults\n if (!sda || !scl) {\n DMESG(\"i2c: lookup default pins\");\n sda = LOOKUP_PIN(SDA);\n scl = LOOKUP_PIN(SCL);\n }\n\n // lookup existing devices\n auto dev = i2cs;\n while(dev) {\n if (dev->matchPins(sda, scl)) {\n DMESG(\"i2c: found existing i2c\");\n return dev;\n }\n dev = dev->next;\n }\n\n // allocate new one\n DMESG(\"i2c: mounting on new device\");\n auto ser = new CodalI2CProxy(sda, scl);\n // push in list\n ser->next = i2cs;\n i2cs = ser;\n return ser;\n}\n\n}\n\nnamespace pxt {\n CODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n auto i2c = pins::createI2C(sda, scl);\n return i2c->getI2C();\n }\n}\n\n#endif",
"i2c.ts": "namespace pins {\n /**\n * Read one number from an I2C address.\n */\n //% help=pins/i2c-read-number weight=5 group=\"i2c\" inlineInputMode=\"external\"\n //% blockId=pins_i2c_readnumber block=\"i2c read number at address %address|of format %format|repeated %repeated\"\n export function i2cReadNumber(address: number, format: NumberFormat, repeated?: boolean): number {\n const buf = pins.i2cReadBuffer(address, pins.sizeOf(format), repeated)\n if (!buf)\n return undefined\n return buf.getNumber(format, 0)\n }\n\n /**\n * Write one number to an I2C address.\n */\n //% help=pins/i2c-write-number weight=4 group=\"i2c\"\n //% blockId=i2c_writenumber block=\"i2c write number|at address %address|with value %value|of format %format|repeated %repeated\"\n export function i2cWriteNumber(address: number, value: number, format?: NumberFormat, repeated?: boolean): void {\n if (format == undefined)\n format = NumberFormat.UInt8LE;\n const buf = control.createBuffer(pins.sizeOf(format))\n buf.setNumber(format, 0, value)\n pins.i2cWriteBuffer(address, buf, repeated)\n }\n\n /**\n * Write a value in a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param value value to write\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-write-register\n //% blockId=i2c_writereg block=\"i2c write register|at address $address|at register $register|value $value\"\n export function i2cWriteRegister(address: number, register: number, value: number, valueFormat?: NumberFormat): void {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n const valueSize = pins.sizeOf(valueFormat);\n const buf = control.createBuffer(1 + valueSize);\n buf.setNumber(NumberFormat.UInt8LE, 0, register);\n buf.setNumber(valueFormat, 1, value);\n pins.i2cWriteBuffer(address, buf);\n }\n\n /**\n * Read the value from a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-read-register\n //% blockId=i2c_readreg block=\"i2c read register|at address $address|at register $register\"\n export function i2cReadRegister(address: number, register: number, valueFormat?: NumberFormat): number {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n pins.i2cWriteNumber(address, register, NumberFormat.UInt8LE);\n return pins.i2cReadNumber(address, valueFormat);\n }\n\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //%\n export function i2cReadBuffer(address: number, size: number, repeat: boolean = false): Buffer {\n return pins.i2c().readBuffer(address, size, repeat);\n }\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //%\n export function i2cWriteBuffer(address: number, buf: Buffer, repeat: boolean = false): number {\n return pins.i2c().writeBuffer(address, buf, repeat);\n }\n\n let _i2c: I2C;\n /**\n * Gets the default I2C bus\n */\n //%\n export function i2c(): I2C {\n if (!_i2c) {\n const sda = pins.pinByCfg(DAL.CFG_PIN_SDA);\n const scl = pins.pinByCfg(DAL.CFG_PIN_SCL);\n _i2c = pins.createI2C(sda, scl); \n }\n return _i2c; \n }\n\n export class I2CDevice {\n public address: number;\n public bus: I2C;\n private _hasError: boolean;\n constructor(address: number, bus?: I2C) {\n this.address = address;\n this.bus = bus || i2c();\n }\n public readInto(buf: Buffer, repeat = false, start = 0, end: number = null) {\n if (end === null)\n end = buf.length\n if (start >= end)\n return\n let res = this.bus.readBuffer(this.address, end - start, repeat)\n if (!res) {\n this._hasError = true\n return\n }\n buf.write(start, res)\n }\n public write(buf: Buffer, repeat = false) {\n let res = this.bus.writeBuffer(this.address, buf, repeat)\n if (res) {\n this._hasError = true\n }\n }\n public begin(): I2CDevice {\n this._hasError = false;\n return this;\n }\n public end() {\n }\n public ok() {\n return !this._hasError\n }\n\n public transfer(command: Buffer, response: Buffer, responseStart?: number, responseEnd?: number) {\n this.begin();\n if (command)\n this.write(command);\n if (response)\n this.readInto(response, false, responseStart, responseEnd);\n this.end();\n } \n }\n}\n",
"keyvaluestorage.cpp": "#include \"pxt.h\"\n#include \"KeyValueStorage.h\"\n\nnamespace pxt {\n\nclass WKeyValueStorage {\n#ifdef CODAL_NVMCONTROLLER\n CODAL_NVMCONTROLLER controller;\n#else\n NVMController controller;\n#endif\n KeyValueStorage storage;\n public:\n\n WKeyValueStorage()\n : controller()\n , storage(controller) {\n }\n\n bool isSupported() {\n#ifdef CODAL_NVMCONTROLLER\n return true;\n#else\n return false;\n#endif\n }\n\n int put(String key, Buffer data) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n return storage.put(mkey, data->data, data->length);\n#else\n return -1;\n#endif\n }\n\n Buffer get(String key) {\n#ifdef CODAL_NVMCONTROLLER\n Buffer buf = NULL;\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n auto entry = storage.get(mkey);\n if (entry) {\n buf = mkBuffer(entry->value, sizeof(entry->value));\n free(entry);\n }\n return buf;\n#else\n return NULL;\n#endif\n }\n\n void remove(String key) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n storage.remove(mkey);\n#endif\n }\n\n void clear() {\n#ifdef CODAL_NVMCONTROLLER\n storage.wipe();\n#endif\n }\n};\nSINGLETON(WKeyValueStorage);\n\n}\n\nnamespace configStorage {\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //%\n void setBuffer(String key, Buffer value) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->put(key, value);\n }\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //%\n Buffer getBuffer(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n return kvm->get(key);\n }\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //%\n void removeItem(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->remove(key);\n }\n\n /**\n * Clears the local storage\n */\n //%\n void clear() {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->clear();\n }\n}\n",
"keyvaluestorage.ts": "namespace configStorage {\n /**\n * Stores the value at the key entry\n * @param key identifier of the key (max 16 characters)\n * @param value identifier of the value (max 32 characters)\n */\n export function setItem(key: string, value: string) {\n if (value == null)\n configStorage.removeItem(key);\n else\n {\n let idx = 0;\n let buf = control.createBuffer(value.length + 1);\n buf[idx++] = value.length;\n let valBuf = control.createBufferFromUTF8(value);\n\n for (let i = 0; i < valBuf.length; i++)\n buf[idx++] = valBuf[i];\n\n configStorage.setBuffer(key, buf);\n }\n }\n\n /**\n * Retrieves the value at the key entry\n * @param key identifier of the key (max 16 characters)\n */\n export function getItem(key: string): string {\n const buf = configStorage.getBuffer(key);\n\n if (!buf)\n return undefined;\n\n let idx = 0;\n let count = buf[idx++];\n const retBuf = control.createBuffer(count);\n\n for (let i = 0; i < count; i++)\n retBuf[i] = buf[idx++];\n\n return retBuf.toString();\n }\n}\n",
"leveldetector.ts": "namespace pins {\n export class LevelDetector {\n public id: number;\n public min: number;\n public max: number;\n public lowThreshold: number;\n public highThreshold: number;\n private transition: number;\n private transitionMs: number;\n private _level: number;\n private _state: number;\n public onHigh: () => void;\n public onLow: () => void;\n public onNeutral: () => void;\n public transitionWindow: number;\n // minimum duration (ms) between events\n public transitionInterval: number;\n\n static LEVEL_THRESHOLD_NEUTRAL = 0;\n\n constructor(id: number,\n min: number, max: number,\n lowThreshold: number, highThreshold: number) {\n this.id = id;\n this.min = min;\n this.max = max;\n this.lowThreshold = lowThreshold;\n this.highThreshold = highThreshold;\n this.transitionWindow = 4;\n this.transitionInterval = 0;\n\n this.onHigh = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_HIGH);\n this.onLow = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_LOW);\n this.onNeutral = undefined;\n\n this.reset();\n }\n\n reset() {\n this.transition = 0;\n this.transitionMs = 0;\n this._level = Math.ceil((this.highThreshold - this.lowThreshold) / 2);\n this._state = LevelDetector.LEVEL_THRESHOLD_NEUTRAL;\n }\n\n get level(): number {\n return this._level;\n }\n\n set level(level: number) {\n this._level = this.clampValue(level);\n\n if (this._level >= this.highThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_HIGH);\n }\n else if (this._level <= this.lowThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_LOW);\n }\n else {\n this.setState(LevelDetector.LEVEL_THRESHOLD_NEUTRAL);\n }\n }\n\n public setLowThreshold(value: number) {\n this.lowThreshold = this.clampValue(value);\n this.reset();\n }\n\n public setHighThreshold(value: number) {\n this.highThreshold = this.clampValue(value);\n this.reset();\n }\n\n private clampValue(value: number) {\n if (value < this.min) {\n return this.min;\n }\n else if (value > this.max) {\n return this.max;\n }\n return value;\n }\n\n private setState(state: number) {\n // not enough samples to change\n if (this._state === state \n || (this.transition++ < this.transitionWindow)\n || (control.millis() - this.transitionMs) < this.transitionInterval) {\n return;\n }\n\n this.transition = 0;\n this.transitionMs = control.millis();\n this._state = state;\n switch (state) {\n case DAL.LEVEL_THRESHOLD_HIGH:\n if (this.onHigh) this.onHigh();\n break;\n case DAL.LEVEL_THRESHOLD_LOW:\n if (this.onLow) this.onLow();\n break;\n case LevelDetector.LEVEL_THRESHOLD_NEUTRAL:\n if (this.onNeutral) this.onNeutral();\n break;\n }\n }\n }\n}",
"light.cpp": "#include \"light.h\"\n\n// WS2812B timings, datasheet v1\n// 0 - 0.25-0.55us hi 0.70-1.00us low\n// 1 - 0.65-0.95us hi 0.30-0.60us low\n// datasheet v5\n// 0 - 0.22-0.38us hi 0.58-1.00us low 1-3\n// 1 - 0.58-1.00us hi 0.58-1.00us low 3-2\n\n#define SPI_SUPPORTED 1\n\n#if defined(NRF52_SERIES)\n#define BIT_EXPANSION 5\n#define SPI_FREQ 4000000\n#else\n#define BIT_EXPANSION 3\n#define SPI_FREQ 2400000\n#endif\n\n#if defined(SAMD21) || defined(SAMD51) || defined(STM32F4) || defined(NRF52_SERIES)\n#include \"neopixel.h\"\n#define BITBANG_SUPPORTED 1\n#else\n#define BITBANG_SUPPORTED 0\n#endif\n\n#define NEOPIXEL_MIN_LENGTH_FOR_SPI 24\n#define DOTSTAR_MIN_LENGTH_FOR_SPI 24\n\n#define LIGHTMODE_RGB 1\n#define LIGHTMODE_RGBW 2\n#define LIGHTMODE_RGB_RGB 3\n#define LIGHTMODE_DOTSTAR 4\n\nnamespace light {\nbool isValidMOSIPin(DigitalInOutPin pin) {\n if (!pin)\n return false;\n\n#if SAMD51\n return ZSPI::isValidMOSIPin(*pin);\n#elif defined(NRF52_SERIES)\n return true;\n#else\n // TODO: support for SPI neopixels\n // default SPI pins supported for now\n return pin == LOOKUP_PIN(MOSI);\n#endif\n}\n\n// SPI\nvoid spiNeopixelSendBuffer(DevicePin *pin, const uint8_t *data, unsigned size) {\n int32_t iptr = 0, optr = 120;\n uint32_t len = optr + size * BIT_EXPANSION + 120;\n uint8_t *expBuf = new uint8_t[len];\n memset(expBuf, 0, len);\n uint8_t imask = 0x80;\n uint8_t omask = 0x80;\n\n#define WR(k) \\\n if (k) \\\n expBuf[optr] |= omask; \\\n omask >>= 1; \\\n if (!omask) { \\\n omask = 0x80; \\\n optr++; \\\n }\n\n while (iptr < (int)size) {\n#if BIT_EXPANSION == 3\n WR(1);\n WR(data[iptr] & imask);\n WR(0);\n#elif BIT_EXPANSION == 5\n WR(1);\n if (data[iptr] & imask) {\n WR(1);\n WR(1);\n } else {\n WR(0);\n }\n WR(0);\n WR(0);\n#else\n#error \"invalid BIT_EXPANSION\"\n#endif\n\n imask >>= 1;\n if (!imask) {\n imask = 0x80;\n iptr++;\n }\n }\n\n auto spi = pxt::getSPI(pin, NULL, NULL);\n spi->setFrequency(SPI_FREQ);\n spi->transfer(expBuf, len, NULL, 0);\n delete expBuf;\n}\n\nvoid neopixelSendData(DevicePin *pin, int mode, const uint8_t *data, unsigned length) {\n if (!pin || !length)\n return;\n\n#if BITBANG_SUPPORTED\n if (SPI_SUPPORTED && length > NEOPIXEL_MIN_LENGTH_FOR_SPI && isValidMOSIPin(pin))\n spiNeopixelSendBuffer(pin, data, length);\n else\n neopixel_send_buffer(*pin, data, length);\n#else\n if (isValidMOSIPin(pin)) {\n spiNeopixelSendBuffer(pin, data, length);\n }\n#endif\n}\n\nvoid bitBangDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n // first frame of zeroes\n data->setDigitalValue(0);\n for (unsigned i = 0; i < 32; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n\n // data stream\n for (unsigned i = 0; i < length; ++i) {\n auto x = buf[i];\n for (uint8_t j = 0x80; j != 0; j >>= 1) {\n data->setDigitalValue(x & j ? 1 : 0);\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n }\n // https://cpldcpu.wordpress.com/2016/12/13/sk9822-a-clone-of-the-apa102/\n // reset frame\n // data->setDigitalValue(0);\n // for (unsigned i = 0; i < 32 ; ++i) {\n // clk->setDigitalValue(1);\n // clk->setDigitalValue(0);\n //}\n\n // https://cpldcpu.wordpress.com/2014/11/30/understanding-the-apa102-superled/\n data->setDigitalValue(1);\n unsigned n = 32;\n for (unsigned i = 0; i < n; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n}\n\nstatic uint8_t ZERO_FRAME[4];\nstatic uint8_t ONE_FRAME[] = {1, 1, 1, 1};\nvoid spiDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n auto spi = pxt::getSPI(data, NULL, clk);\n\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // initial frame\n spi->transfer(buf, length, NULL, 0);\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // reset frame\n for (unsigned i = 0; i < (length >> 3); i += 32)\n spi->transfer(ONE_FRAME, sizeof(ONE_FRAME), NULL, 0); // final frame\n}\n\nvoid dotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n if (!data || !clk || !buf || !length)\n return;\n\n if (length > DOTSTAR_MIN_LENGTH_FOR_SPI && isValidMOSIPin(data))\n spiDotStarSendData(data, clk, mode, buf, length);\n else\n bitBangDotStarSendData(data, clk, mode, buf, length);\n}\n\nvoid sendBuffer(DevicePin *data, DevicePin *clk, int mode, Buffer buf) {\n if (!data || !buf || !buf->length)\n return;\n\n if (mode == LIGHTMODE_DOTSTAR)\n light::dotStarSendData(data, clk, mode, buf->data, buf->length);\n else\n light::neopixelSendData(data, mode, buf->data, buf->length);\n}\n\nvoid clear() {\n auto neopix = LOOKUP_PIN(NEOPIXEL);\n auto neonum = getConfig(CFG_NUM_NEOPIXELS, 0);\n if (neopix && neonum >= 0) {\n auto n = 3 * neonum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n light::neopixelSendData(neopix, 0x100, off, sizeof(off));\n }\n\n auto data = LOOKUP_PIN(DOTSTAR_DATA);\n auto clk = LOOKUP_PIN(DOTSTAR_CLOCK);\n auto dsnum = getConfig(CFG_NUM_DOTSTARS, 0);\n if (data && clk && dsnum > 0) {\n auto n = 4 * dsnum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n for (int i = 0; i < n; i += 4)\n off[i] = 0xe0;\n bitBangDotStarSendData(data, clk, 0x100, off, sizeof(off));\n }\n}\n\n} // namespace light\n",
"light.h": "#ifndef __PXT_LIGHT_H\n#define __PXT_LIGHT_H\n\n#include \"pxt.h\"\n\nnamespace light {\n /**\n * Clear onboard neopixels\n */\n void clear();\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //%\n void sendBuffer(DigitalInOutPin data, DigitalInOutPin clk, int mode, Buffer buf);\n\n void neopixelSendData(DevicePin* pin, int mode, const uint8_t* data, unsigned length);\n}\n\n#endif",
"ns.ts": "/**\n * Events and data from sensors.\n */\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\n//% groups='[\"other\", \"More\"]'\nnamespace input {\n}\n\n/**\n * Servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\"\nnamespace servos {\n\n}\n\n/**\n * A Joint Asynchronous Communications, Device Agnostic Control.\n */\n//% color=\"#E79251\" weight=1 icon=\"\\uf185\"\n//% groups='[\"Broadcast\", \"Console\", \"Control\"]'\n//% blockGap=8\nnamespace jacdac {\n\n}",
"pins.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\nstatic DevicePin **pinPtrs;\nstatic uint8_t numPinPtrs;\nstatic uint8_t pinPos[DEV_NUM_PINS];\n\n//%\nDevicePin *getPin(int id) {\n\n id &= CFG_PIN_NAME_MSK;\n\n if (id >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n\n // we could use lookupComponent() here - it would be slightly slower\n\n int ptr = pinPos[id];\n if (ptr == 0) {\n pinPtrs = (DevicePin **)realloc(pinPtrs, (numPinPtrs + 1) * sizeof(void *));\n bool isAnalog = IS_ANALOG_PIN(id);\n // GCTODO\n pinPtrs[numPinPtrs++] =\n new DevicePin(DEVICE_ID_IO_P0 + id, (PinName)id,\n isAnalog ? PIN_CAPABILITY_AD : PIN_CAPABILITY_DIGITAL);\n ptr = numPinPtrs;\n pinPos[id] = ptr;\n }\n return pinPtrs[ptr - 1];\n}\n\n//%\nDevicePin *getPinCfg(int key) {\n int p = getConfig(key, -1);\n if (p == -1)\n DMESG(\"no pin cfg: %d\", key);\n return getPin(p);\n}\n\nvoid linkPin(int from, int to) {\n if (from < 0 || from >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n getPin(to);\n pinPos[from] = pinPos[to];\n}\n\n//%\nDevicePin *lookupPin(int pinName) {\n if (pinName < 0 || pinName == 0xff)\n return NULL;\n pinName &= CFG_PIN_NAME_MSK;\n return getPin(pinName);\n}\n\n//%\nDevicePin *lookupPinCfg(int key) {\n return lookupPin(getConfig(key));\n}\n\nCodalComponent *lookupComponent(int id) {\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; ++i) {\n if (CodalComponent::components[i] && CodalComponent::components[i]->id == id)\n return CodalComponent::components[i];\n }\n return NULL;\n}\n\n} // namespace pxt\n\nnamespace pins {\n/**\n* Get a pin by configuration id (DAL.CFG_PIN...)\n*/\n//%\nDigitalInOutPin pinByCfg(int key) {\n return pxt::lookupPinCfg(key);\n}\n\n/**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n//%\nBuffer createBuffer(int size) {\n return mkBuffer(NULL, size);\n}\n\n/**\n * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n//% help=pins/pulse-duration blockGap=8\n//% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n//% weight=19\nint pulseDuration() {\n return pxt::lastEvent.timestamp;\n}\n} // namespace pins\n",
"pins.h": "#ifndef __PXT_PINS_H\n#define __PXT_PINS_H\n\n#define BUTTON_ACTIVE_HIGH_PULL_DOWN (ACTIVE_HIGH | 0x10)\n#define BUTTON_ACTIVE_HIGH_PULL_UP (ACTIVE_HIGH | 0x20)\n#define BUTTON_ACTIVE_HIGH_PULL_NONE (ACTIVE_HIGH | 0x30)\n#define BUTTON_ACTIVE_LOW_PULL_DOWN (ACTIVE_LOW | 0x10)\n#define BUTTON_ACTIVE_LOW_PULL_UP (ACTIVE_LOW | 0x20)\n#define BUTTON_ACTIVE_LOW_PULL_NONE (ACTIVE_LOW | 0x30)\n\n#define PIN(name) ((PinName)pxt::getConfig(CFG_PIN_##name, -1))\n#define LOOKUP_PIN(name) pxt::lookupPin(PIN(name))\n\n// these can be overridden in platform.h\n#ifndef CODAL_PIN\n#define CODAL_PIN CODAL_MBED::Pin\n#endif\n\n#ifndef CODAL_TIMER\n#define CODAL_TIMER CODAL_MBED::Timer\n#endif\n\n#ifndef CODAL_SPI\n#define CODAL_SPI CODAL_MBED::SPI\n#endif\n\n#ifndef CODAL_SERIAL\n#define CODAL_SERIAL CODAL_MBED::Serial\n#endif\n\n#ifndef IS_ANALOG_PIN\n#define IS_ANALOG_PIN(id) ((DEV_ANALOG_PINS >> (id)) & 1)\n#endif\n\ntypedef CODAL_PIN DevicePin;\n\ntypedef DevicePin *DigitalInOutPin;\ntypedef DevicePin *AnalogInOutPin;\ntypedef DevicePin *AnalogInPin;\ntypedef DevicePin *AnalogOutPin;\ntypedef DevicePin *PwmPin;\ntypedef DevicePin *PwmOnlyPin;\ntypedef Button *Button_;\n\nnamespace pxt {\nDevicePin *getPin(int id);\nDevicePin *getPinCfg(int key);\nDevicePin *lookupPin(int pinName);\nDevicePin *lookupPinCfg(int key);\nvoid linkPin(int from, int to);\nCodalComponent *lookupComponent(int id);\n}\n\n#define PINOP(op) name->op\n\n#endif\n",
"pins.ts": "//% noRefCounting fixedInstances\ninterface DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogOutPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInOutPin extends AnalogInPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmOnlyPin extends DigitalInOutPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmPin extends PwmOnlyPin, AnalogInOutPin {\n}\n\n/**\n * Control currents in Pins for analog/digital signals, servos, i2c, ...\n */\n//% color=#A80000 weight=85 icon=\"\\uf140\" advanced=true\n//% groups='[\"other\", \"Servo\", \"i2c\"]'\nnamespace pins {\n}",
"pinsAnalog.cpp": "#include \"pxt.h\"\n\nnamespace AnalogInPinMethods {\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\n */\n//% help=pins/analog-read weight=53\n//% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nint analogRead(AnalogInPin name) {\n return PINOP(getAnalogValue());\n}\n}\n\nnamespace AnalogOutPinMethods {\nvoid analogWrite(AnalogOutPin name, int value) __attribute__ ((weak));\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\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n//% help=pins/analog-write weight=52\n//% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.min=0 value.max=1023\nvoid analogWrite(AnalogOutPin name, int value) {\n PINOP(setAnalogValue(value));\n}\n}",
"pinsDigital.cpp": "#include \"pxt.h\"\n\nenum class PulseValue {\n //% block=high\n High = DEVICE_PIN_EVT_PULSE_HI,\n //% block=low\n Low = DEVICE_PIN_EVT_PULSE_LO\n};\n\nenum class PinEvent {\n //% block=\"pulse high\"\n PulseHigh = DEVICE_PIN_EVT_PULSE_HI,\n //% block=\"pulse low\"\n PulseLow = DEVICE_PIN_EVT_PULSE_LO,\n //% block=\"rise\"\n Rise = DEVICE_PIN_EVT_RISE,\n //% block=\"fall\"\n Fall = DEVICE_PIN_EVT_FALL,\n};\n\nenum class PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2\n};\n\nnamespace DigitalInOutPinMethods {\n/**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n//% help=pins/digital-read weight=61\n//% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nbool digitalRead(DigitalInOutPin name) {\n return PINOP(getDigitalValue()) != 0;\n}\n\n/**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n//% help=pins/digital-write weight=60\n//% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid digitalWrite(DigitalInOutPin name, bool value) {\n PINOP(setDigitalValue(value));\n}\n\n/**\n* Make this pin a digital input, and create events where the timestamp is the duration\n* that this pin was either ``high`` or ``low``.\n*/\n//% help=pins/on-pulsed weight=16 blockGap=8\n//% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\n//% deprecated=1 hidden=1\nvoid onPulsed(DigitalInOutPin pin, PulseValue pulse, Action body) {\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)pulse, body);\n}\n\n/**\n* Register code to run when a pin event occurs. \n*/\n//% help=pins/on-event weight=20 blockGap=8\n//% blockId=pinsonevent block=\"on|pin %pin|%event\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nvoid onEvent(DigitalInOutPin pin, PinEvent event, Action body) {\n switch(event) {\n case PinEvent::PulseHigh:\n case PinEvent::PulseLow:\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)event, body);\n break;\n case PinEvent::Rise:\n case PinEvent::Fall:\n pin->eventOn(DEVICE_PIN_EVENT_ON_EDGE);\n registerWithDal(pin->id, (int)event, body);\n break; \n } \n}\n\n/**\n* Return the duration of a pulse in microseconds\n* @param name the pin which measures the pulse\n* @param value the value of the pulse (default high)\n* @param maximum duration in micro-seconds\n*/\n//% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n//% weight=18 blockGap=8\n//% help=\"pins/pulse-in\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nint pulseIn(DigitalInOutPin pin, PulseValue value, int maxDuration = 2000000) {\n int pulse = PulseValue::High == value ? 1 : 0;\n uint64_t tick = system_timer_current_time_us();\n uint64_t maxd = (uint64_t)maxDuration;\n while (pin->getDigitalValue() != pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n\n uint64_t start = system_timer_current_time_us();\n while (pin->getDigitalValue() == pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n uint64_t end = system_timer_current_time_us();\n return end - start;\n}\n\n/**\n* Set the pull direction of this pin.\n* @param name pin to set the pull mode on\n* @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n*/\n//% help=pins/set-pull weight=17 blockGap=8\n//% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid setPull(DigitalInOutPin name, PinPullMode pull) {\n PullMode m = pull == PinPullMode::PullDown ? PullMode::Down : pull == PinPullMode::PullUp\n ? PullMode::Up\n : PullMode::None;\n PINOP(setPull(m));\n}\n\n}\n\n#ifdef PXT_CODAL\n\nnamespace pxt {\n\nstatic void waitABit() {\n // for (int i = 0; i < 10; ++i)\n // asm volatile(\"nop\");\n}\n\nclass ButtonMultiplexer : public CodalComponent {\n public:\n Pin &latch;\n Pin &clock;\n Pin &data;\n uint32_t state;\n uint32_t invMask;\n uint16_t buttonIdPerBit[8];\n bool enabled;\n\n ButtonMultiplexer(uint16_t id)\n : latch(*LOOKUP_PIN(BTNMX_LATCH)), clock(*LOOKUP_PIN(BTNMX_CLOCK)),\n data(*LOOKUP_PIN(BTNMX_DATA)) {\n this->id = id;\n this->status |= DEVICE_COMPONENT_STATUS_SYSTEM_TICK;\n\n state = 0;\n invMask = 0;\n enabled = true;\n\n memset(buttonIdPerBit, 0, sizeof(buttonIdPerBit));\n\n data.getDigitalValue(PullMode::Down);\n latch.setDigitalValue(1);\n clock.setDigitalValue(1);\n }\n\n void disable() {\n data.getDigitalValue(PullMode::None);\n latch.getDigitalValue(PullMode::None);\n clock.getDigitalValue(PullMode::None);\n enabled = false;\n }\n\n bool isButtonPressed(int id) {\n for (int i = 0; i < 8; ++i) {\n if (buttonIdPerBit[i] == id)\n return (state & (1 << i)) != 0;\n }\n return false;\n }\n\n uint32_t readBits(int bits) {\n latch.setDigitalValue(0);\n waitABit();\n latch.setDigitalValue(1);\n waitABit();\n\n uint32_t state = 0;\n for (int i = 0; i < bits; i++) {\n state <<= 1;\n if (data.getDigitalValue(PullMode::Down))\n state |= 1;\n\n clock.setDigitalValue(0);\n waitABit();\n clock.setDigitalValue(1);\n waitABit();\n }\n\n return state;\n }\n\n virtual void periodicCallback() override {\n if (!enabled)\n return;\n\n uint32_t newState = readBits(8);\n newState ^= invMask;\n if (newState == state)\n return;\n\n for (int i = 0; i < 8; ++i) {\n uint32_t mask = 1 << i;\n if (!buttonIdPerBit[i])\n continue;\n int ev = 0;\n if (!(state & mask) && (newState & mask))\n ev = PXT_INTERNAL_KEY_DOWN;\n else if ((state & mask) && !(newState & mask))\n ev = PXT_INTERNAL_KEY_UP;\n if (ev) {\n Event(ev, buttonIdPerBit[i]);\n Event(ev, 0); // any key\n }\n }\n\n state = newState;\n }\n};\n\nstatic ButtonMultiplexer *btnMultiplexer;\nButtonMultiplexer *getMultiplexer() {\n if (!btnMultiplexer)\n btnMultiplexer = new ButtonMultiplexer(DEVICE_ID_FIRST_BUTTON);\n return btnMultiplexer;\n}\n\nint registerMultiplexedButton(int pin, int buttonId) {\n if (1050 <= pin && pin < 1058) {\n pin -= 50;\n getMultiplexer()->invMask |= 1 << (pin - 1000);\n }\n if (1000 <= pin && pin < 1008) {\n getMultiplexer()->buttonIdPerBit[pin - 1000] = buttonId;\n return 1;\n }\n return 0;\n}\n\nint multiplexedButtonIsPressed(int btnId) {\n if (btnMultiplexer)\n return btnMultiplexer->isButtonPressed(btnId) ? 512 : 0;\n return 0;\n}\n\n//% expose\nuint32_t readButtonMultiplexer(int bits) {\n if (!LOOKUP_PIN(BTNMX_CLOCK))\n return 0;\n return getMultiplexer()->readBits(bits);\n}\n\nvoid disableButtonMultiplexer() {\n if (LOOKUP_PIN(BTNMX_CLOCK)) {\n getMultiplexer()->disable();\n }\n}\n\n}\n\n#endif\n",
"pinsPWM.cpp": "#include \"pxt.h\"\n\nnamespace PwmPinMethods {\n}\n\nnamespace PwmOnlyPinMethods {\n\n/**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n//% help=pins/analog-set-period weight=51\n//% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid analogSetPeriod(PwmOnlyPin name, int period) {\n PINOP(setAnalogPeriodUs(period));\n}\n\n/**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n//% help=pins/servo-write weight=41 group=\"Servo\"\n//% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n//% parts=microservo trackArgs=0\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.defl=90\nvoid servoWrite(PwmOnlyPin name, int value) {\n PINOP(setServoValue(value));\n}\n\n/**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n//% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n//% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n//% parts=microservo blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid servoSetPulse(PwmOnlyPin name, int duration) {\n PINOP(setServoPulseUs(duration));\n}\n\n/**\n* Indicates if the servo is running continuously\n*/\n//% blockHidden=1\nvoid servoSetContinuous(PwmOnlyPin name, bool continuous) {\n // used by simulator\n}\n\n}",
"pinscompat.ts": "// filled in by microbit",
"platform.cpp": "#include \"pxt.h\"\n\n#include \"SAMDTCTimer.h\"\n#include \"SAMDTCCTimer.h\"\n#include \"light.h\"\n\nnamespace pxt {\n\nstruct TimerConfig {\n uint8_t id;\n uint8_t irq;\n uint8_t dmaovf;\n uint32_t addr;\n};\n\n#define DEF_TC(n) \\\n { 0x10 + n, TC##n##_IRQn, TC##n##_DMAC_ID_OVF, (uint32_t)TC##n }\n#ifdef SAMD21\n#define DEF_TCC(n) \\\n { 0x20 + n, TCC##n##_IRQn, TCC##n##_DMAC_ID_OVF, (uint32_t)TCC##n }\n#else\n#define DEF_TCC(n) \\\n { 0x20 + n, TCC##n##_0_IRQn, TCC##n##_DMAC_ID_OVF, (uint32_t)TCC##n }\n#endif\n\nstatic const TimerConfig timers[] = {\n#ifdef TC0\n DEF_TC(0),\n#endif\n#ifdef TC1\n DEF_TC(1),\n#endif\n#ifdef TC2\n DEF_TC(2),\n#endif\n#ifdef TC3\n DEF_TC(3),\n#endif\n#ifdef TC4\n DEF_TC(4),\n#endif\n#ifdef TC5\n DEF_TC(5),\n#endif\n\n#ifdef TCC0\n DEF_TCC(0),\n#endif\n#ifdef TCC1\n DEF_TCC(1),\n#endif\n#ifdef TCC2\n DEF_TCC(2),\n#endif\n\n {0, 0, 0, 0}};\n\n// Backlight:\n// Kitronik: PA6 TC1 (ch 0)\n// Adafruit: PA1 TC2 (ch 1)\n\n// TC3 is used by DAC on both D21 and D51\n// TCC0 and TC4 is used by IR\n// TCC0, TCC1, TC4 is used by PWM on CPX\n\n#ifdef SAMD21\n#define DEF_TIMERS 0x15222021 // TC5 TCC2 TCC0 TCC1\n#else\n#define DEF_TIMERS 0x10111200 // TC0 TC1 TC2\n#endif\n\nstatic uint32_t usedTimers;\nstatic int timerIdx(uint8_t id) {\n for (unsigned i = 0; timers[i].id; i++) {\n if (id == timers[i].id)\n return i;\n }\n return -1;\n}\nLowLevelTimer *allocateTimer() {\n uint32_t timersToUse = getConfig(CFG_TIMERS_TO_USE, DEF_TIMERS);\n uint8_t blTC = 0;\n // DAC hard-wired to TC3 right now\n uint8_t dacTC = 0x13;\n\n // if BL is on a known pin, don't use its PWM TC\n // this is a hack for legacy boards that don't have CFG_TIMERS_TO_USE\n auto blPin = PIN(DISPLAY_BL);\n if (blPin == PA01)\n blTC = 0x12;\n\n for (int shift = 24; shift >= 0; shift -= 8) {\n uint8_t tcId = (timersToUse >> shift) & 0xff;\n if (tcId == 0 || tcId == blTC || tcId == dacTC)\n continue;\n int idx = timerIdx(tcId);\n if (idx < 0 || (usedTimers & (1 << idx)))\n continue;\n LowLevelTimer *res;\n if (idx < 0x20) {\n Tc *tc = (Tc *)timers[idx].addr;\n if (tc->COUNT16.CTRLA.bit.ENABLE)\n continue;\n DMESG(\"allocate TC%d\", tcId & 0xf);\n res = new SAMDTCTimer(tc, timers[idx].irq);\n } else {\n Tcc *tcc = (Tcc *)timers[idx].addr;\n if (tcc->CTRLA.bit.ENABLE)\n continue;\n DMESG(\"allocate TCC%d\", tcId & 0xf);\n res = new SAMDTCCTimer(tcc, timers[idx].irq);\n }\n usedTimers |= 1 << idx;\n return res;\n }\n\n soft_panic(PANIC_OUT_OF_TIMERS);\n return NULL;\n}\n\nstatic void initRandomSeed() {\n int seed = 0xC0DA1;\n // TODO use TRNG\n seedRandom(seed);\n}\n\nvoid platformSendSerial(const char *data, int len) {}\n\n#ifdef SAMD21\nstatic void remapSwdPin(int pinCfg, int fallback) {\n int pinName = getConfig(pinCfg);\n if (pinName == PA30 || pinName == PA31) {\n if (getConfig(CFG_SWD_ENABLED, 0)) {\n linkPin(pinName, fallback);\n } else {\n PORT->Group[pinName / 32].PINCFG[pinName % 32].reg = (uint8_t)PORT_PINCFG_INEN;\n }\n }\n}\n\nstatic void initSwdPins() {\n remapSwdPin(CFG_PIN_NEOPIXEL, PIN(D0));\n remapSwdPin(CFG_PIN_RXLED, PIN(D1));\n remapSwdPin(CFG_PIN_SPEAKER_AMP, PIN(A2));\n}\n#else\nstatic void initSwdPins() {}\n#endif\n\nvoid platform_init() {\n initSwdPins();\n initRandomSeed();\n setSendToUART(platformSendSerial);\n light::clear();\n\n /*\n if (*HF2_DBG_MAGIC_PTR == HF2_DBG_MAGIC_START) {\n *HF2_DBG_MAGIC_PTR = 0;\n // this will cause alignment fault at the first breakpoint\n globals[0] = (TValue)1;\n }\n */\n}\n\nint *getBootloaderConfigData() {\n#ifdef SAMD51\n auto config_data = *(uint32_t *)(BOOTLOADER_END - 4 * 4);\n if (config_data && (config_data & 3) == 0 && config_data < BOOTLOADER_END) {\n auto p = (uint32_t *)config_data;\n if (p[0] == CFG_MAGIC0 && p[1] == CFG_MAGIC1)\n return (int *)p + 4;\n }\n#endif\n return NULL;\n}\n\n} // namespace pxt\n\nvoid cpu_clock_init() {}\n",
"platform.h": "#ifndef __PXT_PLATFORM_H\n#define __PXT_PLATFORM_H\n\n#include \"Image.h\"\n#include \"MultiButton.h\"\n#include \"ZPin.h\"\n#include \"Timer.h\"\n#include \"SAMDDAC.h\"\n#include \"ZSPI.h\"\n#include \"ZI2C.h\"\n#include \"ZSingleWireSerial.h\"\n#include \"SAMDNVM.h\"\n#include \"SAMDPDM.h\"\n#include \"SAMDSerial.h\"\n\n// cap touch not available on 51 yet\n#ifdef SAMD21\n#include \"CapTouchButton.h\"\n#endif\n\n#define MIC_DEVICE SAMD21PDM\n\n#ifdef SAMD21\n#define OUTPUT_BITS 10\n#else\n#define OUTPUT_BITS 12\n#endif\n\n#include \"pinmap.h\"\n\n#undef min\n#undef max\n\ntypedef int PinName;\n\n#define PAGE_SIZE 512\n\n#define BOOTLOADER_START 0x0\n\n#ifdef SAMD21\n#define BOOTLOADER_END 0x2000\n#endif\n\n#ifdef SAMD51\n#define BOOTLOADER_END 0x4000\n#endif\n\n#define USB_HANDOVER 0\n\n// if we ever want to support 100+ pin packages, need to add PC,PD ports and increase this to 128\n#ifdef SAMD51\n#define DEV_NUM_PINS 128\n#else\n#define DEV_NUM_PINS 64\n#endif\n\n#define IS_ANALOG_PIN(id) 1\n\n#define CODAL_PIN ZPin\n#define CODAL_TIMER Timer\n#define CODAL_SPI ZSPI\n#define CODAL_I2C ZI2C\n#define CODAL_JACDAC_WIRE_SERIAL codal::ZSingleWireSerial\n#define CODAL_SERIAL codal::SAMDSerial\n#define CODAL_DAC SAMDDAC\n\n#ifdef SAMD21\n#define CODAL_NVMCONTROLLER codal::SAMDNVM\n#endif\n\n#define PXT_74HC165 1\n\n#define IMAGE_BITS 4\n\n// The parameters below needs tuning!\n\n#define PA00 0\n#define PA01 1\n#define PA02 2\n#define PA03 3\n#define PA04 4\n#define PA05 5\n#define PA06 6\n#define PA07 7\n#define PA08 8\n#define PA09 9\n#define PA10 10\n#define PA11 11\n#define PA12 12\n#define PA13 13\n#define PA14 14\n#define PA15 15\n#define PA16 16\n#define PA17 17\n#define PA18 18\n#define PA19 19\n#define PA20 20\n#define PA21 21\n#define PA22 22\n#define PA23 23\n#define PA24 24\n#define PA25 25\n#define PA26 26\n#define PA27 27\n#define PA28 28\n#define PA29 29\n#define PA30 30\n#define PA31 31\n#define PB00 32\n#define PB01 33\n#define PB02 34\n#define PB03 35\n#define PB04 36\n#define PB05 37\n#define PB06 38\n#define PB07 39\n#define PB08 40\n#define PB09 41\n#define PB10 42\n#define PB11 43\n#define PB12 44\n#define PB13 45\n#define PB14 46\n#define PB15 47\n#define PB16 48\n#define PB17 49\n#define PB18 50\n#define PB19 51\n#define PB20 52\n#define PB21 53\n#define PB22 54\n#define PB23 55\n#define PB24 56\n#define PB25 57\n#define PB26 58\n#define PB27 59\n#define PB28 60\n#define PB29 61\n#define PB30 62\n#define PB31 63\n#define PC00 64\n#define PC01 65\n#define PC02 66\n#define PC03 67\n#define PC04 68\n#define PC05 69\n#define PC06 70\n#define PC07 71\n#define PC08 72\n#define PC09 73\n#define PC10 74\n#define PC11 75\n#define PC12 76\n#define PC13 77\n#define PC14 78\n#define PC15 79\n#define PC16 80\n#define PC17 81\n#define PC18 82\n#define PC19 83\n#define PC20 84\n#define PC21 85\n#define PC22 86\n#define PC23 87\n#define PC24 88\n#define PC25 89\n#define PC26 90\n#define PC27 91\n#define PC28 92\n#define PC29 93\n#define PC30 94\n#define PC31 95\n#define PD00 96\n#define PD01 97\n#define PD02 98\n#define PD03 99\n#define PD04 100\n#define PD05 101\n#define PD06 102\n#define PD07 103\n#define PD08 104\n#define PD09 105\n#define PD10 106\n#define PD11 107\n#define PD12 108\n#define PD13 109\n#define PD14 110\n#define PD15 111\n#define PD16 112\n#define PD17 113\n#define PD18 114\n#define PD19 115\n#define PD20 116\n#define PD21 117\n#define PD22 118\n#define PD23 119\n#define PD24 120\n#define PD25 121\n#define PD26 122\n#define PD27 123\n#define PD28 124\n#define PD29 125\n#define PD30 126\n#define PD31 127\n#endif\n",
"pxt.h": "#ifndef __PXT_H\n#define __PXT_H\n\n#include \"pxtbase.h\"\n\n#include \"CodalConfig.h\"\n#include \"CodalHeapAllocator.h\"\n#include \"CodalDevice.h\"\n#include \"CodalDmesg.h\"\n#include \"ErrorNo.h\"\n#include \"Timer.h\"\n#include \"Matrix4.h\"\n#include \"CodalCompat.h\"\n#include \"CodalComponent.h\"\n#include \"ManagedType.h\"\n#include \"Event.h\"\n#include \"NotifyEvents.h\"\n#include \"Button.h\"\n#include \"CodalFiber.h\"\n#include \"MessageBus.h\"\n#include \"MultiButton.h\"\n\nusing namespace codal;\n\n// codal::ManagedString compat\n#define MSTR(s) codal::ManagedString((s)->data, (s)->length)\n#define PSTR(s) mkString((s).toCharArray(), (s).length())\n\n#include \"pins.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"hf2.h\"\n#include \"hf2dbg.h\"\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n#include \"HIDMouse.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n#include \"HIDKeyboard.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n#include \"HIDJoystick.h\"\n#endif\n#endif\n\n#define PXT_COMM_BASE 0x20002000 // 8k in\n\nnamespace pxt {\n\n#if CONFIG_ENABLED(DEVICE_USB)\nextern CodalUSB usb;\nextern HF2 hf2;\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nextern USBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nextern USBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nextern USBHIDJoystick joystick;\n#endif\n#endif\n\n// Utility functions\nextern Event lastEvent;\nextern CODAL_TIMER devTimer;\nextern MessageBus devMessageBus;\nextern codal::CodalDevice device;\n\nvoid set_usb_strings(const char *uf2_info);\nextern void (*logJDFrame)(const uint8_t *data);\nextern void (*sendJDFrame)(const uint8_t *data);\n\nstatic inline void raiseEvent(int src, int val) {\n Event(src, val);\n}\n\n} // namespace pxt\n\nnamespace pins {\nclass CodalSPIProxy;\nclass CodalI2CProxy;\n} // namespace pins\n\ntypedef pins::CodalI2CProxy* I2C_;\ntypedef pins::CodalSPIProxy* SPI_;\n\nnamespace pxt {\ncodal::LowLevelTimer *allocateTimer();\n\n#ifdef CODAL_I2C\nCODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl);\n#endif\nCODAL_SPI* getSPI(DigitalInOutPin mosi, DigitalInOutPin miso, DigitalInOutPin sck);\n#ifdef CODAL_JACDAC_WIRE_SERIAL\nLowLevelTimer* getJACDACTimer();\n#endif\nclass PressureButton;\nuint32_t readButtonMultiplexer(int bits);\nvoid disableButtonMultiplexer();\n}\n\nnamespace serial {\nclass CodalSerialDeviceProxy;\n}\n\ntypedef serial::CodalSerialDeviceProxy* SerialDevice;\n\nnamespace jacdac {\nclass JDProxyDriver;\n} // namespace network\n\ntypedef jacdac::JDProxyDriver* JacDacDriverStatus;\n\n#define DEVICE_ID_BUTTON_SLIDE 3000\n#define DEVICE_ID_MICROPHONE 3001\n#define DEVICE_ID_FIRST_BUTTON 4000\n#define DEVICE_ID_FIRST_TOUCHBUTTON 4100\n\n#define PXT_INTERNAL_KEY_UP 2050\n#define PXT_INTERNAL_KEY_DOWN 2051\n\n#endif\n",
"pxt.json": "{\n \"name\": \"core---samd\",\n \"description\": \"The core library for Codal-based targets\",\n \"dependencies\": {\n \"base\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"dal.d.ts\",\n \"codal.cpp\",\n \"usb.cpp\",\n \"pxt.h\",\n \"platform.h\",\n \"platform.cpp\",\n \"pxtcore.h\",\n \"pins.h\",\n \"pins.cpp\",\n \"pinsAnalog.cpp\",\n \"pinsDigital.cpp\",\n \"pinsPWM.cpp\",\n \"pins.ts\",\n \"pinscompat.ts\",\n \"control.cpp\",\n \"i2c.cpp\",\n \"i2c.ts\",\n \"spi.cpp\",\n \"spi.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"hf2.cpp\",\n \"hf2.h\",\n \"hf2dbg.h\",\n \"uf2format.h\",\n \"uf2hid.h\",\n \"ns.ts\",\n \"dmac.cpp\",\n \"dmac.h\",\n \"timer.ts\",\n \"light.cpp\",\n \"light.h\",\n \"keyvaluestorage.cpp\",\n \"keyvaluestorage.ts\",\n \"leveldetector.ts\",\n \"pxtparts.json\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"cppDependencies\": {\n \"accelerometer\": \"file:../accelerometer\",\n \"mixer---samd\": \"file:../mixer---samd\",\n \"buttons\": \"file:../buttons\",\n \"game\": \"file:../game\",\n \"light\": \"file:../light\",\n \"lightsensor\": \"file:../lightsensor\",\n \"microphone\": \"file:../microphone\",\n \"screen---st7735\": \"file:../screen---st7735\",\n \"serial\": \"file:../serial\",\n \"switch\": \"file:../switch\",\n \"touch\": \"file:../touch\",\n \"thermometer\": \"file:../thermometer\",\n \"lcd\": \"file:../lcd\"\n },\n \"yotta\": {\n \"config\": {\n \"codal\": {\n \"component_count\": 64,\n \"dmesg_buffer_size\": 1024\n }\n }\n },\n \"dalDTS\": {\n \"includeDirs\": [\n \"libraries/codal-core/inc\",\n \"pxtapp\"\n ],\n \"excludePrefix\": [\n \"JD_\",\n \"USB_\",\n \"REQUEST_\",\n \"LIS3DH_\",\n \"FXOS8700_\",\n \"HF2_\",\n \"PXT_REF_TAG_\",\n \"MS_\",\n \"SCSI_\",\n \"MAG_\",\n \"MAG3\",\n \"MPU6\",\n \"MADCTL\",\n \"MMA8\"\n ]\n }\n}\n",
"pxtcore.h": "#ifndef __PXTCORE_H\n#define __PXTCORE_H\n\n#include \"CodalDmesg.h\"\n#include \"CodalHeapAllocator.h\"\n\n#define PXT_CODAL 1\n\n#define itoa(a, b) codal::itoa(a, b)\n\n#define GC_GET_HEAP_SIZE() device_heap_size(0)\n#define GC_STACK_BASE DEVICE_STACK_BASE\n#define xmalloc device_malloc\n#define xfree device_free\n\n// on most devices we allocate the entire heap at once, so large allocs should work\n// if they don't you just get the regular out of memory instead of alloc too large\n#define GC_MAX_ALLOC_SIZE (128 * 1024)\n\n#endif\n",
"pxtparts.json": "{\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\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createStrip,light.createNeoPixelStrip\",\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 \"dotstar\": {\n \"simulationBehavior\": \"dotstar\",\n \"visual\": {\n \"builtIn\": \"dotstar\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 1\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createAPA102Strip\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"dataPin\"\n },\n {\n \"pinInstantiationIdx\": 1,\n \"partParameter\": \"clkPin\"\n },\n {\n \"partParameter\": \"mode\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n },\n \"pixels\": {\n \"simulationBehavior\": \"pixels\",\n \"visual\": { \n \"builtIn\": \"pixels\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"MOSI\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"SCK\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\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, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n }, \n \"buttons\": {\n \"simulationBehavior\": \"buttons\",\n \"visual\": {\n \"builtIn\": \"buttons\",\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 },\n \"numberOfPins\": 2,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"Button.onEvent,Button.isPressed,Button.wasPressed\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"button\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n }\n ]\n },\n \"slideswitch\": {\n \"numberOfPins\": 3,\n \"simulationBehavior\": \"slideswitch\",\n \"visual\": {\n \"builtIn\": \"slideswitch\",\n \"width\": 100,\n \"height\": 100,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 30,\n \"y\": 0\n },\n {\n \"x\": 45,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalRead,DigitalInOutPin.onPulsed,DigitalInOutPin.onEvent\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"pin\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\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 \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"PwmOnlyPin.servoWrite,servos.Servo.setAngle,servos.Servo.run,servos.Servo.setPulse\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\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 \"led\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"analogled\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogOutPin.analogWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"photocell\": {\n \"numberOfPins\": 3,\n \"visual\": {\n \"builtIn\": \"photocell\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 15,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"photocell\",\n \"pinDefinitions\": [\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogInPin.analogRead\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n }\n}",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace light {\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //% shim=light::sendBuffer\n function sendBuffer(data: DigitalInOutPin, clk: DigitalInOutPin, mode: int32, buf: Buffer): void;\n}\ndeclare namespace control {\n\n /**\n * Determines if the USB has been enumerated.\n */\n //% shim=control::isUSBInitialized\n function isUSBInitialized(): boolean;\n}\ndeclare namespace pins {\n\n /**\n * Get a pin by configuration id (DAL.CFG_PIN...)\n */\n //% shim=pins::pinByCfg\n function pinByCfg(key: int32): DigitalInOutPin;\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 * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n //% help=pins/pulse-duration blockGap=8\n //% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n //% weight=19 shim=pins::pulseDuration\n function pulseDuration(): int32;\n}\n\n\ndeclare interface AnalogInPin {\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\n */\n //% help=pins/analog-read weight=53\n //% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=AnalogInPinMethods::analogRead\n analogRead(): int32;\n}\n\n\ndeclare interface AnalogOutPin {\n /**\n * Set the connector value as analog. Value must be comprised between 0 and 1023.\n * @param name pin name to write to\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n //% help=pins/analog-write weight=52\n //% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.min=0 value.max=1023 shim=AnalogOutPinMethods::analogWrite\n analogWrite(value: int32): void;\n}\n\n\ndeclare interface DigitalInOutPin {\n /**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n //% help=pins/digital-read weight=61\n //% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalRead\n digitalRead(): boolean;\n\n /**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n //% help=pins/digital-write weight=60\n //% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalWrite\n digitalWrite(value: boolean): void;\n\n /**\n * Make this pin a digital input, and create events where the timestamp is the duration\n * that this pin was either ``high`` or ``low``.\n */\n //% help=pins/on-pulsed weight=16 blockGap=8\n //% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4\n //% deprecated=1 hidden=1 shim=DigitalInOutPinMethods::onPulsed\n onPulsed(pulse: PulseValue, body: () => void): void;\n\n /**\n * Register code to run when a pin event occurs. \n */\n //% help=pins/on-event weight=20 blockGap=8\n //% blockId=pinsonevent block=\"on|pin %pin|%event\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 shim=DigitalInOutPinMethods::onEvent\n onEvent(event: PinEvent, body: () => void): void;\n\n /**\n * Return the duration of a pulse in microseconds\n * @param name the pin which measures the pulse\n * @param value the value of the pulse (default high)\n * @param maximum duration in micro-seconds\n */\n //% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n //% weight=18 blockGap=8\n //% help=\"pins/pulse-in\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 maxDuration.defl=2000000 shim=DigitalInOutPinMethods::pulseIn\n pulseIn(value: PulseValue, maxDuration?: int32): int32;\n\n /**\n * Set the pull direction of this pin.\n * @param name pin to set the pull mode on\n * @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n */\n //% help=pins/set-pull weight=17 blockGap=8\n //% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::setPull\n setPull(pull: PinPullMode): void;\n}\n\n\ndeclare interface PwmPin {}\n\n\ndeclare interface PwmOnlyPin {\n /**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n //% help=pins/analog-set-period weight=51\n //% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::analogSetPeriod\n analogSetPeriod(period: int32): void;\n\n /**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n //% help=pins/servo-write weight=41 group=\"Servo\"\n //% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n //% parts=microservo trackArgs=0\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.defl=90 shim=PwmOnlyPinMethods::servoWrite\n servoWrite(value?: int32): void;\n\n /**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n //% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n //% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n //% parts=microservo blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::servoSetPulse\n servoSetPulse(duration: int32): void;\n\n /**\n * Indicates if the servo is running continuously\n */\n //% blockHidden=1 shim=PwmOnlyPinMethods::servoSetContinuous\n servoSetContinuous(continuous: boolean): void;\n}\ndeclare namespace control {\n\n /**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\"\n //% help=control/raise-event\n //% block=\"raise event|from %src|with value %value\" blockExternalInputs=1 shim=control::raiseEvent\n function raiseEvent(src: int32, value: int32): void;\n\n /**\n * Determine the version of system software currently running.\n */\n //% blockId=\"control_device_dal_version\" block=\"device dal version\"\n //% help=control/device-dal-version shim=control::deviceDalVersion\n function deviceDalVersion(): string;\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}\n\n\ndeclare interface I2C {\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::readBuffer\n readBuffer(address: int32, size: int32, repeat?: boolean): Buffer;\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::writeBuffer\n writeBuffer(address: int32, buf: Buffer, repeat?: boolean): int32;\n}\ndeclare namespace pins {\n\n /**\n * Opens a Serial communication driver\n */\n //% help=pins/create-i2c\n //% parts=i2c shim=pins::createI2C\n function createI2C(sda: DigitalInOutPin, scl: DigitalInOutPin): I2C;\n}\ndeclare namespace pins {\n\n /**\n * Opens a SPI driver\n */\n //% help=pins/create-spi\n //% parts=spi shim=pins::createSPI\n function createSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin): SPI;\n\n /**\n * Opens a slave SPI driver\n */\n //% parts=spi shim=pins::createSlaveSPI\n function createSlaveSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin, csPin: DigitalInOutPin): SPI;\n}\n\n\ndeclare interface SPI {\n /**\n * Write to the SPI bus\n */\n //% shim=SPIMethods::write\n write(value: int32): int32;\n\n /**\n * Transfer buffers over the SPI bus\n */\n //% argsNullable shim=SPIMethods::transfer\n transfer(command: Buffer, response: Buffer): void;\n\n /**\n * Sets the SPI clock frequency\n */\n //% shim=SPIMethods::setFrequency\n setFrequency(frequency: int32): void;\n\n /**\n * Sets the SPI bus mode\n */\n //% shim=SPIMethods::setMode\n setMode(mode: int32): void;\n}\ndeclare namespace configStorage {\n\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //% shim=configStorage::setBuffer\n function setBuffer(key: string, value: Buffer): void;\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::getBuffer\n function getBuffer(key: string): Buffer;\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::removeItem\n function removeItem(key: string): void;\n\n /**\n * Clears the local storage\n */\n //% shim=configStorage::clear\n function clear(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"spi.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n\nnamespace pins {\n\nclass CodalSPIProxy {\nprivate:\n DevicePin* mosi; \n DevicePin* miso; \n DevicePin* sck;\n CODAL_SPI spi;\npublic:\n CodalSPIProxy* next;\n\npublic:\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck) \n , next(NULL)\n {\n }\n\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck, DevicePin* _cs)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck, _cs) \n , next(NULL)\n {\n }\n#endif\n\n CODAL_SPI* getSPI() {\n return &spi;\n }\n\n bool matchPins(DevicePin* mosi, DevicePin* miso, DevicePin* sck) {\n return this->mosi == mosi && this->miso == miso && this->sck == sck;\n }\n\n int write(int value) {\n return spi.write(value);\n }\n\n void transfer(Buffer command, Buffer response) {\n auto cdata = NULL == command ? NULL : command->data;\n auto clength = NULL == command ? 0 : command->length;\n auto rdata = NULL == response ? NULL : response->data;\n auto rlength = NULL == response ? 0 : response->length;\n spi.transfer(cdata, clength, rdata, rlength);\n }\n\n void setFrequency(int frequency) {\n spi.setFrequency(frequency);\n }\n\n void setMode(int mode) {\n spi.setMode(mode);\n }\n};\n\nSPI_ spis(NULL);\n\n/**\n* Opens a SPI driver\n*/\n//% help=pins/create-spi\n//% parts=spi\nSPI_ createSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto dev = spis;\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin);\n ser->next = spis;\n spis = ser;\n return ser;\n}\n\n/**\n* Opens a slave SPI driver\n*/\n//% parts=spi\nSPI_ createSlaveSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin, DigitalInOutPin csPin) {\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n auto dev = spis;\n if (!csPin)\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin, csPin);\n ser->next = spis;\n spis = ser;\n return ser;\n#else\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n return NULL;\n#endif\n}\n\n}\n\nnamespace pxt {\n\nCODAL_SPI* getSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto spi = pins::createSPI(mosiPin, misoPin, sckPin);\n return spi->getSPI();\n}\n\n}\n\nnamespace SPIMethods {\n\n/**\n* Write to the SPI bus\n*/\n//%\nint write(SPI_ device, int value) {\n return device->write(value);\n}\n\n/**\n* Transfer buffers over the SPI bus\n*/\n//% argsNullable\nvoid transfer(SPI_ device, Buffer command, Buffer response) {\n if (!device)\n soft_panic(PANIC_CAST_FROM_NULL);\n if (!command && !response)\n return;\n device->transfer(command, response);\n}\n\n/**\n* Sets the SPI clock frequency\n*/\n//%\nvoid setFrequency(SPI_ device, int frequency) {\n device->setFrequency(frequency);\n}\n\n/**\n* Sets the SPI bus mode\n*/\n//%\nvoid setMode(SPI_ device, int mode) {\n device->setMode(mode);\n}\n\n}\n",
"spi.ts": "namespace pins {\n\n let _spi: SPI;\n /**\n * Gets the default SPI driver\n */\n //%\n export function spi() {\n if (!_spi) {\n const mosi = pins.pinByCfg(DAL.CFG_PIN_MOSI);\n const miso = pins.pinByCfg(DAL.CFG_PIN_MISO);\n const sck = pins.pinByCfg(DAL.CFG_PIN_SCK);\n _spi = pins.createSPI(mosi, miso, sck);\n }\n return _spi;\n }\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 weight=5 advanced=true\n //% blockId=spi_write block=\"spi write %value\"\n export function spiWrite(value: number) {\n return spi().write(value);\n }\n\n /**\n * Write a given command to SPI bus, and at the same time read the response.\n */\n //% help=pins/spi-transfer weight=4 advanced=true\n //% blockId=spi_transfer block=\"spi transfer %command into %response\"\n export function spiTransfer(command: Buffer, response: Buffer) {\n spi().transfer(command, response);\n }\n\n /**\n * Set the SPI frequency\n * @param frequency the clock frequency, eg: 1000000\n */\n //% help=pins/spi-frequency weight=4 advanced=true\n //% blockId=spi_frequency block=\"spi frequency %frequency\"\n export function spiFrequency(frequency: number) {\n spi().setFrequency(frequency);\n }\n\n /**\n * Set the SPI signal mode\n * @param mode the mode, eg: 3\n */\n //% help=pins/spi-mode weight=3 advanced=true\n //% blockId=spi_mode block=\"spi mode %mode\"\n export function spiMode(mode: number) {\n spi().setMode(mode);\n }\n}",
"test.ts": "let i = 1\nlet f = 0.5\nlet plus = i + f\nlet minus = i - f\n\nlet r = Math.random()\nlet ri = Math.randomRange(5, 10)\n\n",
"timer.ts": "namespace control {\n /**\n * A timer\n */\n //% fixedInstances\n export class Timer {\n start: number;\n\n constructor() {\n this.start = control.millis();\n }\n\n /**\n * Gets the elapsed time in millis since the last reset\n */\n //% blockId=timerMillis block=\"%timer|millis\"\n millis(): number {\n return control.millis() - this.start;\n }\n\n /**\n * Gets the elapsed time in seconds since the last reset\n */\n //% blockId=timerSeconds block=\"%timer|seconds\"\n seconds(): number {\n return this.millis() / 1000;\n }\n\n /**\n * Resets the timer\n */\n //% blockId=timerRest block=\"%timer|reset\"\n reset() {\n this.start = control.millis();\n }\n\n /**\n * Pauses until the timer reaches the given amount of milliseconds\n * @param ms how long to pause for, eg: 5, 100, 200, 500, 1000, 2000\n */\n //% blockId=timerPauseUntil block=\"%timer|pause until (ms) %ms\"\n pauseUntil(ms: number) {\n const remaining = this.millis() - ms;\n pause(Math.max(0, remaining));\n }\n }\n\n //% whenUsed fixedInstance block=\"timer 1\"\n export const timer1 = new Timer();\n //% whenUsed fixedInstance block=\"timer 2\"\n export const timer2 = new Timer();\n //% whenUsed fixedInstance block=\"timer 3\"\n export const timer3 = new Timer();\n //% whenUsed fixedInstance block=\"timer 4\"\n export const timer4 = new Timer();\n //% whenUsed fixedInstance block=\"timer 5\"\n export const timer5 = new Timer();\n //% whenUsed fixedInstance block=\"timer 6\"\n export const timer6 = new Timer();\n //% whenUsed fixedInstance block=\"timer 7\"\n export const timer7 = new Timer();\n //% whenUsed fixedInstance block=\"timer 8\"\n export const timer8 = new Timer();\n}",
"uf2format.h": "#ifndef UF2FORMAT_H\n#define UF2FORMAT_H 1\n\n#include \n#include \n\n// All entries are little endian.\n\n#ifndef BOOTLOADER_START\n#define BOOTLOADER_START 0x0\n#endif\n\n#ifndef BOOTLOADER_END\n#define BOOTLOADER_END 0x2000\n#endif\n\n#ifndef UF2_BINFO\n#define UF2_BINFO ((UF2_BInfo *)(BOOTLOADER_END - sizeof(UF2_BInfo)))\n#endif\n\n#ifndef UF2_INFO_TXT\n#define UF2_INFO_TXT UF2_BINFO->info_uf2\n#endif\n\n\n#define UF2_MAGIC_START0 0x0A324655UL // \"UF2\\n\"\n#define UF2_MAGIC_START1 0x9E5D5157UL // Randomly selected\n#define UF2_MAGIC_END 0x0AB16F30UL // Ditto\n\n// If set, the block is \"comment\" and should not be flashed to the device\n#define UF2_FLAG_NOFLASH 0x00000001\n\ntypedef struct {\n // 32 byte header\n uint32_t magicStart0;\n uint32_t magicStart1;\n uint32_t flags;\n uint32_t targetAddr;\n uint32_t payloadSize;\n uint32_t blockNo;\n uint32_t numBlocks;\n uint32_t reserved;\n\n // raw data;\n uint8_t data[476];\n\n // store magic also at the end to limit damage from partial block reads\n uint32_t magicEnd;\n} UF2_Block;\n\ntypedef struct {\n uint8_t version;\n uint8_t ep_in;\n uint8_t ep_out;\n uint8_t reserved0;\n uint32_t cbw_tag;\n uint32_t blocks_remaining;\n uint8_t *buffer;\n} UF2_HandoverArgs;\n\ntypedef void (*UF2_MSC_Handover_Handler)(UF2_HandoverArgs *handover);\ntypedef void (*UF2_HID_Handover_Handler)(int ep);\n\n// this is required to be exactly 16 bytes long by the linker script\ntypedef struct {\n void *reserved0;\n UF2_HID_Handover_Handler handoverHID;\n UF2_MSC_Handover_Handler handoverMSC;\n const char *info_uf2;\n} UF2_BInfo;\n\nstatic inline bool is_uf2_block(void *data) {\n UF2_Block *bl = (UF2_Block *)data;\n return bl->magicStart0 == UF2_MAGIC_START0 && bl->magicStart1 == UF2_MAGIC_START1 &&\n bl->magicEnd == UF2_MAGIC_END;\n}\n\nstatic inline bool in_uf2_bootloader_space(const void *addr) {\n return (BOOTLOADER_START + 0x100) <= (uint32_t)addr && (uint32_t)addr < (BOOTLOADER_END);\n}\n\nstatic inline const char *uf2_info(void) {\n if (in_uf2_bootloader_space(UF2_INFO_TXT))\n return UF2_INFO_TXT;\n return \"N/A\";\n}\n\n#ifdef UF2_DEFINE_HANDOVER\nstatic inline void hf2_handover(uint8_t ep) {\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_HID_Handover_Handler fn = UF2_BINFO->handoverHID;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n // Pass control to bootloader; never returns\n fn(ep & 0xf);\n }\n}\n\nstatic inline void check_uf2_handover(uint8_t *buffer, uint32_t blocks_remaining, uint8_t ep_in,\n uint8_t ep_out, uint32_t cbw_tag) {\n if (!is_uf2_block(buffer))\n return;\n\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_MSC_Handover_Handler fn = UF2_BINFO->handoverMSC;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n UF2_HandoverArgs hand = {\n 1, ep_in, ep_out, 0, cbw_tag, blocks_remaining, buffer,\n };\n // Pass control to bootloader; never returns\n fn(&hand);\n }\n}\n#endif\n\n#endif\n",
"uf2hid.h": "#ifndef UF2_HID_H\n#define UF2_HID_H 1\n\n#define HF2_CMD_BININFO 0x0001\n// no arguments\n#define HF2_MODE_BOOTLOADER 0x01\n#define HF2_MODE_USERSPACE 0x02\nstruct HF2_BININFO_Result {\n uint32_t mode;\n uint32_t flash_page_size;\n uint32_t flash_num_pages;\n uint32_t max_message_size;\n uint32_t uf2_family;\n};\n\n#define HF2_CMD_INFO 0x0002\n// no arguments\n// results is utf8 character array\n\n#define HF2_CMD_RESET_INTO_APP 0x0003\n// no arguments, no result\n\n#define HF2_CMD_RESET_INTO_BOOTLOADER 0x0004\n// no arguments, no result\n\n#define HF2_CMD_START_FLASH 0x0005\n// no arguments, no result\n\n#define HF2_CMD_WRITE_FLASH_PAGE 0x0006\nstruct HF2_WRITE_FLASH_PAGE_Command {\n uint32_t target_addr;\n uint32_t data[0];\n};\n// no result\n\n#define HF2_CMD_CHKSUM_PAGES 0x0007\nstruct HF2_CHKSUM_PAGES_Command {\n uint32_t target_addr;\n uint32_t num_pages;\n};\nstruct HF2_CHKSUM_PAGES_Result {\n uint16_t chksums[0 /* num_pages */];\n};\n\n#define HF2_CMD_READ_WORDS 0x0008\nstruct HF2_READ_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n};\nstruct HF2_READ_WORDS_Result {\n uint32_t words[0 /* num_words */];\n};\n\n#define HF2_CMD_WRITE_WORDS 0x0009\nstruct HF2_WRITE_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n uint32_t words[0 /* num_words */];\n};\n// no result\n\n#define HF2_CMD_DMESG 0x0010\n// no arguments\n// results is utf8 character array\n\n#define HF2_EV_MASK 0x800000\n\n#define HF2_CMD_JDS_CONFIG 0x0020\n#define HF2_CMD_JDS_SEND 0x0021\n#define HF2_EV_JDS_PACKET 0x800020\n\ntypedef struct {\n uint32_t command_id;\n uint16_t tag;\n uint8_t reserved0;\n uint8_t reserved1;\n\n union {\n struct HF2_WRITE_FLASH_PAGE_Command write_flash_page;\n struct HF2_WRITE_WORDS_Command write_words;\n struct HF2_READ_WORDS_Command read_words;\n struct HF2_CHKSUM_PAGES_Command chksum_pages;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Command;\n\ntypedef struct {\n union {\n uint32_t eventId;\n struct {\n uint16_t tag;\n union {\n struct {\n uint8_t status;\n uint8_t status_info;\n };\n uint16_t status16;\n };\n };\n };\n union {\n struct HF2_BININFO_Result bininfo;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Response;\n\n#define HF2_FLAG_SERIAL_OUT 0x80\n#define HF2_FLAG_SERIAL_ERR 0xC0\n#define HF2_FLAG_CMDPKT_LAST 0x40\n#define HF2_FLAG_CMDPKT_BODY 0x00\n#define HF2_FLAG_MASK 0xC0\n#define HF2_SIZE_MASK 63\n\n#define HF2_STATUS_OK 0x00\n#define HF2_STATUS_INVALID_CMD 0x01\n#define HF2_STATUS_INVALID_STATE 0x02\n\n#endif\n",
"usb.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"uf2format.h\"\n\nnamespace pxt {\nCodalUSB usb;\n\n// share the buffer; we will crash anyway if someone talks to us over both at the same time\nHF2_Buffer hf2buf;\nHF2 hf2(hf2buf);\n#ifdef HF2_HID\nHF2 hf2hid(hf2buf);\n#endif\nDummyIface dummyIface;\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nUSBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nUSBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nUSBHIDJoystick joystick;\n#endif\n\nstatic const DeviceDescriptor device_desc = {\n 0x12, // bLength\n 0x01, // bDescriptorType\n 0x0210, // bcdUSBL\n\n // Class etc specified per-interface\n 0x00, 0x00, 0x00,\n\n 0x40, // bMaxPacketSize0\n USB_DEFAULT_VID, USB_DEFAULT_PID,\n 0x4202, // bcdDevice - leave unchanged for the HF2 to work\n 0x01, // iManufacturer\n 0x02, // iProduct\n 0x03, // SerialNumber\n 0x01 // bNumConfigs\n};\n\nstatic void start_usb() {\n // start USB with a delay, so that user code can add new interfaces if needed\n // (eg USB HID keyboard, or MSC)\n fiber_sleep(500);\n usb.start();\n}\n\nvoid platform_usb_init() __attribute__((weak));\nvoid platform_usb_init() {}\n\nvoid set_usb_strings(const char *uf2_info) {\n static const char *string_descriptors[3];\n static char serial[12];\n itoa(target_get_serial() & 0x7fffffff, serial);\n\n auto model = strstr(uf2_info, \"Model: \");\n if (model) {\n model += 7;\n auto end = model;\n while (*end && *end != '\\n' && *end != '\\r')\n end++;\n auto len = end - model;\n auto dev = (char *)app_alloc(len + 10);\n memcpy(dev, model, len);\n strcpy(dev + len, \" (app)\");\n // try to split into manufacturer and\n auto sep = strstr(dev, \" / \");\n if (sep) {\n *sep = '\\0';\n string_descriptors[0] = dev;\n string_descriptors[1] = sep + 3;\n } else {\n string_descriptors[0] = dev;\n string_descriptors[1] = dev;\n }\n } else {\n string_descriptors[0] = \"Unknown Corp.\";\n string_descriptors[1] = \"PXT Device (app)\";\n }\n\n string_descriptors[2] = serial;\n usb.stringDescriptors = string_descriptors;\n}\n\nvoid usb_init() {\n usb.deviceDescriptor = &device_desc;\n set_usb_strings(UF2_INFO_TXT);\n\n platform_usb_init();\n\n usb.add(hf2);\n\n#ifdef HF2_HID\n hf2hid.useHID = true;\n usb.add(hf2hid);\n#else\n // the WINUSB descriptors don't seem to work if there's only one interface\n // so we add a dummy interface\n usb.add(dummyIface);\n#endif\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n usb.add(mouse);\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n usb.add(keyboard);\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n usb.add(joystick);\n#endif\n\n create_fiber(start_usb);\n}\n\n} // namespace pxt\n\n#else\nnamespace pxt {\nvoid usb_init() {}\n} // namespace pxt\n#endif\n\nnamespace control {\n/**\n * Determines if the USB has been enumerated.\n */\n//%\nbool isUSBInitialized() {\n#if CONFIG_ENABLED(DEVICE_USB)\n return pxt::usb.isInitialised();\n#else\n return false;\n#endif\n}\n} // namespace control\n\nnamespace pxt {\nstatic void (*pSendToUART)(const char *data, int len) = NULL;\nvoid setSendToUART(void (*f)(const char *, int)) {\n pSendToUART = f;\n}\n\nvoid sendSerial(const char *data, int len) {\n#if CONFIG_ENABLED(DEVICE_USB)\n hf2.sendSerial(data, len);\n#if HF2_HID\n hf2hid.sendSerial(data, len);\n#endif\n#endif\n if (pSendToUART)\n pSendToUART(data, len);\n}\n\nvoid dumpDmesg() {\n sendSerial(\"\\nDMESG:\\n\", 8);\n sendSerial(codalLogStore.buffer, codalLogStore.ptr);\n sendSerial(\"\\n\\n\", 2);\n}\n\nvoid (*logJDFrame)(const uint8_t *data);\nvoid (*sendJDFrame)(const uint8_t *data);\n\n} // namespace pxt\n"
},
"core---samd51": {
"README.md": "# core\n\nThe core library for Codal-based targets.\n\n",
"codal.cpp": "#include \"pxt.h\"\n#include \"LowLevelTimer.h\"\nusing namespace codal;\n\nvoid cpu_clock_init(void);\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#ifdef DEVICE_GET_FIBER_LIST_AVAILABLE\n// newer codal-core has get_fiber_list() but not list_fibers()\nnamespace codal {\n/*\n * Return all current fibers.\n *\n * @param dest If non-null, it points to an array of pointers to fibers to store results in.\n *\n * @return the number of fibers (potentially) stored\n */\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\nnamespace pxt {\n\nvoid platform_init();\nvoid usb_init();\n\n// The first two word are used to tell the bootloader that a single reset should start the\n// bootloader and the MSD device, not us.\n// The rest is reserved for partial flashing checksums.\n__attribute__((section(\".binmeta\"))) __attribute__((used)) const uint32_t pxt_binmeta[] = {\n 0x87eeb07c, 0x87eeb07c, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff, 0x00ff00ff,\n};\n\nEvent lastEvent;\nMessageBus devMessageBus;\ncodal::CodalDevice device;\n\nstruct FreeList {\n FreeList *next;\n};\n\nstatic void commInit() {\n int commSize = bytecode[20];\n if (!commSize)\n return;\n\n void *r = app_alloc_at((void *)PXT_COMM_BASE, commSize);\n DMESG(\"comm %d -> %p\", commSize, r);\n if (!r)\n target_panic(20);\n}\n\nstatic void initCodal() {\n cpu_clock_init();\n\n commInit();\n\n // Bring up fiber scheduler.\n scheduler_init(devMessageBus);\n\n // We probably don't need that - components are initialized when one obtains\n // the reference to it.\n // devMessageBus.listen(DEVICE_ID_MESSAGE_BUS_LISTENER, DEVICE_EVT_ANY, this,\n // &CircuitPlayground::onListenerRegisteredEvent);\n\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; i++) {\n if (CodalComponent::components[i])\n CodalComponent::components[i]->init();\n }\n\n usb_init();\n\n auto led = LOOKUP_PIN(LED);\n if (led) {\n led->setDigitalValue(0);\n }\n}\n\n// ---------------------------------------------------------------------------\n// An adapter for the API expected by the run-time.\n// ---------------------------------------------------------------------------\n\n// We have the invariant that if [dispatchEvent] is registered against the DAL\n// for a given event, then [handlersMap] contains a valid entry for that\n// event.\nvoid dispatchEvent(Event e) {\n lastEvent = e;\n\n auto curr = findBinding(e.source, e.value);\n auto value = fromInt(e.value);\n while (curr) {\n runAction1(curr->action, value);\n curr = nextBinding(curr->next, e.source, e.value);\n }\n}\n\nvoid registerWithDal(int id, int event, Action a, int flags) {\n // first time?\n if (!findBinding(id, event)) {\n devMessageBus.listen(id, event, dispatchEvent, flags);\n if (event == 0) {\n // we're registering for all events on given ID\n // need to remove old listeners for specific events\n auto curr = findBinding(id, -1);\n while (curr) {\n devMessageBus.ignore(id, curr->value, dispatchEvent);\n curr = nextBinding(curr->next, id, -1);\n }\n }\n }\n setBinding(id, event, a);\n}\n\nvoid fiberDone(void *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 target_wait_us(us);\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 registerGCPtr(a);\n create_fiber(forever_stub, (void *)a);\n }\n}\n\nvoid runInParallel(Action a) {\n if (a != 0) {\n registerGCPtr(a);\n create_fiber((void (*)(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 initSystemTimer();\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\nuint64_t getLongSerialNumber() {\n return device.getSerialNumber();\n}\n\nint current_time_ms() {\n return system_timer_current_time();\n}\n\nuint64_t current_time_us() {\n return system_timer_current_time_us();\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\nstatic void *threadAddressFor(codal::Fiber *fib, void *sp) {\n if (fib == currentFiber)\n return sp;\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 int numFibers = codal::list_fibers(NULL);\n codal::Fiber **fibers = (codal::Fiber **)xmalloc(sizeof(codal::Fiber *) * numFibers);\n int num2 = codal::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 gcProcess(ctx->thrownValue);\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 xfree(fibers);\n}\n\nLowLevelTimer *getJACDACTimer() {\n static LowLevelTimer *jacdacTimer;\n if (!jacdacTimer) {\n jacdacTimer = allocateTimer();\n jacdacTimer->setIRQPriority(1);\n }\n return jacdacTimer;\n}\nvoid initSystemTimer() {\n new CODAL_TIMER(*allocateTimer());\n}\n\n} // namespace pxt\n",
"control.cpp": "#include \"pxt.h\"\n\n#if defined(NRF52_SERIES) || defined(PICO_BOARD)\n#define _estack __StackTop \n#endif\nextern uint32_t _estack;\n\nnamespace control {\n\n/**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n//% weight=21 blockGap=12 blockId=\"control_raise_event\"\n//% help=control/raise-event\n//% block=\"raise event|from %src|with value %value\" blockExternalInputs=1\nvoid raiseEvent(int src, int value) {\n Event evt(src, value);\n}\n\n/**\n* Determine the version of system software currently running.\n*/\n//% blockId=\"control_device_dal_version\" block=\"device dal version\"\n//% help=control/device-dal-version\nString deviceDalVersion() {\n return mkString(device.getVersion());\n}\n\n/**\n* Allocates the next user notification event\n*/\n//% help=control/allocate-notify-event\nint allocateNotifyEvent() {\n return ::allocateNotifyEvent();\n}\n\n/** Write a message to DMESG debugging buffer. */\n//%\nvoid dmesg(String s) {\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 DMESG(\"# %s: %p\", str->getUTF8Data(), ptr);\n}\n\n//%\nuint32_t _ramSize()\n{\n return (uint32_t)&_estack & 0x1fffffff;\n}\n\n}\n",
"dal.d.ts": "// Auto-generated. Do not edit.\ndeclare const enum DAL {\n // /libraries/codal-core/inc/JACDAC/JDPhysicalLayer.h\n Receiving = 0,\n Transmitting = 1,\n Error = 2,\n Unknown = 3,\n ListeningForPulse = 0,\n ErrorRecovery = 1,\n Off = 2,\n Continuation = 0,\n // /libraries/codal-core/inc/JACDAC/JDServiceClasses.h\n STATIC_CLASS_START = 0,\n STATIC_CLASS_END = 16777215,\n DYNAMIC_CLASS_END = 4294967295,\n // /libraries/codal-core/inc/core/CodalComponent.h\n DEVICE_ID_BUTTON_A = 1,\n DEVICE_ID_BUTTON_B = 2,\n DEVICE_ID_BUTTON_AB = 3,\n DEVICE_ID_BUTTON_RESET = 4,\n DEVICE_ID_ACCELEROMETER = 5,\n DEVICE_ID_COMPASS = 6,\n DEVICE_ID_DISPLAY = 7,\n DEVICE_ID_THERMOMETER = 8,\n DEVICE_ID_RADIO = 9,\n DEVICE_ID_RADIO_DATA_READY = 10,\n DEVICE_ID_MULTIBUTTON_ATTACH = 11,\n DEVICE_ID_SERIAL = 12,\n DEVICE_ID_GESTURE = 13,\n DEVICE_ID_SYSTEM_TIMER = 14,\n DEVICE_ID_SCHEDULER = 15,\n DEVICE_ID_COMPONENT = 16,\n DEVICE_ID_LIGHT_SENSOR = 17,\n DEVICE_ID_TOUCH_SENSOR = 18,\n DEVICE_ID_SYSTEM_DAC = 19,\n DEVICE_ID_SYSTEM_MICROPHONE = 20,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR = 21,\n DEVICE_ID_SYSTEM_LEVEL_DETECTOR_SPL = 22,\n DEVICE_ID_MSC = 23,\n DEVICE_ID_SPI = 24,\n DEVICE_ID_DISTANCE = 25,\n DEVICE_ID_GYROSCOPE = 26,\n DEVICE_ID_HUMIDITY = 27,\n DEVICE_ID_PRESSURE = 28,\n DEVICE_ID_SINGLE_WIRE_SERIAL = 29,\n DEVICE_ID_JACDAC = 30,\n DEVICE_ID_JACDAC_PHYS = 31,\n DEVICE_ID_JACDAC_CONTROL_SERVICE = 32,\n DEVICE_ID_JACDAC_CONFIGURATION_SERVICE = 33,\n DEVICE_ID_IO_P0 = 100,\n DEVICE_ID_MESSAGE_BUS_LISTENER = 1021,\n DEVICE_ID_NOTIFY_ONE = 1022,\n DEVICE_ID_NOTIFY = 1023,\n DEVICE_ID_BUTTON_UP = 2000,\n DEVICE_ID_BUTTON_DOWN = 2001,\n DEVICE_ID_BUTTON_LEFT = 2002,\n DEVICE_ID_BUTTON_RIGHT = 2003,\n DEVICE_ID_JD_DYNAMIC_ID = 3000,\n DEVICE_COMPONENT_RUNNING = 4096,\n DEVICE_COMPONENT_STATUS_SYSTEM_TICK = 8192,\n DEVICE_COMPONENT_STATUS_IDLE_TICK = 16384,\n DEVICE_COMPONENT_LISTENERS_CONFIGURED = 1,\n DEVICE_COMPONENT_EVT_SYSTEM_TICK = 1,\n // /libraries/codal-core/inc/core/CodalFiber.h\n DEVICE_SCHEDULER_RUNNING = 1,\n DEVICE_SCHEDULER_IDLE = 2,\n DEVICE_FIBER_FLAG_FOB = 1,\n DEVICE_FIBER_FLAG_PARENT = 2,\n DEVICE_FIBER_FLAG_CHILD = 4,\n DEVICE_FIBER_FLAG_DO_NOT_PAGE = 8,\n DEVICE_SCHEDULER_EVT_TICK = 1,\n DEVICE_SCHEDULER_EVT_IDLE = 2,\n // /libraries/codal-core/inc/core/CodalListener.h\n MESSAGE_BUS_LISTENER_PARAMETERISED = 1,\n MESSAGE_BUS_LISTENER_METHOD = 2,\n MESSAGE_BUS_LISTENER_BUSY = 4,\n MESSAGE_BUS_LISTENER_REENTRANT = 8,\n MESSAGE_BUS_LISTENER_QUEUE_IF_BUSY = 16,\n MESSAGE_BUS_LISTENER_DROP_IF_BUSY = 32,\n MESSAGE_BUS_LISTENER_NONBLOCKING = 64,\n MESSAGE_BUS_LISTENER_URGENT = 128,\n MESSAGE_BUS_LISTENER_DELETING = 32768,\n MESSAGE_BUS_LISTENER_IMMEDIATE = 192,\n // /libraries/codal-core/inc/core/ErrorNo.h\n DEVICE_OK = 0,\n DEVICE_INVALID_PARAMETER = -1001,\n DEVICE_NOT_SUPPORTED = -1002,\n DEVICE_CALIBRATION_IN_PROGRESS = -1003,\n DEVICE_CALIBRATION_REQUIRED = -1004,\n DEVICE_NO_RESOURCES = -1005,\n DEVICE_BUSY = -1006,\n DEVICE_CANCELLED = -1007,\n DEVICE_I2C_ERROR = -1010,\n DEVICE_SERIAL_IN_USE = -1011,\n DEVICE_NO_DATA = -1012,\n DEVICE_NOT_IMPLEMENTED = -1013,\n DEVICE_SPI_ERROR = -1014,\n DEVICE_INVALID_STATE = -1015,\n DEVICE_OOM = 20,\n DEVICE_HEAP_ERROR = 30,\n DEVICE_NULL_DEREFERENCE = 40,\n DEVICE_USB_ERROR = 50,\n DEVICE_JACDAC_ERROR = 60,\n DEVICE_HARDWARE_CONFIGURATION_ERROR = 90,\n // /libraries/codal-core/inc/core/NotifyEvents.h\n DISPLAY_EVT_FREE = 1,\n CODAL_SERIAL_EVT_TX_EMPTY = 2,\n BLE_EVT_SERIAL_TX_EMPTY = 3,\n ARCADE_PLAYER_JOIN_RESULT = 4,\n DEVICE_NOTIFY_USER_EVENT_BASE = 1024,\n // /libraries/codal-core/inc/driver-models/AbstractButton.h\n DEVICE_BUTTON_EVT_DOWN = 1,\n DEVICE_BUTTON_EVT_UP = 2,\n DEVICE_BUTTON_EVT_CLICK = 3,\n DEVICE_BUTTON_EVT_LONG_CLICK = 4,\n DEVICE_BUTTON_EVT_HOLD = 5,\n DEVICE_BUTTON_EVT_DOUBLE_CLICK = 6,\n DEVICE_BUTTON_LONG_CLICK_TIME = 1000,\n DEVICE_BUTTON_HOLD_TIME = 1500,\n DEVICE_BUTTON_STATE = 1,\n DEVICE_BUTTON_STATE_HOLD_TRIGGERED = 2,\n DEVICE_BUTTON_STATE_CLICK = 4,\n DEVICE_BUTTON_STATE_LONG_CLICK = 8,\n DEVICE_BUTTON_SIGMA_MIN = 0,\n DEVICE_BUTTON_SIGMA_MAX = 12,\n DEVICE_BUTTON_SIGMA_THRESH_HI = 8,\n DEVICE_BUTTON_SIGMA_THRESH_LO = 2,\n DEVICE_BUTTON_DOUBLE_CLICK_THRESH = 50,\n DEVICE_BUTTON_SIMPLE_EVENTS = 0,\n DEVICE_BUTTON_ALL_EVENTS = 1,\n ACTIVE_LOW = 0,\n ACTIVE_HIGH = 1,\n // /libraries/codal-core/inc/driver-models/Accelerometer.h\n ACCELEROMETER_IMU_DATA_VALID = 2,\n ACCELEROMETER_EVT_DATA_UPDATE = 1,\n ACCELEROMETER_EVT_NONE = 0,\n ACCELEROMETER_EVT_TILT_UP = 1,\n ACCELEROMETER_EVT_TILT_DOWN = 2,\n ACCELEROMETER_EVT_TILT_LEFT = 3,\n ACCELEROMETER_EVT_TILT_RIGHT = 4,\n ACCELEROMETER_EVT_FACE_UP = 5,\n ACCELEROMETER_EVT_FACE_DOWN = 6,\n ACCELEROMETER_EVT_FREEFALL = 7,\n ACCELEROMETER_EVT_3G = 8,\n ACCELEROMETER_EVT_6G = 9,\n ACCELEROMETER_EVT_8G = 10,\n ACCELEROMETER_EVT_SHAKE = 11,\n ACCELEROMETER_EVT_2G = 12,\n ACCELEROMETER_REST_TOLERANCE = 200,\n ACCELEROMETER_TILT_TOLERANCE = 200,\n ACCELEROMETER_FREEFALL_TOLERANCE = 400,\n ACCELEROMETER_SHAKE_TOLERANCE = 400,\n ACCELEROMETER_2G_TOLERANCE = 2048,\n ACCELEROMETER_3G_TOLERANCE = 3072,\n ACCELEROMETER_6G_TOLERANCE = 6144,\n ACCELEROMETER_8G_TOLERANCE = 8192,\n ACCELEROMETER_GESTURE_DAMPING = 5,\n ACCELEROMETER_SHAKE_DAMPING = 10,\n ACCELEROMETER_SHAKE_RTX = 30,\n ACCELEROMETER_SHAKE_COUNT_THRESHOLD = 4,\n // /libraries/codal-core/inc/driver-models/Compass.h\n COMPASS_STATUS_RUNNING = 1,\n COMPASS_STATUS_CALIBRATED = 2,\n COMPASS_STATUS_CALIBRATING = 4,\n COMPASS_STATUS_ADDED_TO_IDLE = 8,\n COMPASS_EVT_DATA_UPDATE = 1,\n COMPASS_EVT_CONFIG_NEEDED = 2,\n COMPASS_EVT_CALIBRATE = 3,\n COMPASS_EVT_CALIBRATION_NEEDED = 4,\n // /libraries/codal-core/inc/driver-models/Gyroscope.h\n GYROSCOPE_IMU_DATA_VALID = 2,\n GYROSCOPE_EVT_DATA_UPDATE = 1,\n // /libraries/codal-core/inc/driver-models/LowLevelTimer.h\n TimerModeTimer = 0,\n TimerModeCounter = 1,\n TimerModeAlternateFunction = 2,\n BitMode8 = 0,\n BitMode16 = 1,\n BitMode24 = 2,\n BitMode32 = 3,\n // /libraries/codal-core/inc/driver-models/Pin.h\n IO_STATUS_DIGITAL_IN = 1,\n IO_STATUS_DIGITAL_OUT = 2,\n IO_STATUS_ANALOG_IN = 4,\n IO_STATUS_ANALOG_OUT = 8,\n IO_STATUS_TOUCH_IN = 16,\n IO_STATUS_EVENT_ON_EDGE = 32,\n IO_STATUS_EVENT_PULSE_ON_EDGE = 64,\n IO_STATUS_INTERRUPT_ON_EDGE = 128,\n DEVICE_PIN_MAX_OUTPUT = 1023,\n DEVICE_PIN_MAX_SERVO_RANGE = 180,\n DEVICE_PIN_DEFAULT_SERVO_RANGE = 2000,\n DEVICE_PIN_DEFAULT_SERVO_CENTER = 1500,\n DEVICE_PIN_EVENT_NONE = 0,\n DEVICE_PIN_INTERRUPT_ON_EDGE = 1,\n DEVICE_PIN_EVENT_ON_EDGE = 2,\n DEVICE_PIN_EVENT_ON_PULSE = 3,\n DEVICE_PIN_EVENT_ON_TOUCH = 4,\n DEVICE_PIN_EVT_RISE = 2,\n DEVICE_PIN_EVT_FALL = 3,\n DEVICE_PIN_EVT_PULSE_HI = 4,\n DEVICE_PIN_EVT_PULSE_LO = 5,\n PIN_CAPABILITY_DIGITAL = 1,\n PIN_CAPABILITY_ANALOG = 2,\n PIN_CAPABILITY_AD = 3,\n PIN_CAPABILITY_ALL = 3,\n None = 0,\n Down = 1,\n Up = 2,\n // /libraries/codal-core/inc/driver-models/Radio.h\n RADIO_EVT_DATA_READY = 2,\n // /libraries/codal-core/inc/driver-models/SPIFlash.h\n SPIFLASH_PAGE_SIZE = 256,\n SPIFLASH_SMALL_ROW_PAGES = 16,\n SPIFLASH_BIG_ROW_PAGES = 256,\n // /libraries/codal-core/inc/driver-models/Sensor.h\n SENSOR_THRESHOLD_LOW = 1,\n SENSOR_THRESHOLD_HIGH = 2,\n SENSOR_UPDATE_NEEDED = 3,\n SENSOR_INITIALISED = 1,\n SENSOR_HIGH_THRESHOLD_PASSED = 2,\n SENSOR_LOW_THRESHOLD_PASSED = 4,\n SENSOR_LOW_THRESHOLD_ENABLED = 8,\n SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n SENSOR_DEFAULT_SENSITIVITY = 868,\n SENSOR_DEFAULT_SAMPLE_PERIOD = 500,\n // /libraries/codal-core/inc/driver-models/Serial.h\n CODAL_SERIAL_DEFAULT_BAUD_RATE = 115200,\n CODAL_SERIAL_DEFAULT_BUFFER_SIZE = 20,\n CODAL_SERIAL_EVT_DELIM_MATCH = 1,\n CODAL_SERIAL_EVT_HEAD_MATCH = 2,\n CODAL_SERIAL_EVT_RX_FULL = 3,\n CODAL_SERIAL_EVT_DATA_RECEIVED = 4,\n CODAL_SERIAL_STATUS_RX_IN_USE = 1,\n CODAL_SERIAL_STATUS_TX_IN_USE = 2,\n CODAL_SERIAL_STATUS_RX_BUFF_INIT = 4,\n CODAL_SERIAL_STATUS_TX_BUFF_INIT = 8,\n CODAL_SERIAL_STATUS_RXD = 16,\n ASYNC = 0,\n SYNC_SPINWAIT = 1,\n SYNC_SLEEP = 2,\n RxInterrupt = 0,\n TxInterrupt = 1,\n // /libraries/codal-core/inc/driver-models/SingleWireSerial.h\n SWS_EVT_DATA_RECEIVED = 1,\n SWS_EVT_DATA_SENT = 2,\n SWS_EVT_ERROR = 3,\n SWS_EVT_DATA_DROPPED = 4,\n SingleWireRx = 0,\n SingleWireTx = 1,\n SingleWireDisconnected = 2,\n // /libraries/codal-core/inc/driver-models/Timer.h\n CODAL_TIMER_DEFAULT_EVENT_LIST_SIZE = 10,\n // /libraries/codal-core/inc/drivers/AnalogSensor.h\n ANALOG_THRESHOLD_LOW = 1,\n ANALOG_THRESHOLD_HIGH = 2,\n ANALOG_SENSOR_UPDATE_NEEDED = 3,\n ANALOG_SENSOR_INITIALISED = 1,\n ANALOG_SENSOR_HIGH_THRESHOLD_PASSED = 2,\n ANALOG_SENSOR_LOW_THRESHOLD_PASSED = 4,\n ANALOG_SENSOR_LOW_THRESHOLD_ENABLED = 8,\n ANALOG_SENSOR_HIGH_THRESHOLD_ENABLED = 16,\n // /libraries/codal-core/inc/drivers/AnimatedDisplay.h\n DISPLAY_EVT_ANIMATION_COMPLETE = 1,\n DISPLAY_DEFAULT_AUTOCLEAR = 1,\n DISPLAY_SPACING = 1,\n DISPLAY_ANIMATE_DEFAULT_POS = -255,\n DISPLAY_DEFAULT_SCROLL_SPEED = 120,\n DISPLAY_DEFAULT_SCROLL_STRIDE = -1,\n DISPLAY_DEFAULT_PRINT_SPEED = 400,\n ANIMATION_MODE_NONE = 0,\n ANIMATION_MODE_STOPPED = 1,\n ANIMATION_MODE_SCROLL_TEXT = 2,\n ANIMATION_MODE_PRINT_TEXT = 3,\n ANIMATION_MODE_SCROLL_IMAGE = 4,\n ANIMATION_MODE_ANIMATE_IMAGE = 5,\n ANIMATION_MODE_ANIMATE_IMAGE_WITH_CLEAR = 6,\n ANIMATION_MODE_PRINT_CHARACTER = 7,\n // /libraries/codal-core/inc/drivers/FAT.h\n FAT_RESERVED_SECTORS = 1,\n FAT_ROOT_DIR_SECTORS = 4,\n // /libraries/codal-core/inc/drivers/HID.h\n HID_REQUEST_GET_REPORT = 1,\n HID_REQUEST_GET_IDLE = 2,\n HID_REQUEST_GET_PROTOCOL = 3,\n HID_REQUEST_SET_REPORT = 9,\n HID_REQUEST_SET_IDLE = 10,\n HID_REQUEST_SET_PROTOCOL = 11,\n // /libraries/codal-core/inc/drivers/HIDKeyboard.h\n HID_KEYBOARD_NUM_REPORTS = 3,\n HID_KEYBOARD_REPORT_GENERIC = 1,\n HID_KEYBOARD_REPORT_CONSUMER = 2,\n HID_KEYBOARD_KEYSTATE_SIZE_GENERIC = 8,\n HID_KEYBOARD_KEYSTATE_SIZE_CONSUMER = 2,\n HID_KEYBOARD_MODIFIER_OFFSET = 2,\n HID_KEYBOARD_DELAY_DEFAULT = 10,\n PressKey = 0,\n ReleaseKey = 1,\n // /libraries/codal-core/inc/drivers/KeyMap.h\n KEYMAP_ALL_KEYS_UP_Val = 1,\n KEYMAP_ALL_KEYS_UP_POS = 28,\n KEYMAP_NORMAL_KEY_Val = 0,\n KEYMAP_MODIFIER_KEY_Val = 1,\n KEYMAP_MODIFIER_POS = 29,\n KEYMAP_MEDIA_KEY_Val = 1,\n KEYMAP_MEDIA_POS = 30,\n KEYMAP_KEY_UP_Val = 0,\n KEYMAP_KEY_DOWN_Val = 1,\n KEYMAP_KEY_DOWN_POS = 31,\n // /libraries/codal-core/inc/drivers/KeyValueStorage.h\n DEVICE_KEY_VALUE_STORE_OFFSET = 4,\n KEY_VALUE_STORAGE_MAGIC = 49370,\n KEY_VALUE_STORAGE_BLOCK_SIZE = 48,\n KEY_VALUE_STORAGE_KEY_SIZE = 16,\n KEY_VALUE_STORAGE_SCRATCH_WORD_SIZE = 64,\n KEY_VALUE_STORAGE_MAX_PAIRS = 5,\n // /libraries/codal-core/inc/drivers/LEDMatrix.h\n LED_MATRIX_GREYSCALE_BIT_DEPTH = 8,\n LED_MATRIX_EVT_LIGHT_SENSE = 2,\n LED_MATRIX_EVT_FRAME_TIMEOUT = 3,\n LED_MATRIX_MINIMUM_BRIGHTNESS = 1,\n LED_MATRIX_MAXIMUM_BRIGHTNESS = 255,\n LED_MATRIX_DEFAULT_BRIGHTNESS = 255,\n DISPLAY_MODE_BLACK_AND_WHITE = 0,\n DISPLAY_MODE_GREYSCALE = 1,\n DISPLAY_MODE_BLACK_AND_WHITE_LIGHT_SENSE = 2,\n MATRIX_DISPLAY_ROTATION_0 = 0,\n MATRIX_DISPLAY_ROTATION_90 = 1,\n MATRIX_DISPLAY_ROTATION_180 = 2,\n MATRIX_DISPLAY_ROTATION_270 = 3,\n NO_CONN = 0,\n // /libraries/codal-core/inc/drivers/MMA8653.h\n MICROBIT_ACCEL_PITCH_ROLL_VALID = 2,\n MICROBIT_ACCEL_ADDED_TO_IDLE = 4,\n // /libraries/codal-core/inc/drivers/MultiButton.h\n MULTI_BUTTON_STATE_1 = 1,\n MULTI_BUTTON_STATE_2 = 2,\n MULTI_BUTTON_HOLD_TRIGGERED_1 = 4,\n MULTI_BUTTON_HOLD_TRIGGERED_2 = 8,\n MULTI_BUTTON_SUPRESSED_1 = 16,\n MULTI_BUTTON_SUPRESSED_2 = 32,\n MULTI_BUTTON_ATTACHED = 64,\n // /libraries/codal-core/inc/drivers/TouchButton.h\n TOUCH_BUTTON_CALIBRATION_PERIOD = 10,\n TOUCH_BUTTON_CALIBRATION_LINEAR_OFFSET = 2,\n TOUCH_BUTTON_CALIBRATION_PERCENTAGE_OFFSET = 5,\n TOUCH_BUTTON_CALIBRATING = 16,\n // /libraries/codal-core/inc/drivers/TouchSensor.h\n TOUCH_SENSOR_MAX_BUTTONS = 10,\n TOUCH_SENSOR_SAMPLE_PERIOD = 50,\n TOUCH_SENSE_SAMPLE_MAX = 1000,\n TOUCH_SENSOR_UPDATE_NEEDED = 1,\n // /libraries/codal-core/inc/drivers/USBJACDAC.h\n JACDAC_USB_STATUS_CLEAR_TO_SEND = 2,\n // /libraries/codal-core/inc/drivers/USB_HID_Keys.h\n KEY_MOD_LCTRL = 1,\n KEY_MOD_LSHIFT = 2,\n KEY_MOD_LALT = 4,\n KEY_MOD_LMETA = 8,\n KEY_MOD_RCTRL = 16,\n KEY_MOD_RSHIFT = 32,\n KEY_MOD_RALT = 64,\n KEY_MOD_RMETA = 128,\n KEY_NONE = 0,\n KEY_ERR_OVF = 1,\n KEY_A = 4,\n KEY_B = 5,\n KEY_C = 6,\n KEY_D = 7,\n KEY_E = 8,\n KEY_F = 9,\n KEY_G = 10,\n KEY_H = 11,\n KEY_I = 12,\n KEY_J = 13,\n KEY_K = 14,\n KEY_L = 15,\n KEY_M = 16,\n KEY_N = 17,\n KEY_O = 18,\n KEY_P = 19,\n KEY_Q = 20,\n KEY_R = 21,\n KEY_S = 22,\n KEY_T = 23,\n KEY_U = 24,\n KEY_V = 25,\n KEY_W = 26,\n KEY_X = 27,\n KEY_Y = 28,\n KEY_Z = 29,\n KEY_1 = 30,\n KEY_2 = 31,\n KEY_3 = 32,\n KEY_4 = 33,\n KEY_5 = 34,\n KEY_6 = 35,\n KEY_7 = 36,\n KEY_8 = 37,\n KEY_9 = 38,\n KEY_0 = 39,\n KEY_ENTER = 40,\n KEY_ESC = 41,\n KEY_BACKSPACE = 42,\n KEY_TAB = 43,\n KEY_SPACE = 44,\n KEY_MINUS = 45,\n KEY_EQUAL = 46,\n KEY_LEFTBRACE = 47,\n KEY_RIGHTBRACE = 48,\n KEY_BACKSLASH = 49,\n KEY_HASHTILDE = 50,\n KEY_SEMICOLON = 51,\n KEY_APOSTROPHE = 52,\n KEY_GRAVE = 53,\n KEY_COMMA = 54,\n KEY_DOT = 55,\n KEY_SLASH = 56,\n KEY_CAPSLOCK = 57,\n KEY_F1 = 58,\n KEY_F2 = 59,\n KEY_F3 = 60,\n KEY_F4 = 61,\n KEY_F5 = 62,\n KEY_F6 = 63,\n KEY_F7 = 64,\n KEY_F8 = 65,\n KEY_F9 = 66,\n KEY_F10 = 67,\n KEY_F11 = 68,\n KEY_F12 = 69,\n KEY_SYSRQ = 70,\n KEY_SCROLLLOCK = 71,\n KEY_PAUSE = 72,\n KEY_INSERT = 73,\n KEY_HOME = 74,\n KEY_PAGEUP = 75,\n KEY_DELETE = 76,\n KEY_END = 77,\n KEY_PAGEDOWN = 78,\n KEY_RIGHT = 79,\n KEY_LEFT = 80,\n KEY_DOWN = 81,\n KEY_UP = 82,\n KEY_NUMLOCK = 83,\n KEY_KPSLASH = 84,\n KEY_KPASTERISK = 85,\n KEY_KPMINUS = 86,\n KEY_KPPLUS = 87,\n KEY_KPENTER = 88,\n KEY_KP1 = 89,\n KEY_KP2 = 90,\n KEY_KP3 = 91,\n KEY_KP4 = 92,\n KEY_KP5 = 93,\n KEY_KP6 = 94,\n KEY_KP7 = 95,\n KEY_KP8 = 96,\n KEY_KP9 = 97,\n KEY_KP0 = 98,\n KEY_KPDOT = 99,\n KEY_102ND = 100,\n KEY_COMPOSE = 101,\n KEY_POWER = 102,\n KEY_KPEQUAL = 103,\n KEY_F13 = 104,\n KEY_F14 = 105,\n KEY_F15 = 106,\n KEY_F16 = 107,\n KEY_F17 = 108,\n KEY_F18 = 109,\n KEY_F19 = 110,\n KEY_F20 = 111,\n KEY_F21 = 112,\n KEY_F22 = 113,\n KEY_F23 = 114,\n KEY_F24 = 115,\n KEY_OPEN = 116,\n KEY_HELP = 117,\n KEY_PROPS = 118,\n KEY_FRONT = 119,\n KEY_STOP = 120,\n KEY_AGAIN = 121,\n KEY_UNDO = 122,\n KEY_CUT = 123,\n KEY_COPY = 124,\n KEY_PASTE = 125,\n KEY_FIND = 126,\n KEY_MUTE = 127,\n KEY_VOLUMEUP = 128,\n KEY_VOLUMEDOWN = 129,\n KEY_KPCOMMA = 133,\n KEY_RO = 135,\n KEY_KATAKANAHIRAGANA = 136,\n KEY_YEN = 137,\n KEY_HENKAN = 138,\n KEY_MUHENKAN = 139,\n KEY_KPJPCOMMA = 140,\n KEY_HANGEUL = 144,\n KEY_HANJA = 145,\n KEY_KATAKANA = 146,\n KEY_HIRAGANA = 147,\n KEY_ZENKAKUHANKAKU = 148,\n KEY_KPLEFTPAREN = 182,\n KEY_KPRIGHTPAREN = 183,\n KEY_LEFTCTRL = 224,\n KEY_LEFTSHIFT = 225,\n KEY_LEFTALT = 226,\n KEY_LEFTMETA = 227,\n KEY_RIGHTCTRL = 228,\n KEY_RIGHTSHIFT = 229,\n KEY_RIGHTALT = 230,\n KEY_RIGHTMETA = 231,\n KEY_MEDIA_PLAYPAUSE = 232,\n KEY_MEDIA_STOPCD = 233,\n KEY_MEDIA_PREVIOUSSONG = 234,\n KEY_MEDIA_NEXTSONG = 235,\n KEY_MEDIA_EJECTCD = 236,\n KEY_MEDIA_VOLUMEUP = 237,\n KEY_MEDIA_VOLUMEDOWN = 238,\n KEY_MEDIA_MUTE = 239,\n KEY_MEDIA_WWW = 240,\n KEY_MEDIA_BACK = 241,\n KEY_MEDIA_FORWARD = 242,\n KEY_MEDIA_STOP = 243,\n KEY_MEDIA_FIND = 244,\n KEY_MEDIA_SCROLLUP = 245,\n KEY_MEDIA_SCROLLDOWN = 246,\n KEY_MEDIA_EDIT = 247,\n KEY_MEDIA_SLEEP = 248,\n KEY_MEDIA_COFFEE = 249,\n KEY_MEDIA_REFRESH = 250,\n KEY_MEDIA_CALC = 251,\n // /libraries/codal-core/inc/drivers/uf2format.h\n UF2FORMAT_H = 1,\n APP_START_ADDRESS = 8192,\n UF2_FLAG_NOFLASH = 1,\n // /libraries/codal-core/inc/streams/DataStream.h\n DATASTREAM_MAXIMUM_BUFFERS = 1,\n // /libraries/codal-core/inc/streams/LevelDetector.h\n LEVEL_THRESHOLD_LOW = 1,\n LEVEL_THRESHOLD_HIGH = 2,\n LEVEL_DETECTOR_INITIALISED = 1,\n LEVEL_DETECTOR_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/LevelDetectorSPL.h\n LEVEL_DETECTOR_SPL_INITIALISED = 1,\n LEVEL_DETECTOR_SPL_HIGH_THRESHOLD_PASSED = 2,\n LEVEL_DETECTOR_SPL_LOW_THRESHOLD_PASSED = 4,\n LEVEL_DETECTOR_SPL_DEFAULT_WINDOW_SIZE = 128,\n // /libraries/codal-core/inc/streams/Synthesizer.h\n SYNTHESIZER_SAMPLE_RATE = 44100,\n TONE_WIDTH = 1024,\n // /libraries/codal-core/inc/types/BitmapFont.h\n BITMAP_FONT_WIDTH = 5,\n BITMAP_FONT_HEIGHT = 5,\n BITMAP_FONT_ASCII_START = 32,\n BITMAP_FONT_ASCII_END = 126,\n // /libraries/codal-core/inc/types/CoordinateSystem.h\n COORDINATE_SPACE_ROTATED_0 = 0,\n COORDINATE_SPACE_ROTATED_90 = 1,\n COORDINATE_SPACE_ROTATED_180 = 2,\n COORDINATE_SPACE_ROTATED_270 = 3,\n RAW = 0,\n SIMPLE_CARTESIAN = 1,\n NORTH_EAST_DOWN = 2,\n NORTH_EAST_UP = 3,\n // /libraries/codal-core/inc/types/Event.h\n DEVICE_ID_ANY = 0,\n DEVICE_EVT_ANY = 0,\n CREATE_ONLY = 0,\n CREATE_AND_FIRE = 1,\n DEVICE_EVENT_DEFAULT_LAUNCH_MODE = 1,\n // /libraries/codal-core/inc/types/RefCounted.h\n REF_TAG_STRING = 1,\n REF_TAG_BUFFER = 2,\n REF_TAG_IMAGE = 3,\n REF_TAG_USER = 32,\n // /pxtapp/accelerometer/axis.h\n ACC_SYSTEM = 3,\n ACC_ROTATION = 0,\n // /pxtapp/configkeys.h\n CFG_PIN_NAME_MSK = 65535,\n CFG_PIN_CONFIG_MSK = 4294901760,\n CFG_PIN_CONFIG_ACTIVE_LO = 65536,\n CFG_MAGIC0 = 513675505,\n CFG_MAGIC1 = 539130489,\n CFG_PIN_ACCELEROMETER_INT = 1,\n CFG_PIN_ACCELEROMETER_SCL = 2,\n CFG_PIN_ACCELEROMETER_SDA = 3,\n CFG_PIN_BTN_A = 4,\n CFG_PIN_BTN_B = 5,\n CFG_PIN_BTN_SLIDE = 6,\n CFG_PIN_DOTSTAR_CLOCK = 7,\n CFG_PIN_DOTSTAR_DATA = 8,\n CFG_PIN_FLASH_CS = 9,\n CFG_PIN_FLASH_MISO = 10,\n CFG_PIN_FLASH_MOSI = 11,\n CFG_PIN_FLASH_SCK = 12,\n CFG_PIN_LED = 13,\n CFG_PIN_LIGHT = 14,\n CFG_PIN_MICROPHONE = 15,\n CFG_PIN_MIC_CLOCK = 16,\n CFG_PIN_MIC_DATA = 17,\n CFG_PIN_MISO = 18,\n CFG_PIN_MOSI = 19,\n CFG_PIN_NEOPIXEL = 20,\n CFG_PIN_RX = 21,\n CFG_PIN_RXLED = 22,\n CFG_PIN_SCK = 23,\n CFG_PIN_SCL = 24,\n CFG_PIN_SDA = 25,\n CFG_PIN_SPEAKER_AMP = 26,\n CFG_PIN_TEMPERATURE = 27,\n CFG_PIN_TX = 28,\n CFG_PIN_TXLED = 29,\n CFG_PIN_IR_OUT = 30,\n CFG_PIN_IR_IN = 31,\n CFG_PIN_DISPLAY_SCK = 32,\n CFG_PIN_DISPLAY_MISO = 33,\n CFG_PIN_DISPLAY_MOSI = 34,\n CFG_PIN_DISPLAY_CS = 35,\n CFG_PIN_DISPLAY_DC = 36,\n CFG_DISPLAY_WIDTH = 37,\n CFG_DISPLAY_HEIGHT = 38,\n CFG_DISPLAY_CFG0 = 39,\n CFG_DISPLAY_CFG1 = 40,\n CFG_DISPLAY_CFG2 = 41,\n CFG_DISPLAY_CFG3 = 42,\n CFG_PIN_DISPLAY_RST = 43,\n CFG_PIN_DISPLAY_BL = 44,\n CFG_PIN_SERVO_1 = 45,\n CFG_PIN_SERVO_2 = 46,\n CFG_PIN_BTN_LEFT = 47,\n CFG_PIN_BTN_RIGHT = 48,\n CFG_PIN_BTN_UP = 49,\n CFG_PIN_BTN_DOWN = 50,\n CFG_PIN_BTN_MENU = 51,\n CFG_PIN_LED_R = 52,\n CFG_PIN_LED_G = 53,\n CFG_PIN_LED_B = 54,\n CFG_PIN_LED1 = 55,\n CFG_PIN_LED2 = 56,\n CFG_PIN_LED3 = 57,\n CFG_PIN_LED4 = 58,\n CFG_SPEAKER_VOLUME = 59,\n CFG_PIN_JACK_TX = 60,\n CFG_PIN_JACK_SENSE = 61,\n CFG_PIN_JACK_HPEN = 62,\n CFG_PIN_JACK_BZEN = 63,\n CFG_PIN_JACK_PWREN = 64,\n CFG_PIN_JACK_SND = 65,\n CFG_PIN_JACK_BUSLED = 66,\n CFG_PIN_JACK_COMMLED = 67,\n CFG_PIN_BTN_SOFT_RESET = 69,\n CFG_ACCELEROMETER_TYPE = 70,\n CFG_PIN_BTNMX_LATCH = 71,\n CFG_PIN_BTNMX_CLOCK = 72,\n CFG_PIN_BTNMX_DATA = 73,\n CFG_PIN_BTN_MENU2 = 74,\n CFG_PIN_BATTSENSE = 75,\n CFG_PIN_VIBRATION = 76,\n CFG_PIN_PWREN = 77,\n CFG_DISPLAY_TYPE = 78,\n CFG_PIN_ROTARY_ENCODER_A = 79,\n CFG_PIN_ROTARY_ENCODER_B = 80,\n CFG_ACCELEROMETER_SPACE = 81,\n CFG_PIN_WIFI_MOSI = 82,\n CFG_PIN_WIFI_MISO = 83,\n CFG_PIN_WIFI_SCK = 84,\n CFG_PIN_WIFI_TX = 85,\n CFG_PIN_WIFI_RX = 86,\n CFG_PIN_WIFI_CS = 87,\n CFG_PIN_WIFI_BUSY = 88,\n CFG_PIN_WIFI_RESET = 89,\n CFG_PIN_WIFI_GPIO0 = 90,\n CFG_PIN_WIFI_AT_TX = 91,\n CFG_PIN_WIFI_AT_RX = 92,\n CFG_PIN_USB_POWER = 93,\n ACCELEROMETER_TYPE_LIS3DH = 50,\n ACCELEROMETER_TYPE_LIS3DH_ALT = 48,\n ACCELEROMETER_TYPE_MMA8453 = 56,\n ACCELEROMETER_TYPE_FXOS8700 = 60,\n ACCELEROMETER_TYPE_MMA8653 = 58,\n ACCELEROMETER_TYPE_MSA300 = 76,\n ACCELEROMETER_TYPE_MPU6050 = 104,\n DISPLAY_TYPE_ST7735 = 7735,\n DISPLAY_TYPE_ILI9341 = 9341,\n DISPLAY_TYPE_SMART = 4242,\n CFG_PIN_A0 = 100,\n CFG_PIN_A1 = 101,\n CFG_PIN_A2 = 102,\n CFG_PIN_A3 = 103,\n CFG_PIN_A4 = 104,\n CFG_PIN_A5 = 105,\n CFG_PIN_A6 = 106,\n CFG_PIN_A7 = 107,\n CFG_PIN_A8 = 108,\n CFG_PIN_A9 = 109,\n CFG_PIN_A10 = 110,\n CFG_PIN_A11 = 111,\n CFG_PIN_A12 = 112,\n CFG_PIN_A13 = 113,\n CFG_PIN_A14 = 114,\n CFG_PIN_A15 = 115,\n CFG_PIN_A16 = 116,\n CFG_PIN_A17 = 117,\n CFG_PIN_A18 = 118,\n CFG_PIN_A19 = 119,\n CFG_PIN_A20 = 120,\n CFG_PIN_A21 = 121,\n CFG_PIN_A22 = 122,\n CFG_PIN_A23 = 123,\n CFG_PIN_A24 = 124,\n CFG_PIN_A25 = 125,\n CFG_PIN_A26 = 126,\n CFG_PIN_A27 = 127,\n CFG_PIN_A28 = 128,\n CFG_PIN_A29 = 129,\n CFG_PIN_A30 = 130,\n CFG_PIN_A31 = 131,\n CFG_PIN_D0 = 150,\n CFG_PIN_D1 = 151,\n CFG_PIN_D2 = 152,\n CFG_PIN_D3 = 153,\n CFG_PIN_D4 = 154,\n CFG_PIN_D5 = 155,\n CFG_PIN_D6 = 156,\n CFG_PIN_D7 = 157,\n CFG_PIN_D8 = 158,\n CFG_PIN_D9 = 159,\n CFG_PIN_D10 = 160,\n CFG_PIN_D11 = 161,\n CFG_PIN_D12 = 162,\n CFG_PIN_D13 = 163,\n CFG_PIN_D14 = 164,\n CFG_PIN_D15 = 165,\n CFG_PIN_D16 = 166,\n CFG_PIN_D17 = 167,\n CFG_PIN_D18 = 168,\n CFG_PIN_D19 = 169,\n CFG_PIN_D20 = 170,\n CFG_PIN_D21 = 171,\n CFG_PIN_D22 = 172,\n CFG_PIN_D23 = 173,\n CFG_PIN_D24 = 174,\n CFG_PIN_D25 = 175,\n CFG_PIN_D26 = 176,\n CFG_PIN_D27 = 177,\n CFG_PIN_D28 = 178,\n CFG_PIN_D29 = 179,\n CFG_PIN_D30 = 180,\n CFG_PIN_D31 = 181,\n CFG_PIN_D32 = 182,\n CFG_PIN_D33 = 183,\n CFG_PIN_D34 = 184,\n CFG_PIN_D35 = 185,\n CFG_PIN_D36 = 186,\n CFG_PIN_D37 = 187,\n CFG_PIN_D38 = 188,\n CFG_PIN_D39 = 189,\n CFG_PIN_D40 = 190,\n CFG_PIN_D41 = 191,\n CFG_PIN_D42 = 192,\n CFG_PIN_D43 = 193,\n CFG_PIN_D44 = 194,\n CFG_PIN_D45 = 195,\n CFG_PIN_D46 = 196,\n CFG_PIN_D47 = 197,\n CFG_PIN_D48 = 198,\n CFG_PIN_D49 = 199,\n CFG_PIN_D50 = 259,\n CFG_PIN_D51 = 260,\n CFG_PIN_D52 = 261,\n CFG_PIN_D53 = 262,\n\n CFG_PIN_TX1 = 263,\n CFG_PIN_TX2 = 264,\n CFG_PIN_TX3 = 265,\n CFG_PIN_RX1 = 266,\n CFG_PIN_RX2 = 267,\n CFG_PIN_RX3 = 268,\n CFG_PIN_SCL1 = 269,\n CFG_PIN_SDA1 = 270,\n CFG_PIN_PCC_D0 = 271,\n CFG_PIN_PCC_D1 = 272,\n CFG_PIN_PCC_D2= 273,\n CFG_PIN_PCC_D3 = 274,\n CFG_PIN_PCC_D4 = 275,\n CFG_PIN_PCC_D5 = 276,\n CFG_PIN_PCC_D6 = 277,\n CFG_PIN_PCC_D7 = 278,\n CFG_PIN_PCC_D8 = 279,\n CFG_PIN_PCC_D9 = 280,\n CFG_PIN_PCC_D10 = 281,\n CFG_PIN_PCC_D11 = 282,\n CFG_PIN_PCC_D12 = 283,\n CFG_PIN_PCC_D13 = 284,\n CFG_PIN_CC_DEN1 = 285,\n CFG_PIN_CC_DEN2 = 286,\n CFG_PIN_CC_CLK = 287,\n CFG_PIN_XCC_CLK = 288,\n CFG_PIN_AREF= 289,\n\n CFG_NUM_NEOPIXELS = 200,\n CFG_NUM_DOTSTARS = 201,\n CFG_DEFAULT_BUTTON_MODE = 202,\n CFG_SWD_ENABLED = 203,\n CFG_FLASH_BYTES = 204,\n CFG_RAM_BYTES = 205,\n CFG_SYSTEM_HEAP_BYTES = 206,\n CFG_LOW_MEM_SIMULATION_KB = 207,\n CFG_BOOTLOADER_BOARD_ID = 208,\n CFG_UF2_FAMILY = 209,\n CFG_PINS_PORT_SIZE = 210,\n CFG_BOOTLOADER_PROTECTION = 211,\n CFG_POWER_DEEPSLEEP_TIMEOUT = 212,\n CFG_ANALOG_BUTTON_THRESHOLD = 213,\n CFG_CPU_MHZ = 214,\n CFG_CONTROLLER_LIGHT_MAX_BRIGHTNESS = 215,\n CFG_ANALOG_JOYSTICK_MIN = 216,\n CFG_ANALOG_JOYSTICK_MAX = 217,\n CFG_TIMERS_TO_USE = 218,\n CFG_PIN_ONBOARD_DOTSTAR_CLOCK = 219,\n CFG_PIN_ONBOARD_DOTSTAR_DATA = 220,\n CFG_NUM_ONBOARD_DOTSTARS = 221,\n CFG_PIN_ONBOARD_NEOPIXEL = 222,\n CFG_NUM_ONBOARD_NEOPIXELS = 223,\n CFG_MATRIX_KEYPAD_MESSAGE_ID = 239,\n CFG_NUM_MATRIX_KEYPAD_ROWS = 240,\n CFG_PIN_MATRIX_KEYPAD_ROW0 = 241,\n CFG_PIN_MATRIX_KEYPAD_ROW1 = 242,\n CFG_PIN_MATRIX_KEYPAD_ROW2 = 243,\n CFG_PIN_MATRIX_KEYPAD_ROW3 = 244,\n CFG_PIN_MATRIX_KEYPAD_ROW4 = 245,\n CFG_PIN_MATRIX_KEYPAD_ROW5 = 246,\n CFG_PIN_MATRIX_KEYPAD_ROW6 = 247,\n CFG_PIN_MATRIX_KEYPAD_ROW7 = 248,\n CFG_NUM_MATRIX_KEYPAD_COLS = 250,\n CFG_PIN_MATRIX_KEYPAD_COL0 = 251,\n CFG_PIN_MATRIX_KEYPAD_COL1 = 252,\n CFG_PIN_MATRIX_KEYPAD_COL2 = 253,\n CFG_PIN_MATRIX_KEYPAD_COL3 = 254,\n CFG_PIN_MATRIX_KEYPAD_COL4 = 255,\n CFG_PIN_MATRIX_KEYPAD_COL5 = 256,\n CFG_PIN_MATRIX_KEYPAD_COL6 = 257,\n CFG_PIN_MATRIX_KEYPAD_COL7 = 258,\n CFG_PIN_B0 = 300,\n CFG_PIN_B1 = 301,\n CFG_PIN_B2 = 302,\n CFG_PIN_B3 = 303,\n CFG_PIN_B4 = 304,\n CFG_PIN_B5 = 305,\n CFG_PIN_B6 = 306,\n CFG_PIN_B7 = 307,\n CFG_PIN_B8 = 308,\n CFG_PIN_B9 = 309,\n CFG_PIN_B10 = 310,\n CFG_PIN_B11 = 311,\n CFG_PIN_B12 = 312,\n CFG_PIN_B13 = 313,\n CFG_PIN_B14 = 314,\n CFG_PIN_B15 = 315,\n CFG_PIN_B16 = 316,\n CFG_PIN_B17 = 317,\n CFG_PIN_B18 = 318,\n CFG_PIN_B19 = 319,\n CFG_PIN_B20 = 320,\n CFG_PIN_B21 = 321,\n CFG_PIN_B22 = 322,\n CFG_PIN_B23 = 323,\n CFG_PIN_B24 = 324,\n CFG_PIN_B25 = 325,\n CFG_PIN_B26 = 326,\n CFG_PIN_B27 = 327,\n CFG_PIN_B28 = 328,\n CFG_PIN_B29 = 329,\n CFG_PIN_B30 = 330,\n CFG_PIN_B31 = 331,\n CFG_PIN_C0 = 350,\n CFG_PIN_C1 = 351,\n CFG_PIN_C2 = 352,\n CFG_PIN_C3 = 353,\n CFG_PIN_C4 = 354,\n CFG_PIN_C5 = 355,\n CFG_PIN_C6 = 356,\n CFG_PIN_C7 = 357,\n CFG_PIN_C8 = 358,\n CFG_PIN_C9 = 359,\n CFG_PIN_C10 = 360,\n CFG_PIN_C11 = 361,\n CFG_PIN_C12 = 362,\n CFG_PIN_C13 = 363,\n CFG_PIN_C14 = 364,\n CFG_PIN_C15 = 365,\n CFG_PIN_C16 = 366,\n CFG_PIN_C17 = 367,\n CFG_PIN_C18 = 368,\n CFG_PIN_C19 = 369,\n CFG_PIN_C20 = 370,\n CFG_PIN_C21 = 371,\n CFG_PIN_C22 = 372,\n CFG_PIN_C23 = 373,\n CFG_PIN_C24 = 374,\n CFG_PIN_C25 = 375,\n CFG_PIN_C26 = 376,\n CFG_PIN_C27 = 377,\n CFG_PIN_C28 = 378,\n CFG_PIN_C29 = 379,\n CFG_PIN_C30 = 380,\n CFG_PIN_C31 = 381,\n CFG_PIN_P0 = 400,\n CFG_PIN_P1 = 401,\n CFG_PIN_P2 = 402,\n CFG_PIN_P3 = 403,\n CFG_PIN_P4 = 404,\n CFG_PIN_P5 = 405,\n CFG_PIN_P6 = 406,\n CFG_PIN_P7 = 407,\n CFG_PIN_P8 = 408,\n CFG_PIN_P9 = 409,\n CFG_PIN_P10 = 410,\n CFG_PIN_P11 = 411,\n CFG_PIN_P12 = 412,\n CFG_PIN_P13 = 413,\n CFG_PIN_P14 = 414,\n CFG_PIN_P15 = 415,\n CFG_PIN_P16 = 416,\n CFG_PIN_P17 = 417,\n CFG_PIN_P18 = 418,\n CFG_PIN_P19 = 419,\n CFG_PIN_P20 = 420,\n CFG_PIN_P21 = 421,\n CFG_PIN_P22 = 422,\n CFG_PIN_P23 = 423,\n CFG_PIN_P24 = 424,\n CFG_PIN_P25 = 425,\n CFG_PIN_P26 = 426,\n CFG_PIN_P27 = 427,\n CFG_PIN_P28 = 428,\n CFG_PIN_P29 = 429,\n CFG_PIN_P30 = 430,\n CFG_PIN_P31 = 431,\n CFG_PIN_LORA_MISO = 1001,\n CFG_PIN_LORA_MOSI = 1002,\n CFG_PIN_LORA_SCK = 1003,\n CFG_PIN_LORA_CS = 1004,\n CFG_PIN_LORA_BOOT = 1005,\n CFG_PIN_LORA_RESET = 1006,\n CFG_PIN_IRRXLED = 1007,\n CFG_PIN_IRTXLED = 1008,\n CFG_PIN_LCD_RESET = 1009,\n CFG_PIN_LCD_ENABLE = 1010,\n CFG_PIN_LCD_DATALINE4 = 1011,\n CFG_PIN_LCD_DATALINE5 = 1012,\n CFG_PIN_LCD_DATALINE6 = 1013,\n CFG_PIN_LCD_DATALINE7 = 1014,\n CFG_NUM_LCD_COLUMNS = 1015,\n CFG_NUM_LCD_ROWS = 1016,\n CFG_PIN_RCC0 = 1017,\n CFG_PIN_RCC1 = 1018,\n CFG_PIN_RCC2 = 1019,\n CFG_PIN_RCC3 = 1020,\n CFG_PIN_RCC4 = 1021,\n CFG_PIN_RCC5 = 1022,\n CFG_PIN_RCC6 = 1023,\n CFG_PIN_RCC7 = 1024,\n CFG_PIN_SERVO0 = 1025,\n CFG_PIN_SERVO1 = 1026,\n CFG_PIN_SERVO2 = 1027,\n CFG_PIN_SERVO3 = 1028,\n CFG_PIN_SERVO4 = 1029,\n CFG_PIN_SERVO5 = 1030,\n CFG_PIN_SERVO6 = 1031,\n CFG_PIN_SERVO7 = 1032,\n CFG_PIN_SERVO8 = 1033,\n CFG_PIN_PI_TX = 1034,\n CFG_PIN_PI_RX = 1035,\n CFG_PIN_GPS_SDA = 1036,\n CFG_PIN_GPS_SCL = 1037,\n CFG_PIN_GPS_TX = 1038,\n CFG_PIN_GPS_RX = 1039,\n CFG_PIN_GROVE0 = 1040,\n CFG_PIN_GROVE1 = 1041,\n CFG_PIN_SS = 1042,\n // /pxtapp/hf2dbg.h\n HF2DBG_H = 1,\n // /pxtapp/jacdac/jdprotocol.h\n JDSPI_MAGIC = 31437,\n JDSPI_MAGIC_NOOP = 46029,\n // /pxtapp/mixer---samd/melody.h\n SW_TRIANGLE = 1,\n SW_SAWTOOTH = 2,\n SW_SINE = 3,\n SW_NOISE = 5,\n SW_SQUARE_10 = 11,\n SW_SQUARE_50 = 15,\n CODAL = 1,\n MAX_SOUNDS = 5,\n Waiting = 0,\n Playing = 1,\n Done = 2,\n // /pxtapp/pins.h\n BUTTON_ACTIVE_HIGH_PULL_DOWN = 17,\n BUTTON_ACTIVE_HIGH_PULL_UP = 33,\n BUTTON_ACTIVE_HIGH_PULL_NONE = 49,\n BUTTON_ACTIVE_LOW_PULL_DOWN = 16,\n BUTTON_ACTIVE_LOW_PULL_UP = 32,\n BUTTON_ACTIVE_LOW_PULL_NONE = 48,\n // /pxtapp/platform.h\n PAGE_SIZE = 512,\n BOOTLOADER_START = 0,\n DEV_NUM_PINS = 64,\n PXT_74HC165 = 1,\n IMAGE_BITS = 4,\n PA00 = 0,\n PA01 = 1,\n PA02 = 2,\n PA03 = 3,\n PA04 = 4,\n PA05 = 5,\n PA06 = 6,\n PA07 = 7,\n PA08 = 8,\n PA09 = 9,\n PA10 = 10,\n PA11 = 11,\n PA12 = 12,\n PA13 = 13,\n PA14 = 14,\n PA15 = 15,\n PA16 = 16,\n PA17 = 17,\n PA18 = 18,\n PA19 = 19,\n PA20 = 20,\n PA21 = 21,\n PA22 = 22,\n PA23 = 23,\n PA24 = 24,\n PA25 = 25,\n PA26 = 26,\n PA27 = 27,\n PA28 = 28,\n PA29 = 29,\n PA30 = 30,\n PA31 = 31,\n PB00 = 32,\n PB01 = 33,\n PB02 = 34,\n PB03 = 35,\n PB04 = 36,\n PB05 = 37,\n PB06 = 38,\n PB07 = 39,\n PB08 = 40,\n PB09 = 41,\n PB10 = 42,\n PB11 = 43,\n PB12 = 44,\n PB13 = 45,\n PB14 = 46,\n PB15 = 47,\n PB16 = 48,\n PB17 = 49,\n PB18 = 50,\n PB19 = 51,\n PB20 = 52,\n PB21 = 53,\n PB22 = 54,\n PB23 = 55,\n PB24 = 56,\n PB25 = 57,\n PB26 = 58,\n PB27 = 59,\n PB28 = 60,\n PB29 = 61,\n PB30 = 62,\n PB31 = 63,\n PC00 = 64,\n PC01 = 65,\n PC02 = 66,\n PC03 = 67,\n PC04 = 68,\n PC05 = 69,\n PC06 = 70,\n PC07 = 71,\n PC08 = 72,\n PC09 = 73,\n PC10 = 74,\n PC11 = 75,\n PC12 = 76,\n PC13 = 77,\n PC14 = 78,\n PC15 = 79,\n PC16 = 80,\n PC17 = 81,\n PC18 = 82,\n PC19 = 83,\n PC20 = 84,\n PC21 = 85,\n PC22 = 86,\n PC23 = 87,\n PC24 = 88,\n PC25 = 89,\n PC26 = 90,\n PC27 = 91,\n PC28 = 92,\n PC29 = 93,\n PC30 = 94,\n PC31 = 95,\n PD00 = 96,\n PD01 = 97,\n PD02 = 98,\n PD03 = 99,\n PD04 = 100,\n PD05 = 101,\n PD06 = 102,\n PD07 = 103,\n PD08 = 104,\n PD09 = 105,\n PD10 = 106,\n PD11 = 107,\n PD12 = 108,\n PD13 = 109,\n PD14 = 110,\n PD15 = 111,\n PD16 = 112,\n PD17 = 113,\n PD18 = 114,\n PD19 = 115,\n PD20 = 116,\n PD21 = 117,\n PD22 = 118,\n PD23 = 119,\n PD24 = 120,\n PD25 = 121,\n PD26 = 122,\n PD27 = 123,\n PD28 = 124,\n PD29 = 125,\n PD30 = 126,\n PD31 = 127,\n // /pxtapp/pxt.h\n DEVICE_ID_BUTTON_SLIDE = 3000,\n DEVICE_ID_MICROPHONE = 3001,\n DEVICE_ID_FIRST_BUTTON = 4000,\n DEVICE_ID_FIRST_TOUCHBUTTON = 4100,\n PXT_INTERNAL_KEY_UP = 2050,\n PXT_INTERNAL_KEY_DOWN = 2051,\n // /pxtapp/pxtbase.h\n PXT32 = 1,\n PXT64 = 1,\n PXT_REFCNT_FLASH = 65534,\n VTABLE_MAGIC = 249,\n Undefined = 0,\n Boolean = 1,\n Number = 2,\n String = 3,\n Object = 4,\n Function = 5,\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,\n MMap = 10,\n User0 = 16,\n PXT_IOS_HEAP_ALLOC_BITS = 20,\n IMAGE_HEADER_MAGIC = 135,\n Int8LE = 1,\n UInt8LE = 2,\n Int16LE = 3,\n UInt16LE = 4,\n Int32LE = 5,\n Int8BE = 6,\n UInt8BE = 7,\n Int16BE = 8,\n UInt16BE = 9,\n Int32BE = 10,\n UInt32LE = 11,\n UInt32BE = 12,\n Float32LE = 13,\n Float64LE = 14,\n Float32BE = 15,\n Float64BE = 16,\n NUM_TRY_FRAME_REGS = 3,\n GC = 0,\n // /pxtapp/pxtconfig.h\n PXT_UF2_FAMILY = 1427194976,\n // /pxtapp/settings/Flash.h\n DEVICE_FLASH_ERROR = 922,\n // /pxtapp/settings/RAFFS.h\n RAFFS_FOLLOWING_MASK = 32768,\n RAFFS_FLASH_BUFFER_SIZE = 64,\n // /pxtapp/thermometer/target_temperature.h\n TEMPERATURE_NOMINAL_VALUE = 25,\n TEMPERATURE_NOMINAL_READING = 10000,\n TEMPERATURE_BETA = 3380,\n TEMPERATURE_SERIES_RESISTOR = 10000,\n // /pxtapp/uf2hid.h\n UF2_HID_H = 1,\n}\n",
"dmac.cpp": "#include \"dmac.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nSINGLETON(WDMAC);\n#endif\n\n}",
"dmac.h": "#ifndef __DMAC_H\n#define __DMAC_H\n\n#include \"pxt.h\"\n\nnamespace pxt {\n\n#ifdef CODAL_DMAC\nclass WDMAC {\n public:\n CODAL_DMAC dmac;\n\n WDMAC() {}\n};\n\nWDMAC* getWDMAC();\n#endif\n\n}\n\n#endif",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum PulseValue {\n //% block=high\n High = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=low\n Low = 5, // DEVICE_PIN_EVT_PULSE_LO\n }\n\n\n declare const enum PinEvent {\n //% block=\"pulse high\"\n PulseHigh = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=\"pulse low\"\n PulseLow = 5, // DEVICE_PIN_EVT_PULSE_LO\n //% block=\"rise\"\n Rise = 2, // DEVICE_PIN_EVT_RISE\n //% block=\"fall\"\n Fall = 3, // DEVICE_PIN_EVT_FALL\n }\n\n\n declare const enum PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"hf2.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#ifndef USB_HANDOVER\n#define USB_HANDOVER 1\n#endif\n\n#if USB_HANDOVER\n#define UF2_DEFINE_HANDOVER 1\n#endif\n\n#include \"uf2format.h\"\n\nstatic void *stackCopy;\nstatic uint32_t stackSize;\n\n//#define LOG DMESG\n#define LOG(...) ((void)0)\n\nstatic volatile bool resume = false;\n\nusing namespace codal;\n\n#ifdef HF2_HID\nstatic const char hidDescriptor[] = {\n 0x06, 0x97, 0xFF, // usage page vendor 0x97 (usage 0xff97 0x0001)\n 0x09, 0x01, // usage 1\n 0xA1, 0x01, // collection - application\n 0x15, 0x00, // logical min 0\n 0x26, 0xFF, 0x00, // logical max 255\n 0x75, 8, // report size 8\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x81, 0x02, // input: data, variable, absolute\n 0x95, 64, // report count 64\n 0x09, 0x01, // usage 1\n 0x91, 0x02, // output: data, variable, absolute\n 0x95, 1, // report count 1\n 0x09, 0x01, // usage 1\n 0xB1, 0x02, // feature: data, variable, absolute\n 0xC0, // end\n};\n\nstatic const HIDReportDescriptor reportDesc = {\n 9,\n 0x21, // HID\n 0x100, // hidbcd 1.00\n 0x00, // country code\n 0x01, // num desc\n 0x22, // report desc type\n sizeof(hidDescriptor), // size of 0x22\n};\n\nstatic const InterfaceInfo ifaceInfoHID = {\n &reportDesc,\n sizeof(reportDesc),\n 1,\n {\n 2, // numEndpoints\n 0x03, /// class code - HID\n 0x00, // subclass\n 0x00, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_INTERRUPT, 1},\n {USB_EP_TYPE_INTERRUPT, 1},\n};\n#endif\n\nstatic const InterfaceInfo ifaceInfoEP = {\n NULL,\n 0,\n 2,\n {\n 2, // numEndpoints\n 0xff, /// class code - vendor-specific\n 42, // subclass\n 1, // protocol\n 0x02, // string\n 0x00, // alt\n },\n {USB_EP_TYPE_BULK, 0},\n {USB_EP_TYPE_BULK, 0},\n};\n\nint HF2::stdRequest(UsbEndpointIn &ctrl, USBSetup &setup) {\n#ifdef HF2_HID\n if (!useHID)\n return DEVICE_NOT_SUPPORTED;\n if (setup.bRequest == USB_REQ_GET_DESCRIPTOR) {\n if (setup.wValueH == 0x21) {\n InterfaceDescriptor tmp;\n fillInterfaceInfo(&tmp);\n return ctrl.write(&tmp, sizeof(tmp));\n } else if (setup.wValueH == 0x22) {\n return ctrl.write(hidDescriptor, sizeof(hidDescriptor));\n }\n }\n#endif\n return DEVICE_NOT_SUPPORTED;\n}\n\n// same as in microbit\n#define CTRL_GET_REPORT 0x01\n#define CTRL_SET_REPORT 0x09\n#define CTRL_OUT_REPORT_H 0x2\n#define CTRL_IN_REPORT_H 0x1\n\nvoid HF2::sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend) {\n if (!CodalUSB::usbInstance->isInitialised())\n return;\n\n uint32_t buf[64 / 4]; // aligned\n\n if (prepend + 1)\n size += 4;\n\n target_disable_irq();\n while (size > 0) {\n memset(buf + 1, 0, 60);\n int s = 63;\n if (size <= 63) {\n s = size;\n buf[0] = flag;\n } else {\n buf[0] = flag == HF2_FLAG_CMDPKT_LAST ? HF2_FLAG_CMDPKT_BODY : flag;\n }\n buf[0] |= s;\n uint8_t *dst = (uint8_t *)buf;\n dst++;\n if (prepend + 1) {\n memcpy(dst, &prepend, 4);\n prepend = -1;\n dst += 4;\n s -= 4;\n size -= 4;\n }\n memcpy(dst, data, s);\n data = (const uint8_t *)data + s;\n size -= s;\n\n in->write(buf, sizeof(buf));\n }\n target_enable_irq();\n}\n\nconst InterfaceInfo *HF2::getInterfaceInfo() {\n#ifdef HF2_HID\n if (useHID)\n return &ifaceInfoHID;\n#endif\n return &ifaceInfoEP;\n}\n\nint HF2::sendEvent(uint32_t evId, const void *data, int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, evId);\n return 0;\n}\n\nint HF2::sendSerial(const void *data, int size, int isError) {\n if (!gotSomePacket)\n return DEVICE_OK;\n\n sendBuffer(isError ? HF2_FLAG_SERIAL_ERR : HF2_FLAG_SERIAL_OUT, data, size);\n\n return 0;\n}\n\n// Receive HF2 message\n// Does not block. Will store intermediate data in pkt.\n// `serial` flag is cleared if we got a command message.\nint HF2::recv() {\n uint8_t buf[64];\n\n int len = out->read(buf, sizeof(buf));\n // DMESG(\"HF2 read: %d\", len);\n\n if (len <= 0)\n return len;\n\n uint8_t tag = buf[0];\n // serial packets not allowed when in middle of command packet\n usb_assert(pkt.size == 0 || !(tag & HF2_FLAG_SERIAL_OUT));\n int size = tag & HF2_SIZE_MASK;\n usb_assert(pkt.size + size <= (int)sizeof(pkt.buf));\n memcpy(pkt.buf + pkt.size, buf + 1, size);\n pkt.size += size;\n tag &= HF2_FLAG_MASK;\n if (tag != HF2_FLAG_CMDPKT_BODY) {\n if (tag == HF2_FLAG_CMDPKT_LAST)\n pkt.serial = 0;\n else if (tag == HF2_FLAG_SERIAL_OUT)\n pkt.serial = 1;\n else\n pkt.serial = 2;\n int sz = pkt.size;\n pkt.size = 0;\n return sz;\n }\n return 0;\n}\n\nint HF2::sendResponse(int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, pkt.buf, 4 + size);\n return 0;\n}\n\nint HF2::sendResponseWithData(const void *data, int size) {\n if (size <= (int)sizeof(pkt.buf) - 4) {\n memcpy(pkt.resp.data8, data, size);\n return sendResponse(size);\n } else {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, pkt.resp.eventId);\n return 0;\n }\n}\n\nstatic void copy_words(void *dst0, const void *src0, uint32_t n_words) {\n uint32_t *dst = (uint32_t *)dst0;\n const uint32_t *src = (const uint32_t *)src0;\n while (n_words--)\n *dst++ = *src++;\n}\n\n#ifndef QUICK_BOOT\n#ifdef SAMD21\n#define DBL_TAP_PTR ((volatile uint32_t *)(HMCRAMC0_ADDR + HMCRAMC0_SIZE - 4))\n#endif\n#ifdef SAMD51\n#define DBL_TAP_PTR ((volatile uint32_t *)(HSRAM_ADDR + HSRAM_SIZE - 4))\n#endif\n#if defined(NRF52840) || defined(NRF52833)\n#define DBL_TAP_PTR ((volatile uint32_t*)0x20007F7C)\n#endif\n#define DBL_TAP_MAGIC_QUICK_BOOT 0xf02669ef\n#define QUICK_BOOT(v) *DBL_TAP_PTR = v ? DBL_TAP_MAGIC_QUICK_BOOT : 0\n#endif\n\nstatic HF2 *jdLogger;\nstatic void jdLog(const uint8_t *frame) {\n jdLogger->sendEvent(HF2_EV_JDS_PACKET, frame, frame[2] + 12);\n}\n\nint HF2::endpointRequest() {\n int sz = recv();\n\n if (!sz)\n return 0;\n\n uint32_t tmp;\n\n if (pkt.serial) {\n // TODO raise some event?\n return 0;\n }\n\n LOG(\"HF2 sz=%d CMD=%x\", sz, pkt.buf32[0]);\n\n // one has to be careful dealing with these, as they share memory\n HF2_Command *cmd = &pkt.cmd;\n HF2_Response *resp = &pkt.resp;\n\n uint32_t cmdId = cmd->command_id;\n resp->tag = cmd->tag;\n resp->status16 = HF2_STATUS_OK;\n\n#define checkDataSize(str, add) usb_assert(sz == 8 + (int)sizeof(cmd->str) + (int)(add))\n\n lastExchange = current_time_ms();\n gotSomePacket = true;\n\n switch (cmdId) {\n case HF2_CMD_INFO:\n return sendResponseWithData(uf2_info(), strlen(uf2_info()));\n\n case HF2_CMD_BININFO:\n resp->bininfo.mode = HF2_MODE_USERSPACE;\n resp->bininfo.flash_page_size = 0;\n resp->bininfo.flash_num_pages = 0;\n resp->bininfo.max_message_size = sizeof(pkt.buf);\n resp->bininfo.uf2_family = PXT_UF2_FAMILY;\n return sendResponse(sizeof(resp->bininfo));\n\n case HF2_DBG_RESTART:\n *HF2_DBG_MAGIC_PTR = HF2_DBG_MAGIC_START;\n target_reset();\n break;\n\n case HF2_CMD_RESET_INTO_APP:\n QUICK_BOOT(1);\n NVIC_SystemReset();\n break;\n case HF2_CMD_RESET_INTO_BOOTLOADER:\n QUICK_BOOT(0);\n NVIC_SystemReset();\n break;\n\n#if USB_HANDOVER\n case HF2_CMD_START_FLASH:\n sendResponse(0);\n hf2_handover(in->ep);\n usb_assert(0); // should not be reached\n break;\n#endif\n\n case HF2_CMD_WRITE_WORDS:\n checkDataSize(write_words, cmd->write_words.num_words << 2);\n copy_words((void *)cmd->write_words.target_addr, cmd->write_words.words,\n cmd->write_words.num_words);\n break;\n\n case HF2_CMD_READ_WORDS:\n checkDataSize(read_words, 0);\n tmp = cmd->read_words.num_words;\n usb_assert(tmp <= sizeof(pkt.buf) / 4 - 1);\n copy_words(resp->data32, (void *)cmd->read_words.target_addr, tmp);\n return sendResponse(tmp << 2);\n\n case HF2_CMD_DMESG:\n#if DEVICE_DMESG_BUFFER_SIZE > 0\n return sendResponseWithData(codalLogStore.buffer, codalLogStore.ptr);\n#else\n break;\n#endif\n\n case HF2_DBG_GET_GLOBAL_STATE: {\n HF2_GLOBAL_STATE_Result gstate = {\n .num_globals = (uint32_t)getNumGlobals(), //\n .globals_addr = (uint32_t)globals,\n };\n return sendResponseWithData(&gstate, sizeof(gstate));\n }\n\n case HF2_DBG_RESUME:\n globals[0] = (TValue)cmd->data32[0];\n resume = true;\n return sendResponse(0);\n\n case HF2_DBG_GET_STACK:\n return sendResponseWithData(stackCopy, stackSize);\n\n case HF2_CMD_JDS_CONFIG:\n if (cmd->data8[0]) {\n jdLogger = this;\n pxt::logJDFrame = jdLog;\n } else {\n pxt::logJDFrame = NULL;\n }\n return sendResponse(0);\n\n case HF2_CMD_JDS_SEND:\n if (pxt::sendJDFrame) {\n pxt::sendJDFrame(cmd->data8);\n return sendResponse(0);\n } else {\n resp->status16 = HF2_STATUS_INVALID_STATE;\n return sendResponse(0);\n }\n\n default:\n // command not understood\n resp->status16 = HF2_STATUS_INVALID_CMD;\n break;\n }\n\n return sendResponse(0);\n}\n\nHF2::HF2(HF2_Buffer &p) : gotSomePacket(false), ctrlWaiting(false), pkt(p), useHID(false) {\n lastExchange = 0;\n}\n\nstatic const InterfaceInfo dummyIfaceInfo = {\n NULL,\n 0,\n 0,\n {\n 0, // numEndpoints\n 0xff, /// class code - vendor-specific\n 0xff, // subclass\n 0xff, // protocol\n 0x00, // string\n 0x00, // alt\n },\n {0, 0},\n {0, 0},\n};\n\nconst InterfaceInfo *DummyIface::getInterfaceInfo() {\n return &dummyIfaceInfo;\n}\n\n//\n//\n// Debugger\n//\n//\n\nstruct ExceptionContext {\n uint32_t excReturn; // 0xFFFFFFF9\n uint32_t r0;\n uint32_t r1;\n uint32_t r2;\n uint32_t r3;\n uint32_t r12;\n uint32_t lr;\n uint32_t faultInstrAddr;\n uint32_t psr;\n};\n\nstruct Paused_Data {\n uint32_t pc;\n};\nstatic Paused_Data pausedData;\n\nvoid bkptPaused() {\n\n// waiting for https://github.com/lancaster-university/codal/pull/14\n#ifdef DEVICE_GROUP_ID_USER\n // the loop below counts as \"system\" task, and we don't want to pause ourselves\n fiber_set_group(DEVICE_GROUP_ID_SYSTEM);\n // pause everyone else\n fiber_pause_group(DEVICE_GROUP_ID_USER);\n#endif\n\n while (!resume) {\n // DMESG(\"BKPT\");\n hf2.pkt.resp.eventId = HF2_EV_DBG_PAUSED;\n hf2.sendResponseWithData(&pausedData, sizeof(pausedData));\n // TODO use an event\n for (int i = 0; i < 20; ++i) {\n if (resume)\n break;\n fiber_sleep(50);\n }\n }\n\n if (stackCopy) {\n xfree(stackCopy);\n stackCopy = NULL;\n }\n\n#ifdef DEVICE_GROUP_ID_USER\n fiber_resume_group(DEVICE_GROUP_ID_USER);\n // go back to user mode\n fiber_set_group(DEVICE_GROUP_ID_USER);\n#endif\n\n resume = false;\n}\n\nextern \"C\" void handleHardFault(ExceptionContext *ectx) {\n auto instr = (uint16_t *)ectx->faultInstrAddr;\n\n DMESG(\"FLT %p\", instr);\n\n if (ectx->faultInstrAddr & 0x80000000) {\n ectx->faultInstrAddr &= ~0x80000000;\n // switch to step-over mode\n globals[0] = (TValue)3;\n return;\n }\n\n DMESG(\"BB %p %p %p lr=%p r0=%p\", instr[-1], instr[0], instr[1], ectx->lr, ectx->r0);\n\n if (instr[0] == 0x6840) {\n // ldr r0, [r0, #4] -- entry breakpoint\n ectx->faultInstrAddr += 2;\n // we're being ask for step-over mode\n if (ectx->r0 == 3) {\n // switch to debugger-attached-no-stepping mode\n globals[0] = (TValue)0;\n ectx->lr |= 0x80000000;\n }\n return;\n }\n\n if (instr[0] == 0x6800) {\n // ldr r0, [r0, #0]\n ectx->lr = ectx->faultInstrAddr + 3; // next instruction + thumb mode\n pausedData.pc = ectx->faultInstrAddr + 2;\n void *ssp = (void *)(ectx + 1);\n stackSize = DEVICE_STACK_BASE - (uint32_t)ssp;\n if (stackCopy)\n xfree(stackCopy);\n stackCopy = xmalloc(stackSize);\n memcpy(stackCopy, ssp, stackSize);\n ectx->faultInstrAddr = ((uint32_t)(&bkptPaused) & (~1U));\n return;\n }\n\n while (1) {\n }\n}\n\nextern \"C\" void HardFault_Handler(void) {\n asm(\"push {lr}; mov r0, sp; bl handleHardFault; pop {pc}\");\n}\n\n#endif",
"hf2.h": "#ifndef DEVICE_HF2_H\n#define DEVICE_HF2_H\n\n#if CONFIG_ENABLED(DEVICE_USB)\n\n#include \"HID.h\"\n#include \"uf2hid.h\"\n\n// 260 bytes needed for biggest JD packets (with overheads)\n#define HF2_BUF_SIZE 260\n\ntypedef struct {\n uint16_t size;\n uint8_t serial;\n union {\n uint8_t buf[HF2_BUF_SIZE];\n uint32_t buf32[HF2_BUF_SIZE / 4];\n uint16_t buf16[HF2_BUF_SIZE / 2];\n HF2_Command cmd;\n HF2_Response resp;\n };\n} HF2_Buffer;\n\nclass HF2 : public CodalUSBInterface {\n bool gotSomePacket;\n bool ctrlWaiting;\n uint32_t lastExchange;\n\n public:\n HF2_Buffer &pkt;\n\n bool useHID;\n\n int sendResponse(int size);\n int recv();\n int sendResponseWithData(const void *data, int size);\n int sendEvent(uint32_t evId, const void *data, int size);\n void sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend = -1);\n\n HF2(HF2_Buffer &pkt);\n virtual int endpointRequest();\n virtual int stdRequest(UsbEndpointIn &ctrl, USBSetup &setup);\n virtual const InterfaceInfo *getInterfaceInfo();\n int sendSerial(const void *data, int size, int isError = 0);\n\n virtual bool enableWebUSB() { return !useHID; }\n};\n\nclass DummyIface : public CodalUSBInterface {\n public:\n virtual const InterfaceInfo *getInterfaceInfo();\n};\n\n#endif\n\n#endif\n",
"hf2dbg.h": "#ifndef HF2DBG_H\n#define HF2DBG_H 1\n\n// we use a location at the top of the stack to store a magic value\n// which causes us to stop at the very first break point in the program\n#define HF2_DBG_MAGIC_PTR ((uint32_t *)(DEVICE_STACK_BASE - (DEVICE_STACK_SIZE - 4)))\n#define HF2_DBG_MAGIC_START 0xf0ebac7f\n\n#define HF2_DBG_GET_GLOBAL_STATE 0x53fc66e0\nstruct HF2_GLOBAL_STATE_Result {\n uint32_t num_globals;\n uint32_t globals_addr;\n};\n\n#define HF2_DBG_RESTART 0x1120bd93\n#define HF2_DBG_RESUME 0x27a55931\n#define HF2_EV_DBG_PAUSED 0x3692f9fd\n#define HF2_DBG_GET_STACK 0x70901510\n\n#endif\n",
"i2c.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n#include \"CodalDmesg.h\"\n#include \"configkeys.h\"\n\n#ifdef CODAL_I2C\n\nnamespace pins {\n\nclass CodalI2CProxy {\nprivate:\n DevicePin* sda;\n DevicePin* scl;\n CODAL_I2C i2c;\npublic:\n CodalI2CProxy* next;\npublic:\n CodalI2CProxy(DevicePin* _sda, DevicePin* _scl)\n : sda(_sda)\n , scl(_scl)\n , i2c(*_sda, *_scl) \n , next(NULL)\n {\n\n }\n\n CODAL_I2C* getI2C() {\n return &(this->i2c);\n }\n \n bool matchPins(DevicePin* sda, DevicePin* scl) {\n return this->sda == sda && this->scl == scl;\n }\n\n Buffer readBuffer(int address, int size, bool repeat = false)\n {\n Buffer buf = mkBuffer(NULL, size);\n registerGCObj(buf);\n int status = this->i2c.read(address << 1, buf->data, size, repeat);\n unregisterGCObj(buf);\n if (status != ErrorCode::DEVICE_OK) {\n buf = 0;\n }\n return buf;\n }\n\n int writeBuffer(int address, Buffer buf, bool repeat = false)\n {\n return this->i2c.write(address << 1, buf->data, buf->length, repeat);\n }\n};\n\n}\n\nnamespace I2CMethods {\n/**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n//%\nBuffer readBuffer(I2C_ i2c, int address, int size, bool repeat = false)\n{\n return i2c->readBuffer(address, size, repeat);\n}\n\n/**\n * Write bytes to a 7-bit I2C `address`.\n */\n//%\nint writeBuffer(I2C_ i2c, int address, Buffer buf, bool repeat = false)\n{\n return i2c->writeBuffer(address, buf, repeat);\n}\n\n}\n\nnamespace pins {\n\nstatic I2C_ i2cs(NULL);\n/**\n* Opens a Serial communication driver\n*/\n//% help=pins/create-i2c\n//% parts=i2c\nI2C_ createI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n // pick up defaults\n if (!sda || !scl) {\n DMESG(\"i2c: lookup default pins\");\n sda = LOOKUP_PIN(SDA);\n scl = LOOKUP_PIN(SCL);\n }\n\n // lookup existing devices\n auto dev = i2cs;\n while(dev) {\n if (dev->matchPins(sda, scl)) {\n DMESG(\"i2c: found existing i2c\");\n return dev;\n }\n dev = dev->next;\n }\n\n // allocate new one\n DMESG(\"i2c: mounting on new device\");\n auto ser = new CodalI2CProxy(sda, scl);\n // push in list\n ser->next = i2cs;\n i2cs = ser;\n return ser;\n}\n\n}\n\nnamespace pxt {\n CODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl) {\n auto i2c = pins::createI2C(sda, scl);\n return i2c->getI2C();\n }\n}\n\n#endif",
"i2c.ts": "namespace pins {\n /**\n * Read one number from an I2C address.\n */\n //% help=pins/i2c-read-number weight=5 group=\"i2c\" inlineInputMode=\"external\"\n //% blockId=pins_i2c_readnumber block=\"i2c read number at address %address|of format %format|repeated %repeated\"\n export function i2cReadNumber(address: number, format: NumberFormat, repeated?: boolean): number {\n const buf = pins.i2cReadBuffer(address, pins.sizeOf(format), repeated)\n if (!buf)\n return undefined\n return buf.getNumber(format, 0)\n }\n\n /**\n * Write one number to an I2C address.\n */\n //% help=pins/i2c-write-number weight=4 group=\"i2c\"\n //% blockId=i2c_writenumber block=\"i2c write number|at address %address|with value %value|of format %format|repeated %repeated\"\n export function i2cWriteNumber(address: number, value: number, format?: NumberFormat, repeated?: boolean): void {\n if (format == undefined)\n format = NumberFormat.UInt8LE;\n const buf = control.createBuffer(pins.sizeOf(format))\n buf.setNumber(format, 0, value)\n pins.i2cWriteBuffer(address, buf, repeated)\n }\n\n /**\n * Write a value in a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param value value to write\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-write-register\n //% blockId=i2c_writereg block=\"i2c write register|at address $address|at register $register|value $value\"\n export function i2cWriteRegister(address: number, register: number, value: number, valueFormat?: NumberFormat): void {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n const valueSize = pins.sizeOf(valueFormat);\n const buf = control.createBuffer(1 + valueSize);\n buf.setNumber(NumberFormat.UInt8LE, 0, register);\n buf.setNumber(valueFormat, 1, value);\n pins.i2cWriteBuffer(address, buf);\n }\n\n /**\n * Read the value from a I2C register.\n * @param address I2c address of the device\n * @param register register index\n * @param valueFormat format of the value, default is UInt8LE\n */\n //% weight=3 group=\"i2c\"\n //% help=pins/i2c-read-register\n //% blockId=i2c_readreg block=\"i2c read register|at address $address|at register $register\"\n export function i2cReadRegister(address: number, register: number, valueFormat?: NumberFormat): number {\n if (valueFormat === undefined)\n valueFormat = NumberFormat.UInt8LE;\n pins.i2cWriteNumber(address, register, NumberFormat.UInt8LE);\n return pins.i2cReadNumber(address, valueFormat);\n }\n\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //%\n export function i2cReadBuffer(address: number, size: number, repeat: boolean = false): Buffer {\n return pins.i2c().readBuffer(address, size, repeat);\n }\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //%\n export function i2cWriteBuffer(address: number, buf: Buffer, repeat: boolean = false): number {\n return pins.i2c().writeBuffer(address, buf, repeat);\n }\n\n let _i2c: I2C;\n /**\n * Gets the default I2C bus\n */\n //%\n export function i2c(): I2C {\n if (!_i2c) {\n const sda = pins.pinByCfg(DAL.CFG_PIN_SDA);\n const scl = pins.pinByCfg(DAL.CFG_PIN_SCL);\n _i2c = pins.createI2C(sda, scl); \n }\n return _i2c; \n }\n\n export class I2CDevice {\n public address: number;\n public bus: I2C;\n private _hasError: boolean;\n constructor(address: number, bus?: I2C) {\n this.address = address;\n this.bus = bus || i2c();\n }\n public readInto(buf: Buffer, repeat = false, start = 0, end: number = null) {\n if (end === null)\n end = buf.length\n if (start >= end)\n return\n let res = this.bus.readBuffer(this.address, end - start, repeat)\n if (!res) {\n this._hasError = true\n return\n }\n buf.write(start, res)\n }\n public write(buf: Buffer, repeat = false) {\n let res = this.bus.writeBuffer(this.address, buf, repeat)\n if (res) {\n this._hasError = true\n }\n }\n public begin(): I2CDevice {\n this._hasError = false;\n return this;\n }\n public end() {\n }\n public ok() {\n return !this._hasError\n }\n\n public transfer(command: Buffer, response: Buffer, responseStart?: number, responseEnd?: number) {\n this.begin();\n if (command)\n this.write(command);\n if (response)\n this.readInto(response, false, responseStart, responseEnd);\n this.end();\n } \n }\n}\n",
"keyvaluestorage.cpp": "#include \"pxt.h\"\n#include \"KeyValueStorage.h\"\n\nnamespace pxt {\n\nclass WKeyValueStorage {\n#ifdef CODAL_NVMCONTROLLER\n CODAL_NVMCONTROLLER controller;\n#else\n NVMController controller;\n#endif\n KeyValueStorage storage;\n public:\n\n WKeyValueStorage()\n : controller()\n , storage(controller) {\n }\n\n bool isSupported() {\n#ifdef CODAL_NVMCONTROLLER\n return true;\n#else\n return false;\n#endif\n }\n\n int put(String key, Buffer data) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n return storage.put(mkey, data->data, data->length);\n#else\n return -1;\n#endif\n }\n\n Buffer get(String key) {\n#ifdef CODAL_NVMCONTROLLER\n Buffer buf = NULL;\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n auto entry = storage.get(mkey);\n if (entry) {\n buf = mkBuffer(entry->value, sizeof(entry->value));\n free(entry);\n }\n return buf;\n#else\n return NULL;\n#endif\n }\n\n void remove(String key) {\n#ifdef CODAL_NVMCONTROLLER\n ManagedString mkey(key->getUTF8Data(), key->getUTF8Size());\n storage.remove(mkey);\n#endif\n }\n\n void clear() {\n#ifdef CODAL_NVMCONTROLLER\n storage.wipe();\n#endif\n }\n};\nSINGLETON(WKeyValueStorage);\n\n}\n\nnamespace configStorage {\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //%\n void setBuffer(String key, Buffer value) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->put(key, value);\n }\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //%\n Buffer getBuffer(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n return kvm->get(key);\n }\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //%\n void removeItem(String key) {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->remove(key);\n }\n\n /**\n * Clears the local storage\n */\n //%\n void clear() {\n auto kvm = pxt::getWKeyValueStorage();\n kvm->clear();\n }\n}\n",
"keyvaluestorage.ts": "namespace configStorage {\n /**\n * Stores the value at the key entry\n * @param key identifier of the key (max 16 characters)\n * @param value identifier of the value (max 32 characters)\n */\n export function setItem(key: string, value: string) {\n if (value == null)\n configStorage.removeItem(key);\n else\n {\n let idx = 0;\n let buf = control.createBuffer(value.length + 1);\n buf[idx++] = value.length;\n let valBuf = control.createBufferFromUTF8(value);\n\n for (let i = 0; i < valBuf.length; i++)\n buf[idx++] = valBuf[i];\n\n configStorage.setBuffer(key, buf);\n }\n }\n\n /**\n * Retrieves the value at the key entry\n * @param key identifier of the key (max 16 characters)\n */\n export function getItem(key: string): string {\n const buf = configStorage.getBuffer(key);\n\n if (!buf)\n return undefined;\n\n let idx = 0;\n let count = buf[idx++];\n const retBuf = control.createBuffer(count);\n\n for (let i = 0; i < count; i++)\n retBuf[i] = buf[idx++];\n\n return retBuf.toString();\n }\n}\n",
"leveldetector.ts": "namespace pins {\n export class LevelDetector {\n public id: number;\n public min: number;\n public max: number;\n public lowThreshold: number;\n public highThreshold: number;\n private transition: number;\n private transitionMs: number;\n private _level: number;\n private _state: number;\n public onHigh: () => void;\n public onLow: () => void;\n public onNeutral: () => void;\n public transitionWindow: number;\n // minimum duration (ms) between events\n public transitionInterval: number;\n\n static LEVEL_THRESHOLD_NEUTRAL = 0;\n\n constructor(id: number,\n min: number, max: number,\n lowThreshold: number, highThreshold: number) {\n this.id = id;\n this.min = min;\n this.max = max;\n this.lowThreshold = lowThreshold;\n this.highThreshold = highThreshold;\n this.transitionWindow = 4;\n this.transitionInterval = 0;\n\n this.onHigh = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_HIGH);\n this.onLow = () => control.raiseEvent(this.id, DAL.LEVEL_THRESHOLD_LOW);\n this.onNeutral = undefined;\n\n this.reset();\n }\n\n reset() {\n this.transition = 0;\n this.transitionMs = 0;\n this._level = Math.ceil((this.highThreshold - this.lowThreshold) / 2);\n this._state = LevelDetector.LEVEL_THRESHOLD_NEUTRAL;\n }\n\n get level(): number {\n return this._level;\n }\n\n set level(level: number) {\n this._level = this.clampValue(level);\n\n if (this._level >= this.highThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_HIGH);\n }\n else if (this._level <= this.lowThreshold) {\n this.setState(DAL.LEVEL_THRESHOLD_LOW);\n }\n else {\n this.setState(LevelDetector.LEVEL_THRESHOLD_NEUTRAL);\n }\n }\n\n public setLowThreshold(value: number) {\n this.lowThreshold = this.clampValue(value);\n this.reset();\n }\n\n public setHighThreshold(value: number) {\n this.highThreshold = this.clampValue(value);\n this.reset();\n }\n\n private clampValue(value: number) {\n if (value < this.min) {\n return this.min;\n }\n else if (value > this.max) {\n return this.max;\n }\n return value;\n }\n\n private setState(state: number) {\n // not enough samples to change\n if (this._state === state \n || (this.transition++ < this.transitionWindow)\n || (control.millis() - this.transitionMs) < this.transitionInterval) {\n return;\n }\n\n this.transition = 0;\n this.transitionMs = control.millis();\n this._state = state;\n switch (state) {\n case DAL.LEVEL_THRESHOLD_HIGH:\n if (this.onHigh) this.onHigh();\n break;\n case DAL.LEVEL_THRESHOLD_LOW:\n if (this.onLow) this.onLow();\n break;\n case LevelDetector.LEVEL_THRESHOLD_NEUTRAL:\n if (this.onNeutral) this.onNeutral();\n break;\n }\n }\n }\n}",
"light.cpp": "#include \"light.h\"\n\n// WS2812B timings, datasheet v1\n// 0 - 0.25-0.55us hi 0.70-1.00us low\n// 1 - 0.65-0.95us hi 0.30-0.60us low\n// datasheet v5\n// 0 - 0.22-0.38us hi 0.58-1.00us low 1-3\n// 1 - 0.58-1.00us hi 0.58-1.00us low 3-2\n\n#define SPI_SUPPORTED 1\n\n#if defined(NRF52_SERIES)\n#define BIT_EXPANSION 5\n#define SPI_FREQ 4000000\n#else\n#define BIT_EXPANSION 3\n#define SPI_FREQ 2400000\n#endif\n\n#if defined(SAMD21) || defined(SAMD51) || defined(STM32F4) || defined(NRF52_SERIES)\n#include \"neopixel.h\"\n#define BITBANG_SUPPORTED 1\n#else\n#define BITBANG_SUPPORTED 0\n#endif\n\n#define NEOPIXEL_MIN_LENGTH_FOR_SPI 24\n#define DOTSTAR_MIN_LENGTH_FOR_SPI 24\n\n#define LIGHTMODE_RGB 1\n#define LIGHTMODE_RGBW 2\n#define LIGHTMODE_RGB_RGB 3\n#define LIGHTMODE_DOTSTAR 4\n\nnamespace light {\nbool isValidMOSIPin(DigitalInOutPin pin) {\n if (!pin)\n return false;\n\n#if SAMD51\n return ZSPI::isValidMOSIPin(*pin);\n#elif defined(NRF52_SERIES)\n return true;\n#else\n // TODO: support for SPI neopixels\n // default SPI pins supported for now\n return pin == LOOKUP_PIN(MOSI);\n#endif\n}\n\n// SPI\nvoid spiNeopixelSendBuffer(DevicePin *pin, const uint8_t *data, unsigned size) {\n int32_t iptr = 0, optr = 120;\n uint32_t len = optr + size * BIT_EXPANSION + 120;\n uint8_t *expBuf = new uint8_t[len];\n memset(expBuf, 0, len);\n uint8_t imask = 0x80;\n uint8_t omask = 0x80;\n\n#define WR(k) \\\n if (k) \\\n expBuf[optr] |= omask; \\\n omask >>= 1; \\\n if (!omask) { \\\n omask = 0x80; \\\n optr++; \\\n }\n\n while (iptr < (int)size) {\n#if BIT_EXPANSION == 3\n WR(1);\n WR(data[iptr] & imask);\n WR(0);\n#elif BIT_EXPANSION == 5\n WR(1);\n if (data[iptr] & imask) {\n WR(1);\n WR(1);\n } else {\n WR(0);\n }\n WR(0);\n WR(0);\n#else\n#error \"invalid BIT_EXPANSION\"\n#endif\n\n imask >>= 1;\n if (!imask) {\n imask = 0x80;\n iptr++;\n }\n }\n\n auto spi = pxt::getSPI(pin, NULL, NULL);\n spi->setFrequency(SPI_FREQ);\n spi->transfer(expBuf, len, NULL, 0);\n delete expBuf;\n}\n\nvoid neopixelSendData(DevicePin *pin, int mode, const uint8_t *data, unsigned length) {\n if (!pin || !length)\n return;\n\n#if BITBANG_SUPPORTED\n if (SPI_SUPPORTED && length > NEOPIXEL_MIN_LENGTH_FOR_SPI && isValidMOSIPin(pin))\n spiNeopixelSendBuffer(pin, data, length);\n else\n neopixel_send_buffer(*pin, data, length);\n#else\n if (isValidMOSIPin(pin)) {\n spiNeopixelSendBuffer(pin, data, length);\n }\n#endif\n}\n\nvoid bitBangDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n // first frame of zeroes\n data->setDigitalValue(0);\n for (unsigned i = 0; i < 32; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n\n // data stream\n for (unsigned i = 0; i < length; ++i) {\n auto x = buf[i];\n for (uint8_t j = 0x80; j != 0; j >>= 1) {\n data->setDigitalValue(x & j ? 1 : 0);\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n }\n // https://cpldcpu.wordpress.com/2016/12/13/sk9822-a-clone-of-the-apa102/\n // reset frame\n // data->setDigitalValue(0);\n // for (unsigned i = 0; i < 32 ; ++i) {\n // clk->setDigitalValue(1);\n // clk->setDigitalValue(0);\n //}\n\n // https://cpldcpu.wordpress.com/2014/11/30/understanding-the-apa102-superled/\n data->setDigitalValue(1);\n unsigned n = 32;\n for (unsigned i = 0; i < n; ++i) {\n clk->setDigitalValue(1);\n clk->setDigitalValue(0);\n }\n}\n\nstatic uint8_t ZERO_FRAME[4];\nstatic uint8_t ONE_FRAME[] = {1, 1, 1, 1};\nvoid spiDotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n auto spi = pxt::getSPI(data, NULL, clk);\n\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // initial frame\n spi->transfer(buf, length, NULL, 0);\n spi->transfer(ZERO_FRAME, sizeof(ZERO_FRAME), NULL, 0); // reset frame\n for (unsigned i = 0; i < (length >> 3); i += 32)\n spi->transfer(ONE_FRAME, sizeof(ONE_FRAME), NULL, 0); // final frame\n}\n\nvoid dotStarSendData(DevicePin *data, DevicePin *clk, int mode, const uint8_t *buf,\n unsigned length) {\n if (!data || !clk || !buf || !length)\n return;\n\n if (length > DOTSTAR_MIN_LENGTH_FOR_SPI && isValidMOSIPin(data))\n spiDotStarSendData(data, clk, mode, buf, length);\n else\n bitBangDotStarSendData(data, clk, mode, buf, length);\n}\n\nvoid sendBuffer(DevicePin *data, DevicePin *clk, int mode, Buffer buf) {\n if (!data || !buf || !buf->length)\n return;\n\n if (mode == LIGHTMODE_DOTSTAR)\n light::dotStarSendData(data, clk, mode, buf->data, buf->length);\n else\n light::neopixelSendData(data, mode, buf->data, buf->length);\n}\n\nvoid clear() {\n auto neopix = LOOKUP_PIN(NEOPIXEL);\n auto neonum = getConfig(CFG_NUM_NEOPIXELS, 0);\n if (neopix && neonum >= 0) {\n auto n = 3 * neonum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n light::neopixelSendData(neopix, 0x100, off, sizeof(off));\n }\n\n auto data = LOOKUP_PIN(DOTSTAR_DATA);\n auto clk = LOOKUP_PIN(DOTSTAR_CLOCK);\n auto dsnum = getConfig(CFG_NUM_DOTSTARS, 0);\n if (data && clk && dsnum > 0) {\n auto n = 4 * dsnum;\n uint8_t off[n];\n memset(off, 0, sizeof(off));\n for (int i = 0; i < n; i += 4)\n off[i] = 0xe0;\n bitBangDotStarSendData(data, clk, 0x100, off, sizeof(off));\n }\n}\n\n} // namespace light\n",
"light.h": "#ifndef __PXT_LIGHT_H\n#define __PXT_LIGHT_H\n\n#include \"pxt.h\"\n\nnamespace light {\n /**\n * Clear onboard neopixels\n */\n void clear();\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //%\n void sendBuffer(DigitalInOutPin data, DigitalInOutPin clk, int mode, Buffer buf);\n\n void neopixelSendData(DevicePin* pin, int mode, const uint8_t* data, unsigned length);\n}\n\n#endif",
"ns.ts": "/**\n * Events and data from sensors.\n */\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\n//% groups='[\"other\", \"More\"]'\nnamespace input {\n}\n\n/**\n * Servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\"\nnamespace servos {\n\n}\n\n/**\n * A Joint Asynchronous Communications, Device Agnostic Control.\n */\n//% color=\"#E79251\" weight=1 icon=\"\\uf185\"\n//% groups='[\"Broadcast\", \"Console\", \"Control\"]'\n//% blockGap=8\nnamespace jacdac {\n\n}",
"pins.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\nstatic DevicePin **pinPtrs;\nstatic uint8_t numPinPtrs;\nstatic uint8_t pinPos[DEV_NUM_PINS];\n\n//%\nDevicePin *getPin(int id) {\n\n id &= CFG_PIN_NAME_MSK;\n\n if (id >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n\n // we could use lookupComponent() here - it would be slightly slower\n\n int ptr = pinPos[id];\n if (ptr == 0) {\n pinPtrs = (DevicePin **)realloc(pinPtrs, (numPinPtrs + 1) * sizeof(void *));\n bool isAnalog = IS_ANALOG_PIN(id);\n // GCTODO\n pinPtrs[numPinPtrs++] =\n new DevicePin(DEVICE_ID_IO_P0 + id, (PinName)id,\n isAnalog ? PIN_CAPABILITY_AD : PIN_CAPABILITY_DIGITAL);\n ptr = numPinPtrs;\n pinPos[id] = ptr;\n }\n return pinPtrs[ptr - 1];\n}\n\n//%\nDevicePin *getPinCfg(int key) {\n int p = getConfig(key, -1);\n if (p == -1)\n DMESG(\"no pin cfg: %d\", key);\n return getPin(p);\n}\n\nvoid linkPin(int from, int to) {\n if (from < 0 || from >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n getPin(to);\n pinPos[from] = pinPos[to];\n}\n\n//%\nDevicePin *lookupPin(int pinName) {\n if (pinName < 0 || pinName == 0xff)\n return NULL;\n pinName &= CFG_PIN_NAME_MSK;\n return getPin(pinName);\n}\n\n//%\nDevicePin *lookupPinCfg(int key) {\n return lookupPin(getConfig(key));\n}\n\nCodalComponent *lookupComponent(int id) {\n for (int i = 0; i < DEVICE_COMPONENT_COUNT; ++i) {\n if (CodalComponent::components[i] && CodalComponent::components[i]->id == id)\n return CodalComponent::components[i];\n }\n return NULL;\n}\n\n} // namespace pxt\n\nnamespace pins {\n/**\n* Get a pin by configuration id (DAL.CFG_PIN...)\n*/\n//%\nDigitalInOutPin pinByCfg(int key) {\n return pxt::lookupPinCfg(key);\n}\n\n/**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n//%\nBuffer createBuffer(int size) {\n return mkBuffer(NULL, size);\n}\n\n/**\n * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n//% help=pins/pulse-duration blockGap=8\n//% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n//% weight=19\nint pulseDuration() {\n return pxt::lastEvent.timestamp;\n}\n} // namespace pins\n",
"pins.h": "#ifndef __PXT_PINS_H\n#define __PXT_PINS_H\n\n#define BUTTON_ACTIVE_HIGH_PULL_DOWN (ACTIVE_HIGH | 0x10)\n#define BUTTON_ACTIVE_HIGH_PULL_UP (ACTIVE_HIGH | 0x20)\n#define BUTTON_ACTIVE_HIGH_PULL_NONE (ACTIVE_HIGH | 0x30)\n#define BUTTON_ACTIVE_LOW_PULL_DOWN (ACTIVE_LOW | 0x10)\n#define BUTTON_ACTIVE_LOW_PULL_UP (ACTIVE_LOW | 0x20)\n#define BUTTON_ACTIVE_LOW_PULL_NONE (ACTIVE_LOW | 0x30)\n\n#define PIN(name) ((PinName)pxt::getConfig(CFG_PIN_##name, -1))\n#define LOOKUP_PIN(name) pxt::lookupPin(PIN(name))\n\n// these can be overridden in platform.h\n#ifndef CODAL_PIN\n#define CODAL_PIN CODAL_MBED::Pin\n#endif\n\n#ifndef CODAL_TIMER\n#define CODAL_TIMER CODAL_MBED::Timer\n#endif\n\n#ifndef CODAL_SPI\n#define CODAL_SPI CODAL_MBED::SPI\n#endif\n\n#ifndef CODAL_SERIAL\n#define CODAL_SERIAL CODAL_MBED::Serial\n#endif\n\n#ifndef IS_ANALOG_PIN\n#define IS_ANALOG_PIN(id) ((DEV_ANALOG_PINS >> (id)) & 1)\n#endif\n\ntypedef CODAL_PIN DevicePin;\n\ntypedef DevicePin *DigitalInOutPin;\ntypedef DevicePin *AnalogInOutPin;\ntypedef DevicePin *AnalogInPin;\ntypedef DevicePin *AnalogOutPin;\ntypedef DevicePin *PwmPin;\ntypedef DevicePin *PwmOnlyPin;\ntypedef Button *Button_;\n\nnamespace pxt {\nDevicePin *getPin(int id);\nDevicePin *getPinCfg(int key);\nDevicePin *lookupPin(int pinName);\nDevicePin *lookupPinCfg(int key);\nvoid linkPin(int from, int to);\nCodalComponent *lookupComponent(int id);\n}\n\n#define PINOP(op) name->op\n\n#endif\n",
"pins.ts": "//% noRefCounting fixedInstances\ninterface DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogOutPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInOutPin extends AnalogInPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmOnlyPin extends DigitalInOutPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmPin extends PwmOnlyPin, AnalogInOutPin {\n}\n\n/**\n * Control currents in Pins for analog/digital signals, servos, i2c, ...\n */\n//% color=#A80000 weight=85 icon=\"\\uf140\" advanced=true\n//% groups='[\"other\", \"Servo\", \"i2c\"]'\nnamespace pins {\n}",
"pinsAnalog.cpp": "#include \"pxt.h\"\n\nnamespace AnalogInPinMethods {\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\n */\n//% help=pins/analog-read weight=53\n//% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nint analogRead(AnalogInPin name) {\n return PINOP(getAnalogValue());\n}\n}\n\nnamespace AnalogOutPinMethods {\nvoid analogWrite(AnalogOutPin name, int value) __attribute__ ((weak));\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\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n//% help=pins/analog-write weight=52\n//% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.min=0 value.max=1023\nvoid analogWrite(AnalogOutPin name, int value) {\n PINOP(setAnalogValue(value));\n}\n}",
"pinsDigital.cpp": "#include \"pxt.h\"\n\nenum class PulseValue {\n //% block=high\n High = DEVICE_PIN_EVT_PULSE_HI,\n //% block=low\n Low = DEVICE_PIN_EVT_PULSE_LO\n};\n\nenum class PinEvent {\n //% block=\"pulse high\"\n PulseHigh = DEVICE_PIN_EVT_PULSE_HI,\n //% block=\"pulse low\"\n PulseLow = DEVICE_PIN_EVT_PULSE_LO,\n //% block=\"rise\"\n Rise = DEVICE_PIN_EVT_RISE,\n //% block=\"fall\"\n Fall = DEVICE_PIN_EVT_FALL,\n};\n\nenum class PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2\n};\n\nnamespace DigitalInOutPinMethods {\n/**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n//% help=pins/digital-read weight=61\n//% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nbool digitalRead(DigitalInOutPin name) {\n return PINOP(getDigitalValue()) != 0;\n}\n\n/**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n//% help=pins/digital-write weight=60\n//% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid digitalWrite(DigitalInOutPin name, bool value) {\n PINOP(setDigitalValue(value));\n}\n\n/**\n* Make this pin a digital input, and create events where the timestamp is the duration\n* that this pin was either ``high`` or ``low``.\n*/\n//% help=pins/on-pulsed weight=16 blockGap=8\n//% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\n//% deprecated=1 hidden=1\nvoid onPulsed(DigitalInOutPin pin, PulseValue pulse, Action body) {\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)pulse, body);\n}\n\n/**\n* Register code to run when a pin event occurs. \n*/\n//% help=pins/on-event weight=20 blockGap=8\n//% blockId=pinsonevent block=\"on|pin %pin|%event\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nvoid onEvent(DigitalInOutPin pin, PinEvent event, Action body) {\n switch(event) {\n case PinEvent::PulseHigh:\n case PinEvent::PulseLow:\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)event, body);\n break;\n case PinEvent::Rise:\n case PinEvent::Fall:\n pin->eventOn(DEVICE_PIN_EVENT_ON_EDGE);\n registerWithDal(pin->id, (int)event, body);\n break; \n } \n}\n\n/**\n* Return the duration of a pulse in microseconds\n* @param name the pin which measures the pulse\n* @param value the value of the pulse (default high)\n* @param maximum duration in micro-seconds\n*/\n//% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n//% weight=18 blockGap=8\n//% help=\"pins/pulse-in\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nint pulseIn(DigitalInOutPin pin, PulseValue value, int maxDuration = 2000000) {\n int pulse = PulseValue::High == value ? 1 : 0;\n uint64_t tick = system_timer_current_time_us();\n uint64_t maxd = (uint64_t)maxDuration;\n while (pin->getDigitalValue() != pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n\n uint64_t start = system_timer_current_time_us();\n while (pin->getDigitalValue() == pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n uint64_t end = system_timer_current_time_us();\n return end - start;\n}\n\n/**\n* Set the pull direction of this pin.\n* @param name pin to set the pull mode on\n* @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n*/\n//% help=pins/set-pull weight=17 blockGap=8\n//% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid setPull(DigitalInOutPin name, PinPullMode pull) {\n PullMode m = pull == PinPullMode::PullDown ? PullMode::Down : pull == PinPullMode::PullUp\n ? PullMode::Up\n : PullMode::None;\n PINOP(setPull(m));\n}\n\n}\n\n#ifdef PXT_CODAL\n\nnamespace pxt {\n\nstatic void waitABit() {\n // for (int i = 0; i < 10; ++i)\n // asm volatile(\"nop\");\n}\n\nclass ButtonMultiplexer : public CodalComponent {\n public:\n Pin &latch;\n Pin &clock;\n Pin &data;\n uint32_t state;\n uint32_t invMask;\n uint16_t buttonIdPerBit[8];\n bool enabled;\n\n ButtonMultiplexer(uint16_t id)\n : latch(*LOOKUP_PIN(BTNMX_LATCH)), clock(*LOOKUP_PIN(BTNMX_CLOCK)),\n data(*LOOKUP_PIN(BTNMX_DATA)) {\n this->id = id;\n this->status |= DEVICE_COMPONENT_STATUS_SYSTEM_TICK;\n\n state = 0;\n invMask = 0;\n enabled = true;\n\n memset(buttonIdPerBit, 0, sizeof(buttonIdPerBit));\n\n data.getDigitalValue(PullMode::Down);\n latch.setDigitalValue(1);\n clock.setDigitalValue(1);\n }\n\n void disable() {\n data.getDigitalValue(PullMode::None);\n latch.getDigitalValue(PullMode::None);\n clock.getDigitalValue(PullMode::None);\n enabled = false;\n }\n\n bool isButtonPressed(int id) {\n for (int i = 0; i < 8; ++i) {\n if (buttonIdPerBit[i] == id)\n return (state & (1 << i)) != 0;\n }\n return false;\n }\n\n uint32_t readBits(int bits) {\n latch.setDigitalValue(0);\n waitABit();\n latch.setDigitalValue(1);\n waitABit();\n\n uint32_t state = 0;\n for (int i = 0; i < bits; i++) {\n state <<= 1;\n if (data.getDigitalValue(PullMode::Down))\n state |= 1;\n\n clock.setDigitalValue(0);\n waitABit();\n clock.setDigitalValue(1);\n waitABit();\n }\n\n return state;\n }\n\n virtual void periodicCallback() override {\n if (!enabled)\n return;\n\n uint32_t newState = readBits(8);\n newState ^= invMask;\n if (newState == state)\n return;\n\n for (int i = 0; i < 8; ++i) {\n uint32_t mask = 1 << i;\n if (!buttonIdPerBit[i])\n continue;\n int ev = 0;\n if (!(state & mask) && (newState & mask))\n ev = PXT_INTERNAL_KEY_DOWN;\n else if ((state & mask) && !(newState & mask))\n ev = PXT_INTERNAL_KEY_UP;\n if (ev) {\n Event(ev, buttonIdPerBit[i]);\n Event(ev, 0); // any key\n }\n }\n\n state = newState;\n }\n};\n\nstatic ButtonMultiplexer *btnMultiplexer;\nButtonMultiplexer *getMultiplexer() {\n if (!btnMultiplexer)\n btnMultiplexer = new ButtonMultiplexer(DEVICE_ID_FIRST_BUTTON);\n return btnMultiplexer;\n}\n\nint registerMultiplexedButton(int pin, int buttonId) {\n if (1050 <= pin && pin < 1058) {\n pin -= 50;\n getMultiplexer()->invMask |= 1 << (pin - 1000);\n }\n if (1000 <= pin && pin < 1008) {\n getMultiplexer()->buttonIdPerBit[pin - 1000] = buttonId;\n return 1;\n }\n return 0;\n}\n\nint multiplexedButtonIsPressed(int btnId) {\n if (btnMultiplexer)\n return btnMultiplexer->isButtonPressed(btnId) ? 512 : 0;\n return 0;\n}\n\n//% expose\nuint32_t readButtonMultiplexer(int bits) {\n if (!LOOKUP_PIN(BTNMX_CLOCK))\n return 0;\n return getMultiplexer()->readBits(bits);\n}\n\nvoid disableButtonMultiplexer() {\n if (LOOKUP_PIN(BTNMX_CLOCK)) {\n getMultiplexer()->disable();\n }\n}\n\n}\n\n#endif\n",
"pinsPWM.cpp": "#include \"pxt.h\"\n\nnamespace PwmPinMethods {\n}\n\nnamespace PwmOnlyPinMethods {\n\n/**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n//% help=pins/analog-set-period weight=51\n//% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid analogSetPeriod(PwmOnlyPin name, int period) {\n PINOP(setAnalogPeriodUs(period));\n}\n\n/**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n//% help=pins/servo-write weight=41 group=\"Servo\"\n//% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n//% parts=microservo trackArgs=0\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% value.defl=90\nvoid servoWrite(PwmOnlyPin name, int value) {\n PINOP(setServoValue(value));\n}\n\n/**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n//% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n//% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n//% parts=microservo blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid servoSetPulse(PwmOnlyPin name, int duration) {\n PINOP(setServoPulseUs(duration));\n}\n\n/**\n* Indicates if the servo is running continuously\n*/\n//% blockHidden=1\nvoid servoSetContinuous(PwmOnlyPin name, bool continuous) {\n // used by simulator\n}\n\n}",
"pinscompat.ts": "// filled in by microbit",
"platform.cpp": "#include \"pxt.h\"\n\n#include \"SAMDTCTimer.h\"\n#include \"SAMDTCCTimer.h\"\n#include \"light.h\"\n\nnamespace pxt {\n\nstruct TimerConfig {\n uint8_t id;\n uint8_t irq;\n uint8_t dmaovf;\n uint32_t addr;\n};\n\n#define DEF_TC(n) \\\n { 0x10 + n, TC##n##_IRQn, TC##n##_DMAC_ID_OVF, (uint32_t)TC##n }\n#ifdef SAMD21\n#define DEF_TCC(n) \\\n { 0x20 + n, TCC##n##_IRQn, TCC##n##_DMAC_ID_OVF, (uint32_t)TCC##n }\n#else\n#define DEF_TCC(n) \\\n { 0x20 + n, TCC##n##_0_IRQn, TCC##n##_DMAC_ID_OVF, (uint32_t)TCC##n }\n#endif\n\nstatic const TimerConfig timers[] = {\n#ifdef TC0\n DEF_TC(0),\n#endif\n#ifdef TC1\n DEF_TC(1),\n#endif\n#ifdef TC2\n DEF_TC(2),\n#endif\n#ifdef TC3\n DEF_TC(3),\n#endif\n#ifdef TC4\n DEF_TC(4),\n#endif\n#ifdef TC5\n DEF_TC(5),\n#endif\n\n#ifdef TCC0\n DEF_TCC(0),\n#endif\n#ifdef TCC1\n DEF_TCC(1),\n#endif\n#ifdef TCC2\n DEF_TCC(2),\n#endif\n\n {0, 0, 0, 0}};\n\n// Backlight:\n// Kitronik: PA6 TC1 (ch 0)\n// Adafruit: PA1 TC2 (ch 1)\n\n// TC3 is used by DAC on both D21 and D51\n// TCC0 and TC4 is used by IR\n// TCC0, TCC1, TC4 is used by PWM on CPX\n\n#ifdef SAMD21\n#define DEF_TIMERS 0x15222021 // TC5 TCC2 TCC0 TCC1\n#else\n#define DEF_TIMERS 0x10111200 // TC0 TC1 TC2\n#endif\n\nstatic uint32_t usedTimers;\nstatic int timerIdx(uint8_t id) {\n for (unsigned i = 0; timers[i].id; i++) {\n if (id == timers[i].id)\n return i;\n }\n return -1;\n}\nLowLevelTimer *allocateTimer() {\n uint32_t timersToUse = getConfig(CFG_TIMERS_TO_USE, DEF_TIMERS);\n uint8_t blTC = 0;\n // DAC hard-wired to TC3 right now\n uint8_t dacTC = 0x13;\n\n // if BL is on a known pin, don't use its PWM TC\n // this is a hack for legacy boards that don't have CFG_TIMERS_TO_USE\n auto blPin = PIN(DISPLAY_BL);\n if (blPin == PA01)\n blTC = 0x12;\n\n for (int shift = 24; shift >= 0; shift -= 8) {\n uint8_t tcId = (timersToUse >> shift) & 0xff;\n if (tcId == 0 || tcId == blTC || tcId == dacTC)\n continue;\n int idx = timerIdx(tcId);\n if (idx < 0 || (usedTimers & (1 << idx)))\n continue;\n LowLevelTimer *res;\n if (idx < 0x20) {\n Tc *tc = (Tc *)timers[idx].addr;\n if (tc->COUNT16.CTRLA.bit.ENABLE)\n continue;\n DMESG(\"allocate TC%d\", tcId & 0xf);\n res = new SAMDTCTimer(tc, timers[idx].irq);\n } else {\n Tcc *tcc = (Tcc *)timers[idx].addr;\n if (tcc->CTRLA.bit.ENABLE)\n continue;\n DMESG(\"allocate TCC%d\", tcId & 0xf);\n res = new SAMDTCCTimer(tcc, timers[idx].irq);\n }\n usedTimers |= 1 << idx;\n return res;\n }\n\n soft_panic(PANIC_OUT_OF_TIMERS);\n return NULL;\n}\n\nstatic void initRandomSeed() {\n int seed = 0xC0DA1;\n // TODO use TRNG\n seedRandom(seed);\n}\n\nvoid platformSendSerial(const char *data, int len) {}\n\n#ifdef SAMD21\nstatic void remapSwdPin(int pinCfg, int fallback) {\n int pinName = getConfig(pinCfg);\n if (pinName == PA30 || pinName == PA31) {\n if (getConfig(CFG_SWD_ENABLED, 0)) {\n linkPin(pinName, fallback);\n } else {\n PORT->Group[pinName / 32].PINCFG[pinName % 32].reg = (uint8_t)PORT_PINCFG_INEN;\n }\n }\n}\n\nstatic void initSwdPins() {\n remapSwdPin(CFG_PIN_NEOPIXEL, PIN(D0));\n remapSwdPin(CFG_PIN_RXLED, PIN(D1));\n remapSwdPin(CFG_PIN_SPEAKER_AMP, PIN(A2));\n}\n#else\nstatic void initSwdPins() {}\n#endif\n\nvoid platform_init() {\n initSwdPins();\n initRandomSeed();\n setSendToUART(platformSendSerial);\n light::clear();\n\n /*\n if (*HF2_DBG_MAGIC_PTR == HF2_DBG_MAGIC_START) {\n *HF2_DBG_MAGIC_PTR = 0;\n // this will cause alignment fault at the first breakpoint\n globals[0] = (TValue)1;\n }\n */\n}\n\nint *getBootloaderConfigData() {\n#ifdef SAMD51\n auto config_data = *(uint32_t *)(BOOTLOADER_END - 4 * 4);\n if (config_data && (config_data & 3) == 0 && config_data < BOOTLOADER_END) {\n auto p = (uint32_t *)config_data;\n if (p[0] == CFG_MAGIC0 && p[1] == CFG_MAGIC1)\n return (int *)p + 4;\n }\n#endif\n return NULL;\n}\n\n} // namespace pxt\n\nvoid cpu_clock_init() {}\n",
"platform.h": "#ifndef __PXT_PLATFORM_H\n#define __PXT_PLATFORM_H\n\n#include \"Image.h\"\n#include \"MultiButton.h\"\n#include \"ZPin.h\"\n#include \"Timer.h\"\n#include \"SAMDDAC.h\"\n#include \"ZSPI.h\"\n#include \"ZI2C.h\"\n#include \"ZSingleWireSerial.h\"\n#include \"SAMDNVM.h\"\n#include \"SAMDPDM.h\"\n#include \"SAMDSerial.h\"\n\n// cap touch not available on 51 yet\n#ifdef SAMD21\n#include \"CapTouchButton.h\"\n#endif\n\n#define MIC_DEVICE SAMD21PDM\n\n#ifdef SAMD21\n#define OUTPUT_BITS 10\n#else\n#define OUTPUT_BITS 12\n#endif\n\n#include \"pinmap.h\"\n\n#undef min\n#undef max\n\ntypedef int PinName;\n\n#define PAGE_SIZE 512\n\n#define BOOTLOADER_START 0x0\n\n#ifdef SAMD21\n#define BOOTLOADER_END 0x2000\n#endif\n\n#ifdef SAMD51\n#define BOOTLOADER_END 0x4000\n#endif\n\n#define USB_HANDOVER 0\n\n// if we ever want to support 100+ pin packages, need to add PC,PD ports and increase this to 128\n#ifdef SAMD51\n#define DEV_NUM_PINS 128\n#else\n#define DEV_NUM_PINS 64\n#endif\n\n#define IS_ANALOG_PIN(id) 1\n\n#define CODAL_PIN ZPin\n#define CODAL_TIMER Timer\n#define CODAL_SPI ZSPI\n#define CODAL_I2C ZI2C\n#define CODAL_JACDAC_WIRE_SERIAL codal::ZSingleWireSerial\n#define CODAL_SERIAL codal::SAMDSerial\n#define CODAL_DAC SAMDDAC\n\n#ifdef SAMD21\n#define CODAL_NVMCONTROLLER codal::SAMDNVM\n#endif\n\n#define PXT_74HC165 1\n\n#define IMAGE_BITS 4\n\n// The parameters below needs tuning!\n\n#define PA00 0\n#define PA01 1\n#define PA02 2\n#define PA03 3\n#define PA04 4\n#define PA05 5\n#define PA06 6\n#define PA07 7\n#define PA08 8\n#define PA09 9\n#define PA10 10\n#define PA11 11\n#define PA12 12\n#define PA13 13\n#define PA14 14\n#define PA15 15\n#define PA16 16\n#define PA17 17\n#define PA18 18\n#define PA19 19\n#define PA20 20\n#define PA21 21\n#define PA22 22\n#define PA23 23\n#define PA24 24\n#define PA25 25\n#define PA26 26\n#define PA27 27\n#define PA28 28\n#define PA29 29\n#define PA30 30\n#define PA31 31\n#define PB00 32\n#define PB01 33\n#define PB02 34\n#define PB03 35\n#define PB04 36\n#define PB05 37\n#define PB06 38\n#define PB07 39\n#define PB08 40\n#define PB09 41\n#define PB10 42\n#define PB11 43\n#define PB12 44\n#define PB13 45\n#define PB14 46\n#define PB15 47\n#define PB16 48\n#define PB17 49\n#define PB18 50\n#define PB19 51\n#define PB20 52\n#define PB21 53\n#define PB22 54\n#define PB23 55\n#define PB24 56\n#define PB25 57\n#define PB26 58\n#define PB27 59\n#define PB28 60\n#define PB29 61\n#define PB30 62\n#define PB31 63\n#define PC00 64\n#define PC01 65\n#define PC02 66\n#define PC03 67\n#define PC04 68\n#define PC05 69\n#define PC06 70\n#define PC07 71\n#define PC08 72\n#define PC09 73\n#define PC10 74\n#define PC11 75\n#define PC12 76\n#define PC13 77\n#define PC14 78\n#define PC15 79\n#define PC16 80\n#define PC17 81\n#define PC18 82\n#define PC19 83\n#define PC20 84\n#define PC21 85\n#define PC22 86\n#define PC23 87\n#define PC24 88\n#define PC25 89\n#define PC26 90\n#define PC27 91\n#define PC28 92\n#define PC29 93\n#define PC30 94\n#define PC31 95\n#define PD00 96\n#define PD01 97\n#define PD02 98\n#define PD03 99\n#define PD04 100\n#define PD05 101\n#define PD06 102\n#define PD07 103\n#define PD08 104\n#define PD09 105\n#define PD10 106\n#define PD11 107\n#define PD12 108\n#define PD13 109\n#define PD14 110\n#define PD15 111\n#define PD16 112\n#define PD17 113\n#define PD18 114\n#define PD19 115\n#define PD20 116\n#define PD21 117\n#define PD22 118\n#define PD23 119\n#define PD24 120\n#define PD25 121\n#define PD26 122\n#define PD27 123\n#define PD28 124\n#define PD29 125\n#define PD30 126\n#define PD31 127\n#endif\n",
"pxt.h": "#ifndef __PXT_H\n#define __PXT_H\n\n#include \"pxtbase.h\"\n\n#include \"CodalConfig.h\"\n#include \"CodalHeapAllocator.h\"\n#include \"CodalDevice.h\"\n#include \"CodalDmesg.h\"\n#include \"ErrorNo.h\"\n#include \"Timer.h\"\n#include \"Matrix4.h\"\n#include \"CodalCompat.h\"\n#include \"CodalComponent.h\"\n#include \"ManagedType.h\"\n#include \"Event.h\"\n#include \"NotifyEvents.h\"\n#include \"Button.h\"\n#include \"CodalFiber.h\"\n#include \"MessageBus.h\"\n#include \"MultiButton.h\"\n\nusing namespace codal;\n\n// codal::ManagedString compat\n#define MSTR(s) codal::ManagedString((s)->data, (s)->length)\n#define PSTR(s) mkString((s).toCharArray(), (s).length())\n\n#include \"pins.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"hf2.h\"\n#include \"hf2dbg.h\"\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n#include \"HIDMouse.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n#include \"HIDKeyboard.h\"\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n#include \"HIDJoystick.h\"\n#endif\n#endif\n\n#define PXT_COMM_BASE 0x20002000 // 8k in\n\nnamespace pxt {\n\n#if CONFIG_ENABLED(DEVICE_USB)\nextern CodalUSB usb;\nextern HF2 hf2;\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nextern USBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nextern USBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nextern USBHIDJoystick joystick;\n#endif\n#endif\n\n// Utility functions\nextern Event lastEvent;\nextern CODAL_TIMER devTimer;\nextern MessageBus devMessageBus;\nextern codal::CodalDevice device;\n\nvoid set_usb_strings(const char *uf2_info);\nextern void (*logJDFrame)(const uint8_t *data);\nextern void (*sendJDFrame)(const uint8_t *data);\n\nstatic inline void raiseEvent(int src, int val) {\n Event(src, val);\n}\n\n} // namespace pxt\n\nnamespace pins {\nclass CodalSPIProxy;\nclass CodalI2CProxy;\n} // namespace pins\n\ntypedef pins::CodalI2CProxy* I2C_;\ntypedef pins::CodalSPIProxy* SPI_;\n\nnamespace pxt {\ncodal::LowLevelTimer *allocateTimer();\n\n#ifdef CODAL_I2C\nCODAL_I2C* getI2C(DigitalInOutPin sda, DigitalInOutPin scl);\n#endif\nCODAL_SPI* getSPI(DigitalInOutPin mosi, DigitalInOutPin miso, DigitalInOutPin sck);\n#ifdef CODAL_JACDAC_WIRE_SERIAL\nLowLevelTimer* getJACDACTimer();\n#endif\nclass PressureButton;\nuint32_t readButtonMultiplexer(int bits);\nvoid disableButtonMultiplexer();\n}\n\nnamespace serial {\nclass CodalSerialDeviceProxy;\n}\n\ntypedef serial::CodalSerialDeviceProxy* SerialDevice;\n\nnamespace jacdac {\nclass JDProxyDriver;\n} // namespace network\n\ntypedef jacdac::JDProxyDriver* JacDacDriverStatus;\n\n#define DEVICE_ID_BUTTON_SLIDE 3000\n#define DEVICE_ID_MICROPHONE 3001\n#define DEVICE_ID_FIRST_BUTTON 4000\n#define DEVICE_ID_FIRST_TOUCHBUTTON 4100\n\n#define PXT_INTERNAL_KEY_UP 2050\n#define PXT_INTERNAL_KEY_DOWN 2051\n\n#endif\n",
"pxt.json": "{\n \"name\": \"core---samd\",\n \"description\": \"The core library for Codal-based targets\",\n \"dependencies\": {\n \"base\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"dal.d.ts\",\n \"codal.cpp\",\n \"usb.cpp\",\n \"pxt.h\",\n \"platform.h\",\n \"platform.cpp\",\n \"pxtcore.h\",\n \"pins.h\",\n \"pins.cpp\",\n \"pinsAnalog.cpp\",\n \"pinsDigital.cpp\",\n \"pinsPWM.cpp\",\n \"pins.ts\",\n \"pinscompat.ts\",\n \"control.cpp\",\n \"i2c.cpp\",\n \"i2c.ts\",\n \"spi.cpp\",\n \"spi.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"hf2.cpp\",\n \"hf2.h\",\n \"hf2dbg.h\",\n \"uf2format.h\",\n \"uf2hid.h\",\n \"ns.ts\",\n \"dmac.cpp\",\n \"dmac.h\",\n \"timer.ts\",\n \"light.cpp\",\n \"light.h\",\n \"keyvaluestorage.cpp\",\n \"keyvaluestorage.ts\",\n \"leveldetector.ts\",\n \"pxtparts.json\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"cppDependencies\": {\n \"accelerometer\": \"file:../accelerometer\",\n \"buttons\": \"file:../buttons\",\n \"game\": \"file:../game\",\n \"light\": \"file:../light\",\n \"lightsensor\": \"file:../lightsensor\",\n \"microphone\": \"file:../microphone\",\n \"screen---st7735\": \"file:../screen---st7735\",\n \"switch\": \"file:../switch\",\n \"thermometer\": \"file:../thermometer\",\n \"lcd\": \"file:../lcd\",\n \"mixer---samd\": \"file:../mixer---samd\"\n },\n \"yotta\": {\n \"config\": {\n \"codal\": {\n \"component_count\": 64,\n \"dmesg_buffer_size\": 1024\n }\n }\n },\n \"dalDTS\": {\n \"includeDirs\": [\n \"libraries/codal-core/inc\",\n \"pxtapp\"\n ],\n \"excludePrefix\": [\n \"JD_\",\n \"USB_\",\n \"REQUEST_\",\n \"LIS3DH_\",\n \"FXOS8700_\",\n \"HF2_\",\n \"PXT_REF_TAG_\",\n \"MS_\",\n \"SCSI_\",\n \"MAG_\",\n \"MAG3\",\n \"MPU6\",\n \"MADCTL\",\n \"MMA8\"\n ]\n }\n}\n",
"pxtcore.h": "#ifndef __PXTCORE_H\n#define __PXTCORE_H\n\n#include \"CodalDmesg.h\"\n#include \"CodalHeapAllocator.h\"\n\n#define PXT_CODAL 1\n\n#define itoa(a, b) codal::itoa(a, b)\n\n#define GC_GET_HEAP_SIZE() device_heap_size(0)\n#define GC_STACK_BASE DEVICE_STACK_BASE\n#define xmalloc device_malloc\n#define xfree device_free\n\n// on most devices we allocate the entire heap at once, so large allocs should work\n// if they don't you just get the regular out of memory instead of alloc too large\n#define GC_MAX_ALLOC_SIZE (128 * 1024)\n\n#endif\n",
"pxtparts.json": "{\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\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createStrip,light.createNeoPixelStrip\",\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 \"dotstar\": {\n \"simulationBehavior\": \"dotstar\",\n \"visual\": {\n \"builtIn\": \"dotstar\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 1\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createAPA102Strip\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"dataPin\"\n },\n {\n \"pinInstantiationIdx\": 1,\n \"partParameter\": \"clkPin\"\n },\n {\n \"partParameter\": \"mode\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n },\n \"pixels\": {\n \"simulationBehavior\": \"pixels\",\n \"visual\": { \n \"builtIn\": \"pixels\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"MOSI\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"SCK\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\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, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n }, \n \"buttons\": {\n \"simulationBehavior\": \"buttons\",\n \"visual\": {\n \"builtIn\": \"buttons\",\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 },\n \"numberOfPins\": 2,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"Button.onEvent,Button.isPressed,Button.wasPressed\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"button\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n }\n ]\n },\n \"slideswitch\": {\n \"numberOfPins\": 3,\n \"simulationBehavior\": \"slideswitch\",\n \"visual\": {\n \"builtIn\": \"slideswitch\",\n \"width\": 100,\n \"height\": 100,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 30,\n \"y\": 0\n },\n {\n \"x\": 45,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalRead,DigitalInOutPin.onPulsed,DigitalInOutPin.onEvent\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"pin\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\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 \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"PwmOnlyPin.servoWrite,servos.Servo.setAngle,servos.Servo.run,servos.Servo.setPulse\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\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 \"led\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"analogled\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogOutPin.analogWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"photocell\": {\n \"numberOfPins\": 3,\n \"visual\": {\n \"builtIn\": \"photocell\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 15,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"photocell\",\n \"pinDefinitions\": [\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogInPin.analogRead\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n }\n}",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace light {\n\n /**\n * Send a programmable light buffer to the specified digital pin\n * @param data The pin that the lights are connected to\n * @param clk the clock line if any\n * @param mode the color encoding mode\n * @param buf The buffer to send to the pin\n */\n //% shim=light::sendBuffer\n function sendBuffer(data: DigitalInOutPin, clk: DigitalInOutPin, mode: int32, buf: Buffer): void;\n}\ndeclare namespace control {\n\n /**\n * Determines if the USB has been enumerated.\n */\n //% shim=control::isUSBInitialized\n function isUSBInitialized(): boolean;\n}\ndeclare namespace pins {\n\n /**\n * Get a pin by configuration id (DAL.CFG_PIN...)\n */\n //% shim=pins::pinByCfg\n function pinByCfg(key: int32): DigitalInOutPin;\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 * Get the duration of the last pulse in microseconds. This function should be called from a\n * ``onPulsed`` handler.\n */\n //% help=pins/pulse-duration blockGap=8\n //% blockId=pins_pulse_duration block=\"pulse duration (µs)\"\n //% weight=19 shim=pins::pulseDuration\n function pulseDuration(): int32;\n}\n\n\ndeclare interface AnalogInPin {\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\n */\n //% help=pins/analog-read weight=53\n //% blockId=device_get_analog_pin block=\"analog read|pin %name\" blockGap=\"8\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=AnalogInPinMethods::analogRead\n analogRead(): int32;\n}\n\n\ndeclare interface AnalogOutPin {\n /**\n * Set the connector value as analog. Value must be comprised between 0 and 1023.\n * @param name pin name to write to\n * @param value value to write to the pin between ``0`` and ``1023``. eg:1023,0\n */\n //% help=pins/analog-write weight=52\n //% blockId=device_set_analog_pin block=\"analog write|pin %name|to %value\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.min=0 value.max=1023 shim=AnalogOutPinMethods::analogWrite\n analogWrite(value: int32): void;\n}\n\n\ndeclare interface DigitalInOutPin {\n /**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n //% help=pins/digital-read weight=61\n //% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalRead\n digitalRead(): boolean;\n\n /**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n //% help=pins/digital-write weight=60\n //% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalWrite\n digitalWrite(value: boolean): void;\n\n /**\n * Make this pin a digital input, and create events where the timestamp is the duration\n * that this pin was either ``high`` or ``low``.\n */\n //% help=pins/on-pulsed weight=16 blockGap=8\n //% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4\n //% deprecated=1 hidden=1 shim=DigitalInOutPinMethods::onPulsed\n onPulsed(pulse: PulseValue, body: () => void): void;\n\n /**\n * Register code to run when a pin event occurs. \n */\n //% help=pins/on-event weight=20 blockGap=8\n //% blockId=pinsonevent block=\"on|pin %pin|%event\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 shim=DigitalInOutPinMethods::onEvent\n onEvent(event: PinEvent, body: () => void): void;\n\n /**\n * Return the duration of a pulse in microseconds\n * @param name the pin which measures the pulse\n * @param value the value of the pulse (default high)\n * @param maximum duration in micro-seconds\n */\n //% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n //% weight=18 blockGap=8\n //% help=\"pins/pulse-in\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 maxDuration.defl=2000000 shim=DigitalInOutPinMethods::pulseIn\n pulseIn(value: PulseValue, maxDuration?: int32): int32;\n\n /**\n * Set the pull direction of this pin.\n * @param name pin to set the pull mode on\n * @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n */\n //% help=pins/set-pull weight=17 blockGap=8\n //% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::setPull\n setPull(pull: PinPullMode): void;\n}\n\n\ndeclare interface PwmPin {}\n\n\ndeclare interface PwmOnlyPin {\n /**\n * Set the Pulse-width modulation (PWM) period of the analog output. The period is in\n * **microseconds** or `1/1000` milliseconds.\n * If this pin is not configured as an analog output (using `analog write pin`), the operation has\n * no effect.\n * @param name analog pin to set period to\n * @param micros period in micro seconds. eg:20000\n */\n //% help=pins/analog-set-period weight=51\n //% blockId=device_set_analog_period block=\"analog set period|pin %pin|to (µs)%period\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::analogSetPeriod\n analogSetPeriod(period: int32): void;\n\n /**\n * Write a value to the servo to control the rotation of the shaft. On a standard servo, this will\n * set the angle of the shaft (in degrees), moving the shaft to that orientation. On a continuous\n * rotation servo, this will set the speed of the servo (with ``0`` being full-speed in one\n * direction, ``180`` being full speed in the other, and a value near ``90`` being no movement).\n * @param name pin to write to\n * @param value angle or rotation speed\n */\n //% help=pins/servo-write weight=41 group=\"Servo\"\n //% blockId=device_set_servo_pin block=\"servo write|pin %name|to %value=protractorPicker\" blockGap=8\n //% parts=microservo trackArgs=0\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% value.defl=90 shim=PwmOnlyPinMethods::servoWrite\n servoWrite(value?: int32): void;\n\n /**\n * Set the pin for PWM analog output, make the period be 20 ms, and set the pulse width.\n * The pulse width is based on the value it is given **microseconds** or `1/1000` milliseconds.\n * @param name pin name\n * @param duration pulse duration in micro seconds, eg:1500\n */\n //% help=pins/servo-set-pulse weight=40 group=\"Servo\" blockGap=8\n //% blockId=device_set_servo_pulse block=\"servo set pulse|pin %value|to (µs) %duration\"\n //% parts=microservo blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=PwmOnlyPinMethods::servoSetPulse\n servoSetPulse(duration: int32): void;\n\n /**\n * Indicates if the servo is running continuously\n */\n //% blockHidden=1 shim=PwmOnlyPinMethods::servoSetContinuous\n servoSetContinuous(continuous: boolean): void;\n}\ndeclare namespace control {\n\n /**\n * Announce that an event happened to registered handlers.\n * @param src ID of the MicroBit Component that generated the event\n * @param value Component specific code indicating the cause of the event.\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\"\n //% help=control/raise-event\n //% block=\"raise event|from %src|with value %value\" blockExternalInputs=1 shim=control::raiseEvent\n function raiseEvent(src: int32, value: int32): void;\n\n /**\n * Determine the version of system software currently running.\n */\n //% blockId=\"control_device_dal_version\" block=\"device dal version\"\n //% help=control/device-dal-version shim=control::deviceDalVersion\n function deviceDalVersion(): string;\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}\n\n\ndeclare interface I2C {\n /**\n * Read `size` bytes from a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::readBuffer\n readBuffer(address: int32, size: int32, repeat?: boolean): Buffer;\n\n /**\n * Write bytes to a 7-bit I2C `address`.\n */\n //% repeat.defl=0 shim=I2CMethods::writeBuffer\n writeBuffer(address: int32, buf: Buffer, repeat?: boolean): int32;\n}\ndeclare namespace pins {\n\n /**\n * Opens a Serial communication driver\n */\n //% help=pins/create-i2c\n //% parts=i2c shim=pins::createI2C\n function createI2C(sda: DigitalInOutPin, scl: DigitalInOutPin): I2C;\n}\ndeclare namespace pins {\n\n /**\n * Opens a SPI driver\n */\n //% help=pins/create-spi\n //% parts=spi shim=pins::createSPI\n function createSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin): SPI;\n\n /**\n * Opens a slave SPI driver\n */\n //% parts=spi shim=pins::createSlaveSPI\n function createSlaveSPI(mosiPin: DigitalInOutPin, misoPin: DigitalInOutPin, sckPin: DigitalInOutPin, csPin: DigitalInOutPin): SPI;\n}\n\n\ndeclare interface SPI {\n /**\n * Write to the SPI bus\n */\n //% shim=SPIMethods::write\n write(value: int32): int32;\n\n /**\n * Transfer buffers over the SPI bus\n */\n //% argsNullable shim=SPIMethods::transfer\n transfer(command: Buffer, response: Buffer): void;\n\n /**\n * Sets the SPI clock frequency\n */\n //% shim=SPIMethods::setFrequency\n setFrequency(frequency: int32): void;\n\n /**\n * Sets the SPI bus mode\n */\n //% shim=SPIMethods::setMode\n setMode(mode: int32): void;\n}\ndeclare namespace configStorage {\n\n /**\n * Puts an entry in the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n * @param value the data (max 32 characters)\n */\n //% shim=configStorage::setBuffer\n function setBuffer(key: string, value: Buffer): void;\n\n /**\n * Gets an entry from the device storage. Key may have up to 16 characters (bytes).\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::getBuffer\n function getBuffer(key: string): Buffer;\n\n /**\n * Removes the key from local storage\n * @param key the identifier (max 16 characters)\n */\n //% shim=configStorage::removeItem\n function removeItem(key: string): void;\n\n /**\n * Clears the local storage\n */\n //% shim=configStorage::clear\n function clear(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"spi.cpp": "#include \"pxt.h\"\n#include \"ErrorNo.h\"\n\nnamespace pins {\n\nclass CodalSPIProxy {\nprivate:\n DevicePin* mosi; \n DevicePin* miso; \n DevicePin* sck;\n CODAL_SPI spi;\npublic:\n CodalSPIProxy* next;\n\npublic:\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck) \n , next(NULL)\n {\n }\n\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n CodalSPIProxy(DevicePin* _mosi, DevicePin* _miso, DevicePin* _sck, DevicePin* _cs)\n : mosi(_mosi)\n , miso(_miso)\n , sck(_sck)\n , spi(*_mosi, *_miso, *_sck, _cs) \n , next(NULL)\n {\n }\n#endif\n\n CODAL_SPI* getSPI() {\n return &spi;\n }\n\n bool matchPins(DevicePin* mosi, DevicePin* miso, DevicePin* sck) {\n return this->mosi == mosi && this->miso == miso && this->sck == sck;\n }\n\n int write(int value) {\n return spi.write(value);\n }\n\n void transfer(Buffer command, Buffer response) {\n auto cdata = NULL == command ? NULL : command->data;\n auto clength = NULL == command ? 0 : command->length;\n auto rdata = NULL == response ? NULL : response->data;\n auto rlength = NULL == response ? 0 : response->length;\n spi.transfer(cdata, clength, rdata, rlength);\n }\n\n void setFrequency(int frequency) {\n spi.setFrequency(frequency);\n }\n\n void setMode(int mode) {\n spi.setMode(mode);\n }\n};\n\nSPI_ spis(NULL);\n\n/**\n* Opens a SPI driver\n*/\n//% help=pins/create-spi\n//% parts=spi\nSPI_ createSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto dev = spis;\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin);\n ser->next = spis;\n spis = ser;\n return ser;\n}\n\n/**\n* Opens a slave SPI driver\n*/\n//% parts=spi\nSPI_ createSlaveSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin, DigitalInOutPin csPin) {\n#ifdef CODAL_SPI_SLAVE_SUPPORTED\n auto dev = spis;\n if (!csPin)\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n while(dev) {\n if (dev->matchPins(mosiPin, misoPin, sckPin))\n return dev;\n dev = dev->next;\n }\n\n auto ser = new CodalSPIProxy(mosiPin, misoPin, sckPin, csPin);\n ser->next = spis;\n spis = ser;\n return ser;\n#else\n soft_panic(PANIC_CODAL_HARDWARE_CONFIGURATION_ERROR);\n return NULL;\n#endif\n}\n\n}\n\nnamespace pxt {\n\nCODAL_SPI* getSPI(DigitalInOutPin mosiPin, DigitalInOutPin misoPin, DigitalInOutPin sckPin) {\n auto spi = pins::createSPI(mosiPin, misoPin, sckPin);\n return spi->getSPI();\n}\n\n}\n\nnamespace SPIMethods {\n\n/**\n* Write to the SPI bus\n*/\n//%\nint write(SPI_ device, int value) {\n return device->write(value);\n}\n\n/**\n* Transfer buffers over the SPI bus\n*/\n//% argsNullable\nvoid transfer(SPI_ device, Buffer command, Buffer response) {\n if (!device)\n soft_panic(PANIC_CAST_FROM_NULL);\n if (!command && !response)\n return;\n device->transfer(command, response);\n}\n\n/**\n* Sets the SPI clock frequency\n*/\n//%\nvoid setFrequency(SPI_ device, int frequency) {\n device->setFrequency(frequency);\n}\n\n/**\n* Sets the SPI bus mode\n*/\n//%\nvoid setMode(SPI_ device, int mode) {\n device->setMode(mode);\n}\n\n}\n",
"spi.ts": "namespace pins {\n\n let _spi: SPI;\n /**\n * Gets the default SPI driver\n */\n //%\n export function spi() {\n if (!_spi) {\n const mosi = pins.pinByCfg(DAL.CFG_PIN_MOSI);\n const miso = pins.pinByCfg(DAL.CFG_PIN_MISO);\n const sck = pins.pinByCfg(DAL.CFG_PIN_SCK);\n _spi = pins.createSPI(mosi, miso, sck);\n }\n return _spi;\n }\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 weight=5 advanced=true\n //% blockId=spi_write block=\"spi write %value\"\n export function spiWrite(value: number) {\n return spi().write(value);\n }\n\n /**\n * Write a given command to SPI bus, and at the same time read the response.\n */\n //% help=pins/spi-transfer weight=4 advanced=true\n //% blockId=spi_transfer block=\"spi transfer %command into %response\"\n export function spiTransfer(command: Buffer, response: Buffer) {\n spi().transfer(command, response);\n }\n\n /**\n * Set the SPI frequency\n * @param frequency the clock frequency, eg: 1000000\n */\n //% help=pins/spi-frequency weight=4 advanced=true\n //% blockId=spi_frequency block=\"spi frequency %frequency\"\n export function spiFrequency(frequency: number) {\n spi().setFrequency(frequency);\n }\n\n /**\n * Set the SPI signal mode\n * @param mode the mode, eg: 3\n */\n //% help=pins/spi-mode weight=3 advanced=true\n //% blockId=spi_mode block=\"spi mode %mode\"\n export function spiMode(mode: number) {\n spi().setMode(mode);\n }\n}",
"test.ts": "let i = 1\nlet f = 0.5\nlet plus = i + f\nlet minus = i - f\n\nlet r = Math.random()\nlet ri = Math.randomRange(5, 10)\n\n",
"timer.ts": "namespace control {\n /**\n * A timer\n */\n //% fixedInstances\n export class Timer {\n start: number;\n\n constructor() {\n this.start = control.millis();\n }\n\n /**\n * Gets the elapsed time in millis since the last reset\n */\n //% blockId=timerMillis block=\"%timer|millis\"\n millis(): number {\n return control.millis() - this.start;\n }\n\n /**\n * Gets the elapsed time in seconds since the last reset\n */\n //% blockId=timerSeconds block=\"%timer|seconds\"\n seconds(): number {\n return this.millis() / 1000;\n }\n\n /**\n * Resets the timer\n */\n //% blockId=timerRest block=\"%timer|reset\"\n reset() {\n this.start = control.millis();\n }\n\n /**\n * Pauses until the timer reaches the given amount of milliseconds\n * @param ms how long to pause for, eg: 5, 100, 200, 500, 1000, 2000\n */\n //% blockId=timerPauseUntil block=\"%timer|pause until (ms) %ms\"\n pauseUntil(ms: number) {\n const remaining = this.millis() - ms;\n pause(Math.max(0, remaining));\n }\n }\n\n //% whenUsed fixedInstance block=\"timer 1\"\n export const timer1 = new Timer();\n //% whenUsed fixedInstance block=\"timer 2\"\n export const timer2 = new Timer();\n //% whenUsed fixedInstance block=\"timer 3\"\n export const timer3 = new Timer();\n //% whenUsed fixedInstance block=\"timer 4\"\n export const timer4 = new Timer();\n //% whenUsed fixedInstance block=\"timer 5\"\n export const timer5 = new Timer();\n //% whenUsed fixedInstance block=\"timer 6\"\n export const timer6 = new Timer();\n //% whenUsed fixedInstance block=\"timer 7\"\n export const timer7 = new Timer();\n //% whenUsed fixedInstance block=\"timer 8\"\n export const timer8 = new Timer();\n}",
"uf2format.h": "#ifndef UF2FORMAT_H\n#define UF2FORMAT_H 1\n\n#include \n#include \n\n// All entries are little endian.\n\n#ifndef BOOTLOADER_START\n#define BOOTLOADER_START 0x0\n#endif\n\n#ifndef BOOTLOADER_END\n#define BOOTLOADER_END 0x2000\n#endif\n\n#ifndef UF2_BINFO\n#define UF2_BINFO ((UF2_BInfo *)(BOOTLOADER_END - sizeof(UF2_BInfo)))\n#endif\n\n#ifndef UF2_INFO_TXT\n#define UF2_INFO_TXT UF2_BINFO->info_uf2\n#endif\n\n\n#define UF2_MAGIC_START0 0x0A324655UL // \"UF2\\n\"\n#define UF2_MAGIC_START1 0x9E5D5157UL // Randomly selected\n#define UF2_MAGIC_END 0x0AB16F30UL // Ditto\n\n// If set, the block is \"comment\" and should not be flashed to the device\n#define UF2_FLAG_NOFLASH 0x00000001\n\ntypedef struct {\n // 32 byte header\n uint32_t magicStart0;\n uint32_t magicStart1;\n uint32_t flags;\n uint32_t targetAddr;\n uint32_t payloadSize;\n uint32_t blockNo;\n uint32_t numBlocks;\n uint32_t reserved;\n\n // raw data;\n uint8_t data[476];\n\n // store magic also at the end to limit damage from partial block reads\n uint32_t magicEnd;\n} UF2_Block;\n\ntypedef struct {\n uint8_t version;\n uint8_t ep_in;\n uint8_t ep_out;\n uint8_t reserved0;\n uint32_t cbw_tag;\n uint32_t blocks_remaining;\n uint8_t *buffer;\n} UF2_HandoverArgs;\n\ntypedef void (*UF2_MSC_Handover_Handler)(UF2_HandoverArgs *handover);\ntypedef void (*UF2_HID_Handover_Handler)(int ep);\n\n// this is required to be exactly 16 bytes long by the linker script\ntypedef struct {\n void *reserved0;\n UF2_HID_Handover_Handler handoverHID;\n UF2_MSC_Handover_Handler handoverMSC;\n const char *info_uf2;\n} UF2_BInfo;\n\nstatic inline bool is_uf2_block(void *data) {\n UF2_Block *bl = (UF2_Block *)data;\n return bl->magicStart0 == UF2_MAGIC_START0 && bl->magicStart1 == UF2_MAGIC_START1 &&\n bl->magicEnd == UF2_MAGIC_END;\n}\n\nstatic inline bool in_uf2_bootloader_space(const void *addr) {\n return (BOOTLOADER_START + 0x100) <= (uint32_t)addr && (uint32_t)addr < (BOOTLOADER_END);\n}\n\nstatic inline const char *uf2_info(void) {\n if (in_uf2_bootloader_space(UF2_INFO_TXT))\n return UF2_INFO_TXT;\n return \"N/A\";\n}\n\n#ifdef UF2_DEFINE_HANDOVER\nstatic inline void hf2_handover(uint8_t ep) {\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_HID_Handover_Handler fn = UF2_BINFO->handoverHID;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n // Pass control to bootloader; never returns\n fn(ep & 0xf);\n }\n}\n\nstatic inline void check_uf2_handover(uint8_t *buffer, uint32_t blocks_remaining, uint8_t ep_in,\n uint8_t ep_out, uint32_t cbw_tag) {\n if (!is_uf2_block(buffer))\n return;\n\n const char *board_info = UF2_BINFO->info_uf2;\n UF2_MSC_Handover_Handler fn = UF2_BINFO->handoverMSC;\n\n if (in_uf2_bootloader_space(board_info) && in_uf2_bootloader_space((const void *)fn) &&\n ((uint32_t)fn & 1)) {\n UF2_HandoverArgs hand = {\n 1, ep_in, ep_out, 0, cbw_tag, blocks_remaining, buffer,\n };\n // Pass control to bootloader; never returns\n fn(&hand);\n }\n}\n#endif\n\n#endif\n",
"uf2hid.h": "#ifndef UF2_HID_H\n#define UF2_HID_H 1\n\n#define HF2_CMD_BININFO 0x0001\n// no arguments\n#define HF2_MODE_BOOTLOADER 0x01\n#define HF2_MODE_USERSPACE 0x02\nstruct HF2_BININFO_Result {\n uint32_t mode;\n uint32_t flash_page_size;\n uint32_t flash_num_pages;\n uint32_t max_message_size;\n uint32_t uf2_family;\n};\n\n#define HF2_CMD_INFO 0x0002\n// no arguments\n// results is utf8 character array\n\n#define HF2_CMD_RESET_INTO_APP 0x0003\n// no arguments, no result\n\n#define HF2_CMD_RESET_INTO_BOOTLOADER 0x0004\n// no arguments, no result\n\n#define HF2_CMD_START_FLASH 0x0005\n// no arguments, no result\n\n#define HF2_CMD_WRITE_FLASH_PAGE 0x0006\nstruct HF2_WRITE_FLASH_PAGE_Command {\n uint32_t target_addr;\n uint32_t data[0];\n};\n// no result\n\n#define HF2_CMD_CHKSUM_PAGES 0x0007\nstruct HF2_CHKSUM_PAGES_Command {\n uint32_t target_addr;\n uint32_t num_pages;\n};\nstruct HF2_CHKSUM_PAGES_Result {\n uint16_t chksums[0 /* num_pages */];\n};\n\n#define HF2_CMD_READ_WORDS 0x0008\nstruct HF2_READ_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n};\nstruct HF2_READ_WORDS_Result {\n uint32_t words[0 /* num_words */];\n};\n\n#define HF2_CMD_WRITE_WORDS 0x0009\nstruct HF2_WRITE_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n uint32_t words[0 /* num_words */];\n};\n// no result\n\n#define HF2_CMD_DMESG 0x0010\n// no arguments\n// results is utf8 character array\n\n#define HF2_EV_MASK 0x800000\n\n#define HF2_CMD_JDS_CONFIG 0x0020\n#define HF2_CMD_JDS_SEND 0x0021\n#define HF2_EV_JDS_PACKET 0x800020\n\ntypedef struct {\n uint32_t command_id;\n uint16_t tag;\n uint8_t reserved0;\n uint8_t reserved1;\n\n union {\n struct HF2_WRITE_FLASH_PAGE_Command write_flash_page;\n struct HF2_WRITE_WORDS_Command write_words;\n struct HF2_READ_WORDS_Command read_words;\n struct HF2_CHKSUM_PAGES_Command chksum_pages;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Command;\n\ntypedef struct {\n union {\n uint32_t eventId;\n struct {\n uint16_t tag;\n union {\n struct {\n uint8_t status;\n uint8_t status_info;\n };\n uint16_t status16;\n };\n };\n };\n union {\n struct HF2_BININFO_Result bininfo;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Response;\n\n#define HF2_FLAG_SERIAL_OUT 0x80\n#define HF2_FLAG_SERIAL_ERR 0xC0\n#define HF2_FLAG_CMDPKT_LAST 0x40\n#define HF2_FLAG_CMDPKT_BODY 0x00\n#define HF2_FLAG_MASK 0xC0\n#define HF2_SIZE_MASK 63\n\n#define HF2_STATUS_OK 0x00\n#define HF2_STATUS_INVALID_CMD 0x01\n#define HF2_STATUS_INVALID_STATE 0x02\n\n#endif\n",
"usb.cpp": "#include \"pxt.h\"\n\n#if CONFIG_ENABLED(DEVICE_USB)\n#include \"uf2format.h\"\n\nnamespace pxt {\nCodalUSB usb;\n\n// share the buffer; we will crash anyway if someone talks to us over both at the same time\nHF2_Buffer hf2buf;\nHF2 hf2(hf2buf);\n#ifdef HF2_HID\nHF2 hf2hid(hf2buf);\n#endif\nDummyIface dummyIface;\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\nUSBHIDMouse mouse;\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\nUSBHIDKeyboard keyboard;\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\nUSBHIDJoystick joystick;\n#endif\n\nstatic const DeviceDescriptor device_desc = {\n 0x12, // bLength\n 0x01, // bDescriptorType\n 0x0210, // bcdUSBL\n\n // Class etc specified per-interface\n 0x00, 0x00, 0x00,\n\n 0x40, // bMaxPacketSize0\n USB_DEFAULT_VID, USB_DEFAULT_PID,\n 0x4202, // bcdDevice - leave unchanged for the HF2 to work\n 0x01, // iManufacturer\n 0x02, // iProduct\n 0x03, // SerialNumber\n 0x01 // bNumConfigs\n};\n\nstatic void start_usb() {\n // start USB with a delay, so that user code can add new interfaces if needed\n // (eg USB HID keyboard, or MSC)\n fiber_sleep(500);\n usb.start();\n}\n\nvoid platform_usb_init() __attribute__((weak));\nvoid platform_usb_init() {}\n\nvoid set_usb_strings(const char *uf2_info) {\n static const char *string_descriptors[3];\n static char serial[12];\n itoa(target_get_serial() & 0x7fffffff, serial);\n\n auto model = strstr(uf2_info, \"Model: \");\n if (model) {\n model += 7;\n auto end = model;\n while (*end && *end != '\\n' && *end != '\\r')\n end++;\n auto len = end - model;\n auto dev = (char *)app_alloc(len + 10);\n memcpy(dev, model, len);\n strcpy(dev + len, \" (app)\");\n // try to split into manufacturer and\n auto sep = strstr(dev, \" / \");\n if (sep) {\n *sep = '\\0';\n string_descriptors[0] = dev;\n string_descriptors[1] = sep + 3;\n } else {\n string_descriptors[0] = dev;\n string_descriptors[1] = dev;\n }\n } else {\n string_descriptors[0] = \"Unknown Corp.\";\n string_descriptors[1] = \"PXT Device (app)\";\n }\n\n string_descriptors[2] = serial;\n usb.stringDescriptors = string_descriptors;\n}\n\nvoid usb_init() {\n usb.deviceDescriptor = &device_desc;\n set_usb_strings(UF2_INFO_TXT);\n\n platform_usb_init();\n\n usb.add(hf2);\n\n#ifdef HF2_HID\n hf2hid.useHID = true;\n usb.add(hf2hid);\n#else\n // the WINUSB descriptors don't seem to work if there's only one interface\n // so we add a dummy interface\n usb.add(dummyIface);\n#endif\n\n#if CONFIG_ENABLED(DEVICE_MOUSE)\n usb.add(mouse);\n#endif\n#if CONFIG_ENABLED(DEVICE_KEYBOARD)\n usb.add(keyboard);\n#endif\n#if CONFIG_ENABLED(DEVICE_JOYSTICK)\n usb.add(joystick);\n#endif\n\n create_fiber(start_usb);\n}\n\n} // namespace pxt\n\n#else\nnamespace pxt {\nvoid usb_init() {}\n} // namespace pxt\n#endif\n\nnamespace control {\n/**\n * Determines if the USB has been enumerated.\n */\n//%\nbool isUSBInitialized() {\n#if CONFIG_ENABLED(DEVICE_USB)\n return pxt::usb.isInitialised();\n#else\n return false;\n#endif\n}\n} // namespace control\n\nnamespace pxt {\nstatic void (*pSendToUART)(const char *data, int len) = NULL;\nvoid setSendToUART(void (*f)(const char *, int)) {\n pSendToUART = f;\n}\n\nvoid sendSerial(const char *data, int len) {\n#if CONFIG_ENABLED(DEVICE_USB)\n hf2.sendSerial(data, len);\n#if HF2_HID\n hf2hid.sendSerial(data, len);\n#endif\n#endif\n if (pSendToUART)\n pSendToUART(data, len);\n}\n\nvoid dumpDmesg() {\n sendSerial(\"\\nDMESG:\\n\", 8);\n sendSerial(codalLogStore.buffer, codalLogStore.ptr);\n sendSerial(\"\\n\\n\", 2);\n}\n\nvoid (*logJDFrame)(const uint8_t *data);\nvoid (*sendJDFrame)(const uint8_t *data);\n\n} // namespace pxt\n"
},
"core---esp32": {
"CMakeLists.txt": "cmake_minimum_required(VERSION 3.5)\n\ninclude($ENV{IDF_PATH}/tools/cmake/project.cmake)\n\nproject(pxtapp)\n",
"Makefile": "all: certs/ca-bundle.pem\n\tLC_ALL=C.UTF-8 idf.py build\n\tbase64 build/pxtapp.bin > build/pxtapp.b64\n\ninclude certs.mk\n",
"README.md": "# core\n\nThe core library for Codal-based targets.\n\n",
"certs.mk": "certs/ca-bundle.pem:\n\tmkdir -p certs\n\tcurl https://raw.githubusercontent.com/microsoft/pxt-common-packages/9e8fdb8fd6e21c096f1fe2340652473ddab05d7e/libs/wifi---esp32/ca-bundle.pem > $@\n",
"codalemu.cpp": "#include \"pxt.h\"\n\nIRAM_ATTR void target_wait_us(uint32_t us) {\n int64_t later = esp_timer_get_time() + us;\n while (esp_timer_get_time() < later) {\n ;\n }\n}\n\nstatic portMUX_TYPE global_int_mux = portMUX_INITIALIZER_UNLOCKED;\nint int_level;\n\nIRAM_ATTR void target_disable_irq() {\n vPortEnterCritical(&global_int_mux);\n int_level++;\n}\n\nIRAM_ATTR void target_enable_irq() {\n int_level--;\n vPortExitCritical(&global_int_mux);\n}\n",
"config.cpp": "\n",
"control.cpp": "#include \"pxt.h\"\n\nnamespace control {\n\n/**\n * Announce that an event happened to registered handlers.\n * @param src ID of the Component that generated the event\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.\n */\n//% weight=21 blockGap=12 blockId=\"control_raise_event\"\n//% block=\"raise event|from %src|with value %value\" blockExternalInputs=1\n//% help=control/raise-event\nvoid raiseEvent(int src, int value) {\n pxt::raiseEvent(src, value);\n}\n\n/**\n* Allocates the next user notification event\n*/\n//% help=control/allocate-notify-event\nint allocateNotifyEvent() {\n return pxt::allocateNotifyEvent();\n}\n\n/**\n* Determine the version of system software currently running.\n*/\n//% blockId=\"control_device_dal_version\" block=\"device dal version\"\n//% help=control/device-dal-version\nString deviceDalVersion() {\n#ifdef PXT_VM\n return mkString(\"vm\");\n#else\n return mkString(\"linux\");\n#endif\n}\n\n\n/** Write data to DMESG debugging buffer. */\n//%\nvoid dmesg(String s) {\n DMESG(\"# %s\", s->getUTF8Data());\n}\n\n//%\nuint32_t _ramSize()\n{\n#ifdef POKY\n return 128 * 1024;\n#else\n // a lot! doesn't really matter how much\n return 16 * 1024 * 1024;\n#endif\n}\n\n/**\n * Determines if the USB has been enumerated.\n */\n//%\nbool isUSBInitialized() {\n return false;\n}\n\n}\n\nnamespace serial {\n /** Send DMESG debug buffer over serial. */\n //%\n void writeDmesg() {\n pxt::dumpDmesg();\n }\n}",
"crypto.cpp": "#include \"pxt.h\"\n#include \"mbedtls/sha256.h\"\n\n// https://eprint.iacr.org/2012/156.pdf - in case more hash functions are needed\n\nnamespace crypto {\n\n/*\n * Compute cryptographic SHA256 hash of the concatenation of buffers. Returns 32-byte buffer.\n */\n//% promise\nBuffer _sha256(RefCollection *buffers) {\n mbedtls_sha256_context sha256_ctx;\n uint8_t output[32];\n\n auto bufs = buffers->getData();\n auto len = buffers->length();\n\n mbedtls_sha256_init(&sha256_ctx);\n mbedtls_sha256_starts_ret(&sha256_ctx, false);\n\n while (len--) {\n if (BoxedBuffer::isInstance(*bufs)) {\n auto buf = (BoxedBuffer *)*bufs;\n mbedtls_sha256_update_ret(&sha256_ctx, buf->data, buf->length);\n }\n bufs++;\n }\n\n mbedtls_sha256_finish_ret(&sha256_ctx, output);\n\n return mkBuffer(output, sizeof(output));\n}\n\n} // namespace crypto",
"crypto.ts": "namespace crypto {\n /**\n * Compute cryptographic SHA256 hash of the concatenation of buffers. Returns 32-byte buffer.\n */\n //% promise shim=crypto::_sha256\n export declare function sha256(buffers: Buffer[]): Buffer;\n\n\n /**\n * Compute keyed-Hash Message Authentication Code as defined in RFC 2104.\n */\n export function sha256Hmac(key: Buffer, msg: Buffer) {\n const blockSize = 64\n if (key.length > blockSize) key = sha256([key])\n const paddedKey = Buffer.create(blockSize)\n paddedKey.write(0, key)\n for (let i = 0; i < blockSize; ++i) paddedKey[i] ^= 0x36\n const h0 = sha256([paddedKey, msg])\n for (let i = 0; i < blockSize; ++i) paddedKey[i] ^= (0x36 ^ 0x5c)\n return sha256([paddedKey, h0])\n }\n\n} // namespace crypto",
"dal.d.ts": "// Auto-generated. Do not edit.\ndeclare const enum DAL {\n // /main/configkeys.h\n CFG_PIN_NAME_MSK = 65535,\n CFG_PIN_CONFIG_MSK = 4294901760,\n CFG_PIN_CONFIG_ACTIVE_LO = 65536,\n CFG_MAGIC0 = 513675505,\n CFG_MAGIC1 = 539130489,\n CFG_PIN_ACCELEROMETER_INT = 1,\n CFG_PIN_ACCELEROMETER_SCL = 2,\n CFG_PIN_ACCELEROMETER_SDA = 3,\n CFG_PIN_BTN_A = 4,\n CFG_PIN_BTN_B = 5,\n CFG_PIN_BTN_SLIDE = 6,\n CFG_PIN_DOTSTAR_CLOCK = 7,\n CFG_PIN_DOTSTAR_DATA = 8,\n CFG_PIN_FLASH_CS = 9,\n CFG_PIN_FLASH_MISO = 10,\n CFG_PIN_FLASH_MOSI = 11,\n CFG_PIN_FLASH_SCK = 12,\n CFG_PIN_LED = 13,\n CFG_PIN_LIGHT = 14,\n CFG_PIN_MICROPHONE = 15,\n CFG_PIN_MIC_CLOCK = 16,\n CFG_PIN_MIC_DATA = 17,\n CFG_PIN_MISO = 18,\n CFG_PIN_MOSI = 19,\n CFG_PIN_NEOPIXEL = 20,\n CFG_PIN_RX = 21,\n CFG_PIN_RXLED = 22,\n CFG_PIN_SCK = 23,\n CFG_PIN_SCL = 24,\n CFG_PIN_SDA = 25,\n CFG_PIN_SPEAKER_AMP = 26,\n CFG_PIN_TEMPERATURE = 27,\n CFG_PIN_TX = 28,\n CFG_PIN_TXLED = 29,\n CFG_PIN_IR_OUT = 30,\n CFG_PIN_IR_IN = 31,\n CFG_PIN_DISPLAY_SCK = 32,\n CFG_PIN_DISPLAY_MISO = 33,\n CFG_PIN_DISPLAY_MOSI = 34,\n CFG_PIN_DISPLAY_CS = 35,\n CFG_PIN_DISPLAY_DC = 36,\n CFG_DISPLAY_WIDTH = 37,\n CFG_DISPLAY_HEIGHT = 38,\n CFG_DISPLAY_CFG0 = 39,\n CFG_DISPLAY_CFG1 = 40,\n CFG_DISPLAY_CFG2 = 41,\n CFG_DISPLAY_CFG3 = 42,\n CFG_PIN_DISPLAY_RST = 43,\n CFG_PIN_DISPLAY_BL = 44,\n CFG_PIN_SERVO_1 = 45,\n CFG_PIN_SERVO_2 = 46,\n CFG_PIN_BTN_LEFT = 47,\n CFG_PIN_BTN_RIGHT = 48,\n CFG_PIN_BTN_UP = 49,\n CFG_PIN_BTN_DOWN = 50,\n CFG_PIN_BTN_MENU = 51,\n CFG_PIN_LED_R = 52,\n CFG_PIN_LED_G = 53,\n CFG_PIN_LED_B = 54,\n CFG_PIN_LED1 = 55,\n CFG_PIN_LED2 = 56,\n CFG_PIN_LED3 = 57,\n CFG_PIN_LED4 = 58,\n CFG_SPEAKER_VOLUME = 59,\n CFG_PIN_JACK_TX = 60,\n CFG_PIN_JACK_SENSE = 61,\n CFG_PIN_JACK_HPEN = 62,\n CFG_PIN_JACK_BZEN = 63,\n CFG_PIN_JACK_PWREN = 64,\n CFG_PIN_JACK_SND = 65,\n CFG_PIN_JACK_BUSLED = 66,\n CFG_PIN_JACK_COMMLED = 67,\n CFG_PIN_BTN_SOFT_RESET = 69,\n CFG_ACCELEROMETER_TYPE = 70,\n CFG_PIN_BTNMX_LATCH = 71,\n CFG_PIN_BTNMX_CLOCK = 72,\n CFG_PIN_BTNMX_DATA = 73,\n CFG_PIN_BTN_MENU2 = 74,\n CFG_PIN_BATTSENSE = 75,\n CFG_PIN_VIBRATION = 76,\n CFG_PIN_PWREN = 77,\n CFG_DISPLAY_TYPE = 78,\n CFG_PIN_ROTARY_ENCODER_A = 79,\n CFG_PIN_ROTARY_ENCODER_B = 80,\n CFG_ACCELEROMETER_SPACE = 81,\n CFG_PIN_WIFI_MOSI = 82,\n CFG_PIN_WIFI_MISO = 83,\n CFG_PIN_WIFI_SCK = 84,\n CFG_PIN_WIFI_TX = 85,\n CFG_PIN_WIFI_RX = 86,\n CFG_PIN_WIFI_CS = 87,\n CFG_PIN_WIFI_BUSY = 88,\n CFG_PIN_WIFI_RESET = 89,\n CFG_PIN_WIFI_GPIO0 = 90,\n CFG_PIN_WIFI_AT_TX = 91,\n CFG_PIN_WIFI_AT_RX = 92,\n CFG_PIN_USB_POWER = 93,\n ACCELEROMETER_TYPE_LIS3DH = 50,\n ACCELEROMETER_TYPE_LIS3DH_ALT = 48,\n ACCELEROMETER_TYPE_MMA8453 = 56,\n ACCELEROMETER_TYPE_FXOS8700 = 60,\n ACCELEROMETER_TYPE_MMA8653 = 58,\n ACCELEROMETER_TYPE_MSA300 = 76,\n ACCELEROMETER_TYPE_MPU6050 = 104,\n DISPLAY_TYPE_ST7735 = 7735,\n DISPLAY_TYPE_ILI9341 = 9341,\n DISPLAY_TYPE_SMART = 4242,\n CFG_PIN_A0 = 100,\n CFG_PIN_A1 = 101,\n CFG_PIN_A2 = 102,\n CFG_PIN_A3 = 103,\n CFG_PIN_A4 = 104,\n CFG_PIN_A5 = 105,\n CFG_PIN_A6 = 106,\n CFG_PIN_A7 = 107,\n CFG_PIN_A8 = 108,\n CFG_PIN_A9 = 109,\n CFG_PIN_A10 = 110,\n CFG_PIN_A11 = 111,\n CFG_PIN_A12 = 112,\n CFG_PIN_A13 = 113,\n CFG_PIN_A14 = 114,\n CFG_PIN_A15 = 115,\n CFG_PIN_A16 = 116,\n CFG_PIN_A17 = 117,\n CFG_PIN_A18 = 118,\n CFG_PIN_A19 = 119,\n CFG_PIN_A20 = 120,\n CFG_PIN_A21 = 121,\n CFG_PIN_A22 = 122,\n CFG_PIN_A23 = 123,\n CFG_PIN_A24 = 124,\n CFG_PIN_A25 = 125,\n CFG_PIN_A26 = 126,\n CFG_PIN_A27 = 127,\n CFG_PIN_A28 = 128,\n CFG_PIN_A29 = 129,\n CFG_PIN_A30 = 130,\n CFG_PIN_A31 = 131,\n CFG_PIN_D0 = 150,\n CFG_PIN_D1 = 151,\n CFG_PIN_D2 = 152,\n CFG_PIN_D3 = 153,\n CFG_PIN_D4 = 154,\n CFG_PIN_D5 = 155,\n CFG_PIN_D6 = 156,\n CFG_PIN_D7 = 157,\n CFG_PIN_D8 = 158,\n CFG_PIN_D9 = 159,\n CFG_PIN_D10 = 160,\n CFG_PIN_D11 = 161,\n CFG_PIN_D12 = 162,\n CFG_PIN_D13 = 163,\n CFG_PIN_D14 = 164,\n CFG_PIN_D15 = 165,\n CFG_PIN_D16 = 166,\n CFG_PIN_D17 = 167,\n CFG_PIN_D18 = 168,\n CFG_PIN_D19 = 169,\n CFG_PIN_D20 = 170,\n CFG_PIN_D21 = 171,\n CFG_PIN_D22 = 172,\n CFG_PIN_D23 = 173,\n CFG_PIN_D24 = 174,\n CFG_PIN_D25 = 175,\n CFG_PIN_D26 = 176,\n CFG_PIN_D27 = 177,\n CFG_PIN_D28 = 178,\n CFG_PIN_D29 = 179,\n CFG_PIN_D30 = 180,\n CFG_PIN_D31 = 181,\n CFG_NUM_NEOPIXELS = 200,\n CFG_NUM_DOTSTARS = 201,\n CFG_DEFAULT_BUTTON_MODE = 202,\n CFG_SWD_ENABLED = 203,\n CFG_FLASH_BYTES = 204,\n CFG_RAM_BYTES = 205,\n CFG_SYSTEM_HEAP_BYTES = 206,\n CFG_LOW_MEM_SIMULATION_KB = 207,\n CFG_BOOTLOADER_BOARD_ID = 208,\n CFG_UF2_FAMILY = 209,\n CFG_PINS_PORT_SIZE = 210,\n CFG_BOOTLOADER_PROTECTION = 211,\n CFG_POWER_DEEPSLEEP_TIMEOUT = 212,\n CFG_ANALOG_BUTTON_THRESHOLD = 213,\n CFG_CPU_MHZ = 214,\n CFG_CONTROLLER_LIGHT_MAX_BRIGHTNESS = 215,\n CFG_ANALOG_JOYSTICK_MIN = 216,\n CFG_ANALOG_JOYSTICK_MAX = 217,\n CFG_TIMERS_TO_USE = 218,\n CFG_PIN_ONBOARD_DOTSTAR_CLOCK = 219,\n CFG_PIN_ONBOARD_DOTSTAR_DATA = 220,\n CFG_NUM_ONBOARD_DOTSTARS = 221,\n CFG_PIN_ONBOARD_NEOPIXEL = 222,\n CFG_NUM_ONBOARD_NEOPIXELS = 223,\n CFG_MATRIX_KEYPAD_MESSAGE_ID = 239,\n CFG_NUM_MATRIX_KEYPAD_ROWS = 240,\n CFG_PIN_MATRIX_KEYPAD_ROW0 = 241,\n CFG_PIN_MATRIX_KEYPAD_ROW1 = 242,\n CFG_PIN_MATRIX_KEYPAD_ROW2 = 243,\n CFG_PIN_MATRIX_KEYPAD_ROW3 = 244,\n CFG_PIN_MATRIX_KEYPAD_ROW4 = 245,\n CFG_PIN_MATRIX_KEYPAD_ROW5 = 246,\n CFG_PIN_MATRIX_KEYPAD_ROW6 = 247,\n CFG_PIN_MATRIX_KEYPAD_ROW7 = 248,\n CFG_NUM_MATRIX_KEYPAD_COLS = 250,\n CFG_PIN_MATRIX_KEYPAD_COL0 = 251,\n CFG_PIN_MATRIX_KEYPAD_COL1 = 252,\n CFG_PIN_MATRIX_KEYPAD_COL2 = 253,\n CFG_PIN_MATRIX_KEYPAD_COL3 = 254,\n CFG_PIN_MATRIX_KEYPAD_COL4 = 255,\n CFG_PIN_MATRIX_KEYPAD_COL5 = 256,\n CFG_PIN_MATRIX_KEYPAD_COL6 = 257,\n CFG_PIN_MATRIX_KEYPAD_COL7 = 258,\n CFG_PIN_B0 = 300,\n CFG_PIN_B1 = 301,\n CFG_PIN_B2 = 302,\n CFG_PIN_B3 = 303,\n CFG_PIN_B4 = 304,\n CFG_PIN_B5 = 305,\n CFG_PIN_B6 = 306,\n CFG_PIN_B7 = 307,\n CFG_PIN_B8 = 308,\n CFG_PIN_B9 = 309,\n CFG_PIN_B10 = 310,\n CFG_PIN_B11 = 311,\n CFG_PIN_B12 = 312,\n CFG_PIN_B13 = 313,\n CFG_PIN_B14 = 314,\n CFG_PIN_B15 = 315,\n CFG_PIN_B16 = 316,\n CFG_PIN_B17 = 317,\n CFG_PIN_B18 = 318,\n CFG_PIN_B19 = 319,\n CFG_PIN_B20 = 320,\n CFG_PIN_B21 = 321,\n CFG_PIN_B22 = 322,\n CFG_PIN_B23 = 323,\n CFG_PIN_B24 = 324,\n CFG_PIN_B25 = 325,\n CFG_PIN_B26 = 326,\n CFG_PIN_B27 = 327,\n CFG_PIN_B28 = 328,\n CFG_PIN_B29 = 329,\n CFG_PIN_B30 = 330,\n CFG_PIN_B31 = 331,\n CFG_PIN_C0 = 350,\n CFG_PIN_C1 = 351,\n CFG_PIN_C2 = 352,\n CFG_PIN_C3 = 353,\n CFG_PIN_C4 = 354,\n CFG_PIN_C5 = 355,\n CFG_PIN_C6 = 356,\n CFG_PIN_C7 = 357,\n CFG_PIN_C8 = 358,\n CFG_PIN_C9 = 359,\n CFG_PIN_C10 = 360,\n CFG_PIN_C11 = 361,\n CFG_PIN_C12 = 362,\n CFG_PIN_C13 = 363,\n CFG_PIN_C14 = 364,\n CFG_PIN_C15 = 365,\n CFG_PIN_C16 = 366,\n CFG_PIN_C17 = 367,\n CFG_PIN_C18 = 368,\n CFG_PIN_C19 = 369,\n CFG_PIN_C20 = 370,\n CFG_PIN_C21 = 371,\n CFG_PIN_C22 = 372,\n CFG_PIN_C23 = 373,\n CFG_PIN_C24 = 374,\n CFG_PIN_C25 = 375,\n CFG_PIN_C26 = 376,\n CFG_PIN_C27 = 377,\n CFG_PIN_C28 = 378,\n CFG_PIN_C29 = 379,\n CFG_PIN_C30 = 380,\n CFG_PIN_C31 = 381,\n CFG_PIN_P0 = 400,\n CFG_PIN_P1 = 401,\n CFG_PIN_P2 = 402,\n CFG_PIN_P3 = 403,\n CFG_PIN_P4 = 404,\n CFG_PIN_P5 = 405,\n CFG_PIN_P6 = 406,\n CFG_PIN_P7 = 407,\n CFG_PIN_P8 = 408,\n CFG_PIN_P9 = 409,\n CFG_PIN_P10 = 410,\n CFG_PIN_P11 = 411,\n CFG_PIN_P12 = 412,\n CFG_PIN_P13 = 413,\n CFG_PIN_P14 = 414,\n CFG_PIN_P15 = 415,\n CFG_PIN_P16 = 416,\n CFG_PIN_P17 = 417,\n CFG_PIN_P18 = 418,\n CFG_PIN_P19 = 419,\n CFG_PIN_P20 = 420,\n CFG_PIN_P21 = 421,\n CFG_PIN_P22 = 422,\n CFG_PIN_P23 = 423,\n CFG_PIN_P24 = 424,\n CFG_PIN_P25 = 425,\n CFG_PIN_P26 = 426,\n CFG_PIN_P27 = 427,\n CFG_PIN_P28 = 428,\n CFG_PIN_P29 = 429,\n CFG_PIN_P30 = 430,\n CFG_PIN_P31 = 431,\n CFG_PIN_P32 = 432,\n CFG_PIN_P33 = 433,\n CFG_PIN_P34 = 434,\n CFG_PIN_P35 = 435,\n CFG_PIN_P36 = 436,\n CFG_PIN_P37 = 437,\n CFG_PIN_P38 = 438,\n CFG_PIN_P39 = 439,\n CFG_PIN_P40 = 440,\n CFG_PIN_P41 = 441,\n CFG_PIN_P42 = 442,\n CFG_PIN_P43 = 443,\n CFG_PIN_P44 = 444,\n CFG_PIN_P45 = 445,\n CFG_PIN_P46 = 446,\n CFG_PIN_P47 = 447,\n CFG_PIN_P48 = 448,\n CFG_PIN_P49 = 449,\n CFG_PIN_P50 = 450,\n CFG_PIN_P51 = 451,\n CFG_PIN_P52 = 452,\n CFG_PIN_P53 = 453,\n CFG_PIN_P54 = 454,\n CFG_PIN_P55 = 455,\n CFG_PIN_P56 = 456,\n CFG_PIN_P57 = 457,\n CFG_PIN_P58 = 458,\n CFG_PIN_P59 = 459,\n CFG_PIN_P60 = 460,\n CFG_PIN_P61 = 461,\n CFG_PIN_P62 = 462,\n CFG_PIN_P63 = 463,\n CFG_PIN_LORA_MISO = 1001,\n CFG_PIN_LORA_MOSI = 1002,\n CFG_PIN_LORA_SCK = 1003,\n CFG_PIN_LORA_CS = 1004,\n CFG_PIN_LORA_BOOT = 1005,\n CFG_PIN_LORA_RESET = 1006,\n CFG_PIN_IRRXLED = 1007,\n CFG_PIN_IRTXLED = 1008,\n CFG_PIN_LCD_RESET = 1009,\n CFG_PIN_LCD_ENABLE = 1010,\n CFG_PIN_LCD_DATALINE4 = 1011,\n CFG_PIN_LCD_DATALINE5 = 1012,\n CFG_PIN_LCD_DATALINE6 = 1013,\n CFG_PIN_LCD_DATALINE7 = 1014,\n CFG_NUM_LCD_COLUMNS = 1015,\n CFG_NUM_LCD_ROWS = 1016,\n CFG_PIN_RCC0 = 1017,\n CFG_PIN_RCC1 = 1018,\n CFG_PIN_RCC2 = 1019,\n CFG_PIN_RCC3 = 1020,\n CFG_PIN_RCC4 = 1021,\n CFG_PIN_RCC5 = 1022,\n CFG_PIN_RCC6 = 1023,\n CFG_PIN_RCC7 = 1024,\n CFG_PIN_SERVO0 = 1025,\n CFG_PIN_SERVO1 = 1026,\n CFG_PIN_SERVO2 = 1027,\n CFG_PIN_SERVO3 = 1028,\n CFG_PIN_SERVO4 = 1029,\n CFG_PIN_SERVO5 = 1030,\n CFG_PIN_SERVO6 = 1031,\n CFG_PIN_SERVO7 = 1032,\n CFG_PIN_SERVO8 = 1033,\n CFG_PIN_PI_TX = 1034,\n CFG_PIN_PI_RX = 1035,\n CFG_PIN_GPS_SDA = 1036,\n CFG_PIN_GPS_SCL = 1037,\n CFG_PIN_GPS_TX = 1038,\n CFG_PIN_GPS_RX = 1039,\n CFG_PIN_GROVE0 = 1040,\n CFG_PIN_GROVE1 = 1041,\n CFG_PIN_SS = 1042,\n CFG_PIN_D33 = 183,\n CFG_PIN_D34 = 184,\n CFG_PIN_D35 = 185,\n CFG_PIN_D36 = 186,\n CFG_PIN_D37 = 187,\n CFG_PIN_D38 = 188,\n CFG_PIN_D39 = 189,\n CFG_PIN_D40 = 190,\n CFG_PIN_D41 = 191,\n CFG_PIN_D42 = 192,\n CFG_PIN_D43 = 193,\n CFG_PIN_D44 = 194,\n CFG_PIN_D45 = 195,\n CFG_PIN_D46 = 196,\n CFG_PIN_D47 = 197,\n CFG_PIN_D48 = 198,\n CFG_PIN_D49 = 199,\n CFG_PIN_D50 = 259,\n CFG_PIN_D51 = 260,\n CFG_PIN_D52 = 261,\n CFG_PIN_D53 = 262,\n CFG_PIN_TX1 = 263,\n CFG_PIN_TX2 = 264,\n CFG_PIN_TX3 = 265,\n CFG_PIN_RX1 = 266,\n CFG_PIN_RX2 = 267,\n CFG_PIN_RX3 = 268,\n CFG_PIN_SCL1 = 269,\n CFG_PIN_SDA1 = 270,\n CFG_PIN_PCC_D0 = 271,\n CFG_PIN_PCC_D1 = 272,\n CFG_PIN_PCC_D2 = 273,\n CFG_PIN_PCC_D3 = 274,\n CFG_PIN_PCC_D4 = 275,\n CFG_PIN_PCC_D5 = 276,\n CFG_PIN_PCC_D6 = 277,\n CFG_PIN_PCC_D7 = 278,\n CFG_PIN_PCC_D8 = 279,\n CFG_PIN_PCC_D9 = 280,\n CFG_PIN_PCC_D10 = 281,\n CFG_PIN_PCC_D11 = 282,\n CFG_PIN_PCC_D12 = 283,\n CFG_PIN_PCC_D13 = 284,\n CFG_PIN_CC_DEN1 = 285,\n CFG_PIN_CC_DEN2 = 286,\n CFG_PIN_CC_CLK = 287,\n CFG_PIN_XCC_CLK = 288,\n CFG_PIN_JDPWR_PRE_SENSE = 1100,\n CFG_PIN_JDPWR_GND_SENSE = 1101,\n CFG_PIN_JDPWR_PULSE = 1102,\n CFG_PIN_JDPWR_OVERLOAD_LED = 1103,\n CFG_PIN_JDPWR_ENABLE = 1104,\n CFG_PIN_JDPWR_FAULT = 1105,\n // /main/jacdac/JacdacBLE.h\n JACDAC_BLE_BUFFER_SIZE = 254,\n MICROBIT_JACDAC_S_EVT_RX = 1,\n MICROBIT_JACDAC_S_EVT_TX = 1,\n DEVICE_ID_JACDAC_BLE = 3056,\n JD_BLE_STATUS_IN_USE = 8,\n // /main/jacdac/jdprotocol.h\n JD_SERIAL_PAYLOAD_SIZE = 236,\n JD_SERIAL_FULL_HEADER_SIZE = 16,\n JD_SERVICE_CLASS_CTRL = 0,\n JD_SERVICE_NUMBER_CTRL = 0,\n JD_SERVICE_NUMBER_MASK = 63,\n JD_SERVICE_NUMBER_CRC_ACK = 63,\n JD_FRAME_FLAG_COMMAND = 1,\n JD_FRAME_FLAG_ACK_REQUESTED = 2,\n JD_FRAME_FLAG_IDENTIFIER_IS_SERVICE_CLASS = 4,\n JD_REG_INTENSITY = 1,\n JD_REG_VALUE = 2,\n JD_REG_IS_STREAMING = 3,\n JD_REG_STREAMING_INTERVAL = 4,\n JD_REG_LOW_THRESHOLD = 5,\n JD_REG_HIGH_THRESHOLD = 6,\n JD_REG_MAX_POWER = 7,\n JD_REG_READING = 257,\n JD_CMD_GET_REG = 4096,\n JD_CMD_SET_REG = 8192,\n JD_CMD_ADVERTISEMENT_DATA = 0,\n JD_CMD_EVENT = 1,\n JD_CMD_CALIBRATE = 2,\n JD_CMD_GET_DESCRIPTION = 3,\n JD_CMD_CTRL_NOOP = 128,\n JD_CMD_CTRL_IDENTIFY = 129,\n JD_CMD_CTRL_RESET = 130,\n JD_REG_CTRL_DEVICE_DESCRIPTION = 384,\n JD_REG_CTRL_DEVICE_CLASS = 385,\n JD_REG_CTRL_TEMPERATURE = 386,\n JD_REG_CTRL_LIGHT_LEVEL = 387,\n JD_REG_CTRL_BL_DEVICE_CLASS = 388,\n JDSPI_MAGIC = 31437,\n JDSPI_MAGIC_NOOP = 46029,\n // /main/pintarget.h\n DEVICE_PIN_EVT_RISE = 2,\n DEVICE_PIN_EVT_FALL = 3,\n DEVICE_PIN_EVT_PULSE_HI = 4,\n DEVICE_PIN_EVT_PULSE_LO = 5,\n DEVICE_PIN_EVENT_NONE = 0,\n DEVICE_PIN_EVENT_ON_EDGE = 1,\n DEVICE_PIN_EVENT_ON_PULSE = 2,\n DEVICE_PIN_EVENT_ON_TOUCH = 3,\n // /main/platform.h\n PXT_ESP32 = 1,\n PAGE_SIZE = 1024,\n DEV_NUM_PINS = 50,\n IMAGE_BITS = 4,\n // /main/pxt.h\n OUTPUT_BITS = 12,\n DEVICE_EVT_ANY = 0,\n DEVICE_ID_NOTIFY_ONE = 1022,\n DEVICE_ID_NOTIFY = 1023,\n DEVICE_ID_JACDAC = 30,\n DEVICE_ID_JACDAC_PHYS = 31,\n // /main/pxtbase.h\n PXT32 = 1,\n PXT64 = 1,\n PXT_REFCNT_FLASH = 65534,\n VTABLE_MAGIC = 249,\n VTABLE_MAGIC2 = 248,\n Undefined = 0,\n Boolean = 1,\n Number = 2,\n String = 3,\n Object = 4,\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,\n MMap = 10,\n BoxedString_SkipList = 11,\n BoxedString_ASCII = 12,\n ZPin = 13,\n User0 = 16,\n IMAGE_HEADER_MAGIC = 135,\n Int8LE = 1,\n UInt8LE = 2,\n Int16LE = 3,\n UInt16LE = 4,\n Int32LE = 5,\n Int8BE = 6,\n UInt8BE = 7,\n Int16BE = 8,\n UInt16BE = 9,\n Int32BE = 10,\n UInt32LE = 11,\n UInt32BE = 12,\n Float32LE = 13,\n Float64LE = 14,\n Float32BE = 15,\n Float64BE = 16,\n NUM_TRY_FRAME_REGS = 3,\n GC = 0,\n PXT_STRING_SKIP_INCR = 16,\n // /main/pxtconfig.h\n PXT_VM = 1,\n PXT_UF2_FAMILY = 3218951918,\n // /main/pxtcore.h\n PXT_HARD_FLOAT = 1,\n // /main/uf2hid.h\n UF2_HID_H = 1,\n HF2_CMD_BININFO = 1,\n HF2_MODE_BOOTLOADER = 1,\n HF2_MODE_USERSPACE = 2,\n HF2_CMD_INFO = 2,\n HF2_CMD_RESET_INTO_APP = 3,\n HF2_CMD_RESET_INTO_BOOTLOADER = 4,\n HF2_CMD_START_FLASH = 5,\n HF2_CMD_WRITE_FLASH_PAGE = 6,\n HF2_CMD_CHKSUM_PAGES = 7,\n HF2_CMD_READ_WORDS = 8,\n HF2_CMD_WRITE_WORDS = 9,\n HF2_CMD_DMESG = 16,\n HF2_EV_MASK = 8388608,\n HF2_CMD_JDS_CONFIG = 32,\n HF2_CMD_JDS_SEND = 33,\n HF2_EV_JDS_PACKET = 8388640,\n HF2_FLAG_SERIAL_OUT = 128,\n HF2_FLAG_SERIAL_ERR = 192,\n HF2_FLAG_CMDPKT_LAST = 64,\n HF2_FLAG_CMDPKT_BODY = 0,\n HF2_FLAG_MASK = 192,\n HF2_SIZE_MASK = 63,\n HF2_STATUS_OK = 0,\n HF2_STATUS_INVALID_CMD = 1,\n HF2_STATUS_INVALID_STATE = 2,\n // /main/vm.h\n VM_OPCODE_BASE_SIZE = 6,\n VM_OPCODE_ARG_POS = 7,\n VM_RTCALL_PUSH_MASK = 8192,\n VM_MAX_FUNCTION_STACK = 200,\n VM_STACK_SIZE = 1000,\n Invalid = 0,\n InfoHeader = 1,\n OpCodeMap = 2,\n NumberLiterals = 3,\n ConfigData = 4,\n IfaceMemberNames = 5,\n NumberBoxes = 6,\n Literal = 33,\n VTable = 34,\n PXT_WAIT_SOURCE_PROMISE = 131056,\n}\n",
"dmesg.cpp": "#include \"pxt.h\"\n#include \n#include \n#include \n#include \n#include \n#include \n\n#include \"esp_log.h\"\n\nnamespace pxt {\n\n#define LOG_QUEUE_SIZE (2 * 1024)\nclass LogQueue {\n void writeCore(const char *buf, int len);\n\n public:\n int ptr;\n char buffer[LOG_QUEUE_SIZE];\n int rdPtr;\n int numWrap;\n LogQueue();\n int write(const char *buf, int len);\n int read(char *buf, int len);\n};\n\n} // namespace pxt\n\nLogQueue codalLogStore;\n\nnamespace pxt {\nLogQueue::LogQueue() {\n ptr = 0;\n rdPtr = 0;\n numWrap = 0;\n memset(buffer, 0, sizeof(buffer));\n}\n\nvoid LogQueue::writeCore(const char *buf, int len) {\n memcpy(buffer + ptr, buf, len);\n // did we pass it?\n if (ptr < rdPtr && rdPtr <= ptr + len)\n rdPtr = -1;\n ptr += len;\n}\n\nint LogQueue::read(char *buf, int len) {\n if (rdPtr < 0) {\n if (numWrap == 0) {\n rdPtr = 0;\n } else {\n rdPtr = ptr + 1;\n }\n }\n\n if (rdPtr <= ptr) {\n int av = ptr - rdPtr;\n if (len > av)\n len = av;\n memcpy(buf, buffer + rdPtr, len);\n rdPtr += len;\n } else {\n int latter = sizeof(buffer) - rdPtr;\n\n if (latter >= len) {\n memcpy(buf, buffer + rdPtr, len);\n rdPtr += len;\n } else {\n memcpy(buf, buffer + rdPtr, latter);\n buf += latter;\n int len2 = len - latter;\n if (len2 > ptr)\n len2 = ptr;\n memcpy(buf, buffer, len2);\n rdPtr = len2;\n len = latter + len2;\n }\n }\n\n if (rdPtr >= (int)sizeof(buffer))\n rdPtr = 0;\n\n return len;\n}\n\nint LogQueue::write(const char *buf, int len) {\n if (len > (int)sizeof(buffer) / 2)\n return -1;\n\n int left = sizeof(buffer) - ptr;\n\n if (left < len + 1) {\n writeCore(buf, left);\n buf += left;\n len -= left;\n ptr = 0;\n numWrap++;\n if (rdPtr == 0)\n rdPtr = -1;\n }\n\n writeCore(buf, len);\n buffer[ptr] = 0;\n\n return 0;\n}\n\nvoid dumpDmesg() {\n // not enabled\n}\n\nvoid ets_log_dmesg() {\n char buf[500];\n int prefix = 0;\n for (;;) {\n int len = codalLogStore.read(buf + prefix, sizeof(buf) - 1 - prefix);\n if (len == 0 && prefix != 0) {\n buf[prefix] = '\\n'; // make sure we flush\n len = 1;\n }\n len += prefix;\n if (len == 0)\n return;\n int beg = 0;\n for (int i = 0; i < len; ++i) {\n if (buf[i] == '\\n' || i - beg > 200) {\n buf[i] = 0;\n ets_printf(LOG_FORMAT(W, \"%s\"), esp_log_timestamp(), \"DMESG\", buf + beg);\n beg = i + 1;\n }\n }\n prefix = len - beg;\n if (prefix)\n memmove(buf, buf + beg, prefix);\n }\n}\n\nvoid dmesg_flush() {}\n\n} // namespace pxt\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\n#define WRITEN(p, sz_) \\\n do { \\\n sz = sz_; \\\n ptr += sz; \\\n if (ptr < dstsize) { \\\n memcpy(dst + ptr - sz, p, sz); \\\n dst[ptr] = 0; \\\n } \\\n } while (0)\n\nint codal_vsprintf(char *dst, unsigned dstsize, const char *format, va_list ap) {\n const char *end = format;\n unsigned ptr = 0, sz;\n char buf[16];\n\n for (;;) {\n char c = *end++;\n if (c == 0 || c == '%') {\n if (format != end)\n WRITEN(format, end - format - 1);\n if (c == 0)\n break;\n\n uint32_t val = va_arg(ap, uint32_t);\n c = *end++;\n buf[1] = 0;\n switch (c) {\n case 'c':\n buf[0] = val;\n break;\n case 'd':\n itoa(val, buf);\n break;\n case 'x':\n case 'p':\n case 'X':\n buf[0] = '0';\n buf[1] = 'x';\n writeNum(buf + 2, val, c != 'x');\n break;\n case 's':\n WRITEN((char *)(void *)val, strlen((char *)(void *)val));\n buf[0] = 0;\n break;\n case '%':\n buf[0] = c;\n break;\n default:\n buf[0] = '?';\n break;\n }\n format = end;\n WRITEN(buf, strlen(buf));\n }\n }\n\n return ptr;\n}\n\nDLLEXPORT int pxt_get_logs(int logtype, char *dst, int maxSize) {\n if (logtype != 0)\n return 0;\n target_disable_irq();\n int r = codalLogStore.read(dst, maxSize);\n target_enable_irq();\n return r;\n}\n\nstatic void dmesgRaw(const char *buf, uint32_t len) {\n codalLogStore.write(buf, len);\n}\n\nvoid vdmesg(const char *format, va_list arg) {\n char buf[500];\n\n target_disable_irq();\n\n // snprintf(buf, sizeof(buf), \"[%8d] \", current_time_ms());\n // dmesgRaw(buf, (uint32_t)strlen(buf));\n\n codal_vsprintf(buf, sizeof(buf) - 3, format, arg);\n // ets_printf(LOG_FORMAT(W, \"%s\"), esp_log_timestamp(), \"DMESG\", buf);\n int len = strlen(buf);\n buf[len++] = '\\n';\n dmesgRaw(buf, len);\n\n target_enable_irq();\n}\n\nvoid dmesg(const char *format, ...) {\n va_list arg;\n va_start(arg, format);\n vdmesg(format, arg);\n va_end(arg);\n}\n\nextern int int_level;\nextern \"C\" void panic_print_char(const char c);\nextern \"C\" void panic_print_str(const char *str);\nextern \"C\" void panic_print_dec(int d);\n\nextern \"C\" void user_panic_handler() {\n panic_print_str(\"\\r\\nDMESG:\\r\\n\");\n for (;;) {\n char c;\n int r = codalLogStore.read(&c, 1);\n if (r == 0)\n break;\n if (c == '\\n')\n panic_print_char('\\r');\n panic_print_char(c);\n }\n panic_print_str(\"END DMESG\\r\\nInt: \");\n panic_print_dec(int_level);\n panic_print_str(\"\\r\\n\");\n}\n",
"dmesg.h": "#pragma once\n\n#include \n\n#ifndef DMESG\n#ifdef __cplusplus\nextern \"C\" void dmesg(const char *fmt, ...);\n#define DMESG ::dmesg\n#else // not C++\nvoid dmesg(const char *fmt, ...);\n#define DMESG dmesg\n#endif\n#endif\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum PulseValue {\n //% block=high\n High = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=low\n Low = 5, // DEVICE_PIN_EVT_PULSE_LO\n }\n\n\n declare const enum PinEvent {\n //% block=\"pulse high\"\n PulseHigh = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=\"pulse low\"\n PulseLow = 5, // DEVICE_PIN_EVT_PULSE_LO\n //% block=\"rise\"\n Rise = 2, // DEVICE_PIN_EVT_RISE\n //% block=\"fall\"\n Fall = 3, // DEVICE_PIN_EVT_FALL\n }\n\n\n declare const enum PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"keys.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\nvoid initKeys() {}\n\n//% expose\nint pressureLevelByButtonId(int btnId, int codalId) {\n return 0; // TODO\n}\n\n//% expose\nvoid setupButton(int buttonId, int key) {\n (void)buttonId;\n (void)key;\n // not needed on RPi\n}\n\n} // namespace pxt",
"ns.ts": "/**\n * Events and data from sensors.\n */\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\n//% groups='[\"other\", \"More\"]'\nnamespace input {\n}\n\n/**\n * Servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\"\nnamespace servos {\n\n}\n\n/**\n * A Joint Asynchronous Communications, Device Agnostic Control.\n */\n//% color=\"#E79251\" weight=1 icon=\"\\uf185\"\n//% groups='[\"Broadcast\", \"Console\", \"Control\"]'\n//% blockGap=8\nnamespace jacdac {\n\n}",
"pins.cpp": "#include \"pxt.h\"\n\n#include \"esp_task_wdt.h\"\n\nnamespace pxt {\nstatic DevicePin **pinPtrs;\nstatic uint8_t numPinPtrs;\nstatic uint8_t pinPos[DEV_NUM_PINS];\n\n//% expose\nDevicePin *getPin(int id) {\n\n id &= CFG_PIN_NAME_MSK;\n\n if (id >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n\n int ptr = pinPos[id];\n if (ptr == 0) {\n pinPtrs = (DevicePin **)realloc(pinPtrs, (numPinPtrs + 1) * sizeof(void *));\n // GCTODO\n pinPtrs[numPinPtrs++] = new DevicePin(id);\n ptr = numPinPtrs;\n pinPos[id] = ptr;\n }\n return pinPtrs[ptr - 1];\n}\n\n//% expose\nDevicePin *getPinCfg(int key) {\n int p = getConfig(key, -1);\n if (p == -1)\n DMESG(\"no pin cfg: %d\", key);\n return getPin(p);\n}\n\nvoid linkPin(int from, int to) {\n if (from < 0 || from >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n getPin(to);\n pinPos[from] = pinPos[to];\n}\n\n//% expose\nDevicePin *lookupPin(int pinName) {\n if (pinName < 0 || pinName == 0xff)\n return NULL;\n pinName &= CFG_PIN_NAME_MSK;\n return getPin(pinName);\n}\n\n//% expose\nDevicePin *lookupPinCfg(int key) {\n return lookupPin(getConfig(key));\n}\n\n} // namespace pxt\n\nnamespace pins {\n/**\n * Get a pin by configuration id (DAL.CFG_PIN...)\n */\n//%\nDigitalInOutPin pinByCfg(int key) {\n return pxt::lookupPinCfg(key);\n}\n\n/**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n//%\nBuffer createBuffer(int size) {\n return mkBuffer(NULL, size);\n}\n\n} // namespace pins\n\nnamespace control {\n/**\n * Enable a watchdog timer that need to be fed or it will reset the device.\n * If timeout is not positive, the watchdog is disabled.\n */\n//%\nvoid setWatchdog(int timeout_s) {\n if (timeout_s > 0) {\n esp_task_wdt_init(timeout_s, true);\n esp_task_wdt_add(NULL);\n } else {\n esp_task_wdt_delete(NULL);\n }\n}\n\n/**\n * Reset timeout on previously enabled watchdog.\n */\n//%\nvoid feedWatchdog() {\n esp_task_wdt_reset();\n}\n\n} // namespace control",
"pins.h": "#ifndef __PXT_PINS_H\n#define __PXT_PINS_H\n\n#define BUTTON_ACTIVE_HIGH_PULL_DOWN (ACTIVE_HIGH | 0x10)\n#define BUTTON_ACTIVE_HIGH_PULL_UP (ACTIVE_HIGH | 0x20)\n#define BUTTON_ACTIVE_HIGH_PULL_NONE (ACTIVE_HIGH | 0x30)\n#define BUTTON_ACTIVE_LOW_PULL_DOWN (ACTIVE_LOW | 0x10)\n#define BUTTON_ACTIVE_LOW_PULL_UP (ACTIVE_LOW | 0x20)\n#define BUTTON_ACTIVE_LOW_PULL_NONE (ACTIVE_LOW | 0x30)\n\n#define PIN(name) ((PinName)pxt::getConfig(CFG_PIN_##name, -1))\n#define LOOKUP_PIN(name) pxt::lookupPin(PIN(name))\n\n// these can be overridden in platform.h\n#ifndef CODAL_PIN\n#define CODAL_PIN CODAL_MBED::Pin\n#endif\n\n#ifndef CODAL_TIMER\n#define CODAL_TIMER CODAL_MBED::Timer\n#endif\n\n#ifndef CODAL_SPI\n#define CODAL_SPI CODAL_MBED::SPI\n#endif\n\n#ifndef CODAL_SERIAL\n#define CODAL_SERIAL CODAL_MBED::Serial\n#endif\n\n#ifndef IS_ANALOG_PIN\n#define IS_ANALOG_PIN(id) ((DEV_ANALOG_PINS >> (id)) & 1)\n#endif\n\ntypedef CODAL_PIN DevicePin;\n\ntypedef DevicePin *DigitalInOutPin;\ntypedef DevicePin *AnalogInOutPin;\ntypedef DevicePin *AnalogInPin;\ntypedef DevicePin *AnalogOutPin;\ntypedef DevicePin *PwmPin;\ntypedef DevicePin *PwmOnlyPin;\ntypedef Button *Button_;\n\nnamespace pxt {\nDevicePin *getPin(int id);\nDevicePin *getPinCfg(int key);\nDevicePin *lookupPin(int pinName);\nDevicePin *lookupPinCfg(int key);\nvoid linkPin(int from, int to);\nCodalComponent *lookupComponent(int id);\n}\n\n#define PINOP(op) name->op\n\n#endif\n",
"pins.ts": "//% noRefCounting fixedInstances\ninterface DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogOutPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInOutPin extends AnalogInPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmOnlyPin extends DigitalInOutPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmPin extends PwmOnlyPin, AnalogInOutPin {\n}\n\n/**\n * Control currents in Pins for analog/digital signals, servos, i2c, ...\n */\n//% color=#A80000 weight=85 icon=\"\\uf140\" advanced=true\n//% groups='[\"other\", \"Servo\", \"i2c\"]'\nnamespace pins {\n}",
"pinsDigital.cpp": "#include \"pxt.h\"\n\nenum class PulseValue {\n //% block=high\n High = DEVICE_PIN_EVT_PULSE_HI,\n //% block=low\n Low = DEVICE_PIN_EVT_PULSE_LO\n};\n\nenum class PinEvent {\n //% block=\"pulse high\"\n PulseHigh = DEVICE_PIN_EVT_PULSE_HI,\n //% block=\"pulse low\"\n PulseLow = DEVICE_PIN_EVT_PULSE_LO,\n //% block=\"rise\"\n Rise = DEVICE_PIN_EVT_RISE,\n //% block=\"fall\"\n Fall = DEVICE_PIN_EVT_FALL,\n};\n\nenum class PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2\n};\n\nnamespace DigitalInOutPinMethods {\n/**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n//% help=pins/digital-read weight=61\n//% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nbool digitalRead(DigitalInOutPin name) {\n return PINOP(getDigitalValue()) != 0;\n}\n\n/**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n//% help=pins/digital-write weight=60\n//% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid digitalWrite(DigitalInOutPin name, bool value) {\n PINOP(setDigitalValue(value));\n}\n\n/**\n* Make this pin a digital input, and create events where the timestamp is the duration\n* that this pin was either ``high`` or ``low``.\n*/\n//% help=pins/on-pulsed weight=16 blockGap=8\n//% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\n//% deprecated=1 hidden=1\nvoid onPulsed(DigitalInOutPin pin, PulseValue pulse, Action body) {\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)pulse, body);\n}\n\n/**\n* Register code to run when a pin event occurs. \n*/\n//% help=pins/on-event weight=20 blockGap=8\n//% blockId=pinsonevent block=\"on|pin %pin|%event\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nvoid onEvent(DigitalInOutPin pin, PinEvent event, Action body) {\n switch(event) {\n case PinEvent::PulseHigh:\n case PinEvent::PulseLow:\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)event, body);\n break;\n case PinEvent::Rise:\n case PinEvent::Fall:\n pin->eventOn(DEVICE_PIN_EVENT_ON_EDGE);\n registerWithDal(pin->id, (int)event, body);\n break; \n } \n}\n\n/**\n* Return the duration of a pulse in microseconds\n* @param name the pin which measures the pulse\n* @param value the value of the pulse (default high)\n* @param maximum duration in micro-seconds\n*/\n//% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n//% weight=18 blockGap=8\n//% help=\"pins/pulse-in\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nint pulseIn(DigitalInOutPin pin, PulseValue value, int maxDuration = 2000000) {\n int pulse = PulseValue::High == value ? 1 : 0;\n uint64_t tick = system_timer_current_time_us();\n uint64_t maxd = (uint64_t)maxDuration;\n while (pin->getDigitalValue() != pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n\n uint64_t start = system_timer_current_time_us();\n while (pin->getDigitalValue() == pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n uint64_t end = system_timer_current_time_us();\n return end - start;\n}\n\n/**\n* Set the pull direction of this pin.\n* @param name pin to set the pull mode on\n* @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n*/\n//% help=pins/set-pull weight=17 blockGap=8\n//% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid setPull(DigitalInOutPin name, PinPullMode pull) {\n PullMode m = pull == PinPullMode::PullDown ? PullMode::Down : pull == PinPullMode::PullUp\n ? PullMode::Up\n : PullMode::None;\n PINOP(setPull(m));\n}\n\n}\n\n#ifdef PXT_CODAL\n\nnamespace pxt {\n\nstatic void waitABit() {\n // for (int i = 0; i < 10; ++i)\n // asm volatile(\"nop\");\n}\n\nclass ButtonMultiplexer : public CodalComponent {\n public:\n Pin &latch;\n Pin &clock;\n Pin &data;\n uint32_t state;\n uint32_t invMask;\n uint16_t buttonIdPerBit[8];\n bool enabled;\n\n ButtonMultiplexer(uint16_t id)\n : latch(*LOOKUP_PIN(BTNMX_LATCH)), clock(*LOOKUP_PIN(BTNMX_CLOCK)),\n data(*LOOKUP_PIN(BTNMX_DATA)) {\n this->id = id;\n this->status |= DEVICE_COMPONENT_STATUS_SYSTEM_TICK;\n\n state = 0;\n invMask = 0;\n enabled = true;\n\n memset(buttonIdPerBit, 0, sizeof(buttonIdPerBit));\n\n data.getDigitalValue(PullMode::Down);\n latch.setDigitalValue(1);\n clock.setDigitalValue(1);\n }\n\n void disable() {\n data.getDigitalValue(PullMode::None);\n latch.getDigitalValue(PullMode::None);\n clock.getDigitalValue(PullMode::None);\n enabled = false;\n }\n\n bool isButtonPressed(int id) {\n for (int i = 0; i < 8; ++i) {\n if (buttonIdPerBit[i] == id)\n return (state & (1 << i)) != 0;\n }\n return false;\n }\n\n uint32_t readBits(int bits) {\n latch.setDigitalValue(0);\n waitABit();\n latch.setDigitalValue(1);\n waitABit();\n\n uint32_t state = 0;\n for (int i = 0; i < bits; i++) {\n state <<= 1;\n if (data.getDigitalValue(PullMode::Down))\n state |= 1;\n\n clock.setDigitalValue(0);\n waitABit();\n clock.setDigitalValue(1);\n waitABit();\n }\n\n return state;\n }\n\n virtual void periodicCallback() override {\n if (!enabled)\n return;\n\n uint32_t newState = readBits(8);\n newState ^= invMask;\n if (newState == state)\n return;\n\n for (int i = 0; i < 8; ++i) {\n uint32_t mask = 1 << i;\n if (!buttonIdPerBit[i])\n continue;\n int ev = 0;\n if (!(state & mask) && (newState & mask))\n ev = PXT_INTERNAL_KEY_DOWN;\n else if ((state & mask) && !(newState & mask))\n ev = PXT_INTERNAL_KEY_UP;\n if (ev) {\n Event(ev, buttonIdPerBit[i]);\n Event(ev, 0); // any key\n }\n }\n\n state = newState;\n }\n};\n\nstatic ButtonMultiplexer *btnMultiplexer;\nButtonMultiplexer *getMultiplexer() {\n if (!btnMultiplexer)\n btnMultiplexer = new ButtonMultiplexer(DEVICE_ID_FIRST_BUTTON);\n return btnMultiplexer;\n}\n\nint registerMultiplexedButton(int pin, int buttonId) {\n if (1050 <= pin && pin < 1058) {\n pin -= 50;\n getMultiplexer()->invMask |= 1 << (pin - 1000);\n }\n if (1000 <= pin && pin < 1008) {\n getMultiplexer()->buttonIdPerBit[pin - 1000] = buttonId;\n return 1;\n }\n return 0;\n}\n\nint multiplexedButtonIsPressed(int btnId) {\n if (btnMultiplexer)\n return btnMultiplexer->isButtonPressed(btnId) ? 512 : 0;\n return 0;\n}\n\n//% expose\nuint32_t readButtonMultiplexer(int bits) {\n if (!LOOKUP_PIN(BTNMX_CLOCK))\n return 0;\n return getMultiplexer()->readBits(bits);\n}\n\nvoid disableButtonMultiplexer() {\n if (LOOKUP_PIN(BTNMX_CLOCK)) {\n getMultiplexer()->disable();\n }\n}\n\n}\n\n#endif\n",
"pinscompat.ts": "// filled in by microbit",
"pintarget.cpp": "#include \"pxt.h\"\n\n#include \"esp_system.h\"\n#include \"esp_log.h\"\n#include \"driver/gpio.h\"\n\n#define IO_STATUS_DIGITAL_IN 0x0001 // Pin is configured as a digital input, with no pull up.\n#define IO_STATUS_DIGITAL_OUT 0x0002 // Pin is configured as a digital output\n#define IO_STATUS_ANALOG_IN 0x0004 // Pin is Analog in\n#define IO_STATUS_ANALOG_OUT 0x0008 // Pin is Analog out\n#define IO_STATUS_TOUCH_IN 0x0010 // Pin is a makey-makey style touch sensor\n#define IO_STATUS_EVENT_ON_EDGE 0x0020 // Pin will generate events on pin change\n#define IO_STATUS_EVENT_PULSE_ON_EDGE 0x0040 // Pin will generate events on pin change\n#define IO_STATUS_INTERRUPT_ON_EDGE 0x0080 // Pin will generate events on pin change\n\nnamespace pxt {\n\nPXT_EXT_VTABLE(ZPin);\n\nZPin::ZPin(int gpio_num) : RefObject(&ZPin_vtable) {\n this->gpio_num = gpio_num;\n this->status = 0;\n this->pullMode = PullMode::None;\n this->id = 100 + gpio_num;\n}\n\nvoid ZPin::disconnect() {\n gpio_reset_pin((gpio_num_t)gpio_num);\n status = 0;\n}\n\nint ZPin::setDigitalValue(int value) {\n // Write the value, before setting as output - this way the pin state update will be atomic\n gpio_set_level((gpio_num_t)gpio_num, value);\n\n // Move into a Digital output state if necessary.\n if (!(status & IO_STATUS_DIGITAL_OUT)) {\n disconnect();\n\n gpio_config_t cfg;\n memset(&cfg, 0, sizeof(cfg));\n cfg.pin_bit_mask = 1ULL << gpio_num;\n cfg.mode = GPIO_MODE_OUTPUT;\n gpio_config(&cfg);\n\n status |= IO_STATUS_DIGITAL_OUT;\n }\n\n return 0;\n}\n\nint ZPin::getDigitalValue() {\n if (!(status & (IO_STATUS_DIGITAL_IN | IO_STATUS_EVENT_ON_EDGE | IO_STATUS_EVENT_PULSE_ON_EDGE |\n IO_STATUS_INTERRUPT_ON_EDGE))) {\n disconnect();\n gpio_config_t cfg;\n memset(&cfg, 0, sizeof(cfg));\n cfg.pin_bit_mask = 1ULL << gpio_num;\n cfg.mode = GPIO_MODE_INPUT;\n switch (pullMode) {\n case PullMode::Down:\n cfg.pull_down_en = GPIO_PULLDOWN_ENABLE;\n break;\n case PullMode::Up:\n cfg.pull_up_en = GPIO_PULLUP_ENABLE;\n break;\n case PullMode::None:\n break;\n }\n gpio_config(&cfg);\n\n status |= IO_STATUS_DIGITAL_IN;\n }\n\n return gpio_get_level((gpio_num_t)gpio_num);\n}\n\nint ZPin::setPull(PullMode pull) {\n if (pull != pullMode) {\n status = 0;\n pullMode = pull;\n getDigitalValue();\n }\n return 0;\n}\n\nint ZPin::getDigitalValue(PullMode pull) {\n setPull(pull);\n return getDigitalValue();\n}\n\nint ZPin::eventOn(int eventType) {\n switch (eventType) {\n case DEVICE_PIN_EVENT_ON_EDGE:\n case DEVICE_PIN_EVENT_ON_PULSE:\n // enableRiseFallEvents(eventType);\n break;\n\n case DEVICE_PIN_EVENT_ON_TOUCH:\n // isTouched();\n break;\n\n case DEVICE_PIN_EVENT_NONE:\n // disableEvents();\n break;\n\n default:\n return -1;\n }\n\n return 0;\n}\n\nuint32_t readButtonMultiplexer(int bits) {\n return 0;\n}\n\n} // namespace pxt",
"pintarget.h": "#pragma once\n\n#define DEVICE_PIN_EVT_RISE 2\n#define DEVICE_PIN_EVT_FALL 3\n#define DEVICE_PIN_EVT_PULSE_HI 4\n#define DEVICE_PIN_EVT_PULSE_LO 5\n\n#define DEVICE_PIN_EVENT_NONE 0\n#define DEVICE_PIN_EVENT_ON_EDGE 1\n#define DEVICE_PIN_EVENT_ON_PULSE 2\n#define DEVICE_PIN_EVENT_ON_TOUCH 3\n\nnamespace pxt {\nenum class PullMode : uint8_t { None = 0, Down, Up };\n\nclass ZPin : RefObject {\n uint8_t gpio_num;\n uint8_t status;\n PullMode pullMode;\n\n public:\n uint8_t id;\n\n ZPin(int gpio_num);\n void disconnect();\n int setDigitalValue(int value);\n int getDigitalValue();\n int setPull(PullMode pull);\n int getDigitalValue(PullMode pull);\n int eventOn(int eventType);\n};\n\nstatic inline ZPin *asZPin(TValue v) {\n if (!isPointer(v))\n failedCast(v);\n auto vt = getVTable((RefObject *)v);\n if (vt->classNo != BuiltInType::ZPin)\n failedCast(v);\n return (ZPin *)v;\n}\n\n#define asDigitalInOutPin pxt::asZPin\n#define asAnalogInOutPin pxt::asZPin\n#define asAnalogInPin pxt::asZPin\n#define asAnalogOutPin pxt::asZPin\n#define asPwmPin pxt::asZPin\n#define asPwmOnlyPin pxt::asZPin\n\nstatic inline int64_t system_timer_current_time_us() {\n return esp_timer_get_time();\n}\n\n} // namespace pxt",
"platform.cpp": "#include \"pxt.h\"\n\n#include \"esp_system.h\"\n#include \"esp_log.h\"\n#include \"driver/gpio.h\"\n#include \"driver/ledc.h\"\n#include \"esp_private/system_internal.h\"\n\nstatic void reset_pin(PinName p) {\n if (p != -1)\n gpio_set_direction((gpio_num_t)p, GPIO_MODE_DISABLE);\n}\n\nvoid reboot_to_uf2(void) {\n reset_pin(PIN(LED_R));\n reset_pin(PIN(LED_G));\n reset_pin(PIN(LED_B));\n\n#if CONFIG_IDF_TARGET_ESP32S2\n // call esp_reset_reason() is required for idf.py to properly links esp_reset_reason_set_hint()\n (void)esp_reset_reason();\n esp_reset_reason_set_hint((esp_reset_reason_t)0x11F2);\n#endif\n\n esp_restart();\n}\n\nnamespace pxt {\n\nstatic void initRandomSeed() {\n seedRandom(esp_random());\n}\n\nextern \"C\" void drawPanic(int code) {\n // TODO\n}\n\n#if CONFIG_IDF_TARGET_ESP32S2\nstatic void bootloader_handler(void *) {\n reboot_to_uf2();\n}\n\nvoid install_gpio0_handler() {\n DMESG(\"reset reason: %x\", esp_reset_reason_get_hint());\n gpio_install_isr_service(0);\n gpio_config_t gpio_conf;\n gpio_conf.intr_type = GPIO_INTR_POSEDGE;\n gpio_conf.mode = GPIO_MODE_INPUT;\n gpio_conf.pin_bit_mask = (1ULL << GPIO_NUM_0);\n gpio_conf.pull_down_en = GPIO_PULLDOWN_DISABLE;\n gpio_conf.pull_up_en = GPIO_PULLUP_ENABLE;\n gpio_config(&gpio_conf);\n gpio_isr_handler_add(GPIO_NUM_0, bootloader_handler, NULL);\n}\n#else\nvoid install_gpio0_handler() {\n gpio_install_isr_service(0);\n}\n#endif\n\nextern \"C\" void usb_init();\nextern \"C\" void target_init() {\n initRandomSeed();\n memInfo();\n usb_init();\n}\n\nvoid updateScreen(Image_ img);\n\nvoid screen_init() {\n updateScreen(NULL);\n}\n\nvoid memInfo() {\n // heap_caps_print_heap_info(MALLOC_CAP_DEFAULT);\n DMESG(\"mem: %d free (%d total)\", heap_caps_get_free_size(MALLOC_CAP_DEFAULT),\n heap_caps_get_total_size(MALLOC_CAP_DEFAULT));\n}\n\nvoid (*logJDFrame)(const uint8_t *data);\nvoid (*sendJDFrame)(const uint8_t *data);\n\n} // namespace pxt\n",
"platform.h": "#ifndef __PXT_PLATFORM_H\n#define __PXT_PLATFORM_H\n\n#include \"esp_timer.h\"\n#include \"esp_system.h\"\n#include \"freertos/FreeRTOS.h\"\n#include \"freertos/task.h\"\n\n#define PXT_ESP32 1\n\n#if CONFIG_IDF_TARGET_ESP32S2\n#define PXT_USB 1\n#else\n#define PXT_USB 0\n#endif\n\n#define PAGE_SIZE 1024 // not really\n\n#define DEV_NUM_PINS 50\n\n#define DEV_PWM_PINS 0xffff_ffff_ffffULL\n#define DEV_AIN_PINS 0ULL\n\n// Codal doesn't yet distinguish between PWM and AIN\n#define DEV_ANALOG_PINS (DEV_PWM_PINS | DEV_AIN_PINS)\n\nnamespace pxt {\nclass ZPin;\nclass AbstractButton;\nclass MultiButton;\nclass Button;\nclass CodalComponent;\n\ntypedef int8_t PinName;\n\ntypedef void (*reset_fn_t)();\nvoid registerResetFunction(reset_fn_t fn);\nvoid soft_panic(int errorCode);\n\nextern TaskHandle_t userCodeTask;\n\nvoid install_gpio0_handler();\n\n} // namespace pxt\n\n#define IMAGE_BITS 4\n\n#define PXT_IN_ISR() (xTaskGetCurrentTaskHandle() != userCodeTask)\n\n#define GC_BLOCK_SIZE (1024 * 16)\n\n#define PXT_REGISTER_RESET(fn) pxt::registerResetFunction(fn)\n\n#ifdef CONFIG_IDF_TARGET_ESP32S2\n// 0x3f000000-... range of data SPI flash (we only support first 4M)\n#define PXT_IS_READONLY(v) (isTagged(v) || ((uintptr_t)v >> 22) == 0xfc)\n#else\n// 0x3f400000-0x3f700000 range of data SPI flash\n#define PXT_IS_READONLY(v) (isTagged(v) || ((uintptr_t)v >> 22) == 0xfd)\n#endif\n\n\n#define CODAL_PIN ::pxt::ZPin\n\nextern \"C\" {\nextern const uintptr_t PXT_EXPORTData[];\n}\n\n#ifdef CONFIG_IDF_TARGET_ESP32S2\n#define WORKER_CPU PRO_CPU_NUM\n#else\n#define WORKER_CPU APP_CPU_NUM\n#endif\n\n#endif\n",
"platform_includes.h": "#include \n#include \n#include \n#include \n#include \n#include \n\n#define PROCESSOR_WORD_TYPE uintptr_t\n",
"pxt.h": "#ifndef __PXT_H\n#define __PXT_H\n\n#include \"pxtbase.h\"\n#include \"vm.h\"\n#include \"pins.h\"\n#include \"pintarget.h\"\n\n#define OUTPUT_BITS 12\n\n#define DEVICE_EVT_ANY 0\n#define DEVICE_ID_NOTIFY_ONE 1022\n#define DEVICE_ID_NOTIFY 1023\n\n#define CHK(call) \\\n { \\\n int __r = call; \\\n if (__r != 0) { \\\n DMESG(\"fail: %d at %d\", __r, __LINE__); \\\n abort(); \\\n } \\\n }\n\nnamespace pxt {\nvoid raiseEvent(int id, int event);\nint allocateNotifyEvent();\nvoid sleep_core_us(uint64_t us);\n\nclass Button;\ntypedef Button *Button_;\n\nextern volatile bool paniced;\nextern char **initialArgv;\nvoid target_exit();\nextern volatile int panicCode;\n\n// Buffer, Sound, and Image share representation.\ntypedef Buffer Sound;\n\n\ntypedef struct worker *worker_t;\nworker_t worker_alloc(const char *id, uint32_t stack_size);\nint worker_run(worker_t w, TaskFunction_t fn, void *arg);\nint worker_run_wait(worker_t w, TaskFunction_t fn, void *arg);\nvoid worker_set_idle(worker_t w, TaskFunction_t fn, void *arg);\nextern worker_t fg_worker;\n\nvoid memInfo();\n\nextern void (*logJDFrame)(const uint8_t *data);\nextern void (*sendJDFrame)(const uint8_t *data);\n\n} // namespace pxt\n\nextern \"C\" void target_disable_irq();\nextern \"C\" void target_enable_irq();\nextern \"C\" void target_init();\nextern \"C\" void target_wait_us(uint32_t us);\n\n#define DEVICE_ID_JACDAC 30\n#define DEVICE_ID_JACDAC_PHYS 31\n\n#undef PXT_MAIN\n#define PXT_MAIN \\\n extern \"C\" int app_main() { \\\n pxt::vmStart(); \\\n return 0; \\\n }\n\n#undef PXT_SHIMS_BEGIN\n#define PXT_SHIMS_BEGIN \\\n namespace pxt { \\\n const OpcodeDesc staticOpcodes[] __attribute__((aligned(0x20))) = {\n\n#undef PXT_SHIMS_END\n#define PXT_SHIMS_END \\\n { 0, 0, 0 } \\\n } \\\n ; \\\n }\n\n#endif\n",
"pxt.json": "{\n \"name\": \"core---esp32\",\n \"description\": \"The core library for Codal-based targets\",\n \"dependencies\": {\n \"base\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"Makefile\",\n \"certs.mk\",\n \"dal.d.ts\",\n \"scheduler.cpp\",\n \"config.cpp\",\n \"target.cpp\",\n \"dmesg.cpp\",\n \"dmesg.h\",\n \"usb.cpp\",\n \"pxt.h\",\n \"platform.h\",\n \"platform.cpp\",\n \"pxtcore.h\",\n \"uf2hid.h\",\n \"pins.h\",\n \"pins.cpp\",\n \"pintarget.cpp\",\n \"pintarget.h\",\n \"pinsDigital.cpp\",\n \"pins.ts\",\n \"pinscompat.ts\",\n \"control.cpp\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"ns.ts\",\n \"timer.ts\",\n \"platform_includes.h\",\n \"codalemu.cpp\",\n \"keys.cpp\",\n \"vm.cpp\",\n \"vm.h\",\n \"verify.cpp\",\n \"vmload.cpp\",\n \"worker.cpp\",\n \"crypto.cpp\",\n \"crypto.ts\",\n \"pxtparts.json\",\n \"CMakeLists.txt\",\n \"sdkconfig.defaults\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"dalDTS\": {\n \"includeDirs\": [\n \"main\"\n ],\n \"excludePrefix\": []\n },\n \"yotta\": {\n \"config\": {\n \"codal\": {\n \"component_count\": 64,\n \"dmesg_buffer_size\": 1024\n }\n }\n }\n}\n",
"pxtcore.h": "#ifndef __PXTCORE_H\n#define __PXTCORE_H\n\n#include \n#include \n#include \n\nnamespace pxt {\nvoid *gcAllocBlock(size_t sz);\nvoid vm_stack_trace();\n}\n\nextern \"C\" void dmesg(const char *fmt, ...);\nextern \"C\" void vdmesg(const char *format, va_list arg);\n#define DMESG ::dmesg\n\nstatic inline void itoa(int v, char *dst) {\n snprintf(dst, 30, \"%d\", v);\n}\n\nextern \"C\" void *xmalloc(size_t sz);\n#define xfree free\n\n#define GC_ALLOC_BLOCK gcAllocBlock\n\n#ifndef POKY\n// This seems to degrade performance - probably due to cache size\n//#define GC_BLOCK_SIZE (1024 * 64)\n#endif\n\n#define PXT_HARD_FLOAT 1\n\n#endif\n",
"pxtparts.json": "{\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\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createStrip,light.createNeoPixelStrip\",\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 \"dotstar\": {\n \"simulationBehavior\": \"dotstar\",\n \"visual\": {\n \"builtIn\": \"dotstar\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 1\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createAPA102Strip\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"dataPin\"\n },\n {\n \"pinInstantiationIdx\": 1,\n \"partParameter\": \"clkPin\"\n },\n {\n \"partParameter\": \"mode\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n },\n \"pixels\": {\n \"simulationBehavior\": \"pixels\",\n \"visual\": { \n \"builtIn\": \"pixels\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"MOSI\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"SCK\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\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, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n }, \n \"buttons\": {\n \"simulationBehavior\": \"buttons\",\n \"visual\": {\n \"builtIn\": \"buttons\",\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 },\n \"numberOfPins\": 2,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"Button.onEvent,Button.isPressed,Button.wasPressed\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"button\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n }\n ]\n },\n \"slideswitch\": {\n \"numberOfPins\": 3,\n \"simulationBehavior\": \"slideswitch\",\n \"visual\": {\n \"builtIn\": \"slideswitch\",\n \"width\": 100,\n \"height\": 100,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 30,\n \"y\": 0\n },\n {\n \"x\": 45,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalRead,DigitalInOutPin.onPulsed,DigitalInOutPin.onEvent\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"pin\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\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 \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"PwmOnlyPin.servoWrite,servos.Servo.setAngle,servos.Servo.run,servos.Servo.setPulse\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\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 \"led\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"analogled\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogOutPin.analogWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"photocell\": {\n \"numberOfPins\": 3,\n \"visual\": {\n \"builtIn\": \"photocell\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 15,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"photocell\",\n \"pinDefinitions\": [\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogInPin.analogRead\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n }\n}",
"scheduler.cpp": "#include \"pxt.h\"\n\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n\n#ifndef PXT_ESP32\n// __MINGW32__ is defined on both mingw32 and mingw64\n#ifdef __MINGW32__\n#include \n#else\n#include \n#endif\n#endif\n\n#define HANDLER_RUNNING 0x0001\n\n// should this be something like CXX11 or whatever?\n#define THROW throw()\n#define THREAD_DBG(...)\n\nstatic uint8_t in_xmalloc_panic;\n\nvoid *xmalloc(size_t sz) {\n auto r = malloc(sz);\n if (r == NULL) {\n DMESG(\"failed to allocate %d bytes\", sz);\n if (in_xmalloc_panic) {\n target_panic(PANIC_GC_OOM);\n } else {\n in_xmalloc_panic = 1;\n soft_panic(PANIC_GC_OOM); // this can happen on esp32 etc; shouldn't on linux/ios etc\n }\n }\n return r;\n}\n\nvoid *operator new(size_t size) {\n return xmalloc(size);\n}\nvoid *operator new[](size_t size) {\n return xmalloc(size);\n}\n\nvoid operator delete(void *p)THROW {\n xfree(p);\n}\nvoid operator delete[](void *p) THROW {\n xfree(p);\n}\n\nuint8_t *gcBase;\n\nnamespace pxt {\n\n#ifndef PXT_ESP32\nstatic uint64_t startTime;\n#endif\n\nFiberContext *allFibers;\nFiberContext *currentFiber;\nstatic pthread_mutex_t eventMutex;\nstatic pthread_cond_t newEventBroadcast;\n\nstatic struct Event *eventHead, *eventTail;\n\nstruct Event {\n struct Event *next;\n int source;\n int value;\n};\n\nEvent lastEvent;\n\nEvent *mkEvent(int source, int value) {\n auto res = new Event();\n memset(res, 0, sizeof(Event));\n res->source = source;\n res->value = value;\n return res;\n}\n\nvolatile int panicCode;\nextern \"C\" void drawPanic(int code);\n\nvoid schedule() {\n auto f = currentFiber;\n if (!f->wakeTime && !f->waitSource)\n oops(55);\n f->resumePC = f->pc;\n f->pc = NULL; // this will break the exec_loop()\n}\n\nvoid dmesg_flush();\n\nstatic void panic_core(int error_code) {\n int prevErr = errno;\n\n panicCode = error_code;\n\n drawPanic(error_code);\n\n DMESG(\"PANIC %d\", error_code % 1000);\n DMESG(\"errno=%d %s\", prevErr, strerror(prevErr));\n\n dmesg_flush();\n}\n\nextern \"C\" void target_panic(int error_code) {\n panic_core(error_code);\n\n#if defined(PXT_ESP32)\n // sleep_core_us(5 * 1000 * 1000);\n abort();\n#elif defined(PXT_VM)\n systemReset();\n#else\n while (1)\n sleep_core_us(10000);\n#endif\n}\n\nDLLEXPORT int pxt_get_panic_code() {\n return panicCode;\n}\n\nvoid ets_log_dmesg();\nvoid soft_panic(int errorCode) {\n if (errorCode >= 999)\n errorCode = 999;\n if (errorCode <= 0)\n errorCode = 1;\n vm_stack_trace();\n panic_core(1000 + errorCode);\n#if defined(PXT_ESP32)\n ets_log_dmesg();\n sleep_core_us(4000000);\n abort();\n#else\n systemReset();\n#endif\n}\n\nvoid sleep_core_us(uint64_t us) {\n#ifdef PXT_ESP32\n uint64_t endp = esp_timer_get_time() + us;\n while (esp_timer_get_time() < endp)\n ;\n#else\n struct timespec ts;\n ts.tv_sec = us / 1000000;\n ts.tv_nsec = (us % 1000000) * 1000;\n while (nanosleep(&ts, &ts))\n ;\n#endif\n}\n\nvoid target_yield() {\n#ifdef PXT_ESP32\n vTaskDelay(1);\n#else\n sleep_core_us(1000);\n#endif\n}\n\nvoid sleep_ms(uint32_t ms) {\n currentFiber->wakeTime = current_time_ms() + ms;\n schedule();\n}\n\nvoid sleep_us(uint64_t us) {\n if (us > 20000) {\n sleep_ms((uint32_t)(us / 1000));\n } else {\n sleep_core_us(us);\n }\n}\n\n#ifndef PXT_ESP32\nstatic uint64_t currTime() {\n struct timeval tv;\n gettimeofday(&tv, NULL);\n return tv.tv_sec * 1000000LL + tv.tv_usec;\n}\n\nuint64_t current_time_us() {\n if (!startTime)\n startTime = currTime();\n return currTime() - startTime;\n}\n#endif\n\nint current_time_ms() {\n return (int)(current_time_us() / 1000);\n}\n\nvoid disposeFiber(FiberContext *t) {\n if (allFibers == t) {\n allFibers = t->next;\n } else {\n for (auto tt = allFibers; tt; tt = tt->next) {\n if (tt->next == t) {\n tt->next = t->next;\n break;\n }\n }\n }\n\n // DMESG(\"free: %p %p\", t, t->stackCopy);\n\n xfree(t->stackCopy);\n xfree(t);\n\n if (currentFiber == t)\n currentFiber = NULL;\n}\n\n#define INITIAL_STACK_COPY_SIZE 16\n\nFiberContext *setupThread(Action a, TValue arg = 0, HandlerBinding *hb = NULL) {\n#if 0\n int numThreads = 0;\n for (auto p = allFibers; p; p = p->next)\n numThreads++;\n DMESG(\"setup thread: %p #%d\", a, numThreads);\n //if (numThreads > 10)\n // abort();\n#endif\n auto t = (FiberContext *)xmalloc(sizeof(FiberContext));\n memset(t, 0, sizeof(*t));\n if (!vmImg->stackBase) {\n vmImg->stackBase = (TValue *)xmalloc(VM_STACK_SIZE * sizeof(TValue));\n vmImg->stackTop = vmImg->stackBase + VM_STACK_SIZE;\n vmImg->stackLimit = vmImg->stackBase + VM_MAX_FUNCTION_STACK + 5;\n }\n t->stackCopy = (TValue *)xmalloc(sizeof(TValue) * INITIAL_STACK_COPY_SIZE);\n t->stackCopySize = INITIAL_STACK_COPY_SIZE;\n t->sp = vmImg->stackTop - 8;\n\n // DMESG(\"thr: %p %p\", t, t->stackCopy);\n\n auto ptr = t->stackCopy;\n *ptr++ = TAG_STACK_BOTTOM;\n *ptr++ = 0;\n *ptr++ = arg;\n *ptr++ = 0;\n *ptr++ = 0;\n *ptr++ = 0;\n *ptr++ = 0;\n *ptr++ = (TValue)0xf00df00df00df00d;\n\n t->handlerBinding = hb;\n auto ra = (RefAction *)a;\n // we only pass 1 argument, but can in fact handle up to 4\n if (ra->numArgs > 2)\n target_panic(PANIC_INVALID_IMAGE);\n t->currAction = ra;\n t->resumePC = actionPC(ra);\n\n t->img = vmImg;\n t->imgbase = (uint16_t *)vmImg->dataStart;\n\n // add at the end\n if (allFibers)\n for (auto p = allFibers; p; p = p->next) {\n if (!p->next) {\n p->next = t;\n break;\n }\n }\n else\n allFibers = t;\n\n return t;\n}\n\nvoid runInParallel(Action a) {\n setupThread(a);\n}\n\nvoid runForever(Action a) {\n auto f = setupThread(a);\n f->foreverPC = f->resumePC;\n}\n\nvoid waitForEvent(int source, int value) {\n currentFiber->waitSource = source;\n currentFiber->waitValue = value;\n schedule();\n}\n\nFiberContext *suspendFiber() {\n currentFiber->waitSource = PXT_WAIT_SOURCE_PROMISE;\n schedule();\n return currentFiber;\n}\n\nvoid resumeFiberWithFn(FiberContext *ctx, fiber_resume_t fn, void *arg) {\n if (ctx->waitSource != PXT_WAIT_SOURCE_PROMISE)\n oops(52);\n ctx->waitSource = 0;\n ctx->wakeFn = fn;\n ctx->wakeFnArg = arg;\n}\n\nvoid resumeFiber(FiberContext *ctx, TValue v) {\n if (ctx->waitSource != PXT_WAIT_SOURCE_PROMISE)\n oops(52);\n ctx->waitSource = 0;\n ctx->r0 = v;\n}\n\nstatic void startHandler(HandlerBinding *hb, Event &e) {\n if (!hb)\n return;\n lastEvent = e; // this is quite racy\n if (hb->flags & HANDLER_RUNNING) {\n auto tmp = mkEvent(e.source, e.value);\n if (hb->pending == NULL) {\n hb->pending = tmp;\n } else {\n int numev = 0;\n auto p = hb->pending;\n for (; p->next; p = p->next)\n numev++;\n if (numev >= 10) {\n xfree(tmp);\n return;\n }\n p->next = tmp;\n }\n } else {\n hb->flags |= HANDLER_RUNNING;\n setupThread(hb->action, fromInt(e.value), hb);\n }\n}\n\nstatic void dispatchEvent(Event &e) {\n startHandler(findBinding(e.source, e.value), e);\n startHandler(findBinding(e.source, DEVICE_EVT_ANY), e);\n}\n\nstatic void wakeFibers() {\n for (;;) {\n pthread_mutex_lock(&eventMutex);\n if (eventHead == NULL) {\n pthread_mutex_unlock(&eventMutex);\n return;\n }\n Event *ev = eventHead;\n eventHead = ev->next;\n if (eventHead == NULL)\n eventTail = NULL;\n pthread_mutex_unlock(&eventMutex);\n\n for (auto thr = allFibers; thr; thr = thr->next) {\n if (thr->waitSource == 0)\n continue;\n if (thr->waitValue != ev->value && thr->waitValue != DEVICE_EVT_ANY)\n continue;\n if (thr->waitSource == ev->source) {\n thr->waitSource = 0;\n } else if (thr->waitSource == DEVICE_ID_NOTIFY && ev->source == DEVICE_ID_NOTIFY_ONE) {\n thr->waitSource = 0;\n break; // do not wake up any other threads\n }\n }\n\n dispatchEvent(*ev);\n delete ev;\n }\n}\n\nstatic void saveStack() {\n auto f = currentFiber;\n if (!f)\n return;\n int sizeNeeded = vmImg->stackTop - f->sp;\n // DMESG(\"save %d %p\", sizeNeeded, f);\n if (!f->stackCopy || sizeNeeded > f->stackCopySize) {\n xfree(f->stackCopy);\n f->stackCopySize = sizeNeeded + 10;\n f->stackCopy = (TValue *)xmalloc(f->stackCopySize * sizeof(TValue));\n // DMESG(\" -> %p\", f->stackCopy);\n }\n memcpy(f->stackCopy, f->sp, sizeNeeded * sizeof(TValue));\n}\n\nstatic void restoreStack() {\n auto f = currentFiber;\n memcpy(f->sp, f->stackCopy, (uint8_t *)vmImg->stackTop - (uint8_t *)f->sp);\n}\n\nstatic void mainRunLoop() {\n FiberContext *f = NULL;\n for (;;) {\n if (panicCode)\n return;\n wakeFibers();\n auto now = current_time_ms();\n auto fromBeg = false;\n if (!f) {\n f = allFibers;\n fromBeg = true;\n }\n while (f) {\n if (f->wakeTime && now >= (int)f->wakeTime)\n f->wakeTime = 0;\n if (!f->wakeTime && !f->waitSource)\n break;\n f = f->next;\n }\n if (f) {\n if (currentFiber != f) {\n saveStack();\n currentFiber = f;\n restoreStack();\n }\n f->pc = f->resumePC;\n f->resumePC = NULL;\n if (f->wakeFn) {\n auto fn = f->wakeFn;\n f->wakeFn = NULL;\n f->r0 = fn(f->wakeFnArg);\n if (f->wakeTime || f->waitSource)\n continue; // we got suspended again\n }\n exec_loop(f);\n if (panicCode)\n return;\n auto n = f->next;\n if (f->resumePC == NULL) {\n if (f->foreverPC) {\n f->resumePC = f->foreverPC;\n f->wakeTime = current_time_ms() + 20;\n // restore stack, as setupThread() does it\n for (int i = 0; i < 5; ++i) {\n if (*--f->sp == TAG_STACK_BOTTOM)\n break;\n }\n if (*f->sp != TAG_STACK_BOTTOM)\n target_panic(PANIC_INVALID_IMAGE);\n } else {\n auto hb = f->handlerBinding;\n if (hb) {\n auto pev = hb->pending;\n if (pev) {\n hb->pending = pev->next;\n setupThread(hb->action, fromInt(pev->value), hb);\n xfree(pev);\n } else {\n f->handlerBinding->flags &= ~HANDLER_RUNNING;\n }\n }\n disposeFiber(f);\n }\n }\n f = n;\n } else if (fromBeg) {\n target_yield();\n }\n }\n}\n\nint allocateNotifyEvent() {\n static volatile int notifyId;\n return ++notifyId;\n}\n\nvoid raiseEvent(int id, int event) {\n auto e = mkEvent(id, event);\n pthread_mutex_lock(&eventMutex);\n if (eventTail == NULL) {\n if (eventHead != NULL)\n oops(51);\n eventHead = eventTail = e;\n } else {\n eventTail->next = e;\n eventTail = e;\n }\n pthread_cond_broadcast(&newEventBroadcast);\n pthread_mutex_unlock(&eventMutex);\n}\n\nDLLEXPORT void pxt_raise_event(int id, int event) {\n raiseEvent(id, event);\n}\n\nvoid registerWithDal(int id, int event, Action a, int flags) {\n // TODO support flags\n setBinding(id, event, a);\n}\n\nuint32_t afterProgramPage() {\n return 0;\n}\n\nchar **initialArgv;\n\nvoid screen_init();\nvoid initKeys();\nvoid target_startup();\n\nvoid initRuntime() {\n current_time_ms();\n target_startup();\n\n setupThread((TValue)vmImg->entryPoint);\n\n target_init();\n screen_init();\n initKeys();\n\n DMESG(\"start main loop\");\n\n mainRunLoop();\n systemReset();\n}\n\nvoid *gcAllocBlock(size_t sz) {\n#ifdef PXT_ESP32\n void *r = xmalloc(sz);\n#else\n static uint8_t *currPtr = (uint8_t *)GC_BASE;\n sz = (sz + GC_PAGE_SIZE - 1) & ~(GC_PAGE_SIZE - 1);\n#if defined(PXT64) || defined(__MINGW32__)\n if (!gcBase) {\n gcBase = (uint8_t *)xmalloc(1 << PXT_VM_HEAP_ALLOC_BITS);\n currPtr = gcBase;\n }\n void *r = currPtr;\n if ((uint8_t *)currPtr - gcBase > (1 << PXT_VM_HEAP_ALLOC_BITS) - (int)sz)\n soft_panic(20);\n#else\n void *r = mmap(currPtr, sz, PROT_READ | PROT_WRITE, MAP_PRIVATE | MAP_ANON, -1, 0);\n if (r == MAP_FAILED) {\n DMESG(\"mmap %p failed; err=%d\", currPtr, errno);\n target_panic(PANIC_INTERNAL_ERROR);\n }\n#endif\n currPtr = (uint8_t *)r + sz;\n#endif\n\n if (isReadOnly((TValue)r)) {\n DMESG(\"mmap returned read-only address: %p\", r);\n target_panic(PANIC_INTERNAL_ERROR);\n }\n return r;\n}\n\nvoid gcProcessStacks(int flags) {\n int cnt = 0;\n for (auto f = allFibers; f; f = f->next) {\n TValue *end, *ptr;\n if (f == currentFiber) {\n end = vmImg->stackTop;\n ptr = f->sp;\n } else {\n end = f->stackCopy + (vmImg->stackTop - f->sp);\n ptr = f->stackCopy;\n }\n gcProcess((TValue)f->currAction);\n gcProcess((TValue)f->r0);\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\n#define MAX_RESET_FN 32\nstatic reset_fn_t resetFunctions[MAX_RESET_FN];\n\nvoid registerResetFunction(reset_fn_t fn) {\n for (int i = 0; i < MAX_RESET_FN; ++i) {\n if (!resetFunctions[i]) {\n resetFunctions[i] = fn;\n return;\n }\n }\n\n target_panic(PANIC_INTERNAL_ERROR);\n}\n\nvoid systemReset() {\n#ifdef PXT_ESP32\n esp_restart();\n#else\n if (!panicCode)\n panicCode = -1;\n\n dmesg(\"TARGET RESET\");\n\n gcFreeze();\n\n for (int i = 0; i < MAX_RESET_FN; ++i) {\n auto fn = resetFunctions[i];\n if (fn)\n fn();\n }\n\n coreReset(); // clears handler bindings\n\n currentFiber = NULL;\n while (allFibers) {\n disposeFiber(allFibers);\n }\n\n // this will consume all events, but won't dispatch anything, since all listener maps are empty\n wakeFibers();\n\n // mark all GC memory as free\n gcReset();\n\n pthread_exit(NULL);\n#endif\n}\n\n} // namespace pxt\n",
"sdkconfig.defaults": "CONFIG_NEWLIB_ENABLE=y\nCONFIG_NEWLIB_LIBRARY_LEVEL_NORMAL=y\nCONFIG_NEWLIB_NANO_FORMAT=\nCONFIG_SSL_USING_MBEDTLS=y\nCONFIG_LWIP_IPV6=y\nCONFIG_MBEDTLS_CERTIFICATE_BUNDLE_DEFAULT_NONE=y\nCONFIG_MBEDTLS_CUSTOM_CERTIFICATE_BUNDLE=y\nCONFIG_MBEDTLS_CUSTOM_CERTIFICATE_BUNDLE_PATH=\"certs\"\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace pins {\n\n /**\n * Get a pin by configuration id (DAL.CFG_PIN...)\n */\n //% shim=pins::pinByCfg\n function pinByCfg(key: int32): DigitalInOutPin;\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}\ndeclare namespace control {\n\n /**\n * Enable a watchdog timer that need to be fed or it will reset the device.\n * If timeout is not positive, the watchdog is disabled.\n */\n //% shim=control::setWatchdog\n function setWatchdog(timeout_s: int32): void;\n\n /**\n * Reset timeout on previously enabled watchdog.\n */\n //% shim=control::feedWatchdog\n function feedWatchdog(): void;\n}\n\n\ndeclare interface DigitalInOutPin {\n /**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n //% help=pins/digital-read weight=61\n //% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalRead\n digitalRead(): boolean;\n\n /**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n //% help=pins/digital-write weight=60\n //% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalWrite\n digitalWrite(value: boolean): void;\n\n /**\n * Make this pin a digital input, and create events where the timestamp is the duration\n * that this pin was either ``high`` or ``low``.\n */\n //% help=pins/on-pulsed weight=16 blockGap=8\n //% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4\n //% deprecated=1 hidden=1 shim=DigitalInOutPinMethods::onPulsed\n onPulsed(pulse: PulseValue, body: () => void): void;\n\n /**\n * Register code to run when a pin event occurs. \n */\n //% help=pins/on-event weight=20 blockGap=8\n //% blockId=pinsonevent block=\"on|pin %pin|%event\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 shim=DigitalInOutPinMethods::onEvent\n onEvent(event: PinEvent, body: () => void): void;\n\n /**\n * Return the duration of a pulse in microseconds\n * @param name the pin which measures the pulse\n * @param value the value of the pulse (default high)\n * @param maximum duration in micro-seconds\n */\n //% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n //% weight=18 blockGap=8\n //% help=\"pins/pulse-in\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 maxDuration.defl=2000000 shim=DigitalInOutPinMethods::pulseIn\n pulseIn(value: PulseValue, maxDuration?: int32): int32;\n\n /**\n * Set the pull direction of this pin.\n * @param name pin to set the pull mode on\n * @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n */\n //% help=pins/set-pull weight=17 blockGap=8\n //% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::setPull\n setPull(pull: PinPullMode): void;\n}\ndeclare namespace control {\n\n /**\n * Announce that an event happened to registered handlers.\n * @param src ID of the Component that generated the event\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.\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\"\n //% block=\"raise event|from %src|with value %value\" blockExternalInputs=1\n //% help=control/raise-event shim=control::raiseEvent\n function raiseEvent(src: int32, value: int32): 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 /**\n * Determine the version of system software currently running.\n */\n //% blockId=\"control_device_dal_version\" block=\"device dal version\"\n //% help=control/device-dal-version shim=control::deviceDalVersion\n function deviceDalVersion(): string;\n\n /** Write data to DMESG debugging buffer. */\n //% shim=control::dmesg\n function dmesg(s: string): void;\n\n /**\n * Determines if the USB has been enumerated.\n */\n //% shim=control::isUSBInitialized\n function isUSBInitialized(): boolean;\n}\ndeclare namespace serial {\n\n /** Send DMESG debug buffer over serial. */\n //% shim=serial::writeDmesg\n function writeDmesg(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"target.cpp": "#include \"pxt.h\"\n#include \n#include \n#include \n#include \n#include \n#include \n\n#include \"esp_log.h\"\n\n// make sure compiler doesn't optimize accesses to PXT_EXPORTData in vmload.cpp by placing\n// it in different file (this one)\n// also this is rewritten by pxt; don't rely on values here\n#define PXT_EXPORT(p) (uintptr_t)(void *)(p)\nextern \"C\" {\n__attribute__((used)) __attribute__((aligned(0x20))) const uintptr_t PXT_EXPORTData[] = {\n 0x08010801,\n 0x42424242,\n 0x08010801,\n 0x8de9d83e,\n PXT_EXPORT(&pxt::buffer_vt),\n PXT_EXPORT(&pxt::number_vt),\n PXT_EXPORT(&pxt::RefAction_vtable),\n PXT_EXPORT(&pxt::string_inline_ascii_vt),\n PXT_EXPORT(&pxt::string_skiplist16_packed_vt),\n PXT_EXPORT(&pxt::string_inline_utf8_vt),\n PXT_EXPORT(pxt::RefRecord_destroy),\n PXT_EXPORT(pxt::RefRecord_print),\n PXT_EXPORT(pxt::RefRecord_scan),\n PXT_EXPORT(pxt::RefRecord_gcsize),\n PXT_EXPORT(0),\n};\n}\n\nnamespace pxt {\n\nworker_t fg_worker;\n\nvoid target_exit() {\n systemReset();\n}\n\nextern \"C\" void target_reset() {\n esp_restart();\n}\n\nvoid ets_log_dmesg();\nstatic void fg_worker_idle(void *) {\n ets_log_dmesg();\n}\n\nvoid target_startup() {\n fg_worker = worker_alloc(\"pxt_fg\", 2048);\n worker_set_idle(fg_worker, fg_worker_idle, NULL);\n}\n\nuint64_t getLongSerialNumber() {\n static uint64_t addr;\n if (!addr) {\n uint8_t mac[6];\n esp_efuse_mac_get_default(mac);\n addr = ((uint64_t)0xff << 56) | ((uint64_t)mac[5] << 48) | ((uint64_t)mac[4] << 40) |\n ((uint64_t)mac[3] << 32) | ((uint64_t)mac[2] << 24) | ((uint64_t)mac[1] << 16) |\n ((uint64_t)mac[0] << 8) | ((uint64_t)0xfe << 0);\n }\n return addr;\n}\n\nvoid deepSleep() {\n // nothing to do\n}\n\nuint64_t current_time_us() {\n static uint64_t start_time;\n if (!start_time) {\n // try to synchronize with log timestamp\n start_time = esp_timer_get_time() - esp_log_timestamp() * 1000;\n }\n return esp_timer_get_time() - start_time;\n}\n\n} // namespace pxt\n",
"test.ts": "let i = 1\nlet f = 0.5\nlet plus = i + f\nlet minus = i - f\n\nlet r = Math.random()\nlet ri = Math.randomRange(5, 10)\n\n",
"timer.ts": "namespace control {\n /**\n * A timer\n */\n //% fixedInstances\n export class Timer {\n start: number;\n\n constructor() {\n this.start = control.millis();\n }\n\n /**\n * Gets the elapsed time in millis since the last reset\n */\n //% blockId=timerMillis block=\"%timer|millis\"\n millis(): number {\n return control.millis() - this.start;\n }\n\n /**\n * Gets the elapsed time in seconds since the last reset\n */\n //% blockId=timerSeconds block=\"%timer|seconds\"\n seconds(): number {\n return this.millis() / 1000;\n }\n\n /**\n * Resets the timer\n */\n //% blockId=timerRest block=\"%timer|reset\"\n reset() {\n this.start = control.millis();\n }\n\n /**\n * Pauses until the timer reaches the given amount of milliseconds\n * @param ms how long to pause for, eg: 5, 100, 200, 500, 1000, 2000\n */\n //% blockId=timerPauseUntil block=\"%timer|pause until (ms) %ms\"\n pauseUntil(ms: number) {\n const remaining = this.millis() - ms;\n pause(Math.max(0, remaining));\n }\n }\n\n //% whenUsed fixedInstance block=\"timer 1\"\n export const timer1 = new Timer();\n //% whenUsed fixedInstance block=\"timer 2\"\n export const timer2 = new Timer();\n //% whenUsed fixedInstance block=\"timer 3\"\n export const timer3 = new Timer();\n //% whenUsed fixedInstance block=\"timer 4\"\n export const timer4 = new Timer();\n //% whenUsed fixedInstance block=\"timer 5\"\n export const timer5 = new Timer();\n //% whenUsed fixedInstance block=\"timer 6\"\n export const timer6 = new Timer();\n //% whenUsed fixedInstance block=\"timer 7\"\n export const timer7 = new Timer();\n //% whenUsed fixedInstance block=\"timer 8\"\n export const timer8 = new Timer();\n}",
"uf2hid.h": "#ifndef UF2_HID_H\n#define UF2_HID_H 1\n\n#define HF2_CMD_BININFO 0x0001\n// no arguments\n#define HF2_MODE_BOOTLOADER 0x01\n#define HF2_MODE_USERSPACE 0x02\nstruct HF2_BININFO_Result {\n uint32_t mode;\n uint32_t flash_page_size;\n uint32_t flash_num_pages;\n uint32_t max_message_size;\n uint32_t uf2_family;\n};\n\n#define HF2_CMD_INFO 0x0002\n// no arguments\n// results is utf8 character array\n\n#define HF2_CMD_RESET_INTO_APP 0x0003\n// no arguments, no result\n\n#define HF2_CMD_RESET_INTO_BOOTLOADER 0x0004\n// no arguments, no result\n\n#define HF2_CMD_START_FLASH 0x0005\n// no arguments, no result\n\n#define HF2_CMD_WRITE_FLASH_PAGE 0x0006\nstruct HF2_WRITE_FLASH_PAGE_Command {\n uint32_t target_addr;\n uint32_t data[0];\n};\n// no result\n\n#define HF2_CMD_CHKSUM_PAGES 0x0007\nstruct HF2_CHKSUM_PAGES_Command {\n uint32_t target_addr;\n uint32_t num_pages;\n};\nstruct HF2_CHKSUM_PAGES_Result {\n uint16_t chksums[0 /* num_pages */];\n};\n\n#define HF2_CMD_READ_WORDS 0x0008\nstruct HF2_READ_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n};\nstruct HF2_READ_WORDS_Result {\n uint32_t words[0 /* num_words */];\n};\n\n#define HF2_CMD_WRITE_WORDS 0x0009\nstruct HF2_WRITE_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n uint32_t words[0 /* num_words */];\n};\n// no result\n\n#define HF2_CMD_DMESG 0x0010\n// no arguments\n// results is utf8 character array\n\n#define HF2_EV_MASK 0x800000\n\n#define HF2_CMD_JDS_CONFIG 0x0020\n#define HF2_CMD_JDS_SEND 0x0021\n#define HF2_EV_JDS_PACKET 0x800020\n\ntypedef struct {\n uint32_t command_id;\n uint16_t tag;\n uint8_t reserved0;\n uint8_t reserved1;\n\n union {\n struct HF2_WRITE_FLASH_PAGE_Command write_flash_page;\n struct HF2_WRITE_WORDS_Command write_words;\n struct HF2_READ_WORDS_Command read_words;\n struct HF2_CHKSUM_PAGES_Command chksum_pages;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Command;\n\ntypedef struct {\n union {\n uint32_t eventId;\n struct {\n uint16_t tag;\n union {\n struct {\n uint8_t status;\n uint8_t status_info;\n };\n uint16_t status16;\n };\n };\n };\n union {\n struct HF2_BININFO_Result bininfo;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Response;\n\n#define HF2_FLAG_SERIAL_OUT 0x80\n#define HF2_FLAG_SERIAL_ERR 0xC0\n#define HF2_FLAG_CMDPKT_LAST 0x40\n#define HF2_FLAG_CMDPKT_BODY 0x00\n#define HF2_FLAG_MASK 0xC0\n#define HF2_SIZE_MASK 63\n\n#define HF2_STATUS_OK 0x00\n#define HF2_STATUS_INVALID_CMD 0x01\n#define HF2_STATUS_INVALID_STATE 0x02\n\n#endif\n",
"usb.cpp": "#include \"pxt.h\"\n#include \"esp_log.h\"\n#if PXT_USB\n#include \"tinyusb.h\"\n#include \"tusb_cdc_acm.h\"\n#include \"uf2hid.h\"\n#endif\n\n#define LOG(msg, ...) DMESG(\"USB: \" msg, ##__VA_ARGS__)\n#define LOGV(msg, ...) ((void)0)\n#define ERROR(msg, ...) DMESG(\"USB-ERROR: \" msg, ##__VA_ARGS__)\n\n#if !PXT_USB\n\nextern \"C\" void usb_init() {}\n\n#else\n\n// 260 bytes needed for biggest JD packets (with overheads)\n#define HF2_BUF_SIZE 260\n\ntypedef struct {\n uint16_t size;\n uint8_t serial;\n union {\n uint8_t buf[HF2_BUF_SIZE];\n uint32_t buf32[HF2_BUF_SIZE / 4];\n uint16_t buf16[HF2_BUF_SIZE / 2];\n HF2_Command cmd;\n HF2_Response resp;\n };\n} HF2_Buffer;\n\nclass HF2 {\n bool gotSomePacket;\n // uint32_t lastExchange;\n\n public:\n bool connected;\n HF2_Buffer pkt;\n\n int sendResponse(int size);\n void recv(uint8_t buf[64]);\n int sendResponseWithData(const void *data, int size);\n int sendEvent(uint32_t evId, const void *data, int size);\n void sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend = -1);\n int handlePkt(int sz);\n int sendSerial(const void *data, int size, int isError = 0);\n\n HF2() {}\n};\n\nstatic HF2 hf2;\n\nstatic const char *descriptor_str[USB_STRING_DESCRIPTOR_ARRAY_SIZE] = {\n // array of pointer to string descriptors\n (char[]){0x09, 0x04}, // 0: is supported language is English (0x0409)\n CONFIG_USB_DESC_MANUFACTURER_STRING, // 1: Manufacturer\n \"PXT Device (app)\", // 2: Product\n \"\", // 3: Serials -> replaced\n\n#if CONFIG_USB_CDC_ENABLED\n CONFIG_USB_DESC_CDC_STRING, // 4: CDC Interface\n#else\n \"\",\n#endif\n\n#if CONFIG_USB_MSC_ENABLED\n CONFIG_USB_DESC_MSC_STRING, // 5: MSC Interface\n#else\n \"\",\n#endif\n\n#if CONFIG_USB_HID_ENABLED\n CONFIG_USB_DESC_HID_STRING // 6: HIDs\n#else\n \"\",\n#endif\n};\n\nstatic void on_cdc_rx(int itf0, cdcacm_event_t *event) {\n /* initialization */\n uint8_t buf[CONFIG_USB_CDC_RX_BUFSIZE];\n size_t rx_size = 0;\n tinyusb_cdcacm_itf_t itf = (tinyusb_cdcacm_itf_t)itf0;\n\n /* read */\n esp_err_t ret = tinyusb_cdcacm_read(itf, buf, CONFIG_USB_CDC_RX_BUFSIZE, &rx_size);\n if (ret == ESP_OK) {\n LOGV(\"%d (%d)\", rx_size, buf[0]);\n hf2.recv(buf);\n } else {\n ERROR(\"Read error\");\n }\n}\n\nstatic void on_cdc_line_state_changed(int itf, cdcacm_event_t *event) {\n hf2.connected = event->line_state_changed_data.dtr && event->line_state_changed_data.rts;\n LOG(\"connected: %d\", hf2.connected);\n}\n\nextern \"C\" void usb_init() {\n LOG(\"init\");\n tinyusb_config_t tusb_cfg;\n memset(&tusb_cfg, 0, sizeof(tusb_cfg));\n\n uint8_t mac[6];\n esp_efuse_mac_get_default(mac);\n static char macHex[15];\n macHex[0] = 'P';\n macHex[1] = 'X';\n for (int i = 0; i < 6; ++i) {\n snprintf(macHex + (2 + i * 2), 3, \"%02X\", mac[i]);\n }\n DMESG(\"USB serial: %s\", macHex);\n descriptor_str[3] = macHex;\n tusb_cfg.string_descriptor = (char **)descriptor_str;\n\n ESP_ERROR_CHECK(tinyusb_driver_install(&tusb_cfg));\n\n tinyusb_config_cdcacm_t amc_cfg;\n memset(&amc_cfg, 0, sizeof(amc_cfg));\n amc_cfg.usb_dev = TINYUSB_USBDEV_0;\n amc_cfg.cdc_port = TINYUSB_CDC_ACM_0;\n amc_cfg.rx_unread_buf_sz = 64;\n amc_cfg.callback_rx = &on_cdc_rx;\n amc_cfg.callback_line_state_changed = &on_cdc_line_state_changed;\n ESP_ERROR_CHECK(tusb_cdc_acm_init(&amc_cfg));\n\n LOG(\"init done\");\n}\n\nvoid HF2::recv(uint8_t buf[64]) {\n uint8_t tag = buf[0];\n if (pkt.size && (tag & HF2_FLAG_SERIAL_OUT)) {\n ERROR(\"serial in middle of cmd\");\n return;\n }\n\n int size = tag & HF2_SIZE_MASK;\n if (pkt.size + size > (int)sizeof(pkt.buf)) {\n ERROR(\"pkt too large\");\n return;\n }\n\n memcpy(pkt.buf + pkt.size, buf + 1, size);\n pkt.size += size;\n tag &= HF2_FLAG_MASK;\n if (tag != HF2_FLAG_CMDPKT_BODY) {\n if (tag == HF2_FLAG_CMDPKT_LAST)\n pkt.serial = 0;\n else if (tag == HF2_FLAG_SERIAL_OUT)\n pkt.serial = 1;\n else\n pkt.serial = 2;\n int sz = pkt.size;\n pkt.size = 0;\n handlePkt(sz);\n }\n}\n\nconst char *uf2_info() {\n return \"ESP32-S2\";\n}\n\nvoid reboot_to_uf2(void);\n\nstatic void jdLog(const uint8_t *frame) {\n hf2.sendEvent(HF2_EV_JDS_PACKET, frame, frame[2] + 12);\n}\n\nint HF2::handlePkt(int sz) {\n if (pkt.serial) {\n // TODO raise some event?\n return 0;\n }\n\n LOGV(\"HF2 sz=%d CMD=%x\", sz, pkt.buf32[0]);\n\n // one has to be careful dealing with these, as they share memory\n HF2_Command *cmd = &pkt.cmd;\n HF2_Response *resp = &pkt.resp;\n\n uint32_t cmdId = cmd->command_id;\n resp->tag = cmd->tag;\n resp->status16 = HF2_STATUS_OK;\n\n //#define checkDataSize(str, add) assert(sz == 8 + (int)sizeof(cmd->str) + (int)(add))\n\n // lastExchange = current_time_ms();\n gotSomePacket = true;\n\n switch (cmdId) {\n case HF2_CMD_INFO:\n return sendResponseWithData(uf2_info(), strlen(uf2_info()));\n\n case HF2_CMD_BININFO:\n resp->bininfo.mode = HF2_MODE_USERSPACE;\n resp->bininfo.flash_page_size = 0;\n resp->bininfo.flash_num_pages = 0;\n resp->bininfo.max_message_size = sizeof(pkt.buf);\n resp->bininfo.uf2_family = 0xbfdd4eee;\n return sendResponse(sizeof(resp->bininfo));\n\n case HF2_CMD_RESET_INTO_APP:\n target_reset();\n break;\n\n case HF2_CMD_RESET_INTO_BOOTLOADER:\n reboot_to_uf2();\n break;\n\n case HF2_CMD_DMESG:\n // TODO\n break;\n\n case HF2_CMD_JDS_CONFIG:\n if (cmd->data8[0]) {\n pxt::logJDFrame = jdLog;\n } else {\n pxt::logJDFrame = NULL;\n }\n return sendResponse(0);\n\n case HF2_CMD_JDS_SEND:\n if (pxt::sendJDFrame) {\n pxt::sendJDFrame(cmd->data8);\n return sendResponse(0);\n } else {\n resp->status16 = HF2_STATUS_INVALID_STATE;\n return sendResponse(0);\n }\n\n default:\n // command not understood\n resp->status16 = HF2_STATUS_INVALID_CMD;\n break;\n }\n\n return sendResponse(0);\n}\n\nstruct BufferEntry {\n unsigned size;\n uint8_t flag;\n uint8_t data[0];\n};\n\nstatic void send_buffer_core(void *ent_) {\n auto ent = (BufferEntry *)ent_;\n\n uint32_t buf[64 / 4]; // aligned\n auto size = ent->size;\n auto data = ent->data;\n\n while (hf2.connected && size > 0) {\n memset(buf + 1, 0, 60);\n int s = 63;\n if (size <= 63) {\n s = size;\n buf[0] = ent->flag;\n } else {\n buf[0] = ent->flag == HF2_FLAG_CMDPKT_LAST ? HF2_FLAG_CMDPKT_BODY : ent->flag;\n }\n buf[0] |= s;\n uint8_t *dst = (uint8_t *)buf;\n dst++;\n memcpy(dst, data, s);\n data = data + s;\n size -= s;\n\n if (tinyusb_cdcacm_write_queue(TINYUSB_CDC_ACM_0, (uint8_t *)buf, sizeof(buf)) <\n sizeof(buf))\n DMESG(\"CDC write fail\");\n // tinyusb_cdcacm_write_flush(TINYUSB_CDC_ACM_0, 0); - prints warnings\n }\n\n xfree(ent);\n}\n\nvoid HF2::sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend) {\n if (!connected)\n return;\n\n if (prepend + 1)\n size += 4;\n\n auto ent = (BufferEntry *)xmalloc(sizeof(BufferEntry) + size);\n ent->size = size;\n ent->flag = flag;\n auto dst = ent->data;\n\n if (prepend + 1) {\n memcpy(dst, &prepend, 4);\n dst += 4;\n size -= 4;\n }\n\n memcpy(dst, data, size);\n\n if (worker_run_wait(fg_worker, send_buffer_core, ent))\n DMESG(\"HF2 queue full\");\n}\n\nint HF2::sendEvent(uint32_t evId, const void *data, int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, evId);\n return 0;\n}\n\nint HF2::sendSerial(const void *data, int size, int isError) {\n if (!connected)\n return 0;\n\n sendBuffer(isError ? HF2_FLAG_SERIAL_ERR : HF2_FLAG_SERIAL_OUT, data, size);\n\n return 0;\n}\n\nint HF2::sendResponse(int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, pkt.buf, 4 + size);\n return 0;\n}\n\nint HF2::sendResponseWithData(const void *data, int size) {\n if (size <= (int)sizeof(pkt.buf) - 4) {\n memcpy(pkt.resp.data8, data, size);\n return sendResponse(size);\n } else {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, pkt.resp.eventId);\n return 0;\n }\n}\n\n#endif\n\nnamespace pxt {\nvoid sendSerial(const char *data, int len) {\n ets_printf(LOG_BOLD(LOG_COLOR_PURPLE) \"%s\" LOG_RESET_COLOR, data);\n#if PXT_USB\n hf2.sendSerial(data, len);\n#endif\n}\n} // namespace pxt\n\n// https://gist.github.com/brgaulin/2dec28baf5e9e11dfd7ef8354adf103d\n",
"verify.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\n\nVMImage *setVMImgError(VMImage *img, int code, void *pos) {\n img->errorOffset = pos ? (int)((uint8_t *)pos - (uint8_t *)img->dataStart) : 0;\n img->errorCode = code;\n return img;\n}\n\n// next free error 1066\n#define ERROR(code, pos) return setVMImgError(img, code, pos)\n#define CHECK(cond, code) \\\n do { \\\n if (!(cond)) \\\n ERROR(code, sect); \\\n } while (0)\n#define CHECK_AT(cond, code, pos) \\\n do { \\\n if (!(cond)) \\\n ERROR(code, pos); \\\n } while (0)\n#define ALIGNED(sz) (((sz)&7) == 0)\n\n#define FOR_SECTIONS() \\\n VMImageSection *sect, *next; \\\n for (sect = (VMImageSection *)img->dataStart; \\\n (next = vmNextSection(sect), (uint64_t *)sect < img->dataEnd); sect = next)\n\n#define ALLOC_ARRAY(tp, sz) (tp *)xmalloc(sz == 0 ? 1 : sizeof(tp) * sz)\n\n#define VM_MAX_PATCH 7\n\nstruct VMPatchState {\n uint32_t offset;\n uint32_t bytesLeftInSect;\n uint8_t patchOff;\n const char *error;\n uint64_t patch[VM_MAX_PATCH];\n};\n\nstatic const VTable *vtFor(VMImageSection *sect) {\n if (sect->type == SectionType::Function)\n return &pxt::RefAction_vtable;\n else if (sect->type == SectionType::Literal)\n switch ((BuiltInType)sect->aux) {\n case BuiltInType::BoxedString_ASCII:\n return &pxt::string_inline_ascii_vt;\n case BuiltInType::BoxedString_SkipList:\n return &pxt::string_skiplist16_packed_vt;\n case BuiltInType::BoxedString:\n return &pxt::string_inline_utf8_vt;\n case BuiltInType::BoxedBuffer:\n return &pxt::buffer_vt;\n default:\n return NULL;\n }\n return NULL;\n}\n\nstatic bool isStringSection(VMImageSection *sect) {\n if (sect->type == SectionType::Literal)\n switch ((BuiltInType)sect->aux) {\n case BuiltInType::BoxedString_ASCII:\n case BuiltInType::BoxedString_SkipList:\n case BuiltInType::BoxedString:\n return true;\n default:\n return false;\n }\n return false;\n}\n\nVMPatchState *vm_alloc_patch_state() {\n return (VMPatchState *)calloc(sizeof(VMPatchState), 1);\n}\n\nvoid vm_finish_patch(VMPatchState *state) {\n free(state);\n}\n\nconst char *vm_patch_image(VMPatchState *state, uint8_t *data, uint32_t len) {\n if (state->error)\n return state->error;\n\n if (len <= 8 || !ALIGNED(len))\n return (state->error = \"invalid chunk size\");\n\n while (len > 0) {\n if (state->bytesLeftInSect == 0) {\n VMImageSection sect;\n memcpy(§, data, sizeof(sect));\n\n if (!ALIGNED(sect.size) || !sect.size)\n return (state->error = \"invalid section\");\n\n state->bytesLeftInSect = sect.size;\n\n memset(state->patch, 0, sizeof(state->patch));\n state->patchOff = 1;\n\n const VTable *vt = NULL;\n#ifdef PXT32\n if (sect.type == SectionType::NumberBoxes) {\n return (state->error = \"TODO: NumberBoxes\");\n }\n#endif\n if (sect.type == SectionType::Literal || sect.type == SectionType::Function) {\n vt = vtFor(§);\n if (!vt)\n return (state->error = \"unknown literal vt\");\n#ifdef PXT64\n state->patch[0] = (uint64_t)vt;\n#else\n state->patch[0] = (uint64_t)(uint32_t)vt << 32;\n#endif\n } else if (sect.type == SectionType::VTable) {\n auto dest = (void **)((uint32_t *)state->patch + 4);\n dest[0] = (void *)pxt::RefRecord_destroy;\n dest[1] = (void *)pxt::RefRecord_print;\n dest[2] = (void *)pxt::RefRecord_scan;\n dest[3] = (void *)pxt::RefRecord_gcsize;\n }\n } else if (state->patchOff != 0) {\n uint64_t p = state->patch[state->patchOff - 1];\n if (p)\n memcpy(data, &p, sizeof(p));\n if (state->patchOff == VM_MAX_PATCH) {\n state->patchOff = 0;\n } else {\n state->patchOff++;\n }\n }\n\n state->bytesLeftInSect -= 8;\n data += 8;\n len -= 8;\n }\n\n return NULL;\n}\n\nstatic VMImage *countSections(VMImage *img) {\n auto p = img->dataStart;\n while (p < img->dataEnd) {\n auto sect = (VMImageSection *)p;\n CHECK(ALIGNED(sect->size), 1002);\n CHECK(sect->size > 0, 1002);\n img->numSections++;\n p += sect->size >> 3;\n }\n CHECK_AT(p == img->dataEnd, 1003, p);\n img->pointerLiterals = ALLOC_ARRAY(TValue, img->numSections);\n img->sections = ALLOC_ARRAY(VMImageSection *, img->numSections);\n\n return NULL;\n}\n\nstatic VMImage *loadSections(VMImage *img) {\n auto idx = 0;\n VMImageSection *numberBoxes = NULL;\n\n FOR_SECTIONS() {\n CHECK(sect->size < 32000, 1014);\n CHECK(sect->size >= 16, 1048);\n\n if (sect->type == SectionType::InfoHeader) {\n CHECK(sect->size >= sizeof(VMImageHeader), 1008);\n auto hd = (VMImageHeader *)sect->data;\n CHECK(hd->magic0 == VM_MAGIC0, 1009);\n CHECK(hd->magic1 == VM_MAGIC1, 1010);\n CHECK(hd->allocGlobals >= hd->nonPointerGlobals, 1011);\n CHECK(hd->allocGlobals < 10000, 1012);\n CHECK(idx == 0, 1013);\n img->infoHeader = hd;\n }\n\n if (sect->type == SectionType::OpCodeMap) {\n CHECK(img->opcodes == NULL, 1015);\n auto curr = sect->data;\n auto endp = sect->data + sect->size - 8;\n CHECK(endp[-1] == 0, 1017);\n\n while (curr < endp) {\n if (*curr == 0)\n img->numOpcodes++;\n curr++;\n }\n CHECK(img->numOpcodes >= VM_FIRST_RTCALL, 1016);\n\n img->opcodes = ALLOC_ARRAY(OpFun, img->numOpcodes);\n img->opcodeDescs = ALLOC_ARRAY(const OpcodeDesc *, img->numOpcodes);\n\n int i = 0;\n curr = sect->data;\n while (curr < endp) {\n img->opcodeDescs[i] = NULL;\n img->opcodes[i] = NULL;\n if (*curr) {\n for (auto st = staticOpcodes; st->name; st++) {\n if (strcmp(st->name, (const char *)curr) == 0) {\n img->opcodeDescs[i] = st;\n break;\n }\n }\n if (img->opcodeDescs[i] == NULL) {\n DMESG(\"missing opcode: %s\", (const char *)curr);\n setVMImgError(img, 1018, curr);\n } else {\n img->opcodes[i] = img->opcodeDescs[i]->fn;\n }\n }\n while (*curr)\n curr++;\n curr++;\n i++;\n }\n if (img->errorCode)\n return img;\n }\n\n if (sect->type == SectionType::NumberBoxes) {\n CHECK(!numberBoxes, 1061);\n numberBoxes = sect;\n }\n\n if (sect->type == SectionType::NumberLiterals) {\n CHECK(!!numberBoxes, 1062);\n CHECK(!img->numberLiterals, 1004);\n img->numNumberLiterals = (sect->size >> 3) - 1;\n uint64_t *values = (uint64_t *)sect->data;\n\n int numBoxed = 0;\n\n for (unsigned i = 0; i < img->numNumberLiterals; ++i) {\n auto ptr = &values[i];\n uint64_t v = *ptr;\n if (isEncodedDouble(v)) {\n CHECK_AT(!isnan(decodeDouble(v)), 1005, ptr);\n numBoxed++;\n } else if (v & 1) {\n CHECK_AT((v >> 1) <= 0xffffffff, 1006, ptr);\n if (!canBeTagged(v >> 1))\n numBoxed++;\n } else if (v == 0) {\n // OK - padding probably\n } else {\n CHECK_AT(false, 1007, ptr);\n }\n }\n\n CHECK(numberBoxes->size >= sizeof(VMImageSection) + (numBoxed + 1) * 12, 1063);\n CHECK(numberBoxes->size <= 4 + sizeof(VMImageSection) + (numBoxed + 1) * 12, 1063);\n\n img->numberLiterals = ALLOC_ARRAY(TValue, img->numNumberLiterals);\n#ifdef PXT32\n img->boxedNumbers = (BoxedNumber *)numberBoxes->data;\n int boxedPtr = 0;\n#endif\n\n for (unsigned i = 0; i < img->numNumberLiterals; ++i) {\n uint64_t v = values[i];\n#ifdef PXT32\n if (!isEncodedDouble(v) && canBeTagged(v >> 1)) {\n img->numberLiterals[i] = (TValue)v;\n } else {\n CHECK(boxedPtr < numBoxed, 1060); // should never happen\n double x = isEncodedDouble(v) ? decodeDouble(v) : (int32_t)(v >> 1);\n CHECK(img->boxedNumbers[boxedPtr].vtable == &number_vt, 1064);\n CHECK(img->boxedNumbers[boxedPtr].num == x, 1065);\n img->numberLiterals[i] = (TValue)&img->boxedNumbers[boxedPtr];\n boxedPtr++;\n }\n#else\n img->numberLiterals[i] = (TValue)v;\n#endif\n }\n }\n\n if (sect->type == SectionType::ConfigData) {\n img->numConfigDataEntries = (sect->size - 8) >> 3;\n img->configData = (int32_t *)sect->data;\n CHECK(img->configData[(img->numConfigDataEntries - 1) * 2] == 0, 1045);\n }\n\n img->sections[idx] = sect;\n\n if (sect->type == SectionType::Literal) {\n CHECK(sect->size >= 20, 1066);\n switch ((BuiltInType)sect->aux) {\n case BuiltInType::BoxedString_ASCII:\n case BuiltInType::BoxedString: {\n auto p = (BoxedString *)vmLiteralVal(sect);\n CHECK(sect->size >= 16 + 2 + (uint32_t)p->ascii.length + 1, 1067);\n CHECK(p->ascii.data[p->ascii.length] == 0, 1068);\n break;\n }\n case BuiltInType::BoxedString_SkipList: {\n auto p = (BoxedString *)vmLiteralVal(sect);\n CHECK(sect->size >= 16 + 4 + PXT_NUM_SKIP_ENTRIES(p) * 2 + (uint32_t)p->skip_pack.size + 1,\n 1069);\n CHECK(PXT_SKIP_DATA_PACK(p)[p->skip_pack.size] == 0, 1070);\n for (int i = 0; i < PXT_NUM_SKIP_ENTRIES(p); ++i) {\n CHECK(p->skip_pack.list[i] <= p->skip_pack.size, 1071);\n }\n break;\n }\n case BuiltInType::BoxedBuffer: {\n auto p = (BoxedBuffer *)vmLiteralVal(sect);\n CHECK(sect->size >= 16 + 4 + (uint32_t)p->length, 1072);\n break;\n }\n default:\n CHECK(false, 1050);\n }\n img->pointerLiterals[idx] = vmLiteralVal(sect);\n // TODO validate size/length of boxed string/buffer; check utf8 encoding?; 1042 error\n } else if (sect->type == SectionType::Function) {\n img->pointerLiterals[idx] = vmLiteralVal(sect);\n if (!img->entryPoint)\n img->entryPoint = (RefAction *)img->pointerLiterals[idx];\n } else if (sect->type == SectionType::VTable) {\n img->pointerLiterals[idx] = (TValue)(sect->data);\n } else {\n img->pointerLiterals[idx] = nullptr;\n }\n\n idx++;\n }\n\n CHECK_AT(img->infoHeader != NULL, 1019, 0);\n CHECK_AT(img->opcodes != NULL, 1020, 0);\n CHECK_AT(img->numberLiterals != NULL, 1021, 0);\n CHECK_AT(img->configData != NULL, 1022, 0);\n CHECK_AT(img->entryPoint != NULL, 1059, 0);\n\n return NULL;\n}\n\nstatic VMImage *loadIfaceNames(VMImage *img) {\n FOR_SECTIONS() {\n if (sect->type == SectionType::IfaceMemberNames) {\n uint32_t *ptrs = (uint32_t *)sect->data;\n auto len = *ptrs++;\n CHECK(len < 0x40000, 1047);\n uintptr_t *dst = ALLOC_ARRAY(uintptr_t, len + 1);\n img->ifaceMemberNames = dst;\n img->numIfaceMemberNames = len;\n *dst++ = len;\n CHECK(sect->size >= 12 + len * 4, 1047);\n for (unsigned i = 0; i < len; ++i) {\n CHECK(ptrs[i] < img->numSections, 1051);\n auto ss = img->sections[ptrs[i]];\n CHECK(isStringSection(ss), 1052);\n dst[i] = (uintptr_t)img->pointerLiterals[ptrs[i]];\n // pointers have to be sorted\n CHECK(i == 0 || dst[i - 1] < dst[i], 1053);\n // and so strings\n CHECK(i == 0 || String_::compare((String)dst[i - 1], (String)dst[i]) < 0, 1054);\n }\n }\n }\n\n return NULL;\n}\n\nvoid validateFunction(VMImage *img, VMImageSection *sect, int debug);\n\nstatic VMImage *validateFunctions(VMImage *img) {\n FOR_SECTIONS() {\n if (sect->type == SectionType::VTable) {\n uint8_t *endp = sect->data + sect->size - 8;\n auto vt = (VTable *)sect->data;\n auto multBase = (uint16_t *)&vt->methods[VM_NUM_CPP_METHODS];\n CHECK((uint8_t *)multBase < endp,\n 1023); // basic size check, before dereferencing anything\n\n auto maxMult = 0xffffffffU >> (vt->ifaceHashMult & 0xff);\n\n CHECK(vt->numbytes < 1024, 1024);\n CHECK((vt->numbytes & 7) == 0, 1025);\n CHECK(vt->objectType == ValType::Object, 1026);\n CHECK(vt->magic == VTABLE_MAGIC, 1027);\n CHECK(vt->ifaceHashEntries > maxMult + 3, 1028);\n CHECK((uint8_t *)(multBase + vt->ifaceHashEntries) < endp, 1029);\n CHECK(vt->reserved == 0, 1030);\n CHECK(vt->ifaceHashMult != 0, 1031);\n CHECK((vt->ifaceHashEntries & 3) == 0, 1032);\n CHECK((int)vt->classNo >= (int)BuiltInType::User0, 1055);\n CHECK((int)vt->lastClassNo >= (int)vt->classNo, 1056);\n\n uint32_t maxOff = 0;\n uint32_t minOff = 0xfffffff;\n for (unsigned i = 0; i < vt->ifaceHashEntries; ++i) {\n uint32_t off2 = multBase[i];\n if (off2 > maxOff)\n maxOff = off2;\n if (off2 < minOff)\n minOff = off2;\n auto ent = (IfaceEntry *)multBase + off2;\n CHECK((uint8_t *)(ent + 1) <= endp, 1033);\n }\n\n CHECK(minOff * sizeof(IfaceEntry) == vt->ifaceHashEntries * 2, 1034);\n\n auto last1 = (IfaceEntry *)multBase + maxOff + 1;\n if (last1->memberId != 0)\n maxOff++;\n\n for (unsigned i = minOff; i <= maxOff; ++i) {\n auto ent = (IfaceEntry *)multBase + i;\n if (ent->memberId == 0)\n continue;\n if (ent->aux == 0) {\n CHECK(ent->method < (unsigned)(vt->numbytes >> 3), 1035);\n } else {\n CHECK(ent->method < img->numSections, 1037);\n auto fn = img->sections[ent->method];\n CHECK(fn->type == SectionType::Function, 1039);\n }\n }\n\n auto p = (uint8_t *)((IfaceEntry *)multBase + maxOff + 1);\n while (p < endp)\n CHECK(*p++ == 0, 1040);\n }\n\n if (sect->type == SectionType::Function) {\n validateFunction(img, sect, 0);\n if (img->errorCode) {\n // try again with debug\n validateFunction(img, sect, 1);\n return img;\n }\n }\n }\n return NULL;\n}\n\nstatic VMImage *checkVTables(VMImage *img) {\n FOR_SECTIONS() {\n auto vt = vtFor(sect);\n if (vt) {\n CHECK(((RefObject *)vmLiteralVal(sect))->vtable == vt, 1057);\n }\n if (sect->type == SectionType::Literal) {\n CHECK(vt != NULL, 1043);\n } else if (sect->type == SectionType::VTable) {\n auto vt = (VTable *)sect->data;\n CHECK(vt->methods[0] == (void *)pxt::RefRecord_destroy, 1058);\n CHECK(vt->methods[1] == (void *)pxt::RefRecord_print, 1058);\n CHECK(vt->methods[2] == (void *)pxt::RefRecord_scan, 1058);\n CHECK(vt->methods[3] == (void *)pxt::RefRecord_gcsize, 1058);\n }\n }\n return NULL;\n}\n\nVMImage *loadVMImage(void *data, unsigned length) {\n auto img = new VMImage();\n memset(img, 0, sizeof(*img));\n\n DMESG(\"loading image at %p (%d bytes)\", data, length);\n\n CHECK_AT(ALIGNED((uintptr_t)data), 1000, 0);\n CHECK_AT(ALIGNED(length), 1001, 0);\n\n img->dataStart = (uint64_t *)data;\n img->dataEnd = (uint64_t *)((uint8_t *)data + length);\n\n if (countSections(img) || checkVTables(img) || loadSections(img) || loadIfaceNames(img) ||\n validateFunctions(img)) {\n // error!\n return img;\n }\n\n DMESG(\"image loaded\");\n\n return img;\n}\n\nvoid unloadVMImage(VMImage *img) {\n if (!img)\n return;\n\n free(img->pointerLiterals);\n free(img->sections);\n free(img->opcodes);\n free(img->opcodeDescs);\n free(img->numberLiterals);\n free(img->ifaceMemberNames);\n\n free(img->dataStart);\n memset(img, 0, sizeof(*img));\n delete img;\n}\n\n} // namespace pxt\n",
"vm.cpp": "#include \"pxt.h\"\n\n// TODO look for patterns in output for combined instructions\n// TODO check for backjumps (how many)\n// TODO getConfig() should have a callback into host\n\n#define BOUND_ACTION 1\n\n#define SPLIT_ARG(arg0, arg1) unsigned arg0 = arg & 31, arg1 = arg >> 6\n#define SPLIT_ARG2(arg0, arg1) unsigned arg0 = arg & 255, arg1 = arg >> 8\n\n#define PUSH(v) *--ctx->sp = (v)\n#define POPVAL() *ctx->sp++\n#define POP(n) ctx->sp += (n)\n\n//#define TRACE DMESG\n#define TRACE NOLOG\n\nnamespace pxt {\n\n//%\nvoid op_stloc(FiberContext *ctx, unsigned arg) {\n ctx->sp[arg] = ctx->r0;\n}\n\n//%\nvoid op_ldloc(FiberContext *ctx, unsigned arg) {\n ctx->r0 = ctx->sp[arg];\n}\n\n//%\nvoid op_ldcap(FiberContext *ctx, unsigned arg) {\n ctx->r0 = ctx->currAction->fields[arg];\n}\n\n//%\nvoid op_bitconv(FiberContext *ctx, unsigned arg) {\n int shift = 32 - ((arg & 0xf) * 8);\n if (arg & 0x10) {\n int v = toInt(ctx->r0);\n ctx->r0 = fromInt((v << shift) >> shift);\n } else {\n unsigned v = toUInt(ctx->r0);\n ctx->r0 = fromUInt((v << shift) >> shift);\n }\n}\n\n//%\nvoid op_stglb(FiberContext *ctx, unsigned arg) {\n globals[arg] = ctx->r0;\n}\n\n//%\nvoid op_ldglb(FiberContext *ctx, unsigned arg) {\n ctx->r0 = globals[arg];\n}\n\n//%\nvoid op_ldlit(FiberContext *ctx, unsigned arg) {\n ctx->r0 = ctx->img->pointerLiterals[arg];\n}\n\n//%\nvoid op_ldnumber(FiberContext *ctx, unsigned arg) {\n ctx->r0 = (TValue)ctx->img->numberLiterals[arg];\n}\n\n//%\nvoid op_jmp(FiberContext *ctx, unsigned arg) {\n ctx->pc += (int)arg;\n}\n\n//%\nvoid op_jmpz(FiberContext *ctx, unsigned arg) {\n if (!toBoolQuick(ctx->r0))\n ctx->pc += (int)arg;\n}\n\n//%\nvoid op_jmpnz(FiberContext *ctx, unsigned arg) {\n if (toBoolQuick(ctx->r0))\n ctx->pc += (int)arg;\n}\n\nstatic inline VTable *getStaticVTable(VMImage *img, unsigned classId) {\n return (VTable *)(img->pointerLiterals[classId]);\n}\n\n//%\nvoid op_newobj(FiberContext *ctx, unsigned arg) {\n ctx->r0 = (TValue)pxt::mkClassInstance(getStaticVTable(ctx->img, arg));\n}\n\nstatic inline void shiftArg(FiberContext *ctx, unsigned numArgs) {\n for (unsigned i = numArgs - 1; i > 0; i--)\n ctx->sp[i] = ctx->sp[i - 1];\n POP(1);\n}\n\nstatic inline void checkClass(FiberContext *ctx, TValue obj, unsigned classId, unsigned fldId) {\n TRACE(\"check class: %p cl=%d f=%d\", obj, classId, fldId);\n if (!isPointer(obj))\n failedCast(obj);\n auto vt = getVTable((RefObject *)obj);\n auto vt2 = getStaticVTable(ctx->img, classId);\n if (vt == vt2)\n return;\n if ((int)vt2->classNo <= (int)vt->classNo && (int)vt->classNo <= (int)vt2->lastClassNo) {\n // double check field range - we don't really check class sequence numbers\n if (8 + fldId * 8 >= vt->numbytes)\n failedCast(obj);\n }\n}\n\n//%\nvoid op_ldfld(FiberContext *ctx, unsigned arg) {\n SPLIT_ARG2(fldId, classId);\n auto obj = ctx->r0;\n checkClass(ctx, obj, classId, fldId);\n ctx->r0 = ((RefRecord *)obj)->fields[fldId];\n}\n\n//%\nvoid op_stfld(FiberContext *ctx, unsigned arg) {\n SPLIT_ARG2(fldId, classId);\n auto obj = POPVAL();\n checkClass(ctx, obj, classId, fldId);\n ((RefRecord *)obj)->fields[fldId] = ctx->r0;\n}\n\nstatic RefAction *bindAction(FiberContext *ctx, RefAction *ra, TValue obj) {\n if (ra->initialLen != 0)\n target_panic(PANIC_INVALID_VTABLE);\n auto act = (RefAction *)mkAction(1, ra);\n act->flags = BOUND_ACTION;\n act->fields[0] = obj;\n return act;\n}\n\nstatic inline void runAction(FiberContext *ctx, RefAction *ra) {\n if (ctx->sp < ctx->img->stackLimit)\n soft_panic(PANIC_STACK_OVERFLOW);\n\n PUSH((TValue)ctx->currAction);\n PUSH(VM_ENCODE_PC(ctx->pc - ctx->imgbase));\n ctx->currAction = ra;\n ctx->pc = actionPC(ra);\n}\n\nstatic const uint8_t *find_src_map() {\n const uint32_t *p = (const uint32_t *)((uint32_t)vmImg->dataEnd & ~0xf);\n const uint32_t *endP = p + 128;\n while (p < endP) {\n if (p[0] == 0x4d435253 && p[1] == 0x2d4e1588 && p[2] == 0x719986aa)\n return (const uint8_t *)p;\n p += 4;\n }\n DMESG(\"source map not found; dataEnd=%p\", vmImg->dataEnd);\n return NULL;\n}\n\nstatic const uint8_t *decode_num(const uint8_t *p, int *dst) {\n auto v = *p++;\n if (v < 0xf0) {\n *dst = v;\n return p;\n }\n auto sz = v & 0x07;\n int r = 0;\n for (int i = 0; i < sz; ++i) {\n r |= *p++ << (i * 8);\n }\n if (v & 0x08)\n r = -r;\n *dst = r;\n return p;\n}\n\nstatic const uint8_t *dump_pc_one(int addr, int off, const uint8_t *fn) {\n if (!fn)\n return NULL;\n auto p = fn;\n while (*p)\n p++;\n p++;\n int prevLn = 0, prevOff = 0;\n while (*p != 0xff) {\n int a, b, c;\n p = decode_num(p, &a);\n p = decode_num(p, &b);\n p = decode_num(p, &c);\n prevLn += a;\n b <<= 1;\n prevOff += b;\n c <<= 1;\n\n int startA = prevOff;\n int endA = startA + c;\n if (startA <= addr + off && addr + off <= endA) {\n DMESG(\" PC:%x %s(%d)\", addr, fn, prevLn);\n return NULL;\n }\n }\n return p + 1;\n}\n\nstatic void dump_pc(int addr, const uint8_t *srcmap) {\n if (srcmap) {\n auto p = srcmap + 16;\n for (;;) {\n auto a = dump_pc_one(addr, -2, p);\n if (!a || !dump_pc_one(addr, -4, p) || !dump_pc_one(addr, 0, p))\n return;\n p = a;\n if (*p == 0)\n break;\n }\n }\n DMESG(\" PC:%x\", addr);\n}\n\nvoid vm_stack_trace() {\n auto ctx = currentFiber;\n if (!ctx)\n return;\n DMESG(\"stack trace (programHash:%d):\", programHash());\n auto end = vmImg->stackTop;\n auto ptr = ctx->sp;\n auto srcmap = find_src_map();\n dump_pc((ctx->pc - ctx->imgbase) << 1, srcmap);\n int max = 30;\n while (ptr < end && max) {\n auto v = (uintptr_t)*ptr++;\n if (VM_IS_ENCODED_PC(v)) {\n dump_pc(VM_DECODE_PC(v) << 1, srcmap);\n max--;\n }\n }\n if (max == 0)\n DMESG(\" ...\");\n}\n\n//%\nvoid op_callproc(FiberContext *ctx, unsigned arg) {\n runAction(ctx, (RefAction *)ctx->img->pointerLiterals[arg]);\n}\n\nstatic void callind(FiberContext *ctx, RefAction *ra, unsigned numArgs) {\n if (ra->flags & BOUND_ACTION) {\n PUSH(0);\n for (unsigned i = 0; i < numArgs; i++) {\n ctx->sp[i] = ctx->sp[i + 1];\n }\n ctx->sp[numArgs] = ra->fields[0];\n numArgs++;\n }\n\n if (numArgs != ra->numArgs) {\n int missing = ra->numArgs - numArgs;\n TRACE(\"callind missing=%d\", missing);\n if (missing < 0) {\n // just drop the ones on top\n POP(-missing);\n } else {\n // add some undefineds\n while (missing--)\n PUSH(TAG_UNDEFINED);\n }\n }\n\n if (ra->initialLen > ra->len)\n // trying to call function template\n target_panic(PANIC_INVALID_VTABLE);\n\n runAction(ctx, ra);\n}\n\n//%\nvoid op_callind(FiberContext *ctx, unsigned arg) {\n auto fn = ctx->r0;\n if (!isPointer(fn))\n failedCast(fn);\n auto vt = getVTable((RefObject *)fn);\n if (vt->objectType != ValType::Function)\n failedCast(fn);\n\n callind(ctx, (RefAction *)fn, arg);\n}\n\n//%\nvoid op_ret(FiberContext *ctx, unsigned arg) {\n SPLIT_ARG(retNumArgs, numTmps);\n\n POP(numTmps);\n auto retaddr = (intptr_t)POPVAL();\n ctx->currAction = (RefAction *)POPVAL();\n POP(retNumArgs);\n\n // check if we're leaving a function that still has open try blocks\n // (this results from invalid code generation)\n if (ctx->tryFrame &&\n ctx->tryFrame->registers[2] < (uint8_t *)ctx->sp - (uint8_t *)vmImg->stackBase) {\n DMESG(\"try frame %p left on return %d/%d\", ctx->tryFrame, ctx->tryFrame->registers[2],\n (uint8_t *)ctx->sp - (uint8_t *)vmImg->stackBase);\n vm_stack_trace();\n target_panic(PANIC_VM_ERROR);\n }\n\n if (retaddr == (intptr_t)TAG_STACK_BOTTOM) {\n ctx->pc = NULL;\n } else {\n ctx->pc = ctx->imgbase + VM_DECODE_PC(retaddr);\n }\n}\n\n//%\nvoid op_pop(FiberContext *ctx, unsigned) {\n ctx->r0 = POPVAL();\n}\n\n//%\nvoid op_popmany(FiberContext *ctx, unsigned arg) {\n POP(arg);\n}\n\n//%\nvoid op_pushmany(FiberContext *ctx, unsigned arg) {\n while (arg--) {\n PUSH(TAG_UNDEFINED);\n }\n}\n\n//%\nvoid op_push(FiberContext *ctx, unsigned) {\n PUSH(ctx->r0);\n}\n\n//%\nvoid op_ldspecial(FiberContext *ctx, unsigned arg) {\n ctx->r0 = (TValue)(uintptr_t)arg;\n}\n\n//%\nvoid op_ldint(FiberContext *ctx, unsigned arg) {\n ctx->r0 = TAG_NUMBER(arg);\n}\n\n//%\nvoid op_ldintneg(FiberContext *ctx, unsigned arg) {\n ctx->r0 = TAG_NUMBER(-(int)arg);\n}\n\nTryFrame *beginTry();\n\n//%\nvoid op_try(FiberContext *ctx, unsigned arg) {\n auto f = pxt::beginTry();\n f->registers[0] = (uintptr_t)ctx->currAction;\n f->registers[1] = (uintptr_t)(ctx->pc + (int)arg);\n f->registers[2] = (uint8_t *)ctx->sp - (uint8_t *)vmImg->stackBase;\n}\n\nvoid restoreVMExceptionState(TryFrame *tf, FiberContext *ctx) {\n // TODO verification\n ctx->currAction = (RefAction *)tf->registers[0];\n ctx->pc = (uint16_t *)tf->registers[1];\n ctx->sp = (TValue *)((uint8_t *)vmImg->stackBase + tf->registers[2]);\n longjmp(ctx->loopjmp, 1);\n}\n\nstatic TValue lookupIfaceMember(TValue obj, VTable *vt, unsigned ifaceIdx) {\n uint32_t mult = vt->ifaceHashMult;\n uint32_t off = (ifaceIdx * mult) >> (mult & 0xff);\n\n unsigned n = 3;\n auto multBase = (uint16_t *)&vt->methods[VM_NUM_CPP_METHODS];\n while (n--) {\n uint32_t off2 = multBase[off];\n auto ent = (struct IfaceEntry *)multBase + off2;\n\n if (ent->memberId == ifaceIdx) {\n if (ent->aux != 0) {\n return vmImg->pointerLiterals[ent->method];\n } else {\n return ((RefRecord *)obj)->fields[ent->method - 1];\n }\n }\n off++;\n }\n\n return NULL;\n}\n\n/* skip .d.ts */ enum class CallType { Call = 0, Get = 1, Set = 2 };\n\nstatic inline void callifaceCore(FiberContext *ctx, unsigned numArgs, unsigned ifaceIdx,\n CallType getset) {\n auto obj = ctx->sp[numArgs - 1];\n if (!isPointer(obj))\n failedCast(obj);\n auto vt = getVTable((RefObject *)obj);\n uint32_t mult = vt->ifaceHashMult;\n\n if (!mult) {\n if (vt->classNo == BuiltInType::RefMap) {\n if (getset == CallType::Set) {\n pxtrt::mapSet((RefMap *)obj, ifaceIdx, ctx->sp[0]);\n POP(2); // and pop arguments\n } else {\n ctx->r0 = pxtrt::mapGet((RefMap *)obj, ifaceIdx);\n if (getset == CallType::Call) {\n shiftArg(ctx, numArgs);\n op_callind(ctx, numArgs - 1);\n } else {\n POP(1);\n }\n }\n return;\n }\n missingProperty(obj);\n }\n uint32_t off = (ifaceIdx * mult) >> (mult & 0xff);\n\n unsigned n = 3;\n auto multBase = (uint16_t *)&vt->methods[VM_NUM_CPP_METHODS];\n while (n--) {\n uint32_t off2 = multBase[off];\n auto ent = (struct IfaceEntry *)multBase + off2;\n\n if (ent->memberId == ifaceIdx) {\n if (ent->aux != 0) {\n if (getset == CallType::Set) {\n ent++;\n if (ent->memberId != ifaceIdx)\n missingProperty(obj);\n }\n auto fn = (RefAction *)ctx->img->pointerLiterals[ent->method];\n if (getset == CallType::Get && ent->aux == 2) {\n ctx->r0 = (TValue)bindAction(ctx, fn, obj);\n POP(1);\n return;\n }\n callind(ctx, fn, numArgs);\n } else {\n if (getset == CallType::Set) {\n // store field\n ((RefRecord *)obj)->fields[ent->method - 1] = ctx->sp[0];\n POP(2); // and pop arguments\n } else {\n // load field\n ctx->r0 = ((RefRecord *)obj)->fields[ent->method - 1];\n if (getset == CallType::Call) {\n // and call\n shiftArg(ctx, numArgs);\n op_callind(ctx, numArgs - 1);\n } else {\n // if just loading, pop the object arg\n POP(1);\n }\n }\n }\n\n return;\n }\n off++;\n }\n\n if (getset == CallType::Get) {\n ctx->sp += 1; // pop object arg\n ctx->r0 = TAG_UNDEFINED;\n } else {\n missingProperty(obj);\n }\n}\n\n//%\nvoid op_calliface(FiberContext *ctx, unsigned arg) {\n SPLIT_ARG(numArgs, ifaceIdx);\n callifaceCore(ctx, numArgs, ifaceIdx, CallType::Call);\n}\n\n//%\nvoid op_callget(FiberContext *ctx, unsigned arg) {\n callifaceCore(ctx, 1, arg, CallType::Get);\n}\n\n//%\nvoid op_callset(FiberContext *ctx, unsigned arg) {\n callifaceCore(ctx, 2, arg, CallType::Set);\n}\n\n//%\nvoid op_mapget(FiberContext *ctx, unsigned arg) {\n auto obj = ctx->sp[0];\n if (!isPointer(obj))\n failedCast(obj);\n auto vt = getVTable((RefObject *)obj);\n auto key = numops::toString(ctx->r0);\n if (vt->classNo == BuiltInType::RefMap) {\n ctx->r0 = pxtrt::mapGetByString((RefMap *)obj, key);\n POP(1);\n } else {\n int k = pxtrt::lookupMapKey(key);\n if (k == 0) {\n POP(1);\n ctx->r0 = TAG_UNDEFINED;\n } else {\n callifaceCore(ctx, 1, k, CallType::Get);\n }\n }\n}\n\n//%\nvoid op_mapset(FiberContext *ctx, unsigned arg) {\n auto obj = ctx->sp[1];\n if (!isPointer(obj))\n failedCast(obj);\n auto vt = getVTable((RefObject *)obj);\n auto key = numops::toString(ctx->sp[0]);\n ctx->sp[0] = (TValue)key; // save it, so it doesn't get GCed\n if (vt->classNo == BuiltInType::RefMap) {\n pxtrt::mapSetByString((RefMap *)obj, key, ctx->r0);\n POP(2);\n } else {\n int k = pxtrt::lookupMapKey(key);\n if (k == 0) {\n missingProperty(obj);\n } else {\n ctx->sp[0] = ctx->r0;\n callifaceCore(ctx, 2, k, CallType::Set);\n }\n }\n}\n\n//%\nvoid op_checkinst(FiberContext *ctx, unsigned arg) {\n auto obj = ctx->r0;\n ctx->r0 = TAG_FALSE;\n\n if (isPointer(obj)) {\n auto vt2 = getStaticVTable(ctx->img, arg);\n auto vt = getVTable((RefObject *)obj);\n if (vt == vt2)\n ctx->r0 = TAG_TRUE;\n else if ((int)vt2->classNo <= (int)vt->classNo && (int)vt->classNo <= (int)vt2->lastClassNo)\n ctx->r0 = TAG_TRUE;\n }\n}\n\nstatic TValue inlineInvoke(FiberContext *ctx, RefAction *fn, int numArgs) {\n auto prevPC = ctx->pc;\n auto prevR0 = ctx->r0;\n jmp_buf loopjmp;\n memcpy(&loopjmp, &ctx->loopjmp, sizeof(loopjmp));\n // make sure call will push TAG_STACK_BOTTOM\n ctx->pc = (uint16_t *)ctx->imgbase + 1;\n callind(ctx, fn, numArgs);\n ctx->img->execLock ^= 1;\n exec_loop(ctx);\n if (ctx->resumePC)\n target_panic(PANIC_BLOCKING_TO_STRING);\n ctx->img->execLock ^= 1;\n auto r = ctx->r0;\n ctx->pc = prevPC;\n ctx->r0 = prevR0;\n memcpy(&ctx->loopjmp, &loopjmp, sizeof(loopjmp));\n return r;\n}\n\nString convertToString(FiberContext *ctx, TValue v) {\n if (isPointer(v)) {\n auto vt = getVTable((RefObject *)v);\n if ((int)vt->classNo >= (int)BuiltInType::User0) {\n auto img = ctx->img;\n if (!img->toStringKey) {\n img->toStringKey = pxtrt::lookupMapKey(mkString(\"toString\"));\n if (!img->toStringKey)\n img->toStringKey = -1;\n }\n if (img->toStringKey > 0) {\n auto fn = lookupIfaceMember(v, vt, img->toStringKey);\n if (fn && isPointer(fn) &&\n getVTable((RefObject *)fn)->objectType == ValType::Function) {\n PUSH(v);\n v = inlineInvoke(ctx, (RefAction *)fn, 1);\n PUSH(v); // make sure it doesn't get collected\n }\n }\n }\n }\n\n auto rr = numops::toString(v);\n if ((TValue)rr != v)\n PUSH((TValue)rr); // make sure it doesn't get collected\n\n return rr;\n}\n\nvoid exec_loop(FiberContext *ctx) {\n if (ctx->img->execLock) {\n DMESG(\"image locked!\");\n target_panic(PANIC_VM_ERROR);\n }\n ctx->img->execLock = 1;\n auto opcodes = ctx->img->opcodes;\n setjmp(ctx->loopjmp);\n while (ctx->pc) {\n if (panicCode)\n break;\n uint16_t opcode = *ctx->pc++;\n TRACE(\"0x%x: %04x %d\", (uint8_t *)ctx->pc - 2 - (uint8_t *)ctx->img->dataStart, opcode,\n (int)(vmImg->stackTop - ctx->sp));\n if (opcode >> 15 == 0) {\n opcodes[opcode & VM_OPCODE_BASE_MASK](ctx, opcode >> VM_OPCODE_ARG_POS);\n if (opcode & VM_OPCODE_PUSH_MASK)\n PUSH(ctx->r0);\n } else if (opcode >> 14 == 0b10) {\n ((ApiFun)(void *)opcodes[opcode & 0x1fff])(ctx);\n if (opcode & VM_RTCALL_PUSH_MASK)\n PUSH(ctx->r0);\n } else {\n unsigned tmp = ((int32_t)opcode << (16 + 2)) >> (2 + VM_OPCODE_ARG_POS);\n opcode = *ctx->pc++;\n opcodes[opcode & VM_OPCODE_BASE_MASK](ctx, (opcode >> VM_OPCODE_ARG_POS) + tmp);\n if (opcode & VM_OPCODE_PUSH_MASK)\n PUSH(ctx->r0);\n }\n }\n ctx->img->execLock = 0;\n}\n\n} // namespace pxt\n\n//\n// Verification\n//\n\nnamespace pxt {\n\n// 1255\n#define FNERR(errcode) \\\n do { \\\n setVMImgError(img, errcode, &code[pc]); \\\n return; \\\n } while (0)\n#define FORCE_STACK(v, errcode, pc) \\\n do { \\\n if (stackDepth[pc] && stackDepth[pc] != v) \\\n FNERR(errcode); \\\n stackDepth[pc] = v; \\\n } while (0)\n\nvoid validateFunction(VMImage *img, VMImageSection *sect, int debug) {\n uint16_t stackDepth[sect->size / 2];\n memset(stackDepth, 0, sizeof(stackDepth));\n int baseStack = 1; // 1 is the return address; also zero in the array above means unknown yet\n int currStack = baseStack;\n unsigned pc = 0;\n auto code = (uint16_t *)((uint8_t *)sect + VM_FUNCTION_CODE_OFFSET);\n auto lastPC = (sect->size - VM_FUNCTION_CODE_OFFSET) >> 1;\n auto atEnd = false;\n\n RefAction *ra = (RefAction *)vmLiteralVal(sect);\n\n if (ra->vtable != &pxt::RefAction_vtable)\n FNERR(1251);\n if ((uint8_t *)img->dataStart + ra->func != (uint8_t *)code)\n FNERR(1252);\n\n unsigned numArgs = ra->numArgs;\n unsigned numCaps = ra->initialLen;\n\n if (numCaps > 200)\n FNERR(1239);\n\n while (pc < lastPC) {\n if (currStack > VM_MAX_FUNCTION_STACK)\n FNERR(1204);\n\n FORCE_STACK(currStack, 1201, pc);\n\n uint16_t opcode = code[pc++];\n if (opcode == 0 && atEnd)\n continue; // allow padding at the end\n\n atEnd = false;\n OpFun fn;\n unsigned arg;\n unsigned opIdx;\n bool isRtCall = false;\n bool hasPush = false;\n\n if (opcode >> 15 == 0) {\n opIdx = opcode & VM_OPCODE_BASE_MASK;\n arg = opcode >> VM_OPCODE_ARG_POS;\n hasPush = !!(opcode & VM_OPCODE_PUSH_MASK);\n } else if (opcode >> 14 == 0b10) {\n opIdx = opcode & 0x1fff;\n arg = 0;\n isRtCall = true;\n hasPush = !!(opcode & VM_RTCALL_PUSH_MASK);\n } else {\n unsigned tmp = ((int32_t)opcode << (16 + 2)) >> (2 + VM_OPCODE_ARG_POS);\n FORCE_STACK(0xffff, 1200, pc); // cannot jump here!\n opcode = code[pc++];\n opIdx = opcode & VM_OPCODE_BASE_MASK;\n arg = (opcode >> VM_OPCODE_ARG_POS) + tmp;\n hasPush = !!(opcode & VM_OPCODE_PUSH_MASK);\n }\n\n if (opIdx >= img->numOpcodes)\n FNERR(1227);\n auto opd = img->opcodeDescs[opIdx];\n\n if (debug)\n DMESG(\"%4d/%d -> %04x idx=%d arg=%d st=%d %s\", pc, lastPC, opcode, opIdx, arg,\n currStack, opd ? opd->name : \"NA\");\n\n if (!opd)\n FNERR(1228);\n\n fn = img->opcodes[opIdx];\n\n if (isRtCall) {\n if (opd->numArgs > 1) {\n currStack -= opd->numArgs - 1;\n if (currStack < baseStack)\n FNERR(1229);\n }\n } else if (fn == op_pushmany) {\n if (currStack == 1 && baseStack == 1)\n baseStack = currStack = arg + 1;\n else\n currStack += arg;\n } else if (fn == op_popmany) {\n currStack -= arg;\n if (currStack < baseStack)\n FNERR(1205);\n } else if (fn == op_push) {\n currStack++;\n } else if (fn == op_pop) {\n if (arg)\n FNERR(1243);\n currStack--;\n if (currStack < baseStack)\n FNERR(1206);\n } else if (fn == op_mapget) {\n if (arg)\n FNERR(1244);\n currStack--;\n if (currStack < baseStack)\n FNERR(1245);\n } else if (fn == op_mapset) {\n if (arg)\n FNERR(1246);\n currStack -= 2;\n if (currStack < baseStack)\n FNERR(1247);\n } else if (fn == op_ret) {\n SPLIT_ARG(retNumArgs, numTmps);\n if (currStack != baseStack)\n FNERR(1207);\n if (numTmps + 1 != (unsigned)baseStack)\n FNERR(1208);\n if (retNumArgs != numArgs)\n FNERR(1209);\n currStack = baseStack;\n atEnd = true;\n } else if (fn == op_ldloc || fn == op_stloc) {\n if (arg == (unsigned)currStack - 1 || arg == (unsigned)currStack)\n FNERR(1210); // trying to load return address/function\n if (arg > (unsigned)currStack + numArgs)\n FNERR(1211);\n } else if (fn == op_ldcap) {\n if (arg >= numCaps)\n FNERR(1212);\n } else if (fn == op_ldglb || fn == op_stglb) {\n if (arg >= img->infoHeader->allocGlobals)\n FNERR(1213);\n // not supported (yet?)\n if (arg < img->infoHeader->nonPointerGlobals)\n FNERR(1214);\n } else if (fn == op_ldfld || fn == op_stfld) {\n SPLIT_ARG2(fldId, classId);\n\n if (classId >= img->numSections)\n FNERR(1236);\n auto fsec = img->sections[classId];\n if (fsec->type != SectionType::VTable)\n FNERR(1234);\n\n auto vt = getStaticVTable(img, classId);\n if (fldId * 8 + 8 >= vt->numbytes)\n FNERR(1235);\n\n if (fn == op_stfld) {\n currStack--;\n if (currStack < baseStack)\n FNERR(1232);\n }\n } else if (fn == op_ldlit) {\n if (arg >= img->numSections)\n FNERR(1215);\n auto fsec = img->sections[arg];\n if (fsec->type != SectionType::Literal && fsec->type != SectionType::Function)\n FNERR(1237);\n } else if (fn == op_newobj || fn == op_checkinst) {\n if (arg >= img->numSections)\n FNERR(1219);\n auto fsec = img->sections[arg];\n if (fsec->type != SectionType::VTable)\n FNERR(1238);\n } else if (fn == op_ldnumber) {\n if (arg >= img->numNumberLiterals)\n FNERR(1217);\n } else if (fn == op_callproc) {\n if (arg >= img->numSections)\n FNERR(1218);\n auto fsec = img->sections[arg];\n if (fsec->type != SectionType::Function)\n FNERR(1220);\n auto ra = (RefAction *)img->pointerLiterals[arg];\n unsigned calledArgs = ra->numArgs;\n currStack -= calledArgs;\n if (currStack < baseStack)\n FNERR(1221);\n } else if (fn == op_callind) {\n currStack -= arg;\n if (currStack < baseStack)\n FNERR(1223);\n } else if (fn == op_calliface) {\n SPLIT_ARG(numArgs, ifaceIdx);\n if (ifaceIdx == 0 || ifaceIdx >= img->numIfaceMemberNames)\n FNERR(1240);\n currStack -= numArgs;\n if (currStack < baseStack)\n FNERR(1230);\n } else if (fn == op_callget) {\n if (arg == 0 || arg >= img->numIfaceMemberNames)\n FNERR(1241);\n currStack -= 1;\n if (currStack < baseStack)\n FNERR(1230);\n } else if (fn == op_callset) {\n if (arg == 0 || arg >= img->numIfaceMemberNames)\n FNERR(1242);\n currStack -= 2;\n if (currStack < baseStack)\n FNERR(1230);\n } else if (fn == op_ldspecial) {\n auto a = (TValue)(uintptr_t)arg;\n if (a != TAG_TRUE && a != TAG_FALSE && a != TAG_UNDEFINED && a != TAG_NULL &&\n a != TAG_NAN)\n FNERR(1224);\n } else if (fn == op_ldint || fn == op_ldintneg) {\n // nothing to check!\n } else if (fn == op_bitconv) {\n if (arg & ~0x1f)\n FNERR(1253);\n auto sz = arg & 0xf;\n if (sz != 1 && sz != 2 && sz != 4)\n FNERR(1254);\n } else if (fn == op_jmp || fn == op_jmpnz || fn == op_jmpz) {\n unsigned newPC = pc + arg; // will overflow for backjump, but this is fine\n if (newPC >= lastPC)\n FNERR(1202);\n FORCE_STACK(currStack, 1226, newPC);\n if (fn == op_jmp) {\n if (currStack != baseStack)\n FNERR(1203);\n atEnd = true;\n }\n } else if (fn == op_try) {\n unsigned newPC = pc + arg; // will overflow for backjump, but this is fine\n if (newPC >= lastPC)\n FNERR(1248);\n if (currStack != baseStack)\n FNERR(1249);\n FORCE_STACK(currStack, 1250, newPC);\n } else {\n FNERR(1225);\n }\n\n if (hasPush)\n currStack++;\n }\n\n if (!atEnd) {\n pc--;\n FNERR(1210);\n }\n}\n\n} // namespace pxt",
"vm.h": "#ifndef _PXT_VM_H\n#define _PXT_VM_H\n\n#include \n#include \n\n#define VM_MAGIC0 0x000a34365458500aULL // \\nPXT64\\n\\0\n#define VM_MAGIC1 0x6837215e2bfe7154ULL\n\n#define VM_OPCODE_BASE_SIZE 6 // up to 63 base opcodes\n#define VM_OPCODE_PUSH_MASK (1 << VM_OPCODE_BASE_SIZE)\n#define VM_OPCODE_ARG_POS (VM_OPCODE_BASE_SIZE + 1)\n#define VM_OPCODE_BASE_MASK ((1 << VM_OPCODE_BASE_SIZE) - 1)\n#define VM_FIRST_RTCALL (VM_OPCODE_BASE_MASK + 1)\n#define VM_RTCALL_PUSH_MASK 0x2000\n\n#define VM_FUNCTION_CODE_OFFSET (8 * 4)\n\n// The binary has space for 4 64 bit pointers, so on 32 bit machines we pretend there is 8 of them\n#ifdef PXT32\n#define VM_NUM_CPP_METHODS 8\n#else\n#define VM_NUM_CPP_METHODS 4\n#endif\n\n// maximum size (in words) of stack in a single function\n#define VM_MAX_FUNCTION_STACK 200\n#define VM_STACK_SIZE 1000\n\n#define VM_ENCODE_PC(pc) ((TValue)(((pc) << 9) | 2))\n#define VM_DECODE_PC(pc) (((uintptr_t)(pc)) >> 9)\n#define VM_IS_ENCODED_PC(v) ((((uintptr_t)(v)) & ((1 << 9) - 1)) == 2)\n#define TAG_STACK_BOTTOM VM_ENCODE_PC(1)\n\n#define PXTEXT extern\n#ifdef __MINGW32__\n#define DLLEXPORT PXTEXT \"C\"\n#else\n#define DLLEXPORT PXTEXT \"C\"\n#endif\n\nnamespace pxt {\n\nstruct FiberContext;\ntypedef void (*OpFun)(FiberContext *ctx, unsigned arg);\ntypedef void (*ApiFun)(FiberContext *ctx);\n\n// keep in sync with backvm.ts\nenum class SectionType : uint8_t {\n Invalid = 0x00,\n\n // singular sections\n InfoHeader = 0x01, // VMImageHeader\n OpCodeMap = 0x02, // \\0-terminated names of opcodes and APIs (shims)\n NumberLiterals = 0x03, // array of boxed doubles and ints\n ConfigData = 0x04, // sorted array of pairs of int32s; zero-terminated\n IfaceMemberNames = 0x05, // array of 32 bit offsets, that point to string literals\n NumberBoxes = 0x06, // numbers from NumberLiteral that need to be boxed on 32 bit hosts\n\n // repetitive sections\n Function = 0x20,\n Literal = 0x21, // aux field contains literal type (string, hex, image, ...)\n VTable = 0x22,\n};\n\nstruct VMImageSection {\n SectionType type;\n uint8_t flags;\n uint16_t aux;\n uint32_t size; // in bytes, including this header\n uint8_t data[0];\n};\n\nstatic inline TValue vmLiteralVal(VMImageSection *sect) {\n#ifdef PXT64\n return (TValue)sect->data;\n#else\n return (TValue)(sect->data + 4);\n#endif\n}\n\nstatic inline VMImageSection *vmNextSection(VMImageSection *sect) {\n return (VMImageSection *)((uint8_t *)sect + sect->size);\n}\n\nstruct VMPatchState;\nVMPatchState *vm_alloc_patch_state();\nvoid vm_finish_patch(VMPatchState *state);\nconst char *vm_patch_image(VMPatchState *state, uint8_t *data, uint32_t len);\n\nSTATIC_ASSERT(sizeof(VMImageSection) == 8);\n\n#define PXT_WAIT_SOURCE_PROMISE 0x1fff0\n\nstruct OpcodeDesc {\n const char *name;\n OpFun fn;\n int numArgs;\n};\n\nstruct IfaceEntry {\n uint16_t memberId;\n uint16_t aux;\n uint32_t method;\n};\n\nextern const OpcodeDesc staticOpcodes[];\n\nstruct VMImageHeader {\n uint64_t magic0;\n uint64_t magic1;\n uint64_t hexHash;\n uint64_t programHash;\n\n uint32_t allocGlobals;\n uint32_t nonPointerGlobals;\n\n uint64_t lastUsageTime;\n uint64_t installationTime;\n uint64_t publicationTime;\n uint32_t imageSize;\n uint8_t reserved[60];\n uint8_t name[128];\n};\n\nstruct VMImage {\n TValue *numberLiterals;\n TValue *pointerLiterals;\n BoxedNumber *boxedNumbers;\n OpFun *opcodes;\n int32_t *configData;\n uintptr_t *ifaceMemberNames;\n\n uint64_t *dataStart, *dataEnd;\n VMImageSection **sections;\n VMImageHeader *infoHeader;\n const OpcodeDesc **opcodeDescs;\n RefAction *entryPoint;\n\n // every fiber's sp starts at stackTop and goes towards stackBase\n // stackTop > stackBase\n // stackLimit is close to stackBase\n TValue *stackBase;\n TValue *stackTop;\n TValue *stackLimit;\n\n uint32_t numSections;\n uint32_t numNumberLiterals;\n uint32_t numConfigDataEntries;\n uint32_t numOpcodes;\n uint32_t numIfaceMemberNames;\n uint32_t errorCode;\n uint32_t errorOffset;\n int toStringKey;\n\n int execLock;\n};\n\ntypedef TValue (*fiber_resume_t)(void *);\n\nstruct FiberContext {\n FiberContext *next;\n\n uint16_t *imgbase;\n VMImage *img;\n uint16_t *pc;\n uint16_t *resumePC;\n uint16_t *foreverPC;\n TValue *sp;\n TValue r0;\n RefAction *currAction;\n\n TryFrame *tryFrame;\n TValue thrownValue;\n jmp_buf loopjmp;\n\n TValue *stackCopy;\n int stackCopySize;\n\n // wait_for_event\n int waitSource;\n int waitValue;\n\n // for sleep\n uint64_t wakeTime;\n\n fiber_resume_t wakeFn;\n void *wakeFnArg;\n HandlerBinding *handlerBinding;\n};\n\n#define PXT_EXN_CTX() currentFiber\n\nvoid restoreVMExceptionState(TryFrame *tf, FiberContext *ctx);\n#define pxt_restore_exception_state restoreVMExceptionState\n\nFiberContext *suspendFiber(); // returns currentFiber\n// this can be called from a different thread; fn(arg) will be called from user code thread\n// just before the VM resumes execution; the result value will be stored in ctx->r0\nvoid resumeFiberWithFn(FiberContext *ctx, fiber_resume_t fn, void *arg);\n// a simpler version\nvoid resumeFiber(FiberContext *ctx, TValue v);\n\nextern VMImage *vmImg;\nextern FiberContext *currentFiber;\nextern volatile int panicCode;\n\nstatic inline uint16_t *actionPC(RefAction *ra) {\n return (uint16_t *)((uint8_t *)vmImg->dataStart + (uint32_t)ra->func);\n}\n\nvoid vmStart();\nVMImage *loadVMImage(void *data, unsigned length);\nvoid unloadVMImage(VMImage *img);\nVMImage *setVMImgError(VMImage *img, int code, void *pos);\nvoid exec_loop(FiberContext *ctx);\nvoid vmStartFromUser(const char *fn);\nvoid target_yield();\n\n#define DEF_CONVERSION(retp, tp, btp) \\\n static inline retp tp(TValue v) { \\\n if (!isPointer(v)) \\\n failedCast(v); \\\n if (getVTable((RefObject *)v)->classNo != btp) \\\n failedCast(v); \\\n return (retp)v; \\\n }\n\nDEF_CONVERSION(RefCollection *, asRefCollection, BuiltInType::RefCollection)\nDEF_CONVERSION(RefAction *, asRefAction, BuiltInType::RefAction)\nDEF_CONVERSION(RefRefLocal *, asRefRefLocal, BuiltInType::RefRefLocal)\nDEF_CONVERSION(RefMap *, asRefMap, BuiltInType::RefMap)\n\nDEF_CONVERSION(Buffer, asBuffer, BuiltInType::BoxedBuffer)\nDEF_CONVERSION(Image_, asImage_, BuiltInType::RefImage)\n\nString convertToString(FiberContext *ctx, TValue v);\n\n} // namespace pxt\n\n#endif",
"vmload.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\n\nVMImage *vmImg;\nTaskHandle_t userCodeTask;\n\nstatic void vmStartCore(uint8_t *data, unsigned len) {\n unloadVMImage(vmImg);\n vmImg = NULL;\n\n userCodeTask = xTaskGetCurrentTaskHandle();\n\n gcPreStartup();\n\n auto img = loadVMImage(data, len);\n if (img->errorCode) {\n dmesg(\"validation error %d at 0x%x\", img->errorCode, img->errorOffset);\n return;\n } else {\n dmesg(\"Validation OK\");\n }\n vmImg = img;\n\n gcStartup();\n\n globals = (TValue *)app_alloc(sizeof(TValue) * getNumGlobals());\n memset(globals, 0, sizeof(TValue) * getNumGlobals());\n\n initRuntime();\n}\n\nvoid vmStart() {\n memInfo();\n install_gpio0_handler();\n\n auto sect = (VMImageSection *)PXT_EXPORTData[4];\n auto hd = (VMImageHeader *)sect->data;\n if (sect->type != SectionType::InfoHeader || hd->magic0 != VM_MAGIC0 || hd->imageSize < 256) {\n dmesg(\"invalid image at %p\", sect);\n return;\n }\n\n vmStartCore((uint8_t *)sect, hd->imageSize);\n}\n\n//% expose\nvoid updateScreen(Image_ img) {\n // dummy\n}\n\n} // namespace pxt",
"worker.cpp": "#include \"pxt.h\"\n#include \"freertos/queue.h\"\n\nnamespace pxt {\n\nstruct worker {\n TaskHandle_t task;\n xQueueHandle queue;\n TaskFunction_t fn;\n void *arg;\n};\n\ntypedef struct qitem {\n TaskFunction_t fn;\n void *arg;\n} qitem_t;\n\nstatic void worker_main(void *arg) {\n worker_t w = (worker_t)arg;\n while (1) {\n qitem_t evt;\n if (xQueueReceive(w->queue, &evt, w->fn ? 20 : 1))\n evt.fn(evt.arg);\n if (w->fn)\n w->fn(w->arg);\n }\n}\n\n\nworker_t worker_alloc(const char *id, uint32_t stack_size) {\n worker_t w = (worker_t)calloc(1, sizeof(struct worker));\n w->queue = xQueueCreate(20, sizeof(qitem_t));\n // The main task is at priority 1, so we're higher priority (run \"more often\").\n // Timer task runs at much higher priority (~20).\n xTaskCreatePinnedToCore(worker_main, id, stack_size, w, 2, &w->task, WORKER_CPU);\n return w;\n}\n\nvoid worker_set_idle(worker_t w, TaskFunction_t fn, void *arg) {\n w->fn = fn;\n w->arg = arg;\n}\n\nint worker_run(worker_t w, TaskFunction_t fn, void *arg) {\n qitem_t evt = {fn, arg};\n if (xQueueSendFromISR(w->queue, &evt, NULL) == pdPASS)\n return 0;\n return -1;\n}\n\nint worker_run_wait(worker_t w, TaskFunction_t fn, void *arg) {\n qitem_t evt = {fn, arg};\n if (xQueueSend(w->queue, &evt, 100) == pdPASS)\n return 0;\n return -1;\n}\n\n\n}"
},
"core---esp32s2": {
"CMakeLists.txt": "cmake_minimum_required(VERSION 3.5)\n\ninclude($ENV{IDF_PATH}/tools/cmake/project.cmake)\n\nproject(pxtapp)\n",
"Makefile": "all: certs/ca-bundle.pem\n\tLC_ALL=C.UTF-8 idf.py build\n\tbase64 build/pxtapp.bin > build/pxtapp.b64\n\ninclude certs.mk",
"README.md": "# core\n\nThe core library for Codal-based targets.\n\n",
"certs.mk": "certs/ca-bundle.pem:\n\tmkdir -p certs\n\tcurl https://raw.githubusercontent.com/microsoft/pxt-common-packages/9e8fdb8fd6e21c096f1fe2340652473ddab05d7e/libs/wifi---esp32/ca-bundle.pem > $@\n",
"codalemu.cpp": "#include \"pxt.h\"\n\nIRAM_ATTR void target_wait_us(uint32_t us) {\n int64_t later = esp_timer_get_time() + us;\n while (esp_timer_get_time() < later) {\n ;\n }\n}\n\nstatic portMUX_TYPE global_int_mux = portMUX_INITIALIZER_UNLOCKED;\nint int_level;\n\nIRAM_ATTR void target_disable_irq() {\n vPortEnterCritical(&global_int_mux);\n int_level++;\n}\n\nIRAM_ATTR void target_enable_irq() {\n int_level--;\n vPortExitCritical(&global_int_mux);\n}\n",
"config.cpp": "\n",
"control.cpp": "#include \"pxt.h\"\n\nnamespace control {\n\n/**\n * Announce that an event happened to registered handlers.\n * @param src ID of the Component that generated the event\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.\n */\n//% weight=21 blockGap=12 blockId=\"control_raise_event\"\n//% block=\"raise event|from %src|with value %value\" blockExternalInputs=1\n//% help=control/raise-event\nvoid raiseEvent(int src, int value) {\n pxt::raiseEvent(src, value);\n}\n\n/**\n* Allocates the next user notification event\n*/\n//% help=control/allocate-notify-event\nint allocateNotifyEvent() {\n return pxt::allocateNotifyEvent();\n}\n\n/**\n* Determine the version of system software currently running.\n*/\n//% blockId=\"control_device_dal_version\" block=\"device dal version\"\n//% help=control/device-dal-version\nString deviceDalVersion() {\n#ifdef PXT_VM\n return mkString(\"vm\");\n#else\n return mkString(\"linux\");\n#endif\n}\n\n\n/** Write data to DMESG debugging buffer. */\n//%\nvoid dmesg(String s) {\n DMESG(\"# %s\", s->getUTF8Data());\n}\n\n//%\nuint32_t _ramSize()\n{\n#ifdef POKY\n return 128 * 1024;\n#else\n // a lot! doesn't really matter how much\n return 16 * 1024 * 1024;\n#endif\n}\n\n/**\n * Determines if the USB has been enumerated.\n */\n//%\nbool isUSBInitialized() {\n return false;\n}\n\n}\n\nnamespace serial {\n /** Send DMESG debug buffer over serial. */\n //%\n void writeDmesg() {\n pxt::dumpDmesg();\n }\n}",
"crypto.cpp": "#include \"pxt.h\"\n#include \"mbedtls/sha256.h\"\n\n// https://eprint.iacr.org/2012/156.pdf - in case more hash functions are needed\n\nnamespace crypto {\n\n/*\n * Compute cryptographic SHA256 hash of the concatenation of buffers. Returns 32-byte buffer.\n */\n//% promise\nBuffer _sha256(RefCollection *buffers) {\n mbedtls_sha256_context sha256_ctx;\n uint8_t output[32];\n\n auto bufs = buffers->getData();\n auto len = buffers->length();\n\n mbedtls_sha256_init(&sha256_ctx);\n mbedtls_sha256_starts_ret(&sha256_ctx, false);\n\n while (len--) {\n if (BoxedBuffer::isInstance(*bufs)) {\n auto buf = (BoxedBuffer *)*bufs;\n mbedtls_sha256_update_ret(&sha256_ctx, buf->data, buf->length);\n }\n bufs++;\n }\n\n mbedtls_sha256_finish_ret(&sha256_ctx, output);\n\n return mkBuffer(output, sizeof(output));\n}\n\n} // namespace crypto",
"crypto.ts": "namespace crypto {\n /**\n * Compute cryptographic SHA256 hash of the concatenation of buffers. Returns 32-byte buffer.\n */\n //% promise shim=crypto::_sha256\n export declare function sha256(buffers: Buffer[]): Buffer;\n\n\n /**\n * Compute keyed-Hash Message Authentication Code as defined in RFC 2104.\n */\n export function sha256Hmac(key: Buffer, msg: Buffer) {\n const blockSize = 64\n if (key.length > blockSize) key = sha256([key])\n const paddedKey = Buffer.create(blockSize)\n paddedKey.write(0, key)\n for (let i = 0; i < blockSize; ++i) paddedKey[i] ^= 0x36\n const h0 = sha256([paddedKey, msg])\n for (let i = 0; i < blockSize; ++i) paddedKey[i] ^= (0x36 ^ 0x5c)\n return sha256([paddedKey, h0])\n }\n\n} // namespace crypto",
"dal.d.ts": "// Auto-generated. Do not edit.\ndeclare const enum DAL {\n // /main/configkeys.h\n CFG_PIN_NAME_MSK = 65535,\n CFG_PIN_CONFIG_MSK = 4294901760,\n CFG_PIN_CONFIG_ACTIVE_LO = 65536,\n CFG_MAGIC0 = 513675505,\n CFG_MAGIC1 = 539130489,\n CFG_PIN_ACCELEROMETER_INT = 1,\n CFG_PIN_ACCELEROMETER_SCL = 2,\n CFG_PIN_ACCELEROMETER_SDA = 3,\n CFG_PIN_BTN_A = 4,\n CFG_PIN_BTN_B = 5,\n CFG_PIN_BTN_SLIDE = 6,\n CFG_PIN_DOTSTAR_CLOCK = 7,\n CFG_PIN_DOTSTAR_DATA = 8,\n CFG_PIN_FLASH_CS = 9,\n CFG_PIN_FLASH_MISO = 10,\n CFG_PIN_FLASH_MOSI = 11,\n CFG_PIN_FLASH_SCK = 12,\n CFG_PIN_LED = 13,\n CFG_PIN_LIGHT = 14,\n CFG_PIN_MICROPHONE = 15,\n CFG_PIN_MIC_CLOCK = 16,\n CFG_PIN_MIC_DATA = 17,\n CFG_PIN_MISO = 18,\n CFG_PIN_MOSI = 19,\n CFG_PIN_NEOPIXEL = 20,\n CFG_PIN_RX = 21,\n CFG_PIN_RXLED = 22,\n CFG_PIN_SCK = 23,\n CFG_PIN_SCL = 24,\n CFG_PIN_SDA = 25,\n CFG_PIN_SPEAKER_AMP = 26,\n CFG_PIN_TEMPERATURE = 27,\n CFG_PIN_TX = 28,\n CFG_PIN_TXLED = 29,\n CFG_PIN_IR_OUT = 30,\n CFG_PIN_IR_IN = 31,\n CFG_PIN_DISPLAY_SCK = 32,\n CFG_PIN_DISPLAY_MISO = 33,\n CFG_PIN_DISPLAY_MOSI = 34,\n CFG_PIN_DISPLAY_CS = 35,\n CFG_PIN_DISPLAY_DC = 36,\n CFG_DISPLAY_WIDTH = 37,\n CFG_DISPLAY_HEIGHT = 38,\n CFG_DISPLAY_CFG0 = 39,\n CFG_DISPLAY_CFG1 = 40,\n CFG_DISPLAY_CFG2 = 41,\n CFG_DISPLAY_CFG3 = 42,\n CFG_PIN_DISPLAY_RST = 43,\n CFG_PIN_DISPLAY_BL = 44,\n CFG_PIN_SERVO_1 = 45,\n CFG_PIN_SERVO_2 = 46,\n CFG_PIN_BTN_LEFT = 47,\n CFG_PIN_BTN_RIGHT = 48,\n CFG_PIN_BTN_UP = 49,\n CFG_PIN_BTN_DOWN = 50,\n CFG_PIN_BTN_MENU = 51,\n CFG_PIN_LED_R = 52,\n CFG_PIN_LED_G = 53,\n CFG_PIN_LED_B = 54,\n CFG_PIN_LED1 = 55,\n CFG_PIN_LED2 = 56,\n CFG_PIN_LED3 = 57,\n CFG_PIN_LED4 = 58,\n CFG_SPEAKER_VOLUME = 59,\n CFG_PIN_JACK_TX = 60,\n CFG_PIN_JACK_SENSE = 61,\n CFG_PIN_JACK_HPEN = 62,\n CFG_PIN_JACK_BZEN = 63,\n CFG_PIN_JACK_PWREN = 64,\n CFG_PIN_JACK_SND = 65,\n CFG_PIN_JACK_BUSLED = 66,\n CFG_PIN_JACK_COMMLED = 67,\n CFG_PIN_BTN_SOFT_RESET = 69,\n CFG_ACCELEROMETER_TYPE = 70,\n CFG_PIN_BTNMX_LATCH = 71,\n CFG_PIN_BTNMX_CLOCK = 72,\n CFG_PIN_BTNMX_DATA = 73,\n CFG_PIN_BTN_MENU2 = 74,\n CFG_PIN_BATTSENSE = 75,\n CFG_PIN_VIBRATION = 76,\n CFG_PIN_PWREN = 77,\n CFG_DISPLAY_TYPE = 78,\n CFG_PIN_ROTARY_ENCODER_A = 79,\n CFG_PIN_ROTARY_ENCODER_B = 80,\n CFG_ACCELEROMETER_SPACE = 81,\n CFG_PIN_WIFI_MOSI = 82,\n CFG_PIN_WIFI_MISO = 83,\n CFG_PIN_WIFI_SCK = 84,\n CFG_PIN_WIFI_TX = 85,\n CFG_PIN_WIFI_RX = 86,\n CFG_PIN_WIFI_CS = 87,\n CFG_PIN_WIFI_BUSY = 88,\n CFG_PIN_WIFI_RESET = 89,\n CFG_PIN_WIFI_GPIO0 = 90,\n CFG_PIN_WIFI_AT_TX = 91,\n CFG_PIN_WIFI_AT_RX = 92,\n CFG_PIN_USB_POWER = 93,\n ACCELEROMETER_TYPE_LIS3DH = 50,\n ACCELEROMETER_TYPE_LIS3DH_ALT = 48,\n ACCELEROMETER_TYPE_MMA8453 = 56,\n ACCELEROMETER_TYPE_FXOS8700 = 60,\n ACCELEROMETER_TYPE_MMA8653 = 58,\n ACCELEROMETER_TYPE_MSA300 = 76,\n ACCELEROMETER_TYPE_MPU6050 = 104,\n DISPLAY_TYPE_ST7735 = 7735,\n DISPLAY_TYPE_ILI9341 = 9341,\n DISPLAY_TYPE_SMART = 4242,\n CFG_PIN_A0 = 100,\n CFG_PIN_A1 = 101,\n CFG_PIN_A2 = 102,\n CFG_PIN_A3 = 103,\n CFG_PIN_A4 = 104,\n CFG_PIN_A5 = 105,\n CFG_PIN_A6 = 106,\n CFG_PIN_A7 = 107,\n CFG_PIN_A8 = 108,\n CFG_PIN_A9 = 109,\n CFG_PIN_A10 = 110,\n CFG_PIN_A11 = 111,\n CFG_PIN_A12 = 112,\n CFG_PIN_A13 = 113,\n CFG_PIN_A14 = 114,\n CFG_PIN_A15 = 115,\n CFG_PIN_A16 = 116,\n CFG_PIN_A17 = 117,\n CFG_PIN_A18 = 118,\n CFG_PIN_A19 = 119,\n CFG_PIN_A20 = 120,\n CFG_PIN_A21 = 121,\n CFG_PIN_A22 = 122,\n CFG_PIN_A23 = 123,\n CFG_PIN_A24 = 124,\n CFG_PIN_A25 = 125,\n CFG_PIN_A26 = 126,\n CFG_PIN_A27 = 127,\n CFG_PIN_A28 = 128,\n CFG_PIN_A29 = 129,\n CFG_PIN_A30 = 130,\n CFG_PIN_A31 = 131,\n CFG_PIN_D0 = 150,\n CFG_PIN_D1 = 151,\n CFG_PIN_D2 = 152,\n CFG_PIN_D3 = 153,\n CFG_PIN_D4 = 154,\n CFG_PIN_D5 = 155,\n CFG_PIN_D6 = 156,\n CFG_PIN_D7 = 157,\n CFG_PIN_D8 = 158,\n CFG_PIN_D9 = 159,\n CFG_PIN_D10 = 160,\n CFG_PIN_D11 = 161,\n CFG_PIN_D12 = 162,\n CFG_PIN_D13 = 163,\n CFG_PIN_D14 = 164,\n CFG_PIN_D15 = 165,\n CFG_PIN_D16 = 166,\n CFG_PIN_D17 = 167,\n CFG_PIN_D18 = 168,\n CFG_PIN_D19 = 169,\n CFG_PIN_D20 = 170,\n CFG_PIN_D21 = 171,\n CFG_PIN_D22 = 172,\n CFG_PIN_D23 = 173,\n CFG_PIN_D24 = 174,\n CFG_PIN_D25 = 175,\n CFG_PIN_D26 = 176,\n CFG_PIN_D27 = 177,\n CFG_PIN_D28 = 178,\n CFG_PIN_D29 = 179,\n CFG_PIN_D30 = 180,\n CFG_PIN_D31 = 181,\n CFG_NUM_NEOPIXELS = 200,\n CFG_NUM_DOTSTARS = 201,\n CFG_DEFAULT_BUTTON_MODE = 202,\n CFG_SWD_ENABLED = 203,\n CFG_FLASH_BYTES = 204,\n CFG_RAM_BYTES = 205,\n CFG_SYSTEM_HEAP_BYTES = 206,\n CFG_LOW_MEM_SIMULATION_KB = 207,\n CFG_BOOTLOADER_BOARD_ID = 208,\n CFG_UF2_FAMILY = 209,\n CFG_PINS_PORT_SIZE = 210,\n CFG_BOOTLOADER_PROTECTION = 211,\n CFG_POWER_DEEPSLEEP_TIMEOUT = 212,\n CFG_ANALOG_BUTTON_THRESHOLD = 213,\n CFG_CPU_MHZ = 214,\n CFG_CONTROLLER_LIGHT_MAX_BRIGHTNESS = 215,\n CFG_ANALOG_JOYSTICK_MIN = 216,\n CFG_ANALOG_JOYSTICK_MAX = 217,\n CFG_TIMERS_TO_USE = 218,\n CFG_PIN_ONBOARD_DOTSTAR_CLOCK = 219,\n CFG_PIN_ONBOARD_DOTSTAR_DATA = 220,\n CFG_NUM_ONBOARD_DOTSTARS = 221,\n CFG_PIN_ONBOARD_NEOPIXEL = 222,\n CFG_NUM_ONBOARD_NEOPIXELS = 223,\n CFG_MATRIX_KEYPAD_MESSAGE_ID = 239,\n CFG_NUM_MATRIX_KEYPAD_ROWS = 240,\n CFG_PIN_MATRIX_KEYPAD_ROW0 = 241,\n CFG_PIN_MATRIX_KEYPAD_ROW1 = 242,\n CFG_PIN_MATRIX_KEYPAD_ROW2 = 243,\n CFG_PIN_MATRIX_KEYPAD_ROW3 = 244,\n CFG_PIN_MATRIX_KEYPAD_ROW4 = 245,\n CFG_PIN_MATRIX_KEYPAD_ROW5 = 246,\n CFG_PIN_MATRIX_KEYPAD_ROW6 = 247,\n CFG_PIN_MATRIX_KEYPAD_ROW7 = 248,\n CFG_NUM_MATRIX_KEYPAD_COLS = 250,\n CFG_PIN_MATRIX_KEYPAD_COL0 = 251,\n CFG_PIN_MATRIX_KEYPAD_COL1 = 252,\n CFG_PIN_MATRIX_KEYPAD_COL2 = 253,\n CFG_PIN_MATRIX_KEYPAD_COL3 = 254,\n CFG_PIN_MATRIX_KEYPAD_COL4 = 255,\n CFG_PIN_MATRIX_KEYPAD_COL5 = 256,\n CFG_PIN_MATRIX_KEYPAD_COL6 = 257,\n CFG_PIN_MATRIX_KEYPAD_COL7 = 258,\n CFG_PIN_B0 = 300,\n CFG_PIN_B1 = 301,\n CFG_PIN_B2 = 302,\n CFG_PIN_B3 = 303,\n CFG_PIN_B4 = 304,\n CFG_PIN_B5 = 305,\n CFG_PIN_B6 = 306,\n CFG_PIN_B7 = 307,\n CFG_PIN_B8 = 308,\n CFG_PIN_B9 = 309,\n CFG_PIN_B10 = 310,\n CFG_PIN_B11 = 311,\n CFG_PIN_B12 = 312,\n CFG_PIN_B13 = 313,\n CFG_PIN_B14 = 314,\n CFG_PIN_B15 = 315,\n CFG_PIN_B16 = 316,\n CFG_PIN_B17 = 317,\n CFG_PIN_B18 = 318,\n CFG_PIN_B19 = 319,\n CFG_PIN_B20 = 320,\n CFG_PIN_B21 = 321,\n CFG_PIN_B22 = 322,\n CFG_PIN_B23 = 323,\n CFG_PIN_B24 = 324,\n CFG_PIN_B25 = 325,\n CFG_PIN_B26 = 326,\n CFG_PIN_B27 = 327,\n CFG_PIN_B28 = 328,\n CFG_PIN_B29 = 329,\n CFG_PIN_B30 = 330,\n CFG_PIN_B31 = 331,\n CFG_PIN_C0 = 350,\n CFG_PIN_C1 = 351,\n CFG_PIN_C2 = 352,\n CFG_PIN_C3 = 353,\n CFG_PIN_C4 = 354,\n CFG_PIN_C5 = 355,\n CFG_PIN_C6 = 356,\n CFG_PIN_C7 = 357,\n CFG_PIN_C8 = 358,\n CFG_PIN_C9 = 359,\n CFG_PIN_C10 = 360,\n CFG_PIN_C11 = 361,\n CFG_PIN_C12 = 362,\n CFG_PIN_C13 = 363,\n CFG_PIN_C14 = 364,\n CFG_PIN_C15 = 365,\n CFG_PIN_C16 = 366,\n CFG_PIN_C17 = 367,\n CFG_PIN_C18 = 368,\n CFG_PIN_C19 = 369,\n CFG_PIN_C20 = 370,\n CFG_PIN_C21 = 371,\n CFG_PIN_C22 = 372,\n CFG_PIN_C23 = 373,\n CFG_PIN_C24 = 374,\n CFG_PIN_C25 = 375,\n CFG_PIN_C26 = 376,\n CFG_PIN_C27 = 377,\n CFG_PIN_C28 = 378,\n CFG_PIN_C29 = 379,\n CFG_PIN_C30 = 380,\n CFG_PIN_C31 = 381,\n CFG_PIN_P0 = 400,\n CFG_PIN_P1 = 401,\n CFG_PIN_P2 = 402,\n CFG_PIN_P3 = 403,\n CFG_PIN_P4 = 404,\n CFG_PIN_P5 = 405,\n CFG_PIN_P6 = 406,\n CFG_PIN_P7 = 407,\n CFG_PIN_P8 = 408,\n CFG_PIN_P9 = 409,\n CFG_PIN_P10 = 410,\n CFG_PIN_P11 = 411,\n CFG_PIN_P12 = 412,\n CFG_PIN_P13 = 413,\n CFG_PIN_P14 = 414,\n CFG_PIN_P15 = 415,\n CFG_PIN_P16 = 416,\n CFG_PIN_P17 = 417,\n CFG_PIN_P18 = 418,\n CFG_PIN_P19 = 419,\n CFG_PIN_P20 = 420,\n CFG_PIN_P21 = 421,\n CFG_PIN_P22 = 422,\n CFG_PIN_P23 = 423,\n CFG_PIN_P24 = 424,\n CFG_PIN_P25 = 425,\n CFG_PIN_P26 = 426,\n CFG_PIN_P27 = 427,\n CFG_PIN_P28 = 428,\n CFG_PIN_P29 = 429,\n CFG_PIN_P30 = 430,\n CFG_PIN_P31 = 431,\n CFG_PIN_P32 = 432,\n CFG_PIN_P33 = 433,\n CFG_PIN_P34 = 434,\n CFG_PIN_P35 = 435,\n CFG_PIN_P36 = 436,\n CFG_PIN_P37 = 437,\n CFG_PIN_P38 = 438,\n CFG_PIN_P39 = 439,\n CFG_PIN_P40 = 440,\n CFG_PIN_P41 = 441,\n CFG_PIN_P42 = 442,\n CFG_PIN_P43 = 443,\n CFG_PIN_P44 = 444,\n CFG_PIN_P45 = 445,\n CFG_PIN_P46 = 446,\n CFG_PIN_P47 = 447,\n CFG_PIN_P48 = 448,\n CFG_PIN_P49 = 449,\n CFG_PIN_P50 = 450,\n CFG_PIN_P51 = 451,\n CFG_PIN_P52 = 452,\n CFG_PIN_P53 = 453,\n CFG_PIN_P54 = 454,\n CFG_PIN_P55 = 455,\n CFG_PIN_P56 = 456,\n CFG_PIN_P57 = 457,\n CFG_PIN_P58 = 458,\n CFG_PIN_P59 = 459,\n CFG_PIN_P60 = 460,\n CFG_PIN_P61 = 461,\n CFG_PIN_P62 = 462,\n CFG_PIN_P63 = 463,\n CFG_PIN_LORA_MISO = 1001,\n CFG_PIN_LORA_MOSI = 1002,\n CFG_PIN_LORA_SCK = 1003,\n CFG_PIN_LORA_CS = 1004,\n CFG_PIN_LORA_BOOT = 1005,\n CFG_PIN_LORA_RESET = 1006,\n CFG_PIN_IRRXLED = 1007,\n CFG_PIN_IRTXLED = 1008,\n CFG_PIN_LCD_RESET = 1009,\n CFG_PIN_LCD_ENABLE = 1010,\n CFG_PIN_LCD_DATALINE4 = 1011,\n CFG_PIN_LCD_DATALINE5 = 1012,\n CFG_PIN_LCD_DATALINE6 = 1013,\n CFG_PIN_LCD_DATALINE7 = 1014,\n CFG_NUM_LCD_COLUMNS = 1015,\n CFG_NUM_LCD_ROWS = 1016,\n CFG_PIN_RCC0 = 1017,\n CFG_PIN_RCC1 = 1018,\n CFG_PIN_RCC2 = 1019,\n CFG_PIN_RCC3 = 1020,\n CFG_PIN_RCC4 = 1021,\n CFG_PIN_RCC5 = 1022,\n CFG_PIN_RCC6 = 1023,\n CFG_PIN_RCC7 = 1024,\n CFG_PIN_SERVO0 = 1025,\n CFG_PIN_SERVO1 = 1026,\n CFG_PIN_SERVO2 = 1027,\n CFG_PIN_SERVO3 = 1028,\n CFG_PIN_SERVO4 = 1029,\n CFG_PIN_SERVO5 = 1030,\n CFG_PIN_SERVO6 = 1031,\n CFG_PIN_SERVO7 = 1032,\n CFG_PIN_SERVO8 = 1033,\n CFG_PIN_PI_TX = 1034,\n CFG_PIN_PI_RX = 1035,\n CFG_PIN_GPS_SDA = 1036,\n CFG_PIN_GPS_SCL = 1037,\n CFG_PIN_GPS_TX = 1038,\n CFG_PIN_GPS_RX = 1039,\n CFG_PIN_GROVE0 = 1040,\n CFG_PIN_GROVE1 = 1041,\n CFG_PIN_SS = 1042,\n CFG_PIN_D33 = 183,\n CFG_PIN_D34 = 184,\n CFG_PIN_D35 = 185,\n CFG_PIN_D36 = 186,\n CFG_PIN_D37 = 187,\n CFG_PIN_D38 = 188,\n CFG_PIN_D39 = 189,\n CFG_PIN_D40 = 190,\n CFG_PIN_D41 = 191,\n CFG_PIN_D42 = 192,\n CFG_PIN_D43 = 193,\n CFG_PIN_D44 = 194,\n CFG_PIN_D45 = 195,\n CFG_PIN_D46 = 196,\n CFG_PIN_D47 = 197,\n CFG_PIN_D48 = 198,\n CFG_PIN_D49 = 199,\n CFG_PIN_D50 = 259,\n CFG_PIN_D51 = 260,\n CFG_PIN_D52 = 261,\n CFG_PIN_D53 = 262,\n CFG_PIN_TX1 = 263,\n CFG_PIN_TX2 = 264,\n CFG_PIN_TX3 = 265,\n CFG_PIN_RX1 = 266,\n CFG_PIN_RX2 = 267,\n CFG_PIN_RX3 = 268,\n CFG_PIN_SCL1 = 269,\n CFG_PIN_SDA1 = 270,\n CFG_PIN_PCC_D0 = 271,\n CFG_PIN_PCC_D1 = 272,\n CFG_PIN_PCC_D2 = 273,\n CFG_PIN_PCC_D3 = 274,\n CFG_PIN_PCC_D4 = 275,\n CFG_PIN_PCC_D5 = 276,\n CFG_PIN_PCC_D6 = 277,\n CFG_PIN_PCC_D7 = 278,\n CFG_PIN_PCC_D8 = 279,\n CFG_PIN_PCC_D9 = 280,\n CFG_PIN_PCC_D10 = 281,\n CFG_PIN_PCC_D11 = 282,\n CFG_PIN_PCC_D12 = 283,\n CFG_PIN_PCC_D13 = 284,\n CFG_PIN_CC_DEN1 = 285,\n CFG_PIN_CC_DEN2 = 286,\n CFG_PIN_CC_CLK = 287,\n CFG_PIN_XCC_CLK = 288,\n CFG_PIN_JDPWR_PRE_SENSE = 1100,\n CFG_PIN_JDPWR_GND_SENSE = 1101,\n CFG_PIN_JDPWR_PULSE = 1102,\n CFG_PIN_JDPWR_OVERLOAD_LED = 1103,\n CFG_PIN_JDPWR_ENABLE = 1104,\n CFG_PIN_JDPWR_FAULT = 1105,\n // /main/jacdac/JacdacBLE.h\n JACDAC_BLE_BUFFER_SIZE = 254,\n MICROBIT_JACDAC_S_EVT_RX = 1,\n MICROBIT_JACDAC_S_EVT_TX = 1,\n DEVICE_ID_JACDAC_BLE = 3056,\n JD_BLE_STATUS_IN_USE = 8,\n // /main/jacdac/jdprotocol.h\n JD_SERIAL_PAYLOAD_SIZE = 236,\n JD_SERIAL_FULL_HEADER_SIZE = 16,\n JD_SERVICE_CLASS_CTRL = 0,\n JD_SERVICE_NUMBER_CTRL = 0,\n JD_SERVICE_NUMBER_MASK = 63,\n JD_SERVICE_NUMBER_CRC_ACK = 63,\n JD_FRAME_FLAG_COMMAND = 1,\n JD_FRAME_FLAG_ACK_REQUESTED = 2,\n JD_FRAME_FLAG_IDENTIFIER_IS_SERVICE_CLASS = 4,\n JD_REG_INTENSITY = 1,\n JD_REG_VALUE = 2,\n JD_REG_IS_STREAMING = 3,\n JD_REG_STREAMING_INTERVAL = 4,\n JD_REG_LOW_THRESHOLD = 5,\n JD_REG_HIGH_THRESHOLD = 6,\n JD_REG_MAX_POWER = 7,\n JD_REG_READING = 257,\n JD_CMD_GET_REG = 4096,\n JD_CMD_SET_REG = 8192,\n JD_CMD_ADVERTISEMENT_DATA = 0,\n JD_CMD_EVENT = 1,\n JD_CMD_CALIBRATE = 2,\n JD_CMD_GET_DESCRIPTION = 3,\n JD_CMD_CTRL_NOOP = 128,\n JD_CMD_CTRL_IDENTIFY = 129,\n JD_CMD_CTRL_RESET = 130,\n JD_REG_CTRL_DEVICE_DESCRIPTION = 384,\n JD_REG_CTRL_DEVICE_CLASS = 385,\n JD_REG_CTRL_TEMPERATURE = 386,\n JD_REG_CTRL_LIGHT_LEVEL = 387,\n JD_REG_CTRL_BL_DEVICE_CLASS = 388,\n JDSPI_MAGIC = 31437,\n JDSPI_MAGIC_NOOP = 46029,\n // /main/pintarget.h\n DEVICE_PIN_EVT_RISE = 2,\n DEVICE_PIN_EVT_FALL = 3,\n DEVICE_PIN_EVT_PULSE_HI = 4,\n DEVICE_PIN_EVT_PULSE_LO = 5,\n DEVICE_PIN_EVENT_NONE = 0,\n DEVICE_PIN_EVENT_ON_EDGE = 1,\n DEVICE_PIN_EVENT_ON_PULSE = 2,\n DEVICE_PIN_EVENT_ON_TOUCH = 3,\n // /main/platform.h\n PXT_ESP32 = 1,\n PAGE_SIZE = 1024,\n DEV_NUM_PINS = 50,\n IMAGE_BITS = 4,\n // /main/pxt.h\n OUTPUT_BITS = 12,\n DEVICE_EVT_ANY = 0,\n DEVICE_ID_NOTIFY_ONE = 1022,\n DEVICE_ID_NOTIFY = 1023,\n DEVICE_ID_JACDAC = 30,\n DEVICE_ID_JACDAC_PHYS = 31,\n // /main/pxtbase.h\n PXT32 = 1,\n PXT64 = 1,\n PXT_REFCNT_FLASH = 65534,\n VTABLE_MAGIC = 249,\n VTABLE_MAGIC2 = 248,\n Undefined = 0,\n Boolean = 1,\n Number = 2,\n String = 3,\n Object = 4,\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,\n MMap = 10,\n BoxedString_SkipList = 11,\n BoxedString_ASCII = 12,\n ZPin = 13,\n User0 = 16,\n IMAGE_HEADER_MAGIC = 135,\n Int8LE = 1,\n UInt8LE = 2,\n Int16LE = 3,\n UInt16LE = 4,\n Int32LE = 5,\n Int8BE = 6,\n UInt8BE = 7,\n Int16BE = 8,\n UInt16BE = 9,\n Int32BE = 10,\n UInt32LE = 11,\n UInt32BE = 12,\n Float32LE = 13,\n Float64LE = 14,\n Float32BE = 15,\n Float64BE = 16,\n NUM_TRY_FRAME_REGS = 3,\n GC = 0,\n PXT_STRING_SKIP_INCR = 16,\n // /main/pxtconfig.h\n PXT_VM = 1,\n PXT_UF2_FAMILY = 3218951918,\n // /main/pxtcore.h\n PXT_HARD_FLOAT = 1,\n // /main/uf2hid.h\n UF2_HID_H = 1,\n HF2_CMD_BININFO = 1,\n HF2_MODE_BOOTLOADER = 1,\n HF2_MODE_USERSPACE = 2,\n HF2_CMD_INFO = 2,\n HF2_CMD_RESET_INTO_APP = 3,\n HF2_CMD_RESET_INTO_BOOTLOADER = 4,\n HF2_CMD_START_FLASH = 5,\n HF2_CMD_WRITE_FLASH_PAGE = 6,\n HF2_CMD_CHKSUM_PAGES = 7,\n HF2_CMD_READ_WORDS = 8,\n HF2_CMD_WRITE_WORDS = 9,\n HF2_CMD_DMESG = 16,\n HF2_EV_MASK = 8388608,\n HF2_CMD_JDS_CONFIG = 32,\n HF2_CMD_JDS_SEND = 33,\n HF2_EV_JDS_PACKET = 8388640,\n HF2_FLAG_SERIAL_OUT = 128,\n HF2_FLAG_SERIAL_ERR = 192,\n HF2_FLAG_CMDPKT_LAST = 64,\n HF2_FLAG_CMDPKT_BODY = 0,\n HF2_FLAG_MASK = 192,\n HF2_SIZE_MASK = 63,\n HF2_STATUS_OK = 0,\n HF2_STATUS_INVALID_CMD = 1,\n HF2_STATUS_INVALID_STATE = 2,\n // /main/vm.h\n VM_OPCODE_BASE_SIZE = 6,\n VM_OPCODE_ARG_POS = 7,\n VM_RTCALL_PUSH_MASK = 8192,\n VM_MAX_FUNCTION_STACK = 200,\n VM_STACK_SIZE = 1000,\n Invalid = 0,\n InfoHeader = 1,\n OpCodeMap = 2,\n NumberLiterals = 3,\n ConfigData = 4,\n IfaceMemberNames = 5,\n NumberBoxes = 6,\n Literal = 33,\n VTable = 34,\n PXT_WAIT_SOURCE_PROMISE = 131056,\n}\n",
"dmesg.cpp": "#include \"pxt.h\"\n#include \n#include \n#include \n#include \n#include \n#include \n\n#include \"esp_log.h\"\n\nnamespace pxt {\n\n#define LOG_QUEUE_SIZE (2 * 1024)\nclass LogQueue {\n void writeCore(const char *buf, int len);\n\n public:\n int ptr;\n char buffer[LOG_QUEUE_SIZE];\n int rdPtr;\n int numWrap;\n LogQueue();\n int write(const char *buf, int len);\n int read(char *buf, int len);\n};\n\n} // namespace pxt\n\nLogQueue codalLogStore;\n\nnamespace pxt {\nLogQueue::LogQueue() {\n ptr = 0;\n rdPtr = 0;\n numWrap = 0;\n memset(buffer, 0, sizeof(buffer));\n}\n\nvoid LogQueue::writeCore(const char *buf, int len) {\n memcpy(buffer + ptr, buf, len);\n // did we pass it?\n if (ptr < rdPtr && rdPtr <= ptr + len)\n rdPtr = -1;\n ptr += len;\n}\n\nint LogQueue::read(char *buf, int len) {\n if (rdPtr < 0) {\n if (numWrap == 0) {\n rdPtr = 0;\n } else {\n rdPtr = ptr + 1;\n }\n }\n\n if (rdPtr <= ptr) {\n int av = ptr - rdPtr;\n if (len > av)\n len = av;\n memcpy(buf, buffer + rdPtr, len);\n rdPtr += len;\n } else {\n int latter = sizeof(buffer) - rdPtr;\n\n if (latter >= len) {\n memcpy(buf, buffer + rdPtr, len);\n rdPtr += len;\n } else {\n memcpy(buf, buffer + rdPtr, latter);\n buf += latter;\n int len2 = len - latter;\n if (len2 > ptr)\n len2 = ptr;\n memcpy(buf, buffer, len2);\n rdPtr = len2;\n len = latter + len2;\n }\n }\n\n if (rdPtr >= (int)sizeof(buffer))\n rdPtr = 0;\n\n return len;\n}\n\nint LogQueue::write(const char *buf, int len) {\n if (len > (int)sizeof(buffer) / 2)\n return -1;\n\n int left = sizeof(buffer) - ptr;\n\n if (left < len + 1) {\n writeCore(buf, left);\n buf += left;\n len -= left;\n ptr = 0;\n numWrap++;\n if (rdPtr == 0)\n rdPtr = -1;\n }\n\n writeCore(buf, len);\n buffer[ptr] = 0;\n\n return 0;\n}\n\nvoid dumpDmesg() {\n // not enabled\n}\n\nvoid ets_log_dmesg() {\n char buf[500];\n int prefix = 0;\n for (;;) {\n int len = codalLogStore.read(buf + prefix, sizeof(buf) - 1 - prefix);\n if (len == 0 && prefix != 0) {\n buf[prefix] = '\\n'; // make sure we flush\n len = 1;\n }\n len += prefix;\n if (len == 0)\n return;\n int beg = 0;\n for (int i = 0; i < len; ++i) {\n if (buf[i] == '\\n' || i - beg > 200) {\n buf[i] = 0;\n ets_printf(LOG_FORMAT(W, \"%s\"), esp_log_timestamp(), \"DMESG\", buf + beg);\n beg = i + 1;\n }\n }\n prefix = len - beg;\n if (prefix)\n memmove(buf, buf + beg, prefix);\n }\n}\n\nvoid dmesg_flush() {}\n\n} // namespace pxt\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\n#define WRITEN(p, sz_) \\\n do { \\\n sz = sz_; \\\n ptr += sz; \\\n if (ptr < dstsize) { \\\n memcpy(dst + ptr - sz, p, sz); \\\n dst[ptr] = 0; \\\n } \\\n } while (0)\n\nint codal_vsprintf(char *dst, unsigned dstsize, const char *format, va_list ap) {\n const char *end = format;\n unsigned ptr = 0, sz;\n char buf[16];\n\n for (;;) {\n char c = *end++;\n if (c == 0 || c == '%') {\n if (format != end)\n WRITEN(format, end - format - 1);\n if (c == 0)\n break;\n\n uint32_t val = va_arg(ap, uint32_t);\n c = *end++;\n buf[1] = 0;\n switch (c) {\n case 'c':\n buf[0] = val;\n break;\n case 'd':\n itoa(val, buf);\n break;\n case 'x':\n case 'p':\n case 'X':\n buf[0] = '0';\n buf[1] = 'x';\n writeNum(buf + 2, val, c != 'x');\n break;\n case 's':\n WRITEN((char *)(void *)val, strlen((char *)(void *)val));\n buf[0] = 0;\n break;\n case '%':\n buf[0] = c;\n break;\n default:\n buf[0] = '?';\n break;\n }\n format = end;\n WRITEN(buf, strlen(buf));\n }\n }\n\n return ptr;\n}\n\nDLLEXPORT int pxt_get_logs(int logtype, char *dst, int maxSize) {\n if (logtype != 0)\n return 0;\n target_disable_irq();\n int r = codalLogStore.read(dst, maxSize);\n target_enable_irq();\n return r;\n}\n\nstatic void dmesgRaw(const char *buf, uint32_t len) {\n codalLogStore.write(buf, len);\n}\n\nvoid vdmesg(const char *format, va_list arg) {\n char buf[500];\n\n target_disable_irq();\n\n // snprintf(buf, sizeof(buf), \"[%8d] \", current_time_ms());\n // dmesgRaw(buf, (uint32_t)strlen(buf));\n\n codal_vsprintf(buf, sizeof(buf) - 3, format, arg);\n // ets_printf(LOG_FORMAT(W, \"%s\"), esp_log_timestamp(), \"DMESG\", buf);\n int len = strlen(buf);\n buf[len++] = '\\n';\n dmesgRaw(buf, len);\n\n target_enable_irq();\n}\n\nvoid dmesg(const char *format, ...) {\n va_list arg;\n va_start(arg, format);\n vdmesg(format, arg);\n va_end(arg);\n}\n\nextern int int_level;\nextern \"C\" void panic_print_char(const char c);\nextern \"C\" void panic_print_str(const char *str);\nextern \"C\" void panic_print_dec(int d);\n\nextern \"C\" void user_panic_handler() {\n panic_print_str(\"\\r\\nDMESG:\\r\\n\");\n for (;;) {\n char c;\n int r = codalLogStore.read(&c, 1);\n if (r == 0)\n break;\n if (c == '\\n')\n panic_print_char('\\r');\n panic_print_char(c);\n }\n panic_print_str(\"END DMESG\\r\\nInt: \");\n panic_print_dec(int_level);\n panic_print_str(\"\\r\\n\");\n}\n",
"dmesg.h": "#pragma once\n\n#include \n\n#ifndef DMESG\n#ifdef __cplusplus\nextern \"C\" void dmesg(const char *fmt, ...);\n#define DMESG ::dmesg\n#else // not C++\nvoid dmesg(const char *fmt, ...);\n#define DMESG dmesg\n#endif\n#endif\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum PulseValue {\n //% block=high\n High = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=low\n Low = 5, // DEVICE_PIN_EVT_PULSE_LO\n }\n\n\n declare const enum PinEvent {\n //% block=\"pulse high\"\n PulseHigh = 4, // DEVICE_PIN_EVT_PULSE_HI\n //% block=\"pulse low\"\n PulseLow = 5, // DEVICE_PIN_EVT_PULSE_LO\n //% block=\"rise\"\n Rise = 2, // DEVICE_PIN_EVT_RISE\n //% block=\"fall\"\n Fall = 3, // DEVICE_PIN_EVT_FALL\n }\n\n\n declare const enum PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"keys.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\nvoid initKeys() {}\n\n//% expose\nint pressureLevelByButtonId(int btnId, int codalId) {\n return 0; // TODO\n}\n\n//% expose\nvoid setupButton(int buttonId, int key) {\n (void)buttonId;\n (void)key;\n // not needed on RPi\n}\n\n} // namespace pxt",
"ns.ts": "/**\n * Events and data from sensors.\n */\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\n//% groups='[\"other\", \"More\"]'\nnamespace input {\n}\n\n/**\n * Servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\"\nnamespace servos {\n\n}\n\n/**\n * A Joint Asynchronous Communications, Device Agnostic Control.\n */\n//% color=\"#E79251\" weight=1 icon=\"\\uf185\"\n//% groups='[\"Broadcast\", \"Console\", \"Control\"]'\n//% blockGap=8\nnamespace jacdac {\n\n}",
"pins.cpp": "#include \"pxt.h\"\n\n#include \"esp_task_wdt.h\"\n\nnamespace pxt {\nstatic DevicePin **pinPtrs;\nstatic uint8_t numPinPtrs;\nstatic uint8_t pinPos[DEV_NUM_PINS];\n\n//% expose\nDevicePin *getPin(int id) {\n\n id &= CFG_PIN_NAME_MSK;\n\n if (id >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n\n int ptr = pinPos[id];\n if (ptr == 0) {\n pinPtrs = (DevicePin **)realloc(pinPtrs, (numPinPtrs + 1) * sizeof(void *));\n // GCTODO\n pinPtrs[numPinPtrs++] = new DevicePin(id);\n ptr = numPinPtrs;\n pinPos[id] = ptr;\n }\n return pinPtrs[ptr - 1];\n}\n\n//% expose\nDevicePin *getPinCfg(int key) {\n int p = getConfig(key, -1);\n if (p == -1)\n DMESG(\"no pin cfg: %d\", key);\n return getPin(p);\n}\n\nvoid linkPin(int from, int to) {\n if (from < 0 || from >= DEV_NUM_PINS)\n soft_panic(PANIC_NO_SUCH_PIN);\n getPin(to);\n pinPos[from] = pinPos[to];\n}\n\n//% expose\nDevicePin *lookupPin(int pinName) {\n if (pinName < 0 || pinName == 0xff)\n return NULL;\n pinName &= CFG_PIN_NAME_MSK;\n return getPin(pinName);\n}\n\n//% expose\nDevicePin *lookupPinCfg(int key) {\n return lookupPin(getConfig(key));\n}\n\n} // namespace pxt\n\nnamespace pins {\n/**\n * Get a pin by configuration id (DAL.CFG_PIN...)\n */\n//%\nDigitalInOutPin pinByCfg(int key) {\n return pxt::lookupPinCfg(key);\n}\n\n/**\n * Create a new zero-initialized buffer.\n * @param size number of bytes in the buffer\n */\n//%\nBuffer createBuffer(int size) {\n return mkBuffer(NULL, size);\n}\n\n} // namespace pins\n\nnamespace control {\n/**\n * Enable a watchdog timer that need to be fed or it will reset the device.\n * If timeout is not positive, the watchdog is disabled.\n */\n//%\nvoid setWatchdog(int timeout_s) {\n if (timeout_s > 0) {\n esp_task_wdt_init(timeout_s, true);\n esp_task_wdt_add(NULL);\n } else {\n esp_task_wdt_delete(NULL);\n }\n}\n\n/**\n * Reset timeout on previously enabled watchdog.\n */\n//%\nvoid feedWatchdog() {\n esp_task_wdt_reset();\n}\n\n} // namespace control",
"pins.h": "#ifndef __PXT_PINS_H\n#define __PXT_PINS_H\n\n#define BUTTON_ACTIVE_HIGH_PULL_DOWN (ACTIVE_HIGH | 0x10)\n#define BUTTON_ACTIVE_HIGH_PULL_UP (ACTIVE_HIGH | 0x20)\n#define BUTTON_ACTIVE_HIGH_PULL_NONE (ACTIVE_HIGH | 0x30)\n#define BUTTON_ACTIVE_LOW_PULL_DOWN (ACTIVE_LOW | 0x10)\n#define BUTTON_ACTIVE_LOW_PULL_UP (ACTIVE_LOW | 0x20)\n#define BUTTON_ACTIVE_LOW_PULL_NONE (ACTIVE_LOW | 0x30)\n\n#define PIN(name) ((PinName)pxt::getConfig(CFG_PIN_##name, -1))\n#define LOOKUP_PIN(name) pxt::lookupPin(PIN(name))\n\n// these can be overridden in platform.h\n#ifndef CODAL_PIN\n#define CODAL_PIN CODAL_MBED::Pin\n#endif\n\n#ifndef CODAL_TIMER\n#define CODAL_TIMER CODAL_MBED::Timer\n#endif\n\n#ifndef CODAL_SPI\n#define CODAL_SPI CODAL_MBED::SPI\n#endif\n\n#ifndef CODAL_SERIAL\n#define CODAL_SERIAL CODAL_MBED::Serial\n#endif\n\n#ifndef IS_ANALOG_PIN\n#define IS_ANALOG_PIN(id) ((DEV_ANALOG_PINS >> (id)) & 1)\n#endif\n\ntypedef CODAL_PIN DevicePin;\n\ntypedef DevicePin *DigitalInOutPin;\ntypedef DevicePin *AnalogInOutPin;\ntypedef DevicePin *AnalogInPin;\ntypedef DevicePin *AnalogOutPin;\ntypedef DevicePin *PwmPin;\ntypedef DevicePin *PwmOnlyPin;\ntypedef Button *Button_;\n\nnamespace pxt {\nDevicePin *getPin(int id);\nDevicePin *getPinCfg(int key);\nDevicePin *lookupPin(int pinName);\nDevicePin *lookupPinCfg(int key);\nvoid linkPin(int from, int to);\nCodalComponent *lookupComponent(int id);\n}\n\n#define PINOP(op) name->op\n\n#endif\n",
"pins.ts": "//% noRefCounting fixedInstances\ninterface DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogOutPin extends DigitalInOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface AnalogInOutPin extends AnalogInPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmOnlyPin extends DigitalInOutPin, AnalogOutPin {\n // methods filled from C++\n}\n\n//% noRefCounting fixedInstances\ninterface PwmPin extends PwmOnlyPin, AnalogInOutPin {\n}\n\n/**\n * Control currents in Pins for analog/digital signals, servos, i2c, ...\n */\n//% color=#A80000 weight=85 icon=\"\\uf140\" advanced=true\n//% groups='[\"other\", \"Servo\", \"i2c\"]'\nnamespace pins {\n}",
"pinsDigital.cpp": "#include \"pxt.h\"\n\nenum class PulseValue {\n //% block=high\n High = DEVICE_PIN_EVT_PULSE_HI,\n //% block=low\n Low = DEVICE_PIN_EVT_PULSE_LO\n};\n\nenum class PinEvent {\n //% block=\"pulse high\"\n PulseHigh = DEVICE_PIN_EVT_PULSE_HI,\n //% block=\"pulse low\"\n PulseLow = DEVICE_PIN_EVT_PULSE_LO,\n //% block=\"rise\"\n Rise = DEVICE_PIN_EVT_RISE,\n //% block=\"fall\"\n Fall = DEVICE_PIN_EVT_FALL,\n};\n\nenum class PinPullMode {\n //% block=\"down\"\n PullDown = 0,\n //% block=\"up\"\n PullUp = 1,\n //% block=\"none\"\n PullNone = 2\n};\n\nnamespace DigitalInOutPinMethods {\n/**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n//% help=pins/digital-read weight=61\n//% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nbool digitalRead(DigitalInOutPin name) {\n return PINOP(getDigitalValue()) != 0;\n}\n\n/**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n//% help=pins/digital-write weight=60\n//% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid digitalWrite(DigitalInOutPin name, bool value) {\n PINOP(setDigitalValue(value));\n}\n\n/**\n* Make this pin a digital input, and create events where the timestamp is the duration\n* that this pin was either ``high`` or ``low``.\n*/\n//% help=pins/on-pulsed weight=16 blockGap=8\n//% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\n//% deprecated=1 hidden=1\nvoid onPulsed(DigitalInOutPin pin, PulseValue pulse, Action body) {\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)pulse, body);\n}\n\n/**\n* Register code to run when a pin event occurs. \n*/\n//% help=pins/on-event weight=20 blockGap=8\n//% blockId=pinsonevent block=\"on|pin %pin|%event\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nvoid onEvent(DigitalInOutPin pin, PinEvent event, Action body) {\n switch(event) {\n case PinEvent::PulseHigh:\n case PinEvent::PulseLow:\n pin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n registerWithDal(pin->id, (int)event, body);\n break;\n case PinEvent::Rise:\n case PinEvent::Fall:\n pin->eventOn(DEVICE_PIN_EVENT_ON_EDGE);\n registerWithDal(pin->id, (int)event, body);\n break; \n } \n}\n\n/**\n* Return the duration of a pulse in microseconds\n* @param name the pin which measures the pulse\n* @param value the value of the pulse (default high)\n* @param maximum duration in micro-seconds\n*/\n//% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n//% weight=18 blockGap=8\n//% help=\"pins/pulse-in\"\n//% blockNamespace=pins\n//% pin.fieldEditor=\"gridpicker\"\n//% pin.fieldOptions.width=220\n//% pin.fieldOptions.columns=4\nint pulseIn(DigitalInOutPin pin, PulseValue value, int maxDuration = 2000000) {\n int pulse = PulseValue::High == value ? 1 : 0;\n uint64_t tick = system_timer_current_time_us();\n uint64_t maxd = (uint64_t)maxDuration;\n while (pin->getDigitalValue() != pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n\n uint64_t start = system_timer_current_time_us();\n while (pin->getDigitalValue() == pulse) {\n if (system_timer_current_time_us() - tick > maxd)\n return 0;\n }\n uint64_t end = system_timer_current_time_us();\n return end - start;\n}\n\n/**\n* Set the pull direction of this pin.\n* @param name pin to set the pull mode on\n* @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n*/\n//% help=pins/set-pull weight=17 blockGap=8\n//% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n//% blockNamespace=pins\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\nvoid setPull(DigitalInOutPin name, PinPullMode pull) {\n PullMode m = pull == PinPullMode::PullDown ? PullMode::Down : pull == PinPullMode::PullUp\n ? PullMode::Up\n : PullMode::None;\n PINOP(setPull(m));\n}\n\n}\n\n#ifdef PXT_CODAL\n\nnamespace pxt {\n\nstatic void waitABit() {\n // for (int i = 0; i < 10; ++i)\n // asm volatile(\"nop\");\n}\n\nclass ButtonMultiplexer : public CodalComponent {\n public:\n Pin &latch;\n Pin &clock;\n Pin &data;\n uint32_t state;\n uint32_t invMask;\n uint16_t buttonIdPerBit[8];\n bool enabled;\n\n ButtonMultiplexer(uint16_t id)\n : latch(*LOOKUP_PIN(BTNMX_LATCH)), clock(*LOOKUP_PIN(BTNMX_CLOCK)),\n data(*LOOKUP_PIN(BTNMX_DATA)) {\n this->id = id;\n this->status |= DEVICE_COMPONENT_STATUS_SYSTEM_TICK;\n\n state = 0;\n invMask = 0;\n enabled = true;\n\n memset(buttonIdPerBit, 0, sizeof(buttonIdPerBit));\n\n data.getDigitalValue(PullMode::Down);\n latch.setDigitalValue(1);\n clock.setDigitalValue(1);\n }\n\n void disable() {\n data.getDigitalValue(PullMode::None);\n latch.getDigitalValue(PullMode::None);\n clock.getDigitalValue(PullMode::None);\n enabled = false;\n }\n\n bool isButtonPressed(int id) {\n for (int i = 0; i < 8; ++i) {\n if (buttonIdPerBit[i] == id)\n return (state & (1 << i)) != 0;\n }\n return false;\n }\n\n uint32_t readBits(int bits) {\n latch.setDigitalValue(0);\n waitABit();\n latch.setDigitalValue(1);\n waitABit();\n\n uint32_t state = 0;\n for (int i = 0; i < bits; i++) {\n state <<= 1;\n if (data.getDigitalValue(PullMode::Down))\n state |= 1;\n\n clock.setDigitalValue(0);\n waitABit();\n clock.setDigitalValue(1);\n waitABit();\n }\n\n return state;\n }\n\n virtual void periodicCallback() override {\n if (!enabled)\n return;\n\n uint32_t newState = readBits(8);\n newState ^= invMask;\n if (newState == state)\n return;\n\n for (int i = 0; i < 8; ++i) {\n uint32_t mask = 1 << i;\n if (!buttonIdPerBit[i])\n continue;\n int ev = 0;\n if (!(state & mask) && (newState & mask))\n ev = PXT_INTERNAL_KEY_DOWN;\n else if ((state & mask) && !(newState & mask))\n ev = PXT_INTERNAL_KEY_UP;\n if (ev) {\n Event(ev, buttonIdPerBit[i]);\n Event(ev, 0); // any key\n }\n }\n\n state = newState;\n }\n};\n\nstatic ButtonMultiplexer *btnMultiplexer;\nButtonMultiplexer *getMultiplexer() {\n if (!btnMultiplexer)\n btnMultiplexer = new ButtonMultiplexer(DEVICE_ID_FIRST_BUTTON);\n return btnMultiplexer;\n}\n\nint registerMultiplexedButton(int pin, int buttonId) {\n if (1050 <= pin && pin < 1058) {\n pin -= 50;\n getMultiplexer()->invMask |= 1 << (pin - 1000);\n }\n if (1000 <= pin && pin < 1008) {\n getMultiplexer()->buttonIdPerBit[pin - 1000] = buttonId;\n return 1;\n }\n return 0;\n}\n\nint multiplexedButtonIsPressed(int btnId) {\n if (btnMultiplexer)\n return btnMultiplexer->isButtonPressed(btnId) ? 512 : 0;\n return 0;\n}\n\n//% expose\nuint32_t readButtonMultiplexer(int bits) {\n if (!LOOKUP_PIN(BTNMX_CLOCK))\n return 0;\n return getMultiplexer()->readBits(bits);\n}\n\nvoid disableButtonMultiplexer() {\n if (LOOKUP_PIN(BTNMX_CLOCK)) {\n getMultiplexer()->disable();\n }\n}\n\n}\n\n#endif\n",
"pinscompat.ts": "// filled in by microbit",
"pintarget.cpp": "#include \"pxt.h\"\n\n#include \"esp_system.h\"\n#include \"esp_log.h\"\n#include \"driver/gpio.h\"\n\n#define IO_STATUS_DIGITAL_IN 0x0001 // Pin is configured as a digital input, with no pull up.\n#define IO_STATUS_DIGITAL_OUT 0x0002 // Pin is configured as a digital output\n#define IO_STATUS_ANALOG_IN 0x0004 // Pin is Analog in\n#define IO_STATUS_ANALOG_OUT 0x0008 // Pin is Analog out\n#define IO_STATUS_TOUCH_IN 0x0010 // Pin is a makey-makey style touch sensor\n#define IO_STATUS_EVENT_ON_EDGE 0x0020 // Pin will generate events on pin change\n#define IO_STATUS_EVENT_PULSE_ON_EDGE 0x0040 // Pin will generate events on pin change\n#define IO_STATUS_INTERRUPT_ON_EDGE 0x0080 // Pin will generate events on pin change\n\nnamespace pxt {\n\nPXT_EXT_VTABLE(ZPin);\n\nZPin::ZPin(int gpio_num) : RefObject(&ZPin_vtable) {\n this->gpio_num = gpio_num;\n this->status = 0;\n this->pullMode = PullMode::None;\n this->id = 100 + gpio_num;\n}\n\nvoid ZPin::disconnect() {\n gpio_reset_pin((gpio_num_t)gpio_num);\n status = 0;\n}\n\nint ZPin::setDigitalValue(int value) {\n // Write the value, before setting as output - this way the pin state update will be atomic\n gpio_set_level((gpio_num_t)gpio_num, value);\n\n // Move into a Digital output state if necessary.\n if (!(status & IO_STATUS_DIGITAL_OUT)) {\n disconnect();\n\n gpio_config_t cfg;\n memset(&cfg, 0, sizeof(cfg));\n cfg.pin_bit_mask = 1ULL << gpio_num;\n cfg.mode = GPIO_MODE_OUTPUT;\n gpio_config(&cfg);\n\n status |= IO_STATUS_DIGITAL_OUT;\n }\n\n return 0;\n}\n\nint ZPin::getDigitalValue() {\n if (!(status & (IO_STATUS_DIGITAL_IN | IO_STATUS_EVENT_ON_EDGE | IO_STATUS_EVENT_PULSE_ON_EDGE |\n IO_STATUS_INTERRUPT_ON_EDGE))) {\n disconnect();\n gpio_config_t cfg;\n memset(&cfg, 0, sizeof(cfg));\n cfg.pin_bit_mask = 1ULL << gpio_num;\n cfg.mode = GPIO_MODE_INPUT;\n switch (pullMode) {\n case PullMode::Down:\n cfg.pull_down_en = GPIO_PULLDOWN_ENABLE;\n break;\n case PullMode::Up:\n cfg.pull_up_en = GPIO_PULLUP_ENABLE;\n break;\n case PullMode::None:\n break;\n }\n gpio_config(&cfg);\n\n status |= IO_STATUS_DIGITAL_IN;\n }\n\n return gpio_get_level((gpio_num_t)gpio_num);\n}\n\nint ZPin::setPull(PullMode pull) {\n if (pull != pullMode) {\n status = 0;\n pullMode = pull;\n getDigitalValue();\n }\n return 0;\n}\n\nint ZPin::getDigitalValue(PullMode pull) {\n setPull(pull);\n return getDigitalValue();\n}\n\nint ZPin::eventOn(int eventType) {\n switch (eventType) {\n case DEVICE_PIN_EVENT_ON_EDGE:\n case DEVICE_PIN_EVENT_ON_PULSE:\n // enableRiseFallEvents(eventType);\n break;\n\n case DEVICE_PIN_EVENT_ON_TOUCH:\n // isTouched();\n break;\n\n case DEVICE_PIN_EVENT_NONE:\n // disableEvents();\n break;\n\n default:\n return -1;\n }\n\n return 0;\n}\n\nuint32_t readButtonMultiplexer(int bits) {\n return 0;\n}\n\n} // namespace pxt",
"pintarget.h": "#pragma once\n\n#define DEVICE_PIN_EVT_RISE 2\n#define DEVICE_PIN_EVT_FALL 3\n#define DEVICE_PIN_EVT_PULSE_HI 4\n#define DEVICE_PIN_EVT_PULSE_LO 5\n\n#define DEVICE_PIN_EVENT_NONE 0\n#define DEVICE_PIN_EVENT_ON_EDGE 1\n#define DEVICE_PIN_EVENT_ON_PULSE 2\n#define DEVICE_PIN_EVENT_ON_TOUCH 3\n\nnamespace pxt {\nenum class PullMode : uint8_t { None = 0, Down, Up };\n\nclass ZPin : RefObject {\n uint8_t gpio_num;\n uint8_t status;\n PullMode pullMode;\n\n public:\n uint8_t id;\n\n ZPin(int gpio_num);\n void disconnect();\n int setDigitalValue(int value);\n int getDigitalValue();\n int setPull(PullMode pull);\n int getDigitalValue(PullMode pull);\n int eventOn(int eventType);\n};\n\nstatic inline ZPin *asZPin(TValue v) {\n if (!isPointer(v))\n failedCast(v);\n auto vt = getVTable((RefObject *)v);\n if (vt->classNo != BuiltInType::ZPin)\n failedCast(v);\n return (ZPin *)v;\n}\n\n#define asDigitalInOutPin pxt::asZPin\n#define asAnalogInOutPin pxt::asZPin\n#define asAnalogInPin pxt::asZPin\n#define asAnalogOutPin pxt::asZPin\n#define asPwmPin pxt::asZPin\n#define asPwmOnlyPin pxt::asZPin\n\nstatic inline int64_t system_timer_current_time_us() {\n return esp_timer_get_time();\n}\n\n} // namespace pxt",
"platform.cpp": "#include \"pxt.h\"\n\n#include \"esp_system.h\"\n#include \"esp_log.h\"\n#include \"driver/gpio.h\"\n#include \"driver/ledc.h\"\n#include \"esp_private/system_internal.h\"\n\nstatic void reset_pin(PinName p) {\n if (p != -1)\n gpio_set_direction((gpio_num_t)p, GPIO_MODE_DISABLE);\n}\n\nvoid reboot_to_uf2(void) {\n reset_pin(PIN(LED_R));\n reset_pin(PIN(LED_G));\n reset_pin(PIN(LED_B));\n\n#if CONFIG_IDF_TARGET_ESP32S2\n // call esp_reset_reason() is required for idf.py to properly links esp_reset_reason_set_hint()\n (void)esp_reset_reason();\n esp_reset_reason_set_hint((esp_reset_reason_t)0x11F2);\n#endif\n\n esp_restart();\n}\n\nnamespace pxt {\n\nstatic void initRandomSeed() {\n seedRandom(esp_random());\n}\n\nextern \"C\" void drawPanic(int code) {\n // TODO\n}\n\n#if CONFIG_IDF_TARGET_ESP32S2\nstatic void bootloader_handler(void *) {\n reboot_to_uf2();\n}\n\nvoid install_gpio0_handler() {\n DMESG(\"reset reason: %x\", esp_reset_reason_get_hint());\n gpio_install_isr_service(0);\n gpio_config_t gpio_conf;\n gpio_conf.intr_type = GPIO_INTR_POSEDGE;\n gpio_conf.mode = GPIO_MODE_INPUT;\n gpio_conf.pin_bit_mask = (1ULL << GPIO_NUM_0);\n gpio_conf.pull_down_en = GPIO_PULLDOWN_DISABLE;\n gpio_conf.pull_up_en = GPIO_PULLUP_ENABLE;\n gpio_config(&gpio_conf);\n gpio_isr_handler_add(GPIO_NUM_0, bootloader_handler, NULL);\n}\n#else\nvoid install_gpio0_handler() {\n gpio_install_isr_service(0);\n}\n#endif\n\nextern \"C\" void usb_init();\nextern \"C\" void target_init() {\n initRandomSeed();\n memInfo();\n usb_init();\n}\n\nvoid updateScreen(Image_ img);\n\nvoid screen_init() {\n updateScreen(NULL);\n}\n\nvoid memInfo() {\n // heap_caps_print_heap_info(MALLOC_CAP_DEFAULT);\n DMESG(\"mem: %d free (%d total)\", heap_caps_get_free_size(MALLOC_CAP_DEFAULT),\n heap_caps_get_total_size(MALLOC_CAP_DEFAULT));\n}\n\nvoid (*logJDFrame)(const uint8_t *data);\nvoid (*sendJDFrame)(const uint8_t *data);\n\n} // namespace pxt\n",
"platform.h": "#ifndef __PXT_PLATFORM_H\n#define __PXT_PLATFORM_H\n\n#include \"esp_timer.h\"\n#include \"esp_system.h\"\n#include \"freertos/FreeRTOS.h\"\n#include \"freertos/task.h\"\n\n#define PXT_ESP32 1\n\n#if CONFIG_IDF_TARGET_ESP32S2\n#define PXT_USB 1\n#else\n#define PXT_USB 0\n#endif\n\n#define PAGE_SIZE 1024 // not really\n\n#define DEV_NUM_PINS 50\n\n#define DEV_PWM_PINS 0xffff_ffff_ffffULL\n#define DEV_AIN_PINS 0ULL\n\n// Codal doesn't yet distinguish between PWM and AIN\n#define DEV_ANALOG_PINS (DEV_PWM_PINS | DEV_AIN_PINS)\n\nnamespace pxt {\nclass ZPin;\nclass AbstractButton;\nclass MultiButton;\nclass Button;\nclass CodalComponent;\n\ntypedef int8_t PinName;\n\ntypedef void (*reset_fn_t)();\nvoid registerResetFunction(reset_fn_t fn);\nvoid soft_panic(int errorCode);\n\nextern TaskHandle_t userCodeTask;\n\nvoid install_gpio0_handler();\n\n} // namespace pxt\n\n#define IMAGE_BITS 4\n\n#define PXT_IN_ISR() (xTaskGetCurrentTaskHandle() != userCodeTask)\n\n#define GC_BLOCK_SIZE (1024 * 16)\n\n#define PXT_REGISTER_RESET(fn) pxt::registerResetFunction(fn)\n\n#ifdef CONFIG_IDF_TARGET_ESP32S2\n// 0x3f000000-... range of data SPI flash (we only support first 4M)\n#define PXT_IS_READONLY(v) (isTagged(v) || ((uintptr_t)v >> 22) == 0xfc)\n#else\n// 0x3f400000-0x3f700000 range of data SPI flash\n#define PXT_IS_READONLY(v) (isTagged(v) || ((uintptr_t)v >> 22) == 0xfd)\n#endif\n\n\n#define CODAL_PIN ::pxt::ZPin\n\nextern \"C\" {\nextern const uintptr_t PXT_EXPORTData[];\n}\n\n#ifdef CONFIG_IDF_TARGET_ESP32S2\n#define WORKER_CPU PRO_CPU_NUM\n#else\n#define WORKER_CPU APP_CPU_NUM\n#endif\n\n#endif\n",
"platform_includes.h": "#include \n#include \n#include \n#include \n#include \n#include \n\n#define PROCESSOR_WORD_TYPE uintptr_t\n",
"pxt.h": "#ifndef __PXT_H\n#define __PXT_H\n\n#include \"pxtbase.h\"\n#include \"vm.h\"\n#include \"pins.h\"\n#include \"pintarget.h\"\n\n#define OUTPUT_BITS 12\n\n#define DEVICE_EVT_ANY 0\n#define DEVICE_ID_NOTIFY_ONE 1022\n#define DEVICE_ID_NOTIFY 1023\n\n#define CHK(call) \\\n { \\\n int __r = call; \\\n if (__r != 0) { \\\n DMESG(\"fail: %d at %d\", __r, __LINE__); \\\n abort(); \\\n } \\\n }\n\nnamespace pxt {\nvoid raiseEvent(int id, int event);\nint allocateNotifyEvent();\nvoid sleep_core_us(uint64_t us);\n\nclass Button;\ntypedef Button *Button_;\n\nextern volatile bool paniced;\nextern char **initialArgv;\nvoid target_exit();\nextern volatile int panicCode;\n\n// Buffer, Sound, and Image share representation.\ntypedef Buffer Sound;\n\n\ntypedef struct worker *worker_t;\nworker_t worker_alloc(const char *id, uint32_t stack_size);\nint worker_run(worker_t w, TaskFunction_t fn, void *arg);\nint worker_run_wait(worker_t w, TaskFunction_t fn, void *arg);\nvoid worker_set_idle(worker_t w, TaskFunction_t fn, void *arg);\nextern worker_t fg_worker;\n\nvoid memInfo();\n\nextern void (*logJDFrame)(const uint8_t *data);\nextern void (*sendJDFrame)(const uint8_t *data);\n\n} // namespace pxt\n\nextern \"C\" void target_disable_irq();\nextern \"C\" void target_enable_irq();\nextern \"C\" void target_init();\nextern \"C\" void target_wait_us(uint32_t us);\n\n#define DEVICE_ID_JACDAC 30\n#define DEVICE_ID_JACDAC_PHYS 31\n\n#undef PXT_MAIN\n#define PXT_MAIN \\\n extern \"C\" int app_main() { \\\n pxt::vmStart(); \\\n return 0; \\\n }\n\n#undef PXT_SHIMS_BEGIN\n#define PXT_SHIMS_BEGIN \\\n namespace pxt { \\\n const OpcodeDesc staticOpcodes[] __attribute__((aligned(0x20))) = {\n\n#undef PXT_SHIMS_END\n#define PXT_SHIMS_END \\\n { 0, 0, 0 } \\\n } \\\n ; \\\n }\n\n#endif\n",
"pxt.json": "{\n \"name\": \"core---esp32s2\",\n \"description\": \"The core library for Codal-based targets\",\n \"dependencies\": {\n \"base\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"Makefile\",\n \"certs.mk\",\n \"dal.d.ts\",\n \"scheduler.cpp\",\n \"config.cpp\",\n \"target.cpp\",\n \"dmesg.cpp\",\n \"dmesg.h\",\n \"usb.cpp\",\n \"pxt.h\",\n \"platform.h\",\n \"platform.cpp\",\n \"pxtcore.h\",\n \"uf2hid.h\",\n \"pins.h\",\n \"pins.cpp\",\n \"pintarget.cpp\",\n \"pintarget.h\",\n \"pinsDigital.cpp\",\n \"pins.ts\",\n \"pinscompat.ts\",\n \"control.cpp\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"ns.ts\",\n \"timer.ts\",\n \"platform_includes.h\",\n \"codalemu.cpp\",\n \"keys.cpp\",\n \"vm.cpp\",\n \"vm.h\",\n \"verify.cpp\",\n \"vmload.cpp\",\n \"worker.cpp\",\n \"crypto.cpp\",\n \"crypto.ts\",\n \"pxtparts.json\",\n \"CMakeLists.txt\",\n \"sdkconfig.defaults\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"dalDTS\": {\n \"includeDirs\": [\n \"main\"\n ],\n \"excludePrefix\": []\n },\n \"yotta\": {\n \"config\": {\n \"codal\": {\n \"component_count\": 64,\n \"dmesg_buffer_size\": 1024\n }\n }\n }\n}\n",
"pxtcore.h": "#ifndef __PXTCORE_H\n#define __PXTCORE_H\n\n#include \n#include \n#include \n\nnamespace pxt {\nvoid *gcAllocBlock(size_t sz);\nvoid vm_stack_trace();\n}\n\nextern \"C\" void dmesg(const char *fmt, ...);\nextern \"C\" void vdmesg(const char *format, va_list arg);\n#define DMESG ::dmesg\n\nstatic inline void itoa(int v, char *dst) {\n snprintf(dst, 30, \"%d\", v);\n}\n\nextern \"C\" void *xmalloc(size_t sz);\n#define xfree free\n\n#define GC_ALLOC_BLOCK gcAllocBlock\n\n#ifndef POKY\n// This seems to degrade performance - probably due to cache size\n//#define GC_BLOCK_SIZE (1024 * 64)\n#endif\n\n#define PXT_HARD_FLOAT 1\n\n#endif\n",
"pxtparts.json": "{\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\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createStrip,light.createNeoPixelStrip\",\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 \"dotstar\": {\n \"simulationBehavior\": \"dotstar\",\n \"visual\": {\n \"builtIn\": \"dotstar\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 1\n },\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"light.createAPA102Strip\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"dataPin\"\n },\n {\n \"pinInstantiationIdx\": 1,\n \"partParameter\": \"clkPin\"\n },\n {\n \"partParameter\": \"mode\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n },\n \"pixels\": {\n \"simulationBehavior\": \"pixels\",\n \"visual\": { \n \"builtIn\": \"pixels\",\n \"width\": 58,\n \"height\": 113,\n \"pinDistance\": 9,\n \"pinLocations\": [\n {\n \"x\": 10,\n \"y\": 0\n },\n {\n \"x\": 17,\n \"y\": 0\n },\n {\n \"x\": 24,\n \"y\": 0\n },\n {\n \"x\": 31,\n \"y\": 0\n }\n ]\n },\n \"numberOfPins\": 4,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"MOSI\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"SCK\",\n \"style\": \"solder\",\n \"orientation\": \"+Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"solder\",\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, 2\n ]\n },\n {\n \"pinIndices\": [\n 3\n ]\n }\n ]\n }, \n \"buttons\": {\n \"simulationBehavior\": \"buttons\",\n \"visual\": {\n \"builtIn\": \"buttons\",\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 },\n \"numberOfPins\": 2,\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"Button.onEvent,Button.isPressed,Button.wasPressed\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"button\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true\n },\n {\n \"pinIndices\": [\n 0,\n 1\n ]\n }\n ]\n },\n \"slideswitch\": {\n \"numberOfPins\": 3,\n \"simulationBehavior\": \"slideswitch\",\n \"visual\": {\n \"builtIn\": \"slideswitch\",\n \"width\": 100,\n \"height\": 100,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 30,\n \"y\": 0\n },\n {\n \"x\": 45,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalRead,DigitalInOutPin.onPulsed,DigitalInOutPin.onEvent\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"pin\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\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 \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"PwmOnlyPin.servoWrite,servos.Servo.setAngle,servos.Servo.run,servos.Servo.setPulse\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\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 \"led\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"DigitalInOutPin.digitalWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"analogled\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"builtIn\": \"led\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"led\",\n \"pinDefinitions\": [\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogOutPin.analogWrite\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n },\n \"photocell\": {\n \"numberOfPins\": 3,\n \"visual\": {\n \"builtIn\": \"photocell\",\n \"width\": 68,\n \"height\": 180,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 0,\n \"y\": 0\n },\n {\n \"x\": 15,\n \"y\": 0\n },\n {\n \"x\": 60,\n \"y\": 0\n }\n ]\n },\n \"simulationBehavior\": \"photocell\",\n \"pinDefinitions\": [\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": {\n \"pinInstantiationIdx\": 0\n },\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"instantiation\": {\n \"kind\": \"function\",\n \"fullyQualifiedName\": \"AnalogInPin.analogRead\",\n \"argumentRoles\": [\n {\n \"pinInstantiationIdx\": 0,\n \"partParameter\": \"name\"\n }\n ]\n },\n \"assembly\": [\n {\n \"part\": true,\n \"pinIndices\": [\n 0\n ]\n },\n {\n \"pinIndices\": [\n 1\n ]\n }\n ]\n }\n}",
"scheduler.cpp": "#include \"pxt.h\"\n\n#include \n#include \n#include \n#include \n#include \n#include \n#include \n#include \n\n#ifndef PXT_ESP32\n// __MINGW32__ is defined on both mingw32 and mingw64\n#ifdef __MINGW32__\n#include \n#else\n#include \n#endif\n#endif\n\n#define HANDLER_RUNNING 0x0001\n\n// should this be something like CXX11 or whatever?\n#define THROW throw()\n#define THREAD_DBG(...)\n\nstatic uint8_t in_xmalloc_panic;\n\nvoid *xmalloc(size_t sz) {\n auto r = malloc(sz);\n if (r == NULL) {\n DMESG(\"failed to allocate %d bytes\", sz);\n if (in_xmalloc_panic) {\n target_panic(PANIC_GC_OOM);\n } else {\n in_xmalloc_panic = 1;\n soft_panic(PANIC_GC_OOM); // this can happen on esp32 etc; shouldn't on linux/ios etc\n }\n }\n return r;\n}\n\nvoid *operator new(size_t size) {\n return xmalloc(size);\n}\nvoid *operator new[](size_t size) {\n return xmalloc(size);\n}\n\nvoid operator delete(void *p)THROW {\n xfree(p);\n}\nvoid operator delete[](void *p) THROW {\n xfree(p);\n}\n\nuint8_t *gcBase;\n\nnamespace pxt {\n\n#ifndef PXT_ESP32\nstatic uint64_t startTime;\n#endif\n\nFiberContext *allFibers;\nFiberContext *currentFiber;\nstatic pthread_mutex_t eventMutex;\nstatic pthread_cond_t newEventBroadcast;\n\nstatic struct Event *eventHead, *eventTail;\n\nstruct Event {\n struct Event *next;\n int source;\n int value;\n};\n\nEvent lastEvent;\n\nEvent *mkEvent(int source, int value) {\n auto res = new Event();\n memset(res, 0, sizeof(Event));\n res->source = source;\n res->value = value;\n return res;\n}\n\nvolatile int panicCode;\nextern \"C\" void drawPanic(int code);\n\nvoid schedule() {\n auto f = currentFiber;\n if (!f->wakeTime && !f->waitSource)\n oops(55);\n f->resumePC = f->pc;\n f->pc = NULL; // this will break the exec_loop()\n}\n\nvoid dmesg_flush();\n\nstatic void panic_core(int error_code) {\n int prevErr = errno;\n\n panicCode = error_code;\n\n drawPanic(error_code);\n\n DMESG(\"PANIC %d\", error_code % 1000);\n DMESG(\"errno=%d %s\", prevErr, strerror(prevErr));\n\n dmesg_flush();\n}\n\nextern \"C\" void target_panic(int error_code) {\n panic_core(error_code);\n\n#if defined(PXT_ESP32)\n // sleep_core_us(5 * 1000 * 1000);\n abort();\n#elif defined(PXT_VM)\n systemReset();\n#else\n while (1)\n sleep_core_us(10000);\n#endif\n}\n\nDLLEXPORT int pxt_get_panic_code() {\n return panicCode;\n}\n\nvoid ets_log_dmesg();\nvoid soft_panic(int errorCode) {\n if (errorCode >= 999)\n errorCode = 999;\n if (errorCode <= 0)\n errorCode = 1;\n vm_stack_trace();\n panic_core(1000 + errorCode);\n#if defined(PXT_ESP32)\n ets_log_dmesg();\n sleep_core_us(4000000);\n abort();\n#else\n systemReset();\n#endif\n}\n\nvoid sleep_core_us(uint64_t us) {\n#ifdef PXT_ESP32\n uint64_t endp = esp_timer_get_time() + us;\n while (esp_timer_get_time() < endp)\n ;\n#else\n struct timespec ts;\n ts.tv_sec = us / 1000000;\n ts.tv_nsec = (us % 1000000) * 1000;\n while (nanosleep(&ts, &ts))\n ;\n#endif\n}\n\nvoid target_yield() {\n#ifdef PXT_ESP32\n vTaskDelay(1);\n#else\n sleep_core_us(1000);\n#endif\n}\n\nvoid sleep_ms(uint32_t ms) {\n currentFiber->wakeTime = current_time_ms() + ms;\n schedule();\n}\n\nvoid sleep_us(uint64_t us) {\n if (us > 20000) {\n sleep_ms((uint32_t)(us / 1000));\n } else {\n sleep_core_us(us);\n }\n}\n\n#ifndef PXT_ESP32\nstatic uint64_t currTime() {\n struct timeval tv;\n gettimeofday(&tv, NULL);\n return tv.tv_sec * 1000000LL + tv.tv_usec;\n}\n\nuint64_t current_time_us() {\n if (!startTime)\n startTime = currTime();\n return currTime() - startTime;\n}\n#endif\n\nint current_time_ms() {\n return (int)(current_time_us() / 1000);\n}\n\nvoid disposeFiber(FiberContext *t) {\n if (allFibers == t) {\n allFibers = t->next;\n } else {\n for (auto tt = allFibers; tt; tt = tt->next) {\n if (tt->next == t) {\n tt->next = t->next;\n break;\n }\n }\n }\n\n // DMESG(\"free: %p %p\", t, t->stackCopy);\n\n xfree(t->stackCopy);\n xfree(t);\n\n if (currentFiber == t)\n currentFiber = NULL;\n}\n\n#define INITIAL_STACK_COPY_SIZE 16\n\nFiberContext *setupThread(Action a, TValue arg = 0, HandlerBinding *hb = NULL) {\n#if 0\n int numThreads = 0;\n for (auto p = allFibers; p; p = p->next)\n numThreads++;\n DMESG(\"setup thread: %p #%d\", a, numThreads);\n //if (numThreads > 10)\n // abort();\n#endif\n auto t = (FiberContext *)xmalloc(sizeof(FiberContext));\n memset(t, 0, sizeof(*t));\n if (!vmImg->stackBase) {\n vmImg->stackBase = (TValue *)xmalloc(VM_STACK_SIZE * sizeof(TValue));\n vmImg->stackTop = vmImg->stackBase + VM_STACK_SIZE;\n vmImg->stackLimit = vmImg->stackBase + VM_MAX_FUNCTION_STACK + 5;\n }\n t->stackCopy = (TValue *)xmalloc(sizeof(TValue) * INITIAL_STACK_COPY_SIZE);\n t->stackCopySize = INITIAL_STACK_COPY_SIZE;\n t->sp = vmImg->stackTop - 8;\n\n // DMESG(\"thr: %p %p\", t, t->stackCopy);\n\n auto ptr = t->stackCopy;\n *ptr++ = TAG_STACK_BOTTOM;\n *ptr++ = 0;\n *ptr++ = arg;\n *ptr++ = 0;\n *ptr++ = 0;\n *ptr++ = 0;\n *ptr++ = 0;\n *ptr++ = (TValue)0xf00df00df00df00d;\n\n t->handlerBinding = hb;\n auto ra = (RefAction *)a;\n // we only pass 1 argument, but can in fact handle up to 4\n if (ra->numArgs > 2)\n target_panic(PANIC_INVALID_IMAGE);\n t->currAction = ra;\n t->resumePC = actionPC(ra);\n\n t->img = vmImg;\n t->imgbase = (uint16_t *)vmImg->dataStart;\n\n // add at the end\n if (allFibers)\n for (auto p = allFibers; p; p = p->next) {\n if (!p->next) {\n p->next = t;\n break;\n }\n }\n else\n allFibers = t;\n\n return t;\n}\n\nvoid runInParallel(Action a) {\n setupThread(a);\n}\n\nvoid runForever(Action a) {\n auto f = setupThread(a);\n f->foreverPC = f->resumePC;\n}\n\nvoid waitForEvent(int source, int value) {\n currentFiber->waitSource = source;\n currentFiber->waitValue = value;\n schedule();\n}\n\nFiberContext *suspendFiber() {\n currentFiber->waitSource = PXT_WAIT_SOURCE_PROMISE;\n schedule();\n return currentFiber;\n}\n\nvoid resumeFiberWithFn(FiberContext *ctx, fiber_resume_t fn, void *arg) {\n if (ctx->waitSource != PXT_WAIT_SOURCE_PROMISE)\n oops(52);\n ctx->waitSource = 0;\n ctx->wakeFn = fn;\n ctx->wakeFnArg = arg;\n}\n\nvoid resumeFiber(FiberContext *ctx, TValue v) {\n if (ctx->waitSource != PXT_WAIT_SOURCE_PROMISE)\n oops(52);\n ctx->waitSource = 0;\n ctx->r0 = v;\n}\n\nstatic void startHandler(HandlerBinding *hb, Event &e) {\n if (!hb)\n return;\n lastEvent = e; // this is quite racy\n if (hb->flags & HANDLER_RUNNING) {\n auto tmp = mkEvent(e.source, e.value);\n if (hb->pending == NULL) {\n hb->pending = tmp;\n } else {\n int numev = 0;\n auto p = hb->pending;\n for (; p->next; p = p->next)\n numev++;\n if (numev >= 10) {\n xfree(tmp);\n return;\n }\n p->next = tmp;\n }\n } else {\n hb->flags |= HANDLER_RUNNING;\n setupThread(hb->action, fromInt(e.value), hb);\n }\n}\n\nstatic void dispatchEvent(Event &e) {\n startHandler(findBinding(e.source, e.value), e);\n startHandler(findBinding(e.source, DEVICE_EVT_ANY), e);\n}\n\nstatic void wakeFibers() {\n for (;;) {\n pthread_mutex_lock(&eventMutex);\n if (eventHead == NULL) {\n pthread_mutex_unlock(&eventMutex);\n return;\n }\n Event *ev = eventHead;\n eventHead = ev->next;\n if (eventHead == NULL)\n eventTail = NULL;\n pthread_mutex_unlock(&eventMutex);\n\n for (auto thr = allFibers; thr; thr = thr->next) {\n if (thr->waitSource == 0)\n continue;\n if (thr->waitValue != ev->value && thr->waitValue != DEVICE_EVT_ANY)\n continue;\n if (thr->waitSource == ev->source) {\n thr->waitSource = 0;\n } else if (thr->waitSource == DEVICE_ID_NOTIFY && ev->source == DEVICE_ID_NOTIFY_ONE) {\n thr->waitSource = 0;\n break; // do not wake up any other threads\n }\n }\n\n dispatchEvent(*ev);\n delete ev;\n }\n}\n\nstatic void saveStack() {\n auto f = currentFiber;\n if (!f)\n return;\n int sizeNeeded = vmImg->stackTop - f->sp;\n // DMESG(\"save %d %p\", sizeNeeded, f);\n if (!f->stackCopy || sizeNeeded > f->stackCopySize) {\n xfree(f->stackCopy);\n f->stackCopySize = sizeNeeded + 10;\n f->stackCopy = (TValue *)xmalloc(f->stackCopySize * sizeof(TValue));\n // DMESG(\" -> %p\", f->stackCopy);\n }\n memcpy(f->stackCopy, f->sp, sizeNeeded * sizeof(TValue));\n}\n\nstatic void restoreStack() {\n auto f = currentFiber;\n memcpy(f->sp, f->stackCopy, (uint8_t *)vmImg->stackTop - (uint8_t *)f->sp);\n}\n\nstatic void mainRunLoop() {\n FiberContext *f = NULL;\n for (;;) {\n if (panicCode)\n return;\n wakeFibers();\n auto now = current_time_ms();\n auto fromBeg = false;\n if (!f) {\n f = allFibers;\n fromBeg = true;\n }\n while (f) {\n if (f->wakeTime && now >= (int)f->wakeTime)\n f->wakeTime = 0;\n if (!f->wakeTime && !f->waitSource)\n break;\n f = f->next;\n }\n if (f) {\n if (currentFiber != f) {\n saveStack();\n currentFiber = f;\n restoreStack();\n }\n f->pc = f->resumePC;\n f->resumePC = NULL;\n if (f->wakeFn) {\n auto fn = f->wakeFn;\n f->wakeFn = NULL;\n f->r0 = fn(f->wakeFnArg);\n if (f->wakeTime || f->waitSource)\n continue; // we got suspended again\n }\n exec_loop(f);\n if (panicCode)\n return;\n auto n = f->next;\n if (f->resumePC == NULL) {\n if (f->foreverPC) {\n f->resumePC = f->foreverPC;\n f->wakeTime = current_time_ms() + 20;\n // restore stack, as setupThread() does it\n for (int i = 0; i < 5; ++i) {\n if (*--f->sp == TAG_STACK_BOTTOM)\n break;\n }\n if (*f->sp != TAG_STACK_BOTTOM)\n target_panic(PANIC_INVALID_IMAGE);\n } else {\n auto hb = f->handlerBinding;\n if (hb) {\n auto pev = hb->pending;\n if (pev) {\n hb->pending = pev->next;\n setupThread(hb->action, fromInt(pev->value), hb);\n xfree(pev);\n } else {\n f->handlerBinding->flags &= ~HANDLER_RUNNING;\n }\n }\n disposeFiber(f);\n }\n }\n f = n;\n } else if (fromBeg) {\n target_yield();\n }\n }\n}\n\nint allocateNotifyEvent() {\n static volatile int notifyId;\n return ++notifyId;\n}\n\nvoid raiseEvent(int id, int event) {\n auto e = mkEvent(id, event);\n pthread_mutex_lock(&eventMutex);\n if (eventTail == NULL) {\n if (eventHead != NULL)\n oops(51);\n eventHead = eventTail = e;\n } else {\n eventTail->next = e;\n eventTail = e;\n }\n pthread_cond_broadcast(&newEventBroadcast);\n pthread_mutex_unlock(&eventMutex);\n}\n\nDLLEXPORT void pxt_raise_event(int id, int event) {\n raiseEvent(id, event);\n}\n\nvoid registerWithDal(int id, int event, Action a, int flags) {\n // TODO support flags\n setBinding(id, event, a);\n}\n\nuint32_t afterProgramPage() {\n return 0;\n}\n\nchar **initialArgv;\n\nvoid screen_init();\nvoid initKeys();\nvoid target_startup();\n\nvoid initRuntime() {\n current_time_ms();\n target_startup();\n\n setupThread((TValue)vmImg->entryPoint);\n\n target_init();\n screen_init();\n initKeys();\n\n DMESG(\"start main loop\");\n\n mainRunLoop();\n systemReset();\n}\n\nvoid *gcAllocBlock(size_t sz) {\n#ifdef PXT_ESP32\n void *r = xmalloc(sz);\n#else\n static uint8_t *currPtr = (uint8_t *)GC_BASE;\n sz = (sz + GC_PAGE_SIZE - 1) & ~(GC_PAGE_SIZE - 1);\n#if defined(PXT64) || defined(__MINGW32__)\n if (!gcBase) {\n gcBase = (uint8_t *)xmalloc(1 << PXT_VM_HEAP_ALLOC_BITS);\n currPtr = gcBase;\n }\n void *r = currPtr;\n if ((uint8_t *)currPtr - gcBase > (1 << PXT_VM_HEAP_ALLOC_BITS) - (int)sz)\n soft_panic(20);\n#else\n void *r = mmap(currPtr, sz, PROT_READ | PROT_WRITE, MAP_PRIVATE | MAP_ANON, -1, 0);\n if (r == MAP_FAILED) {\n DMESG(\"mmap %p failed; err=%d\", currPtr, errno);\n target_panic(PANIC_INTERNAL_ERROR);\n }\n#endif\n currPtr = (uint8_t *)r + sz;\n#endif\n\n if (isReadOnly((TValue)r)) {\n DMESG(\"mmap returned read-only address: %p\", r);\n target_panic(PANIC_INTERNAL_ERROR);\n }\n return r;\n}\n\nvoid gcProcessStacks(int flags) {\n int cnt = 0;\n for (auto f = allFibers; f; f = f->next) {\n TValue *end, *ptr;\n if (f == currentFiber) {\n end = vmImg->stackTop;\n ptr = f->sp;\n } else {\n end = f->stackCopy + (vmImg->stackTop - f->sp);\n ptr = f->stackCopy;\n }\n gcProcess((TValue)f->currAction);\n gcProcess((TValue)f->r0);\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\n#define MAX_RESET_FN 32\nstatic reset_fn_t resetFunctions[MAX_RESET_FN];\n\nvoid registerResetFunction(reset_fn_t fn) {\n for (int i = 0; i < MAX_RESET_FN; ++i) {\n if (!resetFunctions[i]) {\n resetFunctions[i] = fn;\n return;\n }\n }\n\n target_panic(PANIC_INTERNAL_ERROR);\n}\n\nvoid systemReset() {\n#ifdef PXT_ESP32\n esp_restart();\n#else\n if (!panicCode)\n panicCode = -1;\n\n dmesg(\"TARGET RESET\");\n\n gcFreeze();\n\n for (int i = 0; i < MAX_RESET_FN; ++i) {\n auto fn = resetFunctions[i];\n if (fn)\n fn();\n }\n\n coreReset(); // clears handler bindings\n\n currentFiber = NULL;\n while (allFibers) {\n disposeFiber(allFibers);\n }\n\n // this will consume all events, but won't dispatch anything, since all listener maps are empty\n wakeFibers();\n\n // mark all GC memory as free\n gcReset();\n\n pthread_exit(NULL);\n#endif\n}\n\n} // namespace pxt\n",
"sdkconfig.defaults": "CONFIG_IDF_TARGET=\"esp32s2\"\nCONFIG_NEWLIB_ENABLE=y\nCONFIG_NEWLIB_LIBRARY_LEVEL_NORMAL=y\nCONFIG_NEWLIB_NANO_FORMAT=\nCONFIG_SSL_USING_MBEDTLS=y\nCONFIG_LWIP_IPV6=y\nCONFIG_MBEDTLS_CERTIFICATE_BUNDLE_DEFAULT_NONE=y\nCONFIG_MBEDTLS_CUSTOM_CERTIFICATE_BUNDLE=y\nCONFIG_MBEDTLS_CUSTOM_CERTIFICATE_BUNDLE_PATH=\"certs\"\nCONFIG_USB_ENABLED=y\nCONFIG_USB_CDC_ENABLED=y\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace pins {\n\n /**\n * Get a pin by configuration id (DAL.CFG_PIN...)\n */\n //% shim=pins::pinByCfg\n function pinByCfg(key: int32): DigitalInOutPin;\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}\ndeclare namespace control {\n\n /**\n * Enable a watchdog timer that need to be fed or it will reset the device.\n * If timeout is not positive, the watchdog is disabled.\n */\n //% shim=control::setWatchdog\n function setWatchdog(timeout_s: int32): void;\n\n /**\n * Reset timeout on previously enabled watchdog.\n */\n //% shim=control::feedWatchdog\n function feedWatchdog(): void;\n}\n\n\ndeclare interface DigitalInOutPin {\n /**\n * Read a pin or connector as either 0 or 1\n * @param name pin to read from\n */\n //% help=pins/digital-read weight=61\n //% blockId=device_get_digital_pin block=\"digital read|pin %name\" blockGap=8\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalRead\n digitalRead(): boolean;\n\n /**\n * Set a pin or connector value to either 0 or 1.\n * @param name pin to write to\n * @param value value to set on the pin\n */\n //% help=pins/digital-write weight=60\n //% blockId=device_set_digital_pin block=\"digital write|pin %name|to %value=toggleHighLow\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::digitalWrite\n digitalWrite(value: boolean): void;\n\n /**\n * Make this pin a digital input, and create events where the timestamp is the duration\n * that this pin was either ``high`` or ``low``.\n */\n //% help=pins/on-pulsed weight=16 blockGap=8\n //% blockId=pins_on_pulsed block=\"on|pin %pin|pulsed %pulse\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4\n //% deprecated=1 hidden=1 shim=DigitalInOutPinMethods::onPulsed\n onPulsed(pulse: PulseValue, body: () => void): void;\n\n /**\n * Register code to run when a pin event occurs. \n */\n //% help=pins/on-event weight=20 blockGap=8\n //% blockId=pinsonevent block=\"on|pin %pin|%event\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 shim=DigitalInOutPinMethods::onEvent\n onEvent(event: PinEvent, body: () => void): void;\n\n /**\n * Return the duration of a pulse in microseconds\n * @param name the pin which measures the pulse\n * @param value the value of the pulse (default high)\n * @param maximum duration in micro-seconds\n */\n //% blockId=\"pins_pulse_in\" block=\"pulse in (µs)|pin %name|pulsed %high||timeout %maxDuration (µs)\"\n //% weight=18 blockGap=8\n //% help=\"pins/pulse-in\"\n //% blockNamespace=pins\n //% pin.fieldEditor=\"gridpicker\"\n //% pin.fieldOptions.width=220\n //% pin.fieldOptions.columns=4 maxDuration.defl=2000000 shim=DigitalInOutPinMethods::pulseIn\n pulseIn(value: PulseValue, maxDuration?: int32): int32;\n\n /**\n * Set the pull direction of this pin.\n * @param name pin to set the pull mode on\n * @param pull one of the mbed pull configurations: PullUp, PullDown, PullNone\n */\n //% help=pins/set-pull weight=17 blockGap=8\n //% blockId=device_set_pull block=\"set pull|pin %pin|to %pull\"\n //% blockNamespace=pins\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4 shim=DigitalInOutPinMethods::setPull\n setPull(pull: PinPullMode): void;\n}\ndeclare namespace control {\n\n /**\n * Announce that an event happened to registered handlers.\n * @param src ID of the Component that generated the event\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.\n */\n //% weight=21 blockGap=12 blockId=\"control_raise_event\"\n //% block=\"raise event|from %src|with value %value\" blockExternalInputs=1\n //% help=control/raise-event shim=control::raiseEvent\n function raiseEvent(src: int32, value: int32): 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 /**\n * Determine the version of system software currently running.\n */\n //% blockId=\"control_device_dal_version\" block=\"device dal version\"\n //% help=control/device-dal-version shim=control::deviceDalVersion\n function deviceDalVersion(): string;\n\n /** Write data to DMESG debugging buffer. */\n //% shim=control::dmesg\n function dmesg(s: string): void;\n\n /**\n * Determines if the USB has been enumerated.\n */\n //% shim=control::isUSBInitialized\n function isUSBInitialized(): boolean;\n}\ndeclare namespace serial {\n\n /** Send DMESG debug buffer over serial. */\n //% shim=serial::writeDmesg\n function writeDmesg(): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"target.cpp": "#include \"pxt.h\"\n#include \n#include \n#include \n#include \n#include \n#include \n\n#include \"esp_log.h\"\n\n// make sure compiler doesn't optimize accesses to PXT_EXPORTData in vmload.cpp by placing\n// it in different file (this one)\n// also this is rewritten by pxt; don't rely on values here\n#define PXT_EXPORT(p) (uintptr_t)(void *)(p)\nextern \"C\" {\n__attribute__((used)) __attribute__((aligned(0x20))) const uintptr_t PXT_EXPORTData[] = {\n 0x08010801,\n 0x42424242,\n 0x08010801,\n 0x8de9d83e,\n PXT_EXPORT(&pxt::buffer_vt),\n PXT_EXPORT(&pxt::number_vt),\n PXT_EXPORT(&pxt::RefAction_vtable),\n PXT_EXPORT(&pxt::string_inline_ascii_vt),\n PXT_EXPORT(&pxt::string_skiplist16_packed_vt),\n PXT_EXPORT(&pxt::string_inline_utf8_vt),\n PXT_EXPORT(pxt::RefRecord_destroy),\n PXT_EXPORT(pxt::RefRecord_print),\n PXT_EXPORT(pxt::RefRecord_scan),\n PXT_EXPORT(pxt::RefRecord_gcsize),\n PXT_EXPORT(0),\n};\n}\n\nnamespace pxt {\n\nworker_t fg_worker;\n\nvoid target_exit() {\n systemReset();\n}\n\nextern \"C\" void target_reset() {\n esp_restart();\n}\n\nvoid ets_log_dmesg();\nstatic void fg_worker_idle(void *) {\n ets_log_dmesg();\n}\n\nvoid target_startup() {\n fg_worker = worker_alloc(\"pxt_fg\", 2048);\n worker_set_idle(fg_worker, fg_worker_idle, NULL);\n}\n\nuint64_t getLongSerialNumber() {\n static uint64_t addr;\n if (!addr) {\n uint8_t mac[6];\n esp_efuse_mac_get_default(mac);\n addr = ((uint64_t)0xff << 56) | ((uint64_t)mac[5] << 48) | ((uint64_t)mac[4] << 40) |\n ((uint64_t)mac[3] << 32) | ((uint64_t)mac[2] << 24) | ((uint64_t)mac[1] << 16) |\n ((uint64_t)mac[0] << 8) | ((uint64_t)0xfe << 0);\n }\n return addr;\n}\n\nvoid deepSleep() {\n // nothing to do\n}\n\nuint64_t current_time_us() {\n static uint64_t start_time;\n if (!start_time) {\n // try to synchronize with log timestamp\n start_time = esp_timer_get_time() - esp_log_timestamp() * 1000;\n }\n return esp_timer_get_time() - start_time;\n}\n\n} // namespace pxt\n",
"test.ts": "let i = 1\nlet f = 0.5\nlet plus = i + f\nlet minus = i - f\n\nlet r = Math.random()\nlet ri = Math.randomRange(5, 10)\n\n",
"timer.ts": "namespace control {\n /**\n * A timer\n */\n //% fixedInstances\n export class Timer {\n start: number;\n\n constructor() {\n this.start = control.millis();\n }\n\n /**\n * Gets the elapsed time in millis since the last reset\n */\n //% blockId=timerMillis block=\"%timer|millis\"\n millis(): number {\n return control.millis() - this.start;\n }\n\n /**\n * Gets the elapsed time in seconds since the last reset\n */\n //% blockId=timerSeconds block=\"%timer|seconds\"\n seconds(): number {\n return this.millis() / 1000;\n }\n\n /**\n * Resets the timer\n */\n //% blockId=timerRest block=\"%timer|reset\"\n reset() {\n this.start = control.millis();\n }\n\n /**\n * Pauses until the timer reaches the given amount of milliseconds\n * @param ms how long to pause for, eg: 5, 100, 200, 500, 1000, 2000\n */\n //% blockId=timerPauseUntil block=\"%timer|pause until (ms) %ms\"\n pauseUntil(ms: number) {\n const remaining = this.millis() - ms;\n pause(Math.max(0, remaining));\n }\n }\n\n //% whenUsed fixedInstance block=\"timer 1\"\n export const timer1 = new Timer();\n //% whenUsed fixedInstance block=\"timer 2\"\n export const timer2 = new Timer();\n //% whenUsed fixedInstance block=\"timer 3\"\n export const timer3 = new Timer();\n //% whenUsed fixedInstance block=\"timer 4\"\n export const timer4 = new Timer();\n //% whenUsed fixedInstance block=\"timer 5\"\n export const timer5 = new Timer();\n //% whenUsed fixedInstance block=\"timer 6\"\n export const timer6 = new Timer();\n //% whenUsed fixedInstance block=\"timer 7\"\n export const timer7 = new Timer();\n //% whenUsed fixedInstance block=\"timer 8\"\n export const timer8 = new Timer();\n}",
"uf2hid.h": "#ifndef UF2_HID_H\n#define UF2_HID_H 1\n\n#define HF2_CMD_BININFO 0x0001\n// no arguments\n#define HF2_MODE_BOOTLOADER 0x01\n#define HF2_MODE_USERSPACE 0x02\nstruct HF2_BININFO_Result {\n uint32_t mode;\n uint32_t flash_page_size;\n uint32_t flash_num_pages;\n uint32_t max_message_size;\n uint32_t uf2_family;\n};\n\n#define HF2_CMD_INFO 0x0002\n// no arguments\n// results is utf8 character array\n\n#define HF2_CMD_RESET_INTO_APP 0x0003\n// no arguments, no result\n\n#define HF2_CMD_RESET_INTO_BOOTLOADER 0x0004\n// no arguments, no result\n\n#define HF2_CMD_START_FLASH 0x0005\n// no arguments, no result\n\n#define HF2_CMD_WRITE_FLASH_PAGE 0x0006\nstruct HF2_WRITE_FLASH_PAGE_Command {\n uint32_t target_addr;\n uint32_t data[0];\n};\n// no result\n\n#define HF2_CMD_CHKSUM_PAGES 0x0007\nstruct HF2_CHKSUM_PAGES_Command {\n uint32_t target_addr;\n uint32_t num_pages;\n};\nstruct HF2_CHKSUM_PAGES_Result {\n uint16_t chksums[0 /* num_pages */];\n};\n\n#define HF2_CMD_READ_WORDS 0x0008\nstruct HF2_READ_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n};\nstruct HF2_READ_WORDS_Result {\n uint32_t words[0 /* num_words */];\n};\n\n#define HF2_CMD_WRITE_WORDS 0x0009\nstruct HF2_WRITE_WORDS_Command {\n uint32_t target_addr;\n uint32_t num_words;\n uint32_t words[0 /* num_words */];\n};\n// no result\n\n#define HF2_CMD_DMESG 0x0010\n// no arguments\n// results is utf8 character array\n\n#define HF2_EV_MASK 0x800000\n\n#define HF2_CMD_JDS_CONFIG 0x0020\n#define HF2_CMD_JDS_SEND 0x0021\n#define HF2_EV_JDS_PACKET 0x800020\n\ntypedef struct {\n uint32_t command_id;\n uint16_t tag;\n uint8_t reserved0;\n uint8_t reserved1;\n\n union {\n struct HF2_WRITE_FLASH_PAGE_Command write_flash_page;\n struct HF2_WRITE_WORDS_Command write_words;\n struct HF2_READ_WORDS_Command read_words;\n struct HF2_CHKSUM_PAGES_Command chksum_pages;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Command;\n\ntypedef struct {\n union {\n uint32_t eventId;\n struct {\n uint16_t tag;\n union {\n struct {\n uint8_t status;\n uint8_t status_info;\n };\n uint16_t status16;\n };\n };\n };\n union {\n struct HF2_BININFO_Result bininfo;\n uint8_t data8[0];\n uint16_t data16[0];\n uint32_t data32[0];\n };\n} HF2_Response;\n\n#define HF2_FLAG_SERIAL_OUT 0x80\n#define HF2_FLAG_SERIAL_ERR 0xC0\n#define HF2_FLAG_CMDPKT_LAST 0x40\n#define HF2_FLAG_CMDPKT_BODY 0x00\n#define HF2_FLAG_MASK 0xC0\n#define HF2_SIZE_MASK 63\n\n#define HF2_STATUS_OK 0x00\n#define HF2_STATUS_INVALID_CMD 0x01\n#define HF2_STATUS_INVALID_STATE 0x02\n\n#endif\n",
"usb.cpp": "#include \"pxt.h\"\n#include \"esp_log.h\"\n#if PXT_USB\n#include \"tinyusb.h\"\n#include \"tusb_cdc_acm.h\"\n#include \"uf2hid.h\"\n#endif\n\n#define LOG(msg, ...) DMESG(\"USB: \" msg, ##__VA_ARGS__)\n#define LOGV(msg, ...) ((void)0)\n#define ERROR(msg, ...) DMESG(\"USB-ERROR: \" msg, ##__VA_ARGS__)\n\n#if !PXT_USB\n\nextern \"C\" void usb_init() {}\n\n#else\n\n// 260 bytes needed for biggest JD packets (with overheads)\n#define HF2_BUF_SIZE 260\n\ntypedef struct {\n uint16_t size;\n uint8_t serial;\n union {\n uint8_t buf[HF2_BUF_SIZE];\n uint32_t buf32[HF2_BUF_SIZE / 4];\n uint16_t buf16[HF2_BUF_SIZE / 2];\n HF2_Command cmd;\n HF2_Response resp;\n };\n} HF2_Buffer;\n\nclass HF2 {\n bool gotSomePacket;\n // uint32_t lastExchange;\n\n public:\n bool connected;\n HF2_Buffer pkt;\n\n int sendResponse(int size);\n void recv(uint8_t buf[64]);\n int sendResponseWithData(const void *data, int size);\n int sendEvent(uint32_t evId, const void *data, int size);\n void sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend = -1);\n int handlePkt(int sz);\n int sendSerial(const void *data, int size, int isError = 0);\n\n HF2() {}\n};\n\nstatic HF2 hf2;\n\nstatic const char *descriptor_str[USB_STRING_DESCRIPTOR_ARRAY_SIZE] = {\n // array of pointer to string descriptors\n (char[]){0x09, 0x04}, // 0: is supported language is English (0x0409)\n CONFIG_USB_DESC_MANUFACTURER_STRING, // 1: Manufacturer\n \"PXT Device (app)\", // 2: Product\n \"\", // 3: Serials -> replaced\n\n#if CONFIG_USB_CDC_ENABLED\n CONFIG_USB_DESC_CDC_STRING, // 4: CDC Interface\n#else\n \"\",\n#endif\n\n#if CONFIG_USB_MSC_ENABLED\n CONFIG_USB_DESC_MSC_STRING, // 5: MSC Interface\n#else\n \"\",\n#endif\n\n#if CONFIG_USB_HID_ENABLED\n CONFIG_USB_DESC_HID_STRING // 6: HIDs\n#else\n \"\",\n#endif\n};\n\nstatic void on_cdc_rx(int itf0, cdcacm_event_t *event) {\n /* initialization */\n uint8_t buf[CONFIG_USB_CDC_RX_BUFSIZE];\n size_t rx_size = 0;\n tinyusb_cdcacm_itf_t itf = (tinyusb_cdcacm_itf_t)itf0;\n\n /* read */\n esp_err_t ret = tinyusb_cdcacm_read(itf, buf, CONFIG_USB_CDC_RX_BUFSIZE, &rx_size);\n if (ret == ESP_OK) {\n LOGV(\"%d (%d)\", rx_size, buf[0]);\n hf2.recv(buf);\n } else {\n ERROR(\"Read error\");\n }\n}\n\nstatic void on_cdc_line_state_changed(int itf, cdcacm_event_t *event) {\n hf2.connected = event->line_state_changed_data.dtr && event->line_state_changed_data.rts;\n LOG(\"connected: %d\", hf2.connected);\n}\n\nextern \"C\" void usb_init() {\n LOG(\"init\");\n tinyusb_config_t tusb_cfg;\n memset(&tusb_cfg, 0, sizeof(tusb_cfg));\n\n uint8_t mac[6];\n esp_efuse_mac_get_default(mac);\n static char macHex[15];\n macHex[0] = 'P';\n macHex[1] = 'X';\n for (int i = 0; i < 6; ++i) {\n snprintf(macHex + (2 + i * 2), 3, \"%02X\", mac[i]);\n }\n DMESG(\"USB serial: %s\", macHex);\n descriptor_str[3] = macHex;\n tusb_cfg.string_descriptor = (char **)descriptor_str;\n\n ESP_ERROR_CHECK(tinyusb_driver_install(&tusb_cfg));\n\n tinyusb_config_cdcacm_t amc_cfg;\n memset(&amc_cfg, 0, sizeof(amc_cfg));\n amc_cfg.usb_dev = TINYUSB_USBDEV_0;\n amc_cfg.cdc_port = TINYUSB_CDC_ACM_0;\n amc_cfg.rx_unread_buf_sz = 64;\n amc_cfg.callback_rx = &on_cdc_rx;\n amc_cfg.callback_line_state_changed = &on_cdc_line_state_changed;\n ESP_ERROR_CHECK(tusb_cdc_acm_init(&amc_cfg));\n\n LOG(\"init done\");\n}\n\nvoid HF2::recv(uint8_t buf[64]) {\n uint8_t tag = buf[0];\n if (pkt.size && (tag & HF2_FLAG_SERIAL_OUT)) {\n ERROR(\"serial in middle of cmd\");\n return;\n }\n\n int size = tag & HF2_SIZE_MASK;\n if (pkt.size + size > (int)sizeof(pkt.buf)) {\n ERROR(\"pkt too large\");\n return;\n }\n\n memcpy(pkt.buf + pkt.size, buf + 1, size);\n pkt.size += size;\n tag &= HF2_FLAG_MASK;\n if (tag != HF2_FLAG_CMDPKT_BODY) {\n if (tag == HF2_FLAG_CMDPKT_LAST)\n pkt.serial = 0;\n else if (tag == HF2_FLAG_SERIAL_OUT)\n pkt.serial = 1;\n else\n pkt.serial = 2;\n int sz = pkt.size;\n pkt.size = 0;\n handlePkt(sz);\n }\n}\n\nconst char *uf2_info() {\n return \"ESP32-S2\";\n}\n\nvoid reboot_to_uf2(void);\n\nstatic void jdLog(const uint8_t *frame) {\n hf2.sendEvent(HF2_EV_JDS_PACKET, frame, frame[2] + 12);\n}\n\nint HF2::handlePkt(int sz) {\n if (pkt.serial) {\n // TODO raise some event?\n return 0;\n }\n\n LOGV(\"HF2 sz=%d CMD=%x\", sz, pkt.buf32[0]);\n\n // one has to be careful dealing with these, as they share memory\n HF2_Command *cmd = &pkt.cmd;\n HF2_Response *resp = &pkt.resp;\n\n uint32_t cmdId = cmd->command_id;\n resp->tag = cmd->tag;\n resp->status16 = HF2_STATUS_OK;\n\n //#define checkDataSize(str, add) assert(sz == 8 + (int)sizeof(cmd->str) + (int)(add))\n\n // lastExchange = current_time_ms();\n gotSomePacket = true;\n\n switch (cmdId) {\n case HF2_CMD_INFO:\n return sendResponseWithData(uf2_info(), strlen(uf2_info()));\n\n case HF2_CMD_BININFO:\n resp->bininfo.mode = HF2_MODE_USERSPACE;\n resp->bininfo.flash_page_size = 0;\n resp->bininfo.flash_num_pages = 0;\n resp->bininfo.max_message_size = sizeof(pkt.buf);\n resp->bininfo.uf2_family = 0xbfdd4eee;\n return sendResponse(sizeof(resp->bininfo));\n\n case HF2_CMD_RESET_INTO_APP:\n target_reset();\n break;\n\n case HF2_CMD_RESET_INTO_BOOTLOADER:\n reboot_to_uf2();\n break;\n\n case HF2_CMD_DMESG:\n // TODO\n break;\n\n case HF2_CMD_JDS_CONFIG:\n if (cmd->data8[0]) {\n pxt::logJDFrame = jdLog;\n } else {\n pxt::logJDFrame = NULL;\n }\n return sendResponse(0);\n\n case HF2_CMD_JDS_SEND:\n if (pxt::sendJDFrame) {\n pxt::sendJDFrame(cmd->data8);\n return sendResponse(0);\n } else {\n resp->status16 = HF2_STATUS_INVALID_STATE;\n return sendResponse(0);\n }\n\n default:\n // command not understood\n resp->status16 = HF2_STATUS_INVALID_CMD;\n break;\n }\n\n return sendResponse(0);\n}\n\nstruct BufferEntry {\n unsigned size;\n uint8_t flag;\n uint8_t data[0];\n};\n\nstatic void send_buffer_core(void *ent_) {\n auto ent = (BufferEntry *)ent_;\n\n uint32_t buf[64 / 4]; // aligned\n auto size = ent->size;\n auto data = ent->data;\n\n while (hf2.connected && size > 0) {\n memset(buf + 1, 0, 60);\n int s = 63;\n if (size <= 63) {\n s = size;\n buf[0] = ent->flag;\n } else {\n buf[0] = ent->flag == HF2_FLAG_CMDPKT_LAST ? HF2_FLAG_CMDPKT_BODY : ent->flag;\n }\n buf[0] |= s;\n uint8_t *dst = (uint8_t *)buf;\n dst++;\n memcpy(dst, data, s);\n data = data + s;\n size -= s;\n\n if (tinyusb_cdcacm_write_queue(TINYUSB_CDC_ACM_0, (uint8_t *)buf, sizeof(buf)) <\n sizeof(buf))\n DMESG(\"CDC write fail\");\n // tinyusb_cdcacm_write_flush(TINYUSB_CDC_ACM_0, 0); - prints warnings\n }\n\n xfree(ent);\n}\n\nvoid HF2::sendBuffer(uint8_t flag, const void *data, unsigned size, uint32_t prepend) {\n if (!connected)\n return;\n\n if (prepend + 1)\n size += 4;\n\n auto ent = (BufferEntry *)xmalloc(sizeof(BufferEntry) + size);\n ent->size = size;\n ent->flag = flag;\n auto dst = ent->data;\n\n if (prepend + 1) {\n memcpy(dst, &prepend, 4);\n dst += 4;\n size -= 4;\n }\n\n memcpy(dst, data, size);\n\n if (worker_run_wait(fg_worker, send_buffer_core, ent))\n DMESG(\"HF2 queue full\");\n}\n\nint HF2::sendEvent(uint32_t evId, const void *data, int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, evId);\n return 0;\n}\n\nint HF2::sendSerial(const void *data, int size, int isError) {\n if (!connected)\n return 0;\n\n sendBuffer(isError ? HF2_FLAG_SERIAL_ERR : HF2_FLAG_SERIAL_OUT, data, size);\n\n return 0;\n}\n\nint HF2::sendResponse(int size) {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, pkt.buf, 4 + size);\n return 0;\n}\n\nint HF2::sendResponseWithData(const void *data, int size) {\n if (size <= (int)sizeof(pkt.buf) - 4) {\n memcpy(pkt.resp.data8, data, size);\n return sendResponse(size);\n } else {\n sendBuffer(HF2_FLAG_CMDPKT_LAST, data, size, pkt.resp.eventId);\n return 0;\n }\n}\n\n#endif\n\nnamespace pxt {\nvoid sendSerial(const char *data, int len) {\n ets_printf(LOG_BOLD(LOG_COLOR_PURPLE) \"%s\" LOG_RESET_COLOR, data);\n#if PXT_USB\n hf2.sendSerial(data, len);\n#endif\n}\n} // namespace pxt\n\n// https://gist.github.com/brgaulin/2dec28baf5e9e11dfd7ef8354adf103d\n",
"verify.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\n\nVMImage *setVMImgError(VMImage *img, int code, void *pos) {\n img->errorOffset = pos ? (int)((uint8_t *)pos - (uint8_t *)img->dataStart) : 0;\n img->errorCode = code;\n return img;\n}\n\n// next free error 1066\n#define ERROR(code, pos) return setVMImgError(img, code, pos)\n#define CHECK(cond, code) \\\n do { \\\n if (!(cond)) \\\n ERROR(code, sect); \\\n } while (0)\n#define CHECK_AT(cond, code, pos) \\\n do { \\\n if (!(cond)) \\\n ERROR(code, pos); \\\n } while (0)\n#define ALIGNED(sz) (((sz)&7) == 0)\n\n#define FOR_SECTIONS() \\\n VMImageSection *sect, *next; \\\n for (sect = (VMImageSection *)img->dataStart; \\\n (next = vmNextSection(sect), (uint64_t *)sect < img->dataEnd); sect = next)\n\n#define ALLOC_ARRAY(tp, sz) (tp *)xmalloc(sz == 0 ? 1 : sizeof(tp) * sz)\n\n#define VM_MAX_PATCH 7\n\nstruct VMPatchState {\n uint32_t offset;\n uint32_t bytesLeftInSect;\n uint8_t patchOff;\n const char *error;\n uint64_t patch[VM_MAX_PATCH];\n};\n\nstatic const VTable *vtFor(VMImageSection *sect) {\n if (sect->type == SectionType::Function)\n return &pxt::RefAction_vtable;\n else if (sect->type == SectionType::Literal)\n switch ((BuiltInType)sect->aux) {\n case BuiltInType::BoxedString_ASCII:\n return &pxt::string_inline_ascii_vt;\n case BuiltInType::BoxedString_SkipList:\n return &pxt::string_skiplist16_packed_vt;\n case BuiltInType::BoxedString:\n return &pxt::string_inline_utf8_vt;\n case BuiltInType::BoxedBuffer:\n return &pxt::buffer_vt;\n default:\n return NULL;\n }\n return NULL;\n}\n\nstatic bool isStringSection(VMImageSection *sect) {\n if (sect->type == SectionType::Literal)\n switch ((BuiltInType)sect->aux) {\n case BuiltInType::BoxedString_ASCII:\n case BuiltInType::BoxedString_SkipList:\n case BuiltInType::BoxedString:\n return true;\n default:\n return false;\n }\n return false;\n}\n\nVMPatchState *vm_alloc_patch_state() {\n return (VMPatchState *)calloc(sizeof(VMPatchState), 1);\n}\n\nvoid vm_finish_patch(VMPatchState *state) {\n free(state);\n}\n\nconst char *vm_patch_image(VMPatchState *state, uint8_t *data, uint32_t len) {\n if (state->error)\n return state->error;\n\n if (len <= 8 || !ALIGNED(len))\n return (state->error = \"invalid chunk size\");\n\n while (len > 0) {\n if (state->bytesLeftInSect == 0) {\n VMImageSection sect;\n memcpy(§, data, sizeof(sect));\n\n if (!ALIGNED(sect.size) || !sect.size)\n return (state->error = \"invalid section\");\n\n state->bytesLeftInSect = sect.size;\n\n memset(state->patch, 0, sizeof(state->patch));\n state->patchOff = 1;\n\n const VTable *vt = NULL;\n#ifdef PXT32\n if (sect.type == SectionType::NumberBoxes) {\n return (state->error = \"TODO: NumberBoxes\");\n }\n#endif\n if (sect.type == SectionType::Literal || sect.type == SectionType::Function) {\n vt = vtFor(§);\n if (!vt)\n return (state->error = \"unknown literal vt\");\n#ifdef PXT64\n state->patch[0] = (uint64_t)vt;\n#else\n state->patch[0] = (uint64_t)(uint32_t)vt << 32;\n#endif\n } else if (sect.type == SectionType::VTable) {\n auto dest = (void **)((uint32_t *)state->patch + 4);\n dest[0] = (void *)pxt::RefRecord_destroy;\n dest[1] = (void *)pxt::RefRecord_print;\n dest[2] = (void *)pxt::RefRecord_scan;\n dest[3] = (void *)pxt::RefRecord_gcsize;\n }\n } else if (state->patchOff != 0) {\n uint64_t p = state->patch[state->patchOff - 1];\n if (p)\n memcpy(data, &p, sizeof(p));\n if (state->patchOff == VM_MAX_PATCH) {\n state->patchOff = 0;\n } else {\n state->patchOff++;\n }\n }\n\n state->bytesLeftInSect -= 8;\n data += 8;\n len -= 8;\n }\n\n return NULL;\n}\n\nstatic VMImage *countSections(VMImage *img) {\n auto p = img->dataStart;\n while (p < img->dataEnd) {\n auto sect = (VMImageSection *)p;\n CHECK(ALIGNED(sect->size), 1002);\n CHECK(sect->size > 0, 1002);\n img->numSections++;\n p += sect->size >> 3;\n }\n CHECK_AT(p == img->dataEnd, 1003, p);\n img->pointerLiterals = ALLOC_ARRAY(TValue, img->numSections);\n img->sections = ALLOC_ARRAY(VMImageSection *, img->numSections);\n\n return NULL;\n}\n\nstatic VMImage *loadSections(VMImage *img) {\n auto idx = 0;\n VMImageSection *numberBoxes = NULL;\n\n FOR_SECTIONS() {\n CHECK(sect->size < 32000, 1014);\n CHECK(sect->size >= 16, 1048);\n\n if (sect->type == SectionType::InfoHeader) {\n CHECK(sect->size >= sizeof(VMImageHeader), 1008);\n auto hd = (VMImageHeader *)sect->data;\n CHECK(hd->magic0 == VM_MAGIC0, 1009);\n CHECK(hd->magic1 == VM_MAGIC1, 1010);\n CHECK(hd->allocGlobals >= hd->nonPointerGlobals, 1011);\n CHECK(hd->allocGlobals < 10000, 1012);\n CHECK(idx == 0, 1013);\n img->infoHeader = hd;\n }\n\n if (sect->type == SectionType::OpCodeMap) {\n CHECK(img->opcodes == NULL, 1015);\n auto curr = sect->data;\n auto endp = sect->data + sect->size - 8;\n CHECK(endp[-1] == 0, 1017);\n\n while (curr < endp) {\n if (*curr == 0)\n img->numOpcodes++;\n curr++;\n }\n CHECK(img->numOpcodes >= VM_FIRST_RTCALL, 1016);\n\n img->opcodes = ALLOC_ARRAY(OpFun, img->numOpcodes);\n img->opcodeDescs = ALLOC_ARRAY(const OpcodeDesc *, img->numOpcodes);\n\n int i = 0;\n curr = sect->data;\n while (curr < endp) {\n img->opcodeDescs[i] = NULL;\n img->opcodes[i] = NULL;\n if (*curr) {\n for (auto st = staticOpcodes; st->name; st++) {\n if (strcmp(st->name, (const char *)curr) == 0) {\n img->opcodeDescs[i] = st;\n break;\n }\n }\n if (img->opcodeDescs[i] == NULL) {\n DMESG(\"missing opcode: %s\", (const char *)curr);\n setVMImgError(img, 1018, curr);\n } else {\n img->opcodes[i] = img->opcodeDescs[i]->fn;\n }\n }\n while (*curr)\n curr++;\n curr++;\n i++;\n }\n if (img->errorCode)\n return img;\n }\n\n if (sect->type == SectionType::NumberBoxes) {\n CHECK(!numberBoxes, 1061);\n numberBoxes = sect;\n }\n\n if (sect->type == SectionType::NumberLiterals) {\n CHECK(!!numberBoxes, 1062);\n CHECK(!img->numberLiterals, 1004);\n img->numNumberLiterals = (sect->size >> 3) - 1;\n uint64_t *values = (uint64_t *)sect->data;\n\n int numBoxed = 0;\n\n for (unsigned i = 0; i < img->numNumberLiterals; ++i) {\n auto ptr = &values[i];\n uint64_t v = *ptr;\n if (isEncodedDouble(v)) {\n CHECK_AT(!isnan(decodeDouble(v)), 1005, ptr);\n numBoxed++;\n } else if (v & 1) {\n CHECK_AT((v >> 1) <= 0xffffffff, 1006, ptr);\n if (!canBeTagged(v >> 1))\n numBoxed++;\n } else if (v == 0) {\n // OK - padding probably\n } else {\n CHECK_AT(false, 1007, ptr);\n }\n }\n\n CHECK(numberBoxes->size >= sizeof(VMImageSection) + (numBoxed + 1) * 12, 1063);\n CHECK(numberBoxes->size <= 4 + sizeof(VMImageSection) + (numBoxed + 1) * 12, 1063);\n\n img->numberLiterals = ALLOC_ARRAY(TValue, img->numNumberLiterals);\n#ifdef PXT32\n img->boxedNumbers = (BoxedNumber *)numberBoxes->data;\n int boxedPtr = 0;\n#endif\n\n for (unsigned i = 0; i < img->numNumberLiterals; ++i) {\n uint64_t v = values[i];\n#ifdef PXT32\n if (!isEncodedDouble(v) && canBeTagged(v >> 1)) {\n img->numberLiterals[i] = (TValue)v;\n } else {\n CHECK(boxedPtr < numBoxed, 1060); // should never happen\n double x = isEncodedDouble(v) ? decodeDouble(v) : (int32_t)(v >> 1);\n CHECK(img->boxedNumbers[boxedPtr].vtable == &number_vt, 1064);\n CHECK(img->boxedNumbers[boxedPtr].num == x, 1065);\n img->numberLiterals[i] = (TValue)&img->boxedNumbers[boxedPtr];\n boxedPtr++;\n }\n#else\n img->numberLiterals[i] = (TValue)v;\n#endif\n }\n }\n\n if (sect->type == SectionType::ConfigData) {\n img->numConfigDataEntries = (sect->size - 8) >> 3;\n img->configData = (int32_t *)sect->data;\n CHECK(img->configData[(img->numConfigDataEntries - 1) * 2] == 0, 1045);\n }\n\n img->sections[idx] = sect;\n\n if (sect->type == SectionType::Literal) {\n CHECK(sect->size >= 20, 1066);\n switch ((BuiltInType)sect->aux) {\n case BuiltInType::BoxedString_ASCII:\n case BuiltInType::BoxedString: {\n auto p = (BoxedString *)vmLiteralVal(sect);\n CHECK(sect->size >= 16 + 2 + (uint32_t)p->ascii.length + 1, 1067);\n CHECK(p->ascii.data[p->ascii.length] == 0, 1068);\n break;\n }\n case BuiltInType::BoxedString_SkipList: {\n auto p = (BoxedString *)vmLiteralVal(sect);\n CHECK(sect->size >= 16 + 4 + PXT_NUM_SKIP_ENTRIES(p) * 2 + (uint32_t)p->skip_pack.size + 1,\n 1069);\n CHECK(PXT_SKIP_DATA_PACK(p)[p->skip_pack.size] == 0, 1070);\n for (int i = 0; i < PXT_NUM_SKIP_ENTRIES(p); ++i) {\n CHECK(p->skip_pack.list[i] <= p->skip_pack.size, 1071);\n }\n break;\n }\n case BuiltInType::BoxedBuffer: {\n auto p = (BoxedBuffer *)vmLiteralVal(sect);\n CHECK(sect->size >= 16 + 4 + (uint32_t)p->length, 1072);\n break;\n }\n default:\n CHECK(false, 1050);\n }\n img->pointerLiterals[idx] = vmLiteralVal(sect);\n // TODO validate size/length of boxed string/buffer; check utf8 encoding?; 1042 error\n } else if (sect->type == SectionType::Function) {\n img->pointerLiterals[idx] = vmLiteralVal(sect);\n if (!img->entryPoint)\n img->entryPoint = (RefAction *)img->pointerLiterals[idx];\n } else if (sect->type == SectionType::VTable) {\n img->pointerLiterals[idx] = (TValue)(sect->data);\n } else {\n img->pointerLiterals[idx] = nullptr;\n }\n\n idx++;\n }\n\n CHECK_AT(img->infoHeader != NULL, 1019, 0);\n CHECK_AT(img->opcodes != NULL, 1020, 0);\n CHECK_AT(img->numberLiterals != NULL, 1021, 0);\n CHECK_AT(img->configData != NULL, 1022, 0);\n CHECK_AT(img->entryPoint != NULL, 1059, 0);\n\n return NULL;\n}\n\nstatic VMImage *loadIfaceNames(VMImage *img) {\n FOR_SECTIONS() {\n if (sect->type == SectionType::IfaceMemberNames) {\n uint32_t *ptrs = (uint32_t *)sect->data;\n auto len = *ptrs++;\n CHECK(len < 0x40000, 1047);\n uintptr_t *dst = ALLOC_ARRAY(uintptr_t, len + 1);\n img->ifaceMemberNames = dst;\n img->numIfaceMemberNames = len;\n *dst++ = len;\n CHECK(sect->size >= 12 + len * 4, 1047);\n for (unsigned i = 0; i < len; ++i) {\n CHECK(ptrs[i] < img->numSections, 1051);\n auto ss = img->sections[ptrs[i]];\n CHECK(isStringSection(ss), 1052);\n dst[i] = (uintptr_t)img->pointerLiterals[ptrs[i]];\n // pointers have to be sorted\n CHECK(i == 0 || dst[i - 1] < dst[i], 1053);\n // and so strings\n CHECK(i == 0 || String_::compare((String)dst[i - 1], (String)dst[i]) < 0, 1054);\n }\n }\n }\n\n return NULL;\n}\n\nvoid validateFunction(VMImage *img, VMImageSection *sect, int debug);\n\nstatic VMImage *validateFunctions(VMImage *img) {\n FOR_SECTIONS() {\n if (sect->type == SectionType::VTable) {\n uint8_t *endp = sect->data + sect->size - 8;\n auto vt = (VTable *)sect->data;\n auto multBase = (uint16_t *)&vt->methods[VM_NUM_CPP_METHODS];\n CHECK((uint8_t *)multBase < endp,\n 1023); // basic size check, before dereferencing anything\n\n auto maxMult = 0xffffffffU >> (vt->ifaceHashMult & 0xff);\n\n CHECK(vt->numbytes < 1024, 1024);\n CHECK((vt->numbytes & 7) == 0, 1025);\n CHECK(vt->objectType == ValType::Object, 1026);\n CHECK(vt->magic == VTABLE_MAGIC, 1027);\n CHECK(vt->ifaceHashEntries > maxMult + 3, 1028);\n CHECK((uint8_t *)(multBase + vt->ifaceHashEntries) < endp, 1029);\n CHECK(vt->reserved == 0, 1030);\n CHECK(vt->ifaceHashMult != 0, 1031);\n CHECK((vt->ifaceHashEntries & 3) == 0, 1032);\n CHECK((int)vt->classNo >= (int)BuiltInType::User0, 1055);\n CHECK((int)vt->lastClassNo >= (int)vt->classNo, 1056);\n\n uint32_t maxOff = 0;\n uint32_t minOff = 0xfffffff;\n for (unsigned i = 0; i < vt->ifaceHashEntries; ++i) {\n uint32_t off2 = multBase[i];\n if (off2 > maxOff)\n maxOff = off2;\n if (off2 < minOff)\n minOff = off2;\n auto ent = (IfaceEntry *)multBase + off2;\n CHECK((uint8_t *)(ent + 1) <= endp, 1033);\n }\n\n CHECK(minOff * sizeof(IfaceEntry) == vt->ifaceHashEntries * 2, 1034);\n\n auto last1 = (IfaceEntry *)multBase + maxOff + 1;\n if (last1->memberId != 0)\n maxOff++;\n\n for (unsigned i = minOff; i <= maxOff; ++i) {\n auto ent = (IfaceEntry *)multBase + i;\n if (ent->memberId == 0)\n continue;\n if (ent->aux == 0) {\n CHECK(ent->method < (unsigned)(vt->numbytes >> 3), 1035);\n } else {\n CHECK(ent->method < img->numSections, 1037);\n auto fn = img->sections[ent->method];\n CHECK(fn->type == SectionType::Function, 1039);\n }\n }\n\n auto p = (uint8_t *)((IfaceEntry *)multBase + maxOff + 1);\n while (p < endp)\n CHECK(*p++ == 0, 1040);\n }\n\n if (sect->type == SectionType::Function) {\n validateFunction(img, sect, 0);\n if (img->errorCode) {\n // try again with debug\n validateFunction(img, sect, 1);\n return img;\n }\n }\n }\n return NULL;\n}\n\nstatic VMImage *checkVTables(VMImage *img) {\n FOR_SECTIONS() {\n auto vt = vtFor(sect);\n if (vt) {\n CHECK(((RefObject *)vmLiteralVal(sect))->vtable == vt, 1057);\n }\n if (sect->type == SectionType::Literal) {\n CHECK(vt != NULL, 1043);\n } else if (sect->type == SectionType::VTable) {\n auto vt = (VTable *)sect->data;\n CHECK(vt->methods[0] == (void *)pxt::RefRecord_destroy, 1058);\n CHECK(vt->methods[1] == (void *)pxt::RefRecord_print, 1058);\n CHECK(vt->methods[2] == (void *)pxt::RefRecord_scan, 1058);\n CHECK(vt->methods[3] == (void *)pxt::RefRecord_gcsize, 1058);\n }\n }\n return NULL;\n}\n\nVMImage *loadVMImage(void *data, unsigned length) {\n auto img = new VMImage();\n memset(img, 0, sizeof(*img));\n\n DMESG(\"loading image at %p (%d bytes)\", data, length);\n\n CHECK_AT(ALIGNED((uintptr_t)data), 1000, 0);\n CHECK_AT(ALIGNED(length), 1001, 0);\n\n img->dataStart = (uint64_t *)data;\n img->dataEnd = (uint64_t *)((uint8_t *)data + length);\n\n if (countSections(img) || checkVTables(img) || loadSections(img) || loadIfaceNames(img) ||\n validateFunctions(img)) {\n // error!\n return img;\n }\n\n DMESG(\"image loaded\");\n\n return img;\n}\n\nvoid unloadVMImage(VMImage *img) {\n if (!img)\n return;\n\n free(img->pointerLiterals);\n free(img->sections);\n free(img->opcodes);\n free(img->opcodeDescs);\n free(img->numberLiterals);\n free(img->ifaceMemberNames);\n\n free(img->dataStart);\n memset(img, 0, sizeof(*img));\n delete img;\n}\n\n} // namespace pxt\n",
"vm.cpp": "#include \"pxt.h\"\n\n// TODO look for patterns in output for combined instructions\n// TODO check for backjumps (how many)\n// TODO getConfig() should have a callback into host\n\n#define BOUND_ACTION 1\n\n#define SPLIT_ARG(arg0, arg1) unsigned arg0 = arg & 31, arg1 = arg >> 6\n#define SPLIT_ARG2(arg0, arg1) unsigned arg0 = arg & 255, arg1 = arg >> 8\n\n#define PUSH(v) *--ctx->sp = (v)\n#define POPVAL() *ctx->sp++\n#define POP(n) ctx->sp += (n)\n\n//#define TRACE DMESG\n#define TRACE NOLOG\n\nnamespace pxt {\n\n//%\nvoid op_stloc(FiberContext *ctx, unsigned arg) {\n ctx->sp[arg] = ctx->r0;\n}\n\n//%\nvoid op_ldloc(FiberContext *ctx, unsigned arg) {\n ctx->r0 = ctx->sp[arg];\n}\n\n//%\nvoid op_ldcap(FiberContext *ctx, unsigned arg) {\n ctx->r0 = ctx->currAction->fields[arg];\n}\n\n//%\nvoid op_bitconv(FiberContext *ctx, unsigned arg) {\n int shift = 32 - ((arg & 0xf) * 8);\n if (arg & 0x10) {\n int v = toInt(ctx->r0);\n ctx->r0 = fromInt((v << shift) >> shift);\n } else {\n unsigned v = toUInt(ctx->r0);\n ctx->r0 = fromUInt((v << shift) >> shift);\n }\n}\n\n//%\nvoid op_stglb(FiberContext *ctx, unsigned arg) {\n globals[arg] = ctx->r0;\n}\n\n//%\nvoid op_ldglb(FiberContext *ctx, unsigned arg) {\n ctx->r0 = globals[arg];\n}\n\n//%\nvoid op_ldlit(FiberContext *ctx, unsigned arg) {\n ctx->r0 = ctx->img->pointerLiterals[arg];\n}\n\n//%\nvoid op_ldnumber(FiberContext *ctx, unsigned arg) {\n ctx->r0 = (TValue)ctx->img->numberLiterals[arg];\n}\n\n//%\nvoid op_jmp(FiberContext *ctx, unsigned arg) {\n ctx->pc += (int)arg;\n}\n\n//%\nvoid op_jmpz(FiberContext *ctx, unsigned arg) {\n if (!toBoolQuick(ctx->r0))\n ctx->pc += (int)arg;\n}\n\n//%\nvoid op_jmpnz(FiberContext *ctx, unsigned arg) {\n if (toBoolQuick(ctx->r0))\n ctx->pc += (int)arg;\n}\n\nstatic inline VTable *getStaticVTable(VMImage *img, unsigned classId) {\n return (VTable *)(img->pointerLiterals[classId]);\n}\n\n//%\nvoid op_newobj(FiberContext *ctx, unsigned arg) {\n ctx->r0 = (TValue)pxt::mkClassInstance(getStaticVTable(ctx->img, arg));\n}\n\nstatic inline void shiftArg(FiberContext *ctx, unsigned numArgs) {\n for (unsigned i = numArgs - 1; i > 0; i--)\n ctx->sp[i] = ctx->sp[i - 1];\n POP(1);\n}\n\nstatic inline void checkClass(FiberContext *ctx, TValue obj, unsigned classId, unsigned fldId) {\n TRACE(\"check class: %p cl=%d f=%d\", obj, classId, fldId);\n if (!isPointer(obj))\n failedCast(obj);\n auto vt = getVTable((RefObject *)obj);\n auto vt2 = getStaticVTable(ctx->img, classId);\n if (vt == vt2)\n return;\n if ((int)vt2->classNo <= (int)vt->classNo && (int)vt->classNo <= (int)vt2->lastClassNo) {\n // double check field range - we don't really check class sequence numbers\n if (8 + fldId * 8 >= vt->numbytes)\n failedCast(obj);\n }\n}\n\n//%\nvoid op_ldfld(FiberContext *ctx, unsigned arg) {\n SPLIT_ARG2(fldId, classId);\n auto obj = ctx->r0;\n checkClass(ctx, obj, classId, fldId);\n ctx->r0 = ((RefRecord *)obj)->fields[fldId];\n}\n\n//%\nvoid op_stfld(FiberContext *ctx, unsigned arg) {\n SPLIT_ARG2(fldId, classId);\n auto obj = POPVAL();\n checkClass(ctx, obj, classId, fldId);\n ((RefRecord *)obj)->fields[fldId] = ctx->r0;\n}\n\nstatic RefAction *bindAction(FiberContext *ctx, RefAction *ra, TValue obj) {\n if (ra->initialLen != 0)\n target_panic(PANIC_INVALID_VTABLE);\n auto act = (RefAction *)mkAction(1, ra);\n act->flags = BOUND_ACTION;\n act->fields[0] = obj;\n return act;\n}\n\nstatic inline void runAction(FiberContext *ctx, RefAction *ra) {\n if (ctx->sp < ctx->img->stackLimit)\n soft_panic(PANIC_STACK_OVERFLOW);\n\n PUSH((TValue)ctx->currAction);\n PUSH(VM_ENCODE_PC(ctx->pc - ctx->imgbase));\n ctx->currAction = ra;\n ctx->pc = actionPC(ra);\n}\n\nstatic const uint8_t *find_src_map() {\n const uint32_t *p = (const uint32_t *)((uint32_t)vmImg->dataEnd & ~0xf);\n const uint32_t *endP = p + 128;\n while (p < endP) {\n if (p[0] == 0x4d435253 && p[1] == 0x2d4e1588 && p[2] == 0x719986aa)\n return (const uint8_t *)p;\n p += 4;\n }\n DMESG(\"source map not found; dataEnd=%p\", vmImg->dataEnd);\n return NULL;\n}\n\nstatic const uint8_t *decode_num(const uint8_t *p, int *dst) {\n auto v = *p++;\n if (v < 0xf0) {\n *dst = v;\n return p;\n }\n auto sz = v & 0x07;\n int r = 0;\n for (int i = 0; i < sz; ++i) {\n r |= *p++ << (i * 8);\n }\n if (v & 0x08)\n r = -r;\n *dst = r;\n return p;\n}\n\nstatic const uint8_t *dump_pc_one(int addr, int off, const uint8_t *fn) {\n if (!fn)\n return NULL;\n auto p = fn;\n while (*p)\n p++;\n p++;\n int prevLn = 0, prevOff = 0;\n while (*p != 0xff) {\n int a, b, c;\n p = decode_num(p, &a);\n p = decode_num(p, &b);\n p = decode_num(p, &c);\n prevLn += a;\n b <<= 1;\n prevOff += b;\n c <<= 1;\n\n int startA = prevOff;\n int endA = startA + c;\n if (startA <= addr + off && addr + off <= endA) {\n DMESG(\" PC:%x %s(%d)\", addr, fn, prevLn);\n return NULL;\n }\n }\n return p + 1;\n}\n\nstatic void dump_pc(int addr, const uint8_t *srcmap) {\n if (srcmap) {\n auto p = srcmap + 16;\n for (;;) {\n auto a = dump_pc_one(addr, -2, p);\n if (!a || !dump_pc_one(addr, -4, p) || !dump_pc_one(addr, 0, p))\n return;\n p = a;\n if (*p == 0)\n break;\n }\n }\n DMESG(\" PC:%x\", addr);\n}\n\nvoid vm_stack_trace() {\n auto ctx = currentFiber;\n if (!ctx)\n return;\n DMESG(\"stack trace (programHash:%d):\", programHash());\n auto end = vmImg->stackTop;\n auto ptr = ctx->sp;\n auto srcmap = find_src_map();\n dump_pc((ctx->pc - ctx->imgbase) << 1, srcmap);\n int max = 30;\n while (ptr < end && max) {\n auto v = (uintptr_t)*ptr++;\n if (VM_IS_ENCODED_PC(v)) {\n dump_pc(VM_DECODE_PC(v) << 1, srcmap);\n max--;\n }\n }\n if (max == 0)\n DMESG(\" ...\");\n}\n\n//%\nvoid op_callproc(FiberContext *ctx, unsigned arg) {\n runAction(ctx, (RefAction *)ctx->img->pointerLiterals[arg]);\n}\n\nstatic void callind(FiberContext *ctx, RefAction *ra, unsigned numArgs) {\n if (ra->flags & BOUND_ACTION) {\n PUSH(0);\n for (unsigned i = 0; i < numArgs; i++) {\n ctx->sp[i] = ctx->sp[i + 1];\n }\n ctx->sp[numArgs] = ra->fields[0];\n numArgs++;\n }\n\n if (numArgs != ra->numArgs) {\n int missing = ra->numArgs - numArgs;\n TRACE(\"callind missing=%d\", missing);\n if (missing < 0) {\n // just drop the ones on top\n POP(-missing);\n } else {\n // add some undefineds\n while (missing--)\n PUSH(TAG_UNDEFINED);\n }\n }\n\n if (ra->initialLen > ra->len)\n // trying to call function template\n target_panic(PANIC_INVALID_VTABLE);\n\n runAction(ctx, ra);\n}\n\n//%\nvoid op_callind(FiberContext *ctx, unsigned arg) {\n auto fn = ctx->r0;\n if (!isPointer(fn))\n failedCast(fn);\n auto vt = getVTable((RefObject *)fn);\n if (vt->objectType != ValType::Function)\n failedCast(fn);\n\n callind(ctx, (RefAction *)fn, arg);\n}\n\n//%\nvoid op_ret(FiberContext *ctx, unsigned arg) {\n SPLIT_ARG(retNumArgs, numTmps);\n\n POP(numTmps);\n auto retaddr = (intptr_t)POPVAL();\n ctx->currAction = (RefAction *)POPVAL();\n POP(retNumArgs);\n\n // check if we're leaving a function that still has open try blocks\n // (this results from invalid code generation)\n if (ctx->tryFrame &&\n ctx->tryFrame->registers[2] < (uint8_t *)ctx->sp - (uint8_t *)vmImg->stackBase) {\n DMESG(\"try frame %p left on return %d/%d\", ctx->tryFrame, ctx->tryFrame->registers[2],\n (uint8_t *)ctx->sp - (uint8_t *)vmImg->stackBase);\n vm_stack_trace();\n target_panic(PANIC_VM_ERROR);\n }\n\n if (retaddr == (intptr_t)TAG_STACK_BOTTOM) {\n ctx->pc = NULL;\n } else {\n ctx->pc = ctx->imgbase + VM_DECODE_PC(retaddr);\n }\n}\n\n//%\nvoid op_pop(FiberContext *ctx, unsigned) {\n ctx->r0 = POPVAL();\n}\n\n//%\nvoid op_popmany(FiberContext *ctx, unsigned arg) {\n POP(arg);\n}\n\n//%\nvoid op_pushmany(FiberContext *ctx, unsigned arg) {\n while (arg--) {\n PUSH(TAG_UNDEFINED);\n }\n}\n\n//%\nvoid op_push(FiberContext *ctx, unsigned) {\n PUSH(ctx->r0);\n}\n\n//%\nvoid op_ldspecial(FiberContext *ctx, unsigned arg) {\n ctx->r0 = (TValue)(uintptr_t)arg;\n}\n\n//%\nvoid op_ldint(FiberContext *ctx, unsigned arg) {\n ctx->r0 = TAG_NUMBER(arg);\n}\n\n//%\nvoid op_ldintneg(FiberContext *ctx, unsigned arg) {\n ctx->r0 = TAG_NUMBER(-(int)arg);\n}\n\nTryFrame *beginTry();\n\n//%\nvoid op_try(FiberContext *ctx, unsigned arg) {\n auto f = pxt::beginTry();\n f->registers[0] = (uintptr_t)ctx->currAction;\n f->registers[1] = (uintptr_t)(ctx->pc + (int)arg);\n f->registers[2] = (uint8_t *)ctx->sp - (uint8_t *)vmImg->stackBase;\n}\n\nvoid restoreVMExceptionState(TryFrame *tf, FiberContext *ctx) {\n // TODO verification\n ctx->currAction = (RefAction *)tf->registers[0];\n ctx->pc = (uint16_t *)tf->registers[1];\n ctx->sp = (TValue *)((uint8_t *)vmImg->stackBase + tf->registers[2]);\n longjmp(ctx->loopjmp, 1);\n}\n\nstatic TValue lookupIfaceMember(TValue obj, VTable *vt, unsigned ifaceIdx) {\n uint32_t mult = vt->ifaceHashMult;\n uint32_t off = (ifaceIdx * mult) >> (mult & 0xff);\n\n unsigned n = 3;\n auto multBase = (uint16_t *)&vt->methods[VM_NUM_CPP_METHODS];\n while (n--) {\n uint32_t off2 = multBase[off];\n auto ent = (struct IfaceEntry *)multBase + off2;\n\n if (ent->memberId == ifaceIdx) {\n if (ent->aux != 0) {\n return vmImg->pointerLiterals[ent->method];\n } else {\n return ((RefRecord *)obj)->fields[ent->method - 1];\n }\n }\n off++;\n }\n\n return NULL;\n}\n\n/* skip .d.ts */ enum class CallType { Call = 0, Get = 1, Set = 2 };\n\nstatic inline void callifaceCore(FiberContext *ctx, unsigned numArgs, unsigned ifaceIdx,\n CallType getset) {\n auto obj = ctx->sp[numArgs - 1];\n if (!isPointer(obj))\n failedCast(obj);\n auto vt = getVTable((RefObject *)obj);\n uint32_t mult = vt->ifaceHashMult;\n\n if (!mult) {\n if (vt->classNo == BuiltInType::RefMap) {\n if (getset == CallType::Set) {\n pxtrt::mapSet((RefMap *)obj, ifaceIdx, ctx->sp[0]);\n POP(2); // and pop arguments\n } else {\n ctx->r0 = pxtrt::mapGet((RefMap *)obj, ifaceIdx);\n if (getset == CallType::Call) {\n shiftArg(ctx, numArgs);\n op_callind(ctx, numArgs - 1);\n } else {\n POP(1);\n }\n }\n return;\n }\n missingProperty(obj);\n }\n uint32_t off = (ifaceIdx * mult) >> (mult & 0xff);\n\n unsigned n = 3;\n auto multBase = (uint16_t *)&vt->methods[VM_NUM_CPP_METHODS];\n while (n--) {\n uint32_t off2 = multBase[off];\n auto ent = (struct IfaceEntry *)multBase + off2;\n\n if (ent->memberId == ifaceIdx) {\n if (ent->aux != 0) {\n if (getset == CallType::Set) {\n ent++;\n if (ent->memberId != ifaceIdx)\n missingProperty(obj);\n }\n auto fn = (RefAction *)ctx->img->pointerLiterals[ent->method];\n if (getset == CallType::Get && ent->aux == 2) {\n ctx->r0 = (TValue)bindAction(ctx, fn, obj);\n POP(1);\n return;\n }\n callind(ctx, fn, numArgs);\n } else {\n if (getset == CallType::Set) {\n // store field\n ((RefRecord *)obj)->fields[ent->method - 1] = ctx->sp[0];\n POP(2); // and pop arguments\n } else {\n // load field\n ctx->r0 = ((RefRecord *)obj)->fields[ent->method - 1];\n if (getset == CallType::Call) {\n // and call\n shiftArg(ctx, numArgs);\n op_callind(ctx, numArgs - 1);\n } else {\n // if just loading, pop the object arg\n POP(1);\n }\n }\n }\n\n return;\n }\n off++;\n }\n\n if (getset == CallType::Get) {\n ctx->sp += 1; // pop object arg\n ctx->r0 = TAG_UNDEFINED;\n } else {\n missingProperty(obj);\n }\n}\n\n//%\nvoid op_calliface(FiberContext *ctx, unsigned arg) {\n SPLIT_ARG(numArgs, ifaceIdx);\n callifaceCore(ctx, numArgs, ifaceIdx, CallType::Call);\n}\n\n//%\nvoid op_callget(FiberContext *ctx, unsigned arg) {\n callifaceCore(ctx, 1, arg, CallType::Get);\n}\n\n//%\nvoid op_callset(FiberContext *ctx, unsigned arg) {\n callifaceCore(ctx, 2, arg, CallType::Set);\n}\n\n//%\nvoid op_mapget(FiberContext *ctx, unsigned arg) {\n auto obj = ctx->sp[0];\n if (!isPointer(obj))\n failedCast(obj);\n auto vt = getVTable((RefObject *)obj);\n auto key = numops::toString(ctx->r0);\n if (vt->classNo == BuiltInType::RefMap) {\n ctx->r0 = pxtrt::mapGetByString((RefMap *)obj, key);\n POP(1);\n } else {\n int k = pxtrt::lookupMapKey(key);\n if (k == 0) {\n POP(1);\n ctx->r0 = TAG_UNDEFINED;\n } else {\n callifaceCore(ctx, 1, k, CallType::Get);\n }\n }\n}\n\n//%\nvoid op_mapset(FiberContext *ctx, unsigned arg) {\n auto obj = ctx->sp[1];\n if (!isPointer(obj))\n failedCast(obj);\n auto vt = getVTable((RefObject *)obj);\n auto key = numops::toString(ctx->sp[0]);\n ctx->sp[0] = (TValue)key; // save it, so it doesn't get GCed\n if (vt->classNo == BuiltInType::RefMap) {\n pxtrt::mapSetByString((RefMap *)obj, key, ctx->r0);\n POP(2);\n } else {\n int k = pxtrt::lookupMapKey(key);\n if (k == 0) {\n missingProperty(obj);\n } else {\n ctx->sp[0] = ctx->r0;\n callifaceCore(ctx, 2, k, CallType::Set);\n }\n }\n}\n\n//%\nvoid op_checkinst(FiberContext *ctx, unsigned arg) {\n auto obj = ctx->r0;\n ctx->r0 = TAG_FALSE;\n\n if (isPointer(obj)) {\n auto vt2 = getStaticVTable(ctx->img, arg);\n auto vt = getVTable((RefObject *)obj);\n if (vt == vt2)\n ctx->r0 = TAG_TRUE;\n else if ((int)vt2->classNo <= (int)vt->classNo && (int)vt->classNo <= (int)vt2->lastClassNo)\n ctx->r0 = TAG_TRUE;\n }\n}\n\nstatic TValue inlineInvoke(FiberContext *ctx, RefAction *fn, int numArgs) {\n auto prevPC = ctx->pc;\n auto prevR0 = ctx->r0;\n jmp_buf loopjmp;\n memcpy(&loopjmp, &ctx->loopjmp, sizeof(loopjmp));\n // make sure call will push TAG_STACK_BOTTOM\n ctx->pc = (uint16_t *)ctx->imgbase + 1;\n callind(ctx, fn, numArgs);\n ctx->img->execLock ^= 1;\n exec_loop(ctx);\n if (ctx->resumePC)\n target_panic(PANIC_BLOCKING_TO_STRING);\n ctx->img->execLock ^= 1;\n auto r = ctx->r0;\n ctx->pc = prevPC;\n ctx->r0 = prevR0;\n memcpy(&ctx->loopjmp, &loopjmp, sizeof(loopjmp));\n return r;\n}\n\nString convertToString(FiberContext *ctx, TValue v) {\n if (isPointer(v)) {\n auto vt = getVTable((RefObject *)v);\n if ((int)vt->classNo >= (int)BuiltInType::User0) {\n auto img = ctx->img;\n if (!img->toStringKey) {\n img->toStringKey = pxtrt::lookupMapKey(mkString(\"toString\"));\n if (!img->toStringKey)\n img->toStringKey = -1;\n }\n if (img->toStringKey > 0) {\n auto fn = lookupIfaceMember(v, vt, img->toStringKey);\n if (fn && isPointer(fn) &&\n getVTable((RefObject *)fn)->objectType == ValType::Function) {\n PUSH(v);\n v = inlineInvoke(ctx, (RefAction *)fn, 1);\n PUSH(v); // make sure it doesn't get collected\n }\n }\n }\n }\n\n auto rr = numops::toString(v);\n if ((TValue)rr != v)\n PUSH((TValue)rr); // make sure it doesn't get collected\n\n return rr;\n}\n\nvoid exec_loop(FiberContext *ctx) {\n if (ctx->img->execLock) {\n DMESG(\"image locked!\");\n target_panic(PANIC_VM_ERROR);\n }\n ctx->img->execLock = 1;\n auto opcodes = ctx->img->opcodes;\n setjmp(ctx->loopjmp);\n while (ctx->pc) {\n if (panicCode)\n break;\n uint16_t opcode = *ctx->pc++;\n TRACE(\"0x%x: %04x %d\", (uint8_t *)ctx->pc - 2 - (uint8_t *)ctx->img->dataStart, opcode,\n (int)(vmImg->stackTop - ctx->sp));\n if (opcode >> 15 == 0) {\n opcodes[opcode & VM_OPCODE_BASE_MASK](ctx, opcode >> VM_OPCODE_ARG_POS);\n if (opcode & VM_OPCODE_PUSH_MASK)\n PUSH(ctx->r0);\n } else if (opcode >> 14 == 0b10) {\n ((ApiFun)(void *)opcodes[opcode & 0x1fff])(ctx);\n if (opcode & VM_RTCALL_PUSH_MASK)\n PUSH(ctx->r0);\n } else {\n unsigned tmp = ((int32_t)opcode << (16 + 2)) >> (2 + VM_OPCODE_ARG_POS);\n opcode = *ctx->pc++;\n opcodes[opcode & VM_OPCODE_BASE_MASK](ctx, (opcode >> VM_OPCODE_ARG_POS) + tmp);\n if (opcode & VM_OPCODE_PUSH_MASK)\n PUSH(ctx->r0);\n }\n }\n ctx->img->execLock = 0;\n}\n\n} // namespace pxt\n\n//\n// Verification\n//\n\nnamespace pxt {\n\n// 1255\n#define FNERR(errcode) \\\n do { \\\n setVMImgError(img, errcode, &code[pc]); \\\n return; \\\n } while (0)\n#define FORCE_STACK(v, errcode, pc) \\\n do { \\\n if (stackDepth[pc] && stackDepth[pc] != v) \\\n FNERR(errcode); \\\n stackDepth[pc] = v; \\\n } while (0)\n\nvoid validateFunction(VMImage *img, VMImageSection *sect, int debug) {\n uint16_t stackDepth[sect->size / 2];\n memset(stackDepth, 0, sizeof(stackDepth));\n int baseStack = 1; // 1 is the return address; also zero in the array above means unknown yet\n int currStack = baseStack;\n unsigned pc = 0;\n auto code = (uint16_t *)((uint8_t *)sect + VM_FUNCTION_CODE_OFFSET);\n auto lastPC = (sect->size - VM_FUNCTION_CODE_OFFSET) >> 1;\n auto atEnd = false;\n\n RefAction *ra = (RefAction *)vmLiteralVal(sect);\n\n if (ra->vtable != &pxt::RefAction_vtable)\n FNERR(1251);\n if ((uint8_t *)img->dataStart + ra->func != (uint8_t *)code)\n FNERR(1252);\n\n unsigned numArgs = ra->numArgs;\n unsigned numCaps = ra->initialLen;\n\n if (numCaps > 200)\n FNERR(1239);\n\n while (pc < lastPC) {\n if (currStack > VM_MAX_FUNCTION_STACK)\n FNERR(1204);\n\n FORCE_STACK(currStack, 1201, pc);\n\n uint16_t opcode = code[pc++];\n if (opcode == 0 && atEnd)\n continue; // allow padding at the end\n\n atEnd = false;\n OpFun fn;\n unsigned arg;\n unsigned opIdx;\n bool isRtCall = false;\n bool hasPush = false;\n\n if (opcode >> 15 == 0) {\n opIdx = opcode & VM_OPCODE_BASE_MASK;\n arg = opcode >> VM_OPCODE_ARG_POS;\n hasPush = !!(opcode & VM_OPCODE_PUSH_MASK);\n } else if (opcode >> 14 == 0b10) {\n opIdx = opcode & 0x1fff;\n arg = 0;\n isRtCall = true;\n hasPush = !!(opcode & VM_RTCALL_PUSH_MASK);\n } else {\n unsigned tmp = ((int32_t)opcode << (16 + 2)) >> (2 + VM_OPCODE_ARG_POS);\n FORCE_STACK(0xffff, 1200, pc); // cannot jump here!\n opcode = code[pc++];\n opIdx = opcode & VM_OPCODE_BASE_MASK;\n arg = (opcode >> VM_OPCODE_ARG_POS) + tmp;\n hasPush = !!(opcode & VM_OPCODE_PUSH_MASK);\n }\n\n if (opIdx >= img->numOpcodes)\n FNERR(1227);\n auto opd = img->opcodeDescs[opIdx];\n\n if (debug)\n DMESG(\"%4d/%d -> %04x idx=%d arg=%d st=%d %s\", pc, lastPC, opcode, opIdx, arg,\n currStack, opd ? opd->name : \"NA\");\n\n if (!opd)\n FNERR(1228);\n\n fn = img->opcodes[opIdx];\n\n if (isRtCall) {\n if (opd->numArgs > 1) {\n currStack -= opd->numArgs - 1;\n if (currStack < baseStack)\n FNERR(1229);\n }\n } else if (fn == op_pushmany) {\n if (currStack == 1 && baseStack == 1)\n baseStack = currStack = arg + 1;\n else\n currStack += arg;\n } else if (fn == op_popmany) {\n currStack -= arg;\n if (currStack < baseStack)\n FNERR(1205);\n } else if (fn == op_push) {\n currStack++;\n } else if (fn == op_pop) {\n if (arg)\n FNERR(1243);\n currStack--;\n if (currStack < baseStack)\n FNERR(1206);\n } else if (fn == op_mapget) {\n if (arg)\n FNERR(1244);\n currStack--;\n if (currStack < baseStack)\n FNERR(1245);\n } else if (fn == op_mapset) {\n if (arg)\n FNERR(1246);\n currStack -= 2;\n if (currStack < baseStack)\n FNERR(1247);\n } else if (fn == op_ret) {\n SPLIT_ARG(retNumArgs, numTmps);\n if (currStack != baseStack)\n FNERR(1207);\n if (numTmps + 1 != (unsigned)baseStack)\n FNERR(1208);\n if (retNumArgs != numArgs)\n FNERR(1209);\n currStack = baseStack;\n atEnd = true;\n } else if (fn == op_ldloc || fn == op_stloc) {\n if (arg == (unsigned)currStack - 1 || arg == (unsigned)currStack)\n FNERR(1210); // trying to load return address/function\n if (arg > (unsigned)currStack + numArgs)\n FNERR(1211);\n } else if (fn == op_ldcap) {\n if (arg >= numCaps)\n FNERR(1212);\n } else if (fn == op_ldglb || fn == op_stglb) {\n if (arg >= img->infoHeader->allocGlobals)\n FNERR(1213);\n // not supported (yet?)\n if (arg < img->infoHeader->nonPointerGlobals)\n FNERR(1214);\n } else if (fn == op_ldfld || fn == op_stfld) {\n SPLIT_ARG2(fldId, classId);\n\n if (classId >= img->numSections)\n FNERR(1236);\n auto fsec = img->sections[classId];\n if (fsec->type != SectionType::VTable)\n FNERR(1234);\n\n auto vt = getStaticVTable(img, classId);\n if (fldId * 8 + 8 >= vt->numbytes)\n FNERR(1235);\n\n if (fn == op_stfld) {\n currStack--;\n if (currStack < baseStack)\n FNERR(1232);\n }\n } else if (fn == op_ldlit) {\n if (arg >= img->numSections)\n FNERR(1215);\n auto fsec = img->sections[arg];\n if (fsec->type != SectionType::Literal && fsec->type != SectionType::Function)\n FNERR(1237);\n } else if (fn == op_newobj || fn == op_checkinst) {\n if (arg >= img->numSections)\n FNERR(1219);\n auto fsec = img->sections[arg];\n if (fsec->type != SectionType::VTable)\n FNERR(1238);\n } else if (fn == op_ldnumber) {\n if (arg >= img->numNumberLiterals)\n FNERR(1217);\n } else if (fn == op_callproc) {\n if (arg >= img->numSections)\n FNERR(1218);\n auto fsec = img->sections[arg];\n if (fsec->type != SectionType::Function)\n FNERR(1220);\n auto ra = (RefAction *)img->pointerLiterals[arg];\n unsigned calledArgs = ra->numArgs;\n currStack -= calledArgs;\n if (currStack < baseStack)\n FNERR(1221);\n } else if (fn == op_callind) {\n currStack -= arg;\n if (currStack < baseStack)\n FNERR(1223);\n } else if (fn == op_calliface) {\n SPLIT_ARG(numArgs, ifaceIdx);\n if (ifaceIdx == 0 || ifaceIdx >= img->numIfaceMemberNames)\n FNERR(1240);\n currStack -= numArgs;\n if (currStack < baseStack)\n FNERR(1230);\n } else if (fn == op_callget) {\n if (arg == 0 || arg >= img->numIfaceMemberNames)\n FNERR(1241);\n currStack -= 1;\n if (currStack < baseStack)\n FNERR(1230);\n } else if (fn == op_callset) {\n if (arg == 0 || arg >= img->numIfaceMemberNames)\n FNERR(1242);\n currStack -= 2;\n if (currStack < baseStack)\n FNERR(1230);\n } else if (fn == op_ldspecial) {\n auto a = (TValue)(uintptr_t)arg;\n if (a != TAG_TRUE && a != TAG_FALSE && a != TAG_UNDEFINED && a != TAG_NULL &&\n a != TAG_NAN)\n FNERR(1224);\n } else if (fn == op_ldint || fn == op_ldintneg) {\n // nothing to check!\n } else if (fn == op_bitconv) {\n if (arg & ~0x1f)\n FNERR(1253);\n auto sz = arg & 0xf;\n if (sz != 1 && sz != 2 && sz != 4)\n FNERR(1254);\n } else if (fn == op_jmp || fn == op_jmpnz || fn == op_jmpz) {\n unsigned newPC = pc + arg; // will overflow for backjump, but this is fine\n if (newPC >= lastPC)\n FNERR(1202);\n FORCE_STACK(currStack, 1226, newPC);\n if (fn == op_jmp) {\n if (currStack != baseStack)\n FNERR(1203);\n atEnd = true;\n }\n } else if (fn == op_try) {\n unsigned newPC = pc + arg; // will overflow for backjump, but this is fine\n if (newPC >= lastPC)\n FNERR(1248);\n if (currStack != baseStack)\n FNERR(1249);\n FORCE_STACK(currStack, 1250, newPC);\n } else {\n FNERR(1225);\n }\n\n if (hasPush)\n currStack++;\n }\n\n if (!atEnd) {\n pc--;\n FNERR(1210);\n }\n}\n\n} // namespace pxt",
"vm.h": "#ifndef _PXT_VM_H\n#define _PXT_VM_H\n\n#include \n#include \n\n#define VM_MAGIC0 0x000a34365458500aULL // \\nPXT64\\n\\0\n#define VM_MAGIC1 0x6837215e2bfe7154ULL\n\n#define VM_OPCODE_BASE_SIZE 6 // up to 63 base opcodes\n#define VM_OPCODE_PUSH_MASK (1 << VM_OPCODE_BASE_SIZE)\n#define VM_OPCODE_ARG_POS (VM_OPCODE_BASE_SIZE + 1)\n#define VM_OPCODE_BASE_MASK ((1 << VM_OPCODE_BASE_SIZE) - 1)\n#define VM_FIRST_RTCALL (VM_OPCODE_BASE_MASK + 1)\n#define VM_RTCALL_PUSH_MASK 0x2000\n\n#define VM_FUNCTION_CODE_OFFSET (8 * 4)\n\n// The binary has space for 4 64 bit pointers, so on 32 bit machines we pretend there is 8 of them\n#ifdef PXT32\n#define VM_NUM_CPP_METHODS 8\n#else\n#define VM_NUM_CPP_METHODS 4\n#endif\n\n// maximum size (in words) of stack in a single function\n#define VM_MAX_FUNCTION_STACK 200\n#define VM_STACK_SIZE 1000\n\n#define VM_ENCODE_PC(pc) ((TValue)(((pc) << 9) | 2))\n#define VM_DECODE_PC(pc) (((uintptr_t)(pc)) >> 9)\n#define VM_IS_ENCODED_PC(v) ((((uintptr_t)(v)) & ((1 << 9) - 1)) == 2)\n#define TAG_STACK_BOTTOM VM_ENCODE_PC(1)\n\n#define PXTEXT extern\n#ifdef __MINGW32__\n#define DLLEXPORT PXTEXT \"C\"\n#else\n#define DLLEXPORT PXTEXT \"C\"\n#endif\n\nnamespace pxt {\n\nstruct FiberContext;\ntypedef void (*OpFun)(FiberContext *ctx, unsigned arg);\ntypedef void (*ApiFun)(FiberContext *ctx);\n\n// keep in sync with backvm.ts\nenum class SectionType : uint8_t {\n Invalid = 0x00,\n\n // singular sections\n InfoHeader = 0x01, // VMImageHeader\n OpCodeMap = 0x02, // \\0-terminated names of opcodes and APIs (shims)\n NumberLiterals = 0x03, // array of boxed doubles and ints\n ConfigData = 0x04, // sorted array of pairs of int32s; zero-terminated\n IfaceMemberNames = 0x05, // array of 32 bit offsets, that point to string literals\n NumberBoxes = 0x06, // numbers from NumberLiteral that need to be boxed on 32 bit hosts\n\n // repetitive sections\n Function = 0x20,\n Literal = 0x21, // aux field contains literal type (string, hex, image, ...)\n VTable = 0x22,\n};\n\nstruct VMImageSection {\n SectionType type;\n uint8_t flags;\n uint16_t aux;\n uint32_t size; // in bytes, including this header\n uint8_t data[0];\n};\n\nstatic inline TValue vmLiteralVal(VMImageSection *sect) {\n#ifdef PXT64\n return (TValue)sect->data;\n#else\n return (TValue)(sect->data + 4);\n#endif\n}\n\nstatic inline VMImageSection *vmNextSection(VMImageSection *sect) {\n return (VMImageSection *)((uint8_t *)sect + sect->size);\n}\n\nstruct VMPatchState;\nVMPatchState *vm_alloc_patch_state();\nvoid vm_finish_patch(VMPatchState *state);\nconst char *vm_patch_image(VMPatchState *state, uint8_t *data, uint32_t len);\n\nSTATIC_ASSERT(sizeof(VMImageSection) == 8);\n\n#define PXT_WAIT_SOURCE_PROMISE 0x1fff0\n\nstruct OpcodeDesc {\n const char *name;\n OpFun fn;\n int numArgs;\n};\n\nstruct IfaceEntry {\n uint16_t memberId;\n uint16_t aux;\n uint32_t method;\n};\n\nextern const OpcodeDesc staticOpcodes[];\n\nstruct VMImageHeader {\n uint64_t magic0;\n uint64_t magic1;\n uint64_t hexHash;\n uint64_t programHash;\n\n uint32_t allocGlobals;\n uint32_t nonPointerGlobals;\n\n uint64_t lastUsageTime;\n uint64_t installationTime;\n uint64_t publicationTime;\n uint32_t imageSize;\n uint8_t reserved[60];\n uint8_t name[128];\n};\n\nstruct VMImage {\n TValue *numberLiterals;\n TValue *pointerLiterals;\n BoxedNumber *boxedNumbers;\n OpFun *opcodes;\n int32_t *configData;\n uintptr_t *ifaceMemberNames;\n\n uint64_t *dataStart, *dataEnd;\n VMImageSection **sections;\n VMImageHeader *infoHeader;\n const OpcodeDesc **opcodeDescs;\n RefAction *entryPoint;\n\n // every fiber's sp starts at stackTop and goes towards stackBase\n // stackTop > stackBase\n // stackLimit is close to stackBase\n TValue *stackBase;\n TValue *stackTop;\n TValue *stackLimit;\n\n uint32_t numSections;\n uint32_t numNumberLiterals;\n uint32_t numConfigDataEntries;\n uint32_t numOpcodes;\n uint32_t numIfaceMemberNames;\n uint32_t errorCode;\n uint32_t errorOffset;\n int toStringKey;\n\n int execLock;\n};\n\ntypedef TValue (*fiber_resume_t)(void *);\n\nstruct FiberContext {\n FiberContext *next;\n\n uint16_t *imgbase;\n VMImage *img;\n uint16_t *pc;\n uint16_t *resumePC;\n uint16_t *foreverPC;\n TValue *sp;\n TValue r0;\n RefAction *currAction;\n\n TryFrame *tryFrame;\n TValue thrownValue;\n jmp_buf loopjmp;\n\n TValue *stackCopy;\n int stackCopySize;\n\n // wait_for_event\n int waitSource;\n int waitValue;\n\n // for sleep\n uint64_t wakeTime;\n\n fiber_resume_t wakeFn;\n void *wakeFnArg;\n HandlerBinding *handlerBinding;\n};\n\n#define PXT_EXN_CTX() currentFiber\n\nvoid restoreVMExceptionState(TryFrame *tf, FiberContext *ctx);\n#define pxt_restore_exception_state restoreVMExceptionState\n\nFiberContext *suspendFiber(); // returns currentFiber\n// this can be called from a different thread; fn(arg) will be called from user code thread\n// just before the VM resumes execution; the result value will be stored in ctx->r0\nvoid resumeFiberWithFn(FiberContext *ctx, fiber_resume_t fn, void *arg);\n// a simpler version\nvoid resumeFiber(FiberContext *ctx, TValue v);\n\nextern VMImage *vmImg;\nextern FiberContext *currentFiber;\nextern volatile int panicCode;\n\nstatic inline uint16_t *actionPC(RefAction *ra) {\n return (uint16_t *)((uint8_t *)vmImg->dataStart + (uint32_t)ra->func);\n}\n\nvoid vmStart();\nVMImage *loadVMImage(void *data, unsigned length);\nvoid unloadVMImage(VMImage *img);\nVMImage *setVMImgError(VMImage *img, int code, void *pos);\nvoid exec_loop(FiberContext *ctx);\nvoid vmStartFromUser(const char *fn);\nvoid target_yield();\n\n#define DEF_CONVERSION(retp, tp, btp) \\\n static inline retp tp(TValue v) { \\\n if (!isPointer(v)) \\\n failedCast(v); \\\n if (getVTable((RefObject *)v)->classNo != btp) \\\n failedCast(v); \\\n return (retp)v; \\\n }\n\nDEF_CONVERSION(RefCollection *, asRefCollection, BuiltInType::RefCollection)\nDEF_CONVERSION(RefAction *, asRefAction, BuiltInType::RefAction)\nDEF_CONVERSION(RefRefLocal *, asRefRefLocal, BuiltInType::RefRefLocal)\nDEF_CONVERSION(RefMap *, asRefMap, BuiltInType::RefMap)\n\nDEF_CONVERSION(Buffer, asBuffer, BuiltInType::BoxedBuffer)\nDEF_CONVERSION(Image_, asImage_, BuiltInType::RefImage)\n\nString convertToString(FiberContext *ctx, TValue v);\n\n} // namespace pxt\n\n#endif",
"vmload.cpp": "#include \"pxt.h\"\n\nnamespace pxt {\n\nVMImage *vmImg;\nTaskHandle_t userCodeTask;\n\nstatic void vmStartCore(uint8_t *data, unsigned len) {\n unloadVMImage(vmImg);\n vmImg = NULL;\n\n userCodeTask = xTaskGetCurrentTaskHandle();\n\n gcPreStartup();\n\n auto img = loadVMImage(data, len);\n if (img->errorCode) {\n dmesg(\"validation error %d at 0x%x\", img->errorCode, img->errorOffset);\n return;\n } else {\n dmesg(\"Validation OK\");\n }\n vmImg = img;\n\n gcStartup();\n\n globals = (TValue *)app_alloc(sizeof(TValue) * getNumGlobals());\n memset(globals, 0, sizeof(TValue) * getNumGlobals());\n\n initRuntime();\n}\n\nvoid vmStart() {\n memInfo();\n install_gpio0_handler();\n\n auto sect = (VMImageSection *)PXT_EXPORTData[4];\n auto hd = (VMImageHeader *)sect->data;\n if (sect->type != SectionType::InfoHeader || hd->magic0 != VM_MAGIC0 || hd->imageSize < 256) {\n dmesg(\"invalid image at %p\", sect);\n return;\n }\n\n vmStartCore((uint8_t *)sect, hd->imageSize);\n}\n\n//% expose\nvoid updateScreen(Image_ img) {\n // dummy\n}\n\n} // namespace pxt",
"worker.cpp": "#include \"pxt.h\"\n#include \"freertos/queue.h\"\n\nnamespace pxt {\n\nstruct worker {\n TaskHandle_t task;\n xQueueHandle queue;\n TaskFunction_t fn;\n void *arg;\n};\n\ntypedef struct qitem {\n TaskFunction_t fn;\n void *arg;\n} qitem_t;\n\nstatic void worker_main(void *arg) {\n worker_t w = (worker_t)arg;\n while (1) {\n qitem_t evt;\n if (xQueueReceive(w->queue, &evt, w->fn ? 20 : 1))\n evt.fn(evt.arg);\n if (w->fn)\n w->fn(w->arg);\n }\n}\n\n\nworker_t worker_alloc(const char *id, uint32_t stack_size) {\n worker_t w = (worker_t)calloc(1, sizeof(struct worker));\n w->queue = xQueueCreate(20, sizeof(qitem_t));\n // The main task is at priority 1, so we're higher priority (run \"more often\").\n // Timer task runs at much higher priority (~20).\n xTaskCreatePinnedToCore(worker_main, id, stack_size, w, 2, &w->task, WORKER_CPU);\n return w;\n}\n\nvoid worker_set_idle(worker_t w, TaskFunction_t fn, void *arg) {\n w->fn = fn;\n w->arg = arg;\n}\n\nint worker_run(worker_t w, TaskFunction_t fn, void *arg) {\n qitem_t evt = {fn, arg};\n if (xQueueSendFromISR(w->queue, &evt, NULL) == pdPASS)\n return 0;\n return -1;\n}\n\nint worker_run_wait(worker_t w, TaskFunction_t fn, void *arg) {\n qitem_t evt = {fn, arg};\n if (xQueueSend(w->queue, &evt, 100) == pdPASS)\n return 0;\n return -1;\n}\n\n\n}"
},
"screen---st7735": {
"arcadegamepad.h": "// Autogenerated C header file for Arcade Gamepad\n#ifndef _JACDAC_SPEC_ARCADE_GAMEPAD_H\n#define _JACDAC_SPEC_ARCADE_GAMEPAD_H 1\n\n#define JD_SERVICE_CLASS_ARCADE_GAMEPAD 0x1deaa06e\n\n// enum Button (uint8_t)\n#define JD_ARCADE_GAMEPAD_BUTTON_LEFT 0x1\n#define JD_ARCADE_GAMEPAD_BUTTON_UP 0x2\n#define JD_ARCADE_GAMEPAD_BUTTON_RIGHT 0x3\n#define JD_ARCADE_GAMEPAD_BUTTON_DOWN 0x4\n#define JD_ARCADE_GAMEPAD_BUTTON_A 0x5\n#define JD_ARCADE_GAMEPAD_BUTTON_B 0x6\n#define JD_ARCADE_GAMEPAD_BUTTON_MENU 0x7\n#define JD_ARCADE_GAMEPAD_BUTTON_SELECT 0x8\n#define JD_ARCADE_GAMEPAD_BUTTON_RESET 0x9\n#define JD_ARCADE_GAMEPAD_BUTTON_EXIT 0xa\n\n/**\n * Indicates which buttons are currently active (pressed).\n * `pressure` should be `0xff` for digital buttons, and proportional for analog ones.\n */\n#define JD_ARCADE_GAMEPAD_REG_BUTTONS JD_REG_READING\ntypedef struct jd_arcade_gamepad_buttons {\n uint8_t button; // Button\n uint8_t pressure; // ratio u0.8\n} jd_arcade_gamepad_buttons_t;\n\n\n/**\n * Constant. Indicates number of players supported and which buttons are present on the controller.\n */\n#define JD_ARCADE_GAMEPAD_REG_AVAILABLE_BUTTONS 0x180\ntypedef struct jd_arcade_gamepad_available_buttons {\n uint8_t button[0]; // Button\n} jd_arcade_gamepad_available_buttons_t;\n\n\n/**\n * Argument: button Button (uint8_t). Emitted when button goes from inactive to active.\n */\n#define JD_ARCADE_GAMEPAD_EV_DOWN JD_EV_ACTIVE\n\n/**\n * Argument: button Button (uint8_t). Emitted when button goes from active to inactive.\n */\n#define JD_ARCADE_GAMEPAD_EV_UP JD_EV_INACTIVE\n\n#endif\n",
"arcadesound.h": "// Autogenerated C header file for Arcade sound\n#ifndef _JACDAC_SPEC_ARCADE_SOUND_H\n#define _JACDAC_SPEC_ARCADE_SOUND_H 1\n\n#define JD_SERVICE_CLASS_ARCADE_SOUND 0x1fc63606\n\n/**\n * Argument: samples bytes. Play samples, which are single channel, signed 16-bit little endian values.\n */\n#define JD_ARCADE_SOUND_CMD_PLAY 0x80\n\n/**\n * Read-write Hz u22.10 (uint32_t). Get or set playback sample rate (in samples per second).\n * If you set it, read it back, as the value may be rounded up or down.\n */\n#define JD_ARCADE_SOUND_REG_SAMPLE_RATE 0x80\n\n/**\n * Constant B uint32_t. The size of the internal audio buffer.\n */\n#define JD_ARCADE_SOUND_REG_BUFFER_SIZE 0x180\n\n/**\n * Read-only B uint32_t. How much data is still left in the buffer to play.\n * Clients should not send more data than `buffer_size - buffer_pending`,\n * but can keep the `buffer_pending` as low as they want to ensure low latency\n * of audio playback.\n */\n#define JD_ARCADE_SOUND_REG_BUFFER_PENDING 0x181\n\n#endif\n",
"fieldeditors.ts": "/**\n * Image manipulation blocks\n */\n//% weight=70 icon=\"\\uf03e\" color=\"#a5b1c2\"\n//% advanced=true\nnamespace images {\n //% blockId=screen_image_picker block=\"%img\"\n //% shim=TD_ID\n //% img.fieldEditor=\"sprite\"\n //% img.fieldOptions.taggedTemplate=\"img\"\n //% img.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% img.fieldOptions.decompileArgumentAsString=\"true\"\n //% img.fieldOptions.filter=\"!tile !dialog !background\"\n //% weight=100 group=\"Create\" duplicateShadowOnDrag\n export function _spriteImage(img: Image) {\n return img\n }\n\n //% blockId=background_image_picker block=\"%img\"\n //% shim=TD_ID\n //% img.fieldEditor=\"sprite\"\n //% img.fieldOptions.taggedTemplate=\"img\"\n //% img.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% img.fieldOptions.decompileArgumentAsString=\"true\"\n //% img.fieldOptions.sizes=\"-1,-1\"\n //% img.fieldOptions.filter=\"background\"\n //% weight=100 group=\"Create\"\n //% blockHidden=1 duplicateShadowOnDrag\n export function _screenImage(img: Image) {\n return img\n }\n\n //% blockId=tilemap_image_picker block=\"%img\"\n //% shim=TD_ID\n //% img.fieldEditor=\"sprite\"\n //% img.fieldOptions.taggedTemplate=\"img\"\n //% img.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% img.fieldOptions.sizes=\"10,8;16,16;32,32;48,48;64,64;16,32;32,48;32,8;64,8;20,15;40,15\"\n //% weight=100 group=\"Create\"\n //% blockHidden=1 duplicateShadowOnDrag\n export function _tileMapImage(img: Image) {\n return img\n }\n\n //% blockId=tile_image_picker block=\"%img\"\n //% shim=TD_ID\n //% img.fieldEditor=\"sprite\"\n //% img.fieldOptions.taggedTemplate=\"img\"\n //% img.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% img.fieldOptions.sizes=\"16,16;32,32;8,8\"\n //% img.fieldOptions.filter=\"tile\"\n //% weight=100 group=\"Create\"\n //% blockHidden=1 duplicateShadowOnDrag\n export function _tileImage(img: Image) {\n return img\n }\n\n //% blockId=tileset_tile_picker block=\"%tile\"\n //% shim=TD_ID\n //% tile.fieldEditor=\"tileset\"\n //% tile.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% weight=10 blockNamespace=\"scene\" group=\"Tiles\"\n //% blockHidden=1 duplicateShadowOnDrag\n export function _tile(tile: Image) {\n return tile\n }\n\n //% blockId=dialog_image_picker block=\"%img\"\n //% shim=TD_ID\n //% img.fieldEditor=\"sprite\"\n //% img.fieldOptions.taggedTemplate=\"img\"\n //% img.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% img.fieldOptions.decompileArgumentAsString=\"true\"\n //% img.fieldOptions.sizes=\"15,15;18,18;21,21;24,24;9,9;12,12\"\n //% img.fieldOptions.filter=\"dialog\"\n //% weight=100 group=\"Create\"\n //% blockHidden=1 duplicateShadowOnDrag\n export function _dialogImage(img: Image) {\n return img\n }\n\n /**\n * An image\n * @param image the image\n */\n //% blockId=image_picker block=\"%image\" shim=TD_ID\n //% image.fieldEditor=\"images\"\n //% image.fieldOptions.columns=6\n //% image.fieldOptions.width=600\n //% weight=0 group=\"Create\"\n export function _image(image: Image): Image {\n return image;\n }\n\n //% blockId=colorindexpicker block=\"%index\" blockHidden=true shim=TD_ID\n //% index.fieldEditor=\"colornumber\"\n //% index.fieldOptions.valueMode=\"index\"\n //% index.fieldOptions.decompileLiterals=\"true\"\n export function __colorIndexPicker(index: number) {\n return index;\n }\n\n /**\n * A position picker\n */\n //% blockId=positionPicker block=\"%index\" blockHidden=true shim=TD_ID\n //% index.fieldEditor=\"position\" color=\"#ffffff\" colorSecondary=\"#ffffff\"\n //% index.fieldOptions.decompileLiterals=\"true\"\n export function __positionPicker(index: number) {\n return index;\n }\n}\n",
"font12.jres": "{\n \"image.font12\": {\n \"mimeType\": \"font/x-mkcd-b26\",\n \"data\": \"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9A9UANwHAAD4AQAI/AcAADhSIAGqCOoIrAS4Aq4BqAi4CKwG6gGqACABOVJQBFQDVAjIB0wAUgFSBgAA/AkACP4PAAA6UgAEdAYUAf4PFAH0AgAA/AEACAAI/gcAADtSAAAkCbQErwJkAhQDxAQAAPwJAAj+DwAAPVIgAJAMiAakBaYEiAawCAAA+AkACP4HAABCUkQIVARUAzYANACsDyQAAAD8CQAI/wcAAENSAAToBKoCrAH4D64AuAcAAPwJAAj+BwAAR1IACP4FKgUqASoB/g0AAPwBAAgACP4HAABKUgAA9g9QAV4JUAn2BwAA/AEACAAI/gcAAE1SAADoD6oCrAqoCugHCADoAw4I6AcIAAAATlIAAFIEUgNMAOQPSgJqBAAA/AkACP4HAABRUhAAWAiEBRIE0wQEB8gCAAL8CAAI/gcAAFRSAAG+BOoCqg2qA6oIvgcAAPwJAAj+BwAAVlIkAKwPrASmBKQEvASsBwAA/AkACP4PAABbUgAA/A8MA+QDFAn8BwAA+AEACPwHAAAAAF1SAADAANgKVgrUB3QAzAYAAPgJAAj+BwAAY1IQCPAEvAbyAbQC5AwAAPwBAAgACP4HAABkUgAAJAisB5YCrAKkDyQAAAD8AQAI/g8AAGVSoAIqCioJ6g8qAb4CoAYAAPwJAAj+BwAAZ1LABz4AqgeqBPoEqgSuBwAA/AAACP8HAABpUogIbARsAgwB/A8MAWoCKAQAAPwJAAj+B2pSAAV8BTwFPgW8A/wBBAF0BQYFdAUEAwAAb1ICAN4PVgXWB1YFVgXeDwAA/AkACP4HAABwUgAArAT8AqwB/A+qAvoGAAD4AQAI/gcAAHJSjAC8D7QFtAX2BbQHtAeMBwAA/AEACP4HdVIQABAO0AP4BfQF5AXoBwAA+AEACPwHAAB/UgAIdgVwBXQD+g94A3ADdgUAAPgJAAj+B4NSSAT8B/wH/gf8B/wH/Af8BwAE+AEACPwHh1IADvgBGATYBn4DbA9sAggE8AEACPwPAACIUoAAfAj0CbQJtAX4A1QBXAn2CVwJVAcAAIlSAACcCcoLyQmwB84FQgUOBPgBAAj+BwAAjVIICOgErALqAEsIogbkBAAA/AEACP4HAACRUjgASAz0A4wClgK8AswPIAD8AQAI/gcAAJtSAAAQCBAEEAKQAX4AEAAQCBAIEAzwAwAAnVIABBQCZAHkABwJAASIA34ACAgICPgHAACeUgAAiAloBAgCiAF+CAgICAz4AwAA4AEAAJ9SBAIEAvwBBAkECRAEEAP+CBAIEAzwAwAAoFIICAgG/gEICAgI+AcAAPwPBAQEBPwPAAChUkAIUAlICSwFNgOkASQJNAlMCUQHQAAAAKNSKAioCKQIogSgA54AkAiICIIIhAcIAAAAqFIAACQE5AMkAqQCJAMACBAH/gAQCPAHAACpUgAE/gOSBJIC/gsABBAD8AgfCBAI8AcAAKpSAAhECVwJZgUkA1wBRAE0CSQJXAdEAAAAq1IAAEgHyAR+AkgCQAcQABAP/gAQCPAHAACxUgAO/AEUDPQDVAjUBwQAEAf8ABAI8AcAALJSAACkCKQElAesBKQEMAAQDv4BEAjwBwAAs1IACLQIlASWBJQD1ACUCJQIlgiUBzQAAAC0UgAIuAiKBIoEiALrAYgIiAiMCIoHOAAAALlSKAioBKgCDAGoAggIUAQQA/4IEAjwBwAAv1IAABQIVAl+BRQFwAM0AR4JBAk8B0AAIADBUgAAtASEBLQHhAS0DAQEEAP+CBAI8AcAAMNSAAA0AhQJXgeUATQJAAQQA/4IEAjwBwAAx1IACAIK+gqqBqoC+gKqAq4Kqgr6BgAAAADJUhAI+ASWA/QAnAfwCBgKmAl+CAgK+AkABMtSAAjuCSoEqgMqCO4LAAAQB/4AEAjwBwAA0lIAAOQCvgL0D74C5AgEBBAD/ggQCPAHAADVUgAAfAl8CfwHeg0IBBgCkAF+CBAI8AcAANhSgACCB/8FqgSqBP8FggwIAv8BCAT4AwAA2VIAACoDqgjqBzYA4AlIBy4BNAk0CSwHRAHdUgAM/gOSCP4HgAFqCTgHrgE4CW4JqgcAAd5SEgiSCKgErgSgAqIBpAioCKYIKAdyAAAA31IAAkQB/AV+A3wDfAF8BX4F/AN8AUQCAADiUgAArAmsCe4FrAWAA/gBGAkOCXgGgABgAORSAAj0CdYF9AfWBfQFAAwQA/4IEAjwBwAA51IAACAB7A+4B+gHqAeoDgAG/AEQCPAHAADyUgAB/g3+Af4B/g3+AQgLmAh+AAgB+AwAAPNSBAh9BW0B/wTsAvwCAAaIAX8ECAT4AwAA9VIADPwDzA/8AewD/AvMDwAM/gMQCPAHAAD4UgAB+g+7B4AHuwe6BwAM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JAAAAK1T+AcEAPQD/AJ8B3QFhAckBPwDJAEUAgAErlMABv4BAgT6AVoD+gECDPoDSgDKD0oAAACyUwAO/gECAOoP6gHqBeIH6gXqBeoJCg8CALNTAA74AQ4E+Ae4BroG/A8IAOgMLAPqBSgIu1NAAEgMSAZIBcgEfgRIBEgFSAZICEAAAAC/UwAAgACABP4GqgWqBKoEqgSqBP4GgASAAMFTIAGoCKgK7Aq6CqgKqgruCqgKqAggAQAAwlMgASgBqAhsCroKqAooCWoErASgACABAADDUwAAAAGwAKQJdgulChQKJgl2BKAEMAFAAchTAAAACAQIHARkBIQCBAGEAmQEHAQECAAIyVMACAQIPAREBJQCFAGUAkQEPAQEBAAIAADKUwAEBAaEAXwIJATEBAQDHAOQAnAEEAQAAMtTAAQIBAgDyAh+BKgEKAMoA6gEaAQICAAEzFMUCDQERALkARwKAAh8BIQDxAI8BAAIAADNUwAAAAz8AyQI5AgkBSQCJAakBWQIBAgAAM5TAAL4AQABAAH+DwAAFAjkBAQDxAQ8BAQI0VMABBACHAuQCPAIXgVQBlAF1ghQCBAIAADUUwACoAEgCP4PJACgCwQIfAaEAeQCHAwACNZTBAT8B5QElASUAvwPAABoCIgFCAPoBBgI11MAAHQIHATcBFQFXAJcAlIF2gQaBDAIAADYUwAIpAiUCIQJvAaGBIYEvAaECZQIJAgACNlTUAZYAVQI8g9UAFQDBAh8BIQDxAI8DAAA21MAAKwIoAb+AaQAAA78AXIMkgOSAnIMAATgUwAA6Ah2CFYPVg9GD1YPXg9WD3gIyAgAAOFTAACoANgHvwfaB/oHkAAMDPQChAF8BgAE4lMIAKoE7Af4B/wH6A/oAPwH7AXqB4gJgAjjUwAAAAD8DwQEBAQEBAQEBAQEBPwPAAAAAORTAAAIAIgPiASIBP4EiASIBIgEiA8IAAAA5VMAAGAAEADMByoCKAIoAugLCAgIDPgDAADmUwAAgAi8BKQEpAPkAKQApAikCLwIgAcAAOhTAAD8AwQB/AkACAQGhAF8BAQIBAz8AwAA6VMAAPwDBAEEAfwBAAD8DwQABAIEAvwBAADqUwAAAAh8BEQCRAFEAEQARAFEAnwEAAgAAOtTAAD8AwQBBAH8AQAA/AMAAQAB/g8AAAAA7FOAAEQARA8kCRQJ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ggCyAIoAAAB9VAAAEADQB1gCWALUAxIA1A9YAEgC0AEQAIZUAAD8AwQB/AEwAPgDlgSUBPQFBAX8BAACi1QAAPwDBAH8ARAACAAOAPgPKAEoASgBAACMVAAClAFUAPwHUgAAAPwHBAIEAgQC/AcAAI9UAAD8AwQB/AQAAtQBFAj0D4QAQAEgBgAEkFQAAPwDBAH8AWAA/A8CANAAEAkQCP4HEACSVAAIHAgUBNQDXABAAFwAVADUBxwIAAgABpVUAAD8AwQB/AEAAJAPkASQBP4EkASQDxAAllQAAPwHBAH8DAAC/gkIDPAD/A8EBPwPAACZVAAA/AMEAfwJAASQA34IEATyB5YIVAgQBJpUAAD8AwQB/AFQAEgCLgK1BDQFTAlEAEAAplQAAPwDBAH8AQAI7ASsAv4BrAKsBLwJAAinVAAA/AMEAfwBQAi8BJQDYAD4CQAI/gcAAKhUIAARAIoPoASsBKMEkgSOBJIEog8uAAAAqlQAAPwHBAL8AwAIrAcgAP4PIACoAyQMAACsVAAA/AMEAfwBAAgoCKgECgPMBQgEaAhACK9UAAD8AwQB/AEQAYgPVgllCXQJXAmED4AAsVQAAPwBBAH8AQAA+AeoAqwCqgKoAvgHAACyVAAA/AMEAfwJAAhOBEwC+AFMAk4ESggAALNUAAD8AwQB/AEACCQFtARvAiQClAVECAAAuFQADPgDCACoB6gCqAoIC/4ICAfKCCwIAAa9VAAA/AMEAfgA/g8CBCIF+gSiBQIE/g8AAMBUAAIEAXQBVA/UBFUE1gRUAVQCdAUEBQAIwVQAAMAPQAReBNIHEgDSD1IEXgRABMAPAADEVAAA/AMEAfwBAAiIBP4CiACIAP4CiAyACMZUAAD8AwQB/AEACCgJpASWBFQCTAHEAAAAx1QAAPwDBAH8AQAIJAkkCb4PJAkkCSAJAADIVAAA/AMEAfwBYAAwD6gEpgSoBDAPYABAAMlUEADUB1QCXgJUAtQJEAz+AhADkgRUCAAHzVQAAPwDBAH8AQAA+A8IAOgDLgHoCQgI+AfOVAAA/AMEAfwBAAgkCM4EBAMEBc4EJAgECNFUAAD8AwQB/AVABAQE/AcEBPwHBATkBAAA11QAAPwDBAH8AQAAfAECAZAPPgFIAUQBJADfVAAA/AMEAfwBAAT8BYIEEALOCAgI+AcAAOFUAAAACP8LrQatBq0CrQKtBq0G/wsACAAA5VQAAEQAfAdsBWwFbAVsB3wARAj8D0QAAADmVAAA/AMEAfwBAAj8D5IAEAz+A5AFVggABuhUAAD8AwQB/AEAAPYPUAFeAVAJUAn2BwAA6VT8AwQB/AEAAHwJVAlUCfwPVAlUCXwJAADqVAAA/AMEAfgMAgL+CZII/gf8DwIA/gMAAO1UgAieCJIIkgSeA8AAnAOUBNQE3AiACAAA7lQAAP4BggD+AIABagEqCb8PagEuASoBCQHyVAAAEgCyD78EigSgBJ4EiQSJBLkHCQAIAPpU/AMEAfwBAADoD6gCqAL+D6gCqgrsBwAA/FQAAPwBhAD8AAAAvAisCK4OrAGsAbwABAABVQAA/AcEA/wDAACoDqgKqgqqCqgKqA4IAAZVAAD8AwQB/AlACCgJngaIBPwGzAVYCEAIB1UAAAAP/gAiDuoKqgpqCqoKqgoqDSIBAAAJVQAA/AMEAfwBAAgoCS4F6gMoBS4JKAkAABBVAAb8AQQAXAdcBVwF/gVcBVwFfAcUAAAAFFUAAPwDBAH8AQAAqge6BK4EqgS6BKIHIAAgVQAA/AMEAfwBAAiUBJYC1AmUCJYMNAMAACRV/AMEAfwBAAj4BJQClgH0AZwClAT0BIAIJ1UAAPwDBAH8AQAE/AdUAjwA+A8EAPwDAAAsVQAA/AMEAfwBAAz4AygIPgdsAGwHTAgABC5VCAAIAHwPXgVcBVwFfgVcBVwFXA9EAAAAL1UAAPwDBAH8AQAA/A+qBKgE/geoBKgEAAAxVQAA/AMEAfwBAAD+B2oFagVqBWoF/gcAADdVAAD8AwQB/AEACPQH7ADmAmUKZAr0ByQAOFUAAPwDBAH8CAAGKACkBLIJNAr0ACQGCAg+VQAA/AMEAfwBAAjUChQK/A8UCtIKUAoQCENVAAD+AYIA/gAIAO4PqAKvAqoKqgrqDwAARFUAAPwDBAH8ASAElAJUCiwJxAdkAJQDAARGVQAAAAD0DxQAfAcWBTQFVAVcBxQA9A8AAEpVAAD8AwQB+AD+DzIAzAHkAxQB5Aj8BwQAT1UAAP4PKgCqB74CgAK+AqoDKggqCP4HAABTVcIAOgCqB6oEqgS6BJAEzgS0BDQHTACEAF9VAAb8AaoHqgKqAroDIAR+AogB6AIYBAAAYVUAAPwDBAH8AQAAKAH+DwAA/g8oASgBAABkVfwDBAH8AQAAfALUAtQCfgJUD1QCfAIAAGVVAAD8AwQB/AEQAEgHRAXyBVQFRAVIB1AAZlUAAPwDBAH8AQAM/gMICGAIiQkKDugJAABqVQAA/AMEAfwBgAj+B0AA+A+MBIoE+A8AAHBVAAD8AwQB+AmOCVIIfgVSAl4B0gFeAAAAeFX8AwQB/AEADKwDLAYsAf4PLAEsArwPCAB8VQAA/AMEAfwBAABsB6QApg+0AKQEpAMAAIBVAAD8BwQC/AMAAKQPtAlWCVQJpA6MAAAAglX8AwQB/AEAAPwA1A/UCPwJ1ALUB/wJAACDVQAA/AMEAfwA4A8UALQCngfUAhQI9AcAAIRVAAFEAVQPVgtUC/wLVAtUC9YL1A9EAQAAh1UAAPwDBAH8DGQCng/0AZQCYAj4CP4HAACJVQAA/AMEAfwBYAD4DwYAUAlUBdQDXAVQCYpVAAD8AwQB/AzwAwgHqAIIDX4CiAVqCAAGlFUAAPwDBAH8DAAC/Ak0CPQKtA+0CrwKAACYVfwDBAH8AQAAvA+wALAP/gCwD7AAvA8AAJpVAAD8AYQAfAjwBVgFNgOUAzwFUAXwCQABnFUAAQQBfA/cC1wLXgtcC1wL3At8DwQBAAGdVQAA/AMEAfwBAAC+BqoEqgWqCKoIvgcAAKdVAAD8AwQB/AEICPQLtAq2CrQK1AscCAAAqlUAAIQIvAisD7wIhAj+CYQCvASsCrwKhAirVQAA/AMEAfwJAAg+BTQDwAM8BQQJfAkAAKxVKAAsAJwP/ADcB9wF3AXcBfwHmgioDyAArlUAAAAE/gVaBVoF/g9QBV4FWgX6BQ4EAACyVQAA/gMCAf4BGAznApAAUAaOAAgI+AcAALNVAAD8AwQB/AEACNQLrAquCqwK1AsUCAAAtVX+AYIA/gAAAPAPkgSXBPIHkASXBPIHAgC2VQAAGAAKB3wFWAXeBVgFWAV8BQoHGAAAALdV/AMEAfwBAAjUC1QIVAZWAVQEVAjUCwAIu1UAAPwDBAH8ARgA2A+0AvIPlAEYCMgHEADFVQAA/AMEAfwBAAh8BVwFXgNeA9wFfAUACc5VAAD8AwQB/AEADP4AqgaqAP4EqgGCDwAA01UAAPwDBAH8AQAIUgV2A4YPlgNSBTAFAAjaVQAA/AMEAfwJAAT8ANQO1gDUBdwIwAcAANxVAAD8AwQB/AFAADQHfgfUB9wH1AfUBwAA4VX8AwQB/AEABMgCVAqiBxAAUgJ0CuQHCADjVQAA3A/UB9QP3A+EAVQC1AsECPwHAAAAAORV/AEEAfwBAATgB2wGeAbuB2gGaAbsDyAI5lUAAPwDBAH8AQAMVAH0CV4HFAGUBTAIAADoVQAA/AMEAfwAAA5EAJADzAKoC6gK6AcAAu9VAAD8AwQB+AA+AWICagRaBVoEQgF+AwAC/VUAAPwDBAH8BCQC/g9UAXQJEAbOAQgGOAgAVgAA/AMEAfwBAAD0DxQC9gVUBVwHFAj0BwFWAAD+AYIA/g74AYQE9AcUAIcEfAOFBnQCBlb8AwQB/AEACPQK1ArWBvQD1AbWCvQKAAAJVgAAgg6+Au4KrgqvBq4M7gquCr4Kgg4AAA5WAAD4AwgB8AUEBXwF/AN8A3wF/AV8BwQDF1YAAAwARg/WC/QL9gv0C/QL9gvFD5wAAAAbVgAA/AMEAfwI+AcEAfQPJgKEAfQPpAAEAx9WAAD8AwQB/ACAD34FUAWID/wHBAD8AwAAMVYAAPwBhAB8CAAH/A60AdwF/AfUAdwPAAAyVgAA/AMEAfwDfAKuD3wC/geSAP4PAAAAADRWAAD8AwQB/AEQBNgD7gL0B/AC7gLUBxAANlYAAPwDBAH4AAQN/gFUAf4N/AMkAOIPIgA5VgAA/gOCAf4BAAz6AVYJUw9WAfoBMgwAADtWAAD8AwQB/AEAAHwP3AteC1wL3At8DwQBP1b8AYQA/AAACF4FVgFSBf4JWgFSBV4AAA5BVgAA/AMEAfwAIA1UAdwHBAvcC1QJdAEADWJWAAD8AwQB+Al8CAwFZAN2ASQDRAV8CQAAaFYAAEACXA9UCdQJfA9gAEwP9Al0CVwPQAJpVgQIxAv8CvwLRAj8D0QI/AvsCvwLBAgAAGpWAAD8AwQB/AnABbwF9AOUD/QPvAPgBQAIdFYAAPwBhAD8BBAE9Af0AvYC9ALUBvQHEAiHVgAA/AMECfwH5As/COQPJA3kA/8PJACgA45WAAD8AwQB/AFACDwGvAa+A7wPvAPkBAAAo1YAAIgH7gWuBW4HWABuB24FrgVuBYgHAAC0VgAO4AG8BPQH9AfsD7gB1Al0BvwFYAgAALdWAAD8AwQB/AUADPwP7An+AfQH7AX8CQAAvFYAAPwDBAH8AQAA9A/yBfoMMgG5CLUHgADCVgAACAL+B/4H/gf+BvgA/gb+B/4HCAUAAclWAAD+AYIAfAH3BqUCBwP9D1cF9QdXBQAAylYABbQD/Av8B/wFngX8AfwD/AXcB5QHAADaVgAA/g8CBAIFggRCBDoEwgQCBQIE/g8AANtWAAD8DwQExAU8BAQEBAR8BIQEBAT8DwAA3lYAAP4PAgTyBJIEkgSSBPIEAgQCBP4PAADgVgAA/g8CBCIFIgWiBHoEogQiBQIE/g8AAOJWAAD+BwIEkgRSBFIFMgX6BRIEAgT+BwAA41YAAP4HAgQKBGoECgUKBfoECgQCBP4HAADkVv4PAgRSBJIEkgT6BZIGkgZSBgIE/g8AAO1WAAD+BwIEKgXqBCoE6gUqBSoFAgT+BwAA8FYAAP4PAgSiBWIE+gViBKIEIgUCBP4PAADxVgAA/A8EBEQFJAVXBZQEdAUUBQQE/A8AAPJWAAD+DwIEkgT6BZIEkgT6BZIEAgT+DwAA81YAAP4PAgZaB0IFygTCBDIFCgUCBP4PAAD0VgAA/g8CBKoEqgT6BaoEqgSKBQIE/g8AAPpWAAD+DwIEEgTSBVIFegVSBdIFAgT+DwAA/VYAAP4PAgQqBSoF+gUqBWoFKgUCBP4PAAD+VgAA/w8BBCkFLQUVBZUFrQYlBgEE/w8AAANXAAD8BwQE9AX0BPwE/AX0BPQE9AUEBPwHBlf+BwIG3gZWBlYFVgVWBF4GwgYCBP4HAAAIVwAA/gcCBD4E/gU6BroGegY6BQIE/gcAAAtXAAD+BwIE6gWqBUoEegWKBW4GAgT+BwAADVcAAP4HAgT+BX4FfgX+BX4FegUCBP4HAAAPVwAA/gcCBGoE6gX6BuoG+gZqBAIE/gcAABJXAAD+DwIM6g1qC3oLagtqC+oLAgz+DwAAE1cAAP4PAgjCC/oL6gvqC+oL+gsCCP4PAAAWVwAA/gcCBP4H9gf2B/YHfgbiBwIE/gcAABhX/g8CBP4E/gX+BP4E/gb+B/4EAgT+DwAAH1cABCAEIAQgBCAE/gcgBCAEIAQgBAAEAAAjV0AIRAhMCSwJNAmkDzQJNAlMCUQIQAgAACdXAAAADPwDBAhECEQI9A9ECEQIRAgECAAAKFcIAYgAyA84AI4IiAiICOgPiAiICIgIAAAtVwAIJAkkCSQJJAm/DyQJJAkkCSQJIAgAADBXAAIQAv4BEAFAAPwHIAggCP4JEAgQCfgEM1cABBAC/gMQAQAM/gMAAAAA/AcAAAAA/g86VwACEAL+AxABAAEiCfIEKgLmCSIM4AMAAD5XAAQQAv4DEAoABIQDfAiEBCQHPAXgBAAIQFcQAhAC/gEQAQAI8A8ACAAI/g8gCCAIIAhCVwACEAL/AZAEAAb+ATIM0gISA5ICcgQCCEdXAAIQAv4BEAEwAAwCKgEoCagICAz4AwAASlcQAhAC/gEQCQAMCAL4AUoISAhICMgHCABOVwACEAL+ARABQAg0CAoG6AEIAkgEOAgAAE9XAAIQAv4BEAFEAUQAJAD8DwQAJADEAIAAUFcgCJAIjgiwCIAI/g+gCJAIjgiQCCAIAABRVwACEAL+ARABAAzoAyoAKgDoBwgICAYAAFdXAAIQAf4BkACACAgESAP+AMgBSAJ4BEAIWlcACD4IAAkACX4JRg8qCRIJKgkmCUAIAABbVwACEAL+ARABAAQkBqQFZAQkBKQFJA4ACF1XAAIQAv4BEAEACP4JAgQCAvoBAgQCBP4JXlcQAhAC/gMQAQAC/AKEAoYCpgqkCJwHAABfVwACEAL+ARABgAkIBHgEigOMAngECAgIBGBXAAR+BQIFPgUCBaAHMAUOBRAFIAVABAAAYVcAAhAC/gMQCQAM+APICX4GSAbICVgIAABkVxAC/gEQAQAA/AMkASQB/w8kASQB/AMAAGZXgAAQAf4AkAAABP4EkgSSBJIEkgT+BAAEalcAABAC/gMQAQIAugCCAP4PggCyAIoAAABvVwAEEAL+AxACQAlECCQI/AskCEQIhAgAAHdXAAIQAv4DEAEEAPQDFAH0CQQI/AcEAAAAglcAAEACVAr0C1QKVAr8D1QK8gtSCkAAAACDVwACEAL+ARABAAQoBMgFCgQIB+gECAQAAIRXiAiICmgKGApMCkgPeAqsCqwKiApICAAAi1cAAEAEygQ+BAoFfgUKBwAFHgVABX4EAASSV0AIaAlICWwJCgkID2gJTAlICSgJQAgAAJtXAAQQBP4DEAIACKAEngLCD4IBvgKgBKAIolcAAhAC/gEQAQAO/AGUD1QEVARSBNIPEACjVwACEAL+AxAJBAj0C1QKVApUClQK9AsECKZXAAAACP4KqgoqCioPagqqCqoK3gqACoAIq1ckBJQF/gUUBQAF1Ac0BR4FBAV8BIAEQACuVwAEEAL8AxACgACoArgDrAqoCpgKqAaoAMJXAAIQAv4DEAkACfwHrAasBfwIrAisCPwAw1cABBAC/gMQAUAIKAkuBegDLAUsCSAJAADLVwACEAL+ARABAAh8CVQJVAn8D1QJVAl8Cc5XAAAQAv4BAAz4AygAKArICX4EiAduCAgG1FcAAhAC/gEQAQAA6A+oAqgC/g+oAqoK6gffVwAAEAL+ARABQACoAugKCAR+AogFaggMBuBXAAIQAv4BEAEAAvwCtAK2D7QCtAL8AgAC91cAAJQC1AKeD/QCEAhIBv4BCAEIAPgHAAz5VwABEAL+AQABJACkB7QEpgSkBLwErAckAPpXAABIAUgF/AR4BXgHeAV4BfwESAVIAQAA/FcAAhAB/gEQAQAAtAe0Aq4LNgg0CPQPNAAAWAAACAH/AAAG/wEFDnUERQT1B0UEdwcAAAJYAAA4CAoK7AqoCq4PqAqoCuwKCgo4CAAABVgABH4FVgV2BVYFXgcABUoFMgU6BUYEQAAGWBACEAH+AYAAMAD8D6oEqAT+B6gEqAQAABVYAAj+CgoKdgoACnwPPgo8CrwK/AoECAAAIVgQABAEfgUABV4FOgcaBXoFOgVeBVAEAAAkWBAEEAT+AxAKgAi+BqoEqg+qCqoKvgqACCpYAAAQBP4DEAMED/4JVAtUC1QJ/g0ECQAAL1gAAJgJnAl8BVwDDgFcAVwHfAlcCVgFAAAwWAACEAH+ARAA/A8EBPwGfAd8BfwFfARAADFYAABUAXQB3gd0AQAA/g9iCLIEMgPuDAAENFgAAggC/gEIAEAJ/gVqA2oFagNqCX4HAAA1WAACEAH+ARAB1ABUAN4HdAVQBVgF1gcQADpYAAEIAf4AgAm+BKoE6gM+ACoA6g++AQABQVgACEAJfgtqCyoKPg8qCqoKagt+C0AJAABKWAAEEAL+AxABAAF8CFYH1QD8B1QIVAt8C0xYCAEIAf8BCAFAAN8BVQXVB5UBVQnfDwAAUVgAAGgIzAp4CkwKKA+ACnwKVApUCvwIAABUWAACEAL+ARABRAAkByYFVAVUBSYFJAdEAFdY2ggCCooKqAosCqwOqgr6CiwKrAqoCAgAWFgAAggB/wEIAQAG/AEcBl0F+gVcBXwHFABaWAACEAL+AZAFBgWqAnoKigk6BsoAJgcAAF5YAACECrQKtAn0CrQKtg70CrQJtAqECgAAaVgAARAB/gEQBTgE9gfUB9QE1Af0BIQHAARrWAAEEAL+AxABAAj8C7wKvgK8CvwLBAoAAHVYAAAADP4H6gT+BWoFawd+BeoF6gX6BAAAflhECHwJfAv+C3wKAA+ICmgKHgr4CAAJwAiDWAACCAL/AYgICAj6BV4DWwFeD/oJCAQAAIVYAAh+C2oL/gtqC34PEAqSCvoKFgpyCAAAilgAAKwIrAruC7wKiA/oCjwKSAr4CAAJwAiTWAABRAX8BH4FfAV8BXwHfAV+BPwERAUAAZdYAAIQAv4BAAF8ANcP1Ar8CtQK1wr8DwAAmVgAABAD/gGQAAQA7AfkB/4G5AZsBeQHAACcWAAAfgSKBnYGAAZWBzwFtAX0BRYFZASAAJ5YAAAQA/8BgAA8AOYPdAV8BWQF5w88AAAAqFgABCAEfgU6BXoFPgd6BT4FOgV+BSAEAACpWBAE/gMQA3AC2grcD/gDAAr+BIgDeAwAAK5YAAD+CAIKfgoACvYPOwp+Cn4K3gp+CAgIs1gAAhAC/gEQAQQI1AfcB94D1APUB9QLEAjBWEAAfgRqBWoFagVuBzQFPAV2BTQFPAUABMdYAAAQAf4BAAF8BMwH/Af+B/wHzAd8BAQEylgAABAC/gEAA/QK1A70Cd4F9ALUBvQIAAjTWAAM/gPKAf4G/ga+B8IHEgf6BvIGtAQAAdVYAAAQAv4BEABEBbwGvAO+C7wHvAHkBgAE2FgABHAFfgV+BX4FfgcuBX4FfgV+BXAEAADeWAAAEAL+AQAAXAKsDjwJbgk8AuwG/AgAAOJYAAAQBPwDAAj8BwQA9A5kCAQO9AqkCgAA5FgAABAC/gEABXwE7A3+C8YB/AfsBfwJBAHrWCAAIAQgBCAEIAT+ByAEIAQgBCAEIAAAAO5YAAIYAgAB/g8AACAIIAj+DyAIIAggCAAA71iACJ4HkAD+DwAAIAggCCAI/g8gCCAIIAjwWAAABAzUA1QBVAHeAVQBVAFUAdQDBAAAAPJYAAjECFQIVAZUAV4AVABUB1QIVAjEBAAA81gACMQIVAhUBNQD3gDUANQHVAhUCMQIAAT2WAAAxAhUClQIVA9UCF4IVA9UCFQKxAgAAPlYAAA0BLwFfAV8BX4FfAV8B/wF3AUUBAAA+lgAAGQINAu0CvQOPgj0DrQKtAo0C2QIAAD9WJQA3Ab8BvwG/Ab+APwE/AL8CtwP1AKAAARZgAhgCN4ECAPoAhgEAAj+CyAIQAiACAAAB1lAAFAASA+sCrYKpA+0CqwKzArED0AAQAAJWQQKRAo0CYQFpAaeBMQG/AaECZQIJAgAAA1ZAAAICAgKdgneB1wFXAVcBVwLfAkECAAID1kACAQKfAl8BfwHfAV8BXwHfAl8CQQIAAgVWQAAQAAgCBAISAROBIoCCAGIAGgAGAAAABZZQABgCFAEjgKIAWgAEAAgAP4PgAAAAQACGlkAAFAISAlECTQFpgSUBkwCRAHAAEAAAAAcWYQARAD0DwQARAhmBLQDFAOUBHQEFAgAAB9ZIADwAywJ6AkICPgHAACoCJYEVAJMAcAAIFkICagEdgVUAswBEADMAyoB6AkICPgHAAAiWcQAfApsCm4L/AtsBWwFdgNsAXwAxAAAACVZAAj8BNQC/A/UAvwAEAhICdYGtASMA4AAJ1kQCBAEEAIQAdAAPgBQAJABEAIQBBAIAAApWUAIRAhEBEQCRAP8AEQBRAJEBEQIQAgAACpZEAgQBBAEEAPQAj4EUAiQARACEAQQCAAAK1lACEgESARIAkgB/gBIAUgCSARIBEAIAAAtWQAAQAhECEQERAREA/wARANEBEIEQghACC5ZAACACPgIiASIA/4AiAGIBogE+AiACAAAL1mAAEgIyAioBJgDzgCICIgImAgoB0gAiAAxWWAIcAROBEgCyAF+AMgBSAJIBEgEQAgAADRZQARICFIEVAREAsABfgBAAkACQARACAAAN1kAAAQI7ASsBKwC/gGsA6wErAq8CoQJAAA4WQAAKACoAKgCuAOsAqgKqAq4CqgGqAAoADlZAACACIgIqAiIBIgD/gCIA4gEqASICIAIOlkAAKgAqACoAJgGjACKCJgImA+oAKgAqAA+WQgJiAhoBAgECAP8AAgDiARoCIgICAkAAERZSAAoAOgHuAKsAuoHqAqoCrgK6AtICAAAR1kAADQAtAe0ArQCrAKuAywINAj0BzQAIABIWSgEqAyoApgIrAiqB6gAmAKoAqgMKAAAAElZAACgAKwCbAIsArwCrg+sAiwCbAKsAqAAS1lAAEQA5A9UBUwFxgdMBVQFZAXkD0QAQABOWRQEVARMBVwFVgV1B1QFXAVMBVQFFAQAAE9ZkABUCFwFfAVcA94BXANcBXwFXAlcCJAAUVkAAFQJVAl+CVQFQANCAyIFHglCCT4JAABUWSABJAkUBawDJAEmAXUBJAGMDxQBJAEgAVVZJAlUCUQJJAUcBQYDBgF8BQQFFAUkCQAIVlkgCSQJEAl+CQAFSANEAyYFJAkcCQQJAABXWSAAJAEUBfwHdAV2BXQFdAV8BRQNJAkgAFpZAAmECawFZAW0A6oBYgNSA0IFSgUACQAAYFkAAAQF/AXuBe4F3APcA+4F7gX8BQQFAABiWSgBKgGqAK4P6gq7CqoKugqmCqYPKgAqAGVZAAAACXwJDAVkBXYDJANMBQQFfAkACQAAZ1kACXwJBAVsBWwFLAN+ASwDLAOEBfwFAAloWQAALgkgCX4FAAUkA5IBFgORBf0FFQkQCWpZAABUATQB/AP0B/YB9AX0BfQD/AGUARQBblkAABoAmg/+Cv4K+w/6CvoK/gr6D0oAAABzWQAAEAgQCdAIMAkeBRICEAKQBXAEEAgQCHRZiAj4BA4DyAE4CAAMNATEA8QCPAQACAAAdlkICPgMDgOIA3AIBAf8AAQEPAgkCOAHAAB4WQAA+AgOBYgDeAwAAEQARAD8D0QARABAAHlZAAj4DA4DiAF4BgAA/AcQCP4JCAj4CAAGfVkACOgMHgOIA3gEAABECEQI9A9MAEQAQACCWQAACAj4CA4F6AMQAPwPBAQEBAQE/A8AAINZAAj4CA4FiAN4BAAAxAdECEQIRAj8CAAGhFmACIQIvAqkC6QKpgSkBKQHpAikCIQIAACGWQAAGAOAAP4PAACQCHAJHgYQA/AEEAgQCIdZCAj4BA4DiAF4AAAERAREBEQERAT8DwAAiFkACPgMDgPoAhgEcAFEAUQJZAlcDMADAACSWQAI+AwOA+gDGAzwA0gASgBKAEgA+AAAAJNZCAj4BI4CyAE4AgAIaASoBT4CqAVoBAgIllkABPwEBwPEAjwAAAwiAqIBfgChASECIASZWQAA6AieBsgBOAIACDwEgAT+AgACjAEwAJ5ZEAjwBA4DiAN4AAgI4A9cCEQI/A9ACAAApVkAAEQIVAbEB2QGbAJEAmIF8gRKBEAIAACoWQgA+AkOBYgDcAQAAAgP+ABOCEgIyAcIAK5ZAAj4DA8D+AgADP4DEgDSB5IIkgheCAAGs1kAANAIPgUQA/gEAADUAwoI+A8IANgBCAK5WQAI+AgOBYgDeAAADEgCSAH+D0gBSAJIBLtZFAlcCVwLXAvcBX4FXAVcB1wFfAkUCQAAxlkACPgJDAb4BQAA/AdEBFQFVAxEDPwHQATJWQAA6AgfB8gBOAbAASQAJAD+DyQA5AMAAMpZCAj4CA4H6AEQBngARA/EAP4PRADEBwAAy1kAAOgNHgOIAXgCAACwD64EoASsBDAHQADQWQAA+AkOBugDEAj8DyQJJAkkCfwPAAgAANFZAAD4DA4DiAN4BAAAkA+QBP4EkASQDwAA01kAAOgIHgXIAzgAIAicCJAI/g+QCJAIAAjUWagIrAisC5wKzAb8BIwCmgWqBKoIqAgAANpZAAj4BA4D8AgMCYAE/gMAAP4HQAicCIQG3FmgCKwIrQquC6wGvASsBq4FrQSsCKQIAADlWRAI8AQeA5ADeAQAAagHfgkoCTgJKAUkAOhZAAj4DI4DcAQEAOwMrAL+AawCrAS8CQAI61kAAPQMjwLkARgA/g+SBJIEngeSBPIEAATsWQAI+AQPA+gBEAD+BwIE8gSeB5IE8gQCBPtZAAD4DA8D6AEQAv4PAgXiBLoFAgT+DwAA/1kAAKIIlArUC8AGpgSUBIwGlAWkCKwIAAABWgAO+AEIBNgFeALYAwgI/gQIA8oEKggABgNaAAj4CA4H+AQAACQJJAm+DyQJJAkgCQAABFrICMgIrgqYC9gG/gSYBpwFqgTqCMgIAAAHWgAI+AQOA8gBOAZQADQPHAAUADIPUgCAABhaAAj4BA4D+AYAAPwPVARWBNQBVAO8BIAEG1oAAPANHgP4AAQIcAlcB+QBZAN8BcAJAAkcWgAA+AyOA3gIAgb+AZII/gf8DwIA/gMAAB9aCAj4CA4F6AMYAMAPvAK0ArQKtAr8DwAAJVoACPgMDgP4AgAKlAj8DxIE/gKQBVYIAAYpWgAI+AgOBcgDOAj4CJQElgP0D5wI8AgABDFaCAj4CAwFiANwCAwJVAfUAVQDVAVcCQAJNFoAAPgMDgP4APIPBACgAfoHogACCP4HAAA2WoAIwgj+CtoL/gaiBsgGtAWUBKwIpAgAAEZaSAhqCQoLYAscBUwFXAUuBSwHXAlECQAASVoAAPgMDgP4AAAITAw0A0YA9AcUCPQJAARaWgAA6ASeAsgBMAC+B2oFagVOBZoHKQAoAGZaAADoCJwGyAEwBoQDvAD8D7wAvASgAwAAdFpAAF4JQgkyC44FAAVeBUIHMglOCQABAAB2WggE+ASPA3gCAAD0A1QB9gdUAVQB9AEAAHdaAADwCI8HfAyABXwAbAluD2wBfADEAQAAf1oAAPAMDgP8BAgAog/aAN4CagtqCuoPIgCSWgAE+AQOA/gCAACEBr4B7AesAb4ChAQAAJpaAAj4CI4HeAAAB/4Ayg+uCqoKqgruDwAAm1rICL4EiANwCAQOXAH0BdwG0gbaBVIIAACzWgAA8AkcBvABAAz8AVQJVgNVAVQF/A0AAL1aAADwCI8FfAIADP4Aqg6qAP4EqgGCDwAAwVrICL4EiAN4AgAAVAW0AnYJtAfUAFQDQATCWgAA+AwOA/gCAAq8CKwH/gSgBqwFvAgAAMla6AgcBcoDMAKIDPwDBAiVBvYBlAaUCAAAzFrICT4FiAN4CAAIXAX4D1gB+A9cA/gFSAjhWgAA+AgOBegDGADgDxwC9gVUBRwC9A8AAONaAADwCI8FfAIACPoBogm+A6oLqgmiBwAA6VoAAPgMDgPwBCQC/g/eD2QBcAyOA3gEAAgJWwAA+AgOB/AEBAB8D9wLXgtcC9wLfA8EAQxbAAD4BI8DfAIAAJYP/gPWBdYH/QCVDyQAUFsAAEAARABEAEQIRAjkB1QATABMAEQAQABUW4AAhAiECPQPTABEAAAA/AcACAAIAAgABlVbQAFCATIBLgkiCaIHagEuAWgBSAE4AQAAV1sAAIwAhACUCJQI1ge0ALQAlACEAIwAAABYWwABiADIDzgADAEoCSgJqAdoASgBCAEAAFlbgACECOQHXABEAAAB8AgACP4PAABwAIABXFsAAEIIQgjyD0oAJggwBG8EiAPIAjgECAhdWwAAkABUAVQBVAl+CVQH1AFcAVQBEgEQAV9bAAAAABAEkAeSBJIHugSWB5IEkAcABAAAY1uQAlQCVAK0CpQKvAeUA7ICUgJSApACAABkW4AAhAj0B0wAAA/8AAQO/AUEBvwIAgMADGZbAAA4AQoBLAEoCSoJrAdoASgBDgE4AQAAaVuECIQI9A9MAAAIKAW4BGoCLAOIBEgIAABrW4QARAj0D0wAxASUAuwApA+UANIEBAUAAHVbAAD8C3QH8AD8D/wBCAAkCaoPYgEqAQAAeFsAAOACPAK8ArwKsAq2BqADvAI8AuACAAB9WwIA+gK+Ar8CugrgCrAOtwP2ArYCNgIAAIFbAABYAEgASAhICMoHSABIAEgASABYAAAAg1sAABgACADoB4gIigiOCEgIKAgICBgGAACFWwAADAEkASQBpADmB5QIlAiUCIQInAYAAIdbAACcAIQAlAiUCPYHlACUAJQAhACcAAAAiFsAACwApAAkAyQAJggkCPQPJAAkACwAAACJWwAALAgkBeQFNAUmAiQDpAJkBCQMLAQAAItbAAhcDEQERAPEAPYPxABEAUQCRARcCAAEjFsAAJwIhAiUBJQDlQCWAJQHlAiECJwIgASPWwAALAQkA+QINAjmB2QEJAQkBSQGJAgIAJdbAACcBIQClAKUCJYPlACUAJQChAKcBAAAmFsAABwABAD0B1QFVgVUBVQFdAUEBxwAAACZWwAABgDyD5IEkgT7B5IEkgSSBPIPBgAAAJpbAAgcDIQDNAI0BPYPtAi0CLQIhAgcCAAAm1uAAIwIRAQ0A6QBRgDkByQIJAkkCewEAACcWwAAHAQEBPQHVAVVBVYFVAX0BwQEHAQAAJ1bAAAMCLQItAi0CPcPtAi0CrQKtAocCAAAnlsAABgJSAkICSgFCgPsAQgDCAUIBRgJAACfWwAADAlcCVwFXAP+AVwDXAVcBVwJHAkAAKBbAAgsDCQC5AE0BCYC7AcsCaQIpAgsBAAAoVsAAAwA5ANUAVQB9gdUAVQBVAHkAwwAAACiW4ACLAEkAaQPtAlWCVQJtAmUD4QBDAGAAKNbAAAcCAQI1A9UDVYNVA1UDdQPBAgcCAAApFsAAAwIhAqUCvQK1g9UCnQKdArECowIAACmWwAADAD0D1QJVAlWCXQPVAlUCdQJHAgAAKpbAADMCMQItASkA6YA9gCkB6QIpAiMCAAGq1sAABwABAd0BVQFVgVUBVQFdAUEBxwAAACuWwAAHAAEB3QFVAXWBVQFVAV0BQQHHAAAALBbAACMAIQC1AKUApYPlALUApQChAKMAAAAs1sAABwBRA9UC1QL9gtUC1QLVAtEDxwBAAG0WwAADAkECXQLdA32BXQFdAd0CQQJDAkAALVbAAAMCOwHLACkArYCpAKkCjQJ5A8MAAAAtlsAAFwFRAVcA7wKXgmcB5wAXAFEAhwEAAS5WwAALAIkAZQPRAkmCSQJRAmUDyQBDAIAAL1bAAAMCNwLXAh8BF4DXAR8CFwI3AscCAAGvlsAAAwJBAX0BVQFTgFMAcwFTAVEBQwJAAC/W4AATADkBxQABADWB1QFdAVUBVQF1AcAAMJbAABMA0QI9A9UAEYLFAh0BJQD1AQ0CAAIxFsAAIwAxAfUBbQFtgW0B9QA1AjED4wAAADFWwAIDAjkC7QGtAb2A7QCtAa0BuQLDAgAAMZbAAAMAaQHhATkBE4HpASUBEQEFA9kAAAAx1tACFQE1ANUANQHVggECHQLVAvUCFQIAATMWwAADACEB/wF3AXeB9wF3AX8BYQHDAAAANJbAACMBLwCvAH8BL4IvAr8CLwJvAKMBAAA01sAAIQP9AD0AvQC9gP0AvQC9Ab0BIQHAADbWwAIDAjEC9QL9AfWA9QD9AfUC8QLDAgAAN1bAAAsAQQB/APECX4IfAt8BXwFfAvMCQAI3lsAAAwK5Ar0CvQG9gP0AvQG9ArkCgwKAADfWwAATAlkBbQB9AmGD5QBpAPUAzQFnAgAAOFbAACMAIQF/AX8A/wD/gH8BfwH/AGMAoAA4lsACWwHRAH0DwQA9gn0C/QF9Af0CKwJAADlWwABXAlcCbwKnAt+B0QGvAR8BXwBDAEAAOZbAAAUCNQH/Af8A/4D/AP8B/wH3AcUCAAA51sAAAwBxANUA9QLagvsD2QDRAPUAwwDAADoW4AEtAK0CrQL9AK2DrQC9Aq0C7QKhAIAAOlbAAFMAWQP9AtUC3YPVAtUC/QLVA9EAQAB61sAAAQB9AT0AvQA5gLEAfQA9AX0BIQDAADsWwAIDAjEC9QH1AfWA8QD1AfUC8QPDAgAAO5bAACMCEQI1AP0CtYO1AL0AtQLRAiMCAAA9VsAAFQI9AfUAfQK1AcGAPQHdAt0C3QOAAT2WwAEFgjWB94H1gPHA+4D7gP+B+4HLggAAPhbAAAIACgAaACIAQgICAgICP8HCAAIAAgA+VsACCQMRAKEAXwCAALQABAJEAj/BxAAAAD6W6AAqACoAKgGqAS8AKgIqAjoB6gAqACgAPtbAAAAAUQBVANUA1QBVAlUCVQHfAEAAQAB/FsAAAABPAFUA1QFVAFUCVQJVAdcAUABAAH+WwAIKAxIAo4BaAYIBFAA0AEQCP4PEAAAAP9bQAREBVQDVAH0BV4BVAlUCdQHVAFEAQAAAVwAAKQEpAS/B6QEpAQAANAJEAj+BxAAAAACXAAAAgF+AVYFVgF/CVYJVgnWB34BAgEAAARcgAT+BKoC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/g8QAP4GkAVWDAAA6lwAAPgDAAL+AwAC+AfAAKYPkgiwCMYPiADtXPgDAAL+AwAC+AMAAO4PoAK+AqAK7AcAAPBcAAD4B/8HAAT8BwAAJAVXBdoPVgVSBRAE9lwAAAAO/ARcBVwHXgVcBVwFXAFcCUAHAAD7XAAA+AP+A/gDAAAoBYwFygKIAi4FaAQAAANdAADwA/4D8AMAAFQDxAD+B8QAVAFEAgAAB10ACXwFGAFYCVgJXA9YAVgBWAUYBXwJAAAOXfgHAAL+AwAC+AMAALQDrAKuCzQI9AcgABRdQAAsAOgPWAVYBV4F+AdYBVgFWAVcBQAEFl0ADP4DDAisCqwKrgrsDqwKrAqsCq4KCAgXXQAAAAD2DxQAVAZ2BtYHdAZ0BhQI9gcAACldAAAMDOwDqAnoDw4ACAjoB6gCqArsBwAALV0IAWsBWgHKB0oBSwECDPoDSgDGD0cAAABKXQAA8AP8A/ADDADsBgwB/A8MAWwCqgQABEtd/AMAAv4DAALwBf4Dyg+qCq4KqgruDwAATF0gAOwPKAUoBegPDgDIDCgCqAEoBqwIYABQXQAA5g8cANwJXAn+D1wNXA2MCPwHBggABmldEACWD/QA9AD0B/QF9gX0BfQH9AiWDxAAi10AAAAA8Af+A/AJ/ARcDV4DXAtcCUAHAAC6XSAAkwCqAqoEsgcHAP4FrgWuAa4F/wUACM1dIAl8C3gFeAV4Cw4A+ATYA/gD3AbQBvAC3V0ACAAM/AMAAAAAAAD4BwAAAAAAAPwPAADeXQAAcAgABv4BIAAAAP4HAABwAAAA/g8AAOFdAAhECMgHAAT4CAQLcAiMCSAK2AgECwAI4l0AAAAF+wWoA6oD/Q+oAaoDrgX9BQAFAADjXQAAAAn+BagFqgP8D6gBqAOsBfoFAAkAAOVdAAQEBAQEBAQEBPwHBAQEBAQEBAQABAAA5l0AAAgMCAPICHwISghICMgPSAhICEgICAjnXQQCBAL8AwQBAAEEAHwERAhECEQMxAMAAOhdAAAAAP4PkgSSBJIEkgSSBJIE8gUCBAAA6V0EAgQC/AEECQAE/AMEAHQABAD8DwAIAAbrXQAFhAR0BIQEBAT8BwQFhAR0BIQEBAUAAO5dgAioBKoDrgioCfgJqA+uCaoJqAmACAAA8V0AAAAA5AckCCQIJAgkCCQIJAh8CAAHAAHyXQAA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dAbUBQYIVAr0C1QKVAoAALVeAAz8AwQAVAD0B9YC1AfUCtQK9AtUCFQEtl4ADvwBBAQkByQA9A6mAKQO9AAkAiQMAAC3XgAG/gECBKoCqguqCPsHqgKqBvoFIgkAALheAA78AQQA9A/0A/QD9g/0A/QL9AukDwQAwV4ADPwDBAj8B6wGrAL+CwQA9AsECPQHAADDXgAM/AMECEwF/ANOAUQB3AdsCWQJFAUAAMleAAz8AwQIdAV0A/QPdgH0D3QD9AVUCAAAyl4ADPwDBAj0D7QItAb2DAQA/A8MAPwHAADTXgAM/AMEAPQLvAu8D/YDBAD8DwwE/AMAANZeAAT+A4IAlgiOBmYHvwZiBW4FRgKeAIIA314AB/wABAL0A7QDtAe2A/YHBAb8AawE/APgXgAM/AMMAOQPvAKmC+4PRAj0BSQD5AwAAOJeAAz8A0QALAusCn4ERANsBfQHtAkUAAAA414ABv4BAgjqBfoF+wX7AfoB+gPqA+oFIgTzXgAAgA98AAQLfA/+DyQEdA10CXQDdAUAAPZeBAi0BKwDZAQABfQJBAkECfwJJAkiCSAJ916ECDQHrAVECAAKJAokCvwLJAoiCiAKAAD6XgIIcgwuA+IECAWqCaoJ/wuqCaoJvgkICf9eAAAQABAA/g8QBBAEEAQQBP4PEAAQAAAAAF9ACEQIRAb8AUQARABEAEQA/A9EAEQAQAABX5AIkAiQBMwDiwCIAIgAigDqD4wAiACQAAJfAAAACR4FqgMqASoBKgEqAaoPLgEgAQABA18ECSQJJAW0AywBJgEkASwBvA8kAUQBBAEEX0AJVAlUBVQDVAF8AVQBVAFUD1QBVAFAAQpfAAl6CTgFPgN4AXoBEAEsAbYPNAFMAQQBD18ICEgESATIB0gESAQIAn4AiAMKBAoICAYTXwAAAADyAJIAkgCSAJIIkgiSCJ4HgAAAABVfAADEAKQIpAikCLwHAAAAAAAA/A8AAAAAF18AAIgI6AioBvwBqACoAPwPqACoBLgDAAAYXwAB5AikCKQIvAcAAAAH+AQEBIAEAAcACBtf8giSCB4HQAD8ByAIEAj/CRAICAn4CAAGH18AAAAEyASqAqwCqAH4D6gArASqBLgDAAAgXwAA8giSCJ4HAABACP4PQATQBEgBRgZACCVfBAHkCKQIvAigBxADzAgICPgPCADIAAgD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iAAACqIJcgQqA+YIIg7gAQAAbWKIAIgI/weIAEAIAghCDv4JQghCDv4JAAhuYggBiAj+D4gAIAhQBE4DwABCCE4I8AdgAG9imACYCP4PWAAACPgPAAgACP8PIAggCCAIcGKIAIgI/g+IAEAIEATQAz4AkAcWCBAIEAZxYogAiAj+D0gAAAf8AMQEBAU8A5AEcAgAAHNiiACIDP4DiAgADvwBZASkBSQCpAVkCAAIdmKAAIgI/g9IAAAISARIA/4ASANIBEgIAAB5YogAiAj+D4gAAAD+DyAEAAD+ByAIGAgQBnxiAAGIDPwDiAgADPwDBAD0BxQIFAn0CAAEfmKIAIgI/g9IAAAIEAQ+AtADEgXUCBQIEAZ/YgAAEAQQA/QABAqkCvQHrAIMAuQAIAMQBIBiiACICP4PSAAACGgEqAU+AigF6AQoCAAAhGKIAIgI/g9IAAAIeAgABP4EAAKMAVAAAACKYoAAiAj+B0gAAAD8B0QIRAh8CEQIRAj8CJFigACICP4HAAD8BwICAgD8DwQABAT8AwAAkmKIAIgI/w9IAAAAIggqCOoPNgCmAGIAAACTYoAAiAj+D0gAAA78AQQA/A8CAP4AAg8ACJViiACICP4HSAAACN4EQgVCAt4FUAgICAAAlmKIAIgI/g9IAEgAAAEiAUwBAAH+D4AAgACXYgAAiACICP4HSAAADOgDLgAoAOgHCAgABphiiACICP4HSAAADv4BIgAiACIA4g8iACIAmmKAAIgI/g9IAEAIBASkA3wA5AckCCQIIASbYgAAiAj+B0gAAA//APgHAAn4CA4K+AkABJxiiACICP4PSAAADIgDfgioBSgC6AUoCAgInmIICYgI/g+IAAAM/ANEAEQAxAFEAnwMAAigYogAiAj+D0gAAAD8DwQIFAvkCLQJBAoACKFigACICP4PSAAAANgHhAiCCEQICAgwBiAAomKIAIgI/g9IAEAAEADIBycIJQnICBAGEACkYogAiAj+B0gAAAz4A0gASgBKAEgA+AAAAKViiAiICP4PSAAAAP4PIgDyDDIDMgXuBAAIq2IIAYgM/gOICAAO+AHIBX4GSAXIBFgIAACsYoAAiAj+D0gAAACwD6wEogSgBKQEmA8gALFikACQCPwHUAAAALAHrgioCOgJCAn4CAAGtWKIAIgI/g9IAAAA/A8kBCIAPgziByIIIAa5YogAiAj+D4gAQAQIAkgB/g/IAEgDSAQAALxigACICP4HiAAAAPwBpACkAPwPpACkAPwBvWKIAIgI/gcIAOAPkASQBP4HkASQBPAPAADCYgAAkAj8B0AA6AyoAv4BqAD+D6gAuAcAAMRiiACICP4PiAAIAIAIiAiKCPoPiAiICAgIxWKIAIgI/g9IAAAI/AkkCSQJJAkkCfwJAAjGYogAiAj+B4gAAAz8AyIAogDiDyIBIgIAAMdigACICP4HSAAAAP4DIgKqCiIKIgb+AyACyWKAAIgI/g9IAAAEKATIBQoECAfoBAgEAADLYgAAiAj+B0gAAA/+AMgHAAn+CggK+AkABMxiCAGICP4HiAACACwBIAH+DyABLAEiAQAAzWIIAYgI/geIAAAA+A+IBI4EigSIBPgPAADQYogAiAj8B0gAAAi8BKQCpAGkCKQIvAcAANJiiABICP8PSAAAAP4PkgSSBJIEkgTyBAIE02KIAIgI/g9IAAgBgADkD1wERAREBMQPAADUYogAiAj+D0gAAAyIA34IqAUqAqoFaggICNZigACICP4HiAAgAJAAzgdICOgLSAjoCwgI12IAAIgI/g8AADgD5gIwCxAF8AMeCPAHAADYYoAAiAj+D0AAEADIAy4BKAHoCQgI+AcAANligACICP4HSAAAALwHIAT+ByAEIAS8DwAA2mIAARgJ/geYAAAImATUA5IAkADUD5gAoADbYoAAiAj/B0gAAACiD5oEhgSiBKIEngcAANxiAACUDJQC/AGSAAMAKAEqAf4PKgEqAQAB3WKIAIgI/gdIAEABFAFUAfwPVAFUAQQBAADfYoAAiAj+D0gAAAT+AwABvAwAAsABPgEADuBigABICP4HYAD+DIgDcAT8CQQI/AsACoAJ4WKIAIgI/g9IAAAO+AEIBIgHbgQIBQgFCA7iYoAAiAj/D4gAAA6QAX4MEATyB5QIVAgQBONigACQCPwHkAAABOgCuAqsCOgPiACIAggE5WKAAIgI/gdIAAAM/gOSAJIA/g+SAJII/gfmYoAAiAj+B4gAAASSBJYEkASYBJYEEAQAAOdiCAGICP4PiACAABgASAhICMoPSABYAAAA6GKAAIgI/geIAAACHAnQBH4FUALUBVQIEAjpYogAiAj+D0gAAAKkApwC1A+cAqQCJAIAAOxigABICP4PSAAAAJIPkgj+CJIIkgiRDxAA7WKAAIgI/g9IAAAEUATQBxAE/AEQBhQMAADvYoAAiAj/D0gAAAnSCCIK+gsmCNIIEgkAAPFigACICP4PSAAACIgE/gKIAIgA/gKIBIAI82KgAKgCagJsC3gL7gcoAygDbgKoAqAAAAD0YgABiAj+B4gAIAgYCSQJ4g8kCQgJMAgAAPdiAAEQCfwHkAAAACgBqAP8CqgKuAqoBiQA/GIAAQgJ/gfIAAAIiQT6A4gAiAD8D4sAgAD+YogAiAj+B0gAAACYD4QEogSiBKQEiAcwAP9iCAHIAfgB/AX6BfoD+gH8AfgB+AGIAQgBAWOQAJAI/AdQAAAAqAKoArwIqAjoB6gAIAACY4AAiAj+D0gAAAgkCSQJvg8kCSQJIAkAAAdjiABICP4PSAAAAN4HZAVkBWQFYgXiBxgACWMIAQgN/gMICEAIXAjEBXcGRAPEBFwIAAAOYwABEAn8B9AAAACoArgDrAqoCrgKqAagABFjgACICP4PSAAACYgE/gMAAP4HQAicCIQGFmOAAEgI/g9AAAQAVARUC0YJ1AhUCAQGAAAZY4gCSgIsArgKqgrsB6gCiAI+AkoCSAIAABpjAAAUAtQD/gOUC4AHtAOeA4QDPANAAyACH2MAAQgJ/gfIAAAIqAiIBv4BiAOoBIgIAAAgYwAAiAj+B0gAAAikBKYDvAC0D8wIrAiABCFjiAGICP4HSAAABC4FIAU+BSAFKAXmDwAAI2OAAIgI/g9IABAAWAlWCfQHXAFUAfABQAAkYwAAiAj+B0gAAAhEBEwDNgAkAFwPRABEACVjAACICP8HAACWAtICsgKaAtIPkgKWAgACKGOAAIgI/gdIAEAJLAUrA+gDKgMuBSgJAAgqYwAAiAz/AwAIkgb+AZII/gf8DwIA/gMAACtjgACICP4HSAAgCBwJYAn+DyAJHAkgCUAAL2OAAIgM/wOICAAO/gHCD1IE0gVSAVIOAAg6YwAAiAj/D0gAAgw+A+IEAAgiCf4JIgkiCT1jgACICP4HQAAQCPgIlASWAvQBnAeUCPAIQmNIAEgI/g8oACAAqge+BKoEqgS6BKIHIgBFY4AAiAj8B0gA4A+kArQC9A+sAqwK5AcAAEZjgACICP8HAAD+DwIEUgT6BVIEAgT+DwAASWOAAIgI/g9IAAAMvAMkBOQPpAikCLwIAAhMYwAAiAz+AwAIvAakAbwIAAf4AQAI/gcAAE1jiACICP4PSAAAAX4BagFqAeoPagF+AQABTmMIAQgJ/geIAAAA4g+sAqACvAKgCuwPAABPY4gASAj+D0gAAAS+BKoEqgeqBKoEvgQABFBjiACICP4HSAAAAO4PqgKqAqoKqgruDwAAVWMIAYgI/geIAAAA6A+oAqgC/g+oAqwK7AdcY4gASAz+AwAIvASsBawG/gSsBqwFvAgABF5jgACICP4PSAAACJQElgLUAZQIlgw0AwAAX2OAAIgI/gdIAAAI4AkuBCoCqgEqBC4I4AthY4AAiAj+D4gAIASYBSQEogUkBAgH0AQAAGJjiAz+A0AIEAj4BJQClgH0AZwClAT0BIAIY2MAAQgJ/geIAAAG/ASEBpYEhAa8CIAHAABnY4AASAj/B0gAAABqAr4Cqw+qAuoCqgIAAGhjiACICP4HSAAQAEwHUgV6BVIFRAVIB1AAbmNAAEgI/g9IAAAH/gAyB7IE8gSyBL4HAAByYwABEAn8D5AABALUB3AJXA1QDVQO1AhAA3ZjAACICP4HCABACfQJVAn8D1QJ8glQAQAAd2OAAIgM/wNICAIIqgaqBKoE/w+qCvoKIgh6YwABEAn8BxAAQAQoARgJTA9YASgBSA1AAHtjgACICP4PSABABwgAJAcqCCIJZAgoAwgEgGMAAIgI/gcAAPwPFAD0DwAAFA7qAQgGOAiCY8AARAb/AQAM/gMCAIIPggT7BJIEkg8CAINjgABECP8HBABgALUHtQD1D7UAvwTgAwAAiGOAAIgI/gfIAGAIaAikBKoHogS6BmoFAAiJY4gI/gdIAAAC+AKoAqgCrg+sAqwC/AIEAoxjAAAcAs0C/wL8Cv4H/AL8Av8CjQKcAgAAj2MAAQgJ/gcYAIwCqgLoA6gCqAqICPgHAACQY4gAiAj+D0gAAADQD0gFBgVEBFwFxA8AAJJjiACICP4PSABAAAgBKAHWDvwHKAEoAQAAlmMAAIgI/geIAAAA5A8UAMYIdAWkA+QEJAiYY4AAiAj+BwAA/g8KAOoOigjqD4oI7g4AAJljAAEICf4HiAAAAqwKpArqB6ICqgLqA4AAm2OAAJAI/AcAACgFvgcoBQAA/A9AAMAAAACgY4AAiAj+D4gAAAT0ApQIlgeUAJQC9AIEBKFjgACICP4HSAAABJQChAHUD4IBsgKKBAAAomMAAQgJ/gfAAAwEpAKUAcQPlAGkAqwEAAClY4AAiAj+B0gAAAikCqwLpgSkBrQFpAigAKdjAAGICP4PSAAMCKQIlAiGD5QIpAgMCAAAqGNIAEgI/g9AADAA/A+qBKgE/geoBKgEAASpY4AAkAj8B1AAAADoA7gCrALqB6gKuAroC6pjiABICP4PSAAAANQHXgVUBVQFXgXUBwAAsGMAAJQI/AeyADgG5gH8AxAIkgj+B5IAgACyYwgBCAn+BwgAAAG+A+oFqgSqAqoIvgcAALdjAACICP4HSAACDvgBTgcAAP4PAgD+AwAAuGMAARgJ/geYAAAC8ANSA1QD8A9cA1ID8AO6YwAAiAj+B0gAQABYCrwKWgkYBTwEWAKQAMljgACICPwHSAAACXQFHANcD3wDFAU0CRAAzWOAAEgI/g8oAAAIXAl8BdwDXgF8BVwFXAjPY0AARAT/AyQAAAD0D5QElwT0B5QElwT0D9BjAAEICf4HiAAADL4CqgSqD6oKqgq+CoAI0mMAAEQE/wNEAAAA6g+qBAoE/gcJBOkPAADWY4gAiAj+B0gAAATsB2wFbAVsBWwF7A8gAtpjBAGEDP8HxAAABt8DVQlVBVUDVQlfBwAA22OAAIgI/geIAAgIeAk2BZQDPANQBXAJAAjhYwAAkA78AQAM/AM0CLQK9Aq0D7QKvAoACONjAACICP4HQAAcD7AAsA/+ALAPsAC8DwAA6WOAAIgI/g9IAAAA/gdoBUAFfgVoBeQHFADqY0AAiAj+B0AAEgH+D0IAGgwAA/4AAAM4DO1jAAEICf4HiAAAAP4G6gSqBaoIqgi+BwAA7mMgAEgI/gdIAAAC+gK6AroC+g+6AroC+gL0Y4AAiAj+D4gAAgRWAvIJ1gbSBNkHVQhACPpjiACICP4HSADAAIwOpASsBOwHogSyBKoO/WMAAIgM/wNACB4IwAteCEAHVgjUCwQIAAQAZIAAiAj+B0AAEAC4BHYENAV8CbQKsACAAAFkAABICP4HAADyD0IAWAeqAtoCAgv+BwAAAmRAAIgI/g9IAAAIqgqYC94EmAaqBaoIgAAFZAAAiAj+B0AAGgj8BTgEugc4CO4JCggABg1kiACICP4PSAAACOwF7APsAewB7AXsCQAID2SAAFAI/AeQAAAAeAN4A3gBfgl4CXwHeAETZIAAiAz+A0gIAAzVA1YIfAlUD1cJVAkAABRkgACICP4HSAAAAKYJWglSCdYPWg1WD9IPFmQAAAgJ/geIAAACVArECqYKng+MCoQKAAAcZIgI/gdIAAAIvAi0CaAG/gSgBrQJvAgACB5kgACECP8HJACAD1oAWgdbBVoHWgDCDwAAKmTAAEgI/gdIAAAH/AB0BnUF9gV0BXQHFAAsZAAAEA78AYAM+AN+CfgHAADeDUICngUgCC1kAACICP4HSABAAG4HVgVcBWQFTgdEAAQANmRAAEgI/A8gAJAPaAB4B3QFcgV0BWgHEAA6ZAABBA3/B4QADAj/BasDqgH/BasDqg6CAERkAACIDPwDKAiABLwGvAG8BbwGvAakCQAARmSAAIgI/gdAABwFVA1cC9QJXAVUBVwJAABHZIAAiAj+B0gAAAasBKQE6geiBKoEqg4AAEpkAABICP4POALIATgBMAD+D6gE/gesBAAEVGQAAIgI/geAAIgCBAK0Au4OxAIEArQCgABYZIAAiAj+BwgA4A8UAFwH9gVcBxQI9AcAAGdkAABICP4PSABMAOgHaAVuBegHaAVsBQAAaWQADPwDBAC0A7QLtguEB7QDtAN0A3QDVAJ4ZIAASAj+D0gAAAl0CXYH9AF0A3YFdAkECXlkAAFEA3wD/AN+C/wL/A9+AvwCfANEAwABg2QAAvwD/AP+C/wLvAfYA9YDUgN2A1QCgAKHZAAAiAf+APAPXgD8B3AA9Ac6BsUBPAYABJBkkACQCPwHkAAYCPwL2AbeBtgC/g+YAgACkWSAAJAI/AcAAJgD/AvYC9wH2AP8AxgDAACSZIgI/gdIABAA9A++ArQK/g8QCO4GiAN4DJVkAACQCPwHAAD8DVgB/AUAAPgPJADkDyQAnmRICP4HWAAACPQK9Ar0CvYP9Ar0CvQKEAikZEAARAz/BwAA8g+/AtoPEAg4BMcDfAwAAKVkAAAICfwHCACgC7wK5A5ACygF/AeoCQAAqWSAAIQE/wNEAAAE+gFWCVMPVgH6ATIMAACrZAABkAj8B1AAAA38ASoB6A0oAegNKAHoDaxkAACICP4HSAACA9YPHgM2AK4DrQcoCwAKrWSAAIgI/gdYANQAVAe8BbwHlAW6BdIHkACuZIAAhA7/AWAE4Ae/BrUG9Q91BHUD/wVgBLBkAACICP4HoABOCfYFVgVAAU4F9gVWBUAJsmRAAEgI/g9IAAIJeAVuA+gBbgN4BWoJAAi1ZAAAiAj+B4gAAARcBd4FQA9cBU4FXAUAALxkAABIB/4AAA78ASwB3AesA38CpAMVBAADv2QAAIgI/gcIAOgMtAL0BBIA8gy0AuQECAjBZEAASAj+BwAAtAxkAwQA+gdUBfwHVAUABMJkAACICP4HCACcB8wFnAW8B5wFzAWYBwAAxWQAAIgI/gdAAHwEzAf8B/4H/AfMB3wEAATHZAAASAj+ByAAvgL6Ar4Cug++AvoCvgIAAMpkQAT8BPwH/gf8DvgPkAfuBqIG5gaoBAgBy2SAAEgI/gdIAAAAmgf8BdgF3gfYBf4FigfNZAAAkAz8AxAIwAW8BfQDlA/0A7wF4AkAAM5kFAA8Ar4DuAPOC7wLhA+oA7YDlAMsA0QC0mQAAYgI/geIAAgOxAGSB9oF8gO0CcQPAADUZIAAiAj+D0gAGA74Aa4MvA/MD7wPyA8AANpkgABICP4PAAT4AxgA2AX+A3wPbAFsBgAE4GQAAIgI/gcIAGAM1APkAr4CvAK8AuwPBADmZAAACA3+AwgJLAmUAdQJvg+0AfQBHA0AAOxkAACICPwHAABeDdQDVAwAAywE9A88CWQI9GSAAIgO/gEADPwDRAj0C/QL9gP0C9QLAAD6ZAAAiAz+A8AIdgfKDO4HCgBuBqoKrgoAAP5kAAGICP4HCADCCH4K3gdeB14H/gvCCgAIAGVUAMwCXgJMA+AL5gvUB8IDSANeAswCVAAPZQAAmAz+AwAI6AdmAvQPAADeB9QL9AoAABJliAj+B0gADAjeC14IXAZMAV4EXgisCyAAFGUAAIgI/gcAAP4H9gR+A/AH7gP2CP4HAAAYZQAAiAj+B0gE+APsD/wJxgH8B+wF/AkAABxlQAAkBP8DIACLD34B+gJ7BvoBegT7ByAAHWUAAJAI/AdQAMQD/AL8DzwA/AP8A+QHIAIkZQAAAABICP4P/gv0B/4O9A+uBPoHqAQAAC9lCAgoBGgEqAQoAz4CKAOoBGgEKAQICAAANmUAAPwDAAEAAf4PAAAwBG4EiAPoAhgECAg5ZQAA5AEkAiQBfAVgDDAEzgIIAegCGAQICDtlBAEEAfwBBAlkCRAEbgKIA4gCeAQICAAAPmUACAgG+AEqCMgHIAAQDO4CiAN4BAgIAAA/ZQQE9AMEAvwDJAJkCDAE7gIIA+gEGAgACEVlCADID0gEfgTID2AIPATKAogDeAQICAAASGUICKgEigKMAygEQAAwDM4CiAN4BAgIAABMZQAAkg+SBP4EkgSCDyAAFAzqAogDeAQICE9lQAD4AVYB9AVUBfQDYAkeBOUCxAM8BAQIUWUIAmgJCAn+D8gACglgCH4EiQPoAhgMAABWZQAEVALUAf4E1ATUA0AAfgaIAWgCGAYABFdlAAj8BVQFVAH8BWAAOAzMAogDeAQICAAAWGVQAlgJVAjyB0QAZAswCO4ECAPoBBgIAAhZZQACVAJUCd4P9AFYCTYIfASLA8gCOAwICFtlAADQBRgE1AQWA4gIMARuAogBeAIIDAAAXWUAAPYP0AH+D9AB9g8ACD4EyQPoBBgIAABeZQAA7g/gAX4CoAnuD0AIfgSIA+gEGAgAAGJlAAAIAvoDqgKqAv4PAAAwDO4CiAN4BAgIY2UAAOoPrwKqAq8KygcgABoMdQLEAzwEBAhmZQgC+ArYCtwO2AN4CmAI/gQIA/gECAgAAGxlRAD0A1YB1AkWDPQDMAhuBogB6AIYDAAIcGWgCKoKmAf+BJgHigggCD4EyQOIAngECAhyZQAA9A/0A/YCdAn0BwAA4Aw+AygD6AwACHRlQABcCDwIvg68CNwP2Aq2CrQKTAhECAAAdWUAAPoPDgP7Ag4J+gcQAD8MxAN8BgQIAAB3ZQAEvwKrAf8FqwW/A5gIPwTCA3ICDgwCBHhlCAl8C3wL/gV8BXwLYAkwBO4DeAQICAAAg2UAAF0JfgX/B1QDXgFoAOYDVgVcBWQFQASHZQAACAgICBgEaASIAgoBiAJoBBgECAgICIllIgQSDNIDVgFaAUsBSgFWAVYB0gcSABIAi2VkAGQPZAFUAVwP1gFUAVwPZAFkCWQHYACMZQgIaASOA3wCAAjUD/QHEAD+AxAEFg4AAI5lJAgkD6QAHAJUCVYPVAEsBSQApA8kAAAAkGWkCKwIrASsBZ4GwAKAAr4GrAWsCKwIoAiRZQAAJAT8AwAIKAbKATgCAAhECPwPRAgACJdlAAIQAiQBJAFIAQgBAAH+DwABgACAAAAAmWUMAKAD/g+gAKwAAAIkAUgBAAH+DwABAAGcZQAEWANUCPIPVAAEAyAAbAEAAf4PgAAAAJ9lQADIA3wF+AT4BXwFAAQoAIAA/weAAAAApGUAAAAO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rAL8BAQEAAB+Z4gBSAD/B0gAgAQ4BIYHYAQBBI4FMAYAAH9nCAOIAP4PiAAADPwDZAikBSQGpAVkCAAAgWeIA0gA/g9IAAAMhAN8CIQFNAIsBeAIAAiEZ4gBSAD+D0gAAACcAWoBCAnICQgM+AMAAIlniANIAP4PSACIAAAIRAhECPwPRAhECEQIkGeIA0gA/w9IAIgAAAz8AyIAIgDiDyIAIACVZ4gDSAD+D2gAgAg4BIgDfgDoBwgIOAgABpdnAACIAUgA/w8oACgCgAFIAP8PaACIAwABmmeIA0gA/w9IAKAIEARuBIgDyAI4BAgIAACcZwAAgAS+BKoCqgGqAf4PqgGqAr4EgAQAAJ1niAFIAP8PSACICCAEqAQoBT4CKAXoBAgInmeAAUgA/wdIAAAH/gAABIADfgCAAwAEAACgZ4gDSAD+D0gAAAEkARwBBgGEDzwBIAEQAaJniANIAP4PSAAAAPwPBAgUC+QItAkECgAIo2cAAAQBtACUBFQEfglUClQKlAq0AAQBAACqZ4gDSAD/D0AAEADIByQIIwkkCcgIEAYQAKtngAFIAP4PKABAD/wABAb0AQQC/AcADAAAr2eIAUgA/g9IAEAAEA+QBP4EkASQBJAHEAC2ZwAApAiUBI4ChAHcD4ABvAKkAqQEvAQABLdngAFIAP4PSAAADv4BCAzwA/wPBAT8DwAAxGeAAUgA/g8oAAAA9A8UAJQBfACUCRQI9AfPZwgBiAD+D0gAAAD4D4gEjgSKBIgE+A8AANBnAACEBIQEvgKsAewHrACsAb4ChASEBAAA0WcIAYgA/g9IAAAA/g+IBIgEiAT+DwgAAADSZwQJZQkRBRIDBAPEDx8DJAMkBSQJFAkAANNniASqBKoCgAKkAbQPjgGEAvwCwATABLAE1GcACVAJVAU0A3wD3A90AxwDFAU0CRAJAADYZ4gBSAD+DygAKAGAAPQPTAREBEQExA8EANxnCAOIAP4PSAAAAPwPJAkkCSQJJAnkCQQI4GcIA4gA/g9IAAAAWABICEoIzA9IAFgAAADlZwAASAgoCKgPWA1cDUgNWA2oDygISAgAAOxnAAAECPQEtAKUAf4PlAG0ApQE9AQECAAA72eIA0gA/g9IAAAA9AMUAfQJBAj8BwQAAADxZwAAiANIAP8PyAAICQAIigj6D4wIiAgICPNngANIAP4PAAD8CQIF+gIAAPwPBAD8AwAA9GegBL4EoAK/AqQBgA+fAaQCpAKkBKIEkAT7ZwAAJAgUCNQPrAquCqQKrArUDxQIJAgAAP9niAFIAP4PSAAAAOgDKAAqAPwPKAAoAugBA2iIAUgA/w9IAAAP/AAUDvQBUghSCNIHAAAEaAAEUARcAlAB0gDUD9AAUAFYAlQCUAQABAVoAAOIAP4PAAT+A0II/gdAAP4HQgD+D0AAB2iIAUgA/g9IAIgEIAKkCSQI5A8kAKQBIAYIaIgBSAD+DygAQAgQBFAEfgTIAyoFqgigBgtokANQAP8PUAAEBnwBRwjkD0QARAMEBAAAD2iIAUgA/g9IAEAEEgSWBJAEmASWBBAEAAARaAADiAD+D0gAAAbkARwDQADQCRAI/gcQABNoiANIAP4PQAAQCAgJJAniDyQJCAkwCAAAFmiIAUgA/g9oAPoPigV+BAoEfgSKBPoPAAAXaAQJdAlUBVQFfAPUD1QBfANUBVQFdAkECSFoiAFIAP8PSAAICGAEGATYAg4ByAIoBEgIKmiIA0gA/g9oAIAEEAROA8gA/g/IAUgCQAQ3aAgBiAD+D0gAAAFKAUoB+A9IAU4BCAEAADhoiAFIAP8PSACICCAEaAWYBE4CKAOoBIgIOWiIA0gA/w9IAAAA/g9SCNIIUgFSBn4FAAk8aMQBJAD/DwQATADkD2cEWwRaBGYE4gdAAD1oEARUAlQB3g9UAVQJEAT+AhAD0gQUCAAGPmhACGQJFAUEBTwDBg9EATwDBAUUBSQJAAhCaIgDSAD+D0gAAAgkCSQJvg8kCSQJIAkAAENogANIAP4PQAAMCYAE/gMAAP4HQAicCAQFRWiIA0gA/g8IACAO+AGWB1QIXArQCRAIAARGaIgDSAD+DygAQAD8DwQIVAr0C1QKVAoACEhoAACUCZQFtAVUA1YPVAF0A5QFlAUUCQAITGgAAAAJeAVYBVgD3g9cAVwDXAV8BQQJAABQaAgDiAD+DwAA/A8EANQDVALUAwQI/AcAAFFokAmYBV4FfgMWAYYPVgFaA1oFsAWACQAAU2jEASQA/w8kAAAE/QUlBSUFJQUlBf0FAQBcaIgDSAD/D0gAyghCCMQFcQZWAkAF3ARCCGNoiANIAP8PSAACBCwFIAU/BSAFKAXmDwAAZWiIAUgA/g8oAIAIVAQ0AxwAFAAyD1IAgABmaIgBSAD+D0gAAAF8AQIBkA8+AUgBRgEkAGhooASUBJACvgKAAagPpgGWApQCjASEBAAAaWjEASQA/wcUAAAO/AEEBCUE9QckBCQEAAB2aIABSAD+BwgA4g9SAVoB+g9WAVIJ8gcAAH9oiAFIAP4HSAAAAX4BagFqAeoHagF+AQABgWhMCWAJEgVYA0IDMg8OAUIDQgU+BQwJMAmFaBABkAD8D5AAoATYA6wCqALoC6gK6AeAAoZoAAOIAP4PSAAACSgN/gMAAPwPBAD8AwAAk2gIA4gA/g9IAAAAVAFEAcYPdAFEAUQBAACXaIgDSAD+DwAA/AisBqwG/AWsCKwI/AgAAJ1oAAAgAPwPAgD4AwAAqAauAJQPtACsAqQEomiEAUQA/g8kAAQA8QdWAVABXgFQBfYHAACmaAAAEgmKBF8ERgVqAkgCSgHfAEYACgAQAKdoiAFIAP4HKAAgAKoHvgSqBKoEugSiBwAAqGhACCoJGgV+BRkDqg8AAR4DQAVABX8JAAmtaIADSAD+D0gAQApYCR4FygaYBp4JqAgACK9oiAFIAP4PSAAABOoErAL4D6gArgS4AwAAsGgAA4gA/w9IAIAM6AOIAOgP/gQIB+oIIASzaIABSAD+D0gAAAy0AywApw8kALQPIAQAALVoAAA0CAwE3gNMAVQBQAJMAN4HDAgUCCQGtmiIA0gA/w9IAAAP/gAKAqoC6gdKCU4JAATAaAgBiAD+D0AAEAUIBSQEogQMBpAFUAQAAMRoRAlUBdQFzAPMAe4PzAHMA8wDzAVUBVQJyWiEA0QA/w8kAEAAngeqAKoA6w+qAL4EgAPLaIgBSAD+D2gAQAkIBf4FWAFYAf4BCA0AAM1okANQAP4PUAAAAPwPVAlUANQHfAkABQAA0miIAUgA/g9IAAAAbAI8Aq4PrAI8AmwCoADVaIQBRAD/D2QATAZEAVQE1wdUAEQBTAIAANhoAAD0DBQC/g8UAfQIYAQUAv4PFAL0DAAA2miAA0gA/g8ABP4Dkgj+BwAM/gOSCP4HAADfaIgBSAD/D0gAAAT8BKwCrAH+D6wBrAL8BOBoAAgYCQoFfAVYA94PWANYA34FCgUYCQAA42gIA4gA/g9IAIAIFAZUAP4PVABUBXwFEAjuaAAApASUAtQPjAKMBD4EjALUD5QBpAKABPFogANIAP4PSABACjQJ1AbeBJQGtAkUCAAA9WgAAMQBJAD/DyQAAAPfAPUH/wfVAF8DQAL6aIgBSAD+B0AAHAD8B/QHVgVUBWQFDAcAAAVpiANIAP4PCAAgALQHrAKuCywI5AcgAAAADWnIACgA/wcIAOAPBAT8BVwFXgVcBfwFBAQOaYgBSAD+DwAAMAD8D6oEqAT+B6gEqAQAABJpgAFIAP4PCAAgDf4DKAiACRwE5AN0BgwIHGmQA1AA/g8QAPAJOAk0BfIDNAM4BfgJEAgtaQAAkAD/DwAA/g8SAO4BAAD4D68C6A8AADBpgANIAP4PAAD8A1QC/A8AAP4PAgD+AwAAP2mAAVAA/AcAAKgA+A94BXgFfAX4D3gAgABKaRADkAD8D5AAAAj8B9QB1AXUA9QJ/AcAAFNpgAFIAP4DAAz+A0IAqgT6B6oEQgT+AwAMVGmAAUgA/g8AACwJfgkMB6ADHgVCCT4JAABaaQAAVAhMBl4DVATAD1QJTAleCUwI1AgACF5pAAOIAP4PQAAcCFQE3ANUAVwJVAlcB0AAY2nAASQA/w8UAIADfwDlD1UFVwVVBfUPBwBtaQgJagVsBXgDbgHoD2gBfgNsBWoFCAkAAHVpiANIAP8PCADiCaII7gj6C0IIkglyCgAAd2mAAUgA/g9IAAAAvA+oCoAKvgqkCqQPFAB8aYABSAD+DygAiAiqCpgH3gSYBqoFqggAAH1pAACkBKQEgAL8AdYH1AH8AYACrASiBAAAgmkAA4gA/g8AAPwHVAJ8CSAExAN8D0QIRASEaQADiAD/D0AAHgjACV4EQANOBtQLBAgABIZpgAFIAP4PCADwB7gC9A8WANYDBAjoBwgAlGkAA4gA/w8AAPwHVgJ8BwAA/A8EAPwDAACVaYgDSAD+DygADAGUD0QJJglECZQPLAMAAJtpgAFIAP4PKACACOwFvAOuD6wDbAUkBQAAnGmIAUgA/g8IAEAIXAbcAVYJVAlUCVQHAACoacQBJAD/DyAAggBKACYA9w+iAqoCqgIAAK5pAATiBOwErgKiAKAPsgCoAqYCqASiBAAAtGkAA4gA/g/IAAAAvA+iCpAKpA+cCoQKvA/LaQAAyAMoAP8PAAD8D74CvAL8A74K/AcQAs1pyAAoAP8HKAAIBugBfAd7BXwFdAV0BwAA0GmAAUgA/g8IAHwAVAhWB/wA1AdUCXwLAAjYaQgDiAD+D4gAAARWBVQA/A9UAlYFVAUAAP1piANIAP4PSAB6ANoP/wraCv8K2gr6DwAAAmrABOwE2gLAArwA1gfWAPwCiAL2BOAEAAAKaiQIFAl/CRQFUAVKAzYBQQM0BX8JFAkkCRFqiAdIAP8PSAGEASYJDA24Dw4BfgUQCQAAE2qAAUgA/g9oAAAIfAt8C/wFfgV8B3wJfAkZaogDSAD/D0gAHAVsAXwJbA98AWwFfAUABR5qAAOQAP4PAAD8BwQJ9ArUC1QJtAqECwAAH2qAAVAA/g9QAAAC9AL8AvYP9AL0AvQCEAIhaoABSAD+D2gAAAl0BXYD9AF0A3YFdAUECSNqhAFEAP8PRAAADSsDqgg+B2oCKwWiDAAAKWo4A7gA/Ae4ACgAgADsB7gHqAeoB6gHAAAqaogBSAD/D0gACAj6CV8FWgX6AV8FWgX6CTFqiANIAP4PAABeCToLjg0cBUIFegtCCV4JOWoAA4gA/w/IAOAItAq+DPQGAASQAP4PEABEagAAyAD+DwgA+gOqAqoC/g94BI4DeAwACEtqkANQAP4PEAAyD7IA8gf+BfIH0QCwDyAAWGqIAUgA/g8oAIAPWgFaB0oF3gZaAMoPAABZasABKAD+ByAA2gS6BboEtQS+B9oFEAQAAF9qiANIAP8PQADmDLgDtArfCKQHuAq0CKAEYWqAAUgA/g9IAAgEuAVsA+4KvAmsB6wBOAJraogBSAD/D0gAEgjyBX8FegX6AX8FcgXyCXFqgANIAP8PAAT8A0QErAdsBwQApAj0ByAAgGoAA4gA/w/IAHgIzAv8C/4L/AvMC/wLAACQaogBSAD/DygAiA98ACcH7gX2BeQF9AcEAJRqiANIAP8PQAAaB/wF2AXeB9gF/gWIBwAAomqAAUgA/g8IANgMuAL0BBYAxAyoAugEAAipagAByAH+B2gAeAXMAfwF/gfMAfwFhAUAAKxqAAOQAP4PAAAUBtQG9gN0C3YHVANUBAAAw2qAAUgA/gcAAP4HAgT+Bf4F/gX+Bf4FEgT7aoADSAD+DwgAfgkuC/4NAAVeBS4LXgkAAARrgAFIAP4PAAD+B+4E5gPwD+YD7gz+BwAACmsIA4gA/g+IATAB1A82D4APNg9UD3QJAAAga0AIMAgMBAoCiAF4AIgBCAJIBDgICAgAACFrAAAEBoQBCAhgCB4ECgPoAAgDSAQ4BAAIImsUBCQCxAE8AwQIMAQOA+gACAMoBBgIAAAjawAE/AMUABQA8gcCADAMDgPoAAgBOAYICCdrAAD8DwQFpATUBAQNYAweB/gACAN4DAgIMmuIAMQPogSQBJIE5AewDA4D+AAIAzgEAAg6awAACAn8BVgB/AUAATAMDgPoAAgDOAwIAD1rUAhYC1QI8gdUDQAIMAQOA+gACAM4BAgIPmsABKoCqgivB6oAogIwCA4G6AEIAzgMCAhHawAB/geqBKoFqgi+BwAAHA7KAQgCOAwAAElrJAStAv4H/AOuAf0EOAwHA+QADAMEBAAATGuAALwHrAW8B4QIvAewCA4G+AEIA3gMAABQawAA/gOCBNoFqgTaBQAMEAPuAAgDKAwYAFNrIAHsD6wHuAeoB+AMYAQcA/ABEALwDAAAYWsAAboPuweAB7sHmgcwAA8O5AEEA3wMAABiawAEAATwBwAEAAQABP4HIAQgBCAEIAQAAGNrAAQEBOQHBAQEBAQE/AdEBEQERAREBAAEZGsACPAPAAgACP4HIAQAAP4HIAggCBAIEAZlayAIIAu8CKAIIAggBP4HJAIkAqQBpAAgAGZrAAAQCNQHFATUB5QEEAT+ABAHFAgUCBAGZ2sACPAHAAT+ByACCApoCKgFPgIoBegECAhpa6AAoAV8CGAIIAUgBf4EJAKkASQApAAgAWprJAikCKQOlAiUCLwIhA+UCpQKpAqkCgAIb2sQANAHHATQBZAF3gWeBbQFFAT0B/AHEAByawgM6AMoAGwL6AdoAi4JfASsA7wEqAgoBnNrEA7QAVAE3ALQD9AAXgn0DFQDdAVUCRAEdGsADPwDBAhUCHQPFAiED1QK9Ao0CtQIAAB3awAM/AMECGwI/A5sCAQPbAr8CmwKpAgAAHhrAAh8B1QE1gc8BUAAPAe8APwPvACoBwAAeWsAAIQARAgkBFQEnAIUAZQAdAAUAAQAAAB7awAAxAhkBJwGFAH0AAQA/AdECCQINAgkBnxrwAAiCJ4EEgPyAAAARABEAP4PQgBCAEAAg2sAAMIIPgSSA3IAAAj4CIgG/gGIBvgIgAiJa8AAIgieBJIDcgAQAM4HqQLoCwgI+AcAAIprgABiCB4GkgFyBBAETgPIAP4PSAFIAkAEi2uAAOIIngSSA3IAAAioBP8EaANlBVUJQASWa0AAYgxeApIBcADkDwQE/AVuBWwF/AUEBJhrgABiCF4GkgFyCAIJqAUvBxgFXQsVC6AItGsAAPwPFAXkBBQNQAzeCEIHQgb+CWAIGAi1awAAAAL8D1ICUgIRCUAI3gVCAl4FoAgYCLdrAAz+A1UJVQk9B0AA4AheB0IG/gVgCAAAumsAAFIGVAHMD1MBAAjeBEIFQgJ+BeAEGAi8awAAbAxsA+4A7AcEAmAI3gRCA14DwAQACL9rAAf/APUOpQD1AqcEAASvAqECLwHoAgAEwGsAAHwJUglAB1QFPA1ACH4JQgb+CWAIAADBawAA/ATSBMAH1AQ8AkAI/gVCAv4FYAgAAMVrAABUATQL1goUB8QCEAjOBUIC3gVQCAAAy2sAACAA4Ak8BSQDpAF8CSQJJAf8ASABAADNawAAIADwAy4CogKqAqoKIgoiDv4DIAIAAM5rAABIAMQHcwJKAsoDegpKCkoO+gNCAkAAz2vAAMgC6AOmApQDlAPUA5QKlAr0B8QCwADSayABIgHqB2oFagX/B2oFag1qDeoHIgUAAdNrEAD4B7YFlAz0BwAAtA8sAKYPJAC0ByAI1GsAAAAA/g8gBCAEAAD+B0AIIAgQCBAHAADVawAAQAF+AUgBKAGADz4BSAFIAUQBJAEAANlrAABACn4L5AdkBVQDXgDkB2QKZAlQCUAE22sAACgBKAEoASQB/AckCaQIkgiSCJAIgAbhayQBJAH8ByQJoggQCMALfgpICkgKyAkIBOtrAADEBPwF7AXsA+4H7AvsCuwKfArECgAA72skASQB/AeSCIIIKApkChAJzgkQCswKAAQPbAAAAAj8ByQEIgQiBH4AogMiBCEIIgggBhFsAAAACPwHpASkBKQE5ASkAaQGvAiACAAGE2wIAPgBCgIIAgAI/g+SCJIE8gGSBp4IAAQUbCAAGABGAFUAVABUAFQAVADUAxQEBAgABBdsAAhYCUYFVAJUAtQF1ARUANQDFAwECAAEG2wQABgJhAUjAyoJKgmqB6oAKgHqAwoMAAYibAgAqAS2Bb4FfAd8BbwFvAUcAPwDBAwABiNsEAAYCUQFIwGqDyoBKgFqDSoA6gcCCAAGJ2wQAMgCxALeAtwP3ALcAtwCHAD8BwQIAAYobAgAUAlYC1YLXAVcB1wJXAkcAPwHBAgABi5sEAiICrYEXANcAlwEXAccCPwBDAYECAAG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AAQRcBAAJA8kAIAFvAT8DrwMvA78ArwEvAmAAh9wEQSmAwAAAgATDLoDOgP4DzoBuwe6A7oPLHAQDKIDhAA2BlQB/gcmAfIEbgVqAfoFAARMcAAAIghEBgQDdA7UDzYPhA92D1QPdA8AAFFwAAAiBqwBAATqA+oH+gXiAeoD+gXqBQAEY3AQACYPQAAXAk0DoAOcA7YL+gtcBxICQABrcAAIYAgYBAACgAF+AIABAAJABDgIAAgAAG1wAAACCEIEMgQCAsIBPgDCAAIDYgISBAAEb3BACHAEAAL+ARACBAAECAQI/AcEAAQAAABwcAQChAF0AA4I5AQkAgQB9AAEAWQCJAwAAHVwAAgACaoIKgQqAqoBKgIqBCoFvggACAAAdnBwBAAO/gEAARgFAAQgBCAE/gcgBCAEIAR4cAAAQAhICigJJAQWAtQBHAIkBKAJIAhACHxweAgABv4BEAEABjAAjgCICAgJCAz4AwAAfXAACAwJ0gQABAgD1gACAwgEDAXSCAAIAAB+cAAAmAiICGgECAIKAewACAMIBMgEGAgAAH9wOAgABv4BAAMIAPAHAAQABP4HAAQABPgPiXBwCAAG/gEAAjgIAgzyA5IAkgCSAPIBAACKcHAAAAz+AwACGAgwBA4C6AEIAygEGAgAAI5wAABACCgJpAQgBBgDxgEYAiAEpAUkCEAIknBAADAO/gEAARgKQAg4BAAE/gIAApgBIACVcDgIAAb+ARACAAjoByoAKgDoBwgICAYAAKtwOAgABv4BAAMIAEgEaAbaBUgEKAcIBAAArHBwCAAE/AMgAgAA/A8kCSQJJAkkCeQJBAitcAAM7AMoCKgJqAQuBqgBKAIoBCgJrAggCK5wcAgABPwDMAYAAPgHLgkoCegLCAr4CQAEs3AYCAAG/gEAAhgA4A8UAJwBfACUCRQI9Ae4cHAIAA7+AQACKAQwAA4A+A8oASgBKAEIALlwAAAADOACoACgBr4ApAKkBKQA5AIEBAAAunAAAYgMigLKALgGrACqAqgIuArgCIAHAAC8cDgIAAb+AQgBEAR0A14I9A9EAEQDRAQAAMFweAgABv4BCAMQADwHpAAkCPQPJACiAyAEwnB4CAAG/gEAARgBAASWBJAEmASWBBAEAADIcCAJEgcOA8oAagwaAAAEfAkAAQAF/gUACM9wAAgADPwBVAFUBVQBVgVUAVQLXAlABwAA2HA4CAAG/gEQAoAIiAT+AogAiAD+AogMAAjZcCAIEA7+AQADWABID64EtASkBLQETA9AANtwQAgwBv4BEAYABPgIiAj+B4gE+AYACAAA33B4CAAO/gEQAP4PAgQiBfoEogUCBP4PAADkcPAIAAz8AwAEEAUAAagD/AqoCrgKqAYkAOZwIAQYBAAD/wAIAwAI+QQJAu8BCQT5BQAI53B4CAAG/gEAApAIhASmA7wAtA/ECKQIgATrcAAIighiChQJAAQqA1oELgSaCIoKeAgAAO1wAAAkBCQDfwAUBoAAZAA/BwQAfAKABkAI+XAAACIIIgY+ADYFNgG3AHYCdgQ+ACICAgQJcQAAEAgUBPQBVAlcA1wBXANcCVwJFAcAAApxPAQADv4BCAMAAF4BVgHWD1YBVgFeAQAAFXEgCBAO/gEQAoAI+ASWAvQBnAL0BIAIAAAZcTgEAAb/AQgDIACsB6QEpgSkBLwEpAcgABpxAAAkChQLvgQMBKQDMAIMBH4FDAUUCCAEIXEoCCgN/gElAfwNJAH8BSQJ/AEkBSAIAAAmcRAIEAz4AV4BWA1YAfwBWg1YAVgBCA0ACDBxeAgABv4BAAI4ANAPSAUGBUQEXAXEDwAANnGICKgGbgJuABQFDAGAAGgGHgBoAooOgAg8cUAIOAQAAv4BEAikBPQDpgCkD/QIpAgABExxeAgABv4BAAKQCPwK1ArWD9QK1Ar8CAAATnEECfwEXQReAVwN/AAEAHYMBQH8AQQMAABVcQAAAAj+BLIAzgK6DAAA/gQSCRIDng8ACFlx8AgADPwDIAj0CpQK/AqUDvwKlAr0CgAAXnEAABgJVgVUAVwN9AEAABwN6gjIAjgFCAlkcTgEAAb+AQABEASEBL4CrAHsB74BhAIABGdxAAj8DZQAlADsDBQAzAFEBVQJVAHMDQAIaXE4CAAG/AEQAgAI/AusCqwCrAasBvwLAAhucQAAMA40APQBdAV+AXQFdAV4AfQBEgwAAH1xAAAQDv4BEA78A6wEbADqB6oEagL6DwAAhHE8CAAG/wEIAgAM/gCqBqsIqgqqAP4GAASKcQQEfAc/ALwAvgb8AAACZwSqAIkCRAwAAI9xAAAICvoK2gLaCv4D2gr6CtkC+QoICgAAlHEYACAM/gMQBCQBlA9ECSYJRAmUDyQBAACZcQAE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t3MEAiQC/AMkAgQAgA+ABP4EiASIBIgPCAC7cwAEJAL8AyQAAAz4A8gJfgZIBsgJGAgAAMJzAAQkBPwDJAIAAPQDFAH0CQQI/AcEAAAAynMAACQE/AMEAkAI/gdCAP4H/A9CAP4PQADNcwQCJAL8AyQBEAFICCQFkgTEBEgCEAEAAOBzBAQkAvwDJAIAAFwGSAH+D0gBSAJABAAA7XMAAEQE/AdEBAAC8AgABP4DAAj8D0QIBAjycwAAJAT8AyACDACMAvQClALUD5QClAIAAv5zJAQkAvwDJAoACPwFVANUAVQPVAn8CQAEA3QAAiQC/AMkAQwDaAIICP4HiAAKA2oEAAQFdAQCJAL8ASQBAAD8D1QEVgTUAVQDvASABAZ0AAQkAvwDJAIACXwIVAnUD/wPVAlUCXwJCXQABCQC/AMkAgAItAcsAKYPJAC0ByQIAAAQdAAEJAL8AyQCAAj0CRQEEALeARAEFAj0CyJ0AAQkAvwDJAKAANQC1Am8CMQHZACUAwAEJnQAAiQC/AEkAQAAtAe0AqwDLgj0DzQAAAAqdAAEJAL8AyQCAAgIBf4FWAFYAf4FCAUACDN0AAAkAvwBIAOIAP4PSAAAA8gA/g9IAIgDNHQAAFoAWgFeAXoBWgFYAXoFXgNaAVoAkAA8dAAIRAT8B0QGAADoBqgArA+oAKgB6AMIBEt0AAAkBPwDJAIAAPQHvAW2BbQPvAXwBQAFW3QAAiQC/AEgAQQE9gSUApAB8ACUApYC9ARcdAAAJAT8AwQI8Ae4AvQPFgDWAwQIyAcQAF50AAQkAvwDJAIAADwAsA+wB/4AsA+wALwPX3QAAJQOVAh8BFQGlApACVQJvARUAVQGAABqdAQCJAL8ASQBAAz+AKoGqgD+BqoBgg8AAHB0AAQkAvwDJAIACHwEVALUAf4HVghUC3wLg3QAAiQE/AMkAgQAdA9kA9YFZANECXQPAACHdAAAJAT8AwAM+gMqCMAHFgcqBOgPKAloCYt0AAAkAvwBJAAAAvQC9AL2D/QC9AL0AhACnnQAAiQC/AMgAQoEaAV+A+gBbgVoBW4JAACndIAAfAh0C7QLtAv8CwAPVAt2D1QLVAkAALB0AAIkAvwBJAUABP4Evge6Ab4CugJ+BRAFynQABCQE/AcgAggM/A/+B+wH7AfoC+gLAAjcdAAIAAb8AQQABAb8BQIEggc+CMIDAAwAAOJ0AAB0DfwB/A90AQAO/AEEBvwFBAL6DwAA43QEAE0N5gMADfwH/AsCCP4HWAHnD1QBAADkdAAE/AX+D/QJ7AHwDfwDBA78BQQG+gsADOZ0AAAEBAQO5AkcCNQEFAUUAPQHBAgECAQG7nQAAFgISA7kB3IHaAdiB2oBcg9kCEgISATvdAAA/AcEBbQE5AQQAQIM/guSAPIPAggABvZ0AACIDPoDiAD+D4oAAAj8D5QA9A8ECAQE93QAAEIIVAzAC2gJZAtWAUwBVA9kCGAEAAAEdQAAfAl8BVwHbAU8AIAPfAiUAPQPBAgABhh1AAAIAAgA/g+IBIgEiASIBP4PCAAIAAAAGnUAAAQBBA/+CVQJVAtUCVQL/gsECQQJAAAcdQAAkg+SBP4EkgcAAP4PiASIBIgE/g8IAB91AAAgCJAIjgiICIgI/g+ICIgIiAiICAAIInUADOQDJAm0CrwKrgqsD7wKtAqkCiQIAAAjdQAM5AMkCLwKpAqkCqYPtAqsCqQKIAggACV1AAArAiQC/wEkAQAIvgbqAb4EqgS+AwAAKHUAAAAM/AMkASQBJAH8DyQBJAkkCfwHAAApdQAAAAz+A5IAkgD+B5IIkgiSCpIK/gkABCt1AAAIAOgPqAKoAqgC/A+oAqwK7AcIAAAAMHUAAPwPRAREBEQE/AdEBEQERAREBPwPAAAxdQAA+A+IBIgEiAT+B4gEiASIBIgE+A8AADJ1AAAAAPwBlACUAJQA/A+UAJQAlAD8AQAAM3UAAPwDJAEkASQB/w8kASQBJAEkAfwDAAA1dQAAAAD8AyQBJAH/ByQJJAkkCfwJAAgABjd1AAAACXwJVAVUA/wBVAlUCVQJfAkABwAAOHVAACAA+AeuAqgC6AOoAugLCAgIDPgDAAA6dQAA/gciAv4DIgL+AwAACAgICPgHCAAIADt1AAD0DwQE9AVUBVQF/AVUBVQF9AUEBPQPRXUAAPgB/g+uD3gAIgnyBDoC5gkiDOADAABMdQAAAAG+CKoEagI+ACoAag+qAL4AAAEAAE91AACACPwP1AjUCPwI1APUBNQG/AiACAAAUXV4CAAG/AEABhAA/A9EBEQE/AdEBEQE/A9UdQAA/AckAvwDJAL8A4AAqAD+D6AArACAAFl1AAA8AKQPogqSCqIKgA+8CoQKRA88AAAAXHUAAEQA1A/UCvwK1g/UCsQKpAqkDyQAAABidQAAoACuAu4CrgLuB64CrgLuAq4CgAAAAGV1AAD8B/wDJAL8A5AAiA/WCKQI3AjED0AAZnUAAPwH/AMkAvwDAAgoCSgJvg8oCSgJAAhqdZAAlADcB7QFlAW8B5QFsgXaBdoHkABAAGt1SAB8BPwH/Af8B/4H/Af8B/wH/AdIBAAAcHUAAAAKvArsB6wGvAKsAqwG7Ae8CgAKAAB0dQAA/AckAvwHdAasA/QDXg1UDVQJVAcAAXZ1AAA4AAoP7AuoC64LqA+oC+wLCg84AAAAeHX8ByQC/AMkAvwDIAC0A7QCrgs0CPQHIAB/dUAA5gdZBdQHWAX/D+AEdgN5B7QIUghABoZ1AAB0BVQPXAzABwQA/A/0DvwP9A78D0QIinUAAPAJ/gj+D/4P/g+uD/4P/g/+CPAJAACOdQAE5AcEBPQDTAIECPQElAL+D5QC9AwAAI91AATEA/QDTAIACKQHPACmDywAPA9kCEQEkXUACW4JVAXUA1IBCA2iAyoE6g82CWIJIAiXdTgJgAT8AwQAJAAkCCcIpA9kAGQAJAAAAJl1MAkABfgDCABIBCgKrAmoCagIqAgoBAAAmnUYCYAM/AMECMQINAQmAqQBZAIEBAQIAACfdZgIgAb8AQQAhAD0B5UElgSUBJQElASEAKR1mASAAvwBBAD0A5QE9gSUBJQE9AQEAgAAq3WICLAO/AEECEQItAWWBpQG9AXECEQIAACudYwIQAb+AWIAIgDyBysIKwkqCfIIEgYiAK91OAGADPwDBAz0AxQAlgLUAxQA9AcECAQEsnWYAIAO/AEEDvQBVATWBXQCVAWUBDQIAAC5dbgIgAb8AUQAJAqUClYJFAWkBCQCRAEAALx1GAmADPwDBAAkBbQE1gjUCrQKlAAEAQAAvnWYCKAO/AEECIQEtASmAuQBpAKkBKQIAATFdZgIgAb8AQQA1A9UAFYD9ABUA1QI1A8AAMd1mASABvwBBATUBxQEFgT0B5QElASUBAAAynWYBIAG/AEEBCQFFAVWBdQHVAUUBSQFJATSdYgIkAb8AQQApAK0AqYC5A+kArQCpAIEANV1mAiABvwBBAD8D6wErgSsAawGfAUECQAA2HU4CYAE/AMECNQJVAtWCVQJVA3UCRQIAADbdZgIgA78AQQA7A+8Ar4C7A+8AqwK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JALkA3wA1AF+AVQB1Ad8AQABl3iEAPQHLATgB8QANAykA0YA9AcUCPQJAASYeEIA+gcWAvIBAAT8DKQC/wCkAP8CpAT8AJ94hAD0D0wEwAcIAHwNSAP8D2gDfAVICQAAp3gAAMoE6gL+D+oKgAr8CtQK1grUDvwAAACpeAAAhAD8ByQC5AsACPwHrAKsAqwG/A8ACLB4hAD8DyQE4AeIAA4J/A8ICPwPCgjICQAAsXgEAdQPLATEC/AHCACoDwgHfgKIBWoIAAazeIQA/AckAuQDAAisB2gALg2oAygErAkgALR4hAD0DywE5AcAAKgL2ArcCtgKqAsoCAAAuniEAPQPTATEB0wA5A9cCVYJ9A9UCVQJTAm8eAAAggD+ByICwAd+A6oEqgD+BqoBgg8AAL54wgD6ByYC4gEABP4DigjqB6oB6gKuBAAAwXiEAfwPJATkAwwIaA+OCOgOSAioD84IKA7FeEQA9AdMBMQHAAB0CFwG3AF2CVQJVAcAAMp4AABSAtIHegVuBWoHagLqB2oFegVCB0AA0HhQBVAFPANUDxYLfAsIC2YLUgu+D5gBgAHVeAAARAD0DywE4APID/wPzgjMD+wIyA8ACNp4hAH0DywEJATEB/wC3AbcDv4K3A/8AgQD6HgADvwBBAS0BLQOtAuWCoQKtAq0CrQOlAD0eEQA9A8sBMQHIACaCdoP1gjWDJoKIAgAAPd4QgD6BxYC8gOACHYHzAFfAMwB9QdUAQAA+ngAAIIA/gcSAuADSgjvBOoC+gDvAuoCAAwBeQAAQgD6BxYC4gEIDP8ArAb9AKwGLAAABw55hAD8ByQCxAsUCEwEXgfQD0wJXglUCRAIGXkAAAQB/APkCw4IVAfUAUAIDAfsDywJZAA6eQAAIAQkAqQBJAgkCOQPJAAkAKQBJAIgBDx5AACIAYoA7g9YAIgBAAD+BwAIAAgACAAGPnkAAAgBiADOD7gACAkgCCAI/g8gCCAIIAhBeQAAiABKAOwPWACIAAAA/A8EAHQCjAEAAEJ5AAGIAMoPeACIACAA/AcgCP4JEAj4CAAGSHkIAYgAzg94AIgJAAT8AyQAIgDiDyIAIABJeQgBiADuD1gAiAgACPAPAAj+DyAIIAgACFB5iACIAO4PWAAIAYAA+A9OBEgESATIDwAAVXmIAIgAzg98AAgI4AwAAvIHxAgwCGwGgABWeQgBiADKD7gAAAj8DyQJJAkkCSQJ/A8ACF15iAFIAO4PWACACDwEJAPkACQA5A88CAAGXnmIAYgA7g9cAIAA+AMoASgB/g8oAfgBAABfeQAAgASWBLQCtAC+B7QAtAK0ApYEgAQAAGB5gABJAOsHWACCAOoDKgEqAeoJAgj+BwAAZXkIAYgAzg94AAgAQAFKAUoB+A9KAUoBCAFoeQQJdAXUBdQB/AnUCdQH/AHUBdQFdA0ECW15EAAQAZgIbgRMAXQJSAlGD1gBZANUA4wMd3kIAYgAyg+4AAAEVALUAX4DVAlUD0QBAAB4eQgBigDqD5gAAADcD1QB9ABUC1QI3A8AAHp5CAGIAOoPWABACAgJ/gVYAVgB/gUICQAAgHkAAAQK/AuMA/wL3AveD/wDjAf8BwQKAACBeQAAFAlMBV4BTAlECVAPTAFeBQwFNAkgAIR5iACIAM4PfAAIAEIEKgIqCeoHKgG+AqAEhXmEAEQA5g9cAAQB8AGqAfgHrAGqAfgBAACNeYAAiADsDxgAwA98AMQH9ALUA1QI/AcAAI95iABIAO4HWACCAPoPagVqBeoHagV6BcIHpnkAACQFswWABesB/gHaB4ABvgOCAz4FAAWneQABigDqD5AABAB8D9wLXgtcC9wLfA8EAap5xAAkAPUPLQBAAv8CrQL/D6oCrQL/AgACrnmIAUoA6g+YAAAI/gv/CuoK/wrqCv4LAAixeQABigDqD5AAxA/8BfwH/gb8AvwP3AIAALl5AACED7wArASsBPwHrASsAqwKugiCBwAAunkAAIAP/ADUAtQC/APUAtQC1Aj8CIAPAAC7eQQABA90AWQFZAfWBVQFVANECXQJBAcEAL15EAAID+gBxAGUBbIHugWyB4QJ6A8IAAAAvnkgBCQCJAGkAGQA/A9iAKIAIgEiAiAEAAC/eQAAkAhUCFQENAN8ADQANAdSCFIIkASAAMB5iAhMCCwEnAOMALwAigqaCSoJSgdIAAAAwXkAApIBUgD+D1IAUgQAB/gEBgTABAAPAAjDeQAAUAhUCFQENAO8AJQANAdSCFQIUAYAAMZ5AAAYA5gA/A+UAAABRABEAPwPRABEAEAAyXkAACgEugS6AroBugH+D7oBugL5AigEAADLeQAAkgNSAP4PUgAACDgEgAN+AIADMAQICM15lANSAP4PUgACAPgBiACIAP4PiACIAPgB0XkAAJQDUgD+D1IAEAFCAUwBAAH+DwABAAHSeQAAlAFSAP4PEgCACDgEgAR+AgAB2AAAANV5EgOSAP4PUgAAAP4PIAQAAP4HIAgQCAgG2HkSA5IA/g9SAIAJYAT6B4IIYAgeCOAGAADfeRQDlAD8D1QAlAkACPwPJAkkCfwPAAgAAOR5AAAUA5QA/A+QAIQAtACEAPwPhAC0AIQA5nkgAawIbASsA7wDrg9sASwDbASsCCABAADneQAAFAOUAPwPkgAACPgIiAb+AYgG+AiACOl5lANUAPwPUgCSCBAETgJIAf4ASANIBEAI63mSA1IA/g9SAJICAAaQAXAA/g9QAJYBEAbveQAAlANUAPwPUgAACHwGRAFEAEQBfA4ACPB5kgNSAP4PUgCSAhACzwEECPwPBADsAQQC+HkUA5QA/A+SABoASA9ICUgJfglICUgPCAD7eQAAlAFUAPwPUgACCagErARWBXQCzAFAAP15FAOUAP4PUwAACZ4JUAhwBV8GUALQAV4AAHoQA5IA/g8SAAAB6gesALwApA+sAKoEqAMFehIDkgD+D0IACAj0BJIDkACSD+QICAgQBAt6AAAYA5gA/A8AATwIpAqkCqQPpAq8CgAIDXqSAVIA/g9SAAAA8gdUAVABXgFQBfYHAAAOegAAlANSAP4PAgA4DMoDSADMD04IeggABhp6AACUAVQA/A9SABAA/g+oBPwHqgSoBAAAIHoYA5gA+A+UAAAM/AMEANQH9ALUCwQI/AcjehAA+AVWBfQFXAX0BiAHpAD8D6QAIgcAAC56AADKASoA/wMACP4Krgr+D64K/QoACAAAMXoUA5IA/g+SAAAC6A+kAqQC6gOiCroK4gcyehQDkgD+D1IAEgDADxIAwg9aBUIF2g8AADN6JAIkAfwPogAABlgAVgVWC1QJXAHwBQAIN3qUA1QA/A9SAAAJfgmWBdYGvgZWBVYIXgA7eooBSgD+D0kAAADKB6oEgQQtBKEE7QcAADx6FAOUAPwPUgBABVwFtAJ2CbQG1ABcA0AEPXoUA5IA/geSABAAdAesB64HtAe2B5YHVAA/eooDSgD+D0kAgA9eAFYPVgVXB14Awg8CAEJ6FAOSAP4PUgCABnwArAysCf4KrAKsBvwIRnoSA5IA/g9SAIAIvAwsBSwF7gYsArwCgABMehAM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fXwsA6AA/g+gAAwBQABECEQI9A9MAEQAQACJfCwDoAD+D6AALAlgBFgGxAFACEYImAcgAJJ8LAYgAf4PoAAsAQAIaAiICw4IiA9oCAgIl3wIACAD/A+gACwBAAj8DyQJJAkkCfwPAAiYfAAALgOgAP4PJACAD4AE/gSIBIgEiA8AAJ58jAMgAP4PhAH8DxQE/AUUBPwEFAX0DwAAn3wECXQF1AXUBXwDVA9UAXwDVAVUBXQFBAmkfAAAgAD8AMQD1gLWAtQK9ArEDvwCgAAAAKV8AADyCJIIngc8A/4PKAAEA3AIkgieBwAAp3wsB6AA/g+oAAAM+AMICEgI7g9ICEgIAACqfAAAKAqoCqoKnAu+AogCmAacB6oKqAooCq58JgegAP4PoAAuAQAA/A9UBNYAVAN8BAAEsXxkCREFQQWMAyABkg8uAUIDwgV+BQwFMAm5fAMA0AH/D1AAkwGAALoAggDjB5oAkgCiAL18AAa4Af4PIAAIAwQIpAanAKQPpACMAoAMvnwCACwH4AC+DwAA1A/cAtwC3grcCtwPFADKfAwAIAP+DywAgA9+BMgDAAz+A5II/gcAANV8BgCgA/4P6AAACKgGqgCsDvgArAyqAIgO1nwGANgA/wNYABAP/AB0A/QC9gL0AvQDIADZfAwAoAH+D6gAJAlABNwHAAisC7wKqAqoC9x8AA78AQQIHAW8BS4Dhg8cA7wDHAUsBQAA33wGAKAB/g+MADoA1g//CtYK/wrWCv4PAADgfAMAkAH/D8IC/wEBAlUB/wfXAz0BkQKBAud8qAH+D6AAKAjgC/wL/Av8D/wL/AvcCwAI73wDANAA/w/eAY0HvQClB+8ApQetAL0HAAD4fIAEhASYA5QB4wDQD0gARAF0AUACgAQAAPt8AAAABJQE1ALcCLQIlA9SAEoBQgKCBIAE/nwAAJAO3ACyDIgCAAD8AwABAAEAAf4PAAAAfQAASAd8ANIPSAEAAOQHJAgkCCQIfAgABgR9SAd+ANAPTAAAAxAATgCICQgICAz4AwAABX0AAEgHdgDQD0wA4AoECAQI/A8ECAQIAAgKfQAAFAhUBVQFfAH0CVYPVAEcBZQJJAokAAt9SAduANAPTADgCggIOATIAg4DyAQ4BAgIDX1IB24A0A9MAAAB+A8IAcgAPgDICPgHAAAQfRAOnADyDsgAgAIECEQM/AtECPwPQAgAABR9SAduANAPTAEAAOgDCAEIAf4HBAnkCQAEGX1IB3YA0A9MAGQBAAT+ByIE/gEiBiEMAAAafUgHWAD2D2AAQAsEB/wAhAQkBTwD4AQgCBt9SAd2ANAPTAAAC3AITgbAAUIITgjQByAAIH0gACoJagVqA+oL/wlqByoBqgWqCSALIAghfUgHfgDQD0wAxAoACAgH+AAuCCgI6AcIACJ9AAA0CBQFVAX0AV4JVA80AbQFFAU0CQAAJ30ACB4JgAXeAcAJogmSD14BUgUeBSIJIAArfRAJHAlQBV4FtAGQD04BFAWUBRIJCAoAAC99AAAACD4FagXqAX4Jag8qAaoFPgUACAAIMH1IB3YA0A9MAcAA/A9EBEQE/AdEBEQE/A85fUgHbgDQD0wAAAMgAKIPngSCBKIEng8AAEJ9SAduANAPTACAAogATgQ1BTQFTAlAAAAAQ30QDtwAsgZIAEAHSABoBloFzAQoBggMAABEfUgHbgDQD0wAAAMACPwPJAkkCSQJ/A8ACEx9SAduANAPTAAAA0IIJgkqCZIPKgkmCUAIUH1IB24A0A9MAKADBACkD6QEvwSkBKQPJABVfbAN7ACiBJgCAAD0BzQJLAnkCTQJLAngBV59SAd4ANYPUAAACygImAQYA84DCAQoCCgAYX1IB24A0A/MAMQDkADID9YEpATcBEQPgABmfUgHbgDQD2wBIACQD4wEogSkBIgEkA8gAG59AAAsCCwFlgHUCcwJgA9eAVIFEgUeCQAAcX1ID3YA0Q9MAAAJBAS8AycALAC8DwQIAARyfQAAkA78AJIGSAIAAFgDdgjQD0wA4AIABHV9SAd2ANAPTAAACxAIiAamBaQEiAawDBAAdn1IB24A0A9MAQAA+AeWCJYI/AicCJQI8AaTfZAMvAHiDNgAAAo6CEIJEgnqD4IJPglGCJl9QAduANAPTAAAAf4PAASoBP4FoAQsBQAEmn0AAEgHfgDQD6wDgAlUBFQDXgBUBtQIBAScfTAO7ACiDJgCAACMDKQCpwCkD6QArAKADKB9MA7sAKICmAQABNoCVAjUD3QATAKABAAArX1IB24A0A9MAEADEAD+D6gE/AeqBKgEAACxfU4HcADsD0AB/A/sA+QDJAKsCyQI/AcAALJ9SAd4ANYPgAL8DwwAvAPkBLQEBAD8DwAAv31IB24A0A9sAQAAvgeqAKoA6w+qAL4EgAPKfQABPgUuBb4F7gGuB6IBWgMaAyYFQgUAAM99SAd2ANAPTAAAAV4EQAD8D2QJcQhGA4gE0X1IB24A0A9MAAAFIASqAioI6gc+AaAGAADSfUgDdgDQD0wA4AOEAJQHfgVUBVwF1gcQANp9SAduANAPzADABZwCrAksCO4PLAO8BAAE4H1IB3gA1g9IAQgAoAeUAJwA1g+cALQHAADjfSAIvAziAtgCgAQgBH4DtAq0B7wBIAYAAOh9SAduANAPTAAAD/wHrAKsD6wCrA+8AoQP6X1IB24A0A9MAEAJFARcA/QJ1AbSBtwFVAjvfUgHWAD2D2ACAAT0BbwHtgW0D7wF8AUABPR9SAd4ANYPSAAAAvwErAKsAf4PrAH8AgQE+32QDtwAsgTAAZwE1AeUBAQA8AwOA/gEAAgBfkgHXgDwD2wAgAIgBGoDqgpqB74AIAcAAAR+RANfAOgPJgAAAfwHvAK8AvwHvAq8CvwNI35AAnwBfAD8B/wASAIYAXwE1ANUANACgAAmfkgHbgDQD8wAQAL2D5gHFgTwD5YIEAgAACt+EA7eAHEEbAMBCHYG4AksCLsK+wsmCgAILn5AB34A0A9MAUAA7A8EANYHdAVUBdQHAAAxfhAO3gCxDMwCAAD3DwAEzgMBBOgHhgiYCD1+kA7cALIMiAIADPwChAaWCaQLhAD8BgAAPn5IB24A0A9MAAAK/Aj8Bf4F/AH8BfwJEAhBfgAIMAq+CjwL/AM8D4gCXgZkB1wKhAoAAEp+QAdOAPAP7AHAB/QHHgT0A5AG/geQDBYCVH6gAy4A8Ae8ABAA/Ae2AtgPPwPQBBYOAABefpAO3ACyBIgCAAiqCeoHrwEKD+oJqgmABWp+AAd4AJQGUgEIADQH8gX6BdIF9AX0BwQAa34AAH4Kfgd/B/4PfgsYB/YC0gp+CpgKgAhwfkgHbgDQD0wBAATwAt4B+gfqAdYC8AQAAHN+kA7cALICCAk+DOsD6wm+BzQMiwN4DAAAfH4QDtwAsgZIAv4PNAi6DzgJPgisDxALAAiMfpgO9gCRBkgBEgjuB/4H7wP+A+4H+gcACI9+gA7cAKIGWAEADPwD9An+C/4O/Av8C4QJln5QB3wAagIACXYE9QcQBPYPMAT+B9AMFgKgfqAEsAVsBSIFkAQAAPwBAAEAAQAB/g8AAKJ+AAAwCewEogSYBgAABAQEBPwHBAQEBAQEpH4AADAJqAVmBRAFQABEAEQA/A9EAEIAQACmfqAEuAXkBJIEgAIwAI4AiAgICQgM+AMAAKd+IAW4BeYEkAIQDIQDfAiEBTQCrAVgCAAIqn4AACAFuAVmBRAFAADEB0QIRAhECPwIAAarfgAAMAXoBaYEkAIACHQEBAP8CAQM/AMAAKx+IAW4BWYFEAQAAqgAqAD+D6gAqASIAwAAr34gBbgFZwUQBQAE9AEEAQQB/wcECfQNBASxfgAAMAXoBaYEkAIACHgIAAT+BAACmAEgALJ+AACYBdcEsQQAAP4PAgCyAdoBAgj+DwAAs34AADAFzgUiBQAA8A8QA/AAnggQCPAPAAC1fgAAMAXsBaIEkAAADv4BAAwAA/4AAAcACLd+AAAgBbgFZgUAAWAIWATEA0AIRgjYB2AAuH4gBbgFZgUwBQAA/A9ECEQE/AFEBkIIQAa5fgAAMAXsBKICmAoACDgEygIOA+gEGAQICLp+AAAwBawFYgUYAQAICAf4AE4ISAjIBwgAvX4AADAJrAVjBRgBAghCDP4LQghCDv4JAAi/fgAAuAXkBJICgAoQCFAEfgTIAyoFqggABMN+uATkBLICAABUBnwBVgj0D0QARAEEBgAAxH4AACAFuAVmBRABAAj8DyQJJAn8DwAIAADFfgAAIAm4BWYFAAD4AygBKAH+DygB+AEAAMZ+IAWwBW4FIgUAAPwPRAREBPwHRAT8DwAAx34gBbgE5gSQAgAIfAZEAUQARABEAXwOAAjIfgAAMAXoBaYEkAQQAEgCVgQkBVQFTAiAAMp+MAqsCWIJEAUAACwBIAH+DyABLAEiAQAAzX4wBZwE8gKIAiAAog+aBIYEogSiBJ4HAADOfiAF+AWmBJAEBACsAqwClA+0AqwCpAIAAM9+IA24BeYEkAAACKQIpAiUD6wIpAggCAAA0X4AADgL5gmQAQAIKA3+AwAA/A8EAHwChAHSfiAAmATkArICCABABugBCAh+BIgHaggIBtN+MAXsBKICmAIAAKQHpASkBL8EpASkBwAA1X4gBbwE4gSYAgAIpASmA7wAtA/ECKQIAATYfjAF7AWiBIACIAiQDqwJpgSIBpAEoAgAANl+IAW4BOYCgAIgAKAPsA+uBKgEsA8gAEAA234gBLgFZgUSAkAAqAKoAq4ClA+sAqQCIALcfgAAMAXsBKICkAIQAEgPtgSkBLQETA9AAN1+IAWcBOIEmAQAAPgHlgiWCPQInAjwCAAG3n4gCbgFZgUQAUAIOAiYBQoCyAUoCEgIAADffiAFuAVmBZIEEAJACGgHXgBID2gISAhIBuJ+AAAgCbgFZAUAAOAPvAK0ArQKtAr8DwAA434wBawE4gSYAgAIrAScA4wAvACaCSoHAADlfjAF6ASmAqACCAhEBeQGagLCBVoMQAQAAOd+IAC4BeYEsAIAAPgHBASgBP4FYASsBQAA6X4wBZwE8gKYCgAI3AVcBF4DXABcBNwJEADqfgAAmAT2ApICAAJUANQHfgVUBVwF1AcSAO1+IAW4BOYEkAIAALQIFAUeA9QBFAVwBRAI7n4AALAF7ASiBDgAoAe0AqwCrgs0CNQHNADwfiAFnATiBJgCAAD4AqgCqAKuD6wC/AIAAvN+AACwBWwFIgUAAPwDtAL0B7QKtAr8CwAA9H6wBOwEogKYAiAA/A+qBKgE+geoBKgEAAD1fiAAmAXWBLECAAC+B6oA6w+qAKoEvgMAAPd+IAX8BbIEAAz+A5II/gcADP4Dkgj+BwAA+H4AALAF7ASiAgAI/AcEANQH9AIECfwHAAD8fgAAIAW4BWYFAAUYAIgCqgisD6gAqAKABP1+AAAwBegFJAUAASgMqAMoBO4PKAkoCQAA/34AALgFZAUSBYgAQAQqAioJ6gcqAb4CoAQAfwAAOAqkC3MJAAyqCJoGBAmgCZIGnguiCAV/AAC8BeIEmQIIAOIHEgTyB14F8gfyBwAABn8AANgCTgJ5AQAE7wQ/AqABKAMmBOwFBAQOfwAAOAXmBJEAAAL8D1ICAAjeBUIC/gVgCBN/IAW8BOMEmALADFQC8gnWBtEG3QVVCAAIFH8QBawFYgUYBQAAtAecANYPnACUBLQDAAAVfwAAOAXkBLIECAKgCKoLmAbeBJgHmgSoCBZ/AAC4AuQCkgAABvwBlAfWA9QHVAHcBwAAGH8gBLwFYwUZAAAFbAVrBaoKqge+ASAGIAQZf5AE3AKjApgCAgDqD2IFfgV+BWIF6g8gABp/IAWwBG4FIAUAAHgBeAV8AXgJ/A/4AQABHX8AANwFswSIACII4AcECK8K6guuCqIKAAggfwAAOAXkBRIBAAz8A3QIrgr+D6wK/AoACCR/uASWAvECCAgGBIIE+gKqAOsCqgSOCAAAKH8ACqAJ+AmmAQAIXgk6C44NDAV6C0IJXgkpfyABuATmAgACjADkDxQA1gd0BVQF1AcAAC1/GAXWBbEEjAAgDPoBVglTD1YB+gUiBAAAMH+gArgC5gKQAAQE/Af8B/wH/Af8B/wHRAQ0fxAEvATjAhgAvgzrA+oJvgc0DMsDeAwAADZ/AABQAEgPRwREBPwHRAREBEQERA9AAAAAOH8AAKgHJgT8AyQCpAcAAAQE/AcEBAQEAAA6fwAAqAcmBPwHJAQEB8AAyA7+AcgC+ATACFB/EAAIB/4HJAcEATQP/g8UD+QPPg80DwQAUX8AAPwPBAAkA+QABAQkBsQBNAsECPwHAABVfwAABAFUAVQBVAHED0wBTAFUAVQBBAEAAFd/AAAeCZIIUgh+BVIGUgJeAlIB0gAeAAAAWn8AAJ4AsgiyDx4EEgQSAN4DEggSCN4PAABifwAAXAlUDVQLXAnUCVQJXAlUBVQFXAkAAGl/AAAcAtQD1APcA/QH9AP8A/QD9AM8AgACan8AArwKtAq0BuwBFAAUAOwPtAK0ArwCAAJufyAA3Ac0BDQE/Af0B/QH/Af0B/QHPAQABHB/IAD+B/oF+gX+BfoHCgDuAQoICgjuDwAAcn8gAa4AugC6B34FegV6BX4FegX6Bz4AIAB1fwAIDgT6APoB/gf6APoC/gD6AvoEngMAAHd/AABcCPQH9AH8CpQHdAa8CrQKtAq8CgAAhX8AAG4N2gFKDQ4FSgD6D64KqgrqD64KoAqKfwABSAFKAUwBSAH4D0gBTAFKAUgBAAEAAI5/QAhYCVoJXAVYA/gBWANcBVoFWAlACQAAlH+ACKgGqgCsAKgG+ACoAqwEqgCoAoAEAACefyABuAS4BHwEeAX4B3gFeAV8BfgHKAQAAKF/UARcApwCHgCcBVwEXANeAl4E3AVQBAAApH8AAagB+g+uBKoEvgcIAUoB+A9IAUsBAACofyAJLAyuAi4ILAn8BKwErAOuBKwIpAsACKl/QAPEC9QL1g/UA/wLVAlWB9YFVAtACQAEr38AACgBKg34Ay4BAAG+A2oEagVqCX4IwAe5fzAK/AveC94H/AfcA/wH3gfeC/wLVAtQCr1/FAIkASQJhAj8BwAAFAJkAQQJhAj8BwAAwX9IBMQEUgJaCtgPEABYBNoCUgpECsgPCADFfygI6AQ/A+gEAAiSCoIK/gsICEIM/g8ACMx/RAgsCSQJBA08CYAJLAksDVQJRAl8CQAAzn8QAEgCZwbkCUgAAgGSCP4HAACSCP4PAADSf0AAKACkD+QKxAr8CoAKrAqkCoQPfAAAANR/KAkqB/gBqwABAjAJAgj+BxABggj+BwAA2H+oCKgGvgG4B8QIgAhMCvwLCAhACvwPAALgfwACKgKuAq4C6gImD7ADZAKqAqoCLgIAAul/AAj8D+wH6g/qB/gOsgH+B5gB/g8AAAAA8H/8AqwCrg+sAvwCAAJYCvQPQgAUCvgHEAD5fwAJqAfsAQ4HbAkECZAL/AkACFQK/AkABPt/QADUD7IFvge6BZMHAAGSCP4HuAH+DwAA/H8AAAIL7gfuB+ID7gPgA+oD6gfiBw4LAAAAgAAE8AM+AOADMAIIAKQHnAeIB6QHvAcAAAGAAAAgASgBqACoB34JKAk4CagIqAgkBiAAA4AAAJAAlADUAlQBfgFUCVQJXAlUBxIAEAAFgAABIAGoAKgPqAr8CqgKuAqoCqgPJAAAAAyABAD0DxQAFAD0DxwAFAD0DxQAFAj0BwQADYCCCLoIigqKC7oGjgSKBLoGigWKBLoIgggQgAAAAAD0D/wD9AP0DwAA0AEQCP4HEAAAABWARAZUAf4P1AHUAgAIiAb+AYgA/g+IAAAAF4AAAFQGVAH+D1QBAAAkAfwHkgiSCJIIgAYYgAAAVAZUAf4PVAFUAQAEJAfkBCQEJAckCBmAAABEBlQB/g9UAQAA/AdECHwIRAj8CAAGM4AAAAQEBAT8A5QClAKUApQC/A8EAgQCAAA2gAQC/ANUAlQC/A8AAPwPBAAkAlwChAEAADiAIAQgBOwHqgWoBaAFsAWoBaYF6A8oBCAEO4ACAv4DUgJSAv4PAgDwDwAI/w8gCCAIAAA9gAIC/gNSAv4PAgEYDAgD/wDoBwgIGAgABj+AAgL+A1ICUgL+DwIJeAQAA/4AAANwBAgIQoAAAMQI/Aa8ArwBvAg8CLwFvAa8BqQJJAhGgAIC/gNSAlIC/g8CAEgAVAFTAkQNyABQAEqAAgT+A1IC/g8CAPgJBgXxA/wPBAD8AwAAS4BkBGQE1Af0BewF5gXcBfYF9gXkD2QEVARMgAIC/gNSAlIC/g8CAXgMRANEAEQBfAYACFSAAgL+A1ICUgL+DwIBSAxKA/gATANKBEAIVoAAAEQI/AjcCtwK/A+ACrwKpAqkCjwIAABYgAEC/wNJAkkC/w9BAPwBagF/BWoFfgNAAFqAAAAkCbwJvAW8BLwCpA/AAnQCVAUsBSQIXoAAAP4PKgBqBP4HwAX+BeoPagAqCP4HAABqgAIC/gNSAv4PAgB4A0sGyAhICE4BeAcAAG+AAQL/ASkB/wcAAN8JEgWwA4cHHAHSARAAcIACAv4DUgL+DwAE/AKEBpYIpAqEAPwGAABygEAA9gS2B7cHtgeiB4gH9gfSB/4P2AQABHSABAT8B1QC/A8kAFQDdA7eCHQIVAF0BwAId4AAAv4DUgL+DyQA7AemAugJIAT+A6ANLgR9gIQA/AusD/wPBAD0AtQM/AjWCvQI1AL0AIOAAAAIDKwDLACsAywA/g+sASwAvA8IAAAAhIBACU4JVAXUA1IFAAisAqwC/g+sArwCCAKFgAgMqgOqA6oPKgH/DyoBqg+qA74PCAAAAIaAgAT+BqoFqgSiBggArAKsAv4PrAK8AggCh4AgAJ4ElgbWB9YHzQfgD+wH1gecB6QEJACJgAAA+A8IAEgCSAK4AR4BKAFICggI+AcAAIuAAAz+A5IAkgj+BwAAEA/+ABAIEAjwBwAAjIAADP4Dkgj+BwAA/g8CAAIA/gcACAAGAACWgAAAAgD2D1ABUAFeAVAJUAlQCfYHAgAAAJiAAAz+AxIBogj+BwAAUACQCRAI/gcQAAAAmoAADP4DkgCSCP4HAAAgBCAE/gcgBCAEIASbgAAM/gOSAJII/g8AAAQEBAT8BwQEBAQABJ2AAAz+A5IAkgj+BwAARABEAPwPRABEAEAAoIAADP4Dkgj+BwAAoglyBCoD5ggiDOADAAChgAAM/gOSAJIM/gMACOAEXgVCAkIF3gRACKKAAAz+A5IAkgj+DwAAaASoBT4CKAXoBCgIpIAADP4DkgCSCP4HAABIDEgD/gBIA0gESAilgAAM/gOSCJII/gcAAP4HQgh+CEII/ggABqmAAADEBzwArAfsAewB7AHsBewF/AMEAAAAqoAADP4DkgiSCP4HAAgIB/gASghICMgHCACugAAM/gOSCP4PAAToAyoAKgDoBwgICAYAAK+AAAAQAPAPvAKwArACvgK0CrQK9AcQAAAAsoACAAoA6g+uAqoCqwKqAqoKrgrqBwoAEgC0gIAAqAByAOwP7AL8AuQC7ArsCuIHIAAAALqAAAz+A5II/g8AAOQDJAAkAPYPJAAkAuQBvoAAAB4AgA+AA7wDgAOsA7QLtAusByQAQAC/gAAI/geSAP4PAAD4AYgAiAD+D4gAiAD4AcCAAAz+A5II/gcAAEAI/g9ABNAETAFCBkAIwYAADP4Dkgj+BwAA6AwIAv4JCAj4BwAA4AHDgAAAfADUD9QD1AP8A9QD1AvUC9QHfAAAAMaAAAz+A5IAkgz+AwAI/AkkCSQJJAn8CQAIzIAgABQA1A/UAt4CwALAAt4K5ArmBxAAAADOgAAM/gOSCP4HAACwB6wEogSoBLAHIAAAANaAAAz+A5IIkgj+ByABJgH8DyABLAEiAQAA2oAADP4DkgiSCP4HAABECPwLJAhECIQIAADcgAAM/gOSCJII/gcAAJ4IkAj+D5AIkAgQCN6AAAz+A5II/gcgAPgHrgioCOgJCAn4CAAG4YAIAMgHSAJ/AkgCyAMACP4HkgCSCP4HAADngAAM/gOSCP4PAAgIB/4ACAT6B4oIaggoBO+AAAz+A5II/g8AAKgAuAOoCqwKiAqYBqgA8IAADP4Dkgj+BwAA7ASsBv4BrAKsBLwJAAjzgAAM/gOSCP4HAADID7YIpAi8CMQPgAAAAPaAAAz8AyQJ/A8AAGgJCAUOAqgFKATICAAA+IAACP4HkgD+D4gDRwLEAjQKxAsECPwHAAD9gAgA7A+qAqoKqAruDwAAngckCSQJoggQBgKBAAz+A5IIkgj+BxwAqA+oCqQKpAqkDxAABYFQADQAnA/cA9QDtAOGA7QLnAscB1AAMAAGgQAM/gOSCP4HIAD4DxYA1AdUCFwK0AkQBAeBAAz+A5II/gcADMQDnAgGB6QHpACcDwAACIEADP4Dkgj+DwAM/AMEAOQPEgDyAUoGQAgJgQAM/gOSCP4HAAQoA+oICgj6D8IAIAMQBAqBAABQAFQA1A/gAt4C0ALUCvQHVABQAAAAD4EADP4Dkgj+DwAE+AMICEoI7A9ICEgIAAAQgQAM/gOSCP4HAABEDEwDNgA0AEwPRAAAABGBAAj+B5IAkg7+AeAHCAXuBKgECAToDwAAE4EADP4Dkgj+BwAAiAjoDxwE6gRIAVgOAAAWgQAM/gOSCP4HAAA0AXQJdAn+B3QBVAEUARqBAAj+B5IA/g8AA/4CSANABAAA/A8EAPwDK4EADP4Dkgn+BwgA9AySA5AAkg/8CBAIAAQvgQAM/gOSCP4HAADoD6gCqAL8D6gCrgroBzGBAAz+A5II/gcAAHgESgfMAMwPSgh5CAAGM4EADP4Dkgj+BwAA7g8ABEEFzgQABO4PAAA4gQAM/AMkCfwPIASQBSgEpgQoBxAHoAQAAD6BAAz+A5II/gcAAPwB1AFUAX4HVAFUAXwBSoEADP4Dkgj+BwAAFADeB1QFVAVeBdQHAABLgQAM/gOSCP4PAAD0DwQA5gxUA5QFdAgACEyBAAj+B5IA/g8AAOgDuALsB6gK+AsoCAAEUIHADzwApA+kALQGhAWmBZQF1Aj0CJQPBABUgQAM/gOSCP4HAACkCJQIhg+UCKQILAgAAFWBAAz+A5II/geAAEwItAdGAPQHFAj0CQAEZYEADP4Dkgj+BwAB/gjqCqoKqg+qCr4KgAhmgQAM/wPJAP8HAADvDyAEtwQoBSIE7QcAAG6BAAz+A5II/gcABHwDVABUB/wIVAhUAXwHcIEADP4Dkgj+B5IAqgf+BqoEvgOqBLoIAABzgQAI/geyAP4PgAD8D6AExA/4BwQA/AMAAHiBAAz+AxII/gcAAP4G6gHqBOoD/gjABwAAeYEADP4Dkgj+BwAAfAXuBewC7AX8BAAEAAB6gQAM/gOSCP4HAAC8AqwJLAjuDywDvAQABHuBAAz+A5II/geAAXgOeAD4BQgI/gMIDAoGfoEACP4HkgH+D4AB6gS4Bq4GqApqC6kGgAB/gQAM/gOSCP4PAAjuBwAI/AtUCNQJ/AoACICBAAz+A5II/gcAAFQO1AFUCVYJVAlUBwAAioEADP4Dkgj+BwAAeAV4BXgBfAl4D3wBeAGPgQAAZAA8D/wHvAe+B7wHvA/8DwwPZAAAAJiBAAz+A5II/gckAdQF/AHUD/wB1AX0BQAAmoEADPgDCAD4CPgH/gP8B/wH/A3cDxgAAACbgQAM/gMCCP4HEADKBagFrgeoBcoFGgUAAJyBAAz+A5II/gcAAHQFdgf0AXYDdAV0BQAJnYEADP4Dkgj+B4AAVAVMAj4PTAJMBVQEAACggQAM/gO2CP4HAABUCqIKvgpABVQFAgI+AKiBAAj+B5IA/g9AALQGvgR0BQAATAwiAwABs4EACP4HkgD+DwAAVA9WC/wLVAvWC1QPAAG9gQAM/gOiCP4HEAD4B5YItA+cD7QP0A/AAMCB8AAOAPoPugP6A74DgAP2C9ILPgdYAEAAwoFAADwA/A/cA9wD/AOwA7wL9gu8BzQAEADJgQAM/gOiCP4HAADwB7gF9wBVDKQC6AwAAMqBAAz+A5II/gfgAN4G+gH6B+oH1gHwAgAE04EADP4Dkgj+D+QH/g90B/QFHgD8BJwHWAzjgQAA/geSBJIEkgSSBJ4HkgSSBPIEAgQAAOWBAAD8B6QEpAS8B+QEAAyAA3wAgAEABgAI6IEAAPwPlAScB5QEcAuYBKYHVA/UBPQPBADqgQAAAAD8DyQJJAknCSQJJAkkCfwPAAAAAO2BAAAACXwFXAVcA14BXAFcA1wFfAUACQAE84EECKQItAisCKQIpA+kCKQIlAikCAQIAAD0gQAAvASkBJQHlAS0AiAIfgSIA+gCGAQICPqBhAn8DdwP3A3cDd4P3A/cD9wP/A2ECQAA/IEAAPwPRARCBEIEAAREBEQERAREBPwPAAAAggAA1A9UBUQFRAUUBCQFAgViBXoFyg8AAAWCAAAcBfwF/AX6A/AB/AH8BfwF/AX8AwAABoIAAAAJ/AVSBQAFXgF0AVQFAAXUBTwJAAAHggAAAAn8BVQFAAU+AXQBAAVUBdQFPAkAAAiCAAAACfwFBAX8BSwBXAEkAfwFQAX8CQAJCYIAAMAAfAJaAsAC7gfcAsgCXAL8AsAAAAAKggAAJAD0B/QH9gfwBvAG9gf0B/QHlAcAAAyCAAAKAMoPSgRKBH4ESgRJBEkEyQcIAAAADYIQAFAAUAdYBVQF8gVUBVQFWAVQB1AAEAAOghAAUABID0QJUgl6CVIJVAlYCUgPUAAQABKCEABID0QF8wVEBQgHYABqCPIPLgDiAAAAFIIAAJIP/gSSBNAP1AE0CJwPFAA0AlQAUAMXghAASA9WBXwFWAcQAMAPqAL+D6gC6g8AABiCEABYD1QF8gVEDwwA9A9WBVQFdAUcDwAAHIIACbAIUgVWAtIBFgDSA1IC2Q9VAlACAAAeghgJWAn+BtQC/AHUAPwD1AK8B9QCkAIAAB+CQAhABvwBRABMAU4BVQJECEQI/A9AAEAAKoJADPwDRwBVCfwHAADoDygALgDoDwgEAAAsgkAM/ANOAEUN/AMACN4IQgVCBs4FUAgAADCCAABADPgD1Aj4DwAAfg4CAfoHAgj+CAAGMYJADPwD1gBECPwHEADoBycIJQnoCDAGAAA1gkAM/APWAEUI/AcAAOgHigiMCEgIWAgABjaCQAjAB3wAVgn8BwAA+A+IBI4EiAT4DwAAN4JADPwDVwFFDPwDAAhoBFgHzgRoBCgHCAg5gkAM/ANEAFcJ/AcAALgPhgSABI4EsAcgAEeCQAz4A14BSgj4D7QH7AQACCQK/AsiCgACWIJADPwDzwhFCPwHAAC+CKAH/wSgBrwFgAhmgkAP/gBbB/4BAAT/B9UE9wfcBI8HpASkB2+CAAAACPwHVARUBNYEVAFUAlQFfAWACAAAcIIUBCQCxAF8BgAA/g9SCNIIUgFSBn4FAAlygiAAEAD4B5QIlgiUCPQInAiQCPAJAAQAAHOCAAAoASgB/g8oAQgA+AeWCPQInAjwCAAGeoIAAAQAJAQuCiQJpAikCGQILghECAQGAAB+ggQIBAgkBM4EBAMEAgQDzgQkBAQIBAgAAIKCBAAkACQALgDkDyQAJAAkAi4C5AEEAAAAi4KEAJQAlACWCJQIlAj0B5YAlACUAIQAAACNgoQARAA0ALYAJAEkAiQIJAguCCQM5AMAAJKCBABEAMQHTgREBFQEZAREBE4ERAREBAQAl4IECAQJRApmCdQFVAdEAg4DxABEAAQAAACZgoQIpAikBK4EpAL0AaQBpAKuBKQEpAiECJyCggiSCJIIlwSSApIB8geSCJcIkgiSBIIAnYIECEQERAJeBEQMdApECkQJ3ghECEQIBAilgkQARAgkBK4DJAAUABQAJACuDyQARABEAKaCAAgEBvQBVgFUAVQBVAFWAUwBzAMEAAAArIKEAEQIxAiuBKQDhACECKQILgdEAIQABACtggAABAD0B5YIlAjwCJQIlAiWCJQI9AgEBq6CAgDiDyIALwIiAbIAcACiAC8LIgjiDwIAr4IIBIgDCACcBwgIKAhICIgIHAaIAAgHCACxggAABAGEAOQPDgAEAeQHjghECEQIJAgABrOCJAgkBCQGLgHkALQIpAikCK4IpAckACQAt4IACAQIxA8OCAQIBAjwD4QIjgiECAQIAAC4goQApAikCK4PpAykDKQMpAyuDKQGpAiECLmCBAgEBPQDlgCUAJQAkACUD5YAjACMAAAAvYIECJQE1ASWApQClAmUCZQI9geUAJQAhADHggQAFAFUAVYB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5APWD/AL6AvwC9QL9gvkDyQAIAC/hAQAFACUD/YA9Af0BfQF9Af2AJQIlAcEAMSEkACUALQH1gfUB9QH9Af0B9YH1AbUAJAAyYQAADQCFAFWD5QJVAlUCVQJlglUD1QDAAHLhAQARAjUDtYK1A70CtAO1ArWCtQMRAlEANaEAAAEAPQO9gr0CrwAvAa0CpYK9AoECAAE3YQEAAQIZA8OCWQPBAk8Dx4J1AmUDwQIAADmhEABRAX8BP4G/Ab8BvwG/gv8CvwGRAAAAOyEFAhUBMQHDgjkC9QLtAu0C7YLtAs0CkQA7oQACLQE8gMDBPoJWAtaC/4LXwtaC/oLAAIRhQQAdAzUA9YB9ArUCNQJ9gbUBtQI9AiABBOFAAjEC3wLfgv8D3wHfAf+B3wLfAvECQAIF4UEDPQDFAhWBNQBVA1UAVQF1glUAFQOBAAahQQP9ABUDNYB1A/wAQQEpAEmCPQPJAAAACGFJAmkCJQF3gG0CZQJhA/2AdQFtAwUCQAAI4UECXQHRAHuDwQAVAWQBXQJVgk0DxQBAAErhQQIVARUANYB1An0BfQB9gH0A/QF1AMAACyFBASUB/QHlgQEAFQPdABWD1YAdAd0CIQENYXEDzQA9A92BXQHdAXUDX4ElAf0CDQIAAY6hQQAxAcUAMYD1APUA9QD1gdUBhQE9AMAADyFRABUBMQHBgB0AfQH9Ab2BfQG9A70BwAAPYUUANQPxAfuD8QD1A+ECO4EJAPkBSQIAABDhUACSgJKD+sLSgt4D0oLRgvnC1YPQgEAAkmFJAgkBvQAdgF0DXAB9AF0DXYBdAEUDQAASoUEBnQABAauCEQFVABUA0QGLgiECTQIBANphUQIVAwEAo4AhAX0BfAD9AX2A/QJhAcEAG2FAAAkCHQHdgdwD/AHdAJ2D3QHdAckDwQAcoUEAOQB9AHmB/wB7AEEDP4DTADMD0QAAAB0hUIKYgnSCkcFIg0CCPoPqw+qD6oJ+g8CCH6FAABkACwP7gssC3gPLAvsC64LLA9kAAAAhIUkBEwHRAAWAfQB9AP0Af4F9Af0AfQBAAGHhQABNAGEDwYAtA6wALQOhADeCCwH5AUgCJuFAAD0D1QFVgV0BwQAlALeApQP1AKUAoAApoUEDvQBtAi2A/QLtAO0C/QDtge0C/QHBACphQAA+g86AMMN6gMoCKoKrgq/D6oKqgogCKqFBARUAVwJ3gd0AQQM9ANeAFQA1A9UAEAArIWEAJQIRAUGBfQDtA+0AfQDBgVEBZQIlACvhQACdAPUA9YP9A/UD9AP9A/WD1QPdAEAALCFAgiKDf4F2wHeBf4B3gX+Bd8B/gWKBQAAyYW0BLQC9A+2AZQCBADUD/4K3Ar0CtQPAADNhQAA9AT0B/YF9AfwBQQHXAVeBVQHVAQAAM+FAAl0B0QB9A/2A7QG9AYeD/wEFAfUCBAE0IUUBlQGVAPOCiQHBAD0CVQHXgFUD/QJAATVhYoEqgL6D6sDqgECDvoB+wOqA6oJ+g8AAN2FBANcB1wH/gv8C5gLQAc2BxQHdAqEAkQA5IUEDPQDVAn2DwQBdAX0AH4PZAL0BWQJAADlhQAItAXkBQYF9AGwD7QB1AN+A2wFBAUAAOmFIgRqAwIBNwCyD/IKsgqzD6oK6g+iAAAA+4UCACoMSgMLBeIDvgN2D5cPdgO+BeIFAgUHhiQM5AF8Df4BdA3kBAACVAH2D0wBTAYEAAuGRABkC0QI7gVkAnAI9Av2CvQC9Ab0BwAIEYYCCPoHCgRrBWoPagsKC2oLawtqDyoBCgAthgAAAAD+D/8H/gLgB8AC/gP/BT4A/gcAADiGBAD0D/QGfga0BvQLJA7+AH4F/AN0ARQFToYAAAAM8AMQCFAHfgHUAbQHlAi0CLAEEABPhgAAAAz4AwgIKAk+B1wBXAVMCVwNWAMIAFCGAADADzgAiA+oCr4K3ArcCswK3ApICCgAUYYAAAAP8AAQBlAAfgbUCLQKtAiUArAGAABUhgAM+AMICCgJKAs+DWwFbAtMC1wJWAkIAFWGAAz4AwgLqAaoBj4JXAjcC9wI3AtYCggAWoYAAAAP8AAQClAIfg60CLQOlAi0CpAIUABbhgAAgA9wABALUAp+D1QItA6UCrQKMAgAAF6GAAAADPwDBAiUC38HtgO2A7YH5gcsCgAAX4YgAO4EqgSqAyYG8AEYDDgDXwBaB0oEGAJnhgAM+AMYAd4PvA+MCxgI8gCSCJIIkgcAAGuGAAAABPgEiASIBP4HiASIBIgG+AQACAAAcYYABPQFNAU0BfQHNAUsB+wHBAj8AwAMAAZ5hgAA+ASIBP4D+AIABAQEBAT8BwQEBAQABH2GAAAACNwLVAlUCfQHVAVUBVQF3AUACAAIfoYABPgJjgf+B/gGAAgEAPwPJABEAIQAAACAhiAAFAjKDwgEGALwCIgIiAT+B4gEiAX4B4GGAAj4CYgE/gf4DgAIeASCBQwD4AQcCAAIgoYAAPgE/gOOA/gHAAB0AUQBRAl8DMADAACKhgAA+An+B44H+AYACBgI6gwKB4gDeAQICIyGAAD4BIgE/gf4BgAEKAEoAf4PJAEkAQABk4YAAPgEjgf+B/gGAADyCJIIngcAAP4PAACVhogASgjqCVoJTgnqB0oFSgVaB+oHSgxICJyG+AWIBP4HiAT4BBICIgGiCWII/gciAAAAo4YAAPgJiAT+B/gGAAw8AAIOwAkOCHALIAykhiAEIgTSBVYFWgXSB1YFWgVWB9IFIAgAAKqGAAD4CYgE/gf4BgAMJADIAgAC/g8AAQABr4YAAPgJiAT+B4gE+A4ACPwPIgjiDyIIAADAhgAA+A3IBP4D+AoADMgIygj6D8gIyAgACMaGAAT4Bf4HiAT4BgAI/A8kCSQJ/A8ACAAAx4YAAPgE/geIBPAGCADoBwoJjAiICFgIAAbJhgAI+AX+B4gE+AoAAFgARAJTBkQJyAAQAMuGAAASBMoFSgVSBd4HVgVWBVYH1gUSCAAA1IYAAvgCzgP+A0gCMAP+D2IEkgRiBP4PAADZhgAA+Az+B/4H+AYACCQJJAm/DyQJJAkgCNuGAAj4Bf4HiAT4BgAAXgZIAf4PSAFIAgAE5IYAAPgESAT+A3gDIAC4D6YErASwBKAPAADuhgAEFATUBUQFXAXGB0QFXAVEBdQFFAgAAPmGAAj4Bf4HiAT4CgAA5A9kAvQPbALkDwAA/oYABHgE/gN4AwABlAj8B5AMfgKQBVYIAAYAh0AAXAD0BXQFfAX0B3QFfAX0DTQI/AcAAAKHAAj4Cf4Hjgf4ClAASAVuBdQPbAVEBUAECIcACPgF/geIBIgE8A5MCVQF1ANUBVwJQAkShwAA+AX/B/gGAgi+B0II8AsCCv4LIgoACBOH+AWIBP8HiATwBhoP5gUACCQK/gsiCiIKFYcAAPgEjgf+B4gE+AIwDM4DyA9OCHkIAAYXhwAA+AX8B4gEcAKMD1QAVAH0AVQI3A8AABiHAAR8Av8DxAd4DCsC/AEkA/4FAgL+BwAAHIcAABQEpAekBrQGtge0BqwGjAaUBxQIAAAhhwAA+ARIAv4DeAMABtQHXgVUBV4F1AcQADuHAAD4BYgE/gf4CgAA/A88Az4DPAv8BxAAR4cAAPgJ+ASOB/gGAAj8A7QC9Ae0CvwNAARJhwAA+AmOB/4HiAT4BnAAqgL4D6wC+gIAAEyHAAR4Av4DOAOAAP4PkAAkAAgB/g+AAAAATof4CYgE/geIBHgB4AdeBGoFagVqCP4HAABXhwAE+AWOB/4HiAfwCLwK1ArWD9QK/AqACFmHAAj4Bf4HiAR4AsAHvALUB1YB1AdUAdwHYIcAAPgJmAj+B/gKAAD0D1QK1A9UCvQPBABmhwAI+AT+B4gEcAL+D5ICDghgCWIH3ggACHSH+AmIBP4HiAR4AIAHfwKAD/4DEgj+BwAAdocACPgF/gf4BgAAfA1IA/wPaAN8BUgJAACChwAI+AX+B4gGcAT8B1YFPAL4DwQA/AMAAIOHAAj4Bf4HiATwDgQIVAbcAVYJVAlUBwAAjYcEAPwP7ATsAnwJgAd4AIgI/geIBPgGAAiehwAA+ATOA/4DSAIwAX4GqgL+AaoJggcAAJ+HAAT4Av4DyAJ2A34JWgVaBdoBWgV+BQ4JoocAAGIE6AfuBuQG4AfyBugG7gboB3QIAAi6hwAA+AmOB/4HiATwBR4J6g1+DyoBvgsACsCHAAj4Cf4H+AYACJQC9ALuDtQCBANUAgAAxocABPgCSAL+A0gCMAtkCHYH9AF2A3QNAATLhwAE+AX+B4gE+AQAAlwENAl8CTIAWgaQANGHAAj4Bf4H+AYACPQDdAN0A3YP9AMQAgAA8ocAAKALrAqsB6wHPgisA6wKvAesBqAHAAj5h4QEfAQ3Bb4FtgV4B8oHtgWyBboHNggAAPuHAAT8Av8DRAJ+ATsL2g9+A+oHKwdqCwAJDYgACPgF/gfwBnwPPAO8B+ADMAf+AAgDOAQViAAI+AX+B/gCAgA6D0oH3gFaD2oBag9AAB+IAAD4Cf4HiARwAiYPeAt0APoPUAR+AwAMIYgAANQF3AW+B78Ftwk/AJcFrQesBaQFAAAiiAAAqgWeBf4H/gX+Cf8A/gX+B54FqgcgCDuILAAXBN4FQAV2Bf8HfgVwBWQFvwc0CBIAQIgABPgHCAQIBPwHCgQIBPgHCAQIBPgHAARFiAAA+Af8B/oH+AMCABwBIAH+DyABLAEAAEaIAAggCbwEJAS8AKYPfAEkAiQFvAQgCAAATIiIAEgA5A8SAAAAJAAkACQIJAjkDyQAIABNiIgARADzDwgAIgwiAoQBIAgiCOIPIgAAAFOIQABEAPMPCQDIAf8HCADDBRAE8gcSAAAAVIgAAMwA8g8YAIYI9QeUBAAAJAjkDyQAAABXiEAARADyDxkCUALeA1QCVAYABPIHEgAAAFmIAADIAOQPAgBUD3wFdAdkACQAJAjkByAAW4gEAEIA+Q8IAPoD3wLaB/4CAgDyBxIAAABdiAAAJADyDwgAeglaCf4H+gUJBCAA5A8gAGGIAABEAPIPCAn4Ba4D/AOsDfgBAAjkDyAAYogAAIwA4A8cALwHnAeYB7wHvAQAAOQPIABjiIAAiABICMgPKAgaBDwEyACIA0gEKAgACGWIAAAIAYoA6g+YAEgBAAD+DyAAQADAAIAAaIggATQJtAS0B3QEPgT0BDQBtAK0BCAIAABpiAgBiADuD5wAQAkcCOQEFAOEAnQEDAgAAGuICAGIAO4PnABIAQAIiARIBEQCMgIQAQAAbIgIAYgA7g+cAEgBAADQABAJEAj+BxAAAABwiBQBFAV8BVwH3AReBNwEXAFcA3wFFAUQBHeIAAAEAnQCVA5UCfYIVAlUAlQGdAkECQAAgYgAAhAC9AK0DrQJvgS0AbQCtAZ0BRAJAAiEiAQBhQD3D44AZAEADCICogF+AKEDIQQgBIuIkAKIArwKgg6ICcgIjgmYAqoGygrKCqgIjYgAAYwA7A9YAQAA8AcsCSgJ6AsICvgJAASSiAgBiADqD5gAAAj8CSQJJAkkCSQJ/AkACJaICAGIAOoP2AAAAPgPiASIBP8HiASIBPgPnIgAAYoA6g/YAAAESAJIAf4PSAFIAkgEAACriAgBiADKD7gBAAz4A8gISAl+BkgGyAkYCK2IhAKkAqQKlA6MCaYIvAnWAtYG1AXEBbQIsYgAAYgA6g/wACAA/A8CABAH/gCQAxYMAAC0iAgBiADsD5gAAACoALgDrAKoCpgKqAagAMGIAAFUC9QHXgRUAVQDEAz+AhAD0gQUCAAGwojWAtYC3gquDp4JxgSAAZ4CwAbABf4JAAjFiKACrAKQCrwOgAmoBKgBvAKoBqgEqAgAAMaICAGIAO4PnABIAQAELAUgBT4FIAXsDwAAz4gABEQFfA18D3wJ/gl8A3wFfAV8C0QLAAjUiBQA1A90APQHbAVkBWYFzAbUAKQPJAAAANWICAGIAO4PWACIAAABxA+yCIgIsgjED4gB2IiABKwCrAqsDoQJ3gSEAaYCrgasBKQIAADZiAABiADrD9gAgAIqAeoHvgSqBKoEvgcIANyICAEIAc4PuAAAAOgPqAKoAv4PqAKqCuoH3YiQAr4CmAqYDr4JgASoBKgBvgKoBqgEiAjhiAgBiADsD9gAAAB8CVQJVAn8D1QJfAkAAOSIAAGKAOoP2AAADPwDRAC2ApQPlAKUAgAA84gAApwEhQK2DrQJ9gS0AbQCtgaFBJwIAAD4iAgBigDqD9AAgAT8BNQC1A/8D9QB/AKABPmIgAJEAnwBfAf8BP4EfAF8AnwCfAXEBAAA/YgIAr4CnAq+BpwF/ASAAZwCwAbABb4JAAQCiQAAxAD1D2wAAASUBN8HlAQAAP8HIABAAAeJgABIAO4HeAAABT4F/gW8ArwCvAW8BAQEEIkIAYkAyg+4AAABvgeqBKoFqgaqCL4HAAASiSACFAL0AgQOZAl8CT4JfAI8BnwFJAkABCWJAAGIAMwP+AAADvwBdARcATwJ3A8cAQAAKokAAIgB7A/YACAI7AcACPwLVAhUCXwKAAgyiQABlADUB7AAAAT4A+gD7AP4B+gD6AMIAkSJQAXEBfwD7A/8CcYJ/APsBewF/AlECQAAX4kAAIgA7g/cAQAJTAVeAVAPTAFeBVQJEAByiQAFDAV8A34PfAt8CQAJfgP8BfwL4AtACX+JBAD0D5QE1AQ8BBQEFAR8BJQElAT0DwQAgYkAAIIIugiqC/4GqgSqBL4GqgWqBLoIgACGiUQBXAG8D1wA3AjsC/wH/Af8B/wLPAgACIeJAgBeB9YH1g/eB1YHFgz+A7YCtgr+BwIAi4kACAAI/AlUBVQDVAFUAVQHVAn8CQAIAASPiUgISAT8A0gBSAoACPwFVANUD1QJ/AkABJOJAAgMCPwL5AbkBuwC5ALkBuIK+gsCCAAElokIAYgAzg+4AAgJAAj8BVQDVA9UCfwJAASaiQAIOAgKCOwL6AbqAuwC6A7sCwoIOAgABKeJAAg8CPwL/Af8B/wDwAPsB+gL6AsoCAAEqokAAKQErALmD6wCoAj8BVQDVAFUD/wJAASziQAAMAHsB7gH6AeoB/wNVANUAVQH/AkABLqJAAAwCB4I3gvQB9oD2gPYD94LHggwCAAEvYkACD4I7gv+B+4H7gPAA/YH/Av8CzQI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AAAAAPwProsgACQI7A8ABAQCeAiCBQwCgAV4CAQIAAiviyAAJAjkBwgCQAJEAPwPRAAEAPwHAAgABrCLIAAiCOQPCAQAAMQHRAhECEQIRAj8CAAGsosgACII5AcAAogIiAT+A4gAiAD+D4gAgACziyAAJADoDwAEiAKoAKgA/g+oAKgEiAMAALaLEAASBvQBBAWADDoCIgGiCGII/gciACIAuIsgACIA7A8ABLAAjgCIAPgPiACIAIgAAAC5iyAAIgjkBwgCYAD4DwYAgAD+ByAIGAgIBrqLIAAiCOQPCAIgAJAHCAmGCIgIkAggBiAAvIsgACII5AcIBGAAGA6GBWAEBgUYB2AIAAC9iwAAJAjkBwgCAAz8AyQGxAEkAvwHAAgABL6LIAAiCOQHCAIgCqAIXgVCAkIGfgXgCCAIv4sgACIE7AcEAgAICAb4AUoISghICMgHCADAiyAAIgTkBwgCQAlIBEgD/gDIA3gEQAgAAMGLIAAiCOwHCAIACOQPBAgECPwPRAhECAQIxIsAACII7AcEBIACugCCAP4PggCyAIoAAADFiyAAJAjoDwgEAAD8DyQJJAkkCfwPAAgAAMaLIAAiBOwHCAIACHwGRAFEAEQARAF8DgAIyIsgACII7AcIAmACEAAOAPgPKAEoASgBKAHJiyAAIgjkDwgEAAD8DyQAJAHkDyICIgIAAMqLIAAiCOQHCAQAAlAISAkGBcgEUAIQAQAAzYsgACII5AcABgIA6gMqASoB6gkCCP4HAADPiyAAIgTsBwQCIACiD5oEhgSiBKIEngcAANGLIAAkCOgHAAIkAqQCrAKUD7QCrAIkAgAA1YsAACII4gcCBAgASATIBwgC/gAIBwoMCALXiyAAJAjoBwgCoACoAqgCvAioCOgHqACgANqLAAAiDOwDAA74AygAKALICX4EiAfqCAgG3YsAACQI6AcIAiAApA+kCPwIpAikCKIPIADeiwAAIgjsBwAAsg0uA8IE8AkCCv4LIgoCCuGLAAAiAOwPAAD4DxYA1AdUCFwK0AkQCAAE4osgACQI7AcABBAAyAOuAqgK6AsICPgHAADliyAAIgjsDwAEJAG0CKwEZwQkBhQFhAgAAOaLIAAiCOQHAAIIAEoBSgH4D0gBTgEIAQAA54sgACQI6AcAAhgACAEoAe4HqAiICJgEAADriwAAIgjkDwAA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gAT/BJgEmA8YAL+MAAQQBPwF9APsA/AB9AHsA+QD1AUMBAAAwIwAABQIzAvmCvQK7ALgAv4K8gryCx4IAAjDjBAACADcA8QL4AvqA+oD/gvqC+kDKgAAAMSMAAj8DVQFVAH8BUAA+A+sAqgCqAroBwAAx4wQCBII9Av0BuQG9AL2AuwG9Ab0CxQIAADKjAAI/A1UAVQF/AFIAOgJSAR+AogFbAgIBtOMIAAsCOwH/AbsAv4C7AL8AvwG/AcMCAAI24wAABwIzAXuBewF7AHgAfwF7gX8BRwIIADcjAAI/A1UAVQF/AUAAb4C6gmqBKoDvgiAB96MAAAcCMYP9g30DfYF9AX0DfYNxQ8cCAAA4IwACPwFVAVUAfwFIAC0B6QEpgSkBLQHJADijAAIPgj6B/4H+gf6A+AD4gfaB5oHJgggAOOMAAQ6CO4H7gf+B+8D7gP+B+4H7gc+CAIA5IwACPwFVAVUAfwDqAjsBBgH2ga8CbgJEATmjAAI/A1UAfwFAAjUDxQI0AeQBP4DEAwUBuqMIAAcCMwL7Ab6BvgC7gLqBuoG2gsKCAgA7YwABPwHVAFUA/wFAAGkB/4FpAW8BaYHIAD0jAAEeAJYAfwPWAE4AMAL7ArkAvQG7AcACPqMAAD8DVQB/AIICGwF+A9oAfgPbgPoBUAI/IwACPwNVAFUA/wGwA/sAv4C7Av+CuwHIAL9jAAArAh8BPwH/AP+A/wD/AP8B7QEpAQAAAiNAAj8BVQB/AUAAPwP5wrkCvwK5ArnD3wACo0AACgI/g9eDVwFXAV8BV4FXgXsDxwICAgPjQAMggO2CjoHugm7A7oFOgC6B7oPCgQAAB2NAAAACPwJBAQEBAQC9AEEBAQE/AkACAAAHo0ACAAI8AsQCBAEHgLUARQEFAT0BQQIAAAfjSAIEAj4CRQIFgQUAtQBHAQQBPAJAAgAACGNAAAUCNQLVAhUBlwBVARUBFQI1AsUCAAAIo0ACP4JAgT6AwIA/g4AAAgDiAhoCP8HCAAjjRAAFAjcC1wIXARcA14AXARcBNwFFAgAACSNAAAeCMAFQAReAkABZgRaBFoI1gsSACAAJY0ACP4IAgb6Af4MAABwCI4EiAN4BAgIAAAmjQAEfwf5AAEC/wIACP8HIAToACYDIQQAACeNAAAICMQLXghBBkQBTwRUBFQI0gsKCAAAKI0AAPAHDADsCSwELAK8ASoEKgTqBQgIAAApjQAAfA/0AAQC/AAADvwBNAzUAhQD8gQECCqNCAAICNQLVAhSBFoDUgB0BFQE1AUECAgAK40IACgI7AtqCFoESANoAGoEXATEBQgICAAsjQAI/g3yAwIC/gAADCQCIgYqCeIIIQgACC2NAAj8DeQDBAD8DhAAzAEKAcgJCAj4BwAALo0AAPwJBAT0AwQA/A4QAAgEDgQIBAgEOAQvjQAACAj8C2oIagZ+AWoEagRqCP4LCAgAADCNAAAoCLgJuAS4ArgIuAsICP4BCAYOCAgEMY0ACPwIBAb0AfwCAAhQBP4EUAdUCVAJAAQ0jQAI/A30AwQA/AYAAIAP/gSIBIgEiA8AADWNAAAgCPwLdAh0BHQDfgB0BHQE/AUgCAAAN40QAAgI3AtCCEgESANOAFgEagjiCxQAAAA4jQAAAAjcC1IIWwRAA1IATgRiBOIFHggAADmNAAhACN4LdghfBFYDVgBfBFYE1gUWCAAAOo0AABQI1AtOCGQGXAFABFwEVAjUCxwAAAA8jQAE/AL0AQQE/AAABugBCAh+BIgH6ggIBj6NAgg6COoFagR+BGoDagB+AmoE6gU6CAIAP40AAPwN9AMEAPwFwAD4D64CqAKoCugPCABBjQgABAjfBUAEagNqAGoCfgJqBOkFKggAAEKNAAj8BuQBBAT8BAAAyA/WBKQE1ARMD0AAQ40AAPwN5AP8DAAM+AMICEoI6g9ICEgIAABEjRAIEgjUBUAEaAJmA1YATAJUBNQFDAgAAEqNAAD8DeQDBAD8DgAAUANoCOYPaABIBxAES40AAPwN5AP8AAAI1A8UCNQHEAD+AxAMFgZMjQAA/A/0AQQE/AWAANQPfgVUBVgF1A8QAE6NAAj+BfIDAgD+BQAApAlUB/4BFAU0CQAAT40AABwIhgu0CLQEtgK0ALQEtgSFBRwIAABQjQAI/AkEBPQDBAD8DgAAvgDqC6oGqgm+B1SNAAj8B+QBBAT8BQAAqA+kBKYEtASkByAAVo0ACPQElAL+D5QB9AoACPgH1gMcCPQLAAhYjSAELgSeBV4EXgJeA0gAbAJeBJwFJAQkAFqNAAj8DeQD/AAACFoF/A9YAfgPXgX4CUAAW40AAKwIvAj8BbwEvgK8ALwE/AW0BCQJAABejSAALgicC04IfARAA24AXAROBJwFLAgoAGCNAAB+BAID+gACAn4AmAd/BXwFfwX8BwAAYY0AAPwN9AP8DAAA+AcOAOwPzAvIC9APAABijQAM4gO+Cv4H3gw/A/4M3gc+Af4PBgQAAGSNIAKkAaQIJAbkAT4IJAjkDyQApAAgAwACZo2ACSQE5AM+COQHJACACTQEygKIA3gECAhrjYAJJATkAz4I5AekAIAH5AE+COQHJACAA3CNIAgoBKgDKAQoBPwPKAkoCSgJKAkgCAAAdI0QBtQBFAL+A1QEVARQBAAE/gUIBBAEIAR1jRAG1AEUAf4DVARUBAAFzAQwBEwEggUABHaNIAykAyQE/gekCKQIAAgkCPwLJAgkCAAAd40QCNQHFAL+B5QIlAgACOQJJAokCjwKgAmBjRAG1AEUAf4DVARQBAQFUgUiBaQEiAQIBIWNAAjYBxgE/AeYCBAI1AtMCmQKZArcCwAIio0gDKgD/AeoCAAI+AmICAgKfgnICioKAAiLjSAGqAEoAv4DiAQgBBgFVgVUBVwF9AUABJWNIAaoASgC/AOoBQAFXATcBNwF3ATcBAAEmY0gDKgDKAL8B6gIAAj0CzAIvAiQCvQJAAifjQAIpAckAv8HpAgECPQLkAheCZAI9gsACKONFAAUBJ4D9AMQBP4EqgT+BQAE5AUcBQAEqI0QDNQDFAL+B5QIpAjvC14JSgluCN4LAACzjQAAAAg8BKQDJAQkCOQPJAkkCTwJAAgAALSNAAjeBxIE8geeAAAO/AEAAAQA/AAABwAIvo0ACN4HEgTyB54AAAj4DwAI/g9ACEAIAADDjQAI3gfyB5IEngQAACQMIgP+ACIDIgQgCMuNAAieDxII8geeDAAICAf/AEgLSgbKCUgAzI0ABN4HEgTyA14CAAhOBEgD/gBIA0gESAjRjQAE3gcSBPIHngQAAPoHtAj0CgQK/AkABNuNAASeDxIE8geeAAAM+APICX8GSAXYCAgI3Y0ABNwHFAT0A5wCAAD8DxQFFAUUBfQFAATfjQAI3gcSBPIHngAACPwPVAjUAVQGfAUACeGNAASeB/IHkgQOAuAM+AMOCPgHCADoAQAA6I0ABJ4H8gfyB44EIAC4A6gKrAq4CqgGqADqjQAAHgfyB5IEPgz4BxYA1AdUCFwK0AkQBO+NAAjeBxIE8geeBJAAiA/WCKQIvAjED4AA840ACN4H8geeBAAA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dAV0BfwPIASTjwAAfAJGAvQPIAD4D7QC8g+UARgI8AcAAJWPRAB0Ak4C5A9AAhAC9A60Cb4JtAJ0BRAJlo8AAHwBRgH0B0ABFAC0B7QF9gW0BZQHgACZjwAAdAJOAuQPFADuB7QK5A90BIoDeAQACJuPIAAkASwBPAEkAecPJAE0ASQBJAEgAAAAnI8AAEIFXgVWBdYFVgV3D1YF1gVeBQIFAACejwQAkg+SBP4EkgcQAEQBdAHGD3QBRAFAAJ+PAAT8A6QPpAS8BwAAWAFIAc4PaAFIAUAAo48AAEQJVAnHB3QBBAjwBJQC/g+UAvQEAAimjxAIzAfoAUAIEAf+AOAPCABaAcYPaAEAAKiPRABVCcYHdAEACHAG/gEAAFQBxw90AUAAqY9EAFUJxgd0AUAADgjkBwAAVAHHD3QBQACrjwgAWgnsB0ABHATyBIgEAARVAccPdAEAAK2PBADMD1IBegfWANYPAABUAccPdAFEAQAAr48IAFoJ7AdIAUgPawVoBwwAXQHvD0wBAACwjwAAAAz8A0QA1A9UCFQE1AFUAlQFVAlACLGPAACAAn4CIgbqBqoCKgpqCqoG6gJiAwACso8ADPwDbAnsCf4H7AnsBf4H7AXsBfwLQAm5jwAIIgTsAwgEAAgIC8gIPggICggK+AkABLqPQghGBMgHAAQECMQLPAgECgQKBAr8CQAIu49ICFIE1gMEBBAIEAgQCP8LEAgQCBAIAAi8j0IIQgTMBwAIAAqCCWIIPgjACAAJAAoAAL2PAAgkBOgDAAQECAQKBAr0CxQIDAgECAAAvo8gCCIE7AMABAgICAvICD4ISAiICAgLAAjBjyAIJgToAwAEJAgkCCQI/AsiCCIIIggABMKPAAgkBOgDCAQgCCQKJAr8CSQIJAgkCAAAxI8gCCQE6AMABDAECAmsCmgKKAooCggJAADFjyQIJAToBwAEJAgkCPQLJAgECPwJAAqACcePIAgiBOwDAAQICCgIyAgICggK/gkICAgIyI8kCCQE6AcACAQLxAg8CBQIFAoUCvQJBATOjwAIRgzIAwAE/AkECQAI/AsECAQJ/AgAANCPIAgkBOgHAAgQCtQJNAkUCVQJlAkUCgAI0Y9CCEIExAcACAAL/ggSCBII8gsSCBIIAADUjwAIQgTMBwAIAAv+CDIK0goSCdIKMgoCCtiPAAgiBOwDCASACEQIJAj8CwQIJAjECIAI2Y8ACCQE6AcACCgKKAnKCEwIuAgICQgKAADbjyAIIgTsAwAESAhIC/4ISAhICP4LSAhICNyPIAgkBOgHAAgQChQJ9AgUCPQLFAqQCQAA3Y8ABCIE7AMABFQEVARUBP4FVARUBMQFAADejwAIIgTsBwAEFAksCSYJ9AskCSQJBAkAAN+PIAgkBOgDAAQACfwIJAhkCOQIJAk8CgAI5o8ACE4EwAcEBfwEBgj8CwAI/AsECvwLAAjqjwAIJAToBwAI+AtICkgK/gtICkgK+AsAAOuPRAhEBMgHAAQACPgLSApOCkgKSAr4CwAI8I9CCEIEzAcABIgJaAgICP4LCAhqCIoJAAj0j5AI1AS0AwAE/AkECvQKlAr0CgQK/AsAAPePQghGBMgHAAgkC6gIYAj+C2AIqAgkCwAK+Y8ACCQE6AMIBGAICAv6CAwK+AsICOgIAAD9j0IIQgTEAwAE/AlUClYKVQpUClwKwAsACACQQAhCBMwHBAgACv4LKgpqCKoJXgpACgAAAZBCCEIEzAcABEgITgpICfgISglKCkgKAAgCkCAIJgToBwAEFAjUC1QKfApSClIK0gsQCAOQAAhECMgHAAScCEAK/gkACP4JQAqcCoAKBpAACE4MwAMIBOoIjgqICvgJiAiOCOoICAgJkAAIJAjoBwAIIAqsCWgIPgjoCygKKAogCQqQAAgiBOwHAAQiCPoLRggwCv4LAAg4CMAADZAAAJII9AaUBQAI9gsQCF4JEAmUCvILAAgPkAAIJAjoBwAELAgsC9wIXAicCqoKqgkgCBCQAAgiBOwDAAQSBaoIrgpSCuIJUgiKCAAEEpAgBCIE7AMABHQFVwXUBPwFVgRVBdwEAAQUkAAITgTABxAESAlUCFQK8glUCEgJUAkQCBeQAAgkDMgDEAQECHQK1ApUCtQL9AoECgAIGZAAAFQEfALYAwAE+AV4BXwFeAX4BQgEAAQakCAIIgTkAwAE+gmuCK4I+guuCK4K+gkAABuQAAgkBOgHQAguC/QIAAokCvwLJAokCgAAHZAACCYI6AcACEgK/gkICPwLEgjyCxIIAAAekAAA0gi8BpgFAAi8CrQK9Au0CrwKAAoAAB+QQghCBMwHAAh0ClQJ1Aj+C9QIVAl0CgQKIJAACCQI6AcABCAIrAuoCrwKqAqoCyAIAAAikAAIJgTgBwQIlAqSCq8K6guuCqoKCAoQCCOQAggmBOQDAAR8CVwJXAn+C1wJXAl8CQQJLpAACE4IwAcQCJQKVApUCP4LVAl8ChAKAAgxkAAIQgzMAwAE/gkCCOoJegnqCQIK/gkACDKQAAhGCMgHAAQQCP4LqAr8C6oKqAoICgAIOJBCCEQExAcQCHgKVgnWCHQI3AtQCnAKAAE7kCAIJAToAwAEnAhUCnwKVAlcCdQIHAgAADyQJAgoBOgHgAt8BWwN7A9sDWwN/A8ACAAAPpAACCIM4gMIBOgF/Aj8CwsI6ggEDOgPCABCkAAIRgTIAwAEKAluCdgIqArICa4IqAgICUWQQAhEBNgDAAX8CBQI1AnUCdQL9AncCQAIR5AACCQE7AcACP4Lagj+CX4Jagt+DMAPAABKkAAIRgzAAwQF/AgXCuQJDAhGCvQLVAhECEuQAAgiDOQDAAR6CXoJegn6C3oJegl6CQABTZAACCIE7AMABfwI1Au0CPYLtAj0C7wI4AtOkAAIQgjMBwAI4As+COIJegnqCT4I4AsAAE+QAAQiAuwDgALcBTwFvAW8BTwFPAf8BwACU5AgCCQE6AcABAgI+gu+CrgKvgr6CwgIAABUkAAIRgTIAwAE1An0CdQJ3gvUCfQJ1AkQCFWQAAhECMgHAAj8CtwL3AreCtwL/AqICgAIV5AACCIE7AMABO4IagpqCX8IagrqCi4IIARZkJAI9gaQBQAIuA6kDrwO9g+sDqwOpA6ACFyQAADRDLYCEAVCBPoJBgpcCPYLQgjBCgAAXpCQCPMEFAOABH4IAgvyCD4Kfgh1CXUKMAFgkAIIQgjCBwgEfAlcCdwI3gtcCfwJiAoACGOQAghCDMQDEAT8CfwK/Ar+CvwK/AqQCwAIZZAACCQM6AMABEwJfApkCuwLZApiCmoLQABokIAI1ggwBwQG9Al+DVQNRAsQCI4LeAoICmmQAAhGDMgDAAT0CTQI/Al2CfwJNAr0CQAIbZAACBEE9gMABP4Jvgq/Cr4Kvwr+Cx4IAARukAAEJgLoA4ACfAQUBXQEVgZUBXQEFAUAAHKQkAjUBLQHAAb8CQwItAqMCtwLjAq8CgAKdZAACCYI6AcABHwJbgtsCWwJfA3+D3wJBAF3kIAI1AS0AwAF/AjsC/wM7A78D+wMfAkACXiQAQgmBOQDgASuCu4K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SgJABAAAyJEAAJYBUgD+B1UAAAb/ASEA4QAhAz8MAATKkQAAKgOiAP4PowCqAKACrgKSD6oCpgIiAsuRBACsAfwPogCoAD4C+gK+AroHvgL6Ai4CzJEAAAAEvgSqBKoEqgT+B6oEqgS+BAAEAADNkQAAEAT0BfQF9AX8B/QF9AXyBfIFEAQAAM6RAAB8CVQJ/AdUBXwBAAgkCPQPLADkAAAAz5EAACAE/Af8B/wH/Af8B/wH/Af8ByAEIADRkRAAsAiQCZgLlgjxD5IIlAiYCpAIMAgAAN2RUAhYC1QI8gdUBEQFAAAgAP4PIAAgAAAA45FQCFgLVAjyB1QERAUQAM4ICAkIDPgDAADnkUAIWAtUCPIHVAYADP4DAAD8BwAA/g8AABWSUAhYCfYHVARUAQAIRAj8D0QIxA98CEAAHpJQCFgLVAjyB1QEWAUGASUJJAkEBfwDAAA0klAIWAtUCPIHVAUQBEgA1w9SAEwE0AcQAESSUAlcCPIHVAREARAETgRIA/4ASANIBEgIcZJQCFwJ8gdUBAAN+AMIAAgH7gQIBIgHAAh0kkAIXglAC2AJXgnQD1YJZA00CVQJRAgAAICSUAhYC1QI8gdUBwAA/g9KCMoBSgZ+CQAIg5JQCFwJ8gdSBAQNZAQ0AywAJgC0DzQIRAaFklAIXAnyB1IEhAT+DwIA6gMqAcII/gcAAJiSWARUBfIHUgREBRACGAGUD+YEnASEDwAArZJQCFwF8gdUBFQBAAioBP4FqAaqCaoIAAazklAIXAX2B0AFEAD8BJIGkAGSD/QIGAgQBLeSQAhQCVwE8gdEBggN9gcQAF4BEAn2BwAA0pIAAFAIXAXyB1QFAABIBa8Fkg+uBaIFQATqklALWAT2B0gEWAUIAOgPqAL+D6gC6g8AAO2SUAlYBVQE8gdUBAABegzMA0gAzA96CAAG/JIAAFALXAjyB1QH/AsMBKQD5AMMC/wHAAAEk1AIWAn2B1QERAUABNgCVgjUD3QATAVABSKTUAhYBfYHVARUAQAIKAmeBRgHWgcqC6gIJpMoBC4F+QMqBioHgAe+AOsPqgCqBL4DAAArk1AIWAlUBPIHRAcABL4E6gOqBqoJvgcAAC+TWAhUCfIHVAQEBSQA/gdkBWQFfgXkBwAAMpNQCFgJ9gdUBAAFogQqAOoPqgEqAr4CoAQ2k0gLXAjyB1QERAEUAFQP1Ah+CNQDVAVACUqTWAhUCfIHVAQEBfQEtAKUAf4PtAH0AgQES5NQCVgI9gdUBQQA4A8+ALIDqgI+CeAHAAB1k0gIXAnyB8QHMAwuA+AEqgb/C6oKvgoICH6TaAhsCWoE+QdqBwIM/giuCv4Prgr9CgAIjJNIBM4E+QdKBewFrQL+D6wA/A+vAvwEAACWk1AIWAhUCfIHVAQACfQLsAq+ArAC9gsACK6TQAhQC1wI8gfUBQAA/AvsCu4C7Ar8CwAK4ZNQCFgIVgnxB1IECg3qCG4HawFuD+oJCAQYlFAIXAXyB1QFAADyC3oLcwvzD3ILfgvyCzWUMAhaCvwHHAd0ALQHvgdUDP4FEAfWCAAGUZRQCFwJ8gcEB34Aqg/uCboPAAlOD0gJSA9wlAgIXAnyB0QFCADoD8QHkgL0D4QCaA8AAH2UUAhcBfIHVA0ACBgI3gXcA9wL3gusCygAiJSYAIYI9Q+UBIQEIAAgACAA/g8gACAAIACJlAAAmACGCPUPlASUBAAABAgECPwHBAAEAJOUAACYAIYI9A+UBKACHABKAIgJCAj4BwAAmZSYAIYA9Q+UBJQEAADyAIIA/giSCJIHAgCdlJgAhgj1D5QEAAToAQgBCAH+BwgJCAnoDZ6UmACGCPUPlASEDIAIOAgABP4DgAEIADAAn5SYAIYI9Q+UBAQE8AGQAJAA/g+QAJAA8AGglLgAhgjlD6QEBADwDxACkAF+AJAJ8A8AAKKUmACGAPUPlAQAAP4PAgIyAfoBAgj+BwAApZS4AIYI5Q+kBKQAAAz8AyQBJAkkCfwPAACmlAAAmACGCPQPlASEDDAIDgboAQgDOAQICKeUmACECPYHlASEAhAATgJICUgJCAz4AwAAqZSYAIYA9Q+UBAQEEAHuAQgJyAsICPgHAACulJgAhgj0D5QEhAwACEIO/glCCEIO/gkACLGUmACGCPUHlAQAAsgISAT+BEgHKgmqCQAEs5SAAKwI6geoBIACEAD8D5AEkASQBPwPEAC7lJgAhgT1B5QElAIEAIAPgAT+BJAEkA8AAL6UmACGCPUPlAQABP4BkgCSAP4PkgCSAP4BwZSYAIYI9Q+UBBQEwADODMgC/gFIAkgEQAjDlJgAhgj1D5QEhAQQAEgBVgJEDcgAEAAAAMWUmACGCPUHlASUAgAAvg+CBIIE/gTADwAA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AAT+AtAI3gfQAPYCAASblgAA/w8ZAO8AbAa3AK4EoAenALgCrgIiAJyWAAD+DwIAOgHGABAC9AL8AvYP/AL0AhACoJYAAP4PMgDOCQQEbAFkDWwJZAtyCeoBAAyjlgAA/g8yAM4AAAnuBZgDvwCYA+oPqAIAAKeWAAD+DzIAzAhABLYHgASqCfgMyAvOCCgJqJYAAP4PMgDMCOIHFATUC+wI7gl8DewPBAiqlgAA/g86AcYIUAS4AvQAEwj0BrgE6AwIALGWAAD+DwIB/gDADfYB8gf6C/IN+QH1DaAItpYQBFQFVAVUAlQK/gdUAVQCVAO8BJAEAAC7lhAIEAl4CXwJeAd4BXwFeAV4B3gJSAgACL6WAAAUBqQB5AAcAyAA/g+oBPoHqASoBAAAwJYAAFAAWADED+AK3grwCvAPxArECtgKEADBlgAG/gFCAPoHAgAiAPoHUgX6B1IFUgUAAMSWCAzoAx4IyAcIBCAD/AeqBKgE/AeqBKgExZYkBrwBZAj8ByQA8A+uBKgE/geqBKgEAADGlggICAV8BV4DXAPcD34BXQNcBVwFRAkAAceWAAAEDvwBrADsD+wK7ArsD+wK7Ar8CgQIzJYAAPAPAAT+BwAE/gcwAv4PqAT6B6gECATPlhAAuASmBLQE7A8gAPgPrgSoBPoHqAQIBNGWJAC0BI4ChA+8AkAEMAD+B0gF/AdKBUgF1ZaAD3wANAe0AjQJ/AcwAPwPqgT0B6gECATWlgAA7gSqBPoDrgLgBjAA/g+oBPoHqASoBNmWAAAICL8EvAS+BbwGiAK+ArwFvgW8BCQE3JYgAKQGlADGD7QCAAD+D6gEqgT6B6gEqATelgQIfAl8BaoDUg04AfwPqgSoBP4HqAQIBOKWgA/0ANQD1gLECPQHIAD+DygF/AcqBQAE45YAAPQJ1gX0A9YF9AUgAP4PqAT8B6oEqATolgQA9A8UAFQBFAD8DxQAVAFUChQI9A8EAOqWGADKCsoKygqKCr4KigrKCsoKyg8YAAAA75YACJgIygjqCcoGngTKBIoG2gnKCJgIAAjwlgAKGAmaBboFCgM+ARoJOgmKBxgBAAIAAPKWAAEMBWUFZQdFBV8FRQVlB2UHBQ0cCQAA85YcDMYDdgh2CX4HRgF2CXYJdglGCVwHAAD2loAAmACaAboFSgXeBcoFWg26C4oBmACAAPeWGADKD8oKygqKCr4PigrKCsoKyg8YAAAA+ZaAAJgA+gf6CuoK/grKCvoLegrKCRgEAAD7lgAAGADaB/oCygLeB9oK+grKCxgIAAYAAP6WAAFYC1wLXAvMBtwC3AJ8C0wLXAcAAAAAAJcAAFgAWg96AUoP3gFaD3oBSglYB0AAAAAElwAAHgAOCK4HhgHeBYYG1gLeCoYHHgAAAAaXAAhMCeYFdgsmCD4NRg32D3YNZg0MDQAAB5cYDNoDegn6B8oF3gXKB/oF+gXKB1gLAAkJlwAADAFmBeYG5gbGB94Gxg7mDuYHTAUAAAqXAAg4CYoLqgmKD74Jig+qD6oJCgs4CwAIDZcAAQwBpg+2C4YL3g+GC7YLpguMCAAAAAAOlxgCWgtKC2oLyg9uD0oPWgf6B0oLWgsYCBOXAAAOAA4I1guuCq4GBgKuBr4K5gsOCAAEFpcAAJgEigK6D4oCPgCKBroBug+KApgEAAQclwAAmAS6AroPugI+AL4H+gX6BfoFyAcAAB6XGADKD/oF+gXKBd4MCgj6C/oFygXYCwAIJ5cAAAAMTAPmD/YBRgMeCsYGdgPmC0wHAAEylxgIyg16CXoPygueAooOegv6CkoPWAIAADiXAABMB+YH9g/GB14DBgz2A/YC5grMBwAAOZcABuwBdQdtBW0FBQcvAuUCpQ+tAu0CoABClwAO7AFlBP0E/QZ1BOcHZQb9BvUG9QQgAEiXAAgMCeYL/gtGCa4PpgnmDU4LtgjkCAAAUpcQABQA/A+8ArwCvgK8ArwKvAr8BxQAEABWlwgC6AIOAugBAAD8D7wCvgK8CrwK/A8UAFmXEADcD9wC3grcDxAAWAlWCfQHXAHwAUAAXJcQCNwH3ALeCtwHAACIAqQK6geiAuoDgABelwABKAEoASgB/g8AAAAA/g8oASgBKAEAAWCXAAQIB3wHXgdcD1wAXgBcD1wHfAcIBwAEYZcADvwBBAQ0B3QHVA8GADQPdAc0B1QHAABilwAA8g8SBPIHXgVSBfIHEgQSBPIPAgAAAGmXAAAEAuQCvgK0AvQPtAK0Ar4C5AIEAgAAdJcEAu4C/A+uAuQCAAIwAP4PAAD+BxAICAZ2lwQA7gKsAvwPrgJAAP4HQgh+CEII/ggABouXAADkAq4C/A/uAgQKIAgkCb8PJAkkCQAAjZcEAO4CrAP+DuQCAABICcYJdAZEBegEQAiRlwQC7gL8D64CZAjgBwQIkAt+CNAIEAsAAJiXBAD+ArQC9A++AkAI9AcQAF4BEAn0BwAAoJcEAv4C9A+0Au4C/AaKA+gP6AGICvgHAACtlwQC7gL8D24A/g98CawH/ASsCPwIBAgAANOX/AKsAq4PrAb8BgAE7AeuBawPrAXsBQgE5pcAAJIAkgCSAJIA/w+SAJIAkgSSBIADAADnl6gAqAD8D6gAqAIAAXQMhAN8CAQI/AcAAOmXAAD0AtQC3g/UAvQCAACoAP4PqACoBIgD7ZcAAFAFUAVQBf4HAAQABP4HqASoBKgEAADzlxAAFADUB1QFVAVWBVQFVAVcBdQHFAAQAPWXIADoB2YFdAXkByAAEAEuBagICAj4BwAA9pcQANwHVgVcBdQHBACwB44EogSiBJ4HAAD7lxAA3AdVBVoF1AcEAPgPVANUA1QD/A8ACP+XlAC+ANUH4Af+B+4HzgfAB94HxgeaAAAAAZgACAQI/AusBqwGrAKsAqwGrAb8CwQIAAACmAQIBAj8DwQAAAj8C6wKrAKsBqwG/AsAAAWYBAEEAfwBBAEECPwHrAasAqwGrAb8CwAIBpgACPwHAAD4AwAA/g8AAPwHrAasAqwK/AsImEgIyAQkBBADBAj8C6wKrAKsAqwK/AsACBCYJAgkCPQPPADkCAAI/AusAqwCrAr8CwAAEZgAABQH9AAUAvQDAAj8B6wGrAKsAvwLAAgTmOgAiAD8D4gE6AIACPQHtAa8ArQK9AsAABeYAA74ASgMvAKoA1gI/AusCqwCrAb8BwAIGJgAAFgA1AdSAMQJDAT8B6wCrAKsBvwPAAAtmAAAfAhMBUwEfAcADPwJrAqsAqwG/AcACDuYEADeBRAEfwIUAZAA/g1WA1YDVgH+BQAEPJgAAHgGWAH8D1gBOAr8CawGrAKsBvwHAAhGmAAEvASsAvwPrAKcCPgJrAqsAqwG/AcACEyYQAxcA1wE3AdcCQAM/A1cCVwJXAn8DQAMTZggAawPtAVWBaQHDAD8B6wGrAKsCvwLAABPmAAM7AM8CK4JLAUkAvwLrAqsAqwG/AcACFSYAAzkAywIpgosBSQA/AusCqwCrAr8CwAIWJgAD/wAfAasAKwP/AEACPwHrAasAvwLAAhbmAQK/AvcCt4C/AsAAPwHrAasAqwG/AsAAF6YAACsBJgC3gGcAogI/AusBqwCrAL8BwAIZ5gADvoBKg+qB9oHgAcCCPoLrgaqAvoHAgxvmAAB/A3aARoJ+gO8AwAJ/AesBqwC/AsACHWYAAAECPQLFAgUBBQC3AEUBBQI9AsECAAAdpgAAAQIBAj8BwQAAAj6CQoE7gMKCPoJAAB3mAAAAAD8AxACEAEACPQFFATcAxQE9AkECHmYBAEEAfwBhAAACPoFCgQKA+4ACgIKBPoFepgADPwDAAD4AwAA/g8AAPwIDAbsAQwC/Ax7mAAESAQmApABAgj6BAoC7gEKAAoC+gQCCH2YAAASBvIBEgDyBwAC+ggKBu4BCgD6DgAAfpj8DwIA+gcKBPoCAAj6BAoG7gEKAPoOAAB/mAAA9ACEAP8PhARgAvoICgbuAQoA+g4ACIGYMAwMAuIJIAjvBxAA+gkKBO4DCgj6CQAAgpgwBAwD4gIAAt4HAAD6DAoC7gEKAPoNAASEmCIAKgjqBzYA4gAACPoECgbuAQoA+g4AAIWYAAjwB5AAngD0AQAI/AkMBOwDDAj8CQAIhpgQAFABTAJqDdAAAAj0BBQG3AEUAPQOAAiHmAAO/AEkDD4D5AYMAPAEFAbcARQA9A4ACIiYAACiCJIIige2BAAM+gkKBO4DCgj6CwAAiphIBFgESAP+AHgDSAjgBBQC3AEUAvQEAACRmCAAuAsgCPwFKAMgCPQJFATcAxQE9AkAAJOYAAAsCKwHvACqBwAE8ggSBt4BEgTyCQAAlpgABM8C1AHUD7IBAAryCBoG1gESBPIFAAiXmAAE/ATUAvwP1AH8AOAJFATcAxQI9AkAAJiYQAxcA1wE3AdcCQAM9AwUC9wIFAr0DAQMnJgACPIHGgGzBKoCEgj6BAoC7gEKAPoOAACdmKwAFAZeBXQFlA4cAPQJFAbcARQA9A0ABKCYBAr8C+wK7gL8CwAA9AkUBNwDFAj0CwAApJgACPwL/Av+C8wLPAPwCAoE7gMKCPoJAAComAAAAA78AQQE7AUsBfwHLAXEDPwHAAgABLGYAA7+AUIE+gNCAv4AAAPYBFYJUAncDQAAxJgEAPQN/AH8B6QP/gdmBPYD+gP6BwQIAATGmEAGygFqAGcG6wFiDP8DYQT9A2EH/wEABs6YAAAADv4BAgQaAqIB4gAaBwIA/gcACAAG0pgoBMoEDgLsAwAK/AcEAvQBBAL8BwAMAADYmHQN1AH8CdQH/APUASQN/AMUBuQB/AcADNuYUAhSBvoBQgBCAPoPQgBCAM4DFAUqCUgF3pgAAAQABAAEAAQABAAEAPwAIAdQCIgIiAbfmAAAEAAQCPgPtAiyCbQCtAb4CZAIEAgAAO+YCATkB9IE0gT0BgAO/gFiDKIFIgPiBAAI8pgIBPQHsgSyBPQGIAAcDIoD+AAIAzgECAj8mBAE/AeyBLIE9AYAAOwDLAHsCQQI/AcAAP2YCAAIBPwHugS6AvQGAAD4A5YE9AQEBPwE/pgQBPwHsgS6BPIGNAToASYA/A8kAOQDAAAFmQQA8g9aCVoF8gkAAIoM+gOIAP8PiQAAAAqZgACUAFwI/g/cCdwJ3AfcBf4NXAiUCAAAEJkQAJAAqAjuD9wLgAO2B9YHlgWuCKIAAAATmQQI8gdxBnUDIQSJBP8DWAAfAvgD2wYQABiZCAjsD1oJVgX0DQQAlAKUCPMHlACEAogEKJkQBPgHtASyBOwGHAD0D5QFlgWUBfwHAABSmQAA8A++BLIE9A5AAGoNegNvASoP+g0oBWWZMAAMCOoPCAQ4AAAO/AEEAAQA/A8ACAAGbZkwAAwIygcYAAAO/AE0DNQCFAPyBBIIAABumXAADAjqDwgEOAIACDAEDgPoAAgDKAQYCHCZIAAUAMoPGAIAAOgDJwAkAPwPJAAkAuQBcZlgABQAyg8YBEAA8AcsCSgJ6AsICvgJAARymTAADAjKBxgCCADiAyoBKgHqCQII/gcAAHWZcAAMCOoPCAQwAAQE/AeUBJQElAL8DwQCdpkgABQIygcYAggIoASuA7gApA/UCJQIAAR6mTAACgjlBwQCCApgCBQEhQOGAwQEdAhABHyZIAAUCMoPCAS4AoEI+geIAIgA/A+LAIAAf5kgABAAzg8YBIAClAj8DxAE/gKQBVYIAAaAmSAAHADKDwgEGACQBpgAlAjyD5QAmAKQBIGZIAAUCMoHGAIACFQJxAVsAkQDwgRaCEAAhZkgABQEygcIAjgA0A9IBQYFRARcBcQPAACGmSAAFATKBxACBAD8B/QHVQVWBWQFDAcAAIuZMAAMCMoHGAKQALgCbgQ8BWwJrAq4AIAAjZkgABQEygcYAwAIdAV2BXQD9AF2A3QFAAiPmTAAjg8oBBgEQAA+D7AK5A+cCoQKvA8AAJKZEAAcAOoHCAFgBN4F/gbeAv4G3gX+BAAAlpkAAAQA9A9XBVQFXAVUBVQFVwX0DwQAAACZmZAAVABUD7QKlAq8CpQKsgrSCtIPUACQAKiZAAC8ArwC/g78D/QP+A72DvIP/g7YAgACrJkACAAM/AFUAVQFVAH8DVQBVAtUCQAHAACzmQAG/gCqB/4CqgoAB/wHEAj+CRAI+AgABsGZAAb+AKoC/gmqC6oHAADWDAgDDgXRBBAIxZkABv4AqgP+C6oOgA3+AyIA4gAiAz4MAADGmQAG/gCqBv4CqgsAB/4PAgSiBXIEigUABdCZAA7+AKoG/g6qCaoHAACKCPoPjAiICAAI0pkABv4Aqgf+AoIKEAfMASoB6AkICPgHAADVmQAAFAjMBeYB5AXsAeAD/gHyA/IFHgMAANuZAAN/ANUDfwNVBcEDHAwkA/8CJAQ8BAAI3ZkABv4Aqgf+A6oPAAAYAPgHjgiICFgIQAb/mQAG/gCqBP4Bqg8AADwHigS4Bq4JIAgAAA6aAAb+AKoD/guKByAApAe0Aq4LNAjUByAAEpoABv4Aqgf+A4oPQACiCWYJ+g9aCeYNIAgTmgAG/gCqA/4GqgoKB+gIJgXyAyQH6AkICBmaAAb+A6oB/gmAD/wH7APsB+oDagX6BwAAMJoADP4Dkgj+B0QA9gXcC9YL3Af2C1QGQAA3mgAO/gCqAv4LqgcAAPQJagnSD2oP5g8gCEWaAAb+BqoB/gmCBwAA/AdUCuwLnAnECwAAVZoABn4H/gKqCQIHqA/6A94F2gf5AKkPAABXmgAG/geqAf4NggNwCLgG9gBUDLgC0AwAAFqaEAg6DP4D+gP6C9oDyAvsA9YLrAssBiQAX5oADv4Aqgf+DgAHfga6AP4PbAAUAywEAABsmgAAAAIEAnQCRAJEAkQCRAp8CEAHwAAAAG6aAAJ6AkIJQgj+BwAAEAyQA34AkAEQBhAIb5oAAnoCQglyCM4HAAD+DwAA/gcAAP4PAABwmgACegJCCkII/gcAAPwHEAj+CQgI+AgABnGaAAB6AkIKQgn+B/gPBAgUC+QIlAkECgAAc5oAAnQCRAlECPwHAABUDIgCiANUBBIIAAB0mgAAegJCCkII/gcAAPgPSABKAEgA+AAAAHaaAAJ0AkQIRAz8AzAISAVIAv4FSAR4CAAAeZoAAnoKQgl6CMYHEADOAykB6AkICPgHAAB7mgAA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\"\n }\n}\n",
"frame.ts": "namespace control.__screen {\n let __update: () => void\n let __updated = false;\n\n export function update() {\n if (__update)\n __update()\n __updated = true\n }\n\n export function setupUpdate(update: () => void) {\n __updated = true;\n __update = update;\n update()\n }\n\n // low frequency fallback screen refresh\n control.runInParallel(() => {\n while (true) {\n __updated = false\n pause(200)\n if (!__updated) {\n __screen.update();\n __updated = true\n }\n }\n })\n}\n",
"image.cpp": "#include \"pxt.h\"\n\n#if IMAGE_BITS == 1\n// OK\n#elif IMAGE_BITS == 4\n// OK\n#else\n#error \"Invalid IMAGE_BITS\"\n#endif\n\n#define XX(v) (int)(((int16_t)(v)))\n#define YY(v) (int)(((int16_t)(((int32_t)(v)) >> 16)))\n\nnamespace pxt {\n\nPXT_VTABLE(RefImage, ValType::Object)\n\nvoid RefImage::destroy(RefImage *t) {}\n\nvoid RefImage::print(RefImage *t) {\n DMESG(\"RefImage %p size=%d x %d\", t, t->width(), t->height());\n}\n\nint RefImage::wordHeight() {\n if (bpp() == 1)\n oops(20);\n return ((height() * 4 + 31) >> 5);\n}\n\nvoid RefImage::makeWritable() {\n ++revision;\n if (buffer->isReadOnly()) {\n buffer = mkBuffer(data(), length());\n }\n}\n\nuint8_t RefImage::fillMask(color c) {\n return this->bpp() == 1 ? (c & 1) * 0xff : 0x11 * (c & 0xf);\n}\n\nbool RefImage::inRange(int x, int y) {\n return 0 <= x && x < width() && 0 <= y && y < height();\n}\n\nvoid RefImage::clamp(int *x, int *y) {\n *x = min(max(*x, 0), width() - 1);\n *y = min(max(*y, 0), height() - 1);\n}\n\nRefImage::RefImage(BoxedBuffer *buf) : PXT_VTABLE_INIT(RefImage), buffer(buf) {\n revision = 0;\n if (!buf)\n oops(21);\n}\n\nstatic inline int byteSize(int w, int h, int bpp) {\n if (bpp == 1)\n return sizeof(ImageHeader) + ((h + 7) >> 3) * w;\n else\n return sizeof(ImageHeader) + (((h * 4 + 31) / 32) * 4) * w;\n}\n\nImage_ allocImage(const uint8_t *data, uint32_t sz) {\n auto buf = mkBuffer(data, sz);\n registerGCObj(buf);\n Image_ r = NEW_GC(RefImage, buf);\n unregisterGCObj(buf);\n return r;\n}\n\nImage_ mkImage(int width, int height, int bpp) {\n if (width < 0 || height < 0 || width > 2000 || height > 2000)\n return NULL;\n if (bpp != 1 && bpp != 4)\n return NULL;\n uint32_t sz = byteSize(width, height, bpp);\n Image_ r = allocImage(NULL, sz);\n auto hd = r->header();\n hd->magic = IMAGE_HEADER_MAGIC;\n hd->bpp = bpp;\n hd->width = width;\n hd->height = height;\n hd->padding = 0;\n MEMDBG(\"mkImage: %d X %d => %p\", width, height, r);\n return r;\n}\n\nbool isValidImage(Buffer buf) {\n if (!buf || buf->length < 9)\n return false;\n\n auto hd = (ImageHeader *)(buf->data);\n if (hd->magic != IMAGE_HEADER_MAGIC || (hd->bpp != 1 && hd->bpp != 4))\n return false;\n\n int sz = byteSize(hd->width, hd->height, hd->bpp);\n if (sz != (int)buf->length)\n return false;\n\n return true;\n}\n\nbool isLegacyImage(Buffer buf) {\n if (!buf || buf->length < 5)\n return false;\n\n if (buf->data[0] != 0xe1 && buf->data[0] != 0xe4)\n return false;\n\n int sz = byteSize(buf->data[1], buf->data[2], buf->data[0] & 0xf) - 4;\n if (sz != (int)buf->length)\n return false;\n\n return true;\n}\n\n} // namespace pxt\n\nnamespace ImageMethods {\n\n/**\n * Get the width of the image\n */\n//% property\nint width(Image_ img) {\n return img->width();\n}\n\n/**\n * Get the height of the image\n */\n//% property\nint height(Image_ img) {\n return img->height();\n}\n\n/**\n * True if the image is monochromatic (black and white)\n */\n//% property\nbool isMono(Image_ img) {\n return img->bpp() == 1;\n}\n\n//% property\nbool isStatic(Image_ img) {\n return img->buffer->isReadOnly();\n}\n\n//% property\nbool revision(Image_ img) {\n return img->revision;\n}\n\n/**\n * Sets all pixels in the current image from the other image, which has to be of the same size and\n * bpp.\n */\n//%\nvoid copyFrom(Image_ img, Image_ from) {\n if (img->width() != from->width() || img->height() != from->height() ||\n img->bpp() != from->bpp())\n return;\n img->makeWritable();\n memcpy(img->pix(), from->pix(), from->pixLength());\n}\n\nstatic void setCore(Image_ img, int x, int y, int c) {\n auto ptr = img->pix(x, y);\n if (img->bpp() == 4) {\n if (y & 1)\n *ptr = (*ptr & 0x0f) | (c << 4);\n else\n *ptr = (*ptr & 0xf0) | (c & 0xf);\n } else if (img->bpp() == 1) {\n uint8_t mask = 0x01 << (y & 7);\n if (c)\n *ptr |= mask;\n else\n *ptr &= ~mask;\n }\n}\n\nstatic int getCore(Image_ img, int x, int y) {\n auto ptr = img->pix(x, y);\n if (img->bpp() == 4) {\n if (y & 1)\n return *ptr >> 4;\n else\n return *ptr & 0x0f;\n } else if (img->bpp() == 1) {\n uint8_t mask = 0x01 << (y & 7);\n return (*ptr & mask) ? 1 : 0;\n }\n return 0;\n}\n\n/**\n * Set pixel color\n */\n//%\nvoid setPixel(Image_ img, int x, int y, int c) {\n if (!img->inRange(x, y))\n return;\n img->makeWritable();\n setCore(img, x, y, c);\n}\n\n/**\n * Get a pixel color\n */\n//%\nint getPixel(Image_ img, int x, int y) {\n if (!img->inRange(x, y))\n return 0;\n return getCore(img, x, y);\n}\n\nvoid fillRect(Image_ img, int x, int y, int w, int h, int c);\n\n/**\n * Fill entire image with a given color\n */\n//%\nvoid fill(Image_ img, int c) {\n if (c && img->hasPadding()) {\n fillRect(img, 0, 0, img->width(), img->height(), c);\n return;\n }\n img->makeWritable();\n memset(img->pix(), img->fillMask(c), img->pixLength());\n}\n\n/**\n * Copy row(s) of pixel from image to buffer (8 bit per pixel).\n */\n//%\nvoid getRows(Image_ img, int x, Buffer dst) {\n if (img->bpp() != 4)\n return;\n\n int w = img->width();\n int h = img->height();\n if (x >= w || x < 0)\n return;\n\n uint8_t *sp = img->pix(x, 0);\n uint8_t *dp = dst->data;\n int n = min(dst->length, (w - x) * h) >> 1;\n\n while (n--) {\n *dp++ = *sp & 0xf;\n *dp++ = *sp >> 4;\n sp++;\n }\n}\n\n/**\n * Copy row(s) of pixel from buffer to image.\n */\n//%\nvoid setRows(Image_ img, int x, Buffer src) {\n if (img->bpp() != 4)\n return;\n\n int w = img->width();\n int h = img->height();\n if (x >= w || x < 0)\n return;\n\n img->makeWritable();\n\n uint8_t *dp = img->pix(x, 0);\n uint8_t *sp = src->data;\n int n = min(src->length, (w - x) * h) >> 1;\n\n while (n--) {\n *dp++ = (sp[0] & 0xf) | (sp[1] << 4);\n sp += 2;\n }\n}\n\nvoid fillRect(Image_ img, int x, int y, int w, int h, int c) {\n if (w == 0 || h == 0 || x >= img->width() || y >= img->height())\n return;\n\n int x2 = x + w - 1;\n int y2 = y + h - 1;\n\n if (x2 < 0 || y2 < 0)\n return;\n\n img->clamp(&x2, &y2);\n img->clamp(&x, &y);\n w = x2 - x + 1;\n h = y2 - y + 1;\n\n if (!img->hasPadding() && x == 0 && y == 0 && w == img->width() && h == img->height()) {\n fill(img, c);\n return;\n }\n\n img->makeWritable();\n\n auto bh = img->byteHeight();\n uint8_t f = img->fillMask(c);\n\n uint8_t *p = img->pix(x, y);\n while (w-- > 0) {\n if (img->bpp() == 1) {\n auto ptr = p;\n unsigned mask = 0x01 << (y & 7);\n\n for (int i = 0; i < h; ++i) {\n if (mask == 0x100) {\n if (h - i >= 8) {\n *++ptr = f;\n i += 7;\n continue;\n } else {\n mask = 0x01;\n ++ptr;\n }\n }\n if (c)\n *ptr |= mask;\n else\n *ptr &= ~mask;\n mask <<= 1;\n }\n\n } else if (img->bpp() == 4) {\n auto ptr = p;\n unsigned mask = 0x0f;\n if (y & 1)\n mask <<= 4;\n\n for (int i = 0; i < h; ++i) {\n if (mask == 0xf00) {\n if (h - i >= 2) {\n *++ptr = f;\n i++;\n continue;\n } else {\n mask = 0x0f;\n ptr++;\n }\n }\n *ptr = (*ptr & ~mask) | (f & mask);\n mask <<= 4;\n }\n }\n p += bh;\n }\n}\n\n//%\nvoid _fillRect(Image_ img, int xy, int wh, int c) {\n fillRect(img, XX(xy), YY(xy), XX(wh), YY(wh), c);\n}\n\nvoid mapRect(Image_ img, int x, int y, int w, int h, Buffer map) {\n if (w == 0 || h == 0 || x >= img->width() || y >= img->height())\n return;\n\n if (img->bpp() != 4 || map->length < 16)\n return;\n\n int x2 = x + w - 1;\n int y2 = y + h - 1;\n\n if (x2 < 0 || y2 < 0)\n return;\n\n img->clamp(&x2, &y2);\n img->clamp(&x, &y);\n w = x2 - x + 1;\n h = y2 - y + 1;\n\n img->makeWritable();\n\n auto bh = img->byteHeight();\n auto m = map->data;\n uint8_t *p = img->pix(x, y);\n while (w-- > 0) {\n auto ptr = p;\n unsigned shift = y & 1;\n for (int i = 0; i < h; i++) {\n if (shift) {\n *ptr = (m[*ptr >> 4] << 4) | (*ptr & 0x0f);\n ptr++;\n shift = 0;\n } else {\n *ptr = (m[*ptr & 0xf] & 0xf) | (*ptr & 0xf0);\n shift = 1;\n }\n }\n p += bh;\n }\n}\n\n//%\nvoid _mapRect(Image_ img, int xy, int wh, Buffer c) {\n mapRect(img, XX(xy), YY(xy), XX(wh), YY(wh), c);\n}\n\n//% argsNullable\nbool equals(Image_ img, Image_ other) {\n if (!other) {\n return false;\n }\n auto len = img->length();\n if (len != other->length()) {\n return false;\n }\n return 0 == memcmp(img->data(), other->data(), len);\n}\n\n/**\n * Return a copy of the current image\n */\n//%\nImage_ clone(Image_ img) {\n auto r = allocImage(img->data(), img->length());\n MEMDBG(\"mkImageClone: %d X %d => %p\", img->width(), img->height(), r);\n return r;\n}\n\n/**\n * Flips (mirrors) pixels horizontally in the current image\n */\n//%\nvoid flipX(Image_ img) {\n img->makeWritable();\n\n int bh = img->byteHeight();\n auto a = img->pix();\n auto b = img->pix(img->width() - 1, 0);\n\n uint8_t tmp[bh];\n\n while (a < b) {\n memcpy(tmp, a, bh);\n memcpy(a, b, bh);\n memcpy(b, tmp, bh);\n a += bh;\n b -= bh;\n }\n}\n\n/**\n * Flips (mirrors) pixels vertically in the current image\n */\n//%\nvoid flipY(Image_ img) {\n img->makeWritable();\n\n // this is quite slow - for small 16x16 sprite it will take in the order of 1ms\n // something faster requires quite a bit of bit tweaking, especially for mono images\n for (int i = 0; i < img->width(); ++i) {\n int a = 0;\n int b = img->height() - 1;\n while (a < b) {\n int tmp = getCore(img, i, a);\n setCore(img, i, a, getCore(img, i, b));\n setCore(img, i, b, tmp);\n a++;\n b--;\n }\n }\n}\n\n/**\n * Returns a transposed image (with X/Y swapped)\n */\n//%\nImage_ transposed(Image_ img) {\n Image_ r = mkImage(img->height(), img->width(), img->bpp());\n\n // this is quite slow\n for (int i = 0; i < img->width(); ++i) {\n for (int j = 0; j < img->height(); ++i) {\n setCore(r, j, i, getCore(img, i, j));\n }\n }\n\n return r;\n}\n\nvoid drawImage(Image_ img, Image_ from, int x, int y);\n\n/**\n * Every pixel in image is moved by (dx,dy)\n */\n//%\nvoid scroll(Image_ img, int dx, int dy) {\n img->makeWritable();\n auto bh = img->byteHeight();\n auto w = img->width();\n if (dy != 0) {\n // TODO one day we may want a more memory-efficient implementation\n auto img2 = clone(img);\n fill(img, 0);\n drawImage(img, img2, dx, dy);\n } else if (dx < 0) {\n dx = -dx;\n if (dx < w)\n memmove(img->pix(), img->pix(dx, 0), (w - dx) * bh);\n else\n dx = w;\n memset(img->pix(w - dx, 0), 0, dx * bh);\n } else if (dx > 0) {\n if (dx < w)\n memmove(img->pix(dx, 0), img->pix(), (w - dx) * bh);\n else\n dx = w;\n memset(img->pix(), 0, dx * bh);\n }\n}\n\nconst uint8_t bitdouble[] = {0x00, 0x03, 0x0c, 0x0f, 0x30, 0x33, 0x3c, 0x3f,\n 0xc0, 0xc3, 0xcc, 0xcf, 0xf0, 0xf3, 0xfc, 0xff};\nconst uint8_t nibdouble[] = {0x00, 0x11, 0x22, 0x33, 0x44, 0x55, 0x66, 0x77,\n 0x88, 0x99, 0xaa, 0xbb, 0xcc, 0xdd, 0xee, 0xff};\n\n/**\n * Stretches the image horizontally by 100%\n */\n//%\nImage_ doubledX(Image_ img) {\n if (img->width() > 126)\n return NULL;\n\n Image_ r = mkImage(img->width() * 2, img->height(), img->bpp());\n auto src = img->pix();\n auto dst = r->pix();\n auto w = img->width();\n auto bh = img->byteHeight();\n\n for (int i = 0; i < w; ++i) {\n memcpy(dst, src, bh);\n dst += bh;\n memcpy(dst, src, bh);\n dst += bh;\n\n src += bh;\n }\n\n return r;\n}\n\n/**\n * Stretches the image vertically by 100%\n */\n//%\nImage_ doubledY(Image_ img) {\n if (img->height() > 126)\n return NULL;\n\n Image_ r = mkImage(img->width(), img->height() * 2, img->bpp());\n auto src0 = img->pix();\n auto dst = r->pix();\n\n auto w = img->width();\n auto sbh = img->byteHeight();\n auto bh = r->byteHeight();\n auto dbl = img->bpp() == 1 ? bitdouble : nibdouble;\n\n for (int i = 0; i < w; ++i) {\n auto src = src0 + i * sbh;\n for (int j = 0; j < bh; j += 2) {\n *dst++ = dbl[*src & 0xf];\n if (j != bh - 1)\n *dst++ = dbl[*src >> 4];\n src++;\n }\n }\n\n return r;\n}\n\n/**\n * Replaces one color in an image with another\n */\n//%\nvoid replace(Image_ img, int from, int to) {\n if (img->bpp() != 4)\n return;\n to &= 0xf;\n if (from == to)\n return;\n\n img->makeWritable();\n\n // avoid bleeding 'to' color into the overflow areas of the picture\n if (from == 0 && img->hasPadding()) {\n for (int i = 0; i < img->height(); ++i)\n for (int j = 0; j < img->width(); ++j)\n if (getCore(img, j, i) == from)\n setCore(img, j, i, to);\n return;\n }\n\n auto ptr = img->pix();\n auto len = img->pixLength();\n while (len--) {\n auto b = *ptr;\n if ((b & 0xf) == from)\n b = (b & 0xf0) | to;\n if ((b >> 4) == from)\n b = (to << 4) | (b & 0xf);\n *ptr++ = b;\n }\n}\n\n/**\n * Stretches the image in both directions by 100%\n */\n//%\nImage_ doubled(Image_ img) {\n Image_ tmp = doubledX(img);\n registerGCObj(tmp);\n Image_ r = doubledY(tmp);\n unregisterGCObj(tmp);\n return r;\n}\n\nbool drawImageCore(Image_ img, Image_ from, int x, int y, int color) {\n auto w = from->width();\n auto h = from->height();\n auto sh = img->height();\n auto sw = img->width();\n\n if (x + w <= 0)\n return false;\n if (x >= sw)\n return false;\n if (y + h <= 0)\n return false;\n if (y >= sh)\n return false;\n\n auto len = y < 0 ? min(sh, h + y) : min(sh - y, h);\n auto tbp = img->bpp();\n auto fbp = from->bpp();\n auto y0 = y;\n\n if (color == -2 && x == 0 && y == 0 && tbp == fbp && w == sw && h == sh) {\n copyFrom(img, from);\n return false;\n }\n\n // DMESG(\"drawIMG(%d,%d) at (%d,%d) w=%d bh=%d len=%d\",\n // w,h,x, y, img->width(), img->byteHeight(), len );\n\n auto fromH = from->byteHeight();\n auto imgH = img->byteHeight();\n auto fromBase = from->pix();\n auto imgBase = img->pix(0, y);\n\n#define LOOPHD \\\n for (int xx = 0; xx < w; ++xx, ++x) \\\n if (0 <= x && x < sw)\n\n if (tbp == 4 && fbp == 4) {\n auto wordH = fromH >> 2;\n LOOPHD {\n y = y0;\n\n auto fdata = (uint32_t *)fromBase + wordH * xx;\n auto tdata = imgBase + imgH * x;\n\n // DMESG(\"%d,%d xx=%d/%d - %p (%p) -- %d\",x,y,xx,w,tdata,img->pix(),\n // (uint8_t*)fdata - from->pix());\n\n auto cnt = wordH;\n auto bot = min(sh, y + h);\n\n#define COLS(s) ((v >> (s)) & 0xf)\n#define COL(s) COLS(s)\n\n#define STEPA(s) \\\n if (COL(s) && 0 <= y && y < bot) \\\n SETLOW(s); \\\n y++;\n#define STEPB(s) \\\n if (COL(s) && 0 <= y && y < bot) \\\n SETHIGH(s); \\\n y++; \\\n tdata++;\n#define STEPAQ(s) \\\n if (COL(s)) \\\n SETLOW(s);\n#define STEPBQ(s) \\\n if (COL(s)) \\\n SETHIGH(s); \\\n tdata++;\n\n// perf: expanded version 5% faster\n#define ORDER(A, B) \\\n A(0); \\\n B(4); \\\n A(8); \\\n B(12); \\\n A(16); \\\n B(20); \\\n A(24); \\\n B(28)\n//#define ORDER(A,B) for (int k = 0; k < 32; k += 8) { A(k); B(4+k); }\n#define LOOP(A, B, xbot) \\\n while (cnt--) { \\\n auto v = *fdata++; \\\n if (0 <= y && y <= xbot - 8) { \\\n ORDER(A##Q, B##Q); \\\n y += 8; \\\n } else { \\\n ORDER(A, B); \\\n } \\\n }\n#define LOOPS(xbot) \\\n if (y & 1) \\\n LOOP(STEPB, STEPA, xbot) \\\n else \\\n LOOP(STEPA, STEPB, xbot)\n\n if (color >= 0) {\n#define SETHIGH(s) *tdata = (*tdata & 0x0f) | ((COLS(s)) << 4)\n#define SETLOW(s) *tdata = (*tdata & 0xf0) | COLS(s)\n LOOPS(sh)\n } else if (color == -2) {\n#undef COL\n#define COL(s) 1\n LOOPS(bot)\n } else {\n#undef COL\n#define COL(s) COLS(s)\n#undef SETHIGH\n#define SETHIGH(s) \\\n if (*tdata & 0xf0) \\\n return true\n#undef SETLOW\n#define SETLOW(s) \\\n if (*tdata & 0x0f) \\\n return true\n LOOPS(sh)\n }\n }\n } else if (tbp == 1 && fbp == 1) {\n auto left = img->pix() - imgBase;\n auto right = img->pix(0, img->height() - 1) - imgBase;\n LOOPHD {\n y = y0;\n\n auto data = fromBase + fromH * xx;\n auto off = imgBase + imgH * x;\n auto off0 = off + left;\n auto off1 = off + right;\n\n int shift = (y & 7);\n\n int y1 = y + h + (y & 7);\n int prev = 0;\n\n while (y < y1 - 8) {\n int curr = *data++ << shift;\n if (off0 <= off && off <= off1) {\n uint8_t v = (curr >> 0) | (prev >> 8);\n\n if (color == -1) {\n if (*off & v)\n return true;\n } else {\n *off |= v;\n }\n }\n off++;\n prev = curr;\n y += 8;\n }\n\n int left = y1 - y;\n if (left > 0) {\n int curr = *data << shift;\n if (off0 <= off && off <= off1) {\n uint8_t v = ((curr >> 0) | (prev >> 8)) & (0xff >> (8 - left));\n if (color == -1) {\n if (*off & v)\n return true;\n } else {\n *off |= v;\n }\n }\n }\n }\n } else if (tbp == 4 && fbp == 1) {\n if (y < 0) {\n fromBase = from->pix(0, -y);\n imgBase = img->pix();\n }\n // icon mode\n LOOPHD {\n auto fdata = fromBase + fromH * xx;\n auto tdata = imgBase + imgH * x;\n\n unsigned mask = 0x01;\n auto v = *fdata++;\n int off = (y & 1) ? 1 : 0;\n if (y < 0) {\n mask <<= -y & 7;\n off = 0;\n }\n for (int i = off; i < len + off; ++i) {\n if (mask == 0x100) {\n mask = 0x01;\n v = *fdata++;\n }\n if (v & mask) {\n if (i & 1)\n *tdata = (*tdata & 0x0f) | (color << 4);\n else\n *tdata = (*tdata & 0xf0) | color;\n }\n mask <<= 1;\n if (i & 1)\n tdata++;\n }\n }\n }\n\n return false;\n}\n\n/**\n * Draw given image on the current image\n */\n//%\nvoid drawImage(Image_ img, Image_ from, int x, int y) {\n img->makeWritable();\n if (img->bpp() == 4 && from->bpp() == 4) {\n drawImageCore(img, from, x, y, -2);\n } else {\n fillRect(img, x, y, from->width(), from->height(), 0);\n drawImageCore(img, from, x, y, 0);\n }\n}\n\n/**\n * Draw given image with transparent background on the current image\n */\n//%\nvoid drawTransparentImage(Image_ img, Image_ from, int x, int y) {\n img->makeWritable();\n drawImageCore(img, from, x, y, 0);\n}\n\n/**\n * Check if the current image \"collides\" with another\n */\n//%\nbool overlapsWith(Image_ img, Image_ other, int x, int y) {\n return drawImageCore(img, other, x, y, -1);\n}\n\n// Image_ format (legacy)\n// byte 0: magic 0xe4 - 4 bit color; 0xe1 is monochromatic\n// byte 1: width in pixels\n// byte 2: height in pixels\n// byte 3: padding (should be zero)\n// byte 4...N: data 4 bits per pixels, high order nibble printed first, lines aligned to 32 bit\n// words byte 4...N: data 1 bit per pixels, high order bit printed first, lines aligned to byte\n\nImage_ convertAndWrap(Buffer buf) {\n if (isValidImage(buf))\n return NEW_GC(RefImage, buf);\n\n // What follows in this function is mostly dead code, except if people construct image buffers\n // by hand. Probably safe to remove in a year (middle of 2020) or so. When removing, also remove\n // from sim.\n if (!isLegacyImage(buf))\n return NULL;\n\n auto tmp = mkBuffer(NULL, buf->length + 4);\n auto hd = (ImageHeader *)tmp->data;\n auto src = buf->data;\n hd->magic = IMAGE_HEADER_MAGIC;\n hd->bpp = src[0] & 0xf;\n hd->width = src[1];\n hd->height = src[2];\n hd->padding = 0;\n memcpy(hd->pixels, src + 4, buf->length - 4);\n\n registerGCObj(tmp);\n auto r = NEW_GC(RefImage, tmp);\n unregisterGCObj(tmp);\n return r;\n}\n\n//%\nvoid _drawIcon(Image_ img, Buffer icon, int xy, int c) {\n img->makeWritable();\n\n auto iconImg = convertAndWrap(icon);\n if (!iconImg || iconImg->bpp() != 1)\n return;\n\n drawImageCore(img, iconImg, XX(xy), YY(xy), c);\n}\n\nstatic void drawLineLow(Image_ img, int x0, int y0, int x1, int y1, int c) {\n int dx = x1 - x0;\n int dy = y1 - y0;\n int yi = 1;\n if (dy < 0) {\n yi = -1;\n dy = -dy;\n }\n int D = 2 * dy - dx;\n dx <<= 1;\n dy <<= 1;\n int y = y0;\n for (int x = x0; x <= x1; ++x) {\n setCore(img, x, y, c);\n if (D > 0) {\n y += yi;\n D -= dx;\n }\n D += dy;\n }\n}\n\nstatic void drawLineHigh(Image_ img, int x0, int y0, int x1, int y1, int c) {\n int dx = x1 - x0;\n int dy = y1 - y0;\n int xi = 1;\n if (dx < 0) {\n xi = -1;\n dx = -dx;\n }\n int D = 2 * dx - dy;\n dx <<= 1;\n dy <<= 1;\n int x = x0;\n for (int y = y0; y <= y1; ++y) {\n setCore(img, x, y, c);\n if (D > 0) {\n x += xi;\n D -= dy;\n }\n D += dx;\n }\n}\n\nvoid drawLine(Image_ img, int x0, int y0, int x1, int y1, int c) {\n if (x1 < x0) {\n drawLine(img, x1, y1, x0, y0, c);\n return;\n }\n int w = x1 - x0;\n int h = y1 - y0;\n\n if (h == 0) {\n if (w == 0)\n setPixel(img, x0, y0, c);\n else\n fillRect(img, x0, y0, w + 1, 1, c);\n return;\n }\n\n if (w == 0) {\n if (h > 0)\n fillRect(img, x0, y0, 1, h + 1, c);\n else\n fillRect(img, x0, y1, 1, -h + 1, c);\n return;\n }\n\n if (x1 < 0 || x0 >= img->width())\n return;\n if (x0 < 0) {\n y0 -= (h * x0 / w);\n x0 = 0;\n }\n if (x1 >= img->width()) {\n int d = (img->width() - 1) - x1;\n y1 += (h * d / w);\n x1 = img->width() - 1;\n }\n\n if (y0 < y1) {\n if (y0 >= img->height() || y1 < 0)\n return;\n if (y0 < 0) {\n x0 -= (w * y0 / h);\n y0 = 0;\n }\n if (y1 >= img->height()) {\n int d = (img->height() - 1) - y1;\n x1 += (w * d / h);\n y1 = img->height() - 1;\n }\n } else {\n if (y1 >= img->height() || y0 < 0)\n return;\n if (y1 < 0) {\n x1 -= (w * y1 / h);\n y1 = 0;\n }\n if (y0 >= img->height()) {\n int d = (img->height() - 1) - y0;\n x0 += (w * d / h);\n y0 = img->height() - 1;\n }\n }\n\n img->makeWritable();\n\n if (h < 0) {\n h = -h;\n if (h < w)\n drawLineLow(img, x0, y0, x1, y1, c);\n else\n drawLineHigh(img, x1, y1, x0, y0, c);\n } else {\n if (h < w)\n drawLineLow(img, x0, y0, x1, y1, c);\n else\n drawLineHigh(img, x0, y0, x1, y1, c);\n }\n}\n\n//%\nvoid _drawLine(Image_ img, int xy, int wh, int c) {\n drawLine(img, XX(xy), YY(xy), XX(wh), YY(wh), c);\n}\n\nvoid blitRow(Image_ img, int x, int y, Image_ from, int fromX, int fromH) {\n if (!img->inRange(x, 0) || !img->inRange(fromX, 0) || fromH <= 0)\n return;\n\n if (img->bpp() != 4 || from->bpp() != 4)\n return;\n\n int fy = 0;\n int stepFY = (from->width() << 16) / fromH;\n int endY = y + fromH;\n if (endY > img->height())\n endY = img->height();\n if (y < 0) {\n fy += -y * stepFY;\n y = 0;\n }\n\n auto dp = img->pix(x, y);\n auto sp = from->pix(fromX, 0);\n\n while (y < endY) {\n int p = fy >> 16, c;\n if (p & 1)\n c = sp[p >> 1] >> 4;\n else\n c = sp[p >> 1] & 0xf;\n if (y & 1) {\n *dp = (*dp & 0x0f) | (c << 4);\n dp++;\n } else {\n *dp = (*dp & 0xf0) | (c & 0xf);\n }\n y++;\n fy += stepFY;\n }\n}\n\n//%\nvoid _blitRow(Image_ img, int xy, Image_ from, int xh) {\n blitRow(img, XX(xy), YY(xy), from, XX(xh), YY(xh));\n}\n\nbool blit(Image_ dst, Image_ src, pxt::RefCollection *args) {\n int xDst = pxt::toInt(args->getAt(0));\n int yDst = pxt::toInt(args->getAt(1));\n int wDst = pxt::toInt(args->getAt(2));\n int hDst = pxt::toInt(args->getAt(3));\n int xSrc = pxt::toInt(args->getAt(4));\n int ySrc = pxt::toInt(args->getAt(5));\n int wSrc = pxt::toInt(args->getAt(6));\n int hSrc = pxt::toInt(args->getAt(7));\n bool transparent = pxt::toBoolQuick(args->getAt(8));\n bool check = pxt::toBoolQuick(args->getAt(9));\n\n int xSrcStep = (wSrc << 16) / wDst;\n int ySrcStep = (hSrc << 16) / hDst;\n\n int xDstClip = abs(min(0, xDst));\n int yDstClip = abs(min(0, yDst));\n int xDstStart = xDst + xDstClip;\n int yDstStart = yDst + yDstClip;\n int xDstEnd = min(dst->width(), xDst + wDst);\n int yDstEnd = min(dst->height(), yDst + hDst);\n\n int xSrcStart = max(0, (xSrc << 16) + xDstClip * xSrcStep);\n int ySrcStart = max(0, (ySrc << 16) + yDstClip * ySrcStep);\n int xSrcEnd = min(src->width(), xSrc + wSrc) << 16;\n int ySrcEnd = min(src->height(), ySrc + hSrc) << 16;\n\n if (!check)\n dst->makeWritable();\n\n for (int yDstCur = yDstStart, ySrcCur = ySrcStart; yDstCur < yDstEnd && ySrcCur < ySrcEnd; ++yDstCur, ySrcCur += ySrcStep) {\n int ySrcCurI = ySrcCur >> 16;\n for (int xDstCur = xDstStart, xSrcCur = xSrcStart; xDstCur < xDstEnd && xSrcCur < xSrcEnd; ++xDstCur, xSrcCur += xSrcStep) {\n int xSrcCurI = xSrcCur >> 16;\n int cSrc = getCore(src, xSrcCurI, ySrcCurI);\n if (check && cSrc) {\n int cDst = getCore(dst, xDstCur, yDstCur);\n if (cDst) {\n return true;\n }\n continue;\n }\n if (!transparent || cSrc) {\n setCore(dst, xDstCur, yDstCur, cSrc);\n }\n }\n }\n return false;\n}\n\n//%\nbool _blit(Image_ img, Image_ src, pxt::RefCollection *args) {\n return blit(img, src, args);\n}\n\nvoid fillCircle(Image_ img, int cx, int cy, int r, int c) {\n int x = r - 1;\n int y = 0;\n int dx = 1;\n int dy = 1;\n int err = dx - (r << 1);\n\n while (x >= y) {\n fillRect(img, cx + x, cy - y, 1, 1 + (y << 1), c);\n fillRect(img, cx + y, cy - x, 1, 1 + (x << 1), c);\n fillRect(img, cx - x, cy - y, 1, 1 + (y << 1), c);\n fillRect(img, cx - y, cy - x, 1, 1 + (x << 1), c);\n if (err <= 0) {\n ++y;\n err += dy;\n dy += 2;\n } else {\n --x;\n dx += 2;\n err += dx - (r << 1);\n }\n }\n}\n\n//%\nvoid _fillCircle(Image_ img, int cxy, int r, int c) {\n fillCircle(img, XX(cxy), YY(cxy), r, c);\n}\n\n} // namespace ImageMethods\n\nnamespace image {\n/**\n * Create new empty (transparent) image\n */\n//%\nImage_ create(int width, int height) {\n Image_ r = mkImage(width, height, IMAGE_BITS);\n if (r)\n memset(r->pix(), 0, r->pixLength());\n else\n target_panic(PANIC_INVALID_IMAGE);\n return r;\n}\n\n/**\n * Create new image with given content\n */\n//%\nImage_ ofBuffer(Buffer buf) {\n return ImageMethods::convertAndWrap(buf);\n}\n\n/**\n * Double the size of an icon\n */\n//%\nBuffer doubledIcon(Buffer icon) {\n if (!isValidImage(icon))\n return NULL;\n\n auto r = NEW_GC(RefImage, icon);\n registerGCObj(r);\n auto t = ImageMethods::doubled(r);\n unregisterGCObj(r);\n return t->buffer;\n}\n\n} // namespace image\n\n// This is 6.5x faster than standard on word-aligned copy\n// probably should move to codal\n\n#ifndef __linux__\nextern \"C\" void *memcpy(void *dst, const void *src, size_t sz) {\n void *dst0 = dst;\n if (sz >= 4 && !((uintptr_t)dst & 3) && !((uintptr_t)src & 3)) {\n size_t cnt = sz >> 2;\n uint32_t *d = (uint32_t *)dst;\n const uint32_t *s = (const uint32_t *)src;\n while (cnt--) {\n *d++ = *s++;\n }\n sz &= 3;\n dst = d;\n src = s;\n }\n\n // see comment in memset() below (have not seen optimization here, but better safe than sorry)\n volatile uint8_t *dd = (uint8_t *)dst;\n volatile uint8_t *ss = (uint8_t *)src;\n\n while (sz--) {\n *dd++ = *ss++;\n }\n\n return dst0;\n}\n\nextern \"C\" void *memset(void *dst, int v, size_t sz) {\n void *dst0 = dst;\n if (sz >= 4 && !((uintptr_t)dst & 3)) {\n size_t cnt = sz >> 2;\n uint32_t vv = 0x01010101 * v;\n uint32_t *d = (uint32_t *)dst;\n while (cnt--) {\n *d++ = vv;\n }\n sz &= 3;\n dst = d;\n }\n\n // without volatile here, GCC may optimize the loop to memset() call which is obviously not great\n volatile uint8_t *dd = (uint8_t *)dst;\n\n while (sz--) {\n *dd++ = v;\n }\n\n return dst0;\n}\n#endif\n",
"image.d.ts": "//% fixedInstances decompileIndirectFixedInstances\ninterface Image {\n /**\n * Fill a rectangle\n */\n //% helper=imageFillRect blockNamespace=\"images\" inlineInputMode=\"inline\" group=\"Drawing\"\n //% block=\"fill rectangle in %picture=variables_get at x %x y %y width %w height %h %c=colorindexpicker\"\n //% help=images/image/fill-rect\n fillRect(x: number, y: number, w: number, h: number, c: color): void;\n\n /**\n * Replace colors in a rectangle\n */\n //% helper=imageMapRect\n mapRect(x: number, y: number, w: number, h: number, colorMap: Buffer): void;\n\n /**\n * Draw a line\n */\n //% helper=imageDrawLine blockNamespace=\"images\" inlineInputMode=\"inline\" group=\"Drawing\"\n //% block=\"draw line in %picture=variables_get from x %x0 y %y0 to x %x1 y %y1 %c=colorindexpicker\"\n //% help=images/image/draw-line\n drawLine(x0: number, y0: number, x1: number, y1: number, c: color): void;\n\n /**\n * Draw an empty rectangle\n */\n //% helper=imageDrawRect blockNamespace=\"images\" inlineInputMode=\"inline\" group=\"Drawing\"\n //% block=\"draw rectangle in %picture=variables_get at x %x y %y width %w height %h %c=colorindexpicker\"\n //% help=images/image/draw-rect\n drawRect(x: number, y: number, w: number, h: number, c: color): void;\n\n /**\n * Set pixel color\n */\n //% shim=ImageMethods::setPixel blockNamespace=\"images\" group=\"Drawing\"\n //% block=\"set %picture=variables_get color at x %x y %y to %c=colorindexpicker\"\n //% help=images/image/set-pixel\n setPixel(x: int32, y: int32, c: int32): void;\n\n /**\n * Get a pixel color\n */\n //% shim=ImageMethods::getPixel blockNamespace=\"images\" group=\"Drawing\"\n //% block=\"%picture=variables_get color at x %x y %y\"\n //% help=images/image/get-pixel\n getPixel(x: int32, y: int32): int32;\n\n /**\n * Fill entire image with a given color\n */\n //% shim=ImageMethods::fill blockNamespace=\"images\" group=\"Drawing\"\n //% block=\"fill %picture=variables_get with %c=colorindexpicker\"\n //% help=images/image/fill\n fill(c: int32): void;\n\n /**\n * Return a copy of the current image\n */\n //% shim=ImageMethods::clone blockNamespace=\"images\" group=\"Create\"\n //% block=\"clone %picture=variables_get\"\n //% help=images/image/clone\n clone(): Image;\n\n /**\n * Flips (mirrors) pixels horizontally in the current image\n */\n //% shim=ImageMethods::flipX blockNamespace=\"images\" group=\"Transformations\"\n //% block=\"flip %picture=variables_get horizontally\"\n //% help=images/image/flip-x\n flipX(): void;\n\n /**\n * Flips (mirrors) pixels vertically in the current image\n */\n //% shim=ImageMethods::flipY blockNamespace=\"images\" group=\"Transformations\"\n //% block=\"flip %picture=variables_get vertically\"\n //% help=images/image/flip-y\n flipY(): void;\n\n /**\n * Every pixel in image is moved by (dx,dy)\n */\n //% shim=ImageMethods::scroll blockNamespace=\"images\" group=\"Transformations\"\n //% help=images/image/scroll\n scroll(dx: int32, dy: int32): void;\n\n /**\n * Replaces one color in an image with another\n */\n //% shim=ImageMethods::replace blockNamespace=\"images\" group=\"Transformations\"\n //% block=\"change color in %picture=variables_get from %from=colorindexpicker to %to=colorindexpicker\"\n //% help=images/image/replace\n replace(from: int32, to: int32): void;\n\n /**\n * Returns true if the provided image is the same as this image,\n * otherwise returns false.\n */\n //% shim=ImageMethods::equals\n //% blockNamespace=\"images\" group=\"Compare\"\n //% block=\"$this is equal to image $other\"\n //% this.shadow=variables_get\n //% this.defl=\"picture\"\n //% other.shadow=screen_image_picker\n equals(other: Image): boolean;\n\n //% shim=ImageMethods::isStatic\n isStatic(): boolean;\n\n //% shim=ImageMethods::revision\n revision(): number;\n}\n\ndeclare namespace image {\n //% blockNamespace=\"images\"\n //% block=\"create image width %width height %height\" group=\"Create\"\n //% help=images/create\n function create(width: number, height: number): Image;\n}",
"image.ts": "type color = number\n\nnamespace image {\n export function repeatY(count: number, image: Image) {\n let arr = [image]\n while (--count > 0)\n arr.push(image)\n return concatY(arr)\n }\n\n export function concatY(images: Image[]) {\n let w = 0\n let h = 0\n for (let img of images) {\n w = Math.max(img.width, w)\n h += img.height\n }\n let r = image.create(w, h)\n let y = 0\n for (let img of images) {\n let x = (w - img.width) >> 1\n r.drawImage(img, x, y)\n y += img.height\n }\n return r\n }\n}\n\n\n//% snippet='img` `'\n//% pySnippet='img(\"\"\" \"\"\")'\n//% fixedInstances\ninterface Image {\n /**\n * Draw an icon (monochromatic image) using given color\n */\n //% helper=imageDrawIcon\n drawIcon(icon: Buffer, x: number, y: number, c: color): void;\n\n /**\n * Fill a rectangle\n */\n //% helper=imageFillRect\n fillRect(x: number, y: number, w: number, h: number, c: color): void;\n\n /**\n * Draw a line\n */\n //% helper=imageDrawLine\n drawLine(x0: number, y0: number, x1: number, y1: number, c: color): void;\n\n /**\n * Draw an empty rectangle\n */\n //% helper=imageDrawRect\n drawRect(x: number, y: number, w: number, h: number, c: color): void;\n\n /**\n * Draw a circle\n */\n //% helper=imageDrawCircle\n drawCircle(cx: number, cy: number, r: number, c: color): void;\n\n /**\n * Fills a circle\n */\n //% helper=imageFillCircle\n fillCircle(cx: number, cy: number, r: number, c: color): void;\n\n /**\n * Returns an image rotated by -90, 0, 90, 180, 270 deg clockwise\n */\n //% helper=imageRotated\n rotated(deg: number): Image;\n\n /**\n * Scale and copy a row of pixels from a texture.\n */\n //% helper=imageBlitRow\n blitRow(dstX: number, dstY: number, from: Image, fromX: number, fromH: number): void;\n\n /**\n * Copy an image from a source rectangle to a destination rectangle, stretching or\n * compressing to fit the dimensions of the destination rectangle, if necessary.\n */\n //% helper=imageBlit\n blit(xDst: number, yDst: number, wDst: number, hDst: number, src: Image, xSrc: number, ySrc: number, wSrc: number, hSrc: number, transparent: boolean, check: boolean): boolean;\n}\n\ninterface ScreenImage extends Image {\n /**\n * Sets the screen backlight brightness (10-100)\n */\n //% helper=setScreenBrightness\n setBrightness(deg: number): Image;\n\n /**\n * Gets current screen backlight brightness (0-100)\n */\n //% helper=screenBrightness\n brightness(): number;\n}\n\n// pxt compiler currently crashes on non-functions in helpers namespace; will fix\nnamespace _helpers_workaround {\n export let brightness = 100\n}\n\nnamespace helpers {\n //% shim=ImageMethods::_drawLine\n function _drawLine(img: Image, xy: number, wh: number, c: color): void { }\n\n //% shim=ImageMethods::_fillRect\n function _fillRect(img: Image, xy: number, wh: number, c: color): void { }\n\n //% shim=ImageMethods::_mapRect\n function _mapRect(img: Image, xy: number, wh: number, m: Buffer): void { }\n\n //% shim=ImageMethods::_drawIcon\n function _drawIcon(img: Image, icon: Buffer, xy: number, c: color): void { }\n\n //% shim=ImageMethods::_fillCircle\n declare function _fillCircle(img: Image, cxy: number, r: number, c: color): void;\n\n //% shim=ImageMethods::_blitRow\n declare function _blitRow(img: Image, xy: number, from: Image, xh: number): void;\n\n //% shim=ImageMethods::_blit\n declare function _blit(img: Image, src: Image, args: number[]): boolean;\n\n function pack(x: number, y: number) {\n return (Math.clamp(-30000, 30000, x | 0) & 0xffff) | (Math.clamp(-30000, 30000, y | 0) << 16)\n }\n\n let _blitArgs: number[];\n\n export function imageBlit(img: Image, xDst: number, yDst: number, wDst: number, hDst: number, src: Image, xSrc: number, ySrc: number, wSrc: number, hSrc: number, transparent: boolean, check: boolean): boolean {\n _blitArgs = _blitArgs || [];\n _blitArgs[0] = xDst | 0;\n _blitArgs[1] = yDst | 0;\n _blitArgs[2] = wDst | 0;\n _blitArgs[3] = hDst | 0;\n _blitArgs[4] = xSrc | 0;\n _blitArgs[5] = ySrc | 0;\n _blitArgs[6] = wSrc | 0;\n _blitArgs[7] = hSrc | 0;\n _blitArgs[8] = transparent ? 1 : 0;\n _blitArgs[9] = check ? 1 : 0;\n return _blit(img, src, _blitArgs);\n }\n\n export function imageBlitRow(img: Image, dstX: number, dstY: number, from: Image, fromX: number, fromH: number): void {\n _blitRow(img, pack(dstX, dstY), from, pack(fromX, fromH))\n }\n\n export function imageDrawIcon(img: Image, icon: Buffer, x: number, y: number, c: color): void {\n _drawIcon(img, icon, pack(x, y), c)\n }\n export function imageFillRect(img: Image, x: number, y: number, w: number, h: number, c: color): void {\n _fillRect(img, pack(x, y), pack(w, h), c)\n }\n export function imageMapRect(img: Image, x: number, y: number, w: number, h: number, m: Buffer): void {\n _mapRect(img, pack(x, y), pack(w, h), m)\n }\n export function imageDrawLine(img: Image, x: number, y: number, w: number, h: number, c: color): void {\n _drawLine(img, pack(x, y), pack(w, h), c)\n }\n export function imageDrawRect(img: Image, x: number, y: number, w: number, h: number, c: color): void {\n if (w == 0 || h == 0) return\n w--\n h--\n imageDrawLine(img, x, y, x + w, y, c)\n imageDrawLine(img, x, y, x, y + h, c)\n imageDrawLine(img, x + w, y + h, x + w, y, c)\n imageDrawLine(img, x + w, y + h, x, y + h, c)\n }\n\n export function imageDrawCircle(img: Image, cx: number, cy: number, r: number, col: number) {\n cx = cx | 0;\n cy = cy | 0;\n r = r | 0;\n // short cuts\n if (r < 0)\n return;\n\n // Bresenham's algorithm\n let x = 0\n let y = r\n let d = 3 - 2 * r\n\n while (y >= x) {\n img.setPixel(cx + x, cy + y, col)\n img.setPixel(cx - x, cy + y, col)\n img.setPixel(cx + x, cy - y, col)\n img.setPixel(cx - x, cy - y, col)\n img.setPixel(cx + y, cy + x, col)\n img.setPixel(cx - y, cy + x, col)\n img.setPixel(cx + y, cy - x, col)\n img.setPixel(cx - y, cy - x, col)\n x++\n if (d > 0) {\n y--\n d += 4 * (x - y) + 10\n } else {\n d += 4 * x + 6\n }\n }\n }\n\n export function imageFillCircle(img: Image, cx: number, cy: number, r: number, col: number) {\n _fillCircle(img, pack(cx, cy), r, col);\n }\n\n /**\n * Returns an image rotated by 90, 180, 270 deg clockwise\n */\n export function imageRotated(img: Image, deg: number) {\n if (deg == -90 || deg == 270) {\n let r = img.transposed();\n r.flipY();\n return r;\n } else if (deg == 180 || deg == -180) {\n let r = img.clone();\n r.flipX();\n r.flipY();\n return r;\n } else if (deg == 90) {\n let r = img.transposed();\n r.flipX();\n return r;\n } else {\n return null;\n }\n }\n\n //% shim=pxt::setScreenBrightness\n function _setScreenBrightness(brightness: number) { }\n\n export function setScreenBrightness(img: Image, b: number) {\n b = Math.clamp(10, 100, b | 0);\n _helpers_workaround.brightness = b\n _setScreenBrightness(_helpers_workaround.brightness)\n }\n\n export function screenBrightness(img: Image) {\n return _helpers_workaround.brightness\n }\n}\n",
"imagesoverrides.jres": "{\n \"*\": {\n \"namespace\": \"images.food\",\n \"mimeType\": \"image/x-mkcd-f4\",\n \"dataEncoding\": \"base64\"\n },\n \"smallBurger\": \"5BAQAAAA7g6I7u4AAOy763fG6w7ATES7Lma+DsBERUTucujLvEREROtiyMtMRERE5GLMxExERUTkcuzES0RERORy6MRLRURU5HLo5EtERETkYuzkS0RERORi7OS7VERE63LM5LBEVETuYujksEtEtC7Gvg4A7EvrdszrDgAA7A6I7u4A\",\n \"smallApple\": \"5BAQAAAAwMzMDAAAAMDs7u7uAgAA7O7u7u4uAADu7iIi4u4C4O4uIiIi4gLg7iIiIiIiLuDuLiIiIiIuzswsIiIiIuR8ZywiIiIi5HfuIiIiIiLk4OJEIiIiQuLgIlUkIiJCDgAuVCQiIiQOAC4iIiJE4gAA4C4iIuIOAAAA4O7uDgAA\",\n \"smallLemon\": \"5BAQAEQLsMzMAAAAVLRL3UTMAABUVV1F1UQMAEBVVVVV1cQAQFFVVUVVRAxUVVVVXUVNDFQRVVXVVUTLVBFVVVXdRMRUUVVVVU1ExFRVVVVVTUTEQBVVVVXVRMtAFVFVVVVNywBUEVVVVV20AEBVFVVVVbUAAERVVUVdRAAAAEREy0wE\",\n \"smallDrumstick\": \"5BAQAAAiIiIAAAAAILK7KwIAAACyRES06wAAAEJERES7DgAAS0RERLsOAABLREREtOsAAEtNRES05AAAS01ERLTkAABL1EREu+sAALBETUS77gAAALtEtOvuAAAAALvu7r7LDAAAAAAA2xHBAAAAAACw0csAAAAAALDRDAAAAAAAALsA\",\n \"smallHam\": \"5BAQAAAAACIi7g4AAAAi093d4wAAIBMxM9M9DgAy0T0zMxPjIBMz0zMzE+Mg3TMTETPR4zIxMzET3d3jMjEzETEzHeMyPdMzMzMT4zLdPTMzMx3rINMxMzMdse7gMhMRET277gDuOzO7u+vuAAC+RERE7g4AALBLRLTuAAAAALvu7gAA\",\n \"smallPizza\": \"5BAQAAAAAAAAALtEAAAAAAC7XU0AAAAAuyNTTQAAALtdIlJNAAC7XVcjXQQAsD0yVVXVBLtLJSJVV9UES7s1MlVVRQBLtFVVI1NNAEu0VFciUk0AsERLVSNTTQAAS+RUVdUEAACwRO5V3QQAAABL5N7tAAAAALDk7k4AAAAAAO7uBAAA\",\n \"smallDonut\": \"5BAQAAAAALurqgAAAAC7MzOjDgAAsDMzMzPqAADbPTMzM+oOsN0zMzMzug6wPTOzM9O6Dts9M6oz00oO2zOjOjPTSg7bM6MzM61EDjszOzMzrUQOOjMzM9NKtA46MzMzrUTkAKAzM91KRO4AoDozqkTkDgAAqqpERO4AAAAAu7vuAAAA\",\n \"smallCake\": \"5BAQAAAAsLu7uwsAAACwsz0zCwAAADuz1dMLAAAAO7PVU7MAALAzvVVTvQAAsDO9VVO1AAA7M71dMzULADszPVs91Quw7jPTWzVVC+AjPtNbNVUL6yI+01o1VbM77jPT2j1VvTszM9Pavd29sDoz3dq93a0AoDo92r07qwAAoKqqqqoK\",\n \"smallIceCream\": \"5BAQAAAAAAAAREQAAAAzS0RdVQQAMBG91N1VRQDTERG9VV1FMN0dEdFb1UUTEdEREb3VBBMRER0Rsd0E2xER0RHR2wQz3RHRERFLANPRHREREUsAHREdER0RvQAdEdERHRE9ABMdEREd0QMAEzMb0TszAAAwMTAzCwAAAAAzAAAAAAAA\",\n \"smallStrawberry\": \"5BAQAAAAAO7u7u4OAADuIiIi7s4A4CJERCTizgAuQkUiIu7CAC5EIiIiIs4ALiQiQiLizoAoYmYmIiTMZuh3dyYiIs5ghndnIkLiDABmdyZC4u4MAGBnIiIi7gwAdndnLuLOAGBnaHfn7gwAgAiGdnfMAAAAAIBgZgYAAAAAAAAAAAAA\",\n \"smallCherries\": \"5BAQAAAA4O4MAAAAAAAuIsIAAAAA4ELiLgwAAADgJeLu4gAAAOAkIuLCAAAA4CIi4sIAAADILiIi7gAAAGgsIuLOzAAAaMjsLiLiDGCHAOBCIu7OYIcA4CUi7sJ2CADgJCLiwnaIZsgiIuLCdnZ3Ziwi7sJ2iIiIyCIiDIYIAAAA7swA\",\n \"smallTaco\": \"5BAQAAAAAODu7k4AAADgTlVVVQQAAF5VzOxORQDgZYbOzO5EAF4iZ+hVVeXgZCJnVUVV5eBlh1hFVVXkTnaGVVVFVQ5eIlZUVFXlAF4iVFVVVeQAXmdVVEVVDgDgRlVVVeUAAOBGVUVV5AAAAE5FVVUOAAAA4FRV5QAAAAAAQEQEAAAA\"\n}",
"imagesoverrides.ts": "namespace images.food {\n //% fixedInstance jres blockIdentity=images._image\n export const smallBurger = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallApple = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallLemon = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallDrumstick = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallHam = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallPizza = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallDonut = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallCake = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallIceCream = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallStrawberry = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallCherries = image.ofBuffer(hex``);\n //% fixedInstance jres blockIdentity=images._image\n export const smallTaco = image.ofBuffer(hex``);\n}\n",
"indexedscreen.h": "// Autogenerated C header file for Indexed screen\n#ifndef _JACDAC_SPEC_INDEXED_SCREEN_H\n#define _JACDAC_SPEC_INDEXED_SCREEN_H 1\n\n#define JD_SERVICE_CLASS_INDEXED_SCREEN 0x16fa36e5\n\n/**\n * Sets the update window for subsequent `set_pixels` commands.\n */\n#define JD_INDEXED_SCREEN_CMD_START_UPDATE 0x81\ntypedef struct jd_indexed_screen_start_update {\n uint16_t x; // px\n uint16_t y; // px\n uint16_t width; // px\n uint16_t height; // px\n} jd_indexed_screen_start_update_t;\n\n\n/**\n * Argument: pixels bytes. Set pixels in current window, according to current palette.\n * Each \"line\" of data is aligned to a byte.\n */\n#define JD_INDEXED_SCREEN_CMD_SET_PIXELS 0x83\n\n/**\n * Read-write ratio u0.8 (uint8_t). Set backlight brightness.\n * If set to `0` the display may go to sleep.\n */\n#define JD_INDEXED_SCREEN_REG_BRIGHTNESS JD_REG_INTENSITY\n\n/**\n * The current palette.\n * The color entry repeats `1 << bits_per_pixel` times.\n * This register may be write-only.\n */\n#define JD_INDEXED_SCREEN_REG_PALETTE 0x80\ntypedef struct jd_indexed_screen_palette {\n uint8_t blue;\n uint8_t green;\n uint8_t red;\n uint8_t padding;\n} jd_indexed_screen_palette_t;\n\n\n/**\n * Constant bit uint8_t. Determines the number of palette entries.\n * Typical values are 1, 2, 4, or 8.\n */\n#define JD_INDEXED_SCREEN_REG_BITS_PER_PIXEL 0x180\n\n/**\n * Constant px uint16_t. Screen width in \"natural\" orientation.\n */\n#define JD_INDEXED_SCREEN_REG_WIDTH 0x181\n\n/**\n * Constant px uint16_t. Screen height in \"natural\" orientation.\n */\n#define JD_INDEXED_SCREEN_REG_HEIGHT 0x182\n\n/**\n * Read-write bool (uint8_t). If true, consecutive pixels in the \"width\" direction are sent next to each other (this is typical for graphics cards).\n * If false, consecutive pixels in the \"height\" direction are sent next to each other.\n * For embedded screen controllers, this is typically true iff `width < height`\n * (in other words, it's only true for portrait orientation screens).\n * Some controllers may allow the user to change this (though the refresh order may not be optimal then).\n * This is independent of the `rotation` register.\n */\n#define JD_INDEXED_SCREEN_REG_WIDTH_MAJOR 0x81\n\n/**\n * Read-write px uint8_t. Every pixel sent over wire is represented by `up_sampling x up_sampling` square of physical pixels.\n * Some displays may allow changing this (which will also result in changes to `width` and `height`).\n * Typical values are 1 and 2.\n */\n#define JD_INDEXED_SCREEN_REG_UP_SAMPLING 0x82\n\n/**\n * Read-write ° uint16_t. Possible values are 0, 90, 180 and 270 only.\n * Write to this register do not affect `width` and `height` registers,\n * and may be ignored by some screens.\n */\n#define JD_INDEXED_SCREEN_REG_ROTATION 0x83\n\n#endif\n",
"jddisplay.cpp": "#include \"pxt.h\"\n#include \"jddisplay.h\"\n\n#define VLOG NOLOG\n//#define VLOG DMESG\n\nnamespace pxt {\n\n#define ALIGN(x) (((x) + 3) & ~3)\n\nstatic void jd_panic(void) {\n target_panic(PANIC_SCREEN_ERROR);\n}\n\nstatic int jd_shift_frame(jd_frame_t *frame) {\n int psize = frame->size;\n jd_packet_t *pkt = (jd_packet_t *)frame;\n int oldsz = pkt->service_size + 4;\n if (ALIGN(oldsz) >= psize)\n return 0; // nothing to shift\n\n int ptr;\n if (frame->data[oldsz] == 0xff) {\n ptr = frame->data[oldsz + 1];\n if (ptr >= psize)\n return 0; // End-of-frame\n if (ptr <= oldsz) {\n DMESG(\"invalid super-frame %d %d\", ptr, oldsz);\n return 0; // don't let it go back, must be some corruption\n }\n } else {\n ptr = ALIGN(oldsz);\n }\n\n // assume the first one got the ACK sorted\n frame->flags &= ~JD_FRAME_FLAG_ACK_REQUESTED;\n\n uint8_t *src = &frame->data[ptr];\n int newsz = *src + 4;\n if (ptr + newsz > psize) {\n DMESG(\"invalid super-frame %d %d %d\", ptr, newsz, psize);\n return 0;\n }\n uint32_t *dst = (uint32_t *)frame->data;\n uint32_t *srcw = (uint32_t *)src;\n // don't trust memmove()\n for (int i = 0; i < newsz; i += 4)\n *dst++ = *srcw++;\n // store ptr\n ptr += ALIGN(newsz);\n frame->data[newsz] = 0xff;\n frame->data[newsz + 1] = ptr;\n\n return 1;\n}\n\nstatic void *jd_push_in_frame(jd_frame_t *frame, unsigned service_num, unsigned service_cmd,\n unsigned service_size) {\n if (service_num >> 8)\n jd_panic();\n if (service_cmd >> 16)\n jd_panic();\n uint8_t *dst = frame->data + frame->size;\n unsigned szLeft = (uint8_t *)frame + sizeof(*frame) - dst;\n if (service_size + 4 > szLeft)\n return NULL;\n *dst++ = service_size;\n *dst++ = service_num;\n *dst++ = service_cmd & 0xff;\n *dst++ = service_cmd >> 8;\n frame->size += ALIGN(service_size + 4);\n return dst;\n}\n\nJDDisplay::JDDisplay(SPI *spi, Pin *cs, Pin *flow) : spi(spi), cs(cs), flow(flow) {\n inProgress = false;\n stepWaiting = false;\n displayServiceNum = 0;\n controlsStartServiceNum = 0;\n controlsEndServiceNum = 0;\n soundServiceNum = 0;\n buttonState = 0;\n brightness = 100;\n soundBufferPending = 0;\n soundSampleRate = 44100;\n avgFrameTime = 26300; // start with a reasonable default\n lastFrameTimestamp = 0;\n\n EventModel::defaultEventBus->listen(DEVICE_ID_DISPLAY, 4243, this, &JDDisplay::sendDone);\n\n flow->getDigitalValue(PullMode::Down);\n EventModel::defaultEventBus->listen(flow->id, DEVICE_PIN_EVENT_ON_EDGE, this,\n &JDDisplay::onFlowHi, MESSAGE_BUS_LISTENER_IMMEDIATE);\n flow->eventOn(DEVICE_PIN_EVT_RISE);\n}\n\nvoid JDDisplay::waitForSendDone() {\n if (inProgress)\n fiber_wait_for_event(DEVICE_ID_DISPLAY, 4242);\n}\n\nvoid JDDisplay::sendDone(Event) {\n inProgress = false;\n Event(DEVICE_ID_DISPLAY, 4242);\n}\n\nvoid *JDDisplay::queuePkt(uint32_t service_num, uint32_t service_cmd, uint32_t size) {\n void *res = jd_push_in_frame(&sendFrame, service_num, service_cmd, size);\n if (res == NULL)\n target_panic(PANIC_SCREEN_ERROR);\n return res;\n}\n\nvoid JDDisplay::flushSend() {\n if (cs)\n cs->setDigitalValue(0);\n spi->startTransfer((uint8_t *)&sendFrame, sizeof(sendFrame), (uint8_t *)&recvFrame,\n sizeof(recvFrame), &JDDisplay::stepStatic, this);\n}\n\nvoid JDDisplay::stepStatic(void *p) {\n ((JDDisplay *)p)->step();\n}\n\n// We assume EIC IRQ pre-empts SPI/DMA IRQ (that is the numerical priority value of EIC is lower)\n// This is true for codal STM32, SAMD, and NRF52\nvoid JDDisplay::onFlowHi(Event) {\n if (stepWaiting)\n step();\n}\n\nvoid JDDisplay::handleIncoming(jd_packet_t *pkt) {\n if (pkt->service_number == JD_SERVICE_NUMBER_CTRL &&\n pkt->service_command == JD_CMD_ADVERTISEMENT_DATA) {\n uint32_t *servptr = (uint32_t *)pkt->data;\n int numServ = pkt->service_size >> 2;\n for (uint8_t servIdx = 1; servIdx < numServ; ++servIdx) {\n uint32_t service_class = servptr[servIdx];\n if (service_class == JD_SERVICE_CLASS_INDEXED_SCREEN) {\n displayServiceNum = servIdx;\n VLOG(\"JDA: found screen, serv=%d\", servIdx);\n } else if (service_class == JD_SERVICE_CLASS_ARCADE_GAMEPAD) {\n if (!controlsStartServiceNum)\n controlsStartServiceNum = servIdx;\n controlsEndServiceNum = servIdx;\n VLOG(\"JDA: found controls, serv=%d\", servIdx);\n } else if (service_class == JD_SERVICE_CLASS_ARCADE_SOUND) {\n soundServiceNum = servIdx;\n VLOG(\"JDA: found sound, serv=%d\", servIdx);\n } else {\n VLOG(\"JDA: unknown service: %x\", service_class);\n }\n }\n } else if (pkt->service_number == JD_SERVICE_NUMBER_CTRL &&\n pkt->service_command == JD_CMD_CTRL_NOOP) {\n // do nothing\n } else if (pkt->service_number == soundServiceNum) {\n switch (pkt->service_command) {\n case JD_GET(JD_ARCADE_SOUND_REG_BUFFER_PENDING):\n soundBufferPending = *(uint32_t *)pkt->data;\n break;\n case JD_GET(JD_ARCADE_SOUND_REG_SAMPLE_RATE):\n soundSampleRate = *(uint32_t *)pkt->data >> 10;\n break;\n }\n } else if (pkt->service_number == displayServiceNum) {\n switch (pkt->service_command) {\n case JD_GET(JD_INDEXED_SCREEN_REG_HEIGHT):\n screenHeight = *(uint16_t *)pkt->data;\n break;\n case JD_GET(JD_INDEXED_SCREEN_REG_WIDTH):\n screenWidth = *(uint16_t *)pkt->data;\n break;\n }\n } else if (controlsStartServiceNum <= pkt->service_number &&\n pkt->service_number <= controlsEndServiceNum &&\n pkt->service_command == (JD_CMD_GET_REG | JD_REG_READING)) {\n auto report = (jd_arcade_gamepad_buttons_t *)pkt->data;\n auto endp = pkt->data + pkt->service_size;\n uint32_t state = 0;\n\n while ((uint8_t *)report < endp) {\n int idx = 0;\n int b = report->button;\n\n if (report->pressure < 0x20)\n continue;\n\n if (b == JD_ARCADE_GAMEPAD_BUTTON_SELECT)\n b = JD_ARCADE_GAMEPAD_BUTTON_MENU;\n\n if (b == JD_ARCADE_GAMEPAD_BUTTON_RESET || b == JD_ARCADE_GAMEPAD_BUTTON_EXIT)\n target_reset();\n\n if (1 <= b && b <= 7) {\n idx = b + 7 * (pkt->service_number - controlsStartServiceNum);\n }\n\n if (idx > 0)\n state |= 1 << idx;\n\n report++;\n }\n\n if (state != buttonState) {\n for (int i = 0; i < 32; ++i) {\n if ((state & (1 << i)) && !(buttonState & (1 << i)))\n Event(PXT_INTERNAL_KEY_DOWN, i);\n if (!(state & (1 << i)) && (buttonState & (1 << i)))\n Event(PXT_INTERNAL_KEY_UP, i);\n }\n buttonState = state;\n }\n } else {\n // TODO remove later\n VLOG(\"JDA: unknown packet for %d (cmd=%x)\", pkt->service_number, pkt->service_command);\n }\n}\n\nvoid JDDisplay::step() {\n if (cs)\n cs->setDigitalValue(1);\n\n target_disable_irq();\n if (!flow->getDigitalValue()) {\n stepWaiting = true;\n target_enable_irq();\n return;\n } else {\n stepWaiting = false;\n }\n target_enable_irq();\n\n memset(&sendFrame, 0, JD_SERIAL_FULL_HEADER_SIZE);\n sendFrame.crc = JDSPI_MAGIC;\n sendFrame.device_identifier = pxt::getLongSerialNumber();\n\n if (recvFrame.crc == JDSPI_MAGIC_NOOP) {\n // empty frame, skip\n } else if (recvFrame.crc != JDSPI_MAGIC) {\n DMESG(\"JDA: magic mismatch %x\", (int)recvFrame.crc);\n } else if (recvFrame.size == 0) {\n // empty frame, skip\n } else {\n for (;;) {\n handleIncoming((jd_packet_t *)&recvFrame);\n if (!jd_shift_frame(&recvFrame))\n break;\n }\n }\n\n if (displayServiceNum == 0) {\n // poke the control service to enumerate\n queuePkt(JD_SERVICE_NUMBER_CTRL, JD_CMD_ADVERTISEMENT_DATA, 0);\n flushSend();\n return;\n }\n\n if (palette) {\n {\n#define PALETTE_SIZE (16 * 4)\n auto cmd =\n queuePkt(displayServiceNum, JD_SET(JD_INDEXED_SCREEN_REG_PALETTE), PALETTE_SIZE);\n memcpy(cmd, palette, PALETTE_SIZE);\n palette = NULL;\n }\n {\n auto cmd = (jd_indexed_screen_start_update_t *)queuePkt(\n displayServiceNum, JD_INDEXED_SCREEN_CMD_START_UPDATE,\n sizeof(jd_indexed_screen_start_update_t));\n *cmd = this->addr;\n }\n {\n auto cmd =\n (uint8_t *)queuePkt(displayServiceNum, JD_SET(JD_INDEXED_SCREEN_REG_BRIGHTNESS), 1);\n *cmd = this->brightness * 0xff / 100;\n }\n\n if (soundServiceNum) {\n // we only need this for sending sound\n uint32_t now = (uint32_t)current_time_us();\n if (lastFrameTimestamp) {\n uint32_t thisFrame = now - lastFrameTimestamp;\n avgFrameTime = (avgFrameTime * 15 + thisFrame) >> 4;\n }\n lastFrameTimestamp = now;\n // send around 2 frames of sound; typically around 60ms, so ~3000 samples\n soundBufferDesiredSize =\n sizeof(int16_t *) * ((((avgFrameTime * 2) >> 10) * soundSampleRate) >> 10);\n }\n\n flushSend();\n return;\n }\n\n if (dataLeft > 0) {\n uint32_t transfer = bytesPerTransfer;\n if (dataLeft < transfer)\n transfer = dataLeft;\n auto pixels = queuePkt(displayServiceNum, JD_INDEXED_SCREEN_CMD_SET_PIXELS, transfer);\n memcpy(pixels, dataPtr, transfer);\n dataPtr += transfer;\n dataLeft -= transfer;\n flushSend();\n } else if (soundServiceNum && soundBufferPending < soundBufferDesiredSize) {\n int bytesLeft = soundBufferDesiredSize - soundBufferPending;\n if (bytesLeft > bytesPerTransfer)\n bytesLeft = bytesPerTransfer;\n auto samples = (int16_t *)queuePkt(soundServiceNum, JD_ARCADE_SOUND_CMD_PLAY, bytesLeft);\n if (pxt::redirectSamples(samples, bytesLeft >> 1, soundSampleRate)) {\n soundBufferPending += bytesLeft;\n } else {\n // no sound generated, fill with 0 and stop\n memset(samples, 0, bytesLeft);\n soundBufferDesiredSize = 0;\n }\n flushSend();\n } else {\n // trigger sendDone(), which executes outside of IRQ context, so there\n // is no race with waitForSendDone\n Event(DEVICE_ID_DISPLAY, 4243);\n }\n}\n\nint JDDisplay::sendIndexedImage(const uint8_t *src, unsigned width, unsigned height,\n uint32_t *palette) {\n if (height & 1 || !height || !width)\n target_panic(PANIC_SCREEN_ERROR);\n if (width != addr.width || height != addr.height)\n target_panic(PANIC_SCREEN_ERROR);\n if (inProgress)\n target_panic(PANIC_SCREEN_ERROR);\n\n if (addr.y && addr.y >= screenHeight)\n return 0; // out of range\n\n inProgress = true;\n\n int numcols = JD_SERIAL_PAYLOAD_SIZE / (height / 2);\n\n bytesPerTransfer = numcols * (height / 2);\n dataLeft = (height / 2) * width;\n dataPtr = src;\n\n this->palette = palette;\n\n memset(&sendFrame, 0, sizeof(sendFrame));\n\n step();\n\n return 0;\n}\n\n} // namespace pxt",
"jddisplay.h": "#ifndef __JDDISPLAY_H\n#define __JDDISPLAY_H\n\n#include \"pxt.h\"\n#include \"jdprotocol.h\"\n#include \"arcadegamepad.h\"\n#include \"indexedscreen.h\"\n#include \"arcadesound.h\"\n\nnamespace pxt {\n\nclass JDDisplay {\n jd_indexed_screen_start_update_t addr;\n SPI *spi;\n Pin *cs;\n Pin *flow;\n uint32_t dataLeft;\n const uint8_t *dataPtr;\n uint32_t *palette;\n jd_frame_t sendFrame;\n jd_frame_t recvFrame;\n uint8_t bytesPerTransfer;\n bool inProgress;\n volatile bool stepWaiting;\n uint8_t displayServiceNum;\n uint8_t controlsStartServiceNum;\n uint8_t controlsEndServiceNum; \n uint8_t soundServiceNum; \n uint16_t screenWidth, screenHeight;\n uint32_t buttonState;\n uint32_t avgFrameTime; // in us\n uint32_t lastFrameTimestamp;\n\n uint32_t soundBufferDesiredSize;\n uint32_t soundBufferPending;\n uint16_t soundSampleRate;\n\n void *queuePkt(uint32_t service_num, uint32_t service_cmd, uint32_t size);\n void flushSend();\n void step();\n void sendDone(Event);\n static void stepStatic(void *);\n void onFlowHi(Event);\n void handleIncoming(jd_packet_t *pkt);\n\n public:\n uint8_t brightness;\n JDDisplay(SPI *spi, Pin *cs, Pin *flow);\n void setAddrWindow(int x, int y, int w, int h) {\n addr.x = x;\n addr.y = y;\n addr.width = w;\n addr.height = h;\n }\n void waitForSendDone();\n\n int sendIndexedImage(const uint8_t *src, unsigned width, unsigned height, uint32_t *palette);\n};\n\n} // namespace pxt\n\n#endif\n",
"jdprotocol.h": "#ifndef __JDPROTOCOL_H\n#define __JDPROTOCOL_H\n\n#include \n#include \n\n#ifdef __cplusplus\nextern \"C\" {\n#endif\n\n// 255 minus size of the serial header, rounded down to 4\n#define JD_SERIAL_PAYLOAD_SIZE 236\n#define JD_SERIAL_FULL_HEADER_SIZE 16\n\n#define JD_SERVICE_CLASS_CTRL 0x00000000\n\n#define JD_SERVICE_NUMBER_CTRL 0x00\n#define JD_SERVICE_NUMBER_MASK 0x3f\n#define JD_SERVICE_NUMBER_CRC_ACK 0x3f\n\n// the COMMAND flag signifies that the device_identifier is the recipent\n// (i.e., it's a command for the peripheral); the bit clear means device_identifier is the source\n// (i.e., it's a report from peripheral or a broadcast message)\n#define JD_FRAME_FLAG_COMMAND 0x01\n// an ACK should be issued with CRC of this package upon reception\n#define JD_FRAME_FLAG_ACK_REQUESTED 0x02\n// the device_identifier contains target service class number\n#define JD_FRAME_FLAG_IDENTIFIER_IS_SERVICE_CLASS 0x04\n\n#define JD_FRAME_SIZE(pkt) ((pkt)->size + 12)\n\n// Registers 0x001-0x07f - r/w common to all services\n// Registers 0x080-0x0ff - r/w defined per-service\n// Registers 0x100-0x17f - r/o common to all services\n// Registers 0x180-0x1ff - r/o defined per-service\n// Registers 0x200-0xeff - custom, defined per-service\n// Registers 0xf00-0xfff - reserved for implementation, should not be on the wire\n\n// this is either binary (0 or non-zero), or can be gradual (eg. brightness of neopixel)\n#define JD_REG_INTENSITY 0x01\n// the primary value of actuator (eg. servo angle)\n#define JD_REG_VALUE 0x02\n// enable/disable streaming\n#define JD_REG_IS_STREAMING 0x03\n// streaming interval in miliseconds\n#define JD_REG_STREAMING_INTERVAL 0x04\n// for analog sensors\n#define JD_REG_LOW_THRESHOLD 0x05\n#define JD_REG_HIGH_THRESHOLD 0x06\n// limit power drawn; in mA\n#define JD_REG_MAX_POWER 0x07\n\n// eg. one number for light sensor, all 3 coordinates for accelerometer\n#define JD_REG_READING 0x101\n\n#define JD_CMD_GET_REG 0x1000\n#define JD_CMD_SET_REG 0x2000\n\n#define JD_GET(reg) (JD_CMD_GET_REG | (reg))\n#define JD_SET(reg) (JD_CMD_SET_REG | (reg))\n\n// Commands 0x000-0x07f - common to all services\n// Commands 0x080-0xeff - defined per-service\n// Commands 0xf00-0xfff - reserved for implementation\n// enumeration data for CTRL, ad-data for other services\n#define JD_CMD_ADVERTISEMENT_DATA 0x00\n// event from sensor or on broadcast service\n#define JD_CMD_EVENT 0x01\n// request to calibrate sensor\n#define JD_CMD_CALIBRATE 0x02\n// request human-readable description of service\n#define JD_CMD_GET_DESCRIPTION 0x03\n\n// Commands specific to control service\n// do nothing\n#define JD_CMD_CTRL_NOOP 0x80\n// blink led or otherwise draw user's attention\n#define JD_CMD_CTRL_IDENTIFY 0x81\n// reset device\n#define JD_CMD_CTRL_RESET 0x82\n// identifies the type of hardware (eg., ACME Corp. Servo X-42 Rev C)\n#define JD_REG_CTRL_DEVICE_DESCRIPTION 0x180\n// a numeric code for the string above; used to mark firmware images\n#define JD_REG_CTRL_DEVICE_CLASS 0x181\n// MCU temperature in Celsius\n#define JD_REG_CTRL_TEMPERATURE 0x182\n// this is very approximate; ADC reading from backward-biasing the identification LED\n#define JD_REG_CTRL_LIGHT_LEVEL 0x183\n// typically the same as JD_REG_CTRL_DEVICE_CLASS; the bootloader will respond to that code\n#define JD_REG_CTRL_BL_DEVICE_CLASS 0x184\n\nstruct _jd_packet_t {\n uint16_t crc;\n uint8_t _size; // of frame data[]\n uint8_t flags;\n\n uint64_t device_identifier;\n\n uint8_t service_size;\n uint8_t service_number;\n uint16_t service_command;\n\n uint8_t data[0];\n} __attribute__((__packed__, aligned(4)));\ntypedef struct _jd_packet_t jd_packet_t;\n\nstruct _jd_frame_t {\n uint16_t crc;\n uint8_t size;\n uint8_t flags;\n\n uint64_t device_identifier;\n\n uint8_t data[JD_SERIAL_PAYLOAD_SIZE + 4];\n} __attribute__((__packed__, aligned(4)));\ntypedef struct _jd_frame_t jd_frame_t;\n\n#define JDSPI_MAGIC 0x7ACD\n#define JDSPI_MAGIC_NOOP 0xB3CD\n\n#ifdef __cplusplus\n}\n#endif\n\n#endif\n",
"ns.ts": " ",
"panic.cpp": "#include \"pxt.h\"\n\n// This adds about 1.2k of binary size, but allows for displaying\n// panic codes regardless of heap state etc. with IRQs disabled.\n\n#define ST7735_NOP 0x00\n#define ST7735_SWRESET 0x01\n#define ST7735_RDDID 0x04\n#define ST7735_RDDST 0x09\n\n#define ST7735_SLPIN 0x10\n#define ST7735_SLPOUT 0x11\n#define ST7735_PTLON 0x12\n#define ST7735_NORON 0x13\n\n#define ST7735_INVOFF 0x20\n#define ST7735_INVON 0x21\n#define ST7735_DISPOFF 0x28\n#define ST7735_DISPON 0x29\n#define ST7735_CASET 0x2A\n#define ST7735_RASET 0x2B\n#define ST7735_RAMWR 0x2C\n#define ST7735_RAMRD 0x2E\n\n#define ST7735_PTLAR 0x30\n#define ST7735_COLMOD 0x3A\n#define ST7735_MADCTL 0x36\n\n#define ST7735_FRMCTR1 0xB1\n#define ST7735_FRMCTR2 0xB2\n#define ST7735_FRMCTR3 0xB3\n#define ST7735_INVCTR 0xB4\n\n#define ST7735_GMCTRP1 0xE0\n#define ST7735_GMCTRN1 0xE1\n\n#define MADCTL_MY 0x80\n#define MADCTL_MX 0x40\n#define MADCTL_MV 0x20\n#define MADCTL_ML 0x10\n#define MADCTL_RGB 0x00\n#define MADCTL_BGR 0x08\n#define MADCTL_MH 0x04\n\nnamespace _pxt_panic {\n\n// target_panic has been called\nstatic bool panicMode = false;\n\n#define DELAY 0x80\n\nclass ST7735 {\n Pin *sck, *mosi, *dc, *cs;\n\n void sendBytes(uint8_t *ptr, uint32_t len);\n void sendCmd(uint8_t *buf, int len);\n void sendCmdSeq(const uint8_t *buf);\n void configure(uint8_t madctl, uint32_t frmctr1);\n\n public:\n uint16_t width, height;\n void fill(int color, int numpixels);\n void setAddrWindow(int x, int y, int w, int h);\n void init();\n void drawNumber(int idx, int x, int y, int color);\n};\n\n// clang-format off\nstatic const uint8_t initCmds[] = {\n ST7735_SWRESET, DELAY, // 1: Software reset, 0 args, w/delay\n 120, // 150 ms delay\n ST7735_SLPOUT , DELAY, // 2: Out of sleep mode, 0 args, w/delay\n 120, // 500 ms delay\n ST7735_INVOFF , 0 , // 13: Don't invert display, no args, no delay\n ST7735_COLMOD , 1 , // 15: set color mode, 1 arg, no delay:\n 0x03, // 12-bit color\n\n ST7735_NORON , DELAY, // 3: Normal display on, no args, w/delay\n 10, // 10 ms delay\n ST7735_DISPON , DELAY, // 4: Main screen turn on, no args w/delay\n 10,\n 0, 0 // END\n};\n// clang-format on\n\nstatic const uint8_t numbers[] = {\n 0x06, 0x09, 0x09, 0x09, 0x06, // 0\n 0x04, 0x06, 0x04, 0x04, 0x0e, // 1\n 0x07, 0x08, 0x06, 0x01, 0x0f, // 2\n 0x0f, 0x08, 0x04, 0x09, 0x06, // 3\n 0x0c, 0x0a, 0x09, 0x1f, 0x08, // 4\n 0x1f, 0x01, 0x0f, 0x10, 0x0f, // 5\n 0x08, 0x04, 0x0e, 0x11, 0x0e, // 6\n 0x1f, 0x08, 0x04, 0x02, 0x01, // 7\n 0x0e, 0x11, 0x0e, 0x11, 0x0e, // 8\n 0x0e, 0x11, 0x0e, 0x04, 0x02, // 9\n 0x11, 0x00, 0x0e, 0x1b, 0x11, // :(\n // 0x11, 0x04, 0x04, 0x0a, 0x11, // :(\n};\n\nvoid ST7735::sendBytes(uint8_t *ptr, uint32_t len) {\n uint8_t mask = 0, b;\n for (;;) {\n if (!mask) {\n if (!len--)\n break;\n mask = 0x80;\n b = *ptr++;\n }\n mosi->setDigitalValue((b & mask) ? 1 : 0);\n sck->setDigitalValue(1);\n mask >>= 1;\n sck->setDigitalValue(0);\n }\n}\n\nvoid ST7735::fill(int color, int numpixels) {\n uint8_t cmd[20] = {ST7735_RAMWR};\n sendCmd(cmd, 1);\n\n dc->setDigitalValue(1);\n if (cs)\n cs->setDigitalValue(0);\n\n cmd[0] = color >> 4;\n cmd[1] = (color << 4) | (color >> 8);\n cmd[2] = color;\n\n int n = (numpixels + 1) >> 1;\n while (n--) {\n sendBytes(cmd, 3);\n }\n\n if (cs)\n cs->setDigitalValue(1);\n}\n\nvoid ST7735::sendCmd(uint8_t *buf, int len) {\n // make sure cmd isn't on stack\n dc->setDigitalValue(0);\n if (cs)\n cs->setDigitalValue(0);\n sendBytes(buf, 1);\n dc->setDigitalValue(1);\n len--;\n buf++;\n if (len > 0)\n sendBytes(buf, len);\n if (cs)\n cs->setDigitalValue(1);\n}\n\nstatic void busy_wait_us(int ms) {\n target_wait_us(ms);\n /*\n // this is for 120MHz\n while (ms--) {\n for (int i = 0; i < 30; ++i)\n asm volatile(\"nop\");\n }\n */\n}\n\nvoid ST7735::sendCmdSeq(const uint8_t *buf) {\n uint8_t cmdBuf[32];\n\n while (*buf) {\n cmdBuf[0] = *buf++;\n int v = *buf++;\n int len = v & ~DELAY;\n // note that we have to copy to RAM\n memcpy(cmdBuf + 1, buf, len);\n sendCmd(cmdBuf, len + 1);\n buf += len;\n if (v & DELAY) {\n busy_wait_us(1000 * *buf++);\n }\n }\n}\n\nvoid ST7735::setAddrWindow(int x, int y, int w, int h) {\n w += x - 1;\n h += y - 1;\n uint8_t cmd0[] = {ST7735_RASET, 0, (uint8_t)x, (uint8_t)(w >> 8), (uint8_t)w};\n uint8_t cmd1[] = {ST7735_CASET, 0, (uint8_t)y, (uint8_t)(h >> 8), (uint8_t)h};\n sendCmd(cmd1, sizeof(cmd1));\n sendCmd(cmd0, sizeof(cmd0));\n}\n\nvoid ST7735::init() {\n mosi = LOOKUP_PIN(DISPLAY_MOSI);\n sck = LOOKUP_PIN(DISPLAY_SCK);\n cs = LOOKUP_PIN(DISPLAY_CS);\n dc = LOOKUP_PIN(DISPLAY_DC);\n auto bl = LOOKUP_PIN(DISPLAY_BL);\n auto rst = LOOKUP_PIN(DISPLAY_RST);\n\n if (cs)\n cs->setDigitalValue(1);\n dc->setDigitalValue(1);\n\n if (bl) {\n bl->setDigitalValue(1);\n }\n\n if (rst) {\n rst->setDigitalValue(0);\n busy_wait_us(20 * 1000);\n rst->setDigitalValue(1);\n busy_wait_us(20 * 1000);\n }\n\n uint32_t cfg0 = getConfig(CFG_DISPLAY_CFG0, 0x40);\n uint32_t frmctr1 = getConfig(CFG_DISPLAY_CFG1, 0x000603);\n auto madctl = cfg0 & 0xff;\n\n sendCmdSeq(initCmds);\n configure(madctl, frmctr1);\n\n width = getConfig(CFG_DISPLAY_WIDTH, 160);\n height = getConfig(CFG_DISPLAY_HEIGHT, 128);\n}\n\nvoid ST7735::configure(uint8_t madctl, uint32_t frmctr1) {\n uint8_t cmd0[] = {ST7735_MADCTL, madctl};\n uint8_t cmd1[] = {ST7735_FRMCTR1, (uint8_t)(frmctr1 >> 16), (uint8_t)(frmctr1 >> 8),\n (uint8_t)frmctr1};\n sendCmd(cmd0, sizeof(cmd0));\n sendCmd(cmd1, cmd1[3] == 0xff ? 3 : 4);\n}\n\n#define SIZE 4\n\nvoid ST7735::drawNumber(int idx, int x, int y, int color) {\n const uint8_t *src = &numbers[idx * 5];\n for (int i = 0; i < 5; i++) {\n uint8_t ch = *src++;\n for (int j = 0; j < 5; j++) {\n if (ch & (1 << j)) {\n setAddrWindow(x + j * SIZE, y + i * SIZE, SIZE - 1, SIZE - 1);\n fill(color, (SIZE - 1) * (SIZE - 1));\n }\n }\n }\n}\n\nstatic void drawPanic(int code) {\n if (!LOOKUP_PIN(DISPLAY_MOSI))\n return;\n\n ST7735 display;\n\n display.init();\n display.setAddrWindow(0, 0, display.width, display.height);\n display.fill(0, display.width * display.height);\n\n display.drawNumber(10, 70, 20, 0xf00);\n int x = 50;\n int y = 60;\n display.drawNumber((code / 100) % 10, x, y, 0xff0);\n x += 24;\n display.drawNumber((code / 10) % 10, x, y, 0xff0);\n x += 24;\n display.drawNumber((code / 1) % 10, x, y, 0xff0);\n x += 24;\n}\n\nextern \"C\" void target_panic(int statusCode) {\n __disable_irq(); // low-level disable\n target_disable_irq(); // make sure they stay disabled in DMESG()\n\n DMESG(\"*** CODAL PANIC : [%d]\", statusCode);\n\n __disable_irq(); // disable IRQ after DMESG() again just to make sure\n\n if (panicMode) {\n // avoid recursive panic invocation\n while (1) {\n }\n }\n\n gcFreeze();\n\n // remember first panic code\n panicMode = true;\n\n drawPanic(statusCode);\n\n auto led = LOOKUP_PIN(LED);\n\n const int unit = 100000;\n const int dit = unit;\n const int dat = 3 * unit;\n const int intra = unit;\n const int inter = 2 * unit;\n const int word = 6 * unit;\n while (1) {\n if (led) {\n // SOS\n // . . .\n for (int i = 0; i < 3; ++i) {\n led->setDigitalValue(1);\n busy_wait_us(dit);\n led->setDigitalValue(0);\n busy_wait_us(intra);\n }\n // inter character space\n busy_wait_us(inter);\n // - - -\n for (int i = 0; i < 3; ++i) {\n led->setDigitalValue(1);\n busy_wait_us(dat);\n led->setDigitalValue(0);\n busy_wait_us(intra);\n }\n // inter character space\n busy_wait_us(inter);\n // . . .\n for (int i = 0; i < 3; ++i) {\n led->setDigitalValue(1);\n busy_wait_us(dit);\n led->setDigitalValue(0);\n busy_wait_us(intra);\n }\n // inter character space\n busy_wait_us(word);\n }\n }\n}\n\n} // namespace _pxt_panic",
"pxt.json": "{\n \"name\": \"screen---st7735\",\n \"description\": \"The screen library\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"screen.cpp\",\n \"panic.cpp\",\n \"image.cpp\",\n \"image.ts\",\n \"screenimage.ts\",\n \"text.ts\",\n \"frame.ts\",\n \"shims.d.ts\",\n \"fieldeditors.ts\",\n \"targetoverrides.ts\",\n \"ns.ts\",\n \"image.d.ts\",\n \"pxtparts.json\",\n \"imagesoverrides.jres\",\n \"imagesoverrides.ts\",\n \"font12.jres\",\n \"jdprotocol.h\",\n \"arcadegamepad.h\",\n \"indexedscreen.h\",\n \"arcadesound.h\",\n \"jddisplay.h\",\n \"jddisplay.cpp\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"palette\": [\n \"#000000\",\n \"#ffffff\",\n \"#ff2121\",\n \"#ff93c4\",\n \"#ff8135\",\n \"#fff609\",\n \"#249ca3\",\n \"#78dc52\",\n \"#003fad\",\n \"#87f2ff\",\n \"#8e2ec4\",\n \"#a4839f\",\n \"#5c406c\",\n \"#e5cdc4\",\n \"#91463d\",\n \"#000000\"\n ],\n \"screenSize\": {\n \"width\": 160,\n \"height\": 120\n }\n}\n",
"pxtparts.json": "{\n \"screen\": {\n \"simulationBehavior\": \"screen\",\n \"visual\": {\n \"builtIn\": \"screen\",\n \"width\": 158.43856811523438,\n \"height\": 146.8025665283203,\n \"pinDistance\": 14.91,\n \"pinLocations\": [\n {\n \"x\": 4.227952701380444,\n \"y\": 3.1650031792503945\n },\n {\n \"x\": 18.170226805137037,\n \"y\": 3.1650031792503945\n },\n {\n \"x\": 46.05478386015504,\n \"y\": 3.1650031792503945\n },\n {\n \"x\": 59.99706238766404,\n \"y\": 3.1650031792503945\n },\n {\n \"x\": 73.93934976267785,\n \"y\": 3.1650031792503945\n },\n {\n \"x\": 87.88161944268204,\n \"y\": 3.1650031792503945\n },\n {\n \"x\": 101.82389797019104,\n \"y\": 3.1650031792503945\n },\n {\n \"x\": 32.11250533264604,\n \"y\": 3.1650031792503945\n },\n {\n \"x\": 117.68761950246274,\n \"y\": 3.1650031792503945\n }\n ]\n },\n \"numberOfPins\": 9,\n \"instantiation\": {\n \"kind\": \"singleton\"\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"DISPLAY_DC\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"DISPLAY_CS\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"DISPLAY_MOSI\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"DISPLAY_SCK\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"DISPLAY_MISO\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"DISPLAY_RST\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"assembly\": [\n {\n \"pinIndices\": [\n 0,\n 1,\n 2,\n 3,\n 4,\n 5,\n 6,\n 7,\n 8\n ]\n }\n ]\n }\n}",
"screen.cpp": "#include \"pxt.h\"\n#include \"ST7735.h\"\n#include \"ILI9341.h\"\n\n#include \"SPIScreenIO.h\"\n#ifdef STM32F4\n#include \"FSMCIO.h\"\n#endif\n\n#include \"jddisplay.h\"\n\nnamespace pxt {\n\nclass WDisplay {\n public:\n ScreenIO *io;\n ST7735 *lcd;\n JDDisplay *smart;\n\n uint32_t currPalette[16];\n bool newPalette;\n bool inUpdate;\n\n uint8_t *screenBuf;\n Image_ lastStatus;\n\n uint16_t width, height;\n uint16_t displayHeight;\n uint8_t offX, offY;\n bool doubleSize;\n uint32_t palXOR;\n\n WDisplay() {\n uint32_t cfg2 = getConfig(CFG_DISPLAY_CFG2, 0x0);\n int conn = cfg2 >> 24;\n\n uint32_t cfg0 = getConfig(CFG_DISPLAY_CFG0, 0x40);\n uint32_t frmctr1 = getConfig(CFG_DISPLAY_CFG1, 0x000603);\n\n int dispTp = getConfig(CFG_DISPLAY_TYPE, DISPLAY_TYPE_ST7735);\n\n doubleSize = false;\n smart = NULL;\n\n auto miso = LOOKUP_PIN(DISPLAY_MISO);\n\n if (dispTp == DISPLAY_TYPE_SMART) {\n dispTp = smartConfigure(&cfg0, &frmctr1, &cfg2);\n }\n\n if (dispTp != DISPLAY_TYPE_SMART)\n miso = NULL; // only JDDisplay needs MISO, otherwise leave free\n\n SPI *spi = NULL;\n if (conn == 0) {\n spi = new CODAL_SPI(*LOOKUP_PIN(DISPLAY_MOSI), *miso, *LOOKUP_PIN(DISPLAY_SCK));\n io = new SPIScreenIO(*spi);\n } else if (conn == 1) {\n#ifdef CODAL_CREATE_PARALLEL_SCREEN_IO\n io = CODAL_CREATE_PARALLEL_SCREEN_IO(cfg2 & 0xffffff, PIN(DISPLAY_MOSI),\n PIN(DISPLAY_MISO));\n#else\n target_panic(PANIC_SCREEN_ERROR);\n#endif\n } else {\n target_panic(PANIC_SCREEN_ERROR);\n }\n\n if (dispTp == DISPLAY_TYPE_ST7735)\n lcd = new ST7735(*io, *LOOKUP_PIN(DISPLAY_CS), *LOOKUP_PIN(DISPLAY_DC));\n else if (dispTp == DISPLAY_TYPE_ILI9341) {\n lcd = new ILI9341(*io, *LOOKUP_PIN(DISPLAY_CS), *LOOKUP_PIN(DISPLAY_DC));\n doubleSize = true;\n } else if (dispTp == DISPLAY_TYPE_SMART) {\n lcd = NULL;\n smart = new JDDisplay(spi, LOOKUP_PIN(DISPLAY_CS), LOOKUP_PIN(DISPLAY_DC));\n } else\n target_panic(PANIC_SCREEN_ERROR);\n\n palXOR = (cfg0 & 0x1000000) ? 0xffffff : 0x000000;\n auto madctl = cfg0 & 0xff;\n offX = (cfg0 >> 8) & 0xff;\n offY = (cfg0 >> 16) & 0xff;\n\n DMESG(\"configure screen: FRMCTR1=%p MADCTL=%p type=%d\", frmctr1, madctl, dispTp);\n\n if (spi) {\n auto freq = (cfg2 & 0xff);\n if (!freq)\n freq = 15;\n spi->setFrequency(freq * 1000000);\n spi->setMode(0);\n auto cs = LOOKUP_PIN(DISPLAY_CS);\n if (cs)\n cs->setDigitalValue(1);\n\n // make sure the SPI peripheral is initialized before toggling reset\n spi->write(0);\n }\n\n auto rst = LOOKUP_PIN(DISPLAY_RST);\n if (rst) {\n rst->setDigitalValue(0);\n fiber_sleep(20);\n rst->setDigitalValue(1);\n fiber_sleep(20);\n }\n\n if (lcd) {\n auto bl = LOOKUP_PIN(DISPLAY_BL);\n if (bl) {\n bl->setDigitalValue(1);\n }\n\n lcd->init();\n lcd->configure(madctl, frmctr1);\n }\n\n width = getConfig(CFG_DISPLAY_WIDTH, 160);\n height = getConfig(CFG_DISPLAY_HEIGHT, 128);\n displayHeight = height;\n setAddrMain();\n DMESG(\"screen: %d x %d, off=%d,%d\", width, height, offX, offY);\n int sz = doubleSize ? (width >> 1) * (height >> 1) : width * height;\n screenBuf = (uint8_t *)app_alloc(sz / 2 + 20);\n\n lastStatus = NULL;\n registerGC((TValue *)&lastStatus);\n inUpdate = false;\n }\n\n uint32_t smartConfigure(uint32_t *cfg0, uint32_t *cfg1, uint32_t *cfg2) {\n uint32_t hc;\n\n DMESG(\"74HC: waiting...\");\n\n // wait while nothing is connected\n for (;;) {\n auto rst = LOOKUP_PIN(DISPLAY_RST);\n if (rst) {\n rst->setDigitalValue(0);\n target_wait_us(10);\n rst->setDigitalValue(1);\n fiber_sleep(3); // in reality we need around 1.2ms\n }\n\n hc = readButtonMultiplexer(17);\n if (hc != 0)\n break;\n\n fiber_sleep(100);\n }\n\n DMESG(\"74HC: %x\", hc);\n\n // is the line forced up? if so, assume JDDisplay\n if (hc == 0x1FFFF) {\n disableButtonMultiplexer();\n return DISPLAY_TYPE_SMART;\n }\n\n hc = hc >> 1;\n\n // SER pin (or first bit of second HC) is orientation\n if (hc & 0x0010)\n *cfg0 = 0x80;\n else\n *cfg0 = 0x40;\n\n uint32_t configId = (hc & 0xe0) >> 5;\n\n switch (configId) {\n case 1:\n *cfg1 = 0x0603; // ST7735\n break;\n case 2:\n *cfg1 = 0xe14ff; // ILI9163C\n *cfg0 |= 0x08; // BGR colors\n break;\n case 3:\n *cfg1 = 0x0603; // ST7735\n *cfg0 |= 0x1000000; // inverted colors\n break;\n default:\n target_panic(PANIC_SCREEN_ERROR);\n break;\n }\n\n DMESG(\"config type: %d; cfg0=%x cfg1=%x\", configId, *cfg0, *cfg1);\n\n *cfg2 = 32; // Damn the torpedoes! 32MHz\n\n return DISPLAY_TYPE_ST7735;\n }\n\n void setAddrStatus() {\n if (lcd)\n lcd->setAddrWindow(offX, offY + displayHeight, width, height - displayHeight);\n else\n smart->setAddrWindow(offX, offY + displayHeight, width, height - displayHeight);\n }\n void setAddrMain() {\n if (lcd)\n lcd->setAddrWindow(offX, offY, width, displayHeight);\n else\n smart->setAddrWindow(offX, offY, width, displayHeight);\n }\n void waitForSendDone() {\n if (lcd)\n lcd->waitForSendDone();\n else\n smart->waitForSendDone();\n }\n int sendIndexedImage(const uint8_t *src, unsigned width, unsigned height, uint32_t *palette) {\n if (lcd)\n return lcd->sendIndexedImage(src, width, height, palette);\n else\n return smart->sendIndexedImage(src, width, height, palette);\n }\n};\n\nSINGLETON_IF_PIN(WDisplay, DISPLAY_MOSI);\n\n//%\nint setScreenBrightnessSupported() {\n auto display = getWDisplay();\n if (display && display->smart)\n return 1;\n\n auto bl = LOOKUP_PIN(DISPLAY_BL);\n if (!bl)\n return 0;\n#ifdef SAMD51\n if (bl->name == PA06)\n return 0;\n#endif\n#ifdef NRF52_SERIES\n // PWM not implemented yet\n return 0;\n#else\n return 1;\n#endif\n}\n\n//%\nvoid setScreenBrightness(int level) {\n if (level < 0)\n level = 0;\n if (level > 100)\n level = 100;\n\n auto display = getWDisplay();\n if (display && display->smart) {\n display->smart->brightness = level;\n return;\n }\n\n auto bl = LOOKUP_PIN(DISPLAY_BL);\n if (!bl)\n return;\n\n if (level == 0)\n bl->setDigitalValue(0);\n else if (level == 100)\n bl->setDigitalValue(1);\n else {\n if (setScreenBrightnessSupported()) {\n bl->setAnalogPeriodUs(1000);\n bl->setAnalogValue(level * level * 1023 / 10000);\n }\n }\n}\n\n//%\nvoid setPalette(Buffer buf) {\n auto display = getWDisplay();\n if (!display)\n return;\n\n if (48 != buf->length)\n target_panic(PANIC_SCREEN_ERROR);\n for (int i = 0; i < 16; ++i) {\n display->currPalette[i] =\n (buf->data[i * 3] << 16) | (buf->data[i * 3 + 1] << 8) | (buf->data[i * 3 + 2] << 0);\n display->currPalette[i] ^= display->palXOR;\n }\n display->newPalette = true;\n}\n\n//%\nvoid setupScreenStatusBar(int barHeight) {\n auto display = getWDisplay();\n if (!display)\n return;\n if (!display->doubleSize) {\n display->displayHeight = display->height - barHeight;\n display->setAddrMain();\n }\n}\n\n//%\nvoid updateScreenStatusBar(Image_ img) {\n auto display = getWDisplay();\n if (!display)\n return;\n\n if (!img)\n return;\n display->lastStatus = img;\n}\n\n//%\nvoid updateScreen(Image_ img) {\n auto display = getWDisplay();\n if (!display)\n return;\n\n if (display->inUpdate)\n return;\n\n display->inUpdate = true;\n\n auto mult = display->doubleSize ? 2 : 1;\n\n if (img) {\n if (img->bpp() != 4 || img->width() * mult != display->width ||\n img->height() * mult != display->displayHeight)\n target_panic(PANIC_SCREEN_ERROR);\n\n // DMESG(\"wait for done\");\n display->waitForSendDone();\n\n auto palette = display->currPalette;\n\n if (display->newPalette) {\n display->newPalette = false;\n } else {\n // smart mode always sends palette\n if (!display->smart)\n palette = NULL;\n }\n\n memcpy(display->screenBuf, img->pix(), img->pixLength());\n\n // DMESG(\"send\");\n display->sendIndexedImage(display->screenBuf, img->width(), img->height(), palette);\n }\n\n if (display->lastStatus && !display->doubleSize) {\n display->waitForSendDone();\n img = display->lastStatus;\n auto barHeight = display->height - display->displayHeight;\n if (img->bpp() != 4 || barHeight != img->height() || img->width() != display->width)\n target_panic(PANIC_SCREEN_ERROR);\n memcpy(display->screenBuf, img->pix(), img->pixLength());\n display->setAddrStatus();\n display->sendIndexedImage(display->screenBuf, img->width(), img->height(), NULL);\n display->waitForSendDone();\n display->setAddrMain();\n display->lastStatus = NULL;\n }\n\n display->inUpdate = false;\n}\n\n//%\nvoid updateStats(String msg) {\n // ignore...\n}\n\n} // namespace pxt",
"screenimage.ts": "\nnamespace image {\n /**\n * Get the screen image\n */\n //% blockNamespace=\"images\" group=\"Create\"\n //% blockId=imagescreen block=\"screen\"\n //% help=images/screen-image\n export function screenImage(): Image {\n return screen;\n }\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\n\n\ndeclare interface Image {\n /**\n * Get the width of the image\n */\n //% property shim=ImageMethods::width\n width: int32;\n\n /**\n * Get the height of the image\n */\n //% property shim=ImageMethods::height\n height: int32;\n\n /**\n * True if the image is monochromatic (black and white)\n */\n //% property shim=ImageMethods::isMono\n isMono: boolean;\n\n /**\n * Sets all pixels in the current image from the other image, which has to be of the same size and\n * bpp.\n */\n //% shim=ImageMethods::copyFrom\n copyFrom(from: Image): void;\n\n /**\n * Set pixel color\n */\n //% shim=ImageMethods::setPixel\n setPixel(x: int32, y: int32, c: int32): void;\n\n /**\n * Get a pixel color\n */\n //% shim=ImageMethods::getPixel\n getPixel(x: int32, y: int32): int32;\n\n /**\n * Fill entire image with a given color\n */\n //% shim=ImageMethods::fill\n fill(c: int32): void;\n\n /**\n * Copy row(s) of pixel from image to buffer (8 bit per pixel).\n */\n //% shim=ImageMethods::getRows\n getRows(x: int32, dst: Buffer): void;\n\n /**\n * Copy row(s) of pixel from buffer to image.\n */\n //% shim=ImageMethods::setRows\n setRows(x: int32, src: Buffer): void;\n\n /**\n * Return a copy of the current image\n */\n //% shim=ImageMethods::clone\n clone(): Image;\n\n /**\n * Flips (mirrors) pixels horizontally in the current image\n */\n //% shim=ImageMethods::flipX\n flipX(): void;\n\n /**\n * Flips (mirrors) pixels vertically in the current image\n */\n //% shim=ImageMethods::flipY\n flipY(): void;\n\n /**\n * Returns a transposed image (with X/Y swapped)\n */\n //% shim=ImageMethods::transposed\n transposed(): Image;\n\n /**\n * Every pixel in image is moved by (dx,dy)\n */\n //% shim=ImageMethods::scroll\n scroll(dx: int32, dy: int32): void;\n\n /**\n * Stretches the image horizontally by 100%\n */\n //% shim=ImageMethods::doubledX\n doubledX(): Image;\n\n /**\n * Stretches the image vertically by 100%\n */\n //% shim=ImageMethods::doubledY\n doubledY(): Image;\n\n /**\n * Replaces one color in an image with another\n */\n //% shim=ImageMethods::replace\n replace(from: int32, to: int32): void;\n\n /**\n * Stretches the image in both directions by 100%\n */\n //% shim=ImageMethods::doubled\n doubled(): Image;\n\n /**\n * Draw given image on the current image\n */\n //% shim=ImageMethods::drawImage\n drawImage(from: Image, x: int32, y: int32): void;\n\n /**\n * Draw given image with transparent background on the current image\n */\n //% shim=ImageMethods::drawTransparentImage\n drawTransparentImage(from: Image, x: int32, y: int32): void;\n\n /**\n * Check if the current image \"collides\" with another\n */\n //% shim=ImageMethods::overlapsWith\n overlapsWith(other: Image, x: int32, y: int32): boolean;\n}\ndeclare namespace image {\n\n /**\n * Create new empty (transparent) image\n */\n //% shim=image::create\n function create(width: int32, height: int32): Image;\n\n /**\n * Create new image with given content\n */\n //% shim=image::ofBuffer\n function ofBuffer(buf: Buffer): Image;\n\n /**\n * Double the size of an icon\n */\n //% shim=image::doubledIcon\n function doubledIcon(icon: Buffer): Buffer;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"targetoverrides.ts": "/**\n * Tagged image literal converter\n */\n//% shim=@f4 helper=image::ofBuffer blockIdentity=\"sprites._createImageShim\"\n//% groups=[\"0.\",\"1#\",\"2T\",\"3t\",\"4N\",\"5n\",\"6G\",\"7g\",\"8\",\"9\",\"aAR\",\"bBP\",\"cCp\",\"dDO\",\"eEY\",\"fFW\"]\nfunction img(lits: any, ...args: any[]): Image { return null }\n\n// set palette before creating screen, so the JS version has the right BPP\nimage.setPalette(hex`__palette`)\n//% whenUsed\nconst screen = _screen_internal.createScreen();\n\nnamespace image {\n //% shim=pxt::setPalette\n export function setPalette(buf: Buffer) { }\n}\n\nnamespace _screen_internal {\n //% shim=pxt::updateScreen\n function updateScreen(img: Image): void { }\n //% shim=pxt::updateStats\n function updateStats(msg: string): void { }\n\n //% parts=\"screen\"\n export function createScreen() {\n const img = image.create(\n control.getConfigValue(DAL.CFG_DISPLAY_WIDTH, 160),\n control.getConfigValue(DAL.CFG_DISPLAY_HEIGHT, 128))\n\n control.__screen.setupUpdate(() => updateScreen(img))\n control.EventContext.onStats = function (msg: string) {\n updateStats(msg);\n }\n\n return img as ScreenImage;\n }\n}\n",
"text.ts": "namespace image {\n\n export interface Font {\n charWidth: number;\n charHeight: number;\n data: Buffer;\n multiplier?: number;\n }\n\n //% whenUsed\n export const font8: Font = {\n charWidth: 6,\n charHeight: 8,\n data: hex`\n2000000000000000 210000005e000000 2200000e000e0000 230028fe28fe2800 24004c92ff926400 250002651248a640\n26006c92926ca000 270000000e000000 280000007c820000 29000000827c0000 2a00543810385400 2b0010107c101000\n2c00000090700000 2d00101010101000 2e00000060600000 2f00006010080600 3000003c42423c00 310000447e400000\n3200004462524c00 330000424a4e3200 34003028247e2000 3500004e4a4a3200 3600003c4a4a3000 3700000262120e00\n380000344a4a3400 3900000c52523c00 3a0000006c6c0000 3b00000096760000 3c00102828444400 3d00282828282800\n3e00444428281000 3f00000259090600 40003c425a560800 4100781412147800 42007e4a4a4a3400 4300003c42422400\n4400007e42423c00 4500007e4a4a4200 4600007e0a0a0200 4700003c42523400 4800007e08087e00 490000427e420000\n4a002040423e0200 4b00007e08146200 4c00007e40404000 4d007e0418047e00 4e00007e04087e00 4f003c4242423c00\n5000007e12120c00 5100003c5262bc00 5200007e12126c00 530000244a522400 540002027e020200 5500003e40403e00\n5600001e70701e00 57007e2018207e00 5800422418244200 5900060870080600 5a000062524a4600 5b00007e42420000\n5c00000608106000 5d000042427e0000 5e00080402040800 5f00808080808000 6000000002040000 6100003048487800\n6200007e48483000 6300003048484800 6400003048487e00 6500003068585000 660000107c120400 67000018a4a47800\n6800007e08087000 690000487a400000 6a000040847d0000 6b00007e10284000 6c0000427e400000 6d00780830087000\n6e00007808087000 6f00003048483000 700000fc24241800 710000182424fc00 7200007810081000 7300005058682800\n740000083e482000 7500003840407800 7600001860601800 7700384030403800 7800004830304800 7900005ca0a07c00\n7a00004868584800 7b00000836410000 7c000000fe000000 7d00004136080000 7e00000804080400 a000000000000000\na10000007a000000 a200003048fc4800 a30090fc92928400 a400542844285400 a5002a2c782c2a00 a6000000ee000000\na7000094aaaa5200 a800000200020000 a9003e414955413e aa0000242a2e0000 ab00102854284400 ac00001010107000\nad00001010101000 ae003e415d45413e af00000202020200 b000000814140800 b1008888be888800 b2000024322c0000\nb30000222a140000 b400000004020000 b50000f840207800 b6000c1e7e027e00 b700000010000000 b800000080400000\nb90000243e200000 ba0000242a240000 bb00442854281000 bc00025f70f84000 bd00021f90c8b000 be0011557af84000\nbf000030484d2000 c000601916186000 c100601816196000 c200601a151a6000 c300601a151a6100 c400601914196000\nc500601a151a6000 c6007c0a7e4a4200 c700001ea1611200 c800007c55564400 c900007c56554400 ca00007c56554600\ncb00007c55544500 cc0000457e440000 cd0000447e450000 ce0000467d460000 cf0000457c450000 d000087e4a423c00\nd100007e09127d00 d200003845463800 d300003846453800 d400003846453a00 d500003a45463900 d600003845443900\nd700442810284400 d80000fc724e3f00 d900003c41423c00 da00003c42413c00 db00003c42413e00 dc00003c41403d00\ndd00040872090400 de00007e24241800 df00007c025a2400 e0000030494a7800 e10000304a497800 e20000304a497a00\ne3000032494a7900 e40000304a487a00 e50000304a4d7a00 e600304878685000 e7000018a4642400 e8000030695a5000\ne90000306a595000 ea0000306a595200 eb0000306a585200 ec0000497a400000 ed0000487a410000 ee00004a79420000\nef00004a78420000 f00000304a4b3d00 f100007a090a7100 f2000030494a3000 f30000304a493000 f40000304a493200\nf5000032494a3100 f60000304a483200 f700101054101000 f800007068583800 f900003841427800 fa00003842417800\nfb00003842417a00 fc00003842407a00 fd0000b84241f800 fe0000ff24241800 ff00005ca1a07d00 0001601915196000\n010100304a4a7a00 0201611a16196000 030100314a4a7900 04013c0a094abc00 050100182464bc00 0601003846452800\n070100304a494800 0801003846452a00 090100304a494a00 0a01003844452800 0b010030484a4800 0c01003845462900\n0d010030494a4900 0e01007c45463900 0f0100314a497e00 1001087e4a423c00 110130484c7e0400 1201007d55554500\n130100326a5a5200 1401007d56564500 150100316a5a5100 1601007c55544400 170100306a585000 1801003f65a52100\n1901001874ac2800 1a01007c55564500 1b010030695a5100 1c01003846553600 1d0100304a49f200 1e01003946563500\n1f0100314a4af100 2001003844553400 21010018a4a57800 2201001ea1691a00 23010018a6a57800 2401007812117a00\n25017e080a710200 2601047e147e0400 2701047e0c087000 28010002457e4500 29010002497a4100 2a0100457d450000\n2b01004a7a420000 2c0100014a7a4900 2d0100014a7a4100 2e0100217fa10000 2f0100247da00000 300100447d440000\n3101004878400000 32017e0022423e00 33013d0040847d00 34012040463d0600 350100800af90200 360100bf440a3100\n370100bf48142000 3801007810284800 3901007c40424100 3a0100467d400000 3b01003fa0602000 3c0100a17f200000\n3d01007c41424100 3e0100457e410000 3f01007e40484000 400100427e400800 4101107e48404000 420100527e480000\n4301007c0a117c00 440100780a097000 450100bf42043f00 460100bc44043800 4701007c09127d00 480100790a097000\n49010a0678087000 4a01003f02847f00 4b01003c04847800 4c01394545453900 4d0100324a4a3200 4e01394646463900\n4f0100314a4a3100 50013a4544463900 5101324948320100 52013c427e4a4200 5301304830685000 5401007c16354800\n5501007812091000 560100bf49093600 570100bc48040800 5801007d16354800 5901007912091000 5a01004856552400\n5b0100505a692800 5c01004856552600 5d0100505a692a00 5e010012a5691200 5f010028ac741400 6001004855562500\n61010050596a2900 62010101bf410100 630100049f641000 640104057e050400 650100083d4a2100 660102127e120200\n670100183e582000 6801003a41423900 6901003a41427900 6a01003d41413d00 6b01003a42427a00 6c01003942423900\n6d01003942427900 6e01003a45453a00 6f01003a45457a00 70013a41403a0100 71013a41407a0100 7201001f60a01f00\n7301001c60a03c00 7401782211227800 7501384231423800 7601081261120800 770100b84241fa00 7801040970090400\n79010064564d4400 7a0100486a594800 7b010064544d4400 7c010048685a4800 7d010064554e4500 7e010048695a4900\n7f0100087c020400 8f01003452523c00 920100887e090200 a0013c42423c0806 a101003048483008 af01003e403e0806\nb001003840781008 b501006a5a4a4e00 b601005878585800 d101003845463900 d2010030494a3100 e601003845563500\ne7010030494af100 fa0100742a750000 fb0100304c4a7d00 fc0178147e554400 fd0130487a695000 fe010078744e3d00\nff0100706a593800 18020012a5691200 19020028ac741400 1a020101bf410100 1b0200049f641000 bb0200000c0a0000\nbc0200000a060000 bd020000060a0000 c602000201020000 c702000102010000 c902000202020000 d802000102020100\nd902000002000000 da02000205020000 db02000040800000 dc02000201020100 dd02020100020100 7403000002010000\n7503000080400000 7a030000c0800000 7e03000096760000 8403000003000000 8503020003000200 8603037c12127c00\n8703000010000000 880303007e4a4200 890303007e087e00 8a030300427e4200 8c03033c42423c00 8e0303000e700e00\n8f03035c62625c00 900302003b400200 9103781412147800 92037e4a4a4a3400 9303007e02020200 9403605846586000\n9503007e4a4a4200 96030062524a4600 9703007e08087e00 98033c4a4a4a3c00 990300427e420000 9a03007e08146200\n9b03601806186000 9c037e0418047e00 9d03007e04087e00 9e0300424a4a4200 9f033c4242423c00 a003007e02027e00\na103007e12120c00 a30300665a424200 a40302027e020200 a503060870080600 a60318247e241800 a703422418244200\na8030e107e100e00 a9035c6202625c00 aa0300457c450000 ab03040970090400 ac030030484a7900 ad030030685a5100\nae0378100a09f000 af03003a41200000 b0033a4043403a00 b103003048487800 b20300fe25251a00 b3030c30c0300c00\nb403344a4a4a3000 b503003068585000 b603021aa6a24200 b7033c080404f800 b803003c4a4a3c00 b903003840200000\nba03007820504800 bb03641212227c00 bc03fc2020103c00 bd03182040201800 be03112d2ba94100 bf03003048483000\nc003087808780800 c103f82424241800 c2031824a4a44800 c303304848582800 c403000838482800 c503384040403800\nc6031c20f8241800 c703c4281028c400 c8031c20fc201c00 c903304820483000 ca03000238422000 cb03384240423800\ncc0330484a493000 cd03384042413800 ce03304822493000 d0033c52525c2000 d10310344a3c0800 d203067804020400\nd303120a7c020400 d4030d7009040800 d5031824ff241800 d603384828483800 d70348302221d800 da031c2221a14200\ndb031824a4a44200 dc037e1212020200 dd0300fc24240400 de033e2010087c00 df030c0ac9281800 e003700c621c7000\ne10301092516f800 e2039ea0bea07e00 e30398a0b8a07800 e4030c1214107e00 e503001028207800 e603be9088887000\ne70348544e443800 e803245252524c00 e903285454544800 ea0364524c526400 eb03086458640800 ec03385454542200\ned03306848682400 ee03184a7e4a1800 ef031848ff0a0800 f003483020205800 f10378a4a4a49800 f203304848485000\nf303006080847d00 f4033c4a4a4a3c00 f503003058584800 0004007c55564400 0104007c55544500 020401013f857900\n0304007c06050400 04043c4a4a422400 050400244a522400 060400427e420000 070400457c450000 08042040423e0200\n09047c027e483000 0a047e087e483000 0b0402027e0a7200 0c04007c102a4500 0d047c2112087c00 0e040c5152523d00\n0f043f20e0203f00 1004781412147800 11047e4a4a4a3000 12047e4a4a4a3400 1304007e02020200 1404c07c427ec000\n1504007e4a4a4200 160476087e087600 170424424a4a3400 1804007e08047e00 1904007d120a7d00 1a04007e08146200\n1b04403c02027e00 1c047e0418047e00 1d04007e08087e00 1e043c4242423c00 1f047e0202027e00 2004007e12120c00\n2104003c42422400 220402027e020200 23040e5050503e00 240418247e241800 2504422418244200 26043f2020bf6000\n27040e1010107e00 28047e407e407e00 29043f203fa07f00 2a04027e48483000 2b047e4848307e00 2c04007e48483000\n2d0424424a4a3c00 2e047e183c423c00 2f04006c12127e00 3004304848784000 3104003c4a4a3100 3204007868502000\n3304007808080800 3404c0704878c000 3504306868500000 3604483078304800 3704004058683000 3804784020107800\n3904794222127900 3a04007820304800 3b04403008087800 3c04781020107800 3d04781010107800 3e04304848483000\n3f04780808087800 4004fc2424241800 4104304848485000 4204080878080800 43041ca0a0a07c00 44041824ff241800\n4504004830304800 46043c2020bc6000 4704182020207800 4804784078407800 49043c203ca07c00 4a04087850502000\n4b04785050207800 4c04007850502000 4d04485868300000 4e04783030483000 4f04502828780000 50040030696a5000\n51040032686a5000 5204023f0a887000 530400780a090800 5404003068584800 5504005058682800 560400487a400000\n5704004a78420000 5804004080847d00 5904700878502000 5a04781078502000 5b04047e14106000 5c04007822314800\n5d04784122107800 5e0418a1a2a27900 5f043c20e0203c00 6204027f4a483000 6304087e58502000 70040e107e100e00\n7104182078201800 72043c4a4a4a3c00 7304306858683000 7404001e70180c00 7504001860301000 9004007e02020300\n9104007808080c00 9204087e0a0a0200 9304207828080800 96043b043f043be0 970424183c1824c0 9a04003f040a31c0\n9b04003c101824c0 ae04060870080600 af040c10e0100c00 b004161870181600 b1042c30e0302c00 b20421120c1221c0\nb3040024181824c0 ba047e0808087000 bb04007e08087000 d804003452523c00 d904002868583000 e20400457d450000\ne304004a7a420000 e8043c4a4a4a3c00 e904003058583000 ee04003d41413d00 ef04003a42427a00 d005681020285000\nd105484848784000 d205004830600000 d305080808780800 d405680808087800 d505000008780000 d605080818680800\nd705087808087800 d805784050487800 d905000008180000 da0504040404fc00 db05484848483800 dc050e4848281800\ndd05087848487800 de05582010487000 df05000004fc0000 e005004040487800 e105000878483800 e205487840281800\ne305041c0404fc00 e405485848483800 e50504f820140800 e605485060685000 e705f40424241c00 e805080808087000\ne905785058403800 ea05487808087800 f005087800087800 f105081800087800 f205081800081800 f305000010080000\nf405100800100800 021e7c5455542800 031e007e48493000 0a1e007c45443800 0b1e003049487e00 1e1e007c15140400\n1f1e001079140800 401e7e0419047e00 411e780832087000 561e007c15140800 571e00fc25241800 601e004854552400\n611e0050586a2800 6a1e04047d040400 6b1e00083d482000 801e7c2112207c00 811e384132403800 821e7c2012217c00\n831e384032413800 841e7c2110217c00 851e384230423800 f21e040972080400 f31e00b84142f800 a3207e0a7a120a00\na420a8fcaa828400 a720087e2a1c0800 ab200098a4a6bf02 ac20183c5a5a4200 af20627f22443800 9021103854101000\n912108047e040800 9221101054381000 932110207e201000 9421103810103810 95212844fe442800 \n`,\n\n }\n\n // A unicode 12x12 pixel font based on https://github.com/adobe-fonts/source-han-sans\n //% whenUsed jres\n export const font12: Font = {\n charWidth: 12,\n charHeight: 12,\n data: hex``\n }\n\n export function getFontForText(text: string) {\n for (let i = 0; i < text.length; ++i) {\n // this is quite approximate\n if (text.charCodeAt(i) > 0x2000)\n return image.font12\n }\n return image.font8\n }\n\n //% deprecated=1 hidden=1\n export function doubledFont(f: Font): Font {\n return scaledFont(f, 2)\n }\n\n export function scaledFont(f: Font, size: number): Font {\n size |= 0\n if (size < 2)\n return f\n return {\n charWidth: f.charWidth * size,\n charHeight: f.charHeight * size,\n data: f.data,\n multiplier: f.multiplier ? size * f.multiplier : size\n }\n }\n\n //% whenUsed\n export const font5: Font = {\n charWidth: 6,\n charHeight: 5,\n // source https://github.com/lancaster-university/microbit-dal/blob/master/source/core/MicroBitFont.cpp\n data: hex`\n2000000000000000 2100001700000000 2200000300030000 23000a1f0a1f0a00 24000a17151d0a00 2500130904121900\n26000a15150a1000 2700000300000000 2800000e11000000 290000110e000000 2a00000a040a0000 2b0000040e040000\n2c00001008000000 2d00000404040000 2e00000800000000 2f00100804020100 30000e11110e0000 310000121f100000\n3200191515120000 33000911150b0000 34000c0a091f0800 3500171515150900 3600081416150800 3700110905030100\n38000a1515150a00 390002150d050200 3a00000a00000000 3b0000100a000000 3c0000040a110000 3d00000a0a0a0000\n3e0000110a040000 3f00020115050200 40000e1115090e00 41001e05051e0000 42001f15150a0000 43000e1111110000\n44001f11110e0000 45001f1515110000 46001f0505010000 47000e1111150c00 48001f04041f0000 4900111f11000000\n4a000911110f0100 4b001f040a110000 4c001f1010100000 4d001f0204021f00 4e001f0204081f00 4f000e11110e0000\n50001f0505020000 5100060919160000 52001f05050a1000 5300121515090000 540001011f010100 55000f10100f0000\n5600070810080700 57001f0804081f00 58001b04041b0000 590001021c020100 5a00191513110000 5b00001f11110000\n5c00010204081000 5d000011111f0000 5e00000201020000 5f00101010101000 6000000102000000 61000c12121e1000\n62001f1414080000 63000c1212120000 64000814141f0000 65000e1515120000 6600041e05010000 67000215150f0000\n68001f0404180000 6900001d00000000 6a000010100d0000 6b001f040a100000 6c00000f10100000 6d001e0204021e00\n6e001e02021c0000 6f000c12120c0000 70001e0a0a040000 7100040a0a1e0000 72001c0202020000 730010140a020000\n7400000f14141000 75000e10101e1000 7600060810080600 77001e1008101e00 7800120c0c120000 7900121408040200\n7a00121a16120000 7b0000041f110000 7c00001f00000000 7d00111f04000000 7e00000404080800 d3000c1213130c00\nf3000c12130d0000 04010e05051e1000 05010609191f0800 06010c1213131200 07010c1213130000 18010f0b1b190000\n19010e151d1a0000 41011f1412100000 4201100f14120000 43011f0205081f00 44011e03031c0000 5a0110140b030200\n5b0110140b030000 7901121a17130000 7a01121a17130000 7b01121b17120000 7c01121b17120000`,\n }\n}\n\nnamespace texteffects {\n export interface TextEffectState {\n xOffset: number;\n yOffset: number;\n }\n}\n\ninterface Image {\n //% helper=imagePrint\n print(text: string, x: number, y: number, color?: number, font?: image.Font, offsets?: texteffects.TextEffectState[]): void;\n\n //% helper=imagePrintCenter\n printCenter(text: string, y: number, color?: number, font?: image.Font): void;\n}\n\nnamespace helpers {\n export function imagePrintCenter(img: Image, text: string, y: number, color?: number, font?: image.Font) {\n if (!font) font = image.getFontForText(text)\n let w = text.length * font.charWidth\n let x = (img.width - w) / 2\n imagePrint(img, text, x, y, color, font)\n }\n\n export function imagePrint(img: Image, text: string, x: number, y: number, color?: number, font?: image.Font, offsets?: texteffects.TextEffectState[]) {\n x |= 0\n y |= 0\n if (!font)\n font = image.getFontForText(text)\n if (!color) color = 1\n let x0 = x\n let cp = 0\n let mult = font.multiplier ? font.multiplier : 1\n let dataW = Math.idiv(font.charWidth, mult)\n let dataH = Math.idiv(font.charHeight, mult)\n let byteHeight = (dataH + 7) >> 3\n let charSize = byteHeight * dataW\n let dataSize = 2 + charSize\n let fontdata = font.data\n let lastchar = Math.idiv(fontdata.length, dataSize) - 1\n let imgBuf: Buffer\n if (mult == 1) {\n imgBuf = control.createBuffer(8 + charSize)\n imgBuf[0] = 0x87\n imgBuf[1] = 1\n imgBuf[2] = dataW\n imgBuf[4] = dataH\n }\n while (cp < text.length) {\n let xOffset = 0, yOffset = 0;\n if (offsets && cp < offsets.length) {\n xOffset = offsets[cp].xOffset\n yOffset = offsets[cp].yOffset\n }\n\n let ch = text.charCodeAt(cp++)\n if (ch == 10) {\n y += font.charHeight + 2\n x = x0\n }\n\n if (ch < 32)\n continue // skip control chars\n\n let l = 0\n let r = lastchar\n let off = 0 // this should be a space (0x0020)\n let guess = (ch - 32) * dataSize\n if (fontdata.getNumber(NumberFormat.UInt16LE, guess) == ch)\n off = guess\n else {\n while (l <= r) {\n let m = l + ((r - l) >> 1);\n let v = fontdata.getNumber(NumberFormat.UInt16LE, m * dataSize)\n if (v == ch) {\n off = m * dataSize\n break\n }\n if (v < ch)\n l = m + 1\n else\n r = m - 1\n }\n }\n\n if (mult == 1) {\n imgBuf.write(8, fontdata.slice(off + 2, charSize))\n img.drawIcon(imgBuf, x + xOffset, y + yOffset, color)\n x += font.charWidth\n } else {\n off += 2\n for (let i = 0; i < dataW; ++i) {\n let j = 0\n let mask = 0x01\n let c = fontdata[off++]\n while (j < dataH) {\n if (mask == 0x100) {\n c = fontdata[off++]\n mask = 0x01\n }\n let n = 0\n while (c & mask) {\n n++\n mask <<= 1\n }\n if (n) {\n img.fillRect(x + xOffset * mult, y + (j + yOffset) * mult, mult, mult * n, color)\n j += n\n } else {\n mask <<= 1\n j++\n }\n }\n x += mult\n }\n }\n }\n }\n}\n"
},
"pulse": {
"README.md": "# pulse\n\nThe Pulse library.\n\n",
"bitvector.h": "#ifndef CABLE_BITVECTOR_H\n#define CABLE_BITVECTOR_H\n\nclass BitVector {\n LLSegment data;\n int len;\n\n uint32_t get32(int idx) { return (uint32_t)data.get(idx >> 5); }\n\n public:\n BitVector() { len = 0; }\n ~BitVector() { data.destroy(); }\n\n int size() { return len; }\n\n void print() {\n char buf[size() + 1];\n for (int i = 0; i < size(); ++i)\n buf[i] = get(i) ? '#' : '.';\n buf[size()] = 0;\n DMESG(\"bits: %s\", buf);\n }\n\n int get(int pos) {\n if (pos < 0 || pos >= len)\n return 0;\n return !!(get32(pos) & (1 << (pos & 31)));\n }\n uint32_t getBits(int pos, int num) {\n uint32_t res = get32(pos);\n int off = pos & 31;\n res >>= off;\n off = 32 - off;\n if (num > off) {\n res |= get32(pos + 32) << off;\n }\n if (num < 32)\n res &= (1U << num) - 1;\n return res;\n }\n void set(int pos, int v) {\n if (pos < 0 || pos >= len)\n return;\n auto curr = get32(pos);\n auto mask = 1 << (pos & 31);\n if (v)\n curr |= mask;\n else\n curr &= ~mask;\n data.set(pos >> 5, (TValue)curr);\n }\n void setLength(uint32_t newLength) {\n len = newLength;\n data.setLength((len + 31) >> 5);\n }\n void push(int v) {\n setLength(len + 1);\n set(len - 1, v);\n }\n};\n\n#endif",
"ns.ts": "/**\n * Communication between devices\n */\n//% color=#E3008C weight=89 icon=\"\\uf086\"\n//% groups='[\"Infrared\", \"Cable\"]'\nnamespace network {\n}",
"pulse.cpp": "#include \"pxt.h\"\n#include \"pulse.h\"\n\n#define IR_TIMER_CHANNEL 0\n\n// from samd21.cpp\nvoid setTCC0(int enabled);\n\n#ifdef SAMD21\nvoid setTCC0(int enabled) {\n while (TCC0->STATUS.reg & TC_STATUS_SYNCBUSY)\n ;\n if (enabled)\n TCC0->CTRLA.reg |= TC_CTRLA_ENABLE;\n else\n TCC0->CTRLA.reg &= ~TC_CTRLA_ENABLE;\n}\n#endif\n\nnamespace network {\n\nstatic const uint8_t hamming[16] = {\n 0b0000000, 0b1110000, 0b1001100, 0b0111100, 0b0101010, 0b1011010, 0b1100110, 0b0010110,\n 0b1101001, 0b0011001, 0b0100101, 0b1010101, 0b1000011, 0b0110011, 0b0001111, 0b1111111,\n};\n\nstatic const uint8_t invHamming[64] = {\n 0x00, 0x0c, 0x0a, 0x7e, 0x09, 0x4e, 0x2e, 0xee, 0x09, 0x7d, 0x7b, 0x77, 0x99, 0x59, 0x39, 0x7e,\n 0x0a, 0x4d, 0xaa, 0x6a, 0x48, 0x44, 0x3a, 0x4e, 0x1d, 0xdd, 0x3a, 0x7d, 0x39, 0x4d, 0x33, 0x3f,\n 0x0c, 0xcc, 0x2b, 0x6c, 0x28, 0x5c, 0x22, 0x2e, 0x1b, 0x5c, 0xbb, 0x7b, 0x59, 0x55, 0x2b, 0x5f,\n 0x18, 0x6c, 0x6a, 0x66, 0x88, 0x48, 0x28, 0x6f, 0x11, 0x1d, 0x1b, 0x6f, 0x18, 0x5f, 0x3f, 0xff};\n\nstatic const uint8_t bitsToGap[4] = {1, 2, 4, 3};\nstatic const uint8_t gapToBits[5] = {0b00, 0b00, 0b01, 0b11, 0b10};\n\nstatic int lookupInvHaming(int v) {\n int k = invHamming[v >> 1];\n if (v & 1)\n return (k & 0xf);\n else\n return (k >> 4);\n}\n\nstatic void decodeHamming(uint32_t r, uint8_t *dst) {\n int a0 = 0;\n int a1 = 0;\n int b0 = 0;\n int b1 = 0;\n int p = 0;\n\n for (int i = 0; i < 7; ++i) {\n a0 |= ((r >> p++) & 1) << i;\n b0 |= ((r >> p++) & 1) << i;\n a1 |= ((r >> p++) & 1) << i;\n b1 |= ((r >> p++) & 1) << i;\n }\n\n dst[0] = (lookupInvHaming(a0) << 4) | lookupInvHaming(a1);\n dst[1] = (lookupInvHaming(b0) << 4) | lookupInvHaming(b1);\n}\n\nstatic void pushTwo(BitVector &bv, uint8_t a, uint8_t b) {\n int gap = bitsToGap[b * 2 + a];\n bv.push(1);\n while (gap--)\n bv.push(0);\n}\n\nstatic void encodeHamming(BitVector &bv, uint8_t a, uint8_t b) {\n int a0 = hamming[a >> 4];\n int a1 = hamming[a & 0xf];\n int b0 = hamming[b >> 4];\n int b1 = hamming[b & 0xf];\n for (int i = 0; i < 7; ++i) {\n pushTwo(bv, (a0 >> i) & 1, (b0 >> i) & 1);\n pushTwo(bv, (a1 >> i) & 1, (b1 >> i) & 1);\n }\n}\n\nuint16_t crc16ccit(uint8_t *data, uint32_t len) {\n uint16_t crc = 0xffff;\n\n while (len--) {\n crc ^= (*data++ << 8);\n for (int i = 0; i < 8; ++i) {\n if (crc & 0x8000)\n crc = crc << 1 ^ 0x1021;\n else\n crc = crc << 1;\n }\n }\n\n return crc;\n}\n\nstatic PulseBase* instance = NULL;\n\nstatic void timer_irq(uint16_t channels)\n{\n if (instance)\n instance->timerIRQ(channels);\n}\n\nPulseBase::PulseBase(uint16_t id, int pinOut, int pinIn, LowLevelTimer* t) {\n this->id = id;\n this->timer = t;\n\n instance = this;\n\n recvState = PULSE_RECV_ERROR;\n sending = false;\n outBuffer = NULL;\n pin = lookupPin(pinOut);\n if (pin) {\n pin->setDigitalValue(0);\n\n inpin = lookupPin(pinIn);\n\n devMessageBus.listen(id, PULSE_PACKET_END_EVENT, this, &PulseBase::packetEnd);\n }\n\n timer->setIRQPriority(0);\n timer->setIRQ(timer_irq);\n timer->setBitMode(BitMode16);\n timer->enable();\n}\n\nvoid PulseBase::setupGapEvents() {\n devMessageBus.listen(inpin->id, DEVICE_PIN_EVT_PULSE_HI, this, &PulseBase::pulseGap,\n MESSAGE_BUS_LISTENER_IMMEDIATE);\n devMessageBus.listen(inpin->id, DEVICE_PIN_EVT_PULSE_LO, this, &PulseBase::pulseMark,\n MESSAGE_BUS_LISTENER_IMMEDIATE);\n listen();\n}\n\nvoid PulseBase::listen() {\n inpin->getDigitalValue();\n inpin->eventOn(DEVICE_PIN_EVENT_ON_PULSE);\n}\n\nvoid PulseBase::setupPWM() {\n pin->setAnalogPeriodUs(1000 / 38); // 38kHz\n pin->setAnalogValue(333);\n setPWM(1);\n}\n\nvoid PulseBase::setPWM(int enabled) {\n setTCC0(enabled);\n pwmstate = enabled;\n}\n\nvoid PulseBase::finishPWM() {\n pin->setAnalogValue(0);\n setPWM(1);\n}\n\nvoid PulseBase::send(Buffer d) {\n if (sending)\n return; // error code?\n\n if (d->length > PULSE_MAX_MSG_SIZE - 2 || (d->length & 1))\n return; // error code?\n\n encodedMsg.setLength(0);\n for (int i = 0; i < 25; ++i)\n encodedMsg.push(1);\n\n for (int i = 0; i < 8; ++i)\n encodedMsg.push(0);\n\n for (int i = 0; i < d->length; i += 2) {\n encodeHamming(encodedMsg, d->data[i], d->data[i + 1]);\n }\n\n uint16_t crc = crc16ccit(d->data, d->length);\n encodeHamming(encodedMsg, crc & 0xff, crc >> 8);\n\n for (int i = 0; i < 15; ++i)\n encodedMsg.push(1);\n\n auto gap = system_timer_current_time_us() - lastSendTime;\n\n // we require 200ms between sends\n if (gap < 200000) {\n gap = (200000 - gap) / 1000;\n fiber_sleep(gap);\n }\n\n while (isReceiving())\n fiber_sleep(10);\n\n // encodedMsg.print();\n\n sending = true;\n sendStartTime = 0;\n setupPWM();\n\n sendPtr = 0;\n\n lastSendTime = system_timer_current_time_us();\n\n timer->setCompare(IR_TIMER_CHANNEL, timer->captureCounter() + PULSE_PULSE_LEN);\n\n while (sending) {\n fiber_sleep(10);\n }\n fiber_sleep(5);\n}\n\nvoid PulseBase::timerIRQ(uint16_t)\n{\n process();\n}\n\nvoid PulseBase::finish(int code) {\n if (recvState == PULSE_RECV_ERROR)\n return;\n\n if (code == 0) {\n Event evt(id, PULSE_PACKET_END_EVENT);\n } else {\n Event evt(id, PULSE_PACKET_ERROR_EVENT);\n PULSE_DMESG(\"IR ERROR %d [%s]\", code, dbg.get());\n }\n dbg.get();\n recvState = PULSE_RECV_ERROR;\n}\n\nvoid PulseBase::addPulse(int v) {\n if (this->pulsePtr < PULSE_MAX_PULSES - 1) {\n pulses[this->pulsePtr++] = (int16_t)v;\n } else {\n finish(2);\n }\n}\n\nint PulseBase::adjustShift() {\n int pulseLen = (pulses[0] - pulses[1]) / 9;\n PULSE_DMESG(\"prev: %d %d %d %d %d %d %d %d %d %d\", pulses[0], pulses[1], pulses[2], pulses[3],\n pulses[4], pulses[5], pulses[6], pulses[7], pulses[8], pulses[9], pulses[10],\n pulses[11]);\n return pulseLen;\n}\n\nvoid PulseBase::pulseGap(Event ev) {\n if (sending)\n return;\n\n if (ev.timestamp > 10000) {\n dbg.put(\" BRK \");\n finish(11);\n return;\n }\n\n int tm = (int)ev.timestamp;\n\n dbg.putNum(tm);\n\n if (recvState == PULSE_WAIT_START_GAP) {\n pulsePtr = 0;\n startTime = system_timer_current_time_us() - tm;\n addPulse(tm);\n recvState = PULSE_WAIT_DATA;\n dbg.put(\" *** \");\n return;\n }\n\n if (recvState == PULSE_WAIT_DATA) {\n addPulse(tm);\n return;\n }\n}\n\nvoid PulseBase::packetEnd(Event) {\n if (pulsePtr < 5)\n return;\n\n int pulseLen = adjustShift();\n int numBits = 0;\n uint32_t r = 0;\n uint8_t buf[PULSE_MAX_MSG_SIZE];\n int ptr = 0;\n\n for (int i = 2; i < pulsePtr; ++i) {\n if (pulses[i] > 0) {\n int len = (pulses[i] + pulseLen / 2) / pulseLen;\n if (len > 4)\n len = 4;\n r |= (uint32_t)gapToBits[len] << numBits;\n numBits += 2;\n if (numBits == 28) {\n decodeHamming(r, buf + ptr);\n numBits = 0;\n r = 0;\n ptr += 2;\n }\n }\n }\n\n pulsePtr = 0;\n\n if (numBits != 0) {\n Event evt(id, PULSE_PACKET_ERROR_EVENT);\n PULSE_DMESG(\"left over bits: %d\", numBits);\n return;\n }\n\n if (ptr < 4) {\n Event evt(id, PULSE_PACKET_ERROR_EVENT);\n PULSE_DMESG(\"too short: %d\", ptr);\n return; // too short\n }\n\n ptr -= 2;\n uint16_t crc = crc16ccit(buf, ptr);\n uint16_t pktCrc = (buf[ptr + 1] << 8) | buf[ptr];\n\n if (!outBuffer)\n registerGC((TValue*)&outBuffer);\n outBuffer = pins::createBuffer(ptr);\n memcpy(outBuffer->data, buf, ptr);\n if (crc != pktCrc)\n PULSE_DMESG(\"crc fail: %x %x len=%d\", crc, pktCrc, pulseLen);\n Event evt(id, crc == pktCrc ? PULSE_PACKET_EVENT : PULSE_PACKET_ERROR_EVENT);\n}\n\nvoid PulseBase::pulseMark(Event ev) {\n if (sending)\n return;\n\n if (ev.timestamp > 10000) {\n dbg.put(\" -BRK \");\n finish(10);\n return;\n }\n\n int tm = (int)ev.timestamp;\n\n dbg.putNum(-tm);\n\n lastMarkTime = system_timer_current_time_us();\n\n if (tm >= 20 * PULSE_PULSE_LEN) {\n recvState = PULSE_WAIT_START_GAP;\n return;\n }\n\n if (recvState == PULSE_WAIT_DATA) {\n if (tm >= 12 * PULSE_PULSE_LEN) {\n // finish\n addPulse(-(40 * PULSE_PULSE_LEN)); // make sure we get all ones at the end\n finish(0);\n } else {\n addPulse(-tm);\n }\n }\n}\n\nbool PulseBase::isReceiving() {\n auto now = system_timer_current_time_us();\n // inpin low means mark\n if (inpin->getDigitalValue() == 0 || now - lastMarkTime < 10000) {\n return true;\n }\n return false;\n}\n\nBuffer PulseBase::getBuffer() {\n return outBuffer;\n}\n\nvoid PulseBase::process() {\n // DMESG(\"PROC\");\n if (!sending)\n return;\n\n auto now = system_timer_current_time_us();\n if (sendStartTime == 0)\n sendStartTime = now - (PULSE_PULSE_LEN / 2);\n\n auto encodedMsgPtr = (int)(now - sendStartTime) / PULSE_PULSE_LEN;\n\n encodedMsgPtr = sendPtr++;\n\n if (encodedMsgPtr >= encodedMsg.size()) {\n encodedMsg.setLength(0);\n finishPWM();\n\n sending = false;\n return;\n }\n\n timer->offsetCompare(IR_TIMER_CHANNEL, PULSE_PULSE_LEN);\n\n int curr = encodedMsg.get(encodedMsgPtr);\n if (curr != pwmstate)\n setPWM(curr);\n}\n}\n",
"pulse.h": "#ifndef CABLE_PULSE_H\n#define CABLE_PULSE_H\n\n#include \"pxt.h\"\n#include \"bitvector.h\"\n#include \"LowLevelTimer.h\"\n\n#define PULSE_MAX_MSG_SIZE 34\n#define PULSE_PACKET_END_EVENT 0x1\n#define PULSE_PACKET_EVENT 0x2\n#define PULSE_PACKET_ERROR_EVENT 0x3\n#define PULSE_MAX_PULSES (PULSE_MAX_MSG_SIZE * 14 + 10)\n#define PULSE_PULSE_LEN 250\n\n#define PULSE_IR_COMPONENT_ID 0x2042\n#define PULSE_CABLE_COMPONENT_ID 0x2043\n\n#define PULSE_DEBUG 0\n\n#if PULSE_DEBUG\n#define PULSE_DMESG DMESG\n#else\n#define PULSE_DMESG(...) \\\n do { \\\n } while (0)\n#endif\n\nnamespace network {\n\nclass DbgBuffer {\n public:\n#if PULSE_DEBUG\n char dbgBuf[1200];\n int dbgPtr;\n DbgBuffer() {\n dbgBuf[0] = 0;\n dbgPtr = 0;\n }\n#endif\n\n void put(const char *msg) {\n#if IR_DEBUG\n int len = strlen(msg);\n if (len + dbgPtr > (int)sizeof(dbgBuf) - 1) {\n dbgPtr = 1;\n dbgBuf[0] = '>';\n }\n memcpy(dbgBuf + dbgPtr, msg, len + 1);\n dbgPtr += len;\n#endif\n }\n\n void putNum(int n) {\n#if IR_DEBUG\n char buf[30];\n itoa(n, buf);\n put(\" \");\n put(buf);\n#endif\n }\n\n const char *get() {\n#if IR_DEBUG\n dbgPtr = 0;\n return dbgBuf;\n#else\n return \"NoDebug\";\n#endif\n }\n};\n\nenum PulseRecvState : uint8_t {\n PULSE_RECV_ERROR,\n PULSE_WAIT_START_GAP,\n PULSE_WAIT_DATA,\n};\n\nclass PulseBase {\n protected:\n DevicePin *pin;\n DevicePin *inpin;\n LowLevelTimer* timer;\n BitVector encodedMsg;\n uint16_t sendPtr;\n int8_t pwmstate;\n bool sending;\n uint16_t id;\n uint64_t startTime;\n uint64_t sendStartTime;\n uint64_t lastMarkTime;\n uint64_t lastSendTime;\n\n int16_t pulses[PULSE_MAX_PULSES + 1];\n uint16_t pulsePtr;\n\n PulseRecvState recvState;\n Buffer outBuffer;\n\n DbgBuffer dbg;\n\n public:\n PulseBase(uint16_t id, int pinOut, int pinIn, LowLevelTimer* t);\n virtual void setupGapEvents();\n virtual void listen();\n virtual void setupPWM();\n virtual void setPWM(int enabled);\n virtual void finishPWM();\n void send(Buffer d);\n void finish(int code);\n void addPulse(int v);\n int adjustShift();\n void pulseGap(Event ev);\n int errorRate(int start, BitVector &bits);\n void packetEnd(Event);\n void pulseMark(Event ev);\n Buffer getBuffer();\n bool isReceiving();\n void process();\n void timerIRQ(uint16_t);\n};\n}\n#endif",
"pxt.json": "{\n \"name\": \"pulse\",\n \"description\": \"Communication over pulses\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"pulse.cpp\",\n \"pulse.h\",\n \"bitvector.h\",\n \"shims.d.ts\",\n \"ns.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace network {\n\n /**\n * Send data over cable.\n */\n //% parts=\"cable\" shim=network::cableSendPacket\n function cableSendPacket(buf: Buffer): void;\n\n /**\n * Get most recent packet received over cable.\n */\n //% parts=\"cable\" shim=network::cablePacket\n function cablePacket(): Buffer;\n\n /**\n * Run action after a packet is recieved over cable.\n */\n //% parts=\"cable\" shim=network::onCablePacket\n function onCablePacket(body: () => void): void;\n\n /**\n * Run action after there's an error reciving packet over cable.\n */\n //% shim=network::onCableError\n function onCableError(body: () => void): void;\n}\n\n// Auto-generated. Do not edit. Really.\n"
},
"infrared": {
"README.md": "# infrared\n\nThe Infra Red library.\n\n",
"ir.cpp": "#include \"pxt.h\"\n#include \"pulse.h\"\n#include \"SAMDTCTimer.h\"\n#include \"SAMDTCCTimer.h\"\n\nnamespace network {\n\nclass IrWrap : public PulseBase {\n public:\n IrWrap()\n : PulseBase(PULSE_IR_COMPONENT_ID, PIN(IR_OUT), PIN(IR_IN),\n new SAMDTCTimer(TC4, TC4_IRQn)) {\n setupGapEvents();\n }\n};\nSINGLETON(IrWrap);\n/**\n * Send data over IR.\n */\n//% parts=\"ir\"\nvoid infraredSendPacket(Buffer buf) {\n auto w = getIrWrap();\n w->send(buf);\n}\n\n/**\n * Get most recent packet received over IR.\n */\n//% parts=\"ir\"\nBuffer infraredPacket() {\n auto w = getIrWrap();\n return w->getBuffer();\n}\n\n/**\n * Run action after a packet is recieved over IR.\n */\n//% parts=\"ir\"\nvoid onInfraredPacket(Action body) {\n getIrWrap(); // attach events\n registerWithDal(PULSE_IR_COMPONENT_ID, PULSE_PACKET_EVENT, body);\n}\n\n/**\n * Run action after there's an error recieving packet over IR.\n */\n//%\nvoid onInfraredError(Action body) {\n getIrWrap();\n registerWithDal(PULSE_IR_COMPONENT_ID, PULSE_PACKET_ERROR_EVENT, body);\n}\n} // namespace network\n",
"ir.ts": "class InfraredPacket {\n /**\n * The first number in the payload.\n */\n public receivedNumber: number;\n /**\n * The array of numbers of received.\n */\n public receivedNumbers: number[];\n /**\n * The raw buffer of data received\n */\n public receivedBuffer: Buffer;\n}\n\nnamespace network {\n /**\n * Send a number over the infrared transmitter.\n * @param value number to send\n */\n //% blockId=\"ir_send_number\" block=\"infrared send number %value\"\n //% help=network/infrared-send-number\n //% parts=\"ir\" weight=90 group=\"Infrared\"\n export function infraredSendNumber(value: number) {\n infraredSendNumbers([value]);\n }\n\n /**\n * Send an array of numbers over infrared. The array size has to be 32 bytes or less.\n * @param values \n */\n //% parts=\"ir\" group=\"Infrared\"\n export function infraredSendNumbers(values: number[]) {\n let buf = msgpack.packNumberArray(values);\n if (buf.length % 2) {\n const buf2 = control.createBuffer(buf.length + 1);\n buf2.write(0, buf);\n buf2[buf2.length - 1] = 0xc1;\n buf = buf2;\n }\n infraredSendPacket(buf);\n }\n\n /**\n * Run some code when the infrared receiver gets a number.\n */\n //% blockId=ir_on_infrared_received block=\"on infrared received\" blockGap=8\n //% help=network/on-infrared-received-number\n //% parts=\"ir\" group=\"Infrared\"\n export function onInfraredReceivedNumber(handler: (num: number) => void) {\n onInfraredPacket(() => {\n const buf: Buffer = infraredPacket();\n const nums: number[] = msgpack.unpackNumberArray(buf) || [];\n const num = nums[0] || 0;\n handler(num);\n });\n }\n\n /**\n * Run some code when the infrared receiver gets a list of numbers.\n */\n export function onInfraredReceivedNumbers(handler: (nums: number[]) => void) {\n onInfraredPacket(() => {\n const buf: Buffer = infraredPacket();\n const nums: number[] = msgpack.unpackNumberArray(buf) || [];\n handler(nums);\n });\n }\n \n /**\n * Run some code when the infrared receiver gets a buffer.\n */\n export function onInfraredReceivedBuffer(handler: (buf: Buffer) => void) {\n onInfraredPacket(() => {\n const buf: Buffer = infraredPacket();\n handler(buf);\n });\n }\n \n /**\n * Run some code when the infrared receiver gets a packet.\n */\n //% mutate=objectdestructuring\n //% mutateText=InfraredPacket\n //% mutateDefaults=\"receivedNumber\"\n //% blockId=ir_on_packet_received block=\"on infrared received\" blockGap=8\n //% parts=\"ir\" group=\"Infrared\" blockHidden=1 deprecated=1\n export function onInfraredPacketReceived(cb: (p: InfraredPacket) => void) {\n onInfraredPacket(() => {\n const buf: Buffer = infraredPacket();\n const nums: number[] = msgpack.unpackNumberArray(buf) || [];\n const num = nums[0] || 0;\n\n const packet = new InfraredPacket();\n packet.receivedBuffer = buf;\n packet.receivedNumbers = nums;\n packet.receivedNumber = num;\n cb(packet)\n });\n }\n}",
"pxt.json": "{\n \"name\": \"infrared\",\n \"description\": \"Communication over Infra Red\",\n \"dependencies\": {\n \"core\": \"*\",\n \"pulse\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"ir.cpp\",\n \"ir.ts\",\n \"shims.d.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace network {\n\n /**\n * Send data over IR.\n */\n //% parts=\"ir\" shim=network::infraredSendPacket\n function infraredSendPacket(buf: Buffer): void;\n\n /**\n * Get most recent packet received over IR.\n */\n //% parts=\"ir\" shim=network::infraredPacket\n function infraredPacket(): Buffer;\n\n /**\n * Run action after a packet is recieved over IR.\n */\n //% parts=\"ir\" shim=network::onInfraredPacket\n function onInfraredPacket(body: () => void): void;\n\n /**\n * Run action after there's an error recieving packet over IR.\n */\n //% shim=network::onInfraredError\n function onInfraredError(body: () => void): void;\n}\n\n// Auto-generated. Do not edit. Really.\n"
},
"game": {
"animation.ts": "/*\n Animation library for sprites\n*/\n//% color=\"#03AA74\" weight=100 icon=\"\\uf021\" block=\"Animation\"\n//% groups='[\"Animate\", \"Advanced\"]'\n//% advanced=true\nnamespace animation {\n const stateNamespace = \"__animation\";\n\n interface AnimationState {\n animations: SpriteAnimation[];\n }\n\n export class Point {\n public x: number;\n public y: number;\n\n constructor(x: number, y: number) {\n this.x = x;\n this.y = y;\n }\n }\n\n //% fixedInstances blockId=animation_path block=\"path %pathString\"\n export class PathPreset {\n constructor(public pathString: string) {\n }\n }\n\n export class Path {\n protected nodes: PathNode[];\n protected lastNode: number; // The index of the last node to fire\n\n constructor() {\n this.nodes = [];\n this.lastNode = -1;\n }\n\n private static generateNode(p0: Point, command: string, args: number[], metadata: [ Point, PathNode ]): PathNode {\n const [ pathStart, lastNode ] = metadata;\n let node: PathNode;\n switch (command) {\n case \"M\": { // M x y\n const p1 = new Point(args[0], args[1]);\n node = new MoveTo(p1);\n break;\n }\n case \"m\": { // m dx dy\n const p1 = new Point(p0.x + args[0], p0.y + args[1]);\n node = new MoveTo(p1);\n break;\n }\n case \"L\": { // L x y\n const p1 = new Point(args[0], args[1]);\n node = new LineTo(p0, p1);\n break;\n }\n case \"l\": { // l dx dy\n const p1 = new Point(p0.x + args[0], p0.y + args[1]);\n node = new LineTo(p0, p1);\n break;\n }\n case \"H\": { // H x\n const p1 = new Point(args[0], p0.y);\n node = new LineTo(p0, p1);\n break;\n }\n case \"h\": { // h dx\n const p1 = new Point(p0.x + args[0], p0.y);\n node = new LineTo(p0, p1);\n break;\n }\n case \"V\": { // V y\n const p1 = new Point(p0.x, args[0]);\n node = new LineTo(p0, p1);\n break;\n }\n case \"v\": { // v dy\n const p1 = new Point(p0.x, p0.y + args[0]);\n node = new LineTo(p0, p1);\n break;\n }\n case \"Q\": { // Q x1 y1 x2 y2\n const p1 = new Point(args[0], args[1]);\n const p2 = new Point(args[2], args[3]);\n node = new QuadraticCurveTo(p0, p1, p2);\n break;\n }\n case \"q\": { // q dx1 dy1 dx2 dy2\n const p1 = new Point(p0.x + args[0], p0.y + args[1]);\n const p2 = new Point(p0.x + args[2], p0.y + args[3]);\n node = new QuadraticCurveTo(p0, p1, p2);\n break;\n }\n case \"T\": { // T x2 y2\n let lastControlPoint: Point = lastNode.getLastControlPoint();\n if (!lastControlPoint) break;\n\n const p1 = new Point(p0.x + (p0.x - lastControlPoint.x), p0.y + (p0.y - lastControlPoint.y));\n const p2 = new Point(args[0], args[1]);\n node = new QuadraticCurveTo(p0, p1, p2);\n break;\n }\n case \"t\": { // t dx2 dy2\n let lastControlPoint: Point = lastNode.getLastControlPoint();\n if (!lastControlPoint) break;\n\n const p1 = new Point(p0.x + (p0.x - lastControlPoint.x), p0.y + (p0.y - lastControlPoint.y));\n const p2 = new Point(p0.x + args[0], p0.y + args[1]);\n node = new QuadraticCurveTo(p0, p1, p2);\n break;\n }\n case \"C\": { // C x1 y1 x2 y2 x3 y3\n const p1 = new Point(args[0], args[1]);\n const p2 = new Point(args[2], args[3]);\n const p3 = new Point(args[4], args[5]);\n node = new CubicCurveTo(p0, p1, p2, p3);\n break;\n }\n case \"c\": { // c dx1 dy1 dx2 dy2 dx3 dy3\n const p1 = new Point(p0.x + args[0], p0.y + args[1]);\n const p2 = new Point(p0.x + args[2], p0.y + args[3]);\n const p3 = new Point(p0.x + args[4], p0.y + args[5]);\n node = new CubicCurveTo(p0, p1, p2, p3);\n break;\n }\n case \"S\": { // S x2 y2 x3 y3\n let lastControlPoint: Point = lastNode.getLastControlPoint();\n if (!lastControlPoint) break;\n\n const p1 = new Point(p0.x + (p0.x - lastControlPoint.x), p0.y + (p0.y - lastControlPoint.y));\n const p2 = new Point(args[0], args[1]);\n const p3 = new Point(args[2], args[3]);\n node = new CubicCurveTo(p0, p1, p2, p3);\n break;\n }\n case \"s\": { // s dx2 dy2 dx3 dy3\n let lastControlPoint: Point = lastNode.getLastControlPoint();\n if (!lastControlPoint) break;\n\n const p1 = new Point(p0.x + (p0.x - lastControlPoint.x), p0.y + (p0.y - lastControlPoint.y));\n const p2 = new Point(p0.x + args[0], p0.y + args[1]);\n const p3 = new Point(p0.x + args[2], p0.y + args[3]);\n node = new CubicCurveTo(p0, p1, p2, p3);\n break;\n }\n case \"Z\": // Z\n case \"z\": { // z\n node = new LineTo(p0, pathStart);\n break;\n }\n }\n\n return node;\n }\n\n private static commandToArgCount(command: string): number {\n switch (command) {\n case \"M\": // moveTo\n case \"m\":\n return 2;\n case \"L\": // lineTo\n case \"l\":\n return 2;\n case \"H\": // horizontalLineTo\n case \"h\":\n return 1;\n case \"V\": // verticalLineTo\n case \"v\":\n return 1;\n case \"Q\": // quadraticCurveTo\n case \"q\":\n return 4;\n case \"T\": // smoothQuadraticCurveTo\n case \"t\":\n return 2;\n case \"C\": // cubicCurveTo\n case \"c\":\n return 6;\n case \"S\": // smoothCubicCurveTo\n case \"s\":\n return 4;\n case \"A\": // arcTo\n case \"a\":\n return 7;\n case \"Z\": // closePath\n case \"z\":\n return 0;\n default:\n return -1;\n }\n }\n\n public static parse(pathStart: Point, pathString: string): Path {\n let path: Path = new Path();\n let p0: Point = pathStart;\n\n // This implementation of SVG parsing does not support the A/a commands, nor does it support exponents in arguments\n const digits = \"0123456789\";\n const separators = \", \\t\\n\\r\\f\\v\";\n const signs = \"+-\";\n\n let currentArg: string = \"\";\n let command: string = null;\n let args: number[] = [];\n\n for (let i = 0; i < pathString.length; i++) {\n const char = pathString.charAt(i);\n const lastNode = path.nodes[path.nodes.length - 1];\n\n // This is an SVG path parser. It's kinda complicated. For each character, evaluate the following conditions:\n // - if it's a digit, add it to the current argument\n // - else if it's whitespace or newline, finish the current argument and prepare for the next one\n // - else if it's a command, complete the previous argument, and prepare for the next one\n // - if there's sufficient data to make a node during this step, create it and continue\n // - else if it's a plus/minus sign, and if it's the start of a new argument, add it to allow for positive/negative numbers\n // - if it's the end of the string, complete the current argument before proceeding to the next step\n // - if there's sufficient data to make a node after all of these steps, create it\n if (digits.indexOf(char) > -1) { // Parses number arguments\n currentArg += char;\n } else if (separators.indexOf(char) > -1 && currentArg) { // Terminates number arguments\n args.push(parseInt(currentArg));\n currentArg = \"\";\n } else if (this.commandToArgCount(char) > -1) { // Parses command arguments\n if (command && currentArg) {\n args.push(parseInt(currentArg));\n\n // Try to finish up this node, otherwise just toss it out\n if (command && args.length >= this.commandToArgCount(command)) {\n let node: PathNode = this.generateNode(p0, command, args, [\n pathStart,\n lastNode\n ]);\n path.add(node);\n p0 = node.getEndPoint(); // Set the start for the next node to the end of this node\n if (node.setStart) pathStart = p0; // If this is a move command, then this sets the new start of the path (for the Z/z command)\n }\n\n // Clean up before continuing\n command = \"\";\n args = [];\n currentArg = \"\";\n }\n command = char;\n } else if (signs.indexOf(char) > -1) { // Allows for positive/negative values\n if (currentArg) {\n args.push(parseInt(currentArg));\n currentArg = \"\";\n }\n currentArg = char;\n }\n\n // If the end of the path has been reached, cleans up the last argument before continuing parsing\n if (i === pathString.length - 1) {\n if (currentArg) {\n args.push(parseInt(currentArg));\n }\n }\n\n // If the command has a sufficient amount of arguments, then create a node for it\n if (command && args.length >= this.commandToArgCount(command)) {\n // Generate the node\n let node: PathNode = this.generateNode(p0, command, args, [\n pathStart,\n lastNode\n ]);\n path.add(node);\n p0 = node.getEndPoint();\n if (node.setStart) pathStart = p0;\n\n // Reset and prepare for the next command\n command = \"\";\n args = [];\n currentArg = \"\";\n }\n }\n\n return path;\n }\n\n public add(node: PathNode) {\n this.nodes.push(node);\n }\n\n get length(): number {\n return this.nodes.length;\n }\n\n public run(interval: number, target: Sprite, startedAt: number): boolean {\n const runningTime = control.millis() - startedAt; // The time since the start of the path\n const nodeIndex = Math.floor(runningTime / interval); // The current node\n const nodeTime = runningTime % interval; // The time the current node has been animating\n\n if (this.lastNode > -1 && this.lastNode < nodeIndex && this.nodes.length) { // If the last node hasn't been completed yet\n this.nodes[this.lastNode].apply(target, interval, interval); // Applies the last state of the previous node in case it was missed (this makes sure all moveTos fire)\n\n if (nodeIndex >= this.nodes.length) return true; // Once the nodeIndex is past the last item of the array, only then end the animation\n }\n this.lastNode = nodeIndex;\n\n this.nodes[nodeIndex].apply(target, nodeTime, interval);\n return false;\n }\n }\n\n export abstract class PathNode {\n setStart: boolean;\n constructor() {\n this.setStart = false;\n }\n\n apply(target: Sprite, nodeTime: number, interval: number) {};\n\n getLastControlPoint(): Point {\n return null;\n };\n\n getEndPoint(): Point {\n return null;\n };\n }\n\n export class MoveTo extends PathNode {\n constructor(public p1: Point) {\n super();\n\n this.setStart = true;\n }\n\n apply(target: Sprite, nodeTime: number, interval: number) {\n nodeTime >= interval && target.setPosition(this.p1.x, this.p1.y);\n }\n\n getEndPoint(): Point {\n return this.p1;\n }\n }\n\n export class LineTo extends PathNode {\n constructor(public p0: Point, public p1: Point) {\n super();\n }\n\n apply(target: Sprite, nodeTime: number, interval: number) {\n const x = Math.round(((this.p1.x - this.p0.x) / interval) * nodeTime) + this.p0.x;\n const y = Math.round(((this.p1.y - this.p0.y) / interval) * nodeTime) + this.p0.y;\n\n target.setPosition(x, y);\n }\n\n getEndPoint(): Point {\n return this.p1;\n }\n }\n\n export class QuadraticCurveTo extends PathNode {\n constructor(public p0: Point, public p1: Point, public p2: Point) {\n super();\n }\n\n apply(target: Sprite, nodeTime: number, interval: number) {\n const progress = nodeTime / interval;\n const diff = 1 - progress;\n const a = Math.pow(diff, 2);\n const b = 2 * diff * progress;\n const c = Math.pow(progress, 2);\n\n const x = Math.round(a * this.p0.x + b * this.p1.x + c * this.p2.x);\n const y = Math.round(a * this.p0.y + b * this.p1.y + c * this.p2.y);\n\n target.setPosition(x, y);\n }\n\n getLastControlPoint(): Point {\n return this.p1;\n }\n\n getEndPoint(): Point {\n return this.p2;\n }\n }\n\n export class CubicCurveTo extends PathNode {\n constructor(public p0: Point, public p1: Point, public p2: Point, public p3: Point) {\n super();\n }\n\n apply(target: Sprite, nodeTime: number, interval: number) {\n const progress = nodeTime / interval;\n const diff = 1 - progress;\n const a = Math.pow(diff, 3);\n const b = 3 * Math.pow(diff, 2) * progress;\n const c = 3 * diff * Math.pow(progress, 2);\n const d = Math.pow(progress, 3);\n\n const x = Math.round(a * this.p0.x + b * this.p1.x + c * this.p2.x + d * this.p3.x);\n const y = Math.round(a * this.p0.y + b * this.p1.y + c * this.p2.y + d * this.p3.y);\n\n target.setPosition(x, y);\n }\n\n getLastControlPoint(): Point {\n return this.p2;\n }\n\n getEndPoint(): Point {\n return this.p3;\n }\n }\n\n export abstract class SpriteAnimation {\n protected startedAt: number;\n\n constructor(public sprite: Sprite, protected loop: boolean) {\n }\n\n public init() {\n let state: AnimationState = game.currentScene().data[stateNamespace];\n\n // Register animation updates to fire when frames are rendered\n if (!state) {\n state = game.currentScene().data[stateNamespace] = {\n animations: []\n } as AnimationState;\n\n game.eventContext().registerFrameHandler(scene.ANIMATION_UPDATE_PRIORITY, () => {\n state.animations = state.animations.filter((anim: SpriteAnimation) => {\n if (anim.sprite.flags & sprites.Flag.Destroyed)\n return false;\n return !anim.update(); // If update returns true, the animation is done and will be removed\n });\n });\n }\n\n // Remove any other animations of this type and attached to this sprite\n state.animations = state.animations.filter((anim: SpriteAnimation) => {\n return !(anim.sprite === this.sprite &&\n ((anim instanceof ImageAnimation && this instanceof ImageAnimation) ||\n (anim instanceof MovementAnimation && this instanceof MovementAnimation)));\n });\n\n state.animations.push(this);\n }\n\n public update(): boolean {\n // This should be implemented by subclasses\n return false;\n }\n }\n\n export class ImageAnimation extends SpriteAnimation {\n private lastFrame: number;\n\n constructor(sprite: Sprite, private frames: Image[], private frameInterval: number, loop?: boolean) {\n super(sprite, loop);\n this.lastFrame = -1;\n }\n\n public update(): boolean {\n if (this.startedAt == null)\n this.startedAt = control.millis();\n const runningTime = control.millis() - this.startedAt;\n const frameIndex = Math.floor(runningTime / this.frameInterval);\n\n if (this.lastFrame != frameIndex && this.frames.length) {\n if (!this.loop && frameIndex >= this.frames.length) {\n return true;\n }\n const newImage = this.frames[frameIndex % this.frames.length];\n if (this.sprite.image !== newImage) {\n this.sprite.setImage(newImage);\n }\n }\n this.lastFrame = frameIndex;\n return false;\n }\n }\n\n export class MovementAnimation extends SpriteAnimation {\n constructor(sprite: Sprite, private path: Path, private nodeInterval: number, loop?: boolean) {\n super(sprite, loop);\n\n this.loop = loop;\n }\n\n public update(): boolean {\n if (this.startedAt == null) this.startedAt = control.millis();\n\n let result = this.path.run(this.nodeInterval, this.sprite, this.startedAt);\n if (result) {\n if (!this.loop) return true;\n this.startedAt = control.millis();\n }\n return false;\n }\n }\n\n /**\n * Create and run an image animation on a sprite\n * @param frames the frames to animate through\n * @param sprite the sprite to animate on\n * @param frameInterval the time between changes, eg: 500\n */\n //% blockId=run_image_animation\n //% block=\"animate $sprite=variables_get(mySprite) frames $frames=animation_editor interval (ms) $frameInterval=timePicker loop $loop=toggleOnOff\"\n //% group=\"Animate\"\n //% weight=100\n //% help=animation/run-image-animation\n export function runImageAnimation(sprite: Sprite, frames: Image[], frameInterval?: number, loop?: boolean) {\n const anim = new ImageAnimation(sprite, frames, frameInterval || 500, !!loop);\n anim.init();\n }\n\n /**\n * Create and run a movement animation on a sprite\n * @param sprite the sprite to move\n * @param pathString the SVG path to animate\n * @param duration how long the animation should play for, eg: 500\n */\n //% blockId=run_movement_animation\n //% block=\"animate $sprite=variables_get(mySprite) with $pathString=animation_path for (ms) $duration=timePicker loop $loop=toggleOnOff\"\n //% duration.defl=2000\n //% weight=80\n //% group=\"Animate\"\n //% help=animation/run-movement-animation\n export function runMovementAnimation(sprite: Sprite, pathString: string, duration?: number, loop?: boolean) {\n const path = Path.parse(new Point(sprite.x, sprite.y), pathString);\n const anim = new MovementAnimation(sprite, path, duration / path.length, !!loop);\n anim.init();\n }\n\n export enum AnimationTypes {\n //% block=\"all\"\n All,\n //% block=\"frame\"\n ImageAnimation,\n //% block=\"path\"\n MovementAnimation\n }\n\n /**\n * Stop one type or all animations (simple and looping) on a sprite\n * @param type the animation type to stop\n * @param sprite the sprite to filter animations by\n */\n //% blockId=stop_animations\n //% block=\"stop %type animations on %sprite=variables_get(mySprite)\"\n //% group=\"Animate\"\n //% weight=60\n //% help=animation/stop-animation\n export function stopAnimation(type: AnimationTypes, sprite: Sprite) {\n let state: AnimationState = game.currentScene().data[stateNamespace];\n if (state && state.animations) {\n state.animations = state.animations.filter((anim: SpriteAnimation) => {\n if (anim.sprite === sprite) {\n switch (type) {\n case AnimationTypes.ImageAnimation:\n if (anim instanceof ImageAnimation) return false;\n break;\n case AnimationTypes.MovementAnimation:\n if (anim instanceof MovementAnimation) return false;\n break;\n case AnimationTypes.All:\n return false;\n }\n }\n return true;\n });\n }\n if (type == AnimationTypes.All || type == AnimationTypes.ImageAnimation) {\n //stop state based animation if any as well\n sprite._action = -1\n }\n }\n\n //% fixedInstance whenUsed block=\"fly to center\"\n export const flyToCenter = new PathPreset(\"L 80 60\");\n\n //% fixedInstance whenUsed block=\"shake\"\n export const shake = new PathPreset(\"m 4 -1 m 1 2 m -6 2 m -4 -8 m 8 8 m 2 -4 m -8 0 m 6 3 m -3 -2\");\n\n //% fixedInstance whenUsed block=\"bounce (right)\"\n export const bounceRight = new PathPreset(\"q 7 0 15 40 q 10 -30 15 -25 q 10 5 15 25 q 5 -25 10 0 q 4 -15 8 0 q 2 -10 4 0 q 1 -5 1 0 q 0 -2 1 0\");\n\n //% fixedInstance whenUsed block=\"bounce (left)\"\n export const bounceLeft = new PathPreset(\"q -7 0 -15 40 q -10 -30 -15 -25 q -10 5 -15 25 q -5 -25 -10 0 q -4 -15 -8 0 q -2 -10 -4 0 q -1 -5 -1 0 q 0 -2 -1 0\");\n\n //% fixedInstance whenUsed block=\"parachute (right)\"\n export const parachuteRight = new PathPreset(\"q 20 10 40 5 q 2 -2 0 0 q -15 10 -30 5 q -2 -2 0 0 q 10 10 20 5 q 2 -2 0 0 q -5 5 -10 3 q -1 -1 0 0 q 2 2 5 1 l 0 2 l 0 2 l 0 2\");\n\n //% fixedInstance whenUsed block=\"parachute (left)\"\n export const parachuteLeft = new PathPreset(\"q -20 10 -40 5 q -2 -2 0 0 q 15 10 30 5 q 2 -2 0 0 q -10 10 -20 5 q -2 -2 0 0 q 5 5 10 3 q 1 -1 0 0 q -2 2 -5 1 l 0 2 l 0 2 l 0 2\");\n\n //% fixedInstance whenUsed block=\"ease (right)\"\n export const easeRight = new PathPreset(\"h 5 h 10 h 20 h 30 h 20 h 10 h 5\");\n\n //% fixedInstance whenUsed block=\"ease (left)\"\n export const easeLeft = new PathPreset(\"h -5 h -10 h -20 h -30 h -20 h -10 h -5\");\n\n //% fixedInstance whenUsed block=\"ease (down)\"\n export const easeDown = new PathPreset(\"v 5 v 10 v 20 v 30 v 20 v 10 v 5\");\n\n //% fixedInstance whenUsed block=\"ease (up)\"\n export const easeUp = new PathPreset(\"v -5 v -10 v -20 v -30 v -20 v -10 v -5\");\n\n //% fixedInstance whenUsed block=\"wave (right)\"\n export const waveRight = new PathPreset(\"c 25 -15 15 -5 20 0\");\n\n //% fixedInstance whenUsed block=\"wave (left)\"\n export const waveLeft = new PathPreset(\"c -25 -15 -15 -5 -20 0\");\n\n //% fixedInstance whenUsed block=\"bobbing (in place)\"\n export const bobbing = new PathPreset(\"c 0 -20 0 20 0 0\");\n\n //% fixedInstance whenUsed block=\"bobbing (right)\"\n export const bobbingRight = new PathPreset(\"c 5 -20 15 20 20 0\");\n\n //% fixedInstance whenUsed block=\"bobbing (left)\"\n export const bobbingLeft = new PathPreset(\"c -5 -20 -15 20 -20 0\");\n\n /**\n * Generates a path string for preset animation\n * @param animationPath The preset path\n */\n //% blockId=animation_path\n //% block=\"%animationPath\"\n //% group=\"Animate\"\n //% blockHidden=1\n export function animationPresets(animationPath: PathPreset) {\n return animationPath.pathString;\n }\n\n\n //% blockId=animation_editor block=\"%frames\"\n //% shim=TD_ID\n //% frames.fieldEditor=\"animation\"\n //% frames.fieldOptions.decompileLiterals=\"true\"\n //% frames.fieldOptions.filter=\"!tile !dialog !background\"\n //% weight=40\n //% group=\"Animate\" duplicateShadowOnDrag\n export function _animationFrames(frames: Image[]) {\n return frames\n }\n}\n",
"ask.ts": "namespace game {\n /**\n * Prompts the user for a boolean question\n * @param title\n * @param subtitle\n */\n //% group=\"Gameplay\"\n //% weight=89 help=game/ask\n //% blockId=gameask block=\"ask %title||%subtitle\"\n //% title.shadow=text\n //% subtitle.shadow=text\n //% group=\"Prompt\"\n export function ask(title: any, subtitle?: any): boolean {\n controller._setUserEventsEnabled(false);\n game.eventContext(); // initialize the game\n control.pushEventContext();\n title = console.inspect(title);\n subtitle = subtitle ? console.inspect(subtitle) : subtitle;\n game.showDialog(title, subtitle, \"A = OK, B = CANCEL\");\n // short pause so that players don't skip through prompt\n pause(500);\n\n let answer: boolean = null;\n let aNotHeld = false;\n let bNotHeld = false;\n pauseUntil(() => {\n aNotHeld = aNotHeld || !controller.A.isPressed();\n bNotHeld = bNotHeld || !controller.B.isPressed();\n\n if (aNotHeld && controller.A.isPressed()) {\n answer = true;\n } else if (bNotHeld && controller.B.isPressed()) {\n answer = false;\n }\n return answer !== null;\n });\n\n control.popEventContext();\n controller._setUserEventsEnabled(true);\n return answer;\n }\n}",
"assetTemplates.ts": "//% helper=getTilemapByName\n//% pyConvertToTaggedTemplate\n//% blockIdentity=\"tiles._tilemapEditor\"\nfunction tilemap(lits: any, ...args: any[]): tiles.TileMapData { return null }\n\n//% helper=getTilemapByName\n//% pyConvertToTaggedTemplate\nfunction tilemap8(lits: any, ...args: any[]): tiles.TileMapData { return null }\n\n//% helper=getTilemapByName\n//% pyConvertToTaggedTemplate\nfunction tilemap16(lits: any, ...args: any[]): tiles.TileMapData { return null }\n\n//% helper=getTilemapByName\n//% pyConvertToTaggedTemplate\nfunction tilemap32(lits: any, ...args: any[]): tiles.TileMapData { return null }\n\nnamespace assets {\n //% helper=getTilemapByName\n //% pyConvertToTaggedTemplate\n //% blockIdentity=\"tiles._tilemapEditor\"\n export function tilemap(lits: any, ...args: any[]): tiles.TileMapData { return null }\n\n //% helper=getImageByName\n //% pyConvertToTaggedTemplate\n //% blockIdentity=\"images._spriteImage\"\n export function image(lits: any, ...args: any[]): Image { return null }\n\n //% helper=getTileByName\n //% pyConvertToTaggedTemplate\n //% blockIdentity=\"images._tile\"\n export function tile(lits: any, ...args: any[]): Image { return null }\n\n //% helper=getAnimationByName\n //% pyConvertToTaggedTemplate\n //% blockIdentity=\"animation._animationFrames\"\n export function animation(lits: any, ...args: any[]): Image[] { return null }\n}\n\nnamespace helpers {\n export type TilemapFactory = (name: string) => tiles.TileMapData;\n export type ImageFactory = (name: string) => Image;\n export type TileFactory = (name: string) => Image;\n export type AnimationFactory = (name: string) => Image[];\n\n interface Factory {\n kind: string;\n factory: (name: string) => any;\n }\n\n let factories: Factory[];\n\n export function _registerFactory(kind: string, factory: (name: string) => any) {\n if (!factories) factories = [];\n factories.push({\n kind,\n factory\n });\n }\n\n export function _getFactoryInstance(kind: string, name: string) {\n if (factories) {\n for (const factory of factories) {\n if (factory.kind === kind) {\n let data = factory.factory(name);\n if (data) return data;\n }\n }\n }\n return null;\n }\n\n // Deprecated; use helpers._registerFactory(\"tilemap\", name)\n export function registerTilemapFactory(factory: TilemapFactory) {\n _registerFactory(\"tilemap\", factory);\n }\n\n export function getTilemapByName(name: string) {\n return _getFactoryInstance(\"tilemap\", name);\n }\n\n export function getImageByName(name: string) {\n return _getFactoryInstance(\"image\", name);\n }\n\n export function getAnimationByName(name: string) {\n return _getFactoryInstance(\"animation\", name);\n }\n\n export function getTileByName(name: string) {\n return _getFactoryInstance(\"tile\", name);\n }\n}\n",
"background.ts": "enum BackgroundAlignment {\n //% block=\"left\"\n Left = 1,\n //% block=\"right\"\n Right,\n //% block=\"top\"\n Top,\n //% block=\"bottom\"\n Bottom,\n //% block=\"center\"\n Center\n}\n\nnamespace scene {\n export class Background {\n color: number;\n _image: Image;\n camera: Camera;\n private _layers: BackgroundLayer[];\n\n constructor(camera: Camera) {\n this.color = 0;\n this.camera = camera;\n this._layers = [];\n }\n\n public addLayer(pic: Image, distance: number, alignment: BackgroundAlignment) {\n const layer = new BackgroundLayer(distance, alignment, pic);\n this._layers.push(layer);\n this._layers.sort((a, b) => b.distance - a.distance);\n return layer;\n }\n\n get image() {\n if (!this._image) {\n this._image = image.create(screen.width, screen.height);\n }\n return this._image;\n }\n \n set image(image: Image) {\n this._image = image;\n }\n\n hasBackgroundImage(): boolean {\n return !!this._image;\n }\n\n draw() {\n screen.fill(this.color);\n if (this._image)\n screen.drawTransparentImage(this._image, 0, 0)\n if (this._layers) {\n this._layers.forEach(layer => {\n // compute displacement based on distance\n const ox = Math.round(this.camera.drawOffsetX / (1 + layer.distance));\n const oy = Math.round(this.camera.drawOffsetY / (1 + layer.distance));\n layer.draw(ox, oy);\n });\n }\n }\n }\n\n\n export class BackgroundLayer {\n distance: number;\n img: Image;\n repeatX: boolean;\n repeatY: boolean;\n alignX: BackgroundAlignment;\n alignY: BackgroundAlignment;\n\n constructor(distance: number, alignment: BackgroundAlignment, img: Image) {\n this.distance = Math.max(1, distance);\n this.img = img;\n switch (alignment) {\n case BackgroundAlignment.Center:\n this.repeatX = true;\n this.repeatY = true;\n this.alignX = BackgroundAlignment.Center;\n this.alignY = BackgroundAlignment.Center;\n break;\n case BackgroundAlignment.Left:\n case BackgroundAlignment.Right:\n this.repeatX = false;\n this.repeatY = true;\n this.alignX = alignment;\n this.alignY = BackgroundAlignment.Center;\n break;\n case BackgroundAlignment.Top:\n case BackgroundAlignment.Bottom:\n this.repeatX = true;\n this.repeatY = false;\n this.alignX = BackgroundAlignment.Center;\n this.alignY = alignment;\n break;\n }\n }\n\n draw(offsetX: number, offsetY: number) {\n const w = screen.width;\n const h = screen.height;\n const pw = this.img.width;\n const ph = this.img.height;\n\n if (!pw || !ph) return; // empty image.\n\n // left, top aligned\n let rx = -offsetX;\n let ry = -offsetY;\n\n switch (this.alignX) {\n case BackgroundAlignment.Right: rx -= (w + pw); break;\n case BackgroundAlignment.Center: rx -= (w + pw) >> 1; break;\n }\n switch (this.alignY) {\n case BackgroundAlignment.Bottom: ry -= (h + ph); break;\n case BackgroundAlignment.Center: ry -= (h + ph) >> 1; break;\n }\n\n rx %= w; if (rx < 0) rx += w;\n ry %= h; if (ry < 0) ry += h;\n\n // avoid subpixel aliasing\n rx = Math.floor(rx);\n ry = Math.floor(ry);\n\n let y = 0;\n let py = 0;\n while (y < h) {\n py = y % ph;\n let dh = Math.min(ph - py, h - ry);\n let x = 0;\n let rxl = rx;\n while (x < w) {\n let px = x % pw;\n let dw = Math.min(pw - px, w - rxl);\n screen.drawImage(this.img, rxl, ry);\n rxl = (rxl + dw) % w;\n x += this.repeatX ? dw : w;\n }\n ry = (ry + dh) % h;\n y += this.repeatY ? dh : h;\n }\n }\n }\n}",
"basesprite.ts": "interface SpriteLike {\n z: number;\n id: number;\n flags?: number;\n\n __update(camera: scene.Camera, dt: number): void;\n __draw(camera: scene.Camera): void;\n __serialize(offset: number): Buffer;\n}\n\nnamespace sprites {\n export class BaseSprite implements SpriteLike {\n protected _z: number;\n id: number;\n\n constructor(z: number) {\n this.z = z;\n\n // this assigns the sprite an id as a side effect\n game.currentScene().addSprite(this);\n }\n\n __visible(): boolean {\n return true;\n }\n\n get z(): number {\n return this._z;\n }\n\n set z(v: number) {\n if (this._z !== v) {\n this._z = v;\n game.currentScene().flags |= scene.Flag.NeedsSorting;\n }\n }\n\n __draw(camera: scene.Camera) {\n if (this.__visible()) {\n this.__drawCore(camera);\n }\n }\n\n __drawCore(camera: scene.Camera) { }\n\n __update(camera: scene.Camera, dt: number) { }\n\n __serialize(offset: number): Buffer { return undefined }\n }\n}",
"camera.ts": "namespace scene {\n export class Camera {\n // coordinate used for all physics computation\n protected _offsetX: number;\n protected _offsetY: number;\n\n // coordinate used for draw sprites, may including shaking\n drawOffsetX: number;\n drawOffsetY: number;\n sprite: Sprite;\n\n protected shakeStartTime: number;\n protected shakeDuration: number;\n protected shakeAmplitude: number;\n\n constructor() {\n this._offsetX = 0;\n this._offsetY = 0;\n\n this.drawOffsetX = 0;\n this.drawOffsetY = 0;\n }\n\n get offsetX() {\n return this._offsetX;\n }\n set offsetX(v: number) {\n const scene = game.currentScene();\n if (scene.tileMap && scene.tileMap.enabled) {\n this._offsetX = scene.tileMap.offsetX(v);\n } else {\n this._offsetX = v;\n }\n }\n get offsetY() {\n return this._offsetY;\n }\n set offsetY(v: number) {\n const scene = game.currentScene();\n if (scene.tileMap && scene.tileMap.enabled) {\n this._offsetY = scene.tileMap.offsetY(v);\n } else {\n this._offsetY = v;\n }\n }\n\n get x() {\n return this.drawOffsetX + (screen.width >> 1);\n }\n get y() {\n return this.drawOffsetY + (screen.height >> 1);\n }\n get left() {\n return this.drawOffsetX;\n }\n get right() {\n return this.drawOffsetX + screen.width;\n }\n get top() {\n return this.drawOffsetY;\n }\n get bottom() {\n return this.drawOffsetY + screen.height;\n }\n\n shake(amplitude: number = 4, duration: number = 1000) {\n if (amplitude <= 0 || duration <= 0) {\n this.shakeStartTime = undefined;\n } else {\n // this overrides any existing shake operation \n this.shakeStartTime = control.millis();\n this.shakeAmplitude = amplitude;\n this.shakeDuration = duration;\n // don't reset offset, will be recomputed in update\n }\n }\n\n update() {\n // if sprite, follow sprite\n if (this.sprite) {\n this.offsetX = this.sprite.x - (screen.width >> 1);\n this.offsetY = this.sprite.y - (screen.height >> 1);\n }\n\n // normalize offset\n this.offsetX |= 0;\n this.offsetY |= 0;\n\n this.drawOffsetX = this.offsetX;\n this.drawOffsetY = this.offsetY;\n\n // apply shake if needed\n if (this.shakeStartTime !== undefined) {\n const elapsed = control.millis() - this.shakeStartTime;\n if (elapsed >= this.shakeDuration) {\n // we are done!\n this.shakeStartTime = undefined;\n } else {\n // compute new shake\n const percentComplete = elapsed / this.shakeDuration;\n const dampStart = 0.75;\n let damp = 1;\n if (percentComplete >= dampStart)\n damp = Math.max(0, 1 - percentComplete);\n const f = this.shakeAmplitude * damp;\n const x = (Math.random() * f) >> 0;\n const y = (Math.random() * f) >> 0;\n // apply to offset\n this.drawOffsetX += x;\n this.drawOffsetY += y;\n }\n }\n }\n }\n}",
"console.ts": "namespace game.consoleOverlay {\n let consoleColor = 1;\n let consoleStrings: string[];\n let tabSize = 8;\n const marginx = 4;\n const marginy = 2;\n const consoleFont = image.font5;\n const consoleLines = Math.floor(screen.height / (consoleFont.charHeight + marginy)) - 1;\n const consoleColumns = Math.floor((screen.width - 2 * marginx) / consoleFont.charWidth);\n console.addListener(listener);\n\n export function isVisible() {\n return !!consoleStrings;\n }\n\n export function clear() {\n consoleStrings = [];\n }\n\n export function setVisible(value: boolean, col?: number) {\n if (value != !!consoleStrings)\n consoleStrings = value ? [] : undefined;\n if (col !== undefined)\n consoleColor = col;\n }\n\n function listener(priority: ConsolePriority, text: string) {\n if (!consoleStrings || !text)\n return;\n\n // split text into lines\n text.split(\"\\n\")\n .filter(line => !!line)\n .forEach(line => {\n for (let j = 0; j < line.length; j += consoleColumns) {\n consoleStrings.push(line.slice(j, j + consoleColumns));\n }\n });\n\n if (consoleStrings.length > consoleLines) {\n consoleStrings.splice(0, consoleStrings.length - consoleLines);\n }\n }\n\n export function draw() {\n if (!consoleStrings || scene.systemMenu.isVisible()) return;\n const height = consoleFont.charHeight + marginy;\n const top = 2 + (game.stats ? height : 0);\n for (let i = 0; i < consoleStrings.length; ++i) {\n if (consoleStrings[i].indexOf(\"\\t\") >= 0) {\n const t = consoleStrings[i].split(\"\\t\");\n let tOff = 0;\n for (let tab of t) {\n let padding = tabSize - ((tOff + tab.length) % tabSize)\n screen.print(tab, marginx + (tOff * consoleFont.charWidth), top + i * height, consoleColor, consoleFont);\n tOff += tab.length + padding;\n }\n }\n else\n screen.print(consoleStrings[i], marginx, top + i * height, consoleColor, consoleFont);\n }\n }\n}",
"constants.ts": "const KEY_UP = 2048;\nconst KEY_DOWN = 2049;\nconst INTERNAL_KEY_UP = 2050;\nconst INTERNAL_KEY_DOWN = 2051;\nconst SYSTEM_KEY_UP = 2052;\nconst SYSTEM_KEY_DOWN = 2053;\nconst KEY_REPEAT = 2054;\nconst SYSTEM_KEY_REPEAT = 2055;\n",
"controller.ts": "enum ControllerEvent {\n //% block=\"connected\"\n Connected = 1,\n //% block=\"disconnected\"\n Disconnected = 2\n}\n\n/**\n * Access to game controls\n */\n//% weight=98 color=\"#D54322\" icon=\"\\uf11b\"\n//% groups='[\"Single Player\", \"Multiplayer\"]'\n//% blockGap=8\nnamespace controller {\n let _players: Controller[];\n\n function addController(ctrl: Controller) {\n if (!_players) {\n _players = [];\n }\n _players[ctrl.playerIndex - 1] = ctrl;\n }\n\n export function _player1(): Controller {\n if (!_players || !_players[0])\n new Controller(1, [controller.left, controller.up, controller.right, controller.down, controller.A, controller.B, controller.menu]);\n return _players[0];\n }\n\n export function players(): Controller[] {\n _player1(); // ensure player1 is present\n return _players.filter(ctrl => !!ctrl);\n }\n\n export class ControlledSprite {\n public _inputLastFrame: boolean;\n constructor(\n public s: Sprite,\n public vx: number,\n public vy: number\n ) { }\n }\n\n export function _moveSprites() {\n // todo: move to current scene\n control.enablePerfCounter(\"controller\")\n players().forEach(ctrl => ctrl.__preUpdate());\n }\n\n //% fixedInstances\n export class Controller {\n playerIndex: number;\n buttons: Button[];\n analog: boolean;\n private _id: number;\n private _connected: boolean;\n\n // array of left,up,right,down,a,b,menu buttons\n constructor(playerIndex: number, buttons: Button[]) {\n this._id = control.allocateNotifyEvent();\n this._connected = false;\n this.playerIndex = playerIndex;\n this.analog = false;\n if (buttons)\n this.buttons = buttons;\n else {\n this.buttons = [];\n const leftId = 1 + (this.playerIndex - 1) * 7;\n for (let i = 0; i < 7; ++i) {\n this.buttons.push(new Button(leftId + i, -1));\n }\n }\n for (let i = 0; i < this.buttons.length; ++i)\n this.buttons[i]._owner = this;\n addController(this);\n }\n\n get _controlledSprites(): ControlledSprite[] {\n return game.currentScene().controlledSprites[this.playerIndex];\n }\n\n set _controlledSprites(cps: ControlledSprite[]) {\n game.currentScene().controlledSprites[this.playerIndex] = cps;\n }\n\n get id() {\n return this._id;\n }\n\n dump() {\n this.buttons.forEach(b => console.log(b.toString()));\n }\n\n /**\n * Get the 'Left' button\n */\n //%\n get left() {\n return this.button(ControllerButton.Left);\n }\n\n /**\n * Get the 'Right' button\n */\n //%\n get right() {\n return this.button(ControllerButton.Right);\n }\n\n /**\n * Get the 'Up' button\n */\n //%\n get up() {\n return this.button(ControllerButton.Up);\n }\n\n /**\n * Get the 'Down' button\n */\n //%\n get down() {\n return this.button(ControllerButton.Down);\n }\n\n /**\n * Get the 'A' button\n */\n //%\n get A() {\n return this.button(ControllerButton.A);\n }\n\n /**\n * Get the 'B' button\n */\n //%\n get B() {\n return this.button(ControllerButton.B);\n }\n\n /**\n * Get the 'Menu' button\n */\n //%\n get menu() {\n return this.button(7);\n }\n\n /**\n * Control a sprite using the direction buttons from the controller. Note that this will overwrite\n * the current velocity of the sprite whenever a directional button is pressed. To stop controlling\n * a sprite, pass 0 for vx and vy.\n *\n * @param sprite The Sprite to control\n * @param vx The velocity used for horizontal movement when left/right is pressed\n * @param vy The velocity used for vertical movement when up/down is pressed\n */\n //% blockId=\"ctrlgame_control_sprite\" block=\"%controller move $sprite=variables_get(mySprite) with buttons||vx $vx vy $vy\"\n //% weight=100\n //% expandableArgumentMode=\"toggle\"\n //% vx.defl=100 vy.defl=100\n //% help=controller/move-sprite\n //% group=\"Multiplayer\"\n //% vx.shadow=\"spriteSpeedPicker\"\n //% vy.shadow=\"spriteSpeedPicker\"\n moveSprite(sprite: Sprite, vx: number = 100, vy: number = 100) {\n if (!sprite) return;\n if (!this._controlledSprites) this._controlledSprites = [];\n let cp = this._controlledSprites.find(cp => cp.s.id == sprite.id);\n if (!cp) {\n cp = new ControlledSprite(sprite, vx, vy);\n this._controlledSprites.push(cp);\n }\n if (cp.vx && vx == 0) {\n cp.s.vx = 0\n }\n if (cp.vy && vy == 0) {\n cp.s.vy = 0\n }\n cp.vx = vx;\n cp.vy = vy;\n }\n\n private button(button: ControllerButton): Button {\n return this.buttons[button - 1];\n }\n\n /**\n * Run some code when a button is pressed, released, or held\n */\n //% weight=99 blockGap=8\n //% blockId=ctrlonbuttonevent block=\"on %controller %button **button** %event\"\n //% group=\"Multiplayer\"\n //% help=controller/on-button-event\n onButtonEvent(btn: ControllerButton, event: ControllerButtonEvent, handler: () => void) {\n this.button(btn).onEvent(event, handler);\n }\n\n /**\n * Register code run when a controller event occurs\n * @param event\n * @param handler\n */\n //% weight=99 blockGap=8\n //% blockId=ctrlonevent block=\"on %controller %event\"\n //% group=\"Multiplayer\"\n //% help=controller/on-event\n onEvent(event: ControllerEvent, handler: () => void) {\n control.onEvent(this.id, event, handler);\n }\n\n get connected() {\n return this._connected;\n }\n\n set connected(value: boolean) {\n if (value != this._connected) {\n this._connected = value;\n control.raiseEvent(this.id, this._connected ? ControllerEvent.Connected : ControllerEvent.Disconnected);\n }\n }\n\n /**\n * Indicates if the button is currently pressed\n */\n //% weight=96 blockGap=8 help=controller/button/is-pressed\n //% blockId=ctrlispressed block=\"is %controller %button **button** pressed\"\n //% group=\"Multiplayer\"\n isPressed(btn: ControllerButton): boolean {\n return this.button(btn).isPressed();\n }\n\n /**\n * Get the horizontal movement, given the step and state of buttons\n * @param step the distance, eg: 100\n */\n //% weight=50 blockGap=8 help=controller/dx\n //% blockId=ctrldx block=\"%controller dx (left-right buttons)||scaled by %step\"\n //% step.defl=100\n //% group=\"Multiplayer\"\n dx(step: number = 100) {\n const ctx = control.eventContext();\n if (!ctx) return 0;\n\n if (this.analog)\n return (this.right.pressureLevel() - this.left.pressureLevel()) / 512 * ctx.deltaTime * step\n if (this.left.isPressed()) {\n if (this.right.isPressed()) return 0\n else return -step * ctx.deltaTime;\n }\n else if (this.right.isPressed()) return step * ctx.deltaTime\n else return 0\n }\n\n /**\n * Get the vertical movement, given the step and state of buttons\n * @param step the distance, eg: 100\n */\n //% weight=49 help=keys/dy\n //% blockId=ctrldy block=\"%controller dy (up-down buttons)||scaled by %step\"\n //% step.defl=100\n //% group=\"Multiplayer\"\n dy(step: number = 100) {\n const ctx = control.eventContext();\n if (!ctx) return 0;\n\n if (this.analog)\n return (this.down.pressureLevel() - this.up.pressureLevel()) / 512 * ctx.deltaTime * step\n if (this.up.isPressed()) {\n if (this.down.isPressed()) return 0\n else return -step * ctx.deltaTime;\n }\n else if (this.down.isPressed()) return step * ctx.deltaTime\n else return 0\n }\n\n __preUpdate() {\n if (!this._controlledSprites) return;\n\n let deadSprites = false;\n\n let svx = 0\n let svy = 0\n\n if (this.analog) {\n svx = (this.right.pressureLevel() - this.left.pressureLevel()) >> 1\n svy = (this.down.pressureLevel() - this.up.pressureLevel()) >> 1\n } else {\n svx = (this.right.isPressed() ? 256 : 0) - (this.left.isPressed() ? 256 : 0)\n svy = (this.down.isPressed() ? 256 : 0) - (this.up.isPressed() ? 256 : 0)\n }\n\n let svxInCricle = svx\n let svyInCircle = svy\n\n // here svx/y are -256 to 256 range\n const sq = svx * svx + svy * svy\n // we want to limit svx/y to be within circle of 256 radius\n const max = 256 * 256\n // is it outside the circle?\n if (sq > max) {\n // if so, store the vector scaled down to fit in the circle\n const scale = Math.sqrt(max / sq)\n svxInCricle = scale * svx | 0\n svyInCircle = scale * svy | 0\n }\n\n this._controlledSprites.forEach(controlledSprite => {\n const { s, vx, vy } = controlledSprite;\n if (s.flags & sprites.Flag.Destroyed) {\n deadSprites = true;\n return;\n }\n\n if (controlledSprite._inputLastFrame) {\n if (vx) s._vx = Fx.zeroFx8;\n if (vy) s._vy = Fx.zeroFx8;\n }\n\n if (svx || svy) {\n if (vx && vy) {\n // if moving in both vx/vy use speed vector constrained to be within circle\n s._vx = Fx.imul(svxInCricle as any as Fx8, vx)\n s._vy = Fx.imul(svyInCircle as any as Fx8, vy)\n } else if (vx) {\n // otherwise don't bother\n s._vx = Fx.imul(svx as any as Fx8, vx)\n } else if (vy) {\n s._vy = Fx.imul(svy as any as Fx8, vy)\n }\n controlledSprite._inputLastFrame = true;\n }\n else {\n controlledSprite._inputLastFrame = false;\n }\n });\n\n if (deadSprites)\n this._controlledSprites = this._controlledSprites\n .filter(s => !(s.s.flags & sprites.Flag.Destroyed));\n }\n\n __update(dtms: number) {\n dtms = dtms | 0;\n this.buttons.forEach(btn => btn.__update(dtms));\n }\n\n serialize(offset: number): Buffer {\n const buf = control.createBuffer(offset + 1);\n let b = 0;\n for (let i = 0; this.buttons.length; ++i)\n b |= (this.buttons[i].isPressed() ? 1 : 0) << i;\n buf[offset] = b\n return buf;\n }\n }\n\n /**\n * Called by the game engine to update and/or raise events\n */\n export function __update(dt: number) {\n const dtms = (dt * 1000) | 0\n players().forEach(ctrl => ctrl.__update(dtms));\n }\n\n export function serialize(offset: number): Buffer {\n return _player1().serialize(offset);\n }\n\n /**\n * Control a sprite using the direction buttons from the controller. Note that this\n * control will take over the vx and vy of the sprite and overwrite any changes\n * made unless a 0 is passed.\n *\n * @param sprite The Sprite to control\n * @param vx The velocity used for horizontal movement when left/right is pressed\n * @param vy The velocity used for vertical movement when up/down is pressed\n */\n //% blockId=\"game_control_sprite\" block=\"move $sprite=variables_get(mySprite) with buttons||vx $vx vy $vy\"\n //% weight=100\n //% expandableArgumentMode=\"toggle\"\n //% vx.defl=100 vy.defl=100\n //% help=controller/move-sprite\n //% group=\"Single Player\"\n //% vx.shadow=spriteSpeedPicker\n //% vy.shadow=spriteSpeedPicker\n export function moveSprite(sprite: Sprite, vx: number = 100, vy: number = 100) {\n _player1().moveSprite(sprite, vx, vy);\n }\n\n /**\n * Get the horizontal movement, given the step and state of buttons\n * @param step the distance, eg: 100\n */\n //% weight=50 blockGap=8 help=controller/dx\n //% blockId=keydx block=\"dx (left-right buttons)||scaled by %step\"\n //% step.defl=100\n //% group=\"Single Player\"\n export function dx(step: number = 100) {\n return _player1().dx(step);\n }\n\n /**\n * Get the vertical movement, given the step and state of buttons\n * @param step the distance, eg: 100\n */\n //% weight=49 help=keys/dy\n //% blockId=keydy block=\"dy (up-down buttons)||scaled by %step\"\n //% step.defl=100\n //% group=\"Single Player\"\n export function dy(step: number = 100) {\n return _player1().dy(step);\n }\n\n class AnyButton extends Button {\n isPressed(): boolean {\n const ctrl = _player1();\n\n for (const b of ctrl.buttons) {\n if (b.isPressed()) return true;\n }\n return false;\n }\n }\n\n //% fixedInstance block=\"any\"\n export const anyButton: Button = new AnyButton(0, -1);\n}\n",
"controllerbutton.ts": "enum ControllerButtonEvent {\n //% block=\"pressed\"\n Pressed = KEY_DOWN,\n //% block=\"released\"\n Released = KEY_UP,\n //% block=\"repeat\"\n Repeated = KEY_REPEAT\n}\n\nenum ControllerButton {\n //% block=\"{id:controller}A\"\n A = 5,\n //% block=\"{id:controller}B\"\n B = 6,\n //% block=\"left\"\n Left = 1,\n //% block=\"up\"\n Up = 2,\n //% block=\"right\"\n Right = 3,\n //% block=\"down\"\n Down = 4\n}\n\n/**\n * Access to game controls\n */\n//% weight=98 color=\"#D54322\" icon=\"\\uf11b\"\n//% groups='[\"Single Player\", \"Multiplayer\"]'\n//% blockGap=8\nnamespace controller {\n let _userEventsEnabled = true;\n let defaultRepeatDelay = 500;\n let defaultRepeatInterval = 30;\n\n //% shim=pxt::pressureLevelByButtonId\n declare function pressureLevelByButtonId(btnId: number, codalId: number): number;\n\n //% shim=pxt::setupButton\n function setupButton(buttonId: number, key: number) {\n return // missing in sim\n }\n\n export class ButtonHandler {\n constructor(public event: number, public callback: () => void) { }\n }\n\n export class ButtonEventHandlerState {\n constructor(public id: number) {};\n\n public user: ButtonHandler[];\n public system: ButtonHandler[];\n }\n\n //% fixedInstances\n export class Button {\n _owner: Controller;\n public id: number;\n //% help=controller/button/repeat-delay\n public repeatDelay: number;\n //% help=controller/button/repeat-interval\n public repeatInterval: number;\n private _pressed: boolean;\n private _pressedElasped: number;\n private _repeatCount: number;\n\n protected get handlerState(): ButtonEventHandlerState {\n for (const state of game.currentScene().buttonEventHandlers) {\n if (state.id === this.id) return state;\n }\n return undefined;\n }\n\n toString(): string {\n return `btn ${this.id} ${this._pressed ? \"down\" : \"up\"}`;\n }\n\n constructor(id: number, configKey: number) {\n this.id = id;\n this._pressed = false;\n this.repeatDelay = undefined;\n this.repeatInterval = undefined;\n this._repeatCount = 0;\n\n if (id > 0) {\n // this is to deal with the \"anyButton\" hack, which creates a button that is not visible\n // in the UI, but used in event-handler to simulate the wildcard ANY for matching. As\n // this button can't actually be pressed, we don't want it to propagate events\n control.internalOnEvent(INTERNAL_KEY_UP, this.id, () => this.setPressed(false), 16)\n control.internalOnEvent(INTERNAL_KEY_DOWN, this.id, () => this.setPressed(true), 16)\n\n if (configKey > 0)\n setupButton(id, configKey)\n }\n }\n\n private raiseButtonUp() {\n if (_userEventsEnabled)\n control.raiseEvent(KEY_UP, this.id)\n else\n control.raiseEvent(SYSTEM_KEY_UP, this.id);\n }\n\n private raiseButtonDown() {\n if (_userEventsEnabled)\n control.raiseEvent(KEY_DOWN, this.id)\n else\n control.raiseEvent(SYSTEM_KEY_DOWN, this.id)\n }\n\n private raiseButtonRepeat() {\n if (_userEventsEnabled)\n control.raiseEvent(KEY_REPEAT, this.id)\n else\n control.raiseEvent(SYSTEM_KEY_REPEAT, this.id)\n }\n\n /**\n * Run some code when a button is pressed, released, or held\n */\n //% weight=99 blockGap=8 help=controller/button/on-event\n //% blockId=keyonevent block=\"on %button **button** %event\"\n //% group=\"Single Player\"\n onEvent(event: ControllerButtonEvent, handler: () => void) {\n const eventHandler = this.getOrCreateHandlerForEvent(event);\n eventHandler.callback = handler;\n }\n\n /**\n * Adds an event handler that will fire whenever the specified event\n * is triggered on this button. Handlers added using this method will\n * not conflict with events added via onEvent. The same handler can\n * not be added for the same event more than once.\n *\n * @param event The event to subscribe to for this button\n * @param handler The code to run when the event triggers\n */\n addEventListener(event: ControllerButtonEvent, handler: () => void) {\n this.getOrCreateHandlerForEvent(event);\n\n const handlerState = this.handlerState;\n\n if (!handlerState.system) handlerState.system = [];\n\n for (const eventHandler of handlerState.system) {\n if (eventHandler.event === event && eventHandler.callback === handler) return;\n }\n\n handlerState.system.push(new ButtonHandler(event, handler));\n }\n\n /**\n * Removes an event handler registered with addEventListener.\n *\n * @param event The event that the handler was registered for\n * @param handler The handler to remove\n */\n removeEventListener(event: ControllerButtonEvent, handler: () => void) {\n const handlerState = this.handlerState;\n if (!handlerState || !handlerState.system) return;\n\n for (let i = 0; i < handlerState.system.length; i++) {\n if (handlerState.system[i].event === event && handlerState.system[i].callback === handler) {\n handlerState.system.splice(i, 1)\n return;\n }\n }\n }\n\n /**\n * Pauses until a button is pressed or released\n */\n //% weight=98 blockGap=8 help=controller/button/pause-until\n // blockId=keypauseuntil block=\"pause until %button **button** is %event\"\n //% group=\"Single Player\"\n pauseUntil(event: ControllerButtonEvent) {\n control.waitForEvent(event, this.id)\n }\n\n /**\n * Indicates if the button is currently pressed\n */\n //% weight=96 blockGap=8 help=controller/button/is-pressed\n //% blockId=keyispressed block=\"is %button **button** pressed\"\n //% group=\"Single Player\"\n isPressed() {\n return this._pressed;\n }\n\n /**\n * Indicates how hard the button is pressed, 0-512\n */\n pressureLevel() {\n if (control.deviceDalVersion() == \"sim\") {\n return this.isPressed() ? 512 : 0\n // once implemented in sim, this could be similar to the one below\n } else {\n return pressureLevelByButtonId(this.id, -1);\n }\n }\n\n setPressed(pressed: boolean) {\n if (this._pressed != pressed) {\n power.poke();\n if (this._owner)\n this._owner.connected = true;\n this._pressed = pressed;\n if (this._pressed) {\n this._pressedElasped = 0;\n this.raiseButtonDown();\n } else {\n this._repeatCount = 0;\n this.raiseButtonUp();\n }\n }\n }\n\n __update(dtms: number) {\n if (!this._pressed) return;\n this._pressedElasped += dtms;\n\n const delay = this.repeatDelay === undefined ? defaultRepeatDelay : this.repeatDelay;\n const interval = this.repeatInterval === undefined ? defaultRepeatInterval : this.repeatInterval;\n\n // inital delay\n if (this._pressedElasped < delay)\n return;\n\n // repeat count for this step\n const count = Math.floor((this._pressedElasped - delay - interval) / interval);\n if (count != this._repeatCount) {\n this.raiseButtonRepeat();\n this._repeatCount = count;\n }\n }\n\n protected runButtonEvents(event: ControllerButtonEvent) {\n const handlerState = this.handlerState;\n if (!handlerState) return;\n\n const userHandler = this.getOrCreateHandlerForEvent(event);\n if (userHandler.callback) userHandler.callback();\n\n if (handlerState.system) {\n for (const eventHandler of handlerState.system) {\n if (eventHandler.event === event && eventHandler.callback) eventHandler.callback();\n }\n }\n }\n\n protected getOrCreateHandlerForEvent(event: ControllerButtonEvent) {\n if (!this.handlerState) {\n game.currentScene().buttonEventHandlers.push(new ButtonEventHandlerState(this.id));\n }\n\n const handlerState = this.handlerState;\n if (!handlerState.user) handlerState.user = [];\n\n for (const eventHandler of handlerState.user) {\n if (eventHandler.event === event) {\n return eventHandler;\n }\n }\n\n // Register actual handler if this hasn't been used before\n control.onEvent(event, this.id, () => this.runButtonEvents(event));\n\n const newHandler = new ButtonHandler(event, undefined);\n handlerState.user.push(newHandler);\n return newHandler;\n }\n }\n\n /**\n * Configures the timing of the on button repeat event for all of the controller buttons\n * @param delay number of milliseconds from when the button is pressed to when the repeat event starts firing, eg: 500\n * @param interval minimum number of milliseconds between calls to the button repeat event, eg: 30\n */\n export function setRepeatDefault(delay: number, interval: number) {\n defaultRepeatDelay = delay;\n defaultRepeatInterval = interval;\n }\n\n /**\n * Pause the program until a button is pressed\n */\n //% weight=10\n export function pauseUntilAnyButtonIsPressed() {\n control.waitForEvent(KEY_DOWN, 0)\n }\n\n export function _setUserEventsEnabled(enabled: boolean) {\n _userEventsEnabled = enabled;\n }\n}\n",
"controllerbuttons.cpp": "#include \"pxt.h\"\n\n#ifdef PXT_CODAL\n\nnamespace pxt {\n\nclass PressureButton : public codal::Button {\n public:\n PressureButton(Pin &pin, uint16_t id,\n ButtonEventConfiguration eventConfiguration = DEVICE_BUTTON_ALL_EVENTS,\n ButtonPolarity polarity = ACTIVE_LOW, PullMode mode = PullMode::None)\n : Button(pin, id, eventConfiguration, polarity, mode) {}\n\n virtual int pressureLevel() { return isPressed() ? 512 : 0; }\n};\n\nstruct AnalogCache {\n AnalogCache *next;\n Pin *pin;\n uint32_t lastMeasureMS;\n uint16_t lastMeasure;\n AnalogCache(Pin *pin) : pin(pin) {\n next = NULL;\n lastMeasureMS = 0;\n lastMeasure = pin->getAnalogValue();\n }\n uint16_t read();\n};\n\nuint16_t AnalogCache::read() {\n uint32_t now = current_time_ms();\n if (now - lastMeasureMS < 50)\n return lastMeasure;\n lastMeasureMS = now;\n lastMeasure = pin->getAnalogValue();\n return lastMeasure;\n}\n\nstatic AnalogCache *analogCache;\n\nclass AnalogButton : public PressureButton {\n public:\n AnalogCache *cache;\n int16_t threshold;\n bool state;\n\n AnalogButton(AnalogCache *cache, uint16_t id, int threshold)\n : PressureButton(*cache->pin, id), cache(cache), threshold(threshold), state(false) {}\n\n protected:\n virtual int pressureLevel() override {\n int v = cache->read() - 512;\n if (threshold < 0)\n v = -v;\n int vmin = getConfig(CFG_ANALOG_JOYSTICK_MIN, 50);\n int vmax = getConfig(CFG_ANALOG_JOYSTICK_MAX, 500);\n v = (v - vmin) * 512 / (vmax - vmin);\n if (v < 0)\n v = 0;\n if (v > 512)\n v = 512;\n return v;\n }\n\n virtual int buttonActive() override {\n int v = cache->read() - 512;\n int thr = threshold;\n\n if (thr < 0) {\n v = -v;\n thr = -thr;\n }\n\n if (v > thr)\n state = true;\n else if (state && v > thr * 3 / 4)\n state = true;\n else\n state = false;\n\n return state;\n }\n};\n\nAnalogCache *lookupAnalogCache(Pin *pin) {\n for (auto c = analogCache; c; c = c->next)\n if (c->pin == pin)\n return c;\n auto c = new AnalogCache(pin);\n c->next = analogCache;\n analogCache = c;\n return c;\n}\n\nint multiplexedButtonIsPressed(int btnId);\nint registerMultiplexedButton(int pin, int buttonId);\n\n//% expose\nint pressureLevelByButtonId(int btnId, int codalId) {\n if (codalId <= 0)\n codalId = DEVICE_ID_FIRST_BUTTON + btnId;\n auto btn = (PressureButton *)lookupComponent(codalId);\n if (!btn) {\n return multiplexedButtonIsPressed(btnId) ? 512 : 0;\n }\n return btn->pressureLevel();\n}\n\nstatic void sendBtnDown(Event ev) {\n Event(PXT_INTERNAL_KEY_DOWN, ev.source - DEVICE_ID_FIRST_BUTTON);\n}\n\nstatic void sendBtnUp(Event ev) {\n Event(PXT_INTERNAL_KEY_UP, ev.source - DEVICE_ID_FIRST_BUTTON);\n}\n\n//% expose\nvoid setupButton(int buttonId, int key) {\n int pin = getConfig(key);\n if (pin == -1)\n return;\n\n unsigned highflags = (unsigned)pin >> 16;\n int flags = BUTTON_ACTIVE_LOW_PULL_UP;\n if (highflags & 0xff)\n flags = highflags & 0xff;\n\n pin &= 0xffff;\n\n auto cpid = DEVICE_ID_FIRST_BUTTON + buttonId;\n auto btn = (PressureButton *)lookupComponent(cpid);\n if (btn == NULL) {\n if (registerMultiplexedButton(pin, buttonId))\n return;\n\n if (1100 <= pin && pin < 1300) {\n pin -= 1100;\n int thr = getConfig(CFG_ANALOG_BUTTON_THRESHOLD, 300);\n if (pin >= 100) {\n thr = -thr;\n pin -= 100;\n }\n btn = new AnalogButton(lookupAnalogCache(lookupPin(pin)), cpid, thr);\n } else {\n auto pull = PullMode::None;\n if ((flags & 0xf0) == 0x10)\n pull = PullMode::Down;\n else if ((flags & 0xf0) == 0x20)\n pull = PullMode::Up;\n else if ((flags & 0xf0) == 0x30)\n pull = PullMode::None;\n else\n oops(3);\n btn = new PressureButton(*lookupPin(pin), cpid, DEVICE_BUTTON_ALL_EVENTS,\n (ButtonPolarity)(flags & 0xf), pull);\n }\n EventModel::defaultEventBus->listen(btn->id, DEVICE_BUTTON_EVT_DOWN, sendBtnDown);\n EventModel::defaultEventBus->listen(btn->id, DEVICE_BUTTON_EVT_UP, sendBtnUp);\n }\n}\n\n} // namespace pxt\n\n#endif",
"controlleroverrides.ts": "namespace controller {\n //% fixedInstance whenUsed block=\"{id:controller}A\"\n export const A = new Button(ControllerButton.A, DAL.CFG_PIN_BTN_A);\n //% fixedInstance whenUsed block=\"{id:controller}B\"\n export const B = new Button(ControllerButton.B, DAL.CFG_PIN_BTN_B);\n //% fixedInstance whenUsed block=\"left\"\n export const left = new Button(ControllerButton.Left, DAL.CFG_PIN_BTN_LEFT);\n //% fixedInstance whenUsed block=\"up\"\n export const up = new Button(ControllerButton.Up, DAL.CFG_PIN_BTN_UP);\n //% fixedInstance whenUsed block=\"right\"\n export const right = new Button(ControllerButton.Right, DAL.CFG_PIN_BTN_RIGHT);\n //% fixedInstance whenUsed block=\"down\"\n export const down = new Button(ControllerButton.Down, DAL.CFG_PIN_BTN_DOWN);\n //% fixedInstance whenUsed block=\"menu\"\n export const menu = new Button(7, DAL.CFG_PIN_BTN_MENU);\n\n //% fixedInstance whenUsed block=\"player 2\"\n export const player2 = new Controller(2, undefined);\n //% fixedInstance whenUsed block=\"player 3\"\n export const player3 = new Controller(3, undefined);\n //% fixedInstance whenUsed block=\"player 4\"\n export const player4 = new Controller(4, undefined);\n //% fixedInstance whenUsed block=\"player 1\"\n export const player1 = controller._player1();\n}",
"effects.ts": "namespace effects {\n //% fixedInstances\n export class ImageEffect implements BackgroundEffect {\n\n // If used in an animation, this should be used as the default delay between method calls\n protected preferredDelay: number;\n protected effect: (image: Image, fastRandom?: Math.FastRandom) => void;\n protected fastRandom: Math.FastRandom;\n private times: number;\n\n constructor(defaultRate: number, effectFactory: (image: Image, fastRandom?: Math.FastRandom) => void) {\n this.effect = effectFactory;\n this.fastRandom = new Math.FastRandom();\n this.preferredDelay = defaultRate;\n this.times = undefined;\n }\n\n /**\n * Apply this effect to the image of the current sprite\n * @param sprite\n */\n applyTo(sprite: Sprite) {\n if (!sprite || !sprite.image) return;\n const clonedImage = sprite.image.clone();\n this.change(clonedImage)\n sprite.setImage(clonedImage);\n }\n\n /**\n * Change the given image with this effect\n * @param input \n */\n change(input: Image) {\n this.effect(input, this.fastRandom);\n }\n\n /**\n * Make this effect occur repeatedly on the background image\n * @param times number of times effect should occur\n * @param delay delay between instances of the effect\n */\n startScreenEffect(times?: number, delay?: number): void {\n if (!game.currentScene().background.hasBackgroundImage()) return;\n const wasRunning = this.times != undefined;\n this.times = times ? times : 15;\n\n if (!wasRunning) {\n control.runInParallel(() => {\n while (this.times > 0) {\n this.change(scene.backgroundImage());\n pause(delay ? delay : this.preferredDelay);\n --this.times;\n }\n this.times = undefined;\n });\n }\n }\n }\n\n //% fixedInstance whenUsed block=\"dissolve\"\n export const dissolve = new ImageEffect(100, (input: Image, r: Math.FastRandom) => {\n for (let i = (input.width * input.height) >> 5; i > 0; --i) {\n const x = r.randomRange(0, input.width)\n const y = r.randomRange(0, input.height)\n const w = r.randomRange(1, 3);\n const h = r.randomRange(1, 3);\n\n input.drawRect(x, y, w, h, 0);\n }\n });\n\n //% fixedInstance whenUsed block=\"melt\"\n export const melt = new ImageEffect(125, (input: Image, r: Math.FastRandom) => {\n const rounds = (input.width * input.height) >> 5;\n for (let j = 0; j < rounds; ++j) {\n let x = r.randomRange(0, input.width - 1)\n let y = r.randomRange(0, input.height - 3)\n let c = input.getPixel(x, y)\n input.setPixel(x, y + 1, c)\n input.setPixel(x, y + 2, c)\n }\n });\n\n //% fixedInstance whenUsed block=\"slash\"\n export const slash = new ImageEffect(125, (input: Image, r: Math.FastRandom) => {\n const rounds = 12;\n for (let j = 0; j < rounds; ++j) {\n let horizontal = r.randomBool();\n let length = r.randomRange(5, 50);\n let x = r.randomRange(0, input.width - (horizontal ? length : 1));\n let y = r.randomRange(0, input.height - (horizontal ? 3 : length));\n input.drawLine(x, y, horizontal ? x + length : x, horizontal ? y : y + length, 1);\n }\n });\n\n //% fixedInstance whenUsed block=\"splatter\"\n export const splatter = new ImageEffect(125, (input: Image, r: Math.FastRandom) => {\n const imgs: Image[] = [\n img`\n . 1 .\n 1 1 1\n . 1 1`,\n img`\n . 1 1 .\n 1 1 1 1\n . 1 1 .`,\n img`\n . 1 1 1 .\n 1 1 1 1 1\n 1 1 1 1 1\n 1 1 1 1 1\n . 1 1 1 .`,\n img`\n . . 1 1 . .\n . 1 1 1 1 .\n 1 1 1 1 1 1\n 1 1 1 1 1 1\n . 1 1 1 1 .\n . . 1 1 . .`,\n img`\n . . 1 1 1. .\n . 1 1 1 1 1 .\n 1 1 1 1 1 1 1\n 1 1 1 1 1 1 1\n 1 1 1 1 1 1 1\n . 1 1 1 1 1 .\n . . 1 1 1. .`,\n img`\n . . 1 1 1 1 . .\n . 1 1 1 1 1 1 .\n 1 1 1 1 1 1 1 1\n 1 1 1 1 1 1 1 1\n 1 1 1 1 1 1 1 1\n 1 1 1 1 1 1 1 1\n . 1 1 1 1 1 1 .\n . . 1 1 1 1 . .`,\n img`\n . . . 1 1 1 . . .\n . . 1 1 1 1 1 . .\n . 1 1 1 1 1 1 1 .\n 1 1 1 1 1 1 1 1 1\n 1 1 1 1 1 1 1 1 1\n 1 1 1 1 1 1 1 1 1\n . 1 1 1 1 1 1 1 .\n . . 1 1 1 1 1 . .\n . . . 1 1 1 . . .`,\n ];\n\n const rounds = 12;\n for (let j = 0; j < rounds; ++j) {\n const im = imgs[r.randomRange(0, imgs.length - 1)];\n const x = r.randomRange(0, input.width - im.width / 2);\n const y = r.randomRange(0, input.height - im.height / 2);\n input.drawTransparentImage(im, x, y);\n }\n });\n}",
"extendableSprite.ts": "namespace sprites {\n /**\n * A version of the Sprite class that is easier to extend.\n * \n * Unlike the normal Sprite class, this class will automatically add\n * itself to the physics engine and run all sprite created handlers\n * in the constructor\n */\n export class ExtendableSprite extends Sprite {\n protected hasCustomDimensions: boolean;\n\n constructor(spriteImage: Image, kind?: number) {\n super(spriteImage);\n\n const scene = game.currentScene();\n this.setKind(kind);\n scene.physicsEngine.addSprite(this);\n \n // run on created handlers\n scene.createdHandlers\n .filter(h => h.kind == kind)\n .forEach(h => h.handler(this));\n\n this.hasCustomDimensions = false;\n }\n\n /**\n * Override to change how the sprite is drawn to the screen\n * \n * @param drawLeft The left position to draw the sprite at (already adjusted for camera)\n * @param drawTop The top position to draw the sprite at (already adjusted for camera)\n */\n draw(drawLeft: number, drawTop: number) {\n super.drawSprite(drawLeft, drawTop);\n }\n\n /**\n * Override to add update logic for a sprite. This method runs once per frame\n * \n * @param deltaTimeMillis The time that has elapsed since the last frame in milliseconds\n */\n update(deltaTimeMillis: number) {\n }\n\n /**\n * Sets the width and height of this sprite. Once set, this will also prevent\n * this width and height from automatically changing whenever scale or the image\n * changes\n */\n setDimensions(width: number, height: number) {\n this._width = Fx8(width);\n this._height = Fx8(height);\n this.hasCustomDimensions = true;\n this.resetHitbox();\n }\n \n __update(camera: scene.Camera, dt: number) {\n super.__update(camera, dt);\n this.update(game.currentScene().eventContext.deltaTimeMillis)\n }\n\n setHitbox() {\n if (this.hasCustomDimensions) {\n this._hitbox = new game.Hitbox(this, this._width, this._height, Fx.zeroFx8, Fx.zeroFx8)\n }\n else {\n super.setHitbox();\n }\n }\n\n protected drawSprite(drawLeft: number, drawTop: number): void {\n this.draw(drawLeft, drawTop);\n }\n\n protected recalcSize() {\n if (this.hasCustomDimensions) return;\n super.recalcSize();\n }\n }\n}",
"fieldeditors.ts": "namespace __internal {\n\n /**\n * A speed picker\n * @param speed the speed, eg: 50\n */\n //% blockId=spriteSpeedPicker block=\"%speed\" shim=TD_ID\n //% speed.fieldEditor=\"speed\" colorSecondary=\"#FFFFFF\"\n //% weight=0 blockHidden=1 \n //% speed.fieldOptions.decompileLiterals=1\n //% speed.fieldOptions.format=\"{0}pix/s\"\n export function __spriteSpeedPicker(speed: number): number {\n return speed;\n }\n\n /**\n * A sprite acceleration picker\n * @param acceleration the acceleration in pixel/sec^2\n */\n //% blockId=spriteAccPicker block=\"%acceleration\" shim=TD_ID\n //% speed.fieldEditor=\"speed\" colorSecondary=\"#FFFFFF\"\n //% weight=0 blockHidden=1 \n //% speed.fieldOptions.decompileLiterals=1\n //% speed.fieldOptions.format=\"{0}pix/s²\"\n export function __accSpeedPicker(acceleration: number): number {\n return acceleration;\n }\n}",
"game.ts": "/**\n * Game transitions and dialog\n **/\n//% color=#8854d0 weight=97 icon=\"\\uf111\"\n//% groups='[\"Gameplay\", \"Prompt\"]'\nnamespace game {\n /**\n * Determines if diagnostics are shown\n */\n export let debug = false;\n export let stats = false;\n export let winEffect: effects.BackgroundEffect = undefined;\n export let loseEffect: effects.BackgroundEffect = undefined;\n let loseSound: music.Melody = undefined;\n let winSound: music.Melody = undefined;\n\n let _scene: scene.Scene;\n let _sceneStack: scene.Scene[];\n\n let _scenePushHandlers: ((scene: scene.Scene) => void)[];\n let _scenePopHandlers: ((scene: scene.Scene) => void)[];\n\n export function currentScene(): scene.Scene {\n init();\n return _scene;\n }\n\n let __waitAnyButton: () => void;\n let __gameOverHandler: (win: boolean) => void;\n let __isOver = false;\n\n export function setWaitAnyButton(f: () => void) {\n __waitAnyButton = f\n }\n\n export function waitAnyButton() {\n if (__waitAnyButton) __waitAnyButton()\n else pause(3000)\n }\n\n export function eventContext(): control.EventContext {\n init();\n return _scene.eventContext;\n }\n\n function init(forceNewScene ?: boolean) {\n if (!_scene || forceNewScene) {\n _scene = new scene.Scene(control.pushEventContext(), _scene);\n }\n _scene.init();\n\n if (!winEffect)\n winEffect = effects.confetti;\n if (!loseEffect)\n loseEffect = effects.melt;\n\n if (!winSound)\n winSound = music.powerUp;\n if (!loseSound)\n loseSound = music.wawawawaa;\n }\n\n export function pushScene() {\n const oldScene = game.currentScene()\n particles.clearAll();\n particles.disableAll();\n if (!_sceneStack) _sceneStack = [];\n _sceneStack.push(_scene);\n init(/** forceNewScene **/ true);\n\n if (_scenePushHandlers) {\n _scenePushHandlers.forEach(cb => cb(oldScene));\n }\n }\n\n export function popScene() {\n const oldScene = game.currentScene()\n if (_sceneStack && _sceneStack.length) {\n // pop scenes from the stack\n _scene = _sceneStack.pop();\n control.popEventContext();\n } else if (_scene) {\n // post last scene\n control.popEventContext();\n _scene = undefined;\n }\n\n if (_scene)\n particles.enableAll();\n\n if (_scenePopHandlers) {\n _scenePopHandlers.forEach(cb => cb(oldScene));\n }\n }\n\n function showDialogBackground(h: number, c: number) {\n const top = (screen.height - h) >> 1;\n screen.fillRect(0, top, screen.width, h, 0)\n screen.drawLine(0, top, screen.width, top, 1)\n screen.drawLine(0, top + h - 1, screen.width, top + h - 1, 1)\n\n return top;\n }\n\n export function showDialog(title: string, subtitle: string, footer?: string) {\n init();\n const titleFont = image.getFontForText(title || \"\");\n const subFont = image.getFontForText(subtitle || \"\")\n const footerFont = image.getFontForText(footer || \"\");\n let h = 8;\n if (title)\n h += titleFont.charHeight;\n if (subtitle)\n h += 2 + subFont.charHeight\n h += 8;\n const top = showDialogBackground(h, 9)\n let y = top + 8;\n if (title) {\n screen.print(title, 8, y, screen.isMono ? 1 : 7, titleFont);\n y += titleFont.charHeight + 2;\n }\n if (subtitle) {\n screen.print(subtitle, 8, y, screen.isMono ? 1 : 6, subFont);\n y += subFont.charHeight + 2;\n }\n if (footer) {\n const footerTop = screen.height - footerFont.charHeight - 4;\n screen.fillRect(0, footerTop, screen.width, footerFont.charHeight + 4, 0);\n screen.drawLine(0, footerTop, screen.width, footerTop, 1);\n screen.print(\n footer,\n screen.width - footer.length * footerFont.charWidth - 8,\n screen.height - footerFont.charHeight - 2,\n 1,\n footerFont\n )\n }\n }\n\n /**\n * Set the effect that occurs when the game is over\n * @param win whether the animation should run on a win (true)\n * @param effect\n */\n export function setGameOverEffect(win: boolean, effect: effects.BackgroundEffect) {\n init();\n if (!effect) return;\n if (win)\n winEffect = effect;\n else\n loseEffect = effect;\n }\n\n /**\n * Set the music that occurs when the player wins\n * @param win\n * @param effect\n */\n export function setGameOverSound(win: boolean, sound: music.Melody) {\n init();\n if (!sound) return;\n if (win)\n winSound = sound;\n else\n loseSound = sound;\n }\n /**\n * Set the function to call on game over. The 'win' boolean is\n * passed to the handler.\n * @param handler\n */\n export function onGameOver(handler: (win: boolean) => void) {\n __gameOverHandler = handler;\n }\n\n /**\n * Finish the game and display the score\n */\n //% group=\"Gameplay\"\n //% blockId=gameOver block=\"game over %win=toggleWinLose || with %effect effect\"\n //% weight=80 help=game/over\n export function over(win: boolean = false, effect?: effects.BackgroundEffect) {\n init();\n if (__isOver) return;\n __isOver = true;\n\n if (__gameOverHandler) {\n __gameOverHandler(win);\n } else {\n if (!effect) {\n effect = win ? winEffect : loseEffect;\n }\n\n // Save all scores as relevant to the game.\n info.saveAllScores();\n\n // collect the scores before poping the scenes\n const scoreInfo = info.player1.getState();\n const highScore = info.highScore();\n if (scoreInfo.score > highScore)\n info.saveHighScore();\n\n // releasing memory and clear fibers. Do not add anything that releases the fiber until background is set below,\n // or screen will be cleared on the new frame and will not appear as background in the game over screen.\n while (_sceneStack && _sceneStack.length) {\n _scene.destroy();\n popScene();\n }\n pushScene();\n scene.setBackgroundImage(screen.clone());\n\n if (win)\n winSound.play();\n else\n loseSound.play();\n\n effect.startScreenEffect();\n\n pause(400);\n\n const overDialog = new GameOverDialog(win, scoreInfo.score, highScore);\n scene.createRenderable(scene.HUD_Z, target => {\n overDialog.update();\n target.drawTransparentImage(\n overDialog.image,\n 0,\n (screen.height - overDialog.image.height) >> 1\n );\n });\n\n pause(500); // wait for users to stop pressing keys\n overDialog.displayCursor();\n waitAnyButton();\n control.reset();\n }\n }\n\n\n // Indicates whether the fiber needs to be created\n let foreverRunning = false;\n\n /**\n * Repeats the code forever in the background for this scene.\n * On each iteration, allows other codes to run.\n * @param body code to execute\n */\n export function forever(action: () => void): void {\n if (!foreverRunning) {\n foreverRunning = true;\n control.runInParallel(() => {\n while (1) {\n const handlers = game.currentScene().gameForeverHandlers;\n handlers.forEach(h => {\n if (!h.lock) {\n h.lock = true;\n control.runInParallel(() => {\n h.handler();\n h.lock = false;\n });\n }\n });\n pause(20);\n }\n });\n }\n\n game.currentScene().gameForeverHandlers.push(\n new scene.GameForeverHandler(action)\n );\n }\n\n /**\n * Draw on screen before sprites, after background\n * @param body code to execute\n */\n //% group=\"Gameplay\"\n //% help=game/paint weight=10 afterOnStart=true\n export function onPaint(a: () => void): void {\n init();\n if (!a) return;\n scene.createRenderable(scene.ON_PAINT_Z, a);\n }\n\n /**\n * Draw on screen after sprites\n * @param body code to execute\n */\n //% group=\"Gameplay\"\n //% help=game/shade weight=10 afterOnStart=true\n export function onShade(a: () => void): void {\n init();\n if (!a) return;\n scene.createRenderable(scene.ON_SHADE_Z, a);\n }\n\n\n /**\n * Register a handler that runs whenever a scene is pushed onto the scene\n * stack. Useful for extensions that need to store/restore state as the\n * event context changes. The handler is run AFTER the push operation (i.e.\n * after game.currentScene() has changed)\n *\n * @param handler Code to run when a scene is pushed onto the stack\n */\n export function addScenePushHandler(handler: (oldScene: scene.Scene) => void) {\n if (!_scenePushHandlers) _scenePushHandlers = [];\n if (_scenePushHandlers.indexOf(handler) < 0)\n _scenePushHandlers.push(handler);\n }\n\n /**\n * Remove a scene push handler. Useful for extensions that need to store/restore state as the\n * event context changes.\n *\n * @param handler The handler to remove\n */\n export function removeScenePushHandler(handler: (oldScene: scene.Scene) => void) {\n if (_scenePushHandlers) _scenePushHandlers.removeElement(handler);\n }\n\n /**\n * Register a handler that runs whenever a scene is popped off of the scene\n * stack. Useful for extensions that need to store/restore state as the\n * event context changes. The handler is run AFTER the pop operation. (i.e.\n * after game.currentScene() has changed)\n *\n * @param handler Code to run when a scene is removed from the top of the stack\n */\n export function addScenePopHandler(handler: (oldScene: scene.Scene) => void) {\n if (!_scenePopHandlers) _scenePopHandlers = [];\n if (_scenePopHandlers.indexOf(handler) < 0)\n _scenePopHandlers.push(handler);\n }\n\n /**\n * Remove a scene pop handler. Useful for extensions that need to store/restore state as the\n * event context changes.\n *\n * @param handler The handler to remove\n */\n export function removeScenePopHandler(handler: (oldScene: scene.Scene) => void) {\n if (_scenePopHandlers) _scenePopHandlers.removeElement(handler);\n }\n}\n",
"gameoverrides.ts": "// override in targets",
"gameutil.ts": "/**\n * Game transitions and dialog\n **/\n//% color=#8854d0 weight=97 icon=\"\\uf111\"\n//% groups='[\"Gameplay\", \"Prompt\"]'\nnamespace game {\n\n /**\n * Update the position and velocities of sprites\n * @param body code to execute\n */\n //% group=\"Gameplay\"\n //% help=game/on-update weight=100 afterOnStart=true\n //% blockId=gameupdate block=\"on game update\"\n //% blockAllowMultiple=1\n export function onUpdate(a: () => void): void {\n if (!a) return;\n game.eventContext().registerFrameHandler(scene.UPDATE_PRIORITY, a);\n }\n\n /**\n * Run code on an interval of time. This executes before game.onUpdate()\n * @param body code to execute\n */\n //% group=\"Gameplay\"\n //% help=game/on-update-interval weight=99 afterOnStart=true\n //% blockId=gameinterval block=\"on game update every %period=timePicker ms\"\n //% blockAllowMultiple=1\n export function onUpdateInterval(period: number, a: () => void): void {\n if (!a || period < 0) return;\n let timer = 0;\n game.eventContext().registerFrameHandler(scene.UPDATE_INTERVAL_PRIORITY, () => {\n const time = game.currentScene().millis();\n if (timer <= time) {\n timer = time + period;\n a();\n }\n });\n }\n\n /**\n * Returns the time since the game started in milliseconds\n */\n //% blockId=arcade_game_runtime block=\"time since start (ms)\"\n //% group=\"Gameplay\" weight=11\n //% help=game/runtime\n export function runtime(): number {\n return currentScene().millis();\n }\n}\n",
"hitbox.ts": "namespace game {\n export class Hitbox {\n hash: Fx8;\n parent: Sprite;\n ox: Fx8;\n oy: Fx8;\n width: Fx8;\n height: Fx8;\n\n constructor(parent: Sprite, width: Fx8, height: Fx8, ox: Fx8, oy: Fx8) {\n this.hash = parent.calcDimensionalHash();\n this.parent = parent;\n this.width = width;\n this.height = height;\n this.ox = ox;\n this.oy = oy;\n }\n\n get left() {\n return Fx.add(this.ox, this.parent._x);\n }\n\n get top() {\n return Fx.add(this.oy, this.parent._y);\n }\n\n get right() {\n return Fx.sub(\n Fx.add(this.width, this.left),\n Fx.oneFx8\n );\n }\n\n get bottom() {\n return Fx.sub(\n Fx.add(this.height, this.top),\n Fx.oneFx8\n );\n }\n\n isValid() {\n return this.hash === this.parent.calcDimensionalHash();\n }\n\n contains(x: Fx8, y: Fx8): boolean {\n return (x >= this.left) && (x <= this.right) && (y >= this.top) && (y <= this.bottom);\n }\n\n overlapsWith(other: Hitbox): boolean {\n if (this.contains(other.left, other.top)) return true;\n if (this.contains(other.left, other.bottom)) return true;\n if (this.contains(other.right, other.top)) return true;\n if (this.contains(other.right, other.bottom)) return true;\n if (other.contains(this.left, this.top)) return true;\n if (other.contains(this.left, this.bottom)) return true;\n if (other.contains(this.right, this.top)) return true;\n if (other.contains(this.right, this.bottom)) return true;\n return false;\n }\n }\n\n\n export function calculateHitBox(s: Sprite): Hitbox {\n if (s._hitbox && s._hitbox.isValid())\n return s._hitbox;\n\n const i = s.image;\n let minX = Fx8(i.width);\n let minY = Fx8(i.height);\n let maxX = Fx.zeroFx8;\n let maxY = Fx.zeroFx8;\n\n for (let c = 0, fxc = Fx.zeroFx8; c < i.width; c++, fxc = Fx.add(fxc, Fx.oneFx8)) {\n for (let r = 0, fxr = Fx.zeroFx8; r < i.height; r++, fxr = Fx.add(fxr, Fx.oneFx8)) {\n if (i.getPixel(c, r)) {\n minX = Fx.min(minX, fxc);\n minY = Fx.min(minY, fxr);\n maxX = Fx.max(maxX, fxc);\n maxY = Fx.max(maxY, fxr);\n }\n }\n }\n\n minX = Fx.mul(minX, s._sx);\n minY = Fx.mul(minY, s._sy);\n maxX = Fx.mul(maxX, s._sx);\n maxY = Fx.mul(maxY, s._sy);\n const width = Fx.add(Fx.sub(maxX, minX), s._sx);\n const height = Fx.add(Fx.sub(maxY, minY), s._sy);\n\n return new Hitbox(s, width, height, Fx.floor(minX), Fx.floor(minY));\n }\n}",
"info.ts": "\n/**\n * Head-up display\n *\n*/\n//% color=#cf6a87 weight=80 icon=\"\\uf2bb\" blockGap=8\n//% groups='[\"Score\", \"Life\", \"Countdown\", \"Multiplayer\"]'\n//% blockGap=8\nnamespace info {\n\n export enum Visibility {\n None = 0,\n Countdown = 1 << 0,\n Score = 1 << 1,\n Life = 1 << 2,\n Hud = 1 << 3,\n Multi = 1 << 4,\n UserHeartImage = 1 << 5,\n _ExplicitlySetScore = 1 << 6,\n _ExplicitlySetLife = 1 << 7,\n }\n\n export class PlayerState {\n public score: number;\n // undefined: not used\n // null: reached 0 and callback was invoked\n public life: number;\n public lifeZeroHandler: () => void;\n\n constructor() { }\n }\n\n class InfoState {\n public playerStates: PlayerState[];\n public visibilityFlag: number;\n\n public gameEnd: number;\n public heartImage: Image;\n public multiplierImage: Image;\n public bgColor: number;\n public borderColor: number;\n public fontColor: number;\n public countdownExpired: boolean;\n public countdownEndHandler: () => void;\n\n constructor() {\n this.visibilityFlag = Visibility.Hud;\n this.playerStates = [];\n this.heartImage = defaultHeartImage();\n this.multiplierImage = img`\n 1 . . . 1\n . 1 . 1 .\n . . 1 . .\n . 1 . 1 .\n 1 . . . 1\n `;\n this.bgColor = screen.isMono ? 0 : 1;\n this.borderColor = screen.isMono ? 1 : 3;\n this.fontColor = screen.isMono ? 1 : 3;\n this.countdownExpired = undefined;\n this.countdownEndHandler = undefined;\n this.gameEnd = undefined;\n this.playerStates = [];\n }\n }\n\n let infoState: InfoState = undefined;\n\n let players: PlayerInfo[];\n\n let infoStateStack: {\n state: InfoState,\n scene: scene.Scene\n }[];\n\n game.addScenePushHandler(oldScene => {\n if (infoState) {\n if (!infoStateStack) infoStateStack = [];\n infoStateStack.push({\n state: infoState,\n scene: oldScene\n });\n infoState = undefined;\n }\n });\n\n game.addScenePopHandler(() => {\n const scene = game.currentScene();\n infoState = undefined;\n if (infoStateStack && infoStateStack.length) {\n const nextState = infoStateStack.pop();\n if (nextState.scene == scene) {\n infoState = nextState.state;\n } else {\n infoStateStack.push(nextState);\n }\n }\n });\n\n function initHUD() {\n if (infoState) return;\n\n infoState = new InfoState();\n\n scene.createRenderable(\n scene.HUD_Z,\n () => {\n if (!infoState) return;\n control.enablePerfCounter(\"info\")\n // show score, lifes\n if (infoState.visibilityFlag & Visibility.Multi) {\n const ps = players.filter(p => !!p);\n // First draw players\n ps.forEach(p => p.drawPlayer());\n // Then run life over events\n ps.forEach(p => p.raiseLifeZero(false));\n } else { // single player\n // show score\n const p = player1;\n if (p.hasScore() && (infoState.visibilityFlag & Visibility.Score)) {\n p.drawScore();\n }\n // show life\n if (p.hasLife() && (infoState.visibilityFlag & Visibility.Life)) {\n p.drawLives();\n }\n p.raiseLifeZero(true);\n }\n // show countdown in both modes\n if (infoState.gameEnd !== undefined && infoState.visibilityFlag & Visibility.Countdown) {\n const scene = game.currentScene();\n const elapsed = infoState.gameEnd - scene.millis();\n drawTimer(elapsed);\n let t = elapsed / 1000;\n if (t <= 0) {\n t = 0;\n if (!infoState.countdownExpired) {\n infoState.countdownExpired = true;\n infoState.gameEnd = undefined;\n if (infoState.countdownEndHandler) {\n infoState.countdownEndHandler();\n } else {\n game.over();\n }\n }\n }\n }\n }\n );\n }\n\n function initMultiHUD() {\n if (infoState.visibilityFlag & Visibility.Multi) return;\n\n infoState.visibilityFlag |= Visibility.Multi;\n if (!(infoState.visibilityFlag & Visibility.UserHeartImage))\n infoState.heartImage = defaultMultiplayerHeartImage();\n infoState.multiplierImage = img`\n 1 . 1\n . 1 .\n 1 . 1\n `;\n }\n\n function defaultHeartImage() {\n return screen.isMono ?\n img`\n . 1 1 . 1 1 . .\n 1 . . 1 . . 1 .\n 1 . . . . . 1 .\n 1 . . . . . 1 .\n . 1 . . . 1 . .\n . . 1 . 1 . . .\n . . . 1 . . . .\n `\n :\n img`\n . c 2 2 . 2 2 .\n c 2 2 2 2 2 4 2\n c 2 2 2 2 4 2 2\n c 2 2 2 2 2 2 2\n . c 2 2 2 2 2 .\n . . c 2 2 2 . .\n . . . c 2 . . .\n `;\n }\n\n function defaultMultiplayerHeartImage() {\n return screen.isMono ?\n img`\n . . 1 . 1 . .\n . 1 . 1 . 1 .\n . 1 . . . 1 .\n . . 1 . 1 . .\n . . . 1 . . .\n `\n :\n img`\n . . 1 . 1 . .\n . 1 2 1 4 1 .\n . 1 2 4 2 1 .\n . . 1 2 1 . .\n . . . 1 . . .\n `;\n }\n\n export function saveAllScores() {\n const allScoresKey = \"all-scores\";\n let allScores: number[];\n if (players) {\n allScores = players.filter(item => item.hasScore()).map(item => item.score());\n }\n else {\n allScores = [];\n }\n\n settings.writeJSON(allScoresKey, allScores);\n }\n\n export function saveHighScore() {\n if (players) {\n let hs = 0;\n players\n .filter(p => p && p.hasScore())\n .forEach(p => hs = Math.max(hs, p.score()));\n const curr = settings.readNumber(\"high-score\")\n if (curr == null || hs > curr)\n settings.writeNumber(\"high-score\", hs);\n }\n }\n\n /**\n * Get the current score if any\n */\n //% weight=95 blockGap=8\n //% blockId=hudScore block=\"score\"\n //% help=info/score\n //% group=\"Score\"\n export function score() {\n return player1.score();\n }\n\n //%\n //% group=\"Score\"\n export function hasScore() {\n return player1.hasScore();\n }\n\n /**\n * Get the last recorded high score\n */\n //% weight=94\n //% blockId=highScore block=\"high score\"\n //% help=info/high-score\n //% group=\"Score\"\n export function highScore(): number {\n return settings.readNumber(\"high-score\") || 0;\n }\n\n /**\n * Set the score\n */\n //% weight=93 blockGap=8\n //% blockId=hudsetScore block=\"set score to %value\"\n //% help=info/set-score\n //% group=\"Score\"\n export function setScore(value: number) {\n player1.setScore(value);\n }\n\n /**\n * Change the score by the given amount\n * @param value the amount of change, eg: 1\n */\n //% weight=92\n //% blockId=hudChangeScoreBy block=\"change score by %value\"\n //% help=info/change-score-by\n //% group=\"Score\"\n export function changeScoreBy(value: number) {\n player1.changeScoreBy(value);\n }\n\n /**\n * Get the number of lives\n */\n //% weight=85 blockGap=8\n //% blockId=hudLife block=\"life\"\n //% help=info/life\n //% group=\"Life\"\n export function life() {\n return player1.life();\n }\n\n //% group=\"Life\"\n export function hasLife() {\n return player1.hasLife();\n }\n\n /**\n * Set the number of lives\n * @param value the number of lives, eg: 3\n */\n //% weight=84 blockGap=8\n //% blockId=hudSetLife block=\"set life to %value\"\n //% help=info/set-life\n //% group=\"Life\"\n export function setLife(value: number) {\n player1.setLife(value);\n }\n\n /**\n * Change the lives by the given amount\n * @param value the change of lives, eg: -1\n */\n //% weight=83\n //% blockId=hudChangeLifeBy block=\"change life by %value\"\n //% help=info/change-life-by\n //% group=\"Life\"\n export function changeLifeBy(value: number) {\n player1.changeLifeBy(value);\n }\n\n /**\n * Run code when the player's life reaches 0. If this function\n * is not called then game.over() is called instead\n */\n //% weight=82\n //% blockId=gamelifeevent block=\"on life zero\"\n //% help=info/on-life-zero\n //% group=\"Life\"\n export function onLifeZero(handler: () => void) {\n player1.onLifeZero(handler);\n }\n\n /**\n * Start a countdown of the given duration in seconds\n * @param duration the duration of the countdown, eg: 10\n */\n //% blockId=gamecountdown block=\"start countdown %duration (s)\"\n //% help=info/start-countdown weight=79 blockGap=8\n //% group=\"Countdown\"\n export function startCountdown(duration: number) {\n updateFlag(Visibility.Countdown, true);\n infoState.gameEnd = game.currentScene().millis() + duration * 1000;\n infoState.countdownExpired = false;\n }\n\n /**\n * Stop the current countdown and hides the timer display\n */\n //% blockId=gamestopcountdown block=\"stop countdown\" weight=78\n //% help=info/stop-countdown\n //% group=\"Countdown\"\n export function stopCountdown() {\n updateFlag(Visibility.Countdown, false);\n infoState.gameEnd = undefined;\n infoState.countdownExpired = true;\n }\n\n /**\n * Run code when the countdown reaches 0. If this function\n * is not called then game.over() is called instead\n */\n //% blockId=gamecountdownevent block=\"on countdown end\" weight=77\n //% help=info/on-countdown-end\n //% group=\"Countdown\"\n export function onCountdownEnd(handler: () => void) {\n initHUD();\n infoState.countdownEndHandler = handler;\n }\n\n /**\n * Replaces the image used to represent the player's lives. Images\n * should be no larger than 8x8\n */\n //% group=\"Life\"\n export function setLifeImage(image: Image) {\n updateFlag(Visibility.UserHeartImage, true);\n infoState.heartImage = image;\n }\n\n /**\n * Set whether life should be displayed\n * @param on if true, lives are shown; otherwise, lives are hidden\n */\n //% group=\"Life\"\n export function showLife(on: boolean) {\n updateFlag(Visibility.Life, on);\n updateFlag(Visibility._ExplicitlySetLife, true);\n }\n\n /**\n * Set whether score should be displayed\n * @param on if true, score is shown; otherwise, score is hidden\n */\n //% group=\"Score\"\n export function showScore(on: boolean) {\n updateFlag(Visibility.Score, on);\n updateFlag(Visibility._ExplicitlySetScore, true);\n }\n\n /**\n * Set whether countdown should be displayed\n * @param on if true, countdown is shown; otherwise, countdown is hidden\n */\n //% group=\"Countdown\"\n export function showCountdown(on: boolean) {\n updateFlag(Visibility.Countdown, on);\n }\n\n function updateFlag(flag: Visibility, on: boolean) {\n initHUD();\n if (on) infoState.visibilityFlag |= flag;\n else infoState.visibilityFlag = ~(~infoState.visibilityFlag | flag);\n }\n\n /**\n * Sets the color of the borders around the score, countdown, and life\n * elements. Defaults to 3\n * @param color The index of the color (0-15)\n */\n //% group=\"Theme\"\n export function setBorderColor(color: number) {\n initHUD();\n infoState.borderColor = Math.min(Math.max(color, 0), 15) | 0;\n }\n\n /**\n * Sets the color of the background of the score, countdown, and life\n * elements. Defaults to 1\n * @param color The index of the color (0-15)\n */\n //% group=\"Theme\"\n export function setBackgroundColor(color: number) {\n initHUD();\n infoState.bgColor = Math.min(Math.max(color, 0), 15) | 0;\n }\n\n /**\n * Sets the color of the text used in the score, countdown, and life\n * elements. Defaults to 3\n * @param color The index of the color (0-15)\n */\n //% group=\"Theme\"\n export function setFontColor(color: number) {\n initHUD();\n infoState.fontColor = Math.min(Math.max(color, 0), 15) | 0;\n }\n\n /**\n * Get the current color of the borders around the score, countdown, and life\n * elements\n */\n //% group=\"Theme\"\n export function borderColor(): number {\n initHUD();\n return infoState.borderColor ? infoState.borderColor : 3;\n }\n\n /**\n * Get the current color of the background of the score, countdown, and life\n * elements\n */\n //% group=\"Theme\"\n export function backgroundColor(): number {\n initHUD();\n return infoState.bgColor ? infoState.bgColor : 1;\n }\n\n /**\n * Get the current color of the text usded in the score, countdown, and life\n * elements\n */\n //% group=\"Theme\"\n export function fontColor(): number {\n initHUD();\n return infoState.fontColor ? infoState.fontColor : 3;\n }\n\n function drawTimer(millis: number) {\n if (millis < 0) millis = 0;\n millis |= 0;\n\n const font = image.font8;\n const smallFont = image.font5;\n const seconds = Math.idiv(millis, 1000);\n const width = font.charWidth * 5 - 2;\n let left = (screen.width >> 1) - (width >> 1) + 1;\n let color1 = infoState.fontColor;\n let color2 = infoState.bgColor;\n\n if (seconds < 10 && (seconds & 1) && !screen.isMono) {\n const temp = color1;\n color1 = color2;\n color2 = temp;\n }\n\n screen.fillRect(left - 3, 0, width + 6, font.charHeight + 3, infoState.borderColor)\n screen.fillRect(left - 2, 0, width + 4, font.charHeight + 2, color2)\n\n\n if (seconds < 60) {\n const top = 1;\n const remainder = Math.idiv(millis % 1000, 10);\n\n screen.print(formatDecimal(seconds) + \".\", left, top, color1, font)\n const decimalLeft = left + 3 * font.charWidth;\n screen.print(formatDecimal(remainder), decimalLeft, top + 2, color1, smallFont)\n }\n else {\n const minutes = Math.idiv(seconds, 60);\n const remainder = seconds % 60;\n screen.print(formatDecimal(minutes) + \":\" + formatDecimal(remainder), left, 1, color1, font);\n }\n }\n\n //% fixedInstances\n //% blockGap=8\n export class PlayerInfo {\n protected _player: number;\n public bg: number; // background color\n public border: number; // border color\n public fc: number; // font color\n public showScore?: boolean;\n public showLife?: boolean;\n public visibility: Visibility;\n public showPlayer?: boolean;\n public x?: number;\n public y?: number;\n public left?: boolean; // if true banner goes from x to the left, else goes rightward\n public up?: boolean; // if true banner goes from y up, else goes downward\n\n constructor(player: number) {\n this._player = player;\n this.border = 1;\n this.fc = 1;\n this.visibility = Visibility.None;\n this.showScore = undefined;\n this.showLife = undefined;\n this.showPlayer = undefined;\n this.left = undefined;\n this.up = undefined;\n if (this._player === 1) {\n // Top left, and banner is white on red\n this.bg = screen.isMono ? 0 : 2;\n this.x = 0;\n this.y = 0;\n } else if (player === 2) {\n // Top right, and banner is white on blue\n this.bg = screen.isMono ? 0 : 8;\n this.x = screen.width;\n this.y = 0;\n this.left = true;\n } else if (player === 3) {\n this.bg = screen.isMono ? 0 : 4;\n this.x = 0;\n this.y = screen.height;\n this.up = true;\n } else {\n // bottom left, banner is white on green\n this.bg = screen.isMono ? 0 : 7;\n this.x = screen.width;\n this.y = screen.height;\n this.left = true;\n this.up = true;\n }\n\n if (!players) players = [];\n players[this._player - 1] = this;\n }\n\n private init() {\n initHUD();\n if (this._player > 1) initMultiHUD();\n if (!infoState.playerStates[this._player - 1]) {\n infoState.playerStates[this._player - 1] = new PlayerState();\n }\n }\n\n getState(): PlayerState {\n this.init();\n return infoState.playerStates[this._player - 1];\n }\n\n // the id numbera of the player\n id(): number {\n return this._player;\n }\n\n /**\n * Get the player score\n */\n //% group=\"Multiplayer\"\n //% blockId=piscore block=\"%player score\"\n //% help=info/score\n score(): number {\n if (this.showScore === undefined) this.showScore = true;\n if (this.showPlayer === undefined) this.showPlayer = true;\n\n const state = this.getState();\n\n if (state.score == null)\n state.score = 0;\n return state.score;\n }\n\n /**\n * Set the player score\n */\n //% group=\"Multiplayer\"\n //% blockId=pisetscore block=\"set %player score to %value\"\n //% value.defl=0\n //% help=info/set-score\n setScore(value: number) {\n const state = this.getState();\n if (!(infoState.visibilityFlag & Visibility._ExplicitlySetScore)) {\n updateFlag(Visibility.Score, true);\n }\n\n this.score(); // invoked for side effects\n state.score = (value | 0);\n }\n\n /**\n * Change the score of a player\n * @param value\n */\n //% group=\"Multiplayer\"\n //% blockId=pichangescore block=\"change %player score by %value\"\n //% value.defl=1\n //% help=info/change-score-by\n changeScoreBy(value: number): void {\n this.setScore(this.score() + value);\n }\n\n hasScore() {\n const state = this.getState();\n return state.score !== undefined;\n }\n\n /**\n * Get the player life\n */\n //% group=\"Multiplayer\"\n //% blockid=piflife block=\"%player life\"\n //% help=info/life\n life(): number {\n const state = this.getState();\n if (this.showLife === undefined) this.showLife = true;\n if (this.showPlayer === undefined) this.showPlayer = true;\n\n if (state.life === undefined) {\n state.life = 3;\n }\n return state.life || 0;\n }\n\n /**\n * Set the player life\n */\n //% group=\"Multiplayer\"\n //% blockId=pisetlife block=\"set %player life to %value\"\n //% value.defl=3\n //% help=info/set-life\n setLife(value: number): void {\n const state = this.getState();\n if (!(infoState.visibilityFlag & Visibility._ExplicitlySetLife)) {\n updateFlag(Visibility.Life, true);\n }\n\n this.life(); // invoked for side effects\n state.life = (value | 0);\n }\n\n /**\n * Change the life of a player\n * @param value\n */\n //% group=\"Multiplayer\"\n //% blockId=pichangelife block=\"change %player life by %value\"\n //% value.defl=-1\n //% help=info/change-life-by\n changeLifeBy(value: number): void {\n this.setLife(this.life() + value);\n }\n\n /**\n * Return true if the given player currently has a value set for health,\n * and false otherwise.\n * @param player player to check life of\n */\n //% group=\"Multiplayer\"\n //% blockId=pihaslife block=\"%player has life\"\n //% help=info/has-life\n hasLife(): boolean {\n const state = this.getState();\n return state.life !== undefined && state.life !== null;\n }\n\n /**\n * Runs code when life reaches zero\n * @param handler\n */\n //% group=\"Multiplayer\"\n //% blockId=playerinfoonlifezero block=\"on %player life zero\"\n //% help=info/on-life-zero\n onLifeZero(handler: () => void) {\n const state = this.getState();\n state.lifeZeroHandler = handler;\n }\n\n raiseLifeZero(gameOver: boolean) {\n const state = this.getState();\n if (state.life !== null && state.life <= 0) {\n state.life = null;\n if (state.lifeZeroHandler) {\n state.lifeZeroHandler();\n } else if (gameOver) {\n game.over();\n }\n }\n }\n\n drawPlayer() {\n const state = this.getState();\n\n const font = image.font5;\n let score: string;\n let life: string;\n let height = 4;\n let scoreWidth = 0;\n let lifeWidth = 0;\n const offsetX = 1;\n let offsetY = 2;\n let showScore = this.showScore && state.score !== undefined;\n let showLife = this.showLife && state.life !== undefined;\n\n if (showScore) {\n score = \"\" + state.score;\n scoreWidth = score.length * font.charWidth + 3;\n height += font.charHeight;\n offsetY += font.charHeight + 1;\n }\n\n if (showLife) {\n life = \"\" + (state.life || 0);\n lifeWidth = infoState.heartImage.width + infoState.multiplierImage.width + life.length * font.charWidth + 3;\n height += infoState.heartImage.height;\n }\n\n const width = Math.max(scoreWidth, lifeWidth);\n\n // bump size for space between lines\n if (showScore && showLife) height++;\n\n const x = this.x - (this.left ? width : 0);\n const y = this.y - (this.up ? height : 0);\n\n // Bordered Box\n if (showScore || showLife) {\n screen.fillRect(x, y, width, height, this.border);\n screen.fillRect(x + 1, y + 1, width - 2, height - 2, this.bg);\n }\n\n // print score\n if (showScore) {\n const bump = this.left ? width - scoreWidth : 0;\n screen.print(score, x + offsetX + bump + 1, y + 2, this.fc, font);\n }\n\n // print life\n if (showLife) {\n const xLoc = x + offsetX + (this.left ? width - lifeWidth : 0);\n\n let mult = infoState.multiplierImage.clone();\n mult.replace(1, this.fc);\n\n screen.drawTransparentImage(\n infoState.heartImage,\n xLoc,\n y + offsetY\n );\n screen.drawTransparentImage(\n mult,\n xLoc + infoState.heartImage.width,\n y + offsetY + font.charHeight - infoState.multiplierImage.height - 1\n );\n screen.print(\n life,\n xLoc + infoState.heartImage.width + infoState.multiplierImage.width + 1,\n y + offsetY,\n this.fc,\n font\n );\n }\n\n // print player icon\n if (this.showPlayer) {\n const pNum = \"\" + this._player;\n\n let iconWidth = pNum.length * font.charWidth + 1;\n const iconHeight = Math.max(height, font.charHeight + 2);\n let iconX = this.left ? (x - iconWidth + 1) : (x + width - 1);\n let iconY = y;\n\n // adjustments when only player icon shown\n if (!showScore && !showLife) {\n iconX += this.left ? -1 : 1;\n if (this.up) iconY -= 3;\n }\n\n screen.fillRect(\n iconX,\n iconY,\n iconWidth,\n iconHeight,\n this.border\n );\n screen.print(\n pNum,\n iconX + 1,\n iconY + (iconHeight >> 1) - (font.charHeight >> 1),\n this.bg,\n font\n );\n }\n }\n\n drawScore() {\n const s = this.score() | 0;\n\n let font: image.Font;\n let offsetY: number;\n if (s >= 1000000) {\n offsetY = 2;\n font = image.font5;\n }\n else {\n offsetY = 1;\n font = image.font8;\n }\n\n const num = s.toString();\n const width = num.length * font.charWidth;\n\n screen.fillRect(\n screen.width - width - 2,\n 0,\n screen.width,\n image.font8.charHeight + 3,\n infoState.borderColor\n );\n screen.fillRect(\n screen.width - width - 1,\n 0,\n screen.width,\n image.font8.charHeight + 2,\n infoState.bgColor\n );\n screen.print(\n num,\n screen.width - width,\n offsetY,\n infoState.fontColor,\n font\n );\n }\n\n drawLives() {\n const state = this.getState();\n if (state.life < 0) return;\n const font = image.font8;\n if (state.life <= 4) {\n screen.fillRect(\n 0,\n 0,\n state.life * (infoState.heartImage.width + 1) + 3,\n infoState.heartImage.height + 4,\n infoState.borderColor\n );\n screen.fillRect(\n 0,\n 0,\n state.life * (infoState.heartImage.width + 1) + 2,\n infoState.heartImage.height + 3,\n infoState.bgColor\n );\n for (let i = 0; i < state.life; i++) {\n screen.drawTransparentImage(\n infoState.heartImage,\n 1 + i * (infoState.heartImage.width + 1),\n 1\n );\n }\n }\n else {\n const num = state.life + \"\";\n const textWidth = num.length * font.charWidth - 1;\n screen.fillRect(\n 0,\n 0,\n infoState.heartImage.width + infoState.multiplierImage.width + textWidth + 5,\n infoState.heartImage.height + 4,\n infoState.borderColor\n );\n screen.fillRect(\n 0,\n 0,\n infoState.heartImage.width + infoState.multiplierImage.width + textWidth + 4,\n infoState.heartImage.height + 3,\n infoState.bgColor\n );\n screen.drawTransparentImage(\n infoState.heartImage,\n 1,\n 1\n );\n\n let mult = infoState.multiplierImage.clone();\n mult.replace(1, infoState.fontColor);\n\n screen.drawTransparentImage(\n mult,\n infoState.heartImage.width + 2,\n font.charHeight - infoState.multiplierImage.height - 1\n );\n screen.print(\n num,\n infoState.heartImage.width + 3 + infoState.multiplierImage.width,\n 1,\n infoState.fontColor,\n font\n );\n }\n }\n }\n\n function formatDecimal(val: number) {\n val |= 0;\n if (val < 10) {\n return \"0\" + val;\n }\n return val.toString();\n }\n\n //% fixedInstance whenUsed block=\"player 2\"\n export const player2 = new PlayerInfo(2);\n //% fixedInstance whenUsed block=\"player 3\"\n export const player3 = new PlayerInfo(3);\n //% fixedInstance whenUsed block=\"player 4\"\n export const player4 = new PlayerInfo(4);\n //% fixedInstance whenUsed block=\"player 1\"\n export const player1 = new PlayerInfo(1);\n}\n",
"keymap.cpp": "#include \"pxt.h\"\n\nnamespace keymap {\n\n void _setPlayerKeys(int player, int up, int down, int left, int right, int A, int B) {\n // not supported\n }\n\n void _setSystemKeys(int screenshot, int gif) {\n // not supported\n }\n}\n",
"keymap.ts": "namespace keymap {\n //% shim=keymap::_setPlayerKeys\n declare function _setPlayerKeys(\n player: number, // player number is 1-based\n up: number,\n down: number,\n left: number,\n right: number,\n A: number,\n B: number\n ): void;\n\n //% shim=keymap::_setSystemKeys\n declare function _setSystemKeys(screenshot: number, gif: number, menu: number, reset: number): void;\n\n /**\n * Sets the keyboard input map for the given player.\n * @param player The player number. 1 = Player1, etc.\n * @param up The key code for 'up'.\n * @param down The key code for 'down'\n * @param left The key code for 'left'\n * @param right The key code for 'right'\n * @param A The key code for 'A'\n * @param B The key code for 'B'\n */\n export function setPlayerKeys(\n player: number, // player number is 1-based\n up: KeyCode,\n down: KeyCode,\n left: KeyCode,\n right: KeyCode,\n A: KeyCode,\n B: KeyCode\n ) {\n _setPlayerKeys(player, up, down, left, right, A, B);\n }\n\n /**\n * Sets the keyboard input map for system keys.\n * @param screenshot The key code for 'screenshot'\n * @param gif The key code for 'gif'\n * @param menu The key code for 'menu'\n * @param reset The key code for 'reset'\n */\n export function setSystemKeys(screenshot: KeyCode, gif: KeyCode, menu: KeyCode, reset: KeyCode) {\n _setSystemKeys(screenshot, gif, menu, reset);\n }\n\n /**\n * Key codes\n */\n export enum KeyCode {\n None = 0,\n\n Backspace = 8,\n Tab = 9,\n Enter = 13,\n Shift = 16,\n Ctrl = 17,\n Alt = 18,\n PauseBreak = 19,\n CapsLock = 20,\n Escape = 27,\n Space = 32,\n PageUp = 33,\n PageDown = 34,\n End = 35,\n Home = 36,\n\n LeftArrow = 37,\n UpArrow = 38,\n RightArrow = 39,\n DownArrow = 40,\n\n Insert = 45,\n Delete = 46,\n\n Zero = 48,\n One = 49,\n Two = 50,\n Three = 51,\n Four = 52,\n Five = 53,\n Six = 54,\n Seven = 55,\n Eight = 56,\n Nine = 57,\n\n A = 65,\n B = 66,\n C = 67,\n D = 68,\n E = 69,\n F = 70,\n G = 71,\n H = 72,\n I = 73,\n J = 74,\n K = 75,\n L = 76,\n M = 77,\n N = 78,\n O = 79,\n P = 80,\n Q = 81,\n R = 82,\n S = 83,\n T = 84,\n U = 85,\n V = 86,\n W = 87,\n X = 88,\n Y = 89,\n Z = 90,\n\n LeftWindowsKey = 91,\n RightWindowsKey = 92,\n\n Numpad0 = 96,\n Numpad1 = 97,\n Numpad2 = 98,\n Numpad3 = 99,\n Numpad4 = 100,\n Numpad5 = 101,\n Numpad6 = 102,\n Numpad7 = 103,\n Numpad8 = 104,\n Numpad9 = 105,\n\n Multiply = 106,\n Add = 107,\n Subtract = 109,\n DecimalPoint = 110,\n Divide = 111,\n\n F1 = 112,\n F2 = 113,\n F3 = 114,\n F4 = 115,\n F5 = 116,\n F6 = 117,\n F7 = 118,\n F8 = 119,\n F9 = 120,\n F10 = 121,\n F11 = 122,\n F12 = 123,\n\n NumLock = 144,\n ScrollLock = 145,\n\n SemiColon = 186,\n Equals = 187,\n Comma = 188,\n Dash = 189,\n Period = 190,\n ForwardSlash = 191,\n Tilde = 192,\n\n OpenBracket = 219,\n ClosedBracket = 221,\n SingleQuote = 222,\n\n // Mouse\n MouseLeftButton = -1,\n MouseRightButton = -2,\n MouseCenterButton = -3,\n }\n}\n",
"mathUtil.ts": "namespace Math {\n /**\n * Returns a random boolean that is true the given percentage of the time.\n * @param percentage The percentage chance that the returned value will be true from 0 - 100\n */\n //% weight=2\n //% blockId=percentchance block=\"%percentage|\\\\% chance\"\n //% percentage.min=0 percentage.max=100;\n //% help=math/percent-chance\n export function percentChance(percentage: number): boolean {\n if (percentage >= 100) {\n return true;\n }\n else if (percentage <= 0) {\n return false;\n }\n return Math.randomRange(0, 99) < percentage;\n }\n\n /**\n * Returns a random element from the given list\n * @param list The list to choose an element from\n */\n //% weight=1\n export function pickRandom(list: T[]) {\n if (!list || list.length == 0) {\n return undefined;\n }\n return list[Math.randomRange(0, list.length - 1)];\n }\n\n /**\n * Fast, 16 bit, seedable (pseudo) random generator.\n */\n export class FastRandom {\n // Implementation of the Galois Linear Feedback Shift Register\n private lfsr: number;\n // A value between 0x0001 and 0xFFFF to generate random values from\n public seed: number;\n\n /**\n * Create a new Fast Random generator\n * @param seed [Optional] initial seed between 0x0001 and 0xFFFF.\n */\n constructor(seed?: number) {\n if (seed === undefined) seed = Math.randomRange(0x0001, 0xFFFF);\n this.seed = seed;\n this.lfsr = seed;\n }\n\n /**\n * @returns the next random number between 0x0001 and 0xFFFF inclusive\n */\n next(): number {\n return this.lfsr = (this.lfsr >> 1) ^ ((-(this.lfsr & 1)) & 0xb400);\n }\n\n /**\n * @param min the minimum value to generate\n * @param max the maximum value to generate\n * @returns a random value between min and max (inclusive). If min is greater than or equal to max, returns min.\n */\n randomRange(min: number, max: number): number {\n return min + (max > min ? this.next() % (max - min + 1) : 0);\n }\n\n /**\n * Returns a random element from the given list\n * @param list The list to choose an element from\n */\n pickRandom(list: T[]) {\n if (!list || list.length == 0) {\n return undefined;\n }\n return list[this.randomRange(0, list.length - 1)];\n }\n\n /**\n * @returns a random boolean value\n */\n randomBool(): boolean {\n return !(this.next() & 1);\n }\n\n /**\n * @param percent the percentage chance that the returned value will be true from 0 - 100\n * @returns a boolean with approximately the given percent chance to be true or false\n */\n percentChance(percent: number): boolean {\n return this.randomRange(0, 100) < percent;\n }\n\n /**\n * Reset the state to the current seed\n */\n reset() {\n this.lfsr = this.seed;\n }\n }\n}\n",
"metrics.ts": "namespace performance {\n\n}",
"multiplayer.cpp": "#include \"pxt.h\"\n\nnamespace multiplayer {\n //%\n void postImage(Image_ im, String goal) {\n // no support >:(\n }\n\n //%\n void setOrigin(String origin) {\n // no\n }\n\n //%\n Image_ getCurrentImage() {\n // nah\n return NULL;\n }\n\n //%\n String getOrigin() {\n return NULL;\n }\n\n}",
"multiplayer.ts": "namespace multiplayer {\n //% shim=multiplayer::getCurrentImage\n declare function getCurrentImage(): Image;\n\n //% shim=multiplayer::setOrigin\n declare function setOrigin(origin: string): void;\n\n //% shim=multiplayer::getOrigin\n declare function getOrigin(): string;\n\n export function init() {\n game.addScenePushHandler(() => {\n game.eventContext().registerFrameHandler(scene.MULTIPLAYER_SCREEN_PRIORITY, () => {\n if (getOrigin() === \"client\") {\n const im: Image = getCurrentImage();\n scene.setBackgroundImage(im);\n // clear default menu button behavior\n controller.menu.onEvent(ControllerButtonEvent.Pressed, () => { });\n }\n });\n });\n game.pushScene();\n }\n}",
"numberprompt.ts": "namespace game {\n\n /**\n * Ask the player for a number value.\n * @param message The message to display on the text-entry screen\n * @param answerLength The maximum number of digits the user can enter (1 - 10)\n */\n //% group=\"Gameplay\"\n //% weight=10 help=game/ask-for-number\n //% blockId=gameaskfornumber block=\"ask for number %message || and max length %answerLength\"\n //% message.shadow=text\n //% message.defl=\"\"\n //% answerLength.defl=\"6\"\n //% answerLength.min=1\n //% answerLength.max=10\n //% group=\"Prompt\"\n export function askForNumber(message: any, answerLength = 6) {\n answerLength = Math.max(0, Math.min(10, answerLength));\n let p = new game.NumberPrompt();\n const result = p.show(console.inspect(message), answerLength);\n return result;\n }\n\n\n //% whenUsed=true\n const font = image.font8;\n //% whenUsed=true\n const PADDING_HORIZONTAL = 40;\n //% whenUsed=true\n const PADDING_VERTICAL = 4;\n //% whenUsed=true\n const PROMPT_LINE_SPACING = 2;\n\n //% whenUsed=true\n const NUM_LETTERS = 12;\n //% whenUsed=true\n const NUMPAD_ROW_LENGTH = 3;\n //% whenUsed=true\n const NUM_ROWS = Math.ceil(NUM_LETTERS / NUMPAD_ROW_LENGTH);\n //% whenUsed=true\n const INPUT_ROWS = 1;\n\n //% whenUsed=true\n const CONTENT_WIDTH = screen.width - PADDING_HORIZONTAL * 2;\n //% whenUsed=true\n const CONTENT_HEIGHT = screen.height - PADDING_VERTICAL * 2;\n //% whenUsed=true\n const CONTENT_TOP = PADDING_VERTICAL;\n\n // Dimensions of a \"cell\" that contains a letter\n //% whenUsed=true\n const CELL_HEIGHT = Math.floor(CONTENT_HEIGHT / (NUM_ROWS + 4));\n //% whenUsed=true\n const CELL_WIDTH = CELL_HEIGHT//Math.floor(CONTENT_WIDTH / NUMPAD_ROW_LENGTH);\n //% whenUsed=true\n const LETTER_OFFSET_X = Math.floor((CELL_WIDTH - font.charWidth) / 2);\n //% whenUsed=true\n const LETTER_OFFSET_Y = Math.floor((CELL_HEIGHT - font.charHeight) / 2);\n //% whenUsed=true\n const BLANK_PADDING = 1;\n //% whenUsed=true\n const ROW_LEFT = PADDING_HORIZONTAL + CELL_WIDTH / 2 + Math.floor((CONTENT_WIDTH - (CELL_WIDTH * NUMPAD_ROW_LENGTH)) / 2);\n\n // Dimensions of the bottom bar\n //% whenUsed=true\n const BOTTOM_BAR_NUMPAD_MARGIN = 4;\n //% whenUsed=true\n const BOTTOM_BAR_HEIGHT = PADDING_VERTICAL + BOTTOM_BAR_NUMPAD_MARGIN + CELL_HEIGHT;\n //% whenUsed=true\n const BOTTOM_BAR_TOP = screen.height - BOTTOM_BAR_HEIGHT;\n //% whenUsed=true\n const BOTTOM_BAR_BUTTON_WIDTH = PADDING_HORIZONTAL * 2 + font.charWidth * 3;\n //% whenUsed=true\n const BOTTOM_BAR_TEXT_Y = (BOTTOM_BAR_HEIGHT - font.charHeight) / 2;\n //% whenUsed=true\n const BOTTOM_BAR_CONFIRM_X = (BOTTOM_BAR_BUTTON_WIDTH - font.charWidth * 2) / 2;\n\n // Dimensions of the numpad area\n //% whenUsed=true\n const NUMPAD_HEIGHT = NUM_ROWS * CELL_HEIGHT;\n //% whenUsed=true\n const NUMPAD_TOP = screen.height - NUMPAD_HEIGHT - BOTTOM_BAR_HEIGHT;\n //% whenUsed=true\n const NUMPAD_INPUT_MARGIN = 4;\n\n // Dimensions of area where text is input\n //% whenUsed=true\n const INPUT_HEIGHT = INPUT_ROWS * CELL_HEIGHT;\n //% whenUsed=true\n const INPUT_TOP = NUMPAD_TOP - INPUT_HEIGHT - NUMPAD_INPUT_MARGIN;\n\n // Pixels kept blank on left and right sides of prompt\n //% whenUsed=true\n const PROMPT_MARGIN_HORIZ = 3;\n\n // Dimensions of prompt message area\n //% whenUsed=true\n const PROMPT_HEIGHT = INPUT_TOP - CONTENT_TOP;\n //% whenUsed=true\n const PROMPT_WIDTH = screen.width - PROMPT_MARGIN_HORIZ * 2\n\n //% whenUsed=true\n const confirmText = \"OK\";\n\n\n export class NumberPrompt {\n theme: PromptTheme;\n\n message: string;\n answerLength: number;\n result: string;\n\n private cursor: Sprite;\n private confirmButton: Sprite;\n\n private numbers: Sprite[];\n private inputs: Sprite[];\n\n private confirmPressed: boolean;\n private cursorRow: number;\n private cursorColumn: number;\n private hasDecimal: boolean;\n private inputIndex: number;\n private blink: boolean;\n private frameCount: number;\n\n constructor(theme?: PromptTheme) {\n if (theme) {\n this.theme = theme;\n }\n else {\n this.theme = {\n colorPrompt: 1,\n colorInput: 3,\n colorInputHighlighted: 5,\n colorInputText: 1,\n colorAlphabet: 1,\n colorCursor: 7,\n colorBackground: 15,\n colorBottomBackground: 3,\n colorBottomText: 1,\n };\n }\n this.cursorRow = 0;\n this.cursorColumn = 0;\n this.hasDecimal = false;\n this.inputIndex = 0;\n }\n\n show(message: string, answerLength: number) : number {\n this.message = message;\n this.answerLength = answerLength;\n this.inputIndex = 0;\n\n controller._setUserEventsEnabled(false);\n game.pushScene()\n\n this.draw();\n this.registerHandlers();\n this.confirmPressed = false;\n\n pauseUntil(() => this.confirmPressed);\n\n game.popScene();\n controller._setUserEventsEnabled(true);\n\n return parseFloat(this.result);\n }\n\n private draw() {\n this.drawPromptText();\n this.drawNumpad();\n this.drawInputarea();\n this.drawBottomBar();\n }\n\n private drawPromptText() {\n const prompt = sprites.create(layoutText(this.message, PROMPT_WIDTH, PROMPT_HEIGHT, this.theme.colorPrompt), -1);\n prompt.x = screen.width / 2\n prompt.y = CONTENT_TOP + Math.floor((PROMPT_HEIGHT - prompt.height) / 2) + Math.floor(prompt.height / 2);\n }\n\n private drawInputarea() {\n const answerLeft = (screen.width - this.answerLength * CELL_WIDTH) / 2\n\n this.inputs = [];\n for (let i = 0; i < this.answerLength; i++) {\n const blank = image.create(CELL_WIDTH, CELL_HEIGHT);\n this.drawInput(blank, \"\", this.theme.colorInput);\n\n const s = sprites.create(blank, -1);\n s.left = answerLeft + i * CELL_WIDTH;\n s.y = INPUT_TOP;\n this.inputs.push(s);\n }\n }\n\n private drawNumpad() {\n const cursorImage = image.create(CELL_WIDTH, CELL_HEIGHT);\n cursorImage.fill(this.theme.colorCursor);\n this.cursor = sprites.create(cursorImage, -1);\n this.cursor.z = -1;\n this.updateCursor();\n\n this.numbers = [];\n for (let j = 0; j < NUM_LETTERS; j++) {\n const letter = image.create(CELL_WIDTH, CELL_HEIGHT);\n\n const col2 = j % NUMPAD_ROW_LENGTH;\n const row2 = Math.floor(j / NUMPAD_ROW_LENGTH);\n\n const t = sprites.create(letter, -1);\n t.x = ROW_LEFT + col2 * CELL_WIDTH;\n t.y = NUMPAD_TOP + row2 * CELL_HEIGHT;\n\n this.numbers.push(t);\n }\n this.updateKeyboard();\n }\n\n private drawBottomBar() {\n const bg = image.create(screen.width, BOTTOM_BAR_HEIGHT);\n bg.fill(this.theme.colorBottomBackground);\n\n const bgSprite = sprites.create(bg, -1);\n bgSprite.x = screen.width / 2;\n bgSprite.y = BOTTOM_BAR_TOP + BOTTOM_BAR_HEIGHT / 2;\n bgSprite.z = -1;\n\n this.confirmButton = sprites.create(image.create(BOTTOM_BAR_BUTTON_WIDTH, BOTTOM_BAR_HEIGHT), -1);\n this.confirmButton.right = screen.width;\n this.confirmButton.y = BOTTOM_BAR_TOP + Math.ceil(BOTTOM_BAR_HEIGHT / 2);\n\n this.updateButtons();\n }\n\n private updateButtons() {\n if (this.cursorRow === 4) {\n this.confirmButton.image.fill(this.theme.colorCursor);\n }\n else {\n this.confirmButton.image.fill(this.theme.colorBottomBackground);\n }\n\n this.confirmButton.image.print(confirmText, BOTTOM_BAR_CONFIRM_X, BOTTOM_BAR_TEXT_Y);\n }\n\n private updateCursor() {\n if (this.cursorRow === 4) {\n this.cursor.image.fill(0);\n this.updateButtons();\n }\n else {\n this.cursor.x = ROW_LEFT + this.cursorColumn * CELL_WIDTH;\n this.cursor.y = NUMPAD_TOP + this.cursorRow * CELL_HEIGHT;\n }\n }\n\n private updateSelectedInput() {\n if (this.inputIndex < this.answerLength) {\n const u = this.inputs[this.inputIndex];\n if (this.blink) {\n this.drawInput(u.image, \"\", this.theme.colorInput);\n }\n else {\n this.drawInput(u.image, \"\", this.theme.colorInputHighlighted)\n }\n }\n }\n\n private updateKeyboard() {\n const len = this.numbers.length;\n for (let k = 0; k < len; k++) {\n const img = this.numbers[k].image;\n img.fill(0);\n img.print(getSymbolFromIndex(k), LETTER_OFFSET_X, LETTER_OFFSET_Y);\n }\n }\n\n private drawInput(img: Image, char: string, color: number) {\n img.fill(0);\n img.fillRect(BLANK_PADDING, CELL_HEIGHT - 1, CELL_WIDTH - BLANK_PADDING * 2, 1, color)\n\n if (char) {\n img.print(char, LETTER_OFFSET_X, LETTER_OFFSET_Y, this.theme.colorInputText, font);\n }\n }\n\n private registerHandlers() {\n controller.up.onEvent(SYSTEM_KEY_DOWN, () => {\n this.moveVertical(true);\n })\n\n controller.down.onEvent(SYSTEM_KEY_DOWN, () => {\n this.moveVertical(false);\n })\n\n controller.right.onEvent(SYSTEM_KEY_DOWN, () => {\n this.moveHorizontal(true);\n });\n\n controller.left.onEvent(SYSTEM_KEY_DOWN, () => {\n this.moveHorizontal(false);\n });\n\n controller.A.onEvent(SYSTEM_KEY_DOWN, () => {\n this.confirm();\n });\n\n controller.B.onEvent(SYSTEM_KEY_DOWN, () => {\n this.delete();\n });\n\n\n this.frameCount = 0;\n this.blink = true;\n\n game.onUpdate(() => {\n this.frameCount = (this.frameCount + 1) % 30;\n\n if (this.frameCount === 0) {\n this.blink = !this.blink;\n\n this.updateSelectedInput();\n }\n })\n }\n\n private moveVertical(up: boolean) {\n if (up) {\n if (this.cursorRow === 4) {\n this.cursor.image.fill(this.theme.colorCursor);\n this.cursorRow = 3;\n\n this.updateButtons();\n }\n else {\n this.cursorRow = Math.max(0, this.cursorRow - 1);\n }\n }\n else {\n this.cursorRow = Math.min(4, this.cursorRow + 1);\n }\n\n this.updateCursor();\n }\n\n private moveHorizontal(right: boolean) {\n if (right) {\n this.cursorColumn = (this.cursorColumn + 1) % NUMPAD_ROW_LENGTH;\n }\n else {\n this.cursorColumn = (this.cursorColumn + (NUMPAD_ROW_LENGTH - 1)) % NUMPAD_ROW_LENGTH;\n }\n\n this.updateCursor();\n }\n\n private confirm() {\n if (this.cursorRow === 4) {\n this.confirmPressed = true;\n } else {\n if (this.inputIndex >= this.answerLength) return;\n\n const index = this.cursorColumn + this.cursorRow * NUMPAD_ROW_LENGTH\n const letter = getSymbolFromIndex(index);\n\n if (letter === \".\") {\n if(this.hasDecimal) {\n return;\n } else {\n this.hasDecimal = true;\n }\n }\n\n if (letter === \"-\" && (this.result && this.result.length > 0)) {\n return;\n }\n\n if (!this.result) {\n this.result = letter;\n }\n else {\n this.result += letter;\n }\n\n const sprite = this.inputs[this.inputIndex];\n this.changeInputIndex(1);\n this.drawInput(sprite.image, letter, this.theme.colorInput);\n }\n }\n\n private delete() {\n if (this.inputIndex <= 0) return;\n\n if (this.inputIndex < this.answerLength) {\n this.drawInput(this.inputs[this.inputIndex].image, \"\", this.theme.colorInput);\n }\n\n if (this.result.charAt(this.result.length - 1) === \".\") {\n this.hasDecimal = false;\n }\n\n this.result = this.result.substr(0, this.result.length - 1);\n\n this.changeInputIndex(-1);\n }\n\n private changeInputIndex(delta: number) {\n this.inputIndex += delta;\n this.frameCount = 0\n this.blink = false;\n this.updateSelectedInput();\n }\n }\n\n function layoutText(message: string, width: number, height: number, color: number) {\n const lineHeight = font.charHeight + PROMPT_LINE_SPACING;\n\n const lineLength = Math.floor(width / font.charWidth);\n const numLines = Math.floor(height / lineHeight);\n\n let lines: string[] = [];\n let word: string;\n let line: string;\n\n let pushWord = () => {\n if (line) {\n if (line.length + word.length + 1 > lineLength) {\n lines.push(line);\n line = word;\n }\n else {\n line = line + \" \" + word;\n }\n }\n else {\n line = word;\n }\n\n word = null;\n }\n\n for (let l = 0; l < message.length; l++) {\n const char = message.charAt(l);\n\n if (char === \" \") {\n if (word) {\n pushWord();\n }\n else {\n word = \" \";\n }\n }\n else if (!word) {\n word = char;\n }\n else {\n word += char;\n }\n }\n\n if (word) {\n pushWord();\n }\n\n if (line) {\n lines.push(line);\n }\n\n let maxLineWidth = 0;\n for (let m = 0; m < lines.length; m++) {\n maxLineWidth = Math.max(maxLineWidth, lines[m].length);\n }\n\n const actualWidth = maxLineWidth * font.charWidth;\n const actualHeight = lines.length * lineHeight;\n\n const res = image.create(actualWidth, actualHeight);\n\n for (let n = 0; n < lines.length; n++) {\n if ((n + 1) > numLines) break;\n res.print(lines[n], 0, n * lineHeight, color, font);\n }\n\n return res;\n }\n\n function getSymbolFromIndex(index: number) {\n if (index < 9) {\n // Calculator Layout\n return \"\" + (3 * Math.idiv(9 - index - 1, 3) + index % 3 + 1);\n } else if (index == 9) {\n return \"-\";\n } else if (index == 10) {\n return \"0\";\n } else if (index == 11) {\n return \".\";\n } else {\n return \"\";\n }\n }\n\n}",
"obstacle.ts": "namespace sprites {\n enum ObstacleFlags {\n Moved = 1 << 4,\n Dead = 1 << 5\n }\n\n export interface Obstacle {\n x: number;\n y: number;\n left: number;\n right: number;\n top: number;\n bottom: number;\n width: number;\n height: number;\n layer: number;\n image: Image;\n tileIndex: number;\n }\n\n export class StaticObstacle implements Obstacle {\n layer: number;\n image: Image;\n tileIndex: number;\n\n top: number;\n left: number;\n\n constructor(image: Image, top: number, left: number, layer: number, tileIndex?: number) {\n this.image = image;\n this.layer = layer;\n this.top = top;\n this.left = left;\n this.tileIndex = tileIndex;\n }\n\n get x(): number {\n return this.left + (this.width >> 1);\n }\n\n get y(): number {\n return this.top + (this.height >> 1);\n }\n\n get height(): number {\n return this.image.height;\n }\n\n get width(): number {\n return this.image.width;\n }\n\n get bottom(): number {\n return this.top + this.height;\n }\n\n get right(): number {\n return this.left + this.width;\n }\n }\n}",
"particleeffects.ts": "namespace effects {\n\n //% fixedInstances\n export interface BackgroundEffect {\n startScreenEffect(): void;\n }\n\n //% fixedInstances\n export class ParticleEffect {\n protected sourceFactory: (anchor: particles.ParticleAnchor, pps: number) => particles.ParticleSource;\n protected defaultRate: number;\n protected defaultLifespan: number;\n\n constructor(defaultParticlesPerSecond: number, defaultLifespan: number,\n sourceFactory: (anchor: particles.ParticleAnchor, particlesPerSecond: number) => particles.ParticleSource) {\n this.sourceFactory = sourceFactory;\n this.defaultRate = defaultParticlesPerSecond;\n this.defaultLifespan = defaultLifespan;\n }\n\n /**\n * Attaches a new particle animation to the sprite or anchor for a short period of time\n * @param anchor\n * @param duration\n * @param particlesPerSecond\n */\n start(anchor: particles.ParticleAnchor, duration?: number, particlesPerSecond?: number, relativeToCamera?: boolean): void {\n if (!this.sourceFactory) return;\n const src = this.sourceFactory(anchor, particlesPerSecond ? particlesPerSecond : this.defaultRate);\n src.setRelativeToCamera(!!relativeToCamera);\n if (duration)\n src.lifespan = duration > 0 ? duration : this.defaultLifespan;\n }\n\n /**\n * Destroy the provided sprite with an effect\n * @param sprite\n * @param duration how long the sprite will remain on the screen. If set to 0 or undefined,\n * uses the default rate for this effect.\n * @param particlesPerSecond\n */\n destroy(anchor: Sprite, duration?: number, particlesPerSecond?: number) {\n anchor.setFlag(SpriteFlag.Ghost, true);\n this.start(anchor, particlesPerSecond, null, !!(anchor.flags & sprites.Flag.RelativeToCamera));\n anchor.lifespan = duration ? duration : this.defaultLifespan >> 2;\n effects.dissolve.applyTo(anchor);\n }\n }\n\n /**\n * Anchor used for effects that occur across the screen.\n */\n class SceneAnchor implements particles.ParticleAnchor {\n private camera: scene.Camera;\n\n constructor() {\n this.camera = game.currentScene().camera;\n }\n\n get x() {\n return this.camera.offsetX + (screen.width >> 1);\n }\n\n get y() {\n return this.camera.offsetY + (screen.height >> 1);\n }\n\n get width() {\n return screen.width;\n }\n\n get height() {\n return screen.height;\n }\n }\n\n //% fixedInstances\n export class ScreenEffect extends ParticleEffect implements BackgroundEffect {\n protected source: particles.ParticleSource;\n protected sceneDefaultRate: number;\n\n constructor(anchorDefault: number, sceneDefault: number, defaultLifespan: number,\n sourceFactory: (anchor: particles.ParticleAnchor, particlesPerSecond: number) => particles.ParticleSource) {\n super(anchorDefault, defaultLifespan, sourceFactory);\n this.sceneDefaultRate = sceneDefault;\n }\n\n /**\n * Creates a new effect that occurs over the entire screen\n * @param particlesPerSecond\n * @param duration\n */\n //% blockId=particlesStartScreenAnimation block=\"start screen %effect effect || for %duration ms\"\n //% duration.shadow=timePicker\n //% blockNamespace=scene\n //% group=\"Effects\" blockGap=8\n //% weight=90 help=effects/start-screen-effect\n startScreenEffect(duration?: number, particlesPerSecond?: number): void {\n if (!this.sourceFactory)\n return;\n\n if (this.source && this.source.enabled) {\n if (duration)\n this.source.lifespan = duration;\n return;\n }\n\n this.endScreenEffect();\n this.source = this.sourceFactory(new SceneAnchor(), particlesPerSecond ? particlesPerSecond : this.sceneDefaultRate);\n this.source.priority = 10;\n if (duration)\n this.source.lifespan = duration;\n }\n\n /**\n * If this effect is currently occurring as a full screen effect, stop producing particles and end the effect\n * @param particlesPerSecond\n */\n //% blockId=particlesEndScreenAnimation block=\"end screen %effect effect\"\n //% blockNamespace=scene\n //% group=\"Effects\" blockGap=8\n //% weight=80 help=effects/end-screen-effect\n endScreenEffect(): void {\n if (this.source) {\n this.source.destroy();\n this.source = undefined;\n }\n }\n }\n\n /**\n * Removes all effects attached to the given anchor\n * @param anchor the anchor to remove effects from\n */\n //% blockId=particlesclearparticles block=\"clear effects on %anchor=variables_get(mySprite)\"\n //% blockNamespace=sprites\n //% group=\"Effects\" weight=89\n //% help=effects/clear-particles\n export function clearParticles(anchor: Sprite | particles.ParticleAnchor) {\n const sources = game.currentScene().particleSources;\n if (!sources) return;\n sources\n .filter(ps => ps.anchor === anchor)\n .forEach(ps => ps.destroy());\n }\n\n function createEffect(defaultParticlesPerSecond: number, defaultLifespan: number,\n factoryFactory: (anchor?: particles.ParticleAnchor) => particles.ParticleFactory): ParticleEffect {\n return new ParticleEffect(defaultParticlesPerSecond, defaultLifespan,\n (anchor: particles.ParticleAnchor, pps: number) =>\n new particles.ParticleSource(anchor, pps, factoryFactory()));\n }\n\n //% fixedInstance whenUsed block=\"spray\"\n export const spray = createEffect(20, 2000, function () { return new particles.SprayFactory(100, 0, 120) });\n\n //% fixedInstance whenUsed block=\"trail\"\n export const trail = new ParticleEffect(20, 4000, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n const factory = new particles.TrailFactory(anchor, 250, 1000);\n return new particles.ParticleSource(anchor, particlesPerSecond, factory);\n });\n\n //% fixedInstance whenUsed block=\"fountain\"\n export const fountain = new ParticleEffect(20, 3000, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n class FountainFactory extends particles.SprayFactory {\n galois: Math.FastRandom;\n\n constructor() {\n super(40, 180, 90);\n this.galois = new Math.FastRandom(1234);\n }\n\n createParticle(anchor: particles.ParticleAnchor) {\n const p = super.createParticle(anchor);\n p.color = this.galois.randomBool() ? 8 : 9;\n p.lifespan = 1500;\n return p;\n }\n\n drawParticle(p: particles.Particle, x: Fx8, y: Fx8) {\n screen.setPixel(Fx.toInt(x), Fx.toInt(y), p.color);\n }\n }\n\n const factory = new FountainFactory();\n const source = new particles.ParticleSource(anchor, particlesPerSecond, factory);\n source.setAcceleration(0, 40);\n return source;\n });\n\n //% fixedInstance whenUsed block=\"confetti\"\n export const confetti = new ScreenEffect(10, 40, 4000, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n const factory = new particles.ConfettiFactory(anchor.width ? anchor.width : 16, 16);\n factory.setSpeed(30);\n return new particles.ParticleSource(anchor, particlesPerSecond, factory);\n });\n\n //% fixedInstance whenUsed block=\"hearts\"\n export const hearts = new ScreenEffect(5, 20, 2000, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n const factory = new particles.ShapeFactory(anchor.width ? anchor.width : 16, 16, img`\n . F . F .\n F . F . F\n F . . . F\n . F . F .\n . . F . .\n `);\n\n // if large anchor, increase lifespan\n if (factory.xRange > 50) {\n factory.minLifespan = 1000;\n factory.maxLifespan = 2000;\n }\n\n factory.setSpeed(90);\n return new particles.ParticleSource(anchor, particlesPerSecond, factory);\n });\n\n //% fixedInstance whenUsed block=\"smiles\"\n export const smiles = new ScreenEffect(5, 25, 1500, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n const factory = new particles.ShapeFactory(anchor.width ? anchor.width : 16, 16, img`\n . f . f .\n . f . f .\n . . . . .\n f . . . f\n . f f f .\n `);\n // if large anchor, increase lifespan\n if (factory.xRange > 50) {\n factory.minLifespan = 1250;\n factory.maxLifespan = 2500;\n }\n\n factory.setSpeed(50);\n return new particles.ParticleSource(anchor, particlesPerSecond, factory);\n });\n\n //% fixedInstance whenUsed block=\"rings\"\n export const rings = createEffect(5, 1000, function () {\n return new particles.ShapeFactory(16, 16, img`\n . F F F .\n F . . . F\n F . . . F\n f . . . f\n . f f f .\n `);\n });\n\n //% fixedInstance whenUsed block=\"fire\"\n export const fire = new ParticleEffect(50, 5000, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n const factory = new particles.FireFactory(5);\n const src = new particles.FireSource(anchor, particlesPerSecond, factory);\n src.setAcceleration(0, -20);\n return src;\n });\n\n //% fixedInstance whenUsed block=\"warm radial\"\n export const warmRadial = createEffect(30, 2500, function () { return new particles.RadialFactory(0, 30, 10) });\n\n //% fixedInstance whenUsed block=\"cool radial\"\n export const coolRadial = createEffect(30, 2000, function () { return new particles.RadialFactory(0, 30, 10, [0x6, 0x7, 0x8, 0x9, 0xA]) });\n\n //% fixedInstance whenUsed block=\"halo\"\n export const halo = createEffect(70, 3000, function () {\n class RingFactory extends particles.RadialFactory {\n createParticle(anchor: particles.ParticleAnchor) {\n const p = super.createParticle(anchor);\n p.lifespan = this.galois.randomRange(200, 350);\n return p;\n }\n }\n return new RingFactory(30, 40, 10, [0x4, 0x4, 0x5]);\n });\n\n //% fixedInstance whenUsed block=\"ashes\"\n export const ashes = new ParticleEffect(60, 2000, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n const factory = new particles.AshFactory(anchor);\n const src = new particles.ParticleSource(anchor, particlesPerSecond, factory);\n src.setAcceleration(0, 500);\n return src;\n });\n\n //% fixedInstance whenUsed block=\"disintegrate\"\n export const disintegrate = new ParticleEffect(60, 1250, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n const factory = new particles.AshFactory(anchor, true, 30);\n factory.minLifespan = 200;\n factory.maxLifespan = 500;\n const src = new particles.ParticleSource(anchor, particlesPerSecond, factory);\n src.setAcceleration(0, 750);\n return src;\n });\n\n //% fixedInstance whenUsed block=\"blizzard\"\n export const blizzard = new ScreenEffect(15, 50, 3000, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n class SnowFactory extends particles.ShapeFactory {\n constructor(xRange: number, yRange: number) {\n super(xRange, yRange, img`F`);\n this.addShape(img`\n F\n F`\n );\n this.minLifespan = 200;\n this.maxLifespan = this.xRange > 50 ? 1200: 700;\n }\n\n createParticle(anchor: particles.ParticleAnchor) {\n const p = super.createParticle(anchor);\n p.color = this.galois.percentChance(80) ? 0x1 : 0x9;\n return p;\n }\n }\n\n const factory = new SnowFactory(anchor.width ? anchor.width : 16, anchor.height ? anchor.height : 16);\n const src = new particles.ParticleSource(anchor, particlesPerSecond, factory);\n src.setAcceleration(-300, -100);\n return src;\n });\n\n //% fixedInstance whenUsed block=\"bubbles\"\n export const bubbles = new ScreenEffect(15, 40, 5000, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n const min = anchor.width > 50 ? 2000 : 500;\n const factory = new particles.BubbleFactory(anchor, min, min * 2.5);\n return new particles.BubbleSource(anchor, particlesPerSecond, factory.stateCount - 1, factory);\n });\n\n //% fixedInstance whenUsed block=\"star field\"\n export const starField = new ScreenEffect(2, 5, 5000, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n const factory = new particles.StarFactory([0x1, 0x3, 0x5, 0x9, 0xC]);\n return new particles.ParticleSource(anchor, particlesPerSecond, factory);\n });\n\n //% fixedInstance whenUsed block=\"clouds\"\n export const clouds = new ScreenEffect(.5, 1.5, 5000, function (anchor: particles.ParticleAnchor, particlesPerSecond: number) {\n const factory = new particles.CloudFactory();\n const source = new particles.ParticleSource(anchor, particlesPerSecond, factory);\n\n // render behind tile map\n source.z = -2;\n return source;\n });\n}",
"particlefactories.ts": "namespace particles {\n let cachedSin: Fx8[];\n let cachedCos: Fx8[];\n\n const NUM_SLICES = 100;\n const galois = new Math.FastRandom();\n let angleSlice = 2 * Math.PI / NUM_SLICES;\n\n /**\n * Initialize sin and cos values for each slice to minimize recomputation\n */\n function initTrig() {\n if (!cachedSin) {\n cachedSin = cacheSin(NUM_SLICES);\n cachedCos = cacheCos(NUM_SLICES);\n }\n }\n\n /**\n * @param slices number of cached sin values to make\n * @returns array of cached sin values between 0 and 360 degrees\n */\n export function cacheSin(slices: number): Fx8[] {\n let sin: Fx8[] = [];\n let anglePerSlice = 2 * Math.PI / slices;\n for (let i = 0; i < slices; i++) {\n sin.push(Fx8(Math.sin(i * anglePerSlice)));\n }\n return sin;\n }\n\n /**\n * @param slices number of cached cos values to make\n * @returns array of cached cos values between 0 and 360 degrees\n */\n export function cacheCos(slices: number): Fx8[] {\n let cos: Fx8[] = [];\n let anglePerSlice = 2 * Math.PI / slices;\n for (let i = 0; i < slices; i++) {\n cos.push(Fx8(Math.cos(i * anglePerSlice)));\n }\n return cos;\n }\n\n const ratio = Math.PI / 180;\n function toRadians(degrees: number) {\n if (degrees < 0)\n degrees = 360 - (Math.abs(degrees) % 360);\n else\n degrees = degrees % 360;\n\n return degrees * ratio;\n }\n\n /**\n * A factory for generating particles\n */\n export class ParticleFactory {\n\n constructor() {\n // Compiler errors if this doesn't exist\n }\n\n /**\n * Generate a particle at the position of the given anchor\n * @param anchor \n */\n createParticle(anchor: ParticleAnchor): Particle {\n const p = new Particle();\n\n p._x = Fx8(anchor.x);\n p._y = Fx8(anchor.y);\n p.vx = Fx.zeroFx8;\n p.vy = Fx.zeroFx8;\n p.lifespan = 500;\n\n return p;\n }\n\n /**\n * Draw the given particle at the given location\n * @param particle \n * @param x \n * @param y \n */\n drawParticle(particle: Particle, x: Fx8, y: Fx8) {\n screen.setPixel(Fx.toInt(x), Fx.toInt(y), 1);\n }\n }\n\n /**\n * A factory for creating a spray of particles\n */\n export class SprayFactory extends ParticleFactory {\n protected speed: Fx8;\n protected minAngle: number;\n protected spread: number;\n\n constructor(speed: number, centerDegrees: number, arcDegrees: number) {\n super();\n initTrig();\n this.setSpeed(speed);\n this.setDirection(centerDegrees, arcDegrees);\n }\n\n createParticle(anchor: ParticleAnchor) {\n const p = super.createParticle(anchor);\n\n const angle = (this.minAngle + galois.randomRange(0, this.spread)) % NUM_SLICES;\n p.vx = Fx.mul(cachedSin[angle], this.speed);\n p.vy = Fx.mul(cachedCos[angle], this.speed);\n\n return p;\n }\n\n drawParticle(particle: Particle, x: Fx8, y: Fx8) {\n screen.setPixel(Fx.toInt(x), Fx.toInt(y), 1);\n }\n\n setSpeed(pixelsPerSecond: number) {\n this.speed = Fx8(pixelsPerSecond);\n }\n\n setDirection(centerDegrees: number, arcDegrees: number) {\n this.minAngle = (toRadians(centerDegrees - (arcDegrees >> 1)) / angleSlice) | 0;\n this.spread = (toRadians(arcDegrees) / angleSlice) | 0;\n }\n }\n\n /**\n * A factory for creating particles within rectangular area\n */\n export class AreaFactory extends SprayFactory {\n xRange: number;\n yRange: number;\n minLifespan: number;\n maxLifespan: number;\n protected galois: Math.FastRandom;\n\n constructor(xRange: number, yRange: number, minLifespan?: number, maxLifespan?: number) {\n super(40, 0, 90);\n this.xRange = xRange;\n this.yRange = yRange;\n this.minLifespan = minLifespan ? minLifespan : 150;\n this.maxLifespan = maxLifespan ? maxLifespan : 850;\n this.galois = new Math.FastRandom();\n }\n\n createParticle(anchor: ParticleAnchor) {\n const p = super.createParticle(anchor);\n\n p.lifespan = this.galois.randomRange(this.minLifespan, this.maxLifespan);\n p._x = Fx.iadd(this.galois.randomRange(0, this.xRange) - (this.xRange >> 1), p._x);\n p._y = Fx.iadd(this.galois.randomRange(0, this.yRange) - (anchor.height ? anchor.height >> 1 : 0), p._y);\n\n return p;\n }\n\n drawParticle(p: Particle, x: Fx8, y: Fx8) {\n const col = p.lifespan > 500 ?\n 4 : p.lifespan > 250 ?\n 5 : 1;\n screen.setPixel(Fx.toInt(x), Fx.toInt(y), col);\n }\n }\n\n /**\n * A factory for creating a trail that is emitted by sprites.\n */\n export class TrailFactory extends ParticleFactory {\n minLifespan: number;\n maxLifespan: number;\n xRange: number;\n yRange: number;\n protected galois: Math.FastRandom;\n\n constructor(sprite: ParticleAnchor, minLifespan: number, maxLifespan: number) {\n super();\n this.xRange = sprite.width ? sprite.width >> 1 : 8;\n this.yRange = sprite.height ? sprite.height >> 1 : 8;\n this.minLifespan = minLifespan;\n this.maxLifespan = maxLifespan;\n this.galois = new Math.FastRandom();\n }\n\n createParticle(anchor: ParticleAnchor) {\n const p = super.createParticle(anchor);\n\n p.lifespan = this.galois.randomRange(this.minLifespan, this.maxLifespan);\n p._x = Fx.iadd(this.galois.randomRange(0, this.xRange) - (this.xRange >> 1), p._x);\n p._y = Fx.iadd(this.galois.randomRange(0, this.yRange) - (this.yRange >> 1), p._y);\n p.color = this.galois.randomRange(0x1, 0xF);\n\n return p;\n }\n\n drawParticle(p: Particle, x: Fx8, y: Fx8) {\n screen.setPixel(Fx.toInt(x), Fx.toInt(y), p.color);\n }\n }\n\n /**\n * A factory for creating particles with the provided shapes fall down the screen.\n * \n * Any pixels assigned to 0xF (black) in the provided shape will be replaced with a\n * random color for each particle.\n */\n export class ShapeFactory extends AreaFactory {\n protected sources: Image[];\n protected ox: Fx8;\n protected oy: Fx8;\n\n constructor(xRange: number, yRange: number, source: Image) {\n super(xRange, yRange);\n this.sources = [source];\n\n // Base offsets off of initial shape\n this.ox = Fx8(source.width >> 1);\n this.oy = Fx8(source.height >> 1);\n }\n\n /**\n * Add another possible shape for a particle to display as\n * @param shape \n */\n addShape(shape: Image) {\n if (shape) this.sources.push(shape);\n }\n\n drawParticle(p: Particle, x: Fx8, y: Fx8) {\n const pImage = this.galois.pickRandom(this.sources).clone();\n pImage.replace(0xF, p.color);\n\n screen.drawTransparentImage(pImage,\n Fx.toInt(Fx.sub(x, this.ox)),\n Fx.toInt(Fx.sub(y, this.oy))\n );\n }\n\n createParticle(anchor: ParticleAnchor) {\n const p = super.createParticle(anchor);\n p.color = this.galois.randomRange(1, 14);\n return p;\n }\n }\n\n export class ConfettiFactory extends ShapeFactory {\n constructor(xRange: number, yRange: number) {\n const confetti = [\n img`\n F\n `,\n img`\n F\n F\n `,\n img`\n F F\n `,\n img`\n F F\n F .\n `,\n img`\n F F\n . F\n `];\n super(xRange, yRange, confetti[0]);\n for (let i = 1; i < confetti.length; i++) {\n this.addShape(confetti[i]);\n }\n\n this.minLifespan = 1000;\n this.maxLifespan = 4500;\n }\n }\n\n export class FireFactory extends ParticleFactory {\n protected galois: Math.FastRandom;\n protected minRadius: number;\n protected maxRadius: number;\n \n constructor(radius: number) {\n super();\n initTrig();\n this.galois = new Math.FastRandom();\n this.minRadius = radius >> 1;\n this.maxRadius = radius;\n }\n\n createParticle(anchor: ParticleAnchor) {\n const p = super.createParticle(anchor);\n p.color = this.galois.randomBool() ?\n 2 : this.galois.randomBool() ?\n 4 : 5;\n\n const i = this.galois.randomRange(0, cachedCos.length);\n const r = this.galois.randomRange(this.minRadius, this.maxRadius);\n\n p._x = Fx.iadd(anchor.x, Fx.mul(Fx8(r), cachedCos[i]));\n p._y = Fx.iadd(anchor.y, Fx.mul(Fx8(r), cachedSin[i]));\n p.vy = Fx8(Math.randomRange(0, 10));\n p.vx = Fx8(Math.randomRange(-5, 5));\n p.lifespan = 1500;\n\n return p;\n }\n\n drawParticle(p: Particle, x: Fx8, y: Fx8) {\n screen.setPixel(\n Fx.toInt(x),\n Fx.toInt(y),\n p.color\n );\n }\n }\n\n export class RadialFactory extends ParticleFactory {\n protected r: Fx8;\n protected speed: Fx8;\n protected t: number;\n protected spread: number;\n protected galois: Math.FastRandom;\n protected colors: number[];\n\n constructor(radius: number, speed: number, spread: number, colors?: number[]) {\n super();\n initTrig();\n\n if (colors && colors.length != 0)\n this.colors = colors;\n else\n this.colors = [0x2, 0x3, 0x4, 0x5];\n\n this.setRadius(radius)\n this.speed = Fx8(-speed);\n this.spread = spread;\n this.t = 0;\n this.galois = new Math.FastRandom();\n }\n\n createParticle(anchor: ParticleAnchor) {\n const p = super.createParticle(anchor);\n const time = ++this.t % cachedCos.length;\n const offsetTime = (time + this.galois.randomRange(0, this.spread)) % cachedCos.length;\n\n p._x = Fx.iadd(anchor.x, Fx.mul(this.r, cachedCos[time]));\n p._y = Fx.iadd(anchor.y, Fx.mul(this.r, cachedSin[time]));\n p.vx = Fx.mul(this.speed, Fx.neg(cachedSin[offsetTime]));\n p.vy = Fx.mul(this.speed, cachedCos[offsetTime]);\n\n p.lifespan = this.galois.randomRange(200, 1500);\n p.color = this.galois.pickRandom(this.colors);\n\n return p;\n }\n\n drawParticle(p: Particle, x: Fx8, y: Fx8) {\n screen.setPixel(\n Fx.toInt(x),\n Fx.toInt(y),\n p.color\n );\n }\n\n setRadius(r: number) {\n this.r = Fx8(r >> 1);\n }\n\n setSpeed(s: number) {\n this.speed = Fx8(-s);\n }\n\n setSpread(s: number) {\n this.spread = s;\n }\n }\n\n class ColorCount {\n constructor(public color: number, public count: number) { }\n }\n\n export class AshFactory extends AreaFactory {\n private colors: ColorCount[];\n \n constructor(anchor: ParticleAnchor, updateImage?: boolean, percentKept: number = 20) {\n super(anchor.width ? anchor.width : 8, anchor.height ? anchor.height >> 1 : 8, 300, 700);\n\n if (!anchor.image) {\n this.colors = [new ColorCount(1, 20)];\n return;\n }\n\n let counts: number[] = [];\n for (let i = 0x0; i <= 0xF; i++) {\n counts[i] = 0;\n }\n let result: Image = anchor.image.clone();\n\n for (let x = 0; x < result.width; x++) {\n for (let y = 0; y < result.height; y++) {\n const c = result.getPixel(x, y);\n if (c && this.galois.percentChance(percentKept)) {\n counts[c]++;\n result.setPixel(x, y, 0x0);\n }\n }\n }\n\n /** TODO: The following should be:\n * if (updateImage && anchor.setImage) {\n * anchor.setImage(result);\n * }\n * but this fails due to https://github.com/Microsoft/pxt-arcade/issues/515 .\n * This is a temporary workaround.\n */\n if (updateImage) {\n (anchor as Sprite).setImage(result);\n }\n\n this.colors = counts\n .map((value: number, index: number) => new ColorCount(index, value))\n .filter(v => v.count != 0);\n }\n\n createParticle(anchor: ParticleAnchor) {\n if (this.colors.length === 0) return undefined;\n\n const index = this.galois.randomRange(0, this.colors.length - 1);\n const choice = this.colors[index];\n const p = super.createParticle(anchor);\n\n choice.count--;\n if (choice.count === 0) this.colors.removeAt(index);\n\n p.color = choice.color;\n\n p._y = Fx.iadd(this.galois.randomRange(this.yRange >> 1, this.yRange), p._y);\n p.vx = anchor.vx ? Fx.neg(Fx8(anchor.vx >> 2)): Fx.zeroFx8;\n p.vy = Fx8(this.galois.randomRange(-150, -50));\n\n return p;\n }\n\n drawParticle(p: Particle, x: Fx8, y: Fx8) {\n screen.setPixel(Fx.toInt(x), Fx.toInt(y), p.color);\n }\n }\n\n export class BubbleFactory extends ParticleFactory {\n minLifespan: number;\n maxLifespan: number;\n xRange: number;\n yRange: number;\n protected galois: Math.FastRandom;\n protected states: Image[];\n \n constructor(sprite: ParticleAnchor, minLifespan: number, maxLifespan: number) {\n super();\n initTrig();\n this.galois = new Math.FastRandom();\n\n this.xRange = sprite.width ? sprite.width : 16;\n this.yRange = 8;\n this.minLifespan = minLifespan;\n this.maxLifespan = maxLifespan;\n\n this.states = [\n img`\n F\n `, img`\n F F\n `, img`\n F F\n F F\n `, img`\n F F F\n F . F\n F F F\n `, img`\n . F F .\n F . . F\n F . . F\n . F F .\n `, img`\n . F F F .\n F . . . F\n F . . . F\n . F F F .\n `\n ];\n }\n\n get stateCount(): number {\n return this.states.length;\n }\n\n createParticle(anchor: ParticleAnchor) {\n const p = super.createParticle(anchor);\n\n p.lifespan = this.galois.randomRange(this.minLifespan, this.maxLifespan);\n p._x = Fx.iadd(this.galois.randomRange(0, this.xRange) - (this.xRange >> 1), p._x);\n p._y = Fx.iadd(this.galois.randomRange(-this.yRange, 0) + (anchor.height ? anchor.height >> 1 : 0), p._y);\n\n p.vy = Fx8(Math.randomRange(-30, -5));\n p.vx = Fx8(Math.randomRange(-10, 10));\n\n p.data = this.galois.percentChance(80) ? 0 : 2;\n p.color = this.galois.percentChance(90) ?\n 0x9 : (this.galois.percentChance(50) ?\n 0x6 : 0x8);\n\n return p;\n }\n\n drawParticle(p: Particle, x: Fx8, y: Fx8) {\n const toDraw = this.states[p.data].clone();\n toDraw.replace(0xF, p.color);\n screen.drawTransparentImage(toDraw, Fx.toInt(x), Fx.toInt(y));\n }\n }\n\n export class StarFactory extends ParticleFactory {\n protected galois: Math.FastRandom;\n protected possibleColors: number[]\n minRate: number;\n maxRate: number;\n images: Image[];\n\n constructor(possibleColors?: number[], minRate: number = 15, maxRate: number = 25) {\n super();\n this.galois = new Math.FastRandom();\n this.minRate = minRate;\n this.maxRate = maxRate;\n this.images = [\n img`\n 1\n `,\n img`\n 1 . 1\n . 1 .\n 1 . 1\n `, img`\n . 1 .\n 1 1 1\n . 1 .\n `\n ];\n\n if (possibleColors && possibleColors.length)\n this.possibleColors = possibleColors\n else\n this.possibleColors = [1];\n }\n\n createParticle(anchor: ParticleAnchor) {\n const p = super.createParticle(anchor);\n const xRange = anchor.width ? anchor.width >> 1 : 8;\n\n p._x = Fx8(this.galois.randomRange(anchor.x - xRange, anchor.x + xRange));\n p._y = Fx8(anchor.height ? anchor.y - (anchor.height >> 1) : anchor.y);\n p.vy = Fx8(this.galois.randomRange(this.minRate, this.maxRate));\n\n // set lifespan based off velocity and screen height (plus a little to make sure it doesn't disappear early)\n p.lifespan = Fx.toInt(Fx.mul(Fx.div(Fx8(screen.height + 20), p.vy), Fx8(1000)));\n\n const length = this.possibleColors.length - 1;\n p.color = this.possibleColors[this.possibleColors.length - 1];\n for (let i = 0; i < length; ++i) {\n if (this.galois.percentChance(80 - (i * 10))) {\n p.color = this.possibleColors[i];\n break;\n }\n }\n\n // images besides the first one are only used on occasion\n p.data = this.galois.percentChance(15) ? this.galois.randomRange(1, this.images.length - 1) : 0;\n\n return p;\n }\n\n drawParticle(p: Particle, x: Fx8, y: Fx8) {\n // on occasion, twinkle from white to yellow\n const twinkleFlag = 0x8000;\n const rest = 0x7FFF;\n if (twinkleFlag && p.data) {\n if (this.galois.percentChance(10)) {\n p.color = 1;\n p.data &= rest;\n }\n } else if (p.color === 1 && this.galois.percentChance(1)) {\n p.color = 5;\n p.data |= twinkleFlag;\n }\n\n const selected = this.images[rest & p.data].clone();\n selected.replace(0x1, p.color);\n screen.drawTransparentImage(selected, Fx.toInt(x), Fx.toInt(y));\n }\n }\n\n export class CloudFactory extends ParticleFactory {\n minRate: number;\n maxRate: number;\n clouds: Image[];\n camera: scene.Camera;\n\n constructor(minRate: number = 8, maxRate: number = 12) {\n super();\n\n this.minRate = minRate;\n this.maxRate = maxRate;\n this.camera = game.currentScene().camera;\n\n this.clouds = [\n img`\n . . . . . . . . . . f f f . . .\n . . . . . . . . . f f 9 f f . .\n . f f f . f f f . f 9 9 9 f f .\n f f 1 f f f 1 f f f 1 1 1 9 f f\n f 1 9 1 9 9 1 9 9 1 1 1 1 9 9 f\n f 9 1 9 9 1 9 1 1 9 1 1 1 1 1 f\n f f 1 1 1 1 1 1 1 1 1 1 1 1 1 f\n . f 1 1 1 1 9 9 1 f f f 1 1 1 f\n . f 1 f f f 9 f f f . f f 1 f f\n . f f f . f f f . . . . f f f .\n `, img`\n . . . . . f f f f f . .\n . . f f . f 1 1 1 f f .\n f f f 1 f f 9 9 1 1 f .\n f 9 9 1 1 1 1 1 9 9 f f\n . f 1 9 9 1 9 1 1 1 1 f\n f 1 f f f 1 1 1 1 9 9 f\n f f f . f f f f 9 f f f\n . . . . . . . f f f . .\n `, img`\n . . . . . . . . f f f . .\n . . . . . . . f f 1 f . .\n . f f f . . . f 1 9 f f .\n f f 1 f f . f f 1 1 1 f f\n f 1 9 1 f f f 1 9 1 1 1 f\n f f 1 9 1 1 1 9 1 1 1 1 f\n . f f 9 1 1 9 9 1 1 1 f f\n . . f 1 1 9 9 1 1 1 f f .\n . . f f 1 1 1 1 1 f f . .\n . . . f f 1 f f f f . . .\n . . . . f f f . . . . . .\n `, img`\n . f f f .\n f 1 9 1 f\n f 9 1 1 f\n f f 1 f f\n . f f f .\n `, img`\n . . . . . f f f f f f .\n . . . f f f 1 1 1 1 f f\n . f f f 1 9 1 1 9 1 1 f\n f f 1 1 9 1 1 1 9 1 1 f\n f 1 1 9 1 1 1 9 1 1 1 f\n f f 1 9 1 1 1 1 1 1 1 f\n . f f 1 1 1 1 1 1 1 f f\n . . f f f f f f f f f .\n `, img`\n . f f f . .\n f f 1 f . .\n f 1 1 f f f\n f 1 9 9 1 f\n f 9 1 1 1 f\n f f 1 1 1 f\n . f 1 1 1 f\n . f f f f f\n `, img`\n . . . . . . . . . . . . f f f\n . . . . . . . . . . f f f 1 f\n f f f f f . f f f . f 1 1 1 f\n f 1 1 1 f f f 1 f . f 1 1 1 f\n f f 1 1 1 f 1 1 f f f 1 1 1 f\n . f f 1 9 1 1 9 1 1 1 1 1 1 f\n . . f 9 1 1 1 9 1 1 1 1 1 f f\n . . f 1 1 1 9 9 1 1 1 1 1 f .\n . . f 1 1 9 9 1 1 1 1 1 f f .\n . . f f f 1 1 1 1 f f f f . .\n . . . . f f 1 f f f . . . . .\n . . . . . f f f . . . . . . .\n `\n ];\n }\n\n createParticle(anchor: ParticleAnchor) {\n const p = super.createParticle(anchor);\n const yRange = anchor.height ? anchor.height >> 1 : 8;\n p.data = Math.randomRange(0, this.clouds.length - 1);\n p._x = Fx8(anchor.width ? anchor.x + (anchor.width >> 1) : anchor.x)\n p._y = Fx.add(\n Fx8(Math.randomRange(anchor.y - yRange, anchor.y + yRange)),\n Fx8(this.clouds[p.data].width >> 1)\n );\n p.vx = Fx8(-Math.randomRange(this.minRate, this.maxRate));\n\n // p.color stores information on conjoined clouds\n p.color = 0;\n if (Math.percentChance(30)) {\n const isConjoined = 1 << 0;\n const isOffsetX = Math.randomRange(0, 1) << 1;\n const isOffsetY = Math.randomRange(0, 1) << 2;\n const selection = Math.randomRange(0, this.clouds.length - 1) << 3;\n\n p.color = isConjoined | isOffsetX | isOffsetY | selection;\n }\n\n p.lifespan = Fx.toInt(\n Fx.mul(\n Fx.div(\n Fx8(screen.width + 30),\n Fx.abs(p.vx)\n ),\n Fx8(1000)\n )\n );\n\n return p;\n }\n\n drawParticle(p: particles.Particle, x: Fx8, y: Fx8) {\n const mainImage = this.clouds[p.data];\n screen.drawTransparentImage(\n mainImage,\n Fx.toInt(x),\n Fx.toInt(y)\n );\n\n if (p.color & 1) {\n const isOffsetX = (p.color >> 1) & 1;\n const isOffsetY = (p.color >> 2) & 1;\n const selection = this.clouds[p.color >> 3];\n\n const xOffset = isOffsetX ? Fx8(mainImage.width >> 2) : Fx.zeroFx8;\n const yOffset = isOffsetY ? Fx8(mainImage.height >> 2) : Fx.zeroFx8;\n\n screen.drawTransparentImage(\n selection,\n Fx.toInt(Fx.add(x, xOffset)),\n Fx.toInt(Fx.add(y, yOffset))\n );\n }\n }\n }\n}\n",
"particles.ts": "namespace particles {\n enum Flag {\n enabled = 1 << 0,\n destroyed = 1 << 1,\n relativeToCamera = 1 << 2\n }\n\n // maximum count of sources before removing previous sources\n //% whenUsed\n const MAX_SOURCES = (() => {\n const sz = control.ramSize();\n if (sz <= 1024 * 100) {\n return 8;\n } else if (sz <= 1024 * 200) {\n return 16;\n } else {\n return 50;\n }\n })();\n const TIME_PRECISION = 10; // time goes down to down to the 1<<10 seconds\n let lastUpdate: number;\n\n /**\n * A single particle\n */\n //% maxBgInstances=200\n export class Particle {\n _x: Fx8;\n _y: Fx8;\n vx: Fx8;\n vy: Fx8;\n lifespan: number;\n next: Particle;\n data?: number;\n color?: number;\n }\n\n /**\n * An anchor for a Particle to originate from\n */\n export interface ParticleAnchor {\n x: number;\n y: number;\n vx?: number;\n vy?: number;\n width?: number;\n height?: number;\n image?: Image;\n flags?: number;\n setImage?: (i: Image) => void;\n }\n\n /**\n * A source of particles\n */\n export class ParticleSource extends sprites.BaseSprite {\n /**\n * A relative ranking of this sources priority\n * When necessary, a source with a lower priority will\n * be culled before a source with a higher priority.\n */\n priority: number;\n _dt: number;\n /**\n * The anchor this source is currently attached to\n */\n anchor: ParticleAnchor;\n /**\n * Time to live in milliseconds. The lifespan decreases by 1 on each millisecond\n * and the source gets destroyed when it reaches 0.\n */\n lifespan: number;\n\n protected pFlags: number;\n protected head: Particle;\n protected timer: number;\n protected period: number;\n protected _factory: ParticleFactory;\n\n protected ax: Fx8;\n protected ay: Fx8;\n\n /**\n * @param anchor to emit particles from\n * @param particlesPerSecond rate at which particles are emitted\n * @param factory [optional] factory to generate particles with; otherwise,\n */\n constructor(anchor: ParticleAnchor, particlesPerSecond: number, factory?: ParticleFactory) {\n super(scene.SPRITE_Z)\n init();\n const sources = particleSources();\n\n // remove and immediately destroy oldest source if over MAX_SOURCES\n if (sources.length >= MAX_SOURCES) {\n sortSources(sources);\n const removedSource = sources.shift();\n removedSource.clear();\n removedSource.destroy();\n }\n\n this.pFlags = 0;\n this.setRate(particlesPerSecond);\n this.setAcceleration(0, 0);\n this.setAnchor(anchor);\n this.lifespan = undefined;\n this._dt = 0;\n this.priority = 0;\n this.setFactory(factory || particles.defaultFactory);\n sources.push(this);\n this.enabled = true;\n }\n\n __draw(camera: scene.Camera) {\n let current = this.head;\n const left = (this.pFlags & Flag.relativeToCamera) ? Fx.zeroFx8 : Fx8(camera.drawOffsetX);\n const top = (this.pFlags & Flag.relativeToCamera) ? Fx.zeroFx8 : Fx8(camera.drawOffsetY);\n\n while (current) {\n if (current.lifespan > 0)\n this.drawParticle(current, left, top);\n current = current.next;\n }\n }\n\n _update(dt: number) {\n this.timer -= dt;\n\n if (this.lifespan !== undefined) {\n this.lifespan -= dt;\n if (this.lifespan <= 0) {\n this.lifespan = undefined;\n this.destroy();\n }\n } else if (this.anchor && this.anchor.flags !== undefined && (this.anchor.flags & sprites.Flag.Destroyed)) {\n this.lifespan = 750;\n }\n\n while (this.timer < 0 && this.enabled) {\n this.timer += this.period;\n const p = this._factory.createParticle(this.anchor);\n if (!p) continue; // some factories can decide to not produce a particle\n p.next = this.head;\n this.head = p;\n }\n\n if (!this.head) return;\n\n let current = this.head;\n\n this._dt += dt;\n let fixedDt = Fx8(this._dt);\n if (fixedDt) {\n do {\n if (current.lifespan > 0) {\n current.lifespan -= dt;\n this.updateParticle(current, fixedDt)\n }\n } while (current = current.next);\n this._dt = 0;\n } else {\n do {\n current.lifespan -= dt;\n } while (current = current.next);\n }\n }\n\n _prune() {\n while (this.head && this.head.lifespan <= 0) {\n this.head = this.head.next;\n }\n\n if ((this.pFlags & Flag.destroyed) && !this.head) {\n const scene = game.currentScene();\n if (scene)\n scene.allSprites.removeElement(this);\n const sources = particleSources();\n if (sources && sources.length)\n sources.removeElement(this);\n this.anchor == undefined;\n }\n\n let current = this.head;\n while (current && current.next) {\n if (current.next.lifespan <= 0) {\n current.next = current.next.next;\n } else {\n current = current.next;\n }\n }\n }\n\n /**\n * Sets the acceleration applied to the particles\n */\n setAcceleration(ax: number, ay: number) {\n this.ax = Fx8(ax);\n this.ay = Fx8(ay);\n }\n\n /**\n * Enables or disables particles\n * @param on\n */\n setEnabled(on: boolean) {\n this.enabled = on;\n }\n\n /**\n * Sets whether the particle source is drawn relative to the camera or not\n * @param on\n */\n setRelativeToCamera(on: boolean) {\n if (on) this.pFlags |= Flag.relativeToCamera\n else this.pFlags = ~(~this.pFlags | Flag.relativeToCamera);\n }\n\n get enabled() {\n return !!(this.pFlags & Flag.enabled);\n }\n\n /**\n * Set whether this source is currently enabled (emitting particles) or not\n */\n set enabled(v: boolean) {\n if (v !== this.enabled) {\n this.pFlags = v ? (this.pFlags | Flag.enabled) : (this.pFlags ^ Flag.enabled);\n this.timer = 0;\n }\n }\n\n /**\n * Destroy the source\n */\n destroy() {\n // The `_prune` step will finishing destroying this Source once all emitted particles finish rendering\n this.enabled = false;\n this.pFlags |= Flag.destroyed;\n this._prune();\n }\n\n /**\n * Clear all particles emitted from this source\n */\n clear() {\n this.head = undefined;\n }\n\n /**\n * Set a anchor for particles to be emitted from\n * @param anchor\n */\n setAnchor(anchor: ParticleAnchor) {\n this.anchor = anchor;\n }\n\n /**\n * Sets the number of particle created per second\n * @param particlesPerSecond\n */\n setRate(particlesPerSecond: number) {\n this.period = Math.ceil(1000 / particlesPerSecond);\n this.timer = 0;\n }\n\n get factory(): ParticleFactory {\n return this._factory;\n }\n\n /**\n * Sets the particle factory\n * @param factory\n */\n setFactory(factory: ParticleFactory) {\n if (factory)\n this._factory = factory;\n }\n\n protected updateParticle(p: Particle, fixedDt: Fx8) {\n fixedDt = Fx.rightShift(fixedDt, TIME_PRECISION);\n\n p.vx = Fx.add(p.vx, Fx.mul(this.ax, fixedDt));\n p.vy = Fx.add(p.vy, Fx.mul(this.ay, fixedDt));\n\n p._x = Fx.add(p._x, Fx.mul(p.vx, fixedDt));\n p._y = Fx.add(p._y, Fx.mul(p.vy, fixedDt));\n }\n\n protected drawParticle(p: Particle, screenLeft: Fx8, screenTop: Fx8) {\n this._factory.drawParticle(p, Fx.sub(p._x, screenLeft), Fx.sub(p._y, screenTop));\n }\n }\n\n //% whenUsed\n export const defaultFactory = new particles.SprayFactory(20, 0, 60);\n\n /**\n * Creates a new source of particles attached to a sprite\n * @param sprite\n * @param particlesPerSecond number of particles created per second\n */\n export function createParticleSource(sprite: Sprite, particlesPerSecond: number): ParticleSource {\n return new ParticleSource(sprite, particlesPerSecond);\n }\n\n function init() {\n const scene = game.currentScene();\n if (scene.particleSources) return;\n scene.particleSources = [];\n lastUpdate = control.millis();\n game.onUpdate(updateParticles);\n game.onUpdateInterval(250, pruneParticles);\n }\n\n function updateParticles() {\n const sources = particleSources();\n if (!sources) return;\n sortSources(sources);\n\n const time = control.millis();\n const dt = time - lastUpdate;\n lastUpdate = time;\n\n for (let i = 0; i < sources.length; i++) {\n sources[i]._update(dt);\n }\n }\n\n function pruneParticles() {\n const sources = particleSources();\n if (sources) sources.slice(0, sources.length).forEach(s => s._prune());\n }\n\n function sortSources(sources: ParticleSource[]) {\n sources.sort((a, b) => (a.priority - b.priority || a.id - b.id));\n }\n\n /**\n * A source of particles where particles will occasionally change speed based off of each other\n */\n export class FireSource extends ParticleSource {\n protected galois: Math.FastRandom;\n\n constructor(anchor: ParticleAnchor, particlesPerSecond: number, factory?: ParticleFactory) {\n super(anchor, particlesPerSecond, factory);\n this.galois = new Math.FastRandom();\n this.z = 20;\n }\n\n updateParticle(p: Particle, fixedDt: Fx8) {\n super.updateParticle(p, fixedDt);\n if (p.next && this.galois.percentChance(30)) {\n p.vx = p.next.vx;\n p.vy = p.next.vy;\n }\n }\n }\n\n /**\n * A source of particles where the particles oscillate horizontally, and occasionally change\n * between a given number of defined states\n */\n export class BubbleSource extends ParticleSource {\n protected maxState: number;\n protected galois: Math.FastRandom;\n stateChangePercentage: number;\n oscillationPercentage: number\n\n constructor(anchor: ParticleAnchor, particlesPerSecond: number, maxState: number, factory?: ParticleFactory) {\n super(anchor, particlesPerSecond, factory);\n this.galois = new Math.FastRandom();\n this.maxState = maxState;\n this.stateChangePercentage = 3;\n this.oscillationPercentage = 4;\n }\n\n updateParticle(p: Particle, fixedDt: Fx8) {\n super.updateParticle(p, fixedDt);\n if (this.galois.percentChance(this.stateChangePercentage)) {\n if (p.data < this.maxState) {\n p.data++;\n } else if (p.data > 0) {\n p.data--;\n }\n }\n\n if (this.galois.percentChance(this.oscillationPercentage)) {\n p.vx = Fx.neg(p.vx);\n }\n }\n }\n\n export function clearAll() {\n const sources = particleSources();\n if (sources) {\n sources.forEach(s => s.clear());\n pruneParticles();\n }\n }\n\n /**\n * Stop all particle sources from creating any new particles\n */\n export function disableAll() {\n const sources = particleSources();\n if (sources) {\n sources.forEach(s => s.enabled = false);\n pruneParticles();\n }\n }\n\n /**\n * Allow all particle sources to create any new particles\n */\n export function enableAll() {\n const sources = particleSources();\n if (sources) {\n sources.forEach(s => s.enabled = true);\n pruneParticles();\n }\n }\n\n function particleSources() {\n const sources = game.currentScene().particleSources;\n return sources;\n }\n}\n",
"physics.ts": "class PhysicsEngine {\n constructor() {\n }\n\n /**\n * Adds sprite to the physics\n * @param sprite\n */\n addSprite(sprite: Sprite) { }\n\n removeSprite(sprite: Sprite) { }\n\n /** move a single sprite **/\n moveSprite(s: Sprite, dx: Fx8, dy: Fx8) { }\n\n draw() { }\n\n /** Apply physics and collisions to all sprites **/\n move(dt: number) { }\n\n setMaxSpeed(speed: number) { }\n\n overlaps(sprite: Sprite): Sprite[] { return []; }\n}\n\nconst MAX_TIME_STEP = 100; // milliseconds\nconst MIN_MOVE_GAP = Fx8(0.1);\n\nconst SPRITE_NO_TILE_OVERLAPS = SpriteFlag.GhostThroughTiles | sprites.Flag.Destroyed | SpriteFlag.RelativeToCamera;\nconst SPRITE_NO_WALL_COLLISION = SpriteFlag.GhostThroughWalls | sprites.Flag.IsClipping | sprites.Flag.Destroyed | SpriteFlag.RelativeToCamera;\nconst SPRITE_NO_SPRITE_OVERLAPS = SpriteFlag.GhostThroughSprites | sprites.Flag.Destroyed | SpriteFlag.RelativeToCamera;\n\nclass MovingSprite {\n constructor(\n public sprite: Sprite,\n // vx and vy when last updated\n public cachedVx: Fx8,\n public cachedVy: Fx8,\n // remaining x\n public dx: Fx8,\n public dy: Fx8,\n // how much to move per step\n public xStep: Fx8,\n public yStep: Fx8\n ) { }\n}\n\n/**\n * A physics engine that does simple AABB bounding box check\n */\nclass ArcadePhysicsEngine extends PhysicsEngine {\n protected sprites: Sprite[];\n protected map: sprites.SpriteMap;\n protected maxVelocity: Fx8;\n protected maxNegativeVelocity: Fx8;\n protected minSingleStep: Fx8;\n protected maxSingleStep: Fx8;\n\n constructor(maxVelocity = 500, minSingleStep = 2, maxSingleStep = 4) {\n super();\n this.sprites = [];\n this.map = new sprites.SpriteMap();\n this.maxSpeed = maxVelocity;\n this.maxStep = maxSingleStep;\n this.minStep = minSingleStep;\n }\n\n get maxSpeed(): number {\n return Fx.toInt(this.maxVelocity);\n }\n\n set maxSpeed(v: number) {\n this.maxVelocity = Fx8(v);\n this.maxNegativeVelocity = Fx.neg(this.maxVelocity);\n }\n\n get minStep(): number {\n return Fx.toInt(this.minSingleStep);\n }\n\n set minStep(v: number) {\n this.minSingleStep = Fx8(v);\n }\n\n get maxStep(): number {\n return Fx.toInt(this.maxSingleStep);\n }\n\n set maxStep(v: number) {\n this.maxSingleStep = Fx8(v);\n }\n\n setMaxSpeed(v: number) {\n this.maxSpeed = v;\n }\n\n addSprite(sprite: Sprite) {\n this.sprites.push(sprite);\n const tm = game.currentScene().tileMap;\n if (tm && tm.isOnWall(sprite)) {\n sprite.flags |= sprites.Flag.IsClipping;\n }\n }\n\n removeSprite(sprite: Sprite) {\n this.sprites.removeElement(sprite);\n }\n\n draw() {\n this.map.draw();\n }\n\n move(dt: number) {\n // Sprite movement logic is done in milliseconds to avoid rounding errors with Fx8 numbers\n const dtMs = Math.min(MAX_TIME_STEP, dt * 1000);\n const dt2 = Math.idiv(dtMs, 2);\n\n const scene = game.currentScene();\n\n const tileMap = scene.tileMap;\n const movingSprites = this.sprites\n .map(sprite => this.createMovingSprite(sprite, dtMs, dt2));\n\n // clear obstacles if moving on that axis\n this.sprites.forEach(s => {\n if (s.vx || s.vy) s.clearObstacles();\n });\n\n this.map.clear();\n this.map.resizeBuckets(this.sprites);\n\n const MAX_STEP_COUNT = Fx.toInt(\n Fx.idiv(\n Fx.imul(\n Fx.div(\n this.maxVelocity,\n this.minSingleStep\n ),\n dtMs\n ),\n 1000\n )\n );\n const overlapHandlers = scene.overlapHandlers.slice();\n\n // buffers store the moving sprites on each step; switch back and forth between the two\n let selected = 0;\n let buffers = [movingSprites, []];\n for (let count = 0; count < MAX_STEP_COUNT && buffers[selected].length !== 0; ++count) {\n const currMovers = buffers[selected];\n selected ^= 1;\n const remainingMovers = buffers[selected];\n\n for (let ms of currMovers) {\n const s = ms.sprite;\n // if still moving and speed has changed from a collision or overlap;\n // reverse direction if speed has reversed\n if (ms.cachedVx !== s._vx) {\n if (s._vx == Fx.zeroFx8) {\n ms.dx = Fx.zeroFx8;\n } else if (s._vx < Fx.zeroFx8 && ms.cachedVx > Fx.zeroFx8\n || s._vx > Fx.zeroFx8 && ms.cachedVx < Fx.zeroFx8) {\n ms.dx = Fx.neg(ms.dx);\n ms.xStep = Fx.neg(ms.xStep);\n }\n\n ms.cachedVx = s._vx;\n }\n if (ms.cachedVy !== s._vy) {\n if (s._vy == Fx.zeroFx8) {\n ms.dy = Fx.zeroFx8;\n } else if (s._vy < Fx.zeroFx8 && ms.cachedVy > Fx.zeroFx8\n || s._vy > Fx.zeroFx8 && ms.cachedVy < Fx.zeroFx8) {\n ms.dy = Fx.neg(ms.dy);\n ms.yStep = Fx.neg(ms.yStep);\n }\n\n ms.cachedVy = s._vy;\n }\n\n // identify how much to move in this step\n const stepX = Fx.abs(ms.xStep) > Fx.abs(ms.dx) ? ms.dx : ms.xStep;\n const stepY = Fx.abs(ms.yStep) > Fx.abs(ms.dy) ? ms.dy : ms.yStep;\n ms.dx = Fx.sub(ms.dx, stepX);\n ms.dy = Fx.sub(ms.dy, stepY);\n\n s._lastX = s._x;\n s._lastY = s._y;\n s._x = Fx.add(s._x, stepX);\n s._y = Fx.add(s._y, stepY);\n\n if (!(s.flags & SPRITE_NO_SPRITE_OVERLAPS)) {\n this.map.insertAABB(s);\n }\n if (tileMap && tileMap.enabled) {\n this.tilemapCollisions(ms, tileMap);\n }\n // if sprite still needs to move, add it to the next step of movements\n if (Fx.abs(ms.dx) > MIN_MOVE_GAP || Fx.abs(ms.dy) > MIN_MOVE_GAP) {\n remainingMovers.push(ms);\n }\n }\n\n // this step is done; check collisions between sprites\n this.spriteCollisions(currMovers, overlapHandlers);\n // clear moving sprites buffer for next step\n while (currMovers.length) currMovers.pop();\n }\n }\n\n protected createMovingSprite(sprite: Sprite, dtMs: number, dt2: number): MovingSprite {\n const ovx = this.constrain(sprite._vx);\n const ovy = this.constrain(sprite._vy);\n sprite._lastX = sprite._x;\n sprite._lastY = sprite._y;\n\n if (sprite._ax) {\n sprite._vx = Fx.add(\n sprite._vx,\n Fx.idiv(\n Fx.imul(\n sprite._ax,\n dtMs\n ),\n 1000\n )\n );\n } else if (sprite._fx) {\n const fx = Fx.idiv(\n Fx.imul(\n sprite._fx,\n dtMs\n ),\n 1000\n );\n const c = Fx.compare(sprite._vx, fx);\n if (c < 0) // v < f, v += f\n sprite._vx = Fx.min(Fx.zeroFx8, Fx.add(sprite._vx, fx));\n else if (c > 0) // v > f, v -= f\n sprite._vx = Fx.max(Fx.zeroFx8, Fx.sub(sprite._vx, fx));\n else\n sprite._vx = Fx.zeroFx8\n }\n\n if (sprite._ay) {\n sprite._vy = Fx.add(\n sprite._vy,\n Fx.idiv(\n Fx.imul(\n sprite._ay,\n dtMs\n ),\n 1000\n )\n );\n } else if (sprite._fy) {\n const fy = Fx.idiv(\n Fx.imul(\n sprite._fy,\n dtMs\n ),\n 1000\n );\n const c = Fx.compare(sprite._vy, fy);\n if (c < 0) // v < f, v += f\n sprite._vy = Fx.min(Fx.zeroFx8, Fx.add(sprite._vy, fy));\n else if (c > 0) // v > f, v -= f\n sprite._vy = Fx.max(Fx.zeroFx8, Fx.sub(sprite._vy, fy));\n else\n sprite._vy = Fx.zeroFx8;\n }\n\n sprite._vx = this.constrain(sprite._vx);\n sprite._vy = this.constrain(sprite._vy);\n\n const dx = Fx8(Fx.toFloat(Fx.add(sprite._vx, ovx)) * dt2 / 1000);\n const dy = Fx8(Fx.toFloat(Fx.add(sprite._vy, ovy)) * dt2 / 1000);\n\n let xStep = dx;\n let yStep = dy;\n\n // make step increments smaller until under max step size\n while (Fx.abs(xStep) > this.maxSingleStep || Fx.abs(yStep) > this.maxSingleStep) {\n if (Fx.abs(xStep) > this.minSingleStep) {\n xStep = Fx.idiv(xStep, 2);\n }\n if (Fx.abs(yStep) > this.minSingleStep) {\n yStep = Fx.idiv(yStep, 2);\n }\n }\n\n return new MovingSprite(\n sprite,\n sprite._vx,\n sprite._vy,\n dx,\n dy,\n xStep,\n yStep\n );\n }\n\n protected spriteCollisions(movedSprites: MovingSprite[], handlers: scene.OverlapHandler[]) {\n control.enablePerfCounter(\"phys_collisions\");\n if (!handlers.length) return;\n\n // sprites that have moved this step\n for (const ms of movedSprites) {\n const sprite = ms.sprite;\n if (sprite.flags & SPRITE_NO_SPRITE_OVERLAPS) continue;\n const overSprites = this.map.overlaps(ms.sprite);\n\n for (const overlapper of overSprites) {\n if (overlapper.flags & SPRITE_NO_SPRITE_OVERLAPS) continue;\n const thisKind = sprite.kind();\n const otherKind = overlapper.kind();\n\n // skip if no overlap event between these two kinds of sprites\n if (sprite._kindsOverlappedWith.indexOf(otherKind) === -1) continue;\n\n // Maintaining invariant that the sprite with the higher ID has the other sprite as an overlapper\n const higher = sprite.id > overlapper.id ? sprite : overlapper;\n const lower = higher === sprite ? overlapper : sprite;\n\n // if the two sprites are not currently engaged in an overlap event,\n // apply all matching overlap events\n if (higher._overlappers.indexOf(lower.id) === -1) {\n handlers\n .filter(h => (h.kind === thisKind && h.otherKind === otherKind)\n || (h.kind === otherKind && h.otherKind === thisKind)\n )\n .forEach(h => {\n higher._overlappers.push(lower.id);\n control.runInParallel(() => {\n if (!((sprite.flags | overlapper.flags) & SPRITE_NO_SPRITE_OVERLAPS)) {\n h.handler(\n thisKind === h.kind ? sprite : overlapper,\n thisKind === h.kind ? overlapper : sprite\n );\n }\n higher._overlappers.removeElement(lower.id);\n });\n });\n }\n }\n }\n }\n\n protected tilemapCollisions(movingSprite: MovingSprite, tm: tiles.TileMap) {\n const s = movingSprite.sprite;\n // if the sprite is already clipping into a wall,\n // allow free movement rather than randomly 'fixing' it\n if (s.flags & sprites.Flag.IsClipping) {\n if (!tm.isOnWall(s)) {\n s.flags &= ~sprites.Flag.IsClipping;\n }\n }\n if (!s.isStatic()) s.setHitbox();\n const hbox = s._hitbox;\n const tileScale = tm.scale;\n const tileSize = 1 << tileScale;\n\n const xDiff = Fx.sub(\n s._x,\n s._lastX\n );\n\n const yDiff = Fx.sub(\n s._y,\n s._lastY\n );\n\n if (!(s.flags & SPRITE_NO_WALL_COLLISION)) {\n if (xDiff !== Fx.zeroFx8) {\n const right = xDiff > Fx.zeroFx8;\n const x0 = Fx.toIntShifted(\n Fx.add(\n right ?\n Fx.add(hbox.right, Fx.oneFx8)\n :\n Fx.sub(hbox.left, Fx.oneFx8),\n Fx.oneHalfFx8\n ),\n tileScale\n );\n\n const collidedTiles: sprites.StaticObstacle[] = [];\n\n // check collisions with tiles sprite is moving towards horizontally\n for (\n let y = Fx.sub(hbox.top, yDiff);\n y < Fx.iadd(tileSize, Fx.sub(hbox.bottom, yDiff));\n y = Fx.iadd(tileSize, y)\n ) {\n const y0 = Fx.toIntShifted(\n Fx.add(\n Fx.min(\n y,\n Fx.sub(\n hbox.bottom,\n yDiff\n )\n ),\n Fx.oneHalfFx8\n ),\n tileScale\n );\n\n if (tm.isObstacle(x0, y0)) {\n const obstacle = tm.getObstacle(x0, y0);\n if (!collidedTiles.some(o => o.tileIndex === obstacle.tileIndex)) {\n collidedTiles.push(obstacle);\n }\n }\n }\n\n if (collidedTiles.length) {\n const collisionDirection = right ? CollisionDirection.Right : CollisionDirection.Left;\n s._x = Fx.sub(\n right ?\n Fx.sub(\n Fx8(x0 << tileScale),\n hbox.width\n )\n :\n Fx8((x0 + 1) << tileScale),\n hbox.ox\n );\n\n for (const tile of collidedTiles) {\n if(!(s.flags & SPRITE_NO_WALL_COLLISION)) {\n s.registerObstacle(collisionDirection, tile, tm);\n }\n }\n\n if (s.flags & sprites.Flag.DestroyOnWall) {\n s.destroy();\n } else if (s._vx === movingSprite.cachedVx) {\n // sprite collision event didn't change velocity in this direction;\n // apply normal updates\n if (s.flags & sprites.Flag.BounceOnWall) {\n if ((!right && s.vx < 0) || (right && s.vx > 0)) {\n s._vx = Fx.neg(s._vx);\n movingSprite.xStep = Fx.neg(movingSprite.xStep);\n movingSprite.dx = Fx.neg(movingSprite.dx);\n }\n } else {\n movingSprite.dx = Fx.zeroFx8;\n s._vx = Fx.zeroFx8;\n }\n } else if (Math.sign(Fx.toInt(s._vx)) === Math.sign(Fx.toInt(movingSprite.cachedVx))) {\n // sprite collision event changed velocity,\n // but still facing same direction; prevent further movement this update.\n movingSprite.dx = Fx.zeroFx8;\n }\n }\n }\n\n if (yDiff !== Fx.zeroFx8) {\n const down = yDiff > Fx.zeroFx8;\n const y0 = Fx.toIntShifted(\n Fx.add(\n down ?\n Fx.add(hbox.bottom, Fx.oneFx8)\n :\n Fx.sub(hbox.top, Fx.oneFx8),\n Fx.oneHalfFx8\n ),\n tileScale\n );\n const collidedTiles: sprites.StaticObstacle[] = [];\n\n // check collisions with tiles sprite is moving towards vertically\n for (\n let x = hbox.left;\n x < Fx.iadd(tileSize, hbox.right);\n x = Fx.iadd(tileSize, x)\n ) {\n const x0 = Fx.toIntShifted(\n Fx.add(\n Fx.min(\n x,\n hbox.right\n ),\n Fx.oneHalfFx8\n ),\n tileScale\n );\n\n if (tm.isObstacle(x0, y0)) {\n const obstacle = tm.getObstacle(x0, y0);\n if (!collidedTiles.some(o => o.tileIndex === obstacle.tileIndex)) {\n collidedTiles.push(obstacle);\n }\n }\n }\n\n if (collidedTiles.length) {\n const collisionDirection = down ? CollisionDirection.Bottom : CollisionDirection.Top;\n s._y = Fx.sub(\n down ?\n Fx.sub(\n Fx8(y0 << tileScale),\n hbox.height\n )\n :\n Fx8((y0 + 1) << tileScale),\n hbox.oy\n );\n\n for (const tile of collidedTiles) {\n if(!(s.flags & SPRITE_NO_WALL_COLLISION)) {\n s.registerObstacle(collisionDirection, tile, tm);\n }\n }\n\n if (s.flags & sprites.Flag.DestroyOnWall) {\n s.destroy();\n } else if (s._vy === movingSprite.cachedVy) {\n // sprite collision event didn't change velocity in this direction;\n // apply normal updates\n if (s.flags & sprites.Flag.BounceOnWall) {\n if ((!down && s.vy < 0) || (down && s.vy > 0)) {\n s._vy = Fx.neg(s._vy);\n movingSprite.yStep = Fx.neg(movingSprite.yStep);\n movingSprite.dy = Fx.neg(movingSprite.dy);\n }\n } else {\n movingSprite.dy = Fx.zeroFx8;\n s._vy = Fx.zeroFx8;\n }\n } else if (Math.sign(Fx.toInt(s._vy)) === Math.sign(Fx.toInt(movingSprite.cachedVy))) {\n // sprite collision event changed velocity,\n // but still facing same direction; prevent further movement this update.\n movingSprite.dy = Fx.zeroFx8;\n }\n }\n }\n }\n\n\n if (!(s.flags & SPRITE_NO_TILE_OVERLAPS)) {\n // Now that we've moved, check all of the tiles underneath the current position\n // for overlaps\n const overlappedTiles: tiles.Location[] = [];\n for (\n let x = hbox.left;\n x < Fx.iadd(tileSize, hbox.right);\n x = Fx.iadd(tileSize, x)\n ) {\n const x0 = Fx.toIntShifted(\n Fx.add(\n Fx.min(\n x,\n hbox.right\n ),\n Fx.oneHalfFx8\n ),\n tileScale\n );\n for (\n let y = hbox.top;\n y < Fx.iadd(tileSize, hbox.bottom);\n y = Fx.iadd(tileSize, y)\n ) {\n const y0 = Fx.toIntShifted(\n Fx.add(\n Fx.min(\n y,\n hbox.bottom\n ),\n Fx.oneHalfFx8\n ),\n tileScale\n );\n\n // if the sprite can move through walls, it can overlap the underlying tile.\n if (!tm.isObstacle(x0, y0) || !!(s.flags & sprites.Flag.GhostThroughWalls)) {\n overlappedTiles.push(tm.getTile(x0, y0));\n }\n }\n }\n\n if (overlappedTiles.length) {\n this.tilemapOverlaps(s, overlappedTiles);\n }\n }\n }\n\n /**\n * Given a sprite and a list of overlapped tiles, checks the overlap handlers and calls\n * the ones appropriate to the sprite and tile kind.\n * @param sprite the sprite\n * @param overlappedTiles the list of tiles the sprite is overlapping\n */\n protected tilemapOverlaps(sprite: Sprite, overlappedTiles: tiles.Location[]) {\n const alreadyHandled: tiles.Location[] = [];\n\n for (const tile of overlappedTiles) {\n if (alreadyHandled.some(l => l.column === tile.column && l.row === tile.row)) {\n continue;\n }\n alreadyHandled.push(tile);\n\n const tileOverlapHandlers = game.currentScene().tileOverlapHandlers;\n if (tileOverlapHandlers) {\n tileOverlapHandlers\n .filter(h => h.spriteKind == sprite.kind() && h.tileKind.equals(tiles.getTileImage(tile)))\n .forEach(h => h.handler(sprite, tile));\n }\n }\n }\n\n /**\n * Returns sprites that overlap with the given sprite. If type is non-zero, also filter by type.\n * @param sprite\n * @param layer\n */\n overlaps(sprite: Sprite): Sprite[] {\n return this.map.overlaps(sprite);\n }\n\n /** moves a sprite explicitly outside of the normal velocity changes **/\n public moveSprite(s: Sprite, dx: Fx8, dy: Fx8) {\n s._lastX = s._x;\n s._lastY = s._y;\n s._x = Fx.add(s._x, dx);\n s._y = Fx.add(s._y, dy);\n\n // if the sprite can collide with things, check tile map\n const tm = game.currentScene().tileMap;\n if (tm && tm.enabled) {\n const maxDist = Fx.toInt(this.maxSingleStep);\n // only check tile map if moving within a single step\n if (Math.abs(Fx.toInt(dx)) <= maxDist && Math.abs(Fx.toInt(dy)) <= maxDist) {\n const ms = new MovingSprite(\n s,\n s._vx,\n s._vy,\n dx,\n dy,\n dx,\n dy\n );\n this.tilemapCollisions(ms, tm);\n // otherwise, accept movement...\n } else if (tm.isOnWall(s) && !this.canResolveClipping(s, tm)) {\n // if no luck, flag as clipping into a wall\n s.flags |= sprites.Flag.IsClipping;\n } else {\n // or clear clipping if no longer clipping\n s.flags &= ~sprites.Flag.IsClipping;\n }\n }\n }\n\n // Attempt to resolve clipping by moving the sprite slightly up / down / left / right\n protected canResolveClipping(s: Sprite, tm: tiles.TileMap) {\n if (!s.isStatic()) s.setHitbox();\n const hbox = s._hitbox;\n const sz = 1 << tm.scale;\n const maxMove = this.maxStep;\n const origY = s._y;\n const origX = s._x;\n const l = Fx.toInt(hbox.left);\n const r = Fx.toInt(hbox.right);\n const t = Fx.toInt(hbox.top);\n const b = Fx.toInt(hbox.bottom);\n\n { // bump up and test;\n const offset = (b + 1) % sz;\n if (offset <= maxMove) {\n s._y = Fx.sub(\n s._y,\n Fx8(offset)\n );\n if (!tm.isOnWall(s)) {\n return true;\n } else {\n s._y = origY;\n }\n }\n }\n { // bump down and test;\n const offset = (Math.floor(t / sz) + 1) * sz - t;\n if (offset <= maxMove) {\n s._y = Fx.add(\n s._y,\n Fx8(offset)\n );\n if (!tm.isOnWall(s)) {\n return true;\n } else {\n s._y = origY;\n }\n }\n }\n { // bump left and test;\n const offset = (r + 1) % sz;\n if (offset <= maxMove) {\n s._x = Fx.sub(\n s._x,\n Fx8(offset)\n );\n if (!tm.isOnWall(s)) {\n return true;\n } else {\n s._x = origX;\n }\n }\n }\n { // bump right and test;\n const offset = (Math.floor(l / sz) + 1) * sz - l;\n if (offset <= maxMove) {\n s._x = Fx.add(\n s._x,\n Fx8(offset)\n );\n if (!tm.isOnWall(s)) {\n return true;\n } else {\n s._x = origX;\n }\n }\n }\n\n // no trivial adjustment worked; it's going to clip for now\n return false;\n }\n\n protected constrain(v: Fx8) {\n return Fx.max(\n Fx.min(\n this.maxVelocity,\n v\n ),\n this.maxNegativeVelocity\n );\n }\n}\n",
"prompt.ts": "namespace game {\n export interface PromptTheme {\n colorPrompt: number;\n colorInput: number;\n colorInputHighlighted: number;\n colorInputText: number;\n colorAlphabet: number;\n colorCursor: number;\n colorBackground: number;\n colorBottomBackground: number;\n colorBottomText: number;\n }\n\n /**\n * Ask the player for a string value.\n * @param message The message to display on the text-entry screen\n * @param answerLength The maximum number of characters the user can enter (1 - 24)\n */\n //% group=\"Gameplay\"\n //% weight=10 help=game/ask-for-string\n //% blockId=gameaskforstring block=\"ask for string %message || and max length %answerLength\"\n //% message.shadow=text\n //% message.defl=\"\"\n //% answerLength.defl=\"12\"\n //% answerLength.min=1\n //% answerLength.max=24\n //% group=\"Prompt\"\n export function askForString(message: any, answerLength = 12) {\n let p = new game.Prompt();\n const result = p.show(console.inspect(message), answerLength);\n return result;\n }\n\n\n //% whenUsed=true\n const font = image.font8; // FONT8-TODO\n //% whenUsed=true\n const PADDING = 4;\n //% whenUsed=true\n const PROMPT_LINE_SPACING = 2;\n\n //% whenUsed=true\n const NUM_LETTERS = 26;\n //% whenUsed=true\n const ALPHABET_ROW_LENGTH = 12;\n //% whenUsed=true\n const NUM_ROWS = Math.ceil(NUM_LETTERS / ALPHABET_ROW_LENGTH);\n //% whenUsed=true\n const INPUT_ROWS = 2;\n\n //% whenUsed=true\n const CONTENT_WIDTH = screen.width - PADDING * 2;\n //% whenUsed=true\n const CONTENT_HEIGHT = screen.height - PADDING * 2;\n //% whenUsed=true\n const CONTENT_TOP = PADDING;\n\n // Dimensions of a \"cell\" that contains a letter\n //% whenUsed=true\n const CELL_WIDTH = Math.floor(CONTENT_WIDTH / ALPHABET_ROW_LENGTH);\n //% whenUsed=true\n const CELL_HEIGHT = CELL_WIDTH;\n //% whenUsed=true\n const LETTER_OFFSET_X = Math.floor((CELL_WIDTH - font.charWidth) / 2);\n //% whenUsed=true\n const LETTER_OFFSET_Y = Math.floor((CELL_HEIGHT - font.charHeight) / 2);\n //% whenUsed=true\n const BLANK_PADDING = 1;\n //% whenUsed=true\n const ROW_LEFT = PADDING + CELL_WIDTH / 2 + Math.floor((CONTENT_WIDTH - (CELL_WIDTH * ALPHABET_ROW_LENGTH)) / 2);\n\n // Dimensions of the bottom bar\n //% whenUsed=true\n const BOTTOM_BAR_ALPHABET_MARGIN = 4;\n //% whenUsed=true\n const BOTTOM_BAR_HEIGHT = PADDING + BOTTOM_BAR_ALPHABET_MARGIN + CELL_HEIGHT;\n //% whenUsed=true\n const BOTTOM_BAR_TOP = screen.height - BOTTOM_BAR_HEIGHT;\n //% whenUsed=true\n const BOTTOM_BAR_BUTTON_WIDTH = PADDING * 2 + font.charWidth * 3;\n //% whenUsed=true\n const BOTTOM_BAR_TEXT_Y = (BOTTOM_BAR_HEIGHT - font.charHeight) / 2;\n //% whenUsed=true\n const BOTTOM_BAR_SHIFT_X = (BOTTOM_BAR_BUTTON_WIDTH - font.charWidth * 3) / 2;\n //% whenUsed=true\n const BOTTOM_BAR_CONFIRM_X = (BOTTOM_BAR_BUTTON_WIDTH - font.charWidth * 2) / 2;\n //% whenUsed=true\n const CONFIRM_BUTTON_LEFT = screen.width - BOTTOM_BAR_BUTTON_WIDTH;\n\n // Dimensions of the alphabet area\n //% whenUsed=true\n const ALPHABET_HEIGHT = NUM_ROWS * CELL_HEIGHT;\n //% whenUsed=true\n const ALPHABET_TOP = CONTENT_TOP + CONTENT_HEIGHT - ALPHABET_HEIGHT - BOTTOM_BAR_HEIGHT;\n //% whenUsed=true\n const ALPHABET_INPUT_MARGIN = 10;\n\n // Dimensions of area where text is input\n //% whenUsed=true\n const INPUT_HEIGHT = INPUT_ROWS * CELL_HEIGHT;\n //% whenUsed=true\n const INPUT_TOP = ALPHABET_TOP - INPUT_HEIGHT - ALPHABET_INPUT_MARGIN;\n\n // Dimensions of prompt message area\n //% whenUsed=true\n const PROMPT_HEIGHT = INPUT_TOP - CONTENT_TOP;\n\n //% whenUsed=true\n const lowerShiftText = \"ABC\";\n //% whenUsed=true\n const upperShiftText = \"abc\";\n //% whenUsed=true\n const digitsUpper = [\" \", \",\", \".\", \"?\", \"!\", \":\", \";\", \"\\\"\", \"(\", \")\"];\n //% whenUsed=true\n const confirmText = \"OK\";\n\n\n export class Prompt {\n theme: PromptTheme;\n\n message: string;\n answerLength: number;\n result: string;\n\n private cursor: Sprite;\n private shiftButton: Sprite;\n private confirmButton: Sprite;\n\n private letters: Sprite[];\n private inputs: Sprite[];\n\n private confirmPressed: boolean;\n private cursorRow: number;\n private cursorColumn: number;\n private upper: boolean;\n private inputIndex: number;\n private blink: boolean;\n private frameCount: number;\n\n constructor(theme?: PromptTheme) {\n if (theme) {\n this.theme = theme;\n }\n else {\n this.theme = {\n colorPrompt: 1,\n colorInput: 3,\n colorInputHighlighted: 5,\n colorInputText: 1,\n colorAlphabet: 1,\n colorCursor: 7,\n colorBackground: 15,\n colorBottomBackground: 3,\n colorBottomText: 1,\n };\n }\n this.cursorRow = 0;\n this.cursorColumn = 0;\n this.upper = false;\n this.inputIndex = 0;\n }\n\n show(message: string, answerLength: number) {\n this.message = message;\n this.answerLength = answerLength;\n this.inputIndex = 0;\n\n controller._setUserEventsEnabled(false);\n game.pushScene()\n\n this.draw();\n this.registerHandlers();\n this.confirmPressed = false;\n\n pauseUntil(() => this.confirmPressed);\n\n game.popScene();\n controller._setUserEventsEnabled(true);\n\n return this.result;\n }\n\n private draw() {\n this.drawPromptText();\n this.drawKeyboard();\n this.drawInputarea();\n this.drawBottomBar();\n }\n\n private drawPromptText() {\n const prompt = sprites.create(layoutText(this.message, CONTENT_WIDTH, PROMPT_HEIGHT, this.theme.colorPrompt), -1);\n prompt.x = screen.width / 2\n prompt.y = CONTENT_TOP + Math.floor((PROMPT_HEIGHT - prompt.height) / 2) + Math.floor(prompt.height / 2);\n }\n\n private drawInputarea() {\n const answerLeft = ROW_LEFT + Math.floor(\n ((CELL_WIDTH * ALPHABET_ROW_LENGTH) -\n CELL_WIDTH * Math.min(this.answerLength, ALPHABET_ROW_LENGTH)) / 2);\n\n this.inputs = [];\n for (let i = 0; i < this.answerLength; i++) {\n const blank = image.create(CELL_WIDTH, CELL_HEIGHT);\n this.drawInput(blank, \"\", this.theme.colorInput);\n\n const col = i % ALPHABET_ROW_LENGTH;\n const row = Math.floor(i / ALPHABET_ROW_LENGTH);\n\n const s = sprites.create(blank, -1);\n s.x = answerLeft + col * CELL_WIDTH;\n s.y = INPUT_TOP + row * CELL_HEIGHT;\n this.inputs.push(s);\n }\n }\n\n private drawKeyboard() {\n const cursorImage = image.create(CELL_WIDTH, CELL_HEIGHT);\n cursorImage.fill(this.theme.colorCursor);\n this.cursor = sprites.create(cursorImage, -1);\n this.cursor.z = -1;\n this.updateCursor();\n\n this.letters = [];\n for (let j = 0; j < 36; j++) {\n const letter = image.create(CELL_WIDTH, CELL_HEIGHT);\n\n const col2 = j % ALPHABET_ROW_LENGTH;\n const row2 = Math.floor(j / ALPHABET_ROW_LENGTH);\n\n const t = sprites.create(letter, -1);\n t.x = ROW_LEFT + col2 * CELL_WIDTH;\n t.y = ALPHABET_TOP + row2 * CELL_HEIGHT;\n\n this.letters.push(t);\n }\n this.updateKeyboard();\n }\n\n private drawBottomBar() {\n const bg = image.create(screen.width, BOTTOM_BAR_HEIGHT);\n bg.fill(this.theme.colorBottomBackground);\n\n const bgSprite = sprites.create(bg, -1);\n bgSprite.x = screen.width / 2;\n bgSprite.y = BOTTOM_BAR_TOP + BOTTOM_BAR_HEIGHT / 2;\n bgSprite.z = -1;\n\n this.shiftButton = sprites.create(image.create(BOTTOM_BAR_BUTTON_WIDTH, BOTTOM_BAR_HEIGHT), -1);\n this.shiftButton.x = Math.floor(BOTTOM_BAR_BUTTON_WIDTH / 2);\n this.shiftButton.y = BOTTOM_BAR_TOP + Math.ceil(BOTTOM_BAR_HEIGHT / 2);\n\n this.confirmButton = sprites.create(image.create(BOTTOM_BAR_BUTTON_WIDTH, BOTTOM_BAR_HEIGHT), -1);\n this.confirmButton.x = CONFIRM_BUTTON_LEFT + Math.floor(BOTTOM_BAR_BUTTON_WIDTH / 2);\n this.confirmButton.y = BOTTOM_BAR_TOP + Math.ceil(BOTTOM_BAR_HEIGHT / 2);\n\n this.updateButtons();\n }\n\n private updateButtons() {\n if (this.cursorRow === 3 && this.cursorColumn % 2 !== 1) {\n this.shiftButton.image.fill(this.theme.colorCursor);\n }\n else {\n this.shiftButton.image.fill(this.theme.colorBottomBackground);\n }\n\n if (this.upper) {\n this.shiftButton.image.print(upperShiftText, BOTTOM_BAR_SHIFT_X, BOTTOM_BAR_TEXT_Y);\n }\n else {\n this.shiftButton.image.print(lowerShiftText, BOTTOM_BAR_SHIFT_X, BOTTOM_BAR_TEXT_Y);\n }\n\n\n if (this.cursorRow === 3 && this.cursorColumn % 2) {\n this.confirmButton.image.fill(this.theme.colorCursor);\n }\n else {\n this.confirmButton.image.fill(this.theme.colorBottomBackground);\n }\n\n this.confirmButton.image.print(confirmText, BOTTOM_BAR_CONFIRM_X, BOTTOM_BAR_TEXT_Y);\n }\n\n private updateCursor() {\n if (this.cursorRow === 3) {\n this.cursor.image.fill(0);\n this.updateButtons();\n }\n else {\n this.cursor.x = ROW_LEFT + this.cursorColumn * CELL_WIDTH;\n this.cursor.y = ALPHABET_TOP + this.cursorRow * CELL_HEIGHT;\n }\n }\n\n private updateSelectedInput() {\n if (this.inputIndex < this.answerLength) {\n const u = this.inputs[this.inputIndex];\n if (this.blink) {\n this.drawInput(u.image, \"\", this.theme.colorInput);\n }\n else {\n this.drawInput(u.image, \"\", this.theme.colorInputHighlighted)\n }\n }\n }\n\n private updateKeyboard() {\n const len = this.letters.length;\n for (let k = 0; k < len; k++) {\n const img = this.letters[k].image;\n img.fill(0);\n img.print(getCharForIndex(k, this.upper), LETTER_OFFSET_X, LETTER_OFFSET_Y);\n }\n }\n\n private drawInput(img: Image, char: string, color: number) {\n img.fill(0);\n img.fillRect(BLANK_PADDING, CELL_HEIGHT - 1, CELL_WIDTH - BLANK_PADDING * 2, 1, color)\n\n if (char) {\n img.print(char, LETTER_OFFSET_X, LETTER_OFFSET_Y, this.theme.colorInputText, font);\n }\n }\n\n private registerHandlers() {\n controller.up.onEvent(SYSTEM_KEY_DOWN, () => {\n this.moveVertical(true);\n })\n\n controller.down.onEvent(SYSTEM_KEY_DOWN, () => {\n this.moveVertical(false);\n })\n\n controller.right.onEvent(SYSTEM_KEY_DOWN, () => {\n this.moveHorizontal(true);\n });\n\n controller.left.onEvent(SYSTEM_KEY_DOWN, () => {\n this.moveHorizontal(false);\n });\n\n controller.A.onEvent(SYSTEM_KEY_DOWN, () => {\n this.confirm();\n });\n\n controller.B.onEvent(SYSTEM_KEY_DOWN, () => {\n this.delete();\n });\n\n\n this.frameCount = 0;\n this.blink = true;\n\n game.onUpdate(() => {\n this.frameCount = (this.frameCount + 1) % 30;\n\n if (this.frameCount === 0) {\n this.blink = !this.blink;\n\n this.updateSelectedInput();\n }\n })\n }\n\n private moveVertical(up: boolean) {\n if (up) {\n if (this.cursorRow === 3) {\n this.cursor.image.fill(this.theme.colorCursor);\n this.cursorRow = 2;\n\n if (this.cursorColumn % 2) {\n this.cursorColumn = ALPHABET_ROW_LENGTH - 1;\n }\n else {\n this.cursorColumn = 0;\n }\n\n this.updateButtons();\n }\n else {\n this.cursorRow = Math.max(0, this.cursorRow - 1);\n }\n }\n else {\n this.cursorRow = Math.min(3, this.cursorRow + 1);\n\n if (this.cursorRow === 3) {\n // Go to closest button\n this.cursorColumn = this.cursorColumn > 5 ? 1 : 0;\n }\n }\n\n this.updateCursor();\n }\n\n private moveHorizontal(right: boolean) {\n if (right) {\n this.cursorColumn = (this.cursorColumn + 1) % ALPHABET_ROW_LENGTH;\n }\n else {\n this.cursorColumn = (this.cursorColumn + (ALPHABET_ROW_LENGTH - 1)) % ALPHABET_ROW_LENGTH;\n }\n\n this.updateCursor();\n }\n\n private confirm() {\n if (this.cursorRow === 3) {\n if (this.cursorColumn % 2) {\n this.confirmPressed = true;\n }\n else {\n this.upper = !this.upper;\n this.updateKeyboard();\n this.updateButtons();\n }\n }\n else {\n if (this.inputIndex >= this.answerLength) return;\n\n const index = this.cursorColumn + this.cursorRow * ALPHABET_ROW_LENGTH\n const letter = getCharForIndex(index, this.upper);\n\n if (!this.result) {\n this.result = letter;\n }\n else {\n this.result += letter;\n }\n\n const sprite = this.inputs[this.inputIndex];\n this.changeInputIndex(1);\n this.drawInput(sprite.image, letter, this.theme.colorInput);\n }\n }\n\n private delete() {\n if (this.inputIndex <= 0) return;\n\n if (this.inputIndex < this.answerLength) {\n this.drawInput(this.inputs[this.inputIndex].image, \"\", this.theme.colorInput);\n }\n\n this.result = this.result.substr(0, this.result.length - 1);\n\n this.changeInputIndex(-1);\n }\n\n private changeInputIndex(delta: number) {\n this.inputIndex += delta;\n this.frameCount = 0\n this.blink = false;\n this.updateSelectedInput();\n }\n }\n\n function layoutText(message: string, width: number, height: number, color: number) {\n const lineHeight = font.charHeight + PROMPT_LINE_SPACING;\n\n const lineLength = Math.floor(width / font.charWidth);\n const numLines = Math.floor(height / lineHeight);\n\n let lines: string[] = [];\n let word: string;\n let line: string;\n\n let pushWord = () => {\n if (line) {\n if (line.length + word.length + 1 > lineLength) {\n lines.push(line);\n line = word;\n }\n else {\n line = line + \" \" + word;\n }\n }\n else {\n line = word;\n }\n\n word = null;\n }\n\n for (let l = 0; l < message.length; l++) {\n const char = message.charAt(l);\n\n if (char === \" \") {\n if (word) {\n pushWord();\n }\n else {\n word = \" \";\n }\n }\n else if (!word) {\n word = char;\n }\n else {\n word += char;\n }\n }\n\n if (word) {\n pushWord();\n }\n\n if (line) {\n lines.push(line);\n }\n\n let maxLineWidth = 0;\n for (let m = 0; m < lines.length; m++) {\n maxLineWidth = Math.max(maxLineWidth, lines[m].length);\n }\n\n const actualWidth = maxLineWidth * font.charWidth;\n const actualHeight = lines.length * lineHeight;\n\n const res = image.create(actualWidth, actualHeight);\n\n for (let n = 0; n < lines.length; n++) {\n if ((n + 1) > numLines) break;\n res.print(lines[n], 0, n * lineHeight, color, font);\n }\n\n return res;\n }\n\n function getCharForIndex(index: number, upper: boolean) {\n if (index < 26) {\n return String.fromCharCode(index + (upper ? 65 : 97));\n }\n else {\n if (upper) {\n return digitsUpper[index - 26];\n }\n else {\n return \"\" + (index - 26);\n }\n }\n }\n}",
"pxt.json": "{\n \"name\": \"game\",\n \"description\": \"The game and sprite library - beta\",\n \"dependencies\": {\n \"settings\": \"*\",\n \"screen---st7735\": \"*\",\n \"mixer\": \"*\",\n \"power\": \"*\"\n },\n \"files\": [\n \"gameoverrides.ts\",\n \"basesprite.ts\",\n \"constants.ts\",\n \"controlleroverrides.ts\",\n \"controller.ts\",\n \"controllerbutton.ts\",\n \"hitbox.ts\",\n \"renderText.ts\",\n \"spritesay.ts\",\n \"sprites.ts\",\n \"sprite.ts\",\n \"extendableSprite.ts\",\n \"sprite.d.ts\",\n \"spritemap.ts\",\n \"spriteevents.ts\",\n \"spriteset.ts\",\n \"spritekind.ts\",\n \"metrics.ts\",\n \"obstacle.ts\",\n \"physics.ts\",\n \"info.ts\",\n \"background.ts\",\n \"tilemap.ts\",\n \"camera.ts\",\n \"renderable.ts\",\n \"scene.ts\",\n \"scenes.ts\",\n \"textDialogs.ts\",\n \"game.ts\",\n \"gameutil.ts\",\n \"prompt.ts\",\n \"numberprompt.ts\",\n \"ask.ts\",\n \"targetoverrides.cpp\",\n \"targetoverrides.ts\",\n \"controllerbuttons.cpp\",\n \"mathUtil.ts\",\n \"systemmenu.ts\",\n \"systemmenuicons.ts\",\n \"console.ts\",\n \"fieldeditors.ts\",\n \"particles.ts\",\n \"particlefactories.ts\",\n \"particleeffects.ts\",\n \"effects.ts\",\n \"texteffects.ts\",\n \"assetTemplates.ts\",\n \"animation.ts\",\n \"multiplayer.cpp\",\n \"multiplayer.ts\",\n \"keymap.cpp\",\n \"keymap.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"renderText.ts": "namespace sprites {\n export class RenderText {\n linebreaks: number[];\n font: image.Font;\n height: number;\n width: number;\n\n constructor(public text: string, maxWidth: number) {\n this.font = image.getFontForText(text);\n\n this.setMaxWidth(maxWidth);\n }\n\n draw(canvas: Image, left: number, top: number, color: number, lineStart?: number, lineEnd?: number) {\n if (lineStart === undefined) lineStart = 0;\n if (lineEnd === undefined) lineEnd = this.linebreaks.length + 1;\n\n for (let i = lineStart; i < lineEnd; i++) {\n this.drawLine(canvas, left, top, i, color);\n top += this.font.charHeight;\n }\n }\n\n drawLine(canvas: Image, left: number, top: number, lineIndex: number, color: number) {\n const start = this.lineStart(lineIndex);\n const end = this.lineEnd(lineIndex);\n\n for (let i = start; i < end; i++) {\n canvas.print(this.text.charAt(i), left, top, color, this.font);\n left += this.font.charWidth;\n }\n }\n\n drawPartial(canvas: Image, left: number, top: number, color: number, lengthToDraw: number, lineStart?: number, lineEnd?: number) {\n if (lineStart === undefined) lineStart = 0;\n if (lineEnd === undefined) lineEnd = this.linebreaks.length + 1;\n\n let currentTextIndex = 0;\n for (let i = lineStart; i < lineEnd; i++) {\n currentTextIndex = this.drawPartialLine(canvas, left, top, i, color, currentTextIndex, lengthToDraw);\n top += this.font.charHeight;\n if (currentTextIndex >= lengthToDraw) return false;\n }\n\n return true;\n }\n\n drawPartialLine(canvas: Image, left: number, top: number, lineIndex: number, color: number, currentTextIndex: number, lengthToDraw: number) {\n const start = this.lineStart(lineIndex);\n const end = this.lineEnd(lineIndex);\n\n for (let i = start; i < end; i++) {\n canvas.print(this.text.charAt(i), left, top, color, this.font);\n left += this.font.charWidth;\n\n if (currentTextIndex + (i - start) >= lengthToDraw) {\n return lengthToDraw;\n }\n }\n return currentTextIndex + end - start;\n }\n\n calculatePartialHeight(startLine: number, lengthToDraw: number) {\n if (this.linebreaks.length === 0) return this.font.charHeight;\n\n let current = 0;\n\n for (let i = startLine; i < this.linebreaks.length + 1; i++) {\n current += this.lineEnd(i) - this.lineStart(i);\n if (current > lengthToDraw) return (i - startLine + 1) * this.font.charHeight\n }\n return this.height;\n }\n\n lineHeight() {\n return this.font.charHeight;\n }\n\n setMaxWidth(maxWidth: number) {\n this.linebreaks = getLineBreaks(this.text, [Math.idiv(maxWidth, this.font.charWidth)]);\n this.height = (this.linebreaks.length + 1) * this.font.charHeight;\n\n this.width = 0;\n for (let i = 0; i < this.linebreaks.length + 1; i++) {\n this.width = Math.max(this.lineEnd(i) - this.lineStart(i), this.width);\n }\n this.width *= this.font.charWidth;\n }\n\n printableCharacters() {\n let total = 0;\n for (let i = 0; i < this.linebreaks.length + 1; i++) {\n total += this.lineEnd(i) - this.lineStart(i);\n }\n return total;\n }\n\n lineEnd(lineIndex: number) {\n const prevEnd = lineIndex > 0 ? this.linebreaks[lineIndex - 1] : 0;\n let end = lineIndex < this.linebreaks.length ? this.linebreaks[lineIndex] : this.text.length;\n let didMove = false;\n\n // Trim trailing whitespace\n while (end > prevEnd) {\n if (this.text.charCodeAt(end) <= 32) {\n end--;\n didMove = true\n }\n else if (this.text.charAt(end) === \"n\" && this.text.charAt(end - 1) === \"\\\\\" && end - 1 > prevEnd) {\n end -= 2;\n didMove = true\n }\n else {\n break;\n }\n }\n return didMove ? end + 1 : end;\n }\n\n lineStart(lineIndex: number) {\n let start = lineIndex > 0 ? this.linebreaks[lineIndex - 1] : 0;\n\n // Trim leading whitespace\n while (start < this.text.length) {\n if (this.text.charCodeAt(start) <= 32) {\n start ++;\n }\n else if (this.text.charAt(start) === \"\\\\\" && this.text.charAt(start + 1) === \"n\" && start + 1 < this.text.length) {\n start += 2;\n }\n else {\n break;\n }\n }\n\n return start;\n }\n\n widthOfLine(lineIndex: number, fullTextOffset?: number) {\n if (fullTextOffset != undefined) {\n return (Math.min(this.lineEnd(lineIndex), fullTextOffset + 1) - this.lineStart(lineIndex)) * this.font.charWidth;\n }\n return (this.lineEnd(lineIndex) - this.lineStart(lineIndex)) * this.font.charWidth;\n }\n\n widthOfLines(lineStartIndex: number, lineEndIndex: number, offset?: number) {\n if (this.linebreaks.length === 0) return this.widthOfLine(0, offset);\n\n let width = 0;\n let fullTextOffset: number;\n for (let i = lineStartIndex; i < Math.min(lineEndIndex, this.linebreaks.length + 1); i++) {\n if (offset != undefined) {\n fullTextOffset = this.lineStart(i) + offset;\n offset -= this.lineEnd(i) - this.lineStart(i);\n }\n if (fullTextOffset !== undefined && this.lineStart(i) > fullTextOffset) break;\n width = Math.max(width, this.widthOfLine(i, fullTextOffset));\n }\n return width;\n }\n }\n\n\n function isBreakCharacter(charCode: number) {\n return charCode <= 32 ||\n (charCode >= 58 && charCode <= 64) ||\n (charCode >= 91 && charCode <= 96) ||\n (charCode >= 123 && charCode <= 126);\n }\n\n function getLineBreaks(text: string, lineLengths: number[]): number[] {\n const result: number[] = [];\n\n let lastBreakLocation = 0;\n let lastBreak = 0;\n let line = 0;\n let lineLength = lineLengths[line];\n\n function nextLine() {\n line++;\n lineLength = lineLengths[line % lineLengths.length];\n }\n\n for (let index = 0; index < text.length; index++) {\n if (text.charAt(index) === \"\\n\") {\n result.push(index);\n index++;\n lastBreak = index;\n nextLine();\n }\n // Handle \\\\n in addition to \\n because that's how it gets converted from blocks\n else if (text.charAt(index) === \"\\\\\" && text.charAt(index + 1) === \"n\") {\n result.push(index);\n lastBreak = index;\n index += 2;\n nextLine();\n }\n else if (isBreakCharacter(text.charCodeAt(index))) {\n lastBreakLocation = index;\n }\n\n if (index - lastBreak === lineLength) {\n if (lastBreakLocation === index || lastBreakLocation <= lastBreak) {\n result.push(index);\n lastBreak = index;\n nextLine();\n }\n else {\n result.push(lastBreakLocation);\n lastBreak = lastBreakLocation;\n nextLine();\n }\n }\n }\n\n return result;\n }\n\n enum RenderTextAnimationState {\n Idle,\n Printing,\n Pausing\n }\n\n export class RenderTextAnimation {\n protected tickPeriod: number;\n protected state: RenderTextAnimationState;\n protected pageLine: number;\n protected timer: number;\n protected pauseMillis: number;\n protected onTickCB: () => void;\n protected onEndCB: () => void;\n protected prevOffset: number;\n\n constructor(public text: RenderText, public height: number) {\n this.state = RenderTextAnimationState.Idle;\n this.timer = -1;\n\n this.pageLine = 0;\n this.setPauseLength(1000);\n this.setTextSpeed(30);\n }\n\n start() {\n this.state = RenderTextAnimationState.Printing;\n this.timer = control.millis();\n }\n\n numPages() {\n const maxLinesPerPage = Math.idiv(this.height, this.text.lineHeight()) + 1;\n return Math.floor((this.text.linebreaks.length + 1) / maxLinesPerPage);\n }\n\n setPauseLength(millis: number) {\n this.pauseMillis = millis;\n }\n\n setTextSpeed(charactersPerSecond: number) {\n this.tickPeriod = 1000/ charactersPerSecond;\n }\n\n currentHeight() {\n const minHeight = this.text.lineHeight();\n const maxHeight = Math.max(\n Math.min(\n Math.idiv(this.height, this.text.lineHeight()) + 1,\n this.text.linebreaks.length + 1 - this.pageLine\n ) * this.text.lineHeight(),\n minHeight\n );\n\n\n if (this.state === RenderTextAnimationState.Printing) {\n return Math.max(Math.min(\n this.text.calculatePartialHeight(this.pageLine, this.currentOffset()),\n maxHeight\n ), minHeight)\n }\n else if (this.state === RenderTextAnimationState.Pausing) {\n return maxHeight\n }\n else {\n return 0;\n }\n }\n\n currentWidth() {\n return this.text.widthOfLines(\n this.pageLine,\n this.pageLine + Math.idiv(this.currentHeight(), this.text.lineHeight()) + 1,\n this.state === RenderTextAnimationState.Printing ? this.currentOffset() : undefined\n );\n }\n\n currentOffset() {\n return Math.idiv(control.millis() - this.timer, this.tickPeriod)\n }\n\n isDone() {\n return this.state === RenderTextAnimationState.Idle;\n }\n\n cancel() {\n this.state = RenderTextAnimationState.Idle;\n }\n\n onCharacterPrinted(cb: () => void) {\n this.onTickCB = cb;\n }\n\n onAnimationEnd(cb: () => void) {\n this.onEndCB = cb;\n }\n\n draw(canvas: Image, left: number, top: number, color: number) {\n if (this.state === RenderTextAnimationState.Idle) return;\n else if (this.state === RenderTextAnimationState.Printing) {\n const pageFinished = this.text.drawPartial(\n canvas,\n left,\n top,\n color,\n this.currentOffset(),\n this.pageLine,\n this.pageLine + Math.idiv(this.height, this.text.lineHeight()) + 1\n );\n\n if (this.onTickCB && this.prevOffset !== this.currentOffset()) {\n this.onTickCB();\n }\n\n if (pageFinished) {\n this.state = RenderTextAnimationState.Pausing;\n this.timer = this.pauseMillis\n }\n }\n else {\n this.text.draw(\n canvas,\n left,\n top,\n color,\n this.pageLine,\n this.pageLine + Math.idiv(this.height, this.text.lineHeight()) + 1\n );\n\n this.timer -= game.currentScene().eventContext.deltaTimeMillis;\n\n if (this.timer < 0) {\n this.pageLine += Math.idiv(this.height, this.text.lineHeight()) + 1;\n if (this.pageLine > this.text.linebreaks.length) {\n this.state = RenderTextAnimationState.Idle;\n if (this.onEndCB) this.onEndCB();\n }\n else {\n this.state = RenderTextAnimationState.Printing;\n this.timer = control.millis();\n }\n }\n }\n\n this.prevOffset = this.currentOffset();\n }\n }\n}",
"renderable.ts": "namespace scene {\n export class Renderable extends sprites.BaseSprite {\n public constructor(\n protected handler: (target: Image, camera: Camera) => void,\n protected shouldBeVisible: () => boolean,\n z: number,\n ) {\n super(z);\n }\n\n __visible(): boolean {\n return this.shouldBeVisible();\n }\n\n __drawCore(camera: scene.Camera) {\n this.handler(screen, camera);\n }\n\n destroy() {\n const s = game.currentScene();\n s.allSprites.removeElement(this);\n }\n }\n\n export function createRenderable(\n z: number,\n handler: (target: Image, camera: Camera) => void,\n shouldBeVisible?: () => boolean\n ): Renderable {\n const renderable = new Renderable(\n handler,\n shouldBeVisible || (() => true),\n z,\n );\n\n return renderable;\n }\n}",
"scene.ts": "interface SparseArray {\n [index: number]: T;\n}\n\n/**\n * Control the background, tiles and camera\n */\nnamespace scene {\n export enum Flag {\n NeedsSorting = 1 << 0, // indicates the sprites in the scene need to be sorted before rendering\n SeeThrough = 1 << 1, // if set, render the previous scene 'below' this one as the background\n IsRendering = 1 << 2, // if set, the scene is currently being rendered to the screen\n }\n\n export class SpriteHandler {\n constructor(\n public kind: number,\n public handler: (sprite: Sprite) => void\n ) { }\n }\n\n export class OverlapHandler {\n constructor(\n public kind: number,\n public otherKind: number,\n public handler: (sprite: Sprite, otherSprite: Sprite) => void\n ) { }\n }\n\n export class TileWallHandler {\n constructor(\n public spriteKind: number,\n public handler: (sprite: Sprite, location: tiles.Location) => void\n ) { }\n }\n\n export class TileOverlapHandler {\n constructor(\n public spriteKind: number,\n public tileKind: Image,\n public handler: (sprite: Sprite, location: tiles.Location) => void\n ) { }\n }\n\n\n export class GameForeverHandler {\n public lock: boolean;\n constructor(\n public handler: () => void\n ) { }\n }\n\n // frame handler priorities\n export const CONTROLLER_PRIORITY = 8;\n export const UPDATE_CONTROLLER_PRIORITY = 13;\n export const FOLLOW_SPRITE_PRIORITY = 14;\n export const PHYSICS_PRIORITY = 15;\n export const ANIMATION_UPDATE_PRIORITY = 15;\n export const CONTROLLER_SPRITES_PRIORITY = 13;\n export const UPDATE_INTERVAL_PRIORITY = 19;\n export const UPDATE_PRIORITY = 20;\n export const PRE_RENDER_UPDATE_PRIORITY = 55;\n export const RENDER_BACKGROUND_PRIORITY = 60;\n export const RENDER_SPRITES_PRIORITY = 90;\n export const RENDER_DIAGNOSTICS_PRIORITY = 150;\n export const MULTIPLAYER_SCREEN_PRIORITY = 190;\n export const UPDATE_SCREEN_PRIORITY = 200;\n\n // default rendering z indices\n export const ON_PAINT_Z = -20;\n export const TILE_MAP_Z = -1;\n export const SPRITE_Z = 0;\n export const ON_SHADE_Z = 80;\n export const HUD_Z = 100;\n\n export class Scene {\n eventContext: control.EventContext;\n background: Background;\n tileMap: tiles.TileMap;\n allSprites: SpriteLike[];\n private spriteNextId: number;\n spritesByKind: SparseArray;\n physicsEngine: PhysicsEngine;\n camera: scene.Camera;\n flags: number;\n destroyedHandlers: SpriteHandler[];\n createdHandlers: SpriteHandler[];\n overlapHandlers: OverlapHandler[];\n overlapMap: SparseArray;\n tileOverlapHandlers: TileOverlapHandler[];\n collisionHandlers: SpriteHandler[][];\n wallCollisionHandlers: TileWallHandler[];\n gameForeverHandlers: GameForeverHandler[];\n particleSources: particles.ParticleSource[];\n controlledSprites: controller.ControlledSprite[][];\n followingSprites: sprites.FollowingSprite[];\n buttonEventHandlers: controller.ButtonEventHandlerState[];\n\n private _millis: number;\n private _data: any;\n\n // a set of functions that need to be called when a scene is being initialized\n static initializers: ((scene: Scene) => void)[] = [];\n\n constructor(eventContext: control.EventContext, protected previousScene?: Scene) {\n this.eventContext = eventContext;\n this.flags = 0;\n this.physicsEngine = new ArcadePhysicsEngine();\n this.camera = new scene.Camera();\n this.background = new Background(this.camera);\n this.destroyedHandlers = [];\n this.createdHandlers = [];\n this.overlapHandlers = [];\n this.overlapMap = {};\n this.tileOverlapHandlers = [];\n this.collisionHandlers = [];\n this.wallCollisionHandlers = [];\n this.gameForeverHandlers = [];\n this.spritesByKind = {};\n this.controlledSprites = [];\n this.buttonEventHandlers = [];\n this._data = {};\n this._millis = 0;\n }\n\n init() {\n if (this.allSprites) return;\n\n power.poke(); // keep game alive a little more\n this.allSprites = [];\n this.spriteNextId = 0;\n // update controller state\n this.eventContext.registerFrameHandler(CONTROLLER_PRIORITY, () => {\n this._millis += this.eventContext.deltaTimeMillis;\n control.enablePerfCounter(\"controller_update\")\n controller.__update(this.eventContext.deltaTime);\n })\n // controller update 13\n this.eventContext.registerFrameHandler(CONTROLLER_SPRITES_PRIORITY, controller._moveSprites);\n // sprite following 14\n // apply physics and collisions 15\n this.eventContext.registerFrameHandler(PHYSICS_PRIORITY, () => {\n control.enablePerfCounter(\"physics and collisions\")\n this.physicsEngine.move(this.eventContext.deltaTime);\n });\n // user update interval 19s\n\n // user update 20\n\n // prerender update 55\n this.eventContext.registerFrameHandler(PRE_RENDER_UPDATE_PRIORITY, () => {\n const dt = this.eventContext.deltaTime;\n this.camera.update();\n\n for (const s of this.allSprites)\n s.__update(this.camera, dt);\n })\n\n // render background 60\n\n // render 90\n this.eventContext.registerFrameHandler(RENDER_SPRITES_PRIORITY, () => {\n control.enablePerfCounter(\"scene_draw\");\n this.render();\n });\n // render diagnostics\n this.eventContext.registerFrameHandler(RENDER_DIAGNOSTICS_PRIORITY, () => {\n if (game.stats && control.EventContext.onStats) {\n control.EventContext.onStats(\n control.EventContext.lastStats +\n ` sprites:${this.allSprites.length}`\n )\n }\n if (game.debug)\n this.physicsEngine.draw();\n game.consoleOverlay.draw();\n // check for power deep sleep\n power.checkDeepSleep();\n });\n // update screen\n this.eventContext.registerFrameHandler(UPDATE_SCREEN_PRIORITY, control.__screen.update);\n // register additional components\n Scene.initializers.forEach(f => f(this));\n }\n\n get data() {\n return this._data;\n }\n\n /**\n * Gets the elapsed time in the scene\n */\n millis(): number {\n return this._millis;\n }\n\n addSprite(sprite: SpriteLike) {\n this.allSprites.push(sprite);\n sprite.id = this.spriteNextId++;\n }\n\n destroy() {\n this.eventContext = undefined;\n this.background = undefined;\n this.tileMap = undefined;\n this.allSprites = undefined;\n this.spriteNextId = undefined;\n this.spritesByKind = undefined;\n this.physicsEngine = undefined;\n this.camera = undefined;\n this.flags = undefined;\n this.destroyedHandlers = undefined;\n this.createdHandlers = undefined;\n this.overlapHandlers = undefined;\n this.tileOverlapHandlers = undefined;\n this.collisionHandlers = undefined;\n this.wallCollisionHandlers = undefined;\n this.gameForeverHandlers = undefined;\n this._data = undefined;\n }\n\n /**\n * Renders the current frame as an image\n */\n render() {\n // bail out from recursive or parallel call.\n if (this.flags & scene.Flag.IsRendering) return;\n this.flags |= scene.Flag.IsRendering;\n\n control.enablePerfCounter(\"render background\")\n if ((this.flags & scene.Flag.SeeThrough) && this.previousScene) {\n this.previousScene.render();\n } else {\n this.background.draw();\n }\n\n control.enablePerfCounter(\"sprite sort\")\n if (this.flags & Flag.NeedsSorting) {\n this.allSprites.sort(function (a, b) { return a.z - b.z || a.id - b.id; })\n this.flags &= ~scene.Flag.NeedsSorting;\n }\n\n control.enablePerfCounter(\"sprite draw\")\n for (const s of this.allSprites) {\n s.__draw(this.camera);\n }\n\n this.flags &= ~scene.Flag.IsRendering;\n }\n }\n}\n",
"scenes.ts": "/**\n * Control the background, tiles and camera\n */\n\nenum CameraProperty {\n //% block=\"x\"\n X,\n //% block=\"y\"\n Y,\n //% block=\"left\"\n Left,\n //% block=\"right\"\n Right,\n //% block=\"top\"\n Top,\n //% block=\"bottom\"\n Bottom\n}\n\n//% weight=88 color=\"#4b6584\" icon=\"\\uf1bb\"\n//% groups='[\"Screen\", \"Camera\", \"Effects\", \"Tilemaps\", \"Tilemap Operations\", \"Locations\"]'\n//% blockGap=8\nnamespace scene {\n /**\n * Get the width of the screen in pixels\n */\n //% blockId=scenescreenwidth block=\"screen width\"\n //% group=\"Screen\"\n //% weight=100 blockGap=8\n //% help=scene/screen-width\n export function screenWidth(): number {\n return screen.width;\n }\n\n /**\n * Gets the height of the screen in pixels\n */\n //% blockId=scenescreenheight block=\"screen height\"\n //% group=\"Screen\"\n //% weight=99\n //% help=scene/screen-width\n export function screenHeight(): number {\n return screen.height;\n }\n\n /**\n * Set the game background color\n * @param color\n */\n //% group=\"Screen\"\n //% weight=25\n //% blockId=gamesetbackgroundcolor block=\"set background color to %color=colorindexpicker\"\n //% help=scene/set-background-color\n export function setBackgroundColor(color: number) {\n const scene = game.currentScene();\n scene.background.color = color;\n }\n\n /**\n * Get the game background color\n * @param color\n */\n //% group=\"Screen\"\n //% weight=22\n //% blockId=gamebackgroundcolor block=\"background color\"\n //% help=scene/background-color\n export function backgroundColor() : number {\n const scene = game.currentScene();\n return scene.background.color;\n }\n\n /**\n * Set a picture as the background\n */\n //% group=\"Screen\"\n //% weight=24\n //% blockId=gamesetbackgroundimage block=\"set background image to %img=background_image_picker\"\n //% help=scene/set-background-image\n export function setBackgroundImage(img: Image) {\n const scene = game.currentScene();\n scene.background.image = img;\n }\n\n /**\n * Get the current background image\n */\n //% weight=22\n //% group=\"Screen\"\n //% blockId=gamebackgroundimage block=\"background image\"\n //% help=scene/background-image\n export function backgroundImage(): Image {\n const scene = game.currentScene();\n return scene.background.image;\n }\n\n /**\n * Adds a moving background layer\n * @param distance distance of the layer which determines how fast it moves, eg: 10\n * @param img\n */\n //% group=\"Screen\"\n //% weight=10\n export function addBackgroundLayer(image: Image, distance?: number, alignment?: BackgroundAlignment) {\n const scene = game.currentScene();\n if (image)\n scene.background.addLayer(image, distance || 100, alignment || BackgroundAlignment.Bottom);\n }\n\n /**\n * Set the map for placing tiles in the scene\n * @param map\n * @param scale\n */\n export function setTileMapLevel(map: tiles.TileMapData) {\n const scene = game.currentScene();\n if (!scene.tileMap)\n scene.tileMap = new tiles.TileMap();\n scene.tileMap.setData(map);\n }\n\n /**\n * Shake the camera\n * @param sprite\n */\n //% blockId=camerashake block=\"camera shake by %amplitude pixels for %duration ms\"\n //% amplitude.min=1 amplitude.max=8 amplitude.defl=4\n //% duration.shadow=timePicker duration.defl=500\n //% group=\"Camera\"\n //% help=scene/camera-shake\n //% weight=90\n export function cameraShake(amplitude: number = 4, duration: number = 500) {\n const scene = game.currentScene();\n scene.camera.shake(amplitude, duration);\n }\n\n /**\n * Set the game camera to follow a sprite\n * @param sprite\n */\n //% blockId=camerafollow block=\"camera follow sprite %sprite=variables_get(mySprite)\"\n //% group=\"Camera\"\n //% help=scene/camera-follow-sprite\n //% weight=100\n export function cameraFollowSprite(sprite: Sprite) {\n const scene = game.currentScene();\n scene.camera.sprite = sprite;\n }\n\n /**\n * Moves the camera center to a coordinate position\n * @param sprite\n */\n //% blockId=camerapos block=\"center camera at x %x y %y\"\n //% group=\"Camera\"\n //% help=scene/center-camera-at\n //% weight=80\n export function centerCameraAt(x: number, y: number) {\n const scene = game.currentScene();\n scene.camera.sprite = undefined;\n scene.camera.offsetX = x - (screen.width >> 1);\n scene.camera.offsetY = y - (screen.height >> 1);\n }\n\n /**\n * Returns the x coordinate of the camera (the left of the screen)\n */\n //% blockId=cameraleft block=\"camera left\"\n //% group=\"Camera\"\n //% help=scene/camera-left\n //% deprecated=true\n export function cameraLeft() {\n const scene = game.currentScene();\n return scene.camera.drawOffsetX;\n }\n\n /**\n * Returns the y coordinate of the camera (the top of the screen)\n */\n //% blockId=cameratop block=\"camera top\"\n //% group=\"Camera\"\n //% help=scene/camera-top\n //% deprecated=true\n export function cameraTop() {\n const scene = game.currentScene();\n return scene.camera.drawOffsetY;\n }\n\n /**\n * Returns the specified camera property\n * @param property The property to get\n */\n //% blockId=cameraproperty block=\"camera $property\"\n //% group=\"Camera\"\n //% help=scene/camera-property\n //% weight=70\n export function cameraProperty(property: CameraProperty): number {\n const scene = game.currentScene();\n switch (property) {\n case CameraProperty.X: return scene.camera.x;\n case CameraProperty.Y: return scene.camera.y;\n case CameraProperty.Left: return scene.camera.left;\n case CameraProperty.Right: return scene.camera.right;\n case CameraProperty.Top: return scene.camera.top;\n case CameraProperty.Bottom: return scene.camera.bottom;\n }\n }\n}\n",
"sprite.d.ts": "declare interface Sprite {\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"z (depth)\"\n z: number;\n // this is defined in the superclass BaseSprite, so it needs to be declared here to show up\n // in the blocks for sprites.\n}",
"sprite.ts": "enum SpriteFlag {\n //% block=\"ghost\"\n Ghost = sprites.Flag.Ghost,\n //% block=\"auto destroy\"\n AutoDestroy = sprites.Flag.AutoDestroy,\n //% block=\"stay in screen\"\n StayInScreen = sprites.Flag.StayInScreen,\n //% block=\"destroy on wall\"\n DestroyOnWall = sprites.Flag.DestroyOnWall,\n //% block=\"bounce on wall\"\n BounceOnWall = sprites.Flag.BounceOnWall,\n //% block=\"show physics\"\n ShowPhysics = sprites.Flag.ShowPhysics,\n //% block=\"invisible\"\n Invisible = sprites.Flag.Invisible,\n //% block=\"relative to camera\"\n RelativeToCamera = sprites.Flag.RelativeToCamera,\n //% block=\"ghost through sprites\"\n GhostThroughSprites = sprites.Flag.GhostThroughSprites,\n //% block=\"ghost through tiles\"\n GhostThroughTiles = sprites.Flag.GhostThroughTiles,\n //% block=\"ghost through walls\"\n GhostThroughWalls = sprites.Flag.GhostThroughWalls,\n}\n\nenum TileDirection {\n //% block=\"left\"\n Left = 0,\n //% block=\"top\"\n Top = 1,\n //% block=\"right\"\n Right = 2,\n //% block=\"bottom\"\n Bottom = 3,\n //% block=\"center\"\n Center = 4\n}\n\nenum CollisionDirection {\n //% block=\"left\"\n Left = 0,\n //% block=\"top\"\n Top = 1,\n //% block=\"right\"\n Right = 2,\n //% block=\"bottom\"\n Bottom = 3\n}\n\nenum FlipOption {\n //% block=none\n None,\n //% block=\"flip x\"\n FlipX,\n //% block=\"flip y\"\n FlipY,\n //% block=\"flip x+y\"\n FlipXY\n}\n\nenum ScaleDirection {\n //% block=\"vertically\"\n Vertically = 0x01,\n //% block=\"horizontally\"\n Horizontally = 0x02,\n //% block=\"uniformly\"\n Uniformly = Vertically | Horizontally,\n}\n\nenum ScaleAnchor {\n //% block=\"middle\"\n Middle = 0,\n //% block=\"top\"\n Top = 0x01,\n //% block=\"left\"\n Left = 0x02,\n //% block=\"right\"\n Right = 0x04,\n //% block=\"bottom\"\n Bottom = 0x08,\n //% block=\"top left\"\n TopLeft = Top | Left,\n //% block=\"top right\"\n TopRight = Top | Right,\n //% block=\"bottom left\"\n BottomLeft = Bottom | Left,\n //% block=\"bottom right\"\n BottomRight = Bottom | Right,\n}\n\n/**\n * A sprite on the screen\n **/\n//% blockNamespace=sprites color=\"#3B6FEA\" blockGap=8\nclass Sprite extends sprites.BaseSprite {\n _x: Fx8\n _y: Fx8\n _vx: Fx8\n _vy: Fx8\n _ax: Fx8\n _ay: Fx8\n _fx: Fx8 // friction\n _fy: Fx8 // friction\n _sx: Fx8 // scale\n _sy: Fx8 // scale\n _width: Fx8 // scaled width\n _height: Fx8 // scaled height\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"x\" callInDebugger\n get x(): number {\n return Fx.toFloat(Fx.add(this._x, Fx.div(this._width, Fx.twoFx8)));\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"x\"\n set x(v: number) {\n this.left = v - (this.width / 2)\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"y\" callInDebugger\n get y(): number {\n return Fx.toFloat(Fx.add(this._y, Fx.div(this._height, Fx.twoFx8)));\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"y\"\n set y(v: number) {\n this.top = v - (this.height / 2)\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"vx (velocity x)\" callInDebugger\n get vx(): number {\n return Fx.toFloat(this._vx)\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"vx (velocity x)\"\n set vx(v: number) {\n this._vx = Fx8(v)\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"vy (velocity y)\" callInDebugger\n get vy(): number {\n return Fx.toFloat(this._vy)\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"vy (velocity y)\"\n set vy(v: number) {\n this._vy = Fx8(v)\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"ax (acceleration x)\" callInDebugger\n get ax(): number {\n return Fx.toFloat(this._ax)\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"ax (acceleration x)\"\n set ax(v: number) {\n this._ax = Fx8(v)\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"ay (acceleration y)\" callInDebugger\n get ay(): number {\n return Fx.toFloat(this._ay)\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"ay (acceleration y)\"\n set ay(v: number) {\n this._ay = Fx8(v)\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"fx (friction x)\" callInDebugger\n get fx(): number {\n return Fx.toFloat(this._fx)\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"fx (friction x)\"\n set fx(v: number) {\n this._fx = Fx8(Math.max(0, v))\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"fy (friction y)\" callInDebugger\n get fy(): number {\n return Fx.toFloat(this._fy)\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"fy (friction y)\"\n set fy(v: number) {\n this._fy = Fx8(Math.max(0, v))\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"sx (scale x)\" callInDebugger\n get sx(): number {\n return Fx.toFloat(this._sx);\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"sx (scale x)\"\n set sx(v: number) {\n const x = this.x;\n this._sx = Fx8(Math.max(0, v));\n this.recalcSize();\n this.left = x - this.width / 2;\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"sy (scale y)\" callInDebugger\n get sy(): number {\n return Fx.toFloat(this._sy);\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"sy (scale y)\"\n set sy(v: number) {\n const y = this.y;\n this._sy = Fx8(Math.max(0, v));\n this.recalcSize();\n this.top = y - this.height / 2;\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"scale\" callInDebugger\n get scale(): number {\n return Math.max(this.sx, this.sy);\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"scale\"\n set scale(v: number) {\n this.sx = this.sy = v;\n }\n\n private _data: any;\n /**\n * Custom data\n */\n //%\n get data(): any {\n if (!this._data) this._data = {};\n return this._data;\n }\n\n set data(value: any) {\n this._data = value;\n }\n _kind: number;\n\n /**\n * A bitset of layer. Each bit is a layer, default is 1.\n */\n //% group=\"Physics\"\n layer: number;\n\n _lastX: Fx8;\n _lastY: Fx8;\n\n _action: number; //Used with animation library\n\n /**\n * Time to live in milliseconds. The lifespan decreases by 1 on each millisecond\n * and the sprite gets destroyed when it reaches 0.\n */\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"lifespan\"\n lifespan: number;\n private _image: Image;\n private _obstacles: sprites.Obstacle[];\n\n private sayEndTime: number;\n private sayRenderer: sprites.BaseSpriteSayRenderer;\n\n _hitbox: game.Hitbox;\n _overlappers: number[];\n _kindsOverlappedWith: number[];\n\n flags: number\n\n private destroyHandler: () => void;\n\n constructor(img: Image) {\n super(scene.SPRITE_Z);\n\n this._x = Fx8(screen.width - img.width >> 1);\n this._y = Fx8(screen.height - img.height >> 1);\n this._lastX = this._x;\n this._lastY = this._y;\n this.vx = 0\n this.vy = 0\n this.ax = 0\n this.ay = 0\n this.fx = 0\n this.fy = 0\n this._sx = Fx.oneFx8;\n this._sy = Fx.oneFx8;\n this.flags = 0\n this.setImage(img);\n this.setKind(-1); // not a member of any type by default\n this.layer = 1; // by default, in layer 1\n this.lifespan = undefined;\n this._overlappers = [];\n this._obstacles = [];\n }\n\n __serialize(offset: number): Buffer {\n const buf = control.createBuffer(offset + 20);\n let k = offset;\n buf.setNumber(NumberFormat.Int16LE, k, Fx.toInt(this._x)); k += 2;\n buf.setNumber(NumberFormat.Int16LE, k, Fx.toInt(this._y)); k += 2;\n buf.setNumber(NumberFormat.Int16LE, k, Fx.toInt(this._vx)); k += 2;\n buf.setNumber(NumberFormat.Int16LE, k, Fx.toInt(this._vy)); k += 2;\n buf.setNumber(NumberFormat.Int16LE, k, Fx.toInt(this._ax)); k += 2;\n buf.setNumber(NumberFormat.Int16LE, k, Fx.toInt(this._ay)); k += 2;\n buf.setNumber(NumberFormat.Float32LE, k, Fx.toFloat(this._sx)); k += 4;\n buf.setNumber(NumberFormat.Float32LE, k, Fx.toFloat(this._sy)); k += 4;\n return buf;\n }\n\n /**\n * Gets the current image\n */\n //% group=\"Image\"\n //% blockId=spriteimage block=\"%sprite(mySprite) image\"\n //% weight=8 help=sprites/sprite/image\n get image(): Image {\n return this._image;\n }\n\n /**\n * Sets the image on the sprite\n */\n //% group=\"Image\"\n //% blockId=spritesetimage block=\"set %sprite(mySprite) image to %img=screen_image_picker\"\n //% weight=7 help=sprites/sprite/set-image\n setImage(img: Image) {\n if (!img || img === this._image) return;\n this._image = img;\n this.recalcSize();\n }\n\n calcDimensionalHash() {\n return Fx.mul(Fx.mul(this._width, this._height), Fx8(this._image.revision()));\n }\n\n resetHitbox() {\n this._hitbox = null;\n this.setHitbox();\n }\n\n setHitbox() {\n const newHitBox = game.calculateHitBox(this);\n\n if (!this._hitbox || this._hitbox.isValid()) {\n this._hitbox = newHitBox;\n return;\n }\n\n const oMinX = this._hitbox.ox;\n const oMinY = this._hitbox.oy;\n const oMaxX = Fx.add(oMinX, this._hitbox.width);\n const oMaxY = Fx.add(oMinY, this._hitbox.height);\n\n const nMinX = newHitBox.ox;\n const nMinY = newHitBox.oy;\n const nMaxX = Fx.add(nMinX, newHitBox.width);\n const nMaxY = Fx.add(nMinY, newHitBox.height);\n\n // total diff in x / y corners between the two hitboxes\n const xDiff = Fx.add(\n Fx.abs(Fx.sub(oMinX, nMinX)),\n Fx.abs(Fx.sub(oMaxX, nMaxX))\n );\n const yDiff = Fx.add(\n Fx.abs(Fx.sub(oMinY, nMinY)),\n Fx.abs(Fx.sub(oMaxY, nMaxY))\n );\n\n // If it's just a small change to the hitbox on one axis,\n // don't change the dimensions to avoid random clipping\n this._hitbox = newHitBox;\n if (xDiff <= Fx.twoFx8) {\n this._hitbox.ox = oMinX;\n this._hitbox.width = Fx.sub(oMaxX, oMinX);\n }\n if (yDiff <= Fx.twoFx8) {\n this._hitbox.oy = oMinY;\n this._hitbox.height = Fx.sub(oMaxY, oMinY);\n }\n }\n\n isStatic() {\n return this._image.isStatic();\n }\n\n __visible() {\n return !(this.flags & SpriteFlag.Invisible);\n }\n\n protected recalcSize(): void {\n this._width = Fx8(this._image.width * this.sx);\n this._height = Fx8(this._image.height * this.sy);\n this.resetHitbox();\n }\n\n private isScaled(): boolean {\n return this._sx !== Fx.oneFx8 || this._sy !== Fx.oneFx8;\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"width\" callInDebugger\n get width() {\n return Fx.toFloat(this._width);\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"height\" callInDebugger\n get height() {\n return Fx.toFloat(this._height);\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"left\" callInDebugger\n get left() {\n return Fx.toFloat(this._x)\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"left\"\n set left(value: number) {\n const physics = game.currentScene().physicsEngine;\n physics.moveSprite(\n this,\n Fx.sub(\n Fx8(value),\n this._x\n ),\n Fx.zeroFx8\n );\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"right\" callInDebugger\n get right() {\n return this.left + this.width\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"right\"\n set right(value: number) {\n this.left = value - this.width\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"top\" callInDebugger\n get top() {\n return Fx.toFloat(this._y);\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"top\"\n set top(value: number) {\n const physics = game.currentScene().physicsEngine;\n physics.moveSprite(\n this,\n Fx.zeroFx8,\n Fx.sub(\n Fx8(value),\n this._y\n )\n );\n }\n\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"bottom\" callInDebugger\n get bottom() {\n return this.top + this.height;\n }\n //% group=\"Physics\" blockSetVariable=\"mySprite\"\n //% blockCombine block=\"bottom\"\n set bottom(value: number) {\n this.top = value - this.height;\n }\n\n // The z field (``get z()`` / ``set z()``) is declared in sprite.d.ts\n // as it is defnied in the superclass\n\n /**\n * The type of sprite\n */\n //% group=\"Overlaps\"\n //% blockId=\"spritegetkind\" block=\"%sprite(mySprite) kind\"\n //% weight=79 help=sprites/sprite/kind\n kind() {\n return this._kind;\n }\n\n /**\n * The type of sprite\n */\n //% group=\"Overlaps\"\n //% blockId=\"spritesetkind\" block=\"set %sprite(mySprite) kind to %kind\"\n //% kind.shadow=spritekind\n //% weight=80 help=sprites/sprite/set-kind\n setKind(value: number) {\n if (value == undefined || this._kind === value) return;\n\n const spritesByKind = game.currentScene().spritesByKind;\n if (this._kind >= 0 && spritesByKind[this._kind])\n spritesByKind[this._kind].remove(this);\n\n if (value >= 0) {\n if (!spritesByKind[value]) spritesByKind[value] = new sprites.SpriteSet();\n spritesByKind[value].add(this);\n }\n\n const overlapMap = game.currentScene().overlapMap;\n if (!overlapMap[value]) {\n overlapMap[value] = [];\n }\n\n this._kindsOverlappedWith = overlapMap[value];\n\n this._kind = value;\n }\n\n /**\n * Set the sprite position in pixels starting from the top-left corner of the screen.\n * @param x horizontal position in pixels\n * @param y vertical position in pixels\n */\n //% group=\"Physics\"\n //% weight=100\n //% blockId=spritesetpos block=\"set %sprite(mySprite) position to x %x y %y\"\n //% help=sprites/sprite/set-position\n //% x.shadow=\"positionPicker\" y.shadow=\"positionPicker\"\n setPosition(x: number, y: number): void {\n const physics = game.currentScene().physicsEngine;\n physics.moveSprite(\n this,\n Fx8(x - this.x),\n Fx8(y - this.y)\n );\n }\n\n /**\n * Sets the sprite velocity in pixel / sec\n * @param vx\n * @param vy\n */\n //% group=\"Physics\"\n //% weight=100\n //% blockId=spritesetvel block=\"set %sprite(mySprite) velocity to vx %vx vy %vy\"\n //% help=sprites/sprite/set-velocity\n //% vx.shadow=spriteSpeedPicker\n //% vy.shadow=spriteSpeedPicker\n setVelocity(vx: number, vy: number): void {\n this.vx = vx;\n this.vy = vy;\n }\n\n /**\n * Deprecated! Use sayText instead.\n *\n * Display a speech bubble with the text, for the given time.\n * @param text the text to say, eg: \":)\"\n * @param time time to keep text on\n */\n //% group=\"Effects\"\n //% weight=60\n //% blockId=spritesay block=\"%sprite(mySprite) say %text||for %millis ms\"\n //% millis.shadow=timePicker\n //% text.shadow=text\n //% inlineInputMode=inline\n //% deprecated=true\n //% help=sprites/sprite/say\n say(text: any, timeOnScreen?: number, textColor = 15, textBoxColor = 1) {\n if (text === null || text === undefined || text === \"\") {\n if (this.sayRenderer) this.sayRenderer.destroy();\n this.sayRenderer = undefined;\n return;\n }\n\n if (this.sayRenderer && this.sayRenderer instanceof sprites.LegacySpriteSayRenderer &&\n this.sayRenderer.text === text && this.sayRenderer.bgColor === textBoxColor &&\n this.sayRenderer.fgColor === textColor && timeOnScreen === undefined && this.sayEndTime === undefined) {\n return;\n }\n\n if (timeOnScreen >= 0) this.sayEndTime = control.millis() + timeOnScreen;\n\n if (this.sayRenderer) this.sayRenderer.destroy();\n this.sayRenderer = undefined;\n text = console.inspect(text);\n\n this.sayRenderer = new sprites.LegacySpriteSayRenderer(text, timeOnScreen, this, textColor, textBoxColor);\n }\n\n /**\n * Display a speech bubble with the text, for the given time\n * @param text the text to say, eg: \":)\"\n * @param time time to keep text on\n * @param animated whether to print the text character by character or not\n */\n //% group=\"Effects\"\n //% weight=60\n //% blockId=spritesaytext block=\"$this say $text||for $timeOnScreen ms with animation $animated\"\n //% timeOnScreen.shadow=timePicker\n //% text.shadow=text\n //% this.shadow=variables_get\n //% this.defl=mySprite\n //% inlineInputMode=inline\n //% help=sprites/sprite/say\n //% expandableArgumentMode=toggle\n sayText(text: any, timeOnScreen?: number, animated = false, textColor = 15, textBoxColor = 1) {\n if (text === null || text === undefined || text === \"\") {\n if (this.sayRenderer) this.sayRenderer.destroy();\n this.sayRenderer = undefined;\n return;\n }\n\n if (this.sayRenderer) this.sayRenderer.destroy();\n this.sayRenderer = undefined;\n\n if (timeOnScreen >= 0) this.sayEndTime = control.millis() + timeOnScreen;\n\n text = console.inspect(text);\n\n this.sayRenderer = new sprites.SpriteSayRenderer(text, textColor, textBoxColor, animated, timeOnScreen);\n }\n\n /**\n * Start an effect on this sprite\n * @param effect the type of effect to create\n */\n //% group=\"Effects\"\n //% weight=90\n //% blockId=startEffectOnSprite block=\"%sprite(mySprite) start %effect effect || for %duration=timePicker|ms\"\n //% help=sprites/sprite/start-effect\n startEffect(effect: effects.ParticleEffect, duration?: number) {\n effect.start(this, duration, null, !!(this.flags & sprites.Flag.RelativeToCamera));\n }\n\n /**\n * Indicates if the sprite is outside the screen\n */\n //%\n isOutOfScreen(camera: scene.Camera): boolean {\n const ox = (this.flags & sprites.Flag.RelativeToCamera) ? 0 : camera.drawOffsetX;\n const oy = (this.flags & sprites.Flag.RelativeToCamera) ? 0 : camera.drawOffsetY;\n return this.right - ox < 0 || this.bottom - oy < 0 || this.left - ox > screen.width || this.top - oy > screen.height;\n }\n\n __drawCore(camera: scene.Camera) {\n this.drawSay(camera);\n\n if (this.isOutOfScreen(camera)) return;\n\n const ox = (this.flags & sprites.Flag.RelativeToCamera) ? 0 : camera.drawOffsetX;\n const oy = (this.flags & sprites.Flag.RelativeToCamera) ? 0 : camera.drawOffsetY;\n\n const l = Math.floor(this.left - ox);\n const t = Math.floor(this.top - oy);\n\n this.drawSprite(l, t);\n this.drawDebug(l, t, ox, oy);\n }\n\n __update(camera: scene.Camera, dt: number) {\n if (this.lifespan !== undefined) {\n this.lifespan -= dt * 1000;\n if (this.lifespan <= 0) {\n this.lifespan = undefined;\n this._destroyCore();\n }\n }\n if ((this.flags & sprites.Flag.AutoDestroy)\n && this.isOutOfScreen(camera)) {\n this.destroy()\n }\n\n const bounce = this.flags & sprites.Flag.BounceOnWall;\n const tm = game.currentScene().tileMap;\n if (this.flags & sprites.Flag.StayInScreen || (bounce && !tm)) {\n if (this.left < camera.offsetX) {\n this.left = camera.offsetX;\n if (bounce) this.vx = -this.vx;\n }\n else if (this.right > camera.offsetX + screen.width) {\n this.right = camera.offsetX + screen.width;\n if (bounce) this.vx = -this.vx;\n }\n\n if (this.top < camera.offsetY) {\n this.top = camera.offsetY;\n if (bounce) this.vy = -this.vy;\n }\n else if (this.bottom > camera.offsetY + screen.height) {\n this.bottom = camera.offsetY + screen.height;\n if (bounce) this.vy = -this.vy;\n }\n }\n\n if (this.sayRenderer) this.sayRenderer.update(dt, camera, this);\n }\n\n /**\n * Set whether a sprite should be constrained within the screen (on) or not (off)\n */\n //% group=\"Effects\"\n //% weight=30\n //% blockId=spritesetsetstayinscreen block=\"set %sprite(mySprite) stay in screen %on=toggleOnOff\"\n //% on.defl=true\n //% help=sprites/sprite/set-stay-in-screen\n setStayInScreen(on: boolean) {\n this.setFlag(SpriteFlag.StayInScreen, on);\n }\n\n /**\n * Set whether a sprite should bounce when it hits a wall (on) or not (off)\n */\n //% group=\"Effects\"\n //% weight=25\n //% blockId=spritesetsetbounceonwall block=\"set %sprite(mySprite) bounce on wall %on=toggleOnOff\"\n //% on.defl=true\n //% help=sprites/sprite/set-bounce-on-wall\n setBounceOnWall(on: boolean) {\n this.setFlag(SpriteFlag.BounceOnWall, on);\n }\n\n /**\n * Set a sprite flag\n */\n //% group=\"Effects\"\n //% weight=10\n //% blockId=spritesetsetflag block=\"set %sprite(mySprite) %flag %on=toggleOnOff\"\n //% flag.defl=SpriteFlag.AutoDestroy\n //% help=sprites/sprite/set-flag\n setFlag(flag: SpriteFlag, on: boolean) {\n if (on) this.flags |= flag\n else this.flags = ~(~this.flags | flag);\n }\n\n /**\n * Check if this sprite overlaps another sprite\n * @param other\n */\n //% group=\"Overlaps\"\n //% blockId=spriteoverlapswith block=\"%sprite(mySprite) overlaps with %other=variables_get(otherSprite)\"\n //% help=sprites/sprite/overlaps-with\n //% weight=90\n overlapsWith(other: Sprite) {\n control.enablePerfCounter(\"overlapsCPP\")\n if (other == this) return false;\n if (this.flags & SPRITE_NO_SPRITE_OVERLAPS)\n return false\n if (other.flags & SPRITE_NO_SPRITE_OVERLAPS)\n return false\n if (!other._hitbox.overlapsWith(this._hitbox))\n return false;\n if (!this.isScaled() && !other.isScaled()) {\n return other._image.overlapsWith(\n this._image,\n this.left - other.left,\n this.top - other.top)\n } else {\n if (this.sx == 0 || this.sy == 0 || other.sx == 0 || other.sy == 0) return false;\n\n let A: Sprite;\n let B: Sprite;\n\n // Render larger-scaled sprite onto smaller-scaled one so that we don't\n // skip over source pixels in the check.\n\n // A is the smaller-scaled sprite\n if (this.sx * this.sy < other.sx * other.sy) {\n A = this;\n B = other;\n } else {\n A = other;\n B = this;\n }\n\n // Render B onto A\n return helpers.imageBlit(\n A.image,\n // Dst rect in A\n (B.left - A.left) / A.sx,\n (B.top - A.top) / A.sy,\n B.width / A.sx,\n B.height / A.sy,\n B.image,\n // Src rect in B\n 0, 0,\n B.image.width,\n B.image.height,\n true, true);\n }\n }\n\n /**\n * Check if there is an obstacle in the given direction\n * @param direction\n */\n //% blockId=spritehasobstacle block=\"is %sprite(mySprite) hitting wall %direction\"\n //% blockNamespace=\"scene\" group=\"Locations\" blockGap=24\n //% help=scene/is-hitting-tile\n //% weight=15\n isHittingTile(direction: CollisionDirection): boolean {\n return this._obstacles && !!this._obstacles[direction];\n }\n\n /**\n * Get the tile kind in a given direction if any\n * @param direction\n */\n //% blockId=spritetileat block=\"tile to $direction of $this(mySprite) is $tile\"\n //% tile.shadow=tileset_tile_picker\n //% blockNamespace=\"scene\" group=\"Locations\" blockGap=8\n //% help=scene/tile-kind-at\n //% weight=20\n tileKindAt(direction: TileDirection, tile: Image): boolean {\n const tilemap = game.currentScene().tileMap;\n let x = this.x >> tilemap.scale;\n let y = this.y >> tilemap.scale;\n switch (direction) {\n case TileDirection.Top:\n y = y - 1;\n break;\n case TileDirection.Bottom:\n y = y + 1;\n break;\n case TileDirection.Left:\n x = x - 1;\n break;\n case TileDirection.Right:\n x = x + 1;\n break;\n case TileDirection.Center:\n default:\n break;\n }\n return tiles.getTileImage(tilemap.getTile(x, y)).equals(tile);\n }\n\n /**\n * Get the obstacle sprite in a given direction if any\n * @param direction\n */\n //% blockId=spriteobstacle block=\"%sprite(mySprite) wall hit on %direction\"\n //% blockNamespace=\"scene\" group=\"Locations\"\n //% direction.shadow=tiles_collision_direction_editor\n //% help=sprites/sprite/tile-hit-from\n //% deprecated=1\n tileHitFrom(direction: number): number {\n return (this._obstacles && this._obstacles[direction]) ? this._obstacles[direction].tileIndex : -1;\n }\n\n /**\n * Gets the tilemap location at the center of a sprite\n */\n //% block=\"tilemap location of $this\"\n //% blockId=tiles_location_of_sprite\n //% this.shadow=variables_get\n //% this.defl=mySprite\n //% blockNamespace=\"scene\" group=\"Locations\" weight=90\n //% help=scene/tilemap-location\n tilemapLocation(): tiles.Location {\n const scene = game.currentScene();\n if (!scene.tileMap) return undefined;\n return tiles.getTileLocation(this.x >> scene.tileMap.scale, this.y >> scene.tileMap.scale);\n }\n\n clearObstacles() {\n this._obstacles = [];\n }\n\n registerObstacle(direction: CollisionDirection, other: sprites.Obstacle, tm?: tiles.TileMap) {\n this._obstacles[direction] = other;\n const collisionHandlers = game.currentScene().collisionHandlers[other.tileIndex];\n const wallCollisionHandlers = game.currentScene().wallCollisionHandlers;\n\n if (collisionHandlers) {\n collisionHandlers\n .filter(h => h.kind == this.kind())\n .forEach(h => h.handler(this));\n }\n if (wallCollisionHandlers) {\n tm = tm || game.currentScene().tileMap;\n const wallHandlersToRun = wallCollisionHandlers\n .filter(h => h.spriteKind == this.kind());\n if (wallHandlersToRun.length) {\n const asTileLocation = tm.getTile(other.left >> tm.scale, other.top >> tm.scale);\n wallHandlersToRun\n .forEach(h => h.handler(this, asTileLocation));\n }\n }\n }\n\n /**\n * Run code when the sprite is destroyed\n * @param handler\n */\n //% group=\"Lifecycle\"\n //% weight=9\n onDestroyed(handler: () => void) {\n this.destroyHandler = handler\n }\n\n /**\n * Destroy the sprite\n */\n //% group=\"Effects\"\n //% weight=80\n //% blockId=spritedestroy block=\"destroy %sprite(mySprite) || with %effect effect for %duration ms\"\n //% duration.shadow=timePicker\n //% expandableArgumentMode=\"toggle\"\n //% help=sprites/sprite/destroy\n destroy(effect?: effects.ParticleEffect, duration?: number) {\n if (this.flags & sprites.Flag.Destroyed)\n return;\n this.flags |= sprites.Flag.Destroyed;\n\n if (effect)\n effect.destroy(this, duration);\n else\n this._destroyCore();\n }\n\n _destroyCore() {\n this.flags |= sprites.Flag.Destroyed;\n const scene = game.currentScene();\n scene.allSprites.removeElement(this);\n if (this.kind() >= 0 && scene.spritesByKind[this.kind()])\n scene.spritesByKind[this.kind()].remove(this);\n scene.physicsEngine.removeSprite(this);\n if (this.destroyHandler)\n this.destroyHandler();\n scene.destroyedHandlers\n .filter(h => h.kind == this.kind())\n .forEach(h => h.handler(this));\n }\n\n /**\n * Make this sprite follow the target sprite.\n *\n * @param target the sprite this one should follow\n * @param speed the rate at which this sprite should move, eg: 100\n * @param turnRate how quickly the sprite should turn while following.\n * The default (400) will cause the sprite to reach max speed after approximately 125 ms when standing still,\n * and turn around 180 degrees when at max speed after approximately 250 ms.\n */\n //% group=\"Physics\" weight=10\n //% blockId=spriteFollowOtherSprite\n //% block=\"set %sprite(myEnemy) follow %target=variables_get(mySprite) || with speed %speed\"\n //% help=sprites/sprite/follow\n follow(target: Sprite, speed = 100, turnRate = 400) {\n if (target === this) return;\n\n const sc = game.currentScene();\n if (!sc.followingSprites) {\n sc.followingSprites = [];\n let lastTime = game.runtime();\n\n sc.eventContext.registerFrameHandler(scene.FOLLOW_SPRITE_PRIORITY, () => {\n const currTime = game.runtime();\n const timeDiff = (currTime - lastTime) / 1000;\n let destroyedSprites = false;\n\n sc.followingSprites.forEach(fs => {\n const { target, self, turnRate, rate } = fs;\n // one of the involved sprites has been destroyed,\n // so exit and remove that in the cleanup step\n if ((self.flags | target.flags) & sprites.Flag.Destroyed) {\n self.vx = 0;\n self.vy = 0;\n destroyedSprites = true;\n return;\n }\n\n const dx = target.x - self.x;\n const dy = target.y - self.y;\n\n // already right on top of target; stop moving\n if (Math.abs(dx) < 2 && Math.abs(dy) < 2) {\n // snap to target location so it sits 'right on top' of sprite.\n self.x = target.x;\n self.y = target.y;\n\n self.vx = 0;\n self.vy = 0;\n return;\n }\n\n const maxMomentumDiff = timeDiff * turnRate * (rate / 50);\n const angleToTarget = Math.atan2(dy, dx);\n\n // to move directly towards target, use this...\n const targetTrajectoryVx = Math.cos(angleToTarget) * rate;\n const targetTrajectoryVy = Math.sin(angleToTarget) * rate;\n\n // ... but to keep momentum, calculate the diff in velocities and maintain some of the velocity\n const diffVx = targetTrajectoryVx - self.vx;\n const diffVy = targetTrajectoryVy - self.vy;\n\n self.vx += Math.clamp(-maxMomentumDiff, maxMomentumDiff, diffVx);\n self.vy += Math.clamp(-maxMomentumDiff, maxMomentumDiff, diffVy);\n });\n\n lastTime = currTime;\n\n // cleanup: remove followers where one has been destroyed\n if (destroyedSprites) {\n sc.followingSprites = sc.followingSprites\n .filter(fs => !((fs.self.flags | fs.target.flags) & sprites.Flag.Destroyed));\n }\n });\n }\n\n const fs = sc.followingSprites.find(fs => fs.self.id == this.id);\n\n if (!target || !speed) {\n if (fs) {\n sc.followingSprites.removeElement(fs);\n this.vx = 0;\n this.vy = 0;\n }\n } else if (!fs) {\n sc.followingSprites.push(new sprites.FollowingSprite(\n this,\n target,\n speed,\n turnRate\n ));\n } else {\n fs.target = target;\n fs.rate = speed;\n fs.turnRate = turnRate;\n }\n }\n\n setScaleCore(sx?: number, sy?: number, anchor?: ScaleAnchor, proportional?: boolean): void {\n anchor = anchor || ScaleAnchor.Middle;\n\n const hasSx = sx != null;\n const hasSy = sy != null;\n\n const oldW = this.width;\n const oldH = this.height;\n\n if (hasSx) {\n const oldSx = this.sx;\n this.sx = sx;\n if (!hasSy && proportional) {\n const ratio = sx / oldSx;\n this.sy *= ratio;\n }\n }\n if (hasSy) {\n const oldSy = this.sy;\n this.sy = sy;\n if (!hasSx && proportional) {\n const ratio = sy / oldSy;\n this.sx *= ratio;\n }\n }\n\n if (anchor & (ScaleAnchor.Left | ScaleAnchor.Right)) {\n const newW = this.width;\n const diff = newW - oldW;\n const diffOver2 = diff / 2;\n if (anchor & ScaleAnchor.Left) { this.x += diffOver2; }\n if (anchor & ScaleAnchor.Right) { this.x -= diffOver2; }\n }\n if (anchor & (ScaleAnchor.Top | ScaleAnchor.Bottom)) {\n const newH = this.height;\n const diff = newH - oldH;\n const diffOver2 = diff / 2;\n if (anchor & ScaleAnchor.Top) { this.y += diffOver2; }\n if (anchor & ScaleAnchor.Bottom) { this.y -= diffOver2; }\n }\n }\n\n //% blockId=sprite_set_scale\n //% block=\"set %sprite(mySprite) scale to $value anchor $anchor\"\n //% expandableArgumentMode=enabled\n //% inlineInputMode=inline\n //% value.defl=1\n //% anchor.defl=ScaleAnchor.Middle\n //% help=sprites/sprite/set-scale\n //% group=\"Scale\" weight=90\n setScale(value: number, anchor?: ScaleAnchor): void {\n const direction = ScaleDirection.Uniformly;\n anchor = anchor || ScaleAnchor.Middle;\n\n let sx: number;\n let sy: number;\n\n if (direction & ScaleDirection.Horizontally) sx = value;\n if (direction & ScaleDirection.Vertically) sy = value;\n\n this.setScaleCore(sx, sy, anchor);\n }\n\n //% blockId=sprite_change_scale\n //% block=\"change %sprite(mySprite) scale by $value anchor $anchor\"\n //% expandableArgumentMode=enabled\n //% inlineInputMode=inline\n //% value.defl=1\n //% anchor.defl=ScaleAnchor.Middle\n //% help=sprites/sprite/change-scale\n //% group=\"Scale\" weight=90\n changeScale(value: number, anchor?: ScaleAnchor): void {\n const direction = ScaleDirection.Uniformly;\n anchor = anchor || ScaleAnchor.Middle;\n\n let sx: number;\n let sy: number;\n\n if (direction & ScaleDirection.Horizontally) sx = this.sx + value;\n if (direction & ScaleDirection.Vertically) sy = this.sy + value;\n\n this.setScaleCore(sx, sy, anchor);\n }\n\n toString() {\n return `${this.id}(${this.x},${this.y})->(${this.vx},${this.vy})`;\n }\n\n protected drawSay(camera: scene.Camera) {\n if (this.sayRenderer) {\n if (this.sayEndTime !== undefined) {\n if (control.millis() < this.sayEndTime) {\n this.sayRenderer.draw(screen, camera, this);\n }\n else {\n this.sayRenderer.destroy();\n this.sayRenderer = undefined;\n this.sayEndTime = undefined;\n }\n }\n else {\n this.sayRenderer.draw(screen, camera, this)\n }\n }\n }\n\n protected drawDebug(left: number, top: number, offsetX: number, offsetY: number) {\n if (this.flags & SpriteFlag.ShowPhysics) {\n const font = image.font5;\n const margin = 2;\n let tx = left;\n let ty = top + this.height + margin;\n screen.print(`${this.x >> 0},${this.y >> 0}`, tx, ty, 1, font);\n tx -= font.charWidth;\n if (this.vx || this.vy) {\n ty += font.charHeight + margin;\n screen.print(`v${this.vx >> 0},${this.vy >> 0}`, tx, ty, 1, font);\n }\n if (this.ax || this.ay) {\n ty += font.charHeight + margin;\n screen.print(`a${this.ax >> 0},${this.ay >> 0}`, tx, ty, 1, font);\n }\n }\n\n // debug info\n if (game.debug) {\n screen.drawRect(\n Fx.toInt(this._hitbox.left) - offsetX,\n Fx.toInt(this._hitbox.top) - offsetY,\n Fx.toInt(this._hitbox.width),\n Fx.toInt(this._hitbox.height),\n 1\n );\n }\n }\n\n protected drawSprite(drawLeft: number, drawTop: number) {\n if (!this.isScaled())\n screen.drawTransparentImage(this._image, drawLeft, drawTop);\n else\n screen.blit(\n // dst rect in screen\n drawLeft, drawTop,\n this.width,\n this.height,\n // src rect in sprite image\n this._image,\n 0, 0,\n this._image.width, this._image.height,\n true, false);\n }\n}\n",
"spriteevents.ts": "namespace sprites {\n /**\n * Run code when a certain kind of sprite is created\n * @param kind\n * @param sprite\n */\n //% group=\"Lifecycle\" draggableParameters=\"reporter\" weight=97\n //% blockId=spritesoncreated block=\"on created $sprite of kind $kind=spritekind\"\n //% help=sprites/on-created\n export function onCreated(kind: number, handler: (sprite: Sprite) => void): void {\n if (!handler || kind == undefined) return;\n\n const sc = game.currentScene();\n sc.createdHandlers.push(\n new scene.SpriteHandler(\n kind,\n handler\n )\n )\n }\n\n /**\n * Run code when a certain kind of sprite is destroyed\n * @param kind\n * @param sprite\n */\n //% group=\"Lifecycle\"\n //% weight=96 draggableParameters=\"reporter\"\n //% blockId=spritesondestroyed block=\"on destroyed $sprite of kind $kind=spritekind \"\n //% help=sprites/on-destroyed\n export function onDestroyed(kind: number, handler: (sprite: Sprite) => void) {\n if (!handler || kind == undefined) return;\n\n const sc = game.currentScene();\n sc.destroyedHandlers.push(\n new scene.SpriteHandler(\n kind,\n handler\n )\n );\n }\n\n /**\n * Run code when two kinds of sprites overlap\n */\n //% group=\"Overlaps\"\n //% weight=100 draggableParameters=\"reporter\"\n //% blockId=spritesoverlap block=\"on $sprite of kind $kind=spritekind overlaps $otherSprite of kind $otherKind=spritekind\"\n //% help=scene/on-overlap\n //% blockGap=8\n export function onOverlap(kind: number, otherKind: number, handler: (sprite: Sprite, otherSprite: Sprite) => void) {\n if (kind == undefined || otherKind == undefined || !handler) return;\n const sc = game.currentScene();\n const overlapHandlers = sc.overlapHandlers;\n const overlapMap = sc.overlapMap;\n\n function associate(a: number, b: number) {\n if (!overlapMap[a]) {\n overlapMap[a] = [];\n }\n\n overlapMap[a].push(b);\n }\n\n associate(kind, otherKind);\n associate(otherKind, kind);\n\n overlapHandlers.push(\n new scene.OverlapHandler(\n kind,\n otherKind,\n handler\n )\n );\n }\n}\n\nnamespace scene {\n /**\n * Run code when a certain kind of sprite overlaps a tile\n * @param kind\n * @param tile\n * @param handler\n */\n //% group=\"Tilemaps\"\n //% weight=120 draggableParameters=\"reporter\" blockGap=8\n //% blockId=spriteshittile block=\"on $sprite of kind $kind=spritekind overlaps $tile at $location\"\n //% tile.shadow=tileset_tile_picker\n //% help=scene/on-overlap-tile\n export function onOverlapTile(kind: number, tile: Image, handler: (sprite: Sprite, location: tiles.Location) => void) {\n if (kind == undefined || !tile || !handler) return;\n\n const tileOverlapHandlers = game.currentScene().tileOverlapHandlers;\n tileOverlapHandlers.push(\n new scene.TileOverlapHandler(\n kind,\n tile,\n handler\n )\n );\n }\n\n /**\n * Run code when a certain kind of sprite hits a wall\n * @param kind\n * @param handler\n */\n //% group=\"Tilemaps\"\n //% weight=100 draggableParameters=\"reporter\" blockGap=8\n //% blockId=spriteshitwall block=\"on $sprite of kind $kind=spritekind hits wall at $location\"\n //% help=scene/on-hit-wall\n export function onHitWall(kind: number, handler: (sprite: Sprite, location: tiles.Location) => void) {\n if (kind == undefined || !handler) return;\n\n const wallCollisionHandlers = game.currentScene().wallCollisionHandlers;\n wallCollisionHandlers.push(\n new scene.TileWallHandler(\n kind,\n handler\n )\n );\n }\n}",
"spritekind.ts": "namespace sprites {\n /**\n * Gets the \"kind\" of sprite\n */\n //% shim=KIND_GET\n //% blockId=spritekind block=\"$kind\"\n //% kindNamespace=SpriteKind kindMemberName=kind kindPromptHint=\"e.g. Coin, Fireball, Asteroid...\"\n //% help=sprites/sprite-kind\n export function _spriteKind(kind: number): number {\n return kind;\n }\n\n /**\n * Gets the sprite type\n */\n //% blockHidden=1 shim=ENUM_GET deprecated=true\n //% blockId=spritetype block=\"$kind\" enumInitialMembers=\"Player,Projectile,Food,Enemy\"\n //% enumName=SpriteKindLegacy enumMemberName=kind enumPromptHint=\"e.g. Coin, Fireball, Asteroid...\"\n export function _spriteType(kind: number): number {\n return kind;\n }\n}\n\nnamespace SpriteKind {\n let nextKind: number;\n\n export function create() {\n if (nextKind === undefined) nextKind = 1000;\n return nextKind++;\n }\n\n //% isKind\n export const Player = create();\n\n //% isKind\n export const Projectile = 1;\n\n //% isKind\n export const Food = create();\n\n //% isKind\n export const Enemy = create();\n}",
"spritemap.ts": "namespace sprites {\n export class SpriteMap {\n private cellWidth: number;\n private cellHeight: number;\n private rowCount: number;\n private columnCount: number;\n private buckets: Sprite[][];\n\n constructor() {\n this.buckets = [];\n }\n\n /**\n * Returns a potential list of neighbors\n */\n neighbors(sprite: Sprite): Sprite[] {\n const n: Sprite[] = [];\n const layer = sprite.layer;\n this.mergeAtKey(sprite.left, sprite.top, layer, n)\n this.mergeAtKey(sprite.left, sprite.bottom, layer, n)\n this.mergeAtKey(sprite.right, sprite.top, layer, n)\n this.mergeAtKey(sprite.right, sprite.bottom, layer, n)\n n.removeElement(sprite);\n return n;\n }\n\n /**\n * Gets the overlaping sprites if any\n * @param sprite\n */\n overlaps(sprite: Sprite): Sprite[] {\n const n = this.neighbors(sprite);\n const o = n.filter(neighbor => sprite.overlapsWith(neighbor));\n return o;\n }\n\n draw() {\n for (let x = 0; x < this.columnCount; ++x) {\n for (let y = 0; y < this.rowCount; ++y) {\n const left = x * this.cellWidth;\n const top = y * this.cellHeight;\n const k = this.key(left, top);\n const b = this.buckets[k];\n if (b && b.length)\n screen.drawRect(left, top, this.cellWidth, this.cellHeight, 5);\n }\n }\n }\n\n /**\n * Recompute hashes for all objects\n */\n resizeBuckets(sprites: Sprite[]) {\n // rescale buckets\n let maxWidth = 0;\n let maxHeight = 0;\n for (const sprite of sprites) {\n if (sprite.width > maxWidth) maxWidth = sprite.width;\n if (sprite.height > maxHeight) maxHeight = sprite.height;\n }\n\n const tMap = game.currentScene().tileMap;\n\n const areaWidth = tMap ? tMap.areaWidth() : screen.width;\n const areaHeight = tMap ? tMap.areaHeight() : screen.height;\n\n this.cellWidth = Math.clamp(8, areaWidth >> 2, maxWidth * 2);\n this.cellHeight = Math.clamp(8, areaHeight >> 2, maxHeight * 2);\n this.rowCount = Math.idiv(areaHeight, this.cellHeight);\n this.columnCount = Math.idiv(areaWidth, this.cellWidth);\n }\n\n clear() {\n this.buckets = [];\n }\n\n private key(x: number, y: number): number {\n const xi = Math.clamp(0, this.columnCount, Math.idiv(x, this.cellWidth));\n const yi = Math.clamp(0, this.rowCount, Math.idiv(y, this.cellHeight));\n return xi + yi * this.columnCount;\n }\n\n private insertAtKey(x: number, y: number, sprite: Sprite) {\n const k = this.key(x, y);\n let bucket = this.buckets[k];\n if (!bucket)\n bucket = this.buckets[k] = [];\n if (bucket.indexOf(sprite) < 0)\n bucket.push(sprite);\n }\n\n insertAABB(sprite: Sprite) {\n const left = sprite.left;\n const top = sprite.top;\n const xn = Math.idiv(sprite.width + this.cellWidth - 1, this.cellWidth);\n const yn = Math.idiv(sprite.height + this.cellHeight - 1, this.cellHeight);\n for (let x = 0; x <= xn; x++)\n for (let y = 0; y <= yn; y++)\n this.insertAtKey(left + Math.min(sprite.width, x * this.cellWidth), top + Math.min(sprite.height, y * this.cellHeight), sprite)\n }\n\n private mergeAtKey(x: number, y: number, layer: number, n: Sprite[]) {\n const k = this.key(x, y);\n const bucket = this.buckets[k];\n if (bucket) {\n for (const sprite of bucket)\n if ((sprite.layer & layer)\n && n.indexOf(sprite) < 0)\n n.push(sprite);\n }\n }\n\n toString() {\n return `${this.buckets.length} buckets, ${this.buckets.filter(b => !!b).length} filled`;\n }\n }\n}",
"sprites.ts": "/*\nFrame handlers:\n 10 - physics and collisions\n 20 - frame()\n 60 - screen/sprite background\n 90 - drawing sprites\n 95 - drawing score\n100 - loops.menu()\n200 - screen refresh\n*/\n\n/**\n * Sprites on screen\n */\n//% weight=99 color=\"#4B7BEC\" icon=\"\\uf1d8\"\n//% groups='[\"Create\", \"Physics\", \"Effects\", \"Projectiles\", \"Overlaps\", \"Lifecycle\"]'\nnamespace sprites {\n export class FollowingSprite {\n constructor(\n public self: Sprite,\n public target: Sprite,\n public rate: number,\n public turnRate: number\n ) { }\n }\n\n /**\n * Create a new sprite from an image\n * @param img the image\n */\n //% group=\"Create\"\n //% blockId=spritescreate block=\"sprite %img=screen_image_picker of kind %kind=spritekind\"\n //% expandableArgumentMode=toggle\n //% blockSetVariable=mySprite\n //% weight=100 help=sprites/create\n export function create(img: Image, kind?: number): Sprite {\n const scene = game.currentScene();\n const sprite = new Sprite(img)\n sprite.setKind(kind);\n scene.physicsEngine.addSprite(sprite);\n\n // run on created handlers\n scene.createdHandlers\n .filter(h => h.kind == kind)\n .forEach(h => h.handler(sprite));\n\n return sprite\n }\n\n /**\n * Create a new sprite from an image\n * @param img the image\n */\n //% group=\"Create\"\n //% blockId=spritescreatenoset block=\"sprite %img=screen_image_picker of kind %kind=spritekind\"\n //% blockAliasFor=\"sprites.create\"\n //% expandableArgumentMode=toggle\n //% weight=99 help=sprites/create\n export function __create(img: Image, kind?: number): Sprite {\n return sprites.create(img, kind);\n }\n\n /**\n * Return an array of all sprites of the given kind.\n * @param kind the target kind\n */\n //% blockId=allOfKind block=\"array of sprites of kind %kind=spritekind\"\n //% weight=87\n export function allOfKind(kind: number): Sprite[] {\n const spritesByKind = game.currentScene().spritesByKind;\n if (!(kind >= 0) || !spritesByKind[kind]) return [];\n else return spritesByKind[kind].sprites();\n }\n\n /**\n * Destroys all sprites of the given kind.\n */\n //% group=\"Effects\"\n //% weight=79 help=sprites/destroy-all-sprites-of-kind\n //% blockId=sprites_destroy_all_sprites_of_kind\n //% block=\"destroy all sprites of kind $kind || with $effect effect for $duration ms\"\n //% kind.shadow=spritekind\n //% duration.shadow=timePicker\n //% expandableArgumentMode=\"toggle\"\n export function destroyAllSpritesOfKind(kind: number, effect?: effects.ParticleEffect, duration?: number) {\n for (const sprite of allOfKind(kind)) {\n sprite.destroy(effect, duration);\n }\n }\n\n /**\n * Create a new sprite with a given speed, and place it at the edge of the screen so it moves towards the middle.\n * The sprite auto-destroys when it leaves the screen. You can modify position after it's created.\n */\n //% group=\"Projectiles\"\n //% blockId=spritescreateprojectilefromside block=\"projectile %img=screen_image_picker from side with vx %vx vy %vy\"\n //% vx.shadow=spriteSpeedPicker\n //% vy.shadow=spriteSpeedPicker\n //% weight=99 help=sprites/create-projectile-from-side\n //% blockSetVariable=projectile\n //% inlineInputMode=inline\n export function createProjectileFromSide(img: Image, vx: number, vy: number) {\n return createProjectile(img, vx, vy, SpriteKind.Projectile);\n }\n\n /**\n * Create a new sprite with a given speed that starts from the location of another sprite.\n * The sprite auto-destroys when it leaves the screen. You can modify position after it's created.\n */\n //% group=\"Projectiles\"\n //% blockId=spritescreateprojectilefromsprite block=\"projectile %img=screen_image_picker from %sprite=variables_get(mySprite) with vx %vx vy %vy\"\n //% vx.shadow=spriteSpeedPicker\n //% vy.shadow=spriteSpeedPicker\n //% weight=99 help=sprites/create-projectile-from-sprite\n //% blockSetVariable=projectile\n //% inlineInputMode=inline\n export function createProjectileFromSprite(img: Image, sprite: Sprite, vx: number, vy: number): Sprite {\n return createProjectile(img, vx, vy, SpriteKind.Projectile, sprite);\n }\n\n /**\n * Create a new sprite with given speed, and place it at the edge of the screen so it moves towards the middle.\n * The sprite auto-destroys when it leaves the screen. You can modify position after it's created.\n */\n //% group=\"Projectiles\"\n //% blockId=spritescreateprojectile block=\"projectile %img=screen_image_picker vx %vx vy %vy of kind %kind=spritekind||from sprite %sprite=variables_get(mySprite)\"\n //% weight=99 help=sprites/create-projectile\n //% blockSetVariable=projectile\n //% inlineInputMode=inline\n //% expandableArgumentMode=toggle\n //% deprecated=true blockHidden=true\n export function createProjectile(img: Image, vx: number, vy: number, kind?: number, sprite?: Sprite) {\n const s = sprites.create(img, kind || SpriteKind.Projectile);\n const sc = game.currentScene();\n\n s.vx = vx;\n s.vy = vy;\n\n if (sprite) {\n s.setPosition(sprite.x, sprite.y);\n } else {\n // put it at the edge of the screen so that it moves towards the middle\n // If the scene has a tile map, place the sprite fully on the screen\n const xOff = sc.tileMap ? -(s.width >> 1) : (s.width >> 1) - 1;\n const yOff = sc.tileMap ? -(s.height >> 1) : (s.height >> 1) - 1;\n const cam = game.currentScene().camera;\n\n let initialX = cam.offsetX;\n let initialY = cam.offsetY;\n\n if (vx < 0) {\n initialX += screen.width + xOff;\n } else if (vx > 0) {\n initialX += -xOff;\n }\n\n if (vy < 0) {\n initialY += screen.height + yOff;\n } else if (vy > 0) {\n initialY += -yOff;\n }\n\n s.setPosition(initialX, initialY);\n }\n\n s.flags |= sprites.Flag.AutoDestroy | sprites.Flag.DestroyOnWall;\n\n return s;\n }\n\n export enum Flag {\n None = 0, // no flags are set\n // 1 << 0 was previously used for Ghost / is now available.\n Destroyed = 1 << 1, // whether the sprite has been destroyed or not\n AutoDestroy = 1 << 2, // remove the sprite when no longer visible\n StayInScreen = 1 << 3, // sprite cannot move outside the camera region\n DestroyOnWall = 1 << 4, // destroy sprite on contact with wall\n BounceOnWall = 1 << 5, // Bounce on walls\n ShowPhysics = 1 << 6, // display position, velocity, acc\n Invisible = 1 << 7, // makes the sprite invisible, so it does not show up on the screen\n IsClipping = 1 << 8, // whether the sprite is currently clipping into a wall. This can happen when a sprite is created or moved explicitly.\n RelativeToCamera = 1 << 9, // draw relative to the camera, not the world (e.g. HUD elements)\n GhostThroughTiles = 1 << 10, // No overlaps with tiles\n GhostThroughWalls = 1 << 11, // No collisions with walls\n GhostThroughSprites = 1 << 12, // No overlaps with other sprites\n Ghost = sprites.Flag.GhostThroughSprites | sprites.Flag.GhostThroughWalls | sprites.Flag.GhostThroughTiles, // doesn't collide with other sprites or walls\n }\n}\n",
"spritesay.ts": "namespace sprites {\n export class BaseSpriteSayRenderer {\n constructor(public text: string, public fgColor: number, public bgColor: number) {\n }\n\n draw(screen: Image, camera: scene.Camera, owner: Sprite) {\n\n }\n\n update(dt: number, camera: scene.Camera, owner: Sprite) {\n\n }\n\n destroy() {\n\n }\n }\n\n export class SpriteSayRenderer extends BaseSpriteSayRenderer {\n static drawSayFrame(textLeft: number, textTop: number, textWidth: number, textHeight: number, speakerX: number, speakerY: number, color: number, canvas: Image) {\n if (textLeft + textWidth < 0 || textTop + textHeight < 0 || textLeft > canvas.width || textTop > canvas.height) return;\n\n if (textHeight) {\n // Draw main rectangle\n canvas.fillRect(\n textLeft,\n textTop,\n textWidth,\n textHeight,\n color\n );\n\n // Draw lines around the rectangle to give it a bubble shape\n canvas.fillRect(\n textLeft - 1,\n textTop + 1,\n 1,\n textHeight - 2,\n color\n );\n canvas.fillRect(\n textLeft + textWidth,\n textTop + 1,\n 1,\n textHeight - 2,\n color\n );\n canvas.fillRect(\n textLeft + 1,\n textTop - 1,\n textWidth - 2,\n 1,\n color\n );\n canvas.fillRect(\n textLeft + 1,\n textTop + textHeight,\n textWidth - 2,\n 1,\n color\n );\n\n // If the speaker location is within the bubble, don't draw an arrow\n if (speakerX > textLeft && speakerX < textLeft + textWidth && speakerY > textTop && speakerY < textTop + textHeight) return;\n\n const xDiff = Math.max(\n Math.abs(speakerX - textLeft),\n Math.abs(speakerX - (textLeft + textWidth))\n );\n\n const yDiff = Math.max(\n Math.abs(speakerY - textHeight),\n Math.abs(speakerY - (textHeight + textHeight))\n );\n\n // Draw the arrow\n if (xDiff > yDiff) {\n if (speakerX > textLeft + textWidth) {\n const anchorY = Math.max(Math.min(speakerY, textTop + textHeight - 4), textTop + 5);\n canvas.fillRect(\n textLeft + textWidth + 1,\n anchorY - 2,\n 1,\n 3,\n color\n );\n canvas.fillRect(\n textLeft + textWidth + 2,\n anchorY - 1,\n 1,\n 1,\n color\n );\n }\n else if (speakerX < textLeft) {\n const anchorY = Math.max(Math.min(speakerY, textTop + textHeight - 4), textTop + 5);\n canvas.fillRect(\n textLeft - 2,\n anchorY - 2,\n 1,\n 3,\n color\n );\n canvas.fillRect(\n textLeft - 3,\n anchorY - 1,\n 1,\n 1,\n color\n );\n }\n else if (speakerY > textTop + textHeight) {\n const anchorX = Math.max(Math.min(speakerX, textLeft + textWidth - 4), textLeft + 5);\n canvas.fillRect(\n anchorX - 2,\n textTop + textHeight + 1,\n 3,\n 1,\n color\n );\n canvas.fillRect(\n anchorX - 1,\n textTop + textHeight + 2,\n 1,\n 1,\n color\n );\n }\n else if (speakerY < textTop) {\n const anchorX = Math.max(Math.min(speakerX, textLeft + textWidth - 4), textLeft + 5);\n canvas.fillRect(\n anchorX - 2,\n textTop - 2,\n 3,\n 1,\n color\n );\n canvas.fillRect(\n anchorX - 1,\n textTop - 3,\n 1,\n 1,\n color\n );\n }\n }\n else {\n if (speakerY > textTop + textHeight) {\n const anchorX = Math.max(Math.min(speakerX, textLeft + textWidth - 4), textLeft + 5);\n canvas.fillRect(\n anchorX - 2,\n textTop + textHeight + 1,\n 3,\n 1,\n color\n );\n canvas.fillRect(\n anchorX - 1,\n textTop + textHeight + 2,\n 1,\n 1,\n color\n );\n }\n else if (speakerY < textTop) {\n const anchorX = Math.max(Math.min(speakerX, textLeft + textWidth - 4), textLeft + 5);\n canvas.fillRect(\n anchorX - 2,\n textTop - 2,\n 3,\n 1,\n color\n );\n canvas.fillRect(\n anchorX - 1,\n textTop - 3,\n 1,\n 1,\n color\n );\n }\n else if (speakerX > textLeft + textWidth) {\n const anchorY = Math.max(Math.min(speakerY, textTop + textHeight - 4), textTop + 5);\n canvas.fillRect(\n textLeft + textWidth + 1,\n anchorY - 2,\n 1,\n 3,\n color\n );\n canvas.fillRect(\n textLeft + textWidth + 2,\n anchorY - 1,\n 1,\n 1,\n color\n );\n }\n else if (speakerX < textLeft) {\n const anchorY = Math.max(Math.min(speakerY, textTop + textHeight - 4), textTop + 5);\n canvas.fillRect(\n textLeft - 2,\n anchorY - 2,\n 1,\n 3,\n color\n );\n canvas.fillRect(\n textLeft - 3,\n anchorY - 1,\n 1,\n 1,\n color\n );\n }\n }\n }\n }\n\n protected renderText: RenderText;\n protected animation: RenderTextAnimation;\n\n constructor(text: string, fg: number, bg: number, animated: boolean, timeOnScreen: number) {\n super(text, fg, bg);\n\n this.renderText = new sprites.RenderText(text, 100);\n if (animated) {\n this.animation = new sprites.RenderTextAnimation(this.renderText, 40);\n if (timeOnScreen >= 0) {\n const numberOfPauses = this.animation.numPages() + 1;\n const pauseTime = Math.min((timeOnScreen / (2 * numberOfPauses)) | 0, 1000);\n this.animation.setPauseLength(pauseTime);\n this.animation.setTextSpeed(this.renderText.printableCharacters() * 1000 / (timeOnScreen - pauseTime * numberOfPauses))\n }\n\n this.animation.start();\n }\n }\n\n draw(screen: Image, camera: scene.Camera, owner: Sprite) {\n const ox = (owner.flags & sprites.Flag.RelativeToCamera) ? 0 : camera.drawOffsetX;\n const oy = (owner.flags & sprites.Flag.RelativeToCamera) ? 0 : camera.drawOffsetY;\n\n const l = Math.floor(owner.left - ox);\n const t = Math.floor(owner.top - oy);\n\n const height = this.animation ? this.animation.currentHeight() : this.renderText.height;\n const width = this.animation ? this.animation.currentWidth() : this.renderText.width;\n const sayLeft = l + (owner.width >> 1) - (width >> 1);\n const sayTop = t - height - 4;\n\n if (sayLeft + width < 0 || sayTop + height < 0 || sayLeft > screen.width || sayTop > screen.height) return;\n\n SpriteSayRenderer.drawSayFrame(sayLeft, sayTop, width, height, owner.x, owner.y, this.bgColor, screen);\n\n if (height) {\n if (this.animation) {\n this.animation.draw(screen, sayLeft, sayTop, this.fgColor);\n }\n else {\n this.renderText.draw(screen, sayLeft, sayTop, this.fgColor);\n }\n }\n }\n }\n\n export class LegacySpriteSayRenderer extends BaseSpriteSayRenderer {\n protected sayBubbleSprite: Sprite;\n protected updateSay: (dt: number, camera: scene.Camera) => void;\n\n constructor(text: string, timeOnScreen: number, owner: Sprite, fg: number, bg: number) {\n super(text, fg, bg);\n\n const textToDisplay = console.inspect(text).split(\"\\n\").join(\" \");\n\n let pixelsOffset = 0;\n let holdTextSeconds = 1.5;\n let bubblePadding = 4;\n let maxTextWidth = 100;\n let font = image.getFontForText(textToDisplay);\n let startX = 2;\n let startY = 2;\n let bubbleWidth = textToDisplay.length * font.charWidth + bubblePadding;\n let maxOffset = textToDisplay.length * font.charWidth - maxTextWidth;\n let bubbleOffset: number = Fx.toInt(owner._hitbox.oy);\n let needsRedraw = true;\n\n // sets the default scroll speed in pixels per second\n let speed = 45;\n const currentScene = game.currentScene();\n\n // Calculates the speed of the scroll if scrolling is needed and a time is specified\n if (timeOnScreen && maxOffset > 0) {\n speed = (maxOffset + (2 * maxTextWidth)) / (timeOnScreen / 1000);\n speed = Math.max(speed, 45);\n holdTextSeconds = maxTextWidth / speed;\n holdTextSeconds = Math.min(holdTextSeconds, 1.5);\n }\n\n if (timeOnScreen) {\n timeOnScreen = timeOnScreen + currentScene.millis();\n }\n\n if (bubbleWidth > maxTextWidth + bubblePadding) {\n bubbleWidth = maxTextWidth + bubblePadding;\n } else {\n maxOffset = -1;\n }\n\n // reuse previous sprite if possible\n const imgh = font.charHeight + bubblePadding;\n if (!this.sayBubbleSprite\n || this.sayBubbleSprite.width != bubbleWidth\n || this.sayBubbleSprite.height != imgh) {\n const sayImg = image.create(bubbleWidth, imgh);\n if (this.sayBubbleSprite) // sprite with same image size, we can reuse it\n this.sayBubbleSprite.setImage(sayImg);\n else { // needs a new sprite\n this.sayBubbleSprite = sprites.create(sayImg, -1);\n this.sayBubbleSprite.setFlag(SpriteFlag.Ghost, true);\n this.sayBubbleSprite.setFlag(SpriteFlag.RelativeToCamera, !!(owner.flags & sprites.Flag.RelativeToCamera))\n }\n }\n this.updateSay = (dt, camera) => {\n // The minus 2 is how much transparent padding there is under the sayBubbleSprite\n this.sayBubbleSprite.y = owner.top + bubbleOffset - ((font.charHeight + bubblePadding) >> 1) - 2;\n this.sayBubbleSprite.x = owner.x;\n this.sayBubbleSprite.z = owner.z + 1;\n\n // Update box stuff as long as timeOnScreen doesn't exist or it can still be on the screen\n if (!timeOnScreen || timeOnScreen > currentScene.millis()) {\n // move bubble\n if (!owner.isOutOfScreen(camera)) {\n const ox = camera.offsetX;\n const oy = camera.offsetY;\n\n if (this.sayBubbleSprite.left - ox < 0) {\n this.sayBubbleSprite.left = 0;\n }\n\n if (this.sayBubbleSprite.right - ox > screen.width) {\n this.sayBubbleSprite.right = screen.width;\n }\n\n // If sprite bubble above the sprite gets cut off on top, place the bubble below the sprite\n if (this.sayBubbleSprite.top - oy < 0) {\n this.sayBubbleSprite.y = (this.sayBubbleSprite.y - 2 * owner.y) * -1;\n }\n }\n\n // Pauses at beginning of text for holdTextSeconds length\n if (holdTextSeconds > 0) {\n holdTextSeconds -= game.eventContext().deltaTime;\n // If scrolling has reached the end, start back at the beginning\n if (holdTextSeconds <= 0 && pixelsOffset > 0) {\n pixelsOffset = 0;\n holdTextSeconds = maxTextWidth / speed;\n needsRedraw = true;\n }\n } else {\n pixelsOffset += dt * speed;\n needsRedraw = true;\n\n // Pause at end of text for holdTextSeconds length\n if (pixelsOffset >= maxOffset) {\n pixelsOffset = maxOffset;\n holdTextSeconds = maxTextWidth / speed;\n }\n }\n\n if (needsRedraw) {\n needsRedraw = false;\n this.sayBubbleSprite.image.fill(this.bgColor);\n // If maxOffset is negative it won't scroll\n if (maxOffset < 0) {\n this.sayBubbleSprite.image.print(textToDisplay, startX, startY, this.fgColor, font);\n\n } else {\n this.sayBubbleSprite.image.print(textToDisplay, startX - pixelsOffset, startY, this.fgColor, font);\n }\n\n // Left side padding\n this.sayBubbleSprite.image.fillRect(0, 0, bubblePadding >> 1, font.charHeight + bubblePadding, this.bgColor);\n // Right side padding\n this.sayBubbleSprite.image.fillRect(bubbleWidth - (bubblePadding >> 1), 0, bubblePadding >> 1, font.charHeight + bubblePadding, this.bgColor);\n // Corners removed\n this.sayBubbleSprite.image.setPixel(0, 0, 0);\n this.sayBubbleSprite.image.setPixel(bubbleWidth - 1, 0, 0);\n this.sayBubbleSprite.image.setPixel(0, font.charHeight + bubblePadding - 1, 0);\n this.sayBubbleSprite.image.setPixel(bubbleWidth - 1, font.charHeight + bubblePadding - 1, 0);\n }\n } else {\n // If can't update because of timeOnScreen then destroy the sayBubbleSprite and reset updateSay\n this.updateSay = undefined;\n this.sayBubbleSprite.destroy();\n this.sayBubbleSprite = undefined;\n }\n }\n this.updateSay(0, currentScene.camera);\n }\n\n update(dt: number, camera: scene.Camera, owner: Sprite) {\n if (!this.sayBubbleSprite) return;\n this.updateSay(dt, camera);\n if (!this.sayBubbleSprite) return;\n\n this.sayBubbleSprite.setFlag(SpriteFlag.RelativeToCamera, !!(owner.flags & SpriteFlag.RelativeToCamera));\n\n if (owner.flags && Flag.Destroyed) this.destroy();\n }\n\n destroy() {\n if (this.sayBubbleSprite) this.sayBubbleSprite.destroy();\n this.sayBubbleSprite = undefined;\n }\n }\n}",
"spriteset.ts": "namespace sprites {\n /*\n * A set of sprites\n */\n export class SpriteSet {\n private _sprites: Sprite[];\n\n /**\n * Create a new set from an array of sprites\n * @param sprites\n */\n static createFromArray(sprites: Sprite[]): SpriteSet {\n const sp = new SpriteSet();\n const n = sprites.length;\n for (let i = 0; i < n; ++i)\n sp.add(sprites[i]);\n return sp;\n }\n\n constructor() {\n this._sprites = [];\n }\n\n /**\n * Gets the number of sprites in the set\n */\n get length() {\n return this._sprites.length;\n }\n\n /**\n * Gets the snapshot of the current list of sprites\n */\n sprites() {\n return this._sprites.filter(s => !(s.flags & sprites.Flag.Destroyed));\n }\n\n /**\n * Adds the sprite, returns true if added; false if the sprite was already in the set\n * @param sprite\n */\n add(sprite: Sprite): boolean {\n if (!sprite) return false; // don't add nulls\n\n // scan if in set\n if (this.contains(sprite))\n return false;\n this._sprites.push(sprite);\n return true;\n }\n\n /**\n * Adds sprite and removes from old set. Returns true if sprite was in old set and not in new set.\n * @param oldSet\n * @param sprite\n */\n addFrom(oldSet: SpriteSet, sprite: Sprite): boolean {\n const removed = oldSet.remove(sprite);\n const added = this.add(sprite);\n return removed && added;\n }\n\n /**\n * Removes sprite from set. Returns true if the sprite was in the set\n * @param sprite\n */\n remove(sprite: Sprite): boolean {\n const i = this._sprites.indexOf(sprite);\n if (i > -1) {\n this._sprites.splice(i, 1);\n return true;\n }\n return false;\n }\n\n /**\n * Checks if the sprite is part of the set\n * @param sprite\n */\n contains(sprite: Sprite): boolean {\n return this._sprites.indexOf(sprite) > -1;\n }\n\n /**\n * Removes all the sprites from the set\n */\n clear() {\n this._sprites.splice(0, this._sprites.length);\n }\n\n /**\n * Removes the last sprite in the set\n */\n pop(): Sprite {\n return this._sprites.pop();\n }\n\n toString() {\n return `${this.length} sprites`\n }\n }\n}",
"systemmenu.ts": "namespace scene.systemMenu {\n let instance: PauseMenu;\n let customMenuOptions: MenuOption[];\n\n export enum CardState {\n Selected,\n Active,\n None\n }\n\n export interface MenuTheme {\n cardSpacing: number;\n cardWidth: number;\n cardsPerRow: number;\n padding: number;\n cardsTop: number;\n infoTop: number;\n\n // \"PAUSED\"\n headerText: string;\n\n headerFont: image.Font;\n infoFont: image.Font;\n\n selectedCard: Image;\n activeCard: Image;\n basicCard: Image;\n }\n\n export class MenuOption {\n protected card: Sprite;\n protected icon: Sprite;\n\n protected top: number;\n protected state: CardState;\n\n protected theme: MenuTheme;\n\n constructor(protected iconImage: Image, public getText: () => string, public action: () => void) {\n }\n\n show() {\n this.card = sprites.create(this.theme ? this.theme.basicCard : CARD_NORMAL);\n this.card.z = 1;\n\n this.icon = sprites.create(this.iconImage);\n this.icon.z = 2;\n\n this.state = CardState.None;\n }\n\n position(left: number, top: number) {\n this.top = top;\n\n this.card.left = left;\n this.card.top = top;\n\n this.icon.x = this.card.x;\n this.icon.y = this.card.y;\n }\n\n setOffset(offset: number) {\n this.card.top = this.top + offset;\n this.icon.y = this.card.y;\n }\n\n setTheme(theme: MenuTheme) {\n this.theme = theme;\n this.updateCard();\n }\n\n setState(state: CardState) {\n if (this.state === state) return;\n this.state = state;\n this.updateCard();\n }\n\n dispose() {\n if (this.card) {\n this.card.destroy();\n this.icon.destroy();\n this.card = undefined;\n this.icon = undefined;\n }\n }\n\n protected updateCard() {\n if (!this.theme) return;\n switch (this.state) {\n case CardState.None: this.card.setImage(this.theme.basicCard); break;\n case CardState.Selected: this.card.setImage(this.theme.selectedCard); break;\n case CardState.Active: this.card.setImage(this.theme.activeCard); break;\n }\n\n // Center the icon\n this.icon.x = this.card.x;\n this.icon.y = this.card.y;\n }\n }\n\n export class PauseMenu {\n protected options: MenuOption[];\n protected theme: MenuTheme;\n\n // Index of selected card\n protected selection: number;\n\n // The row that is currently at the top of the screen\n protected scrollRow: number;\n\n // The pixel offset for the scrollRow\n protected scrollTarget: number;\n\n // The current pixel offset of the scroll (might be animating)\n protected scrollOffset: number;\n\n constructor(protected generator: () => MenuOption[], theme?: MenuTheme) {\n this.theme = theme || buildMenuTheme(CARD_NORMAL.width, 3);\n this.scrollRow = 0;\n this.scrollOffset = 0;\n this.scrollTarget = 0;\n }\n\n show() {\n this.options = this.generator();\n this.selection = 0;\n\n let current: MenuOption;\n for (let i = 0; i < this.options.length; i++) {\n current = this.options[i];\n current.show();\n current.setTheme(this.theme);\n current.position(\n this.theme.padding + (i % this.theme.cardsPerRow) * (this.theme.cardWidth + this.theme.cardSpacing),\n this.theme.cardsTop + (Math.idiv(i, this.theme.cardsPerRow) * (this.theme.cardWidth + this.theme.cardSpacing))\n );\n }\n\n controller._setUserEventsEnabled(false);\n\n controller.A.onEvent(SYSTEM_KEY_DOWN, () => {\n if (!this.options || !this.options[this.selection]) return;\n this.options[this.selection].setState(CardState.Active);\n });\n\n controller.A.onEvent(SYSTEM_KEY_UP, () => {\n if (!this.options || !this.options[this.selection]) return;\n this.options[this.selection].setState(CardState.Selected);\n control.runInParallel(this.options[this.selection].action)\n });\n\n controller.B.onEvent(SYSTEM_KEY_DOWN, () => {\n closeMenu();\n });\n\n controller.menu.onEvent(SYSTEM_KEY_DOWN, () => {\n closeMenu();\n });\n\n controller.up.onEvent(SYSTEM_KEY_DOWN, () => {\n this.setSelection(Math.max(0, this.selection - this.theme.cardsPerRow));\n });\n\n controller.left.onEvent(SYSTEM_KEY_DOWN, () => {\n this.setSelection(Math.max(0, this.selection - 1));\n });\n\n controller.down.onEvent(SYSTEM_KEY_DOWN, () => {\n this.setSelection(Math.min(this.options.length - 1, this.selection + this.theme.cardsPerRow));\n });\n\n controller.right.onEvent(SYSTEM_KEY_DOWN, () => {\n this.setSelection(Math.min(this.options.length - 1, this.selection + 1));\n });\n\n game.onShade(() => {\n this.onUpdate();\n this.drawText();\n });\n\n this.setSelection(0);\n }\n\n onUpdate() {\n // Should probably factor out this animation\n let t = control.millis() / 250;\n for (let i = 0; i < this.options.length; i++) {\n this.options[i].setOffset(2 * Math.sin(t - (i % this.theme.cardsPerRow) * (Math.PI / 2)))\n }\n\n const dt = game.currentScene().eventContext.deltaTime;\n if (this.scrollOffset < this.scrollTarget) {\n this.scrollOffset += dt * 100;\n }\n else if (this.scrollOffset > this.scrollTarget) {\n this.scrollOffset -= dt * 100;\n }\n else {\n return;\n }\n\n if (Math.abs(this.scrollOffset - this.scrollTarget) < 2) {\n this.scrollOffset = this.scrollTarget;\n }\n\n game.currentScene().camera.offsetY = this.scrollOffset;\n }\n\n setSelection(selection: number) {\n if (!this.options) return;\n\n if (this.options[this.selection]) {\n this.options[this.selection].setState(CardState.None);\n }\n\n this.selection = selection;\n\n if (this.options[this.selection]) {\n this.options[this.selection].setState(controller.A.isPressed() ? CardState.Active : CardState.Selected);\n }\n\n this.updateScrollTarget();\n }\n\n drawText() {\n if (!this.options) return;\n\n // Black bar to draw the header on\n screen.fillRect(0, 0, screen.width, this.theme.cardsTop - 2, 15);\n\n // Header text\n screen.printCenter(this.theme.headerText, 2, 1, this.theme.headerFont);\n\n // Black bar for the info box to draw on\n screen.fillRect(0, this.theme.infoTop - 3, screen.width, screen.height - this.theme.infoTop + 6, 15);\n\n // White info box\n screen.fillRect(this.theme.padding, this.theme.infoTop, screen.width - (this.theme.padding << 1), this.theme.infoFont.charHeight + 1, 1);\n\n // Info text\n screen.printCenter(this.options[this.selection].getText(), this.theme.infoTop + 1, 15, this.theme.infoFont);\n }\n\n dispose() {\n if (this.options) {\n this.options.forEach(o => o.dispose());\n this.options = undefined;\n }\n }\n\n protected updateScrollTarget() {\n const row = Math.idiv(this.selection, this.theme.cardsPerRow);\n\n // FIXME: Assumes that there are always two rows on screen\n if (row === this.scrollRow || row - 1 === this.scrollRow) return;\n\n if (row > this.scrollRow) this.scrollRow++;\n else this.scrollRow--;\n\n this.scrollTarget = this.scrollRow * (this.theme.cardSpacing + this.theme.cardWidth);\n }\n }\n\n // we intentionally only save volume when the user explicitly adjusts it\n // we don't want to save it when adjusted programatically, because it could for example changing in a loop\n function setVolume(newVolume: number) {\n music.setVolume(newVolume);\n music.playTone(440, 500);\n settings.writeNumber(\"#volume\", newVolume)\n }\n\n function volumeUp() {\n const v = music.volume();\n const remainder = v % 32;\n const newVolume = v + 32 - remainder;\n setVolume(newVolume);\n }\n\n function volumeDown() {\n const v = music.volume();\n const remainder = v % 32;\n const newVolume = v - (remainder ? remainder : 32);\n setVolume(newVolume);\n }\n\n function brightnessUp() {\n setScreenBrightness(screen.brightness() + 5);\n }\n\n function brightnessDown() {\n setScreenBrightness(screen.brightness() - 5);\n }\n\n function setScreenBrightness(b: number) {\n screen.setBrightness(b);\n // we intentionally only save brightness when the user explicitly adjusts it\n // we don't want to save it when adjusted programatically, because it could for example changing in a loop\n settings.writeNumber(\"#brightness\", screen.brightness())\n }\n\n function toggleStats() {\n game.stats = !game.stats;\n if (!game.stats && control.EventContext.onStats) {\n control.EventContext.onStats(\"\");\n }\n }\n\n function toggleConsole() {\n if (game.consoleOverlay.isVisible())\n game.consoleOverlay.setVisible(false);\n else {\n game.consoleOverlay.setVisible(true);\n console.log(\"console\");\n }\n }\n\n function sleep() {\n power.deepSleep();\n }\n\n export function closeMenu() {\n if (instance) {\n instance.dispose();\n instance = undefined;\n controller._setUserEventsEnabled(true);\n game.popScene();\n }\n }\n\n //% shim=pxt::setScreenBrightnessSupported\n function setScreenBrightnessSupported() {\n return 0 // default to no, in simulator\n }\n\n export function buildOptionList(): MenuOption[] {\n let options: MenuOption[] = [];\n\n options.push(new MenuOption(VOLUME_DOWN_ICON, () => `VOLUME DOWN (${music.volume()})`, volumeDown));\n options.push(new MenuOption(VOLUME_UP_ICON, () => `VOLUME UP (${music.volume()})`, volumeUp));\n if (setScreenBrightnessSupported()) {\n options.push(new MenuOption(BRIGHTNESS_DOWN_ICON, () => `BRIGHTNESS DOWN (${screen.brightness()})`, brightnessDown));\n options.push(new MenuOption(BRIGHTNESS_UP_ICON, () => `BRIGHTNESS UP (${screen.brightness()})`, brightnessUp));\n }\n options.push(new MenuOption(STATS_ICON, () => game.stats ? \"HIDE STATS\" : \"SHOW STATS\", toggleStats));\n options.push(new MenuOption(CONSOLE_ICON, () => game.consoleOverlay.isVisible() ? \"HIDE CONSOLE\" : \"SHOW CONSOLE\", toggleConsole));\n options.push(new MenuOption(SLEEP_ICON, () => \"SLEEP\", sleep));\n\n if (customMenuOptions) {\n options = options.concat(customMenuOptions);\n }\n\n options.push(new MenuOption(CLOSE_MENU_ICON, () => \"CLOSE\", closeMenu));\n\n return options;\n }\n\n export function buildMenuTheme(cardWidth: number, cardSpacing: number, infoFont?: image.Font, headerFont?: image.Font): MenuTheme {\n const cardsPerRow = Math.idiv(screen.width, cardWidth + cardSpacing);\n infoFont = infoFont || image.font8;\n headerFont = headerFont || image.doubledFont(infoFont);\n\n return {\n cardSpacing: cardSpacing,\n cardWidth: cardWidth,\n cardsPerRow: cardsPerRow,\n padding: (screen.width - (cardsPerRow * cardWidth + (cardsPerRow - 1) * cardSpacing)) >> 1,\n infoFont: infoFont,\n headerFont: headerFont,\n cardsTop: headerFont.charHeight + 2 + cardSpacing,\n infoTop: screen.height - infoFont.charHeight - 2,\n headerText: \"PAUSED\",\n selectedCard: CARD_SELECTED,\n activeCard: CARD_ACTIVE,\n basicCard: CARD_NORMAL\n };\n }\n\n export function addEntry(name: () => string, clickHandler: () => void, icon: Image) {\n if (!customMenuOptions) customMenuOptions = [];\n customMenuOptions.push(new MenuOption(icon, name, clickHandler));\n }\n\n export function register() {\n if (instance) return; // don't show system menu, while in system menu\n\n controller.menu.onEvent(ControllerButtonEvent.Pressed, showSystemMenu);\n }\n\n export function showSystemMenu() {\n if (instance) return;\n game.pushScene();\n instance = new PauseMenu(buildOptionList);\n instance.show();\n }\n\n export function isVisible() {\n return !!instance;\n }\n\n function initVolume() {\n const vol = settings.readNumber(\"#volume\")\n if (vol !== undefined)\n music.setVolume(vol)\n }\n\n function initScreen() {\n const brightness = settings.readNumber(\"#brightness\");\n if (brightness !== undefined)\n screen.setBrightness(brightness)\n }\n\n initVolume()\n initScreen()\n scene.Scene.initializers.push(register);\n}\n",
"systemmenuicons.ts": "namespace scene.systemMenu {\n export const CARD_NORMAL = img`\n . . 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 . .\n . 1 1 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 1 1 .\n 1 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1\n 1 1 3 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 3 1 1\n . 1 1 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 1 1 .\n . . 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 . .\n `;\n export const CARD_SELECTED = img`\n . . 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 . .\n . 2 2 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 2 2 .\n 2 2 3 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 3 2 2\n 2 3 2 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 3 2\n 2 3 2 2 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2 2 3 2\n 2 2 3 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 3 2 2\n . 2 2 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 2 2 .\n . . 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 . .\n `;\n export const CARD_ACTIVE = img`\n . . 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 . .\n . 4 4 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 4 4 .\n 4 4 3 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 3 4 4\n 4 3 4 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 3 4\n 4 3 4 4 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 4 4 3 4\n 4 4 3 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 3 4 4\n . 4 4 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 4 4 .\n . . 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4 . .\n `;\n export const VOLUME_UP_ICON = img`\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . c c c b b . . . . . . . . . 6 6 7 . . . . .\n . . . . . . . . . c b 1 1 d b b . . . . . . . . 6 6 6 6 . . . .\n . . . . . . . . c d 1 d c b d b . . . . . 6 7 . . 6 6 6 7 . . .\n . . . . . c c c b 1 d c c c b d b . . . . 6 6 6 . 7 6 6 6 . . .\n . . c c c c b c 1 1 b c c c c d b . . . . 7 6 6 7 . 6 6 6 7 . .\n . c b d c b 1 b 1 1 c c c c c b c . d 7 . . 6 6 6 . 7 6 6 6 . .\n . c d b b 1 1 b 1 d c d b c c b c . 7 6 7 . 7 6 6 . 7 6 6 6 . .\n . f d b b d 1 b d d b d d c c b c . . 6 6 . 7 6 6 . 7 6 6 6 . .\n . f d b b d d b d d b d b c f b c . . 6 6 . 7 6 6 . 7 6 6 6 . .\n . f d b b b d b d d f b c f f b c . 7 6 7 . 7 6 6 . 7 6 6 6 . .\n . f b d c b b b d d f f f f f b c . d 7 . . 6 6 6 . 7 6 6 6 . .\n . . f f f f b c d d c f f f c d b . . . . 7 6 6 7 . 6 6 6 7 . .\n . . . . . f f f b 1 d f f f b d b . . . . 6 6 6 . 7 6 6 6 . . .\n . . . . . . . . c d 1 d c b d b . . . . . 6 7 . . 6 6 6 7 . . .\n . . . . . . . . . c b 1 1 d b b . . . . . . . . 6 6 6 6 . . . .\n . . . . . . . . . . c c c c b . . . . . . . . . 6 6 7 . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n `;\n export const BRIGHTNESS_DOWN_ICON = img`\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . b b b . . . . . . . . . . . . . .\n . . . . . . . . . . . b . . . 4 5 4 . . . b . . . . . . . . . .\n . . . . . . . . . . b 5 4 . . . 4 . . . 4 5 b . . . . . . . . .\n . . . . . . . . . b 5 5 4 . . . . . . . 4 5 5 b . . . . . . . .\n . . . . . . . . . . b 4 . . . 4 4 4 . . . 4 4 . . . . . . . . .\n . . . . . . . . . . . . . 4 4 5 5 5 4 4 . . . . . . . . . . . .\n . . . . . . . . . . . . . 4 5 5 1 1 5 4 . . . . . . . . . . . .\n . . . . . . . . b 4 . . 4 d 5 5 1 1 5 d 4 . . 4 b . . . . . . .\n . . . . . . . . b 5 4 . b d d 5 5 5 d d b . 4 5 b . . . . . . .\n . . . . . . . . b 4 . . b d d d d d d d b . . 4 b . . . . . . .\n . . . . . . . . . . . . . b d d d d d b . . . . . . . . . . . .\n . . . . . . . . . . . . . b b d d d b b . . . . . . . . . . . .\n . . . . . . . . . . 4 4 . . . b b b . . . 4 4 . . . . . . . . .\n . . . . . . . . . b 5 5 4 . . . . . . . 4 5 5 b . . . . . . . .\n . . . . . . . . . . b 5 4 . . . 4 . . . 4 5 b . . . . . . . . .\n . . . . . . . . . . . b . . . 4 5 4 . . . b . . . . . . . . . .\n . . . . . . . . . . . . . . . b b b . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n `;\n export const CLOSE_MENU_ICON = img`\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . 2 2 . . . . . . . . . . . . . . 2 2 . . . . . . .\n . . . . . . . 2 2 2 . . . . . . . . . . . . 2 2 2 . . . . . . .\n . . . . . . . . 2 2 2 . . . . . . . . . . 2 2 2 . . . . . . . .\n . . . . . . . . . 2 2 2 . . . . . . . . 2 2 2 . . . . . . . . .\n . . . . . . . . . . 2 2 2 . . . . . . 2 2 2 . . . . . . . . . .\n . . . . . . . . . . . 2 2 2 . . . . 2 2 2 . . . . . . . . . . .\n . . . . . . . . . . . . 2 2 2 . . 2 2 2 . . . . . . . . . . . .\n . . . . . . . . . . . . . 2 2 2 2 2 2 . . . . . . . . . . . . .\n . . . . . . . . . . . . . . 2 2 2 2 . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . 2 2 2 2 . . . . . . . . . . . . . .\n . . . . . . . . . . . . . 2 2 2 2 2 2 . . . . . . . . . . . . .\n . . . . . . . . . . . . 2 2 2 . . 2 2 2 . . . . . . . . . . . .\n . . . . . . . . . . . 2 2 2 . . . . 2 2 2 . . . . . . . . . . .\n . . . . . . . . . . 2 2 2 . . . . . . 2 2 2 . . . . . . . . . .\n . . . . . . . . . 2 2 2 . . . . . . . . 2 2 2 . . . . . . . . .\n . . . . . . . . 2 2 2 . . . . . . . . . . 2 2 2 . . . . . . . .\n . . . . . . . 2 2 2 . . . . . . . . . . . . 2 2 2 . . . . . . .\n . . . . . . . 2 2 . . . . . . . . . . . . . . 2 2 . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n `;\n export const VOLUME_DOWN_ICON = img`\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . c c c b b . . . . . . . . . . . .\n . . . . . . . . . . . . . . c b 1 1 d b b . . . . . . . . . . .\n . . . . . . . . . . . . . c d 1 d c b d b . . . . . . . . . . .\n . . . . . . . . . . c c c b 1 d c c c b d b . . . . . . . . . .\n . . . . . . . c c c c b c 1 1 b c c c c d b . . . . . . . . . .\n . . . . . . c b d c b 1 b 1 1 c c c c c b c . d 7 . . . . . . .\n . . . . . . c d b b 1 1 b 1 d c d b c c b c . 7 6 7 . . . . . .\n . . . . . . f d b b d 1 b d d b d d c c b c . . 6 6 . . . . . .\n . . . . . . f d b b d d b d d b d b c f b c . . 6 6 . . . . . .\n . . . . . . f d b b b d b d d f b c f f b c . 7 6 7 . . . . . .\n . . . . . . f b d c b b b d d f f f f f b c . d 7 . . . . . . .\n . . . . . . . f f f f b c d d c f f f c d b . . . . . . . . . .\n . . . . . . . . . . f f f b 1 d f f f b d b . . . . . . . . . .\n . . . . . . . . . . . . . c d 1 d c b d b . . . . . . . . . . .\n . . . . . . . . . . . . . . c b 1 1 d b b . . . . . . . . . . .\n . . . . . . . . . . . . . . . c c c c b . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n `;\n export const SLEEP_ICON = img`\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . b b b b b b . . . . . . . . . . . . .\n . . . . . . . . . . . b b d 5 5 5 5 d c c . . . . . . . . . . .\n . . . . . . . . . . b d 5 5 5 b c c c c c c . . . . . . . . . .\n . . . . . . . . . b 5 5 5 5 c c c c c c c c c . . . . . . . . .\n . . . . . . . . b d 5 5 5 b c c c c c d c c c c . . . . . . . .\n . . . . . . . . b 5 5 5 5 c c c c c b 5 b c c c . . . . . . . .\n . . . . . . . b d 5 5 5 5 c c c c d 5 5 5 d c d c . . . . . . .\n . . . . . . . b 5 5 5 5 5 c c c c b 5 5 5 b c d c . . . . . . .\n . . . . . . . c 5 5 5 5 5 c c c c c 5 b 5 c c d c . . . . . . .\n . . . . . . . c 5 5 5 5 5 b c c c c c c c c b d c . . . . . . .\n . . . . . . . c d 5 5 5 5 5 c c c c c c c c d d c . . . . . . .\n . . . . . . . c d d 5 5 5 d d b c c c c b d d d c . . . . . . .\n . . . . . . . . c d d d d d d d d d d d d d d c . . . . . . . .\n . . . . . . . . c d d d d d d d d d d d d d d c . . . . . . . .\n . . . . . . . . . c 9 9 d d d d d d d d d 9 c . . . . . . . . .\n . . . . . . . . . . b 9 9 9 d d d d d 9 9 c . . . . . . . . . .\n . . . . . . . . . . . b b 9 9 9 9 9 9 c c . . . . . . . . . . .\n . . . . . . . . . . . . . b b b b c c . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n `;\n export const CONSOLE_ICON = img`\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . b b b b b b b b b b b c c . . . . . . . . .\n . . . . . . . . . b 1 d d d d d d d d d d 1 b c . . . . . . . .\n . . . . . . . . b 1 1 1 1 1 1 1 1 1 1 1 1 b b c . . . . . . . .\n . . . . . . . . b d b c c c c c c c c c b b b c . . . . . . . .\n . . . . . . . . b d c 6 6 6 6 6 6 6 6 6 c b b c . . . . . . . .\n . . . . . . . . b d c 6 1 6 6 6 6 6 6 6 c b b c . . . . . . . .\n . . . . . . . . b d c 6 6 1 6 6 6 6 6 6 c b b c . . . . . . . .\n . . . . . . . . b d c 6 6 6 1 6 6 6 6 6 c b b c . . . . . . . .\n . . . . . . . . b d c 6 6 1 6 6 6 6 6 6 c b b c . . . . . . . .\n . . . . . . . . b d c 6 1 6 6 6 1 1 1 6 c b b c . . . . . . . .\n . . . . . . . . b d c 6 6 6 6 6 6 6 6 6 c b b c . . . . . . . .\n . . . . . . . . b d c c c c c c c c c c c b b c . . . . . . . .\n . . . . . . . . c b b b b b b b b b b b b b c . . . . . . . . .\n . . . . . . . . . c c c c c c c c c c c c c . . . . . . . . . .\n . . . . . . . . . . . . . c c c c c c . . . . . . . . . . . . .\n . . . . . . . . . c c c c b b b b b b c c c c c . . . . . . . .\n . . . . . . . . c 1 1 b 1 1 b 1 1 b 1 1 b d d c . . . . . . . .\n . . . . . . . c d d d d d d d d d d d d d b c . . . . . . . . .\n . . . . . . . c c c c c c c c c c c c c c c . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n `;\n export const BRIGHTNESS_UP_ICON = img`\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . 4 4 . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . 4 5 5 4 . . . . . . . . . . . . . .\n . . . . . . . . 4 4 b . . . b b b b . . . b 4 4 . . . . . . . .\n . . . . . . . 4 5 5 b . . . . . . . . . . b 5 5 4 . . . . . . .\n . . . . . . . 4 5 b . . . . 4 4 4 4 . . . . b 5 4 . . . . . . .\n . . . . . . . b b . . . 4 4 5 5 5 5 4 4 . . . b b . . . . . . .\n . . . . . . . . . . . 4 d 5 5 5 5 5 5 d 4 . . . . . . . . . . .\n . . . . . . . . . . 4 d 5 5 5 5 5 1 1 5 d 4 . . . . . . . . . .\n . . . . . . . . . . 4 5 5 5 5 5 5 1 1 5 5 4 . . . . . . . . . .\n . . . . . . 4 b . 4 d 5 5 5 5 5 5 5 5 5 5 d 4 . b 4 . . . . . .\n . . . . . 4 5 b . 4 d 5 5 5 5 5 5 5 5 5 5 d 4 . b 5 4 . . . . .\n . . . . . 4 5 b . b d 5 5 5 5 5 5 5 5 5 5 d b . b 5 4 . . . . .\n . . . . . . 4 b . b d d 5 5 5 5 5 5 5 5 d d b . b 4 . . . . . .\n . . . . . . . . . . b d d 5 5 5 5 5 5 d d b . . . . . . . . . .\n . . . . . . . . . . b d d d d d d d d d d b . . . . . . . . . .\n . . . . . . . . . . . b d d d d d d d d b . . . . . . . . . . .\n . . . . . . . b b . . . b b d d d d b b . . . b b . . . . . . .\n . . . . . . . 4 5 b . . . . b b b b . . . . b 5 4 . . . . . . .\n . . . . . . . 4 5 5 b . . . . . . . . . . b 5 5 4 . . . . . . .\n . . . . . . . . 4 4 b . . . b b b b . . . b 4 4 . . . . . . . .\n . . . . . . . . . . . . . . 4 5 5 4 . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . 4 4 . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n `;\n export const STATS_ICON = img`\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . b b b b . . . . . . . . . . . . . . . . . . . . .\n . . . . . . b 5 5 b b . b b b b b b . . . . . . . . . . . . . .\n . . . . . . b 5 b d c c b d d d 5 5 b b . . . . . . . . . . . .\n . . . . . . b b d b c d d b b b b d 5 5 b . . . . . . . . . . .\n . . . . . . b b b c d d b 1 1 1 1 1 b d 5 b . . . . . . . . . .\n . . . . . . . . c b d b 1 1 1 1 1 1 1 d b 5 b . . . . . . . . .\n . . . . . . . . b 5 b d 1 1 b 1 1 1 1 1 d d 5 b . . . . . . . .\n . . . . . . . b b 5 b 1 1 1 d b 1 1 b 1 1 b 5 b . . . . . . . .\n . . . . . . . b b 5 b 1 1 1 1 b b 1 b 9 9 1 d 5 b . . . . . . .\n . . . . . . . b b 5 b 1 1 1 1 1 b b b 9 9 9 b 5 b . . . . . . .\n . . . . . . . b b 5 5 d 1 1 1 9 9 b b 9 9 9 b 5 b . . . . . . .\n . . . . . . . b d b 5 b 1 1 9 9 9 9 9 9 9 9 c 5 b . . . . . . .\n . . . . . . . b d b 5 5 b 1 9 9 9 9 9 9 9 d b 5 b . . . . . . .\n . . . . . . . . b d b 5 5 b 9 9 9 9 9 9 9 c 5 d . . . . . . . .\n . . . . . . . . c d d b 5 5 b b 9 9 9 d c b 5 b . . . . . . . .\n . . . . . . . . . c d d b 5 5 5 b c c b 5 5 b . . . . . . . . .\n . . . . . . . . . . c b b b d 5 5 5 5 5 d b . . . . . . . . . .\n . . . . . . . . . . . c c b b b b b b b b . . . . . . . . . . .\n . . . . . . . . . . . . . c c c c c c . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .\n `;\n}",
"targetoverrides.cpp": "// Overriden in target\n",
"targetoverrides.ts": "// Overriden in target\n",
"textDialogs.ts": "enum DialogLayout {\n //% block=bottom\n Bottom,\n //% block=left\n Left,\n //% block=right\n Right,\n //% block=top\n Top,\n //% block=center\n Center,\n //% block=\"full screen\"\n Full\n}\n\nnamespace game {\n let dialogFrame: Image;\n let dialogCursor: Image;\n let dialogTextColor: number;\n const MAX_FRAME_UNIT = 12;\n\n export class BaseDialog {\n image: Image;\n frame: Image;\n cursor: Image;\n\n columns: number;\n rows: number;\n unit: number;\n\n innerLeft: number;\n innerTop: number;\n cursorCount: number;\n\n font: image.Font;\n textColor: number;\n\n constructor(width: number, height: number, frame?: Image, font?: image.Font, cursor?: Image) {\n this.image = image.create(width, height);\n\n this.frame = frame || dialogFrame || (dialogFrame = defaultFrame());\n\n this.font = font || image.font8;\n\n this.cursor = cursor || dialogCursor || (dialogCursor = defaultCursorImage());\n\n this.textColor = dialogTextColor == undefined ? dialogTextColor = 15 : dialogTextColor;\n\n this.unit = Math.floor(this.frame.width / 3);\n this.columns = Math.floor(width / this.unit);\n this.rows = Math.floor(height / this.unit);\n\n this.innerLeft = (width - (this.columns * this.unit)) >> 1;\n this.innerTop = (height - (this.rows * this.unit)) >> 1;\n\n this.cursorCount = 0;\n\n this.drawBorder();\n this.clearInterior();\n }\n\n update() {\n this.clearInterior();\n this.drawTextCore();\n this.drawCursorRow();\n }\n\n setText(rawString: string) {\n // implemented by subclass\n }\n\n drawTextCore() {\n // Implemented by subclass\n }\n\n drawCursorRow() {\n let offset = 0;\n if (this.cursorCount > 20) {\n offset = 1;\n }\n\n this.cursorCount = (this.cursorCount + 1) % 40;\n\n this.image.drawTransparentImage(\n this.cursor,\n this.innerLeft + this.textAreaWidth() + this.unit + offset - this.cursor.width,\n this.innerTop + this.unit + this.textAreaHeight() + 1 - this.cursorRowHeight()\n )\n }\n\n protected drawBorder() {\n if (this.unit == 1) {\n this.fastFill(0, 0, 0, 1, 1)\n this.fastFill(1, 1, 0, this.columns - 2, 1)\n this.fastFill(2, this.columns - 1, 0, 1, 1)\n\n this.fastFill(3, 0, 1, 1, this.rows - 2)\n this.fastFill(5, this.columns - 1, 1, 1, this.rows - 2)\n\n const y = this.rows - 1\n this.fastFill(6, 0, y, 1, 1)\n this.fastFill(7, 1, y, this.columns - 2, 1)\n this.fastFill(8, this.columns - 1, y, 1, 1)\n\n return\n }\n\n for (let c = 0; c < this.columns; c++) {\n if (c == 0) {\n this.drawPartial(0, 0, 0);\n this.drawPartial(6, 0, this.rows - 1);\n }\n else if (c === this.columns - 1) {\n this.drawPartial(2, c, 0);\n this.drawPartial(8, c, this.rows - 1);\n }\n else {\n this.drawPartial(1, c, 0);\n this.drawPartial(7, c, this.rows - 1);\n }\n }\n\n for (let r = 1; r < this.rows - 1; r++) {\n this.drawPartial(3, 0, r);\n this.drawPartial(5, this.columns - 1, r);\n }\n }\n\n private fastFill(index: number, x: number, y: number, w: number, h: number) {\n const color = this.frame.getPixel(index % 3, Math.idiv(index, 3))\n this.image.fillRect(this.innerLeft + x, this.innerTop + y, w, h, color)\n }\n\n protected clearInterior() {\n if (this.unit == 1)\n return this.fastFill(4, 1, 1, this.columns - 2, this.rows - 2)\n\n for (let d = 1; d < this.columns - 1; d++) {\n for (let s = 1; s < this.rows - 1; s++) {\n this.drawPartial(4, d, s)\n }\n }\n }\n\n protected drawPartial(index: number, colTo: number, rowTo: number) {\n const x0 = this.innerLeft + colTo * this.unit;\n const y0 = this.innerTop + rowTo * this.unit;\n\n const xf = (index % 3) * this.unit;\n const yf = Math.idiv(index, 3) * this.unit;\n\n for (let e = 0; e < this.unit; e++) {\n for (let t = 0; t < this.unit; t++) {\n this.image.setPixel(\n x0 + e,\n y0 + t,\n this.frame.getPixel(xf + e, yf + t));\n }\n }\n }\n\n protected cursorRowHeight() {\n return this.cursor.height + 1;\n }\n\n protected rowHeight() {\n return this.font.charHeight + 1;\n }\n\n protected textAreaWidth() {\n return this.image.width - ((this.innerLeft + Math.min(this.unit, MAX_FRAME_UNIT)) << 1) - 2;\n }\n\n protected textAreaHeight() {\n return this.image.height - ((this.innerTop + Math.min(this.unit, MAX_FRAME_UNIT)) << 1) - 1;\n }\n\n protected setFont(font: image.Font) {\n this.font = font;\n }\n }\n\n export class Dialog extends BaseDialog {\n chunks: string[][];\n chunkIndex: number;\n\n constructor(width: number, height: number, frame?: Image, font?: image.Font, cursor?: Image) {\n super(width, height, frame, font, cursor);\n\n this.chunkIndex = 0;\n }\n\n hasNext() {\n if (!this.chunks || this.chunks.length === 0) return false;\n return this.chunkIndex < this.chunks.length - 1;\n }\n\n hasPrev() {\n if (!this.chunks || this.chunks.length === 0) return false;\n return this.chunkIndex > 0;\n }\n\n nextPage() {\n if (this.hasNext()) {\n this.chunkIndex++;\n }\n }\n\n prevPage() {\n if (this.hasPrev()) {\n this.chunkIndex--;\n }\n }\n\n chunkText(str: string): string[][] {\n const charactersPerRow = Math.floor(this.textAreaWidth() / this.font.charWidth);\n const charactersPerCursorRow = Math.floor(charactersPerRow - (this.cursor.width / this.font.charWidth));\n const rowsOfCharacters = Math.floor(this.textAreaHeight() / this.rowHeight());\n const rowsWithCursor = Math.ceil(this.cursor.height / this.rowHeight());\n\n let lineLengths: number[] = [];\n\n for (let i = 0; i < rowsOfCharacters - rowsWithCursor; i++) lineLengths.push(charactersPerRow);\n for (let i = 0; i < rowsWithCursor; i++) lineLengths.push(charactersPerCursorRow);\n\n return breakIntoPages(str, lineLengths);\n }\n\n setText(rawString: string) {\n this.setFont(image.getFontForText(rawString));\n this.chunks = this.chunkText(rawString);\n this.chunkIndex = 0;\n }\n\n drawTextCore() {\n if (!this.chunks || this.chunks.length === 0) return;\n const lines = this.chunks[this.chunkIndex];\n const availableWidth = this.textAreaWidth();\n const availableHeight = this.textAreaHeight();\n\n const charactersPerRow = Math.floor(availableWidth / this.font.charWidth);\n const rowsOfCharacters = Math.floor(availableHeight / this.rowHeight());\n\n if (this.unit > MAX_FRAME_UNIT) this.drawBorder();\n\n const textLeft = 1 + this.innerLeft + Math.min(this.unit, MAX_FRAME_UNIT) + ((availableWidth - charactersPerRow * this.font.charWidth) >> 1);\n const textTop = 1 + (this.image.height >> 1) - ((lines.length * this.rowHeight()) >> 1);\n\n for (let row = 0; row < lines.length; row++) {\n this.image.print(\n lines[row],\n textLeft,\n textTop + row * this.rowHeight(),\n this.textColor, this.font\n )\n }\n }\n }\n\n export class SplashDialog extends game.BaseDialog {\n text: string;\n subtext: string;\n\n timer: number;\n offset: number;\n maxOffset: number;\n maxSubOffset: number;\n\n constructor(width: number, height: number) {\n super(width, height, defaultSplashFrame())\n this.maxOffset = -1;\n this.maxSubOffset = -1;\n this.textColor = 1;\n }\n\n private updateFont() {\n this.setFont(image.getFontForText((this.text || \"\") + (this.subtext || \"\")));\n }\n\n setText(text: string) {\n this.text = text;\n this.updateFont();\n this.offset = 0;\n this.maxOffset = text.length * this.font.charWidth - screen.width + (this.unit << 1);\n this.timer = 2;\n }\n\n setSubtext(sub: string) {\n this.subtext = sub;\n this.updateFont();\n this.maxSubOffset = sub.length * (this.font.charWidth) - screen.width + (this.unit << 1);\n }\n\n drawTextCore() {\n const scrollMax = Math.max(this.maxOffset, this.maxSubOffset);\n if (this.timer > 0) {\n this.timer -= game.eventContext().deltaTime;\n if (this.timer <= 0) {\n if (this.offset > 0) {\n this.offset = 0;\n this.timer = 2;\n }\n }\n }\n else {\n this.offset++;\n if (this.offset >= scrollMax) {\n this.offset = scrollMax;\n this.timer = 2;\n }\n }\n const ytitle = 10;\n if (this.maxOffset < 0) {\n const left = (this.image.width >> 1) - (this.text.length * this.font.charWidth >> 1)\n this.image.print(this.text, left, ytitle, this.textColor, this.font)\n }\n else {\n this.image.print(this.text, this.unit - this.offset, ytitle, this.textColor, this.font)\n }\n\n if (this.subtext) {\n const ysub = ytitle + this.font.charHeight + 2;\n if (this.maxSubOffset < 0) {\n const left = (this.image.width >> 1) - (this.subtext.length * this.font.charWidth >> 1)\n this.image.print(this.subtext, left, ysub, this.textColor, this.font);\n }\n else {\n this.image.print(this.subtext, this.unit - (Math.min(this.offset, this.maxSubOffset)), ysub, this.textColor, this.font);\n }\n }\n this.drawBorder();\n }\n }\n\n export class GameOverDialog extends game.BaseDialog {\n protected cursorOn: boolean;\n protected isNewHighScore: boolean;\n\n constructor(\n protected win: boolean,\n protected score?: number,\n protected highScore?: number\n ) {\n super(screen.width, 46, defaultSplashFrame());\n this.cursorOn = false;\n this.isNewHighScore = this.score > this.highScore;\n }\n\n displayCursor() {\n this.cursorOn = true;\n }\n\n update() {\n this.clearInterior();\n this.drawTextCore();\n\n if (this.cursorOn) {\n this.drawCursorRow();\n }\n }\n\n drawTextCore() {\n const titleHeight = 8;\n this.image.printCenter(\n this.win ? \"YOU WIN!\" : \"GAME OVER!\",\n titleHeight,\n screen.isMono ? 1 : 5,\n image.font8\n );\n\n if (this.score !== undefined) {\n const scoreHeight = 23;\n const highScoreHeight = 34;\n const scoreColor = screen.isMono ? 1 : 2;\n\n this.image.printCenter(\n \"Score:\" + this.score,\n scoreHeight,\n scoreColor,\n image.font8\n );\n\n if (this.isNewHighScore) {\n this.image.printCenter(\n \"New High Score!\",\n highScoreHeight,\n scoreColor,\n image.font5\n );\n } else {\n this.image.printCenter(\n \"HI\" + this.highScore,\n highScoreHeight,\n scoreColor,\n image.font8\n );\n }\n }\n }\n }\n\n /**\n * Show a long text string in a dialog box that will scroll\n * using the \"A\" or \"down\" buttons. The previous section of the\n * text is shown using the \"up\" button. This function\n * halts execution until the last page of text is dismissed.\n *\n * @param str The text to display\n * @param layout The layout to use for the dialog box\n */\n //% blockId=game_show_long_text group=\"Dialogs\"\n //% block=\"show long text %str %layout\"\n //% str.shadow=text\n //% help=game/show-long-text\n export function showLongText(str: any, layout: DialogLayout) {\n str = console.inspect(str);\n controller._setUserEventsEnabled(false);\n game.pushScene();\n game.currentScene().flags |= scene.Flag.SeeThrough;\n\n let width: number;\n let height: number;\n let top: number;\n let left: number;\n\n switch (layout) {\n case DialogLayout.Bottom:\n width = screen.width - 4;\n height = Math.idiv(screen.height, 3) + 5;\n top = screen.height - height;\n left = screen.width - width >> 1;\n break;\n case DialogLayout.Top:\n width = screen.width - 4;\n height = Math.idiv(screen.height, 3) + 5;\n top = 0;\n left = screen.width - width >> 1;\n break;\n case DialogLayout.Left:\n width = Math.idiv(screen.width, 3) + 5;\n height = screen.height;\n top = 0;\n left = 0;\n break;\n case DialogLayout.Right:\n width = Math.idiv(screen.width, 3) + 5;\n height = screen.height;\n top = 0;\n left = screen.width - width;\n break;\n case DialogLayout.Center:\n width = Math.idiv(screen.width << 1, 3);\n height = Math.idiv(screen.width << 1, 3);\n top = (screen.height - height) >> 1;\n left = (screen.width - width) >> 1;\n break;\n case DialogLayout.Full:\n width = screen.width;\n height = screen.height;\n top = 0;\n left = 0;\n break;\n }\n\n const dialog = new Dialog(width, height);\n const s = sprites.create(dialog.image, -1);\n s.top = top;\n s.left = left;\n\n dialog.setText(str)\n let pressed = true;\n let done = false;\n\n let upPressed = true;\n\n game.onUpdate(() => {\n dialog.update();\n const currentState = controller.A.isPressed() || controller.down.isPressed();\n if (currentState && !pressed) {\n pressed = true;\n if (dialog.hasNext()) {\n dialog.nextPage();\n }\n else {\n scene.setBackgroundImage(null); // GC it\n game.popScene();\n done = true;\n }\n }\n else if (pressed && !currentState) {\n pressed = false;\n }\n\n const moveBack = controller.up.isPressed();\n if (moveBack && !upPressed) {\n upPressed = true;\n if (dialog.hasPrev()) {\n dialog.prevPage();\n }\n }\n else if (upPressed && !moveBack) {\n upPressed = false;\n }\n })\n\n pauseUntil(() => done);\n controller._setUserEventsEnabled(true);\n }\n\n function defaultFrame() {\n return screen.isMono ?\n img`\n 1 1 1\n 1 . 1\n 1 1 1\n `\n :\n img`\n . . . . . . . . . . . .\n . b b b b b b b b b b .\n . b b b b b b b b b b c\n . b b d 1 1 1 1 d b b c\n . b b 1 1 1 1 1 1 b b c\n . b b 1 1 1 1 1 1 b b c\n . b b 1 1 1 1 1 1 b b c\n . b b 1 1 1 1 1 1 b b c\n . b b d 1 1 1 1 d b b c\n . b b b b b b b b b b c\n . b b b b b b b b b b c\n . . c c c c c c c c c c\n `\n }\n\n function defaultSplashFrame() {\n return screen.isMono ?\n img`\n 1 1 1\n . . .\n 1 1 1\n `\n :\n img`\n 1 1 1\n f f f\n 1 1 1\n `\n }\n\n function defaultCursorImage() {\n return screen.isMono ?\n img`\n 1 1 1 1 1 1 1 . . .\n 1 . . 1 . . . 1 . .\n 1 . 1 . 1 . . . 1 .\n 1 . 1 1 1 . . . . 1\n 1 . 1 . 1 . . . 1 .\n 1 . . . . . . 1 . .\n 1 1 1 1 1 1 1 . . .\n . . . . . . . . . .\n `\n :\n img`\n 0 0 0 6 6 6 6 6 0 0 0\n 0 6 6 7 7 7 7 7 6 6 0\n 0 6 7 7 1 1 1 7 7 6 0\n 6 7 7 1 7 7 7 1 7 7 6\n 6 7 7 1 7 7 7 1 7 7 6\n 6 7 7 1 1 1 1 1 7 7 6\n 6 6 7 1 7 7 7 1 7 6 6\n 8 6 6 1 7 7 7 1 6 6 8\n 8 6 6 7 6 6 6 7 6 6 8\n 0 8 6 6 6 6 6 6 6 8 0\n 0 0 8 8 8 8 8 8 8 0 0\n `\n }\n\n /**\n * Change the default dialog frame to a new image. Dialog frames\n * are divided into three rows and three columns and are used to define\n * the outer frame of the dialog box.\n *\n * @param frame A square image with a width and height divisible by three\n */\n //% blockId=game_dialog_set_frame group=\"Dialogs\"\n //% block=\"set dialog frame to %frame=dialog_image_picker\"\n //% help=game/set-dialog-frame\n export function setDialogFrame(frame: Image) {\n dialogFrame = frame;\n }\n\n /**\n * Change the default image used for the cursor that appears in the\n * bottom left of the dialog box.\n *\n * @param cursor The image to use for the cursor\n */\n //% blockId=game_dialog_set_cursor group=\"Dialogs\"\n //% block=\"set dialog cursor to %frame=screen_image_picker\"\n //% help=game/set-dialog-cursor\n export function setDialogCursor(cursor: Image) {\n dialogCursor = cursor;\n }\n\n /**\n * Change the color for the text in dialog boxes.\n *\n * @param color The index of the color 0-15\n */\n //% blockId=game_dialog_set_text_color group=\"Dialogs\"\n //% block=\"set dialog text color to %color=colorindexpicker\"\n //% help=game/set-dialog-text-color\n export function setDialogTextColor(color: number) {\n dialogTextColor = Math.floor(Math.min(15, Math.max(0, color)));\n }\n\n // this function is deprecated\n //% deprecated blockHidden\n export function setDialogFont(font: image.Font) {\n }\n\n /**\n * Show a title and an optional subtitle menu\n * @param title\n * @param subtitle\n */\n //% weight=90 help=game/splash\n //% blockId=gameSplash block=\"splash %title||%subtitle\"\n //% title.shadow=text\n //% subtitle.shadow=text\n //% group=\"Prompt\"\n export function splash(title: any, subtitle?: any) {\n title = console.inspect(title);\n subtitle = subtitle ? console.inspect(subtitle) : subtitle;\n controller._setUserEventsEnabled(false);\n game.pushScene();\n game.currentScene().flags |= scene.Flag.SeeThrough;\n\n const dialog = new SplashDialog(screen.width, subtitle ? 42 : 35);\n dialog.setText(title);\n if (subtitle) dialog.setSubtext(subtitle);\n\n const s = sprites.create(dialog.image, -1);\n let pressed = true;\n let done = false;\n\n game.onUpdate(() => {\n dialog.update();\n const currentState = controller.A.isPressed();\n if (currentState && !pressed) {\n pressed = true;\n scene.setBackgroundImage(null); // GC it\n game.popScene();\n done = true;\n }\n else if (pressed && !currentState) {\n pressed = false;\n }\n })\n\n pauseUntil(() => done);\n controller._setUserEventsEnabled(true);\n }\n\n function isBreakCharacter(charCode: number) {\n return charCode <= 32 ||\n (charCode >= 58 && charCode <= 64) ||\n (charCode >= 91 && charCode <= 96) ||\n (charCode >= 123 && charCode <= 126) || \n (charCode >= 19968 && charCode <= 40869) ||\n charCode == 12290 || \n charCode == 65292;\n }\n\n function breakIntoPages(text: string, lineLengths: number[]): string[][] {\n const result: string[][] = [];\n\n let currentPage: string[] = [];\n\n let lastBreakLocation = 0;\n let lastBreak = 0;\n let line = 0;\n let lineLength = lineLengths[line];\n\n function nextLine() {\n line++;\n lineLength = lineLengths[line];\n }\n\n for (let index = 0; index < text.length; index++) {\n if (text.charAt(index) === \"\\n\") {\n currentPage.push(formatLine(text.substr(lastBreak, index - lastBreak)));\n index++;\n lastBreak = index;\n nextLine();\n }\n // Handle \\\\n in addition to \\n because that's how it gets converted from blocks\n else if (text.charAt(index) === \"\\\\\" && text.charAt(index + 1) === \"n\") {\n currentPage.push(formatLine(text.substr(lastBreak, index - lastBreak)));\n index += 2;\n lastBreak = index\n nextLine();\n }\n else if (isBreakCharacter(text.charCodeAt(index))) {\n lastBreakLocation = index;\n }\n\n if (index - lastBreak === lineLength) {\n if (lastBreakLocation === index || lastBreakLocation < lastBreak) {\n currentPage.push(formatLine(text.substr(lastBreak, lineLength)));\n lastBreak = index;\n nextLine();\n }\n else {\n currentPage.push(formatLine(text.substr(lastBreak, lastBreakLocation - lastBreak)));\n lastBreak = lastBreakLocation;\n nextLine();\n }\n }\n\n if (line >= lineLengths.length) {\n line = 0;\n lineLength = lineLengths[line];\n result.push(currentPage);\n currentPage = [];\n }\n }\n\n currentPage.push(formatLine(text.substr(lastBreak, text.length - lastBreak)));\n\n if (currentPage.length > 1 || currentPage[0] !== \"\") {\n result.push(currentPage);\n }\n\n return result;\n }\n\n function formatLine(text: string) {\n let i = 0;\n while (text.charAt(i) === \" \") i++;\n return text.substr(i, text.length);\n }\n}\n\n",
"texteffects.ts": "namespace texteffects {\n export enum TextEffectKind {\n //% block=none\n None,\n //% block=shake\n Shake,\n //% block=wave\n Wave\n }\n\n export function getTextEffect(e: TextEffectKind) {\n switch (e) {\n case texteffects.TextEffectKind.Wave:\n return texteffects.wave;\n case texteffects.TextEffectKind.Shake:\n return texteffects.shake;\n default:\n return null;\n }\n }\n \n //% fixedInstances\n export class TextEffect {\n public getState: (index?: number, state?: TextEffectState) => TextEffectState;\n \n constructor(getState: (index?: number, state?: TextEffectState) => TextEffectState) {\n this.getState = getState;\n }\n }\n\n //% fixedInstance whenUsed\n export const shake = new TextEffect(() => { \n return { xOffset: (Math.random() * 2 - 1),\n yOffset: (Math.random() * 2 - 1) }\n });\n\n\n interface WaveEffectState extends TextEffectState {\n up: boolean;\n }\n\n //% fixedInstance whenUsed\n export const wave = new TextEffect((index?: number, state?: WaveEffectState) => { // TODO cast state type\n if (!state) {\n state = {\n xOffset: 0,\n yOffset: Math.sin(index) * 2,\n up: Math.sign(Math.sin(index)) < 0\n };\n }\n\n state.yOffset += (state.up ? 1 : -1) * 0.5;\n state.up = Math.abs(state.yOffset) > 2 ? !state.up : state.up;\n\n return state\n });\n\n /**\n * A text sprite on the screen\n **/\n export class TextSprite {\n _str: string\n _font: image.Font\n _color: number;\n _effect: TextEffect\n _state: TextEffectState[]; // per-character state initialized and used by the effect\n\n get color(): number {\n return this._color;\n }\n\n get state(): TextEffectState[] {\n return this._state;\n }\n\n constructor(str: string, font: image.Font, color: number, effect?: TextEffect) {\n this._str = str;\n this._font = font;\n this._color = color;\n this._effect = effect;\n this._state = [];\n }\n\n updateState() {\n if (!this._effect) return;\n \n let i = 0;\n while (i < this._str.length) {\n this._state[i] = this._effect.getState(i, (i < this._state.length ? this._state[i] : null));\n i++;\n }\n }\n\n draw(image: Image, x: number, y: number, start?: number, length?: number): void {\n this.updateState();\n\n let s = this._str.substr(Math.max(start, 0), Math.min(length, this._str.length - start));\n image.print(s, x, y, this._color, this._font, this._state);\n }\n }\n}",
"tilemap.ts": "enum TileScale {\n //% block=\"8x8\"\n Eight = 3,\n //% block=\"16x16\"\n Sixteen = 4,\n //% block=\"32x32\"\n ThirtyTwo = 5\n}\n\nnamespace tiles {\n\n /**\n * A (col, row) location in the tilemap\n **/\n //% blockNamespace=scene color=\"#401255\"\n export class Location {\n protected _row: number;\n protected _col: number;\n\n constructor(col: number, row: number, map: TileMap) {\n this._col = col;\n this._row = row;\n }\n\n get tileMap() {\n return game.currentScene().tileMap;\n }\n\n //% group=\"Locations\" blockSetVariable=\"location\"\n //% blockCombine block=\"column\"\n //% weight=100\n get column() {\n return this._col;\n }\n\n //% group=\"Locations\" blockSetVariable=\"location\"\n //% blockCombine block=\"row\"\n //% weight=100\n get row() {\n return this._row;\n }\n\n //% group=\"Locations\" blockSetVariable=\"location\"\n //% blockCombine block=\"x\"\n //% weight=100\n get x(): number {\n const scale = this.tileMap.scale;\n return (this._col << scale) + (1 << (scale - 1));\n }\n\n //% group=\"Locations\" blockSetVariable=\"location\"\n //% blockCombine block=\"y\"\n //% weight=100\n get y(): number {\n const scale = this.tileMap.scale;\n return (this._row << scale) + (1 << (scale - 1));\n }\n\n //% group=\"Locations\" blockSetVariable=\"location\"\n //% blockCombine block=\"left\"\n //% weight=100\n get left(): number {\n return (this._col << this.tileMap.scale);\n }\n\n //% group=\"Locations\" blockSetVariable=\"location\"\n //% blockCombine block=\"top\"\n //% weight=100\n get top(): number {\n return (this._row << this.tileMap.scale);\n }\n\n //% group=\"Locations\" blockSetVariable=\"location\"\n //% blockCombine block=\"right\"\n //% weight=100\n get right(): number {\n return this.left + (1 << this.tileMap.scale);\n }\n\n //% group=\"Locations\" blockSetVariable=\"location\"\n //% blockCombine block=\"bottom\"\n //% weight=100\n get bottom(): number {\n return this.top + (1 << this.tileMap.scale);\n }\n\n get tileSet(): number {\n return this.tileMap.getTileIndex(this._col, this._row);\n }\n\n // deprecated\n get col() {\n return this.column;\n }\n\n public isWall(): boolean {\n return this.tileMap.isObstacle(this._col, this._row);\n }\n\n public getImage(): Image {\n return this.tileMap.getTileImage(this.tileSet);\n }\n\n /**\n * Returns the neighboring location in a specifc direction from a location in a tilemap\n * @param direction The direction to fetch the location in\n */\n //% blockId=tiles_location_get_neighboring_location\n //% block=\"tilemap location $direction of $this\"\n //% this.defl=location\n //% this.shadow=variables_get\n //% group=\"Locations\" blockGap=8\n //% weight=10 help=tiles/get-neighboring-location\n public getNeighboringLocation(direction: CollisionDirection): Location {\n switch (direction) {\n case CollisionDirection.Top:\n return this.tileMap.getTile(this._col, this._row - 1);\n case CollisionDirection.Right:\n return this.tileMap.getTile(this._col + 1, this._row);\n case CollisionDirection.Bottom:\n return this.tileMap.getTile(this._col, this._row + 1);\n case CollisionDirection.Left:\n return this.tileMap.getTile(this._col - 1, this._row);\n }\n }\n\n /**\n * Center the given sprite on this tile\n * @param sprite\n */\n place(mySprite: Sprite): void {\n if (!mySprite) return;\n mySprite.setPosition(this.x, this.y);\n }\n\n // ## LEGACY: DO NOT USE ##\n _toTile(): Tile {\n return new Tile(this._col, this._row, this.tileMap);\n }\n }\n\n /**\n * DEPRECATED: a tile in the tilemap\n **/\n //% blockNamespace=scene color=\"#401255\" blockGap=8\n export class Tile {\n protected _row: number;\n protected _col: number;\n protected tileMap: TileMap;\n\n constructor(col: number, row: number, map: TileMap) {\n this._col = col;\n this._row = row;\n this.tileMap = map;\n }\n\n get x(): number {\n const scale = this.tileMap.scale;\n return (this._col << scale) + (1 << (scale - 1));\n }\n\n get y(): number {\n const scale = this.tileMap.scale;\n return (this._row << scale) + (1 << (scale - 1));\n }\n\n get tileSet(): number {\n return this.tileMap.getTileIndex(this._col, this._row);\n }\n\n /**\n * Center the given sprite on this tile\n * @param sprite\n */\n //% blockId=gameplaceontile block=\"on top of %tile(myTile) place %sprite=variables_get(mySprite)\"\n //% blockNamespace=\"scene\" group=\"Tilemap Operations\"\n //% weight=25\n //% help=tiles/place\n //% deprecated=1\n place(mySprite: Sprite): void {\n if (!mySprite) return;\n mySprite.setPosition(this.x, this.y);\n }\n }\n\n const TM_DATA_PREFIX_LENGTH = 4;\n const TM_WALL = 2;\n\n //% snippet='tilemap` `'\n //% pySnippet='tilemap(\"\"\" \"\"\")'\n export class TileMapData {\n // The tile data for the map (indices into tileset)\n protected data: Buffer;\n\n // The metadata layers for the map. Currently only 1 is used for walls\n protected layers: Image;\n\n protected tileset: Image[];\n protected cachedTileView: Image[];\n\n protected _scale: TileScale;\n protected _width: number;\n protected _height: number;\n\n constructor(data: Buffer, layers: Image, tileset: Image[], scale: TileScale) {\n this.data = data;\n this.layers = layers;\n this.tileset = tileset;\n this.scale = scale;\n\n this._width = data.getNumber(NumberFormat.UInt16LE, 0);\n this._height = data.getNumber(NumberFormat.UInt16LE, 2);\n }\n\n get width(): number {\n return this._width;\n }\n\n get height(): number {\n return this._height;\n }\n\n get scale(): TileScale {\n return this._scale;\n }\n\n set scale(s: TileScale) {\n this._scale = s;\n this.cachedTileView = [];\n }\n\n getTile(col: number, row: number) {\n if (this.isOutsideMap(col, row)) return 0;\n\n return this.data.getUint8(TM_DATA_PREFIX_LENGTH + (col | 0) + (row | 0) * this.width);\n }\n\n setTile(col: number, row: number, tile: number) {\n if (this.isOutsideMap(col, row)) return;\n\n if (this.data.isReadOnly()) {\n this.data = this.data.slice();\n }\n\n this.data.setUint8(TM_DATA_PREFIX_LENGTH + (col | 0) + (row | 0) * this.width, tile);\n }\n\n getTileset() {\n return this.tileset;\n }\n\n getTileImage(index: number) {\n const size = 1 << this.scale;\n let cachedImage = this.cachedTileView[index];\n if (!cachedImage) {\n const originalImage = this.tileset[index];\n\n if (originalImage) {\n if (originalImage.width <= size && originalImage.height <= size) {\n cachedImage = originalImage;\n } else {\n cachedImage = image.create(size, size);\n cachedImage.drawImage(originalImage, 0, 0);\n }\n this.cachedTileView[index] = cachedImage;\n }\n }\n return cachedImage;\n }\n\n setWall(col: number, row: number, on: boolean) {\n return this.layers.setPixel(col, row, on ? TM_WALL : 0);\n }\n\n isWall(col: number, row: number) {\n return this.layers.getPixel(col, row) === TM_WALL;\n }\n\n isOutsideMap(col: number, row: number) {\n return col < 0 || col >= this.width || row < 0 || row >= this.height;\n }\n }\n\n export enum TileMapEvent {\n Loaded,\n Unloaded\n }\n\n export class TileMapEventHandler {\n constructor(public event: TileMapEvent, public callback: (data: TileMapData) => void) {}\n }\n\n export class TileMap {\n protected _scale: TileScale;\n\n protected _layer: number;\n protected _map: TileMapData;\n renderable: scene.Renderable;\n protected handlerState: TileMapEventHandler[];\n\n constructor(scale: TileScale = TileScale.Sixteen) {\n this._layer = 1;\n this.scale = scale;\n\n this.renderable = scene.createRenderable(\n scene.TILE_MAP_Z,\n (t, c) => this.draw(t, c)\n );\n }\n\n get scale() {\n return this._scale;\n }\n\n set scale(s: TileScale) {\n this._scale = s;\n if (this._map) {\n this._map.scale = s;\n }\n }\n\n get data(): TileMapData {\n return this._map;\n }\n\n offsetX(value: number) {\n return Math.clamp(0, Math.max(this.areaWidth() - screen.width, 0), value);\n }\n\n offsetY(value: number) {\n return Math.clamp(0, Math.max(this.areaHeight() - screen.height, 0), value);\n }\n\n areaWidth() {\n return this._map ? (this._map.width << this.scale) : 0;\n }\n\n areaHeight() {\n return this._map ? (this._map.height << this.scale) : 0;\n }\n\n get layer(): number {\n return this._layer;\n }\n\n set layer(value: number) {\n if (this._layer != value) {\n this._layer = value;\n }\n }\n\n get enabled(): boolean {\n return !!this._map;\n }\n\n setData(map: TileMapData) {\n const previous = this._map;\n\n if (this.handlerState && previous !== map && previous) {\n for (const eventHandler of this.handlerState) {\n if (eventHandler.event === TileMapEvent.Unloaded) {\n eventHandler.callback(previous);\n }\n }\n }\n\n this._map = map;\n if (map) {\n this._scale = map.scale;\n }\n\n if (this.handlerState && previous !== map && map) {\n for (const eventHandler of this.handlerState) {\n if (eventHandler.event === TileMapEvent.Loaded) {\n eventHandler.callback(map);\n }\n }\n }\n }\n\n public getTile(col: number, row: number): Location {\n return new Location(col, row, this);\n }\n\n public getTileIndex(col: number, row: number) {\n return this.data.getTile(col, row);\n }\n\n public setTileAt(col: number, row: number, index: number): void {\n if (!this._map.isOutsideMap(col, row) && !this.isInvalidIndex(index))\n this._map.setTile(col, row, index);\n }\n\n public getImageType(im: Image): number {\n const tileset = this._map.getTileset();\n for (let i = 0; i < tileset.length; i++)\n if (tileset[i].equals(im)) return i;\n\n // not found; append to the tileset if there are spots left.\n const newIndex = tileset.length;\n if (!this.isInvalidIndex(newIndex)) {\n tileset.push(im);\n return newIndex;\n }\n\n return -1;\n }\n\n public setWallAt(col: number, row: number, on: boolean): void {\n if (!this._map.isOutsideMap(col, row))\n this._map.setWall(col, row, on);\n }\n\n public getTilesByType(index: number): Location[] {\n if (this.isInvalidIndex(index) || !this.enabled) return [];\n\n let output: Location[] = [];\n for (let col = 0; col < this._map.width; ++col) {\n for (let row = 0; row < this._map.height; ++row) {\n let currTile = this._map.getTile(col, row);\n if (currTile === index) {\n output.push(new Location(col, row, this));\n }\n }\n }\n return output;\n }\n\n public sampleTilesByType(index: number, maxCount: number): Location[] {\n if (this.isInvalidIndex(index) || !this.enabled || maxCount <= 0) return [];\n\n let count = 0;\n const reservoir: Location[] = [];\n for (let col = 0; col < this._map.width; ++col) {\n for (let row = 0; row < this._map.height; ++row) {\n let currTile = this._map.getTile(col, row);\n if (currTile === index) {\n // first **maxCount** elements just enqueue\n if (count < maxCount) {\n reservoir.push(new Location(col, row, this));\n } else {\n const potentialIndex = randint(0, count);\n if (potentialIndex < maxCount) {\n reservoir[potentialIndex] = new Location(col, row, this);\n }\n }\n ++count;\n }\n }\n }\n\n return reservoir;\n }\n\n protected isInvalidIndex(index: number): boolean {\n return index < 0 || index > 0xff;\n }\n\n protected draw(target: Image, camera: scene.Camera) {\n if (!this.enabled) return;\n\n // render tile map\n const bitmask = (0x1 << this.scale) - 1;\n const offsetX = camera.drawOffsetX & bitmask;\n const offsetY = camera.drawOffsetY & bitmask;\n\n const x0 = Math.max(0, camera.drawOffsetX >> this.scale);\n const xn = Math.min(this._map.width, ((camera.drawOffsetX + target.width) >> this.scale) + 1);\n const y0 = Math.max(0, camera.drawOffsetY >> this.scale);\n const yn = Math.min(this._map.height, ((camera.drawOffsetY + target.height) >> this.scale) + 1);\n\n for (let x = x0; x <= xn; ++x) {\n for (let y = y0; y <= yn; ++y) {\n const index = this._map.getTile(x, y);\n const tile = this._map.getTileImage(index);\n if (tile) {\n target.drawTransparentImage(\n tile,\n ((x - x0) << this.scale) - offsetX,\n ((y - y0) << this.scale) - offsetY\n );\n }\n }\n }\n\n if (game.debug) {\n // render debug grid overlay\n for (let x = x0; x <= xn; ++x) {\n const xLine = ((x - x0) << this.scale) - offsetX;\n if (xLine >= 0 && xLine <= screen.width) {\n target.drawLine(\n xLine,\n 0,\n xLine,\n target.height,\n 1\n );\n }\n }\n\n for (let y = y0; y <= yn; ++y) {\n const yLine = ((y - y0) << this.scale) - offsetY;\n if (yLine >= 0 && yLine <= screen.height) {\n target.drawLine(\n 0,\n yLine,\n target.width,\n yLine,\n 1\n );\n }\n }\n }\n }\n\n public isObstacle(col: number, row: number) {\n if (!this.enabled) return false;\n if (this._map.isOutsideMap(col, row)) return true;\n\n return this._map.isWall(col, row);\n }\n\n public getObstacle(col: number, row: number) {\n const index = this._map.isOutsideMap(col, row) ? 0 : this._map.getTile(col, row);\n const tile = this._map.getTileImage(index);\n return new sprites.StaticObstacle(\n tile,\n row << this.scale,\n col << this.scale,\n this.layer,\n index\n );\n }\n\n public isOnWall(s: Sprite) {\n const hbox = s._hitbox;\n\n const left = Fx.toIntShifted(hbox.left, this.scale);\n const right = Fx.toIntShifted(hbox.right, this.scale);\n const top = Fx.toIntShifted(hbox.top, this.scale);\n const bottom = Fx.toIntShifted(hbox.bottom, this.scale);\n\n for (let col = left; col <= right; ++col) {\n for (let row = top; row <= bottom; ++row) {\n if (this.isObstacle(col, row)) {\n return true;\n }\n }\n }\n\n return false;\n }\n\n public getTileImage(index: number) {\n return this.data.getTileImage(index);\n }\n\n public addEventListener(event: TileMapEvent, handler: (data: TileMapData) => void) {\n if (!this.handlerState) this.handlerState = [];\n\n for (const eventHandler of this.handlerState) {\n if (eventHandler.event === event && eventHandler.callback === handler) return;\n }\n this.handlerState.push(new TileMapEventHandler(event, handler));\n }\n\n public removeEventListener(event: TileMapEvent, handler: (data: TileMapData) => void) {\n if (!this.handlerState) return;\n\n for (let i = 0; i < this.handlerState.length; i++) {\n if (this.handlerState[i].event === event && this.handlerState[i].callback === handler) {\n this.handlerState.splice(i, 1)\n return;\n }\n }\n }\n }\n\n function mkColorTile(index: number, scale: TileScale): Image {\n const size = 1 << scale\n\n const i = image.create(size, size);\n i.fill(index);\n return i;\n }\n\n //% scale.defl=\"TileScale.Sixteen\"\n export function createTilemap(data: Buffer, layer: Image, tiles: Image[], scale: TileScale): TileMapData {\n return new TileMapData(data, layer, tiles, scale)\n }\n\n //% blockId=tilemap_editor block=\"set tilemap to $tilemap\"\n //% weight=200 blockGap=8\n //% tilemap.fieldEditor=\"tilemap\"\n //% tilemap.fieldOptions.decompileArgumentAsString=\"true\"\n //% tilemap.fieldOptions.filter=\"tile\"\n //% tilemap.fieldOptions.taggedTemplate=\"tilemap\"\n //% blockNamespace=\"scene\" duplicateShadowOnDrag\n //% help=tiles/set-tilemap\n //% deprecated=1\n export function setTilemap(tilemap: TileMapData) {\n setCurrentTilemap(tilemap);\n }\n\n /**\n * Sets the given tilemap to be the current active tilemap in the game\n *\n * @param tilemap The tilemap to set as the current tilemap\n */\n //% blockId=set_current_tilemap block=\"set tilemap to $tilemap\"\n //% weight=201 blockGap=8\n //% tilemap.shadow=tiles_tilemap_editor\n //% blockNamespace=\"scene\" group=\"Tilemaps\" duplicateShadowOnDrag\n //% help=tiles/set-current-tilemap\n export function setCurrentTilemap(tilemap: TileMapData) {\n scene.setTileMapLevel(tilemap);\n }\n\n /**\n * Set a location in the map (column, row) to a tile\n * @param loc\n * @param tile\n */\n //% blockId=mapsettileat block=\"set $tile at $loc=mapgettile\"\n //% tile.shadow=tileset_tile_picker\n //% tile.decompileIndirectFixedInstances=true\n //% blockNamespace=\"scene\" group=\"Tilemap Operations\" blockGap=8\n //% help=tiles/set-tile-at\n //% weight=70\n export function setTileAt(loc: Location, tile: Image): void {\n const scene = game.currentScene();\n if (!loc || !tile || !scene.tileMap) return null;\n const scale = scene.tileMap.scale;\n const index = scene.tileMap.getImageType(tile);\n scene.tileMap.setTileAt(loc.x >> scale, loc.y >> scale, index);\n }\n\n /**\n * Set or unset a wall at a location in the map (column, row)\n * @param loc\n * @param on\n */\n //% blockId=mapsetwallat block=\"set wall $on at $loc\"\n //% on.shadow=toggleOnOff loc.shadow=mapgettile\n //% blockNamespace=\"scene\" group=\"Tilemap Operations\"\n //% help=tiles/set-wall-at\n //% weight=60\n export function setWallAt(loc: Location, on: boolean): void {\n const scene = game.currentScene();\n if (!loc || !scene.tileMap) return null;\n const scale = scene.tileMap.scale;\n scene.tileMap.setWallAt(loc.x >> scale, loc.y >> scale, on);\n }\n\n /**\n * Get the tile position given a column and row in the tilemap\n * @param col\n * @param row\n */\n //% blockId=mapgettile block=\"tilemap col $col row $row\"\n //% blockNamespace=\"scene\" group=\"Locations\"\n //% weight=100 blockGap=8\n //% help=tiles/get-tile-location\n export function getTileLocation(col: number, row: number): Location {\n const scene = game.currentScene();\n if (col == undefined || row == undefined || !scene.tileMap) return null;\n return scene.tileMap.getTile(col, row);\n }\n\n /**\n * Get the image of a tile, given a location in the tilemap\n * @param loc\n */\n export function getTileImage(loc: Location): Image {\n const scene = game.currentScene();\n if (!loc || !scene.tileMap) return img``;\n return scene.tileMap.getTileImage(loc.tileSet);\n }\n\n /**\n * Get the image of a tile, given a (column, row) in the tilemap\n * @param loc\n */\n export function getTileAt(col: number, row: number): Image {\n const scene = game.currentScene();\n if (col == undefined || row == undefined || !scene.tileMap) return img``;\n return scene.tileMap.getTileImage(tiles.getTileLocation(col, row).tileSet);\n }\n\n /**\n * Returns true if the tile at the given location is the same as the given tile;\n * otherwise returns false\n * @param location\n * @param tile\n */\n //% blockId=maplocationistile block=\"tile at $location is $tile\"\n //% location.shadow=mapgettile\n //% tile.shadow=tileset_tile_picker tile.decompileIndirectFixedInstances=true\n //% blockNamespace=\"scene\" group=\"Locations\" blockGap=8\n //% weight=40 help=tiles/tile-at-location-equals\n export function tileAtLocationEquals(location: Location, tile: Image): boolean {\n const scene = game.currentScene();\n if (!location || !tile || !scene.tileMap) return false;\n return location.tileSet === scene.tileMap.getImageType(tile);\n }\n\n /**\n * Returns true if the tile at the given location is a wall in the current tilemap;\n * otherwise returns false\n * @param location The location to check for a wall\n */\n //% blockId=tiles_tile_at_location_is_wall\n //% block=\"tile at $location is wall\"\n //% location.shadow=mapgettile\n //% blockNamespace=\"scene\" group=\"Locations\" blockGap=8\n //% weight=30 help=tiles/tile-at-location-is-wall\n export function tileAtLocationIsWall(location: Location): boolean {\n if (!location || !location.tileMap) return false;\n return location.isWall();\n }\n\n /**\n * Returns the image of the tile at the given location in the current tilemap\n *\n * @param location The location of the image to fetch\n */\n //% blockId=tiles_image_at_location\n //% block=\"tile image at $location\"\n //% location.shadow=mapgettile\n //% weight=0 help=tiles/tile-image-at-location\n //% blockNamespace=\"scene\" group=\"Locations\"\n export function tileImageAtLocation(location: Location): Image {\n const scene = game.currentScene();\n if (!location || !scene.tileMap) return img``;\n return location.getImage();\n }\n\n /**\n * Center the given sprite on a given location\n * @param sprite\n * @param loc\n */\n //% blockId=mapplaceontile block=\"place $sprite=variables_get(mySprite) on top of $loc\"\n //% loc.shadow=mapgettile\n //% blockNamespace=\"scene\" group=\"Tilemap Operations\" blockGap=8\n //% help=tiles/place-on-tile\n //% weight=100\n export function placeOnTile(sprite: Sprite, loc: Location): void {\n if (!sprite || !loc || !loc.tileMap) return;\n loc.place(sprite);\n }\n\n /**\n * Center the given sprite on a random location that is the given type (image)\n * @param sprite\n * @param tile\n */\n //% blockId=mapplaceonrandomtile block=\"place $sprite=variables_get(mySprite) on top of random $tile\"\n //% tile.shadow=tileset_tile_picker\n //% tile.decompileIndirectFixedInstances=true\n //% blockNamespace=\"scene\" group=\"Tilemap Operations\"\n //% help=tiles/place-on-random-tile\n //% weight=90\n export function placeOnRandomTile(sprite: Sprite, tile: Image): void {\n if (!sprite || !game.currentScene().tileMap) return;\n const loc = getRandomTileByType(tile);\n if (loc)\n loc.place(sprite);\n }\n\n /**\n * Get all tiles in the tilemap with the given type (image).\n * @param tile\n */\n //% blockId=mapgettilestype block=\"array of all $tile locations\"\n //% tile.shadow=tileset_tile_picker\n //% tile.decompileIndirectFixedInstances=true\n //% blockNamespace=\"scene\" group=\"Locations\" blockGap=8\n //% help=tiles/get-tiles-by-type\n //% weight=10\n export function getTilesByType(tile: Image): Location[] {\n const scene = game.currentScene();\n if (!tile || !scene.tileMap) return [];\n const index = scene.tileMap.getImageType(tile);\n return scene.tileMap.getTilesByType(index);\n }\n\n /**\n * Get a random tile of the given type\n * @param tile the type of tile to get a random selection of\n */\n export function getRandomTileByType(tile: Image): Location {\n const scene = game.currentScene();\n if (!tile || !scene.tileMap)\n return undefined;\n const index = scene.tileMap.getImageType(tile);\n const sample = scene.tileMap.sampleTilesByType(index, 1);\n return sample[0];\n }\n\n /**\n * A tilemap\n */\n //% blockId=tiles_tilemap_editor shim=TD_ID\n //% weight=200 blockGap=8\n //% block=\"tilemap $tilemap\"\n //% tilemap.fieldEditor=\"tilemap\"\n //% tilemap.fieldOptions.decompileArgumentAsString=\"true\"\n //% tilemap.fieldOptions.filter=\"tile\"\n //% tilemap.fieldOptions.taggedTemplate=\"tilemap\"\n //% blockNamespace=\"scene\" group=\"Tilemaps\" duplicateShadowOnDrag\n //% help=tiles/tilemap\n export function _tilemapEditor(tilemap: TileMapData): TileMapData {\n return tilemap;\n }\n\n /**\n * Adds an event handler that will fire whenever the specified event\n * is triggered. Unloaded tilemap events will fire before the new tilemap\n * is set and loaded events will fire afterwards. The same handler can\n * not be added for the same event more than once.\n *\n * @param event The event to subscribe to\n * @param handler The code to run when the event triggers\n */\n export function addEventListener(event: TileMapEvent, callback: (data: TileMapData) => void) {\n const scene = game.currentScene();\n\n if (!scene.tileMap) {\n scene.tileMap = new TileMap();\n }\n\n scene.tileMap.addEventListener(event, callback);\n }\n\n\n /**\n * Removes an event handler registered with addEventListener.\n *\n * @param event The event that the handler was registered for\n * @param handler The handler to remove\n */\n export function removeEventListener(event: TileMapEvent, callback: (data: TileMapData) => void) {\n const scene = game.currentScene();\n\n if (!scene.tileMap) return;\n\n scene.tileMap.removeEventListener(event, callback);\n }\n}\n"
},
"game---light": {
"compat.ts": "namespace scene.systemMenu {\n export function isVisible() {\n return false\n }\n}\n\nnamespace scene {\n export const SCREEN_CLEAR_PRIORITY = 1;\n export const UPDATE_INTERVAL_PRIORITY = 19;\n export const UPDATE_PRIORITY = 20;\n\n export const PRE_RENDER_UPDATE_PRIORITY = 55;\n export const RENDER_BACKGROUND_PRIORITY = 60;\n export const RENDER_SPRITES_PRIORITY = 90;\n export const RENDER_DIAGNOSTICS_PRIORITY = 150;\n export const UPDATE_SCREEN_PRIORITY = 200;\n}\n\nclass Scene {\n millis() {\n return control.millis()\n }\n}\n\nnamespace game {\n export let stats = false;\n let inited = false\n\n const _scene = new Scene()\n export function currentScene() {\n return _scene\n }\n\n export function pushScene() {\n const ctx = control.pushEventContext()\n ctx.registerFrameHandler(scene.RENDER_BACKGROUND_PRIORITY, () => {\n screen.fill(0)\n });\n ctx.registerFrameHandler(scene.UPDATE_SCREEN_PRIORITY, control.__screen.update);\n }\n\n export function popScene() {\n control.popEventContext()\n }\n\n export function eventContext() {\n if (!inited) {\n inited = true\n pushScene()\n }\n return control.eventContext()\n }\n\n let __waitAnyButton: () => void;\n export function setWaitAnyButton(f: () => void) {\n __waitAnyButton = f\n }\n\n /**\n * Draw on screen before sprites, after background\n * @param body code to execute\n */\n //% group=\"Gameplay\"\n //% help=game/paint weight=10 afterOnStart=true\n export function onPaint(a: () => void): void {\n if (!a) return;\n control.eventContext().registerFrameHandler(scene.RENDER_SPRITES_PRIORITY - 1, a);\n }\n\n /**\n * Draw on screen after sprites\n * @param body code to execute\n */\n //% group=\"Gameplay\"\n //% help=game/shade weight=10 afterOnStart=true\n export function onShade(a: () => void): void {\n if (!a) return;\n control.eventContext().registerFrameHandler(scene.RENDER_SPRITES_PRIORITY, a);\n }\n\n}\n\nnamespace controller {\n export function _player1() {\n return new Controller(1, undefined)\n }\n export class Controller {\n constructor(no: number, v: any) { }\n connected: boolean\n }\n}\n",
"console.ts": "namespace game.consoleOverlay {\n let consoleColor = 1;\n let consoleStrings: string[];\n let tabSize = 8;\n const marginx = 4;\n const marginy = 2;\n const consoleFont = image.font5;\n const consoleLines = Math.floor(screen.height / (consoleFont.charHeight + marginy)) - 1;\n const consoleColumns = Math.floor((screen.width - 2 * marginx) / consoleFont.charWidth);\n console.addListener(listener);\n\n export function isVisible() {\n return !!consoleStrings;\n }\n\n export function clear() {\n consoleStrings = [];\n }\n\n export function setVisible(value: boolean, col?: number) {\n if (value != !!consoleStrings)\n consoleStrings = value ? [] : undefined;\n if (col !== undefined)\n consoleColor = col;\n }\n\n function listener(priority: ConsolePriority, text: string) {\n if (!consoleStrings || !text)\n return;\n\n // split text into lines\n text.split(\"\\n\")\n .filter(line => !!line)\n .forEach(line => {\n for (let j = 0; j < line.length; j += consoleColumns) {\n consoleStrings.push(line.slice(j, j + consoleColumns));\n }\n });\n\n if (consoleStrings.length > consoleLines) {\n consoleStrings.splice(0, consoleStrings.length - consoleLines);\n }\n }\n\n export function draw() {\n if (!consoleStrings || scene.systemMenu.isVisible()) return;\n const height = consoleFont.charHeight + marginy;\n const top = 2 + (game.stats ? height : 0);\n for (let i = 0; i < consoleStrings.length; ++i) {\n if (consoleStrings[i].indexOf(\"\\t\") >= 0) {\n const t = consoleStrings[i].split(\"\\t\");\n let tOff = 0;\n for (let tab of t) {\n let padding = tabSize - ((tOff + tab.length) % tabSize)\n screen.print(tab, marginx + (tOff * consoleFont.charWidth), top + i * height, consoleColor, consoleFont);\n tOff += tab.length + padding;\n }\n }\n else\n screen.print(consoleStrings[i], marginx, top + i * height, consoleColor, consoleFont);\n }\n }\n}",
"constants.ts": "const KEY_UP = 2048;\nconst KEY_DOWN = 2049;\nconst INTERNAL_KEY_UP = 2050;\nconst INTERNAL_KEY_DOWN = 2051;\nconst SYSTEM_KEY_UP = 2052;\nconst SYSTEM_KEY_DOWN = 2053;\nconst KEY_REPEAT = 2054;\nconst SYSTEM_KEY_REPEAT = 2055;\n",
"controllerbutton.ts": "enum ControllerButtonEvent {\n //% block=\"pressed\"\n Pressed = KEY_DOWN,\n //% block=\"released\"\n Released = KEY_UP,\n //% block=\"repeat\"\n Repeated = KEY_REPEAT\n}\n\nenum ControllerButton {\n //% block=\"{id:controller}A\"\n A = 5,\n //% block=\"{id:controller}B\"\n B = 6,\n //% block=\"left\"\n Left = 1,\n //% block=\"up\"\n Up = 2,\n //% block=\"right\"\n Right = 3,\n //% block=\"down\"\n Down = 4\n}\n\n/**\n * Access to game controls\n */\n//% weight=98 color=\"#D54322\" icon=\"\\uf11b\"\n//% groups='[\"Single Player\", \"Multiplayer\"]'\n//% blockGap=8\nnamespace controller {\n let _userEventsEnabled = true;\n let defaultRepeatDelay = 500;\n let defaultRepeatInterval = 30;\n\n //% shim=pxt::pressureLevelByButtonId\n declare function pressureLevelByButtonId(btnId: number, codalId: number): number;\n\n //% shim=pxt::setupButton\n function setupButton(buttonId: number, key: number) {\n return // missing in sim\n }\n\n export class ButtonHandler {\n constructor(public event: number, public callback: () => void) { }\n }\n\n export class ButtonEventHandlerState {\n constructor(public id: number) {};\n\n public user: ButtonHandler[];\n public system: ButtonHandler[];\n }\n\n //% fixedInstances\n export class Button {\n _owner: Controller;\n public id: number;\n //% help=controller/button/repeat-delay\n public repeatDelay: number;\n //% help=controller/button/repeat-interval\n public repeatInterval: number;\n private _pressed: boolean;\n private _pressedElasped: number;\n private _repeatCount: number;\n\n protected get handlerState(): ButtonEventHandlerState {\n for (const state of game.currentScene().buttonEventHandlers) {\n if (state.id === this.id) return state;\n }\n return undefined;\n }\n\n toString(): string {\n return `btn ${this.id} ${this._pressed ? \"down\" : \"up\"}`;\n }\n\n constructor(id: number, configKey: number) {\n this.id = id;\n this._pressed = false;\n this.repeatDelay = undefined;\n this.repeatInterval = undefined;\n this._repeatCount = 0;\n\n if (id > 0) {\n // this is to deal with the \"anyButton\" hack, which creates a button that is not visible\n // in the UI, but used in event-handler to simulate the wildcard ANY for matching. As\n // this button can't actually be pressed, we don't want it to propagate events\n control.internalOnEvent(INTERNAL_KEY_UP, this.id, () => this.setPressed(false), 16)\n control.internalOnEvent(INTERNAL_KEY_DOWN, this.id, () => this.setPressed(true), 16)\n\n if (configKey > 0)\n setupButton(id, configKey)\n }\n }\n\n private raiseButtonUp() {\n if (_userEventsEnabled)\n control.raiseEvent(KEY_UP, this.id)\n else\n control.raiseEvent(SYSTEM_KEY_UP, this.id);\n }\n\n private raiseButtonDown() {\n if (_userEventsEnabled)\n control.raiseEvent(KEY_DOWN, this.id)\n else\n control.raiseEvent(SYSTEM_KEY_DOWN, this.id)\n }\n\n private raiseButtonRepeat() {\n if (_userEventsEnabled)\n control.raiseEvent(KEY_REPEAT, this.id)\n else\n control.raiseEvent(SYSTEM_KEY_REPEAT, this.id)\n }\n\n /**\n * Run some code when a button is pressed, released, or held\n */\n //% weight=99 blockGap=8 help=controller/button/on-event\n //% blockId=keyonevent block=\"on %button **button** %event\"\n //% group=\"Single Player\"\n onEvent(event: ControllerButtonEvent, handler: () => void) {\n const eventHandler = this.getOrCreateHandlerForEvent(event);\n eventHandler.callback = handler;\n }\n\n /**\n * Adds an event handler that will fire whenever the specified event\n * is triggered on this button. Handlers added using this method will\n * not conflict with events added via onEvent. The same handler can\n * not be added for the same event more than once.\n *\n * @param event The event to subscribe to for this button\n * @param handler The code to run when the event triggers\n */\n addEventListener(event: ControllerButtonEvent, handler: () => void) {\n this.getOrCreateHandlerForEvent(event);\n\n const handlerState = this.handlerState;\n\n if (!handlerState.system) handlerState.system = [];\n\n for (const eventHandler of handlerState.system) {\n if (eventHandler.event === event && eventHandler.callback === handler) return;\n }\n\n handlerState.system.push(new ButtonHandler(event, handler));\n }\n\n /**\n * Removes an event handler registered with addEventListener.\n *\n * @param event The event that the handler was registered for\n * @param handler The handler to remove\n */\n removeEventListener(event: ControllerButtonEvent, handler: () => void) {\n const handlerState = this.handlerState;\n if (!handlerState || !handlerState.system) return;\n\n for (let i = 0; i < handlerState.system.length; i++) {\n if (handlerState.system[i].event === event && handlerState.system[i].callback === handler) {\n handlerState.system.splice(i, 1)\n return;\n }\n }\n }\n\n /**\n * Pauses until a button is pressed or released\n */\n //% weight=98 blockGap=8 help=controller/button/pause-until\n // blockId=keypauseuntil block=\"pause until %button **button** is %event\"\n //% group=\"Single Player\"\n pauseUntil(event: ControllerButtonEvent) {\n control.waitForEvent(event, this.id)\n }\n\n /**\n * Indicates if the button is currently pressed\n */\n //% weight=96 blockGap=8 help=controller/button/is-pressed\n //% blockId=keyispressed block=\"is %button **button** pressed\"\n //% group=\"Single Player\"\n isPressed() {\n return this._pressed;\n }\n\n /**\n * Indicates how hard the button is pressed, 0-512\n */\n pressureLevel() {\n if (control.deviceDalVersion() == \"sim\") {\n return this.isPressed() ? 512 : 0\n // once implemented in sim, this could be similar to the one below\n } else {\n return pressureLevelByButtonId(this.id, -1);\n }\n }\n\n setPressed(pressed: boolean) {\n if (this._pressed != pressed) {\n power.poke();\n if (this._owner)\n this._owner.connected = true;\n this._pressed = pressed;\n if (this._pressed) {\n this._pressedElasped = 0;\n this.raiseButtonDown();\n } else {\n this._repeatCount = 0;\n this.raiseButtonUp();\n }\n }\n }\n\n __update(dtms: number) {\n if (!this._pressed) return;\n this._pressedElasped += dtms;\n\n const delay = this.repeatDelay === undefined ? defaultRepeatDelay : this.repeatDelay;\n const interval = this.repeatInterval === undefined ? defaultRepeatInterval : this.repeatInterval;\n\n // inital delay\n if (this._pressedElasped < delay)\n return;\n\n // repeat count for this step\n const count = Math.floor((this._pressedElasped - delay - interval) / interval);\n if (count != this._repeatCount) {\n this.raiseButtonRepeat();\n this._repeatCount = count;\n }\n }\n\n protected runButtonEvents(event: ControllerButtonEvent) {\n const handlerState = this.handlerState;\n if (!handlerState) return;\n\n const userHandler = this.getOrCreateHandlerForEvent(event);\n if (userHandler.callback) userHandler.callback();\n\n if (handlerState.system) {\n for (const eventHandler of handlerState.system) {\n if (eventHandler.event === event && eventHandler.callback) eventHandler.callback();\n }\n }\n }\n\n protected getOrCreateHandlerForEvent(event: ControllerButtonEvent) {\n if (!this.handlerState) {\n game.currentScene().buttonEventHandlers.push(new ButtonEventHandlerState(this.id));\n }\n\n const handlerState = this.handlerState;\n if (!handlerState.user) handlerState.user = [];\n\n for (const eventHandler of handlerState.user) {\n if (eventHandler.event === event) {\n return eventHandler;\n }\n }\n\n // Register actual handler if this hasn't been used before\n control.onEvent(event, this.id, () => this.runButtonEvents(event));\n\n const newHandler = new ButtonHandler(event, undefined);\n handlerState.user.push(newHandler);\n return newHandler;\n }\n }\n\n /**\n * Configures the timing of the on button repeat event for all of the controller buttons\n * @param delay number of milliseconds from when the button is pressed to when the repeat event starts firing, eg: 500\n * @param interval minimum number of milliseconds between calls to the button repeat event, eg: 30\n */\n export function setRepeatDefault(delay: number, interval: number) {\n defaultRepeatDelay = delay;\n defaultRepeatInterval = interval;\n }\n\n /**\n * Pause the program until a button is pressed\n */\n //% weight=10\n export function pauseUntilAnyButtonIsPressed() {\n control.waitForEvent(KEY_DOWN, 0)\n }\n\n export function _setUserEventsEnabled(enabled: boolean) {\n _userEventsEnabled = enabled;\n }\n}\n",
"controllerbuttons.cpp": "#include \"pxt.h\"\n\n#ifdef PXT_CODAL\n\nnamespace pxt {\n\nclass PressureButton : public codal::Button {\n public:\n PressureButton(Pin &pin, uint16_t id,\n ButtonEventConfiguration eventConfiguration = DEVICE_BUTTON_ALL_EVENTS,\n ButtonPolarity polarity = ACTIVE_LOW, PullMode mode = PullMode::None)\n : Button(pin, id, eventConfiguration, polarity, mode) {}\n\n virtual int pressureLevel() { return isPressed() ? 512 : 0; }\n};\n\nstruct AnalogCache {\n AnalogCache *next;\n Pin *pin;\n uint32_t lastMeasureMS;\n uint16_t lastMeasure;\n AnalogCache(Pin *pin) : pin(pin) {\n next = NULL;\n lastMeasureMS = 0;\n lastMeasure = pin->getAnalogValue();\n }\n uint16_t read();\n};\n\nuint16_t AnalogCache::read() {\n uint32_t now = current_time_ms();\n if (now - lastMeasureMS < 50)\n return lastMeasure;\n lastMeasureMS = now;\n lastMeasure = pin->getAnalogValue();\n return lastMeasure;\n}\n\nstatic AnalogCache *analogCache;\n\nclass AnalogButton : public PressureButton {\n public:\n AnalogCache *cache;\n int16_t threshold;\n bool state;\n\n AnalogButton(AnalogCache *cache, uint16_t id, int threshold)\n : PressureButton(*cache->pin, id), cache(cache), threshold(threshold), state(false) {}\n\n protected:\n virtual int pressureLevel() override {\n int v = cache->read() - 512;\n if (threshold < 0)\n v = -v;\n int vmin = getConfig(CFG_ANALOG_JOYSTICK_MIN, 50);\n int vmax = getConfig(CFG_ANALOG_JOYSTICK_MAX, 500);\n v = (v - vmin) * 512 / (vmax - vmin);\n if (v < 0)\n v = 0;\n if (v > 512)\n v = 512;\n return v;\n }\n\n virtual int buttonActive() override {\n int v = cache->read() - 512;\n int thr = threshold;\n\n if (thr < 0) {\n v = -v;\n thr = -thr;\n }\n\n if (v > thr)\n state = true;\n else if (state && v > thr * 3 / 4)\n state = true;\n else\n state = false;\n\n return state;\n }\n};\n\nAnalogCache *lookupAnalogCache(Pin *pin) {\n for (auto c = analogCache; c; c = c->next)\n if (c->pin == pin)\n return c;\n auto c = new AnalogCache(pin);\n c->next = analogCache;\n analogCache = c;\n return c;\n}\n\nint multiplexedButtonIsPressed(int btnId);\nint registerMultiplexedButton(int pin, int buttonId);\n\n//% expose\nint pressureLevelByButtonId(int btnId, int codalId) {\n if (codalId <= 0)\n codalId = DEVICE_ID_FIRST_BUTTON + btnId;\n auto btn = (PressureButton *)lookupComponent(codalId);\n if (!btn) {\n return multiplexedButtonIsPressed(btnId) ? 512 : 0;\n }\n return btn->pressureLevel();\n}\n\nstatic void sendBtnDown(Event ev) {\n Event(PXT_INTERNAL_KEY_DOWN, ev.source - DEVICE_ID_FIRST_BUTTON);\n}\n\nstatic void sendBtnUp(Event ev) {\n Event(PXT_INTERNAL_KEY_UP, ev.source - DEVICE_ID_FIRST_BUTTON);\n}\n\n//% expose\nvoid setupButton(int buttonId, int key) {\n int pin = getConfig(key);\n if (pin == -1)\n return;\n\n unsigned highflags = (unsigned)pin >> 16;\n int flags = BUTTON_ACTIVE_LOW_PULL_UP;\n if (highflags & 0xff)\n flags = highflags & 0xff;\n\n pin &= 0xffff;\n\n auto cpid = DEVICE_ID_FIRST_BUTTON + buttonId;\n auto btn = (PressureButton *)lookupComponent(cpid);\n if (btn == NULL) {\n if (registerMultiplexedButton(pin, buttonId))\n return;\n\n if (1100 <= pin && pin < 1300) {\n pin -= 1100;\n int thr = getConfig(CFG_ANALOG_BUTTON_THRESHOLD, 300);\n if (pin >= 100) {\n thr = -thr;\n pin -= 100;\n }\n btn = new AnalogButton(lookupAnalogCache(lookupPin(pin)), cpid, thr);\n } else {\n auto pull = PullMode::None;\n if ((flags & 0xf0) == 0x10)\n pull = PullMode::Down;\n else if ((flags & 0xf0) == 0x20)\n pull = PullMode::Up;\n else if ((flags & 0xf0) == 0x30)\n pull = PullMode::None;\n else\n oops(3);\n btn = new PressureButton(*lookupPin(pin), cpid, DEVICE_BUTTON_ALL_EVENTS,\n (ButtonPolarity)(flags & 0xf), pull);\n }\n EventModel::defaultEventBus->listen(btn->id, DEVICE_BUTTON_EVT_DOWN, sendBtnDown);\n EventModel::defaultEventBus->listen(btn->id, DEVICE_BUTTON_EVT_UP, sendBtnUp);\n }\n}\n\n} // namespace pxt\n\n#endif",
"controlleroverrides.ts": "namespace controller {\n //% fixedInstance whenUsed block=\"{id:controller}A\"\n export const A = new Button(ControllerButton.A, DAL.CFG_PIN_BTN_A);\n //% fixedInstance whenUsed block=\"{id:controller}B\"\n export const B = new Button(ControllerButton.B, DAL.CFG_PIN_BTN_B);\n //% fixedInstance whenUsed block=\"left\"\n export const left = new Button(ControllerButton.Left, DAL.CFG_PIN_BTN_LEFT);\n //% fixedInstance whenUsed block=\"up\"\n export const up = new Button(ControllerButton.Up, DAL.CFG_PIN_BTN_UP);\n //% fixedInstance whenUsed block=\"right\"\n export const right = new Button(ControllerButton.Right, DAL.CFG_PIN_BTN_RIGHT);\n //% fixedInstance whenUsed block=\"down\"\n export const down = new Button(ControllerButton.Down, DAL.CFG_PIN_BTN_DOWN);\n //% fixedInstance whenUsed block=\"menu\"\n export const menu = new Button(7, DAL.CFG_PIN_BTN_MENU);\n\n //% fixedInstance whenUsed block=\"player 2\"\n export const player2 = new Controller(2, undefined);\n //% fixedInstance whenUsed block=\"player 3\"\n export const player3 = new Controller(3, undefined);\n //% fixedInstance whenUsed block=\"player 4\"\n export const player4 = new Controller(4, undefined);\n //% fixedInstance whenUsed block=\"player 1\"\n export const player1 = controller._player1();\n}",
"gameutil.ts": "/**\n * Game transitions and dialog\n **/\n//% color=#8854d0 weight=97 icon=\"\\uf111\"\n//% groups='[\"Gameplay\", \"Prompt\"]'\nnamespace game {\n\n /**\n * Update the position and velocities of sprites\n * @param body code to execute\n */\n //% group=\"Gameplay\"\n //% help=game/on-update weight=100 afterOnStart=true\n //% blockId=gameupdate block=\"on game update\"\n //% blockAllowMultiple=1\n export function onUpdate(a: () => void): void {\n if (!a) return;\n game.eventContext().registerFrameHandler(scene.UPDATE_PRIORITY, a);\n }\n\n /**\n * Run code on an interval of time. This executes before game.onUpdate()\n * @param body code to execute\n */\n //% group=\"Gameplay\"\n //% help=game/on-update-interval weight=99 afterOnStart=true\n //% blockId=gameinterval block=\"on game update every %period=timePicker ms\"\n //% blockAllowMultiple=1\n export function onUpdateInterval(period: number, a: () => void): void {\n if (!a || period < 0) return;\n let timer = 0;\n game.eventContext().registerFrameHandler(scene.UPDATE_INTERVAL_PRIORITY, () => {\n const time = game.currentScene().millis();\n if (timer <= time) {\n timer = time + period;\n a();\n }\n });\n }\n\n /**\n * Returns the time since the game started in milliseconds\n */\n //% blockId=arcade_game_runtime block=\"time since start (ms)\"\n //% group=\"Gameplay\" weight=11\n //% help=game/runtime\n export function runtime(): number {\n return currentScene().millis();\n }\n}\n",
"mathUtil.ts": "namespace Math {\n /**\n * Returns a random boolean that is true the given percentage of the time.\n * @param percentage The percentage chance that the returned value will be true from 0 - 100\n */\n //% weight=2\n //% blockId=percentchance block=\"%percentage|\\\\% chance\"\n //% percentage.min=0 percentage.max=100;\n //% help=math/percent-chance\n export function percentChance(percentage: number): boolean {\n if (percentage >= 100) {\n return true;\n }\n else if (percentage <= 0) {\n return false;\n }\n return Math.randomRange(0, 99) < percentage;\n }\n\n /**\n * Returns a random element from the given list\n * @param list The list to choose an element from\n */\n //% weight=1\n export function pickRandom(list: T[]) {\n if (!list || list.length == 0) {\n return undefined;\n }\n return list[Math.randomRange(0, list.length - 1)];\n }\n\n /**\n * Fast, 16 bit, seedable (pseudo) random generator.\n */\n export class FastRandom {\n // Implementation of the Galois Linear Feedback Shift Register\n private lfsr: number;\n // A value between 0x0001 and 0xFFFF to generate random values from\n public seed: number;\n\n /**\n * Create a new Fast Random generator\n * @param seed [Optional] initial seed between 0x0001 and 0xFFFF.\n */\n constructor(seed?: number) {\n if (seed === undefined) seed = Math.randomRange(0x0001, 0xFFFF);\n this.seed = seed;\n this.lfsr = seed;\n }\n\n /**\n * @returns the next random number between 0x0001 and 0xFFFF inclusive\n */\n next(): number {\n return this.lfsr = (this.lfsr >> 1) ^ ((-(this.lfsr & 1)) & 0xb400);\n }\n\n /**\n * @param min the minimum value to generate\n * @param max the maximum value to generate\n * @returns a random value between min and max (inclusive). If min is greater than or equal to max, returns min.\n */\n randomRange(min: number, max: number): number {\n return min + (max > min ? this.next() % (max - min + 1) : 0);\n }\n\n /**\n * Returns a random element from the given list\n * @param list The list to choose an element from\n */\n pickRandom(list: T[]) {\n if (!list || list.length == 0) {\n return undefined;\n }\n return list[this.randomRange(0, list.length - 1)];\n }\n\n /**\n * @returns a random boolean value\n */\n randomBool(): boolean {\n return !(this.next() & 1);\n }\n\n /**\n * @param percent the percentage chance that the returned value will be true from 0 - 100\n * @returns a boolean with approximately the given percent chance to be true or false\n */\n percentChance(percent: number): boolean {\n return this.randomRange(0, 100) < percent;\n }\n\n /**\n * Reset the state to the current seed\n */\n reset() {\n this.lfsr = this.seed;\n }\n }\n}\n",
"pxt.json": "{\n \"name\": \"game---light\",\n \"description\": \"Empty game library - beta\",\n \"dependencies\": {\n \"settings\": \"*\",\n \"screen\": \"*\",\n \"mixer\": \"*\",\n \"power\": \"*\"\n },\n \"files\": [\n \"compat.ts\",\n \"console.ts\",\n \"constants.ts\",\n \"controlleroverrides.ts\",\n \"controllerbutton.ts\",\n \"controllerbuttons.cpp\",\n \"mathUtil.ts\",\n \"gameutil.ts\",\n \"targetoverrides.cpp\",\n \"targetoverrides.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"targetoverrides.cpp": "// Overriden in target\n",
"targetoverrides.ts": "// Overriden in target\n"
},
"mixer": {
"SoundOutput.h": "#include \"dmac.h\"\n#include \"SAMD21DAC.h\"\n#include \"Mixer.h\"\n\n// DAC always on PA02 on SAMD21\n#define DAC_PIN PA02\n\nclass SoundOutput {\n public:\n SAMD21DAC dac;\n\n SoundOutput(DataSource &data) : dac(*lookupPin(DAC_PIN), pxt::getWDMAC()->dmac, data) {}\n\n void setOutput(int output) { (void)output; }\n};\n",
"headphone.svg": "",
"legacy.ts": "//% deprecated=true hidden=true\nenum Sounds {\n //% block=\"power up\"\n PowerUp,\n //% block=\"power down\"\n PowerDown,\n //% block=\"jump up\"\n JumpUp,\n //% block=\"jump down\"\n JumpDown,\n //% block=\"ba ding\"\n BaDing,\n //% block=\"wawawawaa\"\n Wawawawaa,\n //% block=\"magic wand\"\n MagicWand,\n //% block=\"siren\"\n Siren\n}\n\nnamespace music {\n /**\n * Get the melody string for a built-in melody.\n * @param name the note name, eg: Note.C\n */\n //% help=music/sounds\n //% blockId=music_sounds block=\"%name\"\n //% blockHidden=true\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=285\n //% name.fieldOptions.columns=3\n export function sounds(name: Sounds): string {\n switch (name) {\n case Sounds.BaDing:\n return 'b5:1 e6:3';\n case Sounds.Wawawawaa:\n return 'e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8';\n case Sounds.JumpUp:\n return 'c5:1 d e f g';\n case Sounds.JumpDown:\n return 'g5:1 f e d c';\n case Sounds.PowerUp:\n return 'g4:1 c5 e g:2 e:1 g:3';\n case Sounds.PowerDown:\n return 'g5:1 d# c g4:2 b:1 c5:3';\n case Sounds.MagicWand:\n return 'F#6:1-300 G# A# B C7# D# F F# G# A# B:6'; //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n case Sounds.Siren:\n return 'a4 d5 a4 d5 a4 d5';\n default:\n return '';\n }\n }\n\n let currMelody: Melody\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound\n //% blockId=music_play_sound block=\"play sound %sound=music_sounds\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% deprecated=true hidden=true\n export function playSound(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.play();\n pause(1);\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound-until-done\n //% blockId=music_play_sound_until_done block=\"play sound %sound=music_sounds|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% deprecated=true hidden=true\n export function playSoundUntilDone(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.playUntilDone();\n }\n}",
"melody.cpp": "#include \"pxt.h\"\n#include \"SoundOutput.h\"\n#include \"melody.h\"\n\n//#define LOG DMESG\n#define LOG NOLOG\n\nnamespace music {\n\nSINGLETON(WSynthesizer);\n\n// Tone generator arguments:\n//\n// sound: a pointer to the currently-playing sound, usable for looking up the\n// waveform or generator-specific state.\n//\n// position: offset within the currently-playing wave, range 0..1023.\n//\n// cycle: a 6-bit cyclical sequence number of the wave, incremented each time\n// the position loops from 1023 back to 0.\ntypedef int (*gentone_t)(PlayingSound *sound, uint32_t position, uint8_t cycle);\n\nstatic int noiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)position;\n (void)cycle;\n // see https://en.wikipedia.org/wiki/Xorshift\n static uint32_t x = 0xf01ba80;\n x ^= x << 13;\n x ^= x >> 17;\n x ^= x << 5;\n return (x & 0xffff) - 0x7fff;\n}\n\nstatic int sineTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n int32_t p = position;\n if (p >= 512) {\n p -= 512;\n }\n if (p > 256) {\n p = 512 - p;\n }\n\n // Approximate sin(x * pi / 2) with the odd polynomial y = cx^5 + bx^3 + ax\n // using the constraint y(1) = 1 => a = 1 - b - c\n // => y = c x^5 + b x^3 + (1 - b - c) * x\n //\n // Do a least-squares fit of this to sin(x * pi / 2) in the range 0..1\n // inclusive, using 21 evenly spaced points. Resulting approximation:\n //\n // sin(x*pi/2) ~= 0.0721435357258*x**5 - 0.642443736562*x**3 + 1.57030020084*x\n\n // Scale the constants by 32767 to match the desired output range.\n constexpr int32_t c = 0.0721435357258 * 32767;\n constexpr int32_t b = -0.642443736562 * 32767;\n constexpr int32_t a = 1.57030020084 * 32767;\n\n // Calculate using y = ((c * x^2 + b) * x^2 + a) * x\n //\n // The position p is x * 256, so after each multiply with p we need to\n // shift right by 8 bits to keep the decimal point in the same place. (The\n // approximation has a negative error near x=1 which helps avoid overflow.)\n int32_t p2 = p * p;\n int32_t u = (c * p2 >> 16) + b;\n int32_t v = (u * p2 >> 16) + a;\n int32_t w = v * p >> 8;\n\n // The result is within 7/32767 or 0.02%, signal-to-error ratio about 38 dB.\n return position >= 512 ? -w : w;\n}\n\nstatic int sawtoothTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n return (position << 6) - 0x7fff;\n}\n\nstatic int triangleTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n return position < 512 ? (position << 7) - 0x7fff : ((1023 - position) << 7) - 0x7fff;\n}\n\nstatic int squareWaveTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)cycle;\n uint8_t wave = sound->currInstr->soundWave;\n return (int)position < (102 * (wave - SW_SQUARE_10 + 1)) ? -0x7fff : 0x7fff;\n}\n\nstatic int tunedNoiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a random bit sequence. Since the generator\n // is called multiple times per wave, use PlayingSound state data to ensure we\n // only generate a random bit once per wave, and then reuse it for future\n // calls for that wave.\n //\n // Use the low 6 bits of generatorState to store the last-used cycle, and\n // random_bit to store the last on/off state. (random_bit is arbitrary as\n // long as it isn't one of the low 6 bits.)\n constexpr uint32_t random_bit = 0x8000;\n static uint32_t x = 0xf01ba80; // seed for the static RNG state\n uint8_t prev_cycle = sound->generatorState & 0x3f;\n uint32_t is_on;\n if (cycle == prev_cycle) {\n is_on = sound->generatorState & random_bit;\n } else {\n // see https://en.wikipedia.org/wiki/Xorshift\n x ^= x << 13;\n x ^= x >> 17;\n x ^= x << 5;\n is_on = (x & random_bit);\n sound->generatorState = (cycle & 0x3f) | is_on;\n }\n if (!is_on)\n return 0;\n return position < 512 ? -0x7fff : 0x7fff;\n}\n\n// Bit patterns for use by the cyclic noise tone.\n//\n// The bit pattern is arbitrary, but should have equal numbers of 0 and 1 bits,\n// and should avoid long identical-bit runs for the lower parts. The values below\n// were chosen based on a random permutation of the hex nibbles 0..f and then\n// hand-tweaked by swapping some nibbles. Generated by:\n//\n// shuf -i 0-15 | perl -ne 's/(\\d+)/printf(\"%x\",$1)/e'\nstatic const uint32_t cycle_bits[] = {0x2df0eb47, 0xc8165a93};\nstatic const uint8_t cycle_mask[] = {0xf, 0x1f, 0x3f};\n\nstatic int cycleNoiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a short-cycle pseudorandom bit sequence.\n // The bit sequence repeats every 16/32/64 waves.\n //\n // The \"cycle\" argument corresponds to the sequential number of the generated\n // wave. This is currently a 6-bit value. Since the pseudorandom bit sequences\n // evenly fit into this, there's no need to track generator state.\n uint8_t wave = sound->currInstr->soundWave;\n int cycle_index = wave - SW_SQUARE_CYCLE_16;\n // CLAMP(0, cycle_index, sizeof cycle_bits / sizeof cycle_bits[0])\n cycle &= cycle_mask[cycle_index];\n bool is_on = (cycle_bits[cycle >> 5] & (1U << (cycle & 0x1f)));\n if (!is_on)\n return 0;\n return position < 512 ? -0x7fff : 0x7fff;\n}\n\nstatic int silenceTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a short-cycle pseudorandom bit sequence.\n (void)sound;\n (void)position;\n (void)cycle;\n return 0;\n}\n\nstatic gentone_t getWaveFn(uint8_t wave) {\n switch (wave) {\n case SW_TRIANGLE:\n return triangleTone;\n case SW_SAWTOOTH:\n return sawtoothTone;\n case SW_TUNEDNOISE:\n return tunedNoiseTone;\n case SW_NOISE:\n return noiseTone;\n case SW_SINE:\n return sineTone;\n default:\n if (SW_SQUARE_10 <= wave && wave <= SW_SQUARE_50)\n return squareWaveTone;\n if (SW_SQUARE_CYCLE_16 <= wave && wave <= SW_SQUARE_CYCLE_64)\n return cycleNoiseTone;\n else\n return silenceTone;\n }\n}\n\n#define CLAMP(lo, v, hi) ((v) = ((v) < (lo) ? (lo) : (v) > (hi) ? (hi) : (v)))\n\nint WSynthesizer::updateQueues() {\n const int maxTime = 0xffffff;\n while (1) {\n WaitingSound *p;\n int minLeft = maxTime;\n for (p = waiting; p; p = p->next) {\n int timeLeft =\n p->state == SoundState::Waiting ? p->startSampleNo - currSample : maxTime;\n if (timeLeft <= 0) {\n break;\n }\n if (timeLeft < minLeft)\n minLeft = timeLeft;\n }\n if (p) {\n PlayingSound *snd;\n int minIdx = -1;\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n snd = &playingSounds[i];\n if (snd->sound == NULL)\n break;\n if (minIdx == -1 ||\n playingSounds[minIdx].startSampleNo < playingSounds[i].startSampleNo)\n minIdx = i;\n snd = NULL;\n }\n // if we didn't find a free slot, expel the oldest sound\n if (!snd)\n snd = &playingSounds[minIdx];\n if (snd->sound)\n snd->sound->state = SoundState::Done;\n snd->sound = p;\n p->state = SoundState::Playing;\n snd->startSampleNo = currSample;\n snd->currInstr = (SoundInstruction *)p->instructions->data;\n snd->instrEnd = snd->currInstr + p->instructions->length / sizeof(SoundInstruction);\n snd->prevVolume = -1;\n } else {\n // no more sounds to move\n return minLeft;\n }\n }\n}\n\nint WSynthesizer::fillSamples(int16_t *dst, int numsamples) {\n if (numsamples <= 0)\n return 1;\n\n int timeLeft = updateQueues();\n int res = waiting != NULL;\n\n // if there's a pending sound to be started somewhere during numsamples,\n // split the call into two\n if (timeLeft < numsamples) {\n fillSamples(dst, timeLeft);\n LOG(\"M split %d\", timeLeft);\n fillSamples(dst + timeLeft, numsamples - timeLeft);\n return 1;\n }\n\n memset(dst, 0, numsamples * 2);\n\n uint32_t samplesPerMS = (sampleRate << 8) / 1000;\n float toneStepMult = (1024.0 * (1 << 16)) / sampleRate;\n const int MAXVAL = (1 << (OUTPUT_BITS - 1)) - 1;\n\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n PlayingSound *snd = &playingSounds[i];\n if (snd->sound == NULL)\n continue;\n\n res = 1;\n\n SoundInstruction *instr = NULL;\n gentone_t fn = NULL;\n snd->currInstr--;\n uint32_t toneStep = 0;\n int32_t toneDelta = 0;\n int32_t volumeStep = 0;\n uint32_t tonePosition = snd->tonePosition;\n uint32_t samplesLeft = 0;\n uint8_t wave = 0;\n int32_t volume = 0;\n\n for (int j = 0; j < numsamples; ++j) {\n if (samplesLeft == 0) {\n snd->currInstr++;\n if (snd->currInstr >= snd->instrEnd) {\n break;\n }\n SoundInstruction copy = *snd->currInstr;\n instr = ©\n CLAMP(20, instr->frequency, 20000);\n CLAMP(20, instr->endFrequency, 20000);\n CLAMP(0, instr->startVolume, 1023);\n CLAMP(0, instr->endVolume, 1023);\n CLAMP(1, instr->duration, 60000);\n\n wave = instr->soundWave;\n fn = getWaveFn(wave);\n\n samplesLeft = (uint32_t)(instr->duration * samplesPerMS >> 8);\n // make sure the division is signed\n volumeStep =\n (int)((instr->endVolume - instr->startVolume) << 16) / (int)samplesLeft;\n\n if (j == 0 && snd->prevVolume != -1) {\n // restore previous state\n samplesLeft = snd->samplesLeftInCurr;\n volume = snd->prevVolume;\n toneStep = snd->prevToneStep;\n toneDelta = snd->prevToneDelta;\n } else {\n LOG(\"#sampl %d %p\", samplesLeft, snd->currInstr);\n volume = instr->startVolume << 16;\n LOG(\"%d-%dHz %d-%d vol\", instr->frequency, instr->endFrequency,\n instr->startVolume, instr->endVolume);\n toneStep = (uint32_t)(toneStepMult * instr->frequency);\n if (instr->frequency != instr->endFrequency) {\n uint32_t endToneStep = (uint32_t)(toneStepMult * instr->endFrequency);\n toneDelta = (int32_t)(endToneStep - toneStep) / (int32_t)samplesLeft;\n } else {\n toneDelta = 0;\n }\n }\n }\n\n int v = fn(snd, (tonePosition >> 16) & 1023, tonePosition >> 26);\n v = (v * (volume >> 16)) >> (10 + (16 - OUTPUT_BITS));\n\n // if (v > MAXVAL)\n // target_panic(123);\n\n dst[j] += v;\n\n tonePosition += toneStep;\n toneStep += toneDelta;\n volume += volumeStep;\n samplesLeft--;\n }\n\n if (snd->currInstr >= snd->instrEnd) {\n snd->sound->state = SoundState::Done;\n snd->sound = NULL;\n } else {\n snd->tonePosition = tonePosition;\n if (samplesLeft == 0)\n samplesLeft++; // avoid infinite loop in next iteration\n snd->samplesLeftInCurr = samplesLeft;\n snd->prevVolume = volume;\n snd->prevToneDelta = toneDelta;\n snd->prevToneStep = toneStep;\n }\n }\n\n currSample += numsamples;\n\n for (int j = 0; j < numsamples; ++j) {\n if (dst[j] > MAXVAL)\n dst[j] = MAXVAL;\n else if (dst[j] < -MAXVAL)\n dst[j] = -MAXVAL;\n }\n\n return res;\n}\n\n//%\nvoid enableAmp(int enabled) {\n // this is also compiled on linux\n#ifdef LOOKUP_PIN\n auto pin = LOOKUP_PIN(SPEAKER_AMP);\n if (pin) {\n if (PIN(SPEAKER_AMP) & CFG_PIN_CONFIG_ACTIVE_LO)\n enabled = !enabled;\n pin->setDigitalValue(enabled);\n }\n#endif\n}\n\n//%\nvoid forceOutput(int outp) {\n auto snd = getWSynthesizer();\n snd->out.setOutput(outp);\n}\n\n//%\nvoid queuePlayInstructions(int when, Buffer buf) {\n auto snd = getWSynthesizer();\n\n registerGCObj(buf);\n\n auto p = new WaitingSound;\n p->state = SoundState::Waiting;\n p->instructions = buf;\n p->startSampleNo = snd->currSample + when * snd->sampleRate / 1000;\n\n LOG(\"Queue %dms now=%d off=%d %p sampl:%dHz\", when, snd->currSample,\n p->startSampleNo - snd->currSample, buf->data, snd->sampleRate);\n\n target_disable_irq();\n // add new sound to queue\n p->next = snd->waiting;\n snd->waiting = p;\n // remove sounds that have already been fully played\n while (p) {\n while (p->next && p->next->state == SoundState::Done) {\n auto todel = p->next;\n p->next = todel->next;\n unregisterGCObj(todel->instructions);\n delete todel;\n }\n p = p->next;\n }\n target_enable_irq();\n\n snd->poke();\n}\n\n//%\nvoid stopPlaying() {\n LOG(\"stop playing!\");\n\n auto snd = getWSynthesizer();\n\n target_disable_irq();\n auto p = snd->waiting;\n snd->waiting = NULL;\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n snd->playingSounds[i].sound = NULL;\n }\n while (p) {\n auto n = p->next;\n unregisterGCObj(p->instructions);\n delete p;\n p = n;\n }\n target_enable_irq();\n}\n\nWSynthesizer::WSynthesizer() : upstream(NULL), out(*this) {\n currSample = 0;\n active = false;\n sampleRate = out.dac.getSampleRate();\n memset(&playingSounds, 0, sizeof(playingSounds));\n waiting = NULL;\n PXT_REGISTER_RESET(stopPlaying);\n}\n\n} // namespace music\n\nnamespace pxt {\nint redirectSamples(int16_t *dst, int numsamples, int samplerate) {\n auto snd = music::getWSynthesizer();\n snd->upstream = NULL; // disconnect from regular playback mechanism\n snd->sampleRate = samplerate;\n return snd->fillSamples(dst, numsamples);\n}\n\n} // namespace pxt\n\nnamespace jacdac {\n__attribute__((weak)) void setJackRouterOutput(int output) {}\n} // namespace jacdac\n",
"melody.h": "#pragma once\n\n#ifndef OUTPUT_BITS\n#define OUTPUT_BITS 10\n#endif\n\n#define SW_TRIANGLE 1\n#define SW_SAWTOOTH 2\n#define SW_SINE 3\n#define SW_TUNEDNOISE 4\n#define SW_NOISE 5\n#define SW_SQUARE_10 11\n#define SW_SQUARE_50 15\n#define SW_SQUARE_CYCLE_16 16\n#define SW_SQUARE_CYCLE_32 17\n#define SW_SQUARE_CYCLE_64 18\n\nstruct SoundInstruction {\n uint8_t soundWave;\n uint8_t flags;\n uint16_t frequency; // Hz\n uint16_t duration; // ms\n int16_t startVolume; // 0-1023\n int16_t endVolume; // 0-1023\n uint16_t endFrequency; // Hz\n};\n\n#ifdef DATASTREAM_MAXIMUM_BUFFERS\n#define CODAL 1\n#endif\n\nnamespace music {\n\n#define MAX_SOUNDS 5\n\nSTATIC_ASSERT((1 << (16 - OUTPUT_BITS)) > MAX_SOUNDS);\n\nenum class SoundState : uint8_t {\n Waiting, //\n Playing, //\n Done //\n};\n\nstruct WaitingSound {\n uint32_t startSampleNo;\n SoundState state;\n WaitingSound *next;\n Buffer instructions;\n};\n\nstruct PlayingSound {\n uint32_t startSampleNo;\n uint32_t samplesLeftInCurr;\n uint32_t tonePosition;\n int32_t prevVolume;\n uint32_t prevToneStep;\n int32_t prevToneDelta;\n uint32_t generatorState;\n WaitingSound *sound;\n SoundInstruction *currInstr, *instrEnd;\n};\n\nclass WSynthesizer\n#ifdef CODAL\n : public DataSource\n#endif\n{\n public:\n#ifdef CODAL\n DataSink *upstream;\n#else\n void *upstream;\n#endif\n uint32_t currSample; // after 25h of playing we might get a glitch\n int32_t sampleRate; // eg 44100\n PlayingSound playingSounds[MAX_SOUNDS];\n WaitingSound *waiting;\n bool active;\n\n SoundOutput out;\n\n int fillSamples(int16_t *dst, int numsamples);\n int updateQueues();\n\n WSynthesizer();\n virtual ~WSynthesizer() {}\n\n void pokeUpstream() {\n#ifdef CODAL\n if (upstream) {\n upstream->pullRequest();\n }\n#endif\n }\n\n void poke() {\n if (!active) {\n active = true;\n pokeUpstream();\n }\n }\n\n#ifdef CODAL\n virtual ManagedBuffer pull() {\n if (!upstream)\n return ManagedBuffer();\n ManagedBuffer data(512);\n auto dp = (int16_t *)data.getBytes();\n auto sz = 512 / 2;\n int r = fillSamples(dp, sz);\n#if defined(NRF52_SERIES)\n int mul = out.dac.getSampleRange();\n#endif\n while (sz--) {\n#if defined(NRF52_SERIES)\n *dp = ((-*dp + (1 << (OUTPUT_BITS - 1))) * mul) >> OUTPUT_BITS;\n#else\n *dp += 1 << (OUTPUT_BITS - 1);\n#endif\n dp++;\n }\n if (!r) {\n active = false;\n // return empty - nothing left to play\n return ManagedBuffer();\n }\n pokeUpstream();\n return data;\n }\n virtual void connect(DataSink &sink) { upstream = &sink; }\n#endif\n};\n\n} // namespace music\n",
"melody.ts": "enum MusicOutput {\n AutoDetect = 0,\n Buzzer = 1,\n HeadPhones = 2,\n}\n\nnamespace music {\n //% whenUsed\n const freqs = hex`\n 1f00210023002500270029002c002e003100340037003a003e004100450049004e00520057005c00620068006e00\n 75007b0083008b0093009c00a500af00b900c400d000dc00e900f70006011501260137014a015d01720188019f01\n b801d201ee010b022a024b026e029302ba02e40210033f037003a403dc03170455049704dd0427057505c8052006\n 7d06e0064907b8072d08a9082d09b9094d0aea0a900b400cfa0cc00d910e6f0f5a1053115b1272139a14d4152017\n 8018f519801b231dde1e`\n\n //% shim=music::queuePlayInstructions\n function queuePlayInstructions(timeDelta: number, buf: Buffer) { }\n\n //% shim=music::stopPlaying\n function stopPlaying() { }\n\n //% shim=music::forceOutput\n export function forceOutput(buf: MusicOutput) { }\n\n let globalVolume: number = null\n\n const BUFFER_SIZE: number = 12;\n\n //% shim=music::enableAmp\n function enableAmp(en: number) {\n return // for sim\n }\n\n function initVolume() {\n if (globalVolume === null) {\n globalVolume = 0\n setVolume(control.getConfigValue(DAL.CFG_SPEAKER_VOLUME, 128))\n }\n }\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 //% parts=\"speaker\"\n //% volume.min=0 volume.max=255\n //% volume.defl=20\n //% help=music/set-volume\n //% weight=70\n //% group=\"Volume\"\n export function setVolume(volume: number): void {\n globalVolume = Math.clamp(0, 255, volume | 0)\n enableAmp(globalVolume > 0 ? 1 : 0)\n }\n\n /**\n * Gets the current volume\n */\n //% parts=\"speaker\"\n //% weight=70\n export function volume(): number {\n initVolume()\n return globalVolume;\n }\n\n function playNoteCore(when: number, frequency: number, ms: number) {\n let buf = control.createBuffer(BUFFER_SIZE)\n addNote(buf, 0, ms, 255, 255, 3, frequency, volume(), frequency)\n queuePlayInstructions(when, buf)\n }\n\n /**\n * Play a tone through the speaker for some amount of time.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n * @param ms tone duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/play-tone\n //% blockId=mixer_play_note block=\"play tone|at %note=device_note|for %duration=device_beat\"\n //% parts=\"headphone\" async\n //% blockNamespace=music\n //% weight=76 blockGap=8\n //% group=\"Tone\"\n export function playTone(frequency: number, ms: number): void {\n if (ms == 0)\n ms = 86400000 // 1 day\n\n if (ms <= 2000) {\n playNoteCore(0, frequency, ms)\n pause(ms)\n } else {\n const id = ++playToneID\n control.runInParallel(() => {\n let pos = control.millis()\n while (id == playToneID && ms > 0) {\n let now = control.millis()\n let d = pos - now\n let t = Math.min(ms, 500)\n ms -= t\n pos += t\n playNoteCore(d - 1, frequency, t)\n if (ms == 0)\n pause(d + t)\n else\n pause(d + t - 100)\n }\n })\n }\n }\n\n let playToneID = 0\n\n /**\n * Play a melody from the melody editor.\n * @param melody - string of up to eight notes [C D E F G A B C5] or rests [-] separated by spaces, \n * which will be played one at a time, ex: \"E D G F B A C5 B \"\n * @param tempo - number in beats per minute (bpm), dictating how long each note will play for\n */\n //% block=\"play melody $melody at tempo $tempo|(bpm)\" blockId=playMelody\n //% blockNamespace=music\n //% weight=85 blockGap=8 help=music/play-melody\n //% group=\"Melody\"\n //% melody.shadow=\"melody_editor\"\n //% tempo.min=40 tempo.max=500\n //% tempo.defl=120\n export function playMelody(melody: string, tempo: number) {\n let notes: string[] = melody.split(\" \").filter(n => !!n);\n let formattedMelody = \"\";\n let newOctave = false;\n\n // build melody string, replace '-' with 'R' and add tempo\n // creates format like \"C5-174 B4 A G F E D C \"\n for (let i = 0; i < notes.length; i++) {\n if (notes[i] === \"-\") {\n notes[i] = \"R\";\n } else if (notes[i] === \"C5\") {\n newOctave = true;\n } else if (newOctave) { // change the octave if necesary\n notes[i] += \"4\";\n newOctave = false;\n }\n // add tempo after first note\n if (i == 0) {\n formattedMelody += notes[i] + \"-\" + tempo + \" \";\n } else {\n formattedMelody += notes[i] + \" \";\n }\n }\n\n const song = new Melody(formattedMelody);\n song.playUntilDone();\n }\n\n\n /**\n * Create a melody with the melody editor.\n * @param melody\n */\n //% block=\"$melody\" blockId=melody_editor\n //% blockNamespace=music\n //% blockHidden = true\n //% weight=85 blockGap=8\n //% help=music/melody-editor\n //% group=\"Melody\" duplicateShadowOnDrag\n //% melody.fieldEditor=\"melody\"\n //% melody.fieldOptions.decompileLiterals=true\n //% melody.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% melody.fieldOptions.onParentBlock=\"true\"\n //% shim=TD_ID\n export function melodyEditor(melody: string): string {\n return melody;\n }\n\n /**\n * Stop all sounds from playing.\n */\n //% help=music/stop-all-sounds\n //% blockId=music_stop_all_sounds block=\"stop all sounds\"\n //% weight=10\n //% group=\"Sounds\"\n export function stopAllSounds() {\n Melody.stopAll();\n stopPlaying();\n }\n\n //% fixedInstances\n export class Melody {\n _text: string;\n private _player: MelodyPlayer;\n\n private static playingMelodies: Melody[];\n\n static stopAll() {\n if (Melody.playingMelodies) {\n const ms = Melody.playingMelodies.slice(0, Melody.playingMelodies.length);\n ms.forEach(p => p.stop());\n }\n }\n\n constructor(text: string) {\n this._text = text\n }\n\n get text() {\n return this._text;\n }\n\n /**\n * Stop playing a sound\n */\n //% blockId=mixer_stop block=\"stop sound %sound\"\n //% help=music/melody/stop\n //% parts=\"headphone\"\n //% weight=92 blockGap=8\n //% group=\"Sounds\"\n stop() {\n if (this._player) {\n this._player.stop()\n this._player = null\n }\n this.unregisterMelody();\n }\n\n private registerMelody() {\n // keep track of the active players\n if (!Melody.playingMelodies) Melody.playingMelodies = [];\n // stop and pop melodies if too many playing\n if (Melody.playingMelodies.length > 4) {\n // stop last player (also pops)\n Melody.playingMelodies[Melody.playingMelodies.length - 1].stop();\n }\n // put back the melody on top of the melody stack\n Melody.playingMelodies.removeElement(this);\n Melody.playingMelodies.push(this);\n }\n private unregisterMelody() {\n // remove from list\n if (Melody.playingMelodies) {\n Melody.playingMelodies.removeElement(this); // remove self\n }\n }\n\n private playCore(volume: number, loop: boolean) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this.registerMelody();\n control.runInParallel(() => {\n while (this._player == p) {\n p.play(volume)\n if (!loop) {\n // Unregister the melody when done playing, but\n // only if it hasn't been restarted. (Looping\n // melodies never stop on their own, they only\n // get unregistered via stop().)\n if (this._player == p) {\n this.unregisterMelody();\n }\n break\n }\n }\n })\n }\n\n /**\n * Start playing a sound in a loop and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/loop\n //% blockId=mixer_loop_sound block=\"loop sound %sound\"\n //% parts=\"headphone\"\n //% weight=93 blockGap=8\n //% group=\"Sounds\"\n loop(volume = 255) {\n this.playCore(volume, true)\n }\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/play\n //% blockId=mixer_play_sound block=\"play sound %sound\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% group=\"Sounds\"\n play(volume = 255) {\n this.playCore(volume, false)\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * @param sound the melody to play\n */\n //% help=music/melody/play-until-done\n //% blockId=mixer_play_sound_until_done block=\"play sound %sound|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% group=\"Sounds\"\n playUntilDone(volume = 255) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this._player.onPlayFinished = () => {\n if (p == this._player)\n this.unregisterMelody();\n }\n this.registerMelody();\n this._player.play(volume)\n }\n\n toString() {\n return this._text;\n }\n }\n\n function addNote(sndInstr: Buffer, sndInstrPtr: number, ms: number, beg: number, end: number, soundWave: number, hz: number, volume: number, endHz: number) {\n if (ms > 0) {\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, soundWave)\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr + 1, 0)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 2, hz)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 4, ms)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 6, (beg * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 8, (end * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 10, endHz);\n sndInstrPtr += BUFFER_SIZE;\n }\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, 0) // terminate\n return sndInstrPtr\n }\n\n\n export class MelodyPlayer {\n melody: Melody;\n\n onPlayFinished: () => void;\n\n constructor(m: Melody) {\n this.melody = m\n }\n\n stop() {\n this.melody = null\n }\n\n protected queuePlayInstructions(timeDelta: number, buf: Buffer) {\n queuePlayInstructions(timeDelta, buf)\n }\n\n play(volume: number) {\n if (!this.melody)\n return\n volume = Math.clamp(0, 255, (volume * music.volume()) >> 8)\n\n let notes = this.melody._text\n let pos = 0;\n let duration = 4; //Default duration (Crotchet)\n let octave = 4; //Middle octave\n let tempo = 120; // default tempo\n\n let hz = 0\n let endHz = -1\n let ms = 0\n let timePos = 0\n let startTime = control.millis()\n let now = 0\n\n let envA = 0\n let envD = 0\n let envS = 255\n let envR = 0\n let soundWave = 1 // triangle\n let sndInstr = control.createBuffer(5 * BUFFER_SIZE)\n let sndInstrPtr = 0\n\n const addForm = (formDuration: number, beg: number, end: number, msOff: number) => {\n let freqStart = hz;\n let freqEnd = endHz;\n\n const envelopeWidth = ms > 0 ? ms : duration * Math.idiv(15000, tempo) + envR;\n if (endHz != hz && envelopeWidth != 0) {\n const slope = (freqEnd - freqStart) / envelopeWidth;\n freqStart = hz + slope * msOff;\n freqEnd = hz + slope * (msOff + formDuration);\n }\n sndInstrPtr = addNote(sndInstr, sndInstrPtr, formDuration, beg, end, soundWave, freqStart, volume, freqEnd);\n }\n\n const scanNextWord = () => {\n if (!this.melody)\n return \"\"\n\n // eat space\n while (pos < notes.length) {\n const c = notes[pos];\n if (c != ' ' && c != '\\r' && c != '\\n' && c != '\\t')\n break;\n pos++;\n }\n\n // read note\n let note = \"\";\n while (pos < notes.length) {\n const c = notes[pos];\n if (c == ' ' || c == '\\r' || c == '\\n' || c == '\\t')\n break;\n note += c;\n pos++;\n }\n return note;\n }\n\n enum Token {\n Note,\n Octave,\n Beat,\n Tempo,\n Hz,\n EndHz,\n Ms,\n WaveForm,\n EnvelopeA,\n EnvelopeD,\n EnvelopeS,\n EnvelopeR\n }\n\n let token: string = \"\";\n let tokenKind = Token.Note;\n\n // [ABCDEFG] (\\d+) (:\\d+) (-\\d+)\n // note octave length tempo\n // R (:\\d+) - rest\n // !\\d+,\\d+ - sound at frequency with given length (Hz,ms); !\\d+ and !\\d+,:\\d+ also possible\n // @\\d+,\\d+,\\d+,\\d+ - ADSR envelope - ms,ms,volume,ms; volume is 0-255\n // ~\\d+ - wave form:\n // 1 - triangle\n // 2 - sawtooth\n // 3 - sine\n // 4 - pseudorandom square wave noise (tunable)\n // 5 - white noise (ignores frequency)\n // 11 - square 10%\n // 12 - square 20%\n // ...\n // 15 - square 50%\n // 16 - filtered square wave, cycle length 16\n // 17 - filtered square wave, cycle length 32\n // 18 - filtered square wave, cycle length 64\n\n const consumeToken = () => {\n if (token && tokenKind != Token.Note) {\n const d = parseInt(token);\n switch (tokenKind) {\n case Token.Octave: octave = d; break;\n case Token.Beat:\n duration = Math.max(1, Math.min(16, d));\n ms = -1;\n break;\n case Token.Tempo: tempo = Math.max(1, d); break;\n case Token.Hz: hz = d; tokenKind = Token.Ms; break;\n case Token.Ms: ms = d; break;\n case Token.WaveForm: soundWave = Math.clamp(1, 18, d); break;\n case Token.EnvelopeA: envA = d; tokenKind = Token.EnvelopeD; break;\n case Token.EnvelopeD: envD = d; tokenKind = Token.EnvelopeS; break;\n case Token.EnvelopeS: envS = Math.clamp(0, 255, d); tokenKind = Token.EnvelopeR; break;\n case Token.EnvelopeR: envR = d; break;\n case Token.EndHz: endHz = d; break;\n }\n token = \"\";\n }\n }\n\n while (true) {\n let currNote = scanNextWord();\n let prevNote: boolean = false;\n if (!currNote) {\n let timeLeft = timePos - now\n if (timeLeft > 0)\n pause(timeLeft)\n if (this.onPlayFinished)\n this.onPlayFinished();\n return;\n }\n\n hz = -1;\n\n let note: number = 0;\n token = \"\";\n tokenKind = Token.Note;\n\n for (let i = 0; i < currNote.length; i++) {\n let noteChar = currNote.charAt(i);\n switch (noteChar) {\n case 'c': case 'C': note = 1; prevNote = true; break;\n case 'd': case 'D': note = 3; prevNote = true; break;\n case 'e': case 'E': note = 5; prevNote = true; break;\n case 'f': case 'F': note = 6; prevNote = true; break;\n case 'g': case 'G': note = 8; prevNote = true; break;\n case 'a': case 'A': note = 10; prevNote = true; break;\n case 'B': note = 12; prevNote = true; break;\n case 'r': case 'R': hz = 0; prevNote = false; break;\n case '#': note++; prevNote = false; break;\n case 'b': if (prevNote) note--; else { note = 12; prevNote = true; } break;\n case ',':\n consumeToken();\n prevNote = false;\n break;\n case '!':\n tokenKind = Token.Hz;\n prevNote = false;\n break;\n case '@':\n consumeToken();\n tokenKind = Token.EnvelopeA;\n prevNote = false;\n break;\n case '~':\n consumeToken();\n tokenKind = Token.WaveForm;\n prevNote = false;\n break;\n case ':':\n consumeToken();\n tokenKind = Token.Beat;\n prevNote = false;\n break;\n case '-':\n consumeToken();\n tokenKind = Token.Tempo;\n prevNote = false;\n break;\n case '^':\n consumeToken();\n tokenKind = Token.EndHz;\n break;\n default:\n if (tokenKind == Token.Note)\n tokenKind = Token.Octave;\n token += noteChar;\n prevNote = false;\n break;\n }\n }\n consumeToken();\n\n if (note && hz < 0) {\n const keyNumber = note + (12 * (octave - 1));\n hz = freqs.getNumber(NumberFormat.UInt16LE, keyNumber * 2) || 0;\n }\n\n let currMs = ms\n\n if (currMs <= 0) {\n const beat = Math.idiv(15000, tempo);\n currMs = duration * beat\n }\n\n if (hz < 0) {\n // no frequency specified, so no duration\n } else if (hz == 0) {\n timePos += currMs\n } else {\n if (endHz < 0) {\n endHz = hz;\n }\n\n sndInstrPtr = 0\n addForm(envA, 0, 255, 0)\n addForm(envD, 255, envS, envA)\n addForm(currMs - (envA + envD), envS, envS, envD + envA)\n addForm(envR, envS, 0, currMs)\n\n this.queuePlayInstructions(timePos - now, sndInstr.slice(0, sndInstrPtr))\n endHz = -1;\n timePos += currMs // don't add envR - it's supposed overlap next sound\n }\n\n let timeLeft = timePos - now\n if (timeLeft > 200) {\n pause(timeLeft - 100)\n now = control.millis() - startTime\n }\n }\n }\n }\n\n //% fixedInstance whenUsed block=\"ba ding\"\n export const baDing = new Melody('b5:1 e6:3')\n\n //% fixedInstance whenUsed block=\"wawawawaa\"\n export const wawawawaa = new Melody('~15 e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8')\n\n //% fixedInstance whenUsed block=\"jump up\"\n export const jumpUp = new Melody('c5:1 d e f g')\n\n //% fixedInstance whenUsed block=\"jump down\"\n export const jumpDown = new Melody('g5:1 f e d c')\n\n //% fixedInstance whenUsed block=\"power up\"\n export const powerUp = new Melody('g4:1 c5 e g:2 e:1 g:3')\n\n //% fixedInstance whenUsed block=\"power down\"\n export const powerDown = new Melody('g5:1 d# c g4:2 b:1 c5:3')\n\n //% fixedInstance whenUsed block=\"magic wand\"\n export const magicWand = new Melody('F#6:1-300 G# A# B C7# D# F F# G# A# B:6')\n //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n\n //% fixedInstance whenUsed block=\"siren\"\n export const siren = new Melody('a4 d5 a4 d5 a4 d5')\n\n //% fixedInstance whenUsed block=\"pew pew\"\n export const pewPew = new Melody('!1200,200^50')\n\n //% fixedInstance whenUsed block=\"knock\"\n export const knock = new Melody('~4 @0,0,255,150 !300,1 !211,1')\n\n //% fixedInstance whenUsed block=\"footstep\"\n export const footstep = new Melody('~4 @0,0,60,50 !200,1')\n\n //% fixedInstance whenUsed block=\"thump\"\n export const thump = new Melody('~4 @0,0,255,150 !100,1')\n\n //% fixedInstance whenUsed block=\"small crash\"\n export const smallCrash = new Melody('~4 @10,490,0,1 !800,1')\n\n //% fixedInstance whenUsed block=\"big crash\"\n export const bigCrash = new Melody('~4 @10,990,0,1 !400,1')\n\n //% fixedInstance whenUsed block=\"zapped\"\n export const zapped = new Melody('~16 @10,490,0,0 !1600,500^1')\n\n //% fixedInstance whenUsed block=\"buzzer\"\n export const buzzer = new Melody('~16 @10,0,255,250 !2000,300')\n\n //% fixedInstance whenUsed block=\"sonar\"\n export const sonar = new Melody('~16 @10,1500,0,0 !200,1 !200,1500^190')\n\n //% fixedInstance whenUsed block=\"spooky\"\n export const spooky = new Melody('~16 @700,1300,0,0 !100,1 ~18 !108,2000')\n\n //% fixedInstance whenUsed block=\"beam up\"\n export const beamUp = new Melody('~18 @10,1500,0,0 !200,1500^4000')\n}\n",
"music.ts": "enum Note {\n //% blockIdentity=music.noteFrequency enumval=262\n C = 262,\n //% block=C#\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F = 349,\n //% block=F#\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G = 392,\n //% block=G#\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B = 494,\n //% blockIdentity=music.noteFrequency enumval=131\n C3 = 131,\n //% block=C#3\n //% blockIdentity=music.noteFrequency enumval=139\n CSharp3 = 139,\n //% blockIdentity=music.noteFrequency enumval=147\n D3 = 147,\n //% blockIdentity=music.noteFrequency enumval=156\n Eb3 = 156,\n //% blockIdentity=music.noteFrequency enumval=165\n E3 = 165,\n //% blockIdentity=music.noteFrequency enumval=175\n F3 = 175,\n //% block=F#3\n //% blockIdentity=music.noteFrequency enumval=185\n FSharp3 = 185,\n //% blockIdentity=music.noteFrequency enumval=196\n G3 = 196,\n //% block=G#3\n //% blockIdentity=music.noteFrequency enumval=208\n GSharp3 = 208,\n //% blockIdentity=music.noteFrequency enumval=220\n A3 = 220,\n //% blockIdentity=music.noteFrequency enumval=233\n Bb3 = 233,\n //% blockIdentity=music.noteFrequency enumval=247\n B3 = 247,\n //% blockIdentity=music.noteFrequency enumval=262\n C4 = 262,\n //% block=C#4\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp4 = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D4 = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb4 = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E4 = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F4 = 349,\n //% block=F#4\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp4 = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G4 = 392,\n //% block=G#4\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp4 = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A4 = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb4 = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B4 = 494,\n //% blockIdentity=music.noteFrequency enumval=523\n C5 = 523,\n //% block=C#5\n //% blockIdentity=music.noteFrequency enumval=555\n CSharp5 = 555,\n //% blockIdentity=music.noteFrequency enumval=587\n D5 = 587,\n //% blockIdentity=music.noteFrequency enumval=622\n Eb5 = 622,\n //% blockIdentity=music.noteFrequency enumval=659\n E5 = 659,\n //% blockIdentity=music.noteFrequency enumval=698\n F5 = 698,\n //% block=F#5\n //% blockIdentity=music.noteFrequency enumval=740\n FSharp5 = 740,\n //% blockIdentity=music.noteFrequency enumval=784\n G5 = 784,\n //% block=G#5\n //% blockIdentity=music.noteFrequency enumval=831\n GSharp5 = 831,\n //% blockIdentity=music.noteFrequency enumval=880\n A5 = 880,\n //% blockIdentity=music.noteFrequency enumval=932\n Bb5 = 932,\n //% blockIdentity=music.noteFrequency enumval=988\n B5 = 988,\n}\n\nenum BeatFraction {\n //% block=1\n Whole = 1,\n //% block=\"1/2\"\n Half = 2,\n //% block=\"1/4\"\n Quarter = 4,\n //% block=\"1/8\"\n Eighth = 8,\n //% block=\"1/16\"\n Sixteenth = 16,\n //% block=\"2\"\n Double = 32,\n //% block=\"4\",\n Breve = 64,\n //% block=\"1/3\",\n Triplet = 128\n}\n\nnamespace music {\n\n let beatsPerMinute: number;\n\n /**\n * Play a tone.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n */\n //% help=music/ring-tone\n //% blockId=music_ring block=\"ring tone|at %note=device_note\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music inBasicCategory=true\n //% weight=75 blockGap=8\n //% group=\"Tone\"\n export function ringTone(frequency: number) {\n playTone(frequency, 0);\n }\n\n /**\n * Rest, or play silence, for some time (in milliseconds).\n * @param ms rest duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/rest\n //% blockId=music_rest block=\"rest|for %duration=device_beat\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music\n //% weight=74\n //% group=\"Tone\"\n export function rest(ms: number) {\n playTone(0, Math.max(ms, 20));\n }\n\n function init() {\n if (!beatsPerMinute) beatsPerMinute = 120;\n }\n\n /**\n * Return the duration of a beat in milliseconds (the beat fraction).\n * @param fraction the fraction of the current whole note, eg: BeatFraction.Half\n */\n //% help=music/beat\n //% blockId=device_beat block=\"%fraction|beat\"\n //% weight=9 blockGap=8\n //% group=\"Tempo\"\n export function beat(fraction?: BeatFraction): number {\n init();\n if (fraction == null) fraction = BeatFraction.Whole;\n let beat = 60000 / beatsPerMinute;\n switch (fraction) {\n case BeatFraction.Half: beat /= 2; break;\n case BeatFraction.Quarter: beat /= 4; break;\n case BeatFraction.Eighth: beat /= 8; break;\n case BeatFraction.Sixteenth: beat /= 16; break;\n case BeatFraction.Double: beat *= 2; break;\n case BeatFraction.Breve: beat *= 4; break;\n case BeatFraction.Triplet: beat /= 3; break;\n }\n return beat >> 0;\n }\n\n /**\n * Return the tempo in beats per minute (bpm).\n * Tempo is the speed (bpm = beats per minute) at which notes play. The larger the tempo value, the faster the notes will play.\n */\n //% help=music/tempo\n //% blockId=device_tempo block=\"tempo (bpm)\"\n //% weight=64\n //% group=\"Tempo\"\n export function tempo(): number {\n init();\n return beatsPerMinute;\n }\n\n /**\n * Change the tempo up or down by some amount of beats per minute (bpm).\n * @param bpm The change in beats per minute to the tempo, eg: 20\n */\n //% help=music/change-tempo-by weight=37\n //% blockId=device_change_tempo block=\"change tempo by %value|(bpm)\"\n //% weight=66 blockGap=8\n //% group=\"Tempo\"\n export function changeTempoBy(bpm: number): void {\n init();\n setTempo(beatsPerMinute + bpm);\n }\n\n /**\n * Set the tempo a number of beats per minute (bpm).\n * @param bpm The new tempo in beats per minute, eg: 120\n */\n //% help=music/set-tempo\n //% blockId=device_set_tempo block=\"set tempo to %value|(bpm)\"\n //% bpm.min=4 bpm.max=400\n //% weight=65 blockGap=8\n //% group=\"Tempo\"\n export function setTempo(bpm: number): void {\n init();\n if (bpm > 0) {\n beatsPerMinute = Math.max(1, bpm >> 0);\n }\n }\n}\n",
"ns.ts": "\n/**\n * Generation of music tones.\n */\n//% color=#E30FC0 weight=90 icon=\"\\uf025\"\n//% blockGap=8\n//% groups='[\"Sounds\", \"Melody\", \"Tone\", \"Volume\", \"Tempo\"]'\nnamespace music {\n}",
"piano.ts": "namespace music {\n /**\n * Get the frequency of a note.\n * @param name the note name, eg: Note.C\n */\n //% weight=1 help=music/note-frequency\n //% blockId=device_note block=\"%note\"\n //% shim=TD_ID\n //% color=\"#FFFFFF\" colorSecondary=\"#FFFFFF\" colorTertiary=\"#D83B01\"\n //% note.fieldEditor=\"note\" note.defl=\"262\"\n //% note.fieldOptions.decompileLiterals=true\n //% useEnumVal=1\n //% weight=10 blockGap=8\n //% group=\"Tone\"\n export function noteFrequency(name: Note): number {\n return name;\n }\n}",
"pxt.json": "{\n \"name\": \"mixer\",\n \"description\": \"The music library with a mixer\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"SoundOutput.h\",\n \"sound.cpp\",\n \"melody.h\",\n \"melody.cpp\",\n \"melody.ts\",\n \"piano.ts\",\n \"legacy.ts\",\n \"ns.ts\",\n \"targetoverrides.ts\",\n \"music.ts\",\n \"pxtparts.json\",\n \"headphone.svg\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"pxtparts.json": "{\n \"headphone\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"image\": \"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\": \"A0\",\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}",
"sound.cpp": "// to be overridden\n",
"targetoverrides.ts": "\n",
"test.ts": "for(let i = 1000; i > 0; i -= 50)\n music.playTone(440, i)\n\nfor(let i = 0; i < 1000; i += 20)\n music.playTone(440, i)\n"
},
"mixer---none": {
"SoundOutput.h": "\n",
"headphone.svg": "",
"legacy.ts": "//% deprecated=true hidden=true\nenum Sounds {\n //% block=\"power up\"\n PowerUp,\n //% block=\"power down\"\n PowerDown,\n //% block=\"jump up\"\n JumpUp,\n //% block=\"jump down\"\n JumpDown,\n //% block=\"ba ding\"\n BaDing,\n //% block=\"wawawawaa\"\n Wawawawaa,\n //% block=\"magic wand\"\n MagicWand,\n //% block=\"siren\"\n Siren\n}\n\nnamespace music {\n /**\n * Get the melody string for a built-in melody.\n * @param name the note name, eg: Note.C\n */\n //% help=music/sounds\n //% blockId=music_sounds block=\"%name\"\n //% blockHidden=true\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=285\n //% name.fieldOptions.columns=3\n export function sounds(name: Sounds): string {\n switch (name) {\n case Sounds.BaDing:\n return 'b5:1 e6:3';\n case Sounds.Wawawawaa:\n return 'e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8';\n case Sounds.JumpUp:\n return 'c5:1 d e f g';\n case Sounds.JumpDown:\n return 'g5:1 f e d c';\n case Sounds.PowerUp:\n return 'g4:1 c5 e g:2 e:1 g:3';\n case Sounds.PowerDown:\n return 'g5:1 d# c g4:2 b:1 c5:3';\n case Sounds.MagicWand:\n return 'F#6:1-300 G# A# B C7# D# F F# G# A# B:6'; //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n case Sounds.Siren:\n return 'a4 d5 a4 d5 a4 d5';\n default:\n return '';\n }\n }\n\n let currMelody: Melody\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound\n //% blockId=music_play_sound block=\"play sound %sound=music_sounds\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% deprecated=true hidden=true\n export function playSound(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.play();\n pause(1);\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound-until-done\n //% blockId=music_play_sound_until_done block=\"play sound %sound=music_sounds|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% deprecated=true hidden=true\n export function playSoundUntilDone(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.playUntilDone();\n }\n}",
"melody.cpp": "#include \"pxt.h\"\n#include \"melody.h\"\n\nnamespace music {\n//%\nvoid forceOutput(int outp) {}\n\n//%\nvoid queuePlayInstructions(int when, Buffer buf) {\n}\n\n//%\nvoid enableAmp(int enabled) {\n\n}\n\n} // namespace music\n",
"melody.h": "\n",
"melody.ts": "enum MusicOutput {\n AutoDetect = 0,\n Buzzer = 1,\n HeadPhones = 2,\n}\n\nnamespace music {\n //% whenUsed\n const freqs = hex`\n 1f00210023002500270029002c002e003100340037003a003e004100450049004e00520057005c00620068006e00\n 75007b0083008b0093009c00a500af00b900c400d000dc00e900f70006011501260137014a015d01720188019f01\n b801d201ee010b022a024b026e029302ba02e40210033f037003a403dc03170455049704dd0427057505c8052006\n 7d06e0064907b8072d08a9082d09b9094d0aea0a900b400cfa0cc00d910e6f0f5a1053115b1272139a14d4152017\n 8018f519801b231dde1e`\n\n //% shim=music::queuePlayInstructions\n function queuePlayInstructions(timeDelta: number, buf: Buffer) { }\n\n //% shim=music::stopPlaying\n function stopPlaying() { }\n\n //% shim=music::forceOutput\n export function forceOutput(buf: MusicOutput) { }\n\n let globalVolume: number = null\n\n const BUFFER_SIZE: number = 12;\n\n //% shim=music::enableAmp\n function enableAmp(en: number) {\n return // for sim\n }\n\n function initVolume() {\n if (globalVolume === null) {\n globalVolume = 0\n setVolume(control.getConfigValue(DAL.CFG_SPEAKER_VOLUME, 128))\n }\n }\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 //% parts=\"speaker\"\n //% volume.min=0 volume.max=255\n //% volume.defl=20\n //% help=music/set-volume\n //% weight=70\n //% group=\"Volume\"\n export function setVolume(volume: number): void {\n globalVolume = Math.clamp(0, 255, volume | 0)\n enableAmp(globalVolume > 0 ? 1 : 0)\n }\n\n /**\n * Gets the current volume\n */\n //% parts=\"speaker\"\n //% weight=70\n export function volume(): number {\n initVolume()\n return globalVolume;\n }\n\n function playNoteCore(when: number, frequency: number, ms: number) {\n let buf = control.createBuffer(BUFFER_SIZE)\n addNote(buf, 0, ms, 255, 255, 3, frequency, volume(), frequency)\n queuePlayInstructions(when, buf)\n }\n\n /**\n * Play a tone through the speaker for some amount of time.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n * @param ms tone duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/play-tone\n //% blockId=mixer_play_note block=\"play tone|at %note=device_note|for %duration=device_beat\"\n //% parts=\"headphone\" async\n //% blockNamespace=music\n //% weight=76 blockGap=8\n //% group=\"Tone\"\n export function playTone(frequency: number, ms: number): void {\n if (ms == 0)\n ms = 86400000 // 1 day\n\n if (ms <= 2000) {\n playNoteCore(0, frequency, ms)\n pause(ms)\n } else {\n const id = ++playToneID\n control.runInParallel(() => {\n let pos = control.millis()\n while (id == playToneID && ms > 0) {\n let now = control.millis()\n let d = pos - now\n let t = Math.min(ms, 500)\n ms -= t\n pos += t\n playNoteCore(d - 1, frequency, t)\n if (ms == 0)\n pause(d + t)\n else\n pause(d + t - 100)\n }\n })\n }\n }\n\n let playToneID = 0\n\n /**\n * Play a melody from the melody editor.\n * @param melody - string of up to eight notes [C D E F G A B C5] or rests [-] separated by spaces, \n * which will be played one at a time, ex: \"E D G F B A C5 B \"\n * @param tempo - number in beats per minute (bpm), dictating how long each note will play for\n */\n //% block=\"play melody $melody at tempo $tempo|(bpm)\" blockId=playMelody\n //% blockNamespace=music\n //% weight=85 blockGap=8 help=music/play-melody\n //% group=\"Melody\"\n //% melody.shadow=\"melody_editor\"\n //% tempo.min=40 tempo.max=500\n //% tempo.defl=120\n export function playMelody(melody: string, tempo: number) {\n let notes: string[] = melody.split(\" \").filter(n => !!n);\n let formattedMelody = \"\";\n let newOctave = false;\n\n // build melody string, replace '-' with 'R' and add tempo\n // creates format like \"C5-174 B4 A G F E D C \"\n for (let i = 0; i < notes.length; i++) {\n if (notes[i] === \"-\") {\n notes[i] = \"R\";\n } else if (notes[i] === \"C5\") {\n newOctave = true;\n } else if (newOctave) { // change the octave if necesary\n notes[i] += \"4\";\n newOctave = false;\n }\n // add tempo after first note\n if (i == 0) {\n formattedMelody += notes[i] + \"-\" + tempo + \" \";\n } else {\n formattedMelody += notes[i] + \" \";\n }\n }\n\n const song = new Melody(formattedMelody);\n song.playUntilDone();\n }\n\n\n /**\n * Create a melody with the melody editor.\n * @param melody\n */\n //% block=\"$melody\" blockId=melody_editor\n //% blockNamespace=music\n //% blockHidden = true\n //% weight=85 blockGap=8\n //% help=music/melody-editor\n //% group=\"Melody\" duplicateShadowOnDrag\n //% melody.fieldEditor=\"melody\"\n //% melody.fieldOptions.decompileLiterals=true\n //% melody.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% melody.fieldOptions.onParentBlock=\"true\"\n //% shim=TD_ID\n export function melodyEditor(melody: string): string {\n return melody;\n }\n\n /**\n * Stop all sounds from playing.\n */\n //% help=music/stop-all-sounds\n //% blockId=music_stop_all_sounds block=\"stop all sounds\"\n //% weight=10\n //% group=\"Sounds\"\n export function stopAllSounds() {\n Melody.stopAll();\n stopPlaying();\n }\n\n //% fixedInstances\n export class Melody {\n _text: string;\n private _player: MelodyPlayer;\n\n private static playingMelodies: Melody[];\n\n static stopAll() {\n if (Melody.playingMelodies) {\n const ms = Melody.playingMelodies.slice(0, Melody.playingMelodies.length);\n ms.forEach(p => p.stop());\n }\n }\n\n constructor(text: string) {\n this._text = text\n }\n\n get text() {\n return this._text;\n }\n\n /**\n * Stop playing a sound\n */\n //% blockId=mixer_stop block=\"stop sound %sound\"\n //% help=music/melody/stop\n //% parts=\"headphone\"\n //% weight=92 blockGap=8\n //% group=\"Sounds\"\n stop() {\n if (this._player) {\n this._player.stop()\n this._player = null\n }\n this.unregisterMelody();\n }\n\n private registerMelody() {\n // keep track of the active players\n if (!Melody.playingMelodies) Melody.playingMelodies = [];\n // stop and pop melodies if too many playing\n if (Melody.playingMelodies.length > 4) {\n // stop last player (also pops)\n Melody.playingMelodies[Melody.playingMelodies.length - 1].stop();\n }\n // put back the melody on top of the melody stack\n Melody.playingMelodies.removeElement(this);\n Melody.playingMelodies.push(this);\n }\n private unregisterMelody() {\n // remove from list\n if (Melody.playingMelodies) {\n Melody.playingMelodies.removeElement(this); // remove self\n }\n }\n\n private playCore(volume: number, loop: boolean) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this.registerMelody();\n control.runInParallel(() => {\n while (this._player == p) {\n p.play(volume)\n if (!loop) {\n // Unregister the melody when done playing, but\n // only if it hasn't been restarted. (Looping\n // melodies never stop on their own, they only\n // get unregistered via stop().)\n if (this._player == p) {\n this.unregisterMelody();\n }\n break\n }\n }\n })\n }\n\n /**\n * Start playing a sound in a loop and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/loop\n //% blockId=mixer_loop_sound block=\"loop sound %sound\"\n //% parts=\"headphone\"\n //% weight=93 blockGap=8\n //% group=\"Sounds\"\n loop(volume = 255) {\n this.playCore(volume, true)\n }\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/play\n //% blockId=mixer_play_sound block=\"play sound %sound\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% group=\"Sounds\"\n play(volume = 255) {\n this.playCore(volume, false)\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * @param sound the melody to play\n */\n //% help=music/melody/play-until-done\n //% blockId=mixer_play_sound_until_done block=\"play sound %sound|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% group=\"Sounds\"\n playUntilDone(volume = 255) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this._player.onPlayFinished = () => {\n if (p == this._player)\n this.unregisterMelody();\n }\n this.registerMelody();\n this._player.play(volume)\n }\n\n toString() {\n return this._text;\n }\n }\n\n function addNote(sndInstr: Buffer, sndInstrPtr: number, ms: number, beg: number, end: number, soundWave: number, hz: number, volume: number, endHz: number) {\n if (ms > 0) {\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, soundWave)\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr + 1, 0)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 2, hz)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 4, ms)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 6, (beg * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 8, (end * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 10, endHz);\n sndInstrPtr += BUFFER_SIZE;\n }\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, 0) // terminate\n return sndInstrPtr\n }\n\n\n export class MelodyPlayer {\n melody: Melody;\n\n onPlayFinished: () => void;\n\n constructor(m: Melody) {\n this.melody = m\n }\n\n stop() {\n this.melody = null\n }\n\n protected queuePlayInstructions(timeDelta: number, buf: Buffer) {\n queuePlayInstructions(timeDelta, buf)\n }\n\n play(volume: number) {\n if (!this.melody)\n return\n volume = Math.clamp(0, 255, (volume * music.volume()) >> 8)\n\n let notes = this.melody._text\n let pos = 0;\n let duration = 4; //Default duration (Crotchet)\n let octave = 4; //Middle octave\n let tempo = 120; // default tempo\n\n let hz = 0\n let endHz = -1\n let ms = 0\n let timePos = 0\n let startTime = control.millis()\n let now = 0\n\n let envA = 0\n let envD = 0\n let envS = 255\n let envR = 0\n let soundWave = 1 // triangle\n let sndInstr = control.createBuffer(5 * BUFFER_SIZE)\n let sndInstrPtr = 0\n\n const addForm = (formDuration: number, beg: number, end: number, msOff: number) => {\n let freqStart = hz;\n let freqEnd = endHz;\n\n const envelopeWidth = ms > 0 ? ms : duration * Math.idiv(15000, tempo) + envR;\n if (endHz != hz && envelopeWidth != 0) {\n const slope = (freqEnd - freqStart) / envelopeWidth;\n freqStart = hz + slope * msOff;\n freqEnd = hz + slope * (msOff + formDuration);\n }\n sndInstrPtr = addNote(sndInstr, sndInstrPtr, formDuration, beg, end, soundWave, freqStart, volume, freqEnd);\n }\n\n const scanNextWord = () => {\n if (!this.melody)\n return \"\"\n\n // eat space\n while (pos < notes.length) {\n const c = notes[pos];\n if (c != ' ' && c != '\\r' && c != '\\n' && c != '\\t')\n break;\n pos++;\n }\n\n // read note\n let note = \"\";\n while (pos < notes.length) {\n const c = notes[pos];\n if (c == ' ' || c == '\\r' || c == '\\n' || c == '\\t')\n break;\n note += c;\n pos++;\n }\n return note;\n }\n\n enum Token {\n Note,\n Octave,\n Beat,\n Tempo,\n Hz,\n EndHz,\n Ms,\n WaveForm,\n EnvelopeA,\n EnvelopeD,\n EnvelopeS,\n EnvelopeR\n }\n\n let token: string = \"\";\n let tokenKind = Token.Note;\n\n // [ABCDEFG] (\\d+) (:\\d+) (-\\d+)\n // note octave length tempo\n // R (:\\d+) - rest\n // !\\d+,\\d+ - sound at frequency with given length (Hz,ms); !\\d+ and !\\d+,:\\d+ also possible\n // @\\d+,\\d+,\\d+,\\d+ - ADSR envelope - ms,ms,volume,ms; volume is 0-255\n // ~\\d+ - wave form:\n // 1 - triangle\n // 2 - sawtooth\n // 3 - sine\n // 4 - pseudorandom square wave noise (tunable)\n // 5 - white noise (ignores frequency)\n // 11 - square 10%\n // 12 - square 20%\n // ...\n // 15 - square 50%\n // 16 - filtered square wave, cycle length 16\n // 17 - filtered square wave, cycle length 32\n // 18 - filtered square wave, cycle length 64\n\n const consumeToken = () => {\n if (token && tokenKind != Token.Note) {\n const d = parseInt(token);\n switch (tokenKind) {\n case Token.Octave: octave = d; break;\n case Token.Beat:\n duration = Math.max(1, Math.min(16, d));\n ms = -1;\n break;\n case Token.Tempo: tempo = Math.max(1, d); break;\n case Token.Hz: hz = d; tokenKind = Token.Ms; break;\n case Token.Ms: ms = d; break;\n case Token.WaveForm: soundWave = Math.clamp(1, 18, d); break;\n case Token.EnvelopeA: envA = d; tokenKind = Token.EnvelopeD; break;\n case Token.EnvelopeD: envD = d; tokenKind = Token.EnvelopeS; break;\n case Token.EnvelopeS: envS = Math.clamp(0, 255, d); tokenKind = Token.EnvelopeR; break;\n case Token.EnvelopeR: envR = d; break;\n case Token.EndHz: endHz = d; break;\n }\n token = \"\";\n }\n }\n\n while (true) {\n let currNote = scanNextWord();\n let prevNote: boolean = false;\n if (!currNote) {\n let timeLeft = timePos - now\n if (timeLeft > 0)\n pause(timeLeft)\n if (this.onPlayFinished)\n this.onPlayFinished();\n return;\n }\n\n hz = -1;\n\n let note: number = 0;\n token = \"\";\n tokenKind = Token.Note;\n\n for (let i = 0; i < currNote.length; i++) {\n let noteChar = currNote.charAt(i);\n switch (noteChar) {\n case 'c': case 'C': note = 1; prevNote = true; break;\n case 'd': case 'D': note = 3; prevNote = true; break;\n case 'e': case 'E': note = 5; prevNote = true; break;\n case 'f': case 'F': note = 6; prevNote = true; break;\n case 'g': case 'G': note = 8; prevNote = true; break;\n case 'a': case 'A': note = 10; prevNote = true; break;\n case 'B': note = 12; prevNote = true; break;\n case 'r': case 'R': hz = 0; prevNote = false; break;\n case '#': note++; prevNote = false; break;\n case 'b': if (prevNote) note--; else { note = 12; prevNote = true; } break;\n case ',':\n consumeToken();\n prevNote = false;\n break;\n case '!':\n tokenKind = Token.Hz;\n prevNote = false;\n break;\n case '@':\n consumeToken();\n tokenKind = Token.EnvelopeA;\n prevNote = false;\n break;\n case '~':\n consumeToken();\n tokenKind = Token.WaveForm;\n prevNote = false;\n break;\n case ':':\n consumeToken();\n tokenKind = Token.Beat;\n prevNote = false;\n break;\n case '-':\n consumeToken();\n tokenKind = Token.Tempo;\n prevNote = false;\n break;\n case '^':\n consumeToken();\n tokenKind = Token.EndHz;\n break;\n default:\n if (tokenKind == Token.Note)\n tokenKind = Token.Octave;\n token += noteChar;\n prevNote = false;\n break;\n }\n }\n consumeToken();\n\n if (note && hz < 0) {\n const keyNumber = note + (12 * (octave - 1));\n hz = freqs.getNumber(NumberFormat.UInt16LE, keyNumber * 2) || 0;\n }\n\n let currMs = ms\n\n if (currMs <= 0) {\n const beat = Math.idiv(15000, tempo);\n currMs = duration * beat\n }\n\n if (hz < 0) {\n // no frequency specified, so no duration\n } else if (hz == 0) {\n timePos += currMs\n } else {\n if (endHz < 0) {\n endHz = hz;\n }\n\n sndInstrPtr = 0\n addForm(envA, 0, 255, 0)\n addForm(envD, 255, envS, envA)\n addForm(currMs - (envA + envD), envS, envS, envD + envA)\n addForm(envR, envS, 0, currMs)\n\n this.queuePlayInstructions(timePos - now, sndInstr.slice(0, sndInstrPtr))\n endHz = -1;\n timePos += currMs // don't add envR - it's supposed overlap next sound\n }\n\n let timeLeft = timePos - now\n if (timeLeft > 200) {\n pause(timeLeft - 100)\n now = control.millis() - startTime\n }\n }\n }\n }\n\n //% fixedInstance whenUsed block=\"ba ding\"\n export const baDing = new Melody('b5:1 e6:3')\n\n //% fixedInstance whenUsed block=\"wawawawaa\"\n export const wawawawaa = new Melody('~15 e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8')\n\n //% fixedInstance whenUsed block=\"jump up\"\n export const jumpUp = new Melody('c5:1 d e f g')\n\n //% fixedInstance whenUsed block=\"jump down\"\n export const jumpDown = new Melody('g5:1 f e d c')\n\n //% fixedInstance whenUsed block=\"power up\"\n export const powerUp = new Melody('g4:1 c5 e g:2 e:1 g:3')\n\n //% fixedInstance whenUsed block=\"power down\"\n export const powerDown = new Melody('g5:1 d# c g4:2 b:1 c5:3')\n\n //% fixedInstance whenUsed block=\"magic wand\"\n export const magicWand = new Melody('F#6:1-300 G# A# B C7# D# F F# G# A# B:6')\n //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n\n //% fixedInstance whenUsed block=\"siren\"\n export const siren = new Melody('a4 d5 a4 d5 a4 d5')\n\n //% fixedInstance whenUsed block=\"pew pew\"\n export const pewPew = new Melody('!1200,200^50')\n\n //% fixedInstance whenUsed block=\"knock\"\n export const knock = new Melody('~4 @0,0,255,150 !300,1 !211,1')\n\n //% fixedInstance whenUsed block=\"footstep\"\n export const footstep = new Melody('~4 @0,0,60,50 !200,1')\n\n //% fixedInstance whenUsed block=\"thump\"\n export const thump = new Melody('~4 @0,0,255,150 !100,1')\n\n //% fixedInstance whenUsed block=\"small crash\"\n export const smallCrash = new Melody('~4 @10,490,0,1 !800,1')\n\n //% fixedInstance whenUsed block=\"big crash\"\n export const bigCrash = new Melody('~4 @10,990,0,1 !400,1')\n\n //% fixedInstance whenUsed block=\"zapped\"\n export const zapped = new Melody('~16 @10,490,0,0 !1600,500^1')\n\n //% fixedInstance whenUsed block=\"buzzer\"\n export const buzzer = new Melody('~16 @10,0,255,250 !2000,300')\n\n //% fixedInstance whenUsed block=\"sonar\"\n export const sonar = new Melody('~16 @10,1500,0,0 !200,1 !200,1500^190')\n\n //% fixedInstance whenUsed block=\"spooky\"\n export const spooky = new Melody('~16 @700,1300,0,0 !100,1 ~18 !108,2000')\n\n //% fixedInstance whenUsed block=\"beam up\"\n export const beamUp = new Melody('~18 @10,1500,0,0 !200,1500^4000')\n}\n",
"music.ts": "enum Note {\n //% blockIdentity=music.noteFrequency enumval=262\n C = 262,\n //% block=C#\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F = 349,\n //% block=F#\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G = 392,\n //% block=G#\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B = 494,\n //% blockIdentity=music.noteFrequency enumval=131\n C3 = 131,\n //% block=C#3\n //% blockIdentity=music.noteFrequency enumval=139\n CSharp3 = 139,\n //% blockIdentity=music.noteFrequency enumval=147\n D3 = 147,\n //% blockIdentity=music.noteFrequency enumval=156\n Eb3 = 156,\n //% blockIdentity=music.noteFrequency enumval=165\n E3 = 165,\n //% blockIdentity=music.noteFrequency enumval=175\n F3 = 175,\n //% block=F#3\n //% blockIdentity=music.noteFrequency enumval=185\n FSharp3 = 185,\n //% blockIdentity=music.noteFrequency enumval=196\n G3 = 196,\n //% block=G#3\n //% blockIdentity=music.noteFrequency enumval=208\n GSharp3 = 208,\n //% blockIdentity=music.noteFrequency enumval=220\n A3 = 220,\n //% blockIdentity=music.noteFrequency enumval=233\n Bb3 = 233,\n //% blockIdentity=music.noteFrequency enumval=247\n B3 = 247,\n //% blockIdentity=music.noteFrequency enumval=262\n C4 = 262,\n //% block=C#4\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp4 = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D4 = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb4 = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E4 = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F4 = 349,\n //% block=F#4\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp4 = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G4 = 392,\n //% block=G#4\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp4 = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A4 = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb4 = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B4 = 494,\n //% blockIdentity=music.noteFrequency enumval=523\n C5 = 523,\n //% block=C#5\n //% blockIdentity=music.noteFrequency enumval=555\n CSharp5 = 555,\n //% blockIdentity=music.noteFrequency enumval=587\n D5 = 587,\n //% blockIdentity=music.noteFrequency enumval=622\n Eb5 = 622,\n //% blockIdentity=music.noteFrequency enumval=659\n E5 = 659,\n //% blockIdentity=music.noteFrequency enumval=698\n F5 = 698,\n //% block=F#5\n //% blockIdentity=music.noteFrequency enumval=740\n FSharp5 = 740,\n //% blockIdentity=music.noteFrequency enumval=784\n G5 = 784,\n //% block=G#5\n //% blockIdentity=music.noteFrequency enumval=831\n GSharp5 = 831,\n //% blockIdentity=music.noteFrequency enumval=880\n A5 = 880,\n //% blockIdentity=music.noteFrequency enumval=932\n Bb5 = 932,\n //% blockIdentity=music.noteFrequency enumval=988\n B5 = 988,\n}\n\nenum BeatFraction {\n //% block=1\n Whole = 1,\n //% block=\"1/2\"\n Half = 2,\n //% block=\"1/4\"\n Quarter = 4,\n //% block=\"1/8\"\n Eighth = 8,\n //% block=\"1/16\"\n Sixteenth = 16,\n //% block=\"2\"\n Double = 32,\n //% block=\"4\",\n Breve = 64,\n //% block=\"1/3\",\n Triplet = 128\n}\n\nnamespace music {\n\n let beatsPerMinute: number;\n\n /**\n * Play a tone.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n */\n //% help=music/ring-tone\n //% blockId=music_ring block=\"ring tone|at %note=device_note\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music inBasicCategory=true\n //% weight=75 blockGap=8\n //% group=\"Tone\"\n export function ringTone(frequency: number) {\n playTone(frequency, 0);\n }\n\n /**\n * Rest, or play silence, for some time (in milliseconds).\n * @param ms rest duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/rest\n //% blockId=music_rest block=\"rest|for %duration=device_beat\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music\n //% weight=74\n //% group=\"Tone\"\n export function rest(ms: number) {\n playTone(0, Math.max(ms, 20));\n }\n\n function init() {\n if (!beatsPerMinute) beatsPerMinute = 120;\n }\n\n /**\n * Return the duration of a beat in milliseconds (the beat fraction).\n * @param fraction the fraction of the current whole note, eg: BeatFraction.Half\n */\n //% help=music/beat\n //% blockId=device_beat block=\"%fraction|beat\"\n //% weight=9 blockGap=8\n //% group=\"Tempo\"\n export function beat(fraction?: BeatFraction): number {\n init();\n if (fraction == null) fraction = BeatFraction.Whole;\n let beat = 60000 / beatsPerMinute;\n switch (fraction) {\n case BeatFraction.Half: beat /= 2; break;\n case BeatFraction.Quarter: beat /= 4; break;\n case BeatFraction.Eighth: beat /= 8; break;\n case BeatFraction.Sixteenth: beat /= 16; break;\n case BeatFraction.Double: beat *= 2; break;\n case BeatFraction.Breve: beat *= 4; break;\n case BeatFraction.Triplet: beat /= 3; break;\n }\n return beat >> 0;\n }\n\n /**\n * Return the tempo in beats per minute (bpm).\n * Tempo is the speed (bpm = beats per minute) at which notes play. The larger the tempo value, the faster the notes will play.\n */\n //% help=music/tempo\n //% blockId=device_tempo block=\"tempo (bpm)\"\n //% weight=64\n //% group=\"Tempo\"\n export function tempo(): number {\n init();\n return beatsPerMinute;\n }\n\n /**\n * Change the tempo up or down by some amount of beats per minute (bpm).\n * @param bpm The change in beats per minute to the tempo, eg: 20\n */\n //% help=music/change-tempo-by weight=37\n //% blockId=device_change_tempo block=\"change tempo by %value|(bpm)\"\n //% weight=66 blockGap=8\n //% group=\"Tempo\"\n export function changeTempoBy(bpm: number): void {\n init();\n setTempo(beatsPerMinute + bpm);\n }\n\n /**\n * Set the tempo a number of beats per minute (bpm).\n * @param bpm The new tempo in beats per minute, eg: 120\n */\n //% help=music/set-tempo\n //% blockId=device_set_tempo block=\"set tempo to %value|(bpm)\"\n //% bpm.min=4 bpm.max=400\n //% weight=65 blockGap=8\n //% group=\"Tempo\"\n export function setTempo(bpm: number): void {\n init();\n if (bpm > 0) {\n beatsPerMinute = Math.max(1, bpm >> 0);\n }\n }\n}\n",
"ns.ts": "\n/**\n * Generation of music tones.\n */\n//% color=#E30FC0 weight=90 icon=\"\\uf025\"\n//% blockGap=8\n//% groups='[\"Sounds\", \"Melody\", \"Tone\", \"Volume\", \"Tempo\"]'\nnamespace music {\n}",
"piano.ts": "namespace music {\n /**\n * Get the frequency of a note.\n * @param name the note name, eg: Note.C\n */\n //% weight=1 help=music/note-frequency\n //% blockId=device_note block=\"%note\"\n //% shim=TD_ID\n //% color=\"#FFFFFF\" colorSecondary=\"#FFFFFF\" colorTertiary=\"#D83B01\"\n //% note.fieldEditor=\"note\" note.defl=\"262\"\n //% note.fieldOptions.decompileLiterals=true\n //% useEnumVal=1\n //% weight=10 blockGap=8\n //% group=\"Tone\"\n export function noteFrequency(name: Note): number {\n return name;\n }\n}",
"pxt.json": "{\n \"name\": \"mixer---none\",\n \"description\": \"The music library with a mixer\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"SoundOutput.h\",\n \"sound.cpp\",\n \"melody.h\",\n \"melody.cpp\",\n \"melody.ts\",\n \"piano.ts\",\n \"legacy.ts\",\n \"ns.ts\",\n \"targetoverrides.ts\",\n \"music.ts\",\n \"pxtparts.json\",\n \"headphone.svg\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"pxtparts.json": "{\n \"headphone\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"image\": \"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\": \"A0\",\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}",
"sound.cpp": "// to be overridden\n",
"targetoverrides.ts": "\n",
"test.ts": "for(let i = 1000; i > 0; i -= 50)\n music.playTone(440, i)\n\nfor(let i = 0; i < 1000; i += 20)\n music.playTone(440, i)\n"
},
"mixer---samd": {
"SoundOutput.h": "#include \"SAMDDAC.h\"\n#include \"Synthesizer.h\"\n#include \"Mixer.h\"\n\nnamespace jacdac {\nvoid setJackRouterOutput(int output);\n}\n\nclass SoundOutput {\n public:\n SAMDDAC dac;\n\n SoundOutput(DataSource &data) : dac(*pxt::lookupPin(PIN_PA02), data) {\n jacdac::setJackRouterOutput(-1);\n }\n\n void setOutput(int output) { jacdac::setJackRouterOutput(output); }\n};\n",
"headphone.svg": "",
"legacy.ts": "//% deprecated=true hidden=true\nenum Sounds {\n //% block=\"power up\"\n PowerUp,\n //% block=\"power down\"\n PowerDown,\n //% block=\"jump up\"\n JumpUp,\n //% block=\"jump down\"\n JumpDown,\n //% block=\"ba ding\"\n BaDing,\n //% block=\"wawawawaa\"\n Wawawawaa,\n //% block=\"magic wand\"\n MagicWand,\n //% block=\"siren\"\n Siren\n}\n\nnamespace music {\n /**\n * Get the melody string for a built-in melody.\n * @param name the note name, eg: Note.C\n */\n //% help=music/sounds\n //% blockId=music_sounds block=\"%name\"\n //% blockHidden=true\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=285\n //% name.fieldOptions.columns=3\n export function sounds(name: Sounds): string {\n switch (name) {\n case Sounds.BaDing:\n return 'b5:1 e6:3';\n case Sounds.Wawawawaa:\n return 'e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8';\n case Sounds.JumpUp:\n return 'c5:1 d e f g';\n case Sounds.JumpDown:\n return 'g5:1 f e d c';\n case Sounds.PowerUp:\n return 'g4:1 c5 e g:2 e:1 g:3';\n case Sounds.PowerDown:\n return 'g5:1 d# c g4:2 b:1 c5:3';\n case Sounds.MagicWand:\n return 'F#6:1-300 G# A# B C7# D# F F# G# A# B:6'; //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n case Sounds.Siren:\n return 'a4 d5 a4 d5 a4 d5';\n default:\n return '';\n }\n }\n\n let currMelody: Melody\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound\n //% blockId=music_play_sound block=\"play sound %sound=music_sounds\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% deprecated=true hidden=true\n export function playSound(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.play();\n pause(1);\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound-until-done\n //% blockId=music_play_sound_until_done block=\"play sound %sound=music_sounds|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% deprecated=true hidden=true\n export function playSoundUntilDone(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.playUntilDone();\n }\n}",
"melody.cpp": "#include \"pxt.h\"\n#include \"SoundOutput.h\"\n#include \"melody.h\"\n\n//#define LOG DMESG\n#define LOG NOLOG\n\nnamespace music {\n\nSINGLETON(WSynthesizer);\n\n// Tone generator arguments:\n//\n// sound: a pointer to the currently-playing sound, usable for looking up the\n// waveform or generator-specific state.\n//\n// position: offset within the currently-playing wave, range 0..1023.\n//\n// cycle: a 6-bit cyclical sequence number of the wave, incremented each time\n// the position loops from 1023 back to 0.\ntypedef int (*gentone_t)(PlayingSound *sound, uint32_t position, uint8_t cycle);\n\nstatic int noiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)position;\n (void)cycle;\n // see https://en.wikipedia.org/wiki/Xorshift\n static uint32_t x = 0xf01ba80;\n x ^= x << 13;\n x ^= x >> 17;\n x ^= x << 5;\n return (x & 0xffff) - 0x7fff;\n}\n\nstatic int sineTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n int32_t p = position;\n if (p >= 512) {\n p -= 512;\n }\n if (p > 256) {\n p = 512 - p;\n }\n\n // Approximate sin(x * pi / 2) with the odd polynomial y = cx^5 + bx^3 + ax\n // using the constraint y(1) = 1 => a = 1 - b - c\n // => y = c x^5 + b x^3 + (1 - b - c) * x\n //\n // Do a least-squares fit of this to sin(x * pi / 2) in the range 0..1\n // inclusive, using 21 evenly spaced points. Resulting approximation:\n //\n // sin(x*pi/2) ~= 0.0721435357258*x**5 - 0.642443736562*x**3 + 1.57030020084*x\n\n // Scale the constants by 32767 to match the desired output range.\n constexpr int32_t c = 0.0721435357258 * 32767;\n constexpr int32_t b = -0.642443736562 * 32767;\n constexpr int32_t a = 1.57030020084 * 32767;\n\n // Calculate using y = ((c * x^2 + b) * x^2 + a) * x\n //\n // The position p is x * 256, so after each multiply with p we need to\n // shift right by 8 bits to keep the decimal point in the same place. (The\n // approximation has a negative error near x=1 which helps avoid overflow.)\n int32_t p2 = p * p;\n int32_t u = (c * p2 >> 16) + b;\n int32_t v = (u * p2 >> 16) + a;\n int32_t w = v * p >> 8;\n\n // The result is within 7/32767 or 0.02%, signal-to-error ratio about 38 dB.\n return position >= 512 ? -w : w;\n}\n\nstatic int sawtoothTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n return (position << 6) - 0x7fff;\n}\n\nstatic int triangleTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n return position < 512 ? (position << 7) - 0x7fff : ((1023 - position) << 7) - 0x7fff;\n}\n\nstatic int squareWaveTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)cycle;\n uint8_t wave = sound->currInstr->soundWave;\n return (int)position < (102 * (wave - SW_SQUARE_10 + 1)) ? -0x7fff : 0x7fff;\n}\n\nstatic int tunedNoiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a random bit sequence. Since the generator\n // is called multiple times per wave, use PlayingSound state data to ensure we\n // only generate a random bit once per wave, and then reuse it for future\n // calls for that wave.\n //\n // Use the low 6 bits of generatorState to store the last-used cycle, and\n // random_bit to store the last on/off state. (random_bit is arbitrary as\n // long as it isn't one of the low 6 bits.)\n constexpr uint32_t random_bit = 0x8000;\n static uint32_t x = 0xf01ba80; // seed for the static RNG state\n uint8_t prev_cycle = sound->generatorState & 0x3f;\n uint32_t is_on;\n if (cycle == prev_cycle) {\n is_on = sound->generatorState & random_bit;\n } else {\n // see https://en.wikipedia.org/wiki/Xorshift\n x ^= x << 13;\n x ^= x >> 17;\n x ^= x << 5;\n is_on = (x & random_bit);\n sound->generatorState = (cycle & 0x3f) | is_on;\n }\n if (!is_on)\n return 0;\n return position < 512 ? -0x7fff : 0x7fff;\n}\n\n// Bit patterns for use by the cyclic noise tone.\n//\n// The bit pattern is arbitrary, but should have equal numbers of 0 and 1 bits,\n// and should avoid long identical-bit runs for the lower parts. The values below\n// were chosen based on a random permutation of the hex nibbles 0..f and then\n// hand-tweaked by swapping some nibbles. Generated by:\n//\n// shuf -i 0-15 | perl -ne 's/(\\d+)/printf(\"%x\",$1)/e'\nstatic const uint32_t cycle_bits[] = {0x2df0eb47, 0xc8165a93};\nstatic const uint8_t cycle_mask[] = {0xf, 0x1f, 0x3f};\n\nstatic int cycleNoiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a short-cycle pseudorandom bit sequence.\n // The bit sequence repeats every 16/32/64 waves.\n //\n // The \"cycle\" argument corresponds to the sequential number of the generated\n // wave. This is currently a 6-bit value. Since the pseudorandom bit sequences\n // evenly fit into this, there's no need to track generator state.\n uint8_t wave = sound->currInstr->soundWave;\n int cycle_index = wave - SW_SQUARE_CYCLE_16;\n // CLAMP(0, cycle_index, sizeof cycle_bits / sizeof cycle_bits[0])\n cycle &= cycle_mask[cycle_index];\n bool is_on = (cycle_bits[cycle >> 5] & (1U << (cycle & 0x1f)));\n if (!is_on)\n return 0;\n return position < 512 ? -0x7fff : 0x7fff;\n}\n\nstatic int silenceTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a short-cycle pseudorandom bit sequence.\n (void)sound;\n (void)position;\n (void)cycle;\n return 0;\n}\n\nstatic gentone_t getWaveFn(uint8_t wave) {\n switch (wave) {\n case SW_TRIANGLE:\n return triangleTone;\n case SW_SAWTOOTH:\n return sawtoothTone;\n case SW_TUNEDNOISE:\n return tunedNoiseTone;\n case SW_NOISE:\n return noiseTone;\n case SW_SINE:\n return sineTone;\n default:\n if (SW_SQUARE_10 <= wave && wave <= SW_SQUARE_50)\n return squareWaveTone;\n if (SW_SQUARE_CYCLE_16 <= wave && wave <= SW_SQUARE_CYCLE_64)\n return cycleNoiseTone;\n else\n return silenceTone;\n }\n}\n\n#define CLAMP(lo, v, hi) ((v) = ((v) < (lo) ? (lo) : (v) > (hi) ? (hi) : (v)))\n\nint WSynthesizer::updateQueues() {\n const int maxTime = 0xffffff;\n while (1) {\n WaitingSound *p;\n int minLeft = maxTime;\n for (p = waiting; p; p = p->next) {\n int timeLeft =\n p->state == SoundState::Waiting ? p->startSampleNo - currSample : maxTime;\n if (timeLeft <= 0) {\n break;\n }\n if (timeLeft < minLeft)\n minLeft = timeLeft;\n }\n if (p) {\n PlayingSound *snd;\n int minIdx = -1;\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n snd = &playingSounds[i];\n if (snd->sound == NULL)\n break;\n if (minIdx == -1 ||\n playingSounds[minIdx].startSampleNo < playingSounds[i].startSampleNo)\n minIdx = i;\n snd = NULL;\n }\n // if we didn't find a free slot, expel the oldest sound\n if (!snd)\n snd = &playingSounds[minIdx];\n if (snd->sound)\n snd->sound->state = SoundState::Done;\n snd->sound = p;\n p->state = SoundState::Playing;\n snd->startSampleNo = currSample;\n snd->currInstr = (SoundInstruction *)p->instructions->data;\n snd->instrEnd = snd->currInstr + p->instructions->length / sizeof(SoundInstruction);\n snd->prevVolume = -1;\n } else {\n // no more sounds to move\n return minLeft;\n }\n }\n}\n\nint WSynthesizer::fillSamples(int16_t *dst, int numsamples) {\n if (numsamples <= 0)\n return 1;\n\n int timeLeft = updateQueues();\n int res = waiting != NULL;\n\n // if there's a pending sound to be started somewhere during numsamples,\n // split the call into two\n if (timeLeft < numsamples) {\n fillSamples(dst, timeLeft);\n LOG(\"M split %d\", timeLeft);\n fillSamples(dst + timeLeft, numsamples - timeLeft);\n return 1;\n }\n\n memset(dst, 0, numsamples * 2);\n\n uint32_t samplesPerMS = (sampleRate << 8) / 1000;\n float toneStepMult = (1024.0 * (1 << 16)) / sampleRate;\n const int MAXVAL = (1 << (OUTPUT_BITS - 1)) - 1;\n\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n PlayingSound *snd = &playingSounds[i];\n if (snd->sound == NULL)\n continue;\n\n res = 1;\n\n SoundInstruction *instr = NULL;\n gentone_t fn = NULL;\n snd->currInstr--;\n uint32_t toneStep = 0;\n int32_t toneDelta = 0;\n int32_t volumeStep = 0;\n uint32_t tonePosition = snd->tonePosition;\n uint32_t samplesLeft = 0;\n uint8_t wave = 0;\n int32_t volume = 0;\n\n for (int j = 0; j < numsamples; ++j) {\n if (samplesLeft == 0) {\n snd->currInstr++;\n if (snd->currInstr >= snd->instrEnd) {\n break;\n }\n SoundInstruction copy = *snd->currInstr;\n instr = ©\n CLAMP(20, instr->frequency, 20000);\n CLAMP(20, instr->endFrequency, 20000);\n CLAMP(0, instr->startVolume, 1023);\n CLAMP(0, instr->endVolume, 1023);\n CLAMP(1, instr->duration, 60000);\n\n wave = instr->soundWave;\n fn = getWaveFn(wave);\n\n samplesLeft = (uint32_t)(instr->duration * samplesPerMS >> 8);\n // make sure the division is signed\n volumeStep =\n (int)((instr->endVolume - instr->startVolume) << 16) / (int)samplesLeft;\n\n if (j == 0 && snd->prevVolume != -1) {\n // restore previous state\n samplesLeft = snd->samplesLeftInCurr;\n volume = snd->prevVolume;\n toneStep = snd->prevToneStep;\n toneDelta = snd->prevToneDelta;\n } else {\n LOG(\"#sampl %d %p\", samplesLeft, snd->currInstr);\n volume = instr->startVolume << 16;\n LOG(\"%d-%dHz %d-%d vol\", instr->frequency, instr->endFrequency,\n instr->startVolume, instr->endVolume);\n toneStep = (uint32_t)(toneStepMult * instr->frequency);\n if (instr->frequency != instr->endFrequency) {\n uint32_t endToneStep = (uint32_t)(toneStepMult * instr->endFrequency);\n toneDelta = (int32_t)(endToneStep - toneStep) / (int32_t)samplesLeft;\n } else {\n toneDelta = 0;\n }\n }\n }\n\n int v = fn(snd, (tonePosition >> 16) & 1023, tonePosition >> 26);\n v = (v * (volume >> 16)) >> (10 + (16 - OUTPUT_BITS));\n\n // if (v > MAXVAL)\n // target_panic(123);\n\n dst[j] += v;\n\n tonePosition += toneStep;\n toneStep += toneDelta;\n volume += volumeStep;\n samplesLeft--;\n }\n\n if (snd->currInstr >= snd->instrEnd) {\n snd->sound->state = SoundState::Done;\n snd->sound = NULL;\n } else {\n snd->tonePosition = tonePosition;\n if (samplesLeft == 0)\n samplesLeft++; // avoid infinite loop in next iteration\n snd->samplesLeftInCurr = samplesLeft;\n snd->prevVolume = volume;\n snd->prevToneDelta = toneDelta;\n snd->prevToneStep = toneStep;\n }\n }\n\n currSample += numsamples;\n\n for (int j = 0; j < numsamples; ++j) {\n if (dst[j] > MAXVAL)\n dst[j] = MAXVAL;\n else if (dst[j] < -MAXVAL)\n dst[j] = -MAXVAL;\n }\n\n return res;\n}\n\n//%\nvoid enableAmp(int enabled) {\n // this is also compiled on linux\n#ifdef LOOKUP_PIN\n auto pin = LOOKUP_PIN(SPEAKER_AMP);\n if (pin) {\n if (PIN(SPEAKER_AMP) & CFG_PIN_CONFIG_ACTIVE_LO)\n enabled = !enabled;\n pin->setDigitalValue(enabled);\n }\n#endif\n}\n\n//%\nvoid forceOutput(int outp) {\n auto snd = getWSynthesizer();\n snd->out.setOutput(outp);\n}\n\n//%\nvoid queuePlayInstructions(int when, Buffer buf) {\n auto snd = getWSynthesizer();\n\n registerGCObj(buf);\n\n auto p = new WaitingSound;\n p->state = SoundState::Waiting;\n p->instructions = buf;\n p->startSampleNo = snd->currSample + when * snd->sampleRate / 1000;\n\n LOG(\"Queue %dms now=%d off=%d %p sampl:%dHz\", when, snd->currSample,\n p->startSampleNo - snd->currSample, buf->data, snd->sampleRate);\n\n target_disable_irq();\n // add new sound to queue\n p->next = snd->waiting;\n snd->waiting = p;\n // remove sounds that have already been fully played\n while (p) {\n while (p->next && p->next->state == SoundState::Done) {\n auto todel = p->next;\n p->next = todel->next;\n unregisterGCObj(todel->instructions);\n delete todel;\n }\n p = p->next;\n }\n target_enable_irq();\n\n snd->poke();\n}\n\n//%\nvoid stopPlaying() {\n LOG(\"stop playing!\");\n\n auto snd = getWSynthesizer();\n\n target_disable_irq();\n auto p = snd->waiting;\n snd->waiting = NULL;\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n snd->playingSounds[i].sound = NULL;\n }\n while (p) {\n auto n = p->next;\n unregisterGCObj(p->instructions);\n delete p;\n p = n;\n }\n target_enable_irq();\n}\n\nWSynthesizer::WSynthesizer() : upstream(NULL), out(*this) {\n currSample = 0;\n active = false;\n sampleRate = out.dac.getSampleRate();\n memset(&playingSounds, 0, sizeof(playingSounds));\n waiting = NULL;\n PXT_REGISTER_RESET(stopPlaying);\n}\n\n} // namespace music\n\nnamespace pxt {\nint redirectSamples(int16_t *dst, int numsamples, int samplerate) {\n auto snd = music::getWSynthesizer();\n snd->upstream = NULL; // disconnect from regular playback mechanism\n snd->sampleRate = samplerate;\n return snd->fillSamples(dst, numsamples);\n}\n\n} // namespace pxt\n\nnamespace jacdac {\n__attribute__((weak)) void setJackRouterOutput(int output) {}\n} // namespace jacdac\n",
"melody.h": "#pragma once\n\n#ifndef OUTPUT_BITS\n#define OUTPUT_BITS 10\n#endif\n\n#define SW_TRIANGLE 1\n#define SW_SAWTOOTH 2\n#define SW_SINE 3\n#define SW_TUNEDNOISE 4\n#define SW_NOISE 5\n#define SW_SQUARE_10 11\n#define SW_SQUARE_50 15\n#define SW_SQUARE_CYCLE_16 16\n#define SW_SQUARE_CYCLE_32 17\n#define SW_SQUARE_CYCLE_64 18\n\nstruct SoundInstruction {\n uint8_t soundWave;\n uint8_t flags;\n uint16_t frequency; // Hz\n uint16_t duration; // ms\n int16_t startVolume; // 0-1023\n int16_t endVolume; // 0-1023\n uint16_t endFrequency; // Hz\n};\n\n#ifdef DATASTREAM_MAXIMUM_BUFFERS\n#define CODAL 1\n#endif\n\nnamespace music {\n\n#define MAX_SOUNDS 5\n\nSTATIC_ASSERT((1 << (16 - OUTPUT_BITS)) > MAX_SOUNDS);\n\nenum class SoundState : uint8_t {\n Waiting, //\n Playing, //\n Done //\n};\n\nstruct WaitingSound {\n uint32_t startSampleNo;\n SoundState state;\n WaitingSound *next;\n Buffer instructions;\n};\n\nstruct PlayingSound {\n uint32_t startSampleNo;\n uint32_t samplesLeftInCurr;\n uint32_t tonePosition;\n int32_t prevVolume;\n uint32_t prevToneStep;\n int32_t prevToneDelta;\n uint32_t generatorState;\n WaitingSound *sound;\n SoundInstruction *currInstr, *instrEnd;\n};\n\nclass WSynthesizer\n#ifdef CODAL\n : public DataSource\n#endif\n{\n public:\n#ifdef CODAL\n DataSink *upstream;\n#else\n void *upstream;\n#endif\n uint32_t currSample; // after 25h of playing we might get a glitch\n int32_t sampleRate; // eg 44100\n PlayingSound playingSounds[MAX_SOUNDS];\n WaitingSound *waiting;\n bool active;\n\n SoundOutput out;\n\n int fillSamples(int16_t *dst, int numsamples);\n int updateQueues();\n\n WSynthesizer();\n virtual ~WSynthesizer() {}\n\n void pokeUpstream() {\n#ifdef CODAL\n if (upstream) {\n upstream->pullRequest();\n }\n#endif\n }\n\n void poke() {\n if (!active) {\n active = true;\n pokeUpstream();\n }\n }\n\n#ifdef CODAL\n virtual ManagedBuffer pull() {\n if (!upstream)\n return ManagedBuffer();\n ManagedBuffer data(512);\n auto dp = (int16_t *)data.getBytes();\n auto sz = 512 / 2;\n int r = fillSamples(dp, sz);\n#if defined(NRF52_SERIES)\n int mul = out.dac.getSampleRange();\n#endif\n while (sz--) {\n#if defined(NRF52_SERIES)\n *dp = ((-*dp + (1 << (OUTPUT_BITS - 1))) * mul) >> OUTPUT_BITS;\n#else\n *dp += 1 << (OUTPUT_BITS - 1);\n#endif\n dp++;\n }\n if (!r) {\n active = false;\n // return empty - nothing left to play\n return ManagedBuffer();\n }\n pokeUpstream();\n return data;\n }\n virtual void connect(DataSink &sink) { upstream = &sink; }\n#endif\n};\n\n} // namespace music\n",
"melody.ts": "enum MusicOutput {\n AutoDetect = 0,\n Buzzer = 1,\n HeadPhones = 2,\n}\n\nnamespace music {\n //% whenUsed\n const freqs = hex`\n 1f00210023002500270029002c002e003100340037003a003e004100450049004e00520057005c00620068006e00\n 75007b0083008b0093009c00a500af00b900c400d000dc00e900f70006011501260137014a015d01720188019f01\n b801d201ee010b022a024b026e029302ba02e40210033f037003a403dc03170455049704dd0427057505c8052006\n 7d06e0064907b8072d08a9082d09b9094d0aea0a900b400cfa0cc00d910e6f0f5a1053115b1272139a14d4152017\n 8018f519801b231dde1e`\n\n //% shim=music::queuePlayInstructions\n function queuePlayInstructions(timeDelta: number, buf: Buffer) { }\n\n //% shim=music::stopPlaying\n function stopPlaying() { }\n\n //% shim=music::forceOutput\n export function forceOutput(buf: MusicOutput) { }\n\n let globalVolume: number = null\n\n const BUFFER_SIZE: number = 12;\n\n //% shim=music::enableAmp\n function enableAmp(en: number) {\n return // for sim\n }\n\n function initVolume() {\n if (globalVolume === null) {\n globalVolume = 0\n setVolume(control.getConfigValue(DAL.CFG_SPEAKER_VOLUME, 128))\n }\n }\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 //% parts=\"speaker\"\n //% volume.min=0 volume.max=255\n //% volume.defl=20\n //% help=music/set-volume\n //% weight=70\n //% group=\"Volume\"\n export function setVolume(volume: number): void {\n globalVolume = Math.clamp(0, 255, volume | 0)\n enableAmp(globalVolume > 0 ? 1 : 0)\n }\n\n /**\n * Gets the current volume\n */\n //% parts=\"speaker\"\n //% weight=70\n export function volume(): number {\n initVolume()\n return globalVolume;\n }\n\n function playNoteCore(when: number, frequency: number, ms: number) {\n let buf = control.createBuffer(BUFFER_SIZE)\n addNote(buf, 0, ms, 255, 255, 3, frequency, volume(), frequency)\n queuePlayInstructions(when, buf)\n }\n\n /**\n * Play a tone through the speaker for some amount of time.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n * @param ms tone duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/play-tone\n //% blockId=mixer_play_note block=\"play tone|at %note=device_note|for %duration=device_beat\"\n //% parts=\"headphone\" async\n //% blockNamespace=music\n //% weight=76 blockGap=8\n //% group=\"Tone\"\n export function playTone(frequency: number, ms: number): void {\n if (ms == 0)\n ms = 86400000 // 1 day\n\n if (ms <= 2000) {\n playNoteCore(0, frequency, ms)\n pause(ms)\n } else {\n const id = ++playToneID\n control.runInParallel(() => {\n let pos = control.millis()\n while (id == playToneID && ms > 0) {\n let now = control.millis()\n let d = pos - now\n let t = Math.min(ms, 500)\n ms -= t\n pos += t\n playNoteCore(d - 1, frequency, t)\n if (ms == 0)\n pause(d + t)\n else\n pause(d + t - 100)\n }\n })\n }\n }\n\n let playToneID = 0\n\n /**\n * Play a melody from the melody editor.\n * @param melody - string of up to eight notes [C D E F G A B C5] or rests [-] separated by spaces, \n * which will be played one at a time, ex: \"E D G F B A C5 B \"\n * @param tempo - number in beats per minute (bpm), dictating how long each note will play for\n */\n //% block=\"play melody $melody at tempo $tempo|(bpm)\" blockId=playMelody\n //% blockNamespace=music\n //% weight=85 blockGap=8 help=music/play-melody\n //% group=\"Melody\"\n //% melody.shadow=\"melody_editor\"\n //% tempo.min=40 tempo.max=500\n //% tempo.defl=120\n export function playMelody(melody: string, tempo: number) {\n let notes: string[] = melody.split(\" \").filter(n => !!n);\n let formattedMelody = \"\";\n let newOctave = false;\n\n // build melody string, replace '-' with 'R' and add tempo\n // creates format like \"C5-174 B4 A G F E D C \"\n for (let i = 0; i < notes.length; i++) {\n if (notes[i] === \"-\") {\n notes[i] = \"R\";\n } else if (notes[i] === \"C5\") {\n newOctave = true;\n } else if (newOctave) { // change the octave if necesary\n notes[i] += \"4\";\n newOctave = false;\n }\n // add tempo after first note\n if (i == 0) {\n formattedMelody += notes[i] + \"-\" + tempo + \" \";\n } else {\n formattedMelody += notes[i] + \" \";\n }\n }\n\n const song = new Melody(formattedMelody);\n song.playUntilDone();\n }\n\n\n /**\n * Create a melody with the melody editor.\n * @param melody\n */\n //% block=\"$melody\" blockId=melody_editor\n //% blockNamespace=music\n //% blockHidden = true\n //% weight=85 blockGap=8\n //% help=music/melody-editor\n //% group=\"Melody\" duplicateShadowOnDrag\n //% melody.fieldEditor=\"melody\"\n //% melody.fieldOptions.decompileLiterals=true\n //% melody.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% melody.fieldOptions.onParentBlock=\"true\"\n //% shim=TD_ID\n export function melodyEditor(melody: string): string {\n return melody;\n }\n\n /**\n * Stop all sounds from playing.\n */\n //% help=music/stop-all-sounds\n //% blockId=music_stop_all_sounds block=\"stop all sounds\"\n //% weight=10\n //% group=\"Sounds\"\n export function stopAllSounds() {\n Melody.stopAll();\n stopPlaying();\n }\n\n //% fixedInstances\n export class Melody {\n _text: string;\n private _player: MelodyPlayer;\n\n private static playingMelodies: Melody[];\n\n static stopAll() {\n if (Melody.playingMelodies) {\n const ms = Melody.playingMelodies.slice(0, Melody.playingMelodies.length);\n ms.forEach(p => p.stop());\n }\n }\n\n constructor(text: string) {\n this._text = text\n }\n\n get text() {\n return this._text;\n }\n\n /**\n * Stop playing a sound\n */\n //% blockId=mixer_stop block=\"stop sound %sound\"\n //% help=music/melody/stop\n //% parts=\"headphone\"\n //% weight=92 blockGap=8\n //% group=\"Sounds\"\n stop() {\n if (this._player) {\n this._player.stop()\n this._player = null\n }\n this.unregisterMelody();\n }\n\n private registerMelody() {\n // keep track of the active players\n if (!Melody.playingMelodies) Melody.playingMelodies = [];\n // stop and pop melodies if too many playing\n if (Melody.playingMelodies.length > 4) {\n // stop last player (also pops)\n Melody.playingMelodies[Melody.playingMelodies.length - 1].stop();\n }\n // put back the melody on top of the melody stack\n Melody.playingMelodies.removeElement(this);\n Melody.playingMelodies.push(this);\n }\n private unregisterMelody() {\n // remove from list\n if (Melody.playingMelodies) {\n Melody.playingMelodies.removeElement(this); // remove self\n }\n }\n\n private playCore(volume: number, loop: boolean) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this.registerMelody();\n control.runInParallel(() => {\n while (this._player == p) {\n p.play(volume)\n if (!loop) {\n // Unregister the melody when done playing, but\n // only if it hasn't been restarted. (Looping\n // melodies never stop on their own, they only\n // get unregistered via stop().)\n if (this._player == p) {\n this.unregisterMelody();\n }\n break\n }\n }\n })\n }\n\n /**\n * Start playing a sound in a loop and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/loop\n //% blockId=mixer_loop_sound block=\"loop sound %sound\"\n //% parts=\"headphone\"\n //% weight=93 blockGap=8\n //% group=\"Sounds\"\n loop(volume = 255) {\n this.playCore(volume, true)\n }\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/play\n //% blockId=mixer_play_sound block=\"play sound %sound\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% group=\"Sounds\"\n play(volume = 255) {\n this.playCore(volume, false)\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * @param sound the melody to play\n */\n //% help=music/melody/play-until-done\n //% blockId=mixer_play_sound_until_done block=\"play sound %sound|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% group=\"Sounds\"\n playUntilDone(volume = 255) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this._player.onPlayFinished = () => {\n if (p == this._player)\n this.unregisterMelody();\n }\n this.registerMelody();\n this._player.play(volume)\n }\n\n toString() {\n return this._text;\n }\n }\n\n function addNote(sndInstr: Buffer, sndInstrPtr: number, ms: number, beg: number, end: number, soundWave: number, hz: number, volume: number, endHz: number) {\n if (ms > 0) {\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, soundWave)\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr + 1, 0)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 2, hz)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 4, ms)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 6, (beg * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 8, (end * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 10, endHz);\n sndInstrPtr += BUFFER_SIZE;\n }\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, 0) // terminate\n return sndInstrPtr\n }\n\n\n export class MelodyPlayer {\n melody: Melody;\n\n onPlayFinished: () => void;\n\n constructor(m: Melody) {\n this.melody = m\n }\n\n stop() {\n this.melody = null\n }\n\n protected queuePlayInstructions(timeDelta: number, buf: Buffer) {\n queuePlayInstructions(timeDelta, buf)\n }\n\n play(volume: number) {\n if (!this.melody)\n return\n volume = Math.clamp(0, 255, (volume * music.volume()) >> 8)\n\n let notes = this.melody._text\n let pos = 0;\n let duration = 4; //Default duration (Crotchet)\n let octave = 4; //Middle octave\n let tempo = 120; // default tempo\n\n let hz = 0\n let endHz = -1\n let ms = 0\n let timePos = 0\n let startTime = control.millis()\n let now = 0\n\n let envA = 0\n let envD = 0\n let envS = 255\n let envR = 0\n let soundWave = 1 // triangle\n let sndInstr = control.createBuffer(5 * BUFFER_SIZE)\n let sndInstrPtr = 0\n\n const addForm = (formDuration: number, beg: number, end: number, msOff: number) => {\n let freqStart = hz;\n let freqEnd = endHz;\n\n const envelopeWidth = ms > 0 ? ms : duration * Math.idiv(15000, tempo) + envR;\n if (endHz != hz && envelopeWidth != 0) {\n const slope = (freqEnd - freqStart) / envelopeWidth;\n freqStart = hz + slope * msOff;\n freqEnd = hz + slope * (msOff + formDuration);\n }\n sndInstrPtr = addNote(sndInstr, sndInstrPtr, formDuration, beg, end, soundWave, freqStart, volume, freqEnd);\n }\n\n const scanNextWord = () => {\n if (!this.melody)\n return \"\"\n\n // eat space\n while (pos < notes.length) {\n const c = notes[pos];\n if (c != ' ' && c != '\\r' && c != '\\n' && c != '\\t')\n break;\n pos++;\n }\n\n // read note\n let note = \"\";\n while (pos < notes.length) {\n const c = notes[pos];\n if (c == ' ' || c == '\\r' || c == '\\n' || c == '\\t')\n break;\n note += c;\n pos++;\n }\n return note;\n }\n\n enum Token {\n Note,\n Octave,\n Beat,\n Tempo,\n Hz,\n EndHz,\n Ms,\n WaveForm,\n EnvelopeA,\n EnvelopeD,\n EnvelopeS,\n EnvelopeR\n }\n\n let token: string = \"\";\n let tokenKind = Token.Note;\n\n // [ABCDEFG] (\\d+) (:\\d+) (-\\d+)\n // note octave length tempo\n // R (:\\d+) - rest\n // !\\d+,\\d+ - sound at frequency with given length (Hz,ms); !\\d+ and !\\d+,:\\d+ also possible\n // @\\d+,\\d+,\\d+,\\d+ - ADSR envelope - ms,ms,volume,ms; volume is 0-255\n // ~\\d+ - wave form:\n // 1 - triangle\n // 2 - sawtooth\n // 3 - sine\n // 4 - pseudorandom square wave noise (tunable)\n // 5 - white noise (ignores frequency)\n // 11 - square 10%\n // 12 - square 20%\n // ...\n // 15 - square 50%\n // 16 - filtered square wave, cycle length 16\n // 17 - filtered square wave, cycle length 32\n // 18 - filtered square wave, cycle length 64\n\n const consumeToken = () => {\n if (token && tokenKind != Token.Note) {\n const d = parseInt(token);\n switch (tokenKind) {\n case Token.Octave: octave = d; break;\n case Token.Beat:\n duration = Math.max(1, Math.min(16, d));\n ms = -1;\n break;\n case Token.Tempo: tempo = Math.max(1, d); break;\n case Token.Hz: hz = d; tokenKind = Token.Ms; break;\n case Token.Ms: ms = d; break;\n case Token.WaveForm: soundWave = Math.clamp(1, 18, d); break;\n case Token.EnvelopeA: envA = d; tokenKind = Token.EnvelopeD; break;\n case Token.EnvelopeD: envD = d; tokenKind = Token.EnvelopeS; break;\n case Token.EnvelopeS: envS = Math.clamp(0, 255, d); tokenKind = Token.EnvelopeR; break;\n case Token.EnvelopeR: envR = d; break;\n case Token.EndHz: endHz = d; break;\n }\n token = \"\";\n }\n }\n\n while (true) {\n let currNote = scanNextWord();\n let prevNote: boolean = false;\n if (!currNote) {\n let timeLeft = timePos - now\n if (timeLeft > 0)\n pause(timeLeft)\n if (this.onPlayFinished)\n this.onPlayFinished();\n return;\n }\n\n hz = -1;\n\n let note: number = 0;\n token = \"\";\n tokenKind = Token.Note;\n\n for (let i = 0; i < currNote.length; i++) {\n let noteChar = currNote.charAt(i);\n switch (noteChar) {\n case 'c': case 'C': note = 1; prevNote = true; break;\n case 'd': case 'D': note = 3; prevNote = true; break;\n case 'e': case 'E': note = 5; prevNote = true; break;\n case 'f': case 'F': note = 6; prevNote = true; break;\n case 'g': case 'G': note = 8; prevNote = true; break;\n case 'a': case 'A': note = 10; prevNote = true; break;\n case 'B': note = 12; prevNote = true; break;\n case 'r': case 'R': hz = 0; prevNote = false; break;\n case '#': note++; prevNote = false; break;\n case 'b': if (prevNote) note--; else { note = 12; prevNote = true; } break;\n case ',':\n consumeToken();\n prevNote = false;\n break;\n case '!':\n tokenKind = Token.Hz;\n prevNote = false;\n break;\n case '@':\n consumeToken();\n tokenKind = Token.EnvelopeA;\n prevNote = false;\n break;\n case '~':\n consumeToken();\n tokenKind = Token.WaveForm;\n prevNote = false;\n break;\n case ':':\n consumeToken();\n tokenKind = Token.Beat;\n prevNote = false;\n break;\n case '-':\n consumeToken();\n tokenKind = Token.Tempo;\n prevNote = false;\n break;\n case '^':\n consumeToken();\n tokenKind = Token.EndHz;\n break;\n default:\n if (tokenKind == Token.Note)\n tokenKind = Token.Octave;\n token += noteChar;\n prevNote = false;\n break;\n }\n }\n consumeToken();\n\n if (note && hz < 0) {\n const keyNumber = note + (12 * (octave - 1));\n hz = freqs.getNumber(NumberFormat.UInt16LE, keyNumber * 2) || 0;\n }\n\n let currMs = ms\n\n if (currMs <= 0) {\n const beat = Math.idiv(15000, tempo);\n currMs = duration * beat\n }\n\n if (hz < 0) {\n // no frequency specified, so no duration\n } else if (hz == 0) {\n timePos += currMs\n } else {\n if (endHz < 0) {\n endHz = hz;\n }\n\n sndInstrPtr = 0\n addForm(envA, 0, 255, 0)\n addForm(envD, 255, envS, envA)\n addForm(currMs - (envA + envD), envS, envS, envD + envA)\n addForm(envR, envS, 0, currMs)\n\n this.queuePlayInstructions(timePos - now, sndInstr.slice(0, sndInstrPtr))\n endHz = -1;\n timePos += currMs // don't add envR - it's supposed overlap next sound\n }\n\n let timeLeft = timePos - now\n if (timeLeft > 200) {\n pause(timeLeft - 100)\n now = control.millis() - startTime\n }\n }\n }\n }\n\n //% fixedInstance whenUsed block=\"ba ding\"\n export const baDing = new Melody('b5:1 e6:3')\n\n //% fixedInstance whenUsed block=\"wawawawaa\"\n export const wawawawaa = new Melody('~15 e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8')\n\n //% fixedInstance whenUsed block=\"jump up\"\n export const jumpUp = new Melody('c5:1 d e f g')\n\n //% fixedInstance whenUsed block=\"jump down\"\n export const jumpDown = new Melody('g5:1 f e d c')\n\n //% fixedInstance whenUsed block=\"power up\"\n export const powerUp = new Melody('g4:1 c5 e g:2 e:1 g:3')\n\n //% fixedInstance whenUsed block=\"power down\"\n export const powerDown = new Melody('g5:1 d# c g4:2 b:1 c5:3')\n\n //% fixedInstance whenUsed block=\"magic wand\"\n export const magicWand = new Melody('F#6:1-300 G# A# B C7# D# F F# G# A# B:6')\n //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n\n //% fixedInstance whenUsed block=\"siren\"\n export const siren = new Melody('a4 d5 a4 d5 a4 d5')\n\n //% fixedInstance whenUsed block=\"pew pew\"\n export const pewPew = new Melody('!1200,200^50')\n\n //% fixedInstance whenUsed block=\"knock\"\n export const knock = new Melody('~4 @0,0,255,150 !300,1 !211,1')\n\n //% fixedInstance whenUsed block=\"footstep\"\n export const footstep = new Melody('~4 @0,0,60,50 !200,1')\n\n //% fixedInstance whenUsed block=\"thump\"\n export const thump = new Melody('~4 @0,0,255,150 !100,1')\n\n //% fixedInstance whenUsed block=\"small crash\"\n export const smallCrash = new Melody('~4 @10,490,0,1 !800,1')\n\n //% fixedInstance whenUsed block=\"big crash\"\n export const bigCrash = new Melody('~4 @10,990,0,1 !400,1')\n\n //% fixedInstance whenUsed block=\"zapped\"\n export const zapped = new Melody('~16 @10,490,0,0 !1600,500^1')\n\n //% fixedInstance whenUsed block=\"buzzer\"\n export const buzzer = new Melody('~16 @10,0,255,250 !2000,300')\n\n //% fixedInstance whenUsed block=\"sonar\"\n export const sonar = new Melody('~16 @10,1500,0,0 !200,1 !200,1500^190')\n\n //% fixedInstance whenUsed block=\"spooky\"\n export const spooky = new Melody('~16 @700,1300,0,0 !100,1 ~18 !108,2000')\n\n //% fixedInstance whenUsed block=\"beam up\"\n export const beamUp = new Melody('~18 @10,1500,0,0 !200,1500^4000')\n}\n",
"music.ts": "enum Note {\n //% blockIdentity=music.noteFrequency enumval=262\n C = 262,\n //% block=C#\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F = 349,\n //% block=F#\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G = 392,\n //% block=G#\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B = 494,\n //% blockIdentity=music.noteFrequency enumval=131\n C3 = 131,\n //% block=C#3\n //% blockIdentity=music.noteFrequency enumval=139\n CSharp3 = 139,\n //% blockIdentity=music.noteFrequency enumval=147\n D3 = 147,\n //% blockIdentity=music.noteFrequency enumval=156\n Eb3 = 156,\n //% blockIdentity=music.noteFrequency enumval=165\n E3 = 165,\n //% blockIdentity=music.noteFrequency enumval=175\n F3 = 175,\n //% block=F#3\n //% blockIdentity=music.noteFrequency enumval=185\n FSharp3 = 185,\n //% blockIdentity=music.noteFrequency enumval=196\n G3 = 196,\n //% block=G#3\n //% blockIdentity=music.noteFrequency enumval=208\n GSharp3 = 208,\n //% blockIdentity=music.noteFrequency enumval=220\n A3 = 220,\n //% blockIdentity=music.noteFrequency enumval=233\n Bb3 = 233,\n //% blockIdentity=music.noteFrequency enumval=247\n B3 = 247,\n //% blockIdentity=music.noteFrequency enumval=262\n C4 = 262,\n //% block=C#4\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp4 = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D4 = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb4 = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E4 = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F4 = 349,\n //% block=F#4\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp4 = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G4 = 392,\n //% block=G#4\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp4 = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A4 = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb4 = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B4 = 494,\n //% blockIdentity=music.noteFrequency enumval=523\n C5 = 523,\n //% block=C#5\n //% blockIdentity=music.noteFrequency enumval=555\n CSharp5 = 555,\n //% blockIdentity=music.noteFrequency enumval=587\n D5 = 587,\n //% blockIdentity=music.noteFrequency enumval=622\n Eb5 = 622,\n //% blockIdentity=music.noteFrequency enumval=659\n E5 = 659,\n //% blockIdentity=music.noteFrequency enumval=698\n F5 = 698,\n //% block=F#5\n //% blockIdentity=music.noteFrequency enumval=740\n FSharp5 = 740,\n //% blockIdentity=music.noteFrequency enumval=784\n G5 = 784,\n //% block=G#5\n //% blockIdentity=music.noteFrequency enumval=831\n GSharp5 = 831,\n //% blockIdentity=music.noteFrequency enumval=880\n A5 = 880,\n //% blockIdentity=music.noteFrequency enumval=932\n Bb5 = 932,\n //% blockIdentity=music.noteFrequency enumval=988\n B5 = 988,\n}\n\nenum BeatFraction {\n //% block=1\n Whole = 1,\n //% block=\"1/2\"\n Half = 2,\n //% block=\"1/4\"\n Quarter = 4,\n //% block=\"1/8\"\n Eighth = 8,\n //% block=\"1/16\"\n Sixteenth = 16,\n //% block=\"2\"\n Double = 32,\n //% block=\"4\",\n Breve = 64,\n //% block=\"1/3\",\n Triplet = 128\n}\n\nnamespace music {\n\n let beatsPerMinute: number;\n\n /**\n * Play a tone.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n */\n //% help=music/ring-tone\n //% blockId=music_ring block=\"ring tone|at %note=device_note\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music inBasicCategory=true\n //% weight=75 blockGap=8\n //% group=\"Tone\"\n export function ringTone(frequency: number) {\n playTone(frequency, 0);\n }\n\n /**\n * Rest, or play silence, for some time (in milliseconds).\n * @param ms rest duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/rest\n //% blockId=music_rest block=\"rest|for %duration=device_beat\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music\n //% weight=74\n //% group=\"Tone\"\n export function rest(ms: number) {\n playTone(0, Math.max(ms, 20));\n }\n\n function init() {\n if (!beatsPerMinute) beatsPerMinute = 120;\n }\n\n /**\n * Return the duration of a beat in milliseconds (the beat fraction).\n * @param fraction the fraction of the current whole note, eg: BeatFraction.Half\n */\n //% help=music/beat\n //% blockId=device_beat block=\"%fraction|beat\"\n //% weight=9 blockGap=8\n //% group=\"Tempo\"\n export function beat(fraction?: BeatFraction): number {\n init();\n if (fraction == null) fraction = BeatFraction.Whole;\n let beat = 60000 / beatsPerMinute;\n switch (fraction) {\n case BeatFraction.Half: beat /= 2; break;\n case BeatFraction.Quarter: beat /= 4; break;\n case BeatFraction.Eighth: beat /= 8; break;\n case BeatFraction.Sixteenth: beat /= 16; break;\n case BeatFraction.Double: beat *= 2; break;\n case BeatFraction.Breve: beat *= 4; break;\n case BeatFraction.Triplet: beat /= 3; break;\n }\n return beat >> 0;\n }\n\n /**\n * Return the tempo in beats per minute (bpm).\n * Tempo is the speed (bpm = beats per minute) at which notes play. The larger the tempo value, the faster the notes will play.\n */\n //% help=music/tempo\n //% blockId=device_tempo block=\"tempo (bpm)\"\n //% weight=64\n //% group=\"Tempo\"\n export function tempo(): number {\n init();\n return beatsPerMinute;\n }\n\n /**\n * Change the tempo up or down by some amount of beats per minute (bpm).\n * @param bpm The change in beats per minute to the tempo, eg: 20\n */\n //% help=music/change-tempo-by weight=37\n //% blockId=device_change_tempo block=\"change tempo by %value|(bpm)\"\n //% weight=66 blockGap=8\n //% group=\"Tempo\"\n export function changeTempoBy(bpm: number): void {\n init();\n setTempo(beatsPerMinute + bpm);\n }\n\n /**\n * Set the tempo a number of beats per minute (bpm).\n * @param bpm The new tempo in beats per minute, eg: 120\n */\n //% help=music/set-tempo\n //% blockId=device_set_tempo block=\"set tempo to %value|(bpm)\"\n //% bpm.min=4 bpm.max=400\n //% weight=65 blockGap=8\n //% group=\"Tempo\"\n export function setTempo(bpm: number): void {\n init();\n if (bpm > 0) {\n beatsPerMinute = Math.max(1, bpm >> 0);\n }\n }\n}\n",
"ns.ts": "\n/**\n * Generation of music tones.\n */\n//% color=#E30FC0 weight=90 icon=\"\\uf025\"\n//% blockGap=8\n//% groups='[\"Sounds\", \"Melody\", \"Tone\", \"Volume\", \"Tempo\"]'\nnamespace music {\n}",
"piano.ts": "namespace music {\n /**\n * Get the frequency of a note.\n * @param name the note name, eg: Note.C\n */\n //% weight=1 help=music/note-frequency\n //% blockId=device_note block=\"%note\"\n //% shim=TD_ID\n //% color=\"#FFFFFF\" colorSecondary=\"#FFFFFF\" colorTertiary=\"#D83B01\"\n //% note.fieldEditor=\"note\" note.defl=\"262\"\n //% note.fieldOptions.decompileLiterals=true\n //% useEnumVal=1\n //% weight=10 blockGap=8\n //% group=\"Tone\"\n export function noteFrequency(name: Note): number {\n return name;\n }\n}",
"pxt.json": "{\n \"name\": \"mixer---samd\",\n \"description\": \"The music library with a mixer\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"SoundOutput.h\",\n \"sound.cpp\",\n \"melody.h\",\n \"melody.cpp\",\n \"melody.ts\",\n \"piano.ts\",\n \"legacy.ts\",\n \"ns.ts\",\n \"targetoverrides.ts\",\n \"music.ts\",\n \"pxtparts.json\",\n \"headphone.svg\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"pxtparts.json": "{\n \"headphone\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"image\": \"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\": \"A0\",\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}",
"sound.cpp": "// to be overridden\n",
"targetoverrides.ts": "\n",
"test.ts": "for(let i = 1000; i > 0; i -= 50)\n music.playTone(440, i)\n\nfor(let i = 0; i < 1000; i += 20)\n music.playTone(440, i)\n"
},
"mixer---stm32": {
"SoundOutput.h": "#include \"ZPWM.h\"\n#include \"Synthesizer.h\"\n#include \"Mixer.h\"\n\nnamespace jacdac {\nvoid setJackRouterOutput(int output);\n}\n\nclass SoundOutput {\n public:\n ZPWM dac;\n\n SoundOutput(DataSource &data) : dac(*LOOKUP_PIN(JACK_SND), data) {\n jacdac::setJackRouterOutput(-1);\n }\n\n void setOutput(int output) { jacdac::setJackRouterOutput(output); }\n};\n",
"headphone.svg": "",
"legacy.ts": "//% deprecated=true hidden=true\nenum Sounds {\n //% block=\"power up\"\n PowerUp,\n //% block=\"power down\"\n PowerDown,\n //% block=\"jump up\"\n JumpUp,\n //% block=\"jump down\"\n JumpDown,\n //% block=\"ba ding\"\n BaDing,\n //% block=\"wawawawaa\"\n Wawawawaa,\n //% block=\"magic wand\"\n MagicWand,\n //% block=\"siren\"\n Siren\n}\n\nnamespace music {\n /**\n * Get the melody string for a built-in melody.\n * @param name the note name, eg: Note.C\n */\n //% help=music/sounds\n //% blockId=music_sounds block=\"%name\"\n //% blockHidden=true\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=285\n //% name.fieldOptions.columns=3\n export function sounds(name: Sounds): string {\n switch (name) {\n case Sounds.BaDing:\n return 'b5:1 e6:3';\n case Sounds.Wawawawaa:\n return 'e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8';\n case Sounds.JumpUp:\n return 'c5:1 d e f g';\n case Sounds.JumpDown:\n return 'g5:1 f e d c';\n case Sounds.PowerUp:\n return 'g4:1 c5 e g:2 e:1 g:3';\n case Sounds.PowerDown:\n return 'g5:1 d# c g4:2 b:1 c5:3';\n case Sounds.MagicWand:\n return 'F#6:1-300 G# A# B C7# D# F F# G# A# B:6'; //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n case Sounds.Siren:\n return 'a4 d5 a4 d5 a4 d5';\n default:\n return '';\n }\n }\n\n let currMelody: Melody\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound\n //% blockId=music_play_sound block=\"play sound %sound=music_sounds\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% deprecated=true hidden=true\n export function playSound(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.play();\n pause(1);\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound-until-done\n //% blockId=music_play_sound_until_done block=\"play sound %sound=music_sounds|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% deprecated=true hidden=true\n export function playSoundUntilDone(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.playUntilDone();\n }\n}",
"melody.cpp": "#include \"pxt.h\"\n#include \"SoundOutput.h\"\n#include \"melody.h\"\n\n//#define LOG DMESG\n#define LOG NOLOG\n\nnamespace music {\n\nSINGLETON(WSynthesizer);\n\n// Tone generator arguments:\n//\n// sound: a pointer to the currently-playing sound, usable for looking up the\n// waveform or generator-specific state.\n//\n// position: offset within the currently-playing wave, range 0..1023.\n//\n// cycle: a 6-bit cyclical sequence number of the wave, incremented each time\n// the position loops from 1023 back to 0.\ntypedef int (*gentone_t)(PlayingSound *sound, uint32_t position, uint8_t cycle);\n\nstatic int noiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)position;\n (void)cycle;\n // see https://en.wikipedia.org/wiki/Xorshift\n static uint32_t x = 0xf01ba80;\n x ^= x << 13;\n x ^= x >> 17;\n x ^= x << 5;\n return (x & 0xffff) - 0x7fff;\n}\n\nstatic int sineTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n int32_t p = position;\n if (p >= 512) {\n p -= 512;\n }\n if (p > 256) {\n p = 512 - p;\n }\n\n // Approximate sin(x * pi / 2) with the odd polynomial y = cx^5 + bx^3 + ax\n // using the constraint y(1) = 1 => a = 1 - b - c\n // => y = c x^5 + b x^3 + (1 - b - c) * x\n //\n // Do a least-squares fit of this to sin(x * pi / 2) in the range 0..1\n // inclusive, using 21 evenly spaced points. Resulting approximation:\n //\n // sin(x*pi/2) ~= 0.0721435357258*x**5 - 0.642443736562*x**3 + 1.57030020084*x\n\n // Scale the constants by 32767 to match the desired output range.\n constexpr int32_t c = 0.0721435357258 * 32767;\n constexpr int32_t b = -0.642443736562 * 32767;\n constexpr int32_t a = 1.57030020084 * 32767;\n\n // Calculate using y = ((c * x^2 + b) * x^2 + a) * x\n //\n // The position p is x * 256, so after each multiply with p we need to\n // shift right by 8 bits to keep the decimal point in the same place. (The\n // approximation has a negative error near x=1 which helps avoid overflow.)\n int32_t p2 = p * p;\n int32_t u = (c * p2 >> 16) + b;\n int32_t v = (u * p2 >> 16) + a;\n int32_t w = v * p >> 8;\n\n // The result is within 7/32767 or 0.02%, signal-to-error ratio about 38 dB.\n return position >= 512 ? -w : w;\n}\n\nstatic int sawtoothTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n return (position << 6) - 0x7fff;\n}\n\nstatic int triangleTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n return position < 512 ? (position << 7) - 0x7fff : ((1023 - position) << 7) - 0x7fff;\n}\n\nstatic int squareWaveTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)cycle;\n uint8_t wave = sound->currInstr->soundWave;\n return (int)position < (102 * (wave - SW_SQUARE_10 + 1)) ? -0x7fff : 0x7fff;\n}\n\nstatic int tunedNoiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a random bit sequence. Since the generator\n // is called multiple times per wave, use PlayingSound state data to ensure we\n // only generate a random bit once per wave, and then reuse it for future\n // calls for that wave.\n //\n // Use the low 6 bits of generatorState to store the last-used cycle, and\n // random_bit to store the last on/off state. (random_bit is arbitrary as\n // long as it isn't one of the low 6 bits.)\n constexpr uint32_t random_bit = 0x8000;\n static uint32_t x = 0xf01ba80; // seed for the static RNG state\n uint8_t prev_cycle = sound->generatorState & 0x3f;\n uint32_t is_on;\n if (cycle == prev_cycle) {\n is_on = sound->generatorState & random_bit;\n } else {\n // see https://en.wikipedia.org/wiki/Xorshift\n x ^= x << 13;\n x ^= x >> 17;\n x ^= x << 5;\n is_on = (x & random_bit);\n sound->generatorState = (cycle & 0x3f) | is_on;\n }\n if (!is_on)\n return 0;\n return position < 512 ? -0x7fff : 0x7fff;\n}\n\n// Bit patterns for use by the cyclic noise tone.\n//\n// The bit pattern is arbitrary, but should have equal numbers of 0 and 1 bits,\n// and should avoid long identical-bit runs for the lower parts. The values below\n// were chosen based on a random permutation of the hex nibbles 0..f and then\n// hand-tweaked by swapping some nibbles. Generated by:\n//\n// shuf -i 0-15 | perl -ne 's/(\\d+)/printf(\"%x\",$1)/e'\nstatic const uint32_t cycle_bits[] = {0x2df0eb47, 0xc8165a93};\nstatic const uint8_t cycle_mask[] = {0xf, 0x1f, 0x3f};\n\nstatic int cycleNoiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a short-cycle pseudorandom bit sequence.\n // The bit sequence repeats every 16/32/64 waves.\n //\n // The \"cycle\" argument corresponds to the sequential number of the generated\n // wave. This is currently a 6-bit value. Since the pseudorandom bit sequences\n // evenly fit into this, there's no need to track generator state.\n uint8_t wave = sound->currInstr->soundWave;\n int cycle_index = wave - SW_SQUARE_CYCLE_16;\n // CLAMP(0, cycle_index, sizeof cycle_bits / sizeof cycle_bits[0])\n cycle &= cycle_mask[cycle_index];\n bool is_on = (cycle_bits[cycle >> 5] & (1U << (cycle & 0x1f)));\n if (!is_on)\n return 0;\n return position < 512 ? -0x7fff : 0x7fff;\n}\n\nstatic int silenceTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a short-cycle pseudorandom bit sequence.\n (void)sound;\n (void)position;\n (void)cycle;\n return 0;\n}\n\nstatic gentone_t getWaveFn(uint8_t wave) {\n switch (wave) {\n case SW_TRIANGLE:\n return triangleTone;\n case SW_SAWTOOTH:\n return sawtoothTone;\n case SW_TUNEDNOISE:\n return tunedNoiseTone;\n case SW_NOISE:\n return noiseTone;\n case SW_SINE:\n return sineTone;\n default:\n if (SW_SQUARE_10 <= wave && wave <= SW_SQUARE_50)\n return squareWaveTone;\n if (SW_SQUARE_CYCLE_16 <= wave && wave <= SW_SQUARE_CYCLE_64)\n return cycleNoiseTone;\n else\n return silenceTone;\n }\n}\n\n#define CLAMP(lo, v, hi) ((v) = ((v) < (lo) ? (lo) : (v) > (hi) ? (hi) : (v)))\n\nint WSynthesizer::updateQueues() {\n const int maxTime = 0xffffff;\n while (1) {\n WaitingSound *p;\n int minLeft = maxTime;\n for (p = waiting; p; p = p->next) {\n int timeLeft =\n p->state == SoundState::Waiting ? p->startSampleNo - currSample : maxTime;\n if (timeLeft <= 0) {\n break;\n }\n if (timeLeft < minLeft)\n minLeft = timeLeft;\n }\n if (p) {\n PlayingSound *snd;\n int minIdx = -1;\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n snd = &playingSounds[i];\n if (snd->sound == NULL)\n break;\n if (minIdx == -1 ||\n playingSounds[minIdx].startSampleNo < playingSounds[i].startSampleNo)\n minIdx = i;\n snd = NULL;\n }\n // if we didn't find a free slot, expel the oldest sound\n if (!snd)\n snd = &playingSounds[minIdx];\n if (snd->sound)\n snd->sound->state = SoundState::Done;\n snd->sound = p;\n p->state = SoundState::Playing;\n snd->startSampleNo = currSample;\n snd->currInstr = (SoundInstruction *)p->instructions->data;\n snd->instrEnd = snd->currInstr + p->instructions->length / sizeof(SoundInstruction);\n snd->prevVolume = -1;\n } else {\n // no more sounds to move\n return minLeft;\n }\n }\n}\n\nint WSynthesizer::fillSamples(int16_t *dst, int numsamples) {\n if (numsamples <= 0)\n return 1;\n\n int timeLeft = updateQueues();\n int res = waiting != NULL;\n\n // if there's a pending sound to be started somewhere during numsamples,\n // split the call into two\n if (timeLeft < numsamples) {\n fillSamples(dst, timeLeft);\n LOG(\"M split %d\", timeLeft);\n fillSamples(dst + timeLeft, numsamples - timeLeft);\n return 1;\n }\n\n memset(dst, 0, numsamples * 2);\n\n uint32_t samplesPerMS = (sampleRate << 8) / 1000;\n float toneStepMult = (1024.0 * (1 << 16)) / sampleRate;\n const int MAXVAL = (1 << (OUTPUT_BITS - 1)) - 1;\n\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n PlayingSound *snd = &playingSounds[i];\n if (snd->sound == NULL)\n continue;\n\n res = 1;\n\n SoundInstruction *instr = NULL;\n gentone_t fn = NULL;\n snd->currInstr--;\n uint32_t toneStep = 0;\n int32_t toneDelta = 0;\n int32_t volumeStep = 0;\n uint32_t tonePosition = snd->tonePosition;\n uint32_t samplesLeft = 0;\n uint8_t wave = 0;\n int32_t volume = 0;\n\n for (int j = 0; j < numsamples; ++j) {\n if (samplesLeft == 0) {\n snd->currInstr++;\n if (snd->currInstr >= snd->instrEnd) {\n break;\n }\n SoundInstruction copy = *snd->currInstr;\n instr = ©\n CLAMP(20, instr->frequency, 20000);\n CLAMP(20, instr->endFrequency, 20000);\n CLAMP(0, instr->startVolume, 1023);\n CLAMP(0, instr->endVolume, 1023);\n CLAMP(1, instr->duration, 60000);\n\n wave = instr->soundWave;\n fn = getWaveFn(wave);\n\n samplesLeft = (uint32_t)(instr->duration * samplesPerMS >> 8);\n // make sure the division is signed\n volumeStep =\n (int)((instr->endVolume - instr->startVolume) << 16) / (int)samplesLeft;\n\n if (j == 0 && snd->prevVolume != -1) {\n // restore previous state\n samplesLeft = snd->samplesLeftInCurr;\n volume = snd->prevVolume;\n toneStep = snd->prevToneStep;\n toneDelta = snd->prevToneDelta;\n } else {\n LOG(\"#sampl %d %p\", samplesLeft, snd->currInstr);\n volume = instr->startVolume << 16;\n LOG(\"%d-%dHz %d-%d vol\", instr->frequency, instr->endFrequency,\n instr->startVolume, instr->endVolume);\n toneStep = (uint32_t)(toneStepMult * instr->frequency);\n if (instr->frequency != instr->endFrequency) {\n uint32_t endToneStep = (uint32_t)(toneStepMult * instr->endFrequency);\n toneDelta = (int32_t)(endToneStep - toneStep) / (int32_t)samplesLeft;\n } else {\n toneDelta = 0;\n }\n }\n }\n\n int v = fn(snd, (tonePosition >> 16) & 1023, tonePosition >> 26);\n v = (v * (volume >> 16)) >> (10 + (16 - OUTPUT_BITS));\n\n // if (v > MAXVAL)\n // target_panic(123);\n\n dst[j] += v;\n\n tonePosition += toneStep;\n toneStep += toneDelta;\n volume += volumeStep;\n samplesLeft--;\n }\n\n if (snd->currInstr >= snd->instrEnd) {\n snd->sound->state = SoundState::Done;\n snd->sound = NULL;\n } else {\n snd->tonePosition = tonePosition;\n if (samplesLeft == 0)\n samplesLeft++; // avoid infinite loop in next iteration\n snd->samplesLeftInCurr = samplesLeft;\n snd->prevVolume = volume;\n snd->prevToneDelta = toneDelta;\n snd->prevToneStep = toneStep;\n }\n }\n\n currSample += numsamples;\n\n for (int j = 0; j < numsamples; ++j) {\n if (dst[j] > MAXVAL)\n dst[j] = MAXVAL;\n else if (dst[j] < -MAXVAL)\n dst[j] = -MAXVAL;\n }\n\n return res;\n}\n\n//%\nvoid enableAmp(int enabled) {\n // this is also compiled on linux\n#ifdef LOOKUP_PIN\n auto pin = LOOKUP_PIN(SPEAKER_AMP);\n if (pin) {\n if (PIN(SPEAKER_AMP) & CFG_PIN_CONFIG_ACTIVE_LO)\n enabled = !enabled;\n pin->setDigitalValue(enabled);\n }\n#endif\n}\n\n//%\nvoid forceOutput(int outp) {\n auto snd = getWSynthesizer();\n snd->out.setOutput(outp);\n}\n\n//%\nvoid queuePlayInstructions(int when, Buffer buf) {\n auto snd = getWSynthesizer();\n\n registerGCObj(buf);\n\n auto p = new WaitingSound;\n p->state = SoundState::Waiting;\n p->instructions = buf;\n p->startSampleNo = snd->currSample + when * snd->sampleRate / 1000;\n\n LOG(\"Queue %dms now=%d off=%d %p sampl:%dHz\", when, snd->currSample,\n p->startSampleNo - snd->currSample, buf->data, snd->sampleRate);\n\n target_disable_irq();\n // add new sound to queue\n p->next = snd->waiting;\n snd->waiting = p;\n // remove sounds that have already been fully played\n while (p) {\n while (p->next && p->next->state == SoundState::Done) {\n auto todel = p->next;\n p->next = todel->next;\n unregisterGCObj(todel->instructions);\n delete todel;\n }\n p = p->next;\n }\n target_enable_irq();\n\n snd->poke();\n}\n\n//%\nvoid stopPlaying() {\n LOG(\"stop playing!\");\n\n auto snd = getWSynthesizer();\n\n target_disable_irq();\n auto p = snd->waiting;\n snd->waiting = NULL;\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n snd->playingSounds[i].sound = NULL;\n }\n while (p) {\n auto n = p->next;\n unregisterGCObj(p->instructions);\n delete p;\n p = n;\n }\n target_enable_irq();\n}\n\nWSynthesizer::WSynthesizer() : upstream(NULL), out(*this) {\n currSample = 0;\n active = false;\n sampleRate = out.dac.getSampleRate();\n memset(&playingSounds, 0, sizeof(playingSounds));\n waiting = NULL;\n PXT_REGISTER_RESET(stopPlaying);\n}\n\n} // namespace music\n\nnamespace pxt {\nint redirectSamples(int16_t *dst, int numsamples, int samplerate) {\n auto snd = music::getWSynthesizer();\n snd->upstream = NULL; // disconnect from regular playback mechanism\n snd->sampleRate = samplerate;\n return snd->fillSamples(dst, numsamples);\n}\n\n} // namespace pxt\n\nnamespace jacdac {\n__attribute__((weak)) void setJackRouterOutput(int output) {}\n} // namespace jacdac\n",
"melody.h": "#pragma once\n\n#ifndef OUTPUT_BITS\n#define OUTPUT_BITS 10\n#endif\n\n#define SW_TRIANGLE 1\n#define SW_SAWTOOTH 2\n#define SW_SINE 3\n#define SW_TUNEDNOISE 4\n#define SW_NOISE 5\n#define SW_SQUARE_10 11\n#define SW_SQUARE_50 15\n#define SW_SQUARE_CYCLE_16 16\n#define SW_SQUARE_CYCLE_32 17\n#define SW_SQUARE_CYCLE_64 18\n\nstruct SoundInstruction {\n uint8_t soundWave;\n uint8_t flags;\n uint16_t frequency; // Hz\n uint16_t duration; // ms\n int16_t startVolume; // 0-1023\n int16_t endVolume; // 0-1023\n uint16_t endFrequency; // Hz\n};\n\n#ifdef DATASTREAM_MAXIMUM_BUFFERS\n#define CODAL 1\n#endif\n\nnamespace music {\n\n#define MAX_SOUNDS 5\n\nSTATIC_ASSERT((1 << (16 - OUTPUT_BITS)) > MAX_SOUNDS);\n\nenum class SoundState : uint8_t {\n Waiting, //\n Playing, //\n Done //\n};\n\nstruct WaitingSound {\n uint32_t startSampleNo;\n SoundState state;\n WaitingSound *next;\n Buffer instructions;\n};\n\nstruct PlayingSound {\n uint32_t startSampleNo;\n uint32_t samplesLeftInCurr;\n uint32_t tonePosition;\n int32_t prevVolume;\n uint32_t prevToneStep;\n int32_t prevToneDelta;\n uint32_t generatorState;\n WaitingSound *sound;\n SoundInstruction *currInstr, *instrEnd;\n};\n\nclass WSynthesizer\n#ifdef CODAL\n : public DataSource\n#endif\n{\n public:\n#ifdef CODAL\n DataSink *upstream;\n#else\n void *upstream;\n#endif\n uint32_t currSample; // after 25h of playing we might get a glitch\n int32_t sampleRate; // eg 44100\n PlayingSound playingSounds[MAX_SOUNDS];\n WaitingSound *waiting;\n bool active;\n\n SoundOutput out;\n\n int fillSamples(int16_t *dst, int numsamples);\n int updateQueues();\n\n WSynthesizer();\n virtual ~WSynthesizer() {}\n\n void pokeUpstream() {\n#ifdef CODAL\n if (upstream) {\n upstream->pullRequest();\n }\n#endif\n }\n\n void poke() {\n if (!active) {\n active = true;\n pokeUpstream();\n }\n }\n\n#ifdef CODAL\n virtual ManagedBuffer pull() {\n if (!upstream)\n return ManagedBuffer();\n ManagedBuffer data(512);\n auto dp = (int16_t *)data.getBytes();\n auto sz = 512 / 2;\n int r = fillSamples(dp, sz);\n#if defined(NRF52_SERIES)\n int mul = out.dac.getSampleRange();\n#endif\n while (sz--) {\n#if defined(NRF52_SERIES)\n *dp = ((-*dp + (1 << (OUTPUT_BITS - 1))) * mul) >> OUTPUT_BITS;\n#else\n *dp += 1 << (OUTPUT_BITS - 1);\n#endif\n dp++;\n }\n if (!r) {\n active = false;\n // return empty - nothing left to play\n return ManagedBuffer();\n }\n pokeUpstream();\n return data;\n }\n virtual void connect(DataSink &sink) { upstream = &sink; }\n#endif\n};\n\n} // namespace music\n",
"melody.ts": "enum MusicOutput {\n AutoDetect = 0,\n Buzzer = 1,\n HeadPhones = 2,\n}\n\nnamespace music {\n //% whenUsed\n const freqs = hex`\n 1f00210023002500270029002c002e003100340037003a003e004100450049004e00520057005c00620068006e00\n 75007b0083008b0093009c00a500af00b900c400d000dc00e900f70006011501260137014a015d01720188019f01\n b801d201ee010b022a024b026e029302ba02e40210033f037003a403dc03170455049704dd0427057505c8052006\n 7d06e0064907b8072d08a9082d09b9094d0aea0a900b400cfa0cc00d910e6f0f5a1053115b1272139a14d4152017\n 8018f519801b231dde1e`\n\n //% shim=music::queuePlayInstructions\n function queuePlayInstructions(timeDelta: number, buf: Buffer) { }\n\n //% shim=music::stopPlaying\n function stopPlaying() { }\n\n //% shim=music::forceOutput\n export function forceOutput(buf: MusicOutput) { }\n\n let globalVolume: number = null\n\n const BUFFER_SIZE: number = 12;\n\n //% shim=music::enableAmp\n function enableAmp(en: number) {\n return // for sim\n }\n\n function initVolume() {\n if (globalVolume === null) {\n globalVolume = 0\n setVolume(control.getConfigValue(DAL.CFG_SPEAKER_VOLUME, 128))\n }\n }\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 //% parts=\"speaker\"\n //% volume.min=0 volume.max=255\n //% volume.defl=20\n //% help=music/set-volume\n //% weight=70\n //% group=\"Volume\"\n export function setVolume(volume: number): void {\n globalVolume = Math.clamp(0, 255, volume | 0)\n enableAmp(globalVolume > 0 ? 1 : 0)\n }\n\n /**\n * Gets the current volume\n */\n //% parts=\"speaker\"\n //% weight=70\n export function volume(): number {\n initVolume()\n return globalVolume;\n }\n\n function playNoteCore(when: number, frequency: number, ms: number) {\n let buf = control.createBuffer(BUFFER_SIZE)\n addNote(buf, 0, ms, 255, 255, 3, frequency, volume(), frequency)\n queuePlayInstructions(when, buf)\n }\n\n /**\n * Play a tone through the speaker for some amount of time.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n * @param ms tone duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/play-tone\n //% blockId=mixer_play_note block=\"play tone|at %note=device_note|for %duration=device_beat\"\n //% parts=\"headphone\" async\n //% blockNamespace=music\n //% weight=76 blockGap=8\n //% group=\"Tone\"\n export function playTone(frequency: number, ms: number): void {\n if (ms == 0)\n ms = 86400000 // 1 day\n\n if (ms <= 2000) {\n playNoteCore(0, frequency, ms)\n pause(ms)\n } else {\n const id = ++playToneID\n control.runInParallel(() => {\n let pos = control.millis()\n while (id == playToneID && ms > 0) {\n let now = control.millis()\n let d = pos - now\n let t = Math.min(ms, 500)\n ms -= t\n pos += t\n playNoteCore(d - 1, frequency, t)\n if (ms == 0)\n pause(d + t)\n else\n pause(d + t - 100)\n }\n })\n }\n }\n\n let playToneID = 0\n\n /**\n * Play a melody from the melody editor.\n * @param melody - string of up to eight notes [C D E F G A B C5] or rests [-] separated by spaces, \n * which will be played one at a time, ex: \"E D G F B A C5 B \"\n * @param tempo - number in beats per minute (bpm), dictating how long each note will play for\n */\n //% block=\"play melody $melody at tempo $tempo|(bpm)\" blockId=playMelody\n //% blockNamespace=music\n //% weight=85 blockGap=8 help=music/play-melody\n //% group=\"Melody\"\n //% melody.shadow=\"melody_editor\"\n //% tempo.min=40 tempo.max=500\n //% tempo.defl=120\n export function playMelody(melody: string, tempo: number) {\n let notes: string[] = melody.split(\" \").filter(n => !!n);\n let formattedMelody = \"\";\n let newOctave = false;\n\n // build melody string, replace '-' with 'R' and add tempo\n // creates format like \"C5-174 B4 A G F E D C \"\n for (let i = 0; i < notes.length; i++) {\n if (notes[i] === \"-\") {\n notes[i] = \"R\";\n } else if (notes[i] === \"C5\") {\n newOctave = true;\n } else if (newOctave) { // change the octave if necesary\n notes[i] += \"4\";\n newOctave = false;\n }\n // add tempo after first note\n if (i == 0) {\n formattedMelody += notes[i] + \"-\" + tempo + \" \";\n } else {\n formattedMelody += notes[i] + \" \";\n }\n }\n\n const song = new Melody(formattedMelody);\n song.playUntilDone();\n }\n\n\n /**\n * Create a melody with the melody editor.\n * @param melody\n */\n //% block=\"$melody\" blockId=melody_editor\n //% blockNamespace=music\n //% blockHidden = true\n //% weight=85 blockGap=8\n //% help=music/melody-editor\n //% group=\"Melody\" duplicateShadowOnDrag\n //% melody.fieldEditor=\"melody\"\n //% melody.fieldOptions.decompileLiterals=true\n //% melody.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% melody.fieldOptions.onParentBlock=\"true\"\n //% shim=TD_ID\n export function melodyEditor(melody: string): string {\n return melody;\n }\n\n /**\n * Stop all sounds from playing.\n */\n //% help=music/stop-all-sounds\n //% blockId=music_stop_all_sounds block=\"stop all sounds\"\n //% weight=10\n //% group=\"Sounds\"\n export function stopAllSounds() {\n Melody.stopAll();\n stopPlaying();\n }\n\n //% fixedInstances\n export class Melody {\n _text: string;\n private _player: MelodyPlayer;\n\n private static playingMelodies: Melody[];\n\n static stopAll() {\n if (Melody.playingMelodies) {\n const ms = Melody.playingMelodies.slice(0, Melody.playingMelodies.length);\n ms.forEach(p => p.stop());\n }\n }\n\n constructor(text: string) {\n this._text = text\n }\n\n get text() {\n return this._text;\n }\n\n /**\n * Stop playing a sound\n */\n //% blockId=mixer_stop block=\"stop sound %sound\"\n //% help=music/melody/stop\n //% parts=\"headphone\"\n //% weight=92 blockGap=8\n //% group=\"Sounds\"\n stop() {\n if (this._player) {\n this._player.stop()\n this._player = null\n }\n this.unregisterMelody();\n }\n\n private registerMelody() {\n // keep track of the active players\n if (!Melody.playingMelodies) Melody.playingMelodies = [];\n // stop and pop melodies if too many playing\n if (Melody.playingMelodies.length > 4) {\n // stop last player (also pops)\n Melody.playingMelodies[Melody.playingMelodies.length - 1].stop();\n }\n // put back the melody on top of the melody stack\n Melody.playingMelodies.removeElement(this);\n Melody.playingMelodies.push(this);\n }\n private unregisterMelody() {\n // remove from list\n if (Melody.playingMelodies) {\n Melody.playingMelodies.removeElement(this); // remove self\n }\n }\n\n private playCore(volume: number, loop: boolean) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this.registerMelody();\n control.runInParallel(() => {\n while (this._player == p) {\n p.play(volume)\n if (!loop) {\n // Unregister the melody when done playing, but\n // only if it hasn't been restarted. (Looping\n // melodies never stop on their own, they only\n // get unregistered via stop().)\n if (this._player == p) {\n this.unregisterMelody();\n }\n break\n }\n }\n })\n }\n\n /**\n * Start playing a sound in a loop and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/loop\n //% blockId=mixer_loop_sound block=\"loop sound %sound\"\n //% parts=\"headphone\"\n //% weight=93 blockGap=8\n //% group=\"Sounds\"\n loop(volume = 255) {\n this.playCore(volume, true)\n }\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/play\n //% blockId=mixer_play_sound block=\"play sound %sound\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% group=\"Sounds\"\n play(volume = 255) {\n this.playCore(volume, false)\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * @param sound the melody to play\n */\n //% help=music/melody/play-until-done\n //% blockId=mixer_play_sound_until_done block=\"play sound %sound|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% group=\"Sounds\"\n playUntilDone(volume = 255) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this._player.onPlayFinished = () => {\n if (p == this._player)\n this.unregisterMelody();\n }\n this.registerMelody();\n this._player.play(volume)\n }\n\n toString() {\n return this._text;\n }\n }\n\n function addNote(sndInstr: Buffer, sndInstrPtr: number, ms: number, beg: number, end: number, soundWave: number, hz: number, volume: number, endHz: number) {\n if (ms > 0) {\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, soundWave)\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr + 1, 0)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 2, hz)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 4, ms)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 6, (beg * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 8, (end * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 10, endHz);\n sndInstrPtr += BUFFER_SIZE;\n }\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, 0) // terminate\n return sndInstrPtr\n }\n\n\n export class MelodyPlayer {\n melody: Melody;\n\n onPlayFinished: () => void;\n\n constructor(m: Melody) {\n this.melody = m\n }\n\n stop() {\n this.melody = null\n }\n\n protected queuePlayInstructions(timeDelta: number, buf: Buffer) {\n queuePlayInstructions(timeDelta, buf)\n }\n\n play(volume: number) {\n if (!this.melody)\n return\n volume = Math.clamp(0, 255, (volume * music.volume()) >> 8)\n\n let notes = this.melody._text\n let pos = 0;\n let duration = 4; //Default duration (Crotchet)\n let octave = 4; //Middle octave\n let tempo = 120; // default tempo\n\n let hz = 0\n let endHz = -1\n let ms = 0\n let timePos = 0\n let startTime = control.millis()\n let now = 0\n\n let envA = 0\n let envD = 0\n let envS = 255\n let envR = 0\n let soundWave = 1 // triangle\n let sndInstr = control.createBuffer(5 * BUFFER_SIZE)\n let sndInstrPtr = 0\n\n const addForm = (formDuration: number, beg: number, end: number, msOff: number) => {\n let freqStart = hz;\n let freqEnd = endHz;\n\n const envelopeWidth = ms > 0 ? ms : duration * Math.idiv(15000, tempo) + envR;\n if (endHz != hz && envelopeWidth != 0) {\n const slope = (freqEnd - freqStart) / envelopeWidth;\n freqStart = hz + slope * msOff;\n freqEnd = hz + slope * (msOff + formDuration);\n }\n sndInstrPtr = addNote(sndInstr, sndInstrPtr, formDuration, beg, end, soundWave, freqStart, volume, freqEnd);\n }\n\n const scanNextWord = () => {\n if (!this.melody)\n return \"\"\n\n // eat space\n while (pos < notes.length) {\n const c = notes[pos];\n if (c != ' ' && c != '\\r' && c != '\\n' && c != '\\t')\n break;\n pos++;\n }\n\n // read note\n let note = \"\";\n while (pos < notes.length) {\n const c = notes[pos];\n if (c == ' ' || c == '\\r' || c == '\\n' || c == '\\t')\n break;\n note += c;\n pos++;\n }\n return note;\n }\n\n enum Token {\n Note,\n Octave,\n Beat,\n Tempo,\n Hz,\n EndHz,\n Ms,\n WaveForm,\n EnvelopeA,\n EnvelopeD,\n EnvelopeS,\n EnvelopeR\n }\n\n let token: string = \"\";\n let tokenKind = Token.Note;\n\n // [ABCDEFG] (\\d+) (:\\d+) (-\\d+)\n // note octave length tempo\n // R (:\\d+) - rest\n // !\\d+,\\d+ - sound at frequency with given length (Hz,ms); !\\d+ and !\\d+,:\\d+ also possible\n // @\\d+,\\d+,\\d+,\\d+ - ADSR envelope - ms,ms,volume,ms; volume is 0-255\n // ~\\d+ - wave form:\n // 1 - triangle\n // 2 - sawtooth\n // 3 - sine\n // 4 - pseudorandom square wave noise (tunable)\n // 5 - white noise (ignores frequency)\n // 11 - square 10%\n // 12 - square 20%\n // ...\n // 15 - square 50%\n // 16 - filtered square wave, cycle length 16\n // 17 - filtered square wave, cycle length 32\n // 18 - filtered square wave, cycle length 64\n\n const consumeToken = () => {\n if (token && tokenKind != Token.Note) {\n const d = parseInt(token);\n switch (tokenKind) {\n case Token.Octave: octave = d; break;\n case Token.Beat:\n duration = Math.max(1, Math.min(16, d));\n ms = -1;\n break;\n case Token.Tempo: tempo = Math.max(1, d); break;\n case Token.Hz: hz = d; tokenKind = Token.Ms; break;\n case Token.Ms: ms = d; break;\n case Token.WaveForm: soundWave = Math.clamp(1, 18, d); break;\n case Token.EnvelopeA: envA = d; tokenKind = Token.EnvelopeD; break;\n case Token.EnvelopeD: envD = d; tokenKind = Token.EnvelopeS; break;\n case Token.EnvelopeS: envS = Math.clamp(0, 255, d); tokenKind = Token.EnvelopeR; break;\n case Token.EnvelopeR: envR = d; break;\n case Token.EndHz: endHz = d; break;\n }\n token = \"\";\n }\n }\n\n while (true) {\n let currNote = scanNextWord();\n let prevNote: boolean = false;\n if (!currNote) {\n let timeLeft = timePos - now\n if (timeLeft > 0)\n pause(timeLeft)\n if (this.onPlayFinished)\n this.onPlayFinished();\n return;\n }\n\n hz = -1;\n\n let note: number = 0;\n token = \"\";\n tokenKind = Token.Note;\n\n for (let i = 0; i < currNote.length; i++) {\n let noteChar = currNote.charAt(i);\n switch (noteChar) {\n case 'c': case 'C': note = 1; prevNote = true; break;\n case 'd': case 'D': note = 3; prevNote = true; break;\n case 'e': case 'E': note = 5; prevNote = true; break;\n case 'f': case 'F': note = 6; prevNote = true; break;\n case 'g': case 'G': note = 8; prevNote = true; break;\n case 'a': case 'A': note = 10; prevNote = true; break;\n case 'B': note = 12; prevNote = true; break;\n case 'r': case 'R': hz = 0; prevNote = false; break;\n case '#': note++; prevNote = false; break;\n case 'b': if (prevNote) note--; else { note = 12; prevNote = true; } break;\n case ',':\n consumeToken();\n prevNote = false;\n break;\n case '!':\n tokenKind = Token.Hz;\n prevNote = false;\n break;\n case '@':\n consumeToken();\n tokenKind = Token.EnvelopeA;\n prevNote = false;\n break;\n case '~':\n consumeToken();\n tokenKind = Token.WaveForm;\n prevNote = false;\n break;\n case ':':\n consumeToken();\n tokenKind = Token.Beat;\n prevNote = false;\n break;\n case '-':\n consumeToken();\n tokenKind = Token.Tempo;\n prevNote = false;\n break;\n case '^':\n consumeToken();\n tokenKind = Token.EndHz;\n break;\n default:\n if (tokenKind == Token.Note)\n tokenKind = Token.Octave;\n token += noteChar;\n prevNote = false;\n break;\n }\n }\n consumeToken();\n\n if (note && hz < 0) {\n const keyNumber = note + (12 * (octave - 1));\n hz = freqs.getNumber(NumberFormat.UInt16LE, keyNumber * 2) || 0;\n }\n\n let currMs = ms\n\n if (currMs <= 0) {\n const beat = Math.idiv(15000, tempo);\n currMs = duration * beat\n }\n\n if (hz < 0) {\n // no frequency specified, so no duration\n } else if (hz == 0) {\n timePos += currMs\n } else {\n if (endHz < 0) {\n endHz = hz;\n }\n\n sndInstrPtr = 0\n addForm(envA, 0, 255, 0)\n addForm(envD, 255, envS, envA)\n addForm(currMs - (envA + envD), envS, envS, envD + envA)\n addForm(envR, envS, 0, currMs)\n\n this.queuePlayInstructions(timePos - now, sndInstr.slice(0, sndInstrPtr))\n endHz = -1;\n timePos += currMs // don't add envR - it's supposed overlap next sound\n }\n\n let timeLeft = timePos - now\n if (timeLeft > 200) {\n pause(timeLeft - 100)\n now = control.millis() - startTime\n }\n }\n }\n }\n\n //% fixedInstance whenUsed block=\"ba ding\"\n export const baDing = new Melody('b5:1 e6:3')\n\n //% fixedInstance whenUsed block=\"wawawawaa\"\n export const wawawawaa = new Melody('~15 e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8')\n\n //% fixedInstance whenUsed block=\"jump up\"\n export const jumpUp = new Melody('c5:1 d e f g')\n\n //% fixedInstance whenUsed block=\"jump down\"\n export const jumpDown = new Melody('g5:1 f e d c')\n\n //% fixedInstance whenUsed block=\"power up\"\n export const powerUp = new Melody('g4:1 c5 e g:2 e:1 g:3')\n\n //% fixedInstance whenUsed block=\"power down\"\n export const powerDown = new Melody('g5:1 d# c g4:2 b:1 c5:3')\n\n //% fixedInstance whenUsed block=\"magic wand\"\n export const magicWand = new Melody('F#6:1-300 G# A# B C7# D# F F# G# A# B:6')\n //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n\n //% fixedInstance whenUsed block=\"siren\"\n export const siren = new Melody('a4 d5 a4 d5 a4 d5')\n\n //% fixedInstance whenUsed block=\"pew pew\"\n export const pewPew = new Melody('!1200,200^50')\n\n //% fixedInstance whenUsed block=\"knock\"\n export const knock = new Melody('~4 @0,0,255,150 !300,1 !211,1')\n\n //% fixedInstance whenUsed block=\"footstep\"\n export const footstep = new Melody('~4 @0,0,60,50 !200,1')\n\n //% fixedInstance whenUsed block=\"thump\"\n export const thump = new Melody('~4 @0,0,255,150 !100,1')\n\n //% fixedInstance whenUsed block=\"small crash\"\n export const smallCrash = new Melody('~4 @10,490,0,1 !800,1')\n\n //% fixedInstance whenUsed block=\"big crash\"\n export const bigCrash = new Melody('~4 @10,990,0,1 !400,1')\n\n //% fixedInstance whenUsed block=\"zapped\"\n export const zapped = new Melody('~16 @10,490,0,0 !1600,500^1')\n\n //% fixedInstance whenUsed block=\"buzzer\"\n export const buzzer = new Melody('~16 @10,0,255,250 !2000,300')\n\n //% fixedInstance whenUsed block=\"sonar\"\n export const sonar = new Melody('~16 @10,1500,0,0 !200,1 !200,1500^190')\n\n //% fixedInstance whenUsed block=\"spooky\"\n export const spooky = new Melody('~16 @700,1300,0,0 !100,1 ~18 !108,2000')\n\n //% fixedInstance whenUsed block=\"beam up\"\n export const beamUp = new Melody('~18 @10,1500,0,0 !200,1500^4000')\n}\n",
"music.ts": "enum Note {\n //% blockIdentity=music.noteFrequency enumval=262\n C = 262,\n //% block=C#\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F = 349,\n //% block=F#\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G = 392,\n //% block=G#\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B = 494,\n //% blockIdentity=music.noteFrequency enumval=131\n C3 = 131,\n //% block=C#3\n //% blockIdentity=music.noteFrequency enumval=139\n CSharp3 = 139,\n //% blockIdentity=music.noteFrequency enumval=147\n D3 = 147,\n //% blockIdentity=music.noteFrequency enumval=156\n Eb3 = 156,\n //% blockIdentity=music.noteFrequency enumval=165\n E3 = 165,\n //% blockIdentity=music.noteFrequency enumval=175\n F3 = 175,\n //% block=F#3\n //% blockIdentity=music.noteFrequency enumval=185\n FSharp3 = 185,\n //% blockIdentity=music.noteFrequency enumval=196\n G3 = 196,\n //% block=G#3\n //% blockIdentity=music.noteFrequency enumval=208\n GSharp3 = 208,\n //% blockIdentity=music.noteFrequency enumval=220\n A3 = 220,\n //% blockIdentity=music.noteFrequency enumval=233\n Bb3 = 233,\n //% blockIdentity=music.noteFrequency enumval=247\n B3 = 247,\n //% blockIdentity=music.noteFrequency enumval=262\n C4 = 262,\n //% block=C#4\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp4 = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D4 = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb4 = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E4 = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F4 = 349,\n //% block=F#4\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp4 = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G4 = 392,\n //% block=G#4\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp4 = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A4 = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb4 = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B4 = 494,\n //% blockIdentity=music.noteFrequency enumval=523\n C5 = 523,\n //% block=C#5\n //% blockIdentity=music.noteFrequency enumval=555\n CSharp5 = 555,\n //% blockIdentity=music.noteFrequency enumval=587\n D5 = 587,\n //% blockIdentity=music.noteFrequency enumval=622\n Eb5 = 622,\n //% blockIdentity=music.noteFrequency enumval=659\n E5 = 659,\n //% blockIdentity=music.noteFrequency enumval=698\n F5 = 698,\n //% block=F#5\n //% blockIdentity=music.noteFrequency enumval=740\n FSharp5 = 740,\n //% blockIdentity=music.noteFrequency enumval=784\n G5 = 784,\n //% block=G#5\n //% blockIdentity=music.noteFrequency enumval=831\n GSharp5 = 831,\n //% blockIdentity=music.noteFrequency enumval=880\n A5 = 880,\n //% blockIdentity=music.noteFrequency enumval=932\n Bb5 = 932,\n //% blockIdentity=music.noteFrequency enumval=988\n B5 = 988,\n}\n\nenum BeatFraction {\n //% block=1\n Whole = 1,\n //% block=\"1/2\"\n Half = 2,\n //% block=\"1/4\"\n Quarter = 4,\n //% block=\"1/8\"\n Eighth = 8,\n //% block=\"1/16\"\n Sixteenth = 16,\n //% block=\"2\"\n Double = 32,\n //% block=\"4\",\n Breve = 64,\n //% block=\"1/3\",\n Triplet = 128\n}\n\nnamespace music {\n\n let beatsPerMinute: number;\n\n /**\n * Play a tone.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n */\n //% help=music/ring-tone\n //% blockId=music_ring block=\"ring tone|at %note=device_note\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music inBasicCategory=true\n //% weight=75 blockGap=8\n //% group=\"Tone\"\n export function ringTone(frequency: number) {\n playTone(frequency, 0);\n }\n\n /**\n * Rest, or play silence, for some time (in milliseconds).\n * @param ms rest duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/rest\n //% blockId=music_rest block=\"rest|for %duration=device_beat\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music\n //% weight=74\n //% group=\"Tone\"\n export function rest(ms: number) {\n playTone(0, Math.max(ms, 20));\n }\n\n function init() {\n if (!beatsPerMinute) beatsPerMinute = 120;\n }\n\n /**\n * Return the duration of a beat in milliseconds (the beat fraction).\n * @param fraction the fraction of the current whole note, eg: BeatFraction.Half\n */\n //% help=music/beat\n //% blockId=device_beat block=\"%fraction|beat\"\n //% weight=9 blockGap=8\n //% group=\"Tempo\"\n export function beat(fraction?: BeatFraction): number {\n init();\n if (fraction == null) fraction = BeatFraction.Whole;\n let beat = 60000 / beatsPerMinute;\n switch (fraction) {\n case BeatFraction.Half: beat /= 2; break;\n case BeatFraction.Quarter: beat /= 4; break;\n case BeatFraction.Eighth: beat /= 8; break;\n case BeatFraction.Sixteenth: beat /= 16; break;\n case BeatFraction.Double: beat *= 2; break;\n case BeatFraction.Breve: beat *= 4; break;\n case BeatFraction.Triplet: beat /= 3; break;\n }\n return beat >> 0;\n }\n\n /**\n * Return the tempo in beats per minute (bpm).\n * Tempo is the speed (bpm = beats per minute) at which notes play. The larger the tempo value, the faster the notes will play.\n */\n //% help=music/tempo\n //% blockId=device_tempo block=\"tempo (bpm)\"\n //% weight=64\n //% group=\"Tempo\"\n export function tempo(): number {\n init();\n return beatsPerMinute;\n }\n\n /**\n * Change the tempo up or down by some amount of beats per minute (bpm).\n * @param bpm The change in beats per minute to the tempo, eg: 20\n */\n //% help=music/change-tempo-by weight=37\n //% blockId=device_change_tempo block=\"change tempo by %value|(bpm)\"\n //% weight=66 blockGap=8\n //% group=\"Tempo\"\n export function changeTempoBy(bpm: number): void {\n init();\n setTempo(beatsPerMinute + bpm);\n }\n\n /**\n * Set the tempo a number of beats per minute (bpm).\n * @param bpm The new tempo in beats per minute, eg: 120\n */\n //% help=music/set-tempo\n //% blockId=device_set_tempo block=\"set tempo to %value|(bpm)\"\n //% bpm.min=4 bpm.max=400\n //% weight=65 blockGap=8\n //% group=\"Tempo\"\n export function setTempo(bpm: number): void {\n init();\n if (bpm > 0) {\n beatsPerMinute = Math.max(1, bpm >> 0);\n }\n }\n}\n",
"ns.ts": "\n/**\n * Generation of music tones.\n */\n//% color=#E30FC0 weight=90 icon=\"\\uf025\"\n//% blockGap=8\n//% groups='[\"Sounds\", \"Melody\", \"Tone\", \"Volume\", \"Tempo\"]'\nnamespace music {\n}",
"piano.ts": "namespace music {\n /**\n * Get the frequency of a note.\n * @param name the note name, eg: Note.C\n */\n //% weight=1 help=music/note-frequency\n //% blockId=device_note block=\"%note\"\n //% shim=TD_ID\n //% color=\"#FFFFFF\" colorSecondary=\"#FFFFFF\" colorTertiary=\"#D83B01\"\n //% note.fieldEditor=\"note\" note.defl=\"262\"\n //% note.fieldOptions.decompileLiterals=true\n //% useEnumVal=1\n //% weight=10 blockGap=8\n //% group=\"Tone\"\n export function noteFrequency(name: Note): number {\n return name;\n }\n}",
"pxt.json": "{\n \"name\": \"mixer---stm32\",\n \"description\": \"The music library with a mixer\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"SoundOutput.h\",\n \"sound.cpp\",\n \"melody.h\",\n \"melody.cpp\",\n \"melody.ts\",\n \"piano.ts\",\n \"legacy.ts\",\n \"ns.ts\",\n \"targetoverrides.ts\",\n \"music.ts\",\n \"pxtparts.json\",\n \"headphone.svg\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"pxtparts.json": "{\n \"headphone\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"image\": \"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\": \"A0\",\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}",
"sound.cpp": "// to be overridden\n",
"targetoverrides.ts": "\n",
"test.ts": "for(let i = 1000; i > 0; i -= 50)\n music.playTone(440, i)\n\nfor(let i = 0; i < 1000; i += 20)\n music.playTone(440, i)\n"
},
"mixer---nrf52": {
"SoundOutput.h": "#include \"NRF52PWM.h\"\n#include \"Synthesizer.h\"\n#include \"Mixer.h\"\n\nclass SoundOutput {\n public:\n NRF52PWM dac;\n\n SoundOutput(DataSource &data) : dac(NRF_PWM0, data) {\n dac.connectPin(*LOOKUP_PIN(JACK_SND), 0);\n }\n\n void setOutput(int output) { }\n};\n",
"headphone.svg": "",
"legacy.ts": "//% deprecated=true hidden=true\nenum Sounds {\n //% block=\"power up\"\n PowerUp,\n //% block=\"power down\"\n PowerDown,\n //% block=\"jump up\"\n JumpUp,\n //% block=\"jump down\"\n JumpDown,\n //% block=\"ba ding\"\n BaDing,\n //% block=\"wawawawaa\"\n Wawawawaa,\n //% block=\"magic wand\"\n MagicWand,\n //% block=\"siren\"\n Siren\n}\n\nnamespace music {\n /**\n * Get the melody string for a built-in melody.\n * @param name the note name, eg: Note.C\n */\n //% help=music/sounds\n //% blockId=music_sounds block=\"%name\"\n //% blockHidden=true\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=285\n //% name.fieldOptions.columns=3\n export function sounds(name: Sounds): string {\n switch (name) {\n case Sounds.BaDing:\n return 'b5:1 e6:3';\n case Sounds.Wawawawaa:\n return 'e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8';\n case Sounds.JumpUp:\n return 'c5:1 d e f g';\n case Sounds.JumpDown:\n return 'g5:1 f e d c';\n case Sounds.PowerUp:\n return 'g4:1 c5 e g:2 e:1 g:3';\n case Sounds.PowerDown:\n return 'g5:1 d# c g4:2 b:1 c5:3';\n case Sounds.MagicWand:\n return 'F#6:1-300 G# A# B C7# D# F F# G# A# B:6'; //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n case Sounds.Siren:\n return 'a4 d5 a4 d5 a4 d5';\n default:\n return '';\n }\n }\n\n let currMelody: Melody\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound\n //% blockId=music_play_sound block=\"play sound %sound=music_sounds\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% deprecated=true hidden=true\n export function playSound(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.play();\n pause(1);\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound-until-done\n //% blockId=music_play_sound_until_done block=\"play sound %sound=music_sounds|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% deprecated=true hidden=true\n export function playSoundUntilDone(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.playUntilDone();\n }\n}",
"melody.cpp": "#include \"pxt.h\"\n#include \"SoundOutput.h\"\n#include \"melody.h\"\n\n//#define LOG DMESG\n#define LOG NOLOG\n\nnamespace music {\n\nSINGLETON(WSynthesizer);\n\n// Tone generator arguments:\n//\n// sound: a pointer to the currently-playing sound, usable for looking up the\n// waveform or generator-specific state.\n//\n// position: offset within the currently-playing wave, range 0..1023.\n//\n// cycle: a 6-bit cyclical sequence number of the wave, incremented each time\n// the position loops from 1023 back to 0.\ntypedef int (*gentone_t)(PlayingSound *sound, uint32_t position, uint8_t cycle);\n\nstatic int noiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)position;\n (void)cycle;\n // see https://en.wikipedia.org/wiki/Xorshift\n static uint32_t x = 0xf01ba80;\n x ^= x << 13;\n x ^= x >> 17;\n x ^= x << 5;\n return (x & 0xffff) - 0x7fff;\n}\n\nstatic int sineTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n int32_t p = position;\n if (p >= 512) {\n p -= 512;\n }\n if (p > 256) {\n p = 512 - p;\n }\n\n // Approximate sin(x * pi / 2) with the odd polynomial y = cx^5 + bx^3 + ax\n // using the constraint y(1) = 1 => a = 1 - b - c\n // => y = c x^5 + b x^3 + (1 - b - c) * x\n //\n // Do a least-squares fit of this to sin(x * pi / 2) in the range 0..1\n // inclusive, using 21 evenly spaced points. Resulting approximation:\n //\n // sin(x*pi/2) ~= 0.0721435357258*x**5 - 0.642443736562*x**3 + 1.57030020084*x\n\n // Scale the constants by 32767 to match the desired output range.\n constexpr int32_t c = 0.0721435357258 * 32767;\n constexpr int32_t b = -0.642443736562 * 32767;\n constexpr int32_t a = 1.57030020084 * 32767;\n\n // Calculate using y = ((c * x^2 + b) * x^2 + a) * x\n //\n // The position p is x * 256, so after each multiply with p we need to\n // shift right by 8 bits to keep the decimal point in the same place. (The\n // approximation has a negative error near x=1 which helps avoid overflow.)\n int32_t p2 = p * p;\n int32_t u = (c * p2 >> 16) + b;\n int32_t v = (u * p2 >> 16) + a;\n int32_t w = v * p >> 8;\n\n // The result is within 7/32767 or 0.02%, signal-to-error ratio about 38 dB.\n return position >= 512 ? -w : w;\n}\n\nstatic int sawtoothTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n return (position << 6) - 0x7fff;\n}\n\nstatic int triangleTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n return position < 512 ? (position << 7) - 0x7fff : ((1023 - position) << 7) - 0x7fff;\n}\n\nstatic int squareWaveTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)cycle;\n uint8_t wave = sound->currInstr->soundWave;\n return (int)position < (102 * (wave - SW_SQUARE_10 + 1)) ? -0x7fff : 0x7fff;\n}\n\nstatic int tunedNoiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a random bit sequence. Since the generator\n // is called multiple times per wave, use PlayingSound state data to ensure we\n // only generate a random bit once per wave, and then reuse it for future\n // calls for that wave.\n //\n // Use the low 6 bits of generatorState to store the last-used cycle, and\n // random_bit to store the last on/off state. (random_bit is arbitrary as\n // long as it isn't one of the low 6 bits.)\n constexpr uint32_t random_bit = 0x8000;\n static uint32_t x = 0xf01ba80; // seed for the static RNG state\n uint8_t prev_cycle = sound->generatorState & 0x3f;\n uint32_t is_on;\n if (cycle == prev_cycle) {\n is_on = sound->generatorState & random_bit;\n } else {\n // see https://en.wikipedia.org/wiki/Xorshift\n x ^= x << 13;\n x ^= x >> 17;\n x ^= x << 5;\n is_on = (x & random_bit);\n sound->generatorState = (cycle & 0x3f) | is_on;\n }\n if (!is_on)\n return 0;\n return position < 512 ? -0x7fff : 0x7fff;\n}\n\n// Bit patterns for use by the cyclic noise tone.\n//\n// The bit pattern is arbitrary, but should have equal numbers of 0 and 1 bits,\n// and should avoid long identical-bit runs for the lower parts. The values below\n// were chosen based on a random permutation of the hex nibbles 0..f and then\n// hand-tweaked by swapping some nibbles. Generated by:\n//\n// shuf -i 0-15 | perl -ne 's/(\\d+)/printf(\"%x\",$1)/e'\nstatic const uint32_t cycle_bits[] = {0x2df0eb47, 0xc8165a93};\nstatic const uint8_t cycle_mask[] = {0xf, 0x1f, 0x3f};\n\nstatic int cycleNoiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a short-cycle pseudorandom bit sequence.\n // The bit sequence repeats every 16/32/64 waves.\n //\n // The \"cycle\" argument corresponds to the sequential number of the generated\n // wave. This is currently a 6-bit value. Since the pseudorandom bit sequences\n // evenly fit into this, there's no need to track generator state.\n uint8_t wave = sound->currInstr->soundWave;\n int cycle_index = wave - SW_SQUARE_CYCLE_16;\n // CLAMP(0, cycle_index, sizeof cycle_bits / sizeof cycle_bits[0])\n cycle &= cycle_mask[cycle_index];\n bool is_on = (cycle_bits[cycle >> 5] & (1U << (cycle & 0x1f)));\n if (!is_on)\n return 0;\n return position < 512 ? -0x7fff : 0x7fff;\n}\n\nstatic int silenceTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a short-cycle pseudorandom bit sequence.\n (void)sound;\n (void)position;\n (void)cycle;\n return 0;\n}\n\nstatic gentone_t getWaveFn(uint8_t wave) {\n switch (wave) {\n case SW_TRIANGLE:\n return triangleTone;\n case SW_SAWTOOTH:\n return sawtoothTone;\n case SW_TUNEDNOISE:\n return tunedNoiseTone;\n case SW_NOISE:\n return noiseTone;\n case SW_SINE:\n return sineTone;\n default:\n if (SW_SQUARE_10 <= wave && wave <= SW_SQUARE_50)\n return squareWaveTone;\n if (SW_SQUARE_CYCLE_16 <= wave && wave <= SW_SQUARE_CYCLE_64)\n return cycleNoiseTone;\n else\n return silenceTone;\n }\n}\n\n#define CLAMP(lo, v, hi) ((v) = ((v) < (lo) ? (lo) : (v) > (hi) ? (hi) : (v)))\n\nint WSynthesizer::updateQueues() {\n const int maxTime = 0xffffff;\n while (1) {\n WaitingSound *p;\n int minLeft = maxTime;\n for (p = waiting; p; p = p->next) {\n int timeLeft =\n p->state == SoundState::Waiting ? p->startSampleNo - currSample : maxTime;\n if (timeLeft <= 0) {\n break;\n }\n if (timeLeft < minLeft)\n minLeft = timeLeft;\n }\n if (p) {\n PlayingSound *snd;\n int minIdx = -1;\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n snd = &playingSounds[i];\n if (snd->sound == NULL)\n break;\n if (minIdx == -1 ||\n playingSounds[minIdx].startSampleNo < playingSounds[i].startSampleNo)\n minIdx = i;\n snd = NULL;\n }\n // if we didn't find a free slot, expel the oldest sound\n if (!snd)\n snd = &playingSounds[minIdx];\n if (snd->sound)\n snd->sound->state = SoundState::Done;\n snd->sound = p;\n p->state = SoundState::Playing;\n snd->startSampleNo = currSample;\n snd->currInstr = (SoundInstruction *)p->instructions->data;\n snd->instrEnd = snd->currInstr + p->instructions->length / sizeof(SoundInstruction);\n snd->prevVolume = -1;\n } else {\n // no more sounds to move\n return minLeft;\n }\n }\n}\n\nint WSynthesizer::fillSamples(int16_t *dst, int numsamples) {\n if (numsamples <= 0)\n return 1;\n\n int timeLeft = updateQueues();\n int res = waiting != NULL;\n\n // if there's a pending sound to be started somewhere during numsamples,\n // split the call into two\n if (timeLeft < numsamples) {\n fillSamples(dst, timeLeft);\n LOG(\"M split %d\", timeLeft);\n fillSamples(dst + timeLeft, numsamples - timeLeft);\n return 1;\n }\n\n memset(dst, 0, numsamples * 2);\n\n uint32_t samplesPerMS = (sampleRate << 8) / 1000;\n float toneStepMult = (1024.0 * (1 << 16)) / sampleRate;\n const int MAXVAL = (1 << (OUTPUT_BITS - 1)) - 1;\n\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n PlayingSound *snd = &playingSounds[i];\n if (snd->sound == NULL)\n continue;\n\n res = 1;\n\n SoundInstruction *instr = NULL;\n gentone_t fn = NULL;\n snd->currInstr--;\n uint32_t toneStep = 0;\n int32_t toneDelta = 0;\n int32_t volumeStep = 0;\n uint32_t tonePosition = snd->tonePosition;\n uint32_t samplesLeft = 0;\n uint8_t wave = 0;\n int32_t volume = 0;\n\n for (int j = 0; j < numsamples; ++j) {\n if (samplesLeft == 0) {\n snd->currInstr++;\n if (snd->currInstr >= snd->instrEnd) {\n break;\n }\n SoundInstruction copy = *snd->currInstr;\n instr = ©\n CLAMP(20, instr->frequency, 20000);\n CLAMP(20, instr->endFrequency, 20000);\n CLAMP(0, instr->startVolume, 1023);\n CLAMP(0, instr->endVolume, 1023);\n CLAMP(1, instr->duration, 60000);\n\n wave = instr->soundWave;\n fn = getWaveFn(wave);\n\n samplesLeft = (uint32_t)(instr->duration * samplesPerMS >> 8);\n // make sure the division is signed\n volumeStep =\n (int)((instr->endVolume - instr->startVolume) << 16) / (int)samplesLeft;\n\n if (j == 0 && snd->prevVolume != -1) {\n // restore previous state\n samplesLeft = snd->samplesLeftInCurr;\n volume = snd->prevVolume;\n toneStep = snd->prevToneStep;\n toneDelta = snd->prevToneDelta;\n } else {\n LOG(\"#sampl %d %p\", samplesLeft, snd->currInstr);\n volume = instr->startVolume << 16;\n LOG(\"%d-%dHz %d-%d vol\", instr->frequency, instr->endFrequency,\n instr->startVolume, instr->endVolume);\n toneStep = (uint32_t)(toneStepMult * instr->frequency);\n if (instr->frequency != instr->endFrequency) {\n uint32_t endToneStep = (uint32_t)(toneStepMult * instr->endFrequency);\n toneDelta = (int32_t)(endToneStep - toneStep) / (int32_t)samplesLeft;\n } else {\n toneDelta = 0;\n }\n }\n }\n\n int v = fn(snd, (tonePosition >> 16) & 1023, tonePosition >> 26);\n v = (v * (volume >> 16)) >> (10 + (16 - OUTPUT_BITS));\n\n // if (v > MAXVAL)\n // target_panic(123);\n\n dst[j] += v;\n\n tonePosition += toneStep;\n toneStep += toneDelta;\n volume += volumeStep;\n samplesLeft--;\n }\n\n if (snd->currInstr >= snd->instrEnd) {\n snd->sound->state = SoundState::Done;\n snd->sound = NULL;\n } else {\n snd->tonePosition = tonePosition;\n if (samplesLeft == 0)\n samplesLeft++; // avoid infinite loop in next iteration\n snd->samplesLeftInCurr = samplesLeft;\n snd->prevVolume = volume;\n snd->prevToneDelta = toneDelta;\n snd->prevToneStep = toneStep;\n }\n }\n\n currSample += numsamples;\n\n for (int j = 0; j < numsamples; ++j) {\n if (dst[j] > MAXVAL)\n dst[j] = MAXVAL;\n else if (dst[j] < -MAXVAL)\n dst[j] = -MAXVAL;\n }\n\n return res;\n}\n\n//%\nvoid enableAmp(int enabled) {\n // this is also compiled on linux\n#ifdef LOOKUP_PIN\n auto pin = LOOKUP_PIN(SPEAKER_AMP);\n if (pin) {\n if (PIN(SPEAKER_AMP) & CFG_PIN_CONFIG_ACTIVE_LO)\n enabled = !enabled;\n pin->setDigitalValue(enabled);\n }\n#endif\n}\n\n//%\nvoid forceOutput(int outp) {\n auto snd = getWSynthesizer();\n snd->out.setOutput(outp);\n}\n\n//%\nvoid queuePlayInstructions(int when, Buffer buf) {\n auto snd = getWSynthesizer();\n\n registerGCObj(buf);\n\n auto p = new WaitingSound;\n p->state = SoundState::Waiting;\n p->instructions = buf;\n p->startSampleNo = snd->currSample + when * snd->sampleRate / 1000;\n\n LOG(\"Queue %dms now=%d off=%d %p sampl:%dHz\", when, snd->currSample,\n p->startSampleNo - snd->currSample, buf->data, snd->sampleRate);\n\n target_disable_irq();\n // add new sound to queue\n p->next = snd->waiting;\n snd->waiting = p;\n // remove sounds that have already been fully played\n while (p) {\n while (p->next && p->next->state == SoundState::Done) {\n auto todel = p->next;\n p->next = todel->next;\n unregisterGCObj(todel->instructions);\n delete todel;\n }\n p = p->next;\n }\n target_enable_irq();\n\n snd->poke();\n}\n\n//%\nvoid stopPlaying() {\n LOG(\"stop playing!\");\n\n auto snd = getWSynthesizer();\n\n target_disable_irq();\n auto p = snd->waiting;\n snd->waiting = NULL;\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n snd->playingSounds[i].sound = NULL;\n }\n while (p) {\n auto n = p->next;\n unregisterGCObj(p->instructions);\n delete p;\n p = n;\n }\n target_enable_irq();\n}\n\nWSynthesizer::WSynthesizer() : upstream(NULL), out(*this) {\n currSample = 0;\n active = false;\n sampleRate = out.dac.getSampleRate();\n memset(&playingSounds, 0, sizeof(playingSounds));\n waiting = NULL;\n PXT_REGISTER_RESET(stopPlaying);\n}\n\n} // namespace music\n\nnamespace pxt {\nint redirectSamples(int16_t *dst, int numsamples, int samplerate) {\n auto snd = music::getWSynthesizer();\n snd->upstream = NULL; // disconnect from regular playback mechanism\n snd->sampleRate = samplerate;\n return snd->fillSamples(dst, numsamples);\n}\n\n} // namespace pxt\n\nnamespace jacdac {\n__attribute__((weak)) void setJackRouterOutput(int output) {}\n} // namespace jacdac\n",
"melody.h": "#pragma once\n\n#ifndef OUTPUT_BITS\n#define OUTPUT_BITS 10\n#endif\n\n#define SW_TRIANGLE 1\n#define SW_SAWTOOTH 2\n#define SW_SINE 3\n#define SW_TUNEDNOISE 4\n#define SW_NOISE 5\n#define SW_SQUARE_10 11\n#define SW_SQUARE_50 15\n#define SW_SQUARE_CYCLE_16 16\n#define SW_SQUARE_CYCLE_32 17\n#define SW_SQUARE_CYCLE_64 18\n\nstruct SoundInstruction {\n uint8_t soundWave;\n uint8_t flags;\n uint16_t frequency; // Hz\n uint16_t duration; // ms\n int16_t startVolume; // 0-1023\n int16_t endVolume; // 0-1023\n uint16_t endFrequency; // Hz\n};\n\n#ifdef DATASTREAM_MAXIMUM_BUFFERS\n#define CODAL 1\n#endif\n\nnamespace music {\n\n#define MAX_SOUNDS 5\n\nSTATIC_ASSERT((1 << (16 - OUTPUT_BITS)) > MAX_SOUNDS);\n\nenum class SoundState : uint8_t {\n Waiting, //\n Playing, //\n Done //\n};\n\nstruct WaitingSound {\n uint32_t startSampleNo;\n SoundState state;\n WaitingSound *next;\n Buffer instructions;\n};\n\nstruct PlayingSound {\n uint32_t startSampleNo;\n uint32_t samplesLeftInCurr;\n uint32_t tonePosition;\n int32_t prevVolume;\n uint32_t prevToneStep;\n int32_t prevToneDelta;\n uint32_t generatorState;\n WaitingSound *sound;\n SoundInstruction *currInstr, *instrEnd;\n};\n\nclass WSynthesizer\n#ifdef CODAL\n : public DataSource\n#endif\n{\n public:\n#ifdef CODAL\n DataSink *upstream;\n#else\n void *upstream;\n#endif\n uint32_t currSample; // after 25h of playing we might get a glitch\n int32_t sampleRate; // eg 44100\n PlayingSound playingSounds[MAX_SOUNDS];\n WaitingSound *waiting;\n bool active;\n\n SoundOutput out;\n\n int fillSamples(int16_t *dst, int numsamples);\n int updateQueues();\n\n WSynthesizer();\n virtual ~WSynthesizer() {}\n\n void pokeUpstream() {\n#ifdef CODAL\n if (upstream) {\n upstream->pullRequest();\n }\n#endif\n }\n\n void poke() {\n if (!active) {\n active = true;\n pokeUpstream();\n }\n }\n\n#ifdef CODAL\n virtual ManagedBuffer pull() {\n if (!upstream)\n return ManagedBuffer();\n ManagedBuffer data(512);\n auto dp = (int16_t *)data.getBytes();\n auto sz = 512 / 2;\n int r = fillSamples(dp, sz);\n#if defined(NRF52_SERIES)\n int mul = out.dac.getSampleRange();\n#endif\n while (sz--) {\n#if defined(NRF52_SERIES)\n *dp = ((-*dp + (1 << (OUTPUT_BITS - 1))) * mul) >> OUTPUT_BITS;\n#else\n *dp += 1 << (OUTPUT_BITS - 1);\n#endif\n dp++;\n }\n if (!r) {\n active = false;\n // return empty - nothing left to play\n return ManagedBuffer();\n }\n pokeUpstream();\n return data;\n }\n virtual void connect(DataSink &sink) { upstream = &sink; }\n#endif\n};\n\n} // namespace music\n",
"melody.ts": "enum MusicOutput {\n AutoDetect = 0,\n Buzzer = 1,\n HeadPhones = 2,\n}\n\nnamespace music {\n //% whenUsed\n const freqs = hex`\n 1f00210023002500270029002c002e003100340037003a003e004100450049004e00520057005c00620068006e00\n 75007b0083008b0093009c00a500af00b900c400d000dc00e900f70006011501260137014a015d01720188019f01\n b801d201ee010b022a024b026e029302ba02e40210033f037003a403dc03170455049704dd0427057505c8052006\n 7d06e0064907b8072d08a9082d09b9094d0aea0a900b400cfa0cc00d910e6f0f5a1053115b1272139a14d4152017\n 8018f519801b231dde1e`\n\n //% shim=music::queuePlayInstructions\n function queuePlayInstructions(timeDelta: number, buf: Buffer) { }\n\n //% shim=music::stopPlaying\n function stopPlaying() { }\n\n //% shim=music::forceOutput\n export function forceOutput(buf: MusicOutput) { }\n\n let globalVolume: number = null\n\n const BUFFER_SIZE: number = 12;\n\n //% shim=music::enableAmp\n function enableAmp(en: number) {\n return // for sim\n }\n\n function initVolume() {\n if (globalVolume === null) {\n globalVolume = 0\n setVolume(control.getConfigValue(DAL.CFG_SPEAKER_VOLUME, 128))\n }\n }\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 //% parts=\"speaker\"\n //% volume.min=0 volume.max=255\n //% volume.defl=20\n //% help=music/set-volume\n //% weight=70\n //% group=\"Volume\"\n export function setVolume(volume: number): void {\n globalVolume = Math.clamp(0, 255, volume | 0)\n enableAmp(globalVolume > 0 ? 1 : 0)\n }\n\n /**\n * Gets the current volume\n */\n //% parts=\"speaker\"\n //% weight=70\n export function volume(): number {\n initVolume()\n return globalVolume;\n }\n\n function playNoteCore(when: number, frequency: number, ms: number) {\n let buf = control.createBuffer(BUFFER_SIZE)\n addNote(buf, 0, ms, 255, 255, 3, frequency, volume(), frequency)\n queuePlayInstructions(when, buf)\n }\n\n /**\n * Play a tone through the speaker for some amount of time.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n * @param ms tone duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/play-tone\n //% blockId=mixer_play_note block=\"play tone|at %note=device_note|for %duration=device_beat\"\n //% parts=\"headphone\" async\n //% blockNamespace=music\n //% weight=76 blockGap=8\n //% group=\"Tone\"\n export function playTone(frequency: number, ms: number): void {\n if (ms == 0)\n ms = 86400000 // 1 day\n\n if (ms <= 2000) {\n playNoteCore(0, frequency, ms)\n pause(ms)\n } else {\n const id = ++playToneID\n control.runInParallel(() => {\n let pos = control.millis()\n while (id == playToneID && ms > 0) {\n let now = control.millis()\n let d = pos - now\n let t = Math.min(ms, 500)\n ms -= t\n pos += t\n playNoteCore(d - 1, frequency, t)\n if (ms == 0)\n pause(d + t)\n else\n pause(d + t - 100)\n }\n })\n }\n }\n\n let playToneID = 0\n\n /**\n * Play a melody from the melody editor.\n * @param melody - string of up to eight notes [C D E F G A B C5] or rests [-] separated by spaces, \n * which will be played one at a time, ex: \"E D G F B A C5 B \"\n * @param tempo - number in beats per minute (bpm), dictating how long each note will play for\n */\n //% block=\"play melody $melody at tempo $tempo|(bpm)\" blockId=playMelody\n //% blockNamespace=music\n //% weight=85 blockGap=8 help=music/play-melody\n //% group=\"Melody\"\n //% melody.shadow=\"melody_editor\"\n //% tempo.min=40 tempo.max=500\n //% tempo.defl=120\n export function playMelody(melody: string, tempo: number) {\n let notes: string[] = melody.split(\" \").filter(n => !!n);\n let formattedMelody = \"\";\n let newOctave = false;\n\n // build melody string, replace '-' with 'R' and add tempo\n // creates format like \"C5-174 B4 A G F E D C \"\n for (let i = 0; i < notes.length; i++) {\n if (notes[i] === \"-\") {\n notes[i] = \"R\";\n } else if (notes[i] === \"C5\") {\n newOctave = true;\n } else if (newOctave) { // change the octave if necesary\n notes[i] += \"4\";\n newOctave = false;\n }\n // add tempo after first note\n if (i == 0) {\n formattedMelody += notes[i] + \"-\" + tempo + \" \";\n } else {\n formattedMelody += notes[i] + \" \";\n }\n }\n\n const song = new Melody(formattedMelody);\n song.playUntilDone();\n }\n\n\n /**\n * Create a melody with the melody editor.\n * @param melody\n */\n //% block=\"$melody\" blockId=melody_editor\n //% blockNamespace=music\n //% blockHidden = true\n //% weight=85 blockGap=8\n //% help=music/melody-editor\n //% group=\"Melody\" duplicateShadowOnDrag\n //% melody.fieldEditor=\"melody\"\n //% melody.fieldOptions.decompileLiterals=true\n //% melody.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% melody.fieldOptions.onParentBlock=\"true\"\n //% shim=TD_ID\n export function melodyEditor(melody: string): string {\n return melody;\n }\n\n /**\n * Stop all sounds from playing.\n */\n //% help=music/stop-all-sounds\n //% blockId=music_stop_all_sounds block=\"stop all sounds\"\n //% weight=10\n //% group=\"Sounds\"\n export function stopAllSounds() {\n Melody.stopAll();\n stopPlaying();\n }\n\n //% fixedInstances\n export class Melody {\n _text: string;\n private _player: MelodyPlayer;\n\n private static playingMelodies: Melody[];\n\n static stopAll() {\n if (Melody.playingMelodies) {\n const ms = Melody.playingMelodies.slice(0, Melody.playingMelodies.length);\n ms.forEach(p => p.stop());\n }\n }\n\n constructor(text: string) {\n this._text = text\n }\n\n get text() {\n return this._text;\n }\n\n /**\n * Stop playing a sound\n */\n //% blockId=mixer_stop block=\"stop sound %sound\"\n //% help=music/melody/stop\n //% parts=\"headphone\"\n //% weight=92 blockGap=8\n //% group=\"Sounds\"\n stop() {\n if (this._player) {\n this._player.stop()\n this._player = null\n }\n this.unregisterMelody();\n }\n\n private registerMelody() {\n // keep track of the active players\n if (!Melody.playingMelodies) Melody.playingMelodies = [];\n // stop and pop melodies if too many playing\n if (Melody.playingMelodies.length > 4) {\n // stop last player (also pops)\n Melody.playingMelodies[Melody.playingMelodies.length - 1].stop();\n }\n // put back the melody on top of the melody stack\n Melody.playingMelodies.removeElement(this);\n Melody.playingMelodies.push(this);\n }\n private unregisterMelody() {\n // remove from list\n if (Melody.playingMelodies) {\n Melody.playingMelodies.removeElement(this); // remove self\n }\n }\n\n private playCore(volume: number, loop: boolean) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this.registerMelody();\n control.runInParallel(() => {\n while (this._player == p) {\n p.play(volume)\n if (!loop) {\n // Unregister the melody when done playing, but\n // only if it hasn't been restarted. (Looping\n // melodies never stop on their own, they only\n // get unregistered via stop().)\n if (this._player == p) {\n this.unregisterMelody();\n }\n break\n }\n }\n })\n }\n\n /**\n * Start playing a sound in a loop and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/loop\n //% blockId=mixer_loop_sound block=\"loop sound %sound\"\n //% parts=\"headphone\"\n //% weight=93 blockGap=8\n //% group=\"Sounds\"\n loop(volume = 255) {\n this.playCore(volume, true)\n }\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/play\n //% blockId=mixer_play_sound block=\"play sound %sound\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% group=\"Sounds\"\n play(volume = 255) {\n this.playCore(volume, false)\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * @param sound the melody to play\n */\n //% help=music/melody/play-until-done\n //% blockId=mixer_play_sound_until_done block=\"play sound %sound|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% group=\"Sounds\"\n playUntilDone(volume = 255) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this._player.onPlayFinished = () => {\n if (p == this._player)\n this.unregisterMelody();\n }\n this.registerMelody();\n this._player.play(volume)\n }\n\n toString() {\n return this._text;\n }\n }\n\n function addNote(sndInstr: Buffer, sndInstrPtr: number, ms: number, beg: number, end: number, soundWave: number, hz: number, volume: number, endHz: number) {\n if (ms > 0) {\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, soundWave)\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr + 1, 0)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 2, hz)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 4, ms)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 6, (beg * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 8, (end * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 10, endHz);\n sndInstrPtr += BUFFER_SIZE;\n }\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, 0) // terminate\n return sndInstrPtr\n }\n\n\n export class MelodyPlayer {\n melody: Melody;\n\n onPlayFinished: () => void;\n\n constructor(m: Melody) {\n this.melody = m\n }\n\n stop() {\n this.melody = null\n }\n\n protected queuePlayInstructions(timeDelta: number, buf: Buffer) {\n queuePlayInstructions(timeDelta, buf)\n }\n\n play(volume: number) {\n if (!this.melody)\n return\n volume = Math.clamp(0, 255, (volume * music.volume()) >> 8)\n\n let notes = this.melody._text\n let pos = 0;\n let duration = 4; //Default duration (Crotchet)\n let octave = 4; //Middle octave\n let tempo = 120; // default tempo\n\n let hz = 0\n let endHz = -1\n let ms = 0\n let timePos = 0\n let startTime = control.millis()\n let now = 0\n\n let envA = 0\n let envD = 0\n let envS = 255\n let envR = 0\n let soundWave = 1 // triangle\n let sndInstr = control.createBuffer(5 * BUFFER_SIZE)\n let sndInstrPtr = 0\n\n const addForm = (formDuration: number, beg: number, end: number, msOff: number) => {\n let freqStart = hz;\n let freqEnd = endHz;\n\n const envelopeWidth = ms > 0 ? ms : duration * Math.idiv(15000, tempo) + envR;\n if (endHz != hz && envelopeWidth != 0) {\n const slope = (freqEnd - freqStart) / envelopeWidth;\n freqStart = hz + slope * msOff;\n freqEnd = hz + slope * (msOff + formDuration);\n }\n sndInstrPtr = addNote(sndInstr, sndInstrPtr, formDuration, beg, end, soundWave, freqStart, volume, freqEnd);\n }\n\n const scanNextWord = () => {\n if (!this.melody)\n return \"\"\n\n // eat space\n while (pos < notes.length) {\n const c = notes[pos];\n if (c != ' ' && c != '\\r' && c != '\\n' && c != '\\t')\n break;\n pos++;\n }\n\n // read note\n let note = \"\";\n while (pos < notes.length) {\n const c = notes[pos];\n if (c == ' ' || c == '\\r' || c == '\\n' || c == '\\t')\n break;\n note += c;\n pos++;\n }\n return note;\n }\n\n enum Token {\n Note,\n Octave,\n Beat,\n Tempo,\n Hz,\n EndHz,\n Ms,\n WaveForm,\n EnvelopeA,\n EnvelopeD,\n EnvelopeS,\n EnvelopeR\n }\n\n let token: string = \"\";\n let tokenKind = Token.Note;\n\n // [ABCDEFG] (\\d+) (:\\d+) (-\\d+)\n // note octave length tempo\n // R (:\\d+) - rest\n // !\\d+,\\d+ - sound at frequency with given length (Hz,ms); !\\d+ and !\\d+,:\\d+ also possible\n // @\\d+,\\d+,\\d+,\\d+ - ADSR envelope - ms,ms,volume,ms; volume is 0-255\n // ~\\d+ - wave form:\n // 1 - triangle\n // 2 - sawtooth\n // 3 - sine\n // 4 - pseudorandom square wave noise (tunable)\n // 5 - white noise (ignores frequency)\n // 11 - square 10%\n // 12 - square 20%\n // ...\n // 15 - square 50%\n // 16 - filtered square wave, cycle length 16\n // 17 - filtered square wave, cycle length 32\n // 18 - filtered square wave, cycle length 64\n\n const consumeToken = () => {\n if (token && tokenKind != Token.Note) {\n const d = parseInt(token);\n switch (tokenKind) {\n case Token.Octave: octave = d; break;\n case Token.Beat:\n duration = Math.max(1, Math.min(16, d));\n ms = -1;\n break;\n case Token.Tempo: tempo = Math.max(1, d); break;\n case Token.Hz: hz = d; tokenKind = Token.Ms; break;\n case Token.Ms: ms = d; break;\n case Token.WaveForm: soundWave = Math.clamp(1, 18, d); break;\n case Token.EnvelopeA: envA = d; tokenKind = Token.EnvelopeD; break;\n case Token.EnvelopeD: envD = d; tokenKind = Token.EnvelopeS; break;\n case Token.EnvelopeS: envS = Math.clamp(0, 255, d); tokenKind = Token.EnvelopeR; break;\n case Token.EnvelopeR: envR = d; break;\n case Token.EndHz: endHz = d; break;\n }\n token = \"\";\n }\n }\n\n while (true) {\n let currNote = scanNextWord();\n let prevNote: boolean = false;\n if (!currNote) {\n let timeLeft = timePos - now\n if (timeLeft > 0)\n pause(timeLeft)\n if (this.onPlayFinished)\n this.onPlayFinished();\n return;\n }\n\n hz = -1;\n\n let note: number = 0;\n token = \"\";\n tokenKind = Token.Note;\n\n for (let i = 0; i < currNote.length; i++) {\n let noteChar = currNote.charAt(i);\n switch (noteChar) {\n case 'c': case 'C': note = 1; prevNote = true; break;\n case 'd': case 'D': note = 3; prevNote = true; break;\n case 'e': case 'E': note = 5; prevNote = true; break;\n case 'f': case 'F': note = 6; prevNote = true; break;\n case 'g': case 'G': note = 8; prevNote = true; break;\n case 'a': case 'A': note = 10; prevNote = true; break;\n case 'B': note = 12; prevNote = true; break;\n case 'r': case 'R': hz = 0; prevNote = false; break;\n case '#': note++; prevNote = false; break;\n case 'b': if (prevNote) note--; else { note = 12; prevNote = true; } break;\n case ',':\n consumeToken();\n prevNote = false;\n break;\n case '!':\n tokenKind = Token.Hz;\n prevNote = false;\n break;\n case '@':\n consumeToken();\n tokenKind = Token.EnvelopeA;\n prevNote = false;\n break;\n case '~':\n consumeToken();\n tokenKind = Token.WaveForm;\n prevNote = false;\n break;\n case ':':\n consumeToken();\n tokenKind = Token.Beat;\n prevNote = false;\n break;\n case '-':\n consumeToken();\n tokenKind = Token.Tempo;\n prevNote = false;\n break;\n case '^':\n consumeToken();\n tokenKind = Token.EndHz;\n break;\n default:\n if (tokenKind == Token.Note)\n tokenKind = Token.Octave;\n token += noteChar;\n prevNote = false;\n break;\n }\n }\n consumeToken();\n\n if (note && hz < 0) {\n const keyNumber = note + (12 * (octave - 1));\n hz = freqs.getNumber(NumberFormat.UInt16LE, keyNumber * 2) || 0;\n }\n\n let currMs = ms\n\n if (currMs <= 0) {\n const beat = Math.idiv(15000, tempo);\n currMs = duration * beat\n }\n\n if (hz < 0) {\n // no frequency specified, so no duration\n } else if (hz == 0) {\n timePos += currMs\n } else {\n if (endHz < 0) {\n endHz = hz;\n }\n\n sndInstrPtr = 0\n addForm(envA, 0, 255, 0)\n addForm(envD, 255, envS, envA)\n addForm(currMs - (envA + envD), envS, envS, envD + envA)\n addForm(envR, envS, 0, currMs)\n\n this.queuePlayInstructions(timePos - now, sndInstr.slice(0, sndInstrPtr))\n endHz = -1;\n timePos += currMs // don't add envR - it's supposed overlap next sound\n }\n\n let timeLeft = timePos - now\n if (timeLeft > 200) {\n pause(timeLeft - 100)\n now = control.millis() - startTime\n }\n }\n }\n }\n\n //% fixedInstance whenUsed block=\"ba ding\"\n export const baDing = new Melody('b5:1 e6:3')\n\n //% fixedInstance whenUsed block=\"wawawawaa\"\n export const wawawawaa = new Melody('~15 e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8')\n\n //% fixedInstance whenUsed block=\"jump up\"\n export const jumpUp = new Melody('c5:1 d e f g')\n\n //% fixedInstance whenUsed block=\"jump down\"\n export const jumpDown = new Melody('g5:1 f e d c')\n\n //% fixedInstance whenUsed block=\"power up\"\n export const powerUp = new Melody('g4:1 c5 e g:2 e:1 g:3')\n\n //% fixedInstance whenUsed block=\"power down\"\n export const powerDown = new Melody('g5:1 d# c g4:2 b:1 c5:3')\n\n //% fixedInstance whenUsed block=\"magic wand\"\n export const magicWand = new Melody('F#6:1-300 G# A# B C7# D# F F# G# A# B:6')\n //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n\n //% fixedInstance whenUsed block=\"siren\"\n export const siren = new Melody('a4 d5 a4 d5 a4 d5')\n\n //% fixedInstance whenUsed block=\"pew pew\"\n export const pewPew = new Melody('!1200,200^50')\n\n //% fixedInstance whenUsed block=\"knock\"\n export const knock = new Melody('~4 @0,0,255,150 !300,1 !211,1')\n\n //% fixedInstance whenUsed block=\"footstep\"\n export const footstep = new Melody('~4 @0,0,60,50 !200,1')\n\n //% fixedInstance whenUsed block=\"thump\"\n export const thump = new Melody('~4 @0,0,255,150 !100,1')\n\n //% fixedInstance whenUsed block=\"small crash\"\n export const smallCrash = new Melody('~4 @10,490,0,1 !800,1')\n\n //% fixedInstance whenUsed block=\"big crash\"\n export const bigCrash = new Melody('~4 @10,990,0,1 !400,1')\n\n //% fixedInstance whenUsed block=\"zapped\"\n export const zapped = new Melody('~16 @10,490,0,0 !1600,500^1')\n\n //% fixedInstance whenUsed block=\"buzzer\"\n export const buzzer = new Melody('~16 @10,0,255,250 !2000,300')\n\n //% fixedInstance whenUsed block=\"sonar\"\n export const sonar = new Melody('~16 @10,1500,0,0 !200,1 !200,1500^190')\n\n //% fixedInstance whenUsed block=\"spooky\"\n export const spooky = new Melody('~16 @700,1300,0,0 !100,1 ~18 !108,2000')\n\n //% fixedInstance whenUsed block=\"beam up\"\n export const beamUp = new Melody('~18 @10,1500,0,0 !200,1500^4000')\n}\n",
"music.ts": "enum Note {\n //% blockIdentity=music.noteFrequency enumval=262\n C = 262,\n //% block=C#\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F = 349,\n //% block=F#\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G = 392,\n //% block=G#\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B = 494,\n //% blockIdentity=music.noteFrequency enumval=131\n C3 = 131,\n //% block=C#3\n //% blockIdentity=music.noteFrequency enumval=139\n CSharp3 = 139,\n //% blockIdentity=music.noteFrequency enumval=147\n D3 = 147,\n //% blockIdentity=music.noteFrequency enumval=156\n Eb3 = 156,\n //% blockIdentity=music.noteFrequency enumval=165\n E3 = 165,\n //% blockIdentity=music.noteFrequency enumval=175\n F3 = 175,\n //% block=F#3\n //% blockIdentity=music.noteFrequency enumval=185\n FSharp3 = 185,\n //% blockIdentity=music.noteFrequency enumval=196\n G3 = 196,\n //% block=G#3\n //% blockIdentity=music.noteFrequency enumval=208\n GSharp3 = 208,\n //% blockIdentity=music.noteFrequency enumval=220\n A3 = 220,\n //% blockIdentity=music.noteFrequency enumval=233\n Bb3 = 233,\n //% blockIdentity=music.noteFrequency enumval=247\n B3 = 247,\n //% blockIdentity=music.noteFrequency enumval=262\n C4 = 262,\n //% block=C#4\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp4 = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D4 = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb4 = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E4 = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F4 = 349,\n //% block=F#4\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp4 = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G4 = 392,\n //% block=G#4\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp4 = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A4 = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb4 = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B4 = 494,\n //% blockIdentity=music.noteFrequency enumval=523\n C5 = 523,\n //% block=C#5\n //% blockIdentity=music.noteFrequency enumval=555\n CSharp5 = 555,\n //% blockIdentity=music.noteFrequency enumval=587\n D5 = 587,\n //% blockIdentity=music.noteFrequency enumval=622\n Eb5 = 622,\n //% blockIdentity=music.noteFrequency enumval=659\n E5 = 659,\n //% blockIdentity=music.noteFrequency enumval=698\n F5 = 698,\n //% block=F#5\n //% blockIdentity=music.noteFrequency enumval=740\n FSharp5 = 740,\n //% blockIdentity=music.noteFrequency enumval=784\n G5 = 784,\n //% block=G#5\n //% blockIdentity=music.noteFrequency enumval=831\n GSharp5 = 831,\n //% blockIdentity=music.noteFrequency enumval=880\n A5 = 880,\n //% blockIdentity=music.noteFrequency enumval=932\n Bb5 = 932,\n //% blockIdentity=music.noteFrequency enumval=988\n B5 = 988,\n}\n\nenum BeatFraction {\n //% block=1\n Whole = 1,\n //% block=\"1/2\"\n Half = 2,\n //% block=\"1/4\"\n Quarter = 4,\n //% block=\"1/8\"\n Eighth = 8,\n //% block=\"1/16\"\n Sixteenth = 16,\n //% block=\"2\"\n Double = 32,\n //% block=\"4\",\n Breve = 64,\n //% block=\"1/3\",\n Triplet = 128\n}\n\nnamespace music {\n\n let beatsPerMinute: number;\n\n /**\n * Play a tone.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n */\n //% help=music/ring-tone\n //% blockId=music_ring block=\"ring tone|at %note=device_note\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music inBasicCategory=true\n //% weight=75 blockGap=8\n //% group=\"Tone\"\n export function ringTone(frequency: number) {\n playTone(frequency, 0);\n }\n\n /**\n * Rest, or play silence, for some time (in milliseconds).\n * @param ms rest duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/rest\n //% blockId=music_rest block=\"rest|for %duration=device_beat\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music\n //% weight=74\n //% group=\"Tone\"\n export function rest(ms: number) {\n playTone(0, Math.max(ms, 20));\n }\n\n function init() {\n if (!beatsPerMinute) beatsPerMinute = 120;\n }\n\n /**\n * Return the duration of a beat in milliseconds (the beat fraction).\n * @param fraction the fraction of the current whole note, eg: BeatFraction.Half\n */\n //% help=music/beat\n //% blockId=device_beat block=\"%fraction|beat\"\n //% weight=9 blockGap=8\n //% group=\"Tempo\"\n export function beat(fraction?: BeatFraction): number {\n init();\n if (fraction == null) fraction = BeatFraction.Whole;\n let beat = 60000 / beatsPerMinute;\n switch (fraction) {\n case BeatFraction.Half: beat /= 2; break;\n case BeatFraction.Quarter: beat /= 4; break;\n case BeatFraction.Eighth: beat /= 8; break;\n case BeatFraction.Sixteenth: beat /= 16; break;\n case BeatFraction.Double: beat *= 2; break;\n case BeatFraction.Breve: beat *= 4; break;\n case BeatFraction.Triplet: beat /= 3; break;\n }\n return beat >> 0;\n }\n\n /**\n * Return the tempo in beats per minute (bpm).\n * Tempo is the speed (bpm = beats per minute) at which notes play. The larger the tempo value, the faster the notes will play.\n */\n //% help=music/tempo\n //% blockId=device_tempo block=\"tempo (bpm)\"\n //% weight=64\n //% group=\"Tempo\"\n export function tempo(): number {\n init();\n return beatsPerMinute;\n }\n\n /**\n * Change the tempo up or down by some amount of beats per minute (bpm).\n * @param bpm The change in beats per minute to the tempo, eg: 20\n */\n //% help=music/change-tempo-by weight=37\n //% blockId=device_change_tempo block=\"change tempo by %value|(bpm)\"\n //% weight=66 blockGap=8\n //% group=\"Tempo\"\n export function changeTempoBy(bpm: number): void {\n init();\n setTempo(beatsPerMinute + bpm);\n }\n\n /**\n * Set the tempo a number of beats per minute (bpm).\n * @param bpm The new tempo in beats per minute, eg: 120\n */\n //% help=music/set-tempo\n //% blockId=device_set_tempo block=\"set tempo to %value|(bpm)\"\n //% bpm.min=4 bpm.max=400\n //% weight=65 blockGap=8\n //% group=\"Tempo\"\n export function setTempo(bpm: number): void {\n init();\n if (bpm > 0) {\n beatsPerMinute = Math.max(1, bpm >> 0);\n }\n }\n}\n",
"ns.ts": "\n/**\n * Generation of music tones.\n */\n//% color=#E30FC0 weight=90 icon=\"\\uf025\"\n//% blockGap=8\n//% groups='[\"Sounds\", \"Melody\", \"Tone\", \"Volume\", \"Tempo\"]'\nnamespace music {\n}",
"piano.ts": "namespace music {\n /**\n * Get the frequency of a note.\n * @param name the note name, eg: Note.C\n */\n //% weight=1 help=music/note-frequency\n //% blockId=device_note block=\"%note\"\n //% shim=TD_ID\n //% color=\"#FFFFFF\" colorSecondary=\"#FFFFFF\" colorTertiary=\"#D83B01\"\n //% note.fieldEditor=\"note\" note.defl=\"262\"\n //% note.fieldOptions.decompileLiterals=true\n //% useEnumVal=1\n //% weight=10 blockGap=8\n //% group=\"Tone\"\n export function noteFrequency(name: Note): number {\n return name;\n }\n}",
"pxt.json": "{\n \"name\": \"mixer---nrf52\",\n \"description\": \"The music library with a mixer\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"SoundOutput.h\",\n \"sound.cpp\",\n \"melody.h\",\n \"melody.cpp\",\n \"melody.ts\",\n \"piano.ts\",\n \"legacy.ts\",\n \"ns.ts\",\n \"targetoverrides.ts\",\n \"music.ts\",\n \"pxtparts.json\",\n \"headphone.svg\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"pxtparts.json": "{\n \"headphone\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"image\": \"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\": \"A0\",\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}",
"sound.cpp": "// to be overridden\n",
"targetoverrides.ts": "\n",
"test.ts": "for(let i = 1000; i > 0; i -= 50)\n music.playTone(440, i)\n\nfor(let i = 0; i < 1000; i += 20)\n music.playTone(440, i)\n"
},
"mixer---rp2040": {
"SoundOutput.h": "#include \"RP2040PWM.h\"\n#include \"Synthesizer.h\"\n#include \"Mixer.h\"\n\nnamespace jacdac {\nvoid setJackRouterOutput(int output);\n}\n\nclass SoundOutput {\n public:\n RP2040PWM dac;\n\n SoundOutput(DataSource &data) : dac(*LOOKUP_PIN(JACK_SND), data) {\n jacdac::setJackRouterOutput(-1);\n }\n\n void setOutput(int output) { jacdac::setJackRouterOutput(output); }\n};\n",
"headphone.svg": "",
"legacy.ts": "//% deprecated=true hidden=true\nenum Sounds {\n //% block=\"power up\"\n PowerUp,\n //% block=\"power down\"\n PowerDown,\n //% block=\"jump up\"\n JumpUp,\n //% block=\"jump down\"\n JumpDown,\n //% block=\"ba ding\"\n BaDing,\n //% block=\"wawawawaa\"\n Wawawawaa,\n //% block=\"magic wand\"\n MagicWand,\n //% block=\"siren\"\n Siren\n}\n\nnamespace music {\n /**\n * Get the melody string for a built-in melody.\n * @param name the note name, eg: Note.C\n */\n //% help=music/sounds\n //% blockId=music_sounds block=\"%name\"\n //% blockHidden=true\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=285\n //% name.fieldOptions.columns=3\n export function sounds(name: Sounds): string {\n switch (name) {\n case Sounds.BaDing:\n return 'b5:1 e6:3';\n case Sounds.Wawawawaa:\n return 'e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8';\n case Sounds.JumpUp:\n return 'c5:1 d e f g';\n case Sounds.JumpDown:\n return 'g5:1 f e d c';\n case Sounds.PowerUp:\n return 'g4:1 c5 e g:2 e:1 g:3';\n case Sounds.PowerDown:\n return 'g5:1 d# c g4:2 b:1 c5:3';\n case Sounds.MagicWand:\n return 'F#6:1-300 G# A# B C7# D# F F# G# A# B:6'; //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n case Sounds.Siren:\n return 'a4 d5 a4 d5 a4 d5';\n default:\n return '';\n }\n }\n\n let currMelody: Melody\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound\n //% blockId=music_play_sound block=\"play sound %sound=music_sounds\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% deprecated=true hidden=true\n export function playSound(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.play();\n pause(1);\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * Notes are expressed as a string of characters with this format: NOTE[octave][:duration]\n * @param sound the melody to play\n */\n //% help=music/play-sound-until-done\n //% blockId=music_play_sound_until_done block=\"play sound %sound=music_sounds|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% deprecated=true hidden=true\n export function playSoundUntilDone(sound: string) {\n stopAllSounds();\n currMelody = new Melody(sound);\n currMelody.playUntilDone();\n }\n}",
"melody.cpp": "#include \"pxt.h\"\n#include \"SoundOutput.h\"\n#include \"melody.h\"\n\n//#define LOG DMESG\n#define LOG NOLOG\n\nnamespace music {\n\nSINGLETON(WSynthesizer);\n\n// Tone generator arguments:\n//\n// sound: a pointer to the currently-playing sound, usable for looking up the\n// waveform or generator-specific state.\n//\n// position: offset within the currently-playing wave, range 0..1023.\n//\n// cycle: a 6-bit cyclical sequence number of the wave, incremented each time\n// the position loops from 1023 back to 0.\ntypedef int (*gentone_t)(PlayingSound *sound, uint32_t position, uint8_t cycle);\n\nstatic int noiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)position;\n (void)cycle;\n // see https://en.wikipedia.org/wiki/Xorshift\n static uint32_t x = 0xf01ba80;\n x ^= x << 13;\n x ^= x >> 17;\n x ^= x << 5;\n return (x & 0xffff) - 0x7fff;\n}\n\nstatic int sineTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n int32_t p = position;\n if (p >= 512) {\n p -= 512;\n }\n if (p > 256) {\n p = 512 - p;\n }\n\n // Approximate sin(x * pi / 2) with the odd polynomial y = cx^5 + bx^3 + ax\n // using the constraint y(1) = 1 => a = 1 - b - c\n // => y = c x^5 + b x^3 + (1 - b - c) * x\n //\n // Do a least-squares fit of this to sin(x * pi / 2) in the range 0..1\n // inclusive, using 21 evenly spaced points. Resulting approximation:\n //\n // sin(x*pi/2) ~= 0.0721435357258*x**5 - 0.642443736562*x**3 + 1.57030020084*x\n\n // Scale the constants by 32767 to match the desired output range.\n constexpr int32_t c = 0.0721435357258 * 32767;\n constexpr int32_t b = -0.642443736562 * 32767;\n constexpr int32_t a = 1.57030020084 * 32767;\n\n // Calculate using y = ((c * x^2 + b) * x^2 + a) * x\n //\n // The position p is x * 256, so after each multiply with p we need to\n // shift right by 8 bits to keep the decimal point in the same place. (The\n // approximation has a negative error near x=1 which helps avoid overflow.)\n int32_t p2 = p * p;\n int32_t u = (c * p2 >> 16) + b;\n int32_t v = (u * p2 >> 16) + a;\n int32_t w = v * p >> 8;\n\n // The result is within 7/32767 or 0.02%, signal-to-error ratio about 38 dB.\n return position >= 512 ? -w : w;\n}\n\nstatic int sawtoothTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n return (position << 6) - 0x7fff;\n}\n\nstatic int triangleTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)sound;\n (void)cycle;\n return position < 512 ? (position << 7) - 0x7fff : ((1023 - position) << 7) - 0x7fff;\n}\n\nstatic int squareWaveTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n (void)cycle;\n uint8_t wave = sound->currInstr->soundWave;\n return (int)position < (102 * (wave - SW_SQUARE_10 + 1)) ? -0x7fff : 0x7fff;\n}\n\nstatic int tunedNoiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a random bit sequence. Since the generator\n // is called multiple times per wave, use PlayingSound state data to ensure we\n // only generate a random bit once per wave, and then reuse it for future\n // calls for that wave.\n //\n // Use the low 6 bits of generatorState to store the last-used cycle, and\n // random_bit to store the last on/off state. (random_bit is arbitrary as\n // long as it isn't one of the low 6 bits.)\n constexpr uint32_t random_bit = 0x8000;\n static uint32_t x = 0xf01ba80; // seed for the static RNG state\n uint8_t prev_cycle = sound->generatorState & 0x3f;\n uint32_t is_on;\n if (cycle == prev_cycle) {\n is_on = sound->generatorState & random_bit;\n } else {\n // see https://en.wikipedia.org/wiki/Xorshift\n x ^= x << 13;\n x ^= x >> 17;\n x ^= x << 5;\n is_on = (x & random_bit);\n sound->generatorState = (cycle & 0x3f) | is_on;\n }\n if (!is_on)\n return 0;\n return position < 512 ? -0x7fff : 0x7fff;\n}\n\n// Bit patterns for use by the cyclic noise tone.\n//\n// The bit pattern is arbitrary, but should have equal numbers of 0 and 1 bits,\n// and should avoid long identical-bit runs for the lower parts. The values below\n// were chosen based on a random permutation of the hex nibbles 0..f and then\n// hand-tweaked by swapping some nibbles. Generated by:\n//\n// shuf -i 0-15 | perl -ne 's/(\\d+)/printf(\"%x\",$1)/e'\nstatic const uint32_t cycle_bits[] = {0x2df0eb47, 0xc8165a93};\nstatic const uint8_t cycle_mask[] = {0xf, 0x1f, 0x3f};\n\nstatic int cycleNoiseTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a short-cycle pseudorandom bit sequence.\n // The bit sequence repeats every 16/32/64 waves.\n //\n // The \"cycle\" argument corresponds to the sequential number of the generated\n // wave. This is currently a 6-bit value. Since the pseudorandom bit sequences\n // evenly fit into this, there's no need to track generator state.\n uint8_t wave = sound->currInstr->soundWave;\n int cycle_index = wave - SW_SQUARE_CYCLE_16;\n // CLAMP(0, cycle_index, sizeof cycle_bits / sizeof cycle_bits[0])\n cycle &= cycle_mask[cycle_index];\n bool is_on = (cycle_bits[cycle >> 5] & (1U << (cycle & 0x1f)));\n if (!is_on)\n return 0;\n return position < 512 ? -0x7fff : 0x7fff;\n}\n\nstatic int silenceTone(PlayingSound *sound, uint32_t position, uint8_t cycle) {\n // Generate a square wave filtered by a short-cycle pseudorandom bit sequence.\n (void)sound;\n (void)position;\n (void)cycle;\n return 0;\n}\n\nstatic gentone_t getWaveFn(uint8_t wave) {\n switch (wave) {\n case SW_TRIANGLE:\n return triangleTone;\n case SW_SAWTOOTH:\n return sawtoothTone;\n case SW_TUNEDNOISE:\n return tunedNoiseTone;\n case SW_NOISE:\n return noiseTone;\n case SW_SINE:\n return sineTone;\n default:\n if (SW_SQUARE_10 <= wave && wave <= SW_SQUARE_50)\n return squareWaveTone;\n if (SW_SQUARE_CYCLE_16 <= wave && wave <= SW_SQUARE_CYCLE_64)\n return cycleNoiseTone;\n else\n return silenceTone;\n }\n}\n\n#define CLAMP(lo, v, hi) ((v) = ((v) < (lo) ? (lo) : (v) > (hi) ? (hi) : (v)))\n\nint WSynthesizer::updateQueues() {\n const int maxTime = 0xffffff;\n while (1) {\n WaitingSound *p;\n int minLeft = maxTime;\n for (p = waiting; p; p = p->next) {\n int timeLeft =\n p->state == SoundState::Waiting ? p->startSampleNo - currSample : maxTime;\n if (timeLeft <= 0) {\n break;\n }\n if (timeLeft < minLeft)\n minLeft = timeLeft;\n }\n if (p) {\n PlayingSound *snd;\n int minIdx = -1;\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n snd = &playingSounds[i];\n if (snd->sound == NULL)\n break;\n if (minIdx == -1 ||\n playingSounds[minIdx].startSampleNo < playingSounds[i].startSampleNo)\n minIdx = i;\n snd = NULL;\n }\n // if we didn't find a free slot, expel the oldest sound\n if (!snd)\n snd = &playingSounds[minIdx];\n if (snd->sound)\n snd->sound->state = SoundState::Done;\n snd->sound = p;\n p->state = SoundState::Playing;\n snd->startSampleNo = currSample;\n snd->currInstr = (SoundInstruction *)p->instructions->data;\n snd->instrEnd = snd->currInstr + p->instructions->length / sizeof(SoundInstruction);\n snd->prevVolume = -1;\n } else {\n // no more sounds to move\n return minLeft;\n }\n }\n}\n\nint WSynthesizer::fillSamples(int16_t *dst, int numsamples) {\n if (numsamples <= 0)\n return 1;\n\n int timeLeft = updateQueues();\n int res = waiting != NULL;\n\n // if there's a pending sound to be started somewhere during numsamples,\n // split the call into two\n if (timeLeft < numsamples) {\n fillSamples(dst, timeLeft);\n LOG(\"M split %d\", timeLeft);\n fillSamples(dst + timeLeft, numsamples - timeLeft);\n return 1;\n }\n\n memset(dst, 0, numsamples * 2);\n\n uint32_t samplesPerMS = (sampleRate << 8) / 1000;\n float toneStepMult = (1024.0 * (1 << 16)) / sampleRate;\n const int MAXVAL = (1 << (OUTPUT_BITS - 1)) - 1;\n\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n PlayingSound *snd = &playingSounds[i];\n if (snd->sound == NULL)\n continue;\n\n res = 1;\n\n SoundInstruction *instr = NULL;\n gentone_t fn = NULL;\n snd->currInstr--;\n uint32_t toneStep = 0;\n int32_t toneDelta = 0;\n int32_t volumeStep = 0;\n uint32_t tonePosition = snd->tonePosition;\n uint32_t samplesLeft = 0;\n uint8_t wave = 0;\n int32_t volume = 0;\n\n for (int j = 0; j < numsamples; ++j) {\n if (samplesLeft == 0) {\n snd->currInstr++;\n if (snd->currInstr >= snd->instrEnd) {\n break;\n }\n SoundInstruction copy = *snd->currInstr;\n instr = ©\n CLAMP(20, instr->frequency, 20000);\n CLAMP(20, instr->endFrequency, 20000);\n CLAMP(0, instr->startVolume, 1023);\n CLAMP(0, instr->endVolume, 1023);\n CLAMP(1, instr->duration, 60000);\n\n wave = instr->soundWave;\n fn = getWaveFn(wave);\n\n samplesLeft = (uint32_t)(instr->duration * samplesPerMS >> 8);\n // make sure the division is signed\n volumeStep =\n (int)((instr->endVolume - instr->startVolume) << 16) / (int)samplesLeft;\n\n if (j == 0 && snd->prevVolume != -1) {\n // restore previous state\n samplesLeft = snd->samplesLeftInCurr;\n volume = snd->prevVolume;\n toneStep = snd->prevToneStep;\n toneDelta = snd->prevToneDelta;\n } else {\n LOG(\"#sampl %d %p\", samplesLeft, snd->currInstr);\n volume = instr->startVolume << 16;\n LOG(\"%d-%dHz %d-%d vol\", instr->frequency, instr->endFrequency,\n instr->startVolume, instr->endVolume);\n toneStep = (uint32_t)(toneStepMult * instr->frequency);\n if (instr->frequency != instr->endFrequency) {\n uint32_t endToneStep = (uint32_t)(toneStepMult * instr->endFrequency);\n toneDelta = (int32_t)(endToneStep - toneStep) / (int32_t)samplesLeft;\n } else {\n toneDelta = 0;\n }\n }\n }\n\n int v = fn(snd, (tonePosition >> 16) & 1023, tonePosition >> 26);\n v = (v * (volume >> 16)) >> (10 + (16 - OUTPUT_BITS));\n\n // if (v > MAXVAL)\n // target_panic(123);\n\n dst[j] += v;\n\n tonePosition += toneStep;\n toneStep += toneDelta;\n volume += volumeStep;\n samplesLeft--;\n }\n\n if (snd->currInstr >= snd->instrEnd) {\n snd->sound->state = SoundState::Done;\n snd->sound = NULL;\n } else {\n snd->tonePosition = tonePosition;\n if (samplesLeft == 0)\n samplesLeft++; // avoid infinite loop in next iteration\n snd->samplesLeftInCurr = samplesLeft;\n snd->prevVolume = volume;\n snd->prevToneDelta = toneDelta;\n snd->prevToneStep = toneStep;\n }\n }\n\n currSample += numsamples;\n\n for (int j = 0; j < numsamples; ++j) {\n if (dst[j] > MAXVAL)\n dst[j] = MAXVAL;\n else if (dst[j] < -MAXVAL)\n dst[j] = -MAXVAL;\n }\n\n return res;\n}\n\n//%\nvoid enableAmp(int enabled) {\n // this is also compiled on linux\n#ifdef LOOKUP_PIN\n auto pin = LOOKUP_PIN(SPEAKER_AMP);\n if (pin) {\n if (PIN(SPEAKER_AMP) & CFG_PIN_CONFIG_ACTIVE_LO)\n enabled = !enabled;\n pin->setDigitalValue(enabled);\n }\n#endif\n}\n\n//%\nvoid forceOutput(int outp) {\n auto snd = getWSynthesizer();\n snd->out.setOutput(outp);\n}\n\n//%\nvoid queuePlayInstructions(int when, Buffer buf) {\n auto snd = getWSynthesizer();\n\n registerGCObj(buf);\n\n auto p = new WaitingSound;\n p->state = SoundState::Waiting;\n p->instructions = buf;\n p->startSampleNo = snd->currSample + when * snd->sampleRate / 1000;\n\n LOG(\"Queue %dms now=%d off=%d %p sampl:%dHz\", when, snd->currSample,\n p->startSampleNo - snd->currSample, buf->data, snd->sampleRate);\n\n target_disable_irq();\n // add new sound to queue\n p->next = snd->waiting;\n snd->waiting = p;\n // remove sounds that have already been fully played\n while (p) {\n while (p->next && p->next->state == SoundState::Done) {\n auto todel = p->next;\n p->next = todel->next;\n unregisterGCObj(todel->instructions);\n delete todel;\n }\n p = p->next;\n }\n target_enable_irq();\n\n snd->poke();\n}\n\n//%\nvoid stopPlaying() {\n LOG(\"stop playing!\");\n\n auto snd = getWSynthesizer();\n\n target_disable_irq();\n auto p = snd->waiting;\n snd->waiting = NULL;\n for (unsigned i = 0; i < MAX_SOUNDS; ++i) {\n snd->playingSounds[i].sound = NULL;\n }\n while (p) {\n auto n = p->next;\n unregisterGCObj(p->instructions);\n delete p;\n p = n;\n }\n target_enable_irq();\n}\n\nWSynthesizer::WSynthesizer() : upstream(NULL), out(*this) {\n currSample = 0;\n active = false;\n sampleRate = out.dac.getSampleRate();\n memset(&playingSounds, 0, sizeof(playingSounds));\n waiting = NULL;\n PXT_REGISTER_RESET(stopPlaying);\n}\n\n} // namespace music\n\nnamespace pxt {\nint redirectSamples(int16_t *dst, int numsamples, int samplerate) {\n auto snd = music::getWSynthesizer();\n snd->upstream = NULL; // disconnect from regular playback mechanism\n snd->sampleRate = samplerate;\n return snd->fillSamples(dst, numsamples);\n}\n\n} // namespace pxt\n\nnamespace jacdac {\n__attribute__((weak)) void setJackRouterOutput(int output) {}\n} // namespace jacdac\n",
"melody.h": "#pragma once\n\n#ifndef OUTPUT_BITS\n#define OUTPUT_BITS 10\n#endif\n\n#define SW_TRIANGLE 1\n#define SW_SAWTOOTH 2\n#define SW_SINE 3\n#define SW_TUNEDNOISE 4\n#define SW_NOISE 5\n#define SW_SQUARE_10 11\n#define SW_SQUARE_50 15\n#define SW_SQUARE_CYCLE_16 16\n#define SW_SQUARE_CYCLE_32 17\n#define SW_SQUARE_CYCLE_64 18\n\nstruct SoundInstruction {\n uint8_t soundWave;\n uint8_t flags;\n uint16_t frequency; // Hz\n uint16_t duration; // ms\n int16_t startVolume; // 0-1023\n int16_t endVolume; // 0-1023\n uint16_t endFrequency; // Hz\n};\n\n#ifdef DATASTREAM_MAXIMUM_BUFFERS\n#define CODAL 1\n#endif\n\nnamespace music {\n\n#define MAX_SOUNDS 5\n\nSTATIC_ASSERT((1 << (16 - OUTPUT_BITS)) > MAX_SOUNDS);\n\nenum class SoundState : uint8_t {\n Waiting, //\n Playing, //\n Done //\n};\n\nstruct WaitingSound {\n uint32_t startSampleNo;\n SoundState state;\n WaitingSound *next;\n Buffer instructions;\n};\n\nstruct PlayingSound {\n uint32_t startSampleNo;\n uint32_t samplesLeftInCurr;\n uint32_t tonePosition;\n int32_t prevVolume;\n uint32_t prevToneStep;\n int32_t prevToneDelta;\n uint32_t generatorState;\n WaitingSound *sound;\n SoundInstruction *currInstr, *instrEnd;\n};\n\nclass WSynthesizer\n#ifdef CODAL\n : public DataSource\n#endif\n{\n public:\n#ifdef CODAL\n DataSink *upstream;\n#else\n void *upstream;\n#endif\n uint32_t currSample; // after 25h of playing we might get a glitch\n int32_t sampleRate; // eg 44100\n PlayingSound playingSounds[MAX_SOUNDS];\n WaitingSound *waiting;\n bool active;\n\n SoundOutput out;\n\n int fillSamples(int16_t *dst, int numsamples);\n int updateQueues();\n\n WSynthesizer();\n virtual ~WSynthesizer() {}\n\n void pokeUpstream() {\n#ifdef CODAL\n if (upstream) {\n upstream->pullRequest();\n }\n#endif\n }\n\n void poke() {\n if (!active) {\n active = true;\n pokeUpstream();\n }\n }\n\n#ifdef CODAL\n virtual ManagedBuffer pull() {\n if (!upstream)\n return ManagedBuffer();\n ManagedBuffer data(512);\n auto dp = (int16_t *)data.getBytes();\n auto sz = 512 / 2;\n int r = fillSamples(dp, sz);\n#if defined(NRF52_SERIES)\n int mul = out.dac.getSampleRange();\n#endif\n while (sz--) {\n#if defined(NRF52_SERIES)\n *dp = ((-*dp + (1 << (OUTPUT_BITS - 1))) * mul) >> OUTPUT_BITS;\n#else\n *dp += 1 << (OUTPUT_BITS - 1);\n#endif\n dp++;\n }\n if (!r) {\n active = false;\n // return empty - nothing left to play\n return ManagedBuffer();\n }\n pokeUpstream();\n return data;\n }\n virtual void connect(DataSink &sink) { upstream = &sink; }\n#endif\n};\n\n} // namespace music\n",
"melody.ts": "enum MusicOutput {\n AutoDetect = 0,\n Buzzer = 1,\n HeadPhones = 2,\n}\n\nnamespace music {\n //% whenUsed\n const freqs = hex`\n 1f00210023002500270029002c002e003100340037003a003e004100450049004e00520057005c00620068006e00\n 75007b0083008b0093009c00a500af00b900c400d000dc00e900f70006011501260137014a015d01720188019f01\n b801d201ee010b022a024b026e029302ba02e40210033f037003a403dc03170455049704dd0427057505c8052006\n 7d06e0064907b8072d08a9082d09b9094d0aea0a900b400cfa0cc00d910e6f0f5a1053115b1272139a14d4152017\n 8018f519801b231dde1e`\n\n //% shim=music::queuePlayInstructions\n function queuePlayInstructions(timeDelta: number, buf: Buffer) { }\n\n //% shim=music::stopPlaying\n function stopPlaying() { }\n\n //% shim=music::forceOutput\n export function forceOutput(buf: MusicOutput) { }\n\n let globalVolume: number = null\n\n const BUFFER_SIZE: number = 12;\n\n //% shim=music::enableAmp\n function enableAmp(en: number) {\n return // for sim\n }\n\n function initVolume() {\n if (globalVolume === null) {\n globalVolume = 0\n setVolume(control.getConfigValue(DAL.CFG_SPEAKER_VOLUME, 128))\n }\n }\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 //% parts=\"speaker\"\n //% volume.min=0 volume.max=255\n //% volume.defl=20\n //% help=music/set-volume\n //% weight=70\n //% group=\"Volume\"\n export function setVolume(volume: number): void {\n globalVolume = Math.clamp(0, 255, volume | 0)\n enableAmp(globalVolume > 0 ? 1 : 0)\n }\n\n /**\n * Gets the current volume\n */\n //% parts=\"speaker\"\n //% weight=70\n export function volume(): number {\n initVolume()\n return globalVolume;\n }\n\n function playNoteCore(when: number, frequency: number, ms: number) {\n let buf = control.createBuffer(BUFFER_SIZE)\n addNote(buf, 0, ms, 255, 255, 3, frequency, volume(), frequency)\n queuePlayInstructions(when, buf)\n }\n\n /**\n * Play a tone through the speaker for some amount of time.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n * @param ms tone duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/play-tone\n //% blockId=mixer_play_note block=\"play tone|at %note=device_note|for %duration=device_beat\"\n //% parts=\"headphone\" async\n //% blockNamespace=music\n //% weight=76 blockGap=8\n //% group=\"Tone\"\n export function playTone(frequency: number, ms: number): void {\n if (ms == 0)\n ms = 86400000 // 1 day\n\n if (ms <= 2000) {\n playNoteCore(0, frequency, ms)\n pause(ms)\n } else {\n const id = ++playToneID\n control.runInParallel(() => {\n let pos = control.millis()\n while (id == playToneID && ms > 0) {\n let now = control.millis()\n let d = pos - now\n let t = Math.min(ms, 500)\n ms -= t\n pos += t\n playNoteCore(d - 1, frequency, t)\n if (ms == 0)\n pause(d + t)\n else\n pause(d + t - 100)\n }\n })\n }\n }\n\n let playToneID = 0\n\n /**\n * Play a melody from the melody editor.\n * @param melody - string of up to eight notes [C D E F G A B C5] or rests [-] separated by spaces, \n * which will be played one at a time, ex: \"E D G F B A C5 B \"\n * @param tempo - number in beats per minute (bpm), dictating how long each note will play for\n */\n //% block=\"play melody $melody at tempo $tempo|(bpm)\" blockId=playMelody\n //% blockNamespace=music\n //% weight=85 blockGap=8 help=music/play-melody\n //% group=\"Melody\"\n //% melody.shadow=\"melody_editor\"\n //% tempo.min=40 tempo.max=500\n //% tempo.defl=120\n export function playMelody(melody: string, tempo: number) {\n let notes: string[] = melody.split(\" \").filter(n => !!n);\n let formattedMelody = \"\";\n let newOctave = false;\n\n // build melody string, replace '-' with 'R' and add tempo\n // creates format like \"C5-174 B4 A G F E D C \"\n for (let i = 0; i < notes.length; i++) {\n if (notes[i] === \"-\") {\n notes[i] = \"R\";\n } else if (notes[i] === \"C5\") {\n newOctave = true;\n } else if (newOctave) { // change the octave if necesary\n notes[i] += \"4\";\n newOctave = false;\n }\n // add tempo after first note\n if (i == 0) {\n formattedMelody += notes[i] + \"-\" + tempo + \" \";\n } else {\n formattedMelody += notes[i] + \" \";\n }\n }\n\n const song = new Melody(formattedMelody);\n song.playUntilDone();\n }\n\n\n /**\n * Create a melody with the melody editor.\n * @param melody\n */\n //% block=\"$melody\" blockId=melody_editor\n //% blockNamespace=music\n //% blockHidden = true\n //% weight=85 blockGap=8\n //% help=music/melody-editor\n //% group=\"Melody\" duplicateShadowOnDrag\n //% melody.fieldEditor=\"melody\"\n //% melody.fieldOptions.decompileLiterals=true\n //% melody.fieldOptions.decompileIndirectFixedInstances=\"true\"\n //% melody.fieldOptions.onParentBlock=\"true\"\n //% shim=TD_ID\n export function melodyEditor(melody: string): string {\n return melody;\n }\n\n /**\n * Stop all sounds from playing.\n */\n //% help=music/stop-all-sounds\n //% blockId=music_stop_all_sounds block=\"stop all sounds\"\n //% weight=10\n //% group=\"Sounds\"\n export function stopAllSounds() {\n Melody.stopAll();\n stopPlaying();\n }\n\n //% fixedInstances\n export class Melody {\n _text: string;\n private _player: MelodyPlayer;\n\n private static playingMelodies: Melody[];\n\n static stopAll() {\n if (Melody.playingMelodies) {\n const ms = Melody.playingMelodies.slice(0, Melody.playingMelodies.length);\n ms.forEach(p => p.stop());\n }\n }\n\n constructor(text: string) {\n this._text = text\n }\n\n get text() {\n return this._text;\n }\n\n /**\n * Stop playing a sound\n */\n //% blockId=mixer_stop block=\"stop sound %sound\"\n //% help=music/melody/stop\n //% parts=\"headphone\"\n //% weight=92 blockGap=8\n //% group=\"Sounds\"\n stop() {\n if (this._player) {\n this._player.stop()\n this._player = null\n }\n this.unregisterMelody();\n }\n\n private registerMelody() {\n // keep track of the active players\n if (!Melody.playingMelodies) Melody.playingMelodies = [];\n // stop and pop melodies if too many playing\n if (Melody.playingMelodies.length > 4) {\n // stop last player (also pops)\n Melody.playingMelodies[Melody.playingMelodies.length - 1].stop();\n }\n // put back the melody on top of the melody stack\n Melody.playingMelodies.removeElement(this);\n Melody.playingMelodies.push(this);\n }\n private unregisterMelody() {\n // remove from list\n if (Melody.playingMelodies) {\n Melody.playingMelodies.removeElement(this); // remove self\n }\n }\n\n private playCore(volume: number, loop: boolean) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this.registerMelody();\n control.runInParallel(() => {\n while (this._player == p) {\n p.play(volume)\n if (!loop) {\n // Unregister the melody when done playing, but\n // only if it hasn't been restarted. (Looping\n // melodies never stop on their own, they only\n // get unregistered via stop().)\n if (this._player == p) {\n this.unregisterMelody();\n }\n break\n }\n }\n })\n }\n\n /**\n * Start playing a sound in a loop and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/loop\n //% blockId=mixer_loop_sound block=\"loop sound %sound\"\n //% parts=\"headphone\"\n //% weight=93 blockGap=8\n //% group=\"Sounds\"\n loop(volume = 255) {\n this.playCore(volume, true)\n }\n\n /**\n * Start playing a sound and don't wait for it to finish.\n * @param sound the melody to play\n */\n //% help=music/melody/play\n //% blockId=mixer_play_sound block=\"play sound %sound\"\n //% parts=\"headphone\"\n //% weight=95 blockGap=8\n //% group=\"Sounds\"\n play(volume = 255) {\n this.playCore(volume, false)\n }\n\n\n /**\n * Play a sound and wait until the sound is done.\n * @param sound the melody to play\n */\n //% help=music/melody/play-until-done\n //% blockId=mixer_play_sound_until_done block=\"play sound %sound|until done\"\n //% parts=\"headphone\"\n //% weight=94 blockGap=8\n //% group=\"Sounds\"\n playUntilDone(volume = 255) {\n this.stop()\n const p = this._player = new MelodyPlayer(this)\n this._player.onPlayFinished = () => {\n if (p == this._player)\n this.unregisterMelody();\n }\n this.registerMelody();\n this._player.play(volume)\n }\n\n toString() {\n return this._text;\n }\n }\n\n function addNote(sndInstr: Buffer, sndInstrPtr: number, ms: number, beg: number, end: number, soundWave: number, hz: number, volume: number, endHz: number) {\n if (ms > 0) {\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, soundWave)\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr + 1, 0)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 2, hz)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 4, ms)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 6, (beg * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 8, (end * volume) >> 6)\n sndInstr.setNumber(NumberFormat.UInt16LE, sndInstrPtr + 10, endHz);\n sndInstrPtr += BUFFER_SIZE;\n }\n sndInstr.setNumber(NumberFormat.UInt8LE, sndInstrPtr, 0) // terminate\n return sndInstrPtr\n }\n\n\n export class MelodyPlayer {\n melody: Melody;\n\n onPlayFinished: () => void;\n\n constructor(m: Melody) {\n this.melody = m\n }\n\n stop() {\n this.melody = null\n }\n\n protected queuePlayInstructions(timeDelta: number, buf: Buffer) {\n queuePlayInstructions(timeDelta, buf)\n }\n\n play(volume: number) {\n if (!this.melody)\n return\n volume = Math.clamp(0, 255, (volume * music.volume()) >> 8)\n\n let notes = this.melody._text\n let pos = 0;\n let duration = 4; //Default duration (Crotchet)\n let octave = 4; //Middle octave\n let tempo = 120; // default tempo\n\n let hz = 0\n let endHz = -1\n let ms = 0\n let timePos = 0\n let startTime = control.millis()\n let now = 0\n\n let envA = 0\n let envD = 0\n let envS = 255\n let envR = 0\n let soundWave = 1 // triangle\n let sndInstr = control.createBuffer(5 * BUFFER_SIZE)\n let sndInstrPtr = 0\n\n const addForm = (formDuration: number, beg: number, end: number, msOff: number) => {\n let freqStart = hz;\n let freqEnd = endHz;\n\n const envelopeWidth = ms > 0 ? ms : duration * Math.idiv(15000, tempo) + envR;\n if (endHz != hz && envelopeWidth != 0) {\n const slope = (freqEnd - freqStart) / envelopeWidth;\n freqStart = hz + slope * msOff;\n freqEnd = hz + slope * (msOff + formDuration);\n }\n sndInstrPtr = addNote(sndInstr, sndInstrPtr, formDuration, beg, end, soundWave, freqStart, volume, freqEnd);\n }\n\n const scanNextWord = () => {\n if (!this.melody)\n return \"\"\n\n // eat space\n while (pos < notes.length) {\n const c = notes[pos];\n if (c != ' ' && c != '\\r' && c != '\\n' && c != '\\t')\n break;\n pos++;\n }\n\n // read note\n let note = \"\";\n while (pos < notes.length) {\n const c = notes[pos];\n if (c == ' ' || c == '\\r' || c == '\\n' || c == '\\t')\n break;\n note += c;\n pos++;\n }\n return note;\n }\n\n enum Token {\n Note,\n Octave,\n Beat,\n Tempo,\n Hz,\n EndHz,\n Ms,\n WaveForm,\n EnvelopeA,\n EnvelopeD,\n EnvelopeS,\n EnvelopeR\n }\n\n let token: string = \"\";\n let tokenKind = Token.Note;\n\n // [ABCDEFG] (\\d+) (:\\d+) (-\\d+)\n // note octave length tempo\n // R (:\\d+) - rest\n // !\\d+,\\d+ - sound at frequency with given length (Hz,ms); !\\d+ and !\\d+,:\\d+ also possible\n // @\\d+,\\d+,\\d+,\\d+ - ADSR envelope - ms,ms,volume,ms; volume is 0-255\n // ~\\d+ - wave form:\n // 1 - triangle\n // 2 - sawtooth\n // 3 - sine\n // 4 - pseudorandom square wave noise (tunable)\n // 5 - white noise (ignores frequency)\n // 11 - square 10%\n // 12 - square 20%\n // ...\n // 15 - square 50%\n // 16 - filtered square wave, cycle length 16\n // 17 - filtered square wave, cycle length 32\n // 18 - filtered square wave, cycle length 64\n\n const consumeToken = () => {\n if (token && tokenKind != Token.Note) {\n const d = parseInt(token);\n switch (tokenKind) {\n case Token.Octave: octave = d; break;\n case Token.Beat:\n duration = Math.max(1, Math.min(16, d));\n ms = -1;\n break;\n case Token.Tempo: tempo = Math.max(1, d); break;\n case Token.Hz: hz = d; tokenKind = Token.Ms; break;\n case Token.Ms: ms = d; break;\n case Token.WaveForm: soundWave = Math.clamp(1, 18, d); break;\n case Token.EnvelopeA: envA = d; tokenKind = Token.EnvelopeD; break;\n case Token.EnvelopeD: envD = d; tokenKind = Token.EnvelopeS; break;\n case Token.EnvelopeS: envS = Math.clamp(0, 255, d); tokenKind = Token.EnvelopeR; break;\n case Token.EnvelopeR: envR = d; break;\n case Token.EndHz: endHz = d; break;\n }\n token = \"\";\n }\n }\n\n while (true) {\n let currNote = scanNextWord();\n let prevNote: boolean = false;\n if (!currNote) {\n let timeLeft = timePos - now\n if (timeLeft > 0)\n pause(timeLeft)\n if (this.onPlayFinished)\n this.onPlayFinished();\n return;\n }\n\n hz = -1;\n\n let note: number = 0;\n token = \"\";\n tokenKind = Token.Note;\n\n for (let i = 0; i < currNote.length; i++) {\n let noteChar = currNote.charAt(i);\n switch (noteChar) {\n case 'c': case 'C': note = 1; prevNote = true; break;\n case 'd': case 'D': note = 3; prevNote = true; break;\n case 'e': case 'E': note = 5; prevNote = true; break;\n case 'f': case 'F': note = 6; prevNote = true; break;\n case 'g': case 'G': note = 8; prevNote = true; break;\n case 'a': case 'A': note = 10; prevNote = true; break;\n case 'B': note = 12; prevNote = true; break;\n case 'r': case 'R': hz = 0; prevNote = false; break;\n case '#': note++; prevNote = false; break;\n case 'b': if (prevNote) note--; else { note = 12; prevNote = true; } break;\n case ',':\n consumeToken();\n prevNote = false;\n break;\n case '!':\n tokenKind = Token.Hz;\n prevNote = false;\n break;\n case '@':\n consumeToken();\n tokenKind = Token.EnvelopeA;\n prevNote = false;\n break;\n case '~':\n consumeToken();\n tokenKind = Token.WaveForm;\n prevNote = false;\n break;\n case ':':\n consumeToken();\n tokenKind = Token.Beat;\n prevNote = false;\n break;\n case '-':\n consumeToken();\n tokenKind = Token.Tempo;\n prevNote = false;\n break;\n case '^':\n consumeToken();\n tokenKind = Token.EndHz;\n break;\n default:\n if (tokenKind == Token.Note)\n tokenKind = Token.Octave;\n token += noteChar;\n prevNote = false;\n break;\n }\n }\n consumeToken();\n\n if (note && hz < 0) {\n const keyNumber = note + (12 * (octave - 1));\n hz = freqs.getNumber(NumberFormat.UInt16LE, keyNumber * 2) || 0;\n }\n\n let currMs = ms\n\n if (currMs <= 0) {\n const beat = Math.idiv(15000, tempo);\n currMs = duration * beat\n }\n\n if (hz < 0) {\n // no frequency specified, so no duration\n } else if (hz == 0) {\n timePos += currMs\n } else {\n if (endHz < 0) {\n endHz = hz;\n }\n\n sndInstrPtr = 0\n addForm(envA, 0, 255, 0)\n addForm(envD, 255, envS, envA)\n addForm(currMs - (envA + envD), envS, envS, envD + envA)\n addForm(envR, envS, 0, currMs)\n\n this.queuePlayInstructions(timePos - now, sndInstr.slice(0, sndInstrPtr))\n endHz = -1;\n timePos += currMs // don't add envR - it's supposed overlap next sound\n }\n\n let timeLeft = timePos - now\n if (timeLeft > 200) {\n pause(timeLeft - 100)\n now = control.millis() - startTime\n }\n }\n }\n }\n\n //% fixedInstance whenUsed block=\"ba ding\"\n export const baDing = new Melody('b5:1 e6:3')\n\n //% fixedInstance whenUsed block=\"wawawawaa\"\n export const wawawawaa = new Melody('~15 e3:3 r:1 d#:3 r:1 d:4 r:1 c#:8')\n\n //% fixedInstance whenUsed block=\"jump up\"\n export const jumpUp = new Melody('c5:1 d e f g')\n\n //% fixedInstance whenUsed block=\"jump down\"\n export const jumpDown = new Melody('g5:1 f e d c')\n\n //% fixedInstance whenUsed block=\"power up\"\n export const powerUp = new Melody('g4:1 c5 e g:2 e:1 g:3')\n\n //% fixedInstance whenUsed block=\"power down\"\n export const powerDown = new Melody('g5:1 d# c g4:2 b:1 c5:3')\n\n //% fixedInstance whenUsed block=\"magic wand\"\n export const magicWand = new Melody('F#6:1-300 G# A# B C7# D# F F# G# A# B:6')\n //A#7:1-200 A:1 A#7:1 A:1 A#7:2\n\n //% fixedInstance whenUsed block=\"siren\"\n export const siren = new Melody('a4 d5 a4 d5 a4 d5')\n\n //% fixedInstance whenUsed block=\"pew pew\"\n export const pewPew = new Melody('!1200,200^50')\n\n //% fixedInstance whenUsed block=\"knock\"\n export const knock = new Melody('~4 @0,0,255,150 !300,1 !211,1')\n\n //% fixedInstance whenUsed block=\"footstep\"\n export const footstep = new Melody('~4 @0,0,60,50 !200,1')\n\n //% fixedInstance whenUsed block=\"thump\"\n export const thump = new Melody('~4 @0,0,255,150 !100,1')\n\n //% fixedInstance whenUsed block=\"small crash\"\n export const smallCrash = new Melody('~4 @10,490,0,1 !800,1')\n\n //% fixedInstance whenUsed block=\"big crash\"\n export const bigCrash = new Melody('~4 @10,990,0,1 !400,1')\n\n //% fixedInstance whenUsed block=\"zapped\"\n export const zapped = new Melody('~16 @10,490,0,0 !1600,500^1')\n\n //% fixedInstance whenUsed block=\"buzzer\"\n export const buzzer = new Melody('~16 @10,0,255,250 !2000,300')\n\n //% fixedInstance whenUsed block=\"sonar\"\n export const sonar = new Melody('~16 @10,1500,0,0 !200,1 !200,1500^190')\n\n //% fixedInstance whenUsed block=\"spooky\"\n export const spooky = new Melody('~16 @700,1300,0,0 !100,1 ~18 !108,2000')\n\n //% fixedInstance whenUsed block=\"beam up\"\n export const beamUp = new Melody('~18 @10,1500,0,0 !200,1500^4000')\n}\n",
"music.ts": "enum Note {\n //% blockIdentity=music.noteFrequency enumval=262\n C = 262,\n //% block=C#\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F = 349,\n //% block=F#\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G = 392,\n //% block=G#\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B = 494,\n //% blockIdentity=music.noteFrequency enumval=131\n C3 = 131,\n //% block=C#3\n //% blockIdentity=music.noteFrequency enumval=139\n CSharp3 = 139,\n //% blockIdentity=music.noteFrequency enumval=147\n D3 = 147,\n //% blockIdentity=music.noteFrequency enumval=156\n Eb3 = 156,\n //% blockIdentity=music.noteFrequency enumval=165\n E3 = 165,\n //% blockIdentity=music.noteFrequency enumval=175\n F3 = 175,\n //% block=F#3\n //% blockIdentity=music.noteFrequency enumval=185\n FSharp3 = 185,\n //% blockIdentity=music.noteFrequency enumval=196\n G3 = 196,\n //% block=G#3\n //% blockIdentity=music.noteFrequency enumval=208\n GSharp3 = 208,\n //% blockIdentity=music.noteFrequency enumval=220\n A3 = 220,\n //% blockIdentity=music.noteFrequency enumval=233\n Bb3 = 233,\n //% blockIdentity=music.noteFrequency enumval=247\n B3 = 247,\n //% blockIdentity=music.noteFrequency enumval=262\n C4 = 262,\n //% block=C#4\n //% blockIdentity=music.noteFrequency enumval=277\n CSharp4 = 277,\n //% blockIdentity=music.noteFrequency enumval=294\n D4 = 294,\n //% blockIdentity=music.noteFrequency enumval=311\n Eb4 = 311,\n //% blockIdentity=music.noteFrequency enumval=330\n E4 = 330,\n //% blockIdentity=music.noteFrequency enumval=349\n F4 = 349,\n //% block=F#4\n //% blockIdentity=music.noteFrequency enumval=370\n FSharp4 = 370,\n //% blockIdentity=music.noteFrequency enumval=392\n G4 = 392,\n //% block=G#4\n //% blockIdentity=music.noteFrequency enumval=415\n GSharp4 = 415,\n //% blockIdentity=music.noteFrequency enumval=440\n A4 = 440,\n //% blockIdentity=music.noteFrequency enumval=466\n Bb4 = 466,\n //% blockIdentity=music.noteFrequency enumval=494\n B4 = 494,\n //% blockIdentity=music.noteFrequency enumval=523\n C5 = 523,\n //% block=C#5\n //% blockIdentity=music.noteFrequency enumval=555\n CSharp5 = 555,\n //% blockIdentity=music.noteFrequency enumval=587\n D5 = 587,\n //% blockIdentity=music.noteFrequency enumval=622\n Eb5 = 622,\n //% blockIdentity=music.noteFrequency enumval=659\n E5 = 659,\n //% blockIdentity=music.noteFrequency enumval=698\n F5 = 698,\n //% block=F#5\n //% blockIdentity=music.noteFrequency enumval=740\n FSharp5 = 740,\n //% blockIdentity=music.noteFrequency enumval=784\n G5 = 784,\n //% block=G#5\n //% blockIdentity=music.noteFrequency enumval=831\n GSharp5 = 831,\n //% blockIdentity=music.noteFrequency enumval=880\n A5 = 880,\n //% blockIdentity=music.noteFrequency enumval=932\n Bb5 = 932,\n //% blockIdentity=music.noteFrequency enumval=988\n B5 = 988,\n}\n\nenum BeatFraction {\n //% block=1\n Whole = 1,\n //% block=\"1/2\"\n Half = 2,\n //% block=\"1/4\"\n Quarter = 4,\n //% block=\"1/8\"\n Eighth = 8,\n //% block=\"1/16\"\n Sixteenth = 16,\n //% block=\"2\"\n Double = 32,\n //% block=\"4\",\n Breve = 64,\n //% block=\"1/3\",\n Triplet = 128\n}\n\nnamespace music {\n\n let beatsPerMinute: number;\n\n /**\n * Play a tone.\n * @param frequency pitch of the tone to play in Hertz (Hz), eg: Note.C\n */\n //% help=music/ring-tone\n //% blockId=music_ring block=\"ring tone|at %note=device_note\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music inBasicCategory=true\n //% weight=75 blockGap=8\n //% group=\"Tone\"\n export function ringTone(frequency: number) {\n playTone(frequency, 0);\n }\n\n /**\n * Rest, or play silence, for some time (in milliseconds).\n * @param ms rest duration in milliseconds (ms), eg: BeatFraction.Half\n */\n //% help=music/rest\n //% blockId=music_rest block=\"rest|for %duration=device_beat\"\n //% parts=\"headphone\" trackArgs=0\n //% blockNamespace=music\n //% weight=74\n //% group=\"Tone\"\n export function rest(ms: number) {\n playTone(0, Math.max(ms, 20));\n }\n\n function init() {\n if (!beatsPerMinute) beatsPerMinute = 120;\n }\n\n /**\n * Return the duration of a beat in milliseconds (the beat fraction).\n * @param fraction the fraction of the current whole note, eg: BeatFraction.Half\n */\n //% help=music/beat\n //% blockId=device_beat block=\"%fraction|beat\"\n //% weight=9 blockGap=8\n //% group=\"Tempo\"\n export function beat(fraction?: BeatFraction): number {\n init();\n if (fraction == null) fraction = BeatFraction.Whole;\n let beat = 60000 / beatsPerMinute;\n switch (fraction) {\n case BeatFraction.Half: beat /= 2; break;\n case BeatFraction.Quarter: beat /= 4; break;\n case BeatFraction.Eighth: beat /= 8; break;\n case BeatFraction.Sixteenth: beat /= 16; break;\n case BeatFraction.Double: beat *= 2; break;\n case BeatFraction.Breve: beat *= 4; break;\n case BeatFraction.Triplet: beat /= 3; break;\n }\n return beat >> 0;\n }\n\n /**\n * Return the tempo in beats per minute (bpm).\n * Tempo is the speed (bpm = beats per minute) at which notes play. The larger the tempo value, the faster the notes will play.\n */\n //% help=music/tempo\n //% blockId=device_tempo block=\"tempo (bpm)\"\n //% weight=64\n //% group=\"Tempo\"\n export function tempo(): number {\n init();\n return beatsPerMinute;\n }\n\n /**\n * Change the tempo up or down by some amount of beats per minute (bpm).\n * @param bpm The change in beats per minute to the tempo, eg: 20\n */\n //% help=music/change-tempo-by weight=37\n //% blockId=device_change_tempo block=\"change tempo by %value|(bpm)\"\n //% weight=66 blockGap=8\n //% group=\"Tempo\"\n export function changeTempoBy(bpm: number): void {\n init();\n setTempo(beatsPerMinute + bpm);\n }\n\n /**\n * Set the tempo a number of beats per minute (bpm).\n * @param bpm The new tempo in beats per minute, eg: 120\n */\n //% help=music/set-tempo\n //% blockId=device_set_tempo block=\"set tempo to %value|(bpm)\"\n //% bpm.min=4 bpm.max=400\n //% weight=65 blockGap=8\n //% group=\"Tempo\"\n export function setTempo(bpm: number): void {\n init();\n if (bpm > 0) {\n beatsPerMinute = Math.max(1, bpm >> 0);\n }\n }\n}\n",
"ns.ts": "\n/**\n * Generation of music tones.\n */\n//% color=#E30FC0 weight=90 icon=\"\\uf025\"\n//% blockGap=8\n//% groups='[\"Sounds\", \"Melody\", \"Tone\", \"Volume\", \"Tempo\"]'\nnamespace music {\n}",
"piano.ts": "namespace music {\n /**\n * Get the frequency of a note.\n * @param name the note name, eg: Note.C\n */\n //% weight=1 help=music/note-frequency\n //% blockId=device_note block=\"%note\"\n //% shim=TD_ID\n //% color=\"#FFFFFF\" colorSecondary=\"#FFFFFF\" colorTertiary=\"#D83B01\"\n //% note.fieldEditor=\"note\" note.defl=\"262\"\n //% note.fieldOptions.decompileLiterals=true\n //% useEnumVal=1\n //% weight=10 blockGap=8\n //% group=\"Tone\"\n export function noteFrequency(name: Note): number {\n return name;\n }\n}",
"pxt.json": "{\n \"name\": \"mixer---rp2040\",\n \"description\": \"The music library with a mixer\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"SoundOutput.h\",\n \"sound.cpp\",\n \"melody.h\",\n \"melody.cpp\",\n \"melody.ts\",\n \"piano.ts\",\n \"legacy.ts\",\n \"ns.ts\",\n \"targetoverrides.ts\",\n \"music.ts\",\n \"pxtparts.json\",\n \"headphone.svg\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"pxtparts.json": "{\n \"headphone\": {\n \"numberOfPins\": 2,\n \"visual\": {\n \"image\": \"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\": \"A0\",\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}",
"sound.cpp": "// to be overridden\n",
"targetoverrides.ts": "\n",
"test.ts": "for(let i = 1000; i > 0; i -= 50)\n music.playTone(440, i)\n\nfor(let i = 0; i < 1000; i += 20)\n music.playTone(440, i)\n"
},
"pixel": {
"pixel.ts": "/**\n * Well known colors for a NeoPixel strip\n */\nconst enum PixelColors {\n //% block=red blockIdentity=pixel.colors\n Red = 0xFF0000,\n //% block=orange blockIdentity=pixel.colors\n Orange = 0xFF7F00,\n //% block=yellow blockIdentity=pixel.colors\n Yellow = 0xFFFF00,\n //% block=green blockIdentity=pixel.colors\n Green = 0x00FF00,\n //% block=blue blockIdentity=pixel.colors\n Blue = 0x0000FF,\n //% block=indigo blockIdentity=pixel.colors\n Indigo = 0x4b0082,\n //% block=violet blockIdentity=pixel.colors\n Violet = 0x8a2be2,\n //% block=purple blockIdentity=pixel.colors\n Purple = 0xA033E5,\n //% block=pink blockIdentity=pixel.colors\n Pink = 0xFF007F,\n //% block=white blockIdentity=pixel.colors\n White = 0xFFFFFF,\n //% block=black blockIdentity=pixel.colors\n Black = 0x000000\n}\n\n/**\n * Functions to operate the on-board color LED (if any).\n */\n//% weight=100 color=\"#0078d7\" icon=\"\\uf0eb\"\nnamespace pixel {\n /**\n * Gets the underlying light strip\n */\n //% whenUsed\n export const strip: light.LightStrip = light.onboardStrip();\n\n /**\n * Set the on-board pixel to a given color.\n * @param color RGB color of the LED\n */\n //% blockId=\"pixel_set_pixel\" block=\"set pixel color %rgb=colorNumberPicker\"\n //% weight=99\n //% blockGap=8\n //% parts=\"pixel\"\n export function setColor(color: number): void {\n strip.setAll(color);\n }\n\n /**\n * Get the RGB value of a known color\n */\n //% blockId=pixel_colors block=\"%color\"\n //% weight=20\n //% blockGap=8\n //% shim=TD_ID\n export function colors(color: PixelColors): number {\n return color;\n }\n\n /**\n * Set the brightness of the neopixel. This flag only applies to future operations.\n * @param brightness a measure of LED brightness in 0-255. eg: 20\n */\n //% blockId=\"pixel_set_brightness\" block=\"set brightness %brightness\"\n //% weight=98\n //% parts=\"pixel\"\n //% brightness.min=0 brightness.max=255\n export function setBrightness(brightness: number): void {\n strip.setBrightness(brightness);\n }\n\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=\"pixel_rgb\" 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 //% weight=19\n //% blockGap=8\n export function rgb(red: number, green: number, blue: number): number {\n return light.rgb(red, green, blue);\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=\"pixel_fade\" block=\"fade %color=pixel_colors|by %brightness\"\n //% brightness.min=0 brightness.max=255\n //% weight=18\n //% blockGap=8\n export function fade(color: number, brightness: number): number {\n return light.fade(color, brightness);\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=\"pixel_hsv\" 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 //% weight=17\n export function hsv(hue: number, sat: number, val: number): number {\n return light.hsv(hue, sat, val);\n }\n}",
"pxt.json": "{\n \"name\": \"pixel\",\n \"description\": \"A single on-board light pixel\",\n \"dependencies\": {\n \"core\": \"*\",\n \"light\": \"*\"\n },\n \"files\": [\n \"pixel.ts\"\n ],\n \"testFiles\": [],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"icon\": \"/static/libs/pixel.png\"\n}\n"
},
"buttons": {
"README.md": "# buttons\n\nA library to handle 2 buttons A and B.\n",
"buttons.cpp": "#include \"pxt.h\"\n\n/*\n\nThese button events need CODAL work.\n\n // % block=\"double click\"\n DoubleClick = DEVICE_BUTTON_EVT_DOUBLE_CLICK,\n\n // % block=\"hold\"\n Hold = DEVICE_BUTTON_EVT_HOLD\n\n*/\n\n/**\n * User interaction on buttons\n */\nenum class ButtonEvent {\n //% block=\"click\"\n Click = DEVICE_BUTTON_EVT_CLICK,\n //% block=\"long click\"\n LongClick = DEVICE_BUTTON_EVT_LONG_CLICK,\n //% block=\"up\"\n Up = DEVICE_BUTTON_EVT_UP,\n //% block=\"down\"\n Down = DEVICE_BUTTON_EVT_DOWN\n};\n\nnamespace pxt {\n//%\nButton *getButtonByPin(int pin, int flags) {\n unsigned highflags = (unsigned)pin >> 16;\n if (highflags & 0xff)\n flags = highflags & 0xff;\n\n pin &= 0xffff;\n\n auto cpid = DEVICE_ID_FIRST_BUTTON + pin;\n auto btn = (Button *)lookupComponent(cpid);\n if (btn == NULL) {\n auto pull = PullMode::None;\n if ((flags & 0xf0) == 0x10)\n pull = PullMode::Down;\n else if ((flags & 0xf0) == 0x20)\n pull = PullMode::Up;\n else if ((flags & 0xf0) == 0x30)\n pull = PullMode::None;\n else\n oops(3);\n // GCTODO\n btn = new Button(*lookupPin(pin), cpid, DEVICE_BUTTON_ALL_EVENTS,\n (ButtonPolarity)(flags & 0xf), pull);\n }\n return btn;\n}\n\n//%\nButton *getButtonByPinCfg(int key, int flags) {\n int pin = getConfig(key);\n if (pin == -1)\n soft_panic(PANIC_NO_SUCH_CONFIG);\n return getButtonByPin(pin, flags);\n}\n\nMultiButton *getMultiButton(int id, int pinA, int pinB, int flags) {\n auto btn = (MultiButton *)lookupComponent(id);\n if (btn == NULL) {\n auto bA = getButtonByPin(pinA, flags);\n auto bB = getButtonByPin(pinB, flags);\n // GCTODO\n btn = new MultiButton(bA->id, bB->id, id);\n\n // A user has registered to receive events from the buttonAB multibutton.\n // Disable click events from being generated by ButtonA and ButtonB, and defer the\n // control of this to the multibutton handler.\n //\n // This way, buttons look independent unless a buttonAB is requested, at which\n // point button A+B clicks can be correclty handled without breaking\n // causal ordering.\n bA->setEventConfiguration(DEVICE_BUTTON_SIMPLE_EVENTS);\n bB->setEventConfiguration(DEVICE_BUTTON_SIMPLE_EVENTS);\n btn->setEventConfiguration(DEVICE_BUTTON_ALL_EVENTS);\n }\n return btn;\n}\n\n// This is for A, B, and AB\n//%\nAbstractButton *getButton(int id) {\n int pa = getConfig(CFG_PIN_BTN_A);\n int pb = getConfig(CFG_PIN_BTN_B);\n int flags = getConfig(CFG_DEFAULT_BUTTON_MODE, BUTTON_ACTIVE_LOW_PULL_UP);\n if (id == 0)\n return getButtonByPin(pa, flags);\n else if (id == 1)\n return getButtonByPin(pb, flags);\n else if (id == 2)\n return getMultiButton(DEVICE_ID_BUTTON_AB, pa, pb, flags);\n else {\n soft_panic(PANIC_INVALID_ARGUMENT);\n return NULL;\n }\n}\n\n} // namespace pxt\n\nnamespace DigitalInOutPinMethods {\n\n/**\n * Get the push button (connected to GND) for given pin\n */\n//%\nButton_ pushButton(DigitalInOutPin pin) {\n return pxt::getButtonByPin(pin->name, BUTTON_ACTIVE_LOW_PULL_UP);\n}\n\n} // namespace DigitalInOutPinMethods\n\n//% noRefCounting fixedInstances\nnamespace ButtonMethods {\n/**\n * Do something when a button (`A`, `B` or both `A` + `B`) is clicked, double clicked, etc...\n * @param button the button that needs to be clicked or used\n * @param event the kind of button gesture that needs to be detected\n * @param body code to run when the event is raised\n */\n//% help=input/button/on-event\n//% blockId=buttonEvent block=\"on %button|%event\"\n//% blockNamespace=input\n//% button.fieldEditor=\"gridpicker\"\n//% button.fieldOptions.width=220\n//% button.fieldOptions.columns=3\n//% weight=96 blockGap=12\n//% trackArgs=0\nvoid onEvent(Button_ button, ButtonEvent ev, Action body) {\n registerWithDal(button->id, (int)ev, body);\n}\n\n/**\n * Check if a button is pressed or not.\n * @param button the button to query the request\n */\n//% help=input/button/is-pressed\n//% block=\"%button|is pressed\"\n//% blockId=buttonIsPressed\n//% blockNamespace=input\n//% button.fieldEditor=\"gridpicker\"\n//% button.fieldOptions.width=220\n//% button.fieldOptions.columns=3\n//% weight=50 blockGap=8\n//% trackArgs=0\nbool isPressed(Button_ button) {\n return button->isPressed();\n}\n\n/**\n * See if the button was pressed again since the last time you checked.\n * @param button the button to query the request\n */\n//% help=input/button/was-pressed\n//% block=\"%button|was pressed\"\n//% blockId=buttonWasPressed\n//% blockNamespace=input\n//% button.fieldEditor=\"gridpicker\"\n//% button.fieldOptions.width=220\n//% button.fieldOptions.columns=3\n//% group=\"More\" weight=46 blockGap=8\n//% trackArgs=0\nbool wasPressed(Button_ button) {\n return button->wasPressed();\n}\n\n/**\n * Gets the component identifier for the button\n */\n//%\nint id(Button_ button) {\n return button->id;\n}\n\n} // namespace ButtonMethods\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n /**\n * User interaction on buttons\n */\n\n declare const enum ButtonEvent {\n //% block=\"click\"\n Click = 3, // DEVICE_BUTTON_EVT_CLICK\n //% block=\"long click\"\n LongClick = 4, // DEVICE_BUTTON_EVT_LONG_CLICK\n //% block=\"up\"\n Up = 2, // DEVICE_BUTTON_EVT_UP\n //% block=\"down\"\n Down = 1, // DEVICE_BUTTON_EVT_DOWN\n }\n\n// Auto-generated. Do not edit. Really.\n",
"pxt.json": "{\n \"name\": \"buttons\",\n \"description\": \"Button A and B drivers\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"buttons.cpp\",\n \"shims.d.ts\",\n \"enums.d.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\n\n\ndeclare interface DigitalInOutPin {\n /**\n * Get the push button (connected to GND) for given pin\n */\n //% shim=DigitalInOutPinMethods::pushButton\n pushButton(): Button;\n}\n\n\n\n //% noRefCounting fixedInstances\ndeclare interface Button {\n /**\n * Do something when a button (`A`, `B` or both `A` + `B`) is clicked, double clicked, etc...\n * @param button the button that needs to be clicked or used\n * @param event the kind of button gesture that needs to be detected\n * @param body code to run when the event is raised\n */\n //% help=input/button/on-event\n //% blockId=buttonEvent block=\"on %button|%event\"\n //% blockNamespace=input\n //% button.fieldEditor=\"gridpicker\"\n //% button.fieldOptions.width=220\n //% button.fieldOptions.columns=3\n //% weight=96 blockGap=12\n //% trackArgs=0 shim=ButtonMethods::onEvent\n onEvent(ev: ButtonEvent, body: () => void): void;\n\n /**\n * Check if a button is pressed or not.\n * @param button the button to query the request\n */\n //% help=input/button/is-pressed\n //% block=\"%button|is pressed\"\n //% blockId=buttonIsPressed\n //% blockNamespace=input\n //% button.fieldEditor=\"gridpicker\"\n //% button.fieldOptions.width=220\n //% button.fieldOptions.columns=3\n //% weight=50 blockGap=8\n //% trackArgs=0 shim=ButtonMethods::isPressed\n isPressed(): boolean;\n\n /**\n * See if the button was pressed again since the last time you checked.\n * @param button the button to query the request\n */\n //% help=input/button/was-pressed\n //% block=\"%button|was pressed\"\n //% blockId=buttonWasPressed\n //% blockNamespace=input\n //% button.fieldEditor=\"gridpicker\"\n //% button.fieldOptions.width=220\n //% button.fieldOptions.columns=3\n //% group=\"More\" weight=46 blockGap=8\n //% trackArgs=0 shim=ButtonMethods::wasPressed\n wasPressed(): boolean;\n\n /**\n * Gets the component identifier for the button\n */\n //% shim=ButtonMethods::id\n id(): int32;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"test.ts": ""
},
"touch": {
"README.md": "# touch\n\nThe capacitive touch library.\n\n",
"enums.d.ts": "\n",
"pxt.json": "{\n \"name\": \"touch\",\n \"description\": \"The capacitive touch library\",\n \"dependencies\": {\n \"core\": \"*\",\n \"buttons\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"touch.h\",\n \"touch.cpp\",\n \"touch.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\n\n\ndeclare interface TouchButton {\n /**\n * Manually define the threshold use to detect a touch event. Any sensed value equal to or greater than this value will be interpreted as a touch.\n * @param name button name\n * @param threshold minimum value to consider a touch eg:200\n */\n //% blockId=touch_set_threshold block=\"button %button|set threshold %threshold\"\n //% blockNamespace=input\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% threshold.min=0\n //% threshold.max=1023\n //% group=\"More\" weight=16 blockGap=8\n //% help=input/touch/set-threshold shim=TouchButtonMethods::setThreshold\n setThreshold(threshold: int32): void;\n\n /**\n * Gets the current threshold\n * @param name button name\n */\n //% blockId=touch_threshold block=\"button %button|threshold\"\n //% blockNamespace=input\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% group=\"More\" weight=16 blockGap=8\n //% help=input/touch/threshold shim=TouchButtonMethods::threshold\n threshold(): int32;\n\n /**\n * Reads the current value registered with the button.\n * @param name button name\n */\n //% blockId=touch_value block=\"button %button|value\"\n //% blockNamespace=input\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% group=\"More\" weight=49 blockGap=8\n //% help=input/touch/value shim=TouchButtonMethods::value\n value(): int32;\n\n /**\n * Calibrate the touch sensivity\n */\n //% blockId=touch_calibrate block=\"button %button calibrate\"\n //% blockNamespace=input\n //% name.fieldEditor=\"gridpicker\"\n //% name.fieldOptions.width=220\n //% name.fieldOptions.columns=4\n //% group=\"More\" weight=49 blockGap=8\n //% help=input/touch/calibrate shim=TouchButtonMethods::calibrate\n calibrate(): void;\n}\n\n\ndeclare interface AnalogInOutPin {\n /**\n * Get the cap-touch sensor for given pin (if available)\n */\n //% shim=AnalogInOutPinMethods::touchButton\n touchButton(): TouchButton;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"test.ts": "",
"touch.cpp": "#include \"pxt.h\"\n#include \"touch.h\"\n\nnamespace pxt {\n//%\nTouchButton getTouchButton(int id) {\n auto cpid = DEVICE_ID_FIRST_TOUCHBUTTON + id;\n auto btn = (CapTouchButton*)lookupComponent(cpid);\n if (btn == NULL) {\n // GCTODO\n // 'new' will add it to component list\n btn = new CapTouchButton(*pxt::getPin(id));\n btn->id = cpid;\n }\n return btn;\n}\n}\n\n\nnamespace TouchButtonMethods {\n\n/**\n * Manually define the threshold use to detect a touch event. Any sensed value equal to or greater than this value will be interpreted as a touch.\n * @param name button name\n * @param threshold minimum value to consider a touch eg:200\n */\n//% blockId=touch_set_threshold block=\"button %button|set threshold %threshold\"\n//% blockNamespace=input\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% threshold.min=0\n//% threshold.max=1023\n//% group=\"More\" weight=16 blockGap=8\n//% help=input/touch/set-threshold\nvoid setThreshold(TouchButton button, int threshold) {\n button->setThreshold(max(0, min(1 << 12, threshold << 2)));\n}\n\n/**\n * Gets the current threshold\n * @param name button name\n */\n//% blockId=touch_threshold block=\"button %button|threshold\"\n//% blockNamespace=input\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% group=\"More\" weight=16 blockGap=8\n//% help=input/touch/threshold\nint threshold(TouchButton button) {\n return button->threshold >> 2;\n}\n\n/**\n * Reads the current value registered with the button.\n * @param name button name\n */\n//% blockId=touch_value block=\"button %button|value\"\n//% blockNamespace=input\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% group=\"More\" weight=49 blockGap=8\n//% help=input/touch/value\nint value(TouchButton button) {\n return button->getValue() >> 2;\n}\n\n/**\n* Calibrate the touch sensivity\n*/\n//% blockId=touch_calibrate block=\"button %button calibrate\"\n//% blockNamespace=input\n//% name.fieldEditor=\"gridpicker\"\n//% name.fieldOptions.width=220\n//% name.fieldOptions.columns=4\n//% group=\"More\" weight=49 blockGap=8\n//% help=input/touch/calibrate\nvoid calibrate(TouchButton button) {\n button->calibrate();\n}\n\n}\n\nnamespace AnalogInOutPinMethods {\n \n/**\n * Get the cap-touch sensor for given pin (if available)\n */\n//%\nTouchButton touchButton(AnalogInOutPin pin) {\n if (PA02 <= pin->name && pin->name <= PA07)\n ;\n else if (PB02 <= pin->name && pin->name <= PB09)\n ;\n else\n return NULL;\n return pxt::getTouchButton(pin->name);\n}\n\n}\n",
"touch.h": "#define TouchButton CapTouchButton *\n",
"touch.ts": "//% noRefCounting fixedInstances\ninterface TouchButton extends Button {\n // methods filled from C++\n}\n"
},
"light": {
"README.md": "# neopixel\n\nThe neopixel library.\n\n",
"animations.jres": "{\n \"*\": {\n \"namespace\": \"light\",\n \"dataEncoding\": \"base64\"\n },\n \"rainbowAnimation\": {\n \"icon\": \"data:image/png;base64,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\"\n },\n \"colorWipeAnimation\": {\n \"icon\": \"data:image/png;base64,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\"\n },\n \"runningLightsAnimation\": {\n \"icon\": \"data:image/png;base64,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\"\n },\n \"sparkleAnimation\": {\n \"icon\": \"data:image/png;base64,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\"\n },\n \"theaterChaseAnimation\": {\n \"icon\": \"data:image/png;base64,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\"\n },\n \"cometAnimation\": {\n \"icon\": \"data:image/png;base64,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\"\n }\n}",
"create.ts": "\nnamespace light {\n /**\n * Create a new programmable light strip.\n * @param pin the pin where the strip is connected.\n * @param numleds number of leds in the strip, eg: 30\n * @param mode the light encoding mode for different LED strips, eg: NeoPixelMode.RGB_GRB\n */\n //% blockId=\"neopixel_create_strip\" block=\"create WS2812 strip on %pin with %numleds pixels\"\n //% help=\"light/create-strip\"\n //% weight=100\n //% blockSetVariable=strip\n //% trackArgs=0,2\n //% parts=\"neopixel\"\n //% advanced=true\n export function createStrip(\n pin: DigitalInOutPin = null,\n numleds: number = 30,\n mode: NeoPixelMode = NeoPixelMode.RGB\n ): NeoPixelStrip {\n return light.createNeoPixelStrip(pin, numleds, mode);\n }\n\n /**\n * Creates a strip of colored LEDs (APA102)\n */\n //% blockId=\"light_create_dotstar\" block=\"create APA102 strip|data %data|clock %clk|with %numleds pixels\"\n //% help=\"light/create-apa102-strip\"\n //% trackArgs=0,1,2\n //% parts=\"dotstar\"\n //% weight=100 blockSetVariable=strip\n //% advanced=true\n export function createAPA102Strip(\n dataPin: DigitalInOutPin,\n clkPin: DigitalInOutPin,\n numleds: number): NeoPixelStrip {\n const strip = new NeoPixelStrip();\n strip._mode = NeoPixelMode.APA102;\n strip._length = Math.max(0, numleds | 0);\n strip._dataPin = dataPin;\n strip._clkPin = clkPin;\n return strip;\n }\n}",
"defaultlights.ts": "namespace light {\n /**\n * Gets the default external light strip\n */\n //% whenUsed\n export const pixels = light.defaultStrip();\n\n /**\n * Set all of the pixels on the strip to one RGB color.\n * @param rgb RGB color of the LED\n */\n //% blockId=\"builtin_neopixel_set_strip_color\" block=\"set all pixels to %rgb=colorNumberPicker\"\n //% help=\"light/set-all\"\n //% weight=79 blockGap=8\n export function setAll(rgb: number) {\n light.pixels.setAll(rgb);\n }\n\n /**\n * Sets a gradient between two colors\n * @param startColor the start color\n * @param endColor the end color\n */\n //% blockId=\"builtinlightsetgradient\" block=\"set gradient from %startRgb=colorNumberPicker to %endRgb=colorNumberPicker\"\n //% weight=78 blockGap=8 blockHidden=true\n export function setGradient(startRgb: number, endRgb: number) {\n light.pixels.setGradient(startRgb, endRgb);\n }\n\n /**\n * Turn off all pixel LEDs on the onboard strip.\n */\n //% blockId=\"builtin_neopixel_clear\" block=\"clear\"\n //% parts=\"neopixel\"\n //% help=\"light/clear\"\n //% group=\"More\" weight=9 blockGap=8\n export function clear() {\n light.pixels.clear();\n }\n\n /**\n * Display a vertical bar graph based on the `value` and `high` value.\n * If `high` is 0, the chart gets adjusted automatically.\n * @param value current value to plot\n * @param high maximum value, 0 to autoscale\n */\n //% blockId=builtin_neopixel_show_bar_graph block=\"graph %value||up to %high\" icon=\"\\uf080\"\n //% help=light/graph blockGap=8\n //% weight=10\n export function graph(value: number, high?: number): void {\n light.pixels.graph(value, high);\n }\n\n\n /**\n * Set the pixel to a given color.\n * @param pixeloffset position of the NeoPixel in the strip\n * @param color RGB color of the LED\n */\n //% blockId=\"builtin_neopixel_set_pixel_color\" block=\"set pixel color at %pixeloffset|to %rgb=colorNumberPicker\"\n //% help=\"light/set-pixel-color\"\n //% group=\"More\" weight=89 blockGap=8\n export function setPixelColor(pixeloffset: number, color: number): void {\n light.pixels.setPixelColor(pixeloffset, color);\n }\n\n /**\n * Gets the pixel color at a given offset.\n * @param pixeloffset position of the NeoPixel in the strip\n */\n //% blockId=\"builtin_neopixel_pixel_color\" block=\"pixel color at %pixeloffset\"\n //% help=\"light/pixel-color\"\n //% group=\"More\" weight=88\n export function pixelColor(pixeloffset: number): number {\n return light.pixels.pixelColor(pixeloffset);\n }\n\n /**\n * Set the brightness of the strip. This flag only applies to future operation.\n * @param brightness a measure of LED brightness in 0-255. eg: 20\n */\n //% blockId=\"builtin_neopixel_set_brightness\" block=\"set brightness %brightness\"\n //% brightness.min=0 brightness.max=255\n //% help=\"light/set-brightness\"\n //% weight=2 blockGap=8\n export function setBrightness(brightness: number): void {\n light.pixels.setBrightness(brightness);\n }\n\n /**\n * Move a photon effect along the pixel strip by a number of steps.\n * @param steps number of steps (lights) to move, eg: 1\n */\n //% blockId=builtin_neophoton_fd block=\"photon forward by %steps\"\n //% help=\"light/photon-forward\"\n //% group=\"Photon\" weight=41 blockGap=8\n export function photonForward(steps: number) {\n light.pixels.photonForward(steps);\n }\n /**\n * Switch the direction of the photon pulse.\n */\n //% blockId=builtin_neophoton_flip block=\"photon flip\"\n //% help=\"light/photon-flip\"\n //% parts=\"neopixel\"\n //% group=\"Photon\" weight=40 blockGap=8\n export function photonFlip() {\n light.pixels.photonFlip();\n }\n\n\n /**\n * Sets the photon position to a given light index\n * @param index index of the light, if out of bound, the index is wrapped\n */\n //% blockId=builtin_light_photon_set_position block=\"photon set position %index\"\n //% help=\"light/set-photon-position\"\n //% parts=\"neopixel\"\n //% group=\"Photon\" weight=39 blockGap=8\n export function setPhotonPosition(index: number) {\n light.pixels.setPhotonPosition(index);\n }\n\n /**\n * Set the photon color hue.\n * @param hue the color hue of the photon\n */\n //% blockId=builtin_neophoton_set_pen_hue block=\"photon set pen hue %hue=colorWheelHsvPicker\"\n //% help=\"light/set-photon-pen-hue\"\n //% group=\"Photon\" weight=39 blockGap=8\n export function setPhotonPenHue(hue: number) {\n light.pixels.setPhotonPenHue(hue);\n }\n\n /**\n * Set the photon mode to pen up, pen down, or eraser.\n * @param mode the desired mode\n */\n //% blockId=builtin_neophoton_set_photon block=\"photon %mode\"\n //% help=\"light/set-photon-mode\"\n //% group=\"Photon\" weight=38\n export function setPhotonMode(mode: PhotonMode) {\n light.pixels.setPhotonMode(mode);\n }\n\n /**\n * Show an animation or queue an animation in the animation queue\n * @param animation the animation to run, eg: light.rainbowAnimation\n * @param duration the duration to run in milliseconds, eg: 500\n */\n //% blockId=builtin_neopixel_show_animation block=\"show animation %animation=light_animation_picker|for %duration=timePicker|ms\"\n //% help=\"light/show-animation\" blockGap=8\n //% weight=81\n export function showAnimation(animation: NeoPixelAnimation, duration: number) {\n light.pixels.showAnimation(animation, duration);\n }\n\n /**\n * Show a single animation frame\n * @param animation the animation to run, eg: light.rainbowAnimation\n */\n //% blockId=builtin_neopixel_show_animation_frame block=\"show frame of %animation=light_animation_picker|animation\"\n //% help=\"light/show-animation-frame\"\n //% group=\"More\" weight=24 blockGap=8\n export function showAnimationFrame(animation: NeoPixelAnimation) {\n light.pixels.showAnimationFrame(animation);\n }\n\n /**\n * Stop the current animation and any other animations ready to show.\n */\n //% blockId=builtin_neopixel_stop_all_animations block=\"stop all animations\"\n //% help=\"light/stop-all-animations\"\n //% group=\"More\" weight=23\n export function stopAllAnimations() {\n light.pixels.stopAllAnimations();\n }\n\n /**\n * Creates a builtin animation\n * @param kind the type of animation\n */\n //% kind.fieldEditor=\"imagedropdown\"\n //% kind.fieldOptions.columns=3 blockGap=8\n //% blockId=light_animation block=\"%kind\"\n //% group=\"More\" weight=25\n //% help=\"light/animation\" blockHidden=true deprecated=1\n export function animation(kind: LightAnimation): NeoPixelAnimation {\n switch (kind) {\n case LightAnimation.RunningLights: return runningLightsAnimation;\n case LightAnimation.Comet: return cometAnimation;\n case LightAnimation.ColorWipe: return colorWipeAnimation;\n case LightAnimation.TheaterChase: return theaterChaseAnimation;\n case LightAnimation.Sparkle: return sparkleAnimation;\n default: return rainbowAnimation;\n }\n }\n}",
"defaultlightsoverrides.ts": "namespace light {\n /**\n * Create a range of pixels.\n * @param start offset in the NeoPixel strip to start the range\n * @param length number of pixels in the range, eg: 4\n */\n //% blockId=\"lightstrip_range\" block=\"range from %start|with %length|pixels\"\n //% weight=1\n export function range(start: number, length: number): NeoPixelStrip {\n return pixels.range(start, length);\n }\n\n /**\n * Sets the number of LEDS on the default light strip\n */\n //% blockId=lightds_setlength block=\"set pixels length to %numleds pixels\"\n //% numleds.defl=30\n //% numleds.shadow=lightLengthPicker\n //% weight=0\n export function setLength(numleds: number) {\n light.pixels.setLength(numleds);\n }\n\n /**\n * Sets the type of RGB light on the default strip\n */\n //% blockId=lightds_setmode block=\"set default strip mode to %mode\"\n //% weight=0\n export function setMode(mode: NeoPixelMode) {\n light.pixels.setMode(mode);\n }\n}",
"defaultstrip.ts": "namespace light {\n let _defaultStrip: NeoPixelStrip;\n /**\n * Gets the default light strip\n */\n //% help=light/default-strip\n //% blockId=\"neopixel_default_strip\" block=\"default strip\"\n //% weight=110 blockGap=8\n //% advanced=true\n //% parts=pixels\n export function defaultStrip(): NeoPixelStrip {\n if (_defaultStrip) return _defaultStrip;\n\n const data = pins.pinByCfg(DAL.CFG_PIN_DOTSTAR_DATA);\n const clk = pins.pinByCfg(DAL.CFG_PIN_DOTSTAR_CLOCK);\n const dsnum = control.getConfigValue(DAL.CFG_NUM_DOTSTARS, 0);\n const neo = pins.pinByCfg(DAL.CFG_PIN_NEOPIXEL);\n const neonum = control.getConfigValue(DAL.CFG_NUM_NEOPIXELS, 0);\n const mosi = pins.pinByCfg(DAL.CFG_PIN_MOSI);\n const sck = pins.pinByCfg(DAL.CFG_PIN_SCK);\n\n _defaultStrip = new NeoPixelStrip();\n if (data && clk && dsnum > 0) {\n _defaultStrip._mode = NeoPixelMode.APA102;\n _defaultStrip._dataPin = data;\n _defaultStrip._clkPin = clk;\n _defaultStrip._length = dsnum;\n } else if(neo && neonum > 0) {\n _defaultStrip._mode = NeoPixelMode.RGB;\n _defaultStrip._dataPin = neo;\n _defaultStrip._length = neonum;\n } else { // mount strip on SPI\n _defaultStrip._mode = NeoPixelMode.RGB;\n _defaultStrip._dataPin = mosi;\n _defaultStrip._clkPin = sck;\n _defaultStrip._length = 30;\n }\n\n return _defaultStrip;\n }\n}",
"neopixel.ts": "/**\n * Different modes for RGB or RGB+W NeoPixel strips\n */\nconst enum NeoPixelMode {\n //% block=\"RGB (GRB format)\"\n RGB = 1,\n //% block=\"RGB+W\"\n RGBW = 2,\n //% block=\"RGB (RGB format)\"\n RGB_RGB = 3,\n //% block=\"APA102\"\n APA102 = 4\n}\n\nconst enum LightMove {\n //% block=\"rotate\"\n Rotate,\n //% block=\"shift\"\n Shift\n}\n\n/**\n * A determines the mode of the photon\n */\nconst enum PhotonMode {\n //% block=\"pen up\"\n PenUp,\n //% block=\"pen down\"\n PenDown,\n //% block=\"eraser\"\n Eraser,\n //% block=\"off\"\n Off\n}\n\nconst enum LightAnimation {\n //% blockImage=1\n //% block=\"rainbow\"\n Rainbow,\n //% blockImage=1\n //% block=\"running lights\"\n RunningLights,\n //% blockImage=1\n //% block=\"comet\"\n Comet,\n //% blockImage=1\n //% block=\"sparkle\"\n Sparkle,\n //% blockImage=1\n //% block=\"theater chase\"\n TheaterChase,\n //% blockImage=1\n //% block=\"color wipe\"\n ColorWipe\n}\n\n/**\n * Functions to operate colored LEDs.\n */\n//% weight=100 color=\"#0078d7\" icon=\"\\uf00a\"\n//% groups='[\"other\", \"Color\", \"Photon\", \"More\"]'\n//% blockGap=8\nnamespace light {\n export type LightStrip = NeoPixelStrip;\n /**\n * A NeoPixel strip\n */\n export class NeoPixelStrip {\n _parent: NeoPixelStrip;\n _dataPin: DigitalInOutPin;\n _clkPin: DigitalInOutPin;\n _buf: Buffer; // unscaled color buffer\n // per pixel scaling. This buffer is allocated on-demand when per-pixel brightness is needed.\n // when rendering, if this buffer is null, use _brightness instead\n _brightnessBuf: Buffer;\n _sendBuf: Buffer; // scaled color buffer\n _brightness: number; // global brightness for this strip\n _start: number; // start offset in LED strip\n _length: number; // number of LEDs\n _mode: NeoPixelMode;\n _buffered: boolean;\n _animationQueue: control.AnimationQueue;\n // what's the current high value\n _barGraphHigh: number;\n // when was the current high value recorded\n _barGraphHighLast: number;\n // the current photon color, undefined = no photon\n _photonMode: number;\n _photonPos: number;\n _photonDir: number;\n _photonPenColor: number;\n // last animation used by showAnimationFrame\n _lastAnimation: NeoPixelAnimation;\n _lastAnimationRenderer: () => boolean;\n _transitionPlayer: BrightnessTransitionPlayer;\n\n constructor() {\n this._buffered = false;\n this._mode = NeoPixelMode.RGB;\n this._length = 0;\n this._brightness = 16;\n this._start = 0;\n this._dataPin = undefined;\n this._clkPin = undefined;\n this._barGraphHigh = 0;\n this._barGraphHighLast = 0;\n }\n\n /**\n * Gets the underlying color buffer for the entire strip\n */\n get buf(): Buffer {\n if (this._parent) return this._parent.buf;\n if (!this._buf)\n this.reallocateBuffer();\n return this._buf;\n }\n\n get brightnessBuf(): Buffer {\n if (this._parent) return this._parent.brightnessBuf;\n if (!this._brightnessBuf) {\n const b = this.buf; // force allocate buffer\n this._brightnessBuf = control.createBuffer(this._length);\n this._brightnessBuf.fill(this._brightness, 0, this._brightnessBuf.length);\n }\n return this._brightnessBuf;\n }\n\n /**\n * Gets the LED data layout mode\n */\n get mode(): NeoPixelMode {\n return this._mode;\n }\n\n /**\n * Set all of the pixels on the strip to one RGB color.\n * @param rgb RGB color of the LED\n */\n //% blockId=\"light_set_strip_color\" block=\"set %strip all pixels to %rgb=colorNumberPicker\"\n //% help=\"light/neopixelstrip/set-all\"\n //% weight=80 blockGap=8\n //% advanced=true\n setAll(rgb: number) {\n rgb = rgb | 0;\n const red = color.unpackR(rgb);\n const green = color.unpackG(rgb);\n const blue = color.unpackB(rgb);\n\n const end = this._start + this._length;\n const stride = this.stride();\n for (let i = this._start; i < end; ++i) {\n this.setBufferRGB(i * stride, red, green, blue)\n }\n this.autoShow();\n }\n\n /**\n * Sets a gradient between two colors\n * @param startColor the start color\n * @param endColor the end color\n */\n //% blockId=lightsetgradient block=\"set %strip gradient from %startColor=colorNumberPicker to %endColor=colorNumberPicker\"\n //% weight=79 blockGap=8\n //% group=\"More\" advanced=true\n setGradient(startColor: number, endColor: number) {\n const sr = color.unpackR(startColor);\n const sg = color.unpackG(startColor);\n const sb = color.unpackB(startColor);\n const er = color.unpackR(endColor);\n const eg = color.unpackG(endColor);\n const eb = color.unpackB(endColor);\n\n const end = this._start + this._length;\n const n1 = this._length - 1;\n const stride = this.stride();\n for (let i = this._start; i < end; ++i) {\n let x = (i - this._start) / n1;\n const ox = 1 - x;\n const r = (sr * ox + er * x) | 0;\n const g = (sg * ox + eg * x) | 0;\n const b = (sb * ox + eb * x) | 0;\n this.setBufferRGB(i * stride, r, g, b);\n }\n this.autoShow();\n }\n\n /**\n * Display a vertical bar graph based on the `value` and `high` value.\n * If `high` is 0, the chart gets adjusted automatically.\n * @param value current value to plot\n * @param high maximum value, 0 to autoscale\n */\n //% blockId=light_show_bar_graph block=\"%strip|graph %value||up to %high\" icon=\"\\uf080\"\n //% help=light/neopixelstrip/graph\n //% weight=70 blockGap=8\n //% advanced=true\n graph(value: number, high?: number): void {\n console.logValue(\"\", value);\n value = Math.abs(value);\n\n const now = control.millis();\n if (high > 0) {\n this._barGraphHigh = high;\n }\n else if (value > this._barGraphHigh || now - this._barGraphHighLast > 10000) {\n this._barGraphHigh = value;\n this._barGraphHighLast = now;\n }\n\n const bfr = this.buffered();\n this.setBuffered(true);\n const n = this._length;\n const n1 = n - 1;\n const nhalf = n / 2;\n const v = Math.round((value * n) / this._barGraphHigh);\n if (v == 0) {\n this.setAll(0);\n } else {\n for (let i = 0; i < n; ++i) {\n if (i + 1 <= v) {\n if (i < nhalf) {\n const b = (i * 255 / nhalf) >> 0;\n this.setPixelColor(i, light.rgb(0, b, 255 - b));\n } else {\n const b = ((i - nhalf) * 255 / nhalf) >> 0;\n this.setPixelColor(i, light.rgb(b, 255 - b, 0));\n }\n }\n else {\n this.setPixelColor(i, 0);\n }\n }\n }\n this.show();\n this.setBuffered(bfr);\n }\n\n /**\n * Set the pixel to a given color.\n * You need to call ``show`` to make the changes visible.\n * @param pixeloffset position of the NeoPixel in the strip\n * @param color RGB color of the LED\n */\n //% blockId=\"light_set_pixel_color\" block=\"set %strip pixel color at %pixeloffset|to %rgb=colorNumberPicker\"\n //% help=\"light/neopixelstrip/set-pixel-color\"\n //% weight=79 blockGap=8\n //% group=\"More\" advanced=true\n setPixelColor(pixeloffset: number, c: number): void {\n pixeloffset = pixeloffset | 0;\n c = c | 0;\n\n if (pixeloffset < 0\n || pixeloffset >= this._length)\n return;\n\n const stride = this.stride();\n pixeloffset = (pixeloffset + this._start) * stride;\n const red = color.unpackR(c);\n const green = color.unpackG(c);\n const blue = color.unpackB(c);\n this.setBufferRGB(pixeloffset, red, green, blue)\n this.autoShow();\n }\n\n /**\n * Gets the pixel color.\n * @param pixeloffset position of the NeoPixel in the strip\n */\n //% blockId=\"light_get_pixel_color\" block=\"%strip|pixel color at %pixeloffset\"\n //% help=\"light/neopixelstrip/pixel-color\"\n //% weight=9 blockGap=8\n //% group=\"More\" advanced=true\n pixelColor(pixeloffset: number): number {\n pixeloffset = pixeloffset | 0;\n if (pixeloffset < 0\n || pixeloffset >= this._length) {\n return 0;\n }\n\n const stride = this.stride();\n const offset = (pixeloffset + this._start) * stride;\n const b = this.buf;\n let red = 0, green = 0, blue = 0;\n switch (this._mode) {\n case NeoPixelMode.RGB_RGB:\n red = this.buf[offset + 0];\n green = this.buf[offset + 1];\n blue = this.buf[offset + 2];\n break;\n case NeoPixelMode.APA102:\n blue = this.buf[offset + 1];\n green = this.buf[offset + 2];\n red = this.buf[offset + 3];\n break;\n default:\n green = this.buf[offset + 0];\n red = this.buf[offset + 1];\n blue = this.buf[offset + 2];\n break;\n }\n\n return color.rgb(red, green, blue);\n }\n\n /**\n * Set the white brightness of a pixel in a NeoPixel strip of RGB+W LEDs.\n * This only works for RGB+W NeoPixels.\n * @param pixeloffset position of the LED in the strip\n * @param white brightness of the white LED\n */\n //% blockId=\"light_set_pixel_white_led\" block=\"set %strip pixel white LED at %pixeloffset|to %white\"\n //% help=\"light/neopixelstrip/set-pixel-white-led\"\n //% weight=5 blockGap=8\n //% group=\"More\" advanced=true\n setPixelWhiteLED(pixeloffset: number, white: number): void {\n if (this._mode != NeoPixelMode.RGBW) return;\n\n pixeloffset = pixeloffset | 0;\n if (pixeloffset < 0\n || pixeloffset >= this._length)\n return;\n\n pixeloffset = (pixeloffset + this._start) * 4;\n white = white & 0xff;\n const buf = this.buf;\n buf[pixeloffset + 3] = white;\n this.autoShow();\n }\n\n /**\n * Make the strip show all the new changes for the pixels.\n */\n //% blockId=\"light_show\" block=\"%strip|show\"\n //% help=\"light/neopixelstrip/show\"\n //% weight=86 blockGap=8\n //% group=\"More\" advanced=true\n show(): void {\n if (this._parent) this._parent.show();\n else if (this._dataPin) {\n const b = this.buf;\n\n // fast path: no processing\n if (this._brightness == 0xff && !this._brightnessBuf && !this._photonPenColor) {\n // no need to process buffer\n light.sendBuffer(this._dataPin, this._clkPin, this._mode, b);\n return;\n }\n\n // bb may be undefined if the brightness\n // is uniform over the strip and has not been allocated\n const _bb = this._brightnessBuf;\n if (!this._sendBuf) this._sendBuf = control.createBuffer(b.length);\n const sb = this._sendBuf;\n const stride = this.stride();\n const strideOffset = this._mode == NeoPixelMode.APA102 ? 1 : 0;\n // apply brightness\n for (let i = 0; i < this._length; ++i) {\n const offset = (this._start + i) * stride;\n for (let j = 0; j < strideOffset; ++j)\n sb[offset + j] = 0xff;\n for (let j = strideOffset; j < stride; ++j)\n sb[offset + j] = (b[offset + j] * (_bb ? _bb[i] : this._brightness)) >> 8;\n }\n // apply photon\n this.drawPhoton(sb, stride);\n //console.log(`${!!this._dataPin} ${!!this._clkPin} ${this.mode} hex${sb.toHex()}`)\n light.sendBuffer(this._dataPin, this._clkPin, this._mode, sb);\n }\n }\n\n protected drawPhoton(sb: Buffer, stride: number) {\n // apply photon\n if (this._photonPenColor) {\n // draw head and trail\n const tailn = Math.max(1, Math.min(8, this._length >> 4));\n let pi = this._photonPos * stride;\n let c = Math.max(128, this._brightness);\n let dc = (c - 32) / tailn;\n for (let bi = 0; bi < tailn && c > 0; ++bi) {\n if (this._mode == NeoPixelMode.RGBW)\n sb[pi + 3] = c;\n else if (this._mode == NeoPixelMode.APA102)\n sb[pi + 1] = sb[pi + 2] = sb[pi + 3] = c;\n else\n sb[pi] = sb[pi + 1] = sb[pi + 2] = c;\n\n c -= dc;\n pi += (-this._photonDir * stride) % sb.length;\n if (pi < 0) pi += sb.length;\n }\n }\n }\n\n /**\n * Turn off all pixel LEDs.\n */\n //% blockId=\"light_clear\" block=\"%strip|clear\"\n //% help=\"light/neopixelstrip/clear\"\n //% weight=85 blockGap=8\n //% group=\"More\" advanced=true\n clear(): void {\n const stride = this.stride();\n this.buf.fill(0, this._start * stride, this._length * stride);\n this.autoShow();\n }\n\n /**\n * Get the number of pixels on the strip\n */\n //% blockId=\"light_length\" block=\"%strip|length\"\n //% help=\"light/neopixelstrip/length\"\n //% weight=8 blockGap=8\n //% group=\"More\" advanced=true\n length() {\n return this._length;\n }\n\n /**\n * Set the brightness of the strip. This flag only applies to future operation.\n * @param brightness a measure of LED brightness in 0-255. eg: 20\n */\n //% blockId=\"light_set_brightness\" block=\"set %strip brightness %brightness\"\n //% brightness.min=0 brightness.max=255\n //% help=\"light/neopixelstrip/set-brightness\"\n //% weight=2 blockGap=8\n //% advanced=true\n setBrightness(brightness: number): void {\n const b = Math.max(0, Math.min(0xff, brightness | 0));\n if (b != this._brightness || this._brightnessBuf) {\n this._brightness = b;\n // if this is a top level strip clear any existing brightness buffer\n if (!this._parent)\n this._brightnessBuf = undefined;\n // if this is a NOT top-level strip or if brightness buff has been allocated,\n else if (this._parent || this._brightnessBuf)\n this.brightnessBuf.fill(this._brightness, this._start, this._length);\n this.autoShow();\n }\n }\n\n /**\n * Sets an individual pixel brightness\n * @param index \n * @param brightness \n */\n setPixelBrightness(index: number, brightness: number): void {\n const i = (index | 0);\n if (i < 0 || i > this._length) return;\n\n const b = Math.max(0, Math.min(0xff, brightness | 0));\n const bb = this.brightnessBuf;\n if (bb[this._start + i] != b) {\n bb[this._start + i] = b;\n this.autoShow();\n }\n }\n\n /**\n * Get the brightness of the pixel strip.\n */\n //% blockId=\"light_get_brightness\" block=\"%strip|brightness\"\n //% help=\"light/neopixelstrip/brightness\"\n //% parts=neopixel\n //% weight=7 blockGap=8\n //% group=\"More\" advanced=true\n brightness(): number {\n return this._brightness;\n }\n\n /**\n * Create a range of pixels.\n * @param start offset in the NeoPixel strip to start the range\n * @param length number of pixels in the range, eg: 4\n */\n //% blockId=\"light_range\" block=\"%strip|range from %start|with %length|pixels\"\n //% help=\"light/neopixelstrip/range\"\n //% weight=99 blockGap=30\n //% blockSetVariable=strip\n //% advanced=true\n range(start: number, length: number): NeoPixelStrip {\n start = start | 0;\n length = length | 0;\n\n let strip = new NeoPixelStrip();\n strip._parent = this;\n strip._dataPin = this._dataPin;\n strip._clkPin = this._clkPin;\n strip._brightness = this._brightness;\n strip._start = this._start + Math.clamp(0, this._length - 1, start);\n strip._length = Math.clamp(0, this._length - (strip._start - this._start), length);\n return strip;\n }\n\n /**\n * Shift LEDs forward and clear with zeros.\n * You need to call ``show`` to make the changes visible.\n * @param offset number of pixels to shift forward, eg: 1\n */\n //% blockId=\"light_move_pixels\" block=\"%strip|%kind=MoveKind|by %offset\"\n //% help=\"light/neopixelstrip/move\"\n //% weight=87 blockGap=8\n //% group=\"More\" advanced=true\n move(kind: LightMove, offset: number = 1): void {\n offset = offset | 0;\n\n const stride = this.stride();\n if (kind === LightMove.Shift) {\n this.buf.shift(-offset * stride, this._start * stride, this._length * stride)\n }\n else {\n this.buf.rotate(-offset * stride, this._start * stride, this._length * stride)\n }\n this.autoShow();\n }\n\n private stride(): number {\n return this._mode === NeoPixelMode.RGBW || this._mode == NeoPixelMode.APA102 ? 4 : 3;\n }\n\n initPhoton() {\n if (this._photonPos === undefined) {\n this._photonMode = PhotonMode.PenDown;\n this._photonPos = 0;\n this._photonDir = 1;\n this._photonPenColor = Colors.Red;\n }\n }\n\n /**\n * Move a photon effect along the pixel strip by a number of steps.\n * @param steps number of steps (lights) to move, eg: 1\n */\n //% blockId=light_photon_fd block=\"%strip|photon forward by %steps\"\n //% help=\"light/neopixelstrip/photon-forward\"\n //% weight=41 blockGap=8\n //% group=\"Photon\" advanced=true\n photonForward(steps: number) {\n steps = steps | 0;\n this.setPhotonPosition(this._photonPos + this._photonDir * steps);\n }\n\n /**\n * Switch the direction of the photon pulse.\n */\n //% blockId=light_photon_flip block=\"%strip|photon flip\"\n //% help=\"light/neopixelstrip/photon-flip\"\n //% weight=40 blockGap=8\n //% group=\"Photon\" advanced=true\n photonFlip() {\n this.initPhoton();\n this._photonDir *= -1;\n }\n\n /**\n * Sets the photon position to a given light index\n * @param index index of the light, if out of bound, the index is wrapped\n */\n //% blockId=light_photon_set_position block=\"%strip|photon set position %index\"\n //% help=\"light/neopixelstrip/set-photon-position\"\n //% weight=39 blockGap=8\n //% group=\"Photon\" advanced=true\n setPhotonPosition(index: number) {\n index = index | 0;\n\n this.initPhoton();\n\n // disable buffering\n const buffered = this.buffered();\n this.setBuffered(false);\n\n // move\n this._photonPos = (index >> 0) % this._length;\n if (this._photonPos < 0) this._photonPos += this._length;\n\n // paint under photon\n if (this._photonMode == PhotonMode.PenDown)\n this.setPixelColor(this._photonPos, this._photonPenColor);\n else if (this._photonMode == PhotonMode.Eraser)\n this.setPixelColor(this._photonPos, 0); // erase led\n\n // restoring buffer\n this.setBuffered(buffered);\n\n this.autoShow();\n }\n\n /**\n * Set the photon color.\n * @param color the color of the photon\n */\n //% blockId=light_photon_set_pen_color block=\"%strip=variables_get|photon set pen color %color=colorNumberPicker\"\n //% help=\"light/neopixelstrip/set-photon-pen-color\"\n //% weight=38 blockGap=8\n //% group=\"Photon\" advanced=true\n setPhotonPenColor(color: number) {\n color = color | 0;\n this.initPhoton();\n this._photonPenColor = color;\n this.photonForward(0);\n }\n\n /**\n * Sets the photon hue.\n * @param hue the hue of the photon color\n */\n //% blockId=light_photon_set_pen_hue block=\"%strip=variables_get|photon set pen hue %hue=colorWheelHsvPicker\"\n //% help=\"light/neopixelstrip/set-photon-pen-hue\"\n //% weight=39 blockGap=8\n //% group=\"Photon\" advanced=true\n setPhotonPenHue(hue: number) {\n hue = hue | 0;\n this.setPhotonPenColor(color.hsv(hue, 0xff, 0xff));\n }\n\n //% deprecated=1 blockHidden=1\n //% group=\"Photon\" advanced=true\n setPhotonColor(hue: number) {\n this.setPhotonPenHue(hue);\n }\n\n /**\n * Set the photon mode to pen up, pen down, or eraser.\n * @param mode the desired mode\n */\n //% blockId=light_photon_set_photon block=\"%strip|photon %mode\"\n //% help=\"light/neopixelstrip/set-photon-mode\"\n //% weight=38\n //% group=\"Photon\" advanced=true\n setPhotonMode(mode: PhotonMode) {\n if (mode == PhotonMode.Off) {\n this._photonPos = undefined;\n this.show();\n } else {\n this.initPhoton();\n if (this._photonMode != mode) {\n this._photonMode = mode;\n this.photonForward(0);\n }\n }\n }\n\n /**\n * Starts a brightness transition on the strip (and cancels any other running transition)\n * @param transition \n * @param duration \n */\n startBrightnessTransition(\n startBrightness: number,\n endBrightness: number,\n duration: number,\n repeat?: number,\n yoyo?: boolean,\n transition?: BrightnessTransition\n ) {\n const player = this._transitionPlayer = new BrightnessTransitionPlayer(\n transition || new EasingBrightnessTransition(undefined),\n startBrightness,\n endBrightness,\n duration,\n repeat,\n yoyo);\n control.runInBackground(() => {\n while (player == this._transitionPlayer) {\n const buf = this.buffered();\n this.setBuffered(true);\n const keepRendering = player.update(this);\n this.setBuffered(buf);\n this.show();\n pause(20);\n if (!keepRendering) break;\n }\n });\n }\n\n /**\n * Stops any running brightness transition\n */\n stopBrightnessTransition() {\n this._transitionPlayer = undefined;\n }\n\n /**\n * Show an animation or queue an animation in the animation queue\n * @param animation the animation to run\n * @param duration the duration to run in milliseconds, eg: 500\n */\n //% blockId=light_show_animation block=\"%strip|show animation %animation=light_animation_picker|for %duration=timePicker|ms\"\n //% help=\"light/neopixelstrip/show-animation\"\n //% weight=90 blockGap=8\n //% advanced=true\n showAnimation(animation: NeoPixelAnimation, duration: number) {\n if (!animation) return;\n\n // if a previous renderer for the same animation was used, keep using it\n let animationRenderer = this._lastAnimationRenderer;\n if (!animationRenderer || this._lastAnimation != animation) {\n animationRenderer = animation.createRenderer(this);\n if (!animationRenderer) return;\n }\n\n let start = -1;\n const render: () => boolean = () => {\n // keep track of whose running\n this._lastAnimation = animation;\n this._lastAnimationRenderer = animationRenderer;\n // execute animation\n if (start < 0) start = control.millis();\n const now = control.millis() - start;\n const buf = this.buffered();\n this.setBuffered(true);\n const keepRendering = animationRenderer();\n this.setBuffered(buf);\n this.show();\n pause(1);\n return duration > 0\n ? now <= duration\n : keepRendering;\n };\n this.queueAnimation(render);\n }\n\n /**\n * Show a single animation frame.\n * @param animation the animation to run\n */\n //% blockId=light_show_animation_frame block=\"%strip|show frame of %animation=light_animation_picker|animation\"\n //% help=\"light/neopixelstrip/show-animation-frame\"\n //% weight=87 blockGap=8\n //% group=\"More\" advanced=true\n showAnimationFrame(animation: NeoPixelAnimation) {\n if (!animation) {\n this._lastAnimation = undefined;\n this._lastAnimationRenderer = undefined;\n return;\n }\n let renderer = this._lastAnimationRenderer;\n if (!renderer || this._lastAnimation != animation) {\n this._lastAnimation = animation;\n renderer = this._lastAnimationRenderer = animation.createRenderer(this);\n }\n if (renderer) {\n const buf = this.buffered();\n this.setBuffered(true);\n renderer();\n this.setBuffered(buf);\n this.autoShow();\n }\n }\n\n /**\n * Renders a pattern of colors on the strip\n */\n showColors(leds: string, interval: number = 400) {\n const n = this._length;\n let tempColor = \"\";\n let i = 0;\n let pi = 0;\n\n this.queueAnimation(() => {\n const bf = this.buffered();\n this.setBuffered(true);\n\n while (i < leds.length) {\n const currChar = leds.charAt(i++);\n const isSpace = currChar == ' ' || currChar == '\\n' || currChar == '\\r';\n if (!isSpace)\n tempColor += currChar;\n\n if ((isSpace || i == leds.length) && tempColor) {\n this.setPixelColor(pi++, color.parseColor(tempColor))\n tempColor = \"\";\n if (pi == n) {\n this.show();\n pause(interval);\n pi = 0;\n break;\n }\n }\n }\n\n this.setBuffered(bf);\n return i < leds.length;\n });\n }\n\n //%\n private queueAnimation(render: () => boolean) {\n if (!this._animationQueue) {\n this._animationQueue = new control.AnimationQueue();\n this._animationQueue.interval = 50;\n this._lastAnimation = undefined;\n this._lastAnimationRenderer = undefined;\n }\n this._animationQueue.runUntilDone(render);\n }\n\n /**\n * Stop the current animation and any other animations ready to show.\n */\n //% blockId=light_stop_all_animations block=\"%strip|stop all animations\"\n //% help=\"light/neopixelstrip/stop-all-animations\"\n //% weight=85 blockGap=8\n //% group=\"More\" advanced=true\n stopAllAnimations() {\n if (this._animationQueue) {\n this._animationQueue.cancel();\n this._lastAnimation = undefined;\n this._lastAnimationRenderer = undefined;\n }\n }\n\n /**\n * Enables or disables automatically calling show when a change is made\n * @param on call show whenever a light is modified\n */\n //% blockId=light_set_buffered block=\"set %strip buffered %on\"\n //% help=\"light/neopixelstrip/set-buffered\"\n //% weight=86 blockGap=8\n //% group=\"Configuration\" advanced=true\n setBuffered(on: boolean): void {\n if (this._parent) this._parent.setBuffered(on);\n else this._buffered = on;\n }\n\n /**\n * Gets a value indicated if the changes are buffered\n */\n //% weight=85 blockGap=8\n //% group=\"Configuration\" advanced=true\n buffered(): boolean {\n return this._parent ? this._parent.buffered() : this._buffered;\n }\n\n /**\n * Sets the color mode and clears the colors.\n * @param mode the kind of color encoding required by the programmable lights\n */\n //% blockId=light_set_mode block=\"set %strip mode to %mode\"\n //% help=\"light/neopixelstrip/set-mode\"\n //% weight=1 blockGap=8\n //% group=\"Configuration\" advanced=true\n setMode(mode: NeoPixelMode): void {\n if (this._parent)\n this._parent.setMode(mode);\n else if (this._mode != mode) {\n this._mode = mode;\n this.reallocateBuffer();\n }\n }\n\n /**\n * Sets the number of LEDs on a strip\n * @param numleds \n */\n //% blockId=light_set_length block=\"set %strip length to %length pixels\"\n //% weight=1 blockGap=8\n //% length.shadow=lightLengthPicker\n //% group=\"Configuration\" advanced=true\n setLength(numleds: number): void {\n const n = Math.max(0, numleds | 0);\n // lazy update\n if (n != this._length) {\n if (this._parent)\n this._length = Math.min(n, this._parent.length() - this._start);\n else {\n this._length = n;\n this.reallocateBuffer();\n }\n }\n }\n\n private autoShow() {\n if (!this.buffered()) {\n this.show();\n pause(1);\n }\n }\n\n private setBufferRGB(offset: number, red: number, green: number, blue: number): void {\n const b = this.buf;\n // https://cdn-shop.adafruit.com/datasheets/APA102.pdf\n switch (this._mode) {\n case NeoPixelMode.RGB_RGB:\n b[offset] = red;\n b[offset + 1] = green;\n b[offset + 2] = blue;\n break;\n case NeoPixelMode.APA102:\n // https://cdn-shop.adafruit.com/datasheets/APA102.pdf\n b[offset] = 0xe0 | 0x1f; // full brightness\n b[offset + 1] = blue;\n b[offset + 2] = green;\n b[offset + 3] = red;\n break;\n default:\n b[offset + 0] = green;\n b[offset + 1] = red;\n b[offset + 2] = blue;\n break;\n }\n }\n\n private reallocateBuffer(): void {\n if (this._parent) return; // not supported in ranges\n const stride = this.stride();\n this._buf = control.createBuffer(this._length * stride);\n this._brightnessBuf = undefined;\n this._sendBuf = undefined;\n }\n\n // From here onwards, these block definitions are there for compatibility with old blocks\n // (that have the default instance logic)\n\n /**\n * Set all of the pixels on the strip to one RGB color.\n * @param rgb RGB color of the LED\n */\n //% blockId=\"neopixel_set_strip_color\" block=\"set all pixels to %rgb=colorNumberPicker\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __setAll(rgb: number) {\n this.setAll(rgb);\n }\n\n /**\n * Display a vertical bar graph based on the `value` and `high` value.\n * If `high` is 0, the chart gets adjusted automatically.\n * @param value current value to plot\n * @param high maximum value, 0 to autoscale\n */\n //% blockId=neopixel_show_bar_graph block=\"graph %value |up to %high\" icon=\"\\uf080\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __graph(value: number, high: number): void {\n this.graph(value, high);\n }\n\n /**\n * Set the pixel to a given color.\n * You need to call ``show`` to make the changes visible.\n * @param pixeloffset position of the NeoPixel in the strip\n * @param color RGB color of the LED\n */\n //% blockId=\"neopixel_set_pixel_color\" block=\"set pixel color at %pixeloffset|to %rgb=colorNumberPicker\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __setPixelColor(pixeloffset: number, color: number): void {\n this.setPixelColor(pixeloffset, color);\n }\n\n /**\n * Gets the pixel color.\n * @param pixeloffset position of the NeoPixel in the strip\n */\n //% blockId=\"neopixel_get_pixel_color\" block=\"pixel color at %pixeloffset\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __pixelColor(pixeloffset: number): number {\n return this.pixelColor(pixeloffset);\n }\n\n /**\n * Set the white brightness of a pixel in a NeoPixel strip of RGB+W LEDs.\n * This only works for RGB+W NeoPixels.\n * @param pixeloffset position of the LED in the strip\n * @param white brightness of the white LED\n */\n //% blockId=\"neopixel_set_pixel_white_led\" block=\"set pixel white LED at %pixeloffset|to %white\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __setPixelWhiteLED(pixeloffset: number, white: number): void {\n this.setPixelWhiteLED(pixeloffset, white);\n }\n\n /**\n * Make the strip show all the new changes for the pixels.\n */\n //% blockId=\"neopixel_show\" block=\"show\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __show(): void {\n this.show();\n }\n\n /**\n * Turn off all pixel LEDs.\n */\n //% blockId=\"neopixel_clear\" block=\"clear\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __clear(): void {\n this.clear();\n }\n\n /**\n * Get the number of pixels on the strip\n */\n //% blockId=\"neopixel_length\" block=\"length\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __length() {\n return this.length();\n }\n\n /**\n * Set the brightness of the strip. This flag only applies to future operation.\n * @param brightness a measure of LED brightness in 0-255. eg: 20\n */\n //% blockId=\"neopixel_set_brightness\" block=\"set brightness %brightness\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __setBrightness(brightness: number): void {\n this.setBrightness(brightness);\n }\n\n /**\n * Get the brightness of the pixel strip.\n */\n //% blockId=\"neopixel_get_brightness\" block=\"brightness\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __brightness(): number {\n return this.brightness();\n }\n\n /**\n * Create a range of pixels.\n * @param start offset in the NeoPixel strip to start the range\n * @param length number of pixels in the range. eg: 4\n */\n //% blockId=\"neopixel_range\" block=\"range from %start|with %length|pixels\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __range(start: number, length: number): NeoPixelStrip {\n return this.range(start, length);\n }\n\n /**\n * Shift LEDs forward and clear with zeros.\n * You need to call ``show`` to make the changes visible.\n * @param offset number of pixels to shift forward, eg: 1\n */\n //% blockId=\"neopixel_move_pixels\" block=\"%kind=MoveKind|by %offset\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __move(kind: LightMove, offset: number = 1): void {\n this.move(kind, offset);\n }\n\n /**\n * Move a photon effect along the pixel strip by a number of steps.\n * @param steps number of steps (lights) to move, eg: 1\n */\n //% blockId=neophoton_fd block=\"photon forward by %steps\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __photonForward(steps: number) {\n this.photonForward(steps);\n }\n\n /**\n * Switch the direction of the photon pulse.\n */\n //% blockId=neophoton_flip block=\"photon flip\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __photonFlip() {\n this.photonFlip();\n }\n\n /**\n * Set the photon color.\n * @param color the color of the photon\n */\n //% blockId=neophoton_set_color block=\"photon set pen color %color\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __setPhotonColor(color: number) {\n // The photon color has since changed, and we now use setPhotonPenHue to set the hue of the photon color\n this.setPhotonPenHue(color);\n }\n\n /**\n * Set the photon mode to pen up, pen down, or eraser.\n * @param mode the desired mode\n */\n //% blockId=neophoton_set_photon block=\"photon %mode\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __setPhotonMode(mode: PhotonMode) {\n this.setPhotonMode(mode);\n }\n\n /**\n * Show an animation or queue an animation in the animation queue\n * @param animation the animation to run\n * @param duration the duration to run in milliseconds, eg: 500\n */\n //% blockId=neopixel_show_animation block=\"show %animation=light_animation|animation for %duration=timePicker|ms\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __showAnimation(animation: NeoPixelAnimation, duration: number) {\n this.showAnimation(animation, duration);\n }\n\n /**\n * Show a single animation frame\n * @param animation the animation to run\n */\n //% blockId=neopixel_show_animation_frame block=\"show animation frame %animation=light_animation\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __showAnimationFrame(animation: NeoPixelAnimation) {\n this.showAnimationFrame(animation);\n }\n\n /**\n * Stop the current animation and any other animations ready to show.\n */\n //% blockId=neopixel_stop_all_animations block=\"stop all animations\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __stopAllAnimations() {\n this.stopAllAnimations();\n }\n\n /**\n * Enables or disables automatically calling show when a change is made\n * @param on call show whenever a light is modified\n */\n //% blockId=neopixel_set_buffered block=\"set buffered %on\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __setBuffered(on: boolean): void {\n this.setBuffered(on);\n }\n\n /**\n * Sets the color mode and clears the colors.\n * @param mode the kind of color encoding required by the programmable lights\n */\n //% blockId=neopixel_set_mode block=\"set mode %mode\"\n //% deprecated=1\n //% defaultInstance=light.pixels\n __setMode(mode: NeoPixelMode): void {\n this.setMode(mode);\n }\n }\n\n /**\n * Creates a strip of colored LEDs (WS2812b)\n */\n //% blockId=\"neopixel_create\" block=\"create WS2812 strip|pin %pin|with %numleds pixels\"\n //% help=\"light/create-neo-pixel-strip\"\n //% trackArgs=0,2\n //% parts=\"neopixel\"\n //% weight=100 blockSetVariable=strip\n //% advanced=true blockHidden=1\n export function createNeoPixelStrip(\n pin: DigitalInOutPin,\n numleds: number = 10,\n mode?: NeoPixelMode\n ): NeoPixelStrip {\n if (!mode)\n mode = NeoPixelMode.RGB;\n\n const strip = new NeoPixelStrip();\n strip._mode = mode;\n strip._length = Math.max(0, numleds | 0);\n strip._dataPin = pin;\n if (strip._dataPin) // board with no-board LEDs won't have a default pin\n strip._dataPin.digitalWrite(false);\n return strip;\n }\n\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=\"neopixel_rgb\" 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=\"light/rgb\"\n //% group=\"Color\" weight=19 blockGap=8\n export function rgb(red: number, green: number, blue: number): number {\n return color.rgb(red, green, blue);\n }\n\n /**\n * Get the RGB value of a known color\n */\n //% blockId=neopixel_colors block=\"%color\"\n //% help=\"light/colors\"\n //% shim=TD_ID\n //% group=\"Color\" weight=20 blockGap=8\n export function colors(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=\"neopixel_hsv\" 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=\"light/hsv\"\n //% group=\"Color\" weight=17\n export function hsv(hue: number, sat: number = 255, val: number = 255): number {\n return color.hsv(hue, sat, val);\n }\n\n /**\n * Use color.fade instead\n * @param color color to fade\n * @param brightness the amount of brightness to apply to the color, eg: 128\n */\n //% blockId=\"neopixel_fade\" 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 deprecated\n export function fade(c: number, brightness: number): number {\n return color.fade(c, brightness);\n }\n\n /**\n * An animation of a NeoPixel\n */\n //% fixedInstances\n export class NeoPixelAnimation {\n constructor() { }\n\n /**\n * Creates an animator instance\n * @param strip the strip to execute on\n */\n createRenderer(strip: NeoPixelStrip): () => boolean {\n return undefined;\n }\n }\n\n export class RainbowCycleAnimation extends NeoPixelAnimation {\n public delay: number;\n constructor(delay: number) {\n super();\n this.delay = delay;\n }\n\n public createRenderer(strip: NeoPixelStrip): () => boolean {\n const n = strip.length();\n let hueOffset = 0;\n return () => {\n for (let i = 0; i < n; i++) {\n strip.setPixelColor(i, color.hsv(((i * 256) / (n - 1) + hueOffset) % 0xff, 0xff, 0xff));\n }\n hueOffset += Math.ceil(128 / n);\n if (hueOffset >= 0xff) {\n hueOffset = 0;\n return false;\n } else {\n return true;\n }\n }\n }\n }\n\n //% fixedInstance block=\"rainbow\" whenUsed jres blockIdentity=\"light._animationPicker\"\n export const rainbowAnimation: NeoPixelAnimation = new RainbowCycleAnimation(50);\n\n export class RunningLightsAnimation extends NeoPixelAnimation {\n public red: number;\n public green: number;\n public blue: number;\n public delay: number;\n\n constructor(red: number, green: number, blue: number, delay: number) {\n super();\n this.red = red;\n this.green = green;\n this.blue = blue;\n\n this.delay = delay;\n }\n\n public createRenderer(strip: NeoPixelStrip): () => boolean {\n const l = strip.length();\n let iteration = 0;\n let step = 0;\n return () => {\n if (iteration < l * 2) {\n step++;\n for (let i = 0; i < l; i++) {\n const level = (Math.isin(i + step) * 127) + 128;\n strip.setPixelColor(i, color.rgb(level * this.red / 255, level * this.green / 255, level * this.blue / 255));\n }\n iteration++;\n return true;\n } else {\n step = 0;\n iteration = 0;\n return false;\n }\n }\n }\n }\n\n //% fixedInstance block=\"running lights\" jres blockIdentity=\"light._animationPicker\"\n export const runningLightsAnimation: NeoPixelAnimation = new RunningLightsAnimation(0xff, 0, 0, 50);\n\n class CometAnimation extends NeoPixelAnimation {\n public red: number;\n public green: number;\n public blue: number;\n public delay: number;\n\n constructor(red: number, green: number, blue: number, delay: number) {\n super();\n this.red = red;\n this.green = green;\n this.blue = blue;\n this.delay = delay;\n }\n\n public createRenderer(strip: NeoPixelStrip): () => boolean {\n const l = strip.length();\n const spacing = (255 / l) >> 0;\n let start = -1;\n let step = 0;\n const offsets: number[] = [];\n for (let i = 0; i < l; i++) {\n offsets[i] = spacing * i;\n }\n return () => {\n for (let i = 0; i < l; i++) {\n offsets[i] = (offsets[i] + (step * 2)) % 255\n strip.setPixelColor(i, color.rgb(255 - offsets[i], this.green, this.blue));\n }\n step++;\n if (step * 2 > 0xff) {\n step = 0;\n return false;\n }\n return true;\n }\n }\n }\n\n //% fixedInstance block=\"comet\" jres blockIdentity=\"light._animationPicker\"\n export const cometAnimation: NeoPixelAnimation = new CometAnimation(0xff, 0, 0xff, 50);\n\n export class SparkleAnimation extends NeoPixelAnimation {\n public rgb: number;\n public delay: number;\n\n constructor(red: number, green: number, blue: number, delay: number) {\n super();\n this.rgb = color.rgb(red, green, blue);\n this.delay = delay;\n }\n\n public createRenderer(strip: NeoPixelStrip): () => boolean {\n const l = strip.length();\n let count = 0;\n let pixel = -1;\n let pixelColor = 0;\n return () => {\n if (count == 0)\n strip.clear();\n if (pixel < 0) {\n pixel = Math.randomRange(0, l - 1);\n pixelColor = strip.pixelColor(pixel);\n strip.setPixelColor(pixel, this.rgb);\n\n } else {\n strip.setPixelColor(pixel, pixelColor);\n pixel = -1;\n }\n count++;\n if (count > 50) {\n count = 0;\n return false;\n } else {\n return true;\n }\n }\n }\n }\n\n //% fixedInstance block=\"sparkle\" jres blockIdentity=\"light._animationPicker\"\n export const sparkleAnimation: NeoPixelAnimation = new SparkleAnimation(0xff, 0xff, 0xff, 50);\n\n class ColorWipeAnimation extends NeoPixelAnimation {\n public rgb: number;\n public delay: number;\n\n constructor(rgb: number, delay: number) {\n super();\n this.rgb = rgb;\n this.delay = delay;\n }\n\n public createRenderer(strip: NeoPixelStrip): () => boolean {\n const l = strip.length();\n let i = 0;\n let reveal = true;\n return () => {\n if (i < l) {\n if (reveal) {\n strip.setPixelColor(i, this.rgb);\n } else {\n strip.setPixelColor(i, 0);\n }\n i++;\n } else {\n reveal = !reveal;\n i = 0;\n if (reveal)\n return false;\n }\n return true;\n }\n }\n }\n\n //% fixedInstance block=\"color wipe\" jres blockIdentity=\"light._animationPicker\"\n export const colorWipeAnimation: NeoPixelAnimation = new ColorWipeAnimation(0x0000ff, 50);\n\n class TheatreChaseAnimation extends NeoPixelAnimation {\n public rgb: number;\n public delay: number;\n\n constructor(red: number, green: number, blue: number, delay: number) {\n super();\n this.rgb = color.rgb(red, green, blue);\n this.delay = delay;\n }\n\n public createRenderer(strip: NeoPixelStrip): () => boolean {\n const l = strip.length();\n let j = 0;\n let q = 0;\n let on = false;\n return () => {\n if (j < 10) { // 10 cycles of chasing\n if (q < 3) {\n if (on) {\n for (let i = 0; i < l; i = i + 3) {\n strip.setPixelColor(i + q, this.rgb); // every third pixel on\n }\n }\n else {\n for (let i = 0; i < l; i = i + 3) {\n strip.setPixelColor(i + q, 0); // every third pixel off\n }\n }\n on = !on;\n q++;\n } else {\n q = 0;\n }\n j++;\n } else {\n j = 0;\n return false;\n }\n return true;\n }\n }\n }\n\n //% fixedInstance block=\"theater chase\" jres blockIdentity=\"light._animationPicker\"\n export const theaterChaseAnimation: NeoPixelAnimation = new TheatreChaseAnimation(0xff, 0, 0, 50);\n\n /**\n * An animation that can be shown on a light strip\n * @param animation The animation type\n */\n //% blockId=light_animation_picker block=\"%animation\" shim=TD_ID\n //% animation.fieldEditor=\"imagedropdown\"\n //% animation.fieldOptions.columns=3\n //% weight=0\n //% group=\"More\"\n export function _animationPicker(animation: NeoPixelAnimation): NeoPixelAnimation {\n return animation;\n }\n\n /**\n * Get the light length picker\n * @param pixels number of LEDs\n */\n //% blockId=lightLengthPicker block=\"%pixels\"\n //% blockHidden=true shim=TD_ID\n //% colorSecondary=\"#FFFFFF\"\n //% pixels.fieldEditor=\"numberdropdown\" pixels.fieldOptions.decompileLiterals=true\n //% pixels.fieldOptions.data='[[\"7\", 7], [\"8\", 8], [\"12\", 12], [\"16\", 16], [\"24\", 24], [\"30\", 30], [\"60\", 60], [\"64\", 64], [\"90\", 90], [\"120\", 120], [\"144\", 144]]'\n export function __lengthPicker(pixels: number): number {\n return pixels;\n }\n}\n",
"neopixeloverrides.ts": "// replace in other targets",
"ns.ts": "\n/**\n * Functions to operate colored LEDs.\n */\n//% weight=100 color=\"#0078d7\" icon=\"\\uf00a\"\nnamespace light {\n\n}",
"onboardstrip.ts": "namespace light {\n let _onboardStrip: light.LightStrip;\n /**\n * Get the onboard light strip.\n */\n //% help=light/onboard-strip\n //% blockId=\"neopixel_onboard_strip\" block=\"onboard strip\"\n //% weight=111 blockGap=8\n //% advanced=true\n export function onboardStrip(): NeoPixelStrip {\n if (_onboardStrip) return _onboardStrip;\n\n { // try onboard cfg\n const data = pins.pinByCfg(DAL.CFG_PIN_ONBOARD_DOTSTAR_DATA);\n const clk = pins.pinByCfg(DAL.CFG_PIN_ONBOARD_DOTSTAR_CLOCK);\n const dsnum = control.getConfigValue(DAL.CFG_NUM_ONBOARD_DOTSTARS, 0);\n const neo = pins.pinByCfg(DAL.CFG_PIN_ONBOARD_NEOPIXEL);\n const neonum = control.getConfigValue(DAL.CFG_NUM_ONBOARD_NEOPIXELS, 0);\n if (data && clk && dsnum > 0) {\n _onboardStrip = light.createAPA102Strip(data, clk, dsnum);\n _onboardStrip.setBrightness(96);\n return _onboardStrip;\n } else if (neo && neonum > 0) {\n _onboardStrip = light.createNeoPixelStrip(neo, neonum, NeoPixelMode.RGB);\n return _onboardStrip;\n }\n }\n\n { // resolve from pins\n const data = pins.pinByCfg(DAL.CFG_PIN_DOTSTAR_DATA);\n const clk = pins.pinByCfg(DAL.CFG_PIN_DOTSTAR_CLOCK);\n const dsnum = control.getConfigValue(DAL.CFG_NUM_DOTSTARS, 0);\n const neo = pins.pinByCfg(DAL.CFG_PIN_NEOPIXEL);\n const neonum = control.getConfigValue(DAL.CFG_NUM_NEOPIXELS, 0);\n if (data && clk && dsnum > 0) {\n _onboardStrip = light.createAPA102Strip(data, clk, dsnum);\n _onboardStrip.setBrightness(96);\n return _onboardStrip;\n } else if (neo && neonum > 0) {\n _onboardStrip = light.createNeoPixelStrip(neo, neonum, NeoPixelMode.RGB);\n return _onboardStrip;\n } else {\n _onboardStrip = light.createNeoPixelStrip(undefined, 0);\n }\n }\n\n return _onboardStrip;\n }\n}",
"pxt.json": "{\n \"name\": \"light\",\n \"description\": \"The programmable LED (WS2812b,APA102) driver.\",\n \"dependencies\": {\n \"core\": \"*\",\n \"color\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"neopixel.ts\",\n \"transitions.ts\",\n \"create.ts\",\n \"defaultstrip.ts\",\n \"onboardstrip.ts\",\n \"defaultlights.ts\",\n \"defaultlightsoverrides.ts\",\n \"ns.ts\",\n \"neopixeloverrides.ts\",\n \"animations.jres\",\n \"targetoverrides.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"icon\": \"/static/libs/light.png\"\n}\n",
"targetoverrides.ts": "// define built-in strips here",
"test.ts": "\nlet strip = light.createStrip()\nstrip.setBrightness(20)\n\nfunction flash(n: number) {\n control.runInParallel(() => {\n strip.setPixelColor(n, 0x0000ff)\n pause(1000)\n strip.setPixelColor(n, 0x000000)\n })\n}\n\nflash(0)\n\n",
"transitions.ts": "namespace easing {\n export function linear(t: number): number { return t; }\n export function inQuad(t: number): number { return t * t; }\n export function outQuad(t: number): number { return t * (2 - t); }\n export function inOutQuad(t: number): number { return t < .5 ? 2 * t * t : -1 + (4 - 2 * t) * t; }\n export function inCubic(t: number): number { return t * t * t; }\n export function outCubic(t: number): number { return (--t) * t * t + 1; }\n export function inOutCubic(t: number): number { return t < .5 ? 4 * t * t * t : (t - 1) * (2 * t - 2) * (2 * t - 2) + 1; }\n}\n\nnamespace light {\n export class BrightnessTransition {\n constructor() { }\n apply(strip: LightStrip, t: number, start: number, end: number): void {\n\n }\n }\n\n export class EasingBrightnessTransition extends BrightnessTransition {\n private timeEasing: (t: number) => number;\n private spatialEasing: (t: number) => number;\n\n constructor(\n timeEasing: (t: number) => number, \n spatialEasing?: (t: number) => number) {\n super();\n this.timeEasing = timeEasing || easing.inOutQuad;\n this.spatialEasing = spatialEasing;\n }\n\n apply(strip: LightStrip, t: number, start: number, end: number): void {\n // t in [0..1]\n const db = end - start;\n const b = this.timeEasing(t); // [0..1]\n if (!this.spatialEasing) {\n strip.setBrightness(start + db * b);\n }\n else {\n // convolve desired brightness with spacial easing function\n const n = strip.length();\n for (let i = 0; i < n; ++i) {\n const x = this.spatialEasing(i / (n - 1)); // [0..1]\n strip.setPixelBrightness(i, end - db * (1 - b) * x);\n }\n }\n }\n }\n\n export class BrightnessTransitionPlayer {\n private transition: BrightnessTransition;\n private startBrightness: number;\n private endBrightness: number;\n private duration: number;\n private startTime: number;\n private repeat: number;\n private yoyo: number;\n\n constructor(\n transition: BrightnessTransition,\n startBrightness: number,\n endBrightness: number,\n duration: number,\n repeat: number,\n yoyo: boolean) {\n this.transition = transition;\n this.startBrightness = startBrightness;\n this.endBrightness = endBrightness;\n this.duration = duration;\n this.startTime = control.millis();\n this.repeat = repeat || 1;\n this.yoyo = yoyo ? 1 : 0;\n }\n\n update(strip: LightStrip): boolean {\n let elapsed = control.millis() - this.startTime;\n if (elapsed > this.duration) {\n this.yoyo = -this.yoyo;\n if (this.repeat > 0)\n this.repeat--;\n this.startTime = control.millis();\n elapsed = 0;\n return this.repeat != 0;\n }\n\n let t = elapsed / this.duration;\n if (this.yoyo < 0)\n t = 1 - t;\n this.transition.apply(strip, t, this.startBrightness, this.endBrightness);\n return true;\n }\n }\n}"
},
"tests": {
"README.md": "# tests\n\nA unit test framework\n\n## Defining tests\n\nTests are registered as event handlers. They will automatically run once ``on start`` is finished.\n\n```blocks\ntests.test(\"lgB set speed 10\", () => {\n motors.largeB.setSpeed(10);\n pause(100)\n tests.assertClose(\"speedB\", 10, motors.largeB.speed(), 2)\n});\n```\n\n## Assertions\n\nThe library has various asserts that will register fault. Note that since exceptions are not available, assertion failure **do not** stop the program execution.\n\n* **assert** checks a boolean condition\n\n```blocks\ntests.assert(\"speed positive\", motors.largeB.speed() > 0)\n```\n\n* **assert close** checks that a numberical value is within a particular range\n\n```blocks\ntests.assertClose(\"speed\", motors.largeB.speed(), 10, 2)\n```\n\n```package\ntests\n```",
"pxt.json": "{\n \"name\": \"tests\",\n \"description\": \"A unit test library\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"tests.ts\",\n \"targetoverrides.ts\"\n ],\n \"testFiles\": [],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"targetoverrides.ts": "// override this file in targets for target specific setup\n",
"tests.ts": "/**\n * Various test event in the execution cycle\n */\nenum TestEvent {\n //% block=\"run setup\"\n RunSetUp = 0,\n //% block=\"run teardown\"\n RunTearDown = 1,\n //% block=\"test setup\"\n TestSetUp = 2,\n //% block=\"test teardown\"\n TestTearDown = 3\n}\n\n/**\n * A Unit tests framework\n */\n//% weight=100 color=#0fbc11 icon=\"\"\nnamespace tests {\n class Test {\n name: string;\n handler: () => void;\n errors: string[];\n\n constructor(name: string, handler: () => void) {\n this.name = name;\n this.handler = handler;\n this.errors = [];\n }\n\n run() {\n // clear state\n if (_runSetup)\n _runSetup();\n\n console.log(`> ${this.name}`)\n this.handler()\n\n if (this.errors.length)\n console.log('')\n\n // ensure clean state after test\n if (_runTearDown)\n _runTearDown();\n }\n }\n\n let _tests: Test[] = undefined;\n let _currentTest: Test = undefined;\n let _runSetup: () => void = undefined;\n let _runTearDown: () => void = undefined;\n let _testSetUp: () => void = undefined;\n let _testTearDown: () => void = undefined;\n\n function run() {\n if (!_tests) return;\n\n if (_testSetUp)\n _testSetUp();\n\n const start = control.millis();\n console.log(`${_tests.length} tests found`)\n console.log(` `)\n for (let i = 0; i < _tests.length; ++i) {\n const t = _currentTest = _tests[i];\n t.run();\n _currentTest = undefined;\n }\n\n if (_testTearDown)\n _testTearDown();\n\n console.log(` `)\n console.log(`${_tests.length} tests, ${_tests.map(t => t.errors.length).reduce((p, c) => p + c, 0)} errs in ${Math.ceil((control.millis() - start) / 1000)}s`)\n }\n\n /**\n * Registers a test to run\n */\n //% blockId=testtest block=\"test %name\"\n //% weight=100\n export function test(name: string, handler: () => void): void {\n if (!name || !handler) return;\n if (!_tests) {\n _tests = [];\n control.runInParallel(function () {\n // should run after on start\n pause(100)\n run()\n })\n }\n _tests.push(new Test(name, handler));\n }\n\n /**\n * Checks a boolean condition\n */\n //% blockId=testAssert block=\"assert %message|%condition\"\n //% weight=80\n //% blockGap=8\n export function assert(message: string, condition: boolean) {\n if (!condition) {\n console.log(`!!! ${message || ''}`)\n if (_currentTest)\n _currentTest.errors.push(message);\n }\n }\n\n /**\n * Checks that 2 values are close to each other\n * @param expected what the value should be\n * @param actual what the value was\n * @param tolerance the acceptable error margin, eg: 5\n */\n //% blockId=testAssertClose block=\"assert %message|%expected|close to %actual|by %tolerance\"\n //% weight=79\n //% inlineInputMode=inline\n export function assertClose(name: string, expected: number, actual: number, tolerance: number) {\n assert(`${name} ${expected} != ${actual} +-${tolerance}`, Math.abs(expected - actual) <= tolerance);\n }\n\n /**\n * Registers code to be called at various points in the test execution\n * @param handler\n */\n //% blockGap=8\n //% weight=10\n export function onEvent(event: TestEvent, handler: () => void) {\n switch(event) {\n case TestEvent.RunSetUp: _runSetup = handler; break;\n case TestEvent.RunTearDown: _runTearDown = handler; break;\n case TestEvent.TestSetUp: _testSetUp = handler; break;\n case TestEvent.TestTearDown: _testTearDown = handler; break;\n }\n }\n}\n"
},
"gamepad": {
"gamepad.cpp": "// https://github.com/lancaster-university/codal-core/blob/master/inc/drivers/HIDJoystick.h\n\n\n\n#include \"pxt.h\"\nnamespace gamepad {\n /** \n * Set the button state to down\n */\n //% help=gamepad/set-button\n //% blockId=joystickSetButton block=\"gamepad button %index=joystickStandardButton|%down=toggleDownUp\"\n //% weight=100\n void setButton(int index, bool down) {\n if (down)\n pxt::joystick.buttonDown(index);\n else\n pxt::joystick.buttonUp(index);\n }\n\n /**\n * Set the current move on the gamepad\n **/\n //% blockId=gamepadMove block=\"gamepad %index|move by x %x|y %y\"\n //% help=gamepad/move\n //% index.min=0 index.max=1\n //% blockGap=8\n void move(int index, int x, int y) {\n pxt::joystick.move(index, x, y); \n }\n\n /** \n * Set the throttle state\n */\n //% blockId=gamepadSetThrottle block=\"gamepad set throttle %index|to %value\"\n //% gamepad/set-throttle blockHidden=1\n //% index.min=0 index.max=1\n //% value.min=0 value.max=31\n //%help=gamepad/set-throttle\n void setThrottle(int index, int value) {\n value = max(0, min(31, value));\n pxt::joystick.setThrottle(index, value);\n }\n}",
"gamepad.ts": "enum GamepadButton {\n //% blockIdentity=gamepad.button enumval=0\n B = 0,\n //% blockIdentity=gamepad.button enumval=1\n A = 1,\n //% blockIdentity=gamepad.button enumval=2\n Y = 2,\n //% blockIdentity=gamepad.button enumval=3\n X = 3,\n //% block=\"left bumper\"\n //% blockIdentity=gamepad.button enumval=4\n LeftBumper = 4,\n //% block=\"right bumper\"\n //% blockIdentity=gamepad.button enumval=5\n RightBumper = 5,\n //% block=\"left trigger\"\n //% blockIdentity=gamepad.button enumval=6\n LeftTrigger = 6,\n //% block=\"right trigger\"\n //% blockIdentity=gamepad.button enumval=7\n RightTrigger = 7,\n //% block=\"select\"\n //% blockIdentity=gamepad.button enumval=8\n Select = 8,\n //% block=\"start\"\n //% blockIdentity=gamepad.button enumval=9\n Start = 9,\n //% block=\"left stick\"\n //% blockIdentity=gamepad.button enumval=10\n LeftStick = 10,\n //% block=\"right stick\"\n //% blockIdentity=gamepad.button enumval=11\n RightStick = 11,\n //% block=\"up\"\n //% blockIdentity=gamepad.button enumval=12\n Up = 12,\n //% block=\"down\"\n //% blockIdentity=gamepad.button enumval=13\n Down = 13,\n //% block=\"left\"\n //% blockIdentity=gamepad.button enumval=14\n Left = 14,\n //% block=\"right\"\n //% blockIdentity=gamepad.button enumval=15\n Right = 15\n}\n\n//% icon=\"\\uf11b\" color=\"#303030\"\nnamespace gamepad {\n /**\n * Maps to a standard layout button to the button index\n * @param button the name of the button\n */\n //% blockId=joystickStandardButton block=\"%button\"\n //% shim=TD_ID blockHidden=1\n export function button(button: GamepadButton): number {\n return button;\n }\n}",
"pxt.json": "{\n \"name\": \"gamepad\",\n \"description\": \"Gamepad controller over HID\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"gamepad.cpp\",\n \"shims.d.ts\",\n \"gamepad.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"tests\": [\n \"test.ts\"\n ],\n \"yotta\": {\n \"config\": {\n \"DEVICE_USB\": 1,\n \"DEVICE_JOYSTICK\": 1\n }\n },\n \"icon\": \"/static/libs/gamepad.png\"\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace gamepad {\n\n /** \n * Set the button state to down\n */\n //% help=gamepad/set-button\n //% blockId=joystickSetButton block=\"gamepad button %index=joystickStandardButton|%down=toggleDownUp\"\n //% weight=100 shim=gamepad::setButton\n function setButton(index: int32, down: boolean): void;\n\n /**\n * Set the current move on the gamepad\n **/\n //% blockId=gamepadMove block=\"gamepad %index|move by x %x|y %y\"\n //% help=gamepad/move\n //% index.min=0 index.max=1\n //% blockGap=8 shim=gamepad::move\n function move(index: int32, x: int32, y: int32): void;\n\n /** \n * Set the throttle state\n */\n //% blockId=gamepadSetThrottle block=\"gamepad set throttle %index|to %value\"\n //% gamepad/set-throttle blockHidden=1\n //% index.min=0 index.max=1\n //% value.min=0 value.max=31\n //%help=gamepad/set-throttle shim=gamepad::setThrottle\n function setThrottle(index: int32, value: int32): void;\n}\n\n// Auto-generated. Do not edit. Really.\n"
},
"mouse": {
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum MouseButton {\n //% block=\"left\" enumval=1\n Left = 0x01,\n //% block=\"right\" enumval=2\n Right = 0x02,\n //% block=\"middle\" enumval=4\n Middle = 0x04,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"mouse.cpp": "// https://github.com/lancaster-university/codal-core/blob/master/source/drivers/HIDMouse.cpp\n\n#include \"pxt.h\"\n\nenum class MouseButton {\n //% block=\"left\" enumval=1\n Left = 0x01,\n //% block=\"right\" enumval=2\n Right = 0x02,\n //% block=\"middle\" enumval=4\n Middle = 0x04\n};\n\nnamespace mouse {\n /** \n * Set the mouse button state to up or down\n */\n //% help=mouse/set-button\n //% blockId=mouseSetButton block=\"mouse button %index|%down=toggleDownUp\"\n void setButton(MouseButton button, bool down) {\n if (down)\n pxt::mouse.buttonDown((codal::USBHIDMouseButton)button);\n else\n pxt::mouse.buttonUp((codal::USBHIDMouseButton)button);\n }\n\n /**\n * Move the mouse in the X and Y direction\n **/\n //% help=mouse/move\n //% blockId=mouseMove block=\"mouse move x %x|y %y\"\n //% x.min=-128 x.max=127\n //% y.min=-128 y.max=127\n void move(int x, int y) {\n pxt::mouse.move(x, y);\n }\n\n /**\n * Turn the mouse wheel\n **/\n //% help=mouse/turn-wheel\n //% blockId=mouseWheel block=\"mouse turn wheel %w\"\n //% w.min=-128 w.max=127\n void turnWheel(int w) {\n pxt::mouse.moveWheel(w);\n }\n}",
"mouse.ts": "/**\n * Mouse emulation\n */\n//% icon=\"\\uf245\" color=\"#303030\"\nnamespace mouse {\n /**\n * Generates a mouse click\n * @param button the button to click\n */\n //% help=mouse/click\n //% blockId=mouseClick block=\"mouse click button $button\"\n //% weight=100\n export function click(button: MouseButton): void {\n mouse.setButton(button, true)\n mouse.setButton(button, false)\n }\n}",
"pxt.json": "{\n \"name\": \"mouse\",\n \"description\": \"Mouse emulation over HID\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"mouse.cpp\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"mouse.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"tests\": [\n \"test.ts\"\n ],\n \"yotta\": {\n \"config\": {\n \"DEVICE_USB\": 1,\n \"DEVICE_MOUSE\": 1\n }\n },\n \"icon\": \"/static/libs/mouse.png\"\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace mouse {\n\n /** \n * Set the mouse button state to up or down\n */\n //% help=mouse/set-button\n //% blockId=mouseSetButton block=\"mouse button %index|%down=toggleDownUp\" shim=mouse::setButton\n function setButton(button: MouseButton, down: boolean): void;\n\n /**\n * Move the mouse in the X and Y direction\n **/\n //% help=mouse/move\n //% blockId=mouseMove block=\"mouse move x %x|y %y\"\n //% x.min=-128 x.max=127\n //% y.min=-128 y.max=127 shim=mouse::move\n function move(x: int32, y: int32): void;\n\n /**\n * Turn the mouse wheel\n **/\n //% help=mouse/turn-wheel\n //% blockId=mouseWheel block=\"mouse turn wheel %w\"\n //% w.min=-128 w.max=127 shim=mouse::turnWheel\n function turnWheel(w: int32): void;\n}\n\n// Auto-generated. Do not edit. Really.\n"
},
"keyboard": {
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum KeyboardKeyEvent {\n //% block=\"press\"\n Press = 0,\n //% block=\"up\"\n Up = 1,\n //% block=\"down\"\n Down = 2,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"keyboard.cpp": "// https://github.com/lancaster-university/codal-core/blob/master/source/drivers/HIDKeyboard.cpp\n\n#include \"pxt.h\"\n#include \"USB_HID_Keys.h\"\n\nenum class KeyboardKeyEvent {\n //% block=\"press\"\n Press,\n //% block=\"up\"\n Up,\n //% block=\"down\"\n Down\n};\n\nnamespace keyboard {\n //%\n void __flush() {\n pxt::keyboard.flush();\n }\n\n //% \n void __type(String text) {\n if (NULL != text)\n pxt::keyboard.type(text->getUTF8Data(), text->getUTF8Size());\n }\n\n //%\n void __key(uint16_t ckey, KeyboardKeyEvent event) {\n switch(event) {\n case KeyboardKeyEvent::Down:\n pxt::keyboard.keyDown(ckey);\n break;\n case KeyboardKeyEvent::Up:\n pxt::keyboard.keyUp(ckey);\n break;\n case KeyboardKeyEvent::Press:\n pxt::keyboard.press(ckey);\n break;\n }\n }\n\n //%\n void __mediaKey(uint16_t key, KeyboardKeyEvent event) {\n codal::MediaKey ckey = (codal::MediaKey)((int)codal::MediaKey::Mute + (int)key);\n switch(event) {\n case KeyboardKeyEvent::Down:\n pxt::keyboard.keyDown(ckey);\n break;\n case KeyboardKeyEvent::Up:\n pxt::keyboard.keyUp(ckey);\n break;\n case KeyboardKeyEvent::Press:\n pxt::keyboard.press(ckey);\n break;\n }\n }\n\n //%\n void __functionKey(uint16_t key, KeyboardKeyEvent event) {\n codal::FunctionKey ckey = (codal::FunctionKey)key;\n switch(event) {\n case KeyboardKeyEvent::Down:\n pxt::keyboard.keyDown(ckey);\n break;\n case KeyboardKeyEvent::Up:\n pxt::keyboard.keyUp(ckey);\n break;\n case KeyboardKeyEvent::Press:\n pxt::keyboard.press(ckey);\n break;\n }\n }\n\n //%\n void __modifierKey(uint16_t modifier, KeyboardKeyEvent event) {\n const Key key = { .reg = KEYMAP_KEY_DOWN | KEYMAP_MODIFIER_KEY | (uint8_t)modifier };\n // send keys\n switch(event) {\n case KeyboardKeyEvent::Down:\n pxt::keyboard.keyDown(key);\n break;\n case KeyboardKeyEvent::Up:\n pxt::keyboard.keyUp(key);\n break;\n case KeyboardKeyEvent::Press:\n pxt::keyboard.press(key);\n break;\n };\n }\n}",
"keyboard.ts": "\nconst enum KeyboardMediaKey\n{\n //% block=\"mute\"\n Mute,\n //% block=\"volume up\"\n VolumeUp,\n //% block=\"volume down\"\n VolumeDown,\n //% block=\"play pause\"\n PlayPause,\n //% block=\"stop\"\n Stop,\n //% block=\"previous track\"\n PreviousTrack,\n //% block=\"next track\"\n NextTrack,\n //% block=\"mail\"\n Mail,\n //% block=\"calculator\"\n Calculator,\n //% block=\"web search\"\n WebSearch,\n //% block=\"web home\"\n WebHome,\n //% block=\"web favourites\"\n WebFavourites,\n //% block=\"web refresh\"\n WebRefresh,\n //% block=\"web stop\"\n WebStop,\n //% block=\"web forward\"\n WebForward,\n //% block=\"web back\"\n WebBack\n}\n\nconst enum KeyboardFunctionKey\n{\n //% block=\"F1\"\n F1Key = DAL.KEY_F1, \n //% block=\"F2\"\n F2Key = DAL.KEY_F2,\n //% block=\"F3\"\n F3Key = DAL.KEY_F3,\n //% block=\"F4\"\n F4Key = DAL.KEY_F4, \n //% block=\"F5\"\n F5Key = DAL.KEY_F5,\n //% block=\"F6\"\n F6Key = DAL.KEY_F6,\n //% block=\"F7\"\n F7Key = DAL.KEY_F7,\n //% block=\"F8\"\n F8Key = DAL.KEY_F8,\n //% block=\"F9\"\n F9Key = DAL.KEY_F9,\n //% block=\"F0\"\n F10Key = DAL.KEY_F10,\n //% block=\"F11\"\n F11Key = DAL.KEY_F11,\n //% block=\"F12\"\n F12Key = DAL.KEY_F12,\n //% block=\"F13\"\n F13Key = DAL.KEY_F13,\n //% block=\"F14\"\n F14Key = DAL.KEY_F14,\n //% block=\"F15\"\n F15Key = DAL.KEY_F15,\n //% block=\"F16\"\n F16Key = DAL.KEY_F16,\n //% block=\"F17\"\n F17Key = DAL.KEY_F17,\n //% block=\"F18\"\n F18Key = DAL.KEY_F18,\n //% block=\"F19\"\n F19Key = DAL.KEY_F19,\n //% block=\"F20\"\n F20Key = DAL.KEY_F20,\n //% block=\"F21\"\n F21Key = DAL.KEY_F21,\n //% block=\"F22\"\n F22Key = DAL.KEY_F22,\n //% block=\"F23\"\n F23Key = DAL.KEY_F23,\n //% block=\"F24\"\n F24Key = DAL.KEY_F24,\n\n //% block=\"enter\"\n Enter = DAL.KEY_ENTER,\n //% block=\"esc\"\n Esc = DAL.KEY_ESC,\n //% block=\"backspace\"\n Backspace = DAL.KEY_BACKSPACE,\n //% block=\"tab\"\n Tab = DAL.KEY_TAB,\n //% block=\"caps lock\"\n CapsLock = DAL.KEY_CAPSLOCK,\n //% block=\"num lock\"\n NumLock = DAL.KEY_NUMLOCK,\n //% block=\"keypad /\"\n KeypadSlash = DAL.KEY_KPSLASH,\n //% block=\"keypad *\"\n KeypadAsterisk = DAL.KEY_KPASTERISK,\n //% block=\"keypad -\"\n KeypadMinus = DAL.KEY_KPMINUS,\n //% block=\"keypad +\"\n KeypadPlus = DAL.KEY_KPPLUS,\n //% block=\"keypad enter\"\n KeypadEnter = DAL.KEY_KPENTER,\n //% block=\"keypad 1\"\n Keypad1 = DAL.KEY_KP1,\n //% block=\"keypad 2\"\n Keypad2 = DAL.KEY_KP2,\n //% block=\"keypad 3\"\n Keypad3 = DAL.KEY_KP3,\n //% block=\"keypad 4\"\n Keypad4 = DAL.KEY_KP4,\n //% block=\"keypad 5\"\n Keypad5 = DAL.KEY_KP5,\n //% block=\"keypad 6\"\n Keypad6 = DAL.KEY_KP6,\n //% block=\"keypad 7\"\n Keypad7 = DAL.KEY_KP7,\n //% block=\"keypad 8\"\n Keypad8 = DAL.KEY_KP8,\n //% block=\"keypad 9\"\n Keypad9 = DAL.KEY_KP9,\n //% block=\"keypad 0\"\n Keypad0 = DAL.KEY_KP0,\n //% block=\"keypad .\"\n KeypadDot = DAL.KEY_KPDOT,\n //% block=\"compose\"\n Compose = DAL.KEY_COMPOSE,\n //% block=\"power\"\n Power = DAL.KEY_POWER,\n //% block=\"=\"\n KeypadEqual = DAL.KEY_KPEQUAL,\n //% block=\"open\"\n Open = DAL.KEY_OPEN,\n //% block=\"help\"\n Help = DAL.KEY_HELP,\n //% block=\"props\"\n Props = DAL.KEY_PROPS,\n //% block=\"front\"\n Front = DAL.KEY_FRONT,\n //% block=\"stop\"\n Stop = DAL.KEY_STOP,\n //% block=\"again\"\n Again = DAL.KEY_AGAIN,\n //% block=\"undo\"\n Undo = DAL.KEY_UNDO,\n //% block=\"cut\"\n Cut = DAL.KEY_CUT,\n //% block=\"copy\"\n Copy = DAL.KEY_COPY,\n //% block=\"paste\"\n Paste = DAL.KEY_PASTE,\n //% block=\"find\"\n Find = DAL.KEY_FIND,\n //% block=\"mute\"\n Mute = DAL.KEY_MUTE,\n //% block=\"volume up\"\n VolumeUp = DAL.KEY_VOLUMEUP,\n //% block=\"volume down\"\n VolumeDown = DAL.KEY_VOLUMEDOWN,\n //% block=\"keypad ,\"\n KeypadComma = DAL.KEY_KPCOMMA,\n //% block=\"keypad jump comma\"\n KeypadJumpComma = DAL.KEY_KPJPCOMMA,\n //% block=\"keypad (\"\n KeypadLeftParenthesis = DAL.KEY_KPLEFTPAREN,\n //% block=\"keypad )\"\n KeypadRightParenthesis = DAL.KEY_KPRIGHTPAREN,\n\n //% block=\"print screen\"\n PrintScreen = DAL.KEY_SYSRQ,\n //% block=\"scroll lock\"\n ScrollLock = DAL.KEY_SCROLLLOCK,\n //% block=\"pause\"\n Pause = DAL.KEY_PAUSE,\n //% block=\"insert\"\n Insert = DAL.KEY_INSERT,\n //% block=\"home\"\n Home = DAL.KEY_HOME,\n //% block=\"page up\"\n PageUp = DAL.KEY_PAGEUP,\n //% block=\"delete\"\n DeleteForward = DAL.KEY_DELETE,\n //% block=\"end\"\n End = DAL.KEY_END,\n //% block=\"page down\"\n PageDown = DAL.KEY_PAGEDOWN,\n\n //% block=\"right arrow\"\n RightArrow = DAL.KEY_RIGHT,\n //% block=\"left arrow\"\n LeftArrow = DAL.KEY_LEFT,\n //% block=\"down arrow\"\n DownArrow = DAL.KEY_DOWN,\n //% block=\"up arrow\"\n UpArrow = DAL.KEY_UP\n}\n\nconst enum KeyboardModifierKey {\n //% block=\"Ctrl\"\n Control = DAL.KEY_MOD_LCTRL,\n //% block=\"Shift\"\n Shift = DAL.KEY_MOD_LSHIFT,\n //% block=\"Alt\"\n Alt = DAL.KEY_MOD_LALT,\n //% block=\"Command\"\n Meta = DAL.KEY_MOD_LMETA,\n //% block=\"Ctrl+Shift\"\n ControlShift = Control | Shift,\n //% block=\"Ctrl+Alt\"\n ControlAlt = Control | Alt,\n //% block=\"Shift+Alt\"\n ShiftAlt = Shift | Alt,\n //% block=\"Ctrl+Cmd\"\n ControlCommand = Control | Meta,\n //% block=\"Ctrl+Cmd\"\n ShiftCommand = Shift | Meta,\n //% block=\"Alt+Cmd\"\n AltCommand = Alt | Meta,\n //% block=\"Ctrl+Shift+Alt\"\n ControlShiftAlt = Control | Shift | Alt,\n //% block=\"Ctrl+Cmd+Shift+Alt\"\n ControlCommandShiftAlt = Control | Meta | Shift | Alt,\n //% block=\"Right Ctrl\"\n RightControl = DAL.KEY_MOD_RCTRL,\n //% block=\"Right Shift\"\n RightShift = DAL.KEY_MOD_RSHIFT,\n //% block=\"Right Alt\"\n RightAlt = DAL.KEY_MOD_RALT,\n //% block=\"Right Command\"\n RightMeta = DAL.KEY_MOD_RMETA\n}\n\n/**\n * Keyboard emulation\n */\n//% icon=\"\\uf11c\" color=\"#303030\"\nnamespace keyboard {\n /**\n * Send a sequence of keystrokes to the keyboard\n */\n //% blockId=keyboardType block=\"keyboard type $text||with $modifiers\"\n //% blockGap=8 weight=100\n //% text.shadowOptions.toString=true\n //% help=keyboard/type\n //% weight=100\n export function type(text: string, modifiers?: KeyboardModifierKey) {\n if (modifiers)\n __modifierKey(modifiers, KeyboardKeyEvent.Down);\n __type(text);\n __flush();\n }\n\n /**\n * Send a key command\n */\n //% blockId=keyboardStandardKey block=\"keyboard key %key|%event\"\n //% blockGap=8 weight=99\n //% help=keyboard/key\n export function key(key: string, event: KeyboardKeyEvent) {\n if (!key) return;\n const c = key.charCodeAt(0);\n __key(c, event);\n }\n\n /**\n * Send a media key command\n */\n //% blockId=keyboardMediaKey block=\"keyboard media %key|%event\"\n //% blockGap=8\n //% help=keyboard/media-key\n export function mediaKey(key: KeyboardMediaKey, event: KeyboardKeyEvent) {\n __mediaKey(key, event);\n }\n\n /**\n * Send a function key command\n */\n //% blockId=keyboardFunctionKey block=\"keyboard function %key|%event\"\n //% blockGap=8\n //% help=keyboard/function-key\n export function functionKey(key: KeyboardFunctionKey, event: KeyboardKeyEvent) {\n __functionKey(key, event)\n }\n\n /**\n * Send a modifier key command\n */\n //% blockId=keyboardModiferKey block=\"keyboard modifier %key|%event\"\n //% blockGap=8\n //% help=keyboard/modifier-key\n export function modifierKey(key: KeyboardModifierKey, event: KeyboardKeyEvent) {\n __modifierKey(key, event)\n }\n\n /**\n * Send up commands for any remaning down keys\n */\n //% blockId=keyboardClear block=\"keyboard clear all\"\n //% blockGap=8\n //% help=keyboard/clear-all-keys\n //% weight=10\n export function clearAllKeys() {\n __flush()\n }\n}",
"pxt.json": "{\n \"name\": \"keyboard\",\n \"description\": \"Keyboard emulation over HID\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"keyboard.cpp\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"keyboard.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"tests\": [\n \"test.ts\"\n ],\n \"yotta\": {\n \"config\": {\n \"DEVICE_USB\": 1,\n \"DEVICE_KEYBOARD\": 1\n }\n },\n \"icon\": \"/static/libs/keyboard.png\"\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace keyboard {\n //% shim=keyboard::__flush hidden=1\n function __flush(): void;\n\n //% shim=keyboard::__type hidden=1\n function __type(text: string): void;\n\n //% shim=keyboard::__key hidden=1\n function __key(ckey: number, event: KeyboardKeyEvent): void;\n\n //% shim=keyboard::__mediaKey hidden=1\n function __mediaKey(key: uint16, event: KeyboardKeyEvent): void;\n\n //% shim=keyboard::__functionKey hidden=1\n function __functionKey(key: uint16, event: KeyboardKeyEvent): void;\n\n //% shim=keyboard::__modifierKey hidden=1\n function __modifierKey(modifier: uint16, event: KeyboardKeyEvent): void;\n}\n\n// Auto-generated. Do not edit. Really.\n"
},
"display": {
"display.ts": "/**\n * Basic screen display functionalities\n */\n//% weight=98 icon=\"\\uf108\" color=\"#311557\"\n//% groups='[\"Screen\", \"Charts\"]'\nnamespace display {\n const textOffset = 4;\n const lineOffset = 2;\n\n /**\n * Gets the text line height\n */\n export function lineHeight(): number {\n return image.font8.charHeight + lineOffset;\n }\n\n /**\n * Number of lines\n */\n export function lineCount(): number {\n return ((screen.height - textOffset) / lineHeight()) >> 0\n }\n\n /**\n * Show text on the screen at a specific line.\n * @param text the text to print on the screen, eg: \"Hello world\"\n * @param line the line number to print the text at (starting at 1), eg: 1\n */\n //% blockId=displayshowstring block=\"show string %text|at line %line\"\n //% weight=98 inlineInputMode=\"inline\" blockGap=8\n //% help=display/show-string\n export function showString(text: string, line: number) {\n // line indexing starts at 1.\n line = (line - 1) >> 0;\n const nlines = lineCount();\n if (line < 0 || line >= nlines) return; // out of screen\n\n const h = lineHeight();\n const y = textOffset + h * line;\n screen.fillRect(0, y, screen.width, h, 0); // clear background\n screen.print(text, textOffset, y);\n }\n\n /**\n * Shows a number on the screen\n * @param value the numeric value\n * @param line the line number to print the text at (starting at 1), eg: 1\n */\n //% blockId=displayshownumber block=\"show number %name|at line %line\"\n //% weight=96 inlineInputMode=\"inline\" blockGap=8\n //% help=display/show-number\n //% line.min=1 line.max=10\n export function showNumber(value: number, line: number) {\n showString(\"\" + value, line);\n }\n\n /**\n * Shows a name, value pair on the screen\n * @param value the numeric value\n * @param line the line number to print the text at (starting at 1), eg: 1\n */\n //% blockId=displayshowvalue block=\"show value %name|: %text|at line %line\"\n //% weight=96 inlineInputMode=\"inline\" blockGap=8\n //% help=display/show-value\n //% line.min=1 line.max=10\n export function showValue(name: string, value: number, line: number) {\n value = Math.round(value * 1000) / 1000;\n showString((name ? name + \": \" : \"\") + value, line);\n }\n\n /**\n * Clear the screen\n */\n //% blockId=displayclear block=\"clear display\"\n //% weight=90\n //% help=display/clear\n export function clear() {\n screen.fill(0)\n }\n\n /**\n * Sends the log messages to the brick screen and uses the brick up and down buttons to scroll.\n */\n //% blockId=displayshowconsole block=\"show console\"\n //% weight=1\n //% help=display/show-console\n export function showConsole(): void {\n display.text.scroll(0);\n }\n}\n\nnamespace display.text {\n export let maxLines = 200;\n let screenLines = 1;\n let lines: string[];\n let scrollPosition = 0;\n\n function init() {\n if (!lines) {\n lines = [];\n console.addListener(log);\n screenLines = display.lineCount();\n }\n }\n\n function printLog() {\n display.clear();\n if (!lines) return;\n screenLines = display.lineCount();\n const h = display.lineHeight();\n for (let i = 0; i < screenLines; ++i) {\n const line = lines[i + scrollPosition];\n if (line)\n display.showString(line, i + 1);\n }\n }\n\n export function scroll(pos: number) {\n init();\n if (!pos) return;\n\n scrollPosition += pos >> 0;\n if (scrollPosition >= lines.length) scrollPosition = lines.length - 1;\n if (scrollPosition < 0) scrollPosition = 0;\n printLog();\n }\n\n function log(priority: ConsolePriority, msg: string): void {\n lines.push(msg);\n if (lines.length + 5 > maxLines) {\n lines.splice(0, lines.length >> 1);\n scrollPosition = Math.min(scrollPosition, lines.length - 1)\n }\n // move down scroll once it gets large than the screen\n if (lines.length > screenLines\n && lines.length >= scrollPosition + screenLines) {\n scrollPosition++;\n }\n printLog();\n }\n} \n",
"displayImage.ts": "// NOT SUPPORTED yet",
"graph.ts": "namespace display {\n class Chart {\n // Variables used for data configuration.\n private font: image.Font;\n private times: number[];\n private values: number[];\n\n // grid\n private gridRows: number;\n private gridCols: number;\n private gridWidth: number;\n private gridHeight: number;\n\n // chart rendering\n private chartWidth: number;\n private chartHeight: number;\n private scaleXMin: number;\n private scaleXMax: number;\n private scaleYMin: number;\n private scaleYMax: number;\n private axisPaddingX: number;\n private axisPaddingY: number;\n\n // estimated best number of entries\n private maxEntries: number;\n\n public backgroundColor: number;\n public axisColor: number;\n public lineColor: number;\n\n constructor() {\n this.font = image.font5;\n this.backgroundColor = 0;\n this.axisColor = 1;\n this.lineColor = 1;\n\n this.axisPaddingX = 22;\n this.axisPaddingY = this.font.charHeight + 4;\n this.gridRows = 2;\n this.gridCols = 2; // computed on the fly\n this.times = [];\n this.values = [];\n this.chartWidth = screen.width - this.axisPaddingX;\n this.chartHeight = screen.height - this.axisPaddingY;\n this.maxEntries = (this.chartWidth - 2) / 2;\n }\n\n public addPoint(value: number) {\n this.times.push(control.millis() / 1000);\n this.values.push(value);\n if (this.times.length > this.maxEntries * 2) {\n this.times = this.times.slice(this.times.length - this.maxEntries - 1, this.times.length - 1);\n this.values = this.values.slice(this.values.length - this.maxEntries - 1, this.values.length - 1);\n }\n }\n\n public render() {\n if (this.times.length < 2) return;\n this.calculateScale();\n screen.fill(this.backgroundColor);\n this.drawAxes();\n this.drawChartGrid();\n this.drawGraphPoints();\n }\n\n private calculateScale() {\n this.scaleYMax = this.values[0];\n this.scaleYMin = this.values[0];\n for (let j = 0, len2 = this.values.length; j < len2; j++) {\n if (this.scaleYMax < this.values[j]) {\n this.scaleYMax = this.values[j];\n }\n if (this.scaleYMin > this.values[j]) {\n this.scaleYMin = this.values[j];\n }\n }\n\n // avoid empty interval\n if (this.scaleXMin === this.scaleXMax)\n this.scaleXMax = this.scaleXMin + 1; // TODO\n if (this.scaleYMin === this.scaleYMax)\n this.scaleYMax = this.scaleYMin + 1; // TODO\n\n // update axis to look better\n let rx = generateSteps(0, this.times[this.times.length - 1] - this.times[0], 4);\n this.scaleXMin = rx[0];\n this.scaleXMax = rx[1];\n this.gridCols = rx[2];\n let ry = generateSteps(this.scaleYMin, this.scaleYMax, 6);\n this.scaleYMin = ry[0];\n this.scaleYMax = ry[1];\n this.gridRows = ry[2];\n\n // update y-axis width\n let xl = 0;\n const yRange = this.scaleYMax - this.scaleYMin;\n const yUnit = yRange / this.gridRows;\n for (let i = 0; i <= this.gridRows; ++i)\n xl = Math.max(roundWithPrecision(this.scaleYMax - (i * yUnit), 2).toString().length, xl);\n this.axisPaddingX = xl * this.font.charWidth + 4;\n this.chartWidth = screen.width - this.axisPaddingX;\n this.maxEntries = (this.chartWidth - 2) / 2;\n\n // Calculate the grid for background / scale.\n this.gridWidth = this.chartWidth / this.gridCols; // This is the width of the grid cells (background and axes).\n this.gridHeight = this.chartHeight / this.gridRows; // This is the height of the grid cells (background axes).\n }\n\n private drawChartGrid() {\n const c = this.axisColor;\n const tipLength = 3;\n\n screen.drawRect(0, 0, this.chartWidth, this.chartHeight, c);\n\n for (let i = 0; i < this.gridCols; i++) {\n screen.drawLine(i * this.gridWidth, this.chartHeight, i * this.gridWidth, this.chartHeight - tipLength, c);\n screen.drawLine(i * this.gridWidth, 0, i * this.gridWidth, tipLength, c);\n }\n for (let i = 0; i < this.gridRows; i++) {\n screen.drawLine(0, i * this.gridHeight, tipLength, i * this.gridHeight, c);\n screen.drawLine(this.chartWidth, i * this.gridHeight, this.chartWidth - tipLength, i * this.gridHeight, c);\n }\n }\n\n private drawAxes() {\n const c = this.axisColor;\n const xRange = this.scaleXMax - this.scaleXMin;\n const yRange = this.scaleYMax - this.scaleYMin;\n\n const xUnit = xRange / this.gridCols;\n const yUnit = yRange / this.gridRows;\n\n // Draw the y-axes labels.\n let text = '';\n for (let i = 0; i <= this.gridRows; i++) {\n text = roundWithPrecision(this.scaleYMax - (i * yUnit), 2).toString();\n let y = i * this.gridHeight - this.font.charHeight / 2;\n if (i == this.gridRows)\n y -= this.font.charHeight / 2;\n else if (i == 0)\n y += this.font.charHeight / 2;\n screen.print(text, this.chartWidth + 5, y, c, this.font);\n }\n\n // Draw the x-axis labels\n for (let i = 0; i <= this.gridCols; i++) {\n text = roundWithPrecision((i * xUnit), 2).toString();\n let x = i * this.gridWidth;\n if (i > 0)\n x -= this.font.charWidth / 2; // move one char to the left\n screen.print(text, x, this.chartHeight + (this.axisPaddingY - 2 - this.font.charHeight), c, this.font);\n }\n }\n\n private drawGraphPoints() {\n const c = this.lineColor;\n // Determine the scaling factor based on the min / max ranges.\n const xRange = this.scaleXMax - this.scaleXMin;\n const yRange = this.scaleYMax - this.scaleYMin;\n\n const xFactor = this.chartWidth / xRange;\n let yFactor = this.chartHeight / yRange;\n\n let nextX = 0;\n let nextY = (this.values[0] - this.scaleYMin) * yFactor;\n const startX = nextX;\n const startY = nextY;\n for (let i = 1; i < this.values.length; i++) {\n let prevX = nextX;\n let prevY = nextY;\n nextX = (this.times[i] - this.times[0]) * xFactor;\n nextY = (this.values[i] - this.scaleYMin) * yFactor;\n screen.drawLine(prevX, prevY, nextX, nextY, c);\n }\n }\n }\n\n // helpers\n function log10(x: number): number {\n return Math.log(x) / Math.log(10);\n }\n\n function roundWithPrecision(x: number, digits: number): number {\n if (digits <= 0) return Math.round(x);\n let d = Math.pow(10, digits);\n return Math.round(x * d) / d;\n }\n\n function generateSteps(start: number, end: number, numberOfTicks: number): number[] {\n let bases = [1, 5, 2, 3]; // Tick bases selection\n let currentBase: number;\n let n: number;\n let intervalSize: number, upperBound: number, lowerBound: number;\n let nIntervals: number, nMaxIntervals: number;\n let the_intervalsize = 0.1;\n\n let exponentYmax =\n Math.floor(Math.max(log10(Math.abs(start)), log10(Math.abs(end))));\n let mantissaYmax = end / Math.pow(10.0, exponentYmax);\n\n // now check if numbers can be cleaned...\n // make it pretty\n let significative_numbers = Math.min(3, Math.abs(exponentYmax) + 1);\n\n let expo = Math.pow(10.0, significative_numbers);\n let start_norm = Math.abs(start) * expo;\n let end_norm = Math.abs(end) * expo;\n let mant_norm = Math.abs(mantissaYmax) * expo;\n\n // trunc ends\n let ip_start = Math.floor(start_norm * Math.sign(start));\n let ip_end = Math.ceil(end_norm * Math.sign(end));\n\n start = ip_start;\n end = ip_end;\n\n mantissaYmax = Math.ceil(mant_norm);\n\n nMaxIntervals = 0;\n for (let k = 0; k < bases.length; ++k) {\n // Loop initialisation\n currentBase = bases[k];\n n = 4; // This value only allows results smaller than about 1000 = 10^n\n\n\n do // Tick vector length reduction\n {\n --n;\n intervalSize = currentBase * Math.pow(10.0, exponentYmax - n);\n\n upperBound =\n Math.ceil(mantissaYmax * Math.pow(10.0, n) / currentBase)\n * intervalSize;\n\n nIntervals =\n Math.ceil((upperBound - start) / intervalSize);\n lowerBound = upperBound - nIntervals * intervalSize;\n }\n while (nIntervals > numberOfTicks);\n\n if (nIntervals > nMaxIntervals) {\n nMaxIntervals = nIntervals;\n ip_start = ip_start = lowerBound;\n ip_end = upperBound;\n the_intervalsize = intervalSize;\n }\n }\n\n // trunc ends\n if (start < 0)\n start = Math.floor(ip_start) / expo;\n else\n start = Math.ceil(ip_start) / expo;\n\n if (end < 0)\n end = Math.floor(ip_end) / expo;\n else\n end = Math.ceil(ip_end) / expo;\n\n return [start, end, nMaxIntervals];\n }\n\n\n let chart: Chart;\n /**\n * Adds a new point to the trend chart and renders it to the screen.\n */\n //% group=\"Charts\"\n //% blockId=graphadd block=\"graph %value\"\n //% blockGap=8\n export function graph(value: number) {\n if (!chart)\n chart = new Chart();\n\n chart.addPoint(value);\n chart.render();\n }\n\n /**\n * Clears the trend chart and the screen\n */\n //% group=\"Charts\"\n //% blockid=graphclear block=\"graph clear\"\n export function graphClear() {\n chart = undefined;\n screen.fill(0);\n }\n}\n",
"pxt.json": "{\n \"name\": \"display\",\n \"description\": \"Basic display functionalitites\",\n \"dependencies\": {\n \"screen---st7735\": \"*\"\n },\n \"files\": [\n \"display.ts\",\n \"displayImage.ts\",\n \"graph.ts\",\n \"targetoverrides.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"icon\": \"/static/libs/display.png\"\n}\n",
"targetoverrides.ts": "// Overriden in target"
},
"servo": {
"README.md": "# Servo\n\nA small micro-servo library.",
"ns.ts": "/**\n * Control micro servos\n */\n//% color=\"#03AA74\" weight=88 icon=\"\\uf021\"\nnamespace servos {\n}",
"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\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"icon\": \"/static/libs/servo.png\"\n}\n",
"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",
"targetoverrides.ts": "// TODO any platform specific overrides"
},
"storage": {
"GhostSNORFS.cpp": "#include \"GhostSNORFS.h\"\n\n#include \"CodalCompat.h\"\n#include \"CodalDmesg.h\"\n#include \"CodalDevice.h\"\n\n#define LOG DMESG\n\nusing namespace codal::snorfs;\n\nnamespace codal {\n\n\nGhostSNORFS::GhostSNORFS(FS &fs) : fs(fs)\n{\n currFile = NULL;\n currEntry = NULL;\n}\n\nvoid GhostSNORFS::readFlash(GFATEntry *ent, unsigned blockAddr, char *dst)\n{\n auto th = (GhostSNORFS*)ent->userdata;\n th->fs.readFlashBytes(blockAddr * 512, dst, 512);\n}\n\nvoid GhostSNORFS::readFile(GFATEntry *ent, unsigned blockAddr, char *dst)\n{\n auto th = (GhostSNORFS*)ent->userdata;\n\n if (th->currEntry != ent)\n {\n th->currEntry = ent;\n if (th->currFile)\n delete th->currFile;\n th->currFile = th->fs.open(ent->filename);\n }\n\n th->currFile->seek(blockAddr * 512);\n th->currFile->read(dst, 512);\n}\n\n\nvoid GhostSNORFS::addFiles()\n{\n // reading SPI directory can take some time, so we delay USB start\n CodalUSB::usbInstance->delayStart();\n\n GhostFAT::addFiles();\n\n addFile(readFlash, this, \"spiflash.bin\", fs.rawSize());\n addDirectory(20, \"SPIFLASH\");\n\n fs.dirRewind();\n auto d = fs.dirRead();\n while (d)\n {\n addFile(readFile, this, d->name, d->size, 20);\n d = fs.dirRead();\n }\n\n CodalUSB::usbInstance->start();\n}\n\n}\n",
"GhostSNORFS.h": "#ifndef DEVICE_GHOSTSNORFS_H\n#define DEVICE_GHOSTSNORFS_H\n\n#include \"GhostFAT.h\"\n#include \"SNORFS.h\"\n\nnamespace codal\n{\n \nclass GhostSNORFS : public GhostFAT\n{\nprotected:\n snorfs::FS &fs;\n snorfs::File *currFile;\n GFATEntry *currEntry;\n\n static void readFlash(GFATEntry *ent, unsigned blockAddr, char *dst);\n static void readFile(GFATEntry *ent, unsigned blockAddr, char *dst);\n\npublic:\n GhostSNORFS(snorfs::FS &fs);\n virtual void addFiles();\n};\n\n}\n\n#endif\n\n",
"SNORFS.cpp": "#include \"SNORFS.h\"\n#include \"CodalDmesg.h\"\n#include \"NotifyEvents.h\"\n#include \"MessageBus.h\"\n#include \"pxtbase.h\"\n#include \n\n#define oops() target_panic(DEVICE_FLASH_ERROR)\n\n#ifndef SNORFS_TEST\n#define LOG DMESG\n#define LOGV(...) \\\n do \\\n { \\\n } while (0)\n#endif\n\nusing namespace codal::snorfs;\n\nstatic uint16_t snorfs_unlocked_event;\n\n#define SNORFS_LEVELING_THRESHOLD 100\n\n// The values below were picked at random\n#define SNORFS_MAGIC 0x3576348e\n#define SNORFS_FREE_FLAG 0xd09ff063\n#define SNORFS_COPIED_FLAG 0x4601c6dc\n#define SNORFS_COMPUTING_WRITE_PAGE 0x00ff\n#define SNORFS_TRY_MOUNT 0xfff0\n\nstruct BlockHeader\n{\n uint32_t magic;\n uint8_t version;\n uint8_t numMetaRows;\n uint16_t logicalBlockId;\n uint32_t eraseCount;\n uint32_t freeFlag;\n uint32_t copiedFlag;\n};\n\nstatic uint8_t fnhash(const char *fn)\n{\n uint32_t h = hash_fnv1(fn, strlen(fn));\n h &= 0xff;\n if (h <= 0x02 || h == 0xff)\n return h + 0xf0;\n return h;\n}\n\nFS::FS(SPIFlash &f) : flash(f)\n{\n numRows = 0;\n randomSeed = 1;\n dirptr = 0;\n files = NULL;\n locked = false;\n\n if (!snorfs_unlocked_event)\n snorfs_unlocked_event = codal::allocateNotifyEvent();\n}\n\nvoid FS::feedRandom(uint32_t v)\n{\n randomSeed ^= (v + 1) * 0x1000193;\n}\n\n// we need a deterministic PRNG - this one has period of 2^32\nuint32_t FS::random(uint32_t max)\n{\n uint32_t mask = 1;\n while (mask <= max)\n mask = (mask << 1) | 1;\n while (true)\n {\n randomSeed = randomSeed * 1664525 + 1013904223;\n auto v = randomSeed & mask;\n if (v < max)\n return v;\n }\n}\n\nint FS::firstFree(uint16_t pageIdx)\n{\n flash.readBytes(indexAddr(pageIdx), buf, SPIFLASH_PAGE_SIZE);\n for (int k = 1; k < SPIFLASH_PAGE_SIZE - 1; ++k)\n if (buf[k] == 0xff)\n return pageIdx | k;\n return 0;\n}\n\nvoid FS::busy(bool)\n{\n // blink LED or something\n}\n\nstatic void initBlockHeader(BlockHeader &hd, bool free)\n{\n hd.magic = SNORFS_MAGIC;\n hd.version = 0;\n hd.numMetaRows = 2;\n hd.eraseCount = 0;\n if (free)\n {\n hd.logicalBlockId = 0xffff;\n hd.freeFlag = SNORFS_FREE_FLAG;\n hd.copiedFlag = 0xffffffff;\n }\n else\n {\n hd.freeFlag = 0;\n hd.copiedFlag = SNORFS_COPIED_FLAG;\n }\n}\n\nbool FS::pageErased(uint32_t addr)\n{\n flash.readBytes(addr, buf, SPIFLASH_PAGE_SIZE);\n for (int i = 0; i < SPIFLASH_PAGE_SIZE; ++i)\n if (buf[i] != 0xff)\n return false;\n return true;\n}\n\nbool FS::rowErased(uint32_t addr, bool checkFull)\n{\n if (!checkFull)\n return pageErased(addr) && pageErased(addr + 512) && pageErased(addr + 1024);\n\n for (uint32_t off = 0; off < SPIFLASH_BIG_ROW_SIZE; off += SPIFLASH_PAGE_SIZE)\n {\n if (!pageErased(addr + off))\n return false;\n }\n return true;\n}\n\nvoid FS::format()\n{\n if (files)\n oops();\n\n LOG(\"formatting SNORFS\");\n\n uint32_t end = flash.numPages() * SPIFLASH_PAGE_SIZE;\n uint16_t rowIdx = 0;\n BlockHeader hd;\n initBlockHeader(hd, false);\n bool didErase = false;\n\n for (uint32_t addr = 0; addr < end; addr += SPIFLASH_BIG_ROW_SIZE)\n {\n busy();\n // in case we didn't need to do any erase yet, do a quick \"likely\" erasure test\n if (dirptr != SNORFS_TRY_MOUNT && !rowErased(addr, didErase))\n {\n didErase = true;\n flash.eraseBigRow(addr);\n busy();\n }\n\n // the last empty row?\n if (addr + SPIFLASH_BIG_ROW_SIZE >= end)\n {\n initBlockHeader(hd, true);\n }\n else\n {\n hd.logicalBlockId = rowIdx;\n }\n LOGV(\"format: %d\\n\", rowIdx);\n flash.writeBytes(addr, &hd, sizeof(hd));\n rowIdx++;\n }\n busy(false);\n}\n\nvoid FS::gcCore(bool force, bool isData)\n{\n if (!force)\n {\n fullPages = 0;\n deletedPages = 0;\n freePages = 0;\n }\n\n uint16_t start = 0;\n uint16_t end = numRows;\n\n // in 'force' mode we're interested in specifically data or meta space\n if (force)\n {\n if (isData)\n start = numMetaRows;\n else\n end = numMetaRows;\n }\n\n uint32_t maxDelCnt = 0;\n uint32_t maxDelIdx = 0;\n\n for (unsigned row = start; row < end; ++row)\n {\n uint32_t addr = indexAddr(row << 8);\n flash.readBytes(addr, buf, SPIFLASH_PAGE_SIZE);\n uint16_t numDel = 0;\n for (int i = 1; i < SPIFLASH_PAGE_SIZE - 1; i++)\n {\n if (buf[i] == 0x00)\n numDel++;\n if (!force)\n {\n if (buf[i] == 0x00)\n deletedPages++;\n else if (buf[i] == 0xff)\n freePages++;\n else\n fullPages++;\n }\n }\n\n LOGV(\"GC: row=%d del=%d\\n\", row, numDel);\n\n if (numDel > maxDelCnt)\n {\n maxDelCnt = numDel;\n maxDelIdx = row;\n }\n }\n\n if (force && !maxDelCnt)\n {\n if (isData)\n LOG(\"out of data space\\n\");\n else\n LOG(\"out of meta space\\n\");\n oops(); // really out of space!\n }\n\n LOGV(\"GC: \");\n\n // we do a GC when either one is true:\n // * force is true (we desperately need space)\n // * there's a row that's more than 50% deleted\n // * clearing a row will increase free space by more than 20%\n if (force || maxDelCnt > SPIFLASH_PAGE_SIZE / 2 || (maxDelCnt * 5 > freePages))\n {\n swapRow(rowRemapCache[maxDelIdx]);\n if (!readHeaders()) // this will trigger levelling on the new free block\n oops(); // but it should never fail\n }\n\n debugDump();\n}\n\nvoid FS::swapRow(int row)\n{\n busy();\n LOGV(\"[swap row: %d] \", row);\n if (freeRow == row || row > numRows)\n oops();\n uint32_t trg = freeRow * SPIFLASH_BIG_ROW_SIZE;\n uint32_t src = row * SPIFLASH_BIG_ROW_SIZE;\n\n uint32_t skipmask[SPIFLASH_PAGE_SIZE / 32];\n memset(skipmask, 0, sizeof(skipmask));\n auto idxOff = SPIFLASH_BIG_ROW_SIZE - SPIFLASH_PAGE_SIZE;\n flash.readBytes(src + idxOff, buf, SPIFLASH_PAGE_SIZE);\n for (int i = 1; i < SPIFLASH_PAGE_SIZE - 1; i++)\n {\n if (buf[i] == 0x00)\n {\n skipmask[i / 32] |= 1U << (i % 32);\n buf[i] = 0xff;\n deletedPages--;\n freePages++;\n }\n }\n\n#define setFlag(trg, flag, v) \\\n { \\\n uint32_t flag = v; \\\n flash.writeBytes(trg + offsetof(BlockHeader, flag), &flag, sizeof(flag)); \\\n }\n\n setFlag(trg, freeFlag, 0); // no longer free\n\n flash.writeBytes(trg + idxOff, buf, SPIFLASH_PAGE_SIZE);\n for (int i = 1; i < SPIFLASH_PAGE_SIZE - 1; ++i)\n {\n if (skipmask[i / 32] & (1U << (i % 32)))\n continue;\n\n flash.readBytes(src + SPIFLASH_PAGE_SIZE * i, buf, SPIFLASH_PAGE_SIZE);\n flash.writeBytes(trg + SPIFLASH_PAGE_SIZE * i, buf, SPIFLASH_PAGE_SIZE);\n busy();\n }\n\n flash.readBytes(src, buf, SPIFLASH_PAGE_SIZE);\n auto hd = (BlockHeader *)(void *)buf;\n flash.writeBytes(trg + offsetof(BlockHeader, logicalBlockId), &hd->logicalBlockId, 2);\n setFlag(trg, copiedFlag, SNORFS_COPIED_FLAG);\n setFlag(src, copiedFlag, 0);\n\n hd->logicalBlockId = 0xffff;\n hd->eraseCount++;\n hd->freeFlag = 0xffffffff;\n hd->copiedFlag = 0xffffffff;\n flash.eraseBigRow(src);\n busy();\n int last = 0;\n for (int i = 0; i < SPIFLASH_PAGE_SIZE; ++i)\n if (buf[i] != 0xff)\n last = i;\n flash.writeBytes(src, buf, last + 1);\n // everything done, mark as fully OK free row\n setFlag(src, freeFlag, SNORFS_FREE_FLAG);\n\n for (int i = 0; i < numRows; ++i)\n {\n if (rowRemapCache[i] == row)\n rowRemapCache[i] = freeRow;\n }\n freeRow = row; // new free row\n busy(false);\n}\n\nbool FS::readHeaders()\n{\n memset(rowRemapCache, 0xff, numRows);\n\n static BlockHeader hd; // can't be on stack!\n int freeRow = -1;\n bool freeDirty = false;\n bool freeRandom = false;\n\n int minEraseIdx = -1;\n uint32_t minEraseCnt = 0;\n uint32_t freeEraseCnt = 0;\n uint32_t totalEraseCount = 0;\n\n for (unsigned i = 0; i < (unsigned)numRows + 1; ++i)\n {\n auto addr = i * SPIFLASH_BIG_ROW_SIZE;\n flash.readBytes(addr, &hd, sizeof(hd));\n if (hd.magic != SNORFS_MAGIC || hd.version != 0)\n {\n // likely, we got a power failure during row erase - it now contains random data\n if (freeRow == -1)\n {\n freeDirty = true;\n freeRandom = true;\n freeRow = i;\n continue;\n }\n return false;\n }\n\n numMetaRows = hd.numMetaRows;\n\n totalEraseCount += hd.eraseCount;\n\n if (hd.logicalBlockId == 0xffff || hd.copiedFlag != SNORFS_COPIED_FLAG)\n goto isFree;\n else\n {\n if (hd.logicalBlockId >= numRows)\n return false;\n // if this is the first duplicate, it is liekly a duplicate left over from unfinished\n // swapRow\n if (rowRemapCache[hd.logicalBlockId] != 0xff)\n goto isFree;\n rowRemapCache[hd.logicalBlockId] = i;\n if (minEraseIdx < 0 || hd.eraseCount < minEraseCnt)\n {\n minEraseCnt = hd.eraseCount;\n minEraseIdx = i;\n }\n }\n continue;\n\n isFree:\n if (freeRow == -1)\n {\n freeRow = i;\n if (hd.freeFlag != SNORFS_FREE_FLAG)\n freeDirty = true;\n }\n else\n return false;\n freeEraseCnt = hd.eraseCount;\n }\n\n feedRandom(totalEraseCount);\n\n this->freeRow = freeRow;\n\n if (freeRow == -1 || !numMetaRows || numMetaRows > numRows / 2)\n return false;\n\n if (freeDirty)\n {\n LOG(\"fixing free row: %d\\n\", freeRow);\n busy();\n initBlockHeader(hd, true);\n hd.eraseCount = freeRandom ? totalEraseCount / numRows : freeEraseCnt;\n flash.eraseBigRow(freeRow * SPIFLASH_BIG_ROW_SIZE);\n busy();\n flash.writeBytes(freeRow * SPIFLASH_BIG_ROW_SIZE, &hd, sizeof(hd));\n busy(false);\n }\n else if (minEraseCnt + SNORFS_LEVELING_THRESHOLD < freeEraseCnt)\n {\n swapRow(minEraseIdx);\n LOGV(\" for level\\n\");\n }\n else\n {\n LOGV(\"[no level swap: free %d, min %d]\", freeEraseCnt, minEraseCnt);\n }\n\n return true;\n}\n\nbool FS::tryMount()\n{\n if (numRows == 0)\n {\n // we abuse dirptr as a flag\n dirptr = SNORFS_TRY_MOUNT;\n lock();\n unlock();\n dirptr = 0;\n }\n LOG(\"mount SNORFS, rows=%d\", numRows);\n return numRows > 0;\n}\n\nvoid FS::mount()\n{\n if (numRows > 0)\n return;\n\n numRows = (flash.numPages() / SPIFLASH_BIG_ROW_PAGES) - 1;\n rowRemapCache = new uint8_t[numRows];\n\n if (!readHeaders())\n {\n if (dirptr == SNORFS_TRY_MOUNT)\n {\n uint32_t end = flash.numPages() * SPIFLASH_PAGE_SIZE;\n for (uint32_t addr = 0; addr < end; addr += SPIFLASH_BIG_ROW_SIZE)\n {\n if (!rowErased(addr, false))\n {\n numRows = 0;\n delete rowRemapCache;\n rowRemapCache = NULL;\n return;\n }\n }\n }\n\n format();\n if (!readHeaders())\n oops();\n }\n gcCore(false, false);\n}\n\nuint16_t FS::findFreePage(bool isData, uint16_t hint)\n{\n bool wrapped = false;\n bool gc = false;\n uint16_t start = isData ? numMetaRows : 0;\n uint16_t end = isData ? numRows : numMetaRows;\n uint16_t ptr = random(end - start) + start;\n\n uint16_t fr;\n\n if (hint != 0)\n {\n fr = firstFree(hint & 0xff00);\n if (fr)\n return fr;\n }\n\n for (;;)\n {\n fr = firstFree(ptr << 8);\n if (fr)\n return fr;\n if (++ptr == end)\n {\n if (wrapped)\n {\n if (gc)\n oops();\n gcCore(true, isData);\n gc = true;\n }\n ptr = start;\n wrapped = true;\n }\n }\n}\n\nFS::~FS()\n{\n delete rowRemapCache;\n}\n\nvoid FS::markPage(uint16_t page, uint8_t flag)\n{\n if (flag == 0xff)\n oops();\n if (flag == 0)\n {\n deletedPages++;\n fullPages--;\n }\n else\n {\n fullPages++;\n freePages--;\n }\n\n if (flag == 0 && (page >> 8) < numMetaRows)\n {\n flash.writeBytes(pageAddr(page), &flag, 1);\n }\n flash.writeBytes(indexAddr(page), &flag, 1);\n}\n\nuint8_t FS::dataPageSize()\n{\n int markedLen = 0;\n int i;\n for (i = SPIFLASH_PAGE_SIZE - 1; i >= 0; --i)\n {\n if (buf[i] == 0xff)\n break;\n markedLen = buf[i];\n }\n while (i >= 0)\n {\n if (buf[i] != 0xff)\n break;\n i--;\n }\n i++;\n return max(i, markedLen);\n}\n\nvoid File::rewind()\n{\n readPage = 0;\n readMetaPage = 0;\n readOffset = 0;\n readOffsetInPage = 0;\n readPageSize = 0;\n}\n\nFile *FS::open(uint16_t fileID)\n{\n lock();\n auto r = new File(*this, fileID);\n unlock();\n return r;\n}\n\nFile *FS::open(const char *filename, bool create)\n{\n lock();\n auto page = findMetaEntry(filename);\n if (page == 0)\n {\n if (create) {\n page = createMetaPage(filename);\n } else {\n unlock();\n return NULL;\n }\n }\n auto r = new File(*this, page);\n unlock();\n return r;\n}\n\nbool FS::exists(const char *filename)\n{\n lock();\n auto r = findMetaEntry(filename) != 0;\n unlock();\n return r;\n}\n\nvoid FS::lock()\n{ \n while (locked) \n fiber_wait_for_event(DEVICE_ID_NOTIFY, snorfs_unlocked_event);\n locked = true;\n mount();\n}\n\nvoid FS::unlock()\n{\n if (!locked)\n oops();\n locked = false;\n#ifndef SNORFS_TEST\n Event(DEVICE_ID_NOTIFY, snorfs_unlocked_event);\n#endif\n}\n\nvoid FS::maybeGC()\n{\n lock();\n gcCore(false, false);\n unlock();\n}\n\nuint16_t FS::findMetaEntry(const char *filename)\n{\n uint8_t h = fnhash(filename);\n uint16_t buflen = strlen(filename) + 2;\n\n if (buflen > 64)\n oops();\n\n auto tmp = new uint8_t[buflen];\n\n for (int i = 0; i < numMetaRows; ++i)\n {\n flash.readBytes(indexAddr(i << 8), buf, SPIFLASH_PAGE_SIZE);\n for (int j = 1; j < SPIFLASH_PAGE_SIZE - 1; ++j)\n {\n if (buf[j] == h)\n {\n uint16_t pageIdx = (i << 8) | j;\n auto addr = pageAddr(pageIdx);\n flash.readBytes(addr, tmp, buflen);\n if (tmp[0] == 1 && memcmp(tmp + 1, filename, buflen - 1) == 0) {\n delete tmp;\n return pageIdx;\n }\n }\n }\n }\n\n delete tmp;\n return 0;\n}\n\nuint16_t FS::createMetaPage(const char *filename)\n{\n uint8_t h = fnhash(filename);\n feedRandom(h);\n uint16_t page = findFreePage(false);\n uint16_t buflen = strlen(filename) + 2;\n\n memset(buf, 0xff, SPIFLASH_PAGE_SIZE);\n buf[0] = 0x01;\n memcpy(buf + 1, filename, buflen - 1);\n\n flash.writeBytes(pageAddr(page), buf, buflen);\n markPage(page, h);\n\n return page;\n}\n\nFile::File(FS &f, uint16_t existing) : fs(f)\n{\n metaPage = existing;\n writePage = 0;\n rewind();\n next = fs.files;\n fs.files = this;\n}\n\nFile::~File()\n{\n if (this == fs.files)\n {\n fs.files = next;\n }\n else\n {\n auto p = fs.files;\n while (p)\n {\n if (p->next == this)\n {\n p->next = this->next;\n break;\n }\n p = p->next;\n }\n if (p == NULL)\n oops();\n }\n}\n\nvoid File::seek(uint32_t pos)\n{\n if (pos == readOffset)\n return;\n if (pos < readOffset)\n rewind();\n read(NULL, pos - readOffset);\n}\n\nint FS::metaStart(uint16_t *nextPtr, uint16_t *nextPtrPtr)\n{\n int start = 1;\n while (start < 64 && buf[start])\n start++;\n start++;\n if (nextPtr)\n *nextPtr = read16(start);\n if (nextPtrPtr)\n *nextPtrPtr = start;\n start += 2;\n for (int i = start; i + 2 < SPIFLASH_PAGE_SIZE; i += 3)\n if (buf[i] == 0x00 && buf[i + 1] == 0x00 && buf[i + 2] == 0x00)\n start = i + 3;\n return start;\n}\n\nuint32_t FS::fileSize(uint16_t metaPage)\n{\n uint32_t sz = 0;\n uint16_t lastPage = 0;\n uint16_t currPage = metaPage;\n for (;;)\n {\n flash.readBytes(pageAddr(currPage), buf, SPIFLASH_PAGE_SIZE);\n if (buf[0] == 0x00)\n return 0; // deleted\n uint16_t nextPtr;\n for (int i = metaStart(&nextPtr); i + 2 < SPIFLASH_PAGE_SIZE; i += 3)\n {\n uint16_t page = read16(i);\n if (page == 0xffff)\n {\n if (nextPtr != 0xffff)\n oops();\n break;\n }\n if (buf[i + 2] == 0xff)\n {\n lastPage = page;\n }\n else\n {\n sz += buf[i + 2] + 1;\n if (lastPage)\n oops();\n }\n }\n if (nextPtr == 0xffff)\n break;\n\n if (lastPage)\n oops();\n currPage = nextPtr;\n }\n\n if (lastPage)\n {\n flash.readBytes(pageAddr(lastPage), buf, SPIFLASH_PAGE_SIZE);\n sz += dataPageSize();\n }\n\n if (lastPage || currPage != metaPage)\n {\n flash.readBytes(pageAddr(metaPage), buf, 64);\n }\n\n return sz;\n}\n\nuint16_t FS::read16(int off)\n{\n return buf[off] | (buf[off + 1] << 8);\n}\n\n#define DIRCHUNK 32\nDirEntry *FS::dirRead()\n{\n lock();\n for (;;)\n {\n if ((dirptr >> 8) >= numMetaRows)\n {\n unlock();\n return NULL;\n }\n int off = dirptr & 0xff;\n int len = min(DIRCHUNK, SPIFLASH_PAGE_SIZE - off);\n flash.readBytes(indexAddr(dirptr), buf, len);\n for (int i = 0; i < len; ++i)\n {\n if (i + off >= 0x100)\n oops();\n if (0x02 < buf[i] && buf[i] < 0xff)\n {\n dirptr += i;\n DirEntry tmp;\n tmp.flags = 0;\n tmp.fileID = dirptr;\n tmp.size = fileSize(dirptr);\n dirptr++;\n if (buf[0] == 0x01)\n {\n strcpy(tmp.name, (char *)buf + 1);\n memcpy(buf, &tmp, sizeof(tmp));\n unlock();\n return (DirEntry *)(void *)buf;\n }\n }\n }\n dirptr += len;\n }\n}\n\nbool File::seekNextPage(uint16_t *cache)\n{\n if (readMetaPage == 0)\n readMetaPage = metaPage;\n\n if (*cache != readMetaPage)\n {\n fs.flash.readBytes(fs.pageAddr(readMetaPage), fs.buf, SPIFLASH_PAGE_SIZE);\n *cache = readMetaPage;\n }\n\n uint16_t nextPtr;\n bool isNext = false;\n uint16_t newReadPage = 0;\n\n for (int i = fs.metaStart(&nextPtr); i + 2 < SPIFLASH_PAGE_SIZE; i += 3)\n {\n uint16_t page = fs.read16(i);\n if (page == 0xffff)\n return false;\n if (isNext || readPage == 0)\n {\n newReadPage = page;\n readPageSize = fs.buf[i + 2];\n break;\n }\n if (page == readPage)\n isNext = true;\n }\n\n if (newReadPage == 0)\n {\n if (!isNext)\n oops();\n if (nextPtr == 0xffff)\n return false;\n readMetaPage = nextPtr;\n readPage = 0;\n return seekNextPage(cache);\n }\n\n if (readPageSize == 0xff)\n {\n *cache = 0;\n fs.flash.readBytes(fs.pageAddr(newReadPage), fs.buf, SPIFLASH_PAGE_SIZE);\n readPageSize = fs.dataPageSize();\n }\n else\n readPageSize++;\n\n readPage = newReadPage;\n readOffsetInPage = 0;\n return true;\n}\n\nuint32_t File::size()\n{\n primary()->computeWritePage();\n return metaSize;\n}\n\nFile *File::primary()\n{\n for (auto p = fs.files; p; p = p->next)\n if (p->metaPage == metaPage)\n return p;\n oops();\n return NULL;\n}\n\nint File::read(void *data, uint32_t len)\n{\n if (!len)\n return 0;\n\n if (writePage != SNORFS_COMPUTING_WRITE_PAGE)\n fs.lock();\n\n if (len > 0x7fffffffU)\n len = 0x7fffffffU;\n\n uint16_t seekCache = 0;\n int nread = 0;\n while (len > 0)\n {\n if (readOffsetInPage >= readPageSize)\n {\n if (!seekNextPage(&seekCache))\n break;\n }\n\n int n = min((int)len, readPageSize - readOffsetInPage);\n if (data)\n {\n fs.flash.readBytes(fs.pageAddr(readPage) + readOffsetInPage, data, n);\n data = (uint8_t *)data + n;\n }\n nread += n;\n len -= n;\n readOffset += n;\n readOffsetInPage += n;\n }\n\n if (writePage != SNORFS_COMPUTING_WRITE_PAGE)\n fs.unlock();\n\n return nread;\n}\n\nvoid File::computeWritePage()\n{\n if (isDeleted())\n oops();\n if (writePage)\n return;\n auto prevOff = readOffset;\n writePage = SNORFS_COMPUTING_WRITE_PAGE;\n seek(0xffffffff);\n auto newWritePage = readPage;\n writeMetaPage = readMetaPage;\n writeOffsetInPage = readOffsetInPage;\n writeNumExplicitSizes = 0;\n if (writePage)\n {\n fs.flash.readBytes(fs.pageAddr(writePage), fs.buf, SPIFLASH_PAGE_SIZE);\n for (int i = SPIFLASH_PAGE_SIZE - 1; i >= 0; --i)\n {\n if (fs.buf[i] == 0xff)\n break;\n writeNumExplicitSizes++;\n }\n }\n for (auto p = fs.files; p; p = p->next)\n if (p->metaPage == metaPage)\n p->metaSize = readOffset;\n seek(prevOff);\n writePage = newWritePage;\n}\n\nvoid File::append(const void *data, uint32_t len)\n{\n if (len == 0)\n return;\n\n auto prim = primary();\n if (prim != this)\n {\n prim->append(data, len);\n return;\n }\n\n fs.lock();\n\n computeWritePage();\n\n while (len > 0)\n {\n int nwrite =\n min((int)len, SPIFLASH_PAGE_SIZE - (writeNumExplicitSizes + 2) - writeOffsetInPage);\n if (nwrite <= 0 || writePage == 0)\n {\n allocatePage();\n continue;\n }\n\n LOGV(\"write: left=%d page=0x%x nwr=%d off=%d\\n\", len, writePage, nwrite, writeOffsetInPage);\n\n fs.flash.writeBytes(fs.pageAddr(writePage) + writeOffsetInPage, data, nwrite);\n\n writeOffsetInPage += nwrite;\n\n // if the last byte was 0xff, we need an end marker\n if (((uint8_t *)data)[nwrite - 1] == 0xff)\n {\n fs.flash.writeBytes(fs.pageAddr(writePage) + SPIFLASH_PAGE_SIZE -\n (writeNumExplicitSizes++ + 1),\n &writeOffsetInPage, 1);\n }\n\n len -= nwrite;\n data = (uint8_t *)data + nwrite;\n\n for (auto p = fs.files; p; p = p->next)\n if (p->metaPage == metaPage)\n {\n if (writePage == p->readPage)\n p->readPageSize = writeOffsetInPage;\n p->metaSize += nwrite;\n }\n }\n\n fs.unlock();\n}\n\nvoid File::allocatePage()\n{\n fs.feedRandom(fileID());\n\n fs.flash.readBytes(fs.pageAddr(writeMetaPage), fs.buf, SPIFLASH_PAGE_SIZE);\n int next = 0;\n int last = 0;\n uint16_t nextPP;\n for (int i = fs.metaStart(NULL, &nextPP); i + 2 < SPIFLASH_PAGE_SIZE; i += 3)\n {\n if (fs.buf[i] == 0xff && fs.buf[i + 1] == 0xff)\n {\n next = i;\n break;\n }\n last = i;\n }\n\n if (last && fs.buf[last + 2] != 0xff)\n oops();\n\n if (writePage && last)\n {\n#ifdef SNORFS_TEST\n fs.flash.readBytes(fs.pageAddr(writePage), fs.buf, SPIFLASH_PAGE_SIZE);\n uint8_t len = fs.dataPageSize();\n if (len != writeOffsetInPage)\n oops();\n#endif\n uint8_t v = writeOffsetInPage - 1;\n fs.flash.writeBytes(fs.pageAddr(writeMetaPage) + last + 2, &v, 1);\n }\n\n if (!next)\n {\n uint16_t newMeta = fs.findFreePage(false);\n fs.markPage(newMeta, 0x02);\n uint8_t hd[] = {0x02, 0x00};\n fs.flash.writeBytes(fs.pageAddr(newMeta), hd, 2);\n fs.flash.writeBytes(fs.pageAddr(writeMetaPage) + nextPP, &newMeta, 2);\n writeMetaPage = newMeta;\n next = 4;\n }\n\n // if writePage is set, try to keep the new page on the same row - this helps with\n // delete locality\n writePage = fs.findFreePage(true, writePage);\n fs.markPage(writePage, 1);\n fs.flash.writeBytes(fs.pageAddr(writeMetaPage) + next, &writePage, 2);\n writeOffsetInPage = 0;\n writeNumExplicitSizes = 0;\n}\n\nvoid File::delCore(bool delMeta)\n{\n rewind();\n uint16_t cache = 0;\n uint16_t prev = 0;\n bool empty = true;\n\n for (;;)\n {\n if (!seekNextPage(&cache))\n break;\n empty = false;\n if (readMetaPage != prev)\n {\n if (delMeta)\n fs.markPage(readMetaPage, 0);\n prev = readMetaPage;\n }\n fs.markPage(readPage, 0);\n }\n\n if (delMeta && empty)\n {\n fs.markPage(metaPage, 0);\n }\n\n if (!delMeta && readMetaPage != metaPage)\n oops();\n\n for (auto p = fs.files; p; p = p->next)\n if (p->metaPage == metaPage)\n {\n p->rewind();\n p->metaSize = 0;\n p->writePage = 0xffff;\n }\n}\n\nvoid File::del()\n{\n fs.lock();\n primary()->delCore(true);\n fs.unlock();\n}\n\nvoid File::overwrite(const void *data, uint32_t len)\n{\n\n auto prim = primary();\n if (prim != this)\n {\n prim->overwrite(data, len);\n return;\n }\n\n fs.lock();\n\n fs.flash.readBytes(metaPageAddr(), fs.buf, SPIFLASH_PAGE_SIZE);\n int freePtr = 0;\n for (int i = fs.metaStart(); i + 2 + 6 < SPIFLASH_PAGE_SIZE; i += 3)\n {\n if (fs.buf[i] == 0xff && fs.buf[i + 1] == 0xff)\n {\n freePtr = i;\n break;\n }\n }\n\n if (freePtr)\n {\n uint8_t clearMark[] = {0, 0, 0};\n delCore(false);\n fs.flash.writeBytes(metaPageAddr() + freePtr, clearMark, 3);\n }\n else\n {\n int len = strlen((char *)fs.buf + 1);\n char tmp[len];\n strcpy(tmp, (char *)fs.buf + 1);\n delCore(true);\n metaPage = fs.createMetaPage(tmp);\n }\n writePage = 0;\n rewind();\n fs.unlock();\n\n append(data, len);\n}\n\nint FS::readFlashBytes(uint32_t addr, void *buffer, uint32_t len)\n{\n lock();\n int r = flash.readBytes(addr, buffer, len);\n unlock();\n return r;\n}\n\n#ifdef SNORFS_TEST\nvoid FS::dump()\n{\n if (numRows == 0)\n {\n LOG(\"not mounted\\n\");\n mount();\n }\n LOG(\"row#: %d; remap: \", numRows);\n\n for (unsigned i = 0; i < numRows + 1; ++i)\n {\n BlockHeader hd;\n auto addr = i * SPIFLASH_BIG_ROW_SIZE;\n flash.readBytes(addr, &hd, sizeof(hd));\n LOG(\"[%d: %d] \", (int16_t)hd.logicalBlockId, hd.eraseCount);\n }\n\n LOG(\"free: %d/%d, (junk: %d)\", freePages + deletedPages, fullPages + freePages + deletedPages,\n deletedPages);\n LOG(\"\\n\");\n}\n\nvoid FS::debugDump()\n{\n // dump();\n}\n\nvoid File::debugDump()\n{\n LOGV(\"fileID: 0x%x, rd: 0x%x/%d, wr: 0x%x/%d\\n\", fileID(), readPage, tell(), writePage,\n metaSize);\n}\n#endif",
"SNORFS.h": "#ifndef CODAL_SNORFS_H\n#define CODAL_SNORFS_H\n\n#include \"SPIFlash.h\"\n\n#define DEVICE_FLASH_ERROR 950\n\nnamespace codal\n{\nnamespace snorfs\n{\n\nclass File;\n\nstruct DirEntry\n{\n uint32_t size;\n uint16_t flags;\n uint16_t fileID;\n char name[65];\n};\n\n// Supported flash size: 1-16MB\nclass FS\n{\n friend class File;\n\n SPIFlash &flash;\n uint8_t buf[SPIFLASH_PAGE_SIZE];\n\n File *files;\n\n uint8_t *rowRemapCache;\n uint8_t numRows;\n uint8_t numMetaRows;\n uint8_t freeRow;\n volatile bool locked;\n\n uint32_t randomSeed;\n\n // this is for data pages only\n uint16_t fullPages;\n uint16_t deletedPages;\n uint16_t freePages;\n\n uint16_t dirptr;\n\n uint32_t rowAddr(uint8_t rowIdx)\n {\n if (rowIdx >= numRows)\n target_panic(DEVICE_FLASH_ERROR);\n return rowRemapCache[rowIdx] * SPIFLASH_BIG_ROW_SIZE;\n }\n uint32_t indexAddr(uint16_t ptr)\n {\n return rowAddr(ptr >> 8) + SPIFLASH_BIG_ROW_SIZE - SPIFLASH_PAGE_SIZE + (ptr & 0xff);\n }\n uint32_t pageAddr(uint16_t ptr)\n {\n // page zero is index, shouldn't be accessed through this\n if (!(ptr & 0xff))\n target_panic(DEVICE_FLASH_ERROR);\n return rowAddr(ptr >> 8) + SPIFLASH_PAGE_SIZE * (ptr & 0xff);\n }\n\n int firstFree(uint16_t pageIdx);\n uint16_t findFreePage(bool isData, uint16_t hint = 0);\n uint32_t random(uint32_t max);\n void feedRandom(uint32_t max);\n void mount();\n void format();\n uint16_t findMetaEntry(const char *filename);\n uint16_t createMetaPage(const char *filename);\n bool readHeaders();\n void gcCore(bool force, bool isData);\n void swapRow(int row);\n void markPage(uint16_t page, uint8_t flag);\n uint8_t dataPageSize();\n uint16_t read16(int off);\n int metaStart(uint16_t *nextPtr = NULL, uint16_t *nextPtrPtr = NULL);\n uint32_t fileSize(uint16_t metaPage);\n void lock();\n void unlock();\n bool pageErased(uint32_t addr);\n bool rowErased(uint32_t addr, bool checkFull);\n\npublic:\n FS(SPIFlash &f);\n ~FS();\n // returns NULL if file doesn't exists and create==false\n File *open(const char *filename, bool create = true);\n File *open(uint16_t fileID);\n bool exists(const char *filename);\n uint32_t rawSize() { return flash.numPages() * SPIFLASH_PAGE_SIZE; }\n uint32_t totalSize() { return (fullPages + deletedPages + freePages) * SPIFLASH_PAGE_SIZE; }\n uint32_t freeSize() { return (deletedPages + freePages) * SPIFLASH_PAGE_SIZE; }\n void busy(bool isBusy = true);\n void maybeGC();\n // this allow raw r/o access; will lock the instance as needed\n int readFlashBytes(uint32_t addr, void *buffer, uint32_t len);\n bool tryMount();\n\n void dirRewind() { dirptr = 0; }\n DirEntry *dirRead(); // data is only valid until next call to to any of File or FS function\n\n#ifdef SNORFS_TEST\n void debugDump();\n void dump();\n#else\n void debugDump() {}\n#endif\n};\n\nclass File\n{\n // Invariants:\n // firstPage == 0 <==> no pages has been allocated\n // readOffset % SPIFLASH_PAGE_SIZE == 0 && readPage != 0 ==>\n // readPage is on page for (readOffset - 1)\n // writePage % SPIFLASH_PAGE_SIZE == 0 && writePage != 0 ==>\n // writePage is on page for (metaSize - 1)\n // if readPage is 0 it needs to be recomputed\n // if writePage is 0 it needs to be recomputed\n\n friend class FS;\n\n FS &fs;\n File *next;\n uint32_t metaSize;\n\n uint16_t metaPage; // the address of main meta entry\n\n // this is for reading\n uint16_t readMetaPage;\n uint16_t readPage;\n uint8_t readOffsetInPage;\n uint8_t readPageSize;\n uint32_t readOffset;\n\n // this is for writing (append)\n uint16_t writeMetaPage;\n uint16_t writePage;\n uint8_t writeOffsetInPage;\n uint8_t writeNumExplicitSizes;\n\n uint32_t metaPageAddr() { return fs.pageAddr(metaPage); }\n\n void rewind();\n bool seekNextPage(uint16_t *cache);\n void allocatePage();\n void newMetaPage();\n void findFreeMetaPage();\n void computeWritePage();\n void saveSizeDiff(int32_t sizeDiff);\n void appendCore(const void *data, uint32_t len);\n void delCore(bool delMeta);\n File(FS &f, uint16_t filePage);\n File(FS &f, const char *filename);\n File *primary();\n\npublic:\n int read(void *data, uint32_t len);\n void append(const void *data, uint32_t len);\n void seek(uint32_t pos);\n uint32_t size();\n uint32_t tell() { return readOffset; }\n uint32_t fileID() { return metaPage; }\n bool isDeleted() { return writePage == 0xffff; }\n void overwrite(const void *data, uint32_t len);\n void del();\n void truncate() { overwrite(NULL, 0); }\n ~File();\n#ifdef SNORFS_TEST\n void debugDump();\n#endif\n};\n}\n}\n\n#endif\n",
"pxt.json": "{\n \"name\": \"storage\",\n \"description\": \"USB Pen-drive support and flash storage\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"SNORFS.cpp\",\n \"SNORFS.h\",\n \"GhostSNORFS.cpp\",\n \"GhostSNORFS.h\",\n \"storage.cpp\",\n \"storage.ts\",\n \"shims.d.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"yotta\": {\n \"config\": {\n \"DEVICE_USB\": 1\n }\n },\n \"icon\": \"/static/libs/storage.png\"\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace storage {\n\n /** \n * Append a buffer to a new or existing file. \n * @param filename name of the file, eg: \"log.txt\"\n */\n //% parts=\"storage\" shim=storage::appendBuffer\n function appendBuffer(filename: string, data: Buffer): void;\n\n /** \n * Overwrite file with a buffer. \n * @param filename name of the file, eg: \"log.txt\"\n */\n //% parts=\"storage\" shim=storage::overwriteWithBuffer\n function overwriteWithBuffer(filename: string, data: Buffer): void;\n\n /** \n * Return true if the file already exists. \n * @param filename name of the file, eg: \"log.txt\"\n */\n //% parts=\"storage\"\n //% blockId=\"storage_exists\" block=\"file $filename exists\" shim=storage::exists\n function exists(filename: string): boolean;\n\n /** \n * Delete a file, or do nothing if it doesn't exist. \n * @param filename name of the file, eg: \"log.txt\"\n */\n //% parts=\"storage\"\n //% blockId=\"storage_remove\" block=\"remove file $filename\" shim=storage::remove\n function remove(filename: string): void;\n\n /** \n * Return the size of the file, or -1 if it doesn't exists. \n * @param filename name of the file, eg: \"log.txt\"\n */\n //% parts=\"storage\"\n //% blockId=\"storage_size\" block=\"size of file $filename\" shim=storage::size\n function size(filename: string): int32;\n\n /** \n * Read contents of file as a buffer. \n * @param filename name of the file, eg: \"log.txt\"\n */\n //% parts=\"storage\" shim=storage::readAsBuffer\n function readAsBuffer(filename: string): Buffer;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"storage.cpp": "#include \"pxt.h\"\n#include \"SPI.h\"\n\n#include \"GhostSNORFS.h\"\n#include \"StandardSPIFlash.h\"\n\nnamespace storage {\n\nclass PXTMSC : public GhostSNORFS {\n public:\n virtual const char *volumeLabel() { return \"MAKECODE\"; }\n PXTMSC(snorfs::FS &fs) : GhostSNORFS(fs) {}\n};\n\nclass WStorage {\n public:\n CODAL_SPI flashSPI;\n StandardSPIFlash flash;\n snorfs::FS fs;\n PXTMSC msc;\n bool mounted;\n\n WStorage()\n : flashSPI(*LOOKUP_PIN(FLASH_MOSI), *LOOKUP_PIN(FLASH_MISO), *LOOKUP_PIN(FLASH_SCK)),\n flash(flashSPI, *LOOKUP_PIN(FLASH_CS),\n getConfig(CFG_FLASH_BYTES, 2 * 1024 * 1024) / SPIFLASH_PAGE_SIZE),\n fs(flash), msc(fs) {\n // see if we can mount it\n mounted = fs.tryMount();\n }\n};\nSINGLETON_IF_PIN(WStorage, FLASH_MOSI);\n\nstatic WStorage *mountedStorage() {\n auto s = getWStorage();\n if (!s) \n return NULL;\n\n if (s->mounted)\n return s;\n \n DMESG(\"formatting storage\");\n s->fs.exists(\"foobar\"); // forces mount\n s->mounted = true;\n\n return s;\n\n/*\n auto p = LOOKUP_PIN(LED);\n // lock-up blinking LED\n // TODO wait for A+B, erase SPI chip, and reset\n while (1) {\n p->setDigitalValue(1);\n fiber_sleep(100);\n p->setDigitalValue(0);\n fiber_sleep(100);\n }\n */\n}\n\n//%\nvoid init() {\n usb.delayStart();\n auto s = getWStorage();\n if (s && s->mounted) {\n usb.add(s->msc);\n s->msc.addFiles();\n }\n usb.start();\n}\n\nsnorfs::File *getFile(String filename) {\n auto st = mountedStorage();\n if (!st) \n return NULL;\n\n // maybe we want to keep say up to 5 files open?\n static String currFilename;\n static snorfs::File *currFile;\n\n if (!currFilename) {\n registerGC((TValue*)&currFilename);\n } else {\n if (filename && String_::compare(currFilename, filename) == 0)\n return currFile;\n delete currFile;\n }\n currFilename = filename;\n // TODO: fix UTF8 encoding\n currFile = filename == NULL ? NULL : st->fs.open(filename->getUTF8Data());\n return currFile;\n}\n\n/** \n* Append a buffer to a new or existing file. \n* @param filename name of the file, eg: \"log.txt\"\n*/\n//% parts=\"storage\"\nvoid appendBuffer(String filename, Buffer data) {\n auto f = getFile(filename);\n if (NULL == f) return;\n f->append(data->data, data->length);\n}\n\n/** \n* Overwrite file with a buffer. \n* @param filename name of the file, eg: \"log.txt\"\n*/\n//% parts=\"storage\"\nvoid overwriteWithBuffer(String filename, Buffer data) {\n auto f = getFile(filename);\n if (NULL == f) return;\n f->overwrite(data->data, data->length);\n}\n\n/** \n* Return true if the file already exists. \n* @param filename name of the file, eg: \"log.txt\"\n*/\n//% parts=\"storage\"\n//% blockId=\"storage_exists\" block=\"file $filename exists\"\nbool exists(String filename) {\n auto st = mountedStorage();\n return !!st && st->fs.exists(filename->getUTF8Data());\n}\n\n/** \n* Delete a file, or do nothing if it doesn't exist. \n* @param filename name of the file, eg: \"log.txt\"\n*/\n//% parts=\"storage\"\n//% blockId=\"storage_remove\" block=\"remove file $filename\"\nvoid remove(String filename) {\n if (!exists(filename))\n return;\n auto f = getFile(filename);\n f->del();\n getFile(NULL);\n}\n\n/** \n* Return the size of the file, or -1 if it doesn't exists. \n* @param filename name of the file, eg: \"log.txt\"\n*/\n//% parts=\"storage\"\n//% blockId=\"storage_size\" block=\"size of file $filename\"\nint size(String filename) {\n if (!exists(filename))\n return -1;\n auto f = getFile(filename); \n return f->size();\n}\n\n/** \n* Read contents of file as a buffer. \n* @param filename name of the file, eg: \"log.txt\"\n*/\n//% parts=\"storage\"\nBuffer readAsBuffer(String filename) {\n auto f = getFile(filename);\n if (NULL == f) \n return NULL;\n auto sz = f->size();\n if (sz > 0xffff)\n return NULL;\n auto res = mkBuffer(NULL, sz);\n registerGCObj(res);\n f->seek(0);\n f->read(res->data, res->length);\n unregisterGCObj(res);\n return res;\n}\n\n} // namespace storage\n",
"storage.ts": "/** \n * File storage operations\n*/\n//% weight=5 color=#00c0c0 icon=\"\\uf07b\"\nnamespace storage {\n export let NEW_LINE = \"\\n\";\n\n //% shim=storage::init\n function init() { }\n\n // init() needs to be called at the beginning of the program, so it gets a chance\n // to register its USB handler\n init();\n\n /**\n * Appends a new line to the file\n * @param filename name of the file, eg: \"log.txt\"\n */\n //% parts=\"storage\" \n //% blockId=\"storage_append_line\" block=\"append file $filename with line $data\"\n export function appendLine(filename: string, data: string): void {\n append(filename, data + NEW_LINE);\n }\n\n /** \n * Append string data to a new or existing file. \n * @param filename name of the file, eg: \"log.txt\"\n */\n //% parts=\"storage\" \n //% blockId=\"storage_append\" block=\"append file $filename with $data\"\n export function append(filename: string, data: string) {\n appendBuffer(filename, control.createBufferFromUTF8(data));\n }\n\n /** \n * Overwrite file with string data. \n * @param filename name of the file, eg: \"log.txt\"\n */\n //% parts=\"storage\"\n //% blockId=\"storage_overwrite\" block=\"overwrite file $filename with $data\"\n export function overwrite(filename: string, data: string) {\n overwriteWithBuffer(filename, control.createBufferFromUTF8(data));\n }\n\n /** \n * Read contents of file as a string. \n * @param filename name of the file, eg: \"log.txt\"\n */\n //% parts=\"storage\"\n //% blockId=\"storage_read\" block=\"read file $filename\"\n export function read(filename: string) {\n const buf = readAsBuffer(filename);\n if (!buf)\n return null;\n return buf.toString();\n }\n}\n"
},
"serial": {
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum 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 //% block=300\n BaudRate300 = 300,\n }\n\n\n declare const enum SerialEvent {\n //% block=\"data received\"\n DataReceived = 4, // CODAL_SERIAL_EVT_DATA_RECEIVED\n //% block=\"rx buffer full\"\n RxBufferFull = 3, // CODAL_SERIAL_EVT_RX_FULL\n }\n\n\n declare 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// Auto-generated. Do not edit. Really.\n",
"pxt.json": "{\n \"name\": \"serial\",\n \"description\": \"UART communication\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"serial-target.h\",\n \"serial-common.h\",\n \"serial-target.cpp\",\n \"serial-common.cpp\",\n \"serial-target.ts\",\n \"serial.ts\",\n \"enums.d.ts\",\n \"shims.d.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"icon\": \"/static/libs/serial.png\"\n}\n",
"serial-common.cpp": "#include \"pxt.h\"\n#include \"serial-target.h\"\n\nnamespace SerialDeviceMethods {\n/**\n * Sets the size of the RX buffer in bytes\n */\n//%\nvoid setRxBufferSize(SerialDevice device, uint8_t size) {\n device->setRxBufferSize(size);\n}\n\n/**\n * Sets the size of the TX buffer in bytes\n */\n//%\nvoid setTxBufferSize(SerialDevice device, uint8_t size) {\n device->setTxBufferSize(size);\n}\n\n/**\nSet the baud rate of the serial port\n*/\n//%\nvoid setBaudRate(SerialDevice device, BaudRate rate) {\n device->setBaudRate((int)rate);\n}\n\n/**\n * Reads a single byte from the serial receive buffer. Negative if error, 0 if no data.\n */\n//%\nint read(SerialDevice device) {\n return device->read();\n}\n\n/**\n * Read the buffered received data as a buffer\n */\n//%\nBuffer readBuffer(SerialDevice device) {\n return device->readBuffer();\n}\n\n/**\n * Send a buffer across the serial connection.\n */\n//%\nvoid writeBuffer(SerialDevice device, Buffer buffer) {\n device->writeBuffer(buffer);\n}\n\n/**\n * Register code when a serial event occurs\n */\n//%\nvoid onEvent(SerialDevice device, SerialEvent event, Action handler) {\n device->onEvent(event, handler);\n}\n\n/**\n * Registers code when a delimiter is received\n **/\n//%\nvoid onDelimiterReceived(SerialDevice device, Delimiters delimiter, Action handler) {\n device->onDelimiterReceived(delimiter, handler);\n}\n} // namespace SerialDeviceMethods\n",
"serial-common.h": "#pragma once\n#include \"pxt.h\"\n#include \"serial-target.h\"\n\nenum class 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 //% block=300\n BaudRate300 = 300\n};\n\nenum class SerialEvent {\n //% block=\"data received\"\n DataReceived = CODAL_SERIAL_EVT_DATA_RECEIVED,\n //% block=\"rx buffer full\"\n RxBufferFull = CODAL_SERIAL_EVT_RX_FULL\n};\n\nenum class 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",
"serial-target.cpp": "#include \"pxt.h\"\n#include \"serial-target.h\"\n\nnamespace serial {\n\nstatic SerialDevice serialDevices(NULL);\n/**\n * Opens a Serial communication driver\n */\n//%\nSerialDevice internalCreateSerialDevice(DigitalInOutPin tx, DigitalInOutPin rx, int id) {\n auto dev = serialDevices;\n while (dev) {\n if (dev->matchPins(tx, rx))\n return dev;\n dev = dev->next;\n }\n\n // allocate new one\n auto ser = new CodalSerialDeviceProxy(tx, rx, id);\n ser->next = serialDevices;\n serialDevices = ser;\n return ser;\n}\n\n} // namespace serial\n\nnamespace SerialDeviceMethods {\n\n/**\n */\n//%\nvoid redirect(SerialDevice device, DigitalInOutPin tx, DigitalInOutPin rx, BaudRate rate) {\n device->redirect(tx, rx, rate);\n}\n\n} // namespace SerialDeviceMethods\n",
"serial-target.h": "#pragma once\n#include \"pxt.h\"\n#include \"Serial.h\"\n\nenum class SerialEvent;\nenum class BaudRate;\nenum class Delimiters;\n\nnamespace serial {\n\nclass CodalSerialDeviceProxy {\n private:\n DevicePin *tx;\n DevicePin *rx;\n\n public:\n CODAL_SERIAL ser;\n CodalSerialDeviceProxy *next;\n\n CodalSerialDeviceProxy(DevicePin *_tx, DevicePin *_rx, uint16_t id)\n : tx(_tx), rx(_rx), ser(*tx, *rx), next(NULL) {\n if (id <= 0)\n id = allocateNotifyEvent();\n ser.id = id;\n ser.setBaud(115200);\n }\n\n bool matchPins(DevicePin *_tx, DevicePin *_rx) { return this->tx == _tx && this->rx == _rx; }\n\n void setRxBufferSize(uint8_t size) { ser.setRxBufferSize(size); }\n\n void setTxBufferSize(uint8_t size) { ser.setTxBufferSize(size); }\n\n void setBaudRate(int rate) { ser.setBaud(rate); }\n\n int read() {\n uint8_t buf[1];\n auto r = ser.read(buf, 1, codal::SerialMode::ASYNC);\n // r < 0 => error\n if (r < 0)\n return r;\n // r == 0, nothing read\n if (r == 0)\n return DEVICE_NO_DATA;\n // read 1 char\n return buf[0];\n }\n\n Buffer readBuffer() {\n int n = ser.getRxBufferSize();\n // n maybe 0 but we still call read to force\n // to initialize rx\n auto buf = mkBuffer(NULL, n);\n auto res = buf;\n registerGCObj(buf);\n auto read = ser.read(buf->data, buf->length, SerialMode::ASYNC);\n if (read == DEVICE_SERIAL_IN_USE || read == 0) { // someone else is reading\n res = mkBuffer(NULL, 0);\n } else if (buf->length != read) {\n res = mkBuffer(buf->data, read);\n }\n unregisterGCObj(buf);\n return res;\n }\n\n void writeBuffer(Buffer buffer) {\n if (NULL == buffer)\n return;\n ser.send(buffer->data, buffer->length);\n }\n\n void redirect(DevicePin *tx, DevicePin *rx, BaudRate rate) {\n this->tx = tx;\n this->rx = rx;\n this->ser.redirect(*tx, *rx);\n this->setBaudRate((int)rate);\n }\n\n void onEvent(SerialEvent event, Action handler) {\n ser.setRxBufferSize(ser.getRxBufferSize()); // turn on reading\n registerWithDal(ser.id, (int)event, handler);\n }\n\n void onDelimiterReceived(Delimiters delimiter, Action handler) {\n registerWithDal(ser.id, CODAL_SERIAL_EVT_DELIM_MATCH, handler);\n ManagedString d((char)delimiter);\n ser.eventOn(d);\n }\n};\n\ntypedef CodalSerialDeviceProxy *SerialDevice;\n\n} // namespace serial\n",
"serial-target.ts": "namespace serial {\n /**\n * Creates a serial comm device\n * @param tx \n * @param rx \n * @param id \n */\n //% help=serial/create-serial\n //% parts=serial\n export function createSerial(tx: DigitalInOutPin, rx: DigitalInOutPin, id?: number): Serial {\n const dev = serial.internalCreateSerialDevice(tx, rx, id || 0);\n return new Serial(dev);\n }\n\n let _device: Serial;\n export function device(): Serial {\n if (!_device) {\n const tx = pins.pinByCfg(DAL.CFG_PIN_TX);\n const rx = pins.pinByCfg(DAL.CFG_PIN_RX);\n if (!tx || !rx) return undefined;\n _device = serial.createSerial(tx, rx, DAL.DEVICE_ID_SERIAL);\n }\n return _device;\n }\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\n * @param rx the new reception pin\n * @param rate the new baud rate\n */\n //% weight=10\n //% help=serial/redirect\n //% blockId=serial_redirect block=\"serial|redirect to|TX %tx|RX %rx at rate %rate\"\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 inlineInputMode=inline\n //% group=\"Configuration\"\n export function redirect(tx: DigitalInOutPin, rx: DigitalInOutPin, rate: BaudRate) {\n const ser = device();\n if (ser)\n ser.serialDevice.redirect(tx, rx, rate);\n }\n}\n",
"serial.ts": "/**\n * Reading and writing data over a serial connection.\n */\n//% weight=2 color=#002050 icon=\"\\uf287\"\n//% advanced=true blockGap=8\n//% groups='[\"Write\", \"Read\", \"Events\", \"Configuration\"]'\nnamespace serial {\n export let NEW_LINE = \"\\r\\n\"; // \\r require or Putty really unhappy on windows\n export let NEW_LINE_DELIMITER: Delimiters = Delimiters.NewLine;\n\n export class Serial {\n serialDevice: SerialDevice;\n decoder: UTF8Decoder;\n constructor(serialDevice: SerialDevice) {\n this.serialDevice = serialDevice;\n this.decoder = new UTF8Decoder();\n }\n\n readString(): string {\n const buf = this.serialDevice.readBuffer();\n this.decoder.add(buf);\n return this.decoder.decode();\n }\n\n readLine(timeOut?: number): string {\n return this.readUntil(NEW_LINE_DELIMITER, timeOut);\n }\n\n readUntil(delimiter: Delimiters, timeOut?: number): string {\n const start = control.millis();\n do {\n const s = this.decoder.decodeUntil(delimiter);\n if (s !== undefined)\n return s;\n const b = this.serialDevice.readBuffer()\n this.decoder.add(b);\n pause(1);\n }\n while (timeOut === undefined || (control.millis() - start < timeOut));\n // giving up\n return \"\";\n }\n\n writeString(text: string) {\n if (!text) return;\n const buf = control.createBufferFromUTF8(text);\n this.serialDevice.writeBuffer(buf);\n }\n\n writeLine(text: string) {\n this.writeString(text);\n this.writeString(serial.NEW_LINE);\n }\n }\n\n /**\n * Read the buffered received data as a string\n */\n //% help=serial/read-string\n //% blockId=serial_read_string block=\"serial|read string\"\n //% weight=18\n //% group=\"Read\"\n export function readString(): string {\n const d = device();\n return d ? d.readString() : \"\";\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 //% group=\"Read\"\n export function readLine(): string {\n const d = device();\n return d ? d.readLine() : \"\";\n }\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 //% group=\"Read\" \n export function readUntil(delimiter: Delimiters, timeOut?: number): string {\n const d = device();\n return d ? d.readUntil(delimiter, timeOut) : \"\";\n }\n\n /**\n * Write some text to the serial port.\n */\n //% help=serial/write-string\n //% weight=87\n //% blockId=serial_writestring block=\"serial|write string %text\"\n //% group=\"Write\"\n export function writeString(text: string) {\n const d = device();\n if (d) d.writeString(text);\n }\n\n /**\n * Write 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 //% group=\"Write\"\n export function writeLine(text: string): void {\n const d = device();\n if (d) d.writeLine(text);\n }\n\n /**\n * Write a number 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 //% group=\"Write\"\n export function writeNumber(value: number): void {\n writeString(value.toString());\n }\n\n /**\n * Write a name:value pair as a line of text 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 //% group=\"Write\"\n export function writeValue(name: string, value: number): void {\n if (name) {\n writeString(name);\n writeString(\":\");\n }\n writeNumber(value);\n writeString(NEW_LINE);\n }\n\n /**\n * Sets the size of the RX buffer in bytes\n */\n //% help=serial/set-rx-buffer-size\n //% blockId=serialsetrxbuffersize block=\"serial set rx buffer size to $size\"\n //% weight=10\n //% group=\"Configuration\"\n export function setRxBufferSize(size: number) {\n const ser = device();\n if (ser)\n ser.serialDevice.setRxBufferSize(size);\n }\n\n /**\n * Sets the size of the TX buffer in bytes\n */\n //% help=serial/set-tx-buffer-size\n //% blockId=serialsettxbuffersize block=\"serial set tx buffer size to $size\"\n //% weight=9\n //% group=\"Configuration\"\n export function setTxBufferSize(size: number) {\n const ser = device();\n if (ser)\n ser.serialDevice.setTxBufferSize(size);\n }\n\n /**\n * Reads a single byte from the serial receive buffer. Negative if error, 0 if no data.\n */\n //% Group=\"Read\"\n export function read(): number {\n const ser = device();\n if (ser)\n return ser.serialDevice.read();\n else return DAL.DEVICE_NOT_SUPPORTED;\n }\n\n /**\n * Read the buffered received data as a buffer\n */\n //% help=serial/read-buffer\n //% blockId=serial_read_buffer block=\"serial|read buffer\"\n //% weight=17\n //% group=\"Read\"\n export function readBuffer(): Buffer {\n const ser = device();\n if (ser)\n return ser.serialDevice.readBuffer();\n else\n return control.createBuffer(0);\n }\n\n\n /**\n * Send a buffer across the serial connection.\n */\n //% help=serial/write-buffer weight=6\n //% blockId=serial_writebuffer block=\"serial|write buffer %buffer\"\n //% group=\"Write\"\n export function writeBuffer(buffer: Buffer) {\n const ser = device();\n if (ser)\n ser.serialDevice.writeBuffer(buffer);\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\"\n export function setBaudRate(rate: BaudRate) {\n const ser = device();\n if (ser)\n ser.serialDevice.setBaudRate(rate);\n }\n\n /**\n Send console messages through the TX, RX pins\n **/\n //% blockId=serialsendtoconsole block=\"serial attach to console\"\n //% group=\"Configuration\"\n //% help=serial/attach-to-console\n export function attachToConsole() {\n console.addListener(logListener)\n }\n\n function logListener(priority: ConsolePriority, text: string) {\n switch (priority) {\n case ConsolePriority.Debug: writeString(\"dbg> \"); break;\n case ConsolePriority.Error: writeString(\"err> \"); break;\n case ConsolePriority.Warning: writeString(\"wrn> \"); break;\n }\n writeLine(text);\n }\n\n\n /**\n * Registers code when serial events happen\n **/\n //% weight=9\n //% help=serial/on-event\n //% blockId=serial_onevent block=\"serial on %event\"\n //% blockGap=8\n //% group=\"Events\"\n export function onEvent(event: SerialEvent, handler: () => void) {\n const ser = device();\n if (ser)\n ser.serialDevice.onEvent(event, handler);\n }\n\n /**\n * Registers code when a delimiter is received\n **/\n //% weight=10\n //% help=serial/on-delimiter-received\n //% blockId=serial_ondelimiter block=\"serial on delimiter $delimiter received\"\n //% blockGap=8\n //% group=\"Events\"\n export function onDelimiterReceived(delimiter: Delimiters, handler: () => void) {\n const ser = device();\n if (ser)\n ser.serialDevice.onDelimiterReceived(delimiter, handler);\n }\n\n /**\n * Return the corresponding delimiter string\n */\n //% blockId=\"serial_delimiter_conv\" block=\"%del\"\n //% weight=1 blockHidden=true hidden=true\n export function delimiters(del: Delimiters): string {\n return String.fromCharCode(del as number);\n }\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace serial {\n\n /**\n * Opens a Serial communication driver\n */\n //% shim=serial::internalCreateSerialDevice\n function internalCreateSerialDevice(tx: DigitalInOutPin, rx: DigitalInOutPin, id: int32): SerialDevice;\n}\n\n\ndeclare interface SerialDevice {\n /**\n */\n //% shim=SerialDeviceMethods::redirect\n redirect(tx: DigitalInOutPin, rx: DigitalInOutPin, rate: BaudRate): void;\n}\n\n\ndeclare interface SerialDevice {\n /**\n * Sets the size of the RX buffer in bytes\n */\n //% shim=SerialDeviceMethods::setRxBufferSize\n setRxBufferSize(size: uint8): void;\n\n /**\n * Sets the size of the TX buffer in bytes\n */\n //% shim=SerialDeviceMethods::setTxBufferSize\n setTxBufferSize(size: uint8): void;\n\n /**\n Set the baud rate of the serial port\n */\n //% shim=SerialDeviceMethods::setBaudRate\n setBaudRate(rate: BaudRate): void;\n\n /**\n * Reads a single byte from the serial receive buffer. Negative if error, 0 if no data.\n */\n //% shim=SerialDeviceMethods::read\n read(): int32;\n\n /**\n * Read the buffered received data as a buffer\n */\n //% shim=SerialDeviceMethods::readBuffer\n readBuffer(): Buffer;\n\n /**\n * Send a buffer across the serial connection.\n */\n //% shim=SerialDeviceMethods::writeBuffer\n writeBuffer(buffer: Buffer): void;\n\n /**\n * Register code when a serial event occurs\n */\n //% shim=SerialDeviceMethods::onEvent\n onEvent(event: SerialEvent, handler: () => void): void;\n\n /**\n * Registers code when a delimiter is received\n **/\n //% shim=SerialDeviceMethods::onDelimiterReceived\n onDelimiterReceived(delimiter: Delimiters, handler: () => void): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"test.ts": "for(let i = 0; i < 10; ++i) {\n serial.writeLine((++i).toString())\n}"
},
"datalogger": {
"README.md": "# Data logger\n\nA tiny libraty to create CSV log files.",
"datalogger.ts": "enum LogSeparator {\n //% block=\"tab\"\n Tab = 0x09,\n //% block=\"comma\"\n Comma = 0x2c,\n //% block=\"semicolon\"\n Semicolon = 0x3b\n};\n\n/**\n * A tiny data logging framework\n */\n//% weight=80 color=#00a0a0 icon=\"\" blockGap=8\n//% groups='[\"Data\", \"Configuration\"]'\nnamespace datalogger {\n export let SEPARATOR = \"\\t\";\n /**\n * A storage for log data\n */\n export class Storage {\n constructor() {\n }\n /**\n * Initializes the storage\n */\n init(): void { }\n /**\n * Appends the headers in log\n */\n appendHeaders(headers: string[]): void { }\n /**\n * Appends a row of data\n */\n appendRow(values: number[]): void { }\n /**\n * Flushes any buffered data\n */\n flush(): void { }\n }\n\n let _headers: string[] = undefined;\n let _headersWritten: boolean = false;\n let _row: number[] = undefined;\n let _start: number;\n let _storage: Storage;\n let _enabled = true;\n let _samplingInterval = -1;\n let _sampleCount = 0;\n let _lastSampleTime = -1;\n let _console = false;\n\n function clear() {\n _headers = undefined;\n _row = undefined;\n }\n\n function initRow() {\n if (!_storage || _row) return;\n\n if (!_headers) {\n _headers = [];\n _headersWritten = false;\n _start = control.millis();\n _storage.init();\n }\n _row = [];\n _sampleCount = 1;\n _lastSampleTime = control.millis();\n const s = (_lastSampleTime - _start) / 1000;\n addValue(\"time (s)\", s);\n }\n\n function commitRow() {\n // write row if any data\n if (_row && _row.length > 0 && _storage) {\n // write headers for the first row\n if (!_headersWritten) {\n _storage.appendHeaders(_headers);\n if (_console)\n console.log(_headers.slice(1, _headers.length).join(', '));\n _headersWritten = true;\n }\n // commit row data\n if (_samplingInterval <= 0 || control.millis() - _lastSampleTime >= _samplingInterval) {\n // average data\n if (_sampleCount > 1) {\n for(let i = 1; i < _row.length; ++i) {\n _row[i] /= _sampleCount;\n }\n }\n // append row\n _storage.appendRow(_row);\n if (_console) {\n // drop time\n console.log(_row.slice(1, _row.length).join(','));\n }\n // clear values\n _row = undefined;\n _sampleCount = 1;\n _lastSampleTime = -1;\n } else {\n // don't store the data yet\n _sampleCount++;\n }\n }\n }\n\n /**\n * Start a new row of data\n */\n //% group=\"Data\"\n //% weight=100\n //% blockId=datalogAddRow block=\"data logger add row\"\n //% help=datalogger/add-row\n export function addRow(): void {\n if (!_enabled || !_storage) return;\n\n commitRow();\n initRow();\n }\n\n /**\n * Add a named value to the row of data\n * @param name name of the cell, eg: \"x\"\n * @param value value of the cell, eg: 0\n */\n //% group=\"Data\"\n //% weight=99\n //% blockId=datalogAddValue block=\"data logger add %name|=%value\"\n //% blockGap=12\n //% help=datalogger/add-value\n export function addValue(name: string, value: number) {\n if (!_row) return;\n // happy path\n if (_headers[_row.length] === name)\n _row.push(value);\n else {\n let i = _headers.indexOf(name);\n if (i < 0) {\n _headers.push(name);\n i = _headers.length - 1;\n }\n _row[i] += value;\n }\n }\n\n /**\n * \n * @param storage custom storage solution\n */\n //%\n export function setStorage(storage: Storage) {\n flush();\n _storage = storage;\n clear();\n }\n\n /**\n * Commits any buffered row to disk\n */\n //%\n export function flush() {\n if (_headers && _storage)\n _storage.flush();\n }\n\n /**\n * Set the minimum number of milliseconds between rows\n * @param millis milliseconds between each sample, eg: 50\n */\n //% group=\"Configuration\"\n //% blockId=datalogSetSamplingInterval block=\"set data logger sampling interval to $millis|(ms)\"\n //% millis.shadow=timePicker\n //% help=datalogger/set-sample-interval\n export function setSampleInterval(millis: number) {\n _samplingInterval = millis >> 0;\n }\n\n /**\n * Turn on or off datalogging\n * @param enabled \n */\n //% group=\"Configuration\"\n //% blockId=datalogEnabled block=\"data logger $enabled\"\n //% enabled.shadow=toggleOnOff\n //% help=datalogger/set-enabled\n export function setEnabled(enabled: boolean) {\n flush();\n _enabled = enabled;\n }\n\n /**\n * Send the data logger output to the console\n * @param enabled \n */\n //% group=\"Configuration\"\n //% blockId=\"datalogConsole\" block=\"data logger to console $enabled\"\n //% enabled.shadow=toggleOnOff\n //% help=datalogger/send-to-console\n export function sendToConsole(enabled: boolean) {\n _console = enabled;\n }\n\n /**\n * Set the character used to separate values in a row.\n * @param separator the value separator character, eg: \"\\t\"\n */\n //% group=\"Configuration\"\n //% blockId=\"datalogSeparator\" block=\"data logger set separator $separator\"\n //% help=datalogger/set-separator\n export function setSeparator(separator: LogSeparator) {\n if (!_enabled) {\n SEPARATOR = String.fromCharCode(separator);\n }\n }\n}\n",
"pxt.json": "{\n \"name\": \"datalogger\",\n \"description\": \"Tiny data logging framework\",\n \"dependencies\": {\n \"core\": \"*\",\n \"storage\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"datalogger.ts\",\n \"storagedatalogger.ts\",\n \"targetoverrides.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"icon\": \"/static/libs/datalogger.png\"\n}\n",
"storagedatalogger.ts": "namespace datalogger {\n const FILENAME = \"datalog.csv\";\n /**\n * A storage for datalog data\n */\n export class FileStorage extends Storage {\n filename: string;\n constructor(filename: string) {\n super()\n this.filename = filename;\n }\n /**\n * Initializes the storage\n */\n init(): void { \n\n }\n /**\n * Appends the headers in datalog\n */\n appendHeaders(headers: string[]): void {\n // skip this step if file already exists\n if (storage.exists(this.filename))\n return;\n const line = headers.join(datalogger.SEPARATOR);\n storage.appendLine(this.filename, `sep=${datalogger.SEPARATOR}`);\n storage.appendLine(this.filename, line);\n }\n /**\n * Appends a row of data\n */\n appendRow(values: number[]): void { \n const line = values.join(datalogger.SEPARATOR);\n storage.appendLine(this.filename, line);\n }\n /**\n * Flushes any buffered data\n */\n flush(): void { \n\n }\n }\n}",
"targetoverrides.ts": "// add target specific things here\nnamespace datalogger {\n datalogger.setStorage(new FileStorage(\"log.csv\"));\n}",
"test.ts": "let k = 0;\nforever(function () {\n datalogger.addRow()\n datalogger.addValue(\"x\", k)\n datalogger.addValue(\"y\", 1 / k)\n})\n"
},
"lightsensor": {
"README.md": "# lightsensor\n\nThe lightsensor library.\n\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum LightCondition {\n //% block=\"dark\"\n Dark = 1, // SENSOR_THRESHOLD_LOW\n //% block=\"bright\"\n Bright = 2, // SENSOR_THRESHOLD_HIGH\n }\n\n// Auto-generated. Do not edit. Really.\n",
"lightsensor.cpp": "#include \"pxt.h\"\n#include \"AnalogSensor.h\"\n\n#ifdef CODAL_LIGHT_SENSOR_HEADER\n#include CODAL_LIGHT_SENSOR_HEADER\n#endif\n\n\n#ifndef CODAL_LIGHT_SENSOR\n#define CODAL_LIGHT_SENSOR AnalogSensor\n#endif\n\n#ifndef LIGHTSENSOR_SENSITIVITY\n#define LIGHTSENSOR_SENSITIVITY 868 // codal has 912 now\n#endif\n\n#ifndef LIGHTSENSOR_LOW_THRESHOLD\n#define LIGHTSENSOR_LOW_THRESHOLD 128\n#endif\n\n#ifndef LIGHTSENSOR_HIGH_THRESHOLD\n#define LIGHTSENSOR_HIGH_THRESHOLD 896\n#endif\n\nenum class LightCondition {\n //% block=\"dark\"\n Dark = SENSOR_THRESHOLD_LOW,\n //% block=\"bright\"\n Bright = SENSOR_THRESHOLD_HIGH\n};\n\nnamespace pxt {\n\nclass WLight {\n public:\n CODAL_LIGHT_SENSOR sensor;\n WLight()\n : sensor(*LOOKUP_PIN(LIGHT), DEVICE_ID_LIGHT_SENSOR) //\n {\n sensor.init();\n sensor.setPeriod(50);\n sensor.setSensitivity(LIGHTSENSOR_SENSITIVITY); \n sensor.setLowThreshold(LIGHTSENSOR_LOW_THRESHOLD);\n sensor.setHighThreshold(LIGHTSENSOR_HIGH_THRESHOLD);\n }\n};\nSINGLETON_IF_PIN(WLight, LIGHT);\n\n}\n\nnamespace input {\n\n/**\n* Register an event that runs when light conditions (darker or brighter) change.\n* @param condition the condition that event triggers on\n*/\n//% help=input/on-light-condition-changed\n//% blockId=input_on_light_condition_changed block=\"on light %condition\"\n//% parts=\"lightsensor\"\n//% weight=84 blockGap=12\nvoid onLightConditionChanged(LightCondition condition, Action handler) {\n auto wlight = getWLight();\n if (NULL == wlight) return; \n auto sensor = wlight->sensor;\n\n sensor.updateSample();\n registerWithDal(sensor.id, (int)condition, handler);\n}\n\n/**\n * Read the light level applied to the LED screen in a range from 0 (dark) to 255 (bright).\n */\n//% help=input/light-level\n//% blockId=device_get_light_level block=\"light level\"\n//% parts=\"lightsensor\"\n//% weight=30 blockGap=8\nint lightLevel() {\n auto wlight = getWLight();\n if (NULL == wlight) return 127;\n auto sensor = wlight->sensor;\n // 0...1023\n int value = sensor.getValue();\n return value / 4;\n}\n\n/**\n* Set the threshold value for the light condition event.\n*/\n//% help=input/set-light-threshold\n//% blockId=lightsensor_set_threshold block=\"set %condition| light threshold to %value\"\n//% parts=\"lightsensor\"\n//% value.min=1 value.max=255\n//% group=\"More\" weight=13 blockGap=8\nvoid setLightThreshold(LightCondition condition, int value) {\n auto wlight = getWLight();\n if (NULL == wlight) return;\n auto sensor = wlight->sensor;\n\n int v = value * 4;\n if (condition == LightCondition::Dark)\n sensor.setLowThreshold(v);\n else\n sensor.setHighThreshold(v);\n}\n}\n",
"ns.ts": "\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\nnamespace input {\n}",
"pxt.json": "{\n \"name\": \"lightsensor\",\n \"description\": \"Onboard light level sensor\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"lightsensor.cpp\",\n \"ns.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace input {\n\n /**\n * Register an event that runs when light conditions (darker or brighter) change.\n * @param condition the condition that event triggers on\n */\n //% help=input/on-light-condition-changed\n //% blockId=input_on_light_condition_changed block=\"on light %condition\"\n //% parts=\"lightsensor\"\n //% weight=84 blockGap=12 shim=input::onLightConditionChanged\n function onLightConditionChanged(condition: LightCondition, handler: () => void): void;\n\n /**\n * Read the light level applied to the LED screen in a range from 0 (dark) to 255 (bright).\n */\n //% help=input/light-level\n //% blockId=device_get_light_level block=\"light level\"\n //% parts=\"lightsensor\"\n //% weight=30 blockGap=8 shim=input::lightLevel\n function lightLevel(): int32;\n\n /**\n * Set the threshold value for the light condition event.\n */\n //% help=input/set-light-threshold\n //% blockId=lightsensor_set_threshold block=\"set %condition| light threshold to %value\"\n //% parts=\"lightsensor\"\n //% value.min=1 value.max=255\n //% group=\"More\" weight=13 blockGap=8 shim=input::setLightThreshold\n function setLightThreshold(condition: LightCondition, value: int32): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"test.ts": "for(let i = 0; i < 100; ++i) {\n pause(500)\n console.log(`light=${input.lightLevel()}`);\n}"
},
"thermometer": {
"README.md": "# temperature\n\nThe temperature library.\n\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum TemperatureCondition {\n //% block=\"hot\"\n Hot = 2, // SENSOR_THRESHOLD_HIGH\n //% block=\"cold\"\n Cold = 1, // SENSOR_THRESHOLD_LOW\n }\n\n\n declare const enum TemperatureUnit {\n //% block=\"°C\"\n Celsius = 0,\n //% block=\"°F\"\n Fahrenheit = 1,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"ns.ts": "\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\nnamespace input {\n}",
"pxt.json": "{\n \"name\": \"thermometer\",\n \"description\": \"A thermometer driver\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"temperature.cpp\",\n \"target_temperature.h\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"ns.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace input {\n\n /**\n * Run some code when the temperature changes from hot to cold, or from cold to hot.\n * @param condition the condition, hot or cold, the event triggers on\n * @param temperature the temperature at which this event happens, eg: 15\n * @param unit the unit of the temperature\n */\n //% blockId=input_on_temperature_condition_changed block=\"on temperature %condition|at %temperature|%unit\"\n //% parts=\"thermometer\"\n //% help=input/on-temperature-condition-changed blockExternalInputs=0\n //% group=\"More\" weight=76 shim=input::onTemperatureConditionChanged\n function onTemperatureConditionChanged(condition: TemperatureCondition, temperature: int32, unit: TemperatureUnit, handler: () => void): void;\n\n /**\n * Get the temperature in Celsius or Fahrenheit degrees.\n */\n //% help=input/temperature\n //% blockId=device_temperature block=\"temperature in %unit\"\n //% parts=\"thermometer\"\n //% weight=26 shim=input::temperature\n function temperature(unit: TemperatureUnit): int32;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"target_temperature.h": "#include \"NonLinearAnalogSensor.h\"\n\n/*\n * @param nominalValue The value (in SI units) of a nominal position.\n * @param nominalReading The raw reading from the sensor at the nominal position.\n * @param beta The Steinhart-Hart Beta constant for the device\n * @param seriesResistor The value (in ohms) of the resistor in series with the sensor.\n * @param zeroOffset Optional zero offset applied to all SI units (e.g. 273.15 for temperature\n * sensing in C vs Kelvin).\n */\n\n#ifndef TEMPERATURE_NOMINAL_VALUE\n#define TEMPERATURE_NOMINAL_VALUE 25\n#endif\n\n#ifndef TEMPERATURE_NOMINAL_READING\n#define TEMPERATURE_NOMINAL_READING 10000\n#endif\n\n#ifndef TEMPERATURE_BETA\n#define TEMPERATURE_BETA 3380\n#endif\n\n#ifndef TEMPERATURE_SERIES_RESISTOR\n#define TEMPERATURE_SERIES_RESISTOR 10000\n#endif\n\n#ifndef TEMPERATURE_ZERO_OFFSET\n#define TEMPERATURE_ZERO_OFFSET 273.5\n#endif\n\nnamespace pxt {\nclass WTemp {\n public:\n NonLinearAnalogSensor sensor;\n WTemp()\n : sensor(*LOOKUP_PIN(TEMPERATURE), DEVICE_ID_THERMOMETER,\n TEMPERATURE_NOMINAL_VALUE, \n TEMPERATURE_NOMINAL_READING, \n TEMPERATURE_BETA, \n TEMPERATURE_SERIES_RESISTOR,\n TEMPERATURE_ZERO_OFFSET)\n {\n sensor.init();\n }\n};\n}",
"temperature.cpp": "#include \"pxt.h\"\n#include \"target_temperature.h\"\n\nenum class TemperatureCondition {\n //% block=\"hot\"\n Hot = SENSOR_THRESHOLD_HIGH,\n //% block=\"cold\"\n Cold = SENSOR_THRESHOLD_LOW\n};\n\nenum class TemperatureUnit {\n //% block=\"°C\"\n Celsius,\n //% block=\"°F\"\n Fahrenheit\n};\n\nnamespace pxt {\nSINGLETON_IF_PIN(WTemp, TEMPERATURE);\n}\n\nnamespace input {\n\n/**\n* Run some code when the temperature changes from hot to cold, or from cold to hot.\n* @param condition the condition, hot or cold, the event triggers on\n* @param temperature the temperature at which this event happens, eg: 15\n* @param unit the unit of the temperature\n*/\n//% blockId=input_on_temperature_condition_changed block=\"on temperature %condition|at %temperature|%unit\"\n//% parts=\"thermometer\"\n//% help=input/on-temperature-condition-changed blockExternalInputs=0\n//% group=\"More\" weight=76\nvoid onTemperatureConditionChanged(TemperatureCondition condition, int temperature, TemperatureUnit unit, Action handler) {\n auto thermo = getWTemp();\n if (!thermo) return;\n\n auto sensor = &thermo->sensor;\n sensor->updateSample();\n\n int t = unit == TemperatureUnit::Celsius ? temperature : ((temperature - 32) * 10) / 18;\n\n if (condition == TemperatureCondition::Cold)\n sensor->setLowThreshold(t);\n else\n sensor->setHighThreshold(t);\n registerWithDal(sensor->id, (int)condition, handler);\n}\n\n/**\n * Get the temperature in Celsius or Fahrenheit degrees.\n */\n//% help=input/temperature\n//% blockId=device_temperature block=\"temperature in %unit\"\n//% parts=\"thermometer\"\n//% weight=26\nint temperature(TemperatureUnit unit) {\n auto thermo = getWTemp();\n // default to 21 if not present\n int value = (NULL != thermo) ? thermo->sensor.getValue() : 21;\n if (unit == TemperatureUnit::Celsius) return value;\n else return (value * 18) / 10 + 32;\n}\n}\n",
"test.ts": ""
},
"switch": {
"README.md": "# switch\n\nThe build-in slide switch library.\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum SwitchDirection {\n //% block=\"left\"\n Left = 2, // DEVICE_BUTTON_EVT_UP\n //% block=\"right\"\n Right = 1, // DEVICE_BUTTON_EVT_DOWN\n }\n\n// Auto-generated. Do not edit. Really.\n",
"ns.ts": "//% color=\"#d65cd6\"\nnamespace input {\n}\n",
"pxt.json": "{\n \"name\": \"switch\",\n \"description\": \"A slide switch\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"switch.cpp\",\n \"ns.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace input {\n\n /**\n * Do something when the slide switch is moved left or right.\n * @param direction the direction the switch must be moved to trigger the event\n */\n //% help=input/on-switch-moved\n //% blockId=device_on_switch_moved block=\"on switch moved %direction\"\n //% parts=\"switch\"\n //% weight=80 shim=input::onSwitchMoved\n function onSwitchMoved(direction: SwitchDirection, handler: () => void): void;\n\n /**\n * Gets a value indicating if the switch is positioned to the right\n */\n //% blockId=device_switch_direction block=\"switch right\"\n //% parts=\"switch\"\n //% group=\"Switch\" weight=10 blockGap=8 shim=input::switchRight\n function switchRight(): boolean;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"switch.cpp": "#include \"pxt.h\"\n#include \"Button.h\"\n#include \"pins.h\"\n\nenum class SwitchDirection {\n //% block=\"left\"\n Left = DEVICE_BUTTON_EVT_UP,\n //% block=\"right\"\n Right = DEVICE_BUTTON_EVT_DOWN\n};\n\nnamespace pxt {\n\n// Wrapper classes\nclass WSwitch {\n public:\n Button slideSwitch;\n\n WSwitch()\n : slideSwitch(*LOOKUP_PIN(BTN_SLIDE), DEVICE_ID_BUTTON_SLIDE,\n DEVICE_BUTTON_SIMPLE_EVENTS, ACTIVE_LOW, PullMode::Up) {}\n};\nSINGLETON(WSwitch);\n\n}\n\nnamespace input {\n/**\n* Do something when the slide switch is moved left or right.\n* @param direction the direction the switch must be moved to trigger the event\n*/\n//% help=input/on-switch-moved\n//% blockId=device_on_switch_moved block=\"on switch moved %direction\"\n//% parts=\"switch\"\n//% weight=80\nvoid onSwitchMoved(SwitchDirection direction, Action handler) {\n registerWithDal(getWSwitch()->slideSwitch.id, (int)direction, handler);\n}\n\n/**\n* Gets a value indicating if the switch is positioned to the right\n*/\n//% blockId=device_switch_direction block=\"switch right\"\n//% parts=\"switch\"\n//% group=\"Switch\" weight=10 blockGap=8\nbool switchRight() {\n auto slide = getWSwitch();\n return slide->slideSwitch.isPressed();\n}\n\n}\n"
},
"accelerometer": {
"README.md": "# accelerometer\n\nThe accelerometer library.\n\n",
"accelerometer.cpp": "#include \"pxt.h\"\n#include \"axis.h\"\n#include \"Pin.h\"\n#include \"I2C.h\"\n#include \"CoordinateSystem.h\"\n#include \"Accelerometer.h\"\n\nenum class Dimension {\n //% block=x\n X = 0,\n //% block=y\n Y = 1,\n //% block=z\n Z = 2,\n //% block=strength\n Strength = 3,\n};\n\nenum class Rotation {\n //% block=pitch\n Pitch = 0,\n //% block=roll\n Roll = 1,\n};\n\nenum class AcceleratorRange {\n /**\n * The accelerator measures forces up to 1 gravity\n */\n //% block=\"1g\"\n OneG = 1,\n /**\n * The accelerator measures forces up to 2 gravity\n */\n //% block=\"2g\"\n TwoG = 2,\n /**\n * The accelerator measures forces up to 4 gravity\n */\n //% block=\"4g\"\n FourG = 4,\n /**\n * The accelerator measures forces up to 8 gravity\n */\n //% block=\"8g\"\n EightG = 8\n};\n\nenum class Gesture {\n /**\n * Raised when shaken\n */\n //% block=shake\n Shake = ACCELEROMETER_EVT_SHAKE,\n /**\n * Raised when the device tilts up\n */\n //% block=\"tilt up\"\n TiltUp = ACCELEROMETER_EVT_TILT_UP,\n /**\n * Raised when the device tilts down\n */\n //% block=\"tilt down\"\n TiltDown = ACCELEROMETER_EVT_TILT_DOWN,\n /**\n * Raised when the screen is pointing left\n */\n //% block=\"tilt left\"\n TiltLeft = ACCELEROMETER_EVT_TILT_LEFT,\n /**\n * Raised when the screen is pointing right\n */\n //% block=\"tilt right\"\n TiltRight = ACCELEROMETER_EVT_TILT_RIGHT,\n /**\n * Raised when the screen faces up\n */\n //% block=\"face up\"\n FaceUp = ACCELEROMETER_EVT_FACE_UP,\n /**\n * Raised when the screen is pointing up and the board is horizontal\n */\n //% block=\"face down\"\n FaceDown = ACCELEROMETER_EVT_FACE_DOWN,\n /**\n * Raised when the board is falling!\n */\n //% block=\"free fall\"\n FreeFall = ACCELEROMETER_EVT_FREEFALL,\n /**\n * Raised when a 2G shock is detected\n */\n //% block=\"2g (step)\"\n TwoG = ACCELEROMETER_EVT_2G,\n /**\n * Raised when a 3G shock is detected\n */\n //% block=\"3g\"\n ThreeG = ACCELEROMETER_EVT_3G,\n /**\n * Raised when a 6G shock is detected\n */\n //% block=\"6g\"\n SixG = ACCELEROMETER_EVT_6G,\n /**\n * Raised when a 8G shock is detected\n */\n //% block=\"8g\"\n EightG = ACCELEROMETER_EVT_8G\n};\n\n// defined in accelhw.cpp\nnamespace pxt {\ncodal::Accelerometer *getAccelerometer();\n\nvoid initAccelRandom() {\n auto acc = getAccelerometer();\n if (!acc) return;\n\n for (int i = 0; i < 10; ++i) {\n acc->requestUpdate();\n if (acc->getY())\n break;\n fiber_sleep(5);\n }\n int x = acc->getX(), y = acc->getY(), z = acc->getZ();\n DMESG(\"random seed from accel %d,%d,%d\", x, y, z);\n seedAddRandom(x);\n seedAddRandom(y);\n seedAddRandom(z);\n}\n\n} // namespace pxt\n\nnamespace input {\n/**\n * Do something when a gesture happens (like shaking the board).\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\n//% blockId=device_gesture_event block=\"on |%NAME\"\n//% parts=\"accelerometer\"\n//% gesture.fieldEditor=\"gridpicker\"\n//% gesture.fieldOptions.width=220\n//% gesture.fieldOptions.columns=3\n//% weight=92 blockGap=12\nvoid onGesture(Gesture gesture, Action body) {\n auto acc = getAccelerometer();\n if (!acc) return;\n\n acc->requestUpdate();\n int gi = (int)gesture;\n if (gi == ACCELEROMETER_EVT_3G && acc->getRange() < 3)\n acc->setRange(4);\n else if ((gi == ACCELEROMETER_EVT_6G || gi == ACCELEROMETER_EVT_8G) && acc->getRange() < 6)\n acc->setRange(8);\n registerWithDal(DEVICE_ID_GESTURE, gi, body);\n}\n\n/**\n * Get the acceleration value in milli-gravitys (when the board is laying flat with the screen up,\n * x=0, y=0 and z=-1023)\n * @param dimension TODO\n */\n//% help=input/acceleration\n//% blockId=device_acceleration block=\"acceleration (mg)|%NAME\"\n//% parts=\"accelerometer\"\n//% dimension.fieldEditor=\"gridpicker\"\n//% dimension.fieldOptions.width=180\n//% dimension.fieldOptions.columns=2\n//% weight=42 blockGap=8\nint acceleration(Dimension dimension) {\n auto acc = getAccelerometer();\n if (!acc) return 0;\n\n acc->requestUpdate();\n switch (dimension) {\n case Dimension::X:\n return acc->getX();\n case Dimension::Y:\n return acc->getY();\n case Dimension::Z:\n return acc->getZ();\n case Dimension::Strength:\n float x = acc->getX();\n float y = acc->getY();\n float z = acc->getZ();\n return (int)sqrtf(x * x + y * y + z * z);\n }\n return 0;\n}\n\n/**\n * The pitch or roll of the device, rotation along the ``x-axis`` or ``y-axis``, in degrees.\n * @param kind TODO\n */\n//% help=input/rotation\n//% blockId=device_get_rotation block=\"rotation (°)|%NAME\"\n//% parts=\"accelerometer\"\n//% group=\"More\" weight=38\nint rotation(Rotation kind) {\n auto acc = getAccelerometer();\n if (!acc) return 0;\n\n acc->requestUpdate();\n switch (kind) {\n case Rotation::Pitch:\n return acc->getPitch();\n case Rotation::Roll:\n return acc->getRoll();\n }\n return 0;\n}\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//% group=\"More\" weight=15 blockGap=8\nvoid setAccelerometerRange(AcceleratorRange range) {\n auto acc = getAccelerometer();\n if (!acc) return;\n\n acc->setRange((int)range);\n}\n\n} // namespace input\n",
"accelhw.cpp": "// This supports a few different accelerometers.\n// If desired, overrides PXT_SUPPORT_* in platform.h (note that only LIS3DH is on by default).\n// Then accelerometer can be changed with config.ACCELEROMETER_TYPE in TypeScript.\n// This file can be overridden alltogether by a target if a different accelerometer is desired.\n\n#include \"pxt.h\"\n#include \"axis.h\"\n#include \"Pin.h\"\n#include \"I2C.h\"\n#include \"CoordinateSystem.h\"\n#include \"CodalDmesg.h\"\n\n#ifndef PXT_DEFAULT_ACCELEROMETER\n#define PXT_DEFAULT_ACCELEROMETER -1\n#endif\n\n#ifndef PXT_SUPPORT_LIS3DH\n#define PXT_SUPPORT_LIS3DH 1\n#endif\n#if PXT_SUPPORT_LIS3DH\n#include \"LIS3DH.h\"\n#endif\n\n#ifndef PXT_SUPPORT_MMA8653\n#define PXT_SUPPORT_MMA8653 0\n#endif\n#if PXT_SUPPORT_MMA8653\n#include \"MMA8653.h\"\n#endif\n\n#ifndef PXT_SUPPORT_MMA8453\n#define PXT_SUPPORT_MMA8453 0\n#endif\n#if PXT_SUPPORT_MMA8453\n#include \"MMA8453.h\"\n#endif\n\n#ifndef PXT_SUPPORT_FXOS8700\n#define PXT_SUPPORT_FXOS8700 0\n#endif\n#if PXT_SUPPORT_FXOS8700\n#include \"FXOS8700Accelerometer.h\"\n#endif\n\n#ifndef PXT_SUPPORT_MSA300\n#define PXT_SUPPORT_MSA300 0\n#endif\n#if PXT_SUPPORT_MSA300\n#include \"MSA300.h\"\n#endif\n\n#ifndef PXT_SUPPORT_MPU6050\n#define PXT_SUPPORT_MPU6050 0\n#endif\n#if PXT_SUPPORT_MPU6050\n#include \"MPU6050.h\"\n#endif\n\n#if defined(CODAL_ACCELEROMETER)\n#error \"please define PXT_SUPPORT_*\"\n#endif\n\nnamespace pxt {\n\n /*\nRAW, 0x000000\nSIMPLE_CARTESIAN, 0x000001\nNORTH_EAST_DOWN, 0x000002\nNORTH_EAST_UP 0x000003\n\nCOORDINATE_SPACE_ROTATED_0 0x000000\nCOORDINATE_SPACE_ROTATED_90 0x000010\nCOORDINATE_SPACE_ROTATED_180 0x000020\nCOORDINATE_SPACE_ROTATED_270 0x000030\n\nNOT_UPSIDE_DOWN 0x000000\nUPSIDE_DOWN 0x000100\n */\n\nstatic CoordinateSpace boardCoordinateSpace() {\n int defaultSpace = ((int)ACC_SYSTEM) | ((int)ACC_ROTATION << 4) | (ACC_UPSIDEDOWN ? 0x100 : 0x000);\n#if defined(STM32F4) && PXT_SUPPORT_MPU6050\n // meowbit\n if (getConfig(CFG_ACCELEROMETER_TYPE, -1) == ACCELEROMETER_TYPE_MPU6050)\n defaultSpace = 0x33;\n#endif\n int space = getConfig(CFG_ACCELEROMETER_SPACE, defaultSpace);\n DMESG(\"coordinate space: %d / %d, %s\", space & 0xf, (space >> 4) & 0xf, space & 0x100 ? \"upside\" : \"normal\");\n return CoordinateSpace((CoordinateSystem)(space & 0xf), !!(space & 0x100), (space >> 4) & 0xf);\n}\n\n// Wrapper classes\nclass WAccel {\n CoordinateSpace space;\n\t\t\n public:\n Accelerometer *acc;\n WAccel() \n : space(boardCoordinateSpace())\n , acc(NULL) {\n DMESG(\"acc: mounting\");\n auto sda = LOOKUP_PIN(ACCELEROMETER_SDA);\n auto scl = LOOKUP_PIN(ACCELEROMETER_SCL);\n if (NULL == sda || NULL == scl) { // use default i2c instead\n DMESG(\"acc: using SDA, SCL\");\n sda = LOOKUP_PIN(SDA);\n scl = LOOKUP_PIN(SCL);\n }\n codal::I2C* i2c = pxt::getI2C(sda, scl);\n if (NULL == i2c) {\n DMESG(\"acc: no i2c available\");\n return;\n }\n\t\t\n int accType = getConfig(CFG_ACCELEROMETER_TYPE, PXT_DEFAULT_ACCELEROMETER);\n acc = instantiateAccelerometer(accType, i2c);\n if (NULL == acc) {\n int accDetect = detectAccelerometer(i2c);\n if (accDetect < 0) {\n DMESG(\"acc: not detected\");\n } else {\n DMESG(\"acc: detected %d\", accDetect);\n acc = instantiateAccelerometer(accDetect, i2c);\n }\n }\n\n if (NULL == acc) {\n // the accelerometer might be damaged or incorrectly configured,\n // in doubt, we just ignore it \n if (LOOKUP_PIN(ACCELEROMETER_SDA))\n DMESG(\"acc: damaged accelereomter or invalid ACCELEROMETER_TYPE\");\n else\n DMESG(\"acc: invalid ACCELEROMETER_TYPE\");\n // acc is already NULL, do nothing\n }\n else {\n // acc->init(); - doesn't do anything\n acc->configure();\n acc->requestUpdate();\n DMESG(\"acc: mounted\");\n }\n }\n\nprivate:\n\n\tint detectAccelerometer(codal::I2C* i2c){\n\t\tuint8_t data;\n\t\tint result;\n\n#if PXT_SUPPORT_LIS3DH\n\t\tresult = i2c->readRegister(ACCELEROMETER_TYPE_LIS3DH, LIS3DH_WHOAMI, &data, 1);\n\t\tif (result ==0)\n\t\t\treturn ACCELEROMETER_TYPE_LIS3DH;\n\t\tresult = i2c->readRegister(ACCELEROMETER_TYPE_LIS3DH_ALT, LIS3DH_WHOAMI, &data, 1);\n\t\tif (result ==0)\n\t\t\treturn ACCELEROMETER_TYPE_LIS3DH_ALT;\n#endif\n\t\t\t\n#if PXT_SUPPORT_MMA8453\n\t\tresult = i2c->readRegister(ACCELEROMETER_TYPE_MMA8453, MMA8653_WHOAMI/*MMA8453 is similar to MMA8653*/ , &data, 1);\n\t\tif (result ==0)\n\t\t\treturn ACCELEROMETER_TYPE_MMA8453;\n#endif\n\n#if PXT_SUPPORT_FXOS8700\n\t\tresult = i2c->readRegister(ACCELEROMETER_TYPE_FXOS8700, FXOS8700_WHO_AM_I, &data, 1);\n\t\tif (result ==0)\n\t\t\treturn ACCELEROMETER_TYPE_FXOS8700;\n#endif\n\t\t\n#if PXT_SUPPORT_MMA8653\n\t\tresult = i2c->readRegister(ACCELEROMETER_TYPE_MMA8653, MMA8653_WHOAMI, &data, 1);\n\t\tif (result ==0)\n\t\t\treturn ACCELEROMETER_TYPE_MMA8653;\t\n#endif\n\t\t\n#if PXT_SUPPORT_MSA300\n\t\tresult = i2c->readRegister(ACCELEROMETER_TYPE_MSA300, MSA300_WHOAMI, &data, 1);\n\t\tif (result ==0)\n\t\t\treturn ACCELEROMETER_TYPE_MSA300;\t\n#endif\n\t\t\t\n#if PXT_SUPPORT_MPU6050\n\t\tresult = i2c->readRegister(ACCELEROMETER_TYPE_MPU6050, MPU6050_WHOAMI, &data, 1);\n\t\tif (result ==0)\n\t\t\treturn ACCELEROMETER_TYPE_MPU6050;\t\n#endif \n\n\t\treturn -1;\n\t}\n\n codal::Accelerometer* instantiateAccelerometer(int accType, codal::I2C* i2c) {\n switch (accType) {\n#if PXT_SUPPORT_LIS3DH\n case ACCELEROMETER_TYPE_LIS3DH:\n case ACCELEROMETER_TYPE_LIS3DH_ALT:\n return new LIS3DH(*i2c, *LOOKUP_PIN(ACCELEROMETER_INT), space, accType);\n#endif\n#if PXT_SUPPORT_MSA300\n case ACCELEROMETER_TYPE_MSA300:\n return new MSA300(*i2c, *LOOKUP_PIN(ACCELEROMETER_INT), space);\n#endif\n#if PXT_SUPPORT_FXOS8700\n case ACCELEROMETER_TYPE_FXOS8700: {\n // TODO: singleton when exposing gyro\n auto fox = new FXOS8700(*i2c, *LOOKUP_PIN(ACCELEROMETER_INT));\n return new FXOS8700Accelerometer(*fox, space);\n }\n#endif\n#if PXT_SUPPORT_MMA8653\n case ACCELEROMETER_TYPE_MMA8653:\n return new MMA8653(*i2c, *LOOKUP_PIN(ACCELEROMETER_INT), space);\n#endif\n#if PXT_SUPPORT_MMA8453\n case ACCELEROMETER_TYPE_MMA8453:\n return new MMA8453(*i2c, *LOOKUP_PIN(ACCELEROMETER_INT), space);\n#endif\n#if PXT_SUPPORT_MPU6050\n case ACCELEROMETER_TYPE_MPU6050:\n return new MPU6050(*i2c, *LOOKUP_PIN(ACCELEROMETER_INT), space);\n#endif\n default:\n return NULL;\n }\n }\n\n};\n\nstatic WAccel *instAcc;\ncodal::Accelerometer *getAccelerometer() {\n if (instAcc)\n return instAcc->acc;\n if (LOOKUP_PIN(ACCELEROMETER_INT) || LOOKUP_PIN(ACCELEROMETER_SDA)) {\n instAcc = new WAccel();\n return instAcc->acc;\n }\n return NULL;\n}\n\n} // namespace pxt\n",
"axis.h": "// Override in target to change inversion of axis\n\n#define ACC_SYSTEM NORTH_EAST_UP\n#define ACC_UPSIDEDOWN false\n#define ACC_ROTATION COORDINATE_SPACE_ROTATED_0\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum Dimension {\n //% block=x\n X = 0,\n //% block=y\n Y = 1,\n //% block=z\n Z = 2,\n //% block=strength\n Strength = 3,\n }\n\n\n declare const enum Rotation {\n //% block=pitch\n Pitch = 0,\n //% block=roll\n Roll = 1,\n }\n\n\n declare const enum AcceleratorRange {\n /**\n * The accelerator measures forces up to 1 gravity\n */\n //% block=\"1g\"\n OneG = 1,\n /**\n * The accelerator measures forces up to 2 gravity\n */\n //% block=\"2g\"\n TwoG = 2,\n /**\n * The accelerator measures forces up to 4 gravity\n */\n //% block=\"4g\"\n FourG = 4,\n /**\n * The accelerator measures forces up to 8 gravity\n */\n //% block=\"8g\"\n EightG = 8,\n }\n\n\n declare const enum Gesture {\n /**\n * Raised when shaken\n */\n //% block=shake\n Shake = 11, // ACCELEROMETER_EVT_SHAKE\n /**\n * Raised when the device tilts up\n */\n //% block=\"tilt up\"\n TiltUp = 1, // ACCELEROMETER_EVT_TILT_UP\n /**\n * Raised when the device tilts down\n */\n //% block=\"tilt down\"\n TiltDown = 2, // ACCELEROMETER_EVT_TILT_DOWN\n /**\n * Raised when the screen is pointing left\n */\n //% block=\"tilt left\"\n TiltLeft = 3, // ACCELEROMETER_EVT_TILT_LEFT\n /**\n * Raised when the screen is pointing right\n */\n //% block=\"tilt right\"\n TiltRight = 4, // ACCELEROMETER_EVT_TILT_RIGHT\n /**\n * Raised when the screen faces up\n */\n //% block=\"face up\"\n FaceUp = 5, // ACCELEROMETER_EVT_FACE_UP\n /**\n * Raised when the screen is pointing up and the board is horizontal\n */\n //% block=\"face down\"\n FaceDown = 6, // ACCELEROMETER_EVT_FACE_DOWN\n /**\n * Raised when the board is falling!\n */\n //% block=\"free fall\"\n FreeFall = 7, // ACCELEROMETER_EVT_FREEFALL\n /**\n * Raised when a 2G shock is detected\n */\n //% block=\"2g (step)\"\n TwoG = 12, // ACCELEROMETER_EVT_2G\n /**\n * Raised when a 3G shock is detected\n */\n //% block=\"3g\"\n ThreeG = 8, // ACCELEROMETER_EVT_3G\n /**\n * Raised when a 6G shock is detected\n */\n //% block=\"6g\"\n SixG = 9, // ACCELEROMETER_EVT_6G\n /**\n * Raised when a 8G shock is detected\n */\n //% block=\"8g\"\n EightG = 10, // ACCELEROMETER_EVT_8G\n }\n\n// Auto-generated. Do not edit. Really.\n",
"gesture.ts": "namespace input {\n /**\n * Registers a custom gesture recognizer\n * @param id \n * @param update true if gesture detected\n * @param handler \n */\n export function onCustomGesture(\n id: number, \n update: () => boolean, \n handler: () => void) {\n if (!update || !handler) return;\n\n input.acceleration(Dimension.X); // turn on accelerometer\n const evid = DAL.ACCELEROMETER_EVT_2G + 1 + (id | 0);\n control.onEvent(DAL.DEVICE_ID_GESTURE, evid, handler);\n let sigma = 0;\n control.onIdle(function() {\n if (sigma > 0) {\n sigma--;\n } else if(update()) {\n sigma = 6;\n control.raiseEvent(DAL.DEVICE_ID_GESTURE, evid);\n }\n })\n }\n}",
"ns.ts": "\n//% color=\"#B4009E\" weight=98 icon=\"\\uf192\"\nnamespace input {\n}",
"part.svg": "\n\n \n \n \n image/svg+xml\n \n \n \n \n \n \n \n \n \n ACCELEROMETER\n \n \n \n \n INT\n \n \n \n SDA\n \n \n \n VCC\n \n \n \n GND\n \n \n \n SCL\n \n \n \n SDO\n \n\n",
"pxt.json": "{\n \"name\": \"accelerometer\",\n \"description\": \"The accelerometer library\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"accelerometer.cpp\",\n \"accelhw.cpp\",\n \"axis.h\",\n \"gesture.ts\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"ns.ts\",\n \"pxtparts.json\",\n \"part.svg\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"yotta\": {\n \"optionalConfig\": {\n \"PXT_SUPPORT_LIS3DH\": 1,\n \"PXT_SUPPORT_MMA8653\": 1,\n \"PXT_SUPPORT_MMA8453\": 1,\n \"PXT_SUPPORT_FXOS8700\": 0,\n \"PXT_SUPPORT_MPU6050\": 1\n },\n \"userConfigs\": [\n {\n \"description\": \"Support for LIS3DH accelerometer.\",\n \"config\": {\n \"PXT_SUPPORT_LIS3DH\": 1\n }\n },\n {\n \"description\": \"Support for MMA8653 accelerometer.\",\n \"config\": {\n \"PXT_SUPPORT_MMA8653\": 1\n }\n },\n {\n \"description\": \"Support for MMA8453 accelerometer.\",\n \"config\": {\n \"PXT_SUPPORT_MMA8453\": 1\n }\n },\n {\n \"description\": \"Support for FXOS8700 accelerometer.\",\n \"config\": {\n \"PXT_SUPPORT_FXOS8700\": 1\n }\n },\n {\n \"description\": \"Support for MPU6050 accelerometer.\",\n \"config\": {\n \"PXT_SUPPORT_MPU6050\": 1\n }\n }\n ]\n },\n \"icon\": \"/static/libs/accelerometer.png\"\n}\n",
"pxtparts.json": "{\n \"accelerometer\": {\n \"visual\": {\n \"image\": \"part.svg\",\n \"width\": 92.83499908447266,\n \"height\": 48.351558685302734,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 6.009125520265597,\n \"y\": 2.705139350474586\n },\n {\n \"x\": 36.0982164424424,\n \"y\": 2.705139350474586\n },\n {\n \"x\": 66.81896669097237,\n \"y\": 2.705139350474586\n },\n {\n \"x\": 81.86351733614008,\n \"y\": 2.705139350474586\n },\n {\n \"x\": 21.053670981354,\n \"y\": 2.705139350474586\n },\n {\n \"x\": 51.31091788377569,\n \"y\": 2.378772674719472\n }\n ]\n },\n \"numberOfPins\": 6,\n \"instantiation\": {\n \"kind\": \"singleton\"\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ACCELEROMETER_INT\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"SDA\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"SCL\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"threeVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"assembly\": [\n {\n \"pinIndices\": [\n 0,\n 1,\n 2,\n 3,\n 4,\n 5\n ]\n }\n ]\n }\n}",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace input {\n\n /**\n * Do something when a gesture happens (like shaking the board).\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\n //% blockId=device_gesture_event block=\"on |%NAME\"\n //% parts=\"accelerometer\"\n //% gesture.fieldEditor=\"gridpicker\"\n //% gesture.fieldOptions.width=220\n //% gesture.fieldOptions.columns=3\n //% weight=92 blockGap=12 shim=input::onGesture\n function onGesture(gesture: Gesture, body: () => void): void;\n\n /**\n * Get the acceleration value in milli-gravitys (when the board is laying flat with the screen up,\n * x=0, y=0 and z=-1023)\n * @param dimension TODO\n */\n //% help=input/acceleration\n //% blockId=device_acceleration block=\"acceleration (mg)|%NAME\"\n //% parts=\"accelerometer\"\n //% dimension.fieldEditor=\"gridpicker\"\n //% dimension.fieldOptions.width=180\n //% dimension.fieldOptions.columns=2\n //% weight=42 blockGap=8 shim=input::acceleration\n function acceleration(dimension: Dimension): int32;\n\n /**\n * The pitch or roll of the device, rotation along the ``x-axis`` or ``y-axis``, in degrees.\n * @param kind TODO\n */\n //% help=input/rotation\n //% blockId=device_get_rotation block=\"rotation (°)|%NAME\"\n //% parts=\"accelerometer\"\n //% group=\"More\" weight=38 shim=input::rotation\n function rotation(kind: Rotation): int32;\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 //% group=\"More\" weight=15 blockGap=8 shim=input::setAccelerometerRange\n function setAccelerometerRange(range: AcceleratorRange): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"test.ts": ""
},
"microphone": {
"README.md": "# microphone\n\nThe microphone library.\n\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare enum LoudnessCondition {\n //% block=\"loud\"\n Loud = 2, // LEVEL_THRESHOLD_HIGH\n //% block=\"quiet\"\n Quiet = 1, // LEVEL_THRESHOLD_LOW\n }\n\n// Auto-generated. Do not edit. Really.\n",
"microphone.cpp": "#include \"pxt.h\"\n#include \"LevelDetector.h\"\n#include \"LevelDetectorSPL.h\"\n\n#define MICROPHONE_MIN 52.0f\n#define MICROPHONE_MAX 120.0f\n\nnamespace pxt {\n codal::LevelDetectorSPL* getMicrophoneLevel();\n}\n\nnamespace input {\n/**\n* Registers an event that runs when a loud sound is detected\n*/\n//% help=input/on-loud-sound\n//% blockId=input_on_loud_sound block=\"on loud sound\"\n//% parts=\"microphone\"\n//% weight=88 blockGap=12\nvoid onLoudSound(Action handler) {\n pxt::getMicrophoneLevel(); // wake up service\n registerWithDal(DEVICE_ID_MICROPHONE, LEVEL_THRESHOLD_HIGH, handler);\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\nint soundLevel() {\n auto level = pxt::getMicrophoneLevel();\n if (NULL == level)\n return MICROPHONE_MIN; \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}\n\n/**\n* Sets the minimum threshold for a loud sound\n*/\n//% help=input/set-loud-sound-threshold\n//% blockId=input_set_loud_sound_threshold block=\"set loud sound threshold %value\"\n//% parts=\"microphone\"\n//% value.min=1 value.max=255\n//% group=\"More\" weight=14 blockGap=8\nvoid setLoudSoundThreshold(int value) {\n auto level = pxt::getMicrophoneLevel();\n if (NULL == level)\n return;\n\n value = max(0, min(0xff, value));\n const int scaled = MICROPHONE_MIN + value * (MICROPHONE_MAX - MICROPHONE_MIN) / 0xff;\n level->setHighThreshold(scaled);\n}\n}",
"microphonehw.cpp": "#include \"pxt.h\"\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",
"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\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"icon\": \"/static/libs/microphone.png\"\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace input {\n\n /**\n * Registers an event that runs when a loud sound is detected\n */\n //% help=input/on-loud-sound\n //% blockId=input_on_loud_sound block=\"on loud sound\"\n //% parts=\"microphone\"\n //% weight=88 blockGap=12 shim=input::onLoudSound\n function onLoudSound(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 shim=input::soundLevel\n function soundLevel(): int32;\n\n /**\n * Sets the minimum threshold for a loud sound\n */\n //% help=input/set-loud-sound-threshold\n //% blockId=input_set_loud_sound_threshold block=\"set loud sound threshold %value\"\n //% parts=\"microphone\"\n //% value.min=1 value.max=255\n //% group=\"More\" weight=14 blockGap=8 shim=input::setLoudSoundThreshold\n function setLoudSoundThreshold(value: int32): void;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"targetoverrides.ts": "// target specific code",
"test.ts": "// tests"
},
"lora": {
"README.md": "# LoRa (beta)\n\nPackage adds support LoRa. Adapted from https://github.com/ElectronicCats/pxt-lora/.\n",
"lora.ts": "// Adapted from https://github.com/ElectronicCats/pxt-lora/\n// https://www.mouser.com/ds/2/761/sx1276-944191.pdf\n\n\n/**\n * Reading data of module lora.\n */\n//% weight=2 color=#002050 icon=\"\\uf09e\"\n//% blockGap=8\n//% groups='[\"Sender\", \"Receiver\", \"Packet\", \"Mode\", \"Configuration\"]'\nnamespace lora {\n export const enum LoRaState {\n None,\n /**\n * Started initialization\n */\n Initializing,\n /**\n * LoRa module initialized and ready to go.\n */\n Ready,\n /**\n * Firmware update is required on the LoRa module\n */\n LoRaIncorrectFirmwareVersion,\n /**\n * Pins are not configured properly\n */\n LoRaInvalidConfiguration\n }\n\n /**\n * Priority of log messages\n */\n export let consolePriority = ConsolePriority.Log;\n function log(msg: string) {\n console.add(consolePriority, `lora: ${msg}`);\n }\n\n const FIRMWARE_VERSION = 0x12;\n // registers\n const REG_FIFO = 0x00;\n const REG_OP_MODE = 0x01;\n // unused\n const REG_FRF_MSB = 0x06;\n const REG_FRF_MID = 0x07;\n const REG_FRF_LSB = 0x08;\n const REG_PA_CONFIG = 0x09;\n const REG_PA_RAMP = 0x0a;\n const REG_OCP = 0x0b;\n const REG_LNA = 0x0c;\n const REG_FIFO_ADDR_PTR = 0x0d;\n const REG_FIFO_TX_BASE_ADDR = 0x0e;\n const REG_FIFO_RX_BASE_ADDR = 0x0f;\n const REG_FIFO_RX_CURRENT_ADDR = 0x10;\n const REG_IRQ_FLAGS = 0x12;\n const REG_RX_NB_BYTES = 0x13;\n const REG_RX_HEADER_COUNT_VALUE_MSB = 0x14;\n const REG_RX_HEADER_COUNT_VALUE_LSB = 0x15;\n const REG_RX_PACKET_COUNT_VALUE_MSB = 0x16;\n const REG_RX_PACKET_COUNT_VALUE_LSB = 0x17;\n const REG_MODEM_STAT = 0x18;\n const REG_PKT_SNR_VALUE = 0x19;\n const REG_PKT_RSSI_VALUE = 0x1a;\n const REG_MODEM_CONFIG_1 = 0x1d;\n const REG_MODEM_CONFIG_2 = 0x1e;\n const REG_PREAMBLE_MSB = 0x20;\n const REG_PREAMBLE_LSB = 0x21;\n const REG_PAYLOAD_LENGTH = 0x22;\n const REG_MAX_PAYLOAD_LENGTH = 0x23;\n const REG_HOP_PERIOD = 0x24;\n const REG_FIFO_RX_BYTE_AD = 0x25;\n const REG_MODEM_CONFIG_3 = 0x26;\n // 0x27 reserved\n const REG_FREQ_ERROR_MSB = 0x28;\n const REG_FREQ_ERROR_MID = 0x29;\n const REG_FREQ_ERROR_LSB = 0x2a;\n // 2b reserved\n const REG_RSSI_WIDEBAND = 0x2c;\n // 2d-2f reserved\n const REG_DETECTION_OPTIMIZE = 0x31;\n const REG_INVERT_IQ = 0x33;\n const REG_DETECTION_THRESHOLD = 0x37;\n const REG_SYNC_WORD = 0x39;\n const REG_DIO_MAPPING_1 = 0x40;\n const REG_DIO_MAPPING_2 = 0x40;\n const REG_VERSION = 0x42;\n const REG_TCXO = 0x4b;\n const REG_PA_DAC = 0x4d;\n const REG_FORMER_TEMP = 0x5b;\n const REG_AGC_REF = 0x61;\n const REG_AGC_THRESH_1 = 0x62;\n const REG_AGC_THRESH_2 = 0x63;\n const REG_AGC_THRESH_3 = 0x64;\n const REG_PLL = 0x70;\n\n // modes\n const MODE_LONG_RANGE_MODE = 0x80;\n const MODE_SLEEP = 0x00;\n const MODE_STDBY = 0x01;\n const MODE_TX = 0x03;\n const MODE_RX_CONTINUOUS = 0x05;\n const MODE_RX_SINGLE = 0x06;\n\n // PA config\n const PA_BOOST = 0x80;\n\n // IRQ masks\n const IRQ_TX_DONE_MASK = 0x08;\n const IRQ_PAYLOAD_CRC_ERROR_MASK = 0x20;\n const IRQ_RX_DONE_MASK = 0x40;\n\n const MAX_PKT_LENGTH = 255;\n\n const PA_OUTPUT_RFO_PIN = 0;\n const PA_OUTPUT_PA_BOOST_PIN = 1;\n\n // Arduino hacks\n function bitSet(value: number, bit: number) {\n return value |= 1 << bit;\n // return ((value) |= (1UL << (bit)));\n }\n function bitClear(value: number, bit: number) {\n return value &= ~(1 << bit);\n // return ((value) &= ~(1UL << (bit)));\n }\n function bitWrite(value: number, bit: number, bitvalue: number) {\n return (bitvalue ? bitSet(value, bit) : bitClear(value, bit));\n }\n\n /**\n * State of the driver\n */\n export let state: LoRaState = LoRaState.None;\n let _version: number;\n let _frequency = 915E6;\n let _packetIndex = 0;\n let _implicitHeaderMode = 0;\n let _implicitHeader = false;\n let _outputPin = PA_OUTPUT_PA_BOOST_PIN;\n let _spi: SPI;\n let _cs: DigitalInOutPin;\n let _boot: DigitalInOutPin;\n let _rst: DigitalInOutPin;\n\n\n export function setPins(spiDevice: SPI,\n csPin: DigitalInOutPin,\n bootPin: DigitalInOutPin,\n rstPin: DigitalInOutPin) {\n _spi = spiDevice;\n _cs = csPin;\n _boot = bootPin;\n _rst = rstPin;\n // force reset\n state = LoRaState.None;\n }\n\n function init() {\n if (state != LoRaState.None) return; // already inited\n\n log(`init`);\n state = LoRaState.Initializing;\n if (!_spi) {\n log(`init using builtin lora pins`);\n const mosi = pins.pinByCfg(DAL.CFG_PIN_LORA_MOSI);\n const miso = pins.pinByCfg(DAL.CFG_PIN_LORA_MISO);\n const sck = pins.pinByCfg(DAL.CFG_PIN_LORA_SCK);\n // make sure pins are ok\n if (!mosi || !miso || !sck) {\n log(`missing SPI pins (MOSI ${!!mosi} MISO ${!!miso} SCK ${!!sck})`)\n state = LoRaState.LoRaInvalidConfiguration;\n return;\n }\n _spi = pins.createSPI(mosi, miso, sck);\n _cs = pins.pinByCfg(DAL.CFG_PIN_LORA_CS);\n _boot = pins.pinByCfg(DAL.CFG_PIN_LORA_BOOT);\n _rst = pins.pinByCfg(DAL.CFG_PIN_LORA_RESET);\n }\n\n // final check for pins\n if (!_cs || !_boot || !_rst) {\n log(`missing pins (CS ${!!_cs} BOOT ${!!_boot} RST ${!!_rst})`)\n state = LoRaState.LoRaInvalidConfiguration;\n return;\n }\n\n _cs.digitalWrite(false);\n\n // Hardware reset\n log('hw reset')\n _boot.digitalWrite(false);\n _rst.digitalWrite(true);\n pause(200);\n _rst.digitalWrite(false);\n pause(200);\n _rst.digitalWrite(true);\n pause(50);\n\n // init spi\n _cs.digitalWrite(true);\n _spi.setFrequency(250000);\n _spi.setMode(0);\n\n _version = readRegister(REG_VERSION);\n log(`version v${version()}, required v${FIRMWARE_VERSION}`);\n\n if (_version != FIRMWARE_VERSION) {\n log(`firmware upgrade required`);\n state = LoRaState.LoRaIncorrectFirmwareVersion;\n return;\n }\n\n //Sleep\n writeRegister(REG_OP_MODE, MODE_LONG_RANGE_MODE | MODE_SLEEP);\n\n // set frequency\n setFrequencyRegisters(_frequency);\n\n // set base addresses\n writeRegister(REG_FIFO_TX_BASE_ADDR, 0);\n writeRegister(REG_FIFO_RX_BASE_ADDR, 0);\n\n // set LNA boost\n writeRegister(REG_LNA, readRegister(REG_LNA) | 0x03);\n\n // set auto AGC\n writeRegister(REG_MODEM_CONFIG_3, 0x04);\n\n // set output power to 17 dBm\n setTxPowerRegisters(17);\n\n // put in standby mode\n writeRegister(REG_OP_MODE, MODE_LONG_RANGE_MODE | MODE_STDBY);\n\n state = LoRaState.Ready;\n log(`ready`);\n }\n\n // Write Register of SX. \n function writeRegister(address: number, value: number) {\n _cs.digitalWrite(false);\n\n _spi.write(address | 0x80);\n _spi.write(value);\n\n _cs.digitalWrite(true);\n }\n\n // Read register of SX \n function readRegister(address: number): number {\n _cs.digitalWrite(false);\n _spi.write(address & 0x7f);\n const response = _spi.write(0x00);\n\n _cs.digitalWrite(true);\n\n return response;\n }\n\n function explicitHeaderMode() {\n _implicitHeaderMode = 0;\n writeRegister(REG_MODEM_CONFIG_1, readRegister(REG_MODEM_CONFIG_1) & 0xfe);\n }\n\n function implicitHeaderMode() {\n _implicitHeaderMode = 1;\n\n writeRegister(REG_MODEM_CONFIG_1, readRegister(REG_MODEM_CONFIG_1) | 0x01);\n }\n\n /**\n * Indicates the LoRa module is correctly initialized\n */\n //% group=\"Configuration\"\n //% blockId=loraeady block=\"lora is ready\"\n export function isReady(): boolean {\n init();\n return state == LoRaState.Ready;\n }\n\n /**\n * Read Version of firmware\n **/\n //% parts=\"lora\"\n export function version(): number {\n init();\n return _version;\n }\n\n /**\n * Parse a packet as a string\n **/\n //% group=\"Receiver\"\n //% parts=\"lora\"\n //% blockId=lorareadstring block=\"lora read string\"\n export function readString(): string {\n if (!isReady()) return \"\";\n\n const buf = readBuffer();\n return buf.toString();\n }\n\n /**\n * Parse a packet as a buffer\n **/\n //% group=\"Receiver\"\n //% parts=\"lora\"\n //% blockId=lorareadbuffer block=\"lora read buffer\"\n export function readBuffer(): Buffer {\n if (!isReady()) return control.createBuffer(0);\n\n let length = parsePacket(0);\n if (length <= 0)\n return control.createBuffer(0); // nothing to read\n\n // allocate buffer to store data\n let buf = control.createBuffer(length);\n let i = 0;\n // read all bytes\n for (let i = 0; i < buf.length; ++i) {\n const c = read();\n if (c < 0) break;\n buf[i] = c;\n }\n if (i != buf.length)\n buf = buf.slice(0, i);\n return buf;\n }\n\n /**\n * Parse Packet to send\n **/\n //% group=\"Packet\"\n //% parts=\"lora\"\n //% weight=45 blockGap=8 blockId=loraparsepacket block=\"lora parse packet %size\"\n export function parsePacket(size: number): number {\n if (!isReady()) return 0;\n\n let packetLength = 0;\n let irqFlags = readRegister(REG_IRQ_FLAGS);\n\n if (size > 0) {\n implicitHeaderMode();\n writeRegister(REG_PAYLOAD_LENGTH, size & 0xff);\n } else {\n explicitHeaderMode();\n }\n\n // clear IRQ's\n writeRegister(REG_IRQ_FLAGS, irqFlags);\n\n if ((irqFlags & IRQ_RX_DONE_MASK) && (irqFlags & IRQ_PAYLOAD_CRC_ERROR_MASK) == 0) {\n // received a packet\n _packetIndex = 0;\n\n // read packet length\n if (_implicitHeaderMode) {\n packetLength = readRegister(REG_PAYLOAD_LENGTH);\n } else {\n packetLength = readRegister(REG_RX_NB_BYTES);\n }\n\n // set FIFO address to current RX address\n writeRegister(REG_FIFO_ADDR_PTR, readRegister(REG_FIFO_RX_CURRENT_ADDR));\n\n // put in standby mode\n idle();\n } else if (readRegister(REG_OP_MODE) != (MODE_LONG_RANGE_MODE | MODE_RX_SINGLE)) {\n // not currently in RX mode\n\n // reset FIFO address\n writeRegister(REG_FIFO_ADDR_PTR, 0);\n\n // put in single RX mode\n writeRegister(REG_OP_MODE, MODE_LONG_RANGE_MODE | MODE_RX_SINGLE);\n }\n\n return packetLength;\n }\n\n /**\n * Packet RSSI\n **/\n //% group=\"Packet\"\n //% parts=\"lora\"\n //% weight=45 blockGap=8 blockId=lorapacketRssi block=\"lora packet RSSI\"\n export function packetRssi(): number {\n if (!isReady()) return -1;\n\n return (readRegister(REG_PKT_RSSI_VALUE) - (_frequency < 868E6 ? 164 : 157));\n }\n\n /**\n * Packet SNR\n */\n //% group=\"Packet\"\n //% parts=\"lora\"\n //% blockId=lorapacketsnr block=\"lora packet SNR\"\n export function packetSnr(): number {\n if (!isReady()) return -1;\n\n return (readRegister(REG_PKT_SNR_VALUE)) * 0.25;\n }\n\n // Begin Packet Frecuency Error\n function packetFrequencyError(): number {\n init();\n let freqError = 0;\n freqError = readRegister(REG_FREQ_ERROR_MSB) & 0xb111; //TODO Covert B111 to c++\n freqError <<= 8;\n freqError += readRegister(REG_FREQ_ERROR_MID) | 0;\n freqError <<= 8;\n freqError += readRegister(REG_FREQ_ERROR_LSB) | 0;\n\n if (readRegister(REG_FREQ_ERROR_MSB) & 0xb1000) { // Sign bit is on //TODO Covert B1000 to c++\n freqError -= 524288; // B1000'0000'0000'0000'0000\n }\n\n const fXtal = 32E6; // FXOSC: crystal oscillator (XTAL) frequency (2.5. Chip Specification, p. 14)\n const fError = ((freqError * (1 << 24)) / fXtal) * (signalBandwidth() / 500000.0); // p. 37\n\n return fError | 0;\n }\n\n // Begin Packet to send\n function beginPacket(): void {\n log(`begin packet`)\n // put in standby mode\n idle();\n\n if (_implicitHeader) {\n implicitHeaderMode();\n } else {\n explicitHeaderMode();\n }\n\n // reset FIFO address and payload length\n writeRegister(REG_FIFO_ADDR_PTR, 0);\n writeRegister(REG_PAYLOAD_LENGTH, 0);\n }\n\n function endPacket(): number {\n log(`end packet`)\n // put in TX mode\n writeRegister(REG_OP_MODE, MODE_LONG_RANGE_MODE | MODE_TX);\n\n // wait for TX done\n // TODO interupts!\n let k = 0;\n while ((readRegister(REG_IRQ_FLAGS) & IRQ_TX_DONE_MASK) == 0) {\n if (k++ % 100 == 0)\n log(`wait tx`)\n pause(10);\n }\n\n // clear IRQ's\n writeRegister(REG_IRQ_FLAGS, IRQ_TX_DONE_MASK);\n\n return 1;\n }\n\n /**\n * Write string to send\n **/\n //% parts=\"lora\"\n //% group=\"Sender\"\n //% blockId=lorasendstring block=\"lora send string $text\"\n export function sendString(text: string) {\n if (!text) return;\n if (!isReady()) return;\n const buf = control.createBufferFromUTF8(text);\n sendBuffer(buf);\n }\n\n /**\n * Write buffer to send\n **/\n //% parts=\"lora\"\n //% group=\"Sender\"\n //% blockId=lorasendbuffer block=\"lora send buffer $buffer\"\n export function sendBuffer(buffer: Buffer) {\n if (!buffer || buffer.length == 0) return;\n if (!isReady()) return;\n log('send')\n beginPacket();\n log(`write payload (${buffer.length} bytes)`)\n writeRaw(buffer);\n endPacket();\n }\n\n function writeRaw(buffer: Buffer) {\n const currentLength = readRegister(REG_PAYLOAD_LENGTH);\n let size = buffer.length;\n log(`current payload length: ${currentLength}`)\n\n // check size\n if ((currentLength + size) > MAX_PKT_LENGTH) {\n size = MAX_PKT_LENGTH - currentLength;\n }\n\n log(`write raw ${buffer.length} -> ${size} bytes`)\n\n // write data\n for (let i = 0; i < size; i++) {\n writeRegister(REG_FIFO, buffer[i]);\n }\n\n // update length\n writeRegister(REG_PAYLOAD_LENGTH, currentLength + size);\n log(`updated payload length: ${readRegister(REG_PAYLOAD_LENGTH)}`)\n }\n\n /**\n * Available Packet\n **/\n //% parts=\"lora\"\n //% group=\"Packet\"\n //% weight=45 blockGap=8 \n //% blockId=loraavailable block=\"lora available\"\n export function available(): number {\n if (!isReady()) return 0;\n return readRegister(REG_RX_NB_BYTES) - _packetIndex;\n }\n\n /**\n * Read Packet\n **/\n //% parts=\"lora\"\n //% group=\"Packet\"\n //% blockId=loraread block=\"lora read\"\n export function read(): number {\n if (!isReady()) return -1;\n if (!available())\n return -1;\n _packetIndex++;\n\n return readRegister(REG_FIFO);\n }\n\n /**\n * Peek Packet to send\n **/\n //% parts=\"lora\"\n //% group=\"Packet\"\n //% blockId=lorapeek block=\"lora peek\"\n export function peek(): number {\n if (!isReady()) return -1;\n if (!available())\n return -1;\n\n // store current FIFO address\n const currentAddress = readRegister(REG_FIFO_ADDR_PTR);\n\n // read\n const b = readRegister(REG_FIFO);\n\n // restore FIFO address\n writeRegister(REG_FIFO_ADDR_PTR, currentAddress);\n\n return b;\n }\n\n function flush() {\n //TODO\n }\n\n /**\n * Put LoRa in idle mode\n */\n //% parts=\"lora\"\n //% group=\"Mode\"\n //% blockId=loraidle block=\"lora idle\"\n export function idle() {\n if (!isReady()) return;\n log('idle')\n writeRegister(REG_OP_MODE, MODE_LONG_RANGE_MODE | MODE_STDBY);\n }\n\n /**\n * Sleep Mode\n **/\n //% parts=\"lora\"\n //% group=\"Mode\"\n //% blockId=lorasleep block=\"lora sleep\"\n export function sleep() {\n if (!isReady()) return;\n writeRegister(REG_OP_MODE, MODE_LONG_RANGE_MODE | MODE_SLEEP);\n }\n\n\n function setTxPowerRegisters(level: number, rfo?: boolean) {\n level = level | 0;\n if (rfo) {\n // RFO\n if (level < 0) {\n level = 0;\n } else if (level > 14) {\n level = 14;\n }\n\n writeRegister(REG_PA_CONFIG, 0x70 | level);\n } else {\n // PA BOOST\n if (level < 2) {\n level = 2;\n } else if (level > 17) {\n level = 17;\n }\n\n writeRegister(REG_PA_CONFIG, PA_BOOST | (level - 2));\n }\n }\n\n /**\n * Set Tx Power\n **/\n //% parts=\"lora\"\n //% group=\"Configuration\"\n //% blockId=lorasettxpower block=\"lora set tx power to $level dBm\"\n export function setTxPower(level: number, rfo?: boolean) {\n if (!isReady()) return;\n setTxPowerRegisters(level, rfo);\n }\n\n function setFrequencyRegisters(frequency: number) {\n _frequency = frequency;\n const frf = ((frequency * (1 << 19)) / 32000000) | 0;\n log(`frequency ${_frequency} -> ${frf}`);\n\n writeRegister(REG_FRF_MSB, (frf >> 16) & 0xff);\n writeRegister(REG_FRF_MID, (frf >> 8) & 0xff);\n writeRegister(REG_FRF_LSB, (frf >> 0) & 0xff);\n }\n\n /**\n * Set Frecuency of LoRa\n **/\n //% parts=\"lora\"\n //% group=\"Configuration\"\n //% blockId=lorasetsetfrequency block=\"lora set frequency to $frequency\"\n export function setFrequency(frequency: number) {\n if (!isReady()) return;\n setFrequencyRegisters(_frequency);\n }\n\n /**\n * Get Spreading Factor of LoRa\n **/\n //% parts=\"lora\"\n //% group=\"Configuration\"\n //% blockId=loraspreadingfactor block=\"lora spreading factor\"\n export function spreadingFactor(): number {\n if (!isReady()) return -1;\n return readRegister(REG_MODEM_CONFIG_2) >> 4;\n }\n\n /**\n * Sets the spreading factoring\n * @param factor spreading factor\n */\n //% parts=\"lora\"\n //% blockId=lorasetspreadingfactor block=\"lora set spreading factor $factor\"\n //% factor.min=6 factor.max=12\n //% factor.defl=8\n //% group=\"Configuration\"\n export function setSpreadingFactor(factor: number) {\n if (!isReady()) return;\n factor = factor | 0;\n if (factor < 6) {\n factor = 6;\n } else if (factor > 12) {\n factor = 12;\n }\n\n if (factor == 6) {\n writeRegister(REG_DETECTION_OPTIMIZE, 0xc5);\n writeRegister(REG_DETECTION_THRESHOLD, 0x0c);\n } else {\n writeRegister(REG_DETECTION_OPTIMIZE, 0xc3);\n writeRegister(REG_DETECTION_THRESHOLD, 0x0a);\n }\n\n writeRegister(REG_MODEM_CONFIG_2, (readRegister(REG_MODEM_CONFIG_2) & 0x0f) | ((factor << 4) & 0xf0));\n setLdoFlag();\n }\n\n /**\n * Get Signal Bandwidth of LoRa\n **/\n //% parts=\"lora\"\n //% group=\"Configuration\"\n //% blockId=lorasignalbandwith block=\"signal bandwidth\"\n export function signalBandwidth(): number {\n if (!isReady()) return 0;\n const bw = (readRegister(REG_MODEM_CONFIG_1) >> 4);\n switch (bw) {\n case 0: return 7.8E3;\n case 1: return 10.4E3;\n case 2: return 15.6E3;\n case 3: return 20.8E3;\n case 4: return 31.25E3;\n case 5: return 41.7E3;\n case 6: return 62.5E3;\n case 7: return 125E3;\n case 8: return 250E3;\n case 9: return 500E3;\n }\n // unknown\n return 0;\n }\n\n /**\n * Set Signal Bandwidth of LoRa\n **/\n //% parts=\"lora\"\n //% group=\"Configuration\"\n //% blockId=lorasetsignalbandwith block=\"set signal bandwidth to $value\"\n export function setSignalBandwidth(value: number) {\n if (!isReady()) return;\n let bw;\n\n if (value <= 7.8E3) {\n bw = 0;\n } else if (value <= 10.4E3) {\n bw = 1;\n } else if (value <= 15.6E3) {\n bw = 2;\n } else if (value <= 20.8E3) {\n bw = 3;\n } else if (value <= 31.25E3) {\n bw = 4;\n } else if (value <= 41.7E3) {\n bw = 5;\n } else if (value <= 62.5E3) {\n bw = 6;\n } else if (value <= 125E3) {\n bw = 7;\n } else if (value <= 250E3) {\n bw = 8;\n } else /*if (sbw <= 250E3)*/ {\n bw = 9;\n }\n\n writeRegister(REG_MODEM_CONFIG_1, (readRegister(REG_MODEM_CONFIG_1) & 0x0f) | (bw << 4));\n setLdoFlag();\n }\n\n function setLdoFlag() {\n // Section 4.1.1.5\n const symbolDuration = 1000 / (signalBandwidth() / (1 << spreadingFactor()));\n\n // Section 4.1.1.6\n const ldoOn = symbolDuration > 16 ? 1 : 0;\n\n const config3 = readRegister(REG_MODEM_CONFIG_3);\n bitWrite(config3, 3, ldoOn);\n writeRegister(REG_MODEM_CONFIG_3, config3);\n }\n\n function setCodingRate4(denominator: number) {\n if (denominator < 5) {\n denominator = 5;\n } else if (denominator > 8) {\n denominator = 8;\n }\n\n const cr = denominator - 4;\n writeRegister(REG_MODEM_CONFIG_1, (readRegister(REG_MODEM_CONFIG_1) & 0xf1) | (cr << 1));\n }\n\n function setPreambleLength(length: number) {\n writeRegister(REG_PREAMBLE_MSB, (length >> 8) & 0xff);\n writeRegister(REG_PREAMBLE_LSB, (length >> 0) & 0xff);\n }\n\n function setSyncWord(sw: number) {\n writeRegister(REG_SYNC_WORD, sw);\n }\n\n //% parts=\"lora\"\n //% group=\"Configuration\"\n //% blockId=lorasetcrc block=\"lora set crc $on\"\n //% on.shadow=toggleOnOff\n export function setCrc(on: boolean) {\n if (!isReady()) return;\n let v = readRegister(REG_MODEM_CONFIG_2);\n if (on) v = v | 0x04; else v = v & 0xfb;\n writeRegister(REG_MODEM_CONFIG_2, v);\n }\n\n export function dumpRegisters() {\n init();\n log(`state: ${[\"none\", \"initializing\", \"ready\", \"incorrect firmware\", \"invalid config\"][state]}`)\n if (!isReady()) return;\n log(`registers:`)\n const buf = control.createBuffer(1);\n const regNames: any = {};\n regNames[REG_FIFO] = \"REG_FIFO\";\n regNames[REG_OP_MODE] = \"REG_OP_MODE\";\n // unused\n regNames[REG_FRF_MSB] = \"REG_FRF_MSB\";\n regNames[REG_FRF_MID] = \"REG_FRF_MID\";\n regNames[REG_FRF_LSB] = \"REG_FRF_LSB\";\n regNames[REG_PA_CONFIG] = \"REG_PA_CONFIG\";\n regNames[REG_PA_RAMP] = \"REG_PA_RAMP\";\n regNames[REG_OCP] = \"REG_OCP\";\n regNames[REG_LNA] = \"REG_LNA\";\n regNames[REG_FIFO_ADDR_PTR] = \"REG_FIFO_ADDR_PTR\";\n regNames[REG_FIFO_TX_BASE_ADDR] = \"REG_FIFO_TX_BASE_ADDR\";\n regNames[REG_FIFO_RX_BASE_ADDR] = \"REG_FIFO_RX_BASE_ADDR\";\n regNames[REG_FIFO_RX_CURRENT_ADDR] = \"REG_FIFO_RX_CURRENT_ADDR\";\n regNames[REG_IRQ_FLAGS] = \"REG_IRQ_FLAGS\";\n regNames[REG_RX_NB_BYTES] = \"REG_RX_NB_BYTES\";\n regNames[REG_RX_HEADER_COUNT_VALUE_MSB] = \"REG_RX_HEADER_COUNT_VALUE_MSB\";\n regNames[REG_RX_HEADER_COUNT_VALUE_LSB] = \"REG_RX_HEADER_COUNT_VALUE_LSB\";\n regNames[REG_RX_PACKET_COUNT_VALUE_MSB] = \"REG_RX_PACKET_COUNT_VALUE_MSB\";\n regNames[REG_RX_PACKET_COUNT_VALUE_LSB] = \"REG_RX_PACKET_COUNT_VALUE_LSB\";\n regNames[REG_MODEM_STAT] = \"REG_MODEM_STAT\";\n regNames[REG_PKT_SNR_VALUE] = \"REG_PKT_SNR_VALUE\";\n regNames[REG_PKT_RSSI_VALUE] = \"REG_PKT_RSSI_VALUE\";\n regNames[REG_MODEM_CONFIG_1] = \"REG_MODEM_CONFIG_1\";\n regNames[REG_MODEM_CONFIG_2] = \"REG_MODEM_CONFIG_2\";\n regNames[REG_PREAMBLE_MSB] = \"REG_PREAMBLE_MSB\";\n regNames[REG_PREAMBLE_LSB] = \"REG_PREAMBLE_LSB\";\n regNames[REG_PAYLOAD_LENGTH] = \"REG_PAYLOAD_LENGTH\";\n regNames[REG_MAX_PAYLOAD_LENGTH] = \"REG_MAX_PAYLOAD_LENGTH\";\n regNames[REG_HOP_PERIOD] = \"REG_HOP_PERIOD\";\n regNames[REG_FIFO_RX_BYTE_AD] = \"REG_FIFO_RX_BYTE_AD\";\n regNames[REG_MODEM_CONFIG_3] = \"REG_MODEM_CONFIG_3\";\n // 0x27 reserved\n regNames[REG_FREQ_ERROR_MSB] = \"REG_FREQ_ERROR_MSB\";\n regNames[REG_FREQ_ERROR_MID] = \"REG_FREQ_ERROR_MID\";\n regNames[REG_FREQ_ERROR_LSB] = \"REG_FREQ_ERROR_LSB\";\n // 2b reserved\n regNames[REG_RSSI_WIDEBAND] = \"REG_RSSI_WIDEBAND\";\n // 2d-2f reserved\n regNames[REG_DETECTION_OPTIMIZE] = \"REG_DETECTION_OPTIMIZE\";\n regNames[REG_INVERT_IQ] = \"REG_INVERT_IQ\";\n regNames[REG_DETECTION_THRESHOLD] = \"REG_DETECTION_THRESHOLD\";\n regNames[REG_SYNC_WORD] = \"REG_SYNC_WORD\";\n regNames[REG_DIO_MAPPING_1] = \"REG_DIO_MAPPING_1\";\n regNames[REG_DIO_MAPPING_2] = \"REG_DIO_MAPPING_2\";\n regNames[REG_VERSION] = \"REG_VERSION\";\n regNames[REG_TCXO] = \"REG_TCXO\";\n regNames[REG_PA_DAC] = \"REG_PA_DAC\";\n regNames[REG_FORMER_TEMP] = \"REG_FORMER_TEMP\";\n regNames[REG_AGC_REF] = \"REG_AGC_REF\";\n regNames[REG_AGC_THRESH_1] = \"REG_AGC_THRESH_1\";\n regNames[REG_AGC_THRESH_2] = \"REG_AGC_THRESH_2\";\n regNames[REG_AGC_THRESH_3] = \"REG_AGC_THRESH_3\";\n regNames[REG_PLL] = \"REG_PLL\";\n\n for (let i = 0; i < 128; i++) {\n let r: string = regNames[i];\n if (!!r) {\n r += \" (0x\";\n buf[0] = i;\n r += buf.toHex();\n r += \"): 0x\";\n buf[0] = readRegister(i);\n r += buf.toHex();\n log(r);\n }\n }\n }\n}\n",
"pxt.json": "{\n \"name\": \"lora\",\n \"version\": \"0.2.2\",\n \"description\": \"Library for Lora - beta\",\n \"license\": \"MIT\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"lora.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"test.ts": "// tests go here; this will not be compiled when this package is used as a library\n"
},
"power": {
"power.ts": "/**\n * Power and sleep management\n */\n//% advanced=true icon=\"\\uf011\" color=\"#898989\"\n//% weight=1 blockGap=8\nnamespace power {\n let _poked: number;\n let _timeout: number;\n\n /**\n * Set the no-activity duration after which the device should go to deep sleep.\n * @param seconds duration in seconds until the device should be put in lower power mode\n */\n //% blockId=powersetdeepsleeptimout block=\"power set deep sleep timeout to %seconds s\"\n //% seconds.defl=60\n //% help=/power/set-deep-sleep-timeout\n export function setDeepSleepTimeout(seconds: number) {\n init();\n _timeout = seconds * 1000;\n }\n\n /**\n * Poke the activity watcher to keep the device awake.\n */\n //% blockId=powerpke block=\"power poke\"\n //% help=/power/poke\n export function poke() {\n init();\n _poked = control.millis();\n }\n\n /**\n * Check if the device has had any \"pokes\" and needs to go into deep sleep mode.\n */\n //% blockId=powercheckdeepsleep block=\"power check deep sleep\"\n //% help=/power/check-deep-sleep\n export function checkDeepSleep() {\n init();\n const p = _poked || 0;\n const to = _timeout || 0;\n if (to > 0 && \n control.millis() - p > to &&\n !control.isUSBInitialized()) {\n // going to deep sleep\n deepSleep();\n }\n }\n\n /**\n * Put the device into a deep sleep state.\n */\n //% blockId=powerdeepsleep block=\"power deep sleep\"\n //% shim=pxt::deepSleep\n //% help=/power/deep-sleep\n export function deepSleep() {\n }\n\n function init() {\n if (_timeout !== undefined) return;\n\n // read default value\n _timeout = control.getConfigValue(DAL.CFG_POWER_DEEPSLEEP_TIMEOUT, -1) * 1000;\n // ensure deepsleep is long enough\n const minDeepSleepTimeout = 300000;\n if (_timeout > 0 && _timeout < minDeepSleepTimeout)\n _timeout = minDeepSleepTimeout;\n }\n}\n",
"pxt.json": "{\n \"name\": \"power\",\n \"description\": \"Power and sleep management\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"power.ts\"\n ],\n \"testFiles\": [],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"icon\": \"/static/libs/power.png\"\n}\n"
},
"lcd": {
"README.md": "# LCD\n\nPorted from https://github.com/adafruit/Adafruit_CircuitPython_CharLCD/.\n",
"characterlcd.ts": "namespace lcd {\n\n //% shim=lcd::__write8\n function __write8(value: number, char_mode: boolean): void {\n }\n\n // Commands\n const _LCD_CLEARDISPLAY = 0x01\n const _LCD_RETURNHOME = 0x02\n const _LCD_ENTRYMODESET = 0x04\n const _LCD_DISPLAYCONTROL = 0x08\n const _LCD_CURSORSHIFT = 0x10\n const _LCD_FUNCTIONSET = 0x20\n const _LCD_SETCGRAMADDR = 0x40\n const _LCD_SETDDRAMADDR = 0x80\n // Entry flags\n const _LCD_ENTRYLEFT = 0x02\n const _LCD_ENTRYSHIFTDECREMENT = 0x00\n // Control flags\n const _LCD_DISPLAYON = 0x04\n const _LCD_CURSORON = 0x02\n const _LCD_CURSOROFF = 0x00\n const _LCD_BLINKON = 0x01\n const _LCD_BLINKOFF = 0x00\n // Move flags\n const _LCD_DISPLAYMOVE = 0x08\n const _LCD_MOVERIGHT = 0x04\n const _LCD_MOVELEFT = 0x00\n // Function set flags\n const _LCD_4BITMODE = 0x00\n const _LCD_2LINE = 0x08\n const _LCD_1LINE = 0x00\n const _LCD_5X8DOTS = 0x00\n // Offset for up to 4 rows.\n const _LCD_ROW_OFFSETS = [0x00, 0x40, 0x14, 0x54]\n\n export class CharacterLCD {\n columns: number\n lines: number\n reset: DigitalInOutPin;\n enable: DigitalInOutPin;\n dl4: DigitalInOutPin;\n dl5: DigitalInOutPin;\n dl6: DigitalInOutPin;\n dl7: DigitalInOutPin;\n displaycontrol: number\n displayfunction: number\n displaymode: number\n _message: string;\n _enable: boolean;\n _rtl: boolean;\n\n // pylint: disable-msg=too-many-arguments\n constructor(rs: DigitalInOutPin, en: DigitalInOutPin,\n d4: DigitalInOutPin, d5: DigitalInOutPin, d6: DigitalInOutPin, d7: DigitalInOutPin,\n columns: number, lines: number) {\n this._rtl = false;\n this.columns = columns;\n this.lines = lines;\n // save pin numbers\n this.reset = rs;\n this.enable = en;\n this.dl4 = d4;\n this.dl5 = d5;\n this.dl6 = d6;\n this.dl7 = d7;\n // set all pins as outputs\n for (const pin of [rs, en, d4, d5, d6, d7]) {\n pin.digitalWrite(false);\n }\n // Initialise the display\n this._write8(0x33)\n this._write8(0x32)\n // Initialise display control\n this.displaycontrol = _LCD_DISPLAYON | _LCD_CURSOROFF | _LCD_BLINKOFF\n // Initialise display function\n this.displayfunction = _LCD_4BITMODE | _LCD_1LINE | _LCD_2LINE | _LCD_5X8DOTS\n // Initialise display mode\n this.displaymode = _LCD_ENTRYLEFT | _LCD_ENTRYSHIFTDECREMENT\n // Write to displaycontrol\n this._write8(_LCD_DISPLAYCONTROL | this.displaycontrol)\n // Write to displayfunction\n this._write8(_LCD_FUNCTIONSET | this.displayfunction)\n // Set entry mode\n this._write8(_LCD_ENTRYMODESET | this.displaymode)\n this.clear()\n this._message = \"\"\n this._enable = null\n }\n\n /** \n * Moves the cursor \"home\" to position (1, 1).\n **/\n public home(): void {\n this._write8(_LCD_RETURNHOME)\n pause(3)\n }\n\n /** Clears everything displayed on the LCD.\n * The following example displays, \"Hello, world!\", then clears the LCD.\n **/\n public clear(): void {\n this._write8(_LCD_CLEARDISPLAY)\n this._message = \"\";\n pause(3)\n }\n\n /** \n * True if cursor is visible. False to stop displaying the cursor.\n */\n get cursor(): boolean {\n return (this.displaycontrol & _LCD_CURSORON) == _LCD_CURSORON;\n }\n\n set cursor(show: boolean) {\n const dc = this.displaycontrol;\n if (show)\n this.displaycontrol |= _LCD_CURSORON\n else\n this.displaycontrol &= ~_LCD_CURSORON\n if (dc != this.displaycontrol)\n this._write8(_LCD_DISPLAYCONTROL | this.displaycontrol)\n }\n\n /** \n * Move the cursor to position ``column``, ``row`` \n **/\n public setCursorPosition(column: number, row: number): void {\n column = Math.max(0, Math.min(this.columns - 1, column | 0));\n row = Math.max(0, Math.min(this.lines - 1, row | 0));\n\n //console.log(`cursor ${_LCD_SETDDRAMADDR | column + _LCD_ROW_OFFSETS[row]}`)\n this._write8(_LCD_SETDDRAMADDR | column + _LCD_ROW_OFFSETS[row])\n }\n\n /** \n * Blink the cursor. True to blink the cursor. False to stop blinking.\n */\n get blink(): boolean {\n\n return (this.displaycontrol & _LCD_BLINKON) == _LCD_BLINKON\n }\n\n set blink(value: boolean) {\n const dc = this.displaycontrol;\n if (value)\n this.displaycontrol |= _LCD_BLINKON\n else\n this.displaycontrol &= ~_LCD_BLINKON\n if (dc != this.displaycontrol)\n this._write8(_LCD_DISPLAYCONTROL | this.displaycontrol)\n }\n\n /** \n * Enable or disable the display. True to enable the display. False to disable the display.\n */\n get display(): boolean {\n return (this.displaycontrol & _LCD_DISPLAYON) == _LCD_DISPLAYON\n }\n\n set display(enable: boolean) {\n const dc = this.displaycontrol;\n if (enable)\n this.displaycontrol |= _LCD_DISPLAYON\n else\n this.displaycontrol &= ~_LCD_DISPLAYON\n\n if (dc != this.displaycontrol)\n this._write8(_LCD_DISPLAYCONTROL | this.displaycontrol)\n }\n\n /** \n * Display a string of text on the character LCD.\n */\n get message(): string {\n return this._message\n }\n\n set message(message: string) {\n if (message === undefined || message === null) message = \"\";\n if (this._message === message) return; // nothing to do here\n\n const oldMessage = this._message;\n this._message = message;\n //console.log(`'${oldMessage}' => '${message}'`);\n\n const ltr = !!(this.displaymode & _LCD_ENTRYLEFT);\n const oldLines = oldMessage.split('\\n');\n const lines = this._message.split('\\n');\n const rn = Math.min(this.lines, Math.max(oldLines.length, lines.length));\n\n let cursorrow = -1;\n let cursorcol = -1;\n for (let row = 0; row < rn; ++row) {\n let oldLine = oldLines[row];\n if (oldLine === undefined) oldLine = \"\";\n let line = lines[row];\n if (line === undefined) line = \"\";\n const cn = Math.min(this.columns, Math.max(oldLine.length, line.length));\n for (let column = 0; column < cn; ++column) {\n const oc = oldLine.charCodeAt(column);\n const c = line.charCodeAt(column);\n if (oc !== c) {\n // letter is already shown, skip\n // move cursor if needed\n if (row != cursorrow || column != cursorcol) {\n //console.log(`set cursor pos ${column}, ${row}`);\n this.setCursorPosition(ltr ? column : this.columns - 1 - column, row);\n cursorrow = row;\n cursorcol = column;\n }\n //console.log(`write ${String.fromCharCode(c)} (${String.fromCharCode(oc)}) at ${cursorcol}, ${cursorrow}`);\n if (column >= line.length)\n this._write8(32 /* space */, true);\n else\n this._write8(c, true);\n cursorcol++;\n }\n }\n }\n }\n\n /** \n * Moves displayed text left one column.\n **/\n public moveLeft(): void {\n this._write8(_LCD_CURSORSHIFT | _LCD_DISPLAYMOVE | _LCD_MOVELEFT)\n }\n\n /** \n * Moves displayed text right one column.\n **/\n public moveRight(): void {\n this._write8(_LCD_CURSORSHIFT | _LCD_DISPLAYMOVE | _LCD_MOVERIGHT)\n }\n\n get rightToLeft(): boolean {\n return this._rtl;\n }\n\n set rightToLeft(direction: boolean) {\n if (this._rtl != direction) {\n this._rtl = direction;\n if (this._rtl)\n this._right_to_left();\n else\n this._left_to_right();\n }\n }\n\n private _left_to_right(): void {\n // Displays text from left to right on the LCD.\n this.displaymode |= _LCD_ENTRYLEFT\n this._write8(_LCD_ENTRYMODESET | this.displaymode)\n }\n\n private _right_to_left(): void {\n // Displays text from right to left on the LCD.\n this.displaymode &= ~_LCD_ENTRYLEFT\n this._write8(_LCD_ENTRYMODESET | this.displaymode)\n }\n\n /** \n * Fill one of the first 8 CGRAM locations with custom characters.\n * The location parameter should be between 0 and 7 and pattern should\n * provide an array of 8 bytes containing the pattern. E.g. you can easily\n * design your custom character at http://www.quinapalus.com/hd44780udg.html\n * To show your custom character use, for example, ``lcd.message = \"\u0001\"``\n*/\n public create_char(location: number, pattern: Buffer): void {\n // only position 0..7 are allowed\n location &= 0x7\n this._write8(_LCD_SETCGRAMADDR | location << 3)\n for (let i = 0; i < 8; ++i) {\n this._write8(pattern[i], true)\n }\n }\n\n\n /**\n * Sends 8b ``value`` in ``char_mode``.\n * @param value bytes\n * @param char_mode character/data mode selector. False (default) for data only, True for character bits.\n */\n private _write8(value: number, char_mode = false): void {\n __write8(value, char_mode);\n // one ms delay to prevent writing too quickly.\n pause(1)\n // set character/data bit. (charmode = False)\n this.reset.digitalWrite(char_mode)\n // WRITE upper 4 bits\n this.dl4.digitalWrite(!!(value >> 4 & 1));\n this.dl5.digitalWrite(!!(value >> 5 & 1));\n this.dl6.digitalWrite(!!(value >> 6 & 1));\n this.dl7.digitalWrite(!!(value >> 7 & 1));\n // send command\n this._pulse_enable()\n // WRITE lower 4 bits\n this.dl4.digitalWrite(!!(value & 1));\n this.dl5.digitalWrite(!!(value >> 1 & 1));\n this.dl6.digitalWrite(!!(value >> 2 & 1));\n this.dl7.digitalWrite(!!(value >> 3 & 1));\n this._pulse_enable()\n }\n\n private _pulse_enable(): void {\n // Pulses (lo->hi->lo) to send commands.\n this.enable.digitalWrite(false);\n control.waitMicros(1);\n this.enable.digitalWrite(true);\n control.waitMicros(1);\n this.enable.digitalWrite(false);\n control.waitMicros(1);\n }\n }\n}\n",
"characterlcdmono.ts": "namespace lcd {\n export class CharacterLCDMono extends CharacterLCD {\n backlight_pin: DigitalInOutPin;\n backlight_inverted: boolean;\n /** \n * Interfaces with monochromatic character LCDs.\n @param backlight_inverted: ``False`` if LCD is not inverted, i.e. backlight pin is\n connected to common anode. ``True`` if LCD is inverted i.e. backlight pin is connected\n to common cathode.\n */\n constructor(\n rs: DigitalInOutPin,\n en: DigitalInOutPin,\n db4: DigitalInOutPin,\n db5: DigitalInOutPin,\n db6: DigitalInOutPin,\n db7: DigitalInOutPin,\n columns: number,\n lines: number,\n backlight_pin: DigitalInOutPin = null,\n backlight_inverted: boolean = false\n ) {\n super(rs, en, db4, db5, db6, db7, columns, lines);\n // Backlight pin and inversion\n this.backlight_pin = backlight_pin;\n this.backlight_inverted = !!backlight_inverted;\n // Setup backlight\n if (this.backlight_pin)\n this.backlight_pin.digitalWrite(this.backlight_inverted);\n }\n\n /** \n * Enable or disable backlight. True if backlight is on. False if backlight is off.\n **/\n get backlight(): boolean {\n return this._enable\n }\n\n set backlight(enable: boolean) {\n this._enable = enable;\n this.backlight_pin.digitalWrite(enable ? !this.backlight_inverted : this.backlight_inverted);\n }\n }\n}",
"characterlcdrbg.ts": "namespace lcd {\n\n export class CharacterLCDRGB extends CharacterLCD {\n read_write: DigitalInOutPin; /** TODO: type **/\n rgb_led: PwmOnlyPin[]; /** TODO: type **/\n _color: number;\n /** \n * Interfaces with RGB character LCDs.\n */\n constructor(rs: DigitalInOutPin,\n en: DigitalInOutPin,\n db4: DigitalInOutPin, db5: DigitalInOutPin, db6: DigitalInOutPin, db7: DigitalInOutPin,\n columns: number, lines: number,\n red: PwmOnlyPin, green: PwmOnlyPin, blue: PwmOnlyPin,\n read_write: DigitalInOutPin = null) {\n super(rs, en, db4, db5, db6, db7, columns, lines);\n // Define read_write (rw) pin\n this.read_write = read_write;\n // Setup rw pin if used\n if (read_write)\n this.read_write.digitalWrite(false);\n\n // define color params\n this.rgb_led = [red, green, blue]\n for (let pin of this.rgb_led) {\n pin.digitalWrite(false);\n }\n this._color = 0;\n }\n\n /** \n * The color of the display. Provide a list of three integers ranging 0 - 100, ``[R, G, B]``.\n * ``0`` is no color, or \"off\". ``100`` is maximum color. For example, the brightest red would\n * be ``[100, 0, 0]``, and a half-bright purple would be, ``[50, 0, 50]``.\n \n * If PWM is unavailable, ``0`` is off, and non-zero is on. For example, ``[1, 0, 0]`` would\n * be red. \n **/\n get color(): number {\n return this._color\n }\n\n set color(color: number) {\n this._color = color;\n const channels = [(this._color >> 16) & 0xff, (this._color >> 8) & 0xff, (this._color) & 0xff]\n this.rgb_led.forEach((pin, i) => {\n pin.analogWrite(Math.map(channels[i], 0, 0xff, 0, 1024));\n })\n }\n }\n}",
"lcd.cpp": "#include \"pxt.h\"\n\nnamespace lcd {\n //%\n void __write8(int value, bool char_mode) {\n // sim only\n } \n}\n",
"lcd.ts": "/**\n * Character LCD support\n */\n//% icon=\"\\uf0ae\" color=\"#219E42\" blockGap=8\n//% groups='[\"Display\", \"Configuration\"]'\nnamespace lcd {\n let _screen: CharacterLCD;\n\n /**\n * Gets the current LCD screen\n */\n export function screen(): CharacterLCD {\n if (_screen !== undefined) return _screen;\n\n const rs = pins.pinByCfg(DAL.CFG_PIN_LCD_RESET);\n const en = pins.pinByCfg(DAL.CFG_PIN_LCD_ENABLE);\n const db4 = pins.pinByCfg(DAL.CFG_PIN_LCD_DATALINE4);\n const db5 = pins.pinByCfg(DAL.CFG_PIN_LCD_DATALINE5);\n const db6 = pins.pinByCfg(DAL.CFG_PIN_LCD_DATALINE6);\n const db7 = pins.pinByCfg(DAL.CFG_PIN_LCD_DATALINE7);\n const columns = control.getConfigValue(DAL.CFG_NUM_LCD_COLUMNS, 16);\n const lines = control.getConfigValue(DAL.CFG_NUM_LCD_ROWS, 2);\n\n if (!rs || !en || !db4 || !db5 || !db6 || !db7) {\n _screen = null; // not supported\n }\n else {\n _screen = new CharacterLCDMono(rs, en, db4, db5, db6, db7, columns, lines);\n }\n return _screen;\n }\n\n /**\n * Shows a string on the LCD screen\n * @param text the text to show\n * @param line the line number starting at 1...\n */\n //% blockId=lcdshowstring block=\"lcd show string %text at line %line\"\n //% line.min=1 line.max=2 line.defl=1\n //% parts=\"lcd\"\n //% group=\"Display\"\n export function showString(text: string, line?: number) {\n const l = screen();\n if (!l) return;\n if (line === undefined) line = 1;\n\n line = (line - 1) | 0;\n if (line < 0 || line >= l.lines) return; // out of range\n\n // insert text in line\n const lines = l.message.split('\\n');\n // assign all lines within range\n text.split('\\n')\n .filter((tl, i) => line + i < l.lines)\n .forEach((tl, i) => {\n lines[line + i] = tl;\n })\n // fill the holes\n for(let i = 0; i < lines.length; ++i) {\n if (lines[i] === undefined) lines[i] = \"\";\n }\n // reassemble text\n const message = lines.join('\\n');\n\n l.message = message;\n }\n\n /**\n * Shows a number on the LCD screen\n * @param value the number to show\n */\n //% blockId=lcdshownumber block=\"lcd show number %value at line %line\"\n //% line.min=1 line.max=2 line.defl=1\n //% parts=\"lcd\"\n //% group=\"Display\"\n export function showNumber(value: number, line?: number) {\n value = Math.round(value * 1000) / 1000;\n showString(value + \"\", line);\n }\n\n /**\n * Shows a name, value pair on the screen\n * @param value the numeric value\n * @param line the line number to print the text at (starting at 1), eg: 1\n */\n //% blockId=lcdshowvalue block=\"lcd show value %name: %text at line %line\"\n //% inlineInputMode=\"inline\" blockGap=8\n //% line.min=1 line.max=2 line.defl=1\n //% parts=\"lcd\"\n //% group=\"Display\"\n export function showValue(name: string, value: number, line: number) {\n value = Math.round(value * 1000) / 1000;\n showString((name ? name + \": \" : \"\") + value, line);\n }\n\n /**\n * Clears the screen\n */\n //% blockId=lcdclear block=\"lcd clear\"\n //% parts=lcd\n //% group=\"Display\"\n export function clear() {\n const l = screen();\n if (!l) return;\n l.clear();\n }\n\n /**\n * Enables or disables display\n * @param enabled true to turn the display on; false otherwise\n */\n //% blockId=lcdsetdisplay block=\"lcd set display %enabled\"\n //% enabled.shadow=toggleOnOff\n //% parts=\"lcd\"\n //% group=\"Configuration\"\n export function setDisplay(enabled: boolean) {\n const l = screen();\n if (!l) return;\n\n l.display = !!enabled;\n }\n\n /**\n * Enables or disables blinking\n * @param enabled true to blink\n */\n //% blockId=lcdsetblink block=\"lcd set blink %enabled\"\n //% enabled.shadow=toggleOnOff\n //% group=\"Configuration\"\n export function setBlink(enabled: boolean) {\n const l = screen();\n if (!l) return;\n\n l.blink = !!enabled;\n }\n\n /**\n * Show or hide cursor\n * @param enabled true to display cursor, false otherwise\n */\n //% blockId=lcdsetcursor block=\"lcd set curcor %enabled\"\n //% enabled.shadow=toggleOnOff\n //% group=\"Configuration\"\n export function setCursor(enabled: boolean) {\n const l = screen();\n if (!l) return;\n\n l.cursor = !!enabled;\n }\n}",
"pxt.json": "{\n \"name\": \"lcd\",\n \"description\": \"Characeter LCD driver\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"characterlcd.ts\",\n \"characterlcdmono.ts\",\n \"characterlcdrbg.ts\",\n \"lcd.ts\",\n \"lcd.cpp\",\n \"pxtparts.json\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"icon\": \"/static/libs/lcd.png\"\n}\n",
"pxtparts.json": "{\n \"lcd\": {\n \"simulationBehavior\": \"lcd\",\n \"visual\": {\n \"builtIn\": \"lcd\",\n \"width\": 322.7900085449219,\n \"height\": 129.2734832763672,\n \"pinDistance\": 15,\n \"pinLocations\": [\n {\n \"x\": 11.983749261125496,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 174.95982904462969,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 86.06377405577577,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 71.24775738046868,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 56.431758730357025,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 41.61576008024537,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 26.799752417536006,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 189.77581868214364,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 160.14380335672487,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 219.40781598236694,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 204.59180831965756,\n \"y\": 8.037069860858837\n },\n {\n \"x\": 234.22384167027172,\n \"y\": 8.037069860858837\n }\n ]\n },\n \"numberOfPins\": 12,\n \"instantiation\": {\n \"kind\": \"singleton\"\n },\n \"pinDefinitions\": [\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"LCD_DATALINE5\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"LCD_ENABLE\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"LCD_RESET\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"fiveVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"LCD_DATALINE6\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"LCD_DATALINE4\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"fiveVolt\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"LCD_DATALINE7\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n },\n {\n \"target\": \"ground\",\n \"style\": \"male\",\n \"orientation\": \"-Z\"\n }\n ],\n \"assembly\": [\n {\n \"pinIndices\": [\n 0,\n 1,\n 2,\n 3,\n 4,\n 5,\n 6,\n 7,\n 8,\n 9,\n 10,\n 11\n ]\n }\n ]\n }\n}",
"test.ts": "//\n"
},
"color": {
"README.md": "# Colors\n\nColor manipulation",
"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}",
"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}",
"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\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"weight\": 1\n}\n"
},
"color-sensor": {
"README.md": "# Color Sensor\n\nAmbient light sensor",
"colorsensor.ts": "namespace sensors {\n export interface ColorSensor {\n /**\n * Reads an RGB color from the sensor\n */\n color(): number;\n }\n}\n\nnamespace input {\n let _colorSensor: sensors.ColorSensor;\n\n /**\n * Uses a color sensor to capture the ambient color as a RGB value.\n */\n //% blockId=sensor_lightcolor block=\"light color\"\n //% group=\"Color Sensor\"\n export function lightColor(): number {\n if (!_colorSensor)\n _colorSensor = new sensors.TCS34725();\n return _colorSensor.color();\n }\n}",
"pxt.json": "{\n \"name\": \"color-sensor\",\n \"description\": \"Color sensor (TCS24725)\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"colorsensor.ts\",\n \"tcs34725.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"tcs34725.ts": "/**\n * Makecode package for the TCS34725 Color sensor.\n * \n * More details here: https://ams.com/documents/20143/36005/TCS3472_DS000390_2-00.pdf/6e452176-2407-faaf-a590-d526c78c7432\n */\nnamespace sensors {\n\n const TCS34725_I2C_ADDRESS = 0x29 //I2C address of the TCS34725 (Page 34)\n\n /* TCS34725 register addresses (Page 20)*/\n\n const TCS34725_REGISTER_COMMAND = 0x80\t\t// Specifies register address \n\n const TCS34725_REGISTER_ENABLE = 0x00\t\t// Enables states and interrupts\n const TCS34725_REGISTER_AIEN_ENABLE = 0x10\t// RGBC interrupt enable. When asserted, permits RGBC interrupts to be generated.\n const TCS34725_REGISTER_WEN_ENABLE = 0x08\t// Wait enable. This bit activates the wait feature. Writing a 1 activates the wait timer. Writing a 0 disables the wait timer.\n const TCS34725_REGISTER_AEN_ENABLE = 0x02\t// RGBC enable. This bit actives the two-channel ADC. Writing a 1 activates the RGBC. Writing a 0 disables the RGBC.\n const TCS34725_REGISTER_PON_ENABLE = 0x01\t// Power ON. This bit activates the internal oscillator to permit the timers and ADC channels to operate. Writing a 1 activates the oscillator. Writing a 0 disables the oscillator\n\n const TCS34725_REGISTER_ATIME = 0x01\t\t// The RGBC timing register controls the internal integration time of the RGBC clear and IR channel ADCs in 2.4-ms increments.\n const TCS34725_REGISTER_WTIME = 0x03\t\t// Wait time is set 2.4 ms increments unless the WLONG bit is asserted, in which case the wait times are 12× longer. WTIME is programmed as a 2’s complement number.\n\n const TCS34725_REGISTER_AILTL = 0x04\t\t// Clear interrupt low threshold low byte\n const TCS34725_REGISTER_AILTH = 0x05\t\t// Clear interrupt low threshold high byte\n const TCS34725_REGISTER_AIHTL = 0x06\t\t// Clear interrupt high threshold low byte\n const TCS34725_REGISTER_AIHTH = 0x07\t\t// Clear interrupt high threshold high byte\n\n const TCS34725_REGISTER_PERS = 0x0C\t\t // The persistence register controls the filtering interrupt capabilities of the device.\n\n const TCS34725_REGISTER_CONFIG = 0x0D\t\t// The configuration register sets the wait long time.\n const TCS34725_REGISTER_CONFIG_WLONG = 0x02\t// Configuration: Wait Long. When asserted, the wait cycles are increased by a factor 12× from that programmed in the WTIME register\n\n const TCS34725_REGISTER_CONTROL = 0x0F\t\t// The Control register provides eight bits of miscellaneous control to the analog block. These bits typically control functions such as gain settings and/or diode selection\n const TCS34725_REGISTER_ID = 0x12\t\t // The ID Register provides the value for the part number. The ID register is a read-only register.\n\n const TCS34725_REGISTER_STATUS = 0x13\t\t // The Status Register provides the internal status of the device. This register is read only.\n const TCS34725_REGISTER_STATUS_AINT = 0x10\t\t// Device status: RGBC clear channel Interrupt\n const TCS34725_REGISTER_STATUS_AVALID = 0x01\t// Device status: RGBC Valid. Indicates that the RGBC channels have completed an integration cycle\n\n const TCS34725_REGISTER_CDATAL = 0x14\t\t// Clear data low byte\n const TCS34725_REGISTER_CDATAH = 0x15\t\t// Clear data high byte\n\n const TCS34725_REGISTER_RDATAL = 0x16\t\t// Red data low byte\n const TCS34725_REGISTER_RDATAH = 0x17\t\t// Red data high byte\n\n const TCS34725_REGISTER_GDATAL = 0x18\t\t// Green data low byte\n const TCS34725_REGISTER_GDATAH = 0x19\t\t// Green data high byte\n\n const TCS34725_REGISTER_BDATAL = 0x1A\t\t// Blue data low byte\n const TCS34725_REGISTER_BDATAH = 0x1B\t\t// Blue data high byte\n\n\n /* #region Enums for Modes, etc */\n\n // Parameters for setting the internal integration time of the RGBC clear and IR channel.\n export enum TCS34725_ATIME {\n ATIME_2_4_MS = 0xFF, // 1 2.4 ms 1024\n ATIME_24_MS = 0xF6, // 10 24 ms 10240\n ATIME_100_MS = 0xD5, // 42 101 ms 43008\n ATIME_154_MS = 0xC0, // 64 154 ms 65535\n ATIME_700_MS = 0x00 // 256 700 ms 65535\n }\n\n // Parameters for setting the wait time register.\n enum TCS34725_WTIME {\n WTIME_2_4_MS = 0xFF, // 1 2.4 ms 0.029 sec\n WTIME_204_MS = 0xAB, // 85 204 ms 2.45 sec\n WTIME_614_MS = 0x00 // 256 614 ms 7.4 sec\n }\n\n // Parameters for setting the persistence register. The persistence register controls the filtering interrupt capabilities of the device.\n enum TCS34725_APERS {\n APERS_0_CLEAR = 0b0000, // Every RGBC cycle generates an interrupt\n APERS_1_CLEAR = 0b0001, // 1 clear channel value outside of threshold range\n APERS_2_CLEAR = 0b0010, // 2 clear channel consecutive values out of range\n APERS_3_CLEAR = 0b0011, // 3 clear channel consecutive values out of range\n APERS_5_CLEAR = 0b0100, // 5 clear channel consecutive values out of range\n APERS_10_CLEAR = 0b0101, // 10 clear channel consecutive values out of range\n APERS_15_CLEAR = 0b0110, // 15 clear channel consecutive values out of range\n APERS_20_CLEAR = 0b0111, // 20 clear channel consecutive values out of range\n APERS_25_CLEAR = 0b1000, // 25 clear channel consecutive values out of range\n APERS_30_CLEAR = 0b1001, // 30 clear channel consecutive values out of range\n APERS_35_CLEAR = 0b1010, // 35 clear channel consecutive values out of range\n APERS_40_CLEAR = 0b1011, // 40 clear channel consecutive values out of range\n APERS_45_CLEAR = 0b1100, // 45 clear channel consecutive values out of range\n APERS_50_CLEAR = 0b1101, // 50 clear channel consecutive values out of range\n APERS_55_CLEAR = 0b1110, // 55 clear channel consecutive values out of range\n APERS_60_CLEAR = 0b1111, // 60 clear channel consecutive values out of range\n }\n\n // Parameters for setting the gain of the sensor.\n enum TCS34725_AGAIN {\n AGAIN_1X = 0x0, // 1x gain\n AGAIN_4X = 0x1, // 4x gain\n AGAIN_16X = 0x2, // 16x gain\n AGAIN_60X = 0x3 // 60x gain\n }\n\n\n export class TCS34725 implements sensors.ColorSensor {\n isConnected: boolean;\n atimeIntegrationValue: TCS34725_ATIME;\n gainSensorValue: TCS34725_AGAIN;\n\n constructor() {\n this.isConnected = false;\n this.atimeIntegrationValue = 0;\n this.gainSensorValue = 0;\n\n this.start(TCS34725_ATIME.ATIME_2_4_MS, TCS34725_AGAIN.AGAIN_1X);\n }\n\n private connect() {\n let retry = 0;\n while (!this.isConnected && retry < 5) {\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER READ: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_ID (0x12)\n const device_id = pins.i2cReadRegister(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_ID)\n\n //Check that device Identification has one of 2 i2c addresses \n if ((device_id == 0x44) || (device_id == 0x10))\n this.isConnected = true;\n\n retry++;\n }\n }\n\n private turnSensorOn() {\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER VALUE: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_ENABLE (0x00)\n //REGISTER WRITE: TCS34725_REGISTER_PON_ENABLE (0x01)\n pins.i2cWriteRegister(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_ENABLE, TCS34725_REGISTER_PON_ENABLE);\n basic.pause(300);\n\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER VALUE: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_ENABLE (0x00)\n //REGISTER WRITE: TCS34725_REGISTER_PON_ENABLE (0x01) | TCS34725_REGISTER_AEN_ENABLE (0x02) \n pins.i2cWriteRegister(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_ENABLE, TCS34725_REGISTER_PON_ENABLE | TCS34725_REGISTER_AEN_ENABLE);\n\n this.pauseSensorForIntegrationTime();\n }\n\n private pauseSensorForIntegrationTime() {\n switch (this.atimeIntegrationValue) {\n case TCS34725_ATIME.ATIME_2_4_MS: {\n basic.pause(2.4);\n break;\n }\n case TCS34725_ATIME.ATIME_24_MS: {\n basic.pause(24);\n break;\n }\n case TCS34725_ATIME.ATIME_100_MS: {\n basic.pause(100);\n break;\n }\n case TCS34725_ATIME.ATIME_154_MS: {\n basic.pause(154);\n break;\n }\n case TCS34725_ATIME.ATIME_700_MS: {\n basic.pause(700);\n break;\n }\n }\n }\n\n private turnOff() {\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER READ: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_ID (0x12) \n let sensorReg = pins.i2cReadNumber(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_ENABLE);\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER VALUE: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_ENABLE (0x00)\n //REGISTER WRITE: sensorReg & ~(TCS34725_REGISTER_PON_ENABLE (0x01) | TCS34725_REGISTER_AEN_ENABLE (0x02)) \n pins.i2cWriteRegister(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_ENABLE, sensorReg & ~(TCS34725_REGISTER_PON_ENABLE | TCS34725_REGISTER_AEN_ENABLE));\n }\n\n setATIMEintegration(atime: TCS34725_ATIME) {\n //Always make sure the color sensor is connected. Useful for cases when this block is used but the sensor wasn't set randomly. \n this.connect();\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER VALUE: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_ATIME (0x01)\n //REGISTER WRITE: atime \n pins.i2cWriteRegister(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_ATIME, atime)\n this.atimeIntegrationValue = atime;\n\n }\n\n setGAINsensor(gain: TCS34725_AGAIN) {\n //Always make sure the color sensor is connected. Useful for cases when this block is used but the sensor wasn't set randomly. \n this.connect();\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER VALUE: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_CONTROL (0x0F)\n //REGISTER WRITE: gain \n pins.i2cWriteRegister(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_CONTROL, gain)\n\n this.gainSensorValue = gain;\n }\n\n private start(atime: TCS34725_ATIME, gain: TCS34725_AGAIN) {\n this.connect();\n this.setATIMEintegration(atime);\n this.setGAINsensor(gain);\n this.turnSensorOn();\n }\n\n color(): number {\n //Always check that sensor is/was turned on\n this.connect();\n\n if (!this.isConnected)\n return 0;\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER READ: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_RDATAL (0x16) \n const redColorValue = pins.i2cReadRegister(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_RDATAL, NumberFormat.UInt16LE);\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER READ: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_GDATAL (0x18) \n const greenColorValue = pins.i2cReadRegister(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_GDATAL, NumberFormat.UInt16LE);\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER READ: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_BDATAL (0x1A) \n const blueColorValue = pins.i2cReadRegister(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_BDATAL, NumberFormat.UInt16LE);\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER READ: TCS34725_REGISTER_COMMAND (0x80) | TCS34725_REGISTER_CDATAL (0x14) \n const clearColorValue = pins.i2cReadRegister(TCS34725_I2C_ADDRESS, TCS34725_REGISTER_COMMAND | TCS34725_REGISTER_CDATAL, NumberFormat.UInt16LE);\n\n this.pauseSensorForIntegrationTime();\n\n if (clearColorValue == 0)\n return 0;\n else {\n const sum = clearColorValue;\n const r = ((redColorValue / sum) * 255) & 0xff;\n const g = ((greenColorValue / sum) * 255) & 0xff;\n const b = ((blueColorValue / sum) * 255) & 0xff;\n\n return (r << 16) | (g << 8) | b;\n }\n }\n }\n}\n",
"test.ts": "// tests\n"
},
"light-spectrum-sensor": {
"README.md": "# Color Sensor\n\nAmbient light sensor",
"pxt.json": "{\n \"name\": \"light-spectrum-sensor\",\n \"description\": \"Light Spectrum sensor (TSL2591)\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"sensor.ts\",\n \"tsl2591.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"sensor.ts": "namespace sensors {\n export const enum LightSpectrumRange {\n Full = 10,\n Infrared = 20,\n Visible = 40\n }\n \n export const enum LightSpectrumEvent {\n FullBright = LightSpectrumRange.Full | DAL.LEVEL_THRESHOLD_HIGH,\n FullDark = LightSpectrumRange.Full | DAL.LEVEL_THRESHOLD_LOW,\n InfraredBright = LightSpectrumRange.Infrared | DAL.LEVEL_THRESHOLD_HIGH,\n InfraredDark = LightSpectrumRange.Infrared | DAL.LEVEL_THRESHOLD_LOW,\n VisibleBright = LightSpectrumRange.Visible | DAL.LEVEL_THRESHOLD_HIGH,\n VisibleDark = LightSpectrumRange.Visible | DAL.LEVEL_THRESHOLD_LOW\n }\n\n \n export class LightSpectrum {\n full: number;\n infrared: number;\n visible: number;\n normalized: number;\n\n constructor() {\n this.full = -1;\n this.infrared = -1;\n this.visible = -1;\n this.normalized = -1;\n }\n }\n\n export class LightSpectrumSensor {\n public id: number;\n private reading: boolean;\n private _spectrum: LightSpectrum;\n private normalizedLevelDetector: pins.LevelDetector;\n\n constructor(id: number) {\n this.id = id;\n this.reading = false;\n this._spectrum = new LightSpectrum();\n }\n protected readSpectrum(): LightSpectrum {\n return new LightSpectrum();\n }\n protected startReading() {\n if (this.reading) return;\n this.reading = true;\n control.runInBackground(() => {\n this.normalizedLevelDetector = new pins.LevelDetector(this.id, 0, 1023, 50, 900);\n this.normalizedLevelDetector.onHigh = () => control.raiseEvent(this.id, LightSpectrumEvent.VisibleBright);\n this.normalizedLevelDetector.onLow = () => control.raiseEvent(this.id, LightSpectrumEvent.VisibleDark);\n while (this.reading) {\n let spec = this.readSpectrum();\n if (spec.full != -1 && spec.infrared != -1 && spec.visible != -1) {\n this._spectrum = spec;\n this.normalizedLevelDetector.level = spec.normalized;\n }\n pause(1);\n }\n });\n }\n\n spectrum(): LightSpectrum {\n if (!this.reading) {\n this._spectrum = this.readSpectrum();\n this.startReading();\n }\n return this._spectrum;\n }\n\n onEvent(event: LightSpectrumEvent, handler: () => void): void {\n this.startReading();\n control.onEvent(this.id, event, handler);\n }\n }\n}\n\nnamespace input {\n let _sensor: sensors.LightSpectrumSensor;\n export function lightSpectrumSensor(): sensors.LightSpectrumSensor {\n if (!_sensor)\n _sensor = new sensors.TSL2591(9980); // TODO\n return _sensor;\n }\n\n /**\n * Uses a light spectrum sensor to capture the light spectrum range\n */\n //% blockId=sensor_light_spectrum block=\"light $range spectrum\"\n //% group=\"Light Spectrum Sensor\"\n export function lightSpectrum(range: sensors.LightSpectrumRange): number {\n const sensor = lightSpectrumSensor();\n if (sensor) {\n const spectrum = sensor.spectrum();\n if (spectrum) {\n switch (range) {\n case sensors.LightSpectrumRange.Full: return spectrum.full;\n case sensors.LightSpectrumRange.Infrared: return spectrum.infrared;\n case sensors.LightSpectrumRange.Visible: return spectrum.visible;\n }\n }\n }\n return -1;\n }\n\n /**\n * Register code to run when the light condition changed\n * @param event\n * @param handler\n */\n export function onLightSpectrumConditionChanged(event: sensors.LightSpectrumEvent, handler: () => void): void {\n const sensor = lightSpectrumSensor();\n if (sensor)\n sensor.onEvent(event, handler);\n }\n}",
"test.ts": "// tests\n",
"tsl2591.ts": "namespace sensors {\n /**\n * Makecode package for the TSL2591 Light sensor.\n *\n * More details here: https://ams.com/documents/20143/36005/TSL2591_DS000338_6-00.pdf/090eb50d-bb18-5b45-4938-9b3672f86b80\n */\n\n const TSL2591_I2C_ADDRESS = 0x29 //I2C address of the TSL2591 (Page 28)\n\n //See Page 13 for full register description of TSL2591\n\n const TSL2591_REGISTER_COMMAND = 0xA0\t// Select Command Register. CMD: Must write as 1 when addressing COMMAND register + TRANSACTION: 01 Normal Operation (1010 0000)\n\n const TSL2591_REGISTER_COMMAND_SET_INT = 0xE4\t// Interrupt set – forces an interrupt (11100100)\n const TSL2591_REGISTER_COMMAND_CLEAR_ALS_INT = 0xE6\t// Clears ALS interrupt (11100110)\n const TSL2591_REGISTER_COMMAND_CLEAR_ALS_NO_PERS_INT = 0xE7\t// Clears ALS and no persist ALS interrupt (11100111)\n const TSL2591_REGISTER_COMMAND_CLEAR_NO_PERS_INT = 0xEA\t// Clears no persist ALS interrupt (11101010)\n\n const TSL2591_REGISTER_ENABLE = 0x00\t// The ENABLE register is used to power the device on/off, enable functions and interrupts..\n const TSL2591_REGISTER_NPIEN_ENABLE = 0x80\t// No Persist Interrupt Enable. When asserted NP Threshold conditions will generate an interrupt, bypassing the persist filter.\n const TSL2591_REGISTER_SAI_ENABLE = 0x40\t// Sleep after interrupt. When asserted, the device will power down at the end of an ALS cycle if an interrupt has been generated.\n const TSL2591_REGISTER_AIEN_ENABLE = 0x10\t// ALS Interrupt Enable. When asserted permits ALS interrupts to be generated, subject to the persist filter.\n const TSL2591_REGISTER_AEN_ENABLE = 0x02\t// ALS Enable. This field activates ALS function. Writing a one activates the ALS. Writing a zero disables the ALS.\n const TSL2591_REGISTER_PON_ENABLE = 0x01\t// Power ON. This field activates the internal oscillator to permit the timers and ADC channels to operate. Writing a one activates the oscillator. Writing a zero disables the oscillator.\n const TSL2591_REGISTER_POFF_ENABLE = 0x00\t// Power OFF. This field activates the internal oscillator to permit the timers and ADC channels to operate. Writing a one activates the oscillator. Writing a zero disables the oscillator.\n\n const TSL2591_REGISTER_CONTROL = 0x01\t// The CONTROL register is used to configure the ALS gain and integration time. In addition, a system reset is provided. Upon power up, the CONTROL register resets to 0x00.\n const TSL2591_REGISTER_CONTROL_SRESET = 0x80\t// System reset. When asserted, the device will reset equivalent to a power-on reset. SRESET is self-clearing.\n\n const TSL2591_REGISTER_PID = 0x11\t// The PID register provides an identification of the devices package. This register is a read-only register whose value never changes.\n const TSL2591_REGISTER_ID = 0x12\t// The ID register provides the device identification. This register is a read-only register whose value never changes.\n\n const TSL2591_REGISTER_STATUS = 0x13\t// The Status Register provides the internal status of the device. This register is read only.\n const TSL2591_REGISTER_STATUS_NPINTR = 0x20\t// No-persist Interrupt. Indicates that the device has encountered a no-persist interrupt condition.\n const TSL2591_REGISTER_STATUS_AINT = 0x10\t// ALS Interrupt. Indicates that the device is asserting an ALS interrupt.\n const TSL2591_REGISTER_STATUS_AVALID = 0x01\t// ALS Valid. Indicates that the ADC channels have completed an integration cycle since the AEN bit was asserted.\n\n const TSL2591_REGISTER_C0DATAL = 0x14\t// ALS CH0 data low byte\n const TSL2591_REGISTER_C0DATAH = 0x15\t// ALS CH0 data high byte\n const TSL2591_REGISTER_C1DATAL = 0x16\t// ALS CH1 data low byte\n const TSL2591_REGISTER_C1DATAH = 0x17\t// ALS CH1 data high byte\n\n const TSL2591_REGISTER_AILTL = 0x04\t// ALS low threshold lower byte\n const TSL2591_REGISTER_AILTH = 0x05\t// ALS low threshold upper byte\n const TSL2591_REGISTER_AIHTL = 0x06\t// ALS high threshold lower byte\n const TSL2591_REGISTER_AIHTH = 0x07\t// ALS high threshold upper byte\n const TSL2591_REGISTER_NPAILTL = 0x08\t// No Persist ALS low threshold lower byte\n const TSL2591_REGISTER_NPAILTH = 0x09\t// No Persist ALS low threshold upper byte\n const TSL2591_REGISTER_NPAIHTL = 0x0A\t// No Persist ALS high threshold lower byte\n const TSL2591_REGISTER_NPAIHTH = 0x0B\t// No Persist ALS high threshold upper byte\n\n const TSL2591_REGISTER_PERSIST = 0x0B\t// The Interrupt persistence filter sets the number of consecutive out-of-range ALS cycles necessary to generate an interrupt. Out-of-range is determined by comparing C0DATA (0x14 and 0x15) to the interrupt threshold registers (0x04 - 0x07). Note that the no-persist ALS interrupt is not affected by the interrupt persistence filter. Upon power up, the interrupt persistence filter register resets to 0x00.\n\n\n /* #region Enums for Modes, etc */\n\n // ALS gain sets the gain of the internal integration amplifiers for both photodiode channels.\n enum TSL2591_AGAIN {\n AGAIN_LOW = 0x00, // Low gain mode\n AGAIN_MEDIUM = 0x10, // Medium gain mode\n AGAIN_HIGH = 0x20, // High gain mode\n AGAIN_MAX = 0x30 // Maximum gain mode\n }\n\n // ALS time sets the internal ADC integration time for both photodiode channels.\n enum TSL2591_ATIME {\n ATIME_100_MS = 0x00, // 100 ms\n ATIME_200_MS = 0x01, // 200 ms\n ATIME_300_MS = 0x02, // 300 ms\n ATIME_400_MS = 0x03, // 400 ms\n ATIME_500_MS = 0x04, // 500 ms\n ATIME_600_MS = 0x05 // 600 ms\n }\n\n export class TSL2591 extends sensors.LightSpectrumSensor {\n\n private TSL2591_I2C_ADDR: number;\n private isConnected: boolean;\n private atimeIntegrationValue: TSL2591_ATIME;\n private gainSensorValue: TSL2591_AGAIN;\n\n constructor(id: number) {\n super(id);\n this.atimeIntegrationValue = TSL2591_ATIME.ATIME_100_MS,\n this.gainSensorValue = TSL2591_AGAIN.AGAIN_HIGH,\n this.TSL2591_I2C_ADDR = TSL2591_I2C_ADDRESS;\n this.isConnected = false;\n this.initSensor();\n }\n\n private initSensor() {\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER READ: TSL2591_REGISTER_COMMAND (0x80) | TSL2591_REGISTER_COMMAND_NORMAL (0x20) | TSL2591_REGISTER_ID (0x12)\n let device_id = pins.i2cReadRegister(this.TSL2591_I2C_ADDR, TSL2591_REGISTER_COMMAND | TSL2591_REGISTER_ID)\n //Check that device Identification = 0x50 (Page 19)\n this.isConnected = (device_id == 0x50);\n\n this.configureSensor();\n }\n\n setAtime(atime: TSL2591_ATIME) {\n this.atimeIntegrationValue = atime;\n this.configureSensor();\n }\n\n setGain(gain: TSL2591_AGAIN) {\n this.gainSensorValue = gain;\n this.configureSensor();\n }\n\n private configureSensor() {\n //Always make sure the sensor is connected. Useful for cases when this block is used but the sensor wasn't set randomly.\n if (!this.isConnected)\n return;\n\n //Turn sensor on\n this.enableSensor();\n\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER VALUE: TSL2591_REGISTER_COMMAND (0x80) | TSL2591_REGISTER_CONTROL (0x01)\n //REGISTER WRITE: atimeIntegrationValue | gainSensorValue\n pins.i2cWriteRegister(this.TSL2591_I2C_ADDR, TSL2591_REGISTER_COMMAND | TSL2591_REGISTER_CONTROL, this.atimeIntegrationValue | this.gainSensorValue);\n }\n\n private enableSensor() {\n //1 - First set the command bit to 1, to let the device be set\n //2 - Next, turn it on, then enable ALS, enable ALS Interrupt, and enable No Persist Interrupt\n\n if (this.isConnected)\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER VALUE: TSL2591_REGISTER_COMMAND (0x80) | TSL2591_REGISTER_COMMAND_NORMAL (0x20) | TSL2591_REGISTER_ENABLE (0x00)\n //REGISTER WRITE: TSL2591_REGISTER_PON_ENABLE (0x01) | TSL2591_REGISTER_AEN_ENABLE (0x02) | TSL2591_REGISTER_AIEN_ENABLE (0x10) | TSL2591_REGISTER_NPIEN_ENABLE (0x80)\n pins.i2cWriteRegister(this.TSL2591_I2C_ADDR, TSL2591_REGISTER_COMMAND | TSL2591_REGISTER_ENABLE, TSL2591_REGISTER_PON_ENABLE | TSL2591_REGISTER_AEN_ENABLE /*| TSL2591_REGISTER_AIEN_ENABLE | TSL2591_REGISTER_NPIEN_ENABLE*/)\n }\n\n disableSensor() {\n //1 - First set the command bit to 1, to let the device be set\n //2 - Next, turn it off\n\n if (this.isConnected)\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER VALUE: TSL2591_REGISTER_COMMAND (0x80) | TSL2591_REGISTER_COMMAND_NORMAL (0x20) | TSL2591_REGISTER_ENABLE (0x00)\n //REGISTER WRITE: TSL2591_REGISTER_POFF_ENABLE (0x00)\n pins.i2cWriteRegister(this.TSL2591_I2C_ADDR, TSL2591_REGISTER_COMMAND | TSL2591_REGISTER_ENABLE, TSL2591_REGISTER_POFF_ENABLE)\n }\n\n protected readSpectrum(): LightSpectrum {\n let retVal: LightSpectrum = new LightSpectrum();\n if (this.isConnected) {\n // this.enableSensor();\n // basic.pause(100);\n\n //REGISTER FORMAT: CMD | TRANSACTION | ADDRESS\n //REGISTER READ: TSL2591_REGISTER_COMMAND (0x80) | TSL2591_REGISTER_COMMAND_NORMAL (0x20) | TSL2591_REGISTER_C1DATAL (0x16)\n\n const channel0l = pins.i2cReadRegister(this.TSL2591_I2C_ADDR, TSL2591_REGISTER_COMMAND | TSL2591_REGISTER_C0DATAL);\n const channel0h = pins.i2cReadRegister(this.TSL2591_I2C_ADDR, TSL2591_REGISTER_COMMAND | TSL2591_REGISTER_C0DATAH);\n const channel1l = pins.i2cReadRegister(this.TSL2591_I2C_ADDR, TSL2591_REGISTER_COMMAND | TSL2591_REGISTER_C1DATAL);\n const channel1h = pins.i2cReadRegister(this.TSL2591_I2C_ADDR, TSL2591_REGISTER_COMMAND | TSL2591_REGISTER_C1DATAH);\n // const channel1 = pins.i2cReadRegister(this.TSL2591_I2C_ADDR, TSL2591_REGISTER_COMMAND | TSL2591_REGISTER_C1DATAL, NumberFormat.UInt16LE);\n\n if (channel0l !== undefined && channel0h !== undefined && channel1l !== undefined && channel1h !== undefined) {\n const full = channel0l | (channel0h << 8);\n const ir = channel1l | (channel1h << 8);\n // catch overflow condition when ir and full are equal (max value)\n let visible = (full != ir) ? full - ir : full;\n // control.dmesg(\"RAW C0:\");\n // control.dmesg(channel0l.toString());\n // control.dmesg(channel0h.toString());\n // control.dmesg(\"RAW C1:\");\n // control.dmesg(channel1l.toString());\n // control.dmesg(channel1h.toString());\n // control.dmesg(\"PROC:\");\n // control.dmesg(full.toString());\n // control.dmesg(ir.toString());\n // control.dmesg(visible.toString());\n\n retVal.full = full;\n retVal.infrared = ir;\n retVal.visible = visible;\n retVal.normalized = Math.map(visible, 0, 37888, 0, 1024);\n }\n else\n control.dmesg(\"LSBAD\");\n }\n else\n this.initSensor();\n\n return retVal\n }\n }\n}"
},
"proximity": {
"proximity.ts": "const enum PromixityEvent {\n //% block=\"close\"\n Close = DAL.LEVEL_THRESHOLD_LOW,\n //% block=\"far\"\n Far = DAL.LEVEL_THRESHOLD_HIGH\n}\n\nnamespace sensors {\n export class PromixitySensor {\n private _levelDetector: pins.LevelDetector;\n\n constructor() {\n }\n\n distance(): number {\n return -1;\n }\n\n private levelDetector(): pins.LevelDetector {\n if (!this._levelDetector) {\n this._levelDetector = new pins.LevelDetector(9901, 0, 1023, 45, 600);\n control.runInBackground(() => {\n while(true) {\n this._levelDetector.level = this.distance();\n pause(20);\n }\n })\n }\n return this._levelDetector;\n }\n\n /**\n * Registers an event when a level is detected\n * @param event\n * @param handler\n */\n onDistanceEvent(event: PromixityEvent, handler: () => void) {\n const ld = this.levelDetector();\n control.onEvent(ld.id, event, handler);\n }\n }\n}\n\nnamespace input {\n let _sensor: sensors.PromixitySensor;\n function proximitySensor(): sensors.PromixitySensor {\n if (!_sensor)\n _sensor = new vl53l0x.VL53L0X();\n return _sensor;\n }\n /**\n * Gets the distance measured by the proximity sensor\n */\n //% blockId=proximity_distance block=\"distance\"\n export function distance(): number {\n const sensor = proximitySensor();\n if (!sensor) return -1;\n return sensor.distance();\n }\n\n /**\n * Registers a distance event\n * @param event\n * @param handler\n */\n export function onDistanceEvent(event: PromixityEvent, handler: () => void) {\n const sensor = proximitySensor();\n if (sensor)\n sensor.onDistanceEvent(event, handler);\n }\n}",
"pxt.json": "{\n \"name\": \"proximity\",\n \"description\": \"Proximity drivers\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"proximity.ts\",\n \"vl53l0x.ts\"\n ],\n \"testFiles\": [],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"vl53l0x.ts": "namespace vl53l0x {\n const VL53L0X_SYSRANGE_START = 0x00\n const VL53L0X_REG_SYSRANGE_MODE_BACKTOBACK = 0x0002\n const VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS = 0x29\n\n const VL53L0X_REG_RESULT_RANGE_STATUS = 0x0014;\n\n const VL53L0X_REG_SYSTEM_RANGE_CONFIG = 0x0009;\n\n const VL53L0X_REG_IDENTIFICATION_MODEL_ID = 0x00c0;\n const VL53L0X_REG_IDENTIFICATION_REVISION_ID = 0x00c2;\n const VL53L0X_REG_PRE_RANGE_CONFIG_VCSEL_PERIOD = 0x0050;\n const VL53L0X_REG_FINAL_RANGE_CONFIG_VCSEL_PERIOD = 0x0070;\n const VL53L0X_REG_SYSRANGE_START = 0x0000;\n\n\n export class VL53L0X extends sensors.PromixitySensor {\n private _distance: number;\n constructor() {\n super();\n this.init();\n this._distance = -1;\n }\n\n init() {\n // hoccus pokus!\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x88, 0x00);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x80, 0x01);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0xFF, 0x01);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x00, 0x00);\n pins.i2cReadRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x91);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x91, 0x3c);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x00, 0x01);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0xFF, 0x00);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x80, 0x00);\n\n // abra cadabra!\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x80, 0x01);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0xFF, 0x01);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x00, 0x00);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x91, 0x3c);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x00, 0x01);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0xFF, 0x00);\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 0x80, 0x00);\n\n // alakazam! (continuous mode)\n pins.i2cWriteRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, VL53L0X_SYSRANGE_START, VL53L0X_REG_SYSRANGE_MODE_BACKTOBACK);\n }\n\n /*\n printModelRevision() {\n const rev = pins.i2cReadRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, VL53L0X_REG_IDENTIFICATION_REVISION_ID)\n const model = pins.i2cReadRegister(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, VL53L0X_REG_IDENTIFICATION_MODEL_ID)\n\n control.dmesg(\"REV: \");\n control.dmesg(rev.toString());\n control.dmesg(\"model: \");\n control.dmesg(model.toString());\n }\n */\n\n distance(): number {\n pins.i2cWriteNumber(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, VL53L0X_REG_RESULT_RANGE_STATUS, NumberFormat.UInt8LE)\n const b = pins.i2cReadBuffer(VL53L0X_REG_I2C_SLAVE_DEVICE_ADDRESS, 12);\n const dist = ((b[10] & 0xFF) << 8) | (b[11] & 0xFF);\n\n // control.dmesg(\"READ: \");\n // control.dmesg(dist.toString());\n\n if (dist != 20 && dist != 0)\n this._distance = dist;\n\n return this._distance / 10;\n }\n }\n}"
},
"feather": {
"README.md": "# feather\n\nProvides pin definition for Adafruit Feather compatible boards.\n\n\nSee https://learn.adafruit.com/assets/78438",
"device.d.ts": "declare namespace pins {\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_A0)\n const A0: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_A1)\n const A1: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_A2)\n const A2: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_A3)\n const A3: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_A4)\n const A4: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_A5)\n const A5: PwmPin;\n\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_D0)\n const D0: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_D1)\n const D1: PwmPin;\n\n\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_D4)\n const D4: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_D5)\n const D5: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_D6)\n const D6: PwmPin;\n\n\n\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_D9)\n const D9: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_D10)\n const D10: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_D11)\n const D11: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_D12)\n const D12: PwmPin;\n //% fixedInstance shim=pxt::getPinCfg(CFG_PIN_D13)\n const D13: PwmPin;\n\n}\n",
"pxt.json": "{\n \"name\": \"feather\",\n \"description\": \"Adafruit Feather pinout\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"device.d.ts\",\n \"targetoverrides.d.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"weight\": 2\n}\n",
"targetoverrides.d.ts": "// target specific customizations"
},
"edge-connector": {
"README.md": "# Edge connector\n\nSupport for 20 pin edge connector.\n\n## Config\n\nPin mapping must be specified in config key section.",
"device.d.ts": "declare namespace pins {\n /**\n * Pin P0 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P0)\n const P0: PwmPin;\n\n /**\n * Pin P1 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P1)\n const P1: PwmPin;\n\n /**\n * Pin P2 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P2)\n const P2: PwmPin;\n\n /**\n * Pin P3 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P3)\n const P3: AnalogInPin;\n\n /**\n * Pin P3 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P4)\n const P4: AnalogInPin;\n\n /**\n * Pin P5 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P5)\n const P5: DigitalInOutPin;\n\n /**\n * Pin P6 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P6)\n const P6: DigitalInOutPin;\n\n /**\n * Pin P7 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P7)\n const P7: DigitalInOutPin;\n\n /**\n * Pin P8 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P8)\n const P8: DigitalInOutPin;\n\n /**\n * Pin P9 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P9)\n const P9: DigitalInOutPin;\n\n /**\n * Pin P10 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P10)\n const P10: AnalogInPin;\n\n /**\n * Pin P11 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P11)\n const P11: DigitalInOutPin;\n\n /**\n * Pin P12 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P12)\n const P12: DigitalInOutPin;\n\n /**\n * Pin P13 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P13)\n const P13: DigitalInOutPin;\n\n /**\n * Pin P14 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P14)\n const P14: DigitalInOutPin;\n\n /**\n * Pin P15 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P15)\n const P15: DigitalInOutPin;\n\n /**\n * Pin P16 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P16)\n const P16: PwmPin;\n\n /**\n * Pin P19 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P19)\n const P19: DigitalInOutPin;\n\n /**\n * Pin P20 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P20)\n const P20: DigitalInOutPin;\n\n /**\n * Pin P21 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P21)\n const P21: PwmPin;\n\n /**\n * Pin P22 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P22)\n const P22: PwmPin;\n\n /**\n * Pin P23 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P23)\n const P23: PwmPin;\n\n /**\n * Pin P24 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P24)\n const P24: PwmPin;\n\n /**\n * Pin P25 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P25)\n const P25: PwmPin;\n\n /**\n * Pin P26 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P26)\n const P26: PwmPin;\n\n /**\n * Pin P27 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P27)\n const P27: PwmPin;\n\n /**\n * Pin P28 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P28)\n const P28: PwmPin;\n\n /**\n * Pin P29 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P29)\n const P29: PwmPin;\n\n /**\n * Pin P30 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P30)\n const P30: PwmPin;\n\n /**\n * Pin P31 on the edge connector\n */\n //% fixedInstance shim=pxt::lookupPinCfg(CFG_PIN_P31)\n const P31: PwmPin;\n}\n",
"pinscompat.ts": "// this type alias is required for backward compatibility\n// it gets overriden in microbit (DigitalPin is an enum over there)\nenum DigitalPin {\n P0 = DAL.CFG_PIN_P0,\n P1 = DAL.CFG_PIN_P1,\n P2 = DAL.CFG_PIN_P2,\n P3 = DAL.CFG_PIN_P3,\n P4 = DAL.CFG_PIN_P4,\n P5 = DAL.CFG_PIN_P5,\n P6 = DAL.CFG_PIN_P6,\n P7 = DAL.CFG_PIN_P7,\n P8 = DAL.CFG_PIN_P8,\n P9 = DAL.CFG_PIN_P9,\n P10 = DAL.CFG_PIN_P10,\n P11 = DAL.CFG_PIN_P11,\n P12 = DAL.CFG_PIN_P12,\n P13 = DAL.CFG_PIN_P13,\n P14 = DAL.CFG_PIN_P14,\n P15 = DAL.CFG_PIN_P15,\n P16 = DAL.CFG_PIN_P16,\n P19 = DAL.CFG_PIN_P19,\n P20 = DAL.CFG_PIN_P20\n}\n\nenum AnalogPin {\n P0 = DAL.CFG_PIN_P0,\n P1 = DAL.CFG_PIN_P1,\n P2 = DAL.CFG_PIN_P2,\n P3 = DAL.CFG_PIN_P3,\n P4 = DAL.CFG_PIN_P4,\n P10 = DAL.CFG_PIN_P10,\n P5 = DAL.CFG_PIN_P5,\n P6 = DAL.CFG_PIN_P6,\n P7 = DAL.CFG_PIN_P7,\n P8 = DAL.CFG_PIN_P8,\n P9 = DAL.CFG_PIN_P9,\n P11 = DAL.CFG_PIN_P11,\n P12 = DAL.CFG_PIN_P12,\n P13 = DAL.CFG_PIN_P13,\n P14 = DAL.CFG_PIN_P14,\n P15 = DAL.CFG_PIN_P15,\n P16 = DAL.CFG_PIN_P16,\n P19 = DAL.CFG_PIN_P19,\n P20 = DAL.CFG_PIN_P20\n}\n\nnamespace pins {\n /**\n * Sets the pin pull\n * @param pin \n * @param mode \n */\n //% deprecated=1\n export function setPull(pin: DigitalPin, mode: PinPullMode) {\n const p = pins.pinByCfg(pin);\n if (p)\n p.setPull(mode);\n }\n\n /**\n * Sets the digital pin status\n * @param pin\n * @param value \n */\n //% deprecated=1\n export function digitalWritePin(pin: DigitalPin, value: number) {\n const p = pins.pinByCfg(pin);\n if (p)\n p.digitalWrite(!!value);\n }\n\n /**\n * Reads the pin status\n * @param pin \n */\n //% deprecated=1\n export function digitalReadPin(pin: DigitalPin): number {\n const p = pins.pinByCfg(pin);\n return p && p.digitalRead() ? 1 : 0;\n }\n\n /**\n * Sets the digital pin status\n * @param pin \n * @param value \n */\n //% deprecated=1\n export function analogWritePin(pin: AnalogPin, value: number) {\n const p = pins.pinByCfg(pin) as AnalogOutPin;\n if (p)\n p.analogWrite(value);\n }\n\n /**\n * Reads the pin status\n * @param pin \n */\n //% deprecated=1\n export function analogReadPin(pin: AnalogPin): number {\n const p = pins.pinByCfg(pin) as AnalogInPin;\n if (p)\n return p.analogRead();\n else \n return 0;\n }\n\n /**\n * Make this pin a digital input, and create events where the timestamp is the duration\n * that this pin was either ``high`` or ``low``.\n */\n //% deprecated=1\n export function onPulsed(pin: DigitalPin, pulse: PulseValue, body: () => void): void {\n const p = pins.pinByCfg(pin);\n if (p)\n p.onPulsed(pulse, body);\n }\n\n /**\n * Register code to run when a pin event occurs. \n */\n //% deprecated=1\n export function onEvent(pin: DigitalPin, event: PinEvent, body: () => void): void {\n const p = pins.pinByCfg(pin);\n if (p)\n p.onEvent(event, body);\n }\n\n /**\n * Return the duration of a pulse in microseconds\n * @param name the pin which measures the pulse\n * @param value the value of the pulse (default high)\n * @param maximum duration in micro-seconds\n */\n //% deprecated=1\n export function pulseIn(pin: DigitalPin, value: PulseValue, maxDuration?: number): number {\n const p = pins.pinByCfg(pin);\n if (p)\n return p.pulseIn(value, maxDuration);\n else \n return 0;\n }\n\n export function map(value: number, fromLow: number, fromHigh: number, toLow: number, toHigh: number): number {\n return Math.map(value, fromLow, fromHigh, toLow, toHigh);\n }\n}",
"pxt.json": "{\n \"name\": \"edge-connector\",\n \"description\": \"20 pin Edge Connector\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"device.d.ts\",\n \"pinscompat.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n"
},
"esp32": {
"README.md": "# ESP32\n\nCommunication layer to a accessory ESP32 chip.\n\n> Ported from Adafruit Circuit Python \nhttps://github.com/adafruit/Adafruit_CircuitPython_ESP32SPI.\n\n## Configuration\n\n### Nina-FW over SPI\n\nThe companion firmware is https://github.com/adafruit/nina-fw over SPI.\nThe pins of the main board need to be configured either in the bootloader or using `namespace userconfig { ... }`.\nThe ESP32 pins are listed next to each key below (the number in parenthesis is the pin number on WROOM-32 module).\n\n* ``PIN_WIFI_CS``, ESP32 CS pin mapping, IO5 (29)\n* ``PIN_WIFI_BUSY``, ESP32 BUSY pin mapping, IO33 (9)\n* ``PIN_WIFI_RESET``, ESP32 RESET pin mapping, EN (3)\n* ``PIN_WIFI_GPIO0`` (optional), ESP32 GPIO0 pin mapping, IO0 (25)\n\nThe driver uses the default SPI pins. You can override this behavior by specifying these 3 keys.\n\n* ``PIN_WIFI_MOSI`` (optional), dedicated SPI MOSI pin, IO14 (13)\n* ``PIN_WIFI_MISO`` (optional), dedicated SPI MISO pin, IO23 (37)\n* ``PIN_WIFI_SCK`` (optional), dedicated SPI SCK pin, IO18 (30)\n\n### Expressif AT commands over serial\n\nNot supported yet.\n\n* ``PIN_WIFI_AT_RX``, ESP32 RX pin mapping\n* ``PIN_WIFI_AT_TX``, ESP32 TX pin mapping\n\n## Access Points and passwords\n\nThe module uses access points and password information stored in the device secrets. These secrets can be set programmatically using ``net.updateAccessPoint`` or via the menu items in Arcade (added via the ``net-game`` extension).\n\n> *Friendly reminder:* Do not share .uf2 files or programs with secrets!!\n\n## Example\n\nSee net package readme.",
"net.ts": "namespace esp32 {\n let _defaultController: net.Controller;\n function defaultController(): net.Controller {\n // cached\n if (_defaultController) return _defaultController;\n\n /*\n // look for ESP32 over serial pins\n const rx = pins.pinByCfg(DAL.CFG_PIN_WIFI_AT_RX);\n const tx = pins.pinByCfg(DAL.CFG_PIN_WIFI_AT_TX);\n if (rx && tx) {\n const dev = serial.createSerial(rx, tx);\n return _defaultController = new ATController(dev);\n }\n */\n\n // look for ESP32 over SPI pins\n const cs = pins.pinByCfg(DAL.CFG_PIN_WIFI_CS)\n const busy = pins.pinByCfg(DAL.CFG_PIN_WIFI_BUSY);\n const reset = pins.pinByCfg(DAL.CFG_PIN_WIFI_RESET);\n const gpio0 = pins.pinByCfg(DAL.CFG_PIN_WIFI_GPIO0); // optional\n if (!!cs && !!busy && !!reset) {\n // grab SPI pins and go\n const mosi = pins.pinByCfg(DAL.CFG_PIN_WIFI_MOSI);\n const miso = pins.pinByCfg(DAL.CFG_PIN_WIFI_MISO);\n const sck = pins.pinByCfg(DAL.CFG_PIN_WIFI_SCK);\n let spi: SPI;\n if (!mosi && !miso && !sck) {\n spi = pins.spi();\n } else if (mosi && miso && sck) {\n spi = pins.createSPI(mosi, miso, sck);\n } else {// SPI misconfigured\n net.log(\"esp32 spi configuration error\");\n control.panic(control.PXT_PANIC.CODAL_HARDWARE_CONFIGURATION_ERROR);\n }\n if (spi)\n return _defaultController = new NinaController(spi, cs, busy, reset, gpio0);\n } else if (!cs && !busy && !reset) {\n return undefined;\n // do nothing, panic later\n } else { // cs,busy,reset misconfigured\n net.log(\"esp32 partially configured\");\n control.panic(control.PXT_PANIC.CODAL_HARDWARE_CONFIGURATION_ERROR);\n }\n\n // no option\n net.log(\"esp32 configuration error\");\n control.panic(control.PXT_PANIC.CODAL_HARDWARE_CONFIGURATION_ERROR);\n return undefined;\n }\n\n // initialize net\n new net.Net(defaultController);\n}",
"ninacontroller.ts": "namespace esp32 {\n // pylint: disable=bad-whitespace\n const _SET_NET_CMD = 0x10\n const _SET_PASSPHRASE_CMD = 0x11\n const _SET_DEBUG_CMD = 0x1A\n const _GET_TEMP_CMD = 0x1B\n const _GET_CONN_STATUS_CMD = 0x20\n const _GET_IPADDR_CMD = 0x21\n const _GET_MACADDR_CMD = 0x22\n const _GET_CURR_SSID_CMD = 0x23\n const _GET_CURR_RSSI_CMD = 0x25\n const _GET_CURR_ENCT_CMD = 0x26\n const _SCAN_NETWORKS = 0x27\n const _GET_SOCKET_CMD = 0x3F\n const _GET_STATE_TCP_CMD = 0x29\n const _DATA_SENT_TCP_CMD = 0x2A\n const _AVAIL_DATA_TCP_CMD = 0x2B\n const _GET_DATA_TCP_CMD = 0x2C\n const _START_CLIENT_TCP_CMD = 0x2D\n const _STOP_CLIENT_TCP_CMD = 0x2E\n const _GET_CLIENT_STATE_TCP_CMD = 0x2F\n const _DISCONNECT_CMD = 0x30\n const _GET_IDX_RSSI_CMD = 0x32\n const _GET_IDX_ENCT_CMD = 0x33\n const _REQ_HOST_BY_NAME_CMD = 0x34\n const _GET_HOST_BY_NAME_CMD = 0x35\n const _START_SCAN_NETWORKS = 0x36\n const _GET_FW_VERSION_CMD = 0x37\n const _PING_CMD = 0x3E\n const _SEND_DATA_TCP_CMD = 0x44\n const _GET_DATABUF_TCP_CMD = 0x45\n const _SET_ENT_IDENT_CMD = 0x4A\n const _SET_ENT_UNAME_CMD = 0x4B\n const _SET_ENT_PASSWD_CMD = 0x4C\n const _SET_ENT_ENABLE_CMD = 0x4F\n const _SET_PIN_MODE_CMD = 0x50\n const _SET_DIGITAL_WRITE_CMD = 0x51\n const _SET_ANALOG_WRITE_CMD = 0x52\n const _START_CMD = 0xE0\n const _END_CMD = 0xEE\n const _ERR_CMD = 0xEF\n const _REPLY_FLAG = 1 << 7\n const _CMD_FLAG = 0\n export const SOCKET_CLOSED = 0\n export const SOCKET_LISTEN = 1\n export const SOCKET_SYN_SENT = 2\n export const SOCKET_SYN_RCVD = 3\n export const SOCKET_ESTABLISHED = 4\n export const SOCKET_FIN_WAIT_1 = 5\n export const SOCKET_FIN_WAIT_2 = 6\n export const SOCKET_CLOSE_WAIT = 7\n export const SOCKET_CLOSING = 8\n export const SOCKET_LAST_ACK = 9\n export const SOCKET_TIME_WAIT = 10\n export const WL_NO_SHIELD = 0xFF\n export const WL_NO_MODULE = 0xFF\n export const WL_IDLE_STATUS = 0\n export const WL_NO_SSID_AVAIL = 1\n export const WL_SCAN_COMPLETED = 2\n export const WL_CONNECTED = 3\n export const WL_CONNECT_FAILED = 4\n export const WL_CONNECTION_LOST = 5\n export const WL_DISCONNECTED = 6\n export const WL_AP_LISTENING = 7\n export const WL_AP_CONNECTED = 8\n export const WL_AP_FAILED = 9\n\n\n function buffer1(ch: number) {\n const b = control.createBuffer(1)\n b[0] = ch\n return b\n }\n\n export class NinaController extends net.Controller {\n private _socknum_ll: Buffer[];\n private _locked: boolean;\n\n public wasConnected: boolean;\n\n constructor(\n private _spi: SPI,\n private _cs: DigitalInOutPin,\n private _busy: DigitalInOutPin,\n private _reset: DigitalInOutPin,\n private _gpio0: DigitalInOutPin = null\n ) {\n super();\n // if nothing connected, pretend the device is ready -\n // we'll check for timeout waiting for response instead\n this._busy.setPull(PinPullMode.PullDown);\n this._busy.digitalRead();\n this._socknum_ll = [buffer1(0)]\n this._spi.setFrequency(8000000);\n this.reset();\n this._locked = false;\n }\n\n /** \n * Hard reset the ESP32 using the reset pin \n */\n public reset(): void {\n if (this._gpio0)\n this._gpio0.digitalWrite(true);\n this._cs.digitalWrite(true)\n this._reset.digitalWrite(false)\n // reset\n pause(10)\n this._reset.digitalWrite(true)\n // wait for it to boot up\n pause(750)\n if (this._gpio0)\n this._gpio0.digitalRead();\n // make sure SPI gets initialized while the CS is up\n this.spiTransfer(control.createBuffer(1), null)\n net.log('reseted esp32')\n }\n\n private readByte(): number {\n const r = buffer1(0)\n this.spiTransfer(null, r)\n return r[0]\n }\n\n private checkData(desired: number, msg?: string): boolean {\n const r = this.readByte()\n if (r != desired)\n net.fail(`Expected ${desired} but got ${r}; ` + (msg || \"\"))\n return false;\n }\n\n /** Read a byte with a time-out, and if we get it, check that its what we expect */\n private waitSPIChar(desired: number): boolean {\n let times = control.millis()\n while (control.millis() - times < 100) {\n let r = this.readByte()\n if (r == _ERR_CMD) {\n net.log(\"error response to command\")\n return false\n }\n\n if (r == desired) {\n return true\n }\n //net.log(`read char ${r}, expected ${desired}`)\n }\n net.log(\"timed out waiting for SPI char\")\n return false;\n }\n\n /**\n * Wait until the ready pin goes low\n */\n private waitForReady() {\n net.debug(`wait for ready ${this._busy.digitalRead()}`);\n if (this._busy.digitalRead()) {\n pauseUntil(() => !this._busy.digitalRead(), 10000);\n net.debug(`busy = ${this._busy.digitalRead()}`);\n // pause(1000)\n }\n if (this._busy.digitalRead()) {\n net.log(\"timed out waiting for ready\")\n return false\n }\n\n return true\n }\n\n private _sendCommand(cmd: number, params?: Buffer[], param_len_16?: boolean) {\n params = params || [];\n\n // compute buffer size\n let n = 3; // START_CMD, cmd, length\n params.forEach(param => {\n n += 1 + (param_len_16 ? 1 : 0) + param.length;\n })\n n += 1; // END_CMD\n // padding\n while (n % 4) n++;\n\n const packet = control.createBuffer(n);\n let k = 0;\n packet[k++] = _START_CMD;\n packet[k++] = cmd & ~_REPLY_FLAG;\n packet[k++] = params.length;\n\n params.forEach(param => {\n if (param_len_16)\n packet[k++] = (param.length >> 8) & 0xFF;\n packet[k++] = param.length & 0xFF;\n packet.write(k, param);\n k += param.length;\n })\n packet[k++] = _END_CMD;\n while (k < n)\n packet[k++] = 0xff;\n\n net.debug(`send cmd ${packet.toHex()}`)\n if (!this.waitForReady())\n return false\n this._cs.digitalWrite(false)\n this.spiTransfer(packet, null)\n this._cs.digitalWrite(true)\n net.debug(`send done`);\n return true\n }\n\n private spiTransfer(tx: Buffer, rx: Buffer) {\n if (!tx) tx = control.createBuffer(rx.length)\n if (!rx) rx = control.createBuffer(tx.length)\n this._spi.transfer(tx, rx);\n }\n\n private _waitResponseCmd(cmd: number, num_responses?: number, param_len_16?: boolean) {\n net.debug(`wait response cmd`);\n if (!this.waitForReady())\n return null\n\n this._cs.digitalWrite(false)\n\n let responses: Buffer[] = []\n if (!this.waitSPIChar(_START_CMD)) {\n this._cs.digitalWrite(true)\n return null\n }\n this.checkData(cmd | _REPLY_FLAG)\n if (num_responses !== undefined)\n this.checkData(num_responses, cmd + \"\")\n else\n num_responses = this.readByte();\n for (let num = 0; num < num_responses; ++num) {\n let param_len = this.readByte()\n if (param_len_16) {\n param_len <<= 8\n param_len |= this.readByte()\n }\n net.debug(`\\tParameter #${num} length is ${param_len}`)\n const response = control.createBuffer(param_len);\n this.spiTransfer(null, response)\n responses.push(response);\n }\n this.checkData(_END_CMD);\n\n this._cs.digitalWrite(true)\n\n net.debug(`responses ${responses.length}`);\n return responses;\n }\n\n private lock() {\n while (this._locked) {\n pauseUntil(() => !this._locked)\n }\n this._locked = true\n }\n\n private unlock() {\n if (!this._locked)\n net.fail(\"not locked!\")\n this._locked = false;\n }\n\n private sendCommandGetResponse(cmd: number, params?: Buffer[],\n reply_params = 1, sent_param_len_16 = false, recv_param_len_16 = false) {\n\n this.lock()\n this._sendCommand(cmd, params, sent_param_len_16)\n const resp = this._waitResponseCmd(cmd, reply_params, recv_param_len_16)\n this.unlock();\n return resp\n }\n\n get status(): number {\n const resp = this.sendCommandGetResponse(_GET_CONN_STATUS_CMD)\n if (!resp)\n return WL_NO_SHIELD\n net.debug(`status: ${resp[0][0]}`);\n // one byte response\n return resp[0][0];\n }\n\n /** A string of the firmware version on the ESP32 */\n get firmwareVersion(): string {\n let resp = this.sendCommandGetResponse(_GET_FW_VERSION_CMD)\n if (!resp)\n return \"not connected\"\n return resp[0].toString();\n }\n\n /** A bytearray containing the MAC address of the ESP32 */\n get MACaddress(): Buffer {\n let resp = this.sendCommandGetResponse(_GET_MACADDR_CMD, [hex`ff`])\n if (!resp)\n return null\n // for whatever reason, the mac adderss is backwards\n const res = control.createBuffer(6)\n for (let i = 0; i < 6; ++i)\n res[i] = resp[0][5 - i]\n return res\n }\n\n /** Begin a scan of visible access points. Follow up with a call\n to 'get_scan_networks' for response\n*/\n private startScanNetworks(): void {\n let resp = this.sendCommandGetResponse(_START_SCAN_NETWORKS)\n if (resp[0][0] != 1) {\n net.fail(\"failed to start AP scan\")\n }\n\n }\n\n /** The results of the latest SSID scan. Returns a list of dictionaries with\n 'ssid', 'rssi' and 'encryption' entries, one for each AP found\n*/\n private getScanNetworks(): net.AccessPoint[] {\n let names = this.sendCommandGetResponse(_SCAN_NETWORKS, undefined, undefined)\n // print(\"SSID names:\", names)\n // pylint: disable=invalid-name\n let APs = []\n let i = 0\n for (let name of names) {\n let a_p = new net.AccessPoint(name.toString())\n let rssi = this.sendCommandGetResponse(_GET_IDX_RSSI_CMD, [buffer1(i)])[0]\n a_p.rssi = pins.unpackBuffer(\" RSSI ${ap.rssi}`)\n return APs\n }\n\n }\n return null\n }\n\n /** Tells the ESP32 to set the access point to the given ssid */\n public wifiSetNetwork(ssid: string): void {\n const ssidbuf = control.createBufferFromUTF8(ssid);\n let resp = this.sendCommandGetResponse(_SET_NET_CMD, [ssidbuf])\n if (resp[0][0] != 1) {\n net.fail(\"failed to set network\")\n }\n\n }\n\n /** Sets the desired access point ssid and passphrase */\n public wifiSetPassphrase(ssid: string, passphrase: string): void {\n const ssidbuf = control.createBufferFromUTF8(ssid);\n const passphrasebuf = control.createBufferFromUTF8(passphrase);\n let resp = this.sendCommandGetResponse(_SET_PASSPHRASE_CMD, [ssidbuf, passphrasebuf])\n if (resp[0][0] != 1) {\n net.fail(\"failed to set passphrase\")\n }\n }\n\n /** Sets the WPA2 Enterprise anonymous identity */\n public wifiSetEntidentity(ident: string): void {\n const ssidbuf = control.createBufferFromUTF8(ident);\n let resp = this.sendCommandGetResponse(_SET_ENT_IDENT_CMD, [ssidbuf])\n if (resp[0][0] != 1) {\n net.fail(\"failed to set enterprise anonymous identity\")\n }\n\n }\n\n /** Sets the desired WPA2 Enterprise username */\n public wifiSetEntusername(username: string): void {\n const usernamebuf = control.createBufferFromUTF8(username);\n let resp = this.sendCommandGetResponse(_SET_ENT_UNAME_CMD, [usernamebuf])\n if (resp[0][0] != 1) {\n net.fail(\"failed to set enterprise username\")\n }\n\n }\n\n /** Sets the desired WPA2 Enterprise password */\n public wifiSetEntpassword(password: string): void {\n const passwordbuf = control.createBufferFromUTF8(password);\n let resp = this.sendCommandGetResponse(_SET_ENT_PASSWD_CMD, [passwordbuf])\n if (resp[0][0] != 1) {\n net.fail(\"failed to set enterprise password\")\n }\n\n }\n\n /** Enables WPA2 Enterprise mode */\n public wifiSetEntenable(): void {\n let resp = this.sendCommandGetResponse(_SET_ENT_ENABLE_CMD)\n if (resp[0][0] != 1) {\n net.fail(\"failed to enable enterprise mode\")\n }\n\n }\n\n get ssidBuffer(): Buffer {\n let resp = this.sendCommandGetResponse(_GET_CURR_SSID_CMD, [hex`ff`])\n return resp[0]\n }\n\n get ssid(): string {\n const b = this.ssidBuffer;\n return b ? b.toString() : \"\";\n }\n\n get rssi(): number {\n let resp = this.sendCommandGetResponse(_GET_CURR_RSSI_CMD, [hex`ff`])\n return pins.unpackBuffer(\"= 0) {\n net.log(`failed to connect to \"${ssid}\" (${stat})`)\n }\n\n if (stat == WL_NO_SSID_AVAIL) {\n net.log(`no such ssid: \"${ssid}\"`)\n }\n\n return false;\n }\n\n /** \n * Convert a hostname to a packed 4-byte IP address. Returns\n a 4 bytearray\n */\n public hostbyName(hostname: string): Buffer {\n if (!this.connect())\n return undefined;\n\n let resp = this.sendCommandGetResponse(_REQ_HOST_BY_NAME_CMD, [control.createBufferFromUTF8(hostname)])\n if (resp[0][0] != 1) {\n net.fail(\"failed to request hostname\")\n }\n\n resp = this.sendCommandGetResponse(_GET_HOST_BY_NAME_CMD)\n return resp[0];\n }\n\n /** Ping a destination IP address or hostname, with a max time-to-live\n (ttl). Returns a millisecond timing value\n */\n public ping(dest: string, ttl: number = 250): number {\n if (!this.connect())\n return -1;\n\n // convert to IP address\n let ip = this.hostbyName(dest)\n\n // ttl must be between 0 and 255\n ttl = Math.max(0, Math.min(ttl | 0, 255))\n let resp = this.sendCommandGetResponse(_PING_CMD, [ip, buffer1(ttl)])\n return pins.unpackBuffer(\"H\", [port])\n let resp: Buffer[]\n // use the 5 arg version\n if (typeof dest == \"string\") {\n const dest2 = control.createBufferFromUTF8(dest)\n resp = this.sendCommandGetResponse(_START_CLIENT_TCP_CMD, [dest2, hex`00000000`, port_param, this._socknum_ll[0], buffer1(conn_mode)])\n } else {\n // ip address, use 4 arg vesion\n resp = this.sendCommandGetResponse(_START_CLIENT_TCP_CMD, [dest, port_param, this._socknum_ll[0], buffer1(conn_mode)])\n }\n\n if (resp[0][0] != 1) {\n net.fail(\"could not connect to remote server\")\n }\n\n }\n\n /** Get the socket connection status, can be SOCKET_CLOSED, SOCKET_LISTEN,\n SOCKET_SYN_SENT, SOCKET_SYN_RCVD, SOCKET_ESTABLISHED, SOCKET_FIN_WAIT_1,\n SOCKET_FIN_WAIT_2, SOCKET_CLOSE_WAIT, SOCKET_CLOSING, SOCKET_LAST_ACK, or\n SOCKET_TIME_WAIT\n */\n public socketStatus(socket_num: number): number {\n this._socknum_ll[0][0] = socket_num\n let resp = this.sendCommandGetResponse(_GET_CLIENT_STATE_TCP_CMD, this._socknum_ll)\n return resp[0][0]\n }\n\n /** Test if a socket is connected to the destination, returns boolean true/false */\n public socket_connected(socket_num: number): boolean {\n return this.socketStatus(socket_num) == SOCKET_ESTABLISHED\n }\n\n /** Write the bytearray buffer to a socket */\n public socketWrite(socket_num: number, buffer: Buffer): void {\n net.debug(\"Writing:\" + buffer.length)\n this._socknum_ll[0][0] = socket_num\n let resp = this.sendCommandGetResponse(_SEND_DATA_TCP_CMD, [this._socknum_ll[0], buffer], 1, true)\n let sent = resp[0].getNumber(NumberFormat.UInt16LE, 0)\n if (sent != buffer.length) {\n net.fail(`failed to send ${buffer.length} bytes (sent ${sent})`)\n }\n\n resp = this.sendCommandGetResponse(_DATA_SENT_TCP_CMD, this._socknum_ll)\n if (resp[0][0] != 1) {\n net.fail(\"failed to verify data sent\")\n }\n\n }\n\n /** Determine how many bytes are waiting to be read on the socket */\n public socketAvailable(socket_num: number): number {\n this._socknum_ll[0][0] = socket_num\n let resp = this.sendCommandGetResponse(_AVAIL_DATA_TCP_CMD, this._socknum_ll)\n let reply = pins.unpackBuffer(\">${resp[0].toString()}<<`)\n return resp[0]\n }\n\n /** Open and verify we connected a socket to a destination IP address or hostname\n using the ESP32's internal reference number. By default we use\n 'conn_mode' TCP_MODE but can also use UDP_MODE or TLS_MODE (dest must\n be hostname for TLS_MODE!)\n */\n public socketConnect(socket_num: number, dest: string | Buffer, port: number, conn_mode = net.TCP_MODE): boolean {\n net.debug(\"*** Socket connect mode \" + conn_mode)\n this.socketOpen(socket_num, dest, port, conn_mode)\n let times = net.monotonic()\n // wait 3 seconds\n while (net.monotonic() - times < 3) {\n if (this.socket_connected(socket_num)) {\n return true\n }\n\n pause(10)\n }\n net.fail(\"failed to establish connection\")\n return false\n }\n\n /** Close a socket using the ESP32's internal reference number */\n public socketClose(socket_num: number): void {\n net.debug(\"*** Closing socket #\" + socket_num)\n\n this._socknum_ll[0][0] = socket_num\n let resp = this.sendCommandGetResponse(_STOP_CLIENT_TCP_CMD, this._socknum_ll)\n if (resp[0][0] != 1) {\n net.fail(\"failed to close socket\")\n }\n\n }\n\n /** Enable/disable debug mode on the ESP32. Debug messages will be\n written to the ESP32's UART.\n */\n public setESPdebug(enabled: boolean) {\n let resp = this.sendCommandGetResponse(_SET_DEBUG_CMD, [buffer1(enabled ? 1 : 0)])\n if (resp[0][0] != 1) {\n net.fail(\"failed to set debug mode\")\n }\n }\n\n public getTemperature() {\n let resp = this.sendCommandGetResponse(_GET_TEMP_CMD, [])\n if (resp[0].length != 4) {\n net.fail(\"failed to get temp\")\n }\n return resp[0].getNumber(NumberFormat.Float32LE, 0)\n }\n\n /** \n Set the io mode for a GPIO pin.\n \n :param int pin: ESP32 GPIO pin to set.\n :param value: direction for pin, digitalio.Direction or integer (0=input, 1=output).\n \n */\n public setPinMode(pin: number, pin_mode: number): void {\n\n let resp = this.sendCommandGetResponse(_SET_PIN_MODE_CMD, [buffer1(pin), buffer1(pin_mode)])\n if (resp[0][0] != 1) {\n net.fail(\"failed to set pin mode\")\n }\n\n }\n\n /** \n Set the digital output value of pin.\n \n :param int pin: ESP32 GPIO pin to write to.\n :param bool value: Value for the pin.\n \n */\n public setDigitalWrite(pin: number, value: number): void {\n let resp = this.sendCommandGetResponse(_SET_DIGITAL_WRITE_CMD, [buffer1(pin), buffer1(value)])\n if (resp[0][0] != 1) {\n net.fail(\"failed to write to pin\")\n }\n\n }\n\n /** \n Set the analog output value of pin, using PWM.\n \n :param int pin: ESP32 GPIO pin to write to.\n :param float value: 0=off 1.0=full on\n \n */\n public setAnalogWrite(pin: number, analog_value: number) {\n let value = Math.trunc(255 * analog_value)\n let resp = this.sendCommandGetResponse(_SET_ANALOG_WRITE_CMD, [buffer1(pin), buffer1(value)])\n if (resp[0][0] != 1) {\n net.fail(\"failed to write to pin\")\n }\n\n }\n }\n\n //% shim=esp32spi::flashDevice\n export function flashDevice() {\n return\n }\n}",
"pxt.json": "{\n \"name\": \"esp32\",\n \"description\": \"ESP32 over SPI - beta\",\n \"dependencies\": {\n \"core\": \"*\",\n \"net\": \"*\",\n \"settings\": \"*\"\n },\n \"files\": [\n \"net.ts\",\n \"ninacontroller.ts\",\n \"README.md\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"test.ts": "function test() {\n\n const log = console.log;\n const esp = net.instance().controller()\n\n if (!esp.isIdle)\n return\n\n log(`Firmware vers. ${esp.firmwareVersion}`)\n log(`MAC addr: ${esp.MACaddress.toHex()}`)\n log(\"Temp: \" + esp.getTemperature())\n\n if (!esp.connect()) {\n log(\"can't connect\")\n return\n }\n\n log(\"ping: \" + esp.ping(\"bing.com\"))\n}\n\ntest();"
},
"net": {
"README.md": "# Net\n\nNetworking abstractions and drivers\n\n## WiFi module configuration\n\n* ``PIN_WIFI_CS``, ESP32 CS pin mapping\n* ``PIN_WIFI_BUSY``, ESP32 CS pin mapping\n* ``PIN_WIFI_RESET``, ESP32 RESET pin mapping\n* ``PIN_WIFI_GPIO0`` (optional), ESP32 GPIO0 pin mapping\n\nThe driver uses the default SPI pins. You can override this behavior by specifying these 3 keys.\n\n* ``PIN_WIFI_MOSI`` (optional), dedicated SPI MOSI pin\n* ``PIN_WIFI_MISO`` (optional), dedicated SPI MISO pin\n* ``PIN_WIFI_SCK`` (optional), dedicated SPI SCK pin\n\n## Access Points and passwords\n\nThe module uses access points and password information stored in the device secrets. These secrets can be set programmatically using ``net.updateAccessPoint`` or via the menu items in Arcade (added via the ``net-game`` extension).\n\n> *Friendly reminder:* Do not share .uf2 files or programs with secrets!!\n\n## Example\n\n```\n//\n// to configure your access point password,\n// open the menu and go to the WiFi option (loaded from net-game lib)\n//\ngame.consoleOverlay.setVisible(true)\nnet.logPriority = ConsolePriority.Log;\n\nconsole.log(`connecting...`)\nconst wifi = net.instance();\n// list aps\nconst aps = wifi.scanNetworks();\nconst pwds = net.knownAccessPoints();\nconsole.log(`APs (${aps.length})`)\nfor (const ap of aps) {\n console.log(` ${ap.ssid} ${pwds[ap.ssid] !== undefined ? \"(known)\" : \"\"}`)\n}\n\n// ping\nfor (let i = 0; i < 4; ++i)\n console.log(`ping: ${net.ping(\"bing.com\")}ms`)\n\n// curl\nconst r = net.get(\"https://makecode.com/api/md/arcade/about\")\nconsole.log(r.text)\n```",
"controller.ts": "namespace net {\n export enum ControllerEvent {\n NewScan = 1,\n GotIP = 2,\n LostIP = 3,\n NoScannedNetworks = 4,\n NoKnownNetworks = 5,\n Connecting = 6,\n ConnectionFailed = 7,\n LoginServerStarted = 8\n }\n export class Controller {\n eventID: number\n private _isConnected = false\n\n onConnectSSIDFailed: (ssid: string) => void;\n\n constructor() {\n this.eventID = control.allocateEventSource()\n }\n\n protected setConnected(isConnected: boolean) {\n if (this._isConnected != isConnected) {\n this._isConnected = isConnected\n this.emitEvent(isConnected ? ControllerEvent.GotIP : ControllerEvent.LostIP)\n }\n }\n\n protected emitEvent(ev: ControllerEvent) {\n control.raiseEvent(this.eventID, ev)\n }\n\n onEvent(ev: ControllerEvent, h: () => void) {\n control.onEvent(this.eventID, ev, h)\n }\n\n public scanNetworks(): net.AccessPoint[] {\n this.lastScanResults = this.scanNetworksCore()\n this.emitEvent(ControllerEvent.NewScan)\n return this.lastScanResults\n }\n\n protected scanNetworksCore(): net.AccessPoint[] {\n return [];\n }\n\n public startLoginServer(hostName: string): void {\n \n }\n\n public isLoginServerEnabled(): boolean {\n return false;\n }\n\n public socket(): number {\n return -1;\n }\n\n public socketConnect(socket_num: number, dest: string | Buffer, port: number, conn_mode = TCP_MODE): boolean {\n return false;\n }\n\n public socketWrite(socket_num: number, buffer: Buffer): void {\n }\n\n public socketAvailable(socket_num: number): number {\n return -1;\n }\n\n public socketRead(socket_num: number, size: number): Buffer {\n return undefined;\n }\n\n public socketClose(socket_num: number): void {\n }\n\n public hostbyName(hostname: string): Buffer {\n return undefined;\n }\n get isIdle(): boolean { return false; }\n get isConnected(): boolean { return this._isConnected; }\n connectAP(bssid: string, password: string) { return false }\n disconnectAP() { }\n\n lastScanResults: net.AccessPoint[]\n protected reconnectRunning: {}\n\n autoconnect() {\n if (this.reconnectRunning)\n return\n const myReconn = {}\n this.reconnectRunning = myReconn\n this.emitEvent(ControllerEvent.Connecting)\n control.runInParallel(() => {\n while (this.reconnectRunning == myReconn) {\n if (this.isConnected) {\n pause(1000)\n } else {\n this.connectCore()\n pause(500)\n }\n }\n })\n }\n\n disconnect() {\n this.reconnectRunning = null\n this.disconnectAP()\n }\n\n protected connectCore(): boolean {\n if (control.deviceDalVersion() == \"sim\") {\n this.connectAP(\"\", \"\")\n return true\n }\n\n this.scanNetworks()\n if (!this.lastScanResults || this.lastScanResults.length == 0) {\n net.log(`no networks detected`)\n this.emitEvent(ControllerEvent.NoScannedNetworks)\n return false\n }\n\n if (!this.reconnectRunning)\n return false\n\n const wifis = net.knownAccessPoints();\n const ssids = Object.keys(wifis);\n const networks = this.lastScanResults\n .filter(network => ssids.indexOf(network.ssid) > -1);\n\n if (!networks.length) {\n net.log(`no known networks`)\n this.emitEvent(ControllerEvent.NoKnownNetworks)\n return false\n }\n\n const priorities = net.accessPointPriorities()\n networks.sort((a, b) => {\n const pa = priorities[a.ssid] || 0\n const pb = priorities[b.ssid] || 0\n return pb - pa || b.rssi - a.rssi\n })\n\n // try connecting to known networks\n for (const network of networks) {\n net.log(`connecting to ${network.ssid}...`)\n const pwd = wifis[network.ssid]\n if (this.connectAP(network.ssid, pwd)) {\n net.log(`connected to ${network.ssid}`)\n return true\n }\n if (!this.reconnectRunning)\n return false\n\n if (this.onConnectSSIDFailed)\n this.onConnectSSIDFailed(network.ssid)\n }\n\n net.log(`connection failed`)\n this.emitEvent(ControllerEvent.ConnectionFailed)\n return false\n }\n\n connect(timeout_ms?: number): boolean {\n this.autoconnect()\n pauseUntil(() => this.isConnected, timeout_ms)\n return this.isConnected\n }\n\n get ssid(): string { return undefined; }\n get rssi(): number { return undefined; }\n get MACaddress(): Buffer { return undefined; }\n get IPaddress(): Buffer { return undefined; }\n public ping(dest: string, ttl: number = 250): number { return -1; }\n\n // optional dataAvailable event\n public dataAvailableSrc(socket_num: number): number { return -1; }\n public dataAvailableValue(socket_num: number): number { return -1; }\n }\n}",
"controllersocket.ts": "namespace net {\n\n export const SOCK_STREAM = 1\n export const AF_INET = 2\n export const MAX_PACKET = 4000\n export const TCP_MODE = 0\n export const UDP_MODE = 1\n export const TLS_MODE = 2\n\n export class ControllerSocket implements net.Socket {\n _buffer: Buffer;\n _socknum: number;\n _timeout: number;\n _closed: boolean;\n _openHandler: () => void;\n _closeHandler: () => void;\n _errorHandler: (msg: string) => void;\n _messageHandler: (data: Buffer) => void;\n\n /** A simplified implementation of the Python 'socket' class, for connecting\n through an interface to a remote device\n */\n constructor(private controller: Controller, private host: string | Buffer, private port: number, private conntype: number = null) {\n if (this.conntype === null) {\n this.conntype = net.TCP_MODE\n }\n this._buffer = hex``\n this._socknum = this.controller.socket()\n this.setTimeout(0)\n }\n\n /** Connect the socket to the 'address' (which can be 32bit packed IP or\n a hostname string). 'conntype' is an extra that may indicate SSL or not,\n depending on the underlying interface\n*/\n public connect() {\n if (!this.controller.socketConnect(this._socknum, this.host, this.port, this.conntype)) {\n this.error(`failed to connect to ${this.host}`)\n return;\n }\n\n this._buffer = hex``\n\n if (this._openHandler)\n this._openHandler();\n }\n\n /** Send some data to the socket */\n public send(data: string | Buffer) {\n //console.log(\"sock wr: \" + data)\n this.controller.socketWrite(this._socknum, net.dataAsBuffer(data))\n }\n\n private error(msg: string) {\n if (this._errorHandler)\n this._errorHandler(msg)\n }\n\n onOpen(handler: () => void): void {\n this._openHandler = handler;\n }\n onClose(handler: () => void): void {\n this._closeHandler = handler;\n }\n onError(handler: (msg: string) => void): void {\n this._errorHandler = handler;\n }\n\n private flushReadBuffer() {\n while (!this._closed && this._messageHandler) {\n const buf = this.read()\n if (buf.length) {\n this._messageHandler(buf)\n } else {\n break\n }\n }\n }\n\n onMessage(handler: (data: Buffer) => void): void {\n if (this._messageHandler === undefined) {\n const src = this.controller.dataAvailableSrc(this._socknum)\n const value = this.controller.dataAvailableValue(this._socknum)\n if (src > 0 && value > 0) {\n this.flushReadBuffer()\n control.internalOnEvent(src, value, () => this.flushReadBuffer())\n } else {\n control.runInParallel(() => {\n while (!this._closed) {\n this.flushReadBuffer()\n pause(200)\n }\n })\n }\n }\n this._messageHandler = handler || null;\n }\n\n /** Attempt to return as many bytes as we can up to but not including '\\r\\n' */\n public readLine(): string {\n // print(\"Socket readline\")\n let stamp = monotonic()\n while (this._buffer.indexOf(hex`0d0a`) < 0) {\n // there's no line already in there, read some more\n let avail = Math.min(this.controller.socketAvailable(this._socknum), MAX_PACKET)\n if (avail > 0) {\n this._buffer = this._buffer.concat(this.controller.socketRead(this._socknum, avail))\n } else if (avail < 0 || (this._timeout > 0 && monotonic() - stamp > this._timeout)) {\n // Make sure to close socket so that we don't exhaust sockets.\n this.close()\n throw \"Didn't receive full response, failing out\"\n } else {\n pause(20)\n }\n }\n const pos = this._buffer.indexOf(hex`0d0a`)\n const pref = this._buffer.slice(0, pos)\n this._buffer = this._buffer.slice(pos + 2)\n // print(\"rd: \" + this._buffer.length + \" / \" + pref.length + \" :\" + pref.toString())\n return pref.toString()\n }\n\n /** Read up to 'size' bytes from the socket, this may be buffered internally! If 'size' isn't specified, return everything in the buffer. */\n public read(size: number = 0): Buffer {\n // print(\"Socket read\", size)\n if (size == 0) {\n if (this._buffer.length == 0) {\n let avail = Math.min(this.controller.socketAvailable(this._socknum), MAX_PACKET)\n if (avail > 0)\n this._buffer = this.controller.socketRead(this._socknum, avail)\n if (avail < 0)\n this.close()\n }\n let ret = this._buffer\n this._buffer = hex``\n return ret\n }\n\n let stamp = monotonic()\n let to_read = size - this._buffer.length\n let received = []\n while (to_read > 0) {\n // print(\"Bytes to read:\", to_read)\n let avail = Math.min(this.controller.socketAvailable(this._socknum), MAX_PACKET)\n if (avail > 0) {\n stamp = monotonic()\n let recv = this.controller.socketRead(this._socknum, Math.min(to_read, avail))\n received.push(recv)\n to_read -= recv.length\n } else {\n pause(20)\n }\n\n if (avail < 0 || (this._timeout > 0 && monotonic() - stamp > this._timeout)) {\n break\n }\n\n }\n // print(received)\n received.unshift(this._buffer)\n this._buffer = pins.concatBuffers(received)\n let ret = null\n if (this._buffer.length == size) {\n ret = this._buffer\n this._buffer = hex``\n } else {\n ret = this._buffer.slice(0, size)\n this._buffer = this._buffer.slice(size)\n }\n\n return ret\n }\n\n /** Set the read timeout for sockets, if value is 0 it will block */\n public setTimeout(value: number) {\n this._timeout = value\n }\n\n /** Close the socket, after reading whatever remains */\n public close() {\n this._closed = true;\n this._buffer = hex``\n this.controller.socketClose(this._socknum)\n if (this._closeHandler)\n this._closeHandler();\n }\n }\n}\n",
"net.ts": "/**\n * Networking, WiFi, web requests\n */\n//% weight=1\n//% advanced=true\n//% icon=\"\\uf1eb\" color=\"#8446cf\"\nnamespace net {\n /**\n * Default priority of net log messages\n **/\n export let logPriority: ConsolePriority = -1;\n export function log(msg: string) {\n console.add(logPriority, \"net:\" + msg);\n }\n export function debug(msg: string) {\n if (logPriority > ConsolePriority.Debug)\n console.add(ConsolePriority.Debug, \"net:\" + msg);\n }\n export function fail(reason: string) {\n net.log(`error: ${reason}`);\n throw reason;\n }\n\n export function monotonic(): number {\n return control.millis() / 1000.0;\n }\n\n export const enum WifiAPFlags {\n HasPassword = 0x1,\n WPS = 0x2,\n HasSecondaryChannelAbove = 0x4,\n HasSecondaryChannelBelow = 0x8,\n IEEE_802_11B = 0x100,\n IEEE_802_11A = 0x200,\n IEEE_802_11G = 0x400,\n IEEE_802_11N = 0x800,\n IEEE_802_11AC = 0x1000,\n IEEE_802_11AX = 0x2000,\n IEEE_802_LongRange = 0x8000,\n }\n\n export class AccessPoint {\n flags: WifiAPFlags\n rssi: number\n bssid: Buffer\n channel: number\n constructor(public ssid: string) { }\n static fromBuffer(buf: Buffer) {\n const name = buf.slice(16)\n let endp = name.length - 1\n while (endp > 0 && name[endp] == 0)\n endp--\n endp++\n const res = new AccessPoint(name.slice(0, endp).toString())\n const [flags, _reserved, rssi, channel] = buf.unpack(\" x == 0))\n res.bssid = null\n return res\n }\n toBuffer() {\n /*\n flags: APFlags\n reserved: u32\n rssi: i8 dB {typical_min = -100, typical_max = -20}\n channel: u8 {typical_min = 1, typical_max = 13}\n bssid: u8[6]\n ssid: string {max_bytes = 33}\n */\n const pref = Buffer.pack(\" void): void;\n onClose(handler: () => void): void;\n onError(handler: (msg: string) => void): void;\n onMessage(handler: (data: Buffer) => void): void;\n setTimeout(millis: number): void;\n readLine(): string;\n }\n\n export class Net {\n private _controller: Controller;\n constructor(private factory: () => Controller) {\n Net.instance = this;\n this._controller = undefined; // null failed to initialize\n }\n\n static instance: Net;\n\n get controller(): net.Controller {\n if (this._controller === undefined) {\n net.log(`init controller`)\n this._controller = this.factory();\n if (!this._controller) {\n net.log(`controller not found`)\n this._controller = null;\n }\n }\n return this._controller;\n }\n\n /**\n * Scan for APs\n */\n scanNetworks(): net.AccessPoint[] {\n const c = this.controller;\n try {\n return c ? c.scanNetworks() : [];\n } catch (e) {\n console.error(\"\" + e)\n return [];\n }\n }\n\n createSocket(host: string, port: number, secure: boolean): net.Socket {\n const c = this.controller;\n if (!c) return undefined;\n const socket = new net.ControllerSocket(c, host, port, secure ? net.TLS_MODE : net.TCP_MODE);\n return socket;\n }\n\n hostByName(host: string): string {\n const c = this.controller;\n if (!c) return undefined;\n const b = this.controller.hostbyName(host);\n if (b) return b.toString();\n return undefined;\n }\n }\n\n /**\n * Gets the current Net instance\n */\n export function instance(): Net {\n return net.Net.instance;\n }\n\n const AP_SECRETS_KEY = \"wifi\";\n const AP_PRI_KEY = \"#wifipriority\";\n /**\n * Gets the map of SSID -> password pairs\n */\n export function knownAccessPoints(): StringMap {\n return settings.deviceSecrets.readSecret(AP_SECRETS_KEY) || {};\n }\n\n export function clearAccessPoint(ssid: string) {\n const ap = knownAccessPoints()\n if (ap[ssid] !== undefined) {\n delete ap[ssid]\n settings.deviceSecrets.setSecret(AP_SECRETS_KEY, ap)\n }\n }\n\n export function updateAccessPoint(ssid: string, password: string) {\n const k: StringMap = {};\n k[ssid] = password;\n settings.deviceSecrets.updateSecret(AP_SECRETS_KEY, k);\n }\n\n export function setAccessPointPriority(ssid: string, pri: number) {\n const s = accessPointPriorities()\n if (s[ssid] != pri) {\n s[ssid] = pri\n settings.writeJSON(AP_PRI_KEY, s)\n }\n }\n\n export function accessPointPriorities() {\n return settings.readJSON(AP_PRI_KEY) || {}\n }\n\n export function clearAccessPoints() {\n settings.deviceSecrets.setSecret(AP_SECRETS_KEY, undefined);\n }\n}",
"netutil.ts": "namespace net {\n export function urlencode(s: string) {\n const buf = Buffer.fromUTF8(s)\n let r = \"\"\n for (let i = 0; i < buf.length; ++i) {\n const c = buf[i]\n if ((48 <= c && c <= 57) ||\n (97 <= (c | 0x20) && (c | 0x20) <= 122) ||\n (c == 45 || c == 46 || c == 95 || c == 126))\n r += String.fromCharCode(c)\n else\n r += \"%\" + buf.slice(i, 1).toHex()\n }\n return r\n }\n\n export function urldecode(s: string) {\n let r = \"\"\n let isUtf8 = false\n for (let i = 0; i < s.length; ++i) {\n const c = s[i]\n if (c == \"%\") {\n const h = s.slice(i + 1, i + 3)\n const chcode = parseInt(h, 16)\n if (!isNaN(chcode)) {\n if (chcode > 127)\n isUtf8 = true\n r += String.fromCharCode(chcode)\n i += 2\n continue\n }\n }\n r += c\n }\n if (isUtf8) {\n const buf = Buffer.create(r.length)\n for (let i = 0; i < buf.length; ++i)\n buf[i] = r.charCodeAt(i)\n return buf.toString()\n } else {\n return r\n }\n }\n}",
"pxt.json": "{\n \"name\": \"net\",\n \"description\": \"Networking abstractions\",\n \"dependencies\": {\n \"core\": \"*\",\n \"settings\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"controller.ts\",\n \"controllersocket.ts\",\n \"net.ts\",\n \"netutil.ts\",\n \"requests.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"requests.ts": "namespace net {\n /**\n * Pings a web site\n * @param dest host name\n * @param ttl \n */\n //% blockId=netping block=\"net ping $dest\"\n export function ping(dest: string, ttl: number = 250): number {\n net.log(`ping ${dest}`);\n const c = net.instance().controller;\n if (!c) return Infinity;\n // don't crash.\n try {\n return c.ping(dest, ttl);\n } catch (e) {\n console.error(\"\" + e)\n return Infinity;\n }\n }\n\n export class Response {\n _cached: Buffer\n status_code: number\n reason: string\n _read_so_far: number\n headers: StringMap;\n\n /** \n * The response from a request, contains all the headers/content \n */\n constructor(private socket: Socket) {\n this._cached = null\n this.status_code = null\n this.reason = null\n this._read_so_far = 0\n this.headers = {}\n }\n\n /** \n * Close, delete and collect the response data \n */\n public close() {\n if (this.socket) {\n this.socket.close()\n this.socket = null\n }\n this._cached = null\n }\n\n /** \n * The HTTP content direct from the socket, as bytes \n */\n get content() {\n // print(\"Content length:\", content_length)\n if (this._cached === null && this.socket) {\n const content_length = parseInt(this.headers[\"content-length\"]) || 0\n this._cached = this.socket.read(content_length)\n this.socket.close()\n this.socket = null\n }\n\n // print(\"Buffer length:\", len(self._cached))\n return this._cached\n }\n\n /** \n * The HTTP content, encoded into a string according to the HTTP header encoding\n */\n get text() {\n const b = this.content;\n return b ? b.toString() : undefined;\n }\n\n get json() {\n return JSON.parse(this.text)\n }\n\n public toString() {\n return `HTTP ${this.status_code}; ${Object.keys(this.headers).length} headers; ${this._cached ? this._cached.length : -1} bytes content`\n }\n }\n\n export interface RequestOptions {\n data?: string | Buffer;\n json?: any; // will call JSON.stringify()\n headers?: StringMap;\n stream?: boolean;\n timeout?: number; // in ms\n }\n\n export function dataAsBuffer(data: string | Buffer): Buffer {\n if (data == null)\n return null\n if (typeof data == \"string\")\n return control.createBufferFromUTF8(data)\n return data\n }\n\n /*\n >>> \"a,b,c,d,e\".split(\",\", 2)\n ['a', 'b', 'c,d,e']\n */\n function pysplit(str: string, sep: string, limit: number) {\n const arr = str.split(sep)\n if (arr.length >= limit) {\n return arr.slice(0, limit).concat([arr.slice(limit).join(sep)])\n } else {\n return arr\n }\n }\n\n\n /** Perform an HTTP request to the given url which we will parse to determine\nwhether to use SSL ('https://') or not. We can also send some provided 'data'\nor a json dictionary which we will stringify. 'headers' is optional HTTP headers\nsent along. 'stream' will determine if we buffer everything, or whether to only\nread only when requested\n \n*/\n export function request(method: string, url: string, options?: RequestOptions): net.Response {\n net.log(`${method} ${url}`);\n\n if (!net.instance().controller) {\n // no controller\n const r = new net.Response(null);\n r.status_code = 418; // teapot\n r.reason = \"net controller not configured\";\n return r;\n }\n\n try {\n return internalRequest(method, url, options);\n } catch (e) {\n const r = new net.Response(null);\n r.status_code = 418; // teapot\n r.reason = \"\" + e;\n return r;\n }\n }\n\n function internalRequest(method: string, url: string, options?: RequestOptions): net.Response {\n if (!options) options = {};\n if (!options.headers) {\n options.headers = {}\n }\n\n const tmp = pysplit(url, \"/\", 3)\n let proto = tmp[0]\n let host = tmp[2]\n let path = tmp[3] || \"\"\n // replace spaces in path\n // TODO\n // path = path.replace(\" \", \"%20\")\n\n let port = 0\n if (proto == \"http:\") {\n port = 80\n } else if (proto == \"https:\") {\n port = 443\n } else {\n control.fail(\"Unsupported protocol: \" + proto)\n }\n\n if (host.indexOf(\":\") >= 0) {\n const tmp = host.split(\":\")\n host = tmp[0]\n port = parseInt(tmp[1])\n }\n\n let sock: Socket;\n if (proto == \"https:\") {\n // for SSL we need to know the host name\n sock = net.instance().createSocket(host, port, true)\n } else {\n sock = net.instance().createSocket(host, port, false)\n }\n // our response\n let resp = new Response(sock)\n // socket read timeout\n sock.setTimeout(options.timeout)\n\n sock.connect();\n sock.send(`${method} /${path} HTTP/1.0\\r\\n`)\n\n if (!options.headers[\"Host\"])\n sock.send(`Host: ${host}\\r\\n`)\n\n if (!options.headers[\"User-Agent\"])\n sock.send(\"User-Agent: MakeCode ESP32\\r\\n\")\n\n // Iterate over keys to avoid tuple alloc\n for (let k of Object.keys(options.headers))\n sock.send(`${k}: ${options.headers[k]}\\r\\n`)\n\n if (options.json != null) {\n control.assert(options.data == null, 100)\n options.data = JSON.stringify(options.json)\n sock.send(\"Content-Type: application/json\\r\\n\")\n }\n\n let dataBuf = dataAsBuffer(options.data)\n\n if (dataBuf)\n sock.send(`Content-Length: ${dataBuf.length}\\r\\n`)\n\n sock.send(\"\\r\\n\")\n if (dataBuf)\n sock.send(dataBuf)\n\n let line = sock.readLine()\n // print(line)\n let line2 = pysplit(line, \" \", 2)\n let status = parseInt(line2[1])\n let reason = \"\"\n if (line2.length > 2) {\n reason = line2[2]\n }\n\n while (true) {\n line = sock.readLine()\n if (!line || line == \"\\r\\n\") {\n break\n }\n\n // print(\"**line: \", line)\n const tmp = pysplit(line, \": \", 1)\n let title = tmp[0]\n let content = tmp[1]\n if (title && content) {\n resp.headers[title.toLowerCase()] = content.toLowerCase()\n }\n }\n\n /*\n \n elif line.startswith(b\"Location:\") and not 200 <= status <= 299:\n raise NotImplementedError(\"Redirects not yet supported\")\n */\n\n if ((resp.headers[\"transfer-encoding\"] || \"\").indexOf(\"chunked\") >= 0)\n control.fail(\"not supported chunked encoding\")\n\n resp.status_code = status\n resp.reason = reason\n return resp\n }\n\n /** \n * Send HTTP HEAD request \n **/\n export function head(url: string, options?: RequestOptions) {\n return request(\"HEAD\", url, options)\n }\n\n /** \n * Send HTTP GET request \n **/\n export function get(url: string, options?: RequestOptions) {\n return request(\"GET\", url, options)\n }\n\n /** \n * Send HTTP GET request and return text \n **/\n //% blockId=netgetstring block=\"get string $url\"\n export function getString(url: string, options?: RequestOptions): string {\n const res = get(url, options)\n const rv = res.status_code == 200 ? res.text : undefined\n res.close()\n return rv\n }\n\n /** \n * Send HTTP GET request and return JSON \n **/\n //% blockId=netgetjson block=\"get json $url\"\n export function getJSON(url: string, options?: RequestOptions): any {\n options = options || {};\n options.headers = options.headers || {};\n options.headers[\"accept\"] = options.headers[\"accept\"] || \"application/json\";\n const res = get(url, options);\n const rv = res.status_code == 200 ? res.json : undefined;\n res.close()\n return rv\n }\n\n /** Send HTTP POST request */\n export function post(url: string, options?: RequestOptions) {\n return request(\"POST\", url, options)\n }\n\n /** Send HTTP PATCH request */\n export function patch(url: string, options?: RequestOptions) {\n return request(\"PATCH\", url, options)\n }\n\n /** Send HTTP PUT request */\n export function put(url: string, options?: RequestOptions) {\n return request(\"PUT\", url, options)\n }\n\n /** Send HTTP DELETE request */\n export function del(url: string, options?: RequestOptions) {\n return request(\"DELETE\", url, options)\n }\n}"
},
"net-game": {
"pxt.json": "{\n \"name\": \"net-game\",\n \"description\": \"WiFi support in Arcade - beta\",\n \"dependencies\": {\n \"core\": \"*\",\n \"settings\": \"*\",\n \"net\": \"*\",\n \"game\": \"*\"\n },\n \"files\": [\n \"settings.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"settings.ts": "namespace net {\n class Configurator {\n private accessPoints: net.AccessPoint[];\n private apIndex: number;\n private scanning: boolean;\n private wifi: net.Controller;\n\n constructor() {\n this.scanning = false;\n this.apIndex = 0;\n }\n\n private select() {\n const ap = this.accessPoints && this.accessPoints[this.apIndex];\n if (ap) {\n const wifis = net.knownAccessPoints();\n const known = wifis[ap.ssid] !== undefined ? \"*\" : \"?\";\n console.log(`${known} ${ap.ssid}`);\n }\n }\n\n private connect() {\n console.log(\"connecting...\")\n this.wifi.connect();\n console.log(this.wifi.isConnected ? `connected to ${this.wifi.ssid}` : `disconnected`);\n if (this.wifi.isConnected) {\n for (let i = 0; i < 3; ++i) {\n const ping = this.wifi.ping(\"bing.com\")\n console.log(`bing.com ping ${ping}ms`);\n }\n }\n }\n\n private scan() {\n if (this.scanning) return;\n\n this.scanning = true;\n const mac = this.wifi.MACaddress;\n console.log(`MAC: ${mac ? mac.toHex() : \"???\"}`)\n console.log(\"scanning...\")\n control.runInBackground(() => {\n this.accessPoints = this.wifi.scanNetworks()\n if (this.accessPoints && this.accessPoints.length) {\n const wifis = net.knownAccessPoints();\n for (let i = 0; i < this.accessPoints.length; ++i) {\n const ap = this.accessPoints[i];\n const known = wifis[ap.ssid] !== undefined ? \"*\" : \"?\";\n console.log(` ${known} ${ap.ssid}`);\n }\n console.log(\" \");\n this.apIndex = 0;\n console.log(\"*: AP known\")\n console.log(\"up/down: select AP\")\n console.log(\"left: erase AP info\")\n console.log(\"right: enter AP password\")\n console.log(\"A: connect\")\n console.log(\" \");\n this.select();\n }\n this.scanning = false;\n });\n }\n\n main() {\n this.wifi = net.instance().controller;\n if (!this.wifi) {\n console.log(\"WiFi module not configured\");\n return;\n }\n pauseUntil(() => this.wifi.isIdle, 30000);\n if (!this.wifi.isIdle) {\n console.log(\"WiFi module not responding\")\n return;\n }\n controller.up.onEvent(ControllerButtonEvent.Pressed, () => {\n this.apIndex = this.apIndex + 1;\n if (this.accessPoints)\n this.apIndex = this.apIndex % this.accessPoints.length;\n this.select();\n })\n controller.down.onEvent(ControllerButtonEvent.Pressed, () => {\n this.apIndex = this.apIndex - 1;\n this.apIndex = (this.apIndex + this.accessPoints.length) % this.accessPoints.length;\n this.select();\n })\n controller.left.onEvent(ControllerButtonEvent.Pressed, () => {\n const ap = this.accessPoints && this.accessPoints[this.apIndex];\n if (!ap) return;\n net.updateAccessPoint(ap.ssid, undefined);\n console.log(`password erased`)\n this.scan();\n })\n controller.right.onEvent(ControllerButtonEvent.Pressed, () => {\n const ap = this.accessPoints && this.accessPoints[this.apIndex];\n if (!ap) return;\n game.consoleOverlay.setVisible(false);\n const pwd = game.askForString(`password for ${ap.ssid}`, 24);\n game.consoleOverlay.setVisible(true);\n net.updateAccessPoint(ap.ssid, pwd);\n console.log(`password saved`)\n this.scan();\n })\n controller.A.onEvent(ControllerButtonEvent.Pressed, () => {\n this.connect();\n })\n controller.B.onEvent(ControllerButtonEvent.Pressed, () => {\n game.popScene();\n game.consoleOverlay.setVisible(false);\n });\n this.scan();\n }\n }\n\n function wifiSystemMenu() {\n scene.systemMenu.closeMenu();\n game.pushScene();\n game.consoleOverlay.setVisible(true);\n console.log(\"WiFi configuration\")\n const config = new Configurator();\n config.main()\n }\n\n scene.systemMenu.addEntry(\n () => \"WiFi\",\n () => wifiSystemMenu(),\n img`\n . . . . . . . . . . . . . . . .\n . . . . . . 8 8 8 8 . . . . . .\n . . . . 8 8 8 6 6 6 8 8 . . . .\n . . . 8 6 6 6 6 6 6 6 6 8 . . .\n . . 8 6 6 . . . . . . 6 6 8 . .\n . 8 6 6 . . . . . . . . 6 6 8 .\n 8 6 6 . . . 8 8 8 8 . . . 6 6 8\n . 6 . . . 8 6 6 6 6 8 . . . 6 .\n . . . . 8 6 6 6 6 6 6 8 . . . .\n . . . 8 6 6 . . . . 6 6 8 . . .\n . . . . 6 . . . . . . 6 . . . .\n . . . . . . . 8 8 . . . . . . .\n . . . . . . 8 6 6 8 . . . . . .\n . . . . . . 6 6 6 6 . . . . . .\n . . . . . . . 6 6 . . . . . . .\n . . . . . . . . . . . . . . . .\n`);\n}"
},
"wifi---esp32": {
"README.md": "# Wifi ESP32\n\n\n## Developer\n\nBuild instructions\n* install ESP IDF 4.3.1\n* clone https://github.com/microsoft/pxt-common-packages, link to .\n* clone https://github.com/microsoft/pxt-maker, link pxt-common-packages\n* create projects/... in maker, clone https://github.com/microsoft/pxt-jacdac\n* open wifi--esp32\n* sh run.sh\n",
"controller.ts": "namespace net {\n //% shim=_wifi::_readLastAccessPointCredentials\n declare function _readLastAccessPointCredentials(): string[];\n\n const EV_ScanCompleted = 1000\n\n export class WifiController extends net.Controller {\n private networks: net.AccessPoint[]\n private inScan: boolean\n private _ssid: string\n\n constructor() {\n super()\n control.internalOnEvent(_wifi.eventID(), WifiEvent.ScanDone, () => this.scanDone())\n control.internalOnEvent(_wifi.eventID(), WifiEvent.Disconnected, () => {\n this.setConnected(false)\n })\n control.internalOnEvent(_wifi.eventID(), WifiEvent.GotIP, () => {\n this.setConnected(true)\n })\n }\n\n private scanDone() {\n const buf = _wifi.scanResults()\n this.networks = []\n this.inScan = false\n if (!buf)\n return\n let i = 0\n const entrySize = 48\n while (i < buf.length) {\n const ap = net.AccessPoint.fromBuffer(buf.slice(i, entrySize))\n control.dmesg(`${ap.ssid} [${ap.rssi}dB]`)\n this.networks.push(ap)\n i += entrySize\n }\n control.raiseEvent(_wifi.eventID(), EV_ScanCompleted)\n }\n\n public scanNetworksCore(): net.AccessPoint[] {\n if (!this.inScan) {\n this.inScan = true\n _wifi.scanStart()\n }\n control.waitForEvent(_wifi.eventID(), EV_ScanCompleted)\n return this.networks\n }\n\n public startLoginServer(hostName: string): void {\n if (_wifi.isLoginServerEnabled())\n return\n \n this.disconnect()\n _wifi.startLoginServer(hostName);\n control.onEvent(_wifi.eventID(), WifiEvent.AccessPointCredentialsAvailable, () => {\n const credentials = _readLastAccessPointCredentials()\n if (!!credentials && credentials.length == 2) {\n const ssid = credentials[0]\n const pwd = credentials[1]\n net.updateAccessPoint(ssid, pwd)\n console.debug(`restarting...`);\n pause(100);\n control.reset();\n }\n })\n this.emitEvent(ControllerEvent.LoginServerStarted);\n }\n\n public isLoginServerEnabled(): boolean {\n return _wifi.isLoginServerEnabled()\n }\n\n public disconnectAP() {\n _wifi.disconnect()\n }\n\n public connectAP(ssid: string, pass: string) {\n control.dmesg(`connecting to [${ssid}]...`)\n this._ssid = ssid\n const res = _wifi.connect(ssid, pass)\n if (res != 0)\n return false\n pauseUntil(() => this.isConnected, 15000)\n control.dmesg(`${this.isConnected ? \"\" : \"not \"}connected to [${ssid}]`)\n return this.isConnected\n }\n\n public socket(): number {\n return _wifi.socketAlloc()\n }\n\n private logError(lbl: string, res: number) {\n if (res < 0) {\n control.dmesg(`sock ${lbl} failed: ${res}`)\n return false\n }\n return true\n }\n\n public socketConnect(socket_num: number, dest: string | Buffer, port: number, conn_mode = TCP_MODE): boolean {\n if (conn_mode != TLS_MODE)\n throw \"only TLS supported for now\"\n if (typeof dest != \"string\")\n throw \"connection by IP not supported in TLS mode\"\n return this.logError(\"connect\", _wifi.socketConnectTLS(socket_num, dest, port))\n }\n\n public socketWrite(socket_num: number, buffer: Buffer): void {\n this.logError(\"write\", _wifi.socketWrite(socket_num, buffer))\n }\n\n public socketAvailable(socket_num: number): number {\n return _wifi.socketBytesAvailable(socket_num)\n }\n\n public socketRead(socket_num: number, size: number): Buffer {\n const r = _wifi.socketRead(socket_num, size)\n if (typeof r == \"number\") {\n this.logError(\"read\", r)\n return undefined\n } else {\n return (r as any) as Buffer\n }\n }\n\n public socketClose(socket_num: number): void {\n this.logError(\"close\", _wifi.socketClose(socket_num))\n }\n\n public hostbyName(hostname: string): Buffer {\n return undefined;\n }\n get isIdle(): boolean { return true; }\n get MACaddress(): Buffer { return control.deviceLongSerialNumber().slice(1, 6); }\n get IPaddress(): Buffer { return this.isConnected ? _wifi.ipInfo().slice(0, 4) : undefined; }\n get ssid(): string { return this.isConnected ? this._ssid : \"\" }\n get rssi(): number { return _wifi.rssi() }\n public ping(dest: string, ttl: number = 250): number { return -1; }\n\n public dataAvailableSrc(socket_num: number): number { return _wifi.eventID(); }\n public dataAvailableValue(socket_num: number): number { return 1000 + socket_num; }\n\n }\n\n // initialize Net.instance\n new net.Net(() => new WifiController())\n}\n",
"enums.d.ts": "// Auto-generated. Do not edit.\n\n\n declare const enum WifiEvent {\n //%\n ScanDone = 1,\n //%\n GotIP = 2,\n //%\n Disconnected = 3,\n //%\n AccessPointCredentialsAvailable = 4,\n //%\n LoginServerStarted = 5,\n }\n\n// Auto-generated. Do not edit. Really.\n",
"httpserver.cpp": "#include \"wifi.h\"\n#include \"esp_netif.h\"\n#include \"esp_wifi.h\"\n#include \n#include \n\n#define TAG \"http\"\n#define LOG(...) ESP_LOGI(TAG, __VA_ARGS__)\n\nnamespace _wifi {\n\nstatic httpd_handle_t _server = NULL;\nstatic const char* _lastApBuffer = NULL;\nstatic wifi_config_t wifi_config;\n\nesp_err_t login_handler(httpd_req_t *req)\n{\n LOG(\"login\");\n const char resp[] = \"\";\n httpd_resp_send(req, resp, HTTPD_RESP_USE_STRLEN);\n return ESP_OK;\n}\n\nesp_err_t add_ap_handler(httpd_req_t *req)\n{\n LOG(\"add_ap\");\n\n /* Read URL query string length and allocate memory for length + 1,\n * extra byte for null termination */\n size_t buf_len = httpd_req_get_url_query_len(req) + 1;\n if (buf_len > 1 && buf_len < 256) {\n char* buf = (char*)malloc(buf_len);\n if (httpd_req_get_url_query_str(req, buf, buf_len) == ESP_OK) {\n char name[64];\n char password[64];\n /* Get value of expected key from query string */\n if ((httpd_query_key_value(buf, \"name\", name, sizeof(name)) == ESP_OK) &&\n (httpd_query_key_value(buf, \"password\", password, sizeof(password)) == ESP_OK)) {\n // save ap info, let TS handle it\n if (NULL == _lastApBuffer) {\n _lastApBuffer = buf;\n pxt::raiseEvent(_wifi::eventID(), (int)_wifi::WifiEvent::AccessPointCredentialsAvailable);\n const char resp[] = \"Restarting...\";\n httpd_resp_send(req, resp, HTTPD_RESP_USE_STRLEN);\n return ESP_OK;\n }\n }\n }\n free(buf);\n return ESP_OK;\n }\n\n httpd_resp_send_500(req);\n return ESP_OK;\n}\n\n//%\nRefCollection *_readLastAccessPointCredentials() {\n auto res = Array_::mk();\n registerGCObj(res);\n\n char name[64];\n char password[64];\n /* Get value of expected key from query string */\n if (NULL != _lastApBuffer &&\n (httpd_query_key_value(_lastApBuffer, \"name\", name, sizeof(name)) == ESP_OK) &&\n (httpd_query_key_value(_lastApBuffer, \"password\", password, sizeof(password)) == ESP_OK)) {\n\n {\n auto str = mkString(name, -1);\n registerGCObj(str);\n res->head.push((TValue)str);\n unregisterGCObj(str);\n } \n {\n auto str = mkString(password, -1);\n registerGCObj(str);\n res->head.push((TValue)str);\n unregisterGCObj(str);\n }\n }\n\n unregisterGCObj(res);\n return res;\n}\n\n// HTTP Error (404) Handler - Redirects all requests to the root page\nesp_err_t http_404_error_handler(httpd_req_t *req, httpd_err_code_t err)\n{\n // Set status\n httpd_resp_set_status(req, \"302 Temporary Redirect\");\n // Redirect to the \"/\" root directory\n httpd_resp_set_hdr(req, \"Location\", \"/\");\n // iOS requires content in the response to detect a captive portal, simply redirecting is not sufficient.\n httpd_resp_send(req, \"Redirect to the captive portal\", HTTPD_RESP_USE_STRLEN);\n\n ESP_LOGI(TAG, \"Redirecting to root\");\n return ESP_OK;\n}\n\n/* URI handler structure for GET / */\nhttpd_uri_t login_get = {\n .uri = \"/\",\n .method = HTTP_GET,\n .handler = login_handler,\n .user_ctx = NULL\n};\n\n/* URI handler structure for POST /uri */\nhttpd_uri_t add_ap_get = {\n .uri = \"/add-ap\",\n .method = HTTP_GET,\n .handler = add_ap_handler,\n .user_ctx = NULL\n};\n\n/* Function for starting the webserver */\nstatic void init(const char* hostName)\n{\n LOG(\"starting login server %s\", hostName);\n const char* ssid = hostName;\n\n esp_netif_create_default_wifi_ap();\n\n wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();\n ESP_ERROR_CHECK(esp_wifi_init(&cfg));\n\n memcpy(wifi_config.ap.ssid, ssid, strlen(ssid));\n wifi_config.ap.ssid_len = static_cast(strlen(ssid));\n wifi_config.ap.channel = 11;\n wifi_config.ap.max_connection = 1;\n wifi_config.ap.authmode = WIFI_AUTH_OPEN;\n\n ESP_ERROR_CHECK(esp_wifi_set_storage(WIFI_STORAGE_RAM));\n ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_APSTA));\n ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_AP, &wifi_config)); \n\n /* Generate default configuration */\n httpd_config_t config = HTTPD_DEFAULT_CONFIG();\n\n /* Empty handle to esp_http_server */\n httpd_handle_t server = NULL;\n\n ESP_ERROR_CHECK(httpd_start(&server, &config));\n\n httpd_register_uri_handler(server, &login_get);\n httpd_register_uri_handler(server, &add_ap_get);\n httpd_register_err_handler(server, HTTPD_404_NOT_FOUND, http_404_error_handler);\n\n esp_netif_ip_info_t ip_info;\n esp_netif_get_ip_info(esp_netif_get_handle_from_ifkey(\"WIFI_AP_DEF\"), &ip_info);\n LOG(\"SoftAP ip: \" IPSTR, IP2STR(&ip_info.ip));\n\n LOG(\"start mDNS service %s\", hostName);\n ESP_ERROR_CHECK(mdns_init());\n ESP_ERROR_CHECK(mdns_hostname_set(hostName));\n ESP_ERROR_CHECK(mdns_service_add(NULL, \"_http\", \"_tcp\", 80, NULL, 0));\n\n _server = server;\n}\n\nvoid startHttpServer(const char* hostName) {\n if (NULL == _server) {\n init(hostName);\n }\n}\n\n}",
"pxt.json": "{\n \"name\": \"wifi---esp32\",\n \"description\": \"WiFi implementation for ESP32\",\n \"dependencies\": {\n \"core\": \"*\",\n \"net\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"shims.d.ts\",\n \"enums.d.ts\",\n \"controller.ts\",\n \"wifi.h\",\n \"httpserver.cpp\",\n \"socket.cpp\",\n \"wifi.cpp\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"shims.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace _wifi {\n\n /** Allocate new socket. */\n //% shim=_wifi::socketAlloc\n function socketAlloc(): int32;\n\n /** Connect with TLS */\n //% promise shim=_wifi::socketConnectTLS\n function socketConnectTLS(fd: int32, host: string, port: int32): int32;\n\n /** Write to socket */\n //% promise shim=_wifi::socketWrite\n function socketWrite(fd: int32, data: Buffer): int32;\n\n /** Read from a socket; the return type is really number|Buffer */\n //% promise shim=_wifi::socketRead\n function socketRead(fd: int32, size: int32): int32;\n\n /** See how many bytes are available for reading */\n //% shim=_wifi::socketBytesAvailable\n function socketBytesAvailable(fd: int32): int32;\n\n /** Close the socket if open */\n //% shim=_wifi::socketClose\n function socketClose(fd: int32): int32;\n}\ndeclare namespace _wifi {\n\n /** Get ID used in events. */\n //% shim=_wifi::eventID\n function eventID(): int32;\n\n /** Start a WiFi network scan. */\n //% shim=_wifi::scanStart\n function scanStart(): void;\n\n /** Starts an HTTP server with a login dialog route */\n //% shim=_wifi::startLoginServer\n function startLoginServer(hostName: string): void;\n\n /** Get the results of the scan if any. */\n //% shim=_wifi::scanResults\n function scanResults(): Buffer;\n\n /** Initiate connection. */\n //% shim=_wifi::connect\n function connect(ssid: string, pass: string): int32;\n\n /** Initiate disconnection. */\n //% shim=_wifi::disconnect\n function disconnect(): int32;\n\n /** Check if connected. */\n //% shim=_wifi::isConnected\n function isConnected(): boolean;\n\n /** Check if login server is running */\n //% shim=_wifi::isLoginServerEnabled\n function isLoginServerEnabled(): boolean;\n\n /** Return ipv4 address, netmask, and gateway. */\n //% shim=_wifi::ipInfo\n function ipInfo(): Buffer;\n\n /** Get RSSI of current connection or -128 when not connected. */\n //% shim=_wifi::rssi\n function rssi(): int32;\n}\n\n// Auto-generated. Do not edit. Really.\n",
"socket.cpp": "#include \"wifi.h\"\n\n#include \"esp_tls.h\"\n#include \"esp_crt_bundle.h\"\n\n#define TAG \"ssl\"\n#define LOG(...) ESP_LOGI(TAG, __VA_ARGS__)\n\n#define MAX_SOCKET 16\n\nnamespace _wifi {\n\nstatic esp_tls_cfg_t tls_cfg;\n\nstruct socket_t {\n esp_tls_t *ssl;\n int bytesAvailable;\n struct read_args *readers;\n};\n\nstatic worker_t worker;\nstatic socket_t *sockets[MAX_SOCKET];\n\nstatic void process_reader(struct read_args *args);\n\nstatic void update_bytes_avail(socket_t *sock) {\n if (!sock->ssl)\n return;\n\n int ret = esp_tls_conn_read(sock->ssl, NULL, 0);\n int bytes = esp_tls_get_bytes_avail(sock->ssl);\n int emitEvent = 0;\n\n if (bytes == 0 && ret != 0 && ret != ESP_TLS_ERR_SSL_WANT_READ) {\n esp_tls_conn_destroy(sock->ssl);\n sock->ssl = NULL;\n emitEvent = 1;\n }\n\n // DMESG(\"updbyt: %d r=%d\", bytes, ret);\n\n if (bytes > 0) {\n // if we went from 0 to more, raise event\n if (sock->bytesAvailable == 0)\n emitEvent = 1;\n sock->bytesAvailable = bytes;\n } else\n sock->bytesAvailable = 0;\n\n if (emitEvent)\n for (int i = 0; i < MAX_SOCKET; ++i) {\n if (sockets[i] == sock) {\n raiseEvent(eventID(), 1000 + i);\n break;\n }\n }\n}\n\nstatic void flush_ssl(void *) {\n for (int i = 0; i < MAX_SOCKET; ++i) {\n auto s = sockets[i];\n if (!s || !s->ssl)\n continue;\n update_bytes_avail(s);\n while (s->bytesAvailable && s->readers) {\n process_reader(s->readers);\n }\n }\n}\n\nstatic void socket_init() {\n if (worker)\n return;\n worker = worker_alloc(\"ssl\", 10 * 1024);\n worker_set_idle(worker, flush_ssl, NULL);\n tls_cfg.crt_bundle_attach = esp_crt_bundle_attach;\n tls_cfg.non_block = true;\n tls_cfg.timeout_ms = 30000;\n}\n\n/** Allocate new socket. */\n//%\nint socketAlloc() {\n socket_init();\n for (int i = 1; i < MAX_SOCKET; ++i) {\n if (!sockets[i]) {\n sockets[i] = new socket_t;\n memset(sockets[i], 0, sizeof(*sockets[i]));\n return i;\n }\n }\n return -1;\n}\n\n#define GET_SOCK() \\\n if (fd <= 0 || fd >= MAX_SOCKET) \\\n return -10; \\\n auto sock = sockets[fd]; \\\n if (!sock) \\\n return -11;\n\n#define GET_SOCK_SSL() \\\n GET_SOCK(); \\\n if (!sock->ssl) \\\n return -12;\n\nstruct conn_args {\n socket_t *sock;\n FiberContext *ctx;\n const char *host;\n int port;\n};\n\nPXT_DEF_STRING(sOOM, \"ssl: Out of memory\")\nPXT_DEF_STRING(sHandshake, \"ssl: Handshake failed\")\nPXT_DEF_STRING(sError, \"ssl: error\")\n\nstatic void check_error(socket_t *sock, int r) {\n if (r < 0) {\n int err_code, flags;\n esp_err_t err =\n esp_tls_get_and_clear_last_error(sock->ssl->error_handle, &err_code, &flags);\n\n DMESG(\"ESP TLS error: err=%x (%d/%d) res=%d\", err, err_code, flags, r);\n vm_stack_trace();\n\n#if 0\n // can't really throw from here\n if (err == ESP_ERR_MBEDTLS_SSL_SETUP_FAILED) {\n pxt::throwValue((TValue)sOOM);\n } else if (err == ESP_ERR_MBEDTLS_SSL_HANDSHAKE_FAILED) {\n pxt::throwValue((TValue)sHandshake);\n } else {\n pxt::throwValue((TValue)sError);\n }\n#endif\n }\n}\n\nstatic void worker_conn(conn_args *args) {\n int r = esp_tls_conn_new_sync(args->host, strlen(args->host), args->port, &tls_cfg,\n args->sock->ssl);\n check_error(args->sock, r);\n resumeFiber(args->ctx, fromInt(r));\n delete args;\n}\n\n/** Connect with TLS */\n//% promise\nint socketConnectTLS(int fd, String host, int port) {\n memInfo();\n GET_SOCK();\n if (sock->ssl)\n return -2;\n if (port <= 0 || port > 0xffff)\n return -3;\n sock->ssl = esp_tls_init();\n auto args = new conn_args;\n args->host = host->getUTF8Data();\n args->port = port;\n args->sock = sock;\n args->ctx = suspendFiber();\n worker_run(worker, (TaskFunction_t)worker_conn, args);\n return 0; // ignored\n}\n\nstruct write_args {\n socket_t *sock;\n FiberContext *ctx;\n Buffer data;\n};\n\nstatic void worker_write(write_args *args) {\n int r = esp_tls_conn_write(args->sock->ssl, args->data->data, args->data->length);\n check_error(args->sock, r);\n resumeFiber(args->ctx, fromInt(r));\n delete args;\n}\n\n/** Write to socket */\n//% promise\nint socketWrite(int fd, Buffer data) {\n GET_SOCK_SSL();\n\n auto args = new write_args;\n args->data = data;\n args->sock = sock;\n args->ctx = suspendFiber();\n worker_run(worker, (TaskFunction_t)worker_write, args);\n return 0; // ignored\n}\n\nstruct read_args {\n socket_t *sock;\n FiberContext *ctx;\n int size;\n void *buf;\n struct read_args *next;\n};\n\nstatic Buffer mk_read_buffer(read_args *args) {\n auto res = mkBuffer(args->buf, args->size);\n free(args->buf);\n delete args;\n return res;\n}\n\nstatic void process_reader(read_args *args) {\n auto sock = args->sock;\n sock->readers = args->next;\n int num = args->size;\n if (num > sock->bytesAvailable)\n num = sock->bytesAvailable;\n args->buf = malloc(num);\n int r = esp_tls_conn_read(sock->ssl, args->buf, num);\n if (r < 0) {\n free(args->buf);\n resumeFiber(args->ctx, fromInt(r));\n delete args;\n } else {\n args->size = r;\n resumeFiberWithFn(args->ctx, (fiber_resume_t)mk_read_buffer, args);\n }\n\n update_bytes_avail(sock);\n}\n\nstatic void worker_read(read_args *args) {\n auto sock = args->sock;\n auto rd = sock->readers;\n while (rd && rd->next)\n rd = rd->next;\n if (rd) {\n rd->next = args;\n return; // there are other readers in front of us; don't do anything yet\n }\n\n sock->readers = args;\n update_bytes_avail(sock);\n if (sock->bytesAvailable)\n process_reader(args);\n}\n\n/** Read from a socket; the return type is really number|Buffer */\n//% promise\nint socketRead(int fd, int size) {\n GET_SOCK_SSL();\n\n if (size < 0)\n return -20;\n\n if (size == 0)\n return 0;\n\n auto args = new read_args;\n args->size = size;\n args->sock = sock;\n args->ctx = suspendFiber();\n args->next = NULL;\n worker_run(worker, (TaskFunction_t)worker_read, args);\n return 0; // ignored\n}\n\n/** See how many bytes are available for reading */\n//%\nint socketBytesAvailable(int fd) {\n GET_SOCK_SSL();\n return sock->bytesAvailable;\n}\n\nstatic void worker_close(socket_t *sock) {\n if (sock->ssl) {\n esp_tls_conn_destroy(sock->ssl);\n sock->ssl = NULL;\n }\n}\n\n/** Close the socket if open */\n//%\nint socketClose(int fd) {\n GET_SOCK();\n sockets[fd] = NULL;\n worker_run(worker, (TaskFunction_t)worker_close, sock);\n // wait for the actual close - we only really have memory for one open SSL socket...\n while (sock->ssl)\n vTaskDelay(5);\n free(sock);\n return 0;\n}\n\n} // namespace _wifi",
"wifi.cpp": "#include \"wifi.h\"\n#include \"freertos/event_groups.h\"\n#include \"esp_wifi.h\"\n#include \"esp_netif.h\"\n\n#define TAG \"wifi\"\n#define LOG(...) ESP_LOGI(TAG, __VA_ARGS__)\n#define WIFI_ID 1234\n\nvoid settings_init(void);\n\nnamespace _wifi {\n\n/** Get ID used in events. */\n//%\nint eventID() {\n return WIFI_ID;\n}\n\nstatic bool scan_done, is_connected, login_server;\nstatic esp_netif_ip_info_t ip_info;\n\nstatic void raiseWifiEvent(WifiEvent e) {\n raiseEvent(eventID(), (int)e);\n}\n\nstatic void scan_done_handler(void *arg, esp_event_base_t event_base, int32_t event_id,\n void *event_data) {\n scan_done = true;\n raiseWifiEvent(WifiEvent::ScanDone);\n}\n\nstatic void disconnect_handler(void *arg, esp_event_base_t event_base, int32_t event_id,\n void *event_data) {\n is_connected = false;\n LOG(\"sta disconnect\");\n raiseWifiEvent(WifiEvent::Disconnected);\n}\n\nstatic void got_ip_handler(void *arg, esp_event_base_t event_base, int32_t event_id,\n void *event_data) {\n is_connected = true;\n auto ev = (ip_event_got_ip_t *)event_data;\n ip_info = ev->ip_info;\n raiseWifiEvent(WifiEvent::GotIP);\n}\n\nstatic void init() {\n static bool initialized = false;\n\n if (initialized)\n return;\n\n esp_log_level_set(TAG, ESP_LOG_INFO);\n\n settings_init();\n\n ESP_ERROR_CHECK(esp_netif_init());\n ESP_ERROR_CHECK(esp_event_loop_create_default());\n\n wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();\n ESP_ERROR_CHECK(esp_wifi_init(&cfg));\n\n esp_netif_config_t netif_config = ESP_NETIF_DEFAULT_WIFI_STA();\n esp_netif_t *netif = esp_netif_new(&netif_config);\n assert(netif);\n ESP_ERROR_CHECK(esp_netif_attach_wifi_station(netif));\n ESP_ERROR_CHECK(esp_wifi_set_default_wifi_sta_handlers());\n\n ESP_ERROR_CHECK(\n esp_event_handler_register(WIFI_EVENT, WIFI_EVENT_SCAN_DONE, &scan_done_handler, NULL));\n ESP_ERROR_CHECK(esp_event_handler_register(WIFI_EVENT, WIFI_EVENT_STA_DISCONNECTED,\n &disconnect_handler, NULL));\n ESP_ERROR_CHECK(\n esp_event_handler_register(IP_EVENT, IP_EVENT_STA_GOT_IP, &got_ip_handler, NULL));\n ESP_ERROR_CHECK(esp_wifi_set_storage(WIFI_STORAGE_RAM));\n ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA));\n ESP_ERROR_CHECK(esp_wifi_start());\n\n initialized = true;\n}\n\n/** Start a WiFi network scan. */\n//%\nvoid scanStart() {\n init();\n\n scan_done = false;\n wifi_scan_config_t scan_config;\n memset(&scan_config, 0, sizeof(scan_config));\n // scan_config.scan_time.active.max = 600;\n esp_err_t err = esp_wifi_scan_start(&scan_config, false);\n LOG(\"scan start: %d\", err);\n}\n\n/** Starts an HTTP server with a login dialog route */\n//%\nvoid startLoginServer(String hostName) {\n if (!login_server) {\n login_server = true;\n init();\n _wifi::startHttpServer(hostName->getUTF8Data());\n }\n raiseWifiEvent(WifiEvent::LoginServerStarted);\n}\n\n#define JD_WIFI_APFLAGS_HAS_PASSWORD 0x1\n#define JD_WIFI_APFLAGS_WPS 0x2\n#define JD_WIFI_APFLAGS_HAS_SECONDARY_CHANNEL_ABOVE 0x4\n#define JD_WIFI_APFLAGS_HAS_SECONDARY_CHANNEL_BELOW 0x8\n#define JD_WIFI_APFLAGS_IEEE_802_11B 0x100\n#define JD_WIFI_APFLAGS_IEEE_802_11A 0x200\n#define JD_WIFI_APFLAGS_IEEE_802_11G 0x400\n#define JD_WIFI_APFLAGS_IEEE_802_11N 0x800\n#define JD_WIFI_APFLAGS_IEEE_802_11AC 0x1000\n#define JD_WIFI_APFLAGS_IEEE_802_11AX 0x2000\n#define JD_WIFI_APFLAGS_IEEE_802_LONG_RANGE 0x8000\n\ntypedef struct jd_wifi_results {\n uint32_t flags; // APFlags\n uint32_t reserved;\n int8_t rssi;\n uint8_t channel;\n uint8_t bssid[6]; // u8[6]\n char ssid[32]; // string\n} jd_wifi_results_t;\n\n/** Get the results of the scan if any. */\n//%\nBuffer scanResults() {\n if (!scan_done) {\n DMESG(\"scan not finished\");\n return NULL;\n }\n\n scan_done = false;\n\n uint16_t sta_number = 0;\n uint8_t i;\n wifi_ap_record_t *ap_list_buffer;\n\n esp_wifi_scan_get_ap_num(&sta_number);\n\n ap_list_buffer = (wifi_ap_record_t *)malloc(sta_number * sizeof(wifi_ap_record_t));\n\n Buffer res = NULL;\n\n esp_err_t err = esp_wifi_scan_get_ap_records(&sta_number, ap_list_buffer);\n\n if (err == ESP_OK || sta_number == 0) {\n\n int buffer_size = sizeof(jd_wifi_results_t) * sta_number;\n res = mkBuffer(NULL, buffer_size);\n auto dst = res->data;\n\n for (i = 0; i < sta_number; i++) {\n jd_wifi_results_t ent;\n wifi_ap_record_t *src = &ap_list_buffer[i];\n\n ent.reserved = 0;\n ent.flags = 0;\n\n if (src->phy_11b)\n ent.flags |= JD_WIFI_APFLAGS_IEEE_802_11B;\n if (src->phy_11g)\n ent.flags |= JD_WIFI_APFLAGS_IEEE_802_11G;\n if (src->phy_11n)\n ent.flags |= JD_WIFI_APFLAGS_IEEE_802_11N;\n if (src->phy_lr)\n ent.flags |= JD_WIFI_APFLAGS_IEEE_802_LONG_RANGE;\n if (src->wps)\n ent.flags |= JD_WIFI_APFLAGS_WPS;\n if (src->second == WIFI_SECOND_CHAN_ABOVE)\n ent.flags |= JD_WIFI_APFLAGS_HAS_SECONDARY_CHANNEL_ABOVE;\n if (src->second == WIFI_SECOND_CHAN_BELOW)\n ent.flags |= JD_WIFI_APFLAGS_HAS_SECONDARY_CHANNEL_BELOW;\n if (src->authmode != WIFI_AUTH_OPEN && src->authmode != WIFI_AUTH_WPA2_ENTERPRISE)\n ent.flags |= JD_WIFI_APFLAGS_HAS_PASSWORD;\n ent.channel = src->primary;\n ent.rssi = src->rssi;\n memcpy(ent.bssid, src->bssid, 6);\n memset(ent.ssid, 0, sizeof(ent.ssid));\n int len = strlen((char *)src->ssid);\n if (len > 32)\n len = 32;\n memcpy(ent.ssid, src->ssid, len);\n\n memcpy(dst, &ent, sizeof(ent));\n dst += sizeof(ent);\n }\n } else {\n DMESG(\"failed to read scan results: %d\", err);\n }\n\n free(ap_list_buffer);\n\n return res;\n}\n\n/** Initiate connection. */\n//%\nint connect(String ssid, String pass) {\n wifi_config_t cfg;\n memset(&cfg, 0, sizeof(cfg));\n strlcpy((char *)cfg.sta.ssid, ssid->getUTF8Data(), sizeof(cfg.sta.ssid));\n strlcpy((char *)cfg.sta.password, pass->getUTF8Data(), sizeof(cfg.sta.password));\n\n if (is_connected)\n return -1;\n\n ESP_ERROR_CHECK(esp_wifi_set_mode(WIFI_MODE_STA));\n ESP_ERROR_CHECK(esp_wifi_set_config(WIFI_IF_STA, &cfg));\n ESP_ERROR_CHECK(esp_wifi_connect());\n\n return 0;\n}\n\n/** Initiate disconnection. */\n//%\nint disconnect() {\n if (!is_connected)\n return -1;\n ESP_ERROR_CHECK(esp_wifi_disconnect());\n return 0;\n}\n\n/** Check if connected. */\n//%\nbool isConnected() {\n return is_connected;\n}\n\n/** Check if login server is running */\n//%\nbool isLoginServerEnabled() {\n return login_server;\n}\n\n/** Return ipv4 address, netmask, and gateway. */\n//%\nBuffer ipInfo() {\n return mkBuffer(&ip_info, sizeof(ip_info));\n}\n\n/** Get RSSI of current connection or -128 when not connected. */\n//%\nint rssi() {\n wifi_ap_record_t info;\n if (esp_wifi_sta_get_ap_info(&info) == 0)\n return info.rssi;\n return -128;\n}\n\n} // namespace _wifi",
"wifi.h": "#pragma once\n\n#include \"pxt.h\"\n#include \"esp_log.h\"\n\nnamespace pxt {\n// nothing here yet\n} // namespace pxt\n\nnamespace _wifi {\n enum class WifiEvent {\n //%\n ScanDone = 1,\n //%\n GotIP = 2,\n //%\n Disconnected = 3,\n //%\n AccessPointCredentialsAvailable = 4,\n //%\n LoginServerStarted = 5,\n };\n\n int eventID();\n void startHttpServer(const char* hostName);\n}"
},
"mqtt": {
"README.md": "# MQTT\n\nMQTT communication layer. A port of https://github.com/rovale/micro-mqtt for MakeCode.\n",
"mqtt.ts": "namespace mqtt {\n /**\n * Connect flags\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc385349229\n */\n export const enum ConnectFlags {\n UserName = 128,\n Password = 64,\n WillRetain = 32,\n WillQoS2 = 16,\n WillQoS1 = 8,\n Will = 4,\n CleanSession = 2\n }\n\n /**\n * Connect Return code\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc385349256\n */\n export const enum ConnectReturnCode {\n Unknown = -1,\n Accepted = 0,\n UnacceptableProtocolVersion = 1,\n IdentifierRejected = 2,\n ServerUnavailable = 3,\n BadUserNameOrPassword = 4,\n NotAuthorized = 5\n }\n\n /**\n * A message received in a Publish packet.\n */\n export interface IMessage {\n pid?: number;\n topic: string;\n content: Buffer;\n qos: number;\n retain: number;\n }\n\n /**\n * MQTT Control Packet type\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc353481061\n */\n export const enum ControlPacketType {\n Connect = 1,\n ConnAck = 2,\n Publish = 3,\n PubAck = 4,\n // PubRec = 5,\n // PubRel = 6,\n // PubComp = 7,\n Subscribe = 8,\n SubAck = 9,\n Unsubscribe = 10,\n UnsubAck = 11,\n PingReq = 12,\n PingResp = 13,\n Disconnect = 14\n }\n\n /**\n * Optimization, the TypeScript compiler replaces the constant enums.\n */\n export const enum Constants {\n PingInterval = 40,\n WatchDogInterval = 50,\n DefaultQos = 0,\n Uninitialized = -123,\n FixedPackedId = 1,\n KeepAlive = 60\n }\n\n /**\n * The options used to connect to the MQTT broker.\n */\n export interface IConnectionOptions {\n host: string;\n port?: number;\n username?: string;\n password?: string;\n clientId: string;\n will?: IConnectionOptionsWill;\n }\n\n export interface IConnectionOptionsWill {\n topic: string;\n message: string;\n qos?: number;\n retain?: boolean;\n }\n\n /**\n * The specifics of the MQTT protocol.\n */\n export module Protocol {\n function strChr(codes: number[]): Buffer {\n return pins.createBufferFromArray(codes)\n }\n\n /**\n * Encode remaining length\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718023\n */\n function encodeRemainingLength(remainingLength: number): number[] {\n let length: number = remainingLength;\n const encBytes: number[] = [];\n do {\n let encByte: number = length & 127;\n length = length >> 7;\n // if there are more data to encode, set the top bit of this byte\n if (length > 0) {\n encByte += 128;\n }\n encBytes.push(encByte);\n } while (length > 0);\n\n return encBytes;\n }\n\n /**\n * Connect flags\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc385349229\n */\n function createConnectFlags(options: IConnectionOptions): number {\n let flags: number = 0;\n flags |= (options.username) ? ConnectFlags.UserName : 0;\n flags |= (options.username && options.password) ? ConnectFlags.Password : 0;\n flags |= ConnectFlags.CleanSession;\n\n if (options.will) {\n flags |= ConnectFlags.Will;\n flags |= (options.will.qos || 0) << 3;\n flags |= (options.will.retain) ? ConnectFlags.WillRetain : 0;\n }\n\n return flags;\n }\n\n // Returns the MSB and LSB.\n function getBytes(int16: number): number[] {\n return [int16 >> 8, int16 & 255];\n }\n\n /**\n * Structure of UTF-8 encoded strings\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Figure_1.1_Structure\n */\n function pack(s: string): Buffer {\n const buf = control.createBufferFromUTF8(s);\n return strChr(getBytes(buf.length)).concat(buf);\n }\n\n /**\n * Structure of an MQTT Control Packet\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc384800392\n */\n function createPacketHeader(byte1: number, variable: Buffer, payloadSize: number): Buffer {\n const byte2: number[] = encodeRemainingLength(variable.length + payloadSize);\n return strChr([byte1])\n .concat(strChr(byte2))\n .concat(variable)\n }\n\n /**\n * Structure of an MQTT Control Packet\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc384800392\n */\n function createPacket(byte1: number, variable: Buffer, payload?: Buffer): Buffer {\n if (payload == null) payload = control.createBuffer(0);\n return createPacketHeader(byte1, variable, payload.length).concat(payload)\n }\n\n /**\n * CONNECT - Client requests a connection to a Server\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718028\n */\n export function createConnect(options: IConnectionOptions): Buffer {\n const byte1: number = ControlPacketType.Connect << 4;\n\n const protocolName = pack('MQTT');\n const nums = control.createBuffer(4)\n nums[0] = 4; // protocol level\n nums[1] = createConnectFlags(options)\n nums[2] = 0\n nums[3] = Constants.KeepAlive\n\n let payload = pack(options.clientId);\n\n if (options.will) {\n payload = payload\n .concat(pack(options.will.topic)\n .concat(pack(options.will.message)));\n }\n\n if (options.username) {\n payload = payload.concat(pack(options.username));\n if (options.password) {\n payload = payload.concat(pack(options.password));\n }\n }\n\n return createPacket(\n byte1,\n protocolName.concat(nums),\n payload\n );\n }\n\n /** PINGREQ - PING request\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc384800454\n */\n export function createPingReq() {\n return strChr([ControlPacketType.PingReq << 4, 0]);\n }\n\n /**\n * PUBLISH - Publish message header - doesn't include \"payload\"\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc384800410\n */\n export function createPublishHeader(topic: string, payloadSize: number, qos: number, retained: boolean) {\n let byte1: number = ControlPacketType.Publish << 4 | (qos << 1);\n byte1 |= (retained) ? 1 : 0;\n\n const pid = strChr(getBytes(Constants.FixedPackedId));\n const variable = (qos === 0) ? pack(topic) : pack(topic).concat(pid);\n\n return createPacketHeader(byte1, variable, payloadSize);\n }\n\n export function parsePublish(cmd: number, payload: Buffer): IMessage {\n const qos: number = (cmd & 0b00000110) >> 1;\n\n const topicLength = payload.getNumber(NumberFormat.UInt16BE, 0);\n let variableLength: number = 2 + topicLength;\n if (qos > 0) {\n variableLength += 2;\n }\n\n const message: IMessage = {\n topic: payload.slice(2, topicLength).toString(),\n content: payload.slice(variableLength),\n qos: qos,\n retain: cmd & 1\n };\n\n if (qos > 0)\n message.pid = payload.getNumber(NumberFormat.UInt16BE, variableLength - 2);\n\n return message;\n }\n\n /**\n * PUBACK - Publish acknowledgement\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc384800416\n */\n export function createPubAck(pid: number) {\n const byte1: number = ControlPacketType.PubAck << 4;\n\n return createPacket(byte1, strChr(getBytes(pid)));\n }\n\n /**\n * SUBSCRIBE - Subscribe to topics\n * http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc384800436\n */\n export function createSubscribe(topic: string, qos: number): Buffer {\n const byte1: number = ControlPacketType.Subscribe << 4 | 2;\n const pid = strChr(getBytes(Constants.FixedPackedId));\n\n return createPacket(byte1,\n pid,\n pack(topic).concat(strChr([qos])))\n }\n }\n\n export type EventHandler = (arg?: string | IMessage) => void;\n\n export class EventEmitter {\n private handlers: { [index: string]: EventHandler[] };\n\n constructor() {\n this.handlers = {};\n }\n\n public on(event: string, listener: EventHandler): void {\n if (!event || !listener) return;\n\n let listeners = this.handlers[event];\n if (!listeners)\n this.handlers[event] = listeners = [];\n listeners.push(listener);\n }\n protected emit(event: string, arg?: string | IMessage): boolean {\n let listeners = this.handlers[event];\n if (listeners) {\n listeners.forEach(listener => listener(arg));\n }\n return true;\n }\n }\n\n enum HandlerStatus {\n Normal = 0,\n Once = 1,\n ToRemove = 2,\n }\n\n class MQTTHandler {\n public status: HandlerStatus\n constructor(\n public topic: string,\n public handler: (m: IMessage) => void\n ) {\n this.status = HandlerStatus.Normal\n }\n }\n\n export enum Status {\n Disconnected = 0,\n Connecting = 1,\n Connected = 2,\n Sending = 3,\n }\n\n export class Client extends EventEmitter {\n public logPriority = ConsolePriority.Debug\n public tracePriority = -1 as ConsolePriority;\n\n private log(msg: string) {\n console.add(this.logPriority, `mqtt: ${msg}`);\n }\n\n private trace(msg: string) {\n console.add(this.tracePriority, `mqtt: ${msg}`);\n }\n\n public opt: IConnectionOptions;\n\n private net: net.Net;\n private sct?: net.Socket;\n\n private wdId: number;\n private piId: number;\n\n private buf: Buffer;\n // we re-send subscriptions on re-connect\n private subs: Buffer[] = [];\n\n public status = Status.Disconnected\n\n get connected() {\n return this.status >= Status.Connected\n }\n\n private mqttHandlers: MQTTHandler[];\n\n constructor(opt: IConnectionOptions) {\n super();\n\n this.wdId = Constants.Uninitialized;\n this.piId = Constants.Uninitialized;\n opt.port = opt.port || 8883;\n opt.clientId = opt.clientId;\n\n if (opt.will) {\n opt.will.qos = opt.will.qos || Constants.DefaultQos;\n opt.will.retain = opt.will.retain || false;\n }\n\n this.opt = opt;\n this.net = net.instance();\n }\n\n private static describe(code: ConnectReturnCode): string {\n let error: string = 'Connection refused, ';\n switch (code) {\n case ConnectReturnCode.UnacceptableProtocolVersion:\n error += 'unacceptable protocol version.';\n break;\n case ConnectReturnCode.IdentifierRejected:\n error += 'identifier rejected.';\n break;\n case ConnectReturnCode.ServerUnavailable:\n error += 'server unavailable.';\n break;\n case ConnectReturnCode.BadUserNameOrPassword:\n error += 'bad user name or password.';\n break;\n case ConnectReturnCode.NotAuthorized:\n error += 'not authorized.';\n break;\n default:\n error += `unknown return code: ${code}.`;\n }\n\n return error;\n }\n\n public disconnect(): void {\n this.log(\"disconnect\")\n if (this.wdId !== Constants.Uninitialized) {\n clearInterval(this.wdId);\n this.wdId = Constants.Uninitialized;\n }\n\n if (this.piId !== Constants.Uninitialized) {\n clearInterval(this.piId);\n this.piId = Constants.Uninitialized;\n }\n\n const s = this.sct\n if (s) {\n this.sct = null\n s.close()\n }\n\n this.status = Status.Disconnected\n }\n\n public connect(): void {\n if (this.status != Status.Disconnected)\n return\n this.status = Status.Connecting\n this.log(`Connecting to ${this.opt.host}:${this.opt.port}`);\n if (this.wdId === Constants.Uninitialized) {\n this.wdId = setInterval(() => {\n if (!this.connected) {\n this.emit('disconnected');\n this.emit('error', 'No connection. Retrying.');\n this.disconnect();\n this.connect();\n }\n }, Constants.WatchDogInterval * 1000);\n }\n\n this.sct = this.net.createSocket(this.opt.host, this.opt.port, true);\n this.sct.onOpen(() => {\n this.log('Network connection established.');\n this.emit('connect');\n this.send(Protocol.createConnect(this.opt));\n });\n this.sct.onMessage((msg: Buffer) => {\n this.trace(\"incoming \" + msg.length + \" bytes\")\n this.handleMessage(msg);\n });\n this.sct.onError(() => {\n this.log('Error.');\n this.emit('error');\n });\n this.sct.onClose(() => {\n this.log('Close.');\n this.emit('disconnected');\n this.status = Status.Disconnected\n this.sct = null;\n });\n this.sct.connect();\n }\n\n private canSend() {\n let cnt = 0\n while (true) {\n if (this.status == Status.Connected) {\n this.status = Status.Sending\n return true\n }\n if (cnt++ < 100 && this.status == Status.Sending)\n pause(20)\n else {\n this.log(\"drop pkt\")\n return false\n }\n }\n }\n\n private doneSending() {\n this.trace(\"done send\")\n if (this.status == Status.Sending)\n this.status = Status.Connected\n }\n\n // Publish a message\n public publish(topic: string, message?: string | Buffer, qos: number = Constants.DefaultQos, retained: boolean = false): void {\n const buf = typeof message == \"string\" ? control.createBufferFromUTF8(message) : message\n message = null\n if (this.startPublish(topic, buf ? buf.length : 0, qos, retained)) {\n if (buf)\n this.send(buf);\n this.finishPublish()\n }\n }\n\n public startPublish(topic: string, messageLen: number, qos: number = Constants.DefaultQos, retained: boolean = false) {\n if (!this.canSend()) return false\n this.trace(`publish: ${topic} ${messageLen}b`)\n this.send(Protocol.createPublishHeader(topic, messageLen, qos, retained));\n return true\n }\n\n public continuePublish(data: Buffer) {\n this.send(data)\n }\n\n public finishPublish() {\n this.doneSending()\n this.emit(\"published\")\n }\n\n private subscribeCore(topic: string, handler: (msg: IMessage) => void, qos: number = Constants.DefaultQos): MQTTHandler {\n this.log(`subscribe: ${topic}`)\n const sub = Protocol.createSubscribe(topic, qos)\n this.subs.push(sub)\n this.send1(sub);\n if (handler) {\n if (topic[topic.length - 1] == \"#\")\n topic = topic.slice(0, topic.length - 1)\n if (!this.mqttHandlers) this.mqttHandlers = []\n const h = new MQTTHandler(topic, handler)\n this.mqttHandlers.push(h)\n return h\n } else {\n return null\n }\n }\n\n // Subscribe to topic\n public subscribe(topic: string, handler?: (msg: IMessage) => void, qos: number = Constants.DefaultQos): void {\n this.subscribeCore(topic, handler, qos)\n }\n\n // Subscribe to one update on the topic. Returns function that waits for the topic to be updated.\n public awaitUpdate(topic: string, qos: number = Constants.DefaultQos): () => IMessage {\n let res: IMessage = null\n const evid = control.allocateNotifyEvent()\n const h = this.subscribeCore(topic, msg => {\n res = msg\n control.raiseEvent(DAL.DEVICE_ID_NOTIFY, evid)\n }, qos)\n h.status = HandlerStatus.Once\n return () => {\n while (res == null) {\n control.waitForEvent(DAL.DEVICE_ID_NOTIFY, evid)\n }\n return res\n }\n }\n\n private send(data: Buffer): void {\n if (this.sct) {\n this.trace(\"send: \" + data[0] + \" / \" + data.length + \" bytes\")\n // this.log(\"send: \" + data[0] + \" / \" + data.length + \" bytes: \" + data.toHex())\n this.sct.send(data);\n }\n }\n\n private handleMessage(data: Buffer) {\n if (this.buf)\n data = this.buf.concat(data)\n this.buf = data\n if (data.length < 2)\n return\n let len = data[1]\n let payloadOff = 2\n if (len & 0x80) {\n if (data.length < 3)\n return\n if (data[2] & 0x80) {\n this.emit('error', `too large packet.`);\n this.buf = null\n return\n }\n len = (data[2] << 7) | (len & 0x7f)\n payloadOff++\n }\n\n const payloadEnd = payloadOff + len\n if (data.length < payloadEnd)\n return // wait for the rest of data\n\n this.buf = null\n\n const cmd = data[0]\n const controlPacketType: ControlPacketType = cmd >> 4;\n // this.emit('debug', `Rcvd: ${controlPacketType}: '${data}'.`);\n\n const payload = data.slice(payloadOff, payloadEnd - payloadOff)\n\n switch (controlPacketType) {\n case ControlPacketType.ConnAck:\n const returnCode: number = payload[1];\n if (returnCode === ConnectReturnCode.Accepted) {\n this.log('MQTT connection accepted.');\n this.emit('connected');\n this.status = Status.Connected;\n this.piId = setInterval(() => this.ping(), Constants.PingInterval * 1000);\n for (const sub of this.subs)\n this.send1(sub);\n } else {\n const connectionError: string = Client.describe(returnCode);\n this.log('MQTT connection error: ' + connectionError);\n this.emit('error', connectionError);\n this.disconnect()\n }\n break;\n case ControlPacketType.Publish:\n const message: IMessage = Protocol.parsePublish(cmd, payload);\n this.trace(`incoming: ${message.topic}`)\n let handled = false\n let cleanup = false\n if (this.mqttHandlers) {\n for (let h of this.mqttHandlers)\n if (message.topic.slice(0, h.topic.length) == h.topic) {\n h.handler(message)\n handled = true\n if (h.status == HandlerStatus.Once) {\n h.status = HandlerStatus.ToRemove\n cleanup = true\n }\n }\n if (cleanup)\n this.mqttHandlers = this.mqttHandlers.filter(h => h.status != HandlerStatus.ToRemove)\n }\n if (!handled)\n this.emit('receive', message);\n if (message.qos > 0) {\n setTimeout(() => {\n this.send1(Protocol.createPubAck(message.pid || 0));\n }, 0);\n }\n break;\n case ControlPacketType.PingResp:\n case ControlPacketType.PubAck:\n case ControlPacketType.SubAck:\n break;\n default:\n this.emit('error', `MQTT unexpected packet type: ${controlPacketType}.`);\n }\n\n if (data.length > payloadEnd)\n this.handleMessage(data.slice(payloadEnd))\n }\n\n private send1(msg: Buffer) {\n if (this.canSend()) {\n this.send(msg)\n this.doneSending()\n }\n }\n\n private ping() {\n this.send1(Protocol.createPingReq());\n this.emit('debug', 'Sent: Ping request.');\n }\n }\n}",
"pxt.json": "{\n \"name\": \"mqtt\",\n \"description\": \"MQTT for MakeCode - beta\",\n \"dependencies\": {\n \"core\": \"*\",\n \"net\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"mqtt.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n },\n \"tests\": [\n \"test.ts\"\n ]\n}\n"
},
"azureiot": {
"README.md": "# Azure IoT support - beta\n\nAzure MQTT communication layer. \nA port of https://github.com/rovale/micro-mqtt for MakeCode.\n\n## Settings\n\nThe connection string should be stored in the \"azureiot\" secret in the settings.",
"azureiot.ts": "const enum AzureIotEvent {\n Connected = 1,\n Disconnected = 2,\n Error = 3,\n GotTwinResponse = 100,\n}\n\nnamespace azureiot {\n export const SECRETS_KEY = \"azureiot\"\n\n export let logPriority = ConsolePriority.Debug;\n\n type SMap = { [s: string]: T; }\n export type Json = any;\n\n let _mqttClient: mqtt.Client;\n let _messageBusId: number;\n let _receiveHandler: (msg: Json, sysProps: SMap) => void;\n let _methodHandlers: SMap<(msg: Json) => Json>;\n let twinRespHandlers: SMap<(status: number, body: any) => void>\n\n function log(msg: string) {\n console.add(logPriority, \"azureiot: \" + msg);\n }\n\n export function mqttClient(skipCreate?: boolean): mqtt.Client {\n if (!_mqttClient && !skipCreate) {\n log(\"creating mqtt client\")\n _mqttClient = createMQTTClient();\n }\n return _mqttClient;\n }\n\n function generateSasToken(resourceUri: string, signingKey: string, expiresEpoch: number) {\n const key = Buffer.fromBase64(signingKey)\n resourceUri = net.urlencode(resourceUri)\n const toSign = resourceUri + \"\\n\" + expiresEpoch\n const sig = net.urlencode(crypto.sha256Hmac(key, Buffer.fromUTF8(toSign)).toBase64())\n const token = `sr=${resourceUri}&se=${expiresEpoch}&sig=${sig}`\n return token\n }\n\n export function hubName() {\n return connectionStringPart(\"HostName\")\n }\n\n export function hubDeviceId() {\n return connectionStringPart(\"DeviceId\")\n }\n\n function messageBusId() {\n if (!_messageBusId)\n _messageBusId = control.allocateEventSource();\n return _messageBusId\n }\n\n function createMQTTClient() {\n messageBusId()\n const iotHubHostName = hubName()\n const deviceId = hubDeviceId()\n if (!iotHubHostName || !deviceId)\n throw \"invalid connection string\"\n\n const connStringParts = parseConnectionString();\n let sasToken = connStringParts[\"SharedAccessSignature\"];\n if (!sasToken)\n // token valid until year 2255; in future we may try something more short-lived\n sasToken = generateSasToken(`${iotHubHostName}/devices/${deviceId}`, connStringParts[\"SharedAccessKey\"], 9000000000)\n\n const opts: mqtt.IConnectionOptions = {\n host: iotHubHostName,\n /* port: 8883, overriden based on platform */\n username: `${iotHubHostName}/${deviceId}/?api-version=2018-06-30`,\n password: \"SharedAccessSignature \" + sasToken,\n clientId: deviceId\n }\n const c = new mqtt.Client(opts);\n const evid = messageBusId()\n c.on('connected', () => {\n log(\"connected\")\n control.raiseEvent(evid, AzureIotEvent.Connected)\n });\n c.on('disconnected', () => {\n log(\"disconnected\")\n control.raiseEvent(evid, AzureIotEvent.Disconnected)\n });\n c.on('error', (msg) => {\n log(\"error: \" + msg)\n control.raiseEvent(evid, AzureIotEvent.Error)\n });\n c.on('receive', (packet: mqtt.IMessage) => {\n log(\"unhandled msg: \" + packet.topic + \" / \" + packet.content.toString())\n });\n c.connect();\n return c;\n }\n\n function splitPair(kv: string): string[] {\n const i = kv.indexOf('=');\n if (i < 0)\n return [kv, \"\"];\n else\n return [kv.slice(0, i), kv.slice(i + 1)];\n }\n\n function parsePropertyBag(msg: string, separator?: string): SMap {\n const r: SMap = {};\n if (msg && typeof msg === \"string\")\n msg.split(separator || \"&\")\n .map(kv => splitPair(kv))\n .filter(parts => !!parts[1].length)\n .forEach(parts => r[net.urldecode(parts[0])] = net.urldecode(parts[1]));\n return r;\n }\n\n function parseConnectionString() {\n try {\n const connString = settings.programSecrets.readSecret(SECRETS_KEY);\n const connStringParts = parsePropertyBag(connString, \";\");\n return connStringParts\n } catch {\n console.debug(`clearing invalid azure iot connection string`)\n settings.programSecrets.setSecret(SECRETS_KEY, \"\")\n return {}\n }\n }\n\n function connectionStringPart(name: string) {\n const connStringParts = parseConnectionString()\n const value = connStringParts[name];\n return value || \"\"\n }\n\n function encodeQuery(props: SMap): string {\n const keys = Object.keys(props)\n if (keys.length == 0)\n return \"\"\n return \"?\" + keys\n .map(k => `${net.urlencode(k)}=${net.urlencode(props[k])}`)\n .join('&');\n }\n\n export function setConnectionString(connectionString: string) {\n disconnect()\n settings.programSecrets.setSecret(SECRETS_KEY, connectionString)\n parseConnectionString()\n }\n\n /**\n * Disconnects the hub if any\n */\n export function disconnect() {\n const c = mqttClient(true)\n if (c) {\n try {\n c.disconnect()\n }\n catch {\n // just ignore errors disconnecting\n }\n }\n }\n\n /**\n * Connects to the IoT hub\n */\n export function connect() {\n const c = mqttClient();\n if (!c.connected) {\n c.connect() // start connect if not started yet\n // busy wait for connection\n const start = control.millis()\n const timeout = 30000\n while (!c.connected && control.millis() - start < timeout) {\n pause(1000)\n }\n if (!c.connected)\n throw \"connection failed\"\n }\n }\n\n /**\n * Registers code when the MQTT client gets connected or disconnected\n * @param event \n * @param handler \n */\n export function onEvent(event: AzureIotEvent, handler: () => void) {\n const evid = messageBusId()\n control.onEvent(evid, event, handler);\n try {\n const c = mqttClient(true);\n if (c && c.connected) // raise connected event by default\n control.raiseEvent(evid, AzureIotEvent.Connected);\n } catch { }\n }\n\n /**\n * Indicates if the MQTT client is connected\n */\n //%\n export function isConnected(): boolean {\n try {\n const c = mqttClient(true);\n return !!c && !!c.connected;\n }\n catch {\n return false\n }\n }\n\n /**\n * Send a message via mqtt\n * @param msg \n */\n //%\n export function publishMessageJSON(msg: Json, sysProps?: SMap) {\n const c = mqttClient();\n let topic = `devices/${c.opt.clientId}/messages/events/`;\n if (sysProps)\n topic += encodeQuery(sysProps);\n const m = JSON.stringify(msg)\n msg = null\n // qos, retained are not supported\n c.publish(topic, m);\n }\n\n /**\n * Send a message via mqtt\n * @param msg \n */\n //%\n export function publishMessageBuffer(msg: Buffer, sysProps?: SMap) {\n const c = mqttClient();\n let topic = `devices/${c.opt.clientId}/messages/events/`;\n if (sysProps)\n topic += encodeQuery(sysProps);\n // qos, retained are not supported\n c.publish(topic, msg);\n }\n\n /**\n * Send a message via mqtt\n * @param msg \n */\n //%\n export function publishMessageHex(msg: Buffer, len?: number, sysProps?: SMap) {\n const c = mqttClient();\n let topic = `devices/${c.opt.clientId}/messages/events/`;\n if (sysProps)\n topic += encodeQuery(sysProps);\n if (len == null)\n len = msg.length\n if (len > msg.length) {\n log(`len too long: ${len}/${msg.length}`)\n len = msg.length\n }\n // qos, retained are not supported\n if (c.startPublish(topic, len * 2)) {\n const chunk = 128\n for (let ptr = 0; ptr < len; ptr += chunk)\n c.continuePublish(Buffer.fromUTF8(msg.slice(ptr, Math.min(chunk, len - ptr)).toHex()))\n c.finishPublish()\n }\n }\n\n /**\n * Registers code to run when a message is received\n * @param handler \n */\n //%\n export function onMessageReceived(handler: (body: Json, sysProps: SMap) => void) {\n const c = mqttClient();\n if (!_receiveHandler) {\n c.subscribe(`devices/${c.opt.clientId}/messages/devicebound/#`, handleDeviceBound);\n\n /*\n c.subscribe('$iothub/twin/PATCH/properties/desired/#')\n */\n }\n _receiveHandler = handler;\n }\n\n function parseTopicArgs(topic: string) {\n const qidx = topic.indexOf(\"?\")\n if (qidx >= 0)\n return parsePropertyBag(topic.slice(qidx + 1))\n return {}\n }\n\n function handleDeviceBound(packet: mqtt.IMessage) {\n if (!_receiveHandler) return; // nobody's listening\n // TODO this needs some testing\n const sysProps = parseTopicArgs(packet.topic)\n _receiveHandler(JSON.parse(packet.content.toString()), sysProps);\n }\n\n function handleMethod(msg: mqtt.IMessage) {\n const props = parseTopicArgs(msg.topic)\n const qidx = msg.topic.indexOf(\"/?\")\n const methodName = msg.topic.slice(21, qidx)\n log(\"method: '\" + methodName + \"'; \" + JSON.stringify(props))\n let status = 200\n let resp: any = {}\n if (!_methodHandlers[methodName]) {\n log(\"method not found: '\" + methodName + \"'\")\n status = 404\n } else {\n const h = _methodHandlers[methodName]\n const resp2 = h(JSON.parse(msg.content.toString()))\n if (resp2)\n resp = resp2\n if (resp[\"_status\"] != null) {\n status = resp[\"_status\"]\n resp[\"_status\"] = undefined\n }\n log(\"method: '\" + methodName + \"' status=\" + status)\n }\n\n const c = mqttClient();\n c.publish('$iothub/methods/res/' + status + \"/?$rid=\" + props[\"$rid\"], JSON.stringify(resp))\n }\n\n // $iothub/twin/res/{status}/?$rid={request id}\n function twinResponse(msg: mqtt.IMessage) {\n const args = parseTopicArgs(msg.topic)\n const h = twinRespHandlers[args[\"$rid\"]]\n const status = parseInt(msg.topic.slice(17))\n // log(`twin resp: ${status} ${msg.content.toHex()} ${msg.content.toString()}`)\n if (h) {\n delete twinRespHandlers[args[\"$rid\"]]\n h(status, JSON.parse(msg.content.toString() || \"{}\"))\n }\n }\n\n export class ValueAwaiter {\n private evid: number\n private value: any\n constructor() {\n this.evid = control.allocateNotifyEvent()\n }\n setValue(v: any) {\n this.value = v\n control.raiseEvent(DAL.DEVICE_ID_NOTIFY, this.evid)\n this.evid = -1\n }\n wait() {\n if (this.evid < 0) return this.value\n control.waitForEvent(DAL.DEVICE_ID_NOTIFY, this.evid)\n return this.value\n }\n }\n\n function twinReq(path: string, msg?: string): Json {\n const c = mqttClient();\n if (!twinRespHandlers) {\n twinRespHandlers = {}\n c.subscribe(\"$iothub/twin/res/#\", twinResponse)\n }\n const rid = Math.randomRange(100000000, 900000000) + \"\"\n const va = new ValueAwaiter()\n twinRespHandlers[rid] = (status, body) => {\n if (status == 204 || status == 200) {\n va.setValue(body)\n } else {\n log(`twin error -> ${status} ${JSON.stringify(body)}`)\n va.setValue(null)\n }\n }\n c.publish(`$iothub/twin/${path}/?$rid=${rid}`, msg)\n return va.wait()\n }\n\n export function getTwin(): Json {\n return twinReq(\"GET\")\n }\n\n export function patchTwin(patch: Json) {\n const p = JSON.stringify(patch)\n if (p == \"{}\")\n log(\"skipping empty twin patch\")\n else {\n log(`twin patch: ${JSON.stringify(patch)}`)\n twinReq(\"PATCH/properties/reported\", p)\n }\n }\n\n export function computePatch(curr: Json, target: Json) {\n const patch: Json = {}\n for (const k of Object.keys(curr)) {\n const vt = target[k]\n if (k[0] == \"$\")\n continue\n if (vt === undefined) {\n patch[k] = null\n } else {\n const vc = curr[k]\n if (typeof vt == \"object\")\n if (typeof vc == \"object\") {\n const p0 = computePatch(vc, vt)\n if (Object.keys(p0).length > 0)\n patch[k] = p0\n } else {\n patch[k] = vt\n }\n else if (vc != vt)\n patch[k] = vt\n }\n }\n for (const k of Object.keys(target)) {\n if (curr[k] === undefined && k[0] != \"$\")\n patch[k] = target[k]\n }\n return patch\n }\n\n export function applyPatch(trg: Json, patch: Json) {\n for (const k of Object.keys(patch)) {\n const v = patch[k]\n if (v === null) {\n delete trg[k]\n } else if (typeof v == \"object\") {\n if (!trg[k]) trg[k] = {}\n applyPatch(trg[k], v)\n } else {\n trg[k] = v\n }\n }\n }\n\n export function onTwinUpdate(handler: (twin: Json, patch: Json) => void) {\n const c = mqttClient()\n let currTwin: Json = null\n let lastVersion: number\n c.subscribe(\"$iothub/twin/PATCH/properties/desired/#\", msg => {\n if (!currTwin)\n return\n const sysProps = parseTopicArgs(msg.topic)\n const ver = parseInt(sysProps[\"$version\"])\n if (ver <= lastVersion) {\n log(`skipping twin update: ${ver}`)\n return\n }\n const update = JSON.parse(msg.content.toString())\n applyPatch(currTwin[\"desired\"], update)\n handler(currTwin, update)\n })\n currTwin = getTwin()\n lastVersion = currTwin[\"desired\"][\"$version\"]\n handler(currTwin, currTwin[\"desired\"])\n }\n\n export function onMethod(methodName: string, handler: (msg: Json) => Json) {\n const c = mqttClient();\n if (!_methodHandlers) {\n if (!c.connected)\n throw \"azure iot hub not connected\"\n _methodHandlers = {}\n c.subscribe('$iothub/methods/POST/#', handleMethod)\n }\n _methodHandlers[methodName] = handler\n }\n}\n",
"pxt.json": "{\n \"name\": \"azureiot\",\n \"description\": \"Azure IoT - beta\",\n \"dependencies\": {\n \"mqtt\": \"*\",\n \"settings\": \"*\"\n },\n \"files\": [\n \"azureiot.ts\",\n \"README.md\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"testDependencies\": {\n \"esp32\": \"file:../esp32\"\n },\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"test.ts": "function test() {\n\n const log = console.log;\n const esp = net.instance().controller();\n\n if (!esp.connect()) {\n log(\"can't connect\")\n return\n }\n\n log(\"ping: \" + esp.ping(\"bing.com\"))\n\n azureiot.connect()\n log(\"mqtt connected\")\n\n azureiot.onMessageReceived((msg) => {\n log(\"MSG:\" + JSON.stringify(msg))\n })\n\n azureiot.onMethod(\"echo\", msg => {\n log(\"ECHO \" + msg.displayedValue)\n msg.type = \"echo\"\n return {}\n })\n}\n\ntest();"
},
"settings": {
"Flash.h": "#ifndef CODAL_FLASH_H\n#define CODAL_FLASH_H\n\n#include \"CodalDevice.h\"\n\nnamespace codal {\nclass Flash {\n public:\n /**\n * Return page size in bytes at given address (doesn't have to be page-aligned).\n */\n virtual int pageSize(uintptr_t address) = 0;\n\n /**\n * Erase page at given page-aligned address.\n */\n virtual int erasePage(uintptr_t address) = 0;\n\n /**\n * Write given number of bytes within one page. Flash has to be erased first.\n */\n virtual int writeBytes(uintptr_t dst, const void *src, uint32_t len) = 0;\n\n /**\n * Return the total size of flash.\n */\n virtual int totalSize();\n};\n\nclass ZFlash : public Flash {\n public:\n virtual int pageSize(uintptr_t address);\n virtual int totalSize();\n virtual int erasePage(uintptr_t address);\n virtual int writeBytes(uintptr_t dst, const void *src, uint32_t len);\n};\n\n#define CODAL_FLASH codal::ZFlash\n#define DEVICE_FLASH_ERROR 922\n\n\n} // namespace codal\n\n#endif\n",
"NRF52Flash.cpp": "#include \"pxt.h\"\n#include \"Flash.h\"\n\n//#define LOG DMESG\n#define LOG NOLOG\n\n#if defined(NRF52_SERIES)\nnamespace codal {\n\n#define waitForLast() while ((NRF_NVMC->READY & NVMC_READY_READY_Msk) == 0);\n\nstatic volatile bool flash_op_complete = false;\n\n#ifdef SOFTDEVICE_PRESENT\n#include \"nrf_sdh_soc.h\"\n#include \"nrf_sdm.h\"\n\nstatic void nvmc_event_handler(uint32_t sys_evt, void *)\n{\n if (sys_evt == NRF_EVT_FLASH_OPERATION_SUCCESS)\n flash_op_complete = true;\n}\n\nNRF_SDH_SOC_OBSERVER(nrfflash_soc_observer, 0, nvmc_event_handler, NULL);\n\n#ifndef MICROBIT_CODAL\nbool ble_running()\n{\n uint8_t t = 0;\n sd_softdevice_is_enabled(&t);\n return t==1;\n}\n#endif\n\n#endif\n\n\nstatic inline uint32_t NRF_PAGE_SIZE() {\n#if defined(FICR_INFO_CODEPAGESIZE_CODEPAGESIZE_Msk)\n return NRF_FICR->INFO.CODEPAGESIZE;\n#else\n return NRF_FICR->CODEPAGESIZE;\n#endif\n}\n\nint ZFlash::pageSize(uintptr_t address) {\n (void)address;\n#if defined(FICR_INFO_CODEPAGESIZE_CODEPAGESIZE_Msk)\n return NRF_FICR->INFO.CODEPAGESIZE;\n#else\n return NRF_FICR->CODEPAGESIZE;\n#endif\n}\n\nint ZFlash::totalSize() {\n#if defined(FICR_INFO_CODEPAGESIZE_CODEPAGESIZE_Msk)\n return NRF_FICR->INFO.CODESIZE * pageSize(0);\n#else\n return NRF_FICR->CODESIZE * pageSize(0);\n#endif\n}\n\nint ZFlash::erasePage(uintptr_t address) {\n if (address & (pageSize(address) - 1))\n target_panic(DEVICE_FLASH_ERROR);\n\n#ifdef SOFTDEVICE_PRESENT\n if (ble_running())\n {\n flash_op_complete = false;\n while(1)\n {\n if ( sd_flash_page_erase(((uint32_t)address)/NRF_PAGE_SIZE()) == NRF_SUCCESS)\n break;\n\n system_timer_wait_ms(10);\n }\n\n while(!flash_op_complete);\n }\n else\n#endif\n {\n NRF_NVMC->CONFIG = NVMC_CONFIG_WEN_Een;\n waitForLast();\n NRF_NVMC->ERASEPAGE = address;\n waitForLast();\n NRF_NVMC->CONFIG = NVMC_CONFIG_WEN_Ren;\n waitForLast();\n }\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 \n volatile uint32_t *sp = (uint32_t *)src;\n volatile uint32_t *dp = (uint32_t *)dst;\n\n len >>= 2;\n\n#ifdef SOFTDEVICE_PRESENT\n if (ble_running())\n {\n flash_op_complete = false;\n\n while(1)\n {\n if (sd_flash_write((uint32_t *)dp, (uint32_t *)sp, len) == NRF_SUCCESS)\n break;\n\n system_timer_wait_ms(10);\n }\n\n while(!flash_op_complete);\n }\n else\n#endif\n {\n NRF_NVMC->CONFIG = NVMC_CONFIG_WEN_Wen;\n waitForLast();\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 NRF_NVMC->CONFIG = NVMC_CONFIG_WEN_Ren;\n waitForLast();\n }\n\n LOG(\"WR flash OK\");\n\n return 0;\n}\n} // namespace codal\n#endif\n",
"RAFFS.cpp": "#include \"RAFFS.h\"\n#include \"CodalDmesg.h\"\n#include \"NotifyEvents.h\"\n#include \"MessageBus.h\"\n#include \"Timer.h\"\n#include \"pxtbase.h\"\n\n#include \n\n#define RAFFS_MAGIC 0x7776e0da\n#define M1 0xffffffffU\n\n#define CHECK\n//#undef CHECK\n\nusing namespace codal;\n\n#define oops() target_panic(DEVICE_FLASH_ERROR)\n\n#define OFF2(v, basePtr) (uint32_t)((uint8_t *)v - (uint8_t *)basePtr)\n#define OFF(v) OFF2(v, basePtr)\n\n#define REAL_OFF(dst) (OFF(dst) <= OFF2(dst, altBasePtr()) ? OFF(dst) : OFF2(dst, altBasePtr()))\n\n#undef NOLOG\n#define NOLOG(...) ((void)0)\n#ifndef RAFFS_TEST\n#define LOG DMESG\n#define LOGV NOLOG\n#endif\n\n#define LOGVV NOLOG\n\n#if 0\n#undef LOGV\n#define LOGV DMESG\n#endif\n\n#if 0\n#undef LOGVV\n#define LOGVV DMESG\n#endif\n\nusing namespace pxt::raffs;\n\nstatic uint16_t raffs_unlocked_event;\n\nstruct FSHeader {\n uint32_t magic;\n uint32_t bytes;\n uint32_t numgc;\n uint32_t reserved;\n};\n\nstatic uint16_t fnhash(const char *fn) {\n uint32_t h = hash_fnv1(fn, strlen(fn));\n return h ^ (h >> 16);\n}\n\nFS::FS(Flash &flash, uintptr_t baseAddr, uint32_t bytes)\n : flash(flash), baseAddr(baseAddr), bytes(bytes) {\n locked = false;\n\n basePtr = NULL;\n endPtr = NULL;\n freeDataPtr = NULL;\n metaPtr = NULL;\n readDirPtr = NULL;\n cachedMeta = NULL;\n flashBufAddr = 0;\n blocked = NULL;\n gcHorizon = -10000000;\n minGCSpacing = 0;\n\n if (bytes > 0x20000)\n oops();\n\n auto page = flash.pageSize(baseAddr);\n // baseAddr and bytes needs to page-aligned, and we need even number of pages\n auto numPages = bytes / page;\n if ((baseAddr & (page - 1)) || bytes % page || numPages < 2 || (numPages & 1))\n oops();\n\n if (!raffs_unlocked_event)\n raffs_unlocked_event = codal::allocateNotifyEvent();\n}\n\nvoid FS::erasePages(uintptr_t addr, uint32_t len) {\n auto end = addr + len;\n auto page = flash.pageSize(addr);\n if (addr & (page - 1))\n oops();\n while (addr < end) {\n if (flash.pageSize(addr) != page)\n oops();\n flash.erasePage(addr);\n#ifdef CHECK\n for (int i = 0; i < page; ++i)\n if (((uint8_t *)addr)[i] != 0xff)\n oops();\n#endif\n addr += page;\n }\n}\n\nvoid FS::oopsAndClear() {\n erasePages(baseAddr, bytes);\n oops();\n}\n\nvoid FS::flushFlash() {\n if (flashBufAddr) {\n int r = flash.writeBytes(flashBufAddr, flashBuf, sizeof(flashBuf));\n if (r)\n oopsAndClear();\n#ifdef CHECK\n for (unsigned i = 0; i < sizeof(flashBuf); ++i)\n if (flashBuf[i] != 0xff && flashBuf[i] != ((uint8_t *)flashBufAddr)[i])\n oopsAndClear();\n#endif\n flashBufAddr = 0;\n }\n}\n\nvoid FS::writeBytes(void *dst, const void *src, uint32_t size) {\n LOGVV(\"write %x%s %d %x:%x:%x:%x\", REAL_OFF(dst), OFF(dst) == REAL_OFF(dst) ? \"\" : \"*\", size,\n ((const uint8_t *)src)[0], ((const uint8_t *)src)[1], ((const uint8_t *)src)[2],\n ((const uint8_t *)src)[3]);\n\n while (size > 0) {\n uint32_t off = (uintptr_t)dst & (sizeof(flashBuf) - 1);\n uintptr_t newaddr = (uintptr_t)dst - off;\n if (newaddr != flashBufAddr) {\n flushFlash();\n memset(flashBuf, 0xff, sizeof(flashBuf));\n flashBufAddr = newaddr;\n }\n\n unsigned n = sizeof(flashBuf) - off;\n if (n > size)\n n = size;\n memcpy(flashBuf + off, src, n);\n size -= n;\n src = (const uint8_t *)src + n;\n dst = (uint8_t *)dst + n;\n }\n}\n\n#define IS_VALID(hd) ((hd)->magic == RAFFS_MAGIC && (hd)->bytes == bytes)\n\nvoid FS::format() {\n cachedMeta = NULL;\n readDirPtr = NULL;\n clearBlocked();\n\n LOG(\"formatting...\");\n\n FSHeader hd;\n hd.reserved = M1;\n hd.numgc = 1;\n\n // in case the secondary header is valid, copy #gc\n auto hd2 = (FSHeader *)(baseAddr + bytes / 2);\n if (IS_VALID(hd2)) {\n hd.numgc = hd2->numgc + 1;\n }\n\n // write the primary header\n erasePages(baseAddr, bytes / 2);\n hd.magic = RAFFS_MAGIC;\n hd.bytes = bytes;\n writeBytes((void *)baseAddr, &hd, sizeof(hd));\n\n flushFlash();\n}\n\n#define NUMBLOCKED (int)(sizeof(blocked->fnptrs) / sizeof(uint16_t))\n\nbool FS::checkBlocked(MetaEntry *m) {\n auto fnptr = m->fnptr;\n for (auto p = blocked; p; p = p->next) {\n for (int i = 0; i < NUMBLOCKED; ++i)\n if (p->fnptrs[i] == fnptr) {\n if (m->isFirst())\n p->fnptrs[i] = 0;\n return true;\n }\n }\n if (!m->isFirst()) {\n for (auto p = blocked; p; p = p->next) {\n for (int i = 0; i < NUMBLOCKED; ++i)\n if (p->fnptrs[i] == 0) {\n p->fnptrs[i] = fnptr;\n return false;\n }\n }\n auto p = new BlockedEntries;\n memset(p, 0, sizeof(*p));\n p->next = blocked;\n blocked = p;\n p->fnptrs[0] = fnptr;\n }\n return false;\n}\n\nvoid FS::clearBlocked() {\n while (blocked) {\n auto p = blocked;\n blocked = p->next;\n delete p;\n }\n}\n\nbool FS::tryMount() {\n if (basePtr)\n return true;\n\n auto hd0 = (FSHeader *)baseAddr;\n auto hd1 = (FSHeader *)(baseAddr + bytes / 2);\n\n auto v0 = IS_VALID(hd0);\n auto v1 = IS_VALID(hd1);\n\n if (v0 && v1) {\n // we account for overflows\n // they should not occur in normal operation though\n if (hd0->numgc + 1 == hd1->numgc)\n v0 = false;\n else if (hd1->numgc + 1 == hd0->numgc || hd1->numgc < hd0->numgc)\n v1 = false;\n else\n v0 = false;\n }\n\n uintptr_t addr;\n\n if (v0)\n addr = baseAddr;\n else if (v1)\n addr = baseAddr + bytes / 2;\n else\n return false;\n\n basePtr = (uint8_t *)addr;\n endPtr = (MetaEntry *)(addr + bytes / 2);\n\n auto p = (uint32_t *)endPtr - 2;\n while (*p != M1)\n p -= 2;\n metaPtr = (MetaEntry *)(p + 2);\n\n p = (uint32_t *)metaPtr - 1;\n while (*p == M1)\n p--;\n freeDataPtr = (uint8_t *)RAFFS_ROUND(p + 1);\n\n auto fp = (uint32_t *)freeDataPtr;\n if (fp[0] != M1 || fp[1] != M1)\n oopsAndClear();\n\n LOG(\"mounted, end=%x meta=%x free=%x\", OFF(endPtr), OFF(metaPtr), OFF(freeDataPtr));\n\n return true;\n}\n\nvoid FS::mount() {\n // if (basePtr) return;\n if (tryMount())\n return;\n format();\n if (!tryMount())\n oopsAndClear();\n}\n\nFS::~FS() {}\n\nint FS::write(const char *keyName, const void *data, uint32_t bytes) {\n auto isDel = data == NULL && bytes == M1;\n if (!isDel && !data && bytes)\n oops();\n\n if (isDel)\n LOGV(\"del: %s\", keyName);\n else\n LOGV(\"write: %s sz=%d\", keyName, bytes);\n\n lock();\n uint32_t szneeded = bytes;\n auto existing = findMetaEntry(keyName);\n auto prevBase = basePtr;\n\n cachedMeta = NULL;\n\n if (!existing) {\n if (isDel) {\n unlock();\n return -1;\n }\n szneeded += strlen(keyName) + 1;\n }\n\n if (!tryGC(sizeof(MetaEntry) + RAFFS_ROUND(szneeded))) {\n unlock();\n return -1;\n }\n\n // if the GC happened, find the relocated meta entry\n if (prevBase != basePtr)\n existing = findMetaEntry(keyName);\n\n MetaEntry newMeta;\n if (existing) {\n newMeta.fnhash = existing->fnhash;\n newMeta.fnptr = existing->fnptr;\n } else {\n newMeta.fnhash = fnhash(keyName);\n newMeta.fnptr = writeData(keyName, strlen(keyName) + 1);\n }\n newMeta.dataptr = isDel ? 0 : writeData(data, bytes);\n newMeta._datasize = bytes;\n if (existing)\n newMeta._datasize |= RAFFS_FOLLOWING_MASK;\n finishWrite();\n\n writeBytes(--metaPtr, &newMeta, sizeof(newMeta));\n flushFlash();\n\n unlock();\n return 0;\n}\n\nint FS::read(const char *keyName, void *data, uint32_t bytes) {\n lock();\n int r = -1;\n MetaEntry *meta;\n if (keyName) {\n cachedMeta = meta = findMetaEntry(keyName);\n } else {\n meta = cachedMeta;\n }\n if (meta != NULL && meta->dataptr) {\n r = meta->datasize();\n if (data) {\n if (bytes > (unsigned)r)\n bytes = r;\n memcpy(data, basePtr + meta->dataptr, bytes);\n }\n }\n unlock();\n return r;\n}\n\nint FS::remove(const char *keyName) {\n return write(keyName, NULL, M1);\n}\n\nvoid FS::lock() {\n while (locked)\n fiber_wait_for_event(DEVICE_ID_NOTIFY, raffs_unlocked_event);\n locked = true;\n mount();\n}\n\nvoid FS::unlock() {\n if (!locked)\n oops();\n flushFlash();\n locked = false;\n#ifndef RAFFS_TEST\n Event(DEVICE_ID_NOTIFY, raffs_unlocked_event);\n#endif\n}\n\nMetaEntry *FS::findMetaEntry(const char *filename) {\n uint16_t h = fnhash(filename);\n uint16_t buflen = strlen(filename) + 1;\n\n for (auto p = metaPtr; p < endPtr; p++) {\n // LOGV(\"check at %x %x %x\", OFF(p),p->fnhash,h);\n if (p->fnhash == h && memcmp(fnptr(p), filename, buflen) == 0)\n return p;\n }\n\n // LOGV(\"fail\");\n\n return NULL;\n}\n\nvoid FS::forceGC(filename_filter filter) {\n lock();\n tryGC(0x7fff0000, filter);\n unlock();\n}\n\nbool FS::tryGC(int spaceNeeded, filename_filter filter) {\n int spaceLeft = (intptr_t)metaPtr - (intptr_t)freeDataPtr;\n\n#ifdef RAFFS_TEST\n for (auto p = (uint32_t *)freeDataPtr; p < (uint32_t *)metaPtr; p++) {\n if (*p != M1) {\n LOG(\"value at %x = %x\", OFF(p), *p);\n oopsAndClear();\n }\n }\n#endif\n\n if (spaceLeft > spaceNeeded + 32)\n return true;\n \n int now = (int)system_timer_current_time();\n if (minGCSpacing) {\n gcHorizon += minGCSpacing;\n int nextGC = now - minGCSpacing * 2;\n // LOG(\"now=%d n=%d gch=%d\", now, nextGC, gcHorizon);\n if (nextGC > gcHorizon)\n gcHorizon = nextGC;\n if (gcHorizon > now)\n target_panic(921);\n }\n\n LOG(\"running flash FS GC; needed %d, left %d\", spaceNeeded, spaceLeft);\n\n readDirPtr = NULL;\n cachedMeta = NULL;\n\n auto newBase = (uintptr_t)altBasePtr();\n\n flushFlash();\n\n erasePages(newBase, bytes / 2);\n\n auto metaDst = (MetaEntry *)(newBase + bytes / 2);\n auto newBaseP = (uint8_t *)newBase;\n freeDataPtr = newBaseP + sizeof(FSHeader);\n\n for (int iter = 0; iter < 2; ++iter) {\n clearBlocked();\n auto offset = sizeof(FSHeader);\n for (auto p = metaPtr; p < endPtr; p++) {\n MetaEntry m = *p;\n const char *fn = fnptr(&m);\n\n if (filter && !filter(fn))\n continue;\n\n if (checkBlocked(&m) || m.dataptr == 0)\n continue;\n\n LOGV(\"GC %s sz=%d @%x\", fn, m.datasize(), m.dataptr);\n auto fnlen = strlen(fn) + 1;\n auto sz = fnlen + m.datasize();\n\n if (iter == 0) {\n auto fd = freeDataPtr;\n writeData(fn, fnlen);\n writeData(basePtr + m.dataptr, m.datasize());\n if (freeDataPtr - fd != (int)sz)\n oops();\n } else {\n m.fnptr = offset;\n m.dataptr = offset + fnlen;\n m._datasize &= ~RAFFS_FOLLOWING_MASK;\n writeBytes(--metaDst, &m, sizeof(m));\n }\n offset += sz;\n }\n if (iter == 0)\n finishWrite();\n }\n\n clearBlocked();\n flushFlash();\n\n LOG(\"GC done: %d free\", (int)((intptr_t)metaDst - (intptr_t)freeDataPtr));\n\n FSHeader hd;\n hd.magic = RAFFS_MAGIC;\n hd.bytes = bytes;\n hd.numgc = ((FSHeader*)basePtr)->numgc + 1;\n hd.reserved = M1;\n writeBytes(newBaseP, &hd, sizeof(hd));\n flushFlash();\n\n basePtr = newBaseP;\n endPtr = (MetaEntry *)(newBase + bytes / 2);\n metaPtr = metaDst;\n\n if ((intptr_t)metaDst - (intptr_t)freeDataPtr <= spaceNeeded + 64) {\n if (filter != NULL && spaceNeeded != 0x7fff0000) {\n LOG(\"out of space! needed=%d\", spaceNeeded);\n#ifdef RAFFS_TEST\n oops();\n#endif\n }\n return false;\n }\n\n return true;\n}\n\nDirEntry *FS::dirRead() {\n lock();\n\n if (readDirPtr == NULL) {\n readDirPtr = metaPtr;\n clearBlocked();\n }\n\n while (readDirPtr < endPtr) {\n auto m = *readDirPtr++;\n if (checkBlocked(&m) || m.dataptr == 0)\n continue;\n dirEnt.size = m.datasize();\n dirEnt.flags = 0;\n dirEnt.name = fnptr(&m);\n unlock();\n return &dirEnt;\n }\n\n readDirPtr = NULL;\n clearBlocked();\n unlock();\n return NULL;\n}\n\nuint16_t FS::writeData(const void *data, uint32_t len) {\n LOGVV(\"writeData: @%x %x:%x sz=%d\", REAL_OFF(freeDataPtr), ((const uint8_t *)data)[0],\n ((const uint8_t *)data)[1], len);\n writeBytes(freeDataPtr, data, len);\n auto r = freeDataPtr - basePtr;\n freeDataPtr += len;\n return r;\n}\n\nvoid FS::finishWrite() {\n auto nfp = RAFFS_ROUND(freeDataPtr);\n int tailSz = nfp - (uintptr_t)freeDataPtr;\n uint64_t z = 0;\n if (tailSz) {\n writeData(&z, tailSz);\n } else {\n if (((uint32_t *)nfp)[-1] == M1)\n writeData(&z, 8);\n }\n flushFlash();\n}\n\nint FS::readFlashBytes(uintptr_t addr, void *buffer, uint32_t len) {\n lock();\n memcpy(buffer, (void *)addr, len);\n unlock();\n return len;\n}\n\n#ifdef RAFFS_TEST\nvoid FS::dump() {}\n\nvoid FS::debugDump() {\n // dump();\n}\n#endif",
"RAFFS.h": "#ifndef CODAL_RAFFS_H\n#define CODAL_RAFFS_H\n\n#include \"Flash.h\"\n\nnamespace pxt {\nnamespace raffs {\n\nstruct DirEntry {\n uint32_t size;\n uint16_t flags;\n const char *name;\n};\n\nstruct BlockedEntries {\n BlockedEntries *next;\n uint16_t fnptrs[32];\n};\n\n#define RAFFS_FOLLOWING_MASK 0x8000\n\n#ifdef PICO_BOARD\n#define RAFFS_FLASH_BUFFER_SIZE 256\n#else\n#define RAFFS_FLASH_BUFFER_SIZE 64\n#endif\n\nstruct MetaEntry {\n uint16_t fnhash; // hash of file name\n uint16_t fnptr; // offset in bytes; can't be 0xffff\n uint16_t _datasize; // size in bytes; highest bit is set if this isn't first block\n uint16_t dataptr; // offset in bytes; 0x0 - deleted\n\n uint16_t datasize() { return _datasize & 0x7fff; }\n bool isFirst() { return (_datasize & RAFFS_FOLLOWING_MASK) == 0; }\n};\n\n#define RAFFS_ROUND(x) ((((uintptr_t)(x) + 7) >> 3) << 3)\n\ntypedef bool (*filename_filter)(const char *);\n\nclass FS {\n codal::Flash &flash;\n\n uint8_t *basePtr, *freeDataPtr;\n MetaEntry *endPtr, *metaPtr, *readDirPtr, *cachedMeta;\n int32_t gcHorizon;\n DirEntry dirEnt;\n uintptr_t flashBufAddr;\n uint8_t flashBuf[RAFFS_FLASH_BUFFER_SIZE];\n BlockedEntries *blocked;\n volatile bool locked;\n\n void erasePages(uintptr_t addr, uint32_t len);\n void flushFlash();\n void writeBytes(void *dst, const void *src, uint32_t size);\n void mount();\n void lock();\n void unlock();\n MetaEntry *findMetaEntry(const char *filename);\n bool tryGC(int spaceNeeded, filename_filter filter = NULL);\n\n bool checkBlocked(MetaEntry *m);\n void clearBlocked();\n void oopsAndClear();\n\n uint16_t writeData(const void *data, uint32_t len);\n void finishWrite();\n const char *fnptr(MetaEntry *m) { return (const char *)(basePtr + m->fnptr); }\n\n uint32_t *altBasePtr() {\n if ((uintptr_t)basePtr == baseAddr)\n return (uint32_t *)(baseAddr + bytes / 2);\n else\n return (uint32_t *)baseAddr;\n }\n\n public:\n // Minimum time in ms that has to pass between two GCs; we shall panic 920 if GCs happen more often\n // (avareged over 3x this time).\n // This is usually set to around 10s (10000), so that if user writes a program that writes to flash in\n // a loop, it doesn't wear out flash completely.\n uint16_t minGCSpacing;\n uintptr_t baseAddr;\n uint32_t bytes;\n\n FS(codal::Flash &flash, uintptr_t baseAddr, uint32_t bytes);\n ~FS();\n\n // returns 0 for success, negative for error\n int write(const char *keyName, const void *data, uint32_t bytes);\n // returns total number of bytes in key's value or -1 when file doesn't exists\n // if keyName==NULL it will re-use last keyName\n int read(const char *keyName, void *data, uint32_t bytes);\n // deletes given key if it exists\n int remove(const char *keyName);\n\n void format();\n bool exists(const char *keyName) { return read(keyName, NULL, 0) >= 0; }\n uint32_t totalSize() { return bytes / 2; }\n uint32_t freeSize() { return (uintptr_t)endPtr - (uintptr_t)freeDataPtr; }\n void forceGC(filename_filter filter = NULL);\n // this allow raw r/o access; will lock the instance as needed\n int readFlashBytes(uintptr_t addr, void *buffer, uint32_t len);\n bool tryMount();\n\n void dirRewind() { readDirPtr = NULL; }\n DirEntry *dirRead(); // data is only valid until next call to to any of File or FS function\n\n#ifdef RAFFS_TEST\n void debugDump();\n void dump();\n#else\n void debugDump() {}\n#endif\n};\n\n} // namespace raffs\n} // namespace pxt\n\n#endif\n",
"README.md": "# Settings store in internal MCU flash\n\nThis packages implements a simple key-value storage, in vein of browser's `localStorage`.\nKeys are strings and values are buffers, but APIs are provided for using strings,\nnumbers and number arrays as values.\n\nKeys with names starting with `#` are _system keys_.\nUser applications should not read or write these directly.\n\nFollowing system keys are used:\n* `#run` - current run number; incremented on each reset; it's also used to seed the\n random number generator; accessible via `settings.runNumber()`\n* `#volume` - last music volume set explicitly by user using the game menu\n* `#scope` - keeps the name of the program; if the current name of the program\n doesn't match what is in that key, all non-system keys are cleared;\n this happens for example when a new game (or rather a game with a new name) \n is uploaded to a hardware device\n\nThe size of storage is typically limited to 16 kilobytes.\nThis applies in browser and in Arcade devices.\nSmaller MCUs may limit it further (eg., it's 1k on SAMD21 devices).\n\n## Panics 920, 921 and 922\n\nWhen there is no more space to write a key to storage, all non-system keys\nare deleted.\nThen, if more than 25% of space is still occupied (by system keys),\nall keys are deleted.\nFinally, a panic 920 is issued.\nThe user has to reset the device, and hopefully next run will fix things.\n\nAll flash devices have a limited number of erases (at least 10,000),\nbefore they start failing.\nThe settings storage implemented here doesn't erase on every write (typically\nit will erase every hundred writes or so);\nif your program keeps writing in a loop, you will likely\nhit 10,000 erases in about half hour.\n\nFor this reason, if erases happen too often (i.e., you're writing too much),\npanic 921 will be issued.\n\nIf flash memory is found to be inconsistent, panic 922 is issued.\nIn most cases, the entire flash memory is cleared before that, so that\na device reset will hopefully fix things.\n\n## Storage structure\n\nSettings are written using a very simple log file system.\nThe flash is divided in two equal regions.\nOne region is used for writing, and when it fills up, data is compressed\n(garbage collected) into the other region, which is to be used from now\non until next compression\n\nEach region starts with a header, followed by data section containing\nkey names and values.\nData section grows in the positive direction.\nFrom the end of the region, the meta-data section grows in the negative\ndirection.\nMeta-data entries are 8 bytes each and contain hash of key name,\nvalue size, and points to key name and value in the data sections.\nWhen a key value is overwritten, a new meta-data section for it\nis created. When a key is to be found, it is searched for from the most \nrecent meta-data entry.\n",
"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",
"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",
"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",
"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\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"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",
"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",
"shims.d.ts": "\n"
},
"settings---esp32": {
"pxt.json": "{\n \"name\": \"settings---esp32\",\n \"description\": \"Settings storage in ESP32 NVS\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"settings.cpp\",\n \"settings.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"settings.cpp": "#include \"pxt.h\"\n#include \"nvs_flash.h\"\n#include \"mbedtls/sha256.h\"\n\n#define STORE_NAME \"PXT2\"\n\n#define FAIL(msg) \\\n do { \\\n DMESG(\"FAILURE: %s\", msg); \\\n abort(); \\\n } while (0)\n\nstatic nvs_handle_t handle;\n\nvoid settings_init(void) {\n if (handle)\n return;\n\n esp_err_t ret = nvs_flash_init();\n if (ret == ESP_ERR_NVS_NO_FREE_PAGES || ret == ESP_ERR_NVS_NEW_VERSION_FOUND) {\n ESP_ERROR_CHECK(nvs_flash_erase());\n ret = nvs_flash_init();\n }\n ESP_ERROR_CHECK(ret);\n\n ESP_ERROR_CHECK(nvs_open(STORE_NAME, NVS_READWRITE, &handle));\n}\n\nnamespace settings {\n\nPXT_DEF_STRING(sKeyTooLong, \"settings: key too long\")\n\nconst char *keyName(String key) {\n static char keybuf[16];\n\n mbedtls_sha256_context sha256_ctx;\n uint8_t output[32];\n\n mbedtls_sha256_init(&sha256_ctx);\n mbedtls_sha256_starts_ret(&sha256_ctx, false);\n mbedtls_sha256_update_ret(&sha256_ctx, (unsigned char *)key->getUTF8Data(), key->getUTF8Size());\n mbedtls_sha256_finish_ret(&sha256_ctx, output);\n\n for (int i = 0; i < sizeof(keybuf) - 1; ++i)\n keybuf[i] = output[i] == 0 ? 0x01 : output[i];\n keybuf[sizeof(keybuf) - 1] = 0;\n\n return keybuf;\n}\n\n//%\nint _set(String key, Buffer data) {\n settings_init();\n int n = key->getUTF8Size();\n if (n > 200)\n pxt::throwValue((TValue)sKeyTooLong);\n int bufsize = 1 + n + data->length;\n uint8_t *buf = (uint8_t *)malloc(bufsize);\n buf[0] = n;\n memcpy(buf + 1, key->getUTF8Data(), n);\n memcpy(buf + 1 + n, data->data, data->length);\n ESP_ERROR_CHECK(nvs_set_blob(handle, keyName(key), buf, bufsize));\n free(buf);\n ESP_ERROR_CHECK(nvs_commit(handle));\n return 0;\n}\n\n//%\nint _remove(String key) {\n settings_init();\n if (nvs_erase_key(handle, keyName(key)) == ESP_OK) {\n ESP_ERROR_CHECK(nvs_commit(handle));\n return 0;\n }\n return -1;\n}\n\n//%\nbool _exists(String key) {\n settings_init();\n size_t required_size;\n esp_err_t err = nvs_get_blob(handle, keyName(key), NULL, &required_size);\n if (err == ESP_ERR_NVS_NOT_FOUND)\n return 0;\n ESP_ERROR_CHECK(err);\n return 1;\n}\n\nstatic uint8_t *getEntry(const char *k, int *size = NULL) {\n size_t required_size;\n esp_err_t err = nvs_get_blob(handle, k, NULL, &required_size);\n if (err == ESP_ERR_NVS_NOT_FOUND)\n return NULL;\n ESP_ERROR_CHECK(err);\n\n uint8_t *tmp = (uint8_t *)malloc(required_size);\n ESP_ERROR_CHECK(nvs_get_blob(handle, k, tmp, &required_size));\n\n if (size)\n *size = required_size;\n return tmp;\n}\n\n//%\nBuffer _get(String key) {\n settings_init();\n const char *k = keyName(key);\n int required_size;\n\n uint8_t *tmp = getEntry(k, &required_size);\n if (!tmp)\n return NULL;\n\n int bufsz = required_size - 1 - tmp[0];\n if (bufsz < 0)\n abort();\n auto ret = mkBuffer(tmp + 1 + tmp[0], bufsz);\n free(tmp);\n return ret;\n}\n\n//%\nvoid _userClean() {\n settings_init();\n nvs_iterator_t it = nvs_entry_find(NVS_DEFAULT_PART_NAME, STORE_NAME, NVS_TYPE_BLOB);\n for (; it; it = nvs_entry_next(it)) {\n nvs_entry_info_t info;\n nvs_entry_info(it, &info);\n uint8_t *tmp = getEntry(info.key);\n if (tmp[1] != '#')\n ESP_ERROR_CHECK(nvs_erase_key(handle, info.key));\n free(tmp);\n }\n ESP_ERROR_CHECK(nvs_commit(handle));\n}\n\n//%\nRefCollection *_list(String prefix) {\n settings_init();\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 nvs_iterator_t it = nvs_entry_find(NVS_DEFAULT_PART_NAME, STORE_NAME, NVS_TYPE_BLOB);\n\n for (; it; it = nvs_entry_next(it)) {\n nvs_entry_info_t info;\n nvs_entry_info(it, &info);\n uint8_t *tmp = getEntry(info.key);\n if (!wantsInternal && tmp[1] == '#')\n continue;\n if (tmp[0] < prefLen || memcmp(tmp + 1, prefData, prefLen) != 0)\n continue;\n auto str = mkString((char *)(tmp + 1), tmp[0]);\n registerGCObj(str);\n res->head.push((TValue)str);\n unregisterGCObj(str);\n free(tmp);\n }\n unregisterGCObj(res);\n\n return res;\n}\n\n} // namespace settings\n",
"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"
},
"settings---files": {
"pxt.json": "{\n \"name\": \"settings---files\",\n \"description\": \"Settings storage in files\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"settings.cpp\",\n \"settings.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"settings.cpp": "#define _GNU_SOURCE 1\n\n#include \"pxt.h\"\n\n#include \n#include \n#include \n#include \n\n#define FAIL(msg) \\\n do { \\\n DMESG(\"FAILURE: %s\", msg); \\\n abort(); \\\n } while (0)\n\nnamespace settings {\n\n#define ADD(c) \\\n do { \\\n buf[dp] = (c); \\\n dp++; \\\n if (dp > 1000) \\\n FAIL(\"too long\"); \\\n } while (0)\n\nconst char *hexD = \"0123456789abcdef\";\n\nstatic char *encodeString(const char *str) {\n static char buf[1024];\n int dp = 0;\n for (auto sp = str; *sp; ++sp) {\n auto c = *sp;\n if (('0' <= c && c <= '9') || ('a' <= c && c <= 'z'))\n ADD(c);\n else if (('A' <= c && c <= 'Z')) {\n ADD('-');\n ADD(c | 0x20);\n } else {\n ADD('_');\n ADD(hexD[(c >> 4) & 0xf]);\n ADD(hexD[c & 0xf]);\n }\n }\n\n ADD(0);\n\n return buf;\n}\n\nstatic int hex(char c) {\n if ('0' <= c && c <= '9')\n return c - '0';\n c |= 0x20;\n if ('a' <= c && c <= 'f')\n return c - 'a' + 10;\n return -1;\n}\n\nstatic char *decodeString(const char *str) {\n static char buf[1024];\n int dp = 0;\n\n if (strlen(str) > 1000)\n FAIL(\"too long decode\");\n\n for (auto sp = str; *sp; ++sp) {\n auto c = *sp;\n if (('0' <= c && c <= '9') || ('a' <= c && c <= 'z'))\n ADD(c);\n else if (c == '-' && sp[1]) {\n ADD(sp[1] & ~0x20);\n sp++;\n } else if (c == '_' && hex(sp[1]) >= 0 && hex(sp[2]) >= 0) {\n ADD((hex(sp[1]) << 4) | hex(sp[2]));\n sp += 2;\n }\n }\n\n ADD(0);\n\n return buf;\n}\n\nstatic const char *settingsDirectory() {\n static char *name;\n if (name)\n return name;\n#ifdef SETTINGSDIR\n asprintf(&name, \"%s/%s\", SETTINGSDIR, encodeString(programName()->getUTF8Data()));\n#else\n asprintf(&name, \"%s.data\", initialArgv[0]);\n#endif\n#ifdef __WIN32__\n mkdir(name);\n#else\n mkdir(name, 0777);\n#endif\n return name;\n}\n\nstatic const char *keyName(const char *key) {\n static char *lastName;\n if (lastName)\n free(lastName);\n auto dirname = settingsDirectory();\n asprintf(&lastName, \"%s/%s\", dirname, encodeString(key));\n return lastName;\n}\n\nstatic const char *keyName(String key) {\n return keyName(key->getUTF8Data());\n}\n\nstatic FILE *openKey(String key, const char *mode) {\n return fopen(keyName(key), mode);\n}\n\n//%\nint _set(String key, Buffer data) {\n // DMESG(\"set[%s] - %p\", key->getUTF8Data(), data);\n auto f = openKey(key, \"wb\");\n if (!f) {\n DMESG(\"errno=%d\", errno);\n FAIL(\"can't write file\");\n }\n fwrite(data->data, data->length, 1, f);\n fclose(f);\n return 0;\n}\n\n//%\nint _remove(String key) {\n return remove(keyName(key));\n}\n\n//%\nbool _exists(String key) {\n auto f = openKey(key, \"rb\");\n if (f != NULL)\n fclose(f);\n return f != NULL;\n}\n\n//%\nBuffer _get(String key) {\n auto f = openKey(key, \"rb\");\n if (f == NULL)\n return NULL;\n fseek(f, 0, SEEK_END);\n auto sz = ftell(f);\n auto ret = mkBuffer(NULL, sz);\n registerGCObj(ret);\n fseek(f, 0, SEEK_SET);\n fread(ret->data, ret->length, 1, f);\n fclose(f);\n unregisterGCObj(ret);\n return ret;\n}\n\n//%\nvoid _userClean() {\n auto dp = opendir(settingsDirectory());\n if (!dp)\n return;\n for (;;) {\n dirent *ep = readdir(dp);\n if (!ep)\n break;\n auto name = decodeString(ep->d_name);\n if (name[0] == '#')\n continue;\n remove(keyName(name));\n }\n closedir(dp);\n}\n\n//%\nRefCollection *_list(String prefix) {\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 auto dp = opendir(settingsDirectory());\n\n for (;;) {\n dirent *ep = dp ? readdir(dp) : NULL;\n if (!ep)\n break;\n auto name = decodeString(ep->d_name);\n if (!wantsInternal && name[0] == '#')\n continue;\n if (memcmp(name, prefData, prefLen) != 0)\n continue;\n auto str = mkString(name, -1);\n registerGCObj(str);\n res->head.push((TValue)str);\n unregisterGCObj(str);\n }\n if (dp)\n closedir(dp);\n unregisterGCObj(res);\n\n return res;\n}\n\n} // namespace settings\n",
"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"
},
"radio": {
"README.md": "# radio\n\nThe radio library.\n\n",
"enums.d.ts": "// Auto-generated. Do not edit.\ndeclare namespace radio {\n}\n\n// Auto-generated. Do not edit. Really.\n",
"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\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"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",
"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}",
"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",
"targetoverrides.ts": "// leave empty"
},
"radio-broadcast": {
"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\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"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}"
},
"matrix-keypad": {
"README.md": "# button pad\n\n",
"keypad.ts": "/**\n * User interaction on keypad buttons\n */\nconst enum MatrixKeypadButtonEvent {\n //% block=\"click\"\n Click = DAL.DEVICE_BUTTON_EVT_CLICK,\n //% block=\"long click\"\n LongClick = DAL.DEVICE_BUTTON_EVT_LONG_CLICK,\n //% block=\"up\"\n Up = DAL.DEVICE_BUTTON_EVT_UP,\n //% block=\"down\"\n Down = DAL.DEVICE_BUTTON_EVT_DOWN\n};\n\nnamespace matrixKeypad {\n //% fixedInstances\n export class MatrixKeypad {\n private timePressed: number[];\n\n static fromCfg(): MatrixKeypad {\n const messageBusId = control.getConfigValue(DAL.CFG_MATRIX_KEYPAD_MESSAGE_ID, 7452);\n \n const rows = control.getConfigValue(DAL.CFG_NUM_MATRIX_KEYPAD_ROWS, 0);\n const columns = control.getConfigValue(DAL.CFG_NUM_MATRIX_KEYPAD_COLS, 0);\n \n const rowPins: DigitalInOutPin[] = [];\n for(let i = 0; i < rows; ++i) {\n const p = pins.pinByCfg(DAL.CFG_PIN_MATRIX_KEYPAD_ROW0 + i);\n control.assert(!!p, control.PXT_PANIC.CODAL_HARDWARE_CONFIGURATION_ERROR)\n rowPins.push(p);\n }\n const columnPins: DigitalInOutPin[] = [];\n for(let i = 0; i < columns; ++i) {\n const p = pins.pinByCfg(DAL.CFG_PIN_MATRIX_KEYPAD_COL0 + i);\n control.assert(!!p, control.PXT_PANIC.CODAL_HARDWARE_CONFIGURATION_ERROR)\n columnPins.push(p);\n }\n return new MatrixKeypad(messageBusId, rowPins, columnPins);\n }\n\n constructor(private messageBusId: number, private rowPins: DigitalInOutPin[], private columnPins: DigitalInOutPin[]) {\n this.timePressed = [];\n this.pulseRows();\n control.runInParallel(function() {\n while(true) {\n this.pulseRows();\n pause(50);\n }\n })\n }\n\n static setInput(p: DigitalInOutPin) {\n p.digitalRead();\n p.setPull(PinPullMode.PullDown)\n }\n\n private evId(x: number, y: number, ev: number) {\n return 1 + (x + y * this.columns) * 8 + ev;\n }\n\n private pulseRows() {\n this.rowPins.forEach(p => MatrixKeypad.setInput(p));\n this.columnPins.forEach(p => MatrixKeypad.setInput(p));\n this.rowPins.forEach((row, y) => this.pulseRow(y));\n }\n\n private pulseRow(y: number) {\n const row = this.rowPins[y];\n const time = control.millis();\n // set one row low\n row.digitalWrite(true);\n // check the column pins, which ones are pulled down\n this.columnPins.forEach((col, x) => {\n const pressed = col.digitalRead();\n const idx = x + y * this.columns;\n const lastTime = this.timePressed[idx];\n const wasPressed = !!lastTime;\n if (wasPressed != pressed) {\n this.timePressed[idx] = pressed ? time : 0;\n control.raiseEvent(this.messageBusId, this.evId(x, y, pressed ? MatrixKeypadButtonEvent.Down : MatrixKeypadButtonEvent.Up));\n if (!pressed) {\n const elapsed = time - lastTime;\n if (elapsed >= DAL.DEVICE_BUTTON_LONG_CLICK_TIME) {\n control.raiseEvent(this.messageBusId, this.evId(x, y, MatrixKeypadButtonEvent.LongClick));\n } else {\n control.raiseEvent(this.messageBusId, this.evId(x, y, MatrixKeypadButtonEvent.Click));\n }\n }\n }\n });\n MatrixKeypad.setInput(row);\n }\n\n /**\n * Gets the number of rows\n */\n //% blockId=mkeypadrows\n //% blockSetVariable=\"rows\" blockCombine block=\"rows\"\n get rows(): number {\n return this.rowPins.length;\n }\n\n /**\n * Gets the number of columns\n */\n //% blockId=mkeypadcolumns\n //% blockSetVariable=\"columns\" blockCombine block=\"columns\"\n get columns(): number {\n return this.columnPins.length;\n }\n\n /**\n * Register an event handler\n * @param x \n * @param y \n * @param ev \n * @param handler \n */\n //% blockId=mkeypadonevent block=\"on keypad %keypad button at x %x y %y %ev\"\n onEvent(x: number, y: number, ev: MatrixKeypadButtonEvent, handler: () => void) {\n x = x | 0;\n y = y | 0;\n if (x < 0 || y < 0 || x >= this.columns || y >= this.rows)\n return;\n\n control.onEvent(this.messageBusId, this.evId(x, y, ev), handler);\n this.pulseRows(); // raise events as needed\n }\n\n /**\n * Indicates a button is pressed\n * @param x column index starting from 0\n * @param y row index starting from 0\n */\n //% blockId=mkeypadispressed block=\"is keypad %keypad button pressed at x %x y %y\"\n isPressed(x: number, y: number): boolean {\n x = x | 0;\n y = y | 0;\n if (x < 0 || y < 0 || x >= this.columns || y >= this.rows)\n return false;\n return !!this.timePressed[x + y * this.columns];\n }\n }\n\n //% fixedInstance whenUsed block=\"keypad\"\n export const keypad = MatrixKeypad.fromCfg();\n}",
"pxt.json": "{\n \"name\": \"buttonpad\",\n \"description\": \"A rectangular matrix of buttons - beta\",\n \"dependencies\": {\n \"core\": \"*\"\n },\n \"files\": [\n \"README.md\",\n \"keypad.ts\"\n ],\n \"testFiles\": [\n \"test.ts\"\n ],\n \"public\": true,\n \"targetVersions\": {\n \"target\": \"0.15.66\",\n \"pxt\": \"8.1.1\"\n }\n}\n",
"test.ts": "//"
},
"adafruit-feather-m0-express": {
"README.md": "# adafruit\n\nThe adafruit library.\n\n",
"board.json": "{\n \"driveDisplayName\": \"FEATHERBOOT\",\n \"visual\": {\n \"image\": \"pkg://board.svg\",\n \"useCrocClips\": false,\n \"width\": 454.635986328125,\n \"height\": 204.54568481445312,\n \"pinDist\": 15,\n \"pinBlocks\": [\n {\n \"x\": 391.82993791173703,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"GND\"\n ]\n },\n {\n \"x\": 369.102728100482,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"TX\"\n ]\n },\n {\n \"x\": 346.37556753284446,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"RX\"\n ]\n },\n {\n \"x\": 323.64840696520685,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"MISO\"\n ]\n },\n {\n \"x\": 300.9196459800005,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"MOSI\"\n ]\n },\n {\n \"x\": 278.1924361687454,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"SCK\"\n ]\n },\n {\n \"x\": 255.4652756011079,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"A5\"\n ]\n },\n {\n \"x\": 232.73811503347034,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"A4\"\n ]\n },\n {\n \"x\": 210.0115453892428,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"A3\"\n ]\n },\n {\n \"x\": 187.28440944341398,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"A2\"\n ]\n },\n {\n \"x\": 164.5572242539677,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"A1\"\n ]\n },\n {\n \"x\": 141.83003906452137,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"A0\"\n ]\n },\n {\n \"x\": 96.37569330743752,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"AREF\"\n ]\n },\n {\n \"x\": 73.6485081179912,\n \"y\": 187.19509599700422,\n \"labels\": [\n \"+3V3\"\n ]\n },\n {\n \"x\": 141.83003906452137,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"VBAT\"\n ]\n },\n {\n \"x\": 164.5572242539677,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"EN\"\n ]\n },\n {\n \"x\": 187.28440944341398,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"VBUS\"\n ]\n },\n {\n \"x\": 210.0115453892428,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"D13\"\n ]\n },\n {\n \"x\": 232.73811503347034,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"D12\"\n ]\n },\n {\n \"x\": 255.4652756011079,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"D11\"\n ]\n },\n {\n \"x\": 278.1924361687454,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"D10\"\n ]\n },\n {\n \"x\": 300.9196459800005,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"D9\"\n ]\n },\n {\n \"x\": 323.64840696520685,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"D6\"\n ]\n },\n {\n \"x\": 346.37556753284446,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"D5\"\n ]\n },\n {\n \"x\": 369.102728100482,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"SCL\"\n ]\n },\n {\n \"x\": 391.82993791173703,\n \"y\": 5.376717702581506,\n \"labels\": [\n \"SDA\"\n ]\n },\n {\n \"x\": 76.35291834758675,\n \"y\": 138.76275475349695,\n \"labels\": [\n \"RESET\"\n ]\n }\n ],\n \"leds\": [\n {\n \"x\": 18.16376684462617,\n \"y\": 43.62975794242045,\n \"w\": 11.183656416370631,\n \"h\": 11.183728432031572,\n \"color\": \"#ff0000\",\n \"label\": \"LED\"\n },\n {\n \"x\": 288.9422932476361,\n \"y\": 42.239307735661384,\n \"w\": 26.843336067399623,\n \"h\": 25.527165827499598,\n \"color\": \"neopixel\",\n \"label\": \"NEOPIXEL\"\n }\n ],\n \"reset\": {\n \"x\": 50.921322928544896,\n \"y\": 187.19509599700422,\n \"w\": 11.973807191904287,\n \"h\": 11.973895736807599\n }\n },\n \"gpioPinMap\": {\n \"GND\": \"GND\",\n \"TX\": \"TX\",\n \"RX\": \"RX\",\n \"MISO\": \"MISO\",\n \"MOSI\": \"MOSI\",\n \"SCK\": \"SCK\",\n \"A5\": \"A5\",\n \"A4\": \"A4\",\n \"A3\": \"A3\",\n \"A2\": \"A2\",\n \"A1\": \"A1\",\n \"JACK_TX\": \"TX\",\n \"A0\": \"A0\",\n \"AREF\": \"AREF\",\n \"+3V3\": \"+3V3\",\n \"!RESET\": \"!RESET\",\n \"VBAT\": \"VBAT\",\n \"EN\": \"EN\",\n \"VBUS\": \"VBUS\",\n \"D13\": \"D13\",\n \"D12\": \"D12\",\n \"D11\": \"D11\",\n \"D10\": \"D10\",\n \"D9\": \"D9\",\n \"D6\": \"D6\",\n \"D5\": \"D5\",\n \"SCL\": \"SCL\",\n \"SDA\": \"SDA\",\n \"LED\": \"LED\",\n \"NEOPIXEL\": \"NEOPIXEL\",\n \"RESET\": \"RESET\",\n \"DISPLAY_CS\": \"A2\",\n \"DISPLAY_SCK\": \"SCK\",\n \"DISPLAY_MOSI\": \"MOSI\",\n \"DISPLAY_DC\": \"A5\",\n \"DISPLAY_RST\": \"A4\",\n \"DISPLAY_MISO\": \"MISO\",\n \"ACCELEROMETER_INT\": \"D5\"\n },\n \"groundPins\": [\n \"GND\"\n ],\n \"threeVoltPins\": [\n \"+3V3\"\n ],\n \"spiPins\": {\n \"MOSI\": \"MOSI\",\n \"MISO\": \"MISO\",\n \"SCK\": \"SCK\"\n },\n \"i2cPins\": {\n \"SDA\": \"SDA\",\n \"SCL\": \"SCL\"\n },\n \"onboardComponents\": [\"pixel\"],\n \"marginWhenBreadboarding\": [\n 0,\n 0,\n 80,\n 0\n ]\n }",
"board.svg": "