添加UI页面文件

1. 复制tools/createUiFile.py到项目中UI页面文件的相同目录中，例如./user
2. 运行脚本，按提示选择新增页面文件，输入页面名称，例如demo
3. 按回车后，会自动生成uiDemo.c和uiDemo.h
4. 将文件导入项目中，main.c中添加头文件uiDemo.h
5. 在main函数中添加LD_ADD_PAGE(uiDemo);即可设置好页面
6. 如果有多个页面，请按需要的顺序重复步骤5

   #include "uiHome.h"
   #include "uiZigbee.h"
   #include "uiWifi.h"
   
   int main(void)
   {
       sysInit();
   
       LD_ADD_PAGE(uiHome);//Home页面序号为0
       LD_ADD_PAGE(uiZigbee);//Zigbee页面序号为1
       LD_ADD_PAGE(uiWifi);//Wifi页面序号为2
   
       arm_irq_safe {
           arm_2d_init();
       }
   
       ...
   
       while(1)
       {
           ...
       }
   }

生成图片字模数据

tools文件夹中有工具生成数据

📖 使用说明

添加自定义控件

1. 运行python脚本，src/gui/createWidget.py，输入控件名称后，自动创建控件文件和自动修改代码，例如输入checkBox，则新建ldCheckBox.c、ldCheckBox.h
2. 添加刚才新建的.c .h文件到项目中(新文件在./src/gui中)
3. 修改新控件的.c .h文件

自动处理：

修改ldCommon.h中的控件类型,ldWidgetType

ldGui.c中添加新控件的头文件

修改ldGui.c中的函数，ldGuiDelWidget，_widgetLoop

功能库

btnAction 按键处理

这是一个独立的多功能按键库，可以对GUI按键和实体按键进行行为检测。

信号

该库可以检测以下信号

函数列表

• void xBtnInit(size_t addrOrNum,uint16_t nameId,bool (*getBtnStateFunc)(uint16_t));
• void xBtnConfig(uint8_t debounceMs,uint16_t longPressMs,uint16_t longShootMs,uint16_t clickTimeOutMs);
• void xBtnTick(uint8_t cycleMs);
• uint16_t xBtnGetState(uint16_t id, uint8_t state);
• void xBtnClean(void);

函数说明

void xBtnInit(uint16_t id,bool (*getBtnStateFunc)(uint16_t));

// 实体按键
bool vtGetKeyState(uint16_t value)
{
    switch (value)
    {
    case KEY_NUM_UP:
    {
        return keyUpState;
        break;
    }
    case KEY_NUM_DOWN:
    {
        return keyDownState;
        break;
    }
    default:
        break;
    }
    return 0;
}
// ldgui触摸按键
bool getKeyState(uint16_t value)
{
ldButton_t * pBtn=ldBaseGetWidgetById(value);
return pBtn->isPressed;
}

void xBtnConfig(uint8_t debounceMs,uint16_t longPressMs,uint16_t longShootMs,uint16_t clickTimeOutMs);

void xBtnTick(uint8_t cycleMs);

uint16_t xBtnGetState(uint16_t id, uint8_t state);

void xBtnClean(void);

使用举例

//自定义实体按键序号
#define KEY_NUM_UP   1000

//ldgui内部已经集成
//void SysTick_Handler(void)
//{
//    xBtnTick(10);//10ms
//}

//根据按键序号，获取按键状态
bool vtGetKeyState(uint16_t value)
{
    switch (value)
    {
    case KEY_NUM_UP:
    {
        return keyUp;
    }
    default:
        break;
    }
    return 0;
}

//初始化按键
xBtnInit(KEY_NUM_UP,vtGetKeyState);

//循环处理函数
void loopFunc(void)
{
    //判断按键按下
    if(xBtnGetState(KEY_NUM_UP,BTN_PRESS))
    {
        //按键按下的用户处理代码
    }
}

queue 队列

这是一个简单的队列软件库

函数列表

• xQueue_t* xQueueCreate(uint32_t length, uint32_t itemSize);
• bool xQueueEnqueue(xQueue_t *queue ,void * pInItem,uint32_t itemSize);
• bool xQueueDequeue(xQueue_t *queue ,void * pOutItem,uint32_t itemSize);
• uint32_t xQueueGetLength(xQueue_t *queue);
• void xQueueClear(xQueue_t* queue);

使用举例

typedef struct{
    uint16_t senderId;
    uint8_t signalType;
    size_t value;
}emitInfo_t;

xQueue_t *emitQueue=NULL;
emitInfo_t emitInfo;

//创建队列
emitQueue=xQueueCreate(EMIT_QUEUE_SIZE,sizeof (emitInfo_t));

//写入数据，入队
emitInfo.senderId=0;
emitInfo.signalType=1;
emitInfo.value=10;
xQueueEnqueue(emitQueue,&emitInfo,sizeof (emitInfo_t));

//判断数据数量
if(xQueueGetLength(emitQueue)>0)
{
    //读取数据，出队
    if(xQueueDequeue(emitQueue,&emitInfo,sizeof (emitInfo)))
}

log 打印日志

• 支持普通打印和彩色打印
• 支持信息等级分类

配置

• USE_LOG_COLOR

  =0 普通打印

  =1 彩色打印(需要控制台支持，推荐MobaXterm)

• SET_LOG_LEVEL

  =LOG_LEVEL_NONE

  =LOG_LEVEL_ERROR

  =LOG_LEVEL_WARNING

  =LOG_LEVEL_INFO

  =LOG_LEVEL_DEBUG

• LOG_PRINT

  默认为printf，可自定义串口硬件

函数接口

• LOG_ERROR(fmt, ...)
• LOG_WARNING(fmt, ...)
• LOG_INFO(fmt, ...)
• LOG_DEBUG(fmt, ...)

使用举例

LOG_DEBUG("click widget id:%d\n",pWidget->nameId);

string 字符串处理

对字符串进行简单的转换处理

函数接口

• int32_t xStrToI32(uint8_t * str);
• uint8_t* xI32ToStr(int32_t inInt32,uint8_t *buf);
• float xStrToFloat(uint8_t * str);
• uint8_t* xFloatToStr(float inFloat,uint8_t afterDecimalPointNum,uint8_t *buf);

使用举例

int32_t value;
value = xStrToI32("123");
// value = 123

uint8_t text[16];
float fValue=3.1415926;
text = xFloatToStr(fValue,2,text);
// text = "3.14"

timer 软件定时器

基于arm2d的基础上衍生的软件定时器

函数接口

• bool ldTimeOut(uint16_t ms, int64_t *pTimer,bool isReset)

使用举例

//计数变量
int64_t sysTimer=0;

//循环处理函数
void loopFunc(void)
{
    if(ldTimeOut(10,&sysTimer,true))
    {
        //10ms处理一次的用户代码
    }
}