J1939_Config.H 9.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332
  1. /*********************************************************************
  2. *
  3. * J1939 Main Source Code
  4. *
  5. *********************************************************************
  6. *
  7. * 本程序是由XieTongXueFlyMe对现有的J1939协议文档分析,和对前辈的贡献总结,
  8. * 写出的一套开源的J1939驱动。
  9. * 本协议特点:
  10. * 1.易移植(不针对特定的CAN硬件,只要满足CAN2.0B即可)
  11. * 2.轻量级(可适应低端的MCU)
  12. * 3.支持多任务调用接口(可用于嵌入式系统)
  13. * 4.双模式(轮询或者中断,逻辑更加简单明了)
  14. * 5.不掉帧(数据采用收发列队缓存)
  15. *
  16. * 源代码下载:
  17. * https://github.com/XeiTongXueFlyMe/J1939
  18. * 源代码临时手册Web站点:
  19. * https://xeitongxueflyme.github.io/j1939doc.github.io/
  20. *
  21. * Version Date Description
  22. * -------------------------------------------------------------------
  23. * v1.0.0 2017/06/04 首个版本 Version 1 测试版发布
  24. * v1.0.1 2017/08/04 完善功能
  25. * v1.1.0 2017/11/22 Version 1 稳定发布版
  26. * v2.0.1 2017/11/24 Version 2 测试版发布
  27. * v2.0.2 2018/01/03 解决V2.0.1 遗留问题
  28. * v2.1.0 2018/01/20 Version 2 稳定发布版
  29. * Author Date changes
  30. *~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  31. *XeiTongXueFlyMe 7/06/04 首个版本
  32. *XeiTongXueFlyMe 7/08/04 增加对TP的支持
  33. *XeiTongXueFlyMe 7/11/24 增加对多路CAN硬件的收发,和报文处理
  34. *XeiTongXueFlyMe 7/11/29 增加请求和响应API
  35. *XeiTongXueFlyMe 7/12/07 重做TP接受API函数
  36. *XeiTongXueFlyMe 7/12/08 增加软件滤波器
  37. *XeiTongXueFlyMe 8/01/03 重做接受发送API,简化协议栈初始化调用逻辑
  38. **********************************************************************/
  39. #ifndef __J1939_Config_H
  40. #define __J1939_Config_H
  41. #include "J1939.H"
  42. #include "can_interface.h"
  43. #include "queue.h"
  44. #include <stdint.h>
  45. #include <string.h>
  46. extern uint8_t push_can_message_to_queue(uint32_t id, uint8_t len, uint8_t *p_data);
  47. extern CAN_NODE Can_Node; // CAN硬件选择
  48. /***************************J1939 地址配置*****************************/
  49. // 设备默认的地址(地址命名是有规定的,参考J1939的附录B 地址和标识符的分配)
  50. #define J1939_STARTING_ADDRESS_1 0xF4
  51. #define J1939_STARTING_ADDRESS_2 244
  52. #define J1939_STARTING_ADDRESS_3 247
  53. #define J1939_STARTING_ADDRESS_4 0
  54. /******************************J1939功能配置***************************/
  55. #define J1939_RX_QUEUE_SIZE 3
  56. // 当mcu来不及处理消息,接收消息列队是否允许被新的消息覆盖
  57. #define J1939_OVERWRITE_RX_QUEUE J1939_FALSE
  58. #define J1939_TX_QUEUE_SIZE 3
  59. // 当mcu来不及处理消息,发送消息列队是否允许被新的消息覆盖
  60. #define J1939_OVERWRITE_TX_QUEUE J1939_FALSE
  61. // 是否使用轮询模式(否则使用中断模式)
  62. #define J1939_POLL_ECAN J1939_TRUE
  63. // 是否启用软件滤波器
  64. #define J1939SoftwareFilterEn J1939_TRUE
  65. /******************************J1939移植配置函数************************/
  66. #define Port_CAN_Transmit(MsgPtr) J1939_CAN_Transmit(MsgPtr)
  67. #define Port_CAN_Receive(MsgPtr) J1939_CAN_Receive(MsgPtr)
  68. #define Port_SetAddressFilter(Address) J1939_SetAddressFilter(Address)
  69. /*不使用中断模式,不对下面的函数进行移植*/
  70. #if J1939_POLL_ECAN == J1939_FALSE
  71. #define Port_RXinterruptEnable() J1939_RXinterruptEnable()
  72. #define Port_RXinterruptDisable() J1939_RXinterruptDisable()
  73. #define Port_TXinterruptEnable() J1939_TXinterruptEnable()
  74. #define Port_TXinterruptDisable() J1939_TXinterruptDisable()
  75. #define Port_TXinterruptOk() J1939_TXinterruptOk()
  76. #define Port_CAN_identifier_clc() CAN_identifier_clc()
  77. #endif
  78. /***************************************************************************************/
  79. /*
  80. *输入:
  81. *输出:
  82. *说明:基于SAE J1939协议,我们需要CAN控制器提供至少3个滤波器给J1939协议代码。三个滤波器分别配置如下:
  83. 1. 设置滤波器0,只接受广播信息(PF = 240 -255)。
  84. 2. 设置设置滤波器1,2只接受全局地址(J1939_GLOBAL_ADDRESS)
  85. 3. 随着程序的运行,将改变滤波器2,来适应程序逻辑。
  86. J1939_SetAddressFilter() 是用来设置滤波器2的, 函数主要设置PS位(目标地址),其目的是,让控制器
  87. 只接受发送给本设备的消息。
  88. *警告: 滤波器0,1是在CAN驱动里配置,如果对硬件滤波配置不是很熟练,可以使能软件滤波器,#define J1939SoftwareFilterEn
  89. *则可跳过本函数的移植和CAN硬件滤波器的配置,为了J1939协议栈性能最优化,建议只是用硬件滤波。
  90. */
  91. void J1939_SetAddressFilter(unsigned char Ps_Address)
  92. {
  93. switch (Can_Node)
  94. {
  95. case Select_CAN_NODE_1:
  96. {
  97. break;
  98. }
  99. case Select_CAN_NODE_2:
  100. {
  101. break;
  102. }
  103. case Select_CAN_NODE_3:
  104. {
  105. break;
  106. }
  107. case Select_CAN_NODE_4:
  108. {
  109. break;
  110. }
  111. default:
  112. {
  113. break;
  114. }
  115. }
  116. }
  117. /*
  118. *输入: *MsgPtr ,协议要发送的消息,
  119. *输出:
  120. *说明: 将数据 从MsgPtr结构体赋值到CAN驱动自带的结构体中
  121. 先将传入函数的MsgPtr中的数据写到CAN的结构体,再调用CAN驱动的发送函数
  122. 默认支持4路CAN硬件的收发。如少于4路,只需配置相应的Can_Node开关代码区,
  123. 其他(Select_CAN_NODE)保持不变。就直接返回(break)。
  124. */
  125. void J1939_CAN_Transmit(J1939_MESSAGE *MsgPtr)
  126. {
  127. pdu_tag j1939_tx_data;
  128. switch (Can_Node)
  129. {
  130. case Select_CAN_NODE_1:
  131. {
  132. j1939_tx_data.id.b.sa = MsgPtr->Mxe.SourceAddress;
  133. j1939_tx_data.id.b.ps = MsgPtr->Mxe.PDUSpecific;
  134. j1939_tx_data.id.b.pf = MsgPtr->Mxe.PDUFormat;
  135. j1939_tx_data.id.b.dp = 0; // MsgPtr->Mxe.DataPage;
  136. j1939_tx_data.id.b.r = 0; // MsgPtr->Mxe.Res;
  137. j1939_tx_data.id.b.p = MsgPtr->Mxe.Priority;
  138. j1939_tx_data.reg.dlc = MsgPtr->Mxe.DataLength;
  139. memcpy(j1939_tx_data.data.u8_buf, MsgPtr->Mxe.Data, MsgPtr->Mxe.DataLength);
  140. push_can_message_to_queue(j1939_tx_data.id.r, j1939_tx_data.reg.dlc, j1939_tx_data.data.u8_buf);
  141. break;
  142. }
  143. case Select_CAN_NODE_2:
  144. {
  145. /*加载第二路CAN硬件的29位ID*/
  146. /*CAN硬件加载数据长度*/
  147. /*CAN硬件加载数据*/
  148. /*CAN硬件加载RTR*/
  149. // CAN硬件开始发送数据
  150. break;
  151. }
  152. case Select_CAN_NODE_3:
  153. {
  154. /*加载第三路CAN硬件的29位ID*/
  155. /*CAN硬件加载数据长度*/
  156. /*CAN硬件加载数据*/
  157. /*CAN硬件加载RTR*/
  158. // CAN硬件开始发送数据
  159. break;
  160. }
  161. case Select_CAN_NODE_4:
  162. {
  163. /*加载第四路CAN硬件的29位ID*/
  164. /*CAN硬件加载数据长度*/
  165. /*CAN硬件加载数据*/
  166. /*CAN硬件加载RTR*/
  167. // CAN硬件开始发送数据
  168. break;
  169. }
  170. default:
  171. {
  172. break;
  173. }
  174. }
  175. }
  176. /*
  177. *输入: *MsgPtr 数据要存入的内存的指针
  178. *输出: 1 | 0
  179. *说明: 读取CAN驱动的数据,如果没有数据,返回0
  180. 将CAN中的数据取出,存入J1939_MESSAGE结构体中
  181. 默认支持4路CAN硬件的收发。如少于4路,只需配置相应的Can_Node开关代码区,
  182. 其他(Select_CAN_NODE)保持不变。就直接返回(return 0)
  183. */
  184. queue_entry(J1939_MESSAGE, 10) j1939_rx_queue;
  185. int J1939_CAN_Receive(J1939_MESSAGE *MsgPtr)
  186. {
  187. j1939_uint8_t rec = RC_SUCCESS;
  188. QUEUE_STATUS status;
  189. switch (Can_Node)
  190. {
  191. case Select_CAN_NODE_1:
  192. {
  193. de_queue(&j1939_rx_queue, (*MsgPtr), status);
  194. if (status == Q_EMPTY)
  195. {
  196. return 0;
  197. }
  198. return 1;
  199. break;
  200. }
  201. case Select_CAN_NODE_2:
  202. {
  203. if ("你的代码") // 判断CAN硬件2是否有数据到来
  204. {
  205. // 你的代码,从CAN硬件2 中将数据读取后,存入 MsgPtr
  206. return 1;
  207. }
  208. return 0;
  209. break;
  210. }
  211. case Select_CAN_NODE_3:
  212. {
  213. if ("你的代码") // 判断CAN硬件3是否有数据到来
  214. {
  215. // 你的代码,从CAN硬件3 中将数据读取后,存入 MsgPtr
  216. return 1;
  217. }
  218. return 0;
  219. break;
  220. }
  221. case Select_CAN_NODE_4:
  222. {
  223. if ("你的代码") // 判断CAN硬件4是否有数据到来
  224. {
  225. // 你的代码,从CAN硬件4 中将数据读取后,存入 MsgPtr
  226. return 1;
  227. }
  228. return 0;
  229. break;
  230. }
  231. default:
  232. {
  233. return 0; // 没有消息
  234. break;
  235. }
  236. }
  237. return 0; // 没有消息
  238. }
  239. /*不使用中断模式,不对下面的函数进行移植*/
  240. #if J1939_POLL_ECAN == J1939_FALSE
  241. /*
  242. *输入:
  243. *输出:
  244. *说明:使能接受中断
  245. */
  246. void J1939_RXinterruptEnable()
  247. {
  248. ;
  249. }
  250. /*
  251. *输入:
  252. *输出:
  253. *说明:失能接受中断
  254. */
  255. void J1939_RXinterruptDisable()
  256. {
  257. ;
  258. }
  259. /*
  260. *输入:
  261. *输出:
  262. *说明:使能发送中断
  263. */
  264. void J1939_TXinterruptEnable()
  265. {
  266. ;
  267. }
  268. /*
  269. *输入:
  270. *输出:
  271. *说明:失能发送中断
  272. */
  273. void J1939_TXinterruptDisable()
  274. {
  275. ;
  276. }
  277. /*
  278. *输入:
  279. *输出:
  280. *说明:触发发送中断标致位,当协议栈在中断模式下,要发送消息,将调用此函数
  281. CAN驱动函数,就将直接把消息发送出去,不需要协议在调用任何can驱动函数
  282. */
  283. void J1939_TXinterruptOk()
  284. {
  285. ;
  286. }
  287. /*
  288. *输入:
  289. *输出:
  290. *说明:清除CAN驱动相关的中断产生标识位,包括(发送中断标志位,接受中断标
  291. 志位,can总线错误标识位)
  292. */
  293. void CAN_identifier_clc()
  294. {
  295. ;
  296. }
  297. #endif
  298. #endif