-
Notifications
You must be signed in to change notification settings - Fork 8.4k
boards: doiting: Introduce dt_bl10_devkit #90622
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
kartben
merged 2 commits into
zephyrproject-rtos:main
from
nandojve:bflb/add_dt_bl10_devkit
May 28, 2025
Merged
Changes from all commits
Commits
Show all changes
2 commits
Select commit
Hold shift + click to select a range
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,5 @@ | ||
| # Copyright (c) 2021-2025 ATL Electronics | ||
| # SPDX-License-Identifier: Apache-2.0 | ||
|
|
||
| config BOARD_DT_BL10_DEVKIT | ||
| select SOC_BL602C20Q2I |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,7 @@ | ||
| # Copyright (c) 2021-2025 ATL Electronics | ||
| # SPDX-License-Identifier: Apache-2.0 | ||
|
|
||
| board_runner_args(bflb_mcu_tool --chipname bl602) | ||
| include(${ZEPHYR_BASE}/boards/common/bflb_mcu_tool.board.cmake) | ||
|
|
||
| board_set_flasher(bflb_mcu_tool) |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,6 @@ | ||
| board: | ||
| name: dt_bl10_devkit | ||
| full_name: DT-BL10 coexistence Module Development Kit | ||
| vendor: doiting | ||
| socs: | ||
| - name: bl602c20q2i | ||
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,124 @@ | ||
| .. zephyr:board:: dt_bl10_devkit | ||
|
|
||
| DT-BL10 Development Kit | ||
| ####################### | ||
|
|
||
| Overview | ||
| ******** | ||
|
|
||
| DT-BL10 Wi-Fi and BLE coexistence Module is a highly integrated single-chip | ||
| low power 802.11n Wireless LAN (WLAN) network controller. It combines an RISC | ||
| CPU, WLAN MAC, a lT1R capable WLAN baseband, RF, and Bluetooth in a single chip. | ||
| It also provides a bunch of configurable GPIO, which are configured as digital | ||
| peripherals for different applications and control usage. | ||
|
|
||
| DT-BL10 WiFi Module use BL602 as Wi-Fi and BLE coexistence soc chip. DT-BL10 | ||
| WiFi Module integrates internal memories for complete WIFI protocol functions. | ||
| The embedded memory configuration also provides simple application developments. | ||
|
|
||
| DT-BL10 WiFi module supports the standard IEEE 802.11 b/g/n/e/i protocol and the | ||
| complete TCP/IP protocol stack. User can use it to add the WiFi function for the | ||
| installed devices, and also can be viewed as a independent network controller. | ||
|
|
||
| Hardware | ||
| ******** | ||
|
|
||
| For more information about the Bouffalo Lab BL-602 MCU: | ||
|
|
||
| - `Bouffalo Lab BL602 MCU Website`_ | ||
| - `Bouffalo Lab BL602 MCU Datasheet`_ | ||
| - `Bouffalo Lab Development Zone`_ | ||
| - `dt_bl10_devkit Schematic`_ | ||
| - `Doctors of Intelligence & Technology (www.doiting.com)`_ | ||
| - `The RISC-V BL602 Book`_ | ||
|
|
||
| Supported Features | ||
| ================== | ||
|
|
||
| .. zephyr:board-supported-hw:: | ||
|
|
||
| System Clock | ||
| ============ | ||
|
|
||
| The DT-BL10 board is configured to run at max speed (192MHz). | ||
|
|
||
| Serial Port | ||
| =========== | ||
|
|
||
| The ``dt_bl10_devkit`` board uses UART0 as default serial port. It is connected | ||
| to USB Serial converter and port is used for both program and console. | ||
|
|
||
|
|
||
| Programming and Debugging | ||
| ************************* | ||
|
|
||
| .. zephyr:board-supported-runners:: | ||
|
|
||
| Samples | ||
| ======= | ||
|
|
||
| #. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample | ||
| application: | ||
|
|
||
| .. zephyr-app-commands:: | ||
| :zephyr-app: samples/hello_world | ||
| :board: dt_bl10_devkit | ||
| :goals: build | ||
|
|
||
| #. To flash an image using blflash runner: | ||
|
|
||
| #. Press D8 button | ||
|
|
||
| #. Press and release EN button | ||
|
|
||
| #. Release D8 button | ||
|
|
||
| .. code-block:: console | ||
|
|
||
| west flash | ||
|
|
||
| #. Run your favorite terminal program to listen for output. Under Linux the | ||
| terminal should be :code:`/dev/ttyUSB0`. For example: | ||
|
|
||
| .. code-block:: console | ||
|
|
||
| $ minicom -D /dev/ttyUSB0 -o | ||
|
|
||
| The -o option tells minicom not to send the modem initialization | ||
| string. Connection should be configured as follows: | ||
|
|
||
| - Speed: 115200 | ||
| - Data: 8 bits | ||
| - Parity: None | ||
| - Stop bits: 1 | ||
|
|
||
| Then, press and release EN button | ||
|
|
||
| .. code-block:: console | ||
|
|
||
| *** Booting Zephyr OS build v4.1.0-4682-g21b20de1eb34 *** | ||
| Hello World! dt_bl10_devkit/bl602c20q2i | ||
|
|
||
| Congratulations, you have ``dt_bl10_devkit`` configured and running Zephyr. | ||
|
|
||
|
|
||
| .. _Bouffalo Lab BL602 MCU Website: | ||
| https://www.bouffalolab.com/bl602 | ||
|
|
||
| .. _Bouffalo Lab BL602 MCU Datasheet: | ||
| https://github.com/bouffalolab/bl_docs/tree/main/BL602_DS/en | ||
|
|
||
| .. _Bouffalo Lab Development Zone: | ||
| https://dev.bouffalolab.com/home?id=guest | ||
|
|
||
| .. _dt_bl10_devkit Schematic: | ||
| https://github.com/SmartArduino/Doiting_BL/blob/master/board/DT-BL10%20User%20Mannual.pdf | ||
|
|
||
| .. _Doctors of Intelligence & Technology (www.doiting.com): | ||
| https://www.doiting.com | ||
|
|
||
| .. _The RISC-V BL602 Book: | ||
| https://lupyuen.github.io/articles/book | ||
|
|
||
| .. _Flashing Firmware to BL602: | ||
| https://lupyuen.github.io/articles/book#flashing-firmware-to-bl602 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,25 @@ | ||
| /* | ||
| * Copyright (c) 2021-2025 ATL Electronics | ||
| * SPDX-License-Identifier: Apache-2.0 | ||
| */ | ||
|
|
||
| #include <dt-bindings/pinctrl/bl602x-pinctrl.h> | ||
|
|
||
| &pinctrl { | ||
| uart0_default: uart0_default { | ||
| group1 { | ||
| pinmux = <GPIO7_UART0_RX>, | ||
| <GPIO16_UART0_TX>; | ||
| bias-pull-up; | ||
| input-schmitt-enable; | ||
| }; | ||
| }; | ||
|
|
||
| uart0_sleep: uart0_sleep { | ||
| group1 { | ||
| pinmux = <GPIO7_UART0_RX>, | ||
| <GPIO16_UART0_TX>; | ||
| bias-high-impedance; | ||
| }; | ||
| }; | ||
| }; |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,51 @@ | ||
| /* | ||
| * Copyright (c) 2021-2025 ATL Electronics | ||
| * SPDX-License-Identifier: Apache-2.0 | ||
| */ | ||
|
|
||
| /dts-v1/; | ||
|
|
||
| #include <bflb/bl60x.dtsi> | ||
| #include "dt_bl10_devkit-pinctrl.dtsi" | ||
|
|
||
| / { | ||
| model = "2.4GHz Wi-Fi and BLE coexistence Module Development Kit"; | ||
| compatible = "bflb,bl602"; | ||
|
|
||
| chosen { | ||
| zephyr,flash = &flash0; | ||
| zephyr,itcm = &itcm; | ||
| zephyr,dtcm = &dtcm; | ||
| zephyr,sram = &sram0; | ||
| zephyr,console = &uart0; | ||
| zephyr,shell-uart = &uart0; | ||
| }; | ||
| }; | ||
|
|
||
| &cpu0 { | ||
| clock-frequency = <DT_FREQ_M(192)>; | ||
| }; | ||
|
|
||
| &spi1 { | ||
| #address-cells = <1>; | ||
| #size-cells = <0>; | ||
| reg = <0x4000b000 0x1000 0x23000000 0xc00000>; | ||
|
|
||
| flash0: flash@0 { | ||
| compatible = "issi,is25lp128", "jedec,spi-nor"; | ||
| status = "disabled"; | ||
nandojve marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| size = <DT_SIZE_M(128)>; | ||
| jedec-id = [96 60 18]; | ||
| reg = <0>; | ||
| spi-max-frequency = <DT_FREQ_M(133)>; | ||
| }; | ||
| }; | ||
|
|
||
| &uart0 { | ||
| status = "okay"; | ||
| current-speed = <115200>; | ||
|
|
||
| pinctrl-0 = <&uart0_default>; | ||
| pinctrl-1 = <&uart0_sleep>; | ||
| pinctrl-names = "default", "sleep"; | ||
| }; | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,18 @@ | ||
| # Copyright (c) 2021-2025 ATL Electronics | ||
| # SPDX-License-Identifier: Apache-2.0 | ||
|
|
||
| identifier: dt_bl10_devkit | ||
| name: DT-BL10 coexistence Module Development Kit | ||
| type: mcu | ||
| arch: riscv | ||
| ram: 64 | ||
| toolchain: | ||
| - zephyr | ||
| testing: | ||
| ignore_tags: | ||
| - net | ||
| - bluetooth | ||
| supported: | ||
| - pinctrl | ||
| - uart | ||
| vendor: doiting |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| # Copyright (c) 2021-2025 ATL Electronics | ||
| # SPDX-License-Identifier: Apache-2.0 | ||
|
|
||
| CONFIG_CONSOLE=y | ||
| CONFIG_SERIAL=y | ||
|
|
||
| CONFIG_UART_CONSOLE=y | ||
| CONFIG_UART_INTERRUPT_DRIVEN=y |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,10 @@ | ||
| .. _boards-doiting: | ||
|
|
||
| Doctors of Intelligence & Technology | ||
| #################################### | ||
|
|
||
| .. toctree:: | ||
| :maxdepth: 1 | ||
| :glob: | ||
|
|
||
| **/* |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.