/* MAVLink logfile transfer functions */ /* 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 #if HAL_LOGGING_ENABLED && HAL_GCS_ENABLED #include #include #include // for LOG_ENTRY extern const AP_HAL::HAL& hal; /** handle all types of log download requests from the GCS */ void AP_Logger::handle_log_message(GCS_MAVLINK &link, const mavlink_message_t &msg) { if (!WritesEnabled()) { // this is currently used as a proxy for "in_mavlink_delay" return; } if (vehicle_is_armed()) { if (!_warned_log_disarm) { link.send_text(MAV_SEVERITY_ERROR, "Disarm for log download"); _warned_log_disarm = true; } return; } _warned_log_disarm = false; _last_mavlink_log_transfer_message_handled_ms = AP_HAL::millis(); switch (msg.msgid) { case MAVLINK_MSG_ID_LOG_REQUEST_LIST: handle_log_request_list(link, msg); break; case MAVLINK_MSG_ID_LOG_REQUEST_DATA: handle_log_request_data(link, msg); break; case MAVLINK_MSG_ID_LOG_ERASE: handle_log_request_erase(link, msg); break; case MAVLINK_MSG_ID_LOG_REQUEST_END: handle_log_request_end(link, msg); break; } } /** handle all types of log download requests from the GCS */ void AP_Logger::handle_log_request_list(GCS_MAVLINK &link, const mavlink_message_t &msg) { WITH_SEMAPHORE(_log_send_sem); if (_log_sending_link != nullptr) { link.send_text(MAV_SEVERITY_INFO, "Log download in progress"); return; } mavlink_log_request_list_t packet; mavlink_msg_log_request_list_decode(&msg, &packet); _log_num_logs = get_num_logs(); if (_log_num_logs == 0) { _log_next_list_entry = 0; _log_last_list_entry = 0; } else { _log_next_list_entry = packet.start; _log_last_list_entry = packet.end; if (_log_last_list_entry > _log_num_logs) { _log_last_list_entry = _log_num_logs; } if (_log_next_list_entry < 1) { _log_next_list_entry = 1; } } transfer_activity = TransferActivity::LISTING; _log_sending_link = &link; handle_log_send_listing(); } /** handle request for log data */ void AP_Logger::handle_log_request_data(GCS_MAVLINK &link, const mavlink_message_t &msg) { WITH_SEMAPHORE(_log_send_sem); if (_log_sending_link != nullptr) { // some GCS (e.g. MAVProxy) attempt to stream request_data // messages when they're filling gaps in the downloaded logs. // This channel check avoids complaining to them, at the cost // of silently dropping any repeated attempts to start logging if (_log_sending_link->get_chan() != link.get_chan()) { link.send_text(MAV_SEVERITY_INFO, "Log download in progress"); } return; } mavlink_log_request_data_t packet; mavlink_msg_log_request_data_decode(&msg, &packet); // consider opening or switching logs: if (transfer_activity != TransferActivity::SENDING || _log_num_data != packet.id) { uint16_t num_logs = get_num_logs(); if (packet.id > num_logs || packet.id < 1) { // request for an invalid log; cancel any current download end_log_transfer(); return; } uint32_t time_utc, size; get_log_info(packet.id, size, time_utc); _log_num_data = packet.id; _log_data_size = size; uint32_t end; get_log_boundaries(packet.id, _log_data_page, end); } _log_data_offset = packet.ofs; if (_log_data_offset >= _log_data_size) { _log_data_remaining = 0; } else { _log_data_remaining = _log_data_size - _log_data_offset; } if (_log_data_remaining > packet.count) { _log_data_remaining = packet.count; } transfer_activity = TransferActivity::SENDING; _log_sending_link = &link; handle_log_send(); } /** handle request to erase log data */ void AP_Logger::handle_log_request_erase(GCS_MAVLINK &link, const mavlink_message_t &msg) { // mavlink_log_erase_t packet; // mavlink_msg_log_erase_decode(&msg, &packet); EraseAll(); } /** handle request to stop transfer and resume normal logging */ void AP_Logger::handle_log_request_end(GCS_MAVLINK &link, const mavlink_message_t &msg) { WITH_SEMAPHORE(_log_send_sem); // mavlink_log_request_end_t packet; // mavlink_msg_log_request_end_decode(&msg, &packet); end_log_transfer(); } void AP_Logger::end_log_transfer() { transfer_activity = TransferActivity::IDLE; _log_sending_link = nullptr; backends[0]->end_log_transfer(); } /** trigger sending of log messages if there are some pending */ void AP_Logger::handle_log_send() { WITH_SEMAPHORE(_log_send_sem); if (_log_sending_link == nullptr) { return; } if (hal.util->get_soft_armed()) { // might be flying return; } switch (transfer_activity) { case TransferActivity::IDLE: break; case TransferActivity::LISTING: handle_log_send_listing(); break; case TransferActivity::SENDING: handle_log_sending(); break; } } void AP_Logger::handle_log_sending() { WITH_SEMAPHORE(_log_send_sem); #if CONFIG_HAL_BOARD == HAL_BOARD_SITL // assume USB speeds in SITL for the purposes of log download const uint8_t num_sends = 40; #else uint8_t num_sends = 1; if (_log_sending_link->is_high_bandwidth() && hal.gpio->usb_connected()) { // when on USB we can send a lot more data num_sends = 250; } else if (_log_sending_link->have_flow_control()) { #if CONFIG_HAL_BOARD == HAL_BOARD_LINUX num_sends = 80; #else num_sends = 10; #endif } #endif for (uint8_t i=0; iget_chan(), LOG_ENTRY)) { // no space return; } if (AP_HAL::millis() - _log_sending_link->get_last_heartbeat_time() > 3000) { // give a heartbeat a chance return; } uint32_t size, time_utc; if (_log_next_list_entry == 0) { size = 0; time_utc = 0; } else { get_log_info(_log_next_list_entry, size, time_utc); } mavlink_msg_log_entry_send(_log_sending_link->get_chan(), _log_next_list_entry, _log_num_logs, _log_last_list_entry, time_utc, size); if (_log_next_list_entry == _log_last_list_entry) { transfer_activity = TransferActivity::IDLE; _log_sending_link = nullptr; } else { _log_next_list_entry++; } } /** trigger sending of log data if there are some pending */ bool AP_Logger::handle_log_send_data() { WITH_SEMAPHORE(_log_send_sem); if (!HAVE_PAYLOAD_SPACE(_log_sending_link->get_chan(), LOG_DATA)) { // no space return false; } if (AP_HAL::millis() - _log_sending_link->get_last_heartbeat_time() > 3000) { // give a heartbeat a chance return false; } int16_t nbytes = 0; uint32_t len = _log_data_remaining; mavlink_log_data_t packet; if (len > MAVLINK_MSG_LOG_DATA_FIELD_DATA_LEN) { len = MAVLINK_MSG_LOG_DATA_FIELD_DATA_LEN; } nbytes = get_log_data(_log_num_data, _log_data_page, _log_data_offset, len, packet.data); if (nbytes < 0) { // report as EOF on error nbytes = 0; } if (nbytes < MAVLINK_MSG_LOG_DATA_FIELD_DATA_LEN) { memset(&packet.data[nbytes], 0, MAVLINK_MSG_LOG_DATA_FIELD_DATA_LEN-nbytes); } packet.ofs = _log_data_offset; packet.id = _log_num_data; packet.count = nbytes; _mav_finalize_message_chan_send(_log_sending_link->get_chan(), MAVLINK_MSG_ID_LOG_DATA, (const char *)&packet, MAVLINK_MSG_ID_LOG_DATA_MIN_LEN, MAVLINK_MSG_ID_LOG_DATA_LEN, MAVLINK_MSG_ID_LOG_DATA_CRC); _log_data_offset += nbytes; _log_data_remaining -= nbytes; if (nbytes < MAVLINK_MSG_LOG_DATA_FIELD_DATA_LEN || _log_data_remaining == 0) { end_log_transfer(); } return true; } #endif // HAL_LOGGING_ENABLED && HAL_GCS_ENABLED