讲义参考教案immediate alert service

1、Immediate Alert ServiceImmediate Alert Servicev1.02015/6/121Copyright 2015 Realtek Semiconductor Corporation.s.Immediate Alert Service修订历史(ReviHistory）日期版本修改2Copyright 2015 Realtek Semiconductor Corporation.s.2015/6/12V1.0Draft by Enrelease verImmediate Alert Service目录修订历史(ReviHistory）2表格列表41About I

2、mmediate Alert Service52Service Characteristics62.1Alert Level62.2GATT Table634Service Configuration7Serviceerfa. 84.1IAS_AddService85eract wipplication95.1Handle Cnt Write Request96Referen.103Copyright 2015 Realtek Semiconductor Corporation.s.Immediate Alert Service表格列表表2.1 Characteristic 描述6表2.2 A

3、ttribute Table7表5.1消息格式94Copyright 2015 Realtek Semiconductor Corporation.s.Immediate Alert Service1About Immediate Alert ServiceImmediate Alert Service（IAS）通过提供一个 Control Po，使对端设备能触发本地设备的及能。警功Immediate Alert Service 包含一个 Alert Level characteristic，只要该 characteristic 被写入除“No Alert”以外的值，都会引起设备。Immedi

4、ate Alert Service 一般与其他的 Service 一起某个 profile，如 Proximity，Find Me 等，其作用就是使设备具备及警的功能。5Copyright 2015 Realtek Semiconductor Corporation.s.Immediate Alert Service2Service Characteristics这部分是对 IAS Service 的 Characteristic 的简单介绍，使 Application 开发者能对 IAS Service 的内容有大概的了解，另外也会涉及一些在 Application 中使用 IAS Serv

5、ice 时需要注意的一些事项。关于 IAS Service的详细说明请参考 SIG的相关 spec 文档。如下是 IAS Service 中所包含的 Characteristic：表 2.1 Characteristic 描述从上表可以看到 IAS Service 仅有一个 Characteristic - Alert Level。下面将对 Alert Level 进行介绍。2.1Alert LevelAlert Level characteristic 是一个 control po，使对端可以通过写这个 characteristic 来触发本地设备报警，而且通过 level 的值设定的级别。

6、可以设置的级别分别为“No Alert”，“Mild Alert”和“High Alert”，级别是对强烈程度的分级，形式可以有多种多样，如灯闪烁、蜂鸣器响、振动等。当本地设备被触发后，以下的方式可以停止：时间到达；用户关闭；新的 Alert Level 被写入；链路断开。2.2GATT Table如下是 IAS Service 的 Attribute Table，描述了 IAS Service 的各个 Attribute 的状况：6Copyright 2015 Realtek Semiconductor Corporation.s.Characteristic NameRequirement

7、Mandatory PropertiesOptionalPropertiesSecurityPermissAlert LevelMWrite without ResponseNoneImmediate Alert Service表 2.2 Attribute Table3Service ConfigurationIAS Service 没有可选的配置。7Copyright 2015 Realtek Semiconductor Corporation.s.FlagsAttribute TypeAttribute ValuePermisOptionalINCL/LEPrimary ServiceI

8、AS Service-0 x1802readMINCLCharacteristicproperty(write without response)readMAPPLAlert LevelValue not defined herewrite without responseMImmediate Alert Service4Serviceerfa这部分是 IAS Service 所提供的接口的说明以及一些使用注意事项。关于如何在 Application 中使用这些接口来实现 IAS Service 相关的 Profile 功能，请参考ProfileerfaDesign。4.1IAS_AddSer

9、viceApplication 在初始化时调用该接口将 IAS Service 添加到 Profile Layer。8Copyright 2015 Realtek Semiconductor Corporation.s.Immediate Alert Service5eract wipplication当 Cnt 发起对 IAS Service 相关数据的请求时，IAS Service 会通过 App Callback 将消息通知到Application，IAS Service 发往 Application 的消息格式如下：表 5.1 消息格式Application 需要对 IAS Servi

10、ce 发来的这些消息进行处理，接下来将对这部分的处理详细说明。5.1Handle Cnt Write RequestIAS Service 的 Alert Level 有被 C nt 端 write 的权限。当 C nt 发起对 Alert Level 的 write 请求时，IAS Service 会通过 App Callback 向 Application 发送一个消息， 消息的 msg_type 部分被设置为 SERVICE_CALLBACK_TYPE_WRITE_CHAR_VALUE，表示为 Write Characteristic 事件，消息的 msg_data的 write_ale

11、rt_level 即是要被写入 Alert Level characteristic 的值：在 Application 中对该消息的处理相关的示例代码片段如下：9Copyright 2015 Realtek Semiconductor Corporation.s.else if (serviceID = gIAServiceId) TIAS_CALLBACK_DATA *pIasCallbackData = (TIAS_CALLBACK_DATA *)pData;if(pIasCallbackData-msg_type = SERVICE_CALLBACK_TYPE_WRITE_CHAR_VALUE)DBG_BUFFER(MODULE_APP, LEVEL_INFO, write_alert_level = %d, 1,pIasCallbackData-msg_data.write_alert_level);SubContentValueDescriptionMessagemsg_typeSERVICE_CALLBACK_TYPE_WRITE_CHAR_VALUEWrite Characteristic Eventmsg_