micro:bit target for Microsoft MakeCode (PXT)
npm install pxt-microbit-fmThis target allows you to program a BBC micro:bit using
PXT (Microsoft Programming Experience Toolkit).
All issue tracking for this repo happens at https://github.com/Microsoft/pxt, see you there!
The local server lets you to run the editor and serve the documentation from your own computer.
The following commands perform a one-time setup after synching the repo on your machine.
* See requirements for pxt
* clone this repo to your computer and go in the project folder
``
git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit
* install the PXT command line (add sudo for Mac/Linux shells).`
npm install -g pxt
* install the dependencies
npm install
`
Run this command to open a local web server (add sudo for Mac/Linux shells)`
pxt serve
If the local server opens in the wrong browser, make sure to copy the URL containing the local token.
Otherwise, the editor will not be able to load the projects.
If you need modify the .cpp files, turn on yotta compilation with the -yt flag (add sudo for Mac/Linux shells):`
pxt serve -yt
To update your PXT version and make sure you're running the latest tools, run (add sudo for Mac/Linux shells):`
pxt update
More instructions are at https://github.com/Microsoft/pxt#running-a-target-from-localhost
The build also automatically runs the following checks:
* make sure the built-in packages compile
pxt run in libs/lang-test - this will run the test in command line runner; pxt testdir
there is a number of asserts in both of these
* in tests - this makes sure all the files compile and generates .hex filesmicrobit.co.uk
* run the TD->TS converter on a number of test scripts from and make sure the results compile
To test something on the device:
do a pxt deploy in libs/lang-test - they should show 1 or 2 on the screen (and not unhappy face)pxt testdir
* run in tests and deploy some of the hex files from tests/built
The lang-test0 source comes from the pxt-core package. It's also tested with pxt run` there.
The pxt-microbit target depends on several other repos. The main ones are:
- https://github.com/Microsoft/pxt, the PXT framework
- https://github.com/lancaster-university/microbit, basic wrapper around the DAL
- https://github.com/lancaster-university/microbit-dal
Current serviced versions of pxt-microbit:
| Target | Version | Type | PXT |
|---|---|---|---|
| pxt-microbit | v0.13.\ | accessibility | uses pxt/v0 v.0.13.\ (with accessibility) |
| pxt-microbit | v0.12.\ | release | uses pxt/v0 v.0.12.\ |
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.