/*
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
#include "AP_Proximity_TeraRangerTowerEvo.h"
#if HAL_PROXIMITY_ENABLED
#include
#include
#include
extern const AP_HAL::HAL& hal;
// update the state of the sensor
void AP_Proximity_TeraRangerTowerEvo::update(void)
{
if (_uart == nullptr) {
return;
}
if (_last_request_sent_ms == 0) {
_last_request_sent_ms = AP_HAL::millis();
}
//initialize the sensor
if(_current_init_state != InitState::InitState_Finished)
{
initialise_modes();
}
// process incoming messages
read_sensor_data();
// check for timeout and set health status
if ((_last_distance_received_ms == 0) || (AP_HAL::millis() - _last_distance_received_ms > PROXIMITY_TRTOWER_TIMEOUT_MS)) {
set_status(AP_Proximity::Status::NoData);
} else {
set_status(AP_Proximity::Status::Good);
}
}
// get maximum and minimum distances (in meters) of primary sensor
float AP_Proximity_TeraRangerTowerEvo::distance_max() const
{
return 60.0f;
}
float AP_Proximity_TeraRangerTowerEvo::distance_min() const
{
return 0.50f;
}
void AP_Proximity_TeraRangerTowerEvo::initialise_modes()
{
if((AP_HAL::millis() - _last_request_sent_ms) < _mode_request_delay) {
return;
}
if (_current_init_state == InitState_Printout) {
set_mode(BINARY_MODE, 4);
} else if (_current_init_state == InitState_Sequence) {
//set tower mode - 4 sensors are triggered at once with 90 deg angle between each sensor
set_mode(TOWER_MODE, 4);
} else if (_current_init_state == InitState_Rate) {
//set update rate of the sensor.
set_mode(REFRESH_100_HZ, 5);
} else if (_current_init_state == InitState_StreamStart) {
set_mode(ACTIVATE_STREAM, 5);
}
}
void AP_Proximity_TeraRangerTowerEvo::set_mode(const uint8_t *c, int length)
{
_uart->write(c, length);
_last_request_sent_ms = AP_HAL::millis();
}
// check for replies from sensor, returns true if at least one message was processed
bool AP_Proximity_TeraRangerTowerEvo::read_sensor_data()
{
if (_uart == nullptr) {
return false;
}
uint16_t message_count = 0;
int16_t nbytes = _uart->available();
if(_current_init_state != InitState_Finished && nbytes == 4) {
//Increment _current_init_state only when we receive 4 ack bytes
switch (_current_init_state) {
case InitState_Printout:
_current_init_state = InitState_Sequence;
break;
case InitState_Sequence:
_current_init_state = InitState_Rate;
break;
case InitState_Rate:
_current_init_state = InitState_StreamStart;
break;
case InitState_StreamStart:
_current_init_state = InitState_Finished;
break;
case InitState_Finished:
break;
}
}
while (nbytes-- > 0) {
char c = _uart->read();
if (c == 'T' ) {
buffer_count = 0;
}
buffer[buffer_count++] = c;
// we should always read 19 bytes THxxxxxxxxxxxxxxxxMC
if (buffer_count >= 20){
buffer_count = 0;
//check if message has right CRC
if (crc_crc8(buffer, 19) == buffer[19]){
update_sector_data(0, UINT16_VALUE(buffer[2], buffer[3])); // d1
update_sector_data(45, UINT16_VALUE(buffer[4], buffer[5])); // d2
update_sector_data(90, UINT16_VALUE(buffer[6], buffer[7])); // d3
update_sector_data(135, UINT16_VALUE(buffer[8], buffer[9])); // d4
update_sector_data(180, UINT16_VALUE(buffer[10], buffer[11])); // d5
update_sector_data(225, UINT16_VALUE(buffer[12], buffer[13])); // d6
update_sector_data(270, UINT16_VALUE(buffer[14], buffer[15])); // d7
update_sector_data(315, UINT16_VALUE(buffer[16], buffer[17])); // d8
message_count++;
}
}
}
return (message_count > 0);
}
// process reply
void AP_Proximity_TeraRangerTowerEvo::update_sector_data(int16_t angle_deg, uint16_t distance_cm)
{
// Get location on 3-D boundary based on angle to the object
const AP_Proximity_Boundary_3D::Face face = boundary.get_face(angle_deg);
//check for target too far, target too close and sensor not connected
const bool valid = (distance_cm != 0xffff) && (distance_cm > 0x0001);
if (valid && !ignore_reading(angle_deg, distance_cm * 0.001f, false)) {
boundary.set_face_attributes(face, angle_deg, ((float) distance_cm) / 1000);
// update OA database
database_push(angle_deg, ((float) distance_cm) / 1000);
} else {
boundary.reset_face(face);
}
_last_distance_received_ms = AP_HAL::millis();
}
#endif // HAL_PROXIMITY_ENABLED