2015-01-19 09:32:24 -04:00
|
|
|
/*
|
2016-04-23 18:00:30 -03:00
|
|
|
Please contribute your ideas! See http://dev.ardupilot.org for details
|
2015-01-19 09:32:24 -04:00
|
|
|
|
|
|
|
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 <http://www.gnu.org/licenses/>.
|
|
|
|
*/
|
|
|
|
/*
|
|
|
|
SerialManager allows defining the protocol and baud rates for the available
|
|
|
|
serial ports and provides helper functions so objects (like a gimbal) can
|
|
|
|
find which serial port they should use
|
|
|
|
*/
|
2016-02-17 21:25:48 -04:00
|
|
|
#pragma once
|
2015-01-19 09:32:24 -04:00
|
|
|
|
2015-08-11 03:28:45 -03:00
|
|
|
#include <AP_HAL/AP_HAL.h>
|
|
|
|
#include <GCS_MAVLink/GCS_MAVLink.h>
|
2019-03-22 22:21:52 -03:00
|
|
|
#include <AP_Param/AP_Param.h>
|
2015-01-19 09:32:24 -04:00
|
|
|
|
2019-11-14 23:50:57 -04:00
|
|
|
#ifdef HAL_UART_NUM_SERIAL_PORTS
|
2019-11-20 03:56:46 -04:00
|
|
|
#if HAL_UART_NUM_SERIAL_PORTS >= 4
|
2019-11-14 23:50:57 -04:00
|
|
|
#define SERIALMANAGER_NUM_PORTS HAL_UART_NUM_SERIAL_PORTS
|
|
|
|
#else
|
2019-11-20 03:56:46 -04:00
|
|
|
// we need a minimum of 4 to allow for a GPS due to the odd ordering
|
|
|
|
// of hal.uartB as SERIAL3
|
|
|
|
#define SERIALMANAGER_NUM_PORTS 4
|
|
|
|
#endif
|
|
|
|
#else
|
2019-11-14 23:50:57 -04:00
|
|
|
// assume max 8 ports
|
2019-07-12 01:59:02 -03:00
|
|
|
#define SERIALMANAGER_NUM_PORTS 8
|
2019-11-14 23:50:57 -04:00
|
|
|
#endif
|
2015-01-19 09:32:24 -04:00
|
|
|
|
|
|
|
// console default baud rates and buffer sizes
|
|
|
|
#ifdef HAL_SERIAL0_BAUD_DEFAULT
|
|
|
|
# define AP_SERIALMANAGER_CONSOLE_BAUD HAL_SERIAL0_BAUD_DEFAULT
|
|
|
|
#else
|
|
|
|
# define AP_SERIALMANAGER_CONSOLE_BAUD 115200
|
|
|
|
#endif
|
|
|
|
# define AP_SERIALMANAGER_CONSOLE_BUFSIZE_RX 128
|
|
|
|
# define AP_SERIALMANAGER_CONSOLE_BUFSIZE_TX 512
|
|
|
|
|
|
|
|
// mavlink default baud rates and buffer sizes
|
|
|
|
#define AP_SERIALMANAGER_MAVLINK_BAUD 57600
|
|
|
|
#define AP_SERIALMANAGER_MAVLINK_BUFSIZE_RX 128
|
|
|
|
#define AP_SERIALMANAGER_MAVLINK_BUFSIZE_TX 256
|
|
|
|
|
2016-05-03 15:35:45 -03:00
|
|
|
// FrSky default baud rates, use default buffer sizes
|
|
|
|
#define AP_SERIALMANAGER_FRSKY_D_BAUD 9600
|
2015-01-19 09:32:24 -04:00
|
|
|
#define AP_SERIALMANAGER_FRSKY_SPORT_BAUD 57600
|
|
|
|
#define AP_SERIALMANAGER_FRSKY_BUFSIZE_RX 0
|
|
|
|
#define AP_SERIALMANAGER_FRSKY_BUFSIZE_TX 0
|
|
|
|
|
|
|
|
// GPS default baud rates and buffer sizes
|
|
|
|
// we need a 256 byte buffer for some GPS types (eg. UBLOX)
|
|
|
|
#define AP_SERIALMANAGER_GPS_BAUD 38400
|
|
|
|
#define AP_SERIALMANAGER_GPS_BUFSIZE_RX 256
|
|
|
|
#define AP_SERIALMANAGER_GPS_BUFSIZE_TX 16
|
|
|
|
|
|
|
|
// AlexMos Gimbal protocol default baud rates and buffer sizes
|
|
|
|
#define AP_SERIALMANAGER_ALEXMOS_BAUD 115200
|
|
|
|
#define AP_SERIALMANAGER_ALEXMOS_BUFSIZE_RX 128
|
|
|
|
#define AP_SERIALMANAGER_ALEXMOS_BUFSIZE_TX 128
|
|
|
|
|
2015-05-26 03:57:05 -03:00
|
|
|
#define AP_SERIALMANAGER_SToRM32_BAUD 115200
|
|
|
|
#define AP_SERIALMANAGER_SToRM32_BUFSIZE_RX 128
|
|
|
|
#define AP_SERIALMANAGER_SToRM32_BUFSIZE_TX 128
|
|
|
|
|
2017-11-02 23:27:29 -03:00
|
|
|
#define AP_SERIALMANAGER_VOLZ_BAUD 115
|
|
|
|
#define AP_SERIALMANAGER_VOLZ_BUFSIZE_RX 128
|
|
|
|
#define AP_SERIALMANAGER_VOLZ_BUFSIZE_TX 128
|
|
|
|
|
2018-12-18 23:28:18 -04:00
|
|
|
#define AP_SERIALMANAGER_ROBOTIS_BUFSIZE_RX 128
|
|
|
|
#define AP_SERIALMANAGER_ROBOTIS_BUFSIZE_TX 128
|
|
|
|
|
2017-08-21 17:31:51 -03:00
|
|
|
// SBUS servo outputs
|
|
|
|
#define AP_SERIALMANAGER_SBUS1_BAUD 100000
|
|
|
|
#define AP_SERIALMANAGER_SBUS1_BUFSIZE_RX 16
|
|
|
|
#define AP_SERIALMANAGER_SBUS1_BUFSIZE_TX 32
|
|
|
|
|
2019-04-20 03:13:23 -03:00
|
|
|
#define AP_SERIALMANAGER_SLCAN_BAUD 115200
|
|
|
|
#define AP_SERIALMANAGER_SLCAN_BUFSIZE_RX 128
|
|
|
|
#define AP_SERIALMANAGER_SLCAN_BUFSIZE_TX 128
|
|
|
|
|
2015-01-19 09:32:24 -04:00
|
|
|
class AP_SerialManager {
|
|
|
|
public:
|
2017-12-12 21:06:14 -04:00
|
|
|
AP_SerialManager();
|
|
|
|
|
|
|
|
/* Do not allow copies */
|
|
|
|
AP_SerialManager(const AP_SerialManager &other) = delete;
|
|
|
|
AP_SerialManager &operator=(const AP_SerialManager&) = delete;
|
|
|
|
|
2015-01-19 09:32:24 -04:00
|
|
|
enum SerialProtocol {
|
2016-04-19 00:48:57 -03:00
|
|
|
SerialProtocol_None = -1,
|
2016-05-16 00:34:32 -03:00
|
|
|
SerialProtocol_Console = 0, // unused
|
2015-03-27 22:44:43 -03:00
|
|
|
SerialProtocol_MAVLink = 1,
|
2016-05-03 15:35:45 -03:00
|
|
|
SerialProtocol_MAVLink2 = 2, // do not use - use MAVLink and provide instance of 1
|
|
|
|
SerialProtocol_FrSky_D = 3, // FrSky D protocol (D-receivers)
|
|
|
|
SerialProtocol_FrSky_SPort = 4, // FrSky SPort protocol (X-receivers)
|
2015-01-19 09:32:24 -04:00
|
|
|
SerialProtocol_GPS = 5,
|
2016-05-03 15:35:45 -03:00
|
|
|
SerialProtocol_GPS2 = 6, // do not use - use GPS and provide instance of 1
|
2015-05-26 03:57:05 -03:00
|
|
|
SerialProtocol_AlexMos = 7,
|
|
|
|
SerialProtocol_SToRM32 = 8,
|
2018-02-27 12:00:32 -04:00
|
|
|
SerialProtocol_Rangefinder = 9,
|
2016-05-03 18:29:30 -03:00
|
|
|
SerialProtocol_FrSky_SPort_Passthrough = 10, // FrSky SPort Passthrough (OpenTX) protocol (X-receivers)
|
2017-08-24 13:12:16 -03:00
|
|
|
SerialProtocol_Lidar360 = 11, // Lightware SF40C, TeraRanger Tower or RPLidarA2
|
2018-02-27 12:00:32 -04:00
|
|
|
SerialProtocol_Aerotenna_uLanding = 12, // Ulanding support - deprecated, users should use Rangefinder
|
2017-11-02 23:27:29 -03:00
|
|
|
SerialProtocol_Beacon = 13,
|
|
|
|
SerialProtocol_Volz = 14, // Volz servo protocol
|
2018-04-02 01:21:20 -03:00
|
|
|
SerialProtocol_Sbus1 = 15,
|
2018-03-04 05:41:06 -04:00
|
|
|
SerialProtocol_ESCTelemetry = 16,
|
|
|
|
SerialProtocol_Devo_Telem = 17,
|
2018-11-23 03:40:56 -04:00
|
|
|
SerialProtocol_OpticalFlow = 18,
|
2018-12-18 23:28:18 -04:00
|
|
|
SerialProtocol_Robotis = 19,
|
2019-03-02 12:51:38 -04:00
|
|
|
SerialProtocol_NMEAOutput = 20,
|
2019-05-28 18:08:39 -03:00
|
|
|
SerialProtocol_WindVane = 21,
|
2019-04-20 03:13:23 -03:00
|
|
|
SerialProtocol_SLCAN = 22,
|
2019-08-27 04:41:21 -03:00
|
|
|
SerialProtocol_RCIN = 23,
|
2020-05-11 04:42:35 -03:00
|
|
|
SerialProtocol_Hott = 27,
|
2015-01-19 09:32:24 -04:00
|
|
|
};
|
|
|
|
|
2017-11-02 23:27:29 -03:00
|
|
|
// get singleton instance
|
2019-02-10 01:02:55 -04:00
|
|
|
static AP_SerialManager *get_singleton(void) {
|
|
|
|
return _singleton;
|
2017-11-02 23:27:29 -03:00
|
|
|
}
|
|
|
|
|
2015-01-19 09:32:24 -04:00
|
|
|
// init_console - initialise console at default baud rate
|
|
|
|
void init_console();
|
|
|
|
|
|
|
|
// init - initialise serial ports
|
|
|
|
void init();
|
|
|
|
|
2015-03-27 22:44:43 -03:00
|
|
|
// find_serial - searches available serial ports that allows the given protocol
|
|
|
|
// instance should be zero if searching for the first instance, 1 for the second, etc
|
2016-10-30 02:24:21 -03:00
|
|
|
// returns uart on success, nullptr if a serial port cannot be found
|
2015-03-27 22:44:43 -03:00
|
|
|
AP_HAL::UARTDriver *find_serial(enum SerialProtocol protocol, uint8_t instance) const;
|
2015-01-29 00:35:42 -04:00
|
|
|
|
|
|
|
// find_baudrate - searches available serial ports for the first instance that allows the given protocol
|
2015-04-06 18:47:11 -03:00
|
|
|
// instance should be zero if searching for the first instance, 1 for the second, etc
|
2015-01-29 00:35:42 -04:00
|
|
|
// returns the baudrate of that protocol on success, 0 if a serial port cannot be found
|
2015-04-06 18:47:11 -03:00
|
|
|
uint32_t find_baudrate(enum SerialProtocol protocol, uint8_t instance) const;
|
2015-01-19 09:32:24 -04:00
|
|
|
|
2015-03-27 22:44:43 -03:00
|
|
|
// get_mavlink_channel - provides the mavlink channel associated with a given protocol (and instance)
|
|
|
|
// instance should be zero if searching for the first instance, 1 for the second, etc
|
2015-01-19 09:32:24 -04:00
|
|
|
// returns true if a channel is found, false if not
|
2015-03-27 22:44:43 -03:00
|
|
|
bool get_mavlink_channel(enum SerialProtocol protocol, uint8_t instance, mavlink_channel_t &mav_chan) const;
|
2015-01-19 09:32:24 -04:00
|
|
|
|
2016-05-16 00:34:32 -03:00
|
|
|
// get_mavlink_protocol - provides the specific MAVLink protocol for a
|
|
|
|
// given channel, or SerialProtocol_None if not found
|
|
|
|
SerialProtocol get_mavlink_protocol(mavlink_channel_t mav_chan) const;
|
|
|
|
|
2015-01-19 09:32:24 -04:00
|
|
|
// set_blocking_writes_all - sets block_writes on or off for all serial channels
|
|
|
|
void set_blocking_writes_all(bool blocking);
|
|
|
|
|
2018-12-19 07:24:57 -04:00
|
|
|
// get the passthru ports if enabled
|
|
|
|
bool get_passthru(AP_HAL::UARTDriver *&port1, AP_HAL::UARTDriver *&port2, uint8_t &timeout_s) const;
|
|
|
|
|
|
|
|
// disable passthru by settings SERIAL_PASS2 to -1
|
|
|
|
void disable_passthru(void);
|
2019-01-04 05:51:05 -04:00
|
|
|
|
|
|
|
// get Serial Port
|
|
|
|
AP_HAL::UARTDriver *get_serial_by_id(uint8_t id);
|
|
|
|
|
2015-01-19 09:32:24 -04:00
|
|
|
// parameter var table
|
|
|
|
static const struct AP_Param::GroupInfo var_info[];
|
|
|
|
|
|
|
|
private:
|
2019-02-10 01:02:55 -04:00
|
|
|
static AP_SerialManager *_singleton;
|
2017-11-02 23:27:29 -03:00
|
|
|
|
2015-01-19 09:32:24 -04:00
|
|
|
// array of uart info
|
2018-04-18 03:13:02 -03:00
|
|
|
struct UARTState {
|
2015-01-29 01:02:24 -04:00
|
|
|
AP_Int8 protocol;
|
|
|
|
AP_Int32 baud;
|
|
|
|
AP_HAL::UARTDriver* uart;
|
2018-11-10 05:45:01 -04:00
|
|
|
AP_Int16 options;
|
2015-01-29 01:02:24 -04:00
|
|
|
} state[SERIALMANAGER_NUM_PORTS];
|
2015-01-29 00:47:36 -04:00
|
|
|
|
2018-12-19 07:24:57 -04:00
|
|
|
// pass-through serial support
|
|
|
|
AP_Int8 passthru_port1;
|
|
|
|
AP_Int8 passthru_port2;
|
|
|
|
AP_Int8 passthru_timeout;
|
|
|
|
|
2018-04-18 03:13:02 -03:00
|
|
|
// search through managed serial connections looking for the
|
|
|
|
// instance-nth UART which is running protocol protocol
|
|
|
|
const UARTState *find_protocol_instance(enum SerialProtocol protocol,
|
|
|
|
uint8_t instance) const;
|
|
|
|
|
2015-01-29 00:47:36 -04:00
|
|
|
uint32_t map_baudrate(int32_t rate) const;
|
2015-03-27 22:44:43 -03:00
|
|
|
|
|
|
|
// protocol_match - returns true if the protocols match
|
|
|
|
bool protocol_match(enum SerialProtocol protocol1, enum SerialProtocol protocol2) const;
|
2018-11-10 05:45:01 -04:00
|
|
|
|
|
|
|
// setup any special options
|
2020-05-11 04:42:35 -03:00
|
|
|
void set_options(uint16_t i);
|
2015-01-19 09:32:24 -04:00
|
|
|
};
|
2017-11-20 21:10:02 -04:00
|
|
|
|
|
|
|
namespace AP {
|
|
|
|
AP_SerialManager &serialmanager();
|
|
|
|
};
|