gpgsa.cpp
Go to the documentation of this file.
1 // *****************************************************************************
2 //
3 // © Copyright 2020, Septentrio NV/SA.
4 // All rights reserved.
5 //
6 // Redistribution and use in source and binary forms, with or without
7 // modification, are permitted provided that the following conditions are met:
8 // 1. Redistributions of source code must retain the above copyright
9 // notice, this list of conditions and the following disclaimer.
10 // 2. Redistributions in binary form must reproduce the above copyright
11 // notice, this list of conditions and the following disclaimer in the
12 // documentation and/or other materials provided with the distribution.
13 // 3. Neither the name of the copyright holder nor the names of its
14 // contributors may be used to endorse or promote products derived
15 // from this software without specific prior written permission.
16 //
17 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
18 // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20 // ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
21 // LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
22 // CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23 // SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24 // INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
25 // CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26 // ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
27 // POSSIBILITY OF SUCH DAMAGE.
28 //
29 // *****************************************************************************
30 
32 
39 const std::string GpgsaParser::MESSAGE_ID = "$GPGSA";
40 
41 const std::string GpgsaParser::getMessageID() const
42 {
44 }
45 
54  const std::string& frame_id, bool /*use_gnss_time*/,
55  Timestamp /*time_obj*/) noexcept(false)
56 {
57 
58  // Checking the length first, it should be 19 elements
59  const size_t LENGTH = 19;
60  if (sentence.get_body().size() != LENGTH)
61  {
62  std::stringstream error;
63  error << "Expected GPGSA length is " << LENGTH << ". The actual length is "
64  << sentence.get_body().size();
65  throw ParseException(error.str());
66  }
67 
68  GpgsaMsg msg;
69  msg.header.frame_id = frame_id;
70  msg.message_id = sentence.get_body()[0];
71  msg.auto_manual_mode = sentence.get_body()[1];
72  if (!parsing_utilities::parseUInt8(sentence.get_body()[2], msg.fix_mode))
73  {
74  std::stringstream error;
75  error << "GPGSA fix_mode parsing error.";
76  throw ParseException(error.str());
77  }
78  // Words 3-14 of the sentence are SV PRNs. Copying only the non-null strings..
79  // 0 is the character needed to fill the new character space, in case 12 (first
80  // argument) is larger than sv_ids.
81  msg.sv_ids.resize(12, 0);
82  size_t n_svs = 0;
83  for (std::vector<std::string>::const_iterator id =
84  sentence.get_body().begin() + 3;
85  id < sentence.get_body().begin() + 15; ++id)
86  {
87  if (!id->empty())
88  {
89  if (!parsing_utilities::parseUInt8(*id, msg.sv_ids[n_svs]))
90  {
91  std::stringstream error;
92  error << "GPGSA sv_ids parsing error.";
93  throw ParseException(error.str());
94  }
95  ++n_svs;
96  }
97  }
98  msg.sv_ids.resize(n_svs);
99 
100  if (!parsing_utilities::parseFloat(sentence.get_body()[15], msg.pdop))
101  {
102  std::stringstream error;
103  error << "GPGSA pdop parsing error.";
104  throw ParseException(error.str());
105  }
106  if (!parsing_utilities::parseFloat(sentence.get_body()[16], msg.hdop))
107  {
108  std::stringstream error;
109  error << "GPGSA hdop parsing error.";
110  throw ParseException(error.str());
111  }
112  if (!parsing_utilities::parseFloat(sentence.get_body()[17], msg.vdop))
113  {
114  std::stringstream error;
115  error << "GPGSA vdop parsing error.";
116  throw ParseException(error.str());
117  }
118  return msg;
119 }
Timestamp
uint64_t Timestamp
Definition: typedefs.hpp:92
frame_id
std::string frame_id
parsing_utilities::parseFloat
float parseFloat(const uint8_t *buffer)
Converts a 4-byte-buffer into a float.
Definition: parsing_utilities.cpp:73
NMEASentence
Struct to split an NMEA sentence into its ID and its body, the latter tokenized into a vector of stri...
Definition: nmea_sentence.hpp:55
GpgsaParser::getMessageID
const std::string getMessageID() const override
Returns the ASCII message ID, here "$GPGSA".
Definition: gpgsa.cpp:41
gpgsa.hpp
Derived class for parsing GSA messages.
GpgsaMsg
nmea_msgs::Gpgsa GpgsaMsg
Definition: typedefs.hpp:136
GpgsaParser::MESSAGE_ID
static const std::string MESSAGE_ID
Declares the string MESSAGE_ID.
Definition: gpgsa.hpp:104
parsing_utilities::parseUInt8
bool parseUInt8(const std::string &string, uint8_t &value, int32_t base=10)
Interprets the contents of "string" as a unsigned integer number of type uint8_t.
Definition: parsing_utilities.cpp:153
GpgsaParser::parseASCII
GpgsaMsg parseASCII(const NMEASentence &sentence, const std::string &frame_id, bool use_gnss_time, Timestamp time_obj) noexcept(false) override
Parses one GSA message.
Definition: gpgsa.cpp:53
ParseException
Class to declare error message format when parsing, derived from the public class "std::runtime_error...
Definition: parse_exception.hpp:86


septentrio_gnss_driver
Author(s): Tibor Dome
autogenerated on Wed Nov 22 2023 04:04:27