nRF52832学习笔记（3）--构建第一个nRF connect SDK应用程序-点灯

基础工程创建

• 打开 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. 构建好的工程如下图所示
  

4. 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. 效果

二级目录

三级目录