/* Module Info - extracts and prints the full module information from UBX_MON_VER using a custom command. By: @mayopan Date: May 9th, 2020 Based on: Send Custom Command By: Paul Clark (PaulZC) Date: April 20th, 2020 License: MIT. See license file for more information but you can basically do whatever you want with this code. Previously it was possible to create and send a custom packet through the library but it would always appear to timeout as some of the internal functions referred to the internal private struct packetCfg. The most recent version of the library allows sendCommand to use a custom packet as if it were packetCfg and so: - sendCommand will return a sfe_ublox_status_e enum as if it had been called from within the library - the custom packet will be updated with data returned by the module (previously this was not possible from outside the library) Feel like supporting open source hardware? Buy a board from SparkFun! ZED-F9P RTK2: https://www.sparkfun.com/products/15136 NEO-M8P RTK: https://www.sparkfun.com/products/15005 SAM-M8Q: https://www.sparkfun.com/products/15106 Hardware Connections: Plug a Qwiic cable into the GPS and a BlackBoard If you don't have a platform with a Qwiic connection use the SparkFun Qwiic Breadboard Jumper (https://www.sparkfun.com/products/14425) Open the serial monitor at 115200 baud to see the output */ #include //Needed for I2C to GPS #define MAX_PAYLOAD_SIZE 384 // Override MAX_PAYLOAD_SIZE for getModuleInfo which can return up to 348 bytes #include "SparkFun_Ublox_Arduino_Library.h" //http://librarymanager/All#SparkFun_u-blox_GNSS // Extend the class for getModuleInfo class SFE_UBLOX_GPS_ADD : public SFE_UBLOX_GPS { public: boolean getModuleInfo(uint16_t maxWait = 1100); //Queries module, texts struct minfoStructure // Structure to hold the module info (uses 341 bytes of RAM) { char swVersion[30]; char hwVersion[10]; uint8_t extensionNo = 0; char extension[10][30]; } minfo; }; SFE_UBLOX_GPS_ADD myGPS; void setup() { Serial.begin(115200); // You may need to increase this for high navigation rates! while (!Serial) ; //Wait for user to open terminal Serial.println(F("SparkFun Ublox Example")); Wire.begin(); //myGPS.enableDebugging(); // Uncomment this line to enable debug messages if (myGPS.begin() == false) //Connect to the Ublox module using Wire port { Serial.println(F("Ublox GPS not detected at default I2C address. Please check wiring. Freezing.")); while (1) ; } myGPS.setI2COutput(COM_TYPE_UBX); //Set the I2C port to output UBX only (turn off NMEA noise) Serial.print(F("Polling module info")); if (myGPS.getModuleInfo(1100) == false) // Try to get the module info { Serial.print(F("getModuleInfo failed! Freezing...")); while (1) ; } Serial.println(); Serial.println(); Serial.println(F("Module Info : ")); Serial.print(F("Soft version: ")); Serial.println(myGPS.minfo.swVersion); Serial.print(F("Hard version: ")); Serial.println(myGPS.minfo.hwVersion); Serial.print(F("Extensions:")); Serial.println(myGPS.minfo.extensionNo); for (int i = 0; i < myGPS.minfo.extensionNo; i++) { Serial.print(" "); Serial.println(myGPS.minfo.extension[i]); } Serial.println(); Serial.println(F("Done!")); } void loop() { } boolean SFE_UBLOX_GPS_ADD::getModuleInfo(uint16_t maxWait) { myGPS.minfo.hwVersion[0] = 0; myGPS.minfo.swVersion[0] = 0; for (int i = 0; i < 10; i++) myGPS.minfo.extension[i][0] = 0; myGPS.minfo.extensionNo = 0; // Let's create our custom packet uint8_t customPayload[MAX_PAYLOAD_SIZE]; // This array holds the payload data bytes // The next line creates and initialises the packet information which wraps around the payload ubxPacket customCfg = {0, 0, 0, 0, 0, customPayload, 0, 0, SFE_UBLOX_PACKET_VALIDITY_NOT_DEFINED, SFE_UBLOX_PACKET_VALIDITY_NOT_DEFINED}; // The structure of ubxPacket is: // uint8_t cls : The message Class // uint8_t id : The message ID // uint16_t len : Length of the payload. Does not include cls, id, or checksum bytes // uint16_t counter : Keeps track of number of overall bytes received. Some responses are larger than 255 bytes. // uint16_t startingSpot : The counter value needed to go past before we begin recording into payload array // uint8_t *payload : The payload // uint8_t checksumA : Given to us by the module. Checked against the rolling calculated A/B checksums. // uint8_t checksumB // sfe_ublox_packet_validity_e valid : Goes from NOT_DEFINED to VALID or NOT_VALID when checksum is checked // sfe_ublox_packet_validity_e classAndIDmatch : Goes from NOT_DEFINED to VALID or NOT_VALID when the Class and ID match the requestedClass and requestedID // sendCommand will return: // SFE_UBLOX_STATUS_DATA_RECEIVED if the data we requested was read / polled successfully // SFE_UBLOX_STATUS_DATA_SENT if the data we sent was writted successfully (ACK'd) // Other values indicate errors. Please see the sfe_ublox_status_e enum for further details. // Referring to the u-blox M8 Receiver Description and Protocol Specification we see that // the module information can be read using the UBX-MON-VER message. So let's load our // custom packet with the correct information so we can read (poll / get) the module information. customCfg.cls = UBX_CLASS_MON; // This is the message Class customCfg.id = UBX_MON_VER; // This is the message ID customCfg.len = 0; // Setting the len (length) to zero let's us poll the current settings customCfg.startingSpot = 0; // Always set the startingSpot to zero (unless you really know what you are doing) // Now let's send the command. The module info is returned in customPayload if (sendCommand(&customCfg, maxWait) != SFE_UBLOX_STATUS_DATA_RECEIVED) return (false); //If command send fails then bail // Now let's extract the module info from customPayload uint16_t position = 0; for (int i = 0; i < 30; i++) { minfo.swVersion[i] = customPayload[position]; position++; } for (int i = 0; i < 10; i++) { minfo.hwVersion[i] = customPayload[position]; position++; } while (customCfg.len >= position + 30) { for (int i = 0; i < 30; i++) { minfo.extension[minfo.extensionNo][i] = customPayload[position]; position++; } minfo.extensionNo++; if (minfo.extensionNo > 9) break; } return (true); //Success! }