Skip to content

Commit 4999086

Browse files
nandojvekartben
authored andcommitted
boards: doiting: Introduce dt_bl10_devkit board
Introduce dt_bl10_devkit board from doiting vendor. Signed-off-by: Gerson Fernando Budke <nandojve@gmail.com>
1 parent 9048bd0 commit 4999086

File tree

11 files changed

+254
-0
lines changed

11 files changed

+254
-0
lines changed
Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Copyright (c) 2021-2025 ATL Electronics
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
config BOARD_DT_BL10_DEVKIT
5+
select SOC_BL602C20Q2I
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
# Copyright (c) 2021-2025 ATL Electronics
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
board_runner_args(bflb_mcu_tool --chipname bl602)
5+
include(${ZEPHYR_BASE}/boards/common/bflb_mcu_tool.board.cmake)
6+
7+
board_set_flasher(bflb_mcu_tool)
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
board:
2+
name: dt_bl10_devkit
3+
full_name: DT-BL10 coexistence Module Development Kit
4+
vendor: doiting
5+
socs:
6+
- name: bl602c20q2i
Binary file not shown.
Binary file not shown.
Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
1+
.. zephyr:board:: dt_bl10_devkit
2+
3+
DT-BL10 Development Kit
4+
#######################
5+
6+
Overview
7+
********
8+
9+
DT-BL10 Wi-Fi and BLE coexistence Module is a highly integrated single-chip
10+
low power 802.11n Wireless LAN (WLAN) network controller. It combines an RISC
11+
CPU, WLAN MAC, a lT1R capable WLAN baseband, RF, and Bluetooth in a single chip.
12+
It also provides a bunch of configurable GPIO, which are configured as digital
13+
peripherals for different applications and control usage.
14+
15+
DT-BL10 WiFi Module use BL602 as Wi-Fi and BLE coexistence soc chip. DT-BL10
16+
WiFi Module integrates internal memories for complete WIFI protocol functions.
17+
The embedded memory configuration also provides simple application developments.
18+
19+
DT-BL10 WiFi module supports the standard IEEE 802.11 b/g/n/e/i protocol and the
20+
complete TCP/IP protocol stack. User can use it to add the WiFi function for the
21+
installed devices, and also can be viewed as a independent network controller.
22+
23+
Hardware
24+
********
25+
26+
For more information about the Bouffalo Lab BL-602 MCU:
27+
28+
- `Bouffalo Lab BL602 MCU Website`_
29+
- `Bouffalo Lab BL602 MCU Datasheet`_
30+
- `Bouffalo Lab Development Zone`_
31+
- `dt_bl10_devkit Schematic`_
32+
- `Doctors of Intelligence & Technology (www.doiting.com)`_
33+
- `The RISC-V BL602 Book`_
34+
35+
Supported Features
36+
==================
37+
38+
.. zephyr:board-supported-hw::
39+
40+
System Clock
41+
============
42+
43+
The DT-BL10 board is configured to run at max speed (192MHz).
44+
45+
Serial Port
46+
===========
47+
48+
The ``dt_bl10_devkit`` board uses UART0 as default serial port. It is connected
49+
to USB Serial converter and port is used for both program and console.
50+
51+
52+
Programming and Debugging
53+
*************************
54+
55+
.. zephyr:board-supported-runners::
56+
57+
Samples
58+
=======
59+
60+
#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample
61+
application:
62+
63+
.. zephyr-app-commands::
64+
:zephyr-app: samples/hello_world
65+
:board: dt_bl10_devkit
66+
:goals: build
67+
68+
#. To flash an image using blflash runner:
69+
70+
#. Press D8 button
71+
72+
#. Press and release EN button
73+
74+
#. Release D8 button
75+
76+
.. code-block:: console
77+
78+
west flash
79+
80+
#. Run your favorite terminal program to listen for output. Under Linux the
81+
terminal should be :code:`/dev/ttyUSB0`. For example:
82+
83+
.. code-block:: console
84+
85+
$ minicom -D /dev/ttyUSB0 -o
86+
87+
The -o option tells minicom not to send the modem initialization
88+
string. Connection should be configured as follows:
89+
90+
- Speed: 115200
91+
- Data: 8 bits
92+
- Parity: None
93+
- Stop bits: 1
94+
95+
Then, press and release EN button
96+
97+
.. code-block:: console
98+
99+
*** Booting Zephyr OS build v4.1.0-4682-g21b20de1eb34 ***
100+
Hello World! dt_bl10_devkit/bl602c20q2i
101+
102+
Congratulations, you have ``dt_bl10_devkit`` configured and running Zephyr.
103+
104+
105+
.. _Bouffalo Lab BL602 MCU Website:
106+
https://www.bouffalolab.com/bl602
107+
108+
.. _Bouffalo Lab BL602 MCU Datasheet:
109+
https://github.com/bouffalolab/bl_docs/tree/main/BL602_DS/en
110+
111+
.. _Bouffalo Lab Development Zone:
112+
https://dev.bouffalolab.com/home?id=guest
113+
114+
.. _dt_bl10_devkit Schematic:
115+
https://github.com/SmartArduino/Doiting_BL/blob/master/board/DT-BL10%20User%20Mannual.pdf
116+
117+
.. _Doctors of Intelligence & Technology (www.doiting.com):
118+
https://www.doiting.com
119+
120+
.. _The RISC-V BL602 Book:
121+
https://lupyuen.github.io/articles/book
122+
123+
.. _Flashing Firmware to BL602:
124+
https://lupyuen.github.io/articles/book#flashing-firmware-to-bl602
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
/*
2+
* Copyright (c) 2021-2025 ATL Electronics
3+
* SPDX-License-Identifier: Apache-2.0
4+
*/
5+
6+
#include <dt-bindings/pinctrl/bl602x-pinctrl.h>
7+
8+
&pinctrl {
9+
uart0_default: uart0_default {
10+
group1 {
11+
pinmux = <GPIO7_UART0_RX>,
12+
<GPIO16_UART0_TX>;
13+
bias-pull-up;
14+
input-schmitt-enable;
15+
};
16+
};
17+
18+
uart0_sleep: uart0_sleep {
19+
group1 {
20+
pinmux = <GPIO7_UART0_RX>,
21+
<GPIO16_UART0_TX>;
22+
bias-high-impedance;
23+
};
24+
};
25+
};
Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
/*
2+
* Copyright (c) 2021-2025 ATL Electronics
3+
* SPDX-License-Identifier: Apache-2.0
4+
*/
5+
6+
/dts-v1/;
7+
8+
#include <bflb/bl60x.dtsi>
9+
#include "dt_bl10_devkit-pinctrl.dtsi"
10+
11+
/ {
12+
model = "2.4GHz Wi-Fi and BLE coexistence Module Development Kit";
13+
compatible = "bflb,bl602";
14+
15+
chosen {
16+
zephyr,flash = &flash0;
17+
zephyr,itcm = &itcm;
18+
zephyr,dtcm = &dtcm;
19+
zephyr,sram = &sram0;
20+
zephyr,console = &uart0;
21+
zephyr,shell-uart = &uart0;
22+
};
23+
};
24+
25+
&cpu0 {
26+
clock-frequency = <DT_FREQ_M(192)>;
27+
};
28+
29+
&spi1 {
30+
#address-cells = <1>;
31+
#size-cells = <0>;
32+
reg = <0x4000b000 0x1000 0x23000000 0xc00000>;
33+
34+
flash0: flash@0 {
35+
compatible = "issi,is25lp128", "jedec,spi-nor";
36+
status = "disabled";
37+
size = <DT_SIZE_M(128)>;
38+
jedec-id = [96 60 18];
39+
reg = <0>;
40+
spi-max-frequency = <DT_FREQ_M(133)>;
41+
};
42+
};
43+
44+
&uart0 {
45+
status = "okay";
46+
current-speed = <115200>;
47+
48+
pinctrl-0 = <&uart0_default>;
49+
pinctrl-1 = <&uart0_sleep>;
50+
pinctrl-names = "default", "sleep";
51+
};
Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Copyright (c) 2021-2025 ATL Electronics
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
identifier: dt_bl10_devkit
5+
name: DT-BL10 coexistence Module Development Kit
6+
type: mcu
7+
arch: riscv
8+
ram: 64
9+
toolchain:
10+
- zephyr
11+
testing:
12+
ignore_tags:
13+
- net
14+
- bluetooth
15+
supported:
16+
- pinctrl
17+
- uart
18+
vendor: doiting
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Copyright (c) 2021-2025 ATL Electronics
2+
# SPDX-License-Identifier: Apache-2.0
3+
4+
CONFIG_CONSOLE=y
5+
CONFIG_SERIAL=y
6+
7+
CONFIG_UART_CONSOLE=y
8+
CONFIG_UART_INTERRUPT_DRIVEN=y

boards/doiting/index.rst

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
.. _boards-doiting:
2+
3+
Doctors of Intelligence & Technology
4+
####################################
5+
6+
.. toctree::
7+
:maxdepth: 1
8+
:glob:
9+
10+
**/*

0 commit comments

Comments
 (0)