- 基础工程创建
- 二级目录
- 三级目录
基础工程创建
- 打开 VS Code,单击nRF连接扩展。在“WELCOME”视图中,单机“Create a new application”
- 在“New Application”视图中,执行以下操作:
- 2.1. 选择“Freestanding"独立式应用程序将链接并使用已在计算机上安装的 nRF connect SDK 版本。另一种类型”Workspace“的应用程序是工作区应用程序,它将为每个应用程序提供一个专用的 SDK 实例。
2.2. 选择用于编译和构建应用程序的 nRF connect SDK 版本, “nRF connect Toolchain”版本要和选择的SDK版本一致。
2.3. 选择存储应用程序文件夹的目录,我的目录是D:\2.zjl_study\nordic\myapps。
2.4. 选择应用程序基础模板,会自动创建模板的副本保存在步骤2.3指定的目录中。这里我们选择模板zephyr\samples\basic\blinky。
2.5. 应用程序命名,这里命名为led。
2.6. 最后点击“Create Application”将一个未生成的应用程序添加到 VS Code 中,如下图所示: - 添加构建配置
nRF Connect SDK的众多优势之一是应用程序源代码与软件配置/硬件描述之间的高度分离,这使得为新的硬件或软件配置切换构建非常容易。
在这一步中,我们将指定要为哪个开发板或定制板(硬件)构建应用程序。我们还将选择在构建中使用的软件配置(*.conf和可能的覆盖)。
3.1如何添加构建配置
将鼠标悬停在应用程序名称上,然后单击小的“Add Bulid Configuration”图标。 - 这将会打开“Add Bulid Configuration”视图,如下所似:
- 3.1. 选择我们的开发板nrf52dk_nrf52832。如果你的板子是其他型号,可以选择其他对应的开发板ID。
3.2. 版本默认选择。
3.3. 配置默认选择。
3.4. Kconfig fragments字段将列出模板中可用的或已添加到应用程序文件夹中的Kconfig覆盖。这些是应用程序配置文件的修饰符(后续介绍)。led工程中没有用到。
3.5. CMake 参数字段允许在需要时将参数传递给构建系统。在此演示中将其留空。
3.6. build directory name提供了手动命名构建目录的选项,最终二进制文件和临时构建文件将在其中存储。保留为该工具指定的默认名。
3.7. 勾选7和8.
3.8. 单击“Build Configuration”按钮以创建配置并启动构建过程.
3.9. 构建好的工程如下图所示
- LED源码分析
#include <zephyr/kernel.h>
#include <zephyr/drivers/gpio.h>
/* 1000 msec = 1 sec */
#define SLEEP_TIME_MS 1000
/* The devicetree node identifier for the "led0" alias. */
#define LED0_NODE DT_ALIAS(led0)
/*
* A build error on this line means your board is unsupported.
* See the sample documentation for information on how to fix this.
*/
static const struct gpio_dt_spec led = GPIO_DT_SPEC_GET(LED0_NODE, gpios);
void main(void)
{
int ret;
if (!device_is_ready(led.port)) {
return;
}
ret = gpio_pin_configure_dt(&led, GPIO_OUTPUT_ACTIVE);
if (ret < 0) {
return;
}
while (1) {
ret = gpio_pin_toggle_dt(&led);
if (ret < 0) {
return;
}
k_msleep(SLEEP_TIME_MS);
}
}
4.1. 包含模块
led使用了nRF Connect SDK 一下模块:
- k_msleep();函数由内核服务提供,需要包含头文件<zephyr/kernel.h>。
- device_is_ready()和设备结构由设备驱动模块提供,需要包含头文件<zephyr/device.h>。
- 宏DT_ALIAS()由设备树文件提供,需要包含头文件<zephyr/devicetree.h>。
- 结构体gpio_dt_spec、宏GPIO_DT_SPEC_GET和函数gpio_pin_configure_dt()以及函数gpio_pin_toggle_dt由通用GPIO头文件提供,需要包含头文件<zephyr/drivers/gpio.h>。
- 头文件<zephyr/device.h>和<zephyr/devicetree.h>均被头文件<zephyr/kernel.h>包含,所以直接使用头文件<zephyr/kernel.h>即可。
4.2. 定义节点标识符:DT_ALIAS()
#define LED0_NODE DT_ALIAS(led0)//获取led0的设备树节点。
4.3. 宏GPIO_DT_SPEC_GET()
static const struct gpio_dt_spec led = GPIO_DT_SPEC_GET(LED0_NODE, gpios);
/*宏GPIO_DT_SPEC_GET返回包含节点led0的设备指针以及引脚号和相关的配置标志,
在上一步中定义的节点标识符LED0_NODE将此信息嵌入到其gpios属性中。
注意第二个参数gpios,它是包含所有这些信息的属性的名称。*/
4.4. 验证设备是否可以使用
if (!device_is_ready(led.port)) {
return;
}
4.5. 配置GPIO引脚
/*gpio_pin_configure_dt:配置led对应gpio引脚的输出状态*/
ret = gpio_pin_configure_dt(&led, GPIO_OUTPUT_ACTIVE);
if (ret < 0) {
return;
}
4.6. 在while(1)中不断切换led的状态
/*gpio_pin_toggle_dt:从gpio_dt_spec切换引脚级别*/
while (1) {
ret = gpio_pin_toggle_dt(&led);
if (ret < 0) {
return;
}
k_msleep(SLEEP_TIME_MS);
}
5.“ACTIONS”视图说明
5.1 “Build”编译构建工程文件。点击即可编译。点击点头指向的圆箭头表示全编译的意思,这样是说有的文件都重新编译一边,比较慢。编译后的输出如下:
5.2. Guiconfig
5.3. Debug
5.4. 连接开发板。在 CONNECTED DEVICES点击圆箭头链接设备
5.5. “Flash”将编译好的文件下载到开发板,前提是保证已经连接了开发板。下载到开发板成功如下图所示:
4.6. 效果
二级目录
三级目录