99 lines
3.1 KiB
Markdown
99 lines
3.1 KiB
Markdown
# micro:bit target for PXT
|
|
|
|
[](https://travis-ci.org/Microsoft/pxt-microbit)
|
|
|
|
pxt-microbit is a [Microsoft Programming Experience Toolkit (PXT)](https://github.com/Microsoft/pxt) target that allows you to program a [BBC micro:bit](https://microbit.org/). pxt-microbit v1.x requires pxt v4.x, which is currently in the [master branch of pxt](https://github.com/Microsoft/pxt/tree/master).
|
|
|
|
* [Try it live](https://makecode.microbit.org/)
|
|
|
|
## Issue tracking
|
|
|
|
Please add an issue if you discover an (unreported) bug.
|
|
|
|
## Local server
|
|
|
|
The local server lets you to run the editor and serve the documentation from your own computer.
|
|
|
|
### Setup
|
|
|
|
1. Install [Node.js](https://nodejs.org/) 8.9.4 or higher.
|
|
2. Install [Yotta](http://docs.yottabuild.org/) if you are going to edit any `.cpp` files.
|
|
3. Clone the pxt repository.
|
|
```
|
|
git clone https://github.com/microsoft/pxt
|
|
cd pxt
|
|
```
|
|
4. Install the dependencies of pxt and build it
|
|
```
|
|
npm install
|
|
npm run build
|
|
cd ..
|
|
```
|
|
5. Clone the pxt-common-packages repository
|
|
```
|
|
git clone https://github.com/microsoft/pxt-common-packages
|
|
cd pxt-common-packages
|
|
npm install
|
|
cd ..
|
|
```
|
|
6. Clone the `master` branch of this repository.
|
|
```
|
|
git clone https://github.com/microsoft/pxt-microbit --branch master
|
|
cd pxt-microbit
|
|
```
|
|
7. Install the PXT command line (add `sudo` for Mac/Linux shells).
|
|
```
|
|
npm install -g pxt
|
|
```
|
|
8. Install the pxt-microbit dependencies.
|
|
```
|
|
npm install
|
|
```
|
|
8. Link pxt-microbit back to base pxt repo (add `sudo` for Mac/Linux shells).
|
|
```
|
|
npm link ../pxt
|
|
npm link ../pxt-common-packages
|
|
```
|
|
Note the above command assumes the folder structure of
|
|
```
|
|
makecode
|
|
|
|
|
----------------------------------
|
|
| | |
|
|
pxt pxt-common-packages pxt-microbit
|
|
```
|
|
|
|
### Running
|
|
|
|
Run this command from inside pxt-microbit to open a local web server
|
|
```
|
|
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 to modify the `.cpp` files (and have installed yotta), enable yotta compilation using the `--localbuild` flag:
|
|
```
|
|
pxt serve --localbuild
|
|
```
|
|
|
|
### Updates
|
|
|
|
Make sure to pull changes from all repos regularly. More instructions are at https://github.com/Microsoft/pxt#running-a-target-from-localhost
|
|
|
|
## Repos
|
|
|
|
The pxt-microbit target depends on several other repos. The main ones are:
|
|
- https://github.com/Microsoft/pxt, the PXT framework
|
|
- https://github.com/Microsoft/pxt-common-packages, common APIs accross various MakeCode editors
|
|
- https://github.com/lancaster-university/microbit, basic wrapper around the DAL
|
|
- https://github.com/lancaster-university/microbit-dal
|
|
|
|
## History
|
|
|
|
See the [MakeCode blog](https://makecode.com/blog).
|
|
|
|
## 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.
|