QtFit  0.1
Internal library development documentation
All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
softwaremessage.cpp
Go to the documentation of this file.
1 /*
2  Copyright 2021 Paul Colby
3 
4  This file is part of QtFit.
5 
6  QtFit is free software: you can redistribute it and/or modify
7  it under the terms of the GNU Lesser General Public License as published by
8  the Free Software Foundation, either version 3 of the License, or
9  (at your option) any later version.
10 
11  QtFit is distributed in the hope that it will be useful,
12  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  GNU Lesser General Public License for more details.
15 
16  You should have received a copy of the GNU Lesser General Public License
17  along with QtFit. If not, see <http://www.gnu.org/licenses/>.
18 */
19 
20 /*!
21  * \file
22  * \note This file is automatcially generated. Any changes here are likely to be overwritten.
23  */
24 
25 /*!
26  * \file
27  * Defines the SoftwareMessage, and SoftwareMessagePrivate classes.
28  */
29 
30 #include "softwaremessage.h"
31 #include "softwaremessage_p.h"
32 
33 #include <QDebug>
34 #include <QtEndian>
35 
37 
38 /*!
39  * \class SoftwareMessage
40  *
41  * The SoftwareMessage class represents a FIT SoftwareMessage data message.
42  *
43  * \sa DataMessage
44  */
45 
46 /*!
47  * Constructs a SoftwareMessage object.
48  *
49  * Typically, instances of this class will be returned by FitStreamReader::readNext, but this
50  * constructor may be used, along with the relevant setter methods, to create a valid message.
51  */
53 {
54 
55 }
56 
57 /*!
58  * \internal
59  *
60  * Constructs a SoftwareMessage object with private implementation \a d.
61  *
62  * \param d Pointer to private implementation.
63  */
65 {
66 
67 }
68 
69 /*!
70  * Returns the SoftwareMessage data message's \c messageIndex field's current value.
71  *
72  * \return the \c messageIndex field value.
73  */
75 {
76  Q_D(const SoftwareMessage);
77  return d->messageIndex;
78 }
79 
80 /*!
81  * Returns the SoftwareMessage data message's \c version field's current value.
82  *
83  * \return the \c version field value.
84  */
85 quint16 SoftwareMessage::version() const
86 {
87  Q_D(const SoftwareMessage);
88  return d->version;
89 }
90 
91 /*!
92  * Returns the SoftwareMessage data message's \c partNumber field's current value.
93  *
94  * \return the \c partNumber field value.
95  */
97 {
98  Q_D(const SoftwareMessage);
99  return d->partNumber;
100 }
101 
102 /*!
103  * Sets the \c messageIndex field to \a messageIndex.
104  *
105  * \param messageIndex The field value to set.
106  */
108 {
109  Q_D(SoftwareMessage);
110  d->messageIndex = messageIndex;
111 }
112 /*!
113  * Sets the \c version field to \a version.
114  *
115  * \param version The field value to set.
116  */
117 void SoftwareMessage::setVersion(const quint16 version)
118 {
119  Q_D(SoftwareMessage);
120  d->version = version;
121 }
122 /*!
123  * Sets the \c partNumber field to \a partNumber.
124  *
125  * \param partNumber The field value to set.
126  */
127 void SoftwareMessage::setPartNumber(const QString partNumber)
128 {
129  Q_D(SoftwareMessage);
130  d->partNumber = partNumber;
131 }
132 
133 /// \cond internal
134 
135 /*!
136  * \internal
137  *
138  * \class SoftwareMessagePrivate
139  *
140  * The SoftwareMessagePrivate class provides private implementation for the SoftwareMessage.
141  *
142  * \sa SoftwareMessage
143  */
144 
145 /*!
146  * \internal
147  *
148  * Constructs a SoftwareMessagePrivate object with public implementation \a q.
149  *
150  * \param q Pointer to public implementaton.
151  */
152 SoftwareMessagePrivate::SoftwareMessagePrivate(SoftwareMessage * const q)
154  , messageIndex(static_cast<MessageIndex>(-1))
155  , version(0xFFFF)
156 {
157  globalMessageNumber = MesgNum::Software;
158 }
159 
160 /*!
161  * \internal
162  *
163  * Destroys the SoftwareMessagePrivate object.
164  */
166 {
167 
168 }
169 
171  const int fieldId, const QByteArray &data, const FitBaseType baseType, const bool bigEndian)
172 {
173  switch (fieldId) {
174  case 254: // See Profile.xlsx::Messages:software.messageIndex
175  if (!verify(data, baseType, 2, FitBaseType::Uint16, "software.messageIndex")) return false;
176  this->messageIndex = static_cast<MessageIndex>(bigEndian ? qFromBigEndian<quint16>(data) : qFromLittleEndian<quint16>(data));
177  break;
178  case 3: // See Profile.xlsx::Messages:software.version
179  if (!verify(data, baseType, 2, FitBaseType::Uint16, "software.version")) return false;
180  this->version = static_cast<quint16>(bigEndian ? qFromBigEndian<quint16>(data) : qFromLittleEndian<quint16>(data));
181  break;
182  case 5: // See Profile.xlsx::Messages:software.partNumber
183  if (!verify(data, baseType, 1, FitBaseType::String, "software.partNumber")) return false;
184  this->partNumber = QString::fromUtf8(data);
185  break;
186  default:
187  qWarning() << "ignoring unknown software message field number" << fieldId << bigEndian;
188  // Fall through to return true, as its still 'safe' to continue parsing data messages.
189  }
190  return true;
191 }
192 
193 /// \endcond
194 
#define QTFIT_END_NAMESPACE
Macro for ending the QtFit library's top-most namespace (if one is defined).
Definition: QtFit_global.h:78
#define QTFIT_BEGIN_NAMESPACE
Macro for starting the QtFit library's top-most namespace (if one is defined).
Definition: QtFit_global.h:77
MesgNum globalMessageNumber
FIT Globla Message Number for this FIT Data Message.
bool verify(const QByteArray &data, const FitBaseType actualType, const int expectedSize, const FitBaseType expectedType, const char *messageFieldName)
The AbstractDataMessage class is the polymorphic base class for all FIT Data Message classes.
quint16 version
The SoftwareMessage FIT message's version field.
bool setField(const int fieldId, const QByteArray &data, const FitBaseType baseType, const bool bigEndian) override
QString partNumber
The SoftwareMessage FIT message's partNumber field.
MessageIndex messageIndex
The SoftwareMessage FIT message's messageIndex field.
The SoftwareMessage class represents a FIT SoftwareMessage data message.
QString partNumber() const
Returns the SoftwareMessage data message's partNumber field's current value.
void setVersion(const quint16 version)
Sets the version field to version.
quint16 version() const
Returns the SoftwareMessage data message's version field's current value.
SoftwareMessage()
Constructs a SoftwareMessage object.
void setPartNumber(const QString partNumber)
Sets the partNumber field to partNumber.
MessageIndex messageIndex() const
Returns the SoftwareMessage data message's messageIndex field's current value.
void setMessageIndex(const MessageIndex messageIndex)
Sets the messageIndex field to messageIndex.
Declares the SoftwareMessage class.
Declares the SoftwareMessagePrivate class.
FitBaseType
Garmin FIT FitBaseType type.
Definition: types.h:3388
MessageIndex
Garmin FIT MessageIndex type.
Definition: types.h:263