iprotocolhandler.h
Go to the documentation of this file.
1 
2 // Copyright (c) 2003-2021 Xsens Technologies B.V. or subsidiaries worldwide.
3 // All rights reserved.
4 //
5 // Redistribution and use in source and binary forms, with or without modification,
6 // are permitted provided that the following conditions are met:
7 //
8 // 1. Redistributions of source code must retain the above copyright notice,
9 // this list of conditions, and the following disclaimer.
10 //
11 // 2. Redistributions in binary form must reproduce the above copyright notice,
12 // this list of conditions, and the following disclaimer in the documentation
13 // and/or other materials provided with the distribution.
14 //
15 // 3. Neither the names of the copyright holders nor the names of their contributors
16 // may be used to endorse or promote products derived from this software without
17 // specific prior written permission.
18 //
19 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
20 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
21 // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
22 // THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
23 // SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
24 // OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY OR
26 // TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
27 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.THE LAWS OF THE NETHERLANDS
28 // SHALL BE EXCLUSIVELY APPLICABLE AND ANY DISPUTES SHALL BE FINALLY SETTLED UNDER THE RULES
29 // OF ARBITRATION OF THE INTERNATIONAL CHAMBER OF COMMERCE IN THE HAGUE BY ONE OR MORE
30 // ARBITRATORS APPOINTED IN ACCORDANCE WITH SAID RULES.
31 //
32 
33 
34 // Copyright (c) 2003-2021 Xsens Technologies B.V. or subsidiaries worldwide.
35 // All rights reserved.
36 //
37 // Redistribution and use in source and binary forms, with or without modification,
38 // are permitted provided that the following conditions are met:
39 //
40 // 1. Redistributions of source code must retain the above copyright notice,
41 // this list of conditions, and the following disclaimer.
42 //
43 // 2. Redistributions in binary form must reproduce the above copyright notice,
44 // this list of conditions, and the following disclaimer in the documentation
45 // and/or other materials provided with the distribution.
46 //
47 // 3. Neither the names of the copyright holders nor the names of their contributors
48 // may be used to endorse or promote products derived from this software without
49 // specific prior written permission.
50 //
51 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
52 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
53 // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
54 // THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
55 // SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
56 // OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
57 // HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY OR
58 // TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
59 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.THE LAWS OF THE NETHERLANDS
60 // SHALL BE EXCLUSIVELY APPLICABLE AND ANY DISPUTES SHALL BE FINALLY SETTLED UNDER THE RULES
61 // OF ARBITRATION OF THE INTERNATIONAL CHAMBER OF COMMERCE IN THE HAGUE BY ONE OR MORE
62 // ARBITRATORS APPOINTED IN ACCORDANCE WITH SAID RULES.
63 //
64 
65 #ifndef IPROTOCOLHANDLER_H
66 #define IPROTOCOLHANDLER_H
67 
68 #include "messagelocation.h"
69 #include "xsprotocoltype.h"
70 #include <xstypes/xsmessage.h>
71 #include <xstypes/xsbytearray.h>
72 
73 //--------------------------------------------------------------------------------
79 {
80 public:
82  virtual ~IProtocolHandler() {}
83 
98  virtual MessageLocation findMessage(XsProtocolType& type, const XsByteArray& raw) const = 0;
99 
105  virtual XsMessage convertToMessage(MessageLocation& location, const XsByteArray& raw) const = 0;
106 
111  virtual int minimumMessageSize() const = 0;
112 
117  virtual int maximumMessageSize() const = 0;
118 
124  virtual int type() const = 0;
125 
132  virtual void ignoreMaximumMessageSize(bool ignore)
133  {
134  (void) ignore;
135  }
136 
142  virtual bool setEnable(bool enable)
143  {
144  (void) enable;
145  return false;
146  }
147 };
148 
149 //--------------------------------------------------------------------------------
150 
151 #endif
XsByteArray
A list of uint8_t values.
IProtocolHandler::ignoreMaximumMessageSize
virtual void ignoreMaximumMessageSize(bool ignore)
Tells the protocol handler to ignore/expand its maximum message size.
Definition: iprotocolhandler.h:132
messagelocation.h
IProtocolHandler::type
virtual int type() const =0
Returns the type of the protocol handler.
xsprotocoltype.h
IProtocolHandler::maximumMessageSize
virtual int maximumMessageSize() const =0
Returns the maximum size of a valid message.
IProtocolHandler
Interface class for protocol handlers.
Definition: iprotocolhandler.h:78
IProtocolHandler::minimumMessageSize
virtual int minimumMessageSize() const =0
Returns the minimum size of a valid message.
IProtocolHandler::setEnable
virtual bool setEnable(bool enable)
Enables or disables the protocol handler if supported. A disabled protocol handler ignores and discar...
Definition: iprotocolhandler.h:142
XsMessage
Structure for storing a single message.
Definition: xsmessage.h:202
IProtocolHandler::findMessage
virtual MessageLocation findMessage(XsProtocolType &type, const XsByteArray &raw) const =0
Find the first message in the raw byte stream.
IProtocolHandler::convertToMessage
virtual XsMessage convertToMessage(MessageLocation &location, const XsByteArray &raw) const =0
Converts raw data using location into a XsMessage object.
xsmessage.h
XsProtocolType
XsProtocolType
Protocol types (XsDevice::enableProtocol())
Definition: xsprotocoltype.h:72
IProtocolHandler::~IProtocolHandler
virtual ~IProtocolHandler()
Destructor.
Definition: iprotocolhandler.h:82
xsbytearray.h
MessageLocation
Stores the location of a message in a buffer using a start position and a size.
Definition: messagelocation.h:70


xsens_mti_driver
Author(s):
autogenerated on Sun Sep 3 2023 02:43:20