{"id":16133821,"url":"https://github.com/wallarug/pxt-grandcentral","last_synced_at":"2025-04-06T15:46:06.984Z","repository":{"id":72814147,"uuid":"323312354","full_name":"wallarug/pxt-grandcentral","owner":"wallarug","description":null,"archived":false,"fork":false,"pushed_at":"2020-12-23T11:12:57.000Z","size":5728,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-12T21:45:57.854Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wallarug.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-21T11:11:37.000Z","updated_at":"2020-12-23T11:13:00.000Z","dependencies_parsed_at":"2023-02-23T12:30:56.623Z","dependency_job_id":null,"html_url":"https://github.com/wallarug/pxt-grandcentral","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wallarug%2Fpxt-grandcentral","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wallarug%2Fpxt-grandcentral/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wallarug%2Fpxt-grandcentral/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wallarug%2Fpxt-grandcentral/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wallarug","download_url":"https://codeload.github.com/wallarug/pxt-grandcentral/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247508891,"owners_count":20950230,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-09T22:46:05.487Z","updated_at":"2025-04-06T15:46:06.963Z","avatar_url":"https://github.com/wallarug.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MakeCode Maker [![Actions Status](https://github.com/microsoft/pxt-maker/workflows/pxt-buildtarget/badge.svg)](https://github.com/microsoft/pxt-maker/actions)\n\nThis is an experimental code editor for maker boards - try it at https://maker.makecode.com.\n\nRepo for Adafruit Grand Central M4\n\n* [Read the docs](https://maker.makecode.com/about)\n\n## Who is this for?\n\nThis editor is meant for micro-controllers that are friendly to breadboarding. The editor is based on [Microsoft MakeCode](https://makecode.com).\n\n## Local Dev Server\n\nThe local server lets you to run the editor and serve the documentation from your own computer.\n\n### Setup\n\n1. Install [Node.js](https://nodejs.org/) 8.9.4 or higher.\n2. Install [Docker](https://www.docker.com/) if you are going to edit any `.cpp` files.\n3. Clone the pxt repository.\n```\ngit clone https://github.com/microsoft/pxt\ncd pxt\n```\n4. Install the dependencies of ``Microsoft/pxt`` and build it\n```\nnpm install\nnpm run build\ncd ..\n```\n5. Clone the ``Microsoft/pxt-common-packages`` repository\n```\ngit clone https://github.com/microsoft/pxt-common-packages\ncd pxt-common-packages\nnpm install\ncd ..\n```\n6. Clone the ``Microsoft/pxt-maker`` repository\n```\ngit clone https://github.com/microsoft/pxt-maker\ncd pxt-maker\n```\n7. Install the PXT command line (add `sudo` for Mac/Linux shells).\n```\nnpm install -g pxt\n```\n8. Install the pxt-maker dependencies.\n```\nnpm install\n```\n8. Link pxt-maker back to base pxt repo (add `sudo` for Mac/Linux shells).\n```\nrm -Rf node_modules/pxt-core\nrm -Rf node_modules/pxt-common-packages\npxt link ../pxt\npxt link ../pxt-common-packages\n```\n\nIf you want to know if your folders are link, run ``ls -l``\nand it will indicate them.\n\n```\nls -l node_modules/\n```\n\nNote the above command assumes the folder structure of   \n```\n       maker.makecode.com\n          |\n  ----------------------------------\n  |       |                        |\n pxt      pxt-common-packages  pxt-maker\n ```\n\n### Refresh dal.d.ts files\n\nWhenever you make changes to the ``#defines`` in the .cpp files, you will have to refresh\nthe ``dal.d.ts`` files. For that, run\n\n```\npxt builddaldts\n```\n\n### CODAL changes\n\nIf you need to do changes to CODAL itself, follow these steps.\n\n* create a new project in the web editor, then close the web server. Select the hardware you want to work with.\n* using a command prompt, open the ``projects`` folder and find the subfolder with your new project\n* open the folder in Visual Studio Code\n```\ncode .\n```\n* open ``pxt.json`` and edit the dependencies to use \nthe ``file:...`` path instead of ``*``\n\n```\n   dependencies: {\n        \"adafruit-metro-m0-express\": \"file:../../libs/adafruit-metro-m0-express\"\n   }\n```\n* from the command line, set the ``PXT_NODOCKER`` environment variable to ``1``\n\n```\nexport PXT_NODOCKER=1\n```\n\n* run a local build that will create a CODAL checkout automatically. \nIf you are missing tools, you will be notified by the build script.\n\n```\npxt build --local --force\n```\n\n* go to the ``built/dockercodal`` folder and open all CODAL in a new Visual Studio Code instance\n\n```\ncd built/dockercodal\ncode libraries/*\n```\n\n* go to the Git tab in VS Code, and change the branch of the CODAL repository to work on to ``master``. You can create a new branch to start doing your work and pull requests.\n\n* to build CODAL directly, run ``built/codal``\n```\npython build.py\n```\n\n* to rebuild your project from pxt, run ``pxt build --local --force`` from the project folder\n\n### Running\n\nRun this command from inside pxt-maker to open a local web server\n```\npxt serve\n```\nIf the local server opens in the wrong browser, make sure to copy the URL containing the local token. \nOtherwise, the editor will not be able to load the projects.\n\nIf you need to modify the `.cpp` files (and have installed yotta), enable yotta compilation using the `--localbuild` flag:\n```\npxt serve --localbuild\n```\n\n### Updates\n\nMake sure to pull changes from all repos regularly. More instructions are at https://github.com/microsoft/pxt#running-a-target-from-localhost\n\n## Repos \n\nThe pxt-maker target depends on several other repos. The main ones are:\n- https://github.com/microsoft/pxt, the PXT framework\n- https://github.com/microsoft/pxt-commmon-packages, common APIs accross various MakeCode editors\n- https://github.com/lancaster-university/codal-core, CODAL core project\n- https://github.com/lancaster-university/codal-mbed, mbed layer\n- https://github.com/lancaster-university/codal-samd21, CODAL SAMD21 layer\n- https://github.com/lancaster-university/codal-circuit-playground, Adafruit CPX layer\n\n## Code of Conduct\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n# Contributing\n\nThis project welcomes contributions and suggestions.  Most contributions require you to agree to a\nContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit https://cla.microsoft.com.\n\nWhen you submit a pull request, a CLA-bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions\nprovided by the bot. You will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwallarug%2Fpxt-grandcentral","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwallarug%2Fpxt-grandcentral","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwallarug%2Fpxt-grandcentral/lists"}