1.. zephyr:board:: candlelight
2
3Overview
4********
5
6The candleLight is an open-hardware USB to CAN 2.0B adapter board available from a number of
7sources.
8
9Hardware
10********
11
12The candleLight board is equipped with a STM32F072CB microcontroller and features an USB connector,
13a DB-9M connector for the CAN bus, and two user LEDs. Schematics and component placement drawings
14are available in the `candleLight GitHub repository`_.
15
16Supported Features
17==================
18
19The ``candlelight`` board configuration supports the following hardware features:
20
21+-----------+------------+-------------------------------------+
22| Interface | Controller | Driver/Component                    |
23+===========+============+=====================================+
24| NVIC      | on-chip    | nested vector interrupt controller  |
25+-----------+------------+-------------------------------------+
26| PINMUX    | on-chip    | pinmux                              |
27+-----------+------------+-------------------------------------+
28| FLASH     | on-chip    | flash memory                        |
29+-----------+------------+-------------------------------------+
30| GPIO      | on-chip    | gpio                                |
31+-----------+------------+-------------------------------------+
32| USB       | on-chip    | USB                                 |
33+-----------+------------+-------------------------------------+
34| CAN1      | on-chip    | CAN controller                      |
35+-----------+------------+-------------------------------------+
36
37The default configuration can be found in the defconfig file:
38:zephyr_file:`boards/others/candlelight/candlelight_defconfig`.
39
40Other hardware features are not currently supported by the port.
41
42System Clock
43============
44
45The STM32F072CB PLL is driven by the internal RC oscillator (HSI) running at 8 MHz and
46configured to provide a system clock of 48 MHz.
47
48Programming and Debugging
49*************************
50
51Build and flash applications as usual (see :ref:`build_an_application` and
52:ref:`application_run` for more details).
53
54If flashing via USB DFU, short resistor ``R203`` when applying power to the candleLight in order to
55enter the built-in DFU mode.
56
57Here is an example for the :zephyr:code-sample:`blinky` application.
58
59.. zephyr-app-commands::
60   :zephyr-app: samples/basic/blinky
61   :board: candlelight
62   :goals: flash
63
64.. _candleLight GitHub repository:
65   https://github.com/HubertD/candleLight
66