Stduino 库开发

描述

通过Stduino IDE进行库快速封装及共享,从而提高大家的开发效率。

话不多说,Let’s Go!

下面我以快速点亮一颗LED灯为例。

C语言模式

步骤一,打开Stduino IDE 单击“库开发”按钮

步骤二,如图所示,单击新建库进行选择库开发语言

步骤三,选择C,并根据弹出框进行命名,本次命名为LED_C 点击确认后将自动为您建立四个文件
分别是:.c文件、.h头文件、关键词、示例文件

步骤四,首先来编辑LED_C.c,该文件主要是放功能实现的代码

#include "Arduino.h"
#include "LED_C.h"

void led_init(int pin)
{
    pinMode(pin,OUTPUT);
}
void led_on(int pin)
{
    digitalWrite(pin,HIGH);
}
void led_off(int pin)
{
    digitalWrite(pin,LOW);
}

其次编辑LED_C.h,该文件包含了 C 函数声明和宏定义,被多个源文件中引用共享。

#ifndef __LED_C_H
#define __LED_C_H
#ifdef __cplusplus
extern "C" {
#endif
/*上面不用动,开始你的表演 --------------------------------------------------------------*/

void led_init(int pin);
void led_on(int pin);
void led_off(int pin);

/*下面不用动,表演结束------------------------------------------------------------------*/

#ifdef __cplusplus
}
#endif

#endif

再者是keywords.txt文件,本文件是实现关键词高亮及自动提示的功能,一行一词,请勿输入汉字
//One keyword per line, delete the line after completion 输入完关键词,删除这句

led_init
led_on
led_off

最后是LED_C_example.ino 示例文件的编辑

#include "Arduino.h"
#include "LED_C.h"
void setup()
{
   led_init(13);
}
void loop()
{
    led_on(13);
    delay(1000);
    led_off(13);
    delay(1000);
}

好了基于C语言的Stduino 快速点亮一颗LED灯库就制作好了,So easy!

C++模式

步骤一,打开Stduino IDE 单击“库开发”按钮

步骤二,如图所示,单击新建库进行选择库开发语言

步骤三,选择C++,并根据弹出框进行命名,本次命名为LED_CPP 点击确认后将自动为您建立四个文件
分别是:.cpp文件、.h头文件、关键词、示例文件

步骤四,首先来编辑LED_CPP.cpp,该文件主要是放功能实现的代码

/*****************
LED_CPP.cpp

******************/
#include "Arduino.h"
#include"LED_CPP.h"



LED::LED(int pin,bool state)
{
    pinMode(pin,OUTPUT);
    digitalWrite(pin,state);
}

LED::~LED()
{
    disattach();
}


void LED::on()
{
    digitalWrite(pin,HIGH);
}

void LED::off()
{
    digitalWrite(pin,LOW);
}


void LED::disattach()        //引脚回收,恢复到上电状态
{
    digitalWrite(pin,LOW);
    pinMode(pin,INPUT);
}

其次编辑LED_CPP.h,该文件包含了 C 函数声明和宏定义,被多个源文件中引用共享。

#ifndef  __LED_CPP_H//例如:__STM32F10x_ABC_H
#define  __LED_CPP_H//例如:__STM32F10x_ABC_H
/*上面不用动,开始你的表演 ---------------------------------*/




class LED
{
private:
    int pin;        //控制led使用的引脚


public:

    LED(int pin, bool state=LOW );    //构造函数,初始化引脚输出为低电平

    ~LED();          //析构函数,执行后释放内存


    void on();      //打开LED

    void off();     //关闭LED

    void disattach(); //释放引脚与LED的绑定,使得引脚可以控制其他的东西

};

/*下面不用动,表演结束--------------------------------------------*/
#endif

再者是keywords.txt文件,本文件是实现关键词高亮及自动提示的功能,一行一词,请勿输入汉字
//One keyword per line, delete the line after completion 输入完关键词,删除这句

LED
disattach
on
off

最后是LED_CPP_example.ino示例文件的编辑

#include <Arduino.h>
#include "LED_CPP.h"
LED led(13);//对象实例化,务必在setup之前进行哈
int count =0;

void setup() {
}

void loop() {
    if(count<10)   {
        led.on();
        delay(300);
        led.off();
        delay(300);
        ++count;
        if(count==10)
            led.disattach();
    }
}

好了,基于C++语言的Stduino 快速点亮一颗LED灯库就制作好了,So easy!

Stduino 库分享

为方便后续库的维护,我们基于gitee、github 进行库共享(国内最好用gitee,速度快),大家首先需要注册拥有相关账号后才能继续下一步操作
首先请按照下面这个目录结构上传至git(gitee或github)平台

上传后效果为

具体可参考:https://gitee.com/stduino/lcd12864

后打开api.stduino.com 网站,单击库分享,通过QQ授权后进入分享后台,验证下邮箱即可分享了

邮箱验证后的界面,按照提示进行填写相关信息就可以分享了,此后可以在右侧进行库管理

Stduino库查询

大家可以通过:api.stduino.com/simples
直接进行查看当前已有的库函数及其相关信息
也可通过下面安装的方式进行查看

Stduino库安装

完成了库分享后,现在我们就可以重启软件进行安装自己新分享的库了

单击软件工具栏库开发,单击搜索库即可看到分享的库了

选择我们想要安装的库,即可在右侧看到相关简介信息
同时点击左下角确认安装即可进行安装

文档更新时间: 2021-06-17 11:35   作者:admin