A Blocks / JavaScript code editor for the micro:bit built on Microsoft MakeCode
Clone or download
Pull request Compare This branch is 672 commits behind Microsoft:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.vscode
clients
cmds
docfiles
docs
editor
electron
external
libs
pxtwapp
sim
tests
theme
.gitattributes
.gitignore
.travis.yml
CONTRIBUTING.md
LICENSE.txt
README.md
THIRD-PARTY-NOTICES.txt
faviconDescription.json
package-lock.json
package.json
ptrcheck-ignore
pxtarget.json
targetconfig.json
travis-tests.sh
tslint.json
webmanifest.json

README.md

micro:bit target for PXT

This target allows you to program a BBC micro:bit using PXT (Microsoft Programming Experience Toolkit).

Build Status

Issue tracking

All issue tracking for this repo happens at https://github.com/Microsoft/pxt, see you there!

Local server

The local server lets you to run the editor and serve the documentation from your own computer.

Setup

The following commands perform a one-time setup after synching the repo on your machine.

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

Running

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

Updates

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

Testing

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; there is a number of asserts in both of these
  • pxt testdir in tests - this makes sure all the files compile and generates .hex files
  • run the TD->TS converter on a number of test scripts from microbit.co.uk 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)
  • run pxt testdir 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.

Repos

The pxt-microbit target depends on several other repos. The main ones are:

Versions

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.*

Code of Conduct

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.