Error codes

Your micro:bit may encounter a situation that prevents it from running your code. When this happens, a frowny face will appear on your micro:bit screen (see picture) followed by an error number. These are called panic codes.

basic.forever(function() {
    basic.showLeds(`
        # . . . #
        # # . # #
        . . . . .
        . # # # .
        # . . . #
        `)
    basic.pause(1000)
    basic.clearScreen()
    basic.showString("020")
})

Board system errors

The micro:bit system errors range between 01 - 99. For a full list of these codes, what they mean and what you can do to resolve them, visit the micro:bit guide to error codes.

10 (MICROBIT_I2C_LOCKUP): the micro:bit’s I2C bus is not working
20 (MICROBIT_OOM): there is no free memory on the micro:bit
30 (MICROBIT_HEAP_ERROR): a problem in the heap space
40 (MICROBIT_NULL_DEREFERENCE): there was a NULL dereference, the micro:bit tried to manage a invalid object pointer
42 (MICROBIT_SYSTEM_ERROR): there’s an error condition in the micro:bit system software
43 (MICROBIT_NO_RADIO): the micro:bit can’t enable the radio
50 (MICROBIT_HARDWARE_UNAVAILABLE_ACC): an error occurred with the micro:bit’s accelerometer component
51 (MICROBIT_HARDWARE_UNAVAILABLE_MAG): an error occurred with the micro:bit’s magnetometer component
90 (MICROBIT_HARDWARE_CONFIGURATION_ERROR): actual board hardware doesn’t match the configuration description
98 (MICROBIT_ASSERTION_FAILED): assertion failed, the condition in an assert was false

Memory errors

Memory error codes range from 800 - 909.

Report errors!

If you ever see an error within the range of 800 - 909, please report an issue at GitHub or on the support page.

Garbage collector errors

Error codes generated from the garbage collector.

840: Allocation pointer is null or invalid
841: Garbage collection work queue error
843: VTable entry is not free
844: GC allocation failed for requested number of bytes
846: Invalid allocation thread
848: Allocation pointer beyond allocation header
849: Allocation pointer is null

Program access errors

901 (PANIC_INVALID_BINARY_HEADER): the type header for the object is not valid
902 (PANIC_OUT_OF_BOUNDS): the object data portion is greater than the length defined for it
903 (PANIC_REF_DELETED): an object reference was deleted and the object is no longer valid
904 (PANIC_SIZE): the object size doesn’t match the size defined for the type
905 (PANIC_INVALID_VTABLE): an object vtable is invalid or not initialized
906 (PANIC_INTERNAL_ERROR): an internal resource error
907 (PANIC_NO_SUCH_CONFIG): the specified device resource is not present
909 (PANIC_INVALID_ARGUMENT): the argument value is out of range or the type or format is invalid
927 (PANIC_VARIANT_NOT_SUPPORTED): using a v2 feature on a v1 board
928 (MICROBIT_LOG_FULL): The micro:bit failed to write to datalogger as the log was full

JavaScript runtime codes

Invalid cast codes

When the static type of x is a class C, the dynamic type of x isn’t C, and you try to access a field on x or call a method on x, you will get one of the following codes, depending on dynamic type of x.

980 (PANIC_CAST_FROM_UNDEFINED): when value of x is undefined
981 (PANIC_CAST_FROM_BOOLEAN): when value of x is true or false
982 (PANIC_CAST_FROM_NUMBER): when x is a number
983 (PANIC_CAST_FROM_STRING): when x is a string
984 (PANIC_CAST_FROM_OBJECT): when x is object of some type
985 (PANIC_CAST_FROM_FUNCTION): when x is a function
989 (PANIC_CAST_FROM_NULL): when x is null