Jason Gaunt / GMLAN

Libraries to support working with GMLAN - General Motors CAN BUS network in most of their vehicles between 2007-present day. Please note this is a work in progress and not guaranteed to be correct, use at your own risk! Read commit logs / subscribe to see what has been added, it's a work in progress after all ;)

GMLAN.h@5:d0b067be6d44, 2013-03-19 (annotated)

Committer:
foxdie
Date:
Tue Mar 19 10:03:21 2013 +0000
Revision:
5:d0b067be6d44
Parent:
4:486fec88517e
Child:
6:32592425aa57
Fixed a couple of syntax errors

Who changed what in which revision?

UserRevisionLine numberNew contents of line
foxdie 0:9266fbfbef88 1 /*
foxdie 0:9266fbfbef88 2 GMLAN.h - Header file for GMLAN Library
foxdie 0:9266fbfbef88 3
foxdie 0:9266fbfbef88 4 GMLAN is a Controller Area Network Bus used in General Motors vehicles from
foxdie 0:9266fbfbef88 5 roughly 2007-onwards. Its purpose is to allow various Electronic Control Units
foxdie 0:9266fbfbef88 6 (aka ECUs) within a modern vehicle to share information and enact procedures.
foxdie 0:9266fbfbef88 7
foxdie 0:9266fbfbef88 8 An example of this would be communication between the HU (Head unit) and the
foxdie 0:9266fbfbef88 9 DIC (Dashboard Information Cluster), when you adjust the volume up / down, this
foxdie 0:9266fbfbef88 10 is reported to the cluster to be displayed.
foxdie 0:9266fbfbef88 11
foxdie 0:9266fbfbef88 12 It is the function of this library to "crack open" this world to allow anyone
foxdie 0:9266fbfbef88 13 with only as little as a few hours of C++ programming under their belt to get
foxdie 0:9266fbfbef88 14 started in what can sometimes seem a daunting world.
foxdie 0:9266fbfbef88 15
foxdie 0:9266fbfbef88 16 Jason Gaunt, 18th Feb 2013
foxdie 0:9266fbfbef88 17 */
foxdie 0:9266fbfbef88 18
foxdie 5:d0b067be6d44 19 #include "mbed.h"
foxdie 2:1a2cb289f24d 20 #include "GMLAN_29bit.h"
foxdie 4:486fec88517e 21 #include "GMLAN_11bit.h"
foxdie 5:d0b067be6d44 22 #include <vector>
foxdie 2:1a2cb289f24d 23
foxdie 0:9266fbfbef88 24 #ifndef GMLAN_H
foxdie 0:9266fbfbef88 25 #define GMLAN_H
foxdie 0:9266fbfbef88 26
foxdie 0:9266fbfbef88 27 /* Baud rates of various services */
foxdie 0:9266fbfbef88 28 #define GMLAN_BAUD_LS_NORMAL 33333
foxdie 0:9266fbfbef88 29 #define GMLAN_BAUD_LS_FAST 83333
foxdie 0:9266fbfbef88 30 #define GMLAN_BAUD_MS 95200
foxdie 0:9266fbfbef88 31 #define GMLAN_BAUD_HS 500000
foxdie 0:9266fbfbef88 32
foxdie 0:9266fbfbef88 33 class CANHeader {
foxdie 3:09fdfec053cd 34 /*
foxdie 3:09fdfec053cd 35 CANHeader was designed solely for 29-bit frames but supports 11-bit too by just setting the ArbID
foxdie 3:09fdfec053cd 36
foxdie 3:09fdfec053cd 37 Example 29-bit header packet from Steering Wheel Switches:
foxdie 3:09fdfec053cd 38
foxdie 3:09fdfec053cd 39 Hexadecimal: 0x10 0x0D 0x00 0x60
foxdie 3:09fdfec053cd 40 Binary: 00010000 00001101 00000000 01100000
foxdie 3:09fdfec053cd 41 Priority: ---
foxdie 3:09fdfec053cd 42 Arbitration: -- -------- ---
foxdie 3:09fdfec053cd 43 Sending ECU: ----- --------
foxdie 3:09fdfec053cd 44
foxdie 3:09fdfec053cd 45 Example 11-bit header packet from Head Unit:
foxdie 3:09fdfec053cd 46
foxdie 3:09fdfec053cd 47 Hexadecimal: 0x02 0x44
foxdie 3:09fdfec053cd 48 Binary: 00000010 01000100
foxdie 3:09fdfec053cd 49 Identifier: --- --------
foxdie 3:09fdfec053cd 50
foxdie 3:09fdfec053cd 51 */
foxdie 0:9266fbfbef88 52
foxdie 0:9266fbfbef88 53 private:
foxdie 0:9266fbfbef88 54 int priorityID, arbitrationID, senderID;
foxdie 0:9266fbfbef88 55
foxdie 0:9266fbfbef88 56 public:
foxdie 1:9dfa8ee351a3 57 // Main function
foxdie 1:9dfa8ee351a3 58 CANHeader() { }
foxdie 3:09fdfec053cd 59
foxdie 0:9266fbfbef88 60 // Methods for getting / setting priority, both integers
foxdie 0:9266fbfbef88 61 int priority(void) { return priorityID; }
foxdie 0:9266fbfbef88 62 void priority(int _priority) { priorityID = _priority; }
foxdie 3:09fdfec053cd 63
foxdie 0:9266fbfbef88 64 // Method for getting / setting arbitration id aka arbid, both integers
foxdie 0:9266fbfbef88 65 int arbitration(void) { return arbitrationID; }
foxdie 0:9266fbfbef88 66 void arbitration(int _arbitration) { arbitrationID = _arbitration; }
foxdie 3:09fdfec053cd 67
foxdie 0:9266fbfbef88 68 // Method for getting / setting sender id, both integers
foxdie 0:9266fbfbef88 69 int sender(void) { return senderID; }
foxdie 0:9266fbfbef88 70 void sender(int _sender) { senderID = _sender; }
foxdie 0:9266fbfbef88 71
foxdie 3:09fdfec053cd 72 // Function to decode either an 11-bit or 29-bit header packet and store values in respective variables
foxdie 0:9266fbfbef88 73 void decode(int _header);
foxdie 3:09fdfec053cd 74
foxdie 3:09fdfec053cd 75 // Function to encode stored values as 29-bit header and return header packet as int
foxdie 3:09fdfec053cd 76 int encode29bit(void);
foxdie 4:486fec88517e 77
foxdie 4:486fec88517e 78 // Function to encode stored values as 11-bit header and return header packet as int
foxdie 4:486fec88517e 79 int encode11bit(void);
foxdie 0:9266fbfbef88 80 };
foxdie 0:9266fbfbef88 81
foxdie 5:d0b067be6d44 82 class GMLAN_Message {
foxdie 5:d0b067be6d44 83 /*
foxdie 5:d0b067be6d44 84 Wrapper for CANMessage that automatically parses settings
foxdie 5:d0b067be6d44 85 */
foxdie 5:d0b067be6d44 86 private:
foxdie 5:d0b067be6d44 87 vector<char> data;
foxdie 5:d0b067be6d44 88 int priority, arbitration, sender;
foxdie 5:d0b067be6d44 89
foxdie 5:d0b067be6d44 90 public:
foxdie 5:d0b067be6d44 91 // Main function
foxdie 5:d0b067be6d44 92 GMLAN_Message(int _priority = -1, int _arbitration = -1, int _sender = -1,
foxdie 5:d0b067be6d44 93 int _b0 = -1, int _b1 = -1, int _b2 = -1, int _b3 = -1, int _b4 = -1, int _b5 = -1, int _b6 = -1, int _b7 = -1);
foxdie 5:d0b067be6d44 94
foxdie 5:d0b067be6d44 95 // Return result
foxdie 5:d0b067be6d44 96 CANMessage generate(void);
foxdie 5:d0b067be6d44 97 };
foxdie 5:d0b067be6d44 98
foxdie 0:9266fbfbef88 99 #endif