Go to file

James Devine d0dabbb757 microbit-samples: removed default config.json, moved from rc3 to rc4 A default config.json confused users when try to set option using MicroBitConfig.h. This patch removes the default, and thus enforces a user to make a conscious decision around whether to use yotta config, or MicroBitConfig.h		2016-06-04 00:42:35 +01:00
source	microbit-samples: Update to make HelloWorld the default sample	2016-04-08 16:57:27 +01:00
.gitignore	microbit-samples: added default target of bbc-microbit-classic-gcc	2016-03-24 14:54:47 +00:00
.yotta.json	microbit-samples: added default target of bbc-microbit-classic-gcc	2016-03-24 14:54:47 +00:00
LICENSE	microbit-samples: Added license information.	2016-04-06 16:43:10 +01:00
README.md	microbit-samples: removed default config.json, moved from rc3 to rc4	2016-06-04 00:42:35 +01:00
module.json	microbit-samples: removed default config.json, moved from rc3 to rc4	2016-06-04 00:42:35 +01:00

README.md

microbit-samples

A collection of example programs using the micro:bit runtime.

The source folder contains a selection of samples demonstrating the capabilities and usage of the runtime APIs. To select a sample, edit the MicroBitSamples.h file in the source folder and uncomment the line matching the sample you wish to use. Please be sure to note that only one sample is selected at a time.

Overview

The micro:bit runtime provides an easy to use environment for programming the BBC micro:bit in the C/C++ language, written by Lancaster University. It contains device drivers for all the hardware capabilities of the micro:bit, and also a suite of runtime mechanisms to make programming the micro:bit easier and more flexible. These range from control of the LED matrix display to peer-to-peer radio communication and secure Bluetooth Low Energy services. The micro:bit runtime is proudly built on the ARM mbed and Nordic nrf51 platforms.

In addition to supporting development in C/C++, the runtime is also designed specifically to support higher level languages provided by our partners that target the micro:bit. It is currently used as a support library for all the languages on the BBC www.microbit.co.uk website, including Microsoft Block, Microsoft TouchDevelop, Code Kingdoms JavaScript and Micropython languages.

Links

micro:bit runtime docs | microbit-dal | uBit

Build Environments

Build Environment	Documentation
ARM mbed online	http://lancaster-university.github.io/microbit-docs/online-toolchains/#mbed
yotta	http://lancaster-university.github.io/microbit-docs/offline-toolchains/#yotta

microbit-dal Configuration

To configure the DAL a number options can be modified in MicroBitConfig.h, a full list and explanation can be found in our documentation.

Alternately, yotta can be used to configure the dal regardless of module/folder structure, through providing a config.json in this directory.

Here is an example of config.json with all available options configured:

{
    "microbit-dal":{
        "bluetooth":{
            "enabled": 1,
            "pairing_mode": 1,
            "private_addressing": 0,
            "open": 0,
            "whitelist": 1,
            "advertising_timeout": 0,
            "tx_power": 0,
            "dfu_service": 1,
            "event_service": 1,
            "device_info_service": 1
        },
        "reuse_sd": 1,
        "default_pullmode":"PullDown",
        "gatt_table_size": "0x300",
        "heap_allocator": 1,
        "nested_heap_proportion": 0.75,
        "system_tick_period": 6,
        "system_components": 10,
        "idle_components": 6,
        "use_accel_lsb": 0,
        "min_display_brightness": 1,
        "max_display_brightness": 255,
        "display_scroll_speed": 120,
        "display_scroll_stride": -1,
        "display_print_speed": 400,
        "panic_on_heap_full": 1,
        "debug": 0,
        "heap_debug": 0,
        "stack_size":2048,
        "sram_base":"0x20000008",
        "sram_end":"0x20004000",
        "sd_limit":"0x20002000",
        "gatt_table_start":"0x20001900"
    }
}