Merge branch 'main' of https://github.com/sparkfun/SparkFun_Apple_Accessory_Arduino_Library

Author: PaulZC

library.properties

@@ -1,5 +1,5 @@
 name=SparkFun Apple Accessory Arduino Library
-version=3.0.7.0
+version=3.0.7.1
 author=SparkFun Electronics <[email protected]>
 maintainer=SparkFun Electronics <sparkfun.com>
 sentence=An Arduino library for SparkFun Apple Accessories

src/SparkFun_Apple_Accessory.h

@@ -42,9 +42,39 @@ class SparkFunAppleAccessoryDriver
          *
          * @param latestGPGST Pointer to the latest GNSS NMEA GPGST message (optional)
          *
-         * @note The pointers will be set the nullptr once the NMEA data has been consumed
+         * @param latestGPVTG Pointer to the latest GNSS NMEA GPVTG message (optional)
+         *
+         * @note Each pointer points to NULL when the NMEA data has been consumed.
+         */
+        void setNMEApointers(char *latestGPGGA, char *latestGPRMC, char *latestGPGST = nullptr, char *latestGPVTG = nullptr);
+
+        /**
+         * @brief Set the pointer to the latest EA Session blob.
+         *        E.g. NMEA GSA and GSV - from external GNSS.
+         * 
+         * @param latestEASessionData Pointer to the latest EA Session blob.
+         *
+         * @note The latestEASessionData is passed to the EA Session as-is, (up to)
+         *       1000 bytes at a time.
+         *       If must contain CRLF delimiters.
+         *       It must be NULL-terminated as strlen is used to calculate the length.
+         *       The pointer will point to NULL when the data has been consumed.
+         *       Call latestEASessionDataIsBlocking before adding new data to
+         *       latestEASessionData. Do not modify latestEASessionData if
+         *       latestEASessionDataIsBlocking is true.
+         */
+        void setEASessionPointer(char *latestEASessionData);
+
+        /**
+         * @brief Check if the latestEASessionData is in use (blocking)
+         * 
+         * @return Returns `true` when the latestEASessionData is being written
+         *         to the device, `false` otherwise.
+         *
+         * @note This is a poor man's semaphore. Super code threads / tasks should not update
+         *       the latestEASessionData while latestEASessionDataIsBlocking is true.
          */
-        void setNMEApointers(char *latestGPGGA, char *latestGPRMC, char *latestGPGST = nullptr);
+        bool latestEASessionDataIsBlocking();
 
         /**
          * @brief Enable debug prints on the selected Print stream

src/esp32/SparkFun_Apple_Accessory_Arduino_Library.a

@@ -35,7 +35,9 @@ class SparkFuniAP2Driver
         void iap2LinkUpdate();
         void iap2TrafficUpdate();
         void startHandshake(Stream *theStream);
-        void setNMEApointers(char *latestGPGGA, char *latestGPRMC, char *latestGPGST = nullptr);
+        void setNMEApointers(char *latestGPGGA, char *latestGPRMC, char *latestGPGST = nullptr, char *latestGPVTG = nullptr);
+        void setEASessionPointer(char *latestEASessionData);
+        bool latestEASessionDataIsBlocking();
         void setAuthPointers(uint8_t *authCert, size_t certSize, char *authCertSerial);
         void setAuthCoprocessorPointer(SparkFunAuth3CPArdI2C *authCoprocessor);
         void setAccessoryName(const char *accessoryName);
@@ -125,6 +127,9 @@ class SparkFuniAP2Driver
         char *_latestGPGGA = nullptr; // Pointer to the latest NMEA GGA, provided by an external GNSS
         char *_latestGPRMC = nullptr; // Pointer to the latest NMEA RMC, provided by an external GNSS
         char *_latestGPGST = nullptr; // Pointer to the latest NMEA GST, provided by an external GNSS
+        char *_latestGPVTG = nullptr; // Pointer to the latest NMEA VTG, provided by an external GNSS
+        char *_latestEASessionData = nullptr; // Pointer to the latest ES Session NMEA GSA / GSV blob, provided by an external GNSS
+        bool _latestEASessionDataIsBlocking = false; // Flag to indicate when EA Session Data is being written to the device
 
         uint8_t *_authCert = nullptr; // Storage for the authentication certificate
         size_t _certSize = 0; // The size of the authentication certificate