60 lines
2.0 KiB
Markdown
60 lines
2.0 KiB
Markdown
# micro:bit target for PXT
|
|
|
|
This target allow to program a [BBC micro:bit](https://www.microbit.co.uk/) using
|
|
PXT ([Microsoft Programming Experience Toolkit](https://github.com/Microsoft/pxt)).
|
|
|
|
* [Try it live](https://codethemicrobit.com)
|
|
|
|
[](https://travis-ci.org/Microsoft/pxt-microbit)
|
|
|
|
## Local server
|
|
|
|
### Setup
|
|
|
|
The following commands are a 1-time setup after synching the repo on your machine.
|
|
|
|
* clone this repo to your computer
|
|
* install the PXT command line
|
|
```
|
|
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
|
|
```
|
|
|
|
To make sure you're running the latest tools, run (add ``sudo`` for Mac/Linux shells)
|
|
```
|
|
pxt update
|
|
```
|
|
|
|
More instructions at https://github.com/Microsoft/pxt#running-a-target-from-localhost
|
|
|
|
## Universal Windows App
|
|
|
|
The Windows 10 app is a [Universal Windows Hosted Web App](https://microsoftedge.github.io/WebAppsDocs/en-US/win10/CreateHWA.htm)
|
|
that wraps ``codethemicrobit.com`` and provides additional features.
|
|
|
|
### Building
|
|
|
|
* Install Visual Studio 2015 Update 2 or higher. Make sure the Windows 10 templates are installed.
|
|
* open the ``win10/app.sln`` solution and launch the ``codethemicrobit`` project.
|
|
|
|
## Code of Conduct
|
|
|
|
This 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.
|