0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

基于AWBus-lite总线拓扑结构的设备管理框架

AGk5_ZLG_zhiyua 来源:互联网 作者:佚名 2018-07-02 09:20 次阅读

本文导读

在使用AWBus-lite对设备进行管理时,无论设备处于 AWBus-lite拓扑结构中的哪个位置,只要其能够提供某种标准服务,就可以使用相应的通用接口对其进行操作。本文将从接口的定义和实现两个方面,深入理解AWbus-lite工作的原理。

本文为《面向AWorks框架和接口的编程》第三部分软件篇——第13章——第1~2小节:通用接口的定义和接口的实现。

本章导读

在基于AWBus-lite总线拓扑结构的设备管理框架中,无论一个设备处于AWBus-lite总线拓扑结构中的哪个位置,只要其能够提供某种标准服务,就可以使用相应的通用接口对其进行访问。那么,这究竟是怎样实现的呢?本章将继续深入探讨AWBus-lite,为您揭开AWBus-lite的神秘面纱,使您对AWBus-lite有更加深入的了解,在具有这些足够的了解后,你将有能力独立开发一些设备的驱动,当后续遇到一些AWorks暂不支持的设备时,可以自行开发设备相应的驱动。

13.1 通用接口的定义

合理的接口应该是简洁的、易阅读的、职责明确的,为了便于维护,通用接口由广州致远电子有限公司进行统一的定义,用户通常不需要自行定义通用接口。目前,常用的功能都已经被标准化,定义了相应的通用接口。

作为一种了解,下面以LED为例,从接口的命名、参数和返回值三个方面阐述在AWorks中定义接口的一般方法。

13.1.1 接口命名

在AWorks中,所有通用接口均以“aw_”开头,紧接着是操作对象的名字,对于LED控制接口来说,所有接口都应该以“aw_led_”作为前缀。

在接口的前缀定义好之后,应该考虑需要定义哪些功能性接口,然后根据功能完善接口名。对于LED来说,核心的操作是控制LED的状态,点亮或熄灭LED,为此,可以定义一个设置(set)LED状态的函数,比如:“aw_led_set”。

使用该接口可以设置LED的状态,显然,为了区分是点亮还是熄灭LED,需要通过一个额外的参数来指定具体的操作。

每次开灯或关灯都需要传递额外的参数给aw_led_set()接口,显得比较繁琐。为了简化操作,可以为常用的开灯和关灯操作定义专用的接口,这样就不需要额外的参数来对开灯和关灯操作进行具体的区分了。比如,使用on和off分别表示开灯和关灯,则可以定义开灯的接口名为:“aw_led_on”,关灯的接口名为:

“aw_led_off”。

在一些特殊的应用场合中,比如,LED闪烁,用户可能并不关心具体的操作是开灯还是关灯,它仅仅需要LED的状态发生翻转。此时,可以定义一个用于翻转(toggle)LED状态的专用接口,比如:“aw_led_toggle”

13.1.2 接口参数

在AWorks中,通用接口的第一个参数往往用于表示要操作的具体对象。显然,在一个系统中,可能存在多个LED,为了区分各个LED,可以为每个LED分配一个唯一编号,即ID号。ID号是一个从0开始的整数,例如,系统中有两个LED,则编号分别为0、1。基于此,为了指定要操作的具体LED,通用接口的第一个参数可以设定为int类型的id。

对于aw_led_set接口,其除了使用id确定需要控制的LED外,还需要使用一个参数来区分是点亮LED还是熄灭LED,这是一个二选一的操作,对应参数的类型可以使用布尔类型: aw_bool_t。当值为真(AW_TRUE)时,则点亮LED;当值为假(AW_FALSE)时,则熄灭LED。基于此,可以定义aw_led_set()接口的原型为(还未定义返回值):

对于aw_led_on、aw_led_off和aw_led_toggle接口来说,它们的职责单一,仅仅需要指定控制的LED,即可完成点亮、熄灭或翻转操作,无需其它额外的参数。对于这类接口,参数仅仅需要id,这些接口的原型可以定义如下(还未定义返回值):

13.1.3 返回值

对于用户来说,调用通用接口后,应该可以获取到本次执行的结果,是执行成功还是执行失败,或是一些其它的有用信息。比如,在调用接口时,如果指定的id超过了有效范围,由于没有与无效id对应的LED设备,操作必定会失败,此时必须返回通过返回值告知用户操作失败,且操作失败的原因是id不在有效范围内,无与之对应的LED设备。

在AWorks中,接口通常返回一个aw_err_t类型的返回值来表示接口执行的结果,返回值的含义已被标准化:若返回值为AW_OK,则表示操作成功;若返回值为负数,则表示操作失败,此时,用户可根据具体的返回值,查找aw_errno.h文件中定义的宏,根据宏的含义确定失败的原因;若返回值为正数,其含义与具体接口相关,由具体接口定义,无特殊说明则表示不会返回正数。AW_OK是在aw_common.h文件中定义的宏,其定义如下:

错误号在aw_errno.h文件中定义,几个常见错误号的定义详见表6.2。比如,在调用LED通用接口时,若id不在有效范围内,则该id没有对应的LED设备,此时接口应该返回-AW_ENODEV。注意:AW_ENODEV的前面有一个负号,以表示负值。

基于此,将所有LED通用接口的返回值类型定义为aw_err_t,LED控制接口的完整定义详见表13.1,其对应的类图详见图13.1。

表13.1 LED通用接口(aw_led.h)

图13.1 LED接口类图

这些接口都已经在aw_led.h文件中完成了定义,无需用户再自行定义。上述从接口命名、参数和返回值三个方面详细阐述了一套接口定义的方法,旨在让用户了解接口的由来,加深对接口的理解。实际中,定义接口并不是一件容易的事情,需要尽可能考虑到所有的情况,接口作为与用户交互的途径,一旦定义完成,如非必要,都应该避免再对接口进行修改。否则,所有依赖于该接口的应用程序都将受到影响。因此,当前并不建议用户自定义通用接口,通用接口的定义应由广州致远电子有限公司统一规划、定义、维护和管理。

13.2 接口的实现

作为一种范例,下面以实现LED接口为例,详细介绍AWorks中实现接口的一般方法。

13.2.1 实现接口初探

在AWorks中,硬件设备和驱动统一由AWBus-lite进行管理,因此,对于LED这一类硬件设备,其实现是属于AWBus-lite的一部分。LED有4个通用接口函数,其中的aw_led_on()和aw_led_off()接口可以直接基于aw_led_set()接口实现,详见程序清单13.1。

程序清单13.1 aw_led_on()和aw_led_off()接口的实现

实现接口的核心是实现aw_led_set()和

aw_led_toggle()这两个接口。对于不同的底层硬件设备,LED实际控制方式是不同的,比如,最常见的,通过GPIO直接控制一个LED,简单范例详见程序清单13.2。

程序清单13.2 aw_led_set()的实现(GPIO控制LED)

也有可能是通过串口控制一个LED设备。例如,通过发送字符串命令控制LED的状态,命令格式为:set ,其中,id为LED编号,on为设置LED的状态,要点亮LED0,则发送字符串:"set 0 1"。这种情况下,aw_led_set()的实现范例详见程序清单13.3。

程序清单13.3 aw_led_set()的实现(UART控制LED)

总之,底层硬件设备是多种多样的,不同类型的LED设备对应的控制方式也会不同。

定义通用接口的目的在于屏蔽底层硬件的差异性,即无论底层硬件如何变化,用户都可以使用通用接口控制LED。显然,如果直接类似程序清单13.2和程序清单13.3这样实现一个通用接口,那么随着LED设备种类的增加,同一个接口的实现代码将有越来越多不同的版本。

在一个应用程序中,一个接口不能同时具有多种不同的实现,因此,这样的做法有着非常明显的缺点:多个不同种类的LED设备不能在一个应用中共存,更换硬件设备,就必须更换通用接口的实现,使用何种设备就加入相应设备的控制代码进行编译。 例如,系统中有几个直接通过GPIO控制的LED,同时也存在几个通过UART控制的LED,那么,类似程序清单13.2和程序清单13.3这样直接实现通用接口的方法,就无法组织代码了,因为不可能同时将程序清单13.2和程序清单13.3所示的代码加入工程编译。显然,需要更好的办法来解决这个问题。

13.2.2 LED抽象方法

在使用几种控制方式不同的LED硬件设备时,虽然它们对应的aw_led_set()和aw_led_toggle()接口的具体实现方法并不相同,但它们要实现的功能却是一样的,这是它们的共性:均要实现设置LED状态和翻转LED状态的功能。由于一个接口的实现代码只能有一份,因此,这些功能的实现不能直接作为通用接口的实现代码。为此,可以在通用接口和具体实现之间增加一个抽象层,以对共性进行抽象,将两种功能的实现抽象为如下两个方法:

相对于通用接口来说,抽象方法多了一个p_cookie参数。在面向对象的编程语言中(如C++),对象中的方法都能通过隐式指针p_this访问对象自身,引用自身的一些私有数据。而在C语言中则需要显式的声明,这里的p_cookie就有类似的作用,当前设置为void *类型主要是由于具体对象的类型还并不确定。

为了节省内存空间,同时方便管理,可以将所有抽象方法放在一个结构体中,形成一张虚函数表,比如:

由于LED的实现属于AWBus-lite的一部分,因此,命名使用"awbl_"作为前缀。这里定义了一个虚函数表,包含了两个方法,分别用于设置LED的状态和翻转LED。针对不同的硬件设备,都可以根据自身特性实现这两个方法。GPIO控制LED的伪代码详见程序清单13.4,UART控制LED的伪代码详见程序清单13.5。

程序清单13.4 抽象方法的实现(GPIO控制LED)

程序清单13.5 抽象方法的实现(UART控制LED)

显然,__g_led_gpio_drv_funcs和

__g_led_uart_drv_funcs分别是使用GPIO和UART控制LED的具体实现,它们在形式上是两个不同的结构体常量,在同一系统中是可以共存的。

13.2.3 抽象的LED服务

当对不同的LED硬件设备抽象了相同的

pfn_led_set和pfn_led_toggle方法后,在通用接口aw_led_set()和aw_led_toggle()的实现中,就无需再处理与硬件相关的具体事务,只需要找到相应设备提供的相应方法,然后调用这些具体硬件设备提供的方法即可。

在调用设备提供的方法时,由于方法的第一个参数为p_cookie,p_cookie代表了具体的设备对象,调用方法时,需要传递一个p_cookie给下层,用于在具体实现时,访问设备对象中的具体成员,起到“p_this”的作用。由于在aw_led_set()接口的实现中,并不需要直接操作具体设备,因此,无需知道p_cookie的具体类型,仅需起到一个传递的作用:在调用相应的方法时,传递给下层驱动使用。

既然要传递p_cookie,那么,必然要获得一个p_cookie并保存下来,显然,p_cookie代表了具体设备,只能由具体设备提供,同时,抽象方法也是由具体设备提供的,为此,可以将抽象方法和p_cookie定义在一起,形成一个新的类型,以便在具体设备提供的抽象方法的实现时,将p_cookie一并提供,即:

为了便于描述,将其称之为 “LED服务”。其中包含了由驱动实现的抽象方法和传递给驱动函数的p_cookie。其中,p_servfuncs为指向驱动虚函数表的指针,比如,指向

__g_led_gpio_drv_funcs或

__g_led_uart_drv_funcs,p_cookie为指向具体设备的指针,即传递给驱动函数的第一个参数。此时,在aw_led_set()接口的实现中,无需再完成底层硬件相关的操作,仅需调用LED服务中包含的pfn_led_set方法即可,其范例程序详见程序清单13.6。

程序清单13.6 aw_led_set()实现(1)

程序中,使用了一个全局变量__gp_led_serv指向当前一个有效的LED服务,显然,其只有在赋值后才能使用,暂不考虑其如何赋值,仅用以展示pfn_led_set方法的调用形式。

实际中,具体的LED设备往往不止一个。比如,使用GPIO控制的LED设备和使用UART控制的LED设备,它们都可以向系统提供LED服务,这就需要系统具有管理多个LED服务的能力。由于LED设备的数目无法确定,可能动态变化,因此,选用单向链表进行动态管理。为此,在struct awbl_led_service中增加一个p_next成员,用于指向下一个LED服务。即:

此时,系统中的多个LED服务使用链表的形式进行管理。那么,在通用接口的实现中,如何确定具体该使用哪个LED服务呢?在定义通用接口时,使用了ID号区分不同的LED,ID号是唯一的,显然,某一ID的LED必然属于某一确定的硬件设备,若一个硬件设备在提供LED服务时,包含了该硬件设备中所有LED的ID号信息,那么,在通用接口的实现中,就可以根据ID找到对应的LED服务,然后使用驱动中提供的方法完成LED的操作。为此,可以在LED服务中再增加一个ID信息,以表示对应硬件设备中所有LED的ID号。

在一个LED硬件设备中,可能包含多个LED,例如,MiniPort-LED扩展板,包含了8个LED,但一般来讲,一个LED硬件设备中所有LED的编号是连续分配的,基于此,仅需知道一个硬件设备中LED的起始编号和结束编号,就可以获得该硬件设备中所有LED对应的编号,例如,一个硬件设备中LED的起始编号为2、结束编号为9,则表示在该硬件设备中,各个LED的编号分别为:2、3、4、5、6、7、8、9,共计8个LED。为此,可以定义一个LED服务信息结构体类型,专门用于提供LED服务相关的信息,例如:

由此可见,在LED服务信息中,当前仅包含起始编号和结束编号两个信息。LED服务信息是与具体设备相关的,因此,可以在LED服务中新增一个指向LED服务信息的指针,以便在具体设备在提供p_cookie和抽象方法的实现时,将设备支持的LED编号信息一并提供,LED服务的完整定义详见程序清单13.7。

程序清单13.7 完整的LED服务类型定义(awbl_led.h)

由于在LED服务中新增了LED编号信息,那么,在通用接口的实现中,就可以根据设备提供的LED编号信息,找到id对应的LED服务。基于此,aw_led_set()函数的实现详见程序清单13.8。

程序清单13.8 aw_led_set()实现(2)

程序中,调用了__led_id_to_serv()函数以获取ID号对应的LED服务。__led_id_to_serv()函数通过遍历LED服务链表,将id与各个LED服务中的ID信息进行对比,直到找到id对应的LED服务(即id处于该LED服务的起始编号和结束编号之间),具体实现范例详见程序清单13.9。

程序清单13.9 获取ID号对应的LED服务

其中,__gp_led_serv_head是一个模块内部使用的全局变量,初始值为NULL,表示初始时系统中无任何有效的LED服务。同理,可实现aw_led_toggle()接口,详见程序清单13.10。

程序清单13.10 aw_led_toggle()实现

至此,实现了所有通用接口。显然,由于当前并不存在任何有效的LED服务,因此,

__gp_led_serv_head的值为NULL,致使__led_id_to_serv()的返回值为NULL,最终导致通用接口的返回值始终为-AM_ENODEV。

13.2.4 Method机制

为了使通用接口能够操作到具体有效的LED,必须通过某种方法,将当前系统中所有LED设备提供的LED服务加入到以__gp_led_serv_head为头的LED服务链表中。

AWbus-lite提供了一种特殊的“Method机制”,其是一种系统上层和硬件底层相互“交流”的一种方式,可用于系统发现各个硬件设备提供的服务。AWBus-lite提供了Method相关的宏,详见表13.2。

表13.2 Method相关的宏(awbus_lite.h)

1. 定义一个Method类型

AWBL_METHOD_DEF()用于定义一个Method类型,其原型为:

其中,method为定义的Method类型名,string为一个描述字符串,描述字符串仅在定义时对method类型进行描述,可以是任意字符串,其它地方不会被使用到。

Method类型具有唯一性,不可定义两个相同的Method类型。Method类型可以看作一个“唯一标识”,用于标记某一类操作,在底层驱动的实现中,凡是能够完成该类操作的设备,都可以使用该“唯一标识”标记一个入口函数,该入口函数即用于完成相应的操作,这样一来,系统就可以通过该“唯一标识”查找所有被标记的入口函数,并依次调用它们,完成某种特定功能。例如,对于LED,为了获取当前系统中所有设备提供的LED服务,可以定义一个获取LED服务的Method类型,范例程序详见程序清单13.11。

程序清单13.11 定义Method类型范例程序

如此一来,即定义了一个名为awbl_ledserv_get的Method类型,该Method类型即表示了一类操作:获取LED服务。后续在底层设备驱动的实现中,只要一个设备能够提供LED服务,则表示系统可以从中获取到一个LED服务,此时,该驱动就可以提供一个入口函数,用于获取LED服务,并使用该Method类型对入口函数进行标记。这样,在系统启动时,就可以通过查找系统中所有被该Method类型标记的入口函数,然后一一调用它们,以此获得所有设备提供的LED服务。

2. 定义一个具体的Method对象

定义Method对象的本质就是使用Method类型标记一个入口函数,使系统知道该入口函数可以完成某种特定的功能,以便系统在合适的时机调用。为便于描述,在AWBus-lite中,将使用Method类型标记的入口函数称之为一个Method对象。AWBus-lite提供了定义Method对象的辅助宏,其原型为:

其中,name为使用AWBL_METHOD_DEF()定义的Method类型名,handler为用于完成某种特定功能的入口函数。例如,定义awbl_ledserv_get类型的目的是获取LED服务,因此,该类型的Method对象对应的handler应该能够获取到一个LED服务。handler的类型为

awbl_method_handler_t,其定义如下

(awbus_lite.h):

由此可见,awbl_method_handler_t是一个函数指针类型,其指向的函数有两个形参:p_dev和p_arg,返回值为标准的错误号。p_dev指向设备自身,同样起到一个p_this的作用,该handler运行在哪个设备上,传入p_dev的值就应该为指向该设备的指针;p_arg为void *类型的参数,其具体类型与该入口函数需要完成的功能相关,如果功能为获取一个LED服务,p_arg的实际类型就为struct awbl_led_service **,即一个指向LED服务的指针的地址,以便在函数内部改变指向LED服务的指针的值,使其指向设备提供的LED服务,从而完成LED服务的获取。例如,在GPIO控制LED的设备中,其能够提供LED服务,则应在对应的驱动中,定义一个具体的Method对象,便于系统得到LED服务。范例详见程序清单13.12。

程序清单13.12 定义Method对象范例程序

其中,__g_led_gpio_dev_methods为该设备能够提供的Method对象列表,一个设备提供的Method对象统一存放在一个列表中。该列表的具体使用以及入口函数的具体实现,将在LED驱动的实现中进一步介绍。这里仅用于展示系统上层获取LED服务的原理。

3. Method对象列表结束标记

在程序清单13.12中,将Method对象定义在了一个列表中,AWBL_METHOD_END用于定义一个特殊的标志,表示Method对象列表的结束。其原型为:

该宏无需传入任何参数,其仅用于标识一个Method对象列表的结束。例如,GPIO控制的LED设备只能提供一个Method对象,用于系统上层获取LED服务,那么,在该对象之后,应该使用AWBL_METHOD_END表示列表结束。范例程序详见程序清单13.13。

程序清单13.13 AWBL_METHOD_END使用范例程序

4. 导入(声明)一个在外部定义的Method类型

当需要使用一个已定义的Method类型时,若Method类型是在其它文件中定义的,此时就需要在使用前对该Method类型进行声明,类似于C语言中的extern。其原型为:

其中,name为使用AWBL_METHOD_DEF()定义的Method类型名。例如,在程序清单13.13中,定义了Method对象列表,其中使用到了Method类型:awbl_ledserv_get。在使用前,需要对该Method类型进行声明,范例程序详见程序清单13.14。

程序清单13.14 AWBL_METHOD_IMPORT()使用范例程序

5. 得到一个已定义的Method类型的ID

Method类型相当于一个“唯一标识”,有时候,需要判断某一Method对象是否为指定的Method类型。为了便于比较判断,或将“Method类型”作为参数传递给其它接口函数,可以通过该宏获得一个Method类型对应的ID,ID作为一个常量,可以用于比较或参数传递。获取Method类型的ID对应的宏原型为:

其中,method为使用AWBL_METHOD_DEF()定义的Method类型名,返回值为该Method类型的ID,其类型为:awbl_method_id_t,该类型的具体定义用户无需关心,ID可以用作比较,只要两个Method类型的ID相同,就表示两个Method类型是相同的,ID也可以作为参数传递给其它接口,以指定一种Method类型。

例如,在AWbus-lite中,提供了一个工具函数,用于查找设备中是否存在指定类型的Method对象,其函数原型为(awbus_lite.h):

其中,p_dev指定了要查找的设备,即在该设备中查找是否存在指定类型的Method对象,method用于指定Method类型的ID。若查找到该ID对应的method对象,则返回该method对象的入口函数,否则,返回NULL。

例如,有一个p_dev指向的设备,要查找其是否能够提供LED服务,则可以通过该接口实现,范例程序详见程序清单13.15。

程序清单13.15 AWBL_METHOD_ CALL()使用范例程序

程序中,使用AWBL_METHOD_ CALL()得到Method类型awbl_ledserv_get的ID,然后传递给awbl_dev_method_get()函数以查找设备中是否存在相应的Method对象,若存在,则得到了一个有效的入口函数,最后使用该入口函数即可得到一个LED服务。

13.2.5 LED服务链表的初始化

通过程序清单13.15所示的一个流程,若一个设备能够提供LED服务,则可以从中获取到相应的LED服务。若对每个设备都执行一遍上述流程,并在获得一个设备提供的LED服务后,就将其添加到以__gp_led_serv_head为头的LED服务链表中,则可以收集到系统中所有的LED服务,完成LED服务链表的初始构建。为了便于对所有设备执行某一操作,AWBus-lite提供了一个用于遍历所有设备的接口,其函数原型为:

其中,pfunc_action表示要在每个设备上执行的操作,p_arg为传递给pfunc_action的附加参数,flags为遍历设备的标志,返回值为标准错误号。

pfunc_action的类型为awbl_iterate_func_t,该类型的具体定义如下(awbus_lite.h):

由此可见,awbl_iterate_func_t是一个函数指针类型,其指向的函数有两个形参:p_dev和p_arg,返回值为标准的错误号。p_dev指向当前遍历到的设备,同样起到一个p_this的作用,当前遍历到哪个设备,在哪个设备上运行pfunc_action函数,传入的p_dev就为指向该设备的指针;p_arg为遍历时提供的附加参数,其值与调用awbl_dev_iterate()函数时传入的p_arg参数相同。

flags为遍历设备的标志,其决定了需要遍历哪些设备,以及pfunc_action函数的返回值是否能够终止遍历过程。可用标志详见表13.3。

表13.3 遍历设备标志宏(awbus_lite.h)

其中,AWBL_ITERATE_INSTANCES和

AWBL_ITERATE_ORPHANS标志用于指定需要遍历的设备,即在哪些设备上执行pfunc_action函数。在硬件设备列表中,定义了当前系统中所有的硬件设备,当设备具有与之匹配的驱动时,才能够变成一个实例,被系统正常使用,而如果一个设备没有与之匹配的驱动,该设备将变成一个孤儿设备,由于没有与之匹配的驱动,因此系统暂时无法使用孤儿设备。

AWBL_ITERATE_INSTANCES表示表示需要遍历所有实例,即具有相应驱动的设备。AWBL_ITERATE_ORPHANS表示需要遍历所有的孤儿设备。若要遍历所有的实例和孤儿设备,可以使用或运算同时设定这两个标志。

AWBL_ITERATE_INTRABLE标志用于指定

pfunc_action 的返回值是否可以终止遍历,若设定了该标志,则在某一设备上运行pfunc_action函数的返回值将可以决定是否终止整个遍历过程:返回值为AW_OK时,不终止遍历,继续遍历其它设备;否则,遍历过程被终止,不会再继续遍历其它设备。若未设定该标志,则遍历过程不受返回值影响,直到遍历完所有需要遍历的设备后结束。

为了获得所有设备提供的LED服务,需要遍历所有实例,并在pfunc_action中执行如程序清单13.15所示的流程,并将各个设备提供的LED服务添加到以__gp_led_serv_head为头的LED服务链表中。完整的范例程序详见程序清单13.16。

程序清单13.16 获取所有设备提供的LED服务

程序中,由于孤儿设备没有对应的驱动,无法正常使用,显然无法提供LED服务,因此仅需遍历所有实例,遍历标志设定为了:

AWBL_ITERATE_INSTANCES。该程序的目的是完成LED服务链表的初始构建,是一种初始化操作,因此,将其入口函数命名为了

awbl_led_init(),若需使用LED,则应确保在系统启动时,该函数被自动调用。通常情况下,并不需要由用户手动调用该函数,而是将该函数的调用放在模板工程下的aw_prj_config.c文件中,具体位于aw_prj_early_init()函数中,该函数在系统启动时会被自动调用,从而使系统在启动时自动调用awbl_led_init()函数,详见详见程序清单13.17。

程序清单13.17 awbl_led_init()在系统启动时被自动调用的原理

在aw_prj_params.h工程配置文件中,只要使能了某一LED设备,比如,AW_DEV_GPIO_LED,则表示要使用LED,此时,将自动完成AW_COM_AWBL_LED的定义,以此确保当使用LED时,awbl_led_init()会在系统启动过程中被自动调用。核心的原理性程序详见程序清单13.18。

程序清单13.18 自动定义AW_COM_AWBL_LED宏的原理(aw_prj_params.h)

至此,完成了LED服务链表的初始化,若系统中存在LED服务,则链表将不为空,在LED通用接口的实现中,只要传入的id正确,

__led_id_to_serv()的返回值就不为NULL,进而返回一个有效的LED服务,接着,通过LED服务中实现的抽象方法,即可完成LED相关的操作,例如,设置LED状态、翻转LED状态等。

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • led
    led
    +关注

    关注

    242

    文章

    23264

    浏览量

    660696
  • 嵌入式
    +关注

    关注

    5082

    文章

    19117

    浏览量

    304963
  • AWorks
    +关注

    关注

    1

    文章

    16

    浏览量

    5705

原文标题:AWorks软件篇 — 深入理解 AWbus-lite(接口的定义和实现)

文章出处:【微信号:ZLG_zhiyuan,微信公众号:ZLG致远电子】欢迎添加关注!文章转载请注明出处。

收藏 人收藏

    评论

    相关推荐

    设备驱动在AWbus-lite中驱动设备正常工作

    一个硬件设备正常工作的前提是系统中存在对应的驱动。AWorks提供了大量常用硬件设备的驱动,用户通常不需要开发驱动。本文介绍了设备驱动相关的基础概念,展示了设备驱动在
    的头像 发表于 06-12 09:06 4149次阅读
    <b class='flag-5'>设备</b>驱动在<b class='flag-5'>AWbus-lite</b>中驱动<b class='flag-5'>设备</b>正常工作

    AWBus-lite拓扑结构及应用设计

    为了管理系统中各式各样的硬件设备(或虚拟硬件设备),AWorks推出了领先的轻量级总线管理框架AWBu
    的头像 发表于 06-21 09:10 5920次阅读
    <b class='flag-5'>AWBus-lite</b>的<b class='flag-5'>拓扑</b><b class='flag-5'>结构</b>及应用设计

    从接口定义和实现两个方面,深入理解AWbus-lite

    在使用AWBus-lite设备进行管理时,无论设备处于 AWBus-lite拓扑
    的头像 发表于 07-23 09:08 8378次阅读
    从接口定义和实现两个方面,深入理解<b class='flag-5'>AWbus-lite</b>

    纺织企业MES系统下的设备管理

    纺织企业设备管理的解决方案。3、系统的体系结构基于纺织企业的实际问题,本文提出了纺织企业MES系统软件下的设备管理系统的体系结构,系统的网络拓扑
    发表于 12-14 19:46

    基于.Net框架设备管理系统的设计与实现

    设备管理系统是企业运营过程中必不可少的组成部分。本文以中国教育经济信息网管理中心设备管理系统为例,讨论了设备管理系统的设计与实现,并详细讨论了基于.Net
    发表于 08-28 09:02 28次下载

    USB物理总线拓扑结构

    USB物理总线拓扑结构 USB系统中的设备与主机的连接方式采用的是星形连接,如图4-5。
    发表于 07-02 13:08 3213次阅读
    USB物理<b class='flag-5'>总线</b>的<b class='flag-5'>拓扑</b><b class='flag-5'>结构</b>

    总线拓扑结构

    总线拓扑结构  这种网络拓扑结构比较简单,总线型中所有
    发表于 01-08 10:21 1w次阅读

    总线拓扑结构优缺点是什么

    本文开始介绍了拓扑结构的概念和拓扑结构的分类,其次介绍了总线拓扑
    发表于 04-24 17:26 2.5w次阅读
    <b class='flag-5'>总线</b>型<b class='flag-5'>拓扑</b><b class='flag-5'>结构</b>优缺点是什么

    基于RFID的医院医疗设备管理系统设计

    识别、 监控、定位、跟踪及管理等一系列功能的实现,满足信息通 信与信息交换的需求,将互联网与任意物品联系起来,并在激光扫描器等信息传感装置的辅助下支持设备管理功能的实现。我院在医疗设备管理信息化建设
    的头像 发表于 10-30 01:45 865次阅读

    FF总线系统支持哪几种拓扑结构

    拓扑结构就是不同FF设备之间怎样连接的问题。FOUNDATION®Fieldbus总线支持多种拓扑结构
    发表于 11-19 10:46 2275次阅读

    FF总线系统网络拓扑结构的应用有哪些

    拓扑结构就是不同FF设备之间怎样连接的问题。FOUNDATION®Fieldbus总线支持多种拓扑结构
    发表于 12-18 10:58 2560次阅读
    FF<b class='flag-5'>总线</b>系统网络<b class='flag-5'>拓扑</b><b class='flag-5'>结构</b>的应用有哪些

    面向预测性维护的制造工业设备管理系统

    为了解决制造业中工业设备管理混乱、维护成本高昂等问题,以工业机器人、数控车床等工业设备管理对象,开发面向预测性维护的设备管理系统。基于 Spring Bωot
    发表于 04-23 09:46 43次下载
    面向预测性维护的制造工业<b class='flag-5'>设备管理</b>系统

    设备管理云平台是什么?有什么功能?

    设备管理云平台:现代化企业的重要解决方案 随着科技的迅速发展和企业规模的扩大,设备数量和种类也随之增加,设备管理变得愈加复杂。传统的管理方法已经无法满足企业的需求,而
    的头像 发表于 09-20 16:39 1552次阅读

    设备管理系统:是什么、谁需要、推荐设备管理系统

    设备管理系统(EMS)在企业管理中愈发重要。中设智控设备管理系统以全生命周期管理为主,涵盖预算、采购、维护等功能,支持移动端应用,降低备件储备,提高
    的头像 发表于 08-01 11:23 816次阅读
    <b class='flag-5'>设备管理</b>系统:是什么、谁需要、推荐<b class='flag-5'>设备管理</b>系统

    设备管理流程优化的优势

    设备管理对企业生产效率、产品质量、成本控制和安全生产起着关键作用。但设备管理面临挑战,如种类繁多、数量庞大、位置分散等。因此,企业应采用科学的设备管理方法,建立设备管理系统,跟踪
    的头像 发表于 09-05 10:34 333次阅读
    <b class='flag-5'>设备管理</b>流程优化的优势