2 * Copyright (C) 2015, 2016 "IoT.bzh"
3 * Author "Romain Forlot" <romain.forlot@iot.bzh>
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
23 #include "uds/uds_types.h"
24 #include "../can/can-bus-dev.hpp"
25 #include "../can/can-message.hpp"
26 #include "diagnostic-manager.hpp"
28 #include "../low-can-binding.hpp"
30 class active_diagnostic_request_t;
31 class diagnostic_manager_t;
33 /* Public: The signature for an optional function that can apply the neccessary
34 * formula to translate the binary payload into meaningful data.
36 * response - the received DiagnosticResponse (the data is in response.payload,
37 * a byte array). This is most often used when the byte order is
38 * signiticant, i.e. with many OBD-II PID formulas.
39 * parsed_payload - the entire payload of the response parsed as an int.
41 typedef float (*DiagnosticResponseDecoder)(const DiagnosticResponse* response,
42 float parsed_payload);
44 /* Public: The signature for an optional function to handle a new diagnostic
47 * manager - The DiagnosticsManager providing this response.
48 * request - The original diagnostic request.
49 * response - The response object that was just received.
50 * parsed_payload - The payload of the response, parsed as a float.
52 typedef void (*DiagnosticResponseCallback)(const active_diagnostic_request_t* request,
53 const DiagnosticResponse* response, float parsed_payload);
56 * @brief An active diagnostic request, either recurring or one-time.
58 class active_diagnostic_request_t {
60 can_bus_dev_t* bus_; /*!< bus_ - The CAN bus this request should be made on, or is currently in flight-on*/
61 uint32_t id_; /*!< id_ - The arbitration ID (aka message ID) for the request.*/
62 DiagnosticRequestHandle* handle_; /*!< handle_ - A handle for the request to keep track of it between
63 * sending the frames of the request and receiving all frames of the response.*/
64 std::string name_; /*!< name_ - An optional human readable name this response, to be used when publishing received
65 * responses. If the name is NULL, the published output will use the raw OBD-II response format.*/
66 DiagnosticResponseDecoder decoder_; /*!< decoder_ - An optional DiagnosticResponseDecoder to parse the payload of responses
67 * to this request. If the decoder is NULL, the output will include the raw payload
68 * instead of a parsed value.*/
69 DiagnosticResponseCallback callback_; /*!< callback_ - An optional DiagnosticResponseCallback to be notified whenever a
70 * response is received for this request.*/
71 bool recurring_; /*!< bool recurring_ - If true, this is a recurring request and it will remain as active until explicitly cancelled.
72 * The frequencyClock attribute controls how often a recurrin request is made.*/
73 bool wait_for_multiple_responses_; /*!< wait_for_multiple_responses_ - False by default, when any response is received for a request
74 * it will be removed from the active list. If true, the request will remain active until the timeout
75 * clock expires, to allow it to receive multiple response (e.g. to a functional broadcast request).*/
76 bool in_flight_; /*!< in_flight_ - True if the request has been sent and we are waiting for a response.*/
77 frequency_clock_t frequency_clock_; /*!< frequency_clock_ - A frequency_clock_t object to control the send rate for a
78 * recurring request. If the request is not reecurring, this attribute is not used.*/
79 frequency_clock_t timeout_clock_; /*!< timeout_clock_ - A frequency_clock_t object to monitor how long it's been since
80 * this request was sent.*/
82 active_diagnostic_request_t();
84 void updateDiagnosticRequestEntry(diagnostic_manager_t* manager, can_bus_dev_t* bus, DiagnosticRequest* request,
85 const std::string name, bool wait_for_multiple_responses, const DiagnosticResponseDecoder decoder,
86 const DiagnosticResponseCallback callback, float frequencyHz);