init SDK

Author: yangjie11

.gitignore

@@ -0,0 +1,3 @@
+*.pyc
+*.o
+language.settings.xml

README.md

@@ -1,2 +1,61 @@
-# sdk-bsp-stm32f407-spark
-sdk-bsp-stm32f407-spark
+## 简介
+
+“星火一号”，一款专为工程师和高校学生设计的嵌入式 RTOS 开发学习板。在这个科技飞速发展的时代，嵌入式系统已经成为了现代工业、交通、通信等众多领域的核心驱动力。而 RTOS 实时操作系统作为嵌入式领域的基石，更是工程师们必须熟练掌握的核心技术。作为业界主流的 RTOS 实时操作系统 RT-Thread，我们有义务帮助更多开发者掌握这项技术。为此，我们精心打造了一款专为工程师和高校学生设计的嵌入式开发学习板。
+
+星火一号主控选用了目前行业中比较常用且学习门槛较低的 STM32F407，性能强劲、功能丰富，完全能够满足嵌入式入门的需求。此开发板不仅具有众多的板载资源（Flash 存储、WIFI 通信、多个传感器），还支持丰富的扩展接口，让您轻松实现各种复杂的应用场景。通过使用这款开发学习板，您将能够深入了解 RTOS/RT-Thread 的工作原理，提升自己的技能水平，为当前以及未来的职业生涯做好充分准备。
+
+![board-small](docs/images/board-small.jpg)
+
+## 目录结构
+
+```
+|-- README.md
+|-- docs
+|   |-- SCH_LearnBoard_IoT_V0_0.pdf
+|   `-- images
+|-- libraries
+|   |-- Board_Drivers
+|   |-- HAL_Drivers
+|   `-- STM32F4xx_HAL
+|-- projects
+|   |-- 01_basic_led_blink
+|   |-- 02_basic_rgb_led
+|   |-- 03_basic_key
+|   |-- 04_basic_beep_led
+|   |-- 05_basic_ir
+|   |-- 06_driver_lcd
+|   |-- 07_driver_temp_humi
+|   |-- 08_driver_als_ps
+|   |-- 09_driver_axis
+|   |-- 10_component_usb_mouse
+|   `-- README.md
+|-- rt-thread
+`-- sdk-bsp-rt-spark.yaml
+```
+
+- sdk-bsp-rt-spark.yaml：描述 星火 1 号 的硬件信息
+- libraries：板级移植文件、通用外接驱动程序、STM32F4 固件库
+- projects：示例项目文件夹，包括各种示例代码
+- rt-thread：rt-thread 源代码
+
+## 使用
+
+sdk-bsp-stm32f407-spark 支持 RT-Thread Studio 和 MDK 开发。
+
+### RT-Thread Studio 开发
+
+1. 打开 RT-Thread Studio 的包管理器，安装 ` 星火一号开发板 ` 资源包
+2. 安装完成后，选择基于 BSP 创建工程即可
+
+### MDK 开发
+
+为了避免 SDK 在持续更新中，每一个 `projects` 都创建一份 `rt-thread` 文件夹 和 `libraries` 文件夹导致的 SDK 越来越臃肿，所以这些通用文件夹被单独提取了出来。这样就会导致直接打开 `MDK` 的工程编译会提示缺少上述两个文件夹的文件，我们使用如下步骤解决这个问题：
+
+1. 双击某个 `project` 目录下的 `mklinks.bat` 文件，或者使用 [Env](https://club.rt-thread.org/ask/question/5699.html) 工具执行 mklink 命令，分别为 `rt-thread` 及 `libraries` 文件创建符号链接。
+2. 查看目录下是否有 `rt-thread` 和 `libraries` 的文件夹图标。
+3. 使用 [Env](https://club.rt-thread.org/ask/question/5699.html) 工具执行 scons --target=mdk5 更新 MDK5 工程文件。
+
+## 交流平台
+
+对 星火一号 感兴趣的小伙伴可以加入 QQ 群 - RT-Thread 星火学习板 群号: 839583041、852752783。
+

docs/images/board-small.jpg

@@ -0,0 +1,61 @@
+import os
+import rtconfig
+from building import *
+
+Import('SDK_LIB')
+
+cwd = GetCurrentDir()
+
+# add general drivers
+src = []
+path =  [cwd]
+
+if GetDepend(['BSP_USING_ETH']):
+    src += Glob('phy_reset.c')
+
+if GetDepend(['BSP_USING_RS485']):
+    src += Glob('drv_rs485.c')
+    
+if GetDepend(['BSP_USING_SOFT_SPI_FLASH']):
+    src += Glob('soft_spi_flash_init.c')
+
+if GetDepend(['BSP_USING_SPI_FLASH']):
+    src += Glob('spi_flash_init.c')
+
+if GetDepend(['BSP_USING_FS']):
+    src += Glob('drv_filesystem.c')
+
+if GetDepend(['BSP_USING_FAL']):
+    src += Glob('fal/fal_spi_flash_sfud_port.c')
+    path += [cwd + '/fal']
+
+if GetDepend(['BSP_USING_SRAM']):
+    src += Glob('drv_sram.c')
+
+if GetDepend(['BSP_USING_ONBOARD_LCD']):
+    src += Glob('lcd/drv_lcd.c')
+    path += [cwd + '/lcd']
+    
+if GetDepend(['BSP_USING_ONBOARD_LED_MATRIX']):
+	src += Glob('led_matrix/drv_matrix_led.c')
+	path += [cwd + '/led_matrix']
+
+
+if GetDepend(['BSP_USING_EASYFLASH']):
+    src += Glob('ef_fal_port.c')
+
+if GetDepend(['BSP_USING_ENC28j60']):
+    src += Glob('drv_enc28j60.c')
+
+
+
+
+CPPDEFINES = ['STM32F407xx']
+group = DefineGroup('Drivers', src, depend = [''], CPPPATH = path, CPPDEFINES = CPPDEFINES)
+
+list = os.listdir(cwd)
+for item in list:
+    if os.path.isfile(os.path.join(cwd, item, 'SConscript')):
+        group = group + SConscript(os.path.join(item, 'SConscript'))
+
+Return('group')

docs/images/board.jpg

@@ -0,0 +1,34 @@
+/*
+ * Copyright (c) 2006-2018, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date           Author            Notes
+ * 2018-08-27     ZYLX              the first version
+ */
+
+#include <drivers/pin.h>
+#include <enc28j60.h>
+#include "drv_spi.h"
+#include "board.h"
+
+#define PIN_NRF_IRQ             GET_PIN(E,2)
+
+
+int enc28j60_init(void)
+{
+    __HAL_RCC_GPIOD_CLK_ENABLE();
+    rt_hw_spi_device_attach("spi1", "spi11", GPIOA, GPIO_PIN_4);
+
+    /* attach enc28j60 to spi. spi11 cs - PA4 */
+    enc28j60_attach("spi11");
+
+    /* init interrupt pin */
+    rt_pin_mode(PIN_NRF_IRQ, PIN_MODE_INPUT_PULLUP);
+    rt_pin_attach_irq(PIN_NRF_IRQ, PIN_IRQ_MODE_FALLING, (void(*)(void*))enc28j60_isr, RT_NULL);
+    rt_pin_irq_enable(PIN_NRF_IRQ, PIN_IRQ_ENABLE);
+
+    return 0;
+}
+INIT_COMPONENT_EXPORT(enc28j60_init);

libraries/Board_Drivers/SConscript

@@ -0,0 +1,123 @@
+/*
+ * Copyright (c) 2006-2021, RT-Thread Development Team
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Change Logs:
+ * Date           Author       Notes
+ * 2018-12-13     balanceTWK   add sdcard port file
+ * 2021-05-10     Meco Man     fix a bug that cannot use fatfs in the main thread at starting up
+ * 2021-07-28     Meco Man     implement romfs as the root filesystem
+ */
+
+#include <rtthread.h>
+#include <dfs_romfs.h>
+#include <dfs_fs.h>
+#include <dfs_file.h>
+
+#if DFS_FILESYSTEMS_MAX < 4
+#error "Please define DFS_FILESYSTEMS_MAX more than 4"
+#endif
+#if DFS_FILESYSTEM_TYPES_MAX < 4
+#error "Please define DFS_FILESYSTEM_TYPES_MAX more than 4"
+#endif
+
+#define DBG_TAG "app.filesystem"
+#define DBG_LVL DBG_INFO
+#include <rtdbg.h>
+
+#ifdef BSP_USING_FS_AUTO_MOUNT
+#ifdef BSP_USING_SDCARD_FATFS
+static int onboard_sdcard_mount(void)
+{
+    if (dfs_mount("sd0", "/sdcard", "elm", 0, 0) == RT_EOK)
+    {
+        LOG_I("SD card mount to '/sdcard'");
+    }
+    else
+    {
+        LOG_E("SD card mount to '/sdcard' failed!");
+    }
+
+    return RT_EOK;
+}
+#endif /* BSP_USING_SDCARD_FATFS */
+#endif /* BSP_USING_FS_AUTO_MOUNT */
+
+#ifdef BSP_USING_FLASH_FS_AUTO_MOUNT
+#ifdef BSP_USING_FLASH_FATFS
+#define FS_PARTITION_NAME "filesystem"
+
+static int onboard_fal_mount(void)
+{
+    /* 初始化 fal 功能 */
+    extern int fal_init(void);
+    extern struct rt_device *fal_blk_device_create(const char *parition_name);
+    fal_init();
+    /* 在 spi flash 中名为 "filesystem" 的分区上创建一个块设备 */
+    struct rt_device *flash_dev = fal_blk_device_create(FS_PARTITION_NAME);
+    if (flash_dev == NULL)
+    {
+        LOG_E("Can't create a block device on '%s' partition.", FS_PARTITION_NAME);
+    }
+    else
+    {
+        LOG_D("Create a block device on the %s partition of flash successful.", FS_PARTITION_NAME);
+    }
+
+    /* 挂载 spi flash 中名为 "filesystem" 的分区上的文件系统 */
+    if (dfs_mount(flash_dev->parent.name, "/fal", "elm", 0, 0) == 0)
+    {
+        LOG_I("Filesystem initialized!");
+    }
+    else
+    {
+        LOG_E("Failed to initialize filesystem!");
+        LOG_D("You should create a filesystem on the block device first!");
+    }
+
+    return RT_EOK;
+}
+#endif /*BSP_USING_FLASH_FATFS*/
+#endif /*BSP_USING_FLASH_FS_AUTO_MOUNT*/
+
+
+const struct romfs_dirent _romfs_root[] =
+{
+#ifdef BSP_USING_SDCARD_FATFS
+    {ROMFS_DIRENT_DIR, "sdcard", RT_NULL, 0},
+#endif
+
+#ifdef BSP_USING_FLASH_FATFS
+    {ROMFS_DIRENT_DIR, "fal", RT_NULL, 0},
+#endif
+};
+
+const struct romfs_dirent romfs_root =
+{
+    ROMFS_DIRENT_DIR, "/", (rt_uint8_t *)_romfs_root, sizeof(_romfs_root) / sizeof(_romfs_root[0])
+};
+
+static int filesystem_mount(void)
+{
+
+#ifdef BSP_USING_FS
+    if (dfs_mount(RT_NULL, "/", "rom", 0, &(romfs_root)) != 0)
+    {
+        LOG_E("rom mount to '/' failed!");
+    }
+
+    /* 确保块设备注册成功之后再挂载文件系统 */
+    rt_thread_delay(500);
+#endif
+#ifdef BSP_USING_FS_AUTO_MOUNT
+    onboard_sdcard_mount();
+#endif /* BSP_USING_FS_AUTO_MOUNT */
+
+#ifdef BSP_USING_FLASH_FS_AUTO_MOUNT
+    onboard_fal_mount();
+#endif
+
+    return RT_EOK;
+}
+INIT_APP_EXPORT(filesystem_mount);