1.. zephyr:board:: candlelightfd
2
3Overview
4********
5
6The candleLight FD is an open-hardware USB to CAN FD adapter board available from Linux Automation GmBH.
7Find more information about the board at the `Linux Automation website`_.
8
9Hardware
10********
11
12The candleLight FD board is equipped with a STM32G0B1CBT6 microcontroller and features an USB-C connector,
13a DB-9M connector for the CAN bus, and two user LEDs. Schematics and component placement drawings
14are available in the `candleLight FD GitHub repository`_.
15
16Supported Features
17==================
18
19The ``candlelightfd/stm32g0b1xx`` board target 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| CAN2      | on-chip    | CAN controller                      |
37+-----------+------------+-------------------------------------+
38
39The default configuration can be found in the defconfig file:
40:zephyr_file:`boards/others/candlelightfd/candlelightfd_stm32g0b1xx_defconfig`.
41
42System Clock
43============
44
45The STM32G0B1CBT6 PLL is driven by an external crystal oscillator (HSE) running at 8 MHz and
46configured to provide a system clock of 60 MHz. This allows generating a FDCAN1 and FDCAN2 core
47clock of 80 MHz.
48
49Programming and Debugging
50*************************
51
52Build and flash applications as usual (see :ref:`build_an_application` and
53:ref:`application_run` for more details).
54
55If flashing via USB DFU, short jumper ``BOOT`` when applying power to the candleLight FD in order to
56enter the built-in DFU mode.
57
58Variants
59========
60
61The candleLight FD is can be retrofitted with a second transceiver, making it a dual CAN FD device:
62
63- ``candlelightfd``: The default variant.
64- ``candlelightfd_stm32g0b1xx_dual``: Variant for the dual CAN FD.
65
66Here is an example for the :zephyr:code-sample:`blinky` application.
67
68.. zephyr-app-commands::
69   :zephyr-app: samples/basic/blinky
70   :board: candlelightfd
71   :goals: flash
72
73.. _Linux Automation website:
74   https://linux-automation.com/en/products/candlelight-fd.html
75
76.. _candleLight FD GitHub repository:
77   https://github.com/linux-automation/candleLightFD
78