Go to file
Joe Finney d9d2343ab6 microbit: Add Multicast peer-to-peer radio capability
Integration of new radio mode that permits simple local area multicast communication
directly between micro:bits using the device's on board radio hardware.

It should be noted that this implementation build directly on the nrf51822
hardware. It is not a BLE protocol, and must (currently) be operated with BLE
disabled.

A standard on the wire configuration is defined, to promote future
interoperability between projects and languages. A lightweight
packet format is also defined and adhered to, so as to promote future
extensibility without sacrificing compatibility. The notion of groups is also
introduced, that enable multiple groups of children to work in the same area
without compromising each other's projects.

In adition to a low level packet radio driver, two higher level protocols are
defined that allow simple user datagram communication between micro:bits and
an EventBus protocol that allows the micro:bit's MessageBus to be extended to
other micro:bits.
2016-02-01 04:29:27 +00:00
docs microbit: Updates to Pairing Mode to improve the user experience 2015-12-11 03:43:18 +00:00
inc microbit: Add Multicast peer-to-peer radio capability 2016-02-01 04:29:27 +00:00
source microbit: Add Multicast peer-to-peer radio capability 2016-02-01 04:29:27 +00:00
.gitignore Merge branch 'master' into flatstring 2015-11-12 16:13:45 -08:00
CHANGES.md ble_issue_tracker.md now the file to track BLE issues in 2015-09-10 10:06:27 +01:00
README.md Update README.md 2015-09-11 16:50:28 +01:00
module.json version v1.4.10 2016-01-25 21:19:36 +00:00

README.md

microbit-dal

Building a project for the micro:bit using Yotta

Instead of using the online IDE, Yotta can be used to provide an equivalent offline experience. The current compilers that are available are:

  • GCC
  • ARMCC

Getting Started

1. Install Yotta

The first step is to get Yotta onto your machine, to do this follow the install guide here

Note: if you are on windows, dependencies will be missed as of 8/8/15, please use the helper script located here.

2. Fetch the example project

If your install has gone correctly, and you have all dependencies installed, the next step is to fetch the example project using the runtime from GitHub.

git clone https://github.com/lancaster-university/microbit

Note: To successfully build this project you will need access to the microbit-dal private repository, if you need access please email me at j.devine@lancaster.ac.uk.

3. Try to build

Building rarely works first time due to dependencies currently not being installed by Yotta, so the next step is to try to build.

The default yotta target you will receive when you pull the aforementioned repo is bbc-microbit-classic-armcc, you can use the following command to print your current target in Yotta:

yt target

bbc-microbit-classic-armcc 0.0.5
mbed-armcc 0.0.8

If you do not have armcc installed (or don't have a license for Keil), then you will need to use GCC. To swap to the GCC target run:

yt target bbc-microbit-classic-gcc

Then you should try to build using the following command:

yt build

NOTE: To build the final hex files for the micro:bit, you will need to install the srec which can be installed via brew (brew install srecord), or you can install it manually from here.

4. Flash your micro:bit

The final step is to check your hex works.

The yotta build command will place files in /build/<TARGET_NAME>/source. The file you will need to flash will be microbit-combined.hex. Simply drag and drop the hex.

The expected result will be that the micro:bit will scroll BELLO! :) on its display.