1.. zephyr:board:: kincony_kc868_a32
2
3Overview
4********
5
6Kincony KC868-A32 is a home automation relay module based on the
7Espressif ESP-WROOM-32 module with all its inherent capabilities
8(Wi-Fi, Bluetooth, etc.)
9
10The features include the following:
11
12- 32 digital optoisolated inputs “dry contact”
13- 4 analog inputs 0-5 V
14- 32 relays 220 V, 10 A (COM, NO, NC)
15- RS485 interface
16- I2C connector
17- Connector GSM/HMI
18- Ethernet LAN8270A
19- USB Type-B connector for programming and filling firmware
20- RESET and DOWNLOAD buttons
21- Powered by 12V DC
22
23System requirements
24===================
25
26Prerequisites
27-------------
28
29Espressif HAL requires WiFi and Bluetooth binary blobs in order work. Run the command
30below to retrieve those files.
31
32.. code-block:: console
33
34   west blobs fetch hal_espressif
35
36.. note::
37
38   It is recommended running the command above after :file:`west update`.
39
40Building & Flashing
41-------------------
42
43Build and flash applications as usual (see :ref:`build_an_application` and
44:ref:`application_run` for more details).
45
46.. zephyr-app-commands::
47   :zephyr-app: samples/hello_world
48   :board: kincony_kc868_a32/esp32/procpu
49   :goals: build
50
51The usual ``flash`` target will work with the ``kincony_kc868_a32`` board
52configuration. Here is an example for the :zephyr:code-sample:`hello_world`
53application.
54
55.. zephyr-app-commands::
56   :zephyr-app: samples/hello_world
57   :board: kincony_kc868_a32/esp32/procpu
58   :goals: flash
59
60Open the serial monitor using the following command:
61
62.. code-block:: shell
63
64   west espressif monitor
65
66After the board has automatically reset and booted, you should see the following
67message in the monitor:
68
69.. code-block:: console
70
71   ***** Booting Zephyr OS vx.x.x-xxx-gxxxxxxxxxxxx *****
72   Hello World! kincony_kc868_a32
73
74Enabling Ethernet
75*****************
76
77Enable Ethernet in KConfig:
78
79.. code-block:: cfg
80
81    CONFIG_NETWORKING=y
82    CONFIG_NET_L2_ETHERNET=y
83    CONFIG_MDIO=y
84
85References
86**********
87
88.. target-notes::
89
90.. _KINCONY KC868-A32 User Guide: https://www.kincony.com/arduino-esp32-32-channel-relay-module-kc868-a32.html
91