src/marnav/nmea/bwc.hpp

   1 #ifndef __NMEA__BWC__HPP__
   2 #define __NMEA__BWC__HPP__
   3
   4 #include <marnav/nmea/sentence.hpp>
   5 #include <marnav/nmea/angle.hpp>
   6 #include <marnav/nmea/time.hpp>
   7 #include <marnav/nmea/waypoint.hpp>
   8 #include <marnav/utils/optional.hpp>
   9
  10 namespace marnav
  11 {
  12 namespace nmea
  13 {
  14 MARNAV_NMEA_DECLARE_SENTENCE_PARSE_FUNC(bwc)
  15
  16 /// @brief BWC - Bearing & Distance to Waypoint - Geat Circle
  17 ///
  18 /// @code
  19 ///                                                         12
  20 ///        1         2       3 4        5 6   7 8   9 10  11|    13
  21 ///        |         |       | |        | |   | |   | |   | |    |
  22 /// $--BWC,hhmmss.ss,llll.ll,a,yyyyy.yy,a,x.x,T,x.x,M,x.x,N,c--c,m*hh<CR><LF>
  23 /// @endcode
  24 ///
  25 /// Field Number:
  26 /// 1.  UTCTime
  27 /// 2.  Waypoint Latitude
  28 /// 3.  Latitude Hemisphere
  29 ///     - N = North
  30 ///     - S = South
  31 /// 4.  Waypoint Longitude
  32 /// 5.  Longitude Hemisphere
  33 ///     - E = East
  34 ///     - W = West
  35 /// 6.  Bearing True
  36 /// 7.  Bearing True reference
  37 ///     - T = True
  38 /// 8.  Bearing Magnetic
  39 /// 9.  Bearing Magnetic reference
  40 ///     - M = Magnetic
  41 /// 10. Nautical Miles
  42 /// 11. Nautical Miles unit
  43 ///     - N = Nautical Miles
  44 /// 12. Waypoint ID
  45 /// 13. Mode Indicator
  46 ///     - A = Autonomous
  47 ///     - D = Differential
  48 ///     - E = Estimated
  49 ///     - M = Manual Input
  50 ///     - S = Simulated
  51 ///     - N = Data not valid
  52 ///
  53 /// Example: <tt>$GPBWC,081837,,,,,,T,,M,,N,*13</tt>
  54 ///
  55 /// Example: <tt>$GPBWC,220516,5130.02,N,00046.34,W,213.8,T,218.0,M,0004.6,N,EGLM*11</tt>
  56 ///
  57 class bwc : public sentence
  58 {
  59         MARNAV_NMEA_SENTENCE_FRIENDS(bwc)
  60
  61 public:
  62         constexpr static const sentence_id ID = sentence_id::BWC;
  63         constexpr static const char * TAG = "BWC";
  64
  65         virtual ~bwc() {}
  66
  67         bwc();
  68         bwc(const bwc &) = default;
  69         bwc & operator=(const bwc &) = default;
  70
  71 protected:
  72         bwc(const std::string & talker, fields::const_iterator first, fields::const_iterator last);
  73         virtual std::vector<std::string> get_data() const override;
  74
  75 private:
  76         utils::optional<nmea::time> time_utc;
  77         utils::optional<geo::latitude> lat;
  78         utils::optional<direction> lat_hem;
  79         utils::optional<geo::longitude> lon;
  80         utils::optional<direction> lon_hem;
  81         utils::optional<double> bearing_true;
  82         utils::optional<reference> bearing_true_ref;
  83         utils::optional<double> bearing_mag;
  84         utils::optional<reference> bearing_mag_ref;
  85         utils::optional<double> distance; // nautical miles
  86         utils::optional<unit::distance> distance_unit;
  87         utils::optional<waypoint> waypoint_id;
  88         utils::optional<positioning_system_mode_indicator> mode_indicator; // NMEA 2.3 and later
  89
  90 public:
  91         NMEA_GETTER(time_utc)
  92         NMEA_GETTER(bearing_true)
  93         NMEA_GETTER(bearing_true_ref)
  94         NMEA_GETTER(bearing_mag)
  95         NMEA_GETTER(bearing_mag_ref)
  96         NMEA_GETTER(distance)
  97         NMEA_GETTER(distance_unit)
  98         NMEA_GETTER(waypoint_id)
  99         NMEA_GETTER(mode_indicator)
 100
 101         utils::optional<geo::longitude> get_longitude() const;
 102         utils::optional<geo::latitude> get_latitude() const;
 103
 104         void set_time_utc(const nmea::time & t) noexcept { time_utc = t; }
 105         void set_lat(const geo::latitude & t);
 106         void set_lon(const geo::longitude & t);
 107         void set_bearing_true(double t) noexcept;
 108         void set_bearing_mag(double t) noexcept;
 109         void set_distance(double t) noexcept;
 110         void set_waypoint(const waypoint & id) { waypoint_id = id; }
 111         void set_faa_mode_indicator(positioning_system_mode_indicator t) noexcept
 112         {
 113                 mode_indicator = t;
 114         }
 115 };
 116 }
 117 }
 118
 119 #endif