From 4bcb47864452b2d219572862aed3d173c3c0a945 Mon Sep 17 00:00:00 2001 From: Romain Forlot Date: Mon, 20 Feb 2017 19:37:50 +0000 Subject: Some cleaning and comments Change-Id: Iad73e3a34c5638e012819506b56741f62cfa3e30 Signed-off-by: Romain Forlot --- src/obd2.hpp | 40 ++++++++++++++++------------------------ 1 file changed, 16 insertions(+), 24 deletions(-) (limited to 'src/obd2.hpp') diff --git a/src/obd2.hpp b/src/obd2.hpp index bdccad6..42ba9fa 100644 --- a/src/obd2.hpp +++ b/src/obd2.hpp @@ -48,8 +48,8 @@ const char *UNIT_NAMES[10] = { "NM" }; -/* - * A representation of an OBD-II PID. +/** + * @brief A representation of an OBD-II PID. * * pid - The 1 byte PID. * name - A human readable name to use for this PID when published. @@ -73,8 +73,8 @@ typedef struct _Obd2Pid { } Obd2Pid; /* - * Pre-defined OBD-II PIDs to query for if supported by the vehicle. - */ +* Pre-defined OBD-II PIDs to query for if supported by the vehicle. +*/ const std::vector OBD2_PIDS { { pid: 0x04, name: "obd2.engine.load", min:0, max: 100, unit: POURCENT, frequency: 5, supported: false, event: {nullptr, nullptr} }, { pid: 0x05, name: "obd2.engine.coolant.temperature", min: -40, max: 215, unit: DEGREES_CELSIUS, frequency: 1, supported: false, event: {nullptr, nullptr} }, @@ -97,21 +97,6 @@ const std::vector OBD2_PIDS { { pid: 0x63, name: "obd2.engine.torque", min: 0, max: 65535, unit: NM, frequency: 1, supported: false, event: {nullptr, nullptr} } }; -/* Public: Check if a request is an OBD-II PID request. - * - * Returns true if the request is a mode 1 request and it has a 1 byte PID. - */ -bool isObd2Request(DiagnosticRequest* request); - -/* Public: Decode the payload of an OBD-II PID. - * - * This function matches the type signature for a DiagnosticResponseDecoder, so - * it can be used as the decoder for a DiagnosticRequest. It returns the decoded - * value of the PID, using the standard formulas (see - * http://en.wikipedia.org/wiki/OBD-II_PIDs#Mode_01). - */ -float handleObd2Pid(const DiagnosticResponse* response, float parsedPayload); - /** * @brief - Object to handle obd2 session with pre-scan of supported pid * then request them regularly @@ -141,11 +126,18 @@ class obd2_handler_t { */ bool is_obd2_signal(const char *name); - /* - * @brief pass response to UDS-C library function - * diagnostic_decode_obd2_pid() + /** + * @brief Decode the payload of an OBD-II PID. + * + * This function matches the type signature for a DiagnosticResponseDecoder, so + * it can be used as the decoder for a DiagnosticRequest. It returns the decoded + * value of the PID, using the standard formulas (see + * http://en.wikipedia.org/wiki/OBD-II_PIDs#Mode_01). * - * @return float number representing the requested value. + * @param[in] DiagnosticResponse response - the received DiagnosticResponse (the data is in response.payload, + * a byte array). This is most often used when the byte order is + * signiticant, i.e. with many OBD-II PID formulas. + * @param[in] float parsed_payload - the entire payload of the response parsed as an int. */ - bool decode_obd2_response(DiagnosticResponse* responce); + float handle_obd2_pid(const DiagnosticResponse* response, float parsedPayload); }; \ No newline at end of file -- cgit 1.2.3-korg