be7858cbed
* Fix example and do a few edits (#850) * Small fixes to the Karel project text (#862) * fix missing shadow type * add calibration info (#897) microbit-support:6348 User reported bug, but didn't realie micro:bit compass had to be calibrated on first run of the program. * Cherry pick adding various cross-editor compat APIs (#863) * fix nudge * Fix a typo ("screent") in the documentation (#1012) * Fix a typo "screent" -> "the LED screen" * Update showArrow doc string for consistency with other methods * Doc bugs found by xlators (#899) * Update rotation.md (#998) reflects actual behaviour of the board * fixed layout corruption (#1073) * Updating the new bug filer with the right link * Update challenges.md (#1325) For what I'm taught in school, 2 follows 1 😉😉. * Update simulator.md (#1209) * Update plant watering.md (#1264) the connection to servo are male not female * support for MIDI simulator in v0 (#1331) * Doc improvements (#1337) * update grammar in radio-dashboard sample code * Chanllenge 2 follows 1 I open all challenges.md without "Challenge 2" and review the file `grep -r "Challenge 2" -L | grep challenge | xargs -I@ code @` Changes to be committed: modified: docs/lessons/counter/challenges.md modified: docs/lessons/game-counter/challenges.md modified: docs/lessons/night-light/challenges.md modified: docs/lessons/snowflake-fall/challenges.md * Revert "support for MIDI simulator in v0 (#1331)" This reverts commit 30a9c411fb80762656e7a636feff8e77b7fd9e67. * Revert "Cherry pick adding various cross-editor compat APIs (#863)" This reverts commit 7308dbef23e9ee402bebb7e721d7014d8252c9e5. * Fixed pin needed to replace button A (#1385) * Cherry pick part of the signature update in in2cWriteBuffer (#863): 7308dbe |
||
|---|---|---|
| .github/ISSUE_TEMPLATE | ||
| .vscode | ||
| clients | ||
| docfiles | ||
| docs | ||
| editor | ||
| electron | ||
| external | ||
| fieldeditors | ||
| libs | ||
| pxtwapp | ||
| resources | ||
| sim | ||
| tests | ||
| theme | ||
| .clang-format | ||
| .gitattributes | ||
| .gitignore | ||
| .travis.yml | ||
| CONTRIBUTING.md | ||
| faviconDescription.json | ||
| LICENSE.txt | ||
| package-lock.json | ||
| package.json | ||
| ptrcheck-ignore | ||
| pxtarget.json | ||
| README.md | ||
| targetconfig.json | ||
| THIRD-PARTY-NOTICES.txt | ||
| travis-tests.sh | ||
| tslint.json | ||
| webmanifest.json | ||
micro:bit target for PXT
This README is for pxt-microbit v1.x, which is currently in beta.
pxt-microbit is a Microsoft Programming Experience Toolkit (PXT) target that allows you to program a BBC micro:bit. pxt-microbit v1.x requires pxt v3.x, which is currently in the master branch of pxt.
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
- Install Node.js 8.9.4 or higher.
- Install Yotta if you are going to edit any
.cppfiles. - Clone the pxt repository.
git clone https://github.com/microsoft/pxt
cd pxt
- Install the dependencies of pxt and build it
npm install
npm run build
cd ..
- Clone the pxt-common-packages repository
git clone https://github.com/microsoft/pxt-common-packages
cd pxt-common-packages
npm install
cd ..
- Clone the
v1branch of this repository.
git clone https://github.com/microsoft/pxt-microbit --branch v1
cd pxt-microbit
- Install the PXT command line (add
sudofor Mac/Linux shells).
npm install -g pxt
- Install the pxt-microbit dependencies.
npm install
- Link pxt-microbit back to base pxt repo (add
sudofor 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-commmon-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.
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.