ardupilot/libraries/AP_HAL/RCOutput.h

143 lines
4.2 KiB
C++

#pragma once
#include "AP_HAL_Namespace.h"
#include <stdint.h>
#define RC_OUTPUT_MIN_PULSEWIDTH 400
#define RC_OUTPUT_MAX_PULSEWIDTH 2100
/* Define the CH_n names, indexed from 1, if we don't have them already */
#ifndef CH_1
#define CH_1 0
#define CH_2 1
#define CH_3 2
#define CH_4 3
#define CH_5 4
#define CH_6 5
#define CH_7 6
#define CH_8 7
#define CH_9 8
#define CH_10 9
#define CH_11 10
#define CH_12 11
#define CH_13 12
#define CH_14 13
#define CH_15 14
#define CH_16 15
#define CH_17 16
#define CH_18 17
#define CH_NONE 255
#endif
class AP_HAL::RCOutput {
public:
virtual void init() = 0;
/* Output freq (1/period) control */
virtual void set_freq(uint32_t chmask, uint16_t freq_hz) = 0;
virtual uint16_t get_freq(uint8_t ch) = 0;
/* Output active/highZ control, either by single channel at a time
* or a mask of channels */
virtual void enable_ch(uint8_t ch) = 0;
virtual void disable_ch(uint8_t ch) = 0;
/*
* Output a single channel, possibly grouped with previous writes if
* cork() has been called before.
*/
virtual void write(uint8_t ch, uint16_t period_us) = 0;
/*
* Delay subsequent calls to write() going to the underlying hardware in
* order to group related writes together. When all the needed writes are
* done, call push() to commit the changes.
*/
virtual void cork() = 0;
/*
* Push pending changes to the underlying hardware. All changes between a
* call to cork() and push() are pushed together in a single transaction.
*/
virtual void push() = 0;
/* Read back current output state, as either single channel or
* array of channels. On boards that have a separate IO controller,
* this returns the latest output value that the IO controller has
* reported */
virtual uint16_t read(uint8_t ch) = 0;
virtual void read(uint16_t* period_us, uint8_t len) = 0;
/* Read the current input state. This returns the last value that was written. */
virtual uint16_t read_last_sent(uint8_t ch) { return read(ch); }
virtual void read_last_sent(uint16_t* period_us, uint8_t len) { read(period_us, len); };
/*
set PWM to send to a set of channels when the safety switch is
in the safe state
*/
virtual void set_safety_pwm(uint32_t chmask, uint16_t period_us) {}
/*
set PWM to send to a set of channels if the FMU firmware dies
*/
virtual void set_failsafe_pwm(uint32_t chmask, uint16_t period_us) {}
/*
force the safety switch on, disabling PWM output from the IO board
return false (indicating failure) by default so that boards with no safety switch
do not need to implement this method
*/
virtual bool force_safety_on(void) { return false; }
/*
force the safety switch off, enabling PWM output from the IO board
*/
virtual void force_safety_off(void) {}
/*
If we support async sends (px4), this will force it to be serviced immediately
*/
virtual void force_safety_no_wait(void) {}
/*
setup scaling of ESC output for ESCs that can output a
percentage of power (such as UAVCAN ESCs). The values are in
microseconds, and represent minimum and maximum PWM values which
will be used to convert channel writes into a percentage
*/
virtual void set_esc_scaling(uint16_t min_pwm, uint16_t max_pwm) {}
/*
returns the pwm value scaled to [-1;1] regrading to set_esc_scaling ranges range without constraints.
*/
virtual float scale_esc_to_unity(uint16_t pwm) { return 0; }
/*
enable PX4IO SBUS out at the given rate
*/
virtual bool enable_px4io_sbus_out(uint16_t rate_hz) { return false; }
/*
* Optional method to control the update of the motors. Derived classes
* can implement it if their HAL layer requires.
*/
virtual void timer_tick(void) { }
/*
output modes. Allows for support of oneshot
*/
enum output_mode {
MODE_PWM_NORMAL,
MODE_PWM_ONESHOT,
MODE_PWM_BRUSHED
};
virtual void set_output_mode(enum output_mode mode) {}
/*
set default update rate
*/
virtual void set_default_rate(uint16_t rate_hz) {}
};