/* 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 . */ #include "AP_RangeFinder_NMEA.h" #if AP_RANGEFINDER_NMEA_ENABLED #include #include extern const AP_HAL::HAL& hal; // return last value measured by sensor bool AP_RangeFinder_NMEA::get_reading(float &reading_m) { if (uart == nullptr) { return false; } // read any available lines from the lidar float sum = 0.0f; uint16_t count = 0; for (auto i=0; i<8192; i++) { uint8_t c; if (!uart->read(c)) { break; } if (decode(c)) { sum += _distance_m; count++; } } // return false on failure if (count == 0) { return false; } // return average of all measurements reading_m = sum / count; return true; } // get temperature reading bool AP_RangeFinder_NMEA::get_temp(float &temp) const { uint32_t now_ms = AP_HAL::millis(); if ((_temp_readtime_ms == 0) || ((now_ms - _temp_readtime_ms) > read_timeout_ms())) { return false; } temp = _temp; return true; } // add a single character to the buffer and attempt to decode // returns true if a distance was successfully decoded bool AP_RangeFinder_NMEA::decode(char c) { switch (c) { case ',': // end of a term, add to checksum _checksum ^= c; FALLTHROUGH; case '\r': case '\n': case '*': { if (_sentence_done) { return false; } // null terminate and decode latest term _term[_term_offset] = 0; bool valid_sentence = decode_latest_term(); // move onto next term _term_number++; _term_offset = 0; _term_is_checksum = (c == '*'); return valid_sentence; } case '$': // sentence begin _sentence_type = SONAR_UNKNOWN; _term_number = 0; _term_offset = 0; _checksum = 0; _term_is_checksum = false; _distance_m = -1.0f; _sentence_done = false; return false; } // ordinary characters are added to term if (_term_offset < sizeof(_term) - 1) { _term[_term_offset++] = c; } if (!_term_is_checksum) { _checksum ^= c; } return false; } // decode the most recently consumed term // returns true if new distance sentence has just passed checksum test and is validated bool AP_RangeFinder_NMEA::decode_latest_term() { // handle the last term in a message if (_term_is_checksum) { _sentence_done = true; uint8_t nibble_high = 0; uint8_t nibble_low = 0; if (!hex_to_uint8(_term[0], nibble_high) || !hex_to_uint8(_term[1], nibble_low)) { return false; } const uint8_t checksum = (nibble_high << 4u) | nibble_low; if (checksum == _checksum) { if ((_sentence_type == SONAR_DBT || _sentence_type == SONAR_DPT || _sentence_type == SONAR_HDED) && !is_negative(_distance_m)) { // return true if distance is valid return true; } if (_sentence_type == SONAR_MTW) { _temp = _temp_unvalidated; _temp_readtime_ms = AP_HAL::millis(); // return false because this is not a distance // temperature is accessed via separate accessor return false; } } return false; } // the first term determines the sentence type if (_term_number == 0) { // the first two letters of the NMEA term are the talker ID. // we accept any two characters here. if (_term[0] < 'A' || _term[0] > 'Z' || _term[1] < 'A' || _term[1] > 'Z') { _sentence_type = SONAR_UNKNOWN; return false; } const char *term_type = &_term[2]; if (strcmp(term_type, "DBT") == 0) { _sentence_type = SONAR_DBT; } else if (strcmp(term_type, "DPT") == 0) { _sentence_type = SONAR_DPT; } else if (strcmp(term_type, "MTW") == 0) { _sentence_type = SONAR_MTW; } else if (strcmp(term_type, "ED") == 0) { _sentence_type = SONAR_HDED; } else { _sentence_type = SONAR_UNKNOWN; } return false; } if (_sentence_type == SONAR_DBT) { // parse DBT messages if (_term_number == 3) { _distance_m = strtof(_term, NULL); } } else if (_sentence_type == SONAR_DPT) { // parse DPT messages if (_term_number == 1) { _distance_m = strtof(_term, NULL); } } else if (_sentence_type == SONAR_MTW) { // parse MTW (mean water temperature) messages if (_term_number == 1) { _temp_unvalidated = strtof(_term, NULL); } } else if (_sentence_type == SONAR_HDED) { // parse HDED (Hondex custom message) if (_term_number == 4) { _distance_m = strtof(_term, NULL); } } return false; } #endif // AP_RANGEFINDER_NMEA_ENABLED