card10.cfg

Certain high-level settings can be configured using a filed named card10.cfg. It is accessed from the USB File Transfer of the bootloader. Once you are in this mode and have mounted the badge’s flash device, you can either create or update a file named card10.cfg.

The file is in the well-known INI-style format, with one setting per line. For instance, if there were an option called answer_to_life, you could set it by writing the following line in the card10.cfg file:

answer_to_life = 42

Don’t forget to unmount the filesystem before rebooting your badge after changing any setting.

Syntax and Types

Lines that start with a # character are ignored.

Any other line will have the overall syntax of option_name = option_value, with spaces around the = character optional.

Option names are internal to card10 and described below. Each option has a defined type.

Type name

Description

Boolean

A true/false value. 1 or true is true, 0 or false is false. Example: foo = true.

String

An unquoted string value of maximum 20 bytes. Values longer than 20 bytes are trimmed. Example: foo = bar.

Integer

A signed 32-bit integer in base 10. Example: foo = 42 or bar = -1337.

Float

A single-precision (32-bit) floating-point number in base 10. Example: foo = 13.37.

Supported options

Option name

Type

Description

execute_elf

Boolean

Allow running of binary l0dables. These files can be nefarious, so this option is off by default.

timezone

String

Timezone for card10; must be of format [+-]HHMM. Examples: +0800, -0200

default_app

String

Full path to the exectutable file of the default application. If this option is not set,``apps/analog_clock/__init__.py`` is used.

ble_enable

Boolean

Activate the BLE interface. Turn off for more privacy or to conserve energy.

ble_mac

Boolean

MAC address used for BLE. Format: ca:4d:10:xx:xx:xx.

ble_hid_enable

Boolean

Enable the Human Interface Device (HID) characteristics on BLE.

ble_log_enable

Boolean

Activate HCI level logging of BLE data. Creates a new btsnoop compatible log file named ble.log in the logs folder after each boot if BLE is activated. Keeps the last 10 files.

right_scroll

Boolean

Use both right buttons to scroll up and down. Lower left button is SELECT.

long_press_ms

Integer

Defines the timespan for a long key press in milliseconds.

retrigger_ms

Integer

Defines the timespan for repeating key presses when a key is hold in milliseconds.

bsec_enable

Boolean

Activate the Bosch BSEC binary blob to compute an Indoor Air Quality indication.

bsec_debug

Boolean

Turn on debug output of the BSEC system. Prints each meaurement on the console.

bsec_offset

Integer

Temperature offset in .1 K. Example: Set to -14 if temperature reads 1.4 “C” to high. Default: -2.2 K (appropriate for a card10 without a case, connected to USB and with BLE active in vertical orientation).

battery_check

Boolean

Whether the low battery check should be enabled (default true). Warning: Do not use this unless you know what you’re doing. This option is only meant to be used on devices with a broken PMIC ADMUX connection.

has_flashlight

Boolean

Whether the flashlight LED was soldered onto the harmonic board. Can be used by apps to optionally enable flashlight features.