/* This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ // // Trimble GPS driver for ArduPilot. // Code by Michael Oborne // // Usage in SITL with hardware for debugging: // sim_vehicle.py -v Plane -A "--serial3=uart:/dev/ttyUSB0" --console --map -DG // param set GPS_TYPE 11 // GSOF // param set SERIAL3_PROTOCOL 5 // GPS // #define ALLOW_DOUBLE_MATH_FUNCTIONS #include "AP_GPS.h" #include "AP_GPS_GSOF.h" #include #include #include #if AP_GPS_GSOF_ENABLED extern const AP_HAL::HAL& hal; #define gsof_DEBUGGING 0 #if gsof_DEBUGGING # define Debug(fmt, args ...) \ do { \ hal.console->printf("%s:%d: " fmt "\n", \ __FUNCTION__, __LINE__, \ ## args); \ hal.scheduler->delay(1); \ } while(0) #else # define Debug(fmt, args ...) #endif AP_GPS_GSOF::AP_GPS_GSOF(AP_GPS &_gps, AP_GPS::GPS_State &_state, AP_HAL::UARTDriver *_port) : AP_GPS_Backend(_gps, _state, _port) { // https://receiverhelp.trimble.com/oem-gnss/index.html#GSOFmessages_Overview.html?TocPath=Output%2520Messages%257CGSOF%2520Messages%257COverview%257C_____0 static_assert(ARRAY_SIZE(gsofmsgreq) <= 10, "The maximum number of outputs allowed with GSOF is 10."); msg.state = Msg_Parser::State::STARTTX; constexpr uint8_t default_com_port = static_cast(HW_Port::COM2); gps._com_port[state.instance].set_default(default_com_port); const auto com_port = gps._com_port[state.instance].get(); if (!validate_com_port(com_port)) { // The user parameter for COM port is not a valid GSOF port GCS_SEND_TEXT(MAV_SEVERITY_ERROR, "GSOF instance %d has invalid COM port setting of %d", state.instance, com_port); return; } requestBaud(static_cast(com_port)); const uint32_t now = AP_HAL::millis(); gsofmsg_time = now + 110; } // Process all bytes available from the stream // bool AP_GPS_GSOF::read(void) { const uint32_t now = AP_HAL::millis(); if (gsofmsgreq_index < (sizeof(gsofmsgreq))) { const auto com_port = gps._com_port[state.instance].get(); if (!validate_com_port(com_port)) { // The user parameter for COM port is not a valid GSOF port return false; } if (now > gsofmsg_time) { requestGSOF(gsofmsgreq[gsofmsgreq_index], static_cast(com_port), Output_Rate::FREQ_10_HZ); gsofmsg_time = now + 110; gsofmsgreq_index++; } } bool ret = false; while (port->available() > 0) { const uint8_t temp = port->read(); #if AP_GPS_DEBUG_LOGGING_ENABLED log_data(&temp, 1); #endif ret |= parse(temp); } return ret; } bool AP_GPS_GSOF::parse(const uint8_t temp) { // https://receiverhelp.trimble.com/oem-gnss/index.html#API_DataCollectorFormatPacketStructure.html switch (msg.state) { default: case Msg_Parser::State::STARTTX: if (temp == STX) { msg.state = Msg_Parser::State::STATUS; msg.read = 0; msg.checksumcalc = 0; } break; case Msg_Parser::State::STATUS: msg.status = temp; msg.state = Msg_Parser::State::PACKETTYPE; msg.checksumcalc += temp; break; case Msg_Parser::State::PACKETTYPE: msg.packettype = temp; msg.state = Msg_Parser::State::LENGTH; msg.checksumcalc += temp; break; case Msg_Parser::State::LENGTH: msg.length = temp; msg.state = Msg_Parser::State::DATA; msg.checksumcalc += temp; break; case Msg_Parser::State::DATA: msg.data[msg.read] = temp; msg.read++; msg.checksumcalc += temp; if (msg.read >= msg.length) { msg.state = Msg_Parser::State::CHECKSUM; } break; case Msg_Parser::State::CHECKSUM: msg.checksum = temp; msg.state = Msg_Parser::State::ENDTX; if (msg.checksum == msg.checksumcalc) { return process_message(); } break; case Msg_Parser::State::ENDTX: msg.endtx = temp; msg.state = Msg_Parser::State::STARTTX; break; } return false; } void AP_GPS_GSOF::requestBaud(const HW_Port portindex) { uint8_t buffer[19] = {0x02,0x00,0x64,0x0d,0x00,0x00,0x00, // application file record 0x03, 0x00, 0x01, 0x00, // file control information block 0x02, 0x04, static_cast(portindex), 0x07, 0x00,0x00, // serial port baud format 0x00,0x03 }; // checksum buffer[4] = packetcount++; uint8_t checksum = 0; for (uint8_t a = 1; a < (sizeof(buffer) - 1); a++) { checksum += buffer[a]; } buffer[17] = checksum; port->write((const uint8_t*)buffer, sizeof(buffer)); } void AP_GPS_GSOF::requestGSOF(const uint8_t messageType, const HW_Port portIndex, const Output_Rate rateHz) { uint8_t buffer[21] = {0x02,0x00,0x64,0x0f,0x00,0x00,0x00, // application file record 0x03,0x00,0x01,0x00, // file control information block 0x07,0x06,0x0a,static_cast(portIndex),static_cast(rateHz),0x00,messageType,0x00, // output message record 0x00,0x03 }; // checksum buffer[4] = packetcount++; uint8_t checksum = 0; for (uint8_t a = 1; a < (sizeof(buffer) - 1); a++) { checksum += buffer[a]; } buffer[19] = checksum; port->write((const uint8_t*)buffer, sizeof(buffer)); } double AP_GPS_GSOF::SwapDouble(const uint8_t* src, const uint32_t pos) const { union { double d; char bytes[sizeof(double)]; } doubleu; doubleu.bytes[0] = src[pos + 7]; doubleu.bytes[1] = src[pos + 6]; doubleu.bytes[2] = src[pos + 5]; doubleu.bytes[3] = src[pos + 4]; doubleu.bytes[4] = src[pos + 3]; doubleu.bytes[5] = src[pos + 2]; doubleu.bytes[6] = src[pos + 1]; doubleu.bytes[7] = src[pos + 0]; return doubleu.d; } float AP_GPS_GSOF::SwapFloat(const uint8_t* src, const uint32_t pos) const { union { float f; char bytes[sizeof(float)]; } floatu; floatu.bytes[0] = src[pos + 3]; floatu.bytes[1] = src[pos + 2]; floatu.bytes[2] = src[pos + 1]; floatu.bytes[3] = src[pos + 0]; return floatu.f; } uint32_t AP_GPS_GSOF::SwapUint32(const uint8_t* src, const uint32_t pos) const { uint32_t u; memcpy(&u, &src[pos], sizeof(u)); return be32toh(u); } uint16_t AP_GPS_GSOF::SwapUint16(const uint8_t* src, const uint32_t pos) const { uint16_t u; memcpy(&u, &src[pos], sizeof(u)); return be16toh(u); } bool AP_GPS_GSOF::process_message(void) { if (msg.packettype == 0x40) { // GSOF // https://receiverhelp.trimble.com/oem-gnss/index.html#GSOFmessages_TIME.html?TocPath=Output%2520Messages%257CGSOF%2520Messages%257C_____25 #if gsof_DEBUGGING const uint8_t trans_number = msg.data[0]; const uint8_t pageidx = msg.data[1]; const uint8_t maxpageidx = msg.data[2]; Debug("GSOF page: %u of %u (trans_number=%u)", pageidx, maxpageidx, trans_number); #endif int valid = 0; // want 1 2 8 9 12 for (uint32_t a = 3; a < msg.length; a++) { const uint8_t output_type = msg.data[a]; a++; const uint8_t output_length = msg.data[a]; a++; //Debug("GSOF type: " + output_type + " len: " + output_length); if (output_type == 1) // pos time { // https://receiverhelp.trimble.com/oem-gnss/index.html#GSOFmessages_TIME.html?TocPath=Output%2520Messages%257CGSOF%2520Messages%257C_____25 state.time_week_ms = SwapUint32(msg.data, a); state.time_week = SwapUint16(msg.data, a + 4); state.num_sats = msg.data[a + 6]; const uint8_t posf1 = msg.data[a + 7]; const uint8_t posf2 = msg.data[a + 8]; //Debug("POSTIME: " + posf1 + " " + posf2); if ((posf1 & 1)) { // New position state.status = AP_GPS::GPS_OK_FIX_3D; if ((posf2 & 1)) { // Differential position state.status = AP_GPS::GPS_OK_FIX_3D_DGPS; if (posf2 & 2) { // Differential position method if (posf2 & 4) {// Differential position method state.status = AP_GPS::GPS_OK_FIX_3D_RTK_FIXED; } else { state.status = AP_GPS::GPS_OK_FIX_3D_RTK_FLOAT; } } } } else { state.status = AP_GPS::NO_FIX; } valid++; } else if (output_type == 2) // position { // This packet is not documented in Trimble's receiver help as of May 18, 2023 state.location.lat = (int32_t)(RAD_TO_DEG_DOUBLE * (SwapDouble(msg.data, a)) * (double)1e7); state.location.lng = (int32_t)(RAD_TO_DEG_DOUBLE * (SwapDouble(msg.data, a + 8)) * (double)1e7); state.location.alt = (int32_t)(SwapDouble(msg.data, a + 16) * 100); state.last_gps_time_ms = AP_HAL::millis(); valid++; } else if (output_type == 8) // velocity { // https://receiverhelp.trimble.com/oem-gnss/index.html#GSOFmessages_Velocity.html?TocPath=Output%2520Messages%257CGSOF%2520Messages%257C_____32 const uint8_t vflag = msg.data[a]; if ((vflag & 1) == 1) { state.ground_speed = SwapFloat(msg.data, a + 1); state.ground_course = degrees(SwapFloat(msg.data, a + 5)); fill_3d_velocity(); state.velocity.z = -SwapFloat(msg.data, a + 9); state.have_vertical_velocity = true; } valid++; } else if (output_type == 9) //dop { // https://receiverhelp.trimble.com/oem-gnss/index.html#GSOFmessages_PDOP.html?TocPath=Output%2520Messages%257CGSOF%2520Messages%257C_____12 state.hdop = (uint16_t)(SwapFloat(msg.data, a + 4) * 100); valid++; } else if (output_type == 12) // position sigma { // https://receiverhelp.trimble.com/oem-gnss/index.html#GSOFmessages_SIGMA.html?TocPath=Output%2520Messages%257CGSOF%2520Messages%257C_____24 state.horizontal_accuracy = (SwapFloat(msg.data, a + 4) + SwapFloat(msg.data, a + 8)) / 2; state.vertical_accuracy = SwapFloat(msg.data, a + 16); state.have_horizontal_accuracy = true; state.have_vertical_accuracy = true; valid++; } a += output_length-1u; } if (valid == 5) { return true; } else { state.status = AP_GPS::NO_FIX; } } return false; } bool AP_GPS_GSOF::validate_com_port(const uint8_t com_port) const { switch(com_port) { case static_cast(HW_Port::COM1): case static_cast(HW_Port::COM2): return true; default: return false; } } #endif