1.. zephyr:code-sample:: led-xec
2   :name: Breathing-blinking LED (BBLED)
3   :relevant-api: led_interface
4
5   Control a BBLED (Breathing-Blinking LED) using Microchip XEC driver.
6
7Overview
8********
9
10This sample allows to test the Microchip led-xec driver which uses the
11breathing-blinking LED (BBLED) controllers. The SoC design is fixed
12allowing each BBLED control over one specific GPIO.
13
14MEC15xx and MEC172x:
15
16- BBLED controller 0 uses GPIO 0156.
17- BBLED controller 1 uses GPIO 0157.
18- BBLED controller 2 uses GPIO 0153.
19
20MEC172x has a fourth instance of BBLED:
21
22- BBLED controller 3 uses GPIO 0035
23
24Test pattern
25============
26
27For each LEDs (one after the other):
28
29- Turning on
30- Turning off
31- Blinking on: 0.1 sec, off: 0.1 sec
32- Blinking on: 1 sec, off: 1 sec
33
34Board Jumpers
35*************
36
37mec172xevb_assy6906 evaluation board
38====================================
39
40- BBLED0: GPIO 0156.
41       - Connect GPIO 0156 to board LED4 by placing a wire from JP71-11 to J47-3.
42       - Make sure there are no jumpers on JP54 1-2 and JP21 4-5
43
44- BBLED1: GPIO 0157.
45       - Connect GPIO 0156 to board LED5 by placing a wire from JP71-12 to J48-3.
46       - Make sure there are no jumpers on JP54 3-4 and JP21 16-17
47
48- BBLED2: GPIO 0153.
49       - Connect GPIO 0153 to board LED7 by placing a wire from JP71-5 to JP146-5.
50
51         JP146-5 is connected to MEC172x VCI_OUT1 without a jumper. Force VCI_OUT1
52         high by forcing VCI_IN1 high: install jumper on J55 3-4 which pulls VCI_IN1
53         to the VBAT rail via a 100K pull-up. Requires VBAT power rail is connected
54         to VTR or some other power source.
55
56- BBLED3: GPIO 0035.
57       - Connect GPIO 0035 to board LED7 by placing a wire from JP67-19 to JP146-1.
58       - Make sure there is no jumper on JP79 17-18.
59
60         JP146-1 is connected to MEC172x VCI_OUT2 without a jumper. Force VCI_OUT2
61         high by forcing VCI_IN2 high: install a jumper on J55 5-6 which pulls VCI_IN2
62         to the VBAT rail via a 100K pull-up. Requires VBAT power rail is connected
63         to VTR or some other power source.
64
65mec15xxevb_assy6853 evaluation board
66====================================
67
68- BBLED0: GPIO 0156.
69       - Add jumper on JP41 1-2 to connect GPIO 0156 to board LED2
70       - Remove jumper on JP31 13-14
71
72- BBLED1: GPIO 0157.
73       - Add jumper on JP41 3-4 to connect GPIO 0157 to board LED3
74       - Remove jumper on JP31 15-16
75
76- BBLED2: GPIO 0153.
77       - Add jumper on JP41 3-4 to connect GPIO 0153 to board LED4
78       - Remove jumper on JP31 17-18
79
80Building and Running
81********************
82
83This sample can be built and executed on all the boards with the LEDs connected.
84The LEDs must be correctly described in the DTS. Each breathing-blinking LED
85controller is fixed by chip design to connect to one GPIO. The bbled node must
86have its PINCTRL properties set to the correct GPIO.
87