本文件规定了LIN应用程序接口(API)。 本文件适用于LIN通信的应用程序接口定义。

ICS43.040.15
CCST36
中华人民共和国国家标准
GB/T42691.5—2023/IS017987-5:2016道路车辆
局域互联网络（LIN）
第5部分：应用程序接口
Road vehiclesLocal Interconnect Network(LIN)-Part 5:Application programmers interface (API)（IS017987-5:2016,IDT）
2023-05-23发布
国家市场监督管理总局
国家标准化管理委员会
2023-12-01实施
规范性引用文件
术语和定义、缩略语
术语和定义
缩略语
应用程序接口定义
LIN协议集生成
操作概念
API约定
节点配置及识别
传输层·
参考文献
GB/T42691.5—2023/ISO17987-5:201619
本文件按照GB/T1.1一2020《标准化工作导则起草。
GB/T42691.5—2023/ISO17987-5:2016第1部分：标准化文件的结构和起草规则》的规定本文件为GB/T42691《道路车辆局域互联网络（LIN)》的第5部分。GB/T42691已经发布了以下部分：
第1部分：一般信息和使用案例定义；第2部分：传输层协议和网络层服务；一第3部分：协议规范；
一第4部分：12V/24V电气物理层规范；第5部分：应用程序接口；
一第6部分：协议一致性测试规范；一第7部分：电气物理层（EPL)一致性测试规范；第8部分：电气物理层(EPL)规范：直流电源线上的局域互联网络(DC-LIN)。本文件等同采用ISO17987-5：2016《道路车辆局域互联网络（LIN）第5部分：应用程序接口》。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由中华人民共和国工业和信息化部提出。本文件由全国汽车标准化技术委员会（SAC/TC114)归口。本文件起草单位：吉利汽车研究院（宁波)有限公司、中国汽车技术研究中心有限公司、长城汽车股份有限公司、中国第一汽车股份有限公司、北京国家新能源汽车技术创新中心有限公司、东风汽车集团股份有限公司、中汽研（天津)汽车工程研究院有限公司、泛亚汽车技术中心有限公司、一汽-大众汽车有限公司、上汽通用五菱汽车股份有限公司、惠州市德赛西威汽车电子股份有限公司、上汽大通汽车有限公司。
本文件主要起草人：甄海川、潘俊家、檀庭跃、朱彤、王拓、边泽宇、李兆麟、李敏、韩光省、曲云鸽、董慧、覃华强、何杰聪、闫东东、李腾飞、瑞孟洋、许赞珍、杨丽莎、郑继翔、吴尚、吕亮、高长斌、覃韶辉、李展宏。
GB/T42691.5—2023/ISO17987-5:2016引言
GB/T42691《道路车辆局域互联网络（LIN)》规定了称为局域互联网络（LIN)的车辆通信网络的使用案例、通信协议和物理层需求。LIN协议是一种基于汽车的低速通用异步收发器（UART)的网络，它的一些关键特性是基于信号通信，基于调度表的顿传输，主从通信错误检测，节点配置和诊断服务传输。LIN协议适用于低成本的汽车控制应用，比如门模块和空调系统。作为车辆低速控制应用的通信基础设施，它能提高以下功能：基于信号在不同节点的应用程序之间交换信息；—比特率支持1kbit/s~20kbit/s；一基于确定性调度表的顿通信；一唤醒和休眠LIN网络的网络管理方案；提供错误处理和错误信号的状态管理：一传输层允许大量数据的传输（例如诊断服务）；一如何处理诊断服务的规范；
电气物理层规范；
一用于描述从节点属性的节点描述语言；-一用于描述通信行为的网络描述文件；应用程序接口。
GB/T42691基于ISO/IEC7498-1规定的开发系统互连基本参考模型，该模型将通信系统架构分为七层，即（自上而下)应用层（七层）、表示层、会话层、传输层、网络层、数据链路层和物理层（一层）。这些层的子集都应用在GB/T42691中。GB/T42691区分了由一层提供给它上面一层的服务和该层用来在它的对等实体之间发送消息的协议。这种区分的原因主要是为了服务，尤其是应用层服务和传输层服务，也用于除LIN以外的其他类型的网络。因此，协议对服务的使用者是隐藏的，并且如果有特殊的系统需求，可以修改协议。GB/T42691由8个部分构成，提供了支持以下相关要求实施所需的所有文件和参考材料。第1部分：一般信息和使用案例定义。旨在阐述GB/T42691的结构，以及使用案例定义和供所有后续部分使用的公共资源集（定义、引用），更好地从系统层面指明各部分的关联。一第2部分：传输层协议和网络层服务。旨在定义LIN节点之间传输报文的PDU传输协议网络层要求。
第3部分：协议规范。旨在定义抽象逻辑层上实现LIN协议的要求及与硬件相关的规则。第4部分：12V/24V电气物理层规范。旨在定义实现互连协议所需的有效硬件组件的要求。一第5部分：应用程序接口。通过规定在LIN应用程序接口（API)中规定节点配置和标识服务，进而定义从节点的配置方式和从节点如何使用标识服务，旨在统一LIN应用程序接口（API）。第6部分：协议一致性测试规范。根据第2部分和第3部分检查LIN协议实现的一致性，旨在提供包括对数据链路层、网络层和传输层的测试要求。第7部分：电气物理层（EPL）一致性测试规范。根据第4部分检查LIN电气物理层实现（抽象逻辑层）一致性，旨在提供对电气物理层的测试要求。IN
GB/T42691.5—2023/IS017987-5:2016第8部分：电气物理层（EPL）规范：直流电源线上的局域互联网络（DC-LIN）。旨在定义LIN通信系统直流电源线电气物理层（EPL)的实现要求和EPL的符合性测试要求。LINAPI是一个网络软件层，它位于LIN网络配置中（即，信号如何映射到特定帧），用于用户为专用ECU做一个应用程序。用户提供API,在LIN网络上通过信号传输。工具关注从网络配置到程序代码的步骤。提供给用户配置灵活性。LINAPI仅是一种当前可能的API,不同于其他的AUTOSAR标准中的LIN主节点的定义。因此，LINAPI作为技术报告发布，在这里所有的定义仅仅是指导性的。1范围
GB/T42691.5—2023/ISO17987-5:2016道路车辆
商局域互联网络（LIN）
第5部分：应用程序接口
本文件规定了LIN应用程序接口（API）。本文件适用于LIN通信的应用程序接口定义。2规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。www.bzxz.net
ISO17987-2道路车辆
商局域互联网络（LIN）第2部分：传输协议和网络层服务[RoadvehiclesLocal Interconnect Network (LIN)-—Part 2:Transport protocol and network layer services注：GB/T42691.2一2023道路车辆局域互连网络（LIN）第2部分：传输层协议和网络层服务（ISO17987-2：2016,IDT
ISO17987-3道路车辆
两局域互联网络（LIN）第3部分：协议规范[Roadvehicles一LocalInterconnectNetwork (LIN)—Part3:Protocol specification注：GB/T42691.3—2023道路车辆局域互连网络第3部分：协议规范（ISO17987-3：2016，IDT）3
术语和定义、缩略语
3.1术语和定义
ISO17987-2和ISO17987-3界定的术语和定义适用于本文件。2符号
下列符号适用于本文件
ⅡI：逻辑“或”二进制运算。
3缩略语
下列缩略语适用于本文件。
API：应用程序接口（aplicationprogrammersinterface）OSI：开放式系统互联（opensystemsinterconnection）PDU：协议数据单元（protocoldataunit）RX：收发器的接收引脚（Rxpinofthetransceiver）UART：通用异步收发器（universalasynchronousreceivertransmitter）1
GB/T42691.5—2023/IS017987-5：20164应用程序接口定义
4.1LIN协议集生成
LIN描述文件（LDF；见ISO17987-2）是通过工具解析并生成LIN驱动程序的配置。节点性能语言规范（NCF)一般不用于此过程，因为它面向的是描述从节点硬件，因此不需要API。工作流程的描述和LDF与NCF的角色见ISO17987-2。4.2
操作概念
4.2.1概述
API分成三个部分：
a）LIN核心API;
b）LIN节点配置和标识API；
c）LIN传输层API（可选）。
4.2.2LIN核心API
LIN核心API处理应用程序和LIN核心之间的初始化、处理和基于信号的交互。这意味着应用不需要关心和顿传输，如果需要，可使用检测特定顿传输的通知，见4.3.5，也包含控制LIN核心的API调用
API的调用主要有两个版本：
静态调用将信号或接口的名称嵌入到调用的名称中；a）
b）动态调用提供信号或接口作为参数。注：LDF中定义的命名对象（信号，调度表），使用通道后缀名扩展其名称（见ISO17987-2中的通道后缀名）。4.2.3LIN节点配置和标识API
LIN节点配置和标识API是基于服务实现的（请求/响应），即主节点应用调用一个API例程，该例程传输请求到特定从节点并等待响应。从节点设备驱动自动处理此服务LIN节点配置及标识API的行为被涵盖在节点配置及标识中（见ISO17987-3）。4.2.4LIN传输层API
LIN传输层基于报文。它的用途是作为报文的传输层，用于LIN驱动设备的外部诊断报文解释器。存在两种专有的可选API，一种原始的方式，允许应用控制每一个顺内容的发送，另一种基于报文的方式，执行全部的传输层功能。LIN传输层API行为定义见ISO17987-2。4.3
API约定
4.3.1概述
LIN核心API有一套函数（见表1),基于此理念给API一个特定的命名空间，这样是为了降低现有软件的冲突风险。所有的函数和类型都有前缀“1_”（“L”的小写字母形式跟着“下划线”）。2
Lsys_init
scalar signal read
scalar signal write
byte array read
byte array write
I_fig_tst
I_fig_elr
Lsch_tick
I_sch_set
Lif_init
L_ifc_goto_sleep
Lifc_wake_up
Life_ioctl
Life_rx
Life_tx
Life_aux
Life_read_status
Lsys_irq_disable
I_sys_irq_restore
Id_is_ready
Id_check_response
Id_assign_frame_id_range
Id_assign_NAD
API函数综述
驱动和集的管理
GB/T42691.5—2023/ISO17987-5:2016描述
执行LIN核心的初始化
信号交互
读取并返回信号的当前值
读取并返回信号的当前值
读取并返回信号中被选字节的当前值通过名字sSs设置信号中被选字节的当前值为规定的值通知
返回一个C布尔值指示通过静态API名字规定的标识的当前状态，即如果标识清除，返回0，否则非0
设置通过静态API名字规定的标识的当前状态为0调度表管理
函数为调度表提供时基
设置下一个调度表
接口管理
通过名字初始化控制器，即设置内部函数，例如比特率此调用函数请求此集中连接到这个接口的从节点通过发出一个休眠命令进人总线休眠模式
此函数发出一个唤醒信号
此函数控制其他API调用函数未涵盖的功能此应用程序负责封装中断并设置正确的接口（如果中断可用）此应用程序负责封装中断并设置正确的接口（如果中断可用）此函数在从节点中使用，用于同步主节点发出的间隔场和同步字节场序列此函数返回前一个通信的状态
用户提供服务
用户使用此函数达到LIN通信非中断的状态用户使用此函数恢复到中断前的配置节点配置
此调用函数返回最后一次请求配置服务的状态此调用函数返回最后一次节点配置服务的结果此调用函数为带配置NAD的从节点分配四个顿的保护标识符此调用函数分配所有从节点的配置NAD（节点诊断地址），匹配初始NAD，供应商ID和功能ID
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。