单片机软件架构连载(1)-枚举(enum)

今天跟大家讲一下我在产品开发时,用枚举(enum)的一些骚操作,都是实战经验,不难,但开发经验尚浅的话,不一定能把它灵活应用。

为什么要讲枚举呢?

因为我发现它是一个容易被遗忘,同时又非常重要的关键词,大家如果看那些大佬写的产品程序,真的会发现有非常非常多enum的应用。

1.什么是枚举?

我对枚举Enum(Enumeration)数据类型的理解,是给常量另起个名字。

举例:

给"1"取个名字叫True;

给"0"取个名字叫False;

把常量重命名以后,在程序里,相对数字能更直观地表达逻辑的对和错。

2.枚举的几种用法

2.1直接定义枚举值,然后给普通变量赋值

示例程序:

// 定义一个匿名枚举类型,包含四种颜色,分别对应整数值0到3
enum 
{
    RED,     // 枚举成员RED的值为0,代表红色
    GREEN,   // 枚举成员GREEN的值为1,代表绿色
    BLUE,    // 枚举成员BLUE的值为2,代表蓝色
    YELLOW   // 枚举成员YELLOW的值为3,代表黄色
};

// 程序的入口点,main函数
int main() 
{
    //定义一个无符号字符变量color1,用于存储颜色的枚举值
    unsigned char color1;
    
    // 将枚举成员BLUE赋值给color1变量,BLUE的值为2
    color1 = BLUE; 
    
     // 使用printf函数打印color1变量的值
    // \r是回车符,用于将光标移动到当前行的开头;\n是换行符,用于移动到下一行的开头
    printf("color1=%d\r\n", color1);
    
   // main函数执行成功,返回0,表示程序正常结束
    return 0;
}

输出结果:color1=2

这段代码定义了一个匿名枚举,但没有给枚举类型命名。

这个枚举类型,有四个枚举成员:RED、GREEN、BLUE、YELLOW,这些成员分别默认被赋予了从0到3的整数值。

这种方式,没办法定义枚举变量的,但是呢,我们可以定义一个数值型变量color1,然后把枚举的值赋给他它,最终color1输出的结果是2,也就是枚举成员BLUE,如果是一些简单的应用,这种方法我个人也比较常用,省事。

注意:如果不指定枚举成员的值,默认是从0开始,自动递增。

当然,也可以我们自己指定,每个枚举成员的值,比如:

enum 
{
    RED=1,    // 枚举成员RED的值为1
    GREEN=10,  // 枚举成员GREEN的值为10
    BLUE=18,   // 枚举成员BLUE的值为18
    YELLOW=39  // 枚举成员YELLOW的值为39
};

2.2定义带名称的枚举

程序示例:

// 定义一个名为Color的枚举类型,包含四种颜色的枚举成员
enum Color
{
    RED,     // 枚举成员RED的值为0,代表红色
    GREEN,   // 枚举成员GREEN的值为1,代表绿色
    BLUE,    // 枚举成员BLUE的值为2,代表蓝色
    YELLOW   // 枚举成员YELLOW的值为3,代表黄色
};

// 程序的入口点,main函数
int main() 
{
    //定义一个枚举类型Color的变量color1,用于存储颜色的枚举值
    enum Color color1;
    
    // 将枚举成员BLUE赋值给color1变量,BLUE的值为2,代表蓝色
    color1 = BLUE;
    
    // 使用printf函数打印color1变量的值
    // \r是回车符,用于将光标移动到当前行的开头;\n是换行符,用于移动到下一行的开头
    printf("color1=%d\r\n", color1);
    
    // main函数执行成功,返回0,表示程序正常结束
    return 0;
}

输出结果:color1=2

这里定义了一个名字为Color的枚举类型,那么我们就可以通过这个枚举类型,再定义一个color1的枚举变量。

注意:Color是数据类型(枚举类型),color1是变量。

这种方式,我比较少用,因为每次定义枚举变量,都要在前面多写一个enum。

2.3用typedef自定义枚举类型

程序示例

// 使用typedef关键字定义一个名为Color的枚举类型,包含四种颜色的枚举成员
typedef enum 
{
    RED,     // 枚举成员RED的值为0,代表红色
    GREEN,   // 枚举成员GREEN的值为1,代表绿色
    BLUE,    // 枚举成员BLUE的值为2,代表蓝色
    YELLOW   // 枚举成员YELLOW的值为3,代表黄色
} Color; // 注意,枚举类型的名称后面跟着分号

// 程序的入口点,main函数
int main() 
{
    //定义一个Color类型的变量color1,用于存储颜色的枚举值
    Color color1;
    
    // 将枚举成员BLUE赋值给color1变量,BLUE的值为2,代表蓝色
    color1 = BLUE;
    
   // 使用printf函数打印color1变量的值
    // \r是回车符,用于将光标移动到当前行的开头;\n是换行符,用于移动到下一行的开头
    printf("color1=%d\r\n", color1);
    
    // main函数执行成功,返回0,表示程序正常结束
    return 0;
}

输出结果:color1=2

这个代码中使用typedef关键字,定义了一个名为Color的枚举类型,然后我们直接使用Color来定义一个enum变量,这种方法用的最多。

3.枚举有什么用?具体用在哪里?

枚举可以帮助开发者,以一种更加清晰和结构化的方式,来处理项目代码中的各种状态和配置

下面那我结合实际产品代码,来讲解它的应用场景:

3.1枚举在数组的应用

程序示例:

enum
{
    ESP12_AT_RESET =0,
    ESP12_AT_AT,
    ESP12_AT_ATE,        
    ESP12_AT_GETWIFILIST,        
    ESP12_AT_CWMODE,        
    ESP12_AT_CWAUTOCONN,                
    ESP12_AT_CWSTARTSMART,        
    ESP12_AT_CWSTOPSMART,        
    ESP12_AT_CWSTATE,
    ESP12_AT_CWLAP,        
    
    ESP12_AT_MQTTUSERCFG,// "AT+MQTTUSERCFG=0,1,\"",  
    ESP12_AT_MQTTCONN,// "AT+MQTTCONN=0,\"",   
    ESP12_AT_MQTTPUB,// "AT+MQTTPUB=0,\"",    
    ESP12_AT_MQTTSUB,// "AT+MQTTSUB=0,\"",     
    ESP12_AT_MQTTCLEAN,// "AT+MQTTCLEAN=0",          
    ESP12_AT_MAX
};



const unsigned char ESP12_AT[ESP12_AT_MAX][70]=
{
    "AT+RST",
    "AT\0",,             ///WIFI 测试指令
    "ATE1\0",            //打开回显
    "AT+CWSTATE?\0",        //
    "AT+CWMODE=1\0",    ///配置WIFI工作模式 =0 关闭WIFI   =1 Station模式 =2 softAP模式 =3 softAP+ Station模式
    "AT+CWAUTOCONN=1\0",//0 上电不自动链接AP   =1 上电自动链接AP
    "AT+CWSTARTSMART=2\0",//启动某种类型的SmartConfig模式  1:ESP=TOUCH  2:AirKiss 3 AirKiss+Esptouch
    "AT+CWSTOPSMART\0",//        停止SmartConfig        
    "AT+CWSTATE?\0",      //获取WIFI 的链接状态 
    "AT+CWLAP=\"\0",        //获取WIFI的信号 强弱
    "AT+MQTTUSERCFG=0,1,\"",  //MQTT  CONFESP12_AT_MQTTUSERCFG,// 
    "AT+MQTTCONN=0,\"",    //MQTT CONNESP12_AT_MQTTCONN,
    "AT+MQTTPUB=0,\"",    
    "AT+MQTTSUB=0,\"",     
    "AT+MQTTCLEAN=0",     
};

这是从无际单片机项目特训营的项目6,拷贝了一小段代码。

这段代码定义了一个匿名的枚举类型,表示ESP8266模块的相关AT命令。

enum定义了一系列的枚举成员,每个成员都有一个默认的整数值,从0开始递增。

也定义了一个字符串数组ESP12_AT,用于存储与枚举值对应的AT指令字符串。

ESP12_AT数组中的每个元素都是一个字符串,对应于一个特定的AT命令。

3.2可灵活确定数组大小

我定义数组确定大小的时候,不需要人工去数,一共有多少条AT指令,直接用枚举最后一个成员(ESP12_AT_MAX)就可以了。

举个例子:

//使用枚举作为数组大小例子
const unsigned char ESP12_AT[ESP12_AT_MAX][70]; 


//不使用枚举作为数组大小例子
const unsigned char ESP12_AT[15][70];

使用枚举成员最后一个值,作为定义数组时的大小,代码可维护性更强,后期哪怕增加或者减少指令,也不用手动修改数组大小,直接修改枚举成员就可以了。

否则,如果数组大小超过百个, 后期修改会非常头痛。

3.3枚举成员作为数组下标使用

可以直接用枚举成员,访问数组中的某个元素。

举例:

unsigned char *p;

//方式1
p = ESP12_AT[ESP12_AT_RESET];

//方式2
p = ESP12_AT[0];

方式1:采用枚举成员值,作为数组下标,访问数组中某个元素的值,代码可维护性更强,不用去记某条AT指令,对应的数组下标值是多少,而且用枚举值访问,没有数组越界访问的风险

方式2:直接用数值去访问数组中的某个元素,代码可维护性差,如果指令多了,很难搞清,什么值对应哪条指令,直接用值,有数组越界访问的风险

3.4枚举在模块化编程的应用

我觉得STM32固件库,就是典型的面向对象,模块化编程的方式了。

我们拿STM32固件库,关于GPIO引脚部分的代码来讲解。

程序示例:

// 定义一个名为GPIOSpeed_TypeDef的枚举类型,用于指定GPIO引脚的速度
typedef enum
{ 
  GPIO_Speed_10MHz = 1, // GPIO引脚速度为10MHz
  GPIO_Speed_2MHz,     // GPIO引脚速度为2MHz
  GPIO_Speed_50MHz      // GPIO引脚速度为50MHz
}GPIOSpeed_TypeDef;

// 定义一个名为GPIOMode_TypeDef的枚举类型,用于指定GPIO引脚的模式
typedef enum
{ 
  GPIO_Mode_AIN = 0x0,     //模拟输入模式
  GPIO_Mode_IN_FLOATING = 0x04, //浮空输入模式
  GPIO_Mode_IPD = 0x28,    //带有内部上拉/下拉的输入模式
  GPIO_Mode_IPU = 0x48,    //仅带有内部上拉的输入模式
  GPIO_Mode_Out_OD = 0x14,  //开漏输出模式
  GPIO_Mode_Out_PP = 0x10,  //推挽输出模式
  GPIO_Mode_AF_OD = 0x1C,  //带替代功能的开漏输出模式
  GPIO_Mode_AF_PP = 0x18   //带替代功能的推挽输出模式
}GPIOMode_TypeDef;

// 定义一个名为GPIO_InitTypeDef的结构体,用于初始化GPIO引脚的配置
typedef struct
{
  uint16_t GPIO_Pin;           // 要配置的GPIO引脚,可以是单个引脚或多个引脚的组合

  GPIOSpeed_TypeDef GPIO_Speed; // 指定GPIO引脚的速度
  GPIOMode_TypeDef GPIO_Mode;     // 指定GPIO引脚的模式
}GPIO_InitTypeDef;

这段代码定义了两个枚举类型GPIOSpeed_TypeDefGPIOMode_TypeDef。分别用于指定GPIO引脚的速度和工作模式。

GPIO_Speed_TypeDef枚举定义了三种速度:10MHz、2MHz、50MHz。

GPIOMode_TypeDef枚举定义了多种GPIO模式,包括模拟输入、浮空输入、带内部上拉/下拉的输入、开漏输出和推挽输出等。

每种模式都有对应的十六进制值,这些值,通常与硬件寄存器的位设置相对应

枚举类型为GPIO速度和模式,提供了具有意义的名称,这比直接使用数字更易于理解。

例如,GPIO_Speed_50MHz比单纯的数字1或2,更清楚地表明了GPIO引脚的运行速度是50MHz。

GPIO_InitTypeDef结构体用于在初始化GPIO引脚时,保存配置信息。

它包含三个结构体成员:

GPIO_Pin-表示要配置的引脚

GPIO_Speed-表示引脚的速度

GPIO_Mode表示引脚的模式

这种代码风格,就是模块化编程思维之一了,每个模块都应该提供清晰、定义良好的接口。

通过使用枚举类型,如GPIOSpeed_TypeDef和GPIOMode_TypeDef,模块可以定义一组预定义的常量(枚举成员),这些常量(枚举成员)代表了不同的配置选项。

这样,其它模块在调用该模块的函数时,可以使用这些枚举值作为参数,从而提供了一种明确、易于理解的配置方式。

正面教材:

// 定义一个GPIO_InitTypeDef结构体变量,用于存储GPIO的初始化配置
GPIO_InitTypeDef GPIO_InitStructure;

// 设置GPIO_InitStructure结构体中的GPIO_Speed成员,指定GPIO引脚的速度
// 这里使用GPIO_Speed_50MHz枚举值,表示GPIO引脚的速率设置为50MHz
GPIO_InitStructure.GPIO_Speed = GPIO_Speed_50MHz;

// 设置GPIO_InitStructure结构体中的GPIO_Mode成员,指定GPIO引脚的模式
// 这里使用GPIO_Mode_Out_PP枚举值,表示GPIO引脚配置为推挽输出模式
GPIO_InitStructure.GPIO_Mode = GPIO_Mode_Out_PP;

反面教材:

GPIO_InitTypeDef GPIO_InitStructure;

GPIO_InitStructure.GPIO_Speed = 3;
GPIO_InitStructure.GPIO_Mode = 0x10;

是不是正面教材的例子,更加专业呢?

枚举在实际产品的应用还有非常多,这节课只是给大家演示几种,如果想继续全面深入学习,可以做我们无际单片机陪跑营的项目,从0到1实现产品功能,能学习得更系统一些。

4.枚举的几个细节

  • 枚举的值默认是从0开始递增。

  • 我用Keil测试过,枚举最大值是0xFFFFFFFF,即4个字节。

最近在写单片机软件架构系列的文章,有些内容篇幅过长,后面打算在一些关键点和难点处,增加视频讲解,内容可能会不定期更新,如果这种方式阅读起来不方便,可以找我安排飞书的文档。


最近很多粉丝问我单片机怎么学,我根据自己从业十年经验,累积耗时一个月,精心整理一份「单

片机最佳学习路径+单片机入门到高级教程+工具包」全部无偿分享给铁粉!!!

除此以外,再含泪分享我压箱底的22个热门开源项目,包含源码+原理图+PCB+说明文档,让你迅速进阶成高手

教程资料包和详细的学习路径可以看我下面这篇文章的开头

《单片机入门到高级开挂学习路径(附教程+工具)》

《单片机入门到高级开挂学习路径(附教程+工具)》

《单片机入门到高级开挂学习路径(附教程+工具)》

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mfbz.cn/a/770444.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

【产品经理】订单处理11-订单修改场景梳理

为了应对订单修改的场景,电商ERP系统应该如何设计相应模块? 电商ERP系统,经常遇到需要修改订单的情况,修改订单主要以下几种场景: 一、修改商品 修改商品,包括对正常商品的换货、以及对赠品的增删改。 1…

【SQL】已解决:SQL分组去重并合并相同数据

文章目录 一、分析问题背景二、可能出错的原因三、错误代码示例四、正确代码示例五、注意事项 已解决:SQL分组去重并合并相同数据 在数据库操作中,数据的分组、去重以及合并是常见需求。然而,初学者在编写SQL语句时,可能会遇到一…

【JNDI注入利用工具】JNDIExploit v1.1

# 简介 JNDIExploit一款用于 JNDI注入 利用的工具,大量参考/引用了 Rogue JNDI 项目的代码,集成了JDNI注入格式,能够更加方便的开启服务端后直接利用,支持反弹Shell、命令执行、直接植入内存shell等,并集成了常见的by…

[单master节点k8s部署]17.监控系统构建(二)Prometheus安装

prometheus server安装 创建sa账号,对prometheus server进行授权。因为Prometheus是安装在pod里面,以pod的形式去运行的,因此需要创建sa,并对他做rbac授权。 apiVersion: v1 kind: ServiceAccount metadata:name: monitornamesp…

k8s学习--k8s群集部署zookeeper应用及详细解释

文章目录 zookeeper什么是zookeeper基本概念主要功能工作原理使用场景优点缺点 k8s集群部署zookeeper环境一、zookeeper部署YAML资源清单准备二、zookeeper部署及部署验证三、zookeeper应用验证 zookeeper 什么是zookeeper ZooKeeper 是一个开源的分布式协调服务,…

Windows11 安装MySQL

MySQL下载官网 安装教程参考 选择Windows离线安装 典型安装

优化页面加载时间

注:机翻,未校对。 本文年代久远,除了少部分不合时宜的,其他仍有借鉴意义。 Optimizing Page Load Time 优化页面加载时间 It is widely accepted that fast-loading pages improve the user experience. In recent years, many …

Pharmacy Management System v1.0 文件上传漏洞(CVE-2022-30887)

前言 CVE-2022-30887 是一个存在于 Pharmacy Management System v1.0 中的远程代码执行(RCE)漏洞。这个漏洞存在于 /php_action/editProductImage.php 组件中。攻击者可以通过上传一个精心制作的图像文件来执行任意代码。 漏洞详细信息 漏洞描述: Pha…

java项目总结2

3.了解Java的内存分配 4.重载 定义:在一个类中,有相同名的,但是却是不同参数(返回类型可以不一样) 重载的优点: 1.减少定义方法时使用的单词 2.减少调用方法时候的麻烦(比如sum的返回两个数的…

5月1日起,《碳排放权交易管理暂行条例》正式施行

2024年5月1日,《碳排放权交易管理暂行条例》(以下简称《条例》)正式施行,作为我国应对气候变化领域的第一部专门法规,《条例》首次以行政法规的形式明确了碳排放权市场交易制度。 作为碳排放权交易市场的重要补充&…

关于腾讯的哪些事(4月新闻纪要)

科技进步一等奖! 这份文件是关于腾讯Angel机器学习平台获得2023年中国电子学会科学技术奖科技进步一等奖的详细介绍。主要内容涵盖了获奖项目《面向大规模数据的Angel机器学习平台关键技术及应用》的技术特点、应用效果以及发展历程。以下是详细总结: 获…

数据结构——树的基础概念

目录 1.树的概念 2.树的相关概念 3.树的表示 (1)直接表示法 (2)双亲表示法 (3)左孩子右兄弟表示法 4.树在实际中的运用(表示文件系统的目录树结构) 1.树的概念 树是一种非线性的数据结构&#xff0…

关于一些数据资源入表事项

一、入表条件: 2024年1月1日《企业数据资源相关会计处理暂行规定》开始执行,以上简称《企业会计准则》,它将资产定义为“企业过去的交易或者事项形成的、由企业拥有或者控制的、预期会给企业带来经济利益的资源”。需要说明的是,…

github 设置中文,亲测有效

点进去 安装 选上面第二个,不行再选第一个 GitHub - maboloshi/github-chinese: GitHub 汉化插件,GitHub 中文化界面。 (GitHub Translation To Chinese)

Java学习十二—Java8特性之Optional类

一、简介 Java 8 引入了 Optional​ 类作为一种容器,可以用来显式地表示一个值存在或不存在。它解决了传统上可能会遇到的空指针异常问题,同时提供了一种更优雅的方式来处理可能为null的情况。 Java 8 中引入 Optional​ 类的背景可以从以下几个方面来理…

Ubuntu查看opencv版本c++

✗命令行中直接输入: pkg-config --modversion opencv✔命令行中直接输入: pkg-config --modversion opencv4注解:附上在markdown中打勾,对号和打叉。使用时将&和#之间的空格去掉,这里只是为了不让CSDN自动转换才…

内容监管与自由表达:Facebook的平衡之道

在当今数字化信息社会中,社交媒体平台不仅是人们交流和获取信息的主要渠道,也是自由表达的重要舞台。Facebook,作为全球最大的社交网络平台,连接了数十亿用户,形成了一个丰富多样的信息生态。然而,如何在维…

怎么加密CAD图纸丨企业级图纸加密软件排行榜

我们为什么需要一款好用的图纸加密软件? CAD图纸包含企业的核心设计和技术,是宝贵的知识产权。加密软件可以防止未经授权的人员获取和复制这些设计。 通过加密,可以有效防止CAD图纸在传输或存储过程中被窃取或泄露,特别是在互联…

软考的报名详细流程

2024年软考的考试时间已经公布,分别为5月25日至28日和11月9日至12日。准备参加2024年软考的朋友们,一定要提前关注官方发布的考试安排。 本文将详细介绍软考报考的整个流程。准备报考的朋友们,阅读本文就足够啦!软考的报考流程大致…

面向高精度导航定位领域的UM980RTK定位模块

UM980 是和芯星通自主研发的新一代 BDS/GPS/GLONASS/Galileo/QZSS 全系统全频高精度 RTK 定位模块,基于和芯星通自主研发的新一代射频基带及高精度算法一体化GNSS SoC 芯片—NebulasIV 设计。可同时跟踪 BDS, GPS, GLONASS, Galileo, QZSS, NavIC, SBAS, L-Band* 等…