GB/T 42691.5-2023 English PDF (GBT42691.5-2023)

Delivery: 3 seconds. Download true-PDF + Invoice.
Get QUOTATION in 1-minute: Click GB/T 42691.5-2023
Historical versions: GB/T 42691.5-2023
Preview True-PDF (Reload/Scroll if blank)

GB/T 42691.5-2023: Road vehicles -- Local Interconnect Network(LIN) -- Part 5: Application programmers interface (API)
GB/T 42691.5-2023
GB
NATIONAL STANDARD OF THE
PEOPLE’S REPUBLIC OF CHINA
ICS 43.040.15
CCS T 36
GB/T 42691.5-2023 / ISO 17987-5:2016
Road vehicles - Local Interconnect Network (LIN) - Part 5:
Application programmers interface (API)
(ISO 17987-5:2016, IDT)
ISSUED ON: MAY 23, 2023
IMPLEMENTED ON: DECEMBER 01, 2023
Issued by: State Administration for Market Regulation;
Standardization Administration of the People’s Republic of China.
Table of Contents
Foreword ... 3
Introduction ... 5
1 Scope ... 8
2 Normative references ... 8
3 Terms, definitions, symbols and abbreviated terms ... 8
3.1 Terms and definitions ... 8
3.2 Symbols ... 8
3.3 Abbreviated terms ... 9
4 API definitions ... 9
4.1 LIN cluster generation ... 9
4.2 Concept of operations ... 9
4.3 API conventions ... 10
4.4 Node configuration and identification ... 24
4.5 Transport layer ... 29
4.6 Examples ... 34
Bibliography ... 41
Foreword
This document was drafted in accordance with the rules provided in GB/T 1.1-2020
Directives for standardization - Part 1: Rules for the structure and drafting of
standardizing documents.
This document is Part 5 of GB/T 42691 Road vehicles - Local Interconnect Network
(LIN). The following parts have been issued for GB/T 42691:
-- Part 1: General information and use case definition;
-- Part 2: Transport protocol and network layer services;
-- Part 3: Protocol specification;
-- Part 4: Electrical physical layer (EPL) specification 12 V/24 V;
-- Part 5: Application programmers interface (API);
-- Part 6: Protocol conformance test specification;
-- Part 7: Electrical Physical Layer (EPL) conformance test specification;
-- Part 8: Electrical physical layer (EPL) specification: LIN over DC powerline (DC-
LIN).
This document is identical to ISO 17987-5:2016 Road vehicles - Local Interconnect
Network (LIN) - Part 5: Application programmers interface (API).
Please note that some of the contents of this document may involve patents. The issuing
organization of this document is not responsible for identifying patents.
This document was proposed by the Ministry of Industry and Information Technology
of the People's Republic of China.
This document shall be under the jurisdiction of National Technical Committee on Road
Vehicles of Standardization Administration of China (SAC/TC 114).
Drafting organizations of this document: Geely Automobile Research Institute (Ningbo)
Co., Ltd., China Automotive Technology and Research Center Co., Ltd., Great Wall
Motor Company Limited, FAW Car Co., Ltd., Beijing National New Energy Vehicle
Technology Innovation Center Co., Ltd., Dongfeng Motor Corporation, CATARC
(Tianjin) Automotive Engineering Research Institute Co., Ltd., Pan Asia Technical
Automotive Center Co., Ltd., FAW-Volkswagen, SAIC-GM-Wuling Automobile,
Huizhou Desay SV Automotive Co., Ltd., SAIC MAXUS Automotive Co., Ltd.
Main drafters of this document: Zhen Haichuan, Pan Junjia, Tan Tingyue, Zhu Tong,
Wang Tuo, Bian Zeyu, Li Zhaolin, Li Min, Han Guangsheng, Qu Yunge, Dong Hui, Qin
Road vehicles - Local Interconnect Network (LIN) - Part 5:
Application programmers interface (API)
1 Scope
This document has been established in order to define the LIN application programmers
interface (API).
This document applies to the definition of application programmers interface of LIN
communication.
2 Normative references
The following documents are referred to in the text in such a way that some or all of
their content constitutes requirements of this document. For dated references, only the
version corresponding to that date is applicable to this document; for undated references,
the latest version (including all amendments) is applicable to this document.
ISO 17987-2, Road vehicles - Local Interconnect Network (LIN) - Part 2: Transport
protocol and network layer services
Note: GB/T 42691.2-2023, Road vehicles - Local Interconnect Network (LIN) - Part
2: Transport protocol and network layer services (ISO 17987-2:2016, IDT)
ISO 17987-3, Road vehicles - Local Interconnect Network (LIN) - Part 3: Protocol
specification
Note: GB/T 42691.3-2023, Road vehicles - Local Interconnect Network (LIN) - Part
3: Protocol specification (ISO 17987-3:2016, IDT)
3 Terms, definitions, symbols and abbreviated terms
3.1 Terms and definitions
For the purposes of this document, the terms and definitions given in ISO 17987-2 and
ISO 17987-3 apply.
3.2 Symbols
For the purposes of this document, the following symbols apply.
||: logical OR binary operation.
3.3 Abbreviated terms
For the purposes of this document, the following abbreviated terms apply.
API: application programmers interface
OSI: open systems interconnection
PDU: protocol data unit
RX: Rx pin of the transceiver
UART: universal asynchronous receiver transmitter
4 API definitions
4.1 LIN cluster generation
The LIN Description file (LDF; see ISO 17987-2) is parsed by a tool and generates a
configuration for the LIN device driver. The node capability language specification
(NCF) is normally not used in this process since its intention is to describe a hardware
slave node, and therefore, does not need the API. See ISO 17987-2 for a description of
the workflow and the roles of the LDF and NCF.
4.2 Concept of operations
4.2.1 General
The API is split in three areas:
a) LIN core API;
b) LIN node configuration and identification API;
c) LIN transport layer API (optional).
4.2.2 LIN core API
The LIN core API handles initialization, processing and a signal based interaction
between the application and the LIN core. This implies that the application does not
have to bother with frames and transmission of frames. Notification exists to detect
transfer of a specific frame if this is necessary, see 4.3.5. API calls to control the LIN
core also exist.
Two versions exist of most of the API calls:
a) static calls embed the name of the signal or interface in the name of the call;