文件:Micro ecc.png

2020-01-07T08:11:03Z

Erjin：

NRF52832DK-DFU固件升级教程

2020-01-07T08:10:10Z

Erjin：/* 存储空间布局（Memory layout） */

文件:Secure bootloader.png

2020-01-07T07:22:48Z

Erjin：

Detail on secure bootloader

NRF52832DK-DFU固件升级教程

2020-01-07T06:37:58Z

Erjin：/* 烧录bootloader（Programming the bootloader） */

文件:Bootloader memory nrf52.png

2020-01-07T06:36:01Z

Erjin：

memory layout for nRF52 devices

文件:Bootloader memory layout.png

2020-01-07T06:30:52Z

NRF52832DK基础实验

2019-07-18T07:07:45Z

Erjin：/* flash readwrite*/

nRF52832是Nordic公司推出一款高性能无线SOC芯片，在芯片上可以运行多种协议栈，包括蓝牙BLE，NFC,ANT,802.15.4G，其中BLE协议栈可以支持到BLE5.0。为此谷雨物联推出一款基于nRF52832芯片评估板，nRF52832DK。

nRF52832DK评估板上设计了丰富实用的外围设备。其中有4路LED，4路按键输入，一路MINI usb转UART，三路PWM RGB灯珠，一路有源蜂鸣器，一路光敏，一路振动马达，TFT显示器接口，NFC标签接口。

=== nRF52832DK基础实验说明列表 ===
方便开发者，更快，更容易上手nRF52832芯片的外设操作，为此我们提供和整理nRF52832DK外围电路实验说明。见下表所示。

{| class="wikitable"
|+
!实验名称
!实验所需外设
!实验简单说明
|-
|01_LED亮灭实验
|GPIO
|熟悉GPIO操作
|-
|02_按键输入实验（poll）
|GPIO
|熟悉GPIO操作
|-
|03_按键输入实验（int）
|GPIO边沿中断
|熟悉GPIO边沿中断
|-
|04_振动马达实验
|GPIO
|熟悉GPIO操作
|-
|05_蜂鸣器实验
|GPIO
|熟悉GPIO操作
|-
|06_RGB实验
|PWM
|熟悉PWM操作
|-
|07_TFT实验(tft_lcd_144，tft_lcd_130)
|SPI
|熟悉SPI操作
|-
|08_UART收发实验
|UART
|熟悉UART操作
|-
|09_光照度实验
|ADC
|熟悉ADC操作
|-
|10_温度实验
|Temperture
|芯片上温度传感器
|-
|11_Flash操作
|NVMC
|片上Flash操作
|}

=== LED亮灭实验 ===
LED亮灭实验是展示nRF52832的GPIO输出配置，使开发者更直观的了解GPIO输出。GPIO输出是熟悉一款MCU的开始。下面将简单的介绍并分析相关代码。在NRF52832DK评估板上有4路LED资源，分别处在PIN17，PIN18，PIN19，PIN20四个引脚上。LED电路原理图，如下图所示。其为低电平有效，即引脚为低电平时LED被点亮，引脚为高电平时LED熄灭。
[[文件:FOUR LINES LED.png|居中|缩略图|402x402像素|LED 外设电路]]

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中01_led_blinkly工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{

LED_Init();

for(;;)
{
//循环点亮熄灭LED，间隔500ms
for( uint8_t i = 0; i < LEDS_NUMBER ; i++)
{
nrf_gpio_pin_toggle(Leds[i]);
nrf_delay_ms(500);
}
}
}
</syntaxhighlight>其中LED_Init函数用于初始化LED引脚。将四路LED引脚初始化输出模式，并置高电平，即熄灭LED。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :LED_Init
//
// brief : 初始化LED引脚为输出模式，并熄灭LED
//
// param : none
//
// return : none
void LED_Init(void)
{
uint8_t i = 0;

//配置LED引脚为输出模式
nrf_gpio_range_cfg_output(LED_START, LED_STOP);

//置LED引脚为高电平，即LED灭
for(i = 0 ; i < LEDS_NUMBER; i++)
{
nrf_gpio_pin_set(Leds[i]);
}
}
</syntaxhighlight>LED_START，LED_STOP是两个宏，标记LED开始引脚到LED结束引脚范围。配合nrf_gpio_range_cfg_output函数，可实现批量设置。nrf_gpio_pin_set设置LED引脚输出高电平。

完成LED引脚配置，进入while循环。在循环中遍历所有的LED引脚，翻转引脚高低电平，达到闪烁的目的。nrf_delay_ms函数用于软件延时。nrf_gpio_pin_toggle对引脚电平进行翻转。参数是LED引脚。在nrf_gpio_pin_toggle内部，先读取引脚当前的高低电平状态，然后根据返回的状态进行取反，再设置OUT寄存器。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832的LED便会每500ms依次点亮LED；当四个LED全部点亮后，再以500ms依次熄灭LED，直到全部熄灭。

=== 按键输入实验(poll) ===
01_LED亮灭实验是操作GPIO引脚输出，而本实验是操作GPIO的输入。利用GPIO输入引脚电平变化，来监测按键按下动作。在NRF52832DE评估板上，提供了四路按键资源，分别占用PIN13，PIN14，PIN15，PIN16四个引脚上。按键电路原理图，如下图所示。由原理图可知，按键是低电平有效。当按键按下引脚为低电平，释放时会高电平。'''注，按键引脚必须要使能引脚上拉功能，否则可能告成按键识别不可靠。'''
[[文件:Four key sech.png|居中|缩略图|463x463像素|按键外设原理图]]

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中02_key_press工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{

LED_Init(); //LED 初始化
BTN_Init(); //BTN 初始化

for(;;)
{
//循环点亮熄灭LED，间隔500ms
for( uint8_t i = 0; i < BUTTONS_NUMBER ; i++)
{
if(BTN_state_get(i))
{
LED_On(i);
}
else
{
LED_Off(i);
}

}
nrf_delay_ms(100);
}
}
</syntaxhighlight>在LED_Init函数中调用nrf_gpio_range_cfg_output，将初始化NRF52832DK评估板LED引脚。LED将GPIO引脚初始化为输出。BTN_Init函数中调用nrf_gpio_range_cfg_input按键初始化上拉输入。此实验中只是用GPIO输入，所以只能采用轮询的方式，周期性查询按键引脚电平状态。当按键按下，BTN_state_get函数返回true，否则返回false。

为增加互动性，将用4个LED分别指示4个按键状态。按键按下点亮LED,按键释放熄灭LED。其代码实现如while中的for循环。LED_On点亮指定LED，LED_Off熄灭LED。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832的LED是全灭状态。
# 按下SW1，LED1亮；释放SW1，LED1灭
# 按下SW2，LED2亮；释放SW2，LED2灭
# 按下SW3，LED3亮；释放SW3，LED3灭
# 按下SW3，LED4亮；释放SW4，LED4灭

=== 按键中断输入实验（int） ===
02_按键输入实验是采用轮询方式不断查询引脚电平状态。引脚默认为高电平，当按下按键后，引脚会变成低电平。而此实验将使用nRF52832的GPIOTE边沿中断方式来监测按键动作。中断方式监测按键，带来了高灵敏度，高效率，同时也增加了按键按下不可靠性。主要原因按键按下会产生电平抖动。要求高可靠性可以为此要加入消抖。由02的原理图中可以见，没有硬件上的消抖，所以只能在驱动程序上进行消抖操作（此例程中没加入消抖）。

在例子中，使用了RF52832的GPIOTE功能，GPIOTE与GPIO使用上有所区别。但是如果一个引脚使用了GPIOTE功能，GPIO功能将不启作用，引脚上的所有操作将由GPIOTE支配，直到GPIOTE失能。

如果开发者要详细了解GPIOTE可以查看nRF52832的芯片手册《nRF52832_OPS.PDF》。《nRF52832 Objective Product Specification v0.6.3》

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中03_key_press_int工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
GPIOTE_Init();

LED_Init(); //LED 初始化
BTN_Init(); //BTN 初始化

for(;;)
{
//循环，间隔100ms
nrf_delay_ms(100);
}
}
</syntaxhighlight>在例程中使用了GPIOTE功能，所以在main函数开始处就初始化GPIOTE驱动（在使用gpiote相关函数之前，一定要先调用gpiote初始化函数nrf_drv_gpiote_init，否则可能产生不可预知问题）。接着配置LED引脚。在代码中提供两种方式，一种与02实验一至，另一种是gpiote方式。它们通过LED_GPOITE宏进行选择编译。这里主要介绍GPIOTE方式。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :LED_Init
//
// brief : 初始化LED引脚为输出模式，并熄灭LED
//
// param : none
//
// return : none
void LED_Init(void)
{
#if defined(LED_GPIOTE)
uint8_t i = 0;

//配置LED引脚为输出模式
nrf_drv_gpiote_out_config_t out_config = GPIOTE_CONFIG_OUT_SIMPLE(true);

//置LED引脚为高电平，即LED灭
for(i = 0 ; i < LEDS_NUMBER; i++)
{
nrf_drv_gpiote_out_init(Leds[i], &out_config);
}
#else
uint8_t i = 0;

//配置LED引脚为输出模式
nrf_gpio_range_cfg_output(LED_START, LED_STOP);

//置LED引脚为高电平，即LED灭
for(i = 0 ; i < LEDS_NUMBER; i++)
{
nrf_gpio_pin_set(Leds[i]);
}
#endif
}
</syntaxhighlight>nRF52832的GPIOTE只有8个通道，所以每个通道都要进行配置。在LED引脚中，选择简单的输出配置即GPIOTE_CONFIG_OUT_SIMPLE，它是一个宏。是对nrf_drv_gpiote_out_config_t类型成员初始化结构体。其中参数表示引脚配置成GPIOTE时默认引脚状态。

nrf_drv_gpiote_out_init函数将对指定引脚进行GPIOTE_CONFIG_OUT_SIMPLE配置。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :Btn_Init
//
// brief : 初始化Btn引脚为输入，全边沿敏感模式
//
// param : none
//
// return : none
void BTN_Init(void)
{
//创建引脚配置结构
nrf_drv_gpiote_in_config_t btn_config = GPIOTE_CONFIG_IN_SENSE_TOGGLE(true);
btn_config.pull = NRF_GPIO_PIN_PULLUP;
//配置Btn引脚为边沿敏感
for(uint8_t i = 0 ; i < BUTTONS_NUMBER ; i++)
{
nrf_drv_gpiote_in_init(Btns[i], &btn_config, BTN_pin_handler);
nrf_drv_gpiote_in_event_enable(Btns[i], true);
}
}
</syntaxhighlight>BTN_Init函数是对按键的引脚进行TOGGLE sense输入配置。其中GPIOTE_CONFIG_IN_SENSE_TOGGLE也宏，是对nrf_drv_gpiote_in_config_t类型成员初始化结构体。参数true表示使用IN_EVENT配置，而非PORT_EVENT。由于按键外部硬件没有上拉，所以这里要配置成上拉，即pull成员变量设置成NRF_GPIO_PIN_PULLUP。

nrf_drv_gpiote_in_init函数将按键引脚配置成GPIOTE_CONFIG_IN_SENSE_TOGGLE模式，同时要传入中断回调函数。最后要调用nrf_drv_gpiote_in_event_enable函数使能引脚IN_EVENT。

中断方式采集按键，是一种异步方式，所以在回调函数中要进行逻辑上的处理。然而在这个例程中，四个按键使用同一个回调函数。所以要在回调函数中要进行按按键识别，包括按键位置识别，还有按键动作。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :BTN_pin_handler
//
// brief : BTN引脚边沿中断回调函数
//
// param : pin -> 引脚号
// action -> 极性变化形为
//
// return : none
void BTN_pin_handler(nrf_drv_gpiote_pin_t pin, nrf_gpiote_polarity_t action)
{
bool flag = false;
switch(pin)
{
case BUTTON_1:
case BUTTON_2:
case BUTTON_3:
case BUTTON_4:
flag = true;
break;
default:
break;
}
if(flag)
{
uint8_t idx = BTN_Pin_To_Idx(pin);
//读取pin电平状态
if(nrf_drv_gpiote_in_is_set(pin))
{
LED_Off(idx); //按键释放,熄灭LED
}
else
{
LED_On(idx); //按键按下,点亮LED
}
}
}
</syntaxhighlight>其中flag是有效按键动作的标记。只有是BUTTON_1，BUTTON_2，BUTTON_3，BUTTON_4按键才是有效动作。通过nrf_drv_gpiote_in_is_set查询引脚当前电平状态，确定按键是按下，还是释放动作。并根据按键动作，点亮或熄灭LED。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832的LED是全灭状态。
# 按下SW1，LED1亮；释放SW1，LED1灭
# 按下SW2，LED2亮；释放SW2，LED2灭
# 按下SW3，LED3亮；释放SW3，LED3灭
# 按下SW3，LED4亮；释放SW4，LED4灭

=== 振动马达实验 ===
在NRF52832DK评估板上，设计有一路振动马达，方便开发者对蓝牙ANCS开发。其直流马达的工作原理不用多介绍，只要给它提供直流电即可工作。MOTOR端的高低电平，将会另三极管打开与关闭，从而控制振动马达工作。MOTOR是连接在nrf52832的P0.12引脚上。
[[文件:MOTOR.png|居中|缩略图|500x500像素]]

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中04_motor_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
Motor_Init();
LED_Init();

for(;;)
{
//循环点亮熄灭LED，间隔500ms
for( uint8_t i = 0; i < LEDS_NUMBER ; i++)
{
nrf_gpio_pin_toggle(Leds[i]);
nrf_gpio_pin_toggle(BSP_MOTOR_0);
nrf_delay_ms(500);
}
}
}
</syntaxhighlight>main函数与《01_LED亮灭实验》十相似，只是在其基础上添加了MOTOR相关的代码。

Motor_Init函数是对MOTOR引脚进行输出初始化。nrf_gpio_pin_toggle函数是对MOTOR引脚的电平进行翻转，从而输出高低电平，即马达就会振动与关闭。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832的LED便会每500ms依次点亮LED；当四个LED全部点亮后，再以500ms依次熄灭LED，直到全部熄灭。期间，每一次LED状态改变，其马达就会工作一次或关闭一次，间隔时间是500ms。

=== 蜂鸣器实验 ===
在NRF52832DK评估板上，设计有一路有源蜂鸣器，方便开发者对蓝牙ANCS开发。其蜂鸣器的工作原理不用多介绍，只要给它提供直流电即可工作。BUZZER端的高低电平，将会另三极管打开与关闭，从而控制蜂鸣器工作。BUZZER是连接在nrf52832的P0.11引脚上。
[[文件:Beep.png|居中|缩略图|494x494像素]]

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中05_buzzer_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
Buzzer_Init();
LED_Init();

for(;;)
{
//循环点亮熄灭LED，间隔500ms
for( uint8_t i = 0; i < LEDS_NUMBER ; i++)
{
nrf_gpio_pin_toggle(Leds[i]);
nrf_gpio_pin_toggle(BSP_BUZZER_0);
nrf_delay_ms(500);
}
}
}
</syntaxhighlight>main函数与《04_振动马达实验》十相似，只是将MOTOR相关代码替换成了BUZZER代码。

Buzzer_Init函数是对BUZZER引脚进行输出初始化。nrf_gpio_pin_toggle函数是对BUZZER引脚的电平进行翻转，从而输出高低电平，即蜂鸣器就会工作与关闭。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832的LED便会每500ms依次点亮LED；当四个LED全部点亮后，再以500ms依次熄灭LED，直到全部熄灭。期间，每一次LED状态改变，其蜂鸣器就会工作一次或关闭一次，间隔时间是500ms。

=== RGB实险 ===
在NRF52832DK评估板上，提供一个RGB调色灯。方便开发者利用NRF52832开发蓝牙RGB灯。RGB调光灯采用三路PWM分别控制三色灯的亮度达到调色目标。在NRF52832芯片中有三个PWM外设，每个外设有4路PWM。NRF52832的PWM外设细节，可以查阅芯片手册。
[[文件:RGB.png|居中|缩略图|500x500像素]]
从原理图可以看出，每路灯都是由三极管控制，所以控制端高电平表示打开，低电平表示关闭。

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中06_rgb_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
GPIOTE_Init();

LED_Init(); //LED 初始化
BTN_Init(); //BTN 初始化
RGB_PwmInit();

for(;;)
{
//循环，间隔100ms
nrf_delay_ms(100);
}
}
</syntaxhighlight>在main函数中，RGB_PwmInit是初始化PWM函数。在RGB_PwmInit函数中，配置了pwm输出引脚，时钟频率，计数方式等。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :RGB_PwmInit
//
// brief : 初始化RGB pwm模式
//
// param : none
//
// return : none
void RGB_PwmInit(void)
{
nrf_drv_pwm_config_t const rgb_config =
{
.output_pins =
{
RGB_PWM_R , // channel 0
RGB_PWM_G , // channel 1
RGB_PWM_B , // channel 2
NRF_DRV_PWM_PIN_NOT_USED // channel 3
},
.irq_priority = APP_IRQ_PRIORITY_LOWEST,
.base_clock = NRF_PWM_CLK_1MHz,
.count_mode = NRF_PWM_MODE_UP, //向上计数方式
.top_value = NRFX_PWM_DEFAULT_CONFIG_TOP_VALUE,
.load_mode = NRF_PWM_LOAD_WAVE_FORM, //WaveForm加载方式
.step_mode = NRF_PWM_STEP_AUTO
};

nrf_drv_pwm_init(&m_RGB, &rgb_config, rgb_pwm_handler);
nrf_drv_pwm_simple_playback(&m_RGB, &m_rgb_seq, 1,
NRF_DRV_PWM_FLAG_LOOP);
}
</syntaxhighlight>nrf_drv_pwm_config_t 是初始化PWM外设配置结构体。在其中设置的pwm输出引脚，中断优先级，时钟频率，计数方式，计数长度，比较值加载方式等。调用nrf_drv_pwm_init初始化函数，传入事件回调函数rgb_pwm_handler，方便开发者监视相关事件及参数修改。在此例程中，回调数主要用来修改相应PWM通道的比较值，实现PWM的占空比从0%到100%变化。改变通道数是通过按键来修改RGB_OP_CH值。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :rgb_pwm_handler
//
// brief : rgb pwm事件回调函数
//
// param : none
//
// return : none
static void rgb_pwm_handler(nrf_drv_pwm_evt_type_t event_type)
{
if (event_type == NRF_DRV_PWM_EVT_FINISHED)
{
uint16_t *p_channel = NULL;
//获取当前wm通道数值地址
switch(RGB_OP_CH)
{
case PWM_R:
p_channel = &m_rgb_seq_values.channel_0;
break;
case PWM_G:
p_channel = &m_rgb_seq_values.channel_1;
break;
case PWM_B:
p_channel = &m_rgb_seq_values.channel_2;
break;
default:
return;
break;
}
if(value_dir) //控制修改数据方向。
{
//UP
*p_channel += RGB_MIN_STEP;

if(*p_channel >= m_rgb_seq_values.counter_top)
{
*p_channel = m_rgb_seq_values.counter_top;
value_dir = false;
}
}
else
{
//Down
*p_channel -= RGB_MIN_STEP;
if(*p_channel >= m_rgb_seq_values.counter_top)
{
*p_channel = 0;
value_dir = true;
}
}
}
}
</syntaxhighlight>RGB_MIN_STEP是每次变化的步长，这里设置为1。value_dir是控制修改数据的方向，当比较值达到最大值或最小值时就会更改方向，使比较值向相反的方向增加或减小。
==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。会发现评估板的RGB灯会不断的改变颜色。原因是PWMR路的PWM的占空化不断变化所致，如下图PWR所示，而其他二路PWM占空比保持不变。
[[文件:F0001TEK.jpg|居中|缩略图|640x640像素|PWMR]]
按键S1，S2，S3分别控制PWM的R，G，B分量。而S4则会暂停PWM的占空比，直到S1，S2，S3按下。

=== TFT实验(tft_lcd_144，tft_lcd_130) ===
NRF52832DK评估板上，提供一路LCD接口。使用NRF52832的SPI外设。在SPI外设中有两种工作模式，分别为EasyDMA方式，普通DMA模式。使用DMA模式时，开发者要注意。所有使用SPI发送的数据，都必须在RAM中，否则将发生错误。SPI的CPOL与CPHA具体参数及意义，这里将不再详述。详细的细节部分，开发者可以查阅NRF52832的芯片手册。
[[文件:Tft.png|居中|缩略图|383x383像素]]
DIS_BL与DIS_D/C引脚，是TFT屏的控制引脚。DIS_BL是控制背光，DIS_D/C是控制收发数据的属性，是命令数据，还是颜色数据。

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中07_tft_spi_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。

'''LCD驱动部分代码说明，在此不会进行说明。开发者可以查看《谷雨显示接口原理说明》，里面详细介绍了屏幕驱动部分。'''<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
LED_Init(); //LED 初始化

bsp_board_lcd_init();
GUI_Init();
for(uint8_t i = 0;;)
{
GUI_SetBkColor(color[i%3]);
GUI_Clear();
GUI_DispStringAt("SPI lcd Test\r\n",0,0);
LED_Toggle(i++%3);
nrf_delay_ms(500);
}
}
</syntaxhighlight>在main函数中，bsp_board_lcd_init函数用于初始化SPI外设。在此例子中没有使用EasyDMA模式，而使用普通的SPI模式，具本的宏定义配置在SDK_CONFIG.H中。bsp_board_lcd_init函数中，配置SCK，MOSI，SS引脚，时钟频率，及SPI工作模式，字节方向等。NRF_DRV_SPI_DEFAULT_CONFIG是一个宏，定义了nrf_drv_spi_config_t的结构数据。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn : bsp_board_lcd_init
//
// brife : init lcd hardware.ex spi, gpio
//
// param : opt -> 0 OR 1
//
// return : none
void bsp_board_lcd_init(void)
{
nrf_drv_spi_config_t spi_config = NRF_DRV_SPI_DEFAULT_CONFIG;
spi_config.ss_pin = LCD_SPI_SS_PIN;
//spi_config.miso_pin = SPI_MISO_PIN; //NOT USED
spi_config.mosi_pin = LCD_SPI_MOSI_PIN;
spi_config.sck_pin = LCD_SPI_SCK_PIN;
spi_config.frequency = NRF_DRV_SPI_FREQ_8M;

//block mode
nrf_drv_spi_init(&spi, &spi_config, NULL, NULL);

//Config the bl and mode pin to output
nrf_gpio_cfg_output(LCD_BL_PIN);
nrf_gpio_cfg_output(LCD_MODE_PIN);
}
</syntaxhighlight>NRF_DRV_SPI_DEFAULT_CONFIG宏定义内容。<syntaxhighlight lang="c" line="1">
#define NRF_DRV_SPI_DEFAULT_CONFIG \
{ \
.sck_pin = NRF_DRV_SPI_PIN_NOT_USED, \
.mosi_pin = NRF_DRV_SPI_PIN_NOT_USED, \
.miso_pin = NRF_DRV_SPI_PIN_NOT_USED, \
.ss_pin = NRF_DRV_SPI_PIN_NOT_USED, \
.irq_priority = SPI_DEFAULT_CONFIG_IRQ_PRIORITY, \
.orc = 0xFF, \
.frequency = NRF_DRV_SPI_FREQ_4M, \
.mode = NRF_DRV_SPI_MODE_0, \
.bit_order = NRF_DRV_SPI_BIT_ORDER_MSB_FIRST, \
}
</syntaxhighlight>nrf_drv_spi_init函数是正式初始化spi函数。将配置好的config结构转入其中，第三，第四参数是回调函数参数。如果传入回调函数指针，将进行异步数据收发，调用收发函数将立即返回。数据接收完成后，调用回调函数。如果传入NULL，将进行阻塞模式，只有接收完成后，收发函数才会返回。

根据《'''谷雨显示接口原理说明'''》要求，要实现SPI发送函数，背光控制函数，数据命令控制函数等，方便显示屏驱动调用。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn : BSP_LcdBL
//
// brife : set the LCD_BL_PIN pin level
//
// param : opt -> 0 OR 1
//
// return : none
void BSP_LcdBL(uint8_t opt)
{
nrf_gpio_pin_write(LCD_BL_PIN, opt? 1 : 0 );
}
//******************************************************************************
// fn : BSP_LcdCD
//
// brife : set the LCD_MODE_PIN pin level
//
// param : opt -> 0 OR 1
//
// return : none
void BSP_LcdCD(uint8_t opt)
{
nrf_gpio_pin_write(LCD_MODE_PIN, opt? 1 : 0 );
}
//******************************************************************************
// fn : BSP_LcdCs
//
// brife : set the LCD_BL_PIN pin level
//
// param : opt -> 0 OR 1
//
// return : none
void BSP_LcdCs(uint8_t opt)
{
//nrf_gpio_pin_write(SPI_SS_PIN, opt ? 1 : 0);
}

uint8_t BSP_LcdSend(uint8_t data)
{
spi_tmp = data;
nrf_drv_spi_transfer(&spi, &spi_tmp, 1, NULL, 0);

return NRF_SUCCESS;
}

uint8_t BSP_LcdSendMore(uint8_t* buf, uint16_t len)
{
//单次发送最大255个字节，这里做了相应的分包。
uint8_t cnt_max = len >> 7;
uint8_t cnt_rest = len & 0x007F;
uint8_t i = 0;
if(cnt_max)
{
for( ; i < cnt_max ; i++)
{
nrf_drv_spi_transfer(&spi, buf + (i << 7), 128, NULL, 0);
}
}
if(cnt_rest)
{
nrf_drv_spi_transfer(&spi, buf + (i << 7), cnt_rest, NULL, 0);
}
return NRF_SUCCESS;
}
</syntaxhighlight>其中BSP_LcdSendMore函数里，将数据包进行了分包处理，因为nrf_drv_spi_transfer的最大长度为255。实现上述函数后，在lcd_gpio.c文件中进行调用。

上述函数只是，LCD驱动运行前的准备。在调用任务显示函数前，一定要先调用GUI_Init函数，它将初始化LCD驱动相关的结构。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
# TFT-LCD-144或TFT-LCD-130显示屏
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时屏幕上，便会交替显示红，绿，蓝三色，同时第一行显示“SPI lcd Test”字样。

=== UART 收发实验 ===
在NRF52832芯片上有一路UART外设。为此NRF52832DK评估板上，通过CH340C将UART与USB相连。这样开发者可以用PC完成UART通信收发实验。串口外设细节部分，这里不做说明。占用芯片引脚为P0.5，P0.6，P0.7，P0.8。
[[文件:Uart.png|居中|缩略图|587x587像素]]

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中08_uart_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
uint8_t len;
LED_Init(); //LED 初始化
UART_Init(APP_UartEvtHandle); //初始化串口

bsp_board_lcd_init(); //初始化LCD使用的外设，SPI,GPIO
GUI_Init(); //初始化LCD
GUI_DispStringAt("Uart Test\r\n",0,0); //显示字符

//串口打印字符串
UART_Write("Uart Test\r\n",sizeof("Uart Test\r\n")-1);

GUI_SetColor(GUI_BLUE);
for(;;)
{
switch(uart_evt.evt_type)
{
case UART_EVT_RX_TIMEOUT:
len = UART_Read(Buf,uart_evt.status);
UART_Write(Buf,len); //从串口发出
Buf[len] = 0;
GUI_DispString((char const*)Buf);
uart_evt.evt_type = UART_EVT_NONE;
break;
default :
break;
}

if(GUI_IsFull()) //判断是否为满屏
{
GUI_Clear(); //清屏
GUI_GotoXY(0,0); //回到原点
FontColorChange();//改变字体颜色
}
}
}
</syntaxhighlight>其中，UART_Init是初始化串口函数，参数是传入的事件回调函数指针，可以为NULL。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn : UART_Init
//
// brief : 初始化串口
//
// param : pHandle ->处理串口事件
//
// return :
void UART_Init(uart_user_callback pHandle)
{
m_uart_callback = pHandle;

uart_fifo_init();
uart_timer_init();
//baudrate = 115200
nrf_drv_uart_config_t uartConfig = NRF_DRV_UART_DEFAULT_CONFIG;
uartConfig.pseltxd = TX_PIN_NUMBER;
uartConfig.pselrxd = RX_PIN_NUMBER;
//uartConfig.pselcts = CTS_PIN_NUMBER;
//uartConfig.pselrts = RTS_PIN_NUMBER;

nrf_drv_uart_init(&m_Uart,&uartConfig,uart_event_handler);

nrf_drv_uart_rx(&m_Uart, rxBuf,1);
}
</syntaxhighlight>在UART_Init函数中，指定串口的TX，RX引脚，不使能流控制。且格式为115200，8，N，1。在调用nrf_drv_uart_init时，传入事件回调函数指针uart_event_handler，即使用导步模式。如果传入NULL，即使用阻塞模式。在uart_event_handler事件回调函数中，监视以下三个事件
# NRF_DRV_UART_EVT_RX_DONE
# NRF_DRV_UART_EVT_ERROR，
# NRF_DRV_UART_EVT_TX_DONE
NRF_DRV_UART_EVT_RX_DONE是接收完成之后产生的事件；NRF_DRV_UART_EVT_ERROR是串口发生错误时产生的事件，其中包括帧错误，无有效停止位等；NRF_DRV_UART_EVT_TX_DONE是发生完成后产生事件。

为有效控制数据帧之间的间隔，这里引入了定时器，用于监控串口接收空闲。其工作原理如下，当接收到有效数据时，打开定时器，在定时时间之内再次接收到数据时，清除定时器记数，从零重新记时。如果超时，则认为此帧数据已经结束，向上层上报接收超时事件，并携带此帧数据长度。定时器的初始化部分，不是此例程的重点，这里不做详细说明。下面将贴出定时器事件回调函数与串口事件回调函数。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn : timer_uart_event_handler
//
// brief : 定时器事件回调函数
//
// param : event_type -> 事件类型
// p_context -> 事件附加指针
//
// return : none

void timer_uart_event_handler(nrf_timer_event_t event_type, void* p_context)
{
switch (event_type)
{
case NRF_TIMER_EVENT_COMPARE0:
//串口接收超时
{
uart_user_evt.evt_type = UART_EVT_RX_TIMEOUT; //上报超时事件
uart_user_evt.status = UART_BUF_DATA_LEN(&m_RxBuf); //携带数据长度
if(m_uart_callback != NULL)
{
m_uart_callback(&uart_user_evt);
}

}
break;

default:
//Do nothing.
break;
}
}
//串口事件回调数据
static void uart_event_handler(nrf_drv_uart_event_t * p_event, void* p_context)
{
switch (p_event->type)
{
case NRF_DRV_UART_EVT_RX_DONE:
{
//关闭超时定时器
nrf_drv_timer_disable(&m_TimerUart);
//查询空闲字节
if(UART_BUF_FREE_SAPCE_LEN(&m_RxBuf))
{
//
fifo_set(&m_RxBuf,rxBuf);
}

if(UART_BUF_FREE_SAPCE_LEN(&m_RxBuf))
{
nrf_drv_uart_rx(&m_Uart, rxBuf,1);
//启动超时定时器
nrf_drv_timer_enable(&m_TimerUart);
}
else
{
//没有可用空间
uart_user_evt.evt_type = UART_EVT_RX_OVERFLOW;
uart_user_evt.status = UART_BUF_SIZE;
if(m_uart_callback != NULL)
{
m_uart_callback(&uart_user_evt);
}
}
}
break;
case NRF_DRV_UART_EVT_ERROR:

break;
case NRF_DRV_UART_EVT_TX_DONE:
{
uint8_t tmp;
if (uart_data_get(&m_TxBuf,&tmp) == NRF_SUCCESS)
{
nrf_drv_uart_tx(&m_Uart, &tmp, 1);
}
else
{
// Last byte from FIFO transmitted, notify the application.
uart_user_evt.evt_type = UART_EVT_TX_EMPTY;
if(m_uart_callback != NULL)
{
m_uart_callback(&uart_user_evt);
}
}
}
break;
default:
break;
}
}
</syntaxhighlight>在timer_uart_event_handler函数中，主要监视定时器的超时事件，向上层上报串口接收超时事件。在uart_event_handler函数中，完成接收与发送工作。为配合串口收发工作，程序中引入了发送与接收缓存 buf_fifo_t结构。read_pos记录获取数据位置，write_pos记录写入数据位置。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// Name : buf_fifo_t
//
// brief : 串口接收缓存
//
typedef struct
{
uint8_t* pbuf;
volatile uint16_t read_pos;
volatile uint16_t write_pos;
}buf_fifo_t;
</syntaxhighlight>为方便使用，同时实现fifo_get与fifo_set两函数。fifo_get 是从read_pos位置读取数据，并更改read_pos；fifo_set 是将数据写入write_pos位置，并更新write_pos。<syntaxhighlight lang="c">
static __INLINE void fifo_get(buf_fifo_t* pFifo, uint8_t * p_byte)
{
*p_byte = pFifo->pbuf[pFifo->read_pos];

pFifo->read_pos++;
if(pFifo->read_pos >= UART_BUF_SIZE)
{
pFifo->read_pos = 0;
}
}

static __INLINE void fifo_set(buf_fifo_t* pFifo, uint8_t * p_byte)
{
pFifo->pbuf[pFifo->write_pos] = *p_byte;

pFifo->write_pos++;
if(pFifo->write_pos >= UART_BUF_SIZE)
{
pFifo->write_pos = 0;
}
}
</syntaxhighlight>完成串口驱动部分后，在main函数中，只要监视UART_EVT_RX_TIMEOUT与UART_EVT_RX_OVERFLOW事件，并在事件处理结构中，对串口数据进行读取并显示。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
# TFT-LCD-144或TFT-LCD-130显示屏
软件准备：

串口助手或相类似的软件

编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。打开串口助手，选择相应串口号，通信格式为115200，8，N，1。在串口助手中发送数据，此时NRF52832DK上的LCD显示屏会显示发送的数据，同时串口助手本身也会收到发送的数据。

=== 光照度实验 ===
光照度是通过光敏传感器，将光照度转成电信号。在NRF52832DK评估板上，利用光敏元件，将光强度转成电压信号，通过ADC对电压信号进行采集，从而可以测量光照度。其原理图如下图所示。
[[文件:Lux.png|居中|缩略图|313x313像素]]
当光照度增加时，流过Q6的电流变大，从而分得的电压变小；当光照度变小时，流过Q6的电流变小，从而分得的电压变大。所以光照度与电压信号成反比。

NRF52832芯片中8路ADC采集通道。可以配置成单端模式和差分模式。本例程中光敏器件是连接在P0.30引脚上，即ADC通道6。采用单端方式对电压进行采集。

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中09_adc_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
int main(void)
{
LED_Init(); //LED 初始化

bsp_board_lcd_init(); //LCD 实始化
GUI_Init();
GUI_SetBkColor(GUI_BLUE);//设置蓝色背景色
GUI_Clear();
GUI_SetColor(GUI_RED); //设置红色字体
GUI_DispString("ADC Example");
LUX_SaadcInit(); //ADC初始化

for(;;)
{
#if defined(SAADC_BLOCKING)
//发起ADC采集
if(nrf_drv_saadc_sample_convert(NRF_SAADC_INPUT_AIN6,m_buffer_pool) == NRF_SUCCESS)
{
GUI_DisprintfAt(0,32,"ADC:%04d",m_buffer_pool[0]);
}
#else
//发起ADC采集
nrf_drv_saadc_sample();
#endif
LED_Toggle(0); //翻转LED0
nrf_delay_ms(500);
}
}

</syntaxhighlight>main函数中，对LED，ADC，LCD进行初始化与设置。ADC具体的初始化在LUX_SaadcInit函数中，对ADC通道进行配置。main函数for循环中，使用nrf_delay_ms延时函数，周期性地触发ADC采集，同时翻转LED0进行指示。

例子中，采用SAADC_BLOCKING宏定义进行编译区分ADC同步采集和ADC异步采集。完成ADC转换后，将结果通过显示屏显示出。<syntaxhighlight lang="c" line="1">
void LUX_SaadcInit(void)
{

nrf_saadc_channel_config_t channel_config =
NRF_DRV_SAADC_DEFAULT_CHANNEL_CONFIG_SE(NRF_SAADC_INPUT_AIN6);
nrf_drv_saadc_init(NULL, saadc_callback);

nrf_drv_saadc_channel_init(6, &channel_config);

#ifndef SAADC_BLOCKING
nrf_drv_saadc_buffer_convert(m_buffer_pool, SAMPLES_IN_BUFFER);
#endif
}
</syntaxhighlight>LUX_SaadcInit函数中，调用nrf_drv_saadc_init函数初始化ADC，并传入saadc_callback事件回调函数（异步ADC采集使用）。nrf_drv_saadc_channel_init函数对ADC通道6，进行默认配置。其中包括参考源，增益，单端模式，引脚等配置。下面是saadc_callback回调函数的实现，在其中会监视NRF_DRV_SAADC_EVT_DONE事件（ADC采集转转换完成），并将结果显示在屏幕上。此回调函数调用，只在进行ADC异步转换时，才会被调用。<syntaxhighlight lang="c" line="1">
void saadc_callback(nrf_drv_saadc_evt_t const * p_event)
{
if (p_event->type == NRF_DRV_SAADC_EVT_DONE)
{
nrf_drv_saadc_buffer_convert(p_event->data.done.p_buffer, SAMPLES_IN_BUFFER);

}
GUI_DisprintfAt(0,32,"ADC:%04d\r\n",p_event->data.done.p_buffer[0]);
for(uint8_t i = 1 ; i < SAMPLES_IN_BUFFER ; i++)
{
GUI_Disprintf("ADC:%04d\r\n",p_event->data.done.p_buffer[i]);
}
}
</syntaxhighlight>

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
# TFT-LCD-144或TFT-LCD-130显示屏
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832DK上的LCD显示屏会显示光敏器件电压的ADC结果，同时每转换一次，LED0会状态会翻转一次。

=== 温度传感器实验 ===
NRF52832芯片内部，自带一个温度传感器，并有线性补尝。它最大的分辨率为0.25度。本实验利用温度传感测量芯片周围环境的温度。它工作不需要外围电路。

温度测量通过触发TASK_START，当完成测量时DATARDY事件将会产生。通过读取TEMP寄存器，读取当前温度。

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中10_temp_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
int main(void)
{
int32_t volatile temp = INT32_MAX;
LED_Init(); //LED 初始化

bsp_board_lcd_init(); //LCD 实始化
GUI_Init();

UpdateLCD(temp);

for(;;)
{
NRF_TEMP->TASKS_START = 1; //启动温度测量任务
while (NRF_TEMP->EVENTS_DATARDY == 0)
{
// Do nothing.
}
NRF_TEMP->EVENTS_DATARDY = 0;
//读取温度值
temp = (nrf_temp_read() / 4);
NRF_TEMP->TASKS_STOP = 1; //停止测量任务
UpdateLCD(temp);

LED_Toggle(0); //翻转LED0
nrf_delay_ms(500);
}
}

</syntaxhighlight>在main函数前部，对用到的外设进行初始化，包括LED，LCD。在for循环中，启动，停止温度测量。RNF_TEMP->TASKS_START置1，将启动温度测量，NRF_TEMP->EVENTS_DATARDY是测量完成事件，如果DATARDY事件置1，表明温度测量已经完成。nrf_temp_read函数将读取TEMP寄存器返回当前温度值。其值除以4，即丢弃小数部分。

UpdateLCD函数，用于改变屏幕的内部。其输入参数为当前的温度值。在其内部对温度区间进行划分，小于20度属于NORMAL，显示屏会显示绿色背景；在20到27度之间，属于WARN，显示屏会显示黄色；大于27度，属于EMERGENT，显示屏会显示红色。同时也会显示当前温度值。<syntaxhighlight lang="c" line="1">
typedef enum
{
TEMP_DEFAULT,
TEMP_NORMAL,
TEMP_WARN,
TEMP_EMERGENT
}TEMP_RANGE;
</syntaxhighlight><syntaxhighlight lang="c" line="1">
void UpdateLCD(int32_t temp)
{
static TEMP_RANGE LEVEL = TEMP_DEFAULT;
bool isChange = false;
if(temp == INT32_MAX)
{
LEVEL = TEMP_DEFAULT;
isChange = true ;
}
else
{
if(temp < 20)
{
if(LEVEL != TEMP_NORMAL)
{
LEVEL = TEMP_NORMAL;
isChange = true;
}

}
else if(temp < 27)
{
if(LEVEL != TEMP_WARN)
{
LEVEL = TEMP_WARN;
isChange = true;
}
}
else
{
if(LEVEL != TEMP_EMERGENT)
{
LEVEL = TEMP_EMERGENT;
isChange = true;
}
}
}
if(isChange)
{
switch(LEVEL)
{
case TEMP_DEFAULT:
GUI_SetBkColor(GUI_WHITE);//设置蓝色背景色
break;
case TEMP_NORMAL:
GUI_SetBkColor(GUI_GREEN);//设置蓝色背景色
break;
case TEMP_WARN:
GUI_SetBkColor(GUI_YELLOW);//设置绿色背景色
break;
default:
GUI_SetBkColor(GUI_RED);//设置红色背景色
break;
}
GUI_Clear();
GUI_DispString("Temperture\r\nExample");
isChange = false;
}
if(LEVEL)
{
GUI_DisprintfAt(0,32,"Temp:%dC",temp);
}
}
</syntaxhighlight>

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
# TFT-LCD-144或TFT-LCD-130显示屏
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832DK上的LCD显示屏会显示当前的温度值。并根据温度值，显示屏的背景色也会改变。

=== Flash读写操作 ===
一般MCU都有两种类型的存储单元：易失性存储单元和非易失性存储单元。易失性存储单元一般俗称RAM，非易失性存储单元一般俗称ROM。它们的特性这里不做详细说明。本例程中主要描述与操作对象为FLASH，即ROM。在NRF52832芯片中，操作FLASH是通过NVMC控制器进行管理。它们都会被芯片映射到地址空间中，如下图所示。
[[文件:Addr space.png|居中|缩略图|758x758像素]]
NRF52832使用Code区域的低地址空间映射Flash，作为代码区域。除了可以存储CPU执行程序外，也可以用于存储数据常量。NRF52832片上共有512K字节大小的Flash，分为128页，每页大小为4K。每页分为8个块，每块大小512字节。

对Flash进行写数据，要先擦除，然后再写入（必须要字对齐）。

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中11_flash_readwrite_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
int main(void)
{
clock_config(); //初始化时钟

LED_Init(); //LED 初始化
UART_Init(APP_UartEvtHandle); //初始化串口
Flash_info_init();
bsp_board_lcd_init(); //初始化LCD使用的外设，SPI,GPIO
GUI_Init(); //初始化LCD
GUI_DispStringAt("Flash Test\r\n",0,0); //显示字符
GUI_SetColor(GUI_BLUE);
//串口打印字符串
printf("Flash Test\r\n");
Flash_info_out();
printf(CLI_PROMPT_STRINGS);
for(;;)
{
APP_UartPoll();
}
}
</syntaxhighlight>main函数中，对用到的外设和软件模块进行初始化。其中flash_info_out函数获取芯片的flash信息，包括页数，页大小，flash大小，RAM大小等。<syntaxhighlight lang="c" line="1">
static void Flash_info_out(void)
{
uint32_t codesize = NRF_FICR->CODESIZE;
uint32_t codepagesize = NRF_FICR->CODEPAGESIZE;
uint32_t ramsize = NRF_FICR->INFO.RAM;
uint32_t romsize = NRF_FICR->INFO.FLASH;
uint32_t deviceid0 = NRF_FICR->DEVICEID[0];
uint32_t deviceid1 = NRF_FICR->DEVICEID[1];

//打印芯片信息
printf("FLASH INFO:\r\npage num :%d\r\npage size:%d\r\nram size:%dk\r\nflash size:%dk\r\ndevice id0:0x%08X\r\ndevice id1:0x%08X\r\n",
codesize,
codepagesize,
ramsize,
romsize,
deviceid0,
deviceid1
);

GUI_Disprintf("\r\nPNum:%d\r\n",flash_info.page_num);
GUI_Disprintf("PSize:%d\r\n",flash_info.page_size);
GUI_Disprintf("Addr:0x%X\r\n",flash_info.opt_addr);
}
</syntaxhighlight>CLI_PROMPT_STRINGS是命令行提示字符，用于提示命令输入。<syntaxhighlight lang="c">
#define CLI_PROMPT_STRINGS "\r\nNRF_Flash#:"
</syntaxhighlight>所有串口命令处理都在APP_UartPoll函数中。有关串口低层收发处理，此例程中不作说明，开发者可以查看《08_UART收发实验》例程。<syntaxhighlight lang="c" line="1">
static int APP_UartPoll(void)
{
uint8_t len = 0;
switch(uart_evt.evt_type)
{
case UART_EVT_RX_TIMEOUT:
case UART_EVT_RX_OVERFLOW:
//检查是否将会溢出
if((cmd_buf.len + uart_evt.status) > (USER_CMD_MAX_LEN -1))
{
len = UART_BUF_SIZE - 1 - cmd_buf.len;
}
else
{
len = uart_evt.status;
}
//回显
len = UART_Read(cmd_buf.Buf + cmd_buf.len,len);
UART_Write(cmd_buf.Buf + cmd_buf.len,len);
cmd_buf.len += len;
cmd_buf.Buf[cmd_buf.len] = 0;

//进行命令解析
if((cmd_buf.len >= USER_CMD_MAX_LEN) || (strchr((char const*)cmd_buf.Buf,'\r')))
{
printf("\r\n");
if(CLI_Process(cmd_buf.Buf))
{
printf("error\r\n");
}
cmd_buf.len = 0;
printf(CLI_PROMPT_STRINGS);
}

uart_evt.evt_type = UART_EVT_NONE;
break;
default :
break;
}
return len;
}
</syntaxhighlight>串口在收到控制台发来数据后，通过UART_EVT_RX_TIMEOUT事件回调到上层，并将收到数据回显到控制台，以显示开发者输入字符。接下来就是对命令数据进行结束识别。结束条件分为两种：一是最大长度为USER_CMD_MAX_LEN；二是回车换行符。

最终对命令进行解析的是CLI_Process函数。利用strtok库函数对命令数据进行分割，分割字符为空格。所以开发者在命令输入时，要以空格作为分隔。最后将分割的数据与个数传入CMD_ExcuteHandle函数。<syntaxhighlight lang="c" line="1">
CMD_CODE_T CLI_Process(uint8_t* buf)
{
char *pTmp = NULL;
char* argv[10];
size_t count = 0;

if(buf == NULL)
{
//数据内容为空，直接返回
return CMD_BAD_BUF;
}

pTmp = (char*)strchr((char const*)buf,'\r');
if(pTmp)
{
*pTmp = '\0';
}
pTmp = (char*)buf;

//提取指令返回的参数，此时buf已经遭到破坏
while((argv[count] = strtok(pTmp," ")) != NULL)
{
count++;
pTmp = NULL;
if(count >=10)
{
break;
}
}
return CMD_ExcuteHandle(count,argv);

}
</syntaxhighlight>CMD_ExcuteHandle函数会根据输入参数查找命令库。如果查找到将执行命令，否则返回CMD_NOT_FIND。

与命令相关的数据结构如下。<syntaxhighlight lang="c">
typedef void (*cmd_handler)(size_t argc, char **argv);

typedef struct
{
const char* cmd; //cmd
cmd_handler handler; //handler
}cmd_item_t;
</syntaxhighlight>其中cmd是命令名字，handler是命令执行函数。所以开发者，想要实现命令，只要向cmd_item中添加命令名字与处理函数即可，如下。<syntaxhighlight lang="c" line="1">
//增加命令条目
const cmd_item_t cmd_item[] =
{
{STRINGIFY(read),Flash_read_cmd},
{STRINGIFY(write),Flash_write_cmd},
{STRINGIFY(erase),Flash_erase_cmd},
{NULL,NULL}
};
</syntaxhighlight>

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
# TFT-LCD-144或TFT-LCD-130显示屏
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832DK上的LCD显示屏会显地当前操作Flash信息，包括页号，此页大小及所在地址。而此时控制台也会收到相应的信息。
[[文件:Flash uart reset.png|居中|缩略图|547x547像素]]
开发者可以根据命令条目，输入命令进行简单调试。read -> write -> read。
[[文件:Flash readwrite.png|居中|缩略图|720x720像素]]

文件:Flash readwrite.png

2019-07-18T07:06:04Z

Erjin：

debug

文件:Flash uart reset.png

2019-07-18T07:01:25Z

Erjin：

por uart get

2019-07-11T03:46:52Z

Erjin：UART 收发实验

nRF52832是Nordic公司推出一款高性能无线SOC芯片，在芯片上可以运行多种协议栈，包括蓝牙BLE，NFC,ANT,802.15.4G，其中BLE协议栈可以支持到BLE5.0。为此谷雨物联推出一款基于nRF52832芯片评估板，nRF52832DK。

nRF52832DK评估板上设计了丰富实用的外围设备。其中有4路LED，4路按键输入，一路MINI usb转UART，三路PWM RGB灯珠，一路有源蜂鸣器，一路光敏，一路振动马达，TFT显示器接口，NFC标签接口。

=== nRF52832DK基础实验说明列表 ===
方便开发者，更快，更容易上手nRF52832芯片的外设操作，为此我们提供和整理nRF52832DK外围电路实验说明。见下表所示。

{| class="wikitable"
|+
!实验名称
!实验所需外设
!实验简单说明
|-
|01_LED亮灭实验
|GPIO
|熟悉GPIO操作
|-
|02_按键输入实验（poll）
|GPIO
|熟悉GPIO操作
|-
|03_按键输入实验（int）
|GPIO边沿中断
|熟悉GPIO边沿中断
|-
|04_振动马达实验
|GPIO
|熟悉GPIO操作
|-
|05_蜂鸣器实验
|GPIO
|熟悉GPIO操作
|-
|06_RGB实验
|PWM
|熟悉PWM操作
|-
|07_TFT实验(tft_lcd_144，tft_lcd_130)
|SPI
|熟悉SPI操作
|-
|08_UART收发实验
|UART
|熟悉UART操作
|-
|09_光照度实验
|ADC
|熟悉ADC操作
|}

=== LED亮灭实验 ===
LED亮灭实验是展示nRF52832的GPIO输出配置，使开发者更直观的了解GPIO输出。GPIO输出是熟悉一款MCU的开始。下面将简单的介绍并分析相关代码。在NRF52832DK评估板上有4路LED资源，分别处在PIN17，PIN18，PIN19，PIN20四个引脚上。LED电路原理图，如下图所示。其为低电平有效，即引脚为低电平时LED被点亮，引脚为高电平时LED熄灭。
[[文件:FOUR LINES LED.png|居中|缩略图|402x402像素|LED 外设电路]]

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中01_led_blinkly工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{

LED_Init();

for(;;)
{
//循环点亮熄灭LED，间隔500ms
for( uint8_t i = 0; i < LEDS_NUMBER ; i++)
{
nrf_gpio_pin_toggle(Leds[i]);
nrf_delay_ms(500);
}
}
}
</syntaxhighlight>其中LED_Init函数用于初始化LED引脚。将四路LED引脚初始化输出模式，并置高电平，即熄灭LED。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :LED_Init
//
// brief : 初始化LED引脚为输出模式，并熄灭LED
//
// param : none
//
// return : none
void LED_Init(void)
{
uint8_t i = 0;

//配置LED引脚为输出模式
nrf_gpio_range_cfg_output(LED_START, LED_STOP);

//置LED引脚为高电平，即LED灭
for(i = 0 ; i < LEDS_NUMBER; i++)
{
nrf_gpio_pin_set(Leds[i]);
}
}
</syntaxhighlight>LED_START，LED_STOP是两个宏，标记LED开始引脚到LED结束引脚范围。配合nrf_gpio_range_cfg_output函数，可实现批量设置。nrf_gpio_pin_set设置LED引脚输出高电平。

完成LED引脚配置，进入while循环。在循环中遍历所有的LED引脚，翻转引脚高低电平，达到闪烁的目的。nrf_delay_ms函数用于软件延时。nrf_gpio_pin_toggle对引脚电平进行翻转。参数是LED引脚。在nrf_gpio_pin_toggle内部，先读取引脚当前的高低电平状态，然后根据返回的状态进行取反，再设置OUT寄存器。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832的LED便会每500ms依次点亮LED；当四个LED全部点亮后，再以500ms依次熄灭LED，直到全部熄灭。

=== 按键输入实验(poll) ===
01_LED亮灭实验是操作GPIO引脚输出，而本实验是操作GPIO的输入。利用GPIO输入引脚电平变化，来监测按键按下动作。在NRF52832DE评估板上，提供了四路按键资源，分别占用PIN13，PIN14，PIN15，PIN16四个引脚上。按键电路原理图，如下图所示。由原理图可知，按键是低电平有效。当按键按下引脚为低电平，释放时会高电平。'''注，按键引脚必须要使能引脚上拉功能，否则可能告成按键识别不可靠。'''
[[文件:Four key sech.png|居中|缩略图|463x463像素|按键外设原理图]]

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中02_key_press工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{

LED_Init(); //LED 初始化
BTN_Init(); //BTN 初始化

for(;;)
{
//循环点亮熄灭LED，间隔500ms
for( uint8_t i = 0; i < BUTTONS_NUMBER ; i++)
{
if(BTN_state_get(i))
{
LED_On(i);
}
else
{
LED_Off(i);
}

}
nrf_delay_ms(100);
}
}
</syntaxhighlight>在LED_Init函数中调用nrf_gpio_range_cfg_output，将初始化NRF52832DK评估板LED引脚。LED将GPIO引脚初始化为输出。BTN_Init函数中调用nrf_gpio_range_cfg_input按键初始化上拉输入。此实验中只是用GPIO输入，所以只能采用轮询的方式，周期性查询按键引脚电平状态。当按键按下，BTN_state_get函数返回true，否则返回false。

为增加互动性，将用4个LED分别指示4个按键状态。按键按下点亮LED,按键释放熄灭LED。其代码实现如while中的for循环。LED_On点亮指定LED，LED_Off熄灭LED。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832的LED是全灭状态。
# 按下SW1，LED1亮；释放SW1，LED1灭
# 按下SW2，LED2亮；释放SW2，LED2灭
# 按下SW3，LED3亮；释放SW3，LED3灭
# 按下SW3，LED4亮；释放SW4，LED4灭

=== 按键中断输入实验（int） ===
02_按键输入实验是采用轮询方式不断查询引脚电平状态。引脚默认为高电平，当按下按键后，引脚会变成低电平。而此实验将使用nRF52832的GPIOTE边沿中断方式来监测按键动作。中断方式监测按键，带来了高灵敏度，高效率，同时也增加了按键按下不可靠性。主要原因按键按下会产生电平抖动。要求高可靠性可以为此要加入消抖。由02的原理图中可以见，没有硬件上的消抖，所以只能在驱动程序上进行消抖操作（此例程中没加入消抖）。

在例子中，使用了RF52832的GPIOTE功能，GPIOTE与GPIO使用上有所区别。但是如果一个引脚使用了GPIOTE功能，GPIO功能将不启作用，引脚上的所有操作将由GPIOTE支配，直到GPIOTE失能。

如果开发者要详细了解GPIOTE可以查看nRF52832的芯片手册《nRF52832_OPS.PDF》。《nRF52832 Objective Product Specification v0.6.3》

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中03_key_press_int工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
GPIOTE_Init();

LED_Init(); //LED 初始化
BTN_Init(); //BTN 初始化

for(;;)
{
//循环，间隔100ms
nrf_delay_ms(100);
}
}
</syntaxhighlight>在例程中使用了GPIOTE功能，所以在main函数开始处就初始化GPIOTE驱动（在使用gpiote相关函数之前，一定要先调用gpiote初始化函数nrf_drv_gpiote_init，否则可能产生不可预知问题）。接着配置LED引脚。在代码中提供两种方式，一种与02实验一至，另一种是gpiote方式。它们通过LED_GPOITE宏进行选择编译。这里主要介绍GPIOTE方式。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :LED_Init
//
// brief : 初始化LED引脚为输出模式，并熄灭LED
//
// param : none
//
// return : none
void LED_Init(void)
{
#if defined(LED_GPIOTE)
uint8_t i = 0;

//配置LED引脚为输出模式
nrf_drv_gpiote_out_config_t out_config = GPIOTE_CONFIG_OUT_SIMPLE(true);

//置LED引脚为高电平，即LED灭
for(i = 0 ; i < LEDS_NUMBER; i++)
{
nrf_drv_gpiote_out_init(Leds[i], &out_config);
}
#else
uint8_t i = 0;

//配置LED引脚为输出模式
nrf_gpio_range_cfg_output(LED_START, LED_STOP);

//置LED引脚为高电平，即LED灭
for(i = 0 ; i < LEDS_NUMBER; i++)
{
nrf_gpio_pin_set(Leds[i]);
}
#endif
}
</syntaxhighlight>nRF52832的GPIOTE只有8个通道，所以每个通道都要进行配置。在LED引脚中，选择简单的输出配置即GPIOTE_CONFIG_OUT_SIMPLE，它是一个宏。是对nrf_drv_gpiote_out_config_t类型成员初始化结构体。其中参数表示引脚配置成GPIOTE时默认引脚状态。

nrf_drv_gpiote_out_init函数将对指定引脚进行GPIOTE_CONFIG_OUT_SIMPLE配置。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :Btn_Init
//
// brief : 初始化Btn引脚为输入，全边沿敏感模式
//
// param : none
//
// return : none
void BTN_Init(void)
{
//创建引脚配置结构
nrf_drv_gpiote_in_config_t btn_config = GPIOTE_CONFIG_IN_SENSE_TOGGLE(true);
btn_config.pull = NRF_GPIO_PIN_PULLUP;
//配置Btn引脚为边沿敏感
for(uint8_t i = 0 ; i < BUTTONS_NUMBER ; i++)
{
nrf_drv_gpiote_in_init(Btns[i], &btn_config, BTN_pin_handler);
nrf_drv_gpiote_in_event_enable(Btns[i], true);
}
}
</syntaxhighlight>BTN_Init函数是对按键的引脚进行TOGGLE sense输入配置。其中GPIOTE_CONFIG_IN_SENSE_TOGGLE也宏，是对nrf_drv_gpiote_in_config_t类型成员初始化结构体。参数true表示使用IN_EVENT配置，而非PORT_EVENT。由于按键外部硬件没有上拉，所以这里要配置成上拉，即pull成员变量设置成NRF_GPIO_PIN_PULLUP。

nrf_drv_gpiote_in_init函数将按键引脚配置成GPIOTE_CONFIG_IN_SENSE_TOGGLE模式，同时要传入中断回调函数。最后要调用nrf_drv_gpiote_in_event_enable函数使能引脚IN_EVENT。

中断方式采集按键，是一种异步方式，所以在回调函数中要进行逻辑上的处理。然而在这个例程中，四个按键使用同一个回调函数。所以要在回调函数中要进行按按键识别，包括按键位置识别，还有按键动作。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :BTN_pin_handler
//
// brief : BTN引脚边沿中断回调函数
//
// param : pin -> 引脚号
// action -> 极性变化形为
//
// return : none
void BTN_pin_handler(nrf_drv_gpiote_pin_t pin, nrf_gpiote_polarity_t action)
{
bool flag = false;
switch(pin)
{
case BUTTON_1:
case BUTTON_2:
case BUTTON_3:
case BUTTON_4:
flag = true;
break;
default:
break;
}
if(flag)
{
uint8_t idx = BTN_Pin_To_Idx(pin);
//读取pin电平状态
if(nrf_drv_gpiote_in_is_set(pin))
{
LED_Off(idx); //按键释放,熄灭LED
}
else
{
LED_On(idx); //按键按下,点亮LED
}
}
}
</syntaxhighlight>其中flag是有效按键动作的标记。只有是BUTTON_1，BUTTON_2，BUTTON_3，BUTTON_4按键才是有效动作。通过nrf_drv_gpiote_in_is_set查询引脚当前电平状态，确定按键是按下，还是释放动作。并根据按键动作，点亮或熄灭LED。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832的LED是全灭状态。
# 按下SW1，LED1亮；释放SW1，LED1灭
# 按下SW2，LED2亮；释放SW2，LED2灭
# 按下SW3，LED3亮；释放SW3，LED3灭
# 按下SW3，LED4亮；释放SW4，LED4灭

=== 振动马达实验 ===
在NRF52832DK评估板上，设计有一路振动马达，方便开发者对蓝牙ANCS开发。其直流马达的工作原理不用多介绍，只要给它提供直流电即可工作。MOTOR端的高低电平，将会另三极管打开与关闭，从而控制振动马达工作。MOTOR是连接在nrf52832的P0.12引脚上。
[[文件:MOTOR.png|居中|缩略图|500x500像素]]

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中04_motor_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
Motor_Init();
LED_Init();

for(;;)
{
//循环点亮熄灭LED，间隔500ms
for( uint8_t i = 0; i < LEDS_NUMBER ; i++)
{
nrf_gpio_pin_toggle(Leds[i]);
nrf_gpio_pin_toggle(BSP_MOTOR_0);
nrf_delay_ms(500);
}
}
}
</syntaxhighlight>main函数与《01_LED亮灭实验》十相似，只是在其基础上添加了MOTOR相关的代码。

Motor_Init函数是对MOTOR引脚进行输出初始化。nrf_gpio_pin_toggle函数是对MOTOR引脚的电平进行翻转，从而输出高低电平，即马达就会振动与关闭。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832的LED便会每500ms依次点亮LED；当四个LED全部点亮后，再以500ms依次熄灭LED，直到全部熄灭。期间，每一次LED状态改变，其马达就会工作一次或关闭一次，间隔时间是500ms。

=== 蜂鸣器实验 ===
在NRF52832DK评估板上，设计有一路有源蜂鸣器，方便开发者对蓝牙ANCS开发。其蜂鸣器的工作原理不用多介绍，只要给它提供直流电即可工作。BUZZER端的高低电平，将会另三极管打开与关闭，从而控制蜂鸣器工作。BUZZER是连接在nrf52832的P0.11引脚上。
[[文件:Beep.png|居中|缩略图|494x494像素]]

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中05_buzzer_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
Buzzer_Init();
LED_Init();

for(;;)
{
//循环点亮熄灭LED，间隔500ms
for( uint8_t i = 0; i < LEDS_NUMBER ; i++)
{
nrf_gpio_pin_toggle(Leds[i]);
nrf_gpio_pin_toggle(BSP_BUZZER_0);
nrf_delay_ms(500);
}
}
}
</syntaxhighlight>main函数与《04_振动马达实验》十相似，只是将MOTOR相关代码替换成了BUZZER代码。

Buzzer_Init函数是对BUZZER引脚进行输出初始化。nrf_gpio_pin_toggle函数是对BUZZER引脚的电平进行翻转，从而输出高低电平，即蜂鸣器就会工作与关闭。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时NRF52832的LED便会每500ms依次点亮LED；当四个LED全部点亮后，再以500ms依次熄灭LED，直到全部熄灭。期间，每一次LED状态改变，其蜂鸣器就会工作一次或关闭一次，间隔时间是500ms。

=== RGB实险 ===
在NRF52832DK评估板上，提供一个RGB调色灯。方便开发者利用NRF52832开发蓝牙RGB灯。RGB调光灯采用三路PWM分别控制三色灯的亮度达到调色目标。在NRF52832芯片中有三个PWM外设，每个外设有4路PWM。NRF52832的PWM外设细节，可以查阅芯片手册。
[[文件:RGB.png|居中|缩略图|500x500像素]]
从原理图可以看出，每路灯都是由三极管控制，所以控制端高电平表示打开，低电平表示关闭。

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中06_rgb_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
GPIOTE_Init();

LED_Init(); //LED 初始化
BTN_Init(); //BTN 初始化
RGB_PwmInit();

for(;;)
{
//循环，间隔100ms
nrf_delay_ms(100);
}
}
</syntaxhighlight>在main函数中，RGB_PwmInit是初始化PWM函数。在RGB_PwmInit函数中，配置了pwm输出引脚，时钟频率，计数方式等。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :RGB_PwmInit
//
// brief : 初始化RGB pwm模式
//
// param : none
//
// return : none
void RGB_PwmInit(void)
{
nrf_drv_pwm_config_t const rgb_config =
{
.output_pins =
{
RGB_PWM_R , // channel 0
RGB_PWM_G , // channel 1
RGB_PWM_B , // channel 2
NRF_DRV_PWM_PIN_NOT_USED // channel 3
},
.irq_priority = APP_IRQ_PRIORITY_LOWEST,
.base_clock = NRF_PWM_CLK_1MHz,
.count_mode = NRF_PWM_MODE_UP, //向上计数方式
.top_value = NRFX_PWM_DEFAULT_CONFIG_TOP_VALUE,
.load_mode = NRF_PWM_LOAD_WAVE_FORM, //WaveForm加载方式
.step_mode = NRF_PWM_STEP_AUTO
};

nrf_drv_pwm_init(&m_RGB, &rgb_config, rgb_pwm_handler);
nrf_drv_pwm_simple_playback(&m_RGB, &m_rgb_seq, 1,
NRF_DRV_PWM_FLAG_LOOP);
}
</syntaxhighlight>nrf_drv_pwm_config_t 是初始化PWM外设配置结构体。在其中设置的pwm输出引脚，中断优先级，时钟频率，计数方式，计数长度，比较值加载方式等。调用nrf_drv_pwm_init初始化函数，传入事件回调函数rgb_pwm_handler，方便开发者监视相关事件及参数修改。在此例程中，回调数主要用来修改相应PWM通道的比较值，实现PWM的占空比从0%到100%变化。改变通道数是通过按键来修改RGB_OP_CH值。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :rgb_pwm_handler
//
// brief : rgb pwm事件回调函数
//
// param : none
//
// return : none
static void rgb_pwm_handler(nrf_drv_pwm_evt_type_t event_type)
{
if (event_type == NRF_DRV_PWM_EVT_FINISHED)
{
uint16_t *p_channel = NULL;
//获取当前wm通道数值地址
switch(RGB_OP_CH)
{
case PWM_R:
p_channel = &m_rgb_seq_values.channel_0;
break;
case PWM_G:
p_channel = &m_rgb_seq_values.channel_1;
break;
case PWM_B:
p_channel = &m_rgb_seq_values.channel_2;
break;
default:
return;
break;
}
if(value_dir) //控制修改数据方向。
{
//UP
*p_channel += RGB_MIN_STEP;

if(*p_channel >= m_rgb_seq_values.counter_top)
{
*p_channel = m_rgb_seq_values.counter_top;
value_dir = false;
}
}
else
{
//Down
*p_channel -= RGB_MIN_STEP;
if(*p_channel >= m_rgb_seq_values.counter_top)
{
*p_channel = 0;
value_dir = true;
}
}
}
}
</syntaxhighlight>RGB_MIN_STEP是每次变化的步长，这里设置为1。value_dir是控制修改数据的方向，当比较值达到最大值或最小值时就会更改方向，使比较值向相反的方向增加或减小。
==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。会发现评估板的RGB灯会不断的改变颜色。原因是PWMR路的PWM的占空化不断变化所致，如下图PWR所示，而其他二路PWM占空比保持不变。
[[文件:F0001TEK.jpg|居中|缩略图|640x640像素|PWMR]]
按键S1，S2，S3分别控制PWM的R，G，B分量。而S4则会暂停PWM的占空比，直到S1，S2，S3按下。

=== TFT实验(tft_lcd_144，tft_lcd_130) ===
NRF52832DK评估板上，提供一路LCD接口。使用NRF52832的SPI外设。在SPI外设中有两种工作模式，分别为EasyDMA方式，普通DMA模式。使用DMA模式时，开发者要注意。所有使用SPI发送的数据，都必须在RAM中，否则将发生错误。SPI的CPOL与CPHA具体参数及意义，这里将不再详述。详细的细节部分，开发者可以查阅NRF52832的芯片手册。
[[文件:Tft.png|居中|缩略图|383x383像素]]
DIS_BL与DIS_D/C引脚，是TFT屏的控制引脚。DIS_BL是控制背光，DIS_D/C是控制收发数据的属性，是命令数据，还是颜色数据。

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中07_tft_spi_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。

'''LCD驱动部分代码说明，在此不会进行说明。开发者可以查看《谷雨显示接口原理说明》，里面详细介绍了屏幕驱动部分。'''<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
LED_Init(); //LED 初始化

bsp_board_lcd_init();
GUI_Init();
for(uint8_t i = 0;;)
{
GUI_SetBkColor(color[i%3]);
GUI_Clear();
GUI_DispStringAt("SPI lcd Test\r\n",0,0);
LED_Toggle(i++%3);
nrf_delay_ms(500);
}
}
</syntaxhighlight>在main函数中，bsp_board_lcd_init函数用于初始化SPI外设。在此例子中没有使用EasyDMA模式，而使用普通的SPI模式，具本的宏定义配置在SDK_CONFIG.H中。bsp_board_lcd_init函数中，配置SCK，MOSI，SS引脚，时钟频率，及SPI工作模式，字节方向等。NRF_DRV_SPI_DEFAULT_CONFIG是一个宏，定义了nrf_drv_spi_config_t的结构数据。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn : bsp_board_lcd_init
//
// brife : init lcd hardware.ex spi, gpio
//
// param : opt -> 0 OR 1
//
// return : none
void bsp_board_lcd_init(void)
{
nrf_drv_spi_config_t spi_config = NRF_DRV_SPI_DEFAULT_CONFIG;
spi_config.ss_pin = LCD_SPI_SS_PIN;
//spi_config.miso_pin = SPI_MISO_PIN; //NOT USED
spi_config.mosi_pin = LCD_SPI_MOSI_PIN;
spi_config.sck_pin = LCD_SPI_SCK_PIN;
spi_config.frequency = NRF_DRV_SPI_FREQ_8M;

//block mode
nrf_drv_spi_init(&spi, &spi_config, NULL, NULL);

//Config the bl and mode pin to output
nrf_gpio_cfg_output(LCD_BL_PIN);
nrf_gpio_cfg_output(LCD_MODE_PIN);
}
</syntaxhighlight>NRF_DRV_SPI_DEFAULT_CONFIG宏定义内容。<syntaxhighlight lang="c" line="1">
#define NRF_DRV_SPI_DEFAULT_CONFIG \
{ \
.sck_pin = NRF_DRV_SPI_PIN_NOT_USED, \
.mosi_pin = NRF_DRV_SPI_PIN_NOT_USED, \
.miso_pin = NRF_DRV_SPI_PIN_NOT_USED, \
.ss_pin = NRF_DRV_SPI_PIN_NOT_USED, \
.irq_priority = SPI_DEFAULT_CONFIG_IRQ_PRIORITY, \
.orc = 0xFF, \
.frequency = NRF_DRV_SPI_FREQ_4M, \
.mode = NRF_DRV_SPI_MODE_0, \
.bit_order = NRF_DRV_SPI_BIT_ORDER_MSB_FIRST, \
}
</syntaxhighlight>nrf_drv_spi_init函数是正式初始化spi函数。将配置好的config结构转入其中，第三，第四参数是回调函数参数。如果传入回调函数指针，将进行异步数据收发，调用收发函数将立即返回。数据接收完成后，调用回调函数。如果传入NULL，将进行阻塞模式，只有接收完成后，收发函数才会返回。

根据《'''谷雨显示接口原理说明'''》要求，要实现SPI发送函数，背光控制函数，数据命令控制函数等，方便显示屏驱动调用。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn : BSP_LcdBL
//
// brife : set the LCD_BL_PIN pin level
//
// param : opt -> 0 OR 1
//
// return : none
void BSP_LcdBL(uint8_t opt)
{
nrf_gpio_pin_write(LCD_BL_PIN, opt? 1 : 0 );
}
//******************************************************************************
// fn : BSP_LcdCD
//
// brife : set the LCD_MODE_PIN pin level
//
// param : opt -> 0 OR 1
//
// return : none
void BSP_LcdCD(uint8_t opt)
{
nrf_gpio_pin_write(LCD_MODE_PIN, opt? 1 : 0 );
}
//******************************************************************************
// fn : BSP_LcdCs
//
// brife : set the LCD_BL_PIN pin level
//
// param : opt -> 0 OR 1
//
// return : none
void BSP_LcdCs(uint8_t opt)
{
//nrf_gpio_pin_write(SPI_SS_PIN, opt ? 1 : 0);
}

uint8_t BSP_LcdSend(uint8_t data)
{
spi_tmp = data;
nrf_drv_spi_transfer(&spi, &spi_tmp, 1, NULL, 0);

return NRF_SUCCESS;
}

uint8_t BSP_LcdSendMore(uint8_t* buf, uint16_t len)
{
//单次发送最大255个字节，这里做了相应的分包。
uint8_t cnt_max = len >> 7;
uint8_t cnt_rest = len & 0x007F;
uint8_t i = 0;
if(cnt_max)
{
for( ; i < cnt_max ; i++)
{
nrf_drv_spi_transfer(&spi, buf + (i << 7), 128, NULL, 0);
}
}
if(cnt_rest)
{
nrf_drv_spi_transfer(&spi, buf + (i << 7), cnt_rest, NULL, 0);
}
return NRF_SUCCESS;
}
</syntaxhighlight>其中BSP_LcdSendMore函数里，将数据包进行了分包处理，因为nrf_drv_spi_transfer的最大长度为255。实现上述函数后，在lcd_gpio.c文件中进行调用。

上述函数只是，LCD驱动运行前的准备。在调用任务显示函数前，一定要先调用GUI_Init函数，它将初始化LCD驱动相关的结构。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
# TFT-LCD-144或TFT-LCD-130显示屏
编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。此时屏幕上，便会交替显示红，绿，蓝三色，同时第一行显示“SPI lcd Test”字样。

=== UART 收发实验 ===
在NRF52832芯片上有一路UART外设。为此NRF52832DK评估板上，通过CH340C将UART与USB相连。这样开发者可以用PC完成UART通信收发实验。串口外设细节部分，这里不做说明。占用芯片引脚为P0.5，P0.6，P0.7，P0.8。
[[文件:Uart.png|居中|缩略图|587x587像素]]

==== 代码分析 ====
开发者打开谷雨物联提供的peripheral_ghostyu文件夹中08_uart_example工程（IAR工程）。

在IAR的Workspace中点开Application，双击main.c文件，打开main.c。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn :main
//
// brief : 主程序入口
//
// param : none
//
// return : none
int main(void)
{
uint8_t len;
LED_Init(); //LED 初始化
UART_Init(APP_UartEvtHandle); //初始化串口

bsp_board_lcd_init(); //初始化LCD使用的外设，SPI,GPIO
GUI_Init(); //初始化LCD
GUI_DispStringAt("Uart Test\r\n",0,0); //显示字符

//串口打印字符串
UART_Write("Uart Test\r\n",sizeof("Uart Test\r\n")-1);

GUI_SetColor(GUI_BLUE);
for(;;)
{
switch(uart_evt.evt_type)
{
case UART_EVT_RX_TIMEOUT:
len = UART_Read(Buf,uart_evt.status);
UART_Write(Buf,len); //从串口发出
Buf[len] = 0;
GUI_DispString((char const*)Buf);
uart_evt.evt_type = UART_EVT_NONE;
break;
default :
break;
}

if(GUI_IsFull()) //判断是否为满屏
{
GUI_Clear(); //清屏
GUI_GotoXY(0,0); //回到原点
FontColorChange();//改变字体颜色
}
}
}
</syntaxhighlight>其中，UART_Init是初始化串口函数，参数是传入的事件回调函数指针，可以为NULL。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn : UART_Init
//
// brief : 初始化串口
//
// param : pHandle ->处理串口事件
//
// return :
void UART_Init(uart_user_callback pHandle)
{
m_uart_callback = pHandle;

uart_fifo_init();
uart_timer_init();
//baudrate = 115200
nrf_drv_uart_config_t uartConfig = NRF_DRV_UART_DEFAULT_CONFIG;
uartConfig.pseltxd = TX_PIN_NUMBER;
uartConfig.pselrxd = RX_PIN_NUMBER;
//uartConfig.pselcts = CTS_PIN_NUMBER;
//uartConfig.pselrts = RTS_PIN_NUMBER;

nrf_drv_uart_init(&m_Uart,&uartConfig,uart_event_handler);

nrf_drv_uart_rx(&m_Uart, rxBuf,1);
}
</syntaxhighlight>在UART_Init函数中，指定串口的TX，RX引脚，不使能流控制。且格式为115200，8，N，1。在调用nrf_drv_uart_init时，传入事件回调函数指针uart_event_handler，即使用导步模式。如果传入NULL，即使用阻塞模式。在uart_event_handler事件回调函数中，监视以下三个事件
# NRF_DRV_UART_EVT_RX_DONE
# NRF_DRV_UART_EVT_ERROR，
# NRF_DRV_UART_EVT_TX_DONE
NRF_DRV_UART_EVT_RX_DONE是接收完成之后产生的事件；NRF_DRV_UART_EVT_ERROR是串口发生错误时产生的事件，其中包括帧错误，无有效停止位等；NRF_DRV_UART_EVT_TX_DONE是发生完成后产生事件。

为有效控制数据帧之间的间隔，这里引入了定时器，用于监控串口接收空闲。其工作原理如下，当接收到有效数据时，打开定时器，在定时时间之内再次接收到数据时，清除定时器记数，从零重新记时。如果超时，则认为此帧数据已经结束，向上层上报接收超时事件，并携带此帧数据长度。定时器的初始化部分，不是此例程的重点，这里不做详细说明。下面将贴出定时器事件回调函数与串口事件回调函数。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// fn : timer_uart_event_handler
//
// brief : 定时器事件回调函数
//
// param : event_type -> 事件类型
// p_context -> 事件附加指针
//
// return : none

void timer_uart_event_handler(nrf_timer_event_t event_type, void* p_context)
{
switch (event_type)
{
case NRF_TIMER_EVENT_COMPARE0:
//串口接收超时
{
uart_user_evt.evt_type = UART_EVT_RX_TIMEOUT; //上报超时事件
uart_user_evt.status = UART_BUF_DATA_LEN(&m_RxBuf); //携带数据长度
if(m_uart_callback != NULL)
{
m_uart_callback(&uart_user_evt);
}

}
break;

default:
//Do nothing.
break;
}
}
//串口事件回调数据
static void uart_event_handler(nrf_drv_uart_event_t * p_event, void* p_context)
{
switch (p_event->type)
{
case NRF_DRV_UART_EVT_RX_DONE:
{
//关闭超时定时器
nrf_drv_timer_disable(&m_TimerUart);
//查询空闲字节
if(UART_BUF_FREE_SAPCE_LEN(&m_RxBuf))
{
//
fifo_set(&m_RxBuf,rxBuf);
}

if(UART_BUF_FREE_SAPCE_LEN(&m_RxBuf))
{
nrf_drv_uart_rx(&m_Uart, rxBuf,1);
//启动超时定时器
nrf_drv_timer_enable(&m_TimerUart);
}
else
{
//没有可用空间
uart_user_evt.evt_type = UART_EVT_RX_OVERFLOW;
uart_user_evt.status = UART_BUF_SIZE;
if(m_uart_callback != NULL)
{
m_uart_callback(&uart_user_evt);
}
}
}
break;
case NRF_DRV_UART_EVT_ERROR:

break;
case NRF_DRV_UART_EVT_TX_DONE:
{
uint8_t tmp;
if (uart_data_get(&m_TxBuf,&tmp) == NRF_SUCCESS)
{
nrf_drv_uart_tx(&m_Uart, &tmp, 1);
}
else
{
// Last byte from FIFO transmitted, notify the application.
uart_user_evt.evt_type = UART_EVT_TX_EMPTY;
if(m_uart_callback != NULL)
{
m_uart_callback(&uart_user_evt);
}
}
}
break;
default:
break;
}
}
</syntaxhighlight>在timer_uart_event_handler函数中，主要监视定时器的超时事件，向上层上报串口接收超时事件。在uart_event_handler函数中，完成接收与发送工作。为配合串口收发工作，程序中引入了发送与接收缓存 buf_fifo_t结构。read_pos记录获取数据位置，write_pos记录写入数据位置。<syntaxhighlight lang="c" line="1">
//******************************************************************************
// Name : buf_fifo_t
//
// brief : 串口接收缓存
//
typedef struct
{
uint8_t* pbuf;
volatile uint16_t read_pos;
volatile uint16_t write_pos;
}buf_fifo_t;
</syntaxhighlight>为方便使用，同时实现fifo_get与fifo_set两函数。fifo_get 是从read_pos位置读取数据，并更改read_pos；fifo_set 是将数据写入write_pos位置，并更新write_pos。<syntaxhighlight lang="c">
static __INLINE void fifo_get(buf_fifo_t* pFifo, uint8_t * p_byte)
{
*p_byte = pFifo->pbuf[pFifo->read_pos];

pFifo->read_pos++;
if(pFifo->read_pos >= UART_BUF_SIZE)
{
pFifo->read_pos = 0;
}
}

static __INLINE void fifo_set(buf_fifo_t* pFifo, uint8_t * p_byte)
{
pFifo->pbuf[pFifo->write_pos] = *p_byte;

pFifo->write_pos++;
if(pFifo->write_pos >= UART_BUF_SIZE)
{
pFifo->write_pos = 0;
}
}
</syntaxhighlight>完成串口驱动部分后，在main函数中，只要监视UART_EVT_RX_TIMEOUT与UART_EVT_RX_OVERFLOW事件，并在事件处理结构中，对串口数据进行读取并显示。

==== 实验现象 ====
硬件准备：
# Jlink-Lite仿真器或J-Link仿真器
# NRF52832DK评估板
# TFT-LCD-144或TFT-LCD-130显示屏
软件准备：

串口助手或相类似的软件

编译工程，点击IAR IDE工具栏中绿色三角仿真按钮，IAR便会将程序下载到nRF52832中，点击全速运行即可。打开串口助手，选择相应串口号，通信格式为115200，8，N，1。在串口助手中发送数据，此时NRF52832DK上的LCD显示屏会显示发送的数据，同时串口助手本身也会收到发送的数据。

文件:Uart.png

2019-07-11T01:10:34Z

Erjin：

uart scheme