SignalLed

信号灯LED

1、介绍

在我们的日常开发中，led虽小，但却起着不可忽视的作用。我们总是用小灯的闪烁来表示一个事件的发生或停止。单个小灯的闪烁直接调用设置高低电平的函数会非常方便，然而，当你有多个led闪烁事件的时候，一个个的循环，一个个的delay可能就让你非常烦躁了。
这个时候，快来试试这款简单的小工具吧，抛开所有的循环和延时，解放你的双手，只需几个设置，便可轻松实现各种不同的信号闪烁！

2、获取方式

使用SignalLed软件包需要在RT-Thread的包管理中选中它，具体路径如下：

RT-Thread online packages
    miscellaneous packages --->
        [*] signal_led: a signal_led package for rt-thread

3、使用方式

1. 首先申请一个信号灯结构

   led led_0;
   

2. 定义信号灯的开关函数

   void rSwitch_on(void)
   {
   rt_pin_write(LEDR_PIN, PIN_LOW);
   }
   
   void rSwitch_off(void)
   {
   rt_pin_write(LEDR_PIN, PIN_HIGH);
   }
   

3. 设置闪烁模式（字符串形式，以亮、灭、亮、灭……的顺序，依次写入持续时间，单位：ms）

   char* rLedMode="300,300,300,300,300,2000,";//必须以英文逗号结尾
   

   注意：时间参数必须以英文逗号间隔开，并且整个字符串必须以英文逗号结尾！

4. 初始化信号灯并绑定信号灯开关函数

   led_init(&led_0,LEDR_PIN,rSwitch_on,rSwitch_off);
   

5. 设置信号灯工作模式（循环多少次、闪烁方式）

   led_set_mode(&led_0,5,rLedMode);
   

6. 开启信号灯

   led_start(&led_0);
   

7. 创建一个信号灯线程循环调用信号灯心跳函数

   while (1)
   {
   led_ticks();
   rt_thread_mdelay(LED_TICK_TIME);
   }
   

   注意：LED_TICK_TIME 为 signal_led.h 中的宏，默认值为50，单位为ms。信号灯内核依赖该宏，不可删除，该宏作为信号灯闪烁计时的时基，因此信号灯处于亮或灭状态的时间一定大于该宏所定义的时间，即若该宏定义为50，则信号灯最快50毫秒变化一次状态，用户可根据自己工程的需求改变该值得大小。

   4、使用案例

   #include "drv_gpio.h"
   #include "signal_led.h"
   
   #define LEDR_PIN    GET_PIN(E, 7)
   led led_0;
   
   void rSwitch_on(void)
   {
   rt_pin_write(LEDR_PIN, PIN_LOW);
   }
   
   void rSwitch_off(void)
   {
   rt_pin_write(LEDR_PIN, PIN_HIGH);
   }
   
   char* rLedMode="300,300,300,300,300,2000,";//必须以英文逗号结尾
   
   int main(void)
   {
   led_init(&led_0,LEDR_PIN,rSwitch_on,rSwitch_off);
   led_set_mode(&led_0,5,rLedMode);
   led_start(&led_0);
   
   while (1)
   {
       led_ticks();
       rt_thread_mdelay(LED_TICK_TIME);
   }
   }
   
   

5、联系方式&感谢

• 作者：WKJay
• 主页：https://github.com/WKJay/SignalLed
• email: 1931048074@qq.com
• 如有意见或者建议请与作者取得联系，该说明文档会不定期更新。