1 Star 4 Fork 4

亓岚 / iso15765-canbus

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

ISO15765-2 CANBus TP

C/C++ CI Codacy Badge

Compiler flags: -O3 -Wfatal-errors -Wall -std=c11

An implementation of the ISO15765-2 (ISO-TP) protocol in a platform agnostic C library. The library interacts in a transparent way with the lower ISO layers which means that the user must define the connection for the reception and the transmission of the CANBus frames. In this way you have a complete control and reusability of this library in different platforms. This library can support UDS, OBDII and any other application layer protocol that requires ISO15765-2 TP.

This ISO defines common requirements for vehicle diagnostic systems implemented on a Controller Area Network (CAN) communication link, as specified in ISO 11898. Although primarily intended for diagnostic systems, it also meets requirements from other CAN-based systems needing a network layer protocol.

How to use

  • Include the header file iso15765_2.h
  • Define an iso15765_t handler, create and attach the required shim/callbacks (send_frame on_error get_ms) of the handler
/* Required shim/callback functions */
static uint8_t send_frame(canbus_md md, uint32_t id, uint8_t dlc, uint8_t* data);
static void usdata_indication(n_indn_t* info);
static void on_error(n_rslt err_type);
static uint32_t getms();

/* ISOTP handler */
static iso15765_t handler =
{
	.addr_md = N_ADM_FIXED,		// Selected address mode of the TP
	.can_md = CANBUS_EXTENDED,	// CANBus frame type
	.config.stmin = 0x05,		// Default min. frame transmission separation
	.config.bs = 0x0F,		// Maximun size of the block sequence
	.config.n_bs = 800,		// Time until reception of the next FlowControl N_PDU
 	.config.n_cr = 250,		// Time until reception of the next ConsecutiveFrame N_PDU
	.clbs.get_ms = getms,		// Time-source for the library in ms(required)
	.clbs.on_error = on_error,	// Callback which will be executed in any occured error.
	.clbs.send_frame = send_frame,	// This callback will be fired when a transmission of a canbus frame is ready.
	.clbs.indn = usdata_indication	// Indication Callback: Will be fired when a reception
					// is available or an error occured during the reception.
};

static uint8_t send_frame(canbus_md mode, uint32_t id, uint8_t dlc, uint8_t* data)
{
    // Here transmit the frame through CANBus
    return 0;
}

static void usdata_indication(n_indn_t* info)
{
    // Use the incoming message. This function should be fired by the library when a new complete message arrives.
}

static void on_error(n_rslt err_type)
{
    // Check the errors etc..
}

static uint32_t getms()
{
    // return time in ms; 
    // ex. return GetTickCount();
}
  • In your main, first initialize the iso15765_t handler iso15765_init(&handler);

  • To send a message, create a n_req_t and use the function iso15765_send. For example:

n_req_t frame =
{
    .n_ai.n_pr = 0x06,		// Network Address Priority
    .n_ai.n_sa = 0x01,		// Network Source Address
    .n_ai.n_ta = 0x02,		// Network Target Address
    .n_ai.n_ae = 0x00,		// Network Address Extension
    .n_ai.n_tt = N_TA_T_PHY,	// Network Target Address type
    .msg = {1,2,3,4,5,6,7,8,	// Message
    	    9,10,11,12,13,14,
	    15,16,17,18,19,20},
    .msg_sz = 20,		// Message size
};
...
iso15765_send(&handler, &frame);
  • To push an incoming frame to the library use the function iso15765_enqueue(&handler, &frame);. It is suggested to put this function inside the frame reception callback of your interface
  • Use the iso15765_process(&handler); to allow the library to process the in/out streams of data. Normally you could put this function in a thread to run continuously.
  • As described before, any new/completed incoming message should be handled in the callback static void usdata_indication(indn_t* info)

Below is a complete loopback example. The service send a message to itself by enqueing the transmitted frame in the inbound stream.

#include <stdio.h>
#include <stdlib.h>
#include "iso15765_2.h"
#include <windows.h>
#include <sysinfoapi.h>

/******************************************************************************
* Declaration | Static Functions
******************************************************************************/

static uint8_t send_frame(canbus_md md, uint32_t id, uint8_t dlc, uint8_t* dt);
static void on_error(n_rslt err_type);
static uint32_t getms();

/******************************************************************************
* Enumerations, structures & Variables
******************************************************************************/

static iso15765_t handler =
{
        .addr_md = N_ADM_NORMAL,
        .can_md = CANBUS_STANDARD,
        .clbs.send_frame = send_frame,
        .clbs.on_error = on_error,
        .clbs.get_ms = getms,
        .config.stmin = 0x3,
        .config.bs = 0x0f,
        .config.n_bs = 100,
        .config.n_cr = 3
};

n_req_t frame =
{
        .n_ai.n_pr = 0x07,
        .n_ai.n_sa = 0x01,
        .n_ai.n_ta = 0x02,
        .n_ai.n_ae = 0x00,
        .n_ai.n_tt = N_TA_T_PHY,
        .msg = {1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23},
        .msg_sz = 23,
};

/******************************************************************************
* Definition  | Static Functions
******************************************************************************/

static uint32_t getms()
{
        return GetTickCount();
}

static uint8_t send_frame(canbus_md mode, uint32_t id, uint8_t dlc, uint8_t* dt)
{
        printf("%d  #1# - id:%x    dlc:%02x    ",GetTickCount(), id, dlc);
        for (int i = 0; i < 8; i++) printf("%02x ", dt[i]);
        printf("\n");
        canbus_frame_t frame = { .id = id, .dlc = 8, .mode = mode };
        memmove(frame.dt, dt, 8);
        iso15765_enqueue(&handler, &frame);
        return 0;
}

static void on_error(n_rslt err_type)
{
        printf("ERROR OCCURED!:%d", err_type);
}

/******************************************************************************
* Definition  | Public Functions
******************************************************************************/

int main()
{
        iso15765_init(&handler);

        iso15765_send(&handler, &frame);
        while(1)
        {
                iso15765_process(&handler);
                Sleep(5);
        }
        return 0;
}

Please check the folder exm for more examples

Development

This library is experimental and is still under development. The purpose is to create a complete ISO15765 library with all the described features. Feel free to suggest anything. If you use this library please ref.

Contributing

We would love you to contribute to iso15765-canbus, pull requests are welcome!

License

This project is released under the MIT License

MIT License Copyright (c) 2020 Io. D Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

Implementation of ISO15765-2 in C 展开 收起
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
1
https://gitee.com/hiker_pan/iso15765-canbus.git
git@gitee.com:hiker_pan/iso15765-canbus.git
hiker_pan
iso15765-canbus
iso15765-canbus
master

搜索帮助