https://github.com/microbit-foundation/micropython-microbit-v2
Temporary home for MicroPython for micro:bit v2 as we stablise it before pushing upstream
https://github.com/microbit-foundation/micropython-microbit-v2
Last synced: about 1 year ago
JSON representation
Temporary home for MicroPython for micro:bit v2 as we stablise it before pushing upstream
- Host: GitHub
- URL: https://github.com/microbit-foundation/micropython-microbit-v2
- Owner: microbit-foundation
- License: mit
- Created: 2020-10-12T18:21:15.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-09-18T02:06:06.000Z (almost 2 years ago)
- Last Synced: 2025-04-02T08:57:58.937Z (over 1 year ago)
- Language: C
- Size: 408 KB
- Stars: 48
- Watchers: 9
- Forks: 27
- Open Issues: 44
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
MicroPython on the micro:bit via CODAL
======================================
This is a port of MicroPython to the micro:bit which uses the CODAL as the
underlying target platform.
Setting up
----------
After cloning this repository update the submodules:
$ git submodule update --init
Then build the MicroPython cross-compiler:
$ make -C lib/micropython/mpy-cross
Note: you may need to add to the line above `PYTHON=python` (or some variant
thereof) to select your Python executable (this defaults to `python3`); for
example:
$ make -C lib/micropython/mpy-cross PYTHON=python
Building and running
--------------------
After setting up, go to the `src/` directory and build
(as above, you may need to add `PYTHON=python` to the `make` command):
$ cd src
$ make
That will build both `libmicropython.a` (from source in `src/codal_port/`) and
the CODAL app (from source in `src/codal_app/`). The resulting firmware will be
`MICROBIT.hex` in the `src/` directory which can be copied to the micro:bit.
Once the firmware is on the device there will appear a REPL prompt on the serial
port. To test it you can run:
>>> display.show(Image.HAPPY)
>>> audio.play(Sound.HAPPY)
Code of Conduct
-------------------
Trust, partnership, simplicity and passion are our core values we live and
breathe in our daily work life and within our projects. Our open-source
projects are no exception. We have an active community which spans the globe
and we welcome and encourage participation and contributions to our projects
by everyone. We work to foster a positive, open, inclusive and supportive
environment and trust that our community respects the micro:bit code of conduct.
Please see our [code of conduct](https://microbit.org/safeguarding/) which
outlines our expectations for all those that participate in our community and
details on how to report any concerns and what would happen should breaches occur.