#include #if CONFIG_HAL_BOARD_SUBTYPE == HAL_BOARD_SUBTYPE_LINUX_BEBOP #include #include #include #include #include #include #include #include #include #include "RCOutput_Bebop.h" #include "Util.h" /* BEBOP BLDC motor controller address and registers description */ #define BEBOP_BLDC_I2C_ADDR 0x08 #define BEBOP_BLDC_STARTPROP 0x40 #define BEBOP_BLDC_SETREFSPEED 0x02 struct bldc_ref_speed_data { uint8_t cmd; uint16_t rpm[BEBOP_BLDC_MOTORS_NUM]; uint8_t enable_security; uint8_t checksum; }__attribute__((packed)); #define BEBOP_BLDC_GETOBSDATA 0x20 struct bldc_obs_data { uint16_t rpm[BEBOP_BLDC_MOTORS_NUM]; uint16_t batt_mv; uint8_t status; uint8_t error; uint8_t motors_err; uint8_t temp; uint8_t checksum; }__attribute__((packed)); #define BEBOP_BLDC_TOGGLE_GPIO 0x4d #define BEBOP_BLDC_GPIO_RESET (1 << 0) #define BEBOP_BLDC_GPIO_RED (1 << 1) #define BEBOP_BLDC_GPIO_GREEN (1 << 2) #define BEBOP_BLDC_STOP_PROP 0x60 #define BEBOP_BLDC_CLEAR_ERROR 0x80 #define BEBOP_BLDC_PLAY_SOUND 0x82 #define BEBOP_BLDC_GET_INFO 0xA0 #define BEBOP_BLDC_MIN_PERIOD_US 1100 #define BEBOP_BLDC_MAX_PERIOD_US 1900 #define BEBOP_BLDC_MIN_RPM 3000 /* the max rpm speed is different on Bebop 2 */ #define BEBOP_BLDC_MAX_RPM_1 11000 #define BEBOP_BLDC_MAX_RPM_2 12200 /* Priority of the thread controlling the BLDC via i2c * set to 14, which is the same as the UART */ #define RCOUT_BEBOP_RTPRIO 14 /* Set timeout to 500ms */ #define BEBOP_BLDC_TIMEOUT_NS 500000000 enum { BEBOP_BLDC_STARTED, BEBOP_BLDC_STOPPED, }; using namespace Linux; static const AP_HAL::HAL& hal = AP_HAL::get_HAL(); RCOutput_Bebop::RCOutput_Bebop(): _i2c_sem(NULL), _min_pwm(BEBOP_BLDC_MIN_PERIOD_US), _max_pwm(BEBOP_BLDC_MAX_PERIOD_US), _state(BEBOP_BLDC_STOPPED) { memset(_period_us, 0, sizeof(_period_us)); memset(_request_period_us, 0, sizeof(_request_period_us)); memset(_rpm, 0, sizeof(_rpm)); } uint8_t RCOutput_Bebop::_checksum(uint8_t *data, unsigned int len) { uint8_t checksum = data[0]; unsigned int i; for (i = 1; i < len; i++) checksum = checksum ^ data[i]; return checksum; } void RCOutput_Bebop::_start_prop() { uint8_t data = BEBOP_BLDC_STARTPROP; if (!_i2c_sem->take(0)) return; hal.i2c1->write(BEBOP_BLDC_I2C_ADDR, 1, &data); _i2c_sem->give(); _state = BEBOP_BLDC_STARTED; } void RCOutput_Bebop::_set_ref_speed(uint16_t rpm[BEBOP_BLDC_MOTORS_NUM]) { struct bldc_ref_speed_data data; int i; data.cmd = BEBOP_BLDC_SETREFSPEED; for (i=0; itake(0)) return; hal.i2c1->write(BEBOP_BLDC_I2C_ADDR, sizeof(data), (uint8_t *)&data); _i2c_sem->give(); } bool RCOutput_Bebop::_get_info(struct bldc_info *info) { if (info == NULL) { return false; } memset(info, 0, sizeof(struct bldc_info)); if (!_i2c_sem->take(0)) { return false; } hal.i2c1->readRegisters(BEBOP_BLDC_I2C_ADDR, BEBOP_BLDC_GET_INFO, sizeof(struct bldc_info), (uint8_t *)info); _i2c_sem->give(); return true; } int RCOutput_Bebop::read_obs_data(BebopBLDC_ObsData &obs) { struct bldc_obs_data data; int i; memset(&data, 0, sizeof(data)); if (!_i2c_sem->take(0)) return -EBUSY; hal.i2c1->readRegisters(BEBOP_BLDC_I2C_ADDR, BEBOP_BLDC_GETOBSDATA, sizeof(data), (uint8_t *)&data); _i2c_sem->give(); if (data.checksum != _checksum((uint8_t *)&data, sizeof(data) - 1)) hal.console->printf("RCOutput_Bebop: bad checksum in obs data"); /* fill obs class */ for (i = 0; i < BEBOP_BLDC_MOTORS_NUM; i++) { /* extract 'rpm saturation bit' */ obs.rpm_saturated[i] = (data.rpm[i] & (1 << 7)) ? 1 : 0; /* clear 'rpm saturation bit' */ data.rpm[i] &= (uint16_t)(~(1 << 7)); obs.rpm[i] = be16toh(data.rpm[i]); if (obs.rpm[i] == 0) obs.rpm_saturated[i] = 0; } obs.batt_mv = be16toh(data.batt_mv); obs.status = data.status; obs.error = data.error; obs.motors_err = data.motors_err; obs.temperature = data.temp; return 0; } void RCOutput_Bebop::_toggle_gpio(uint8_t mask) { if (!_i2c_sem->take(0)) return; hal.i2c1->writeRegister(BEBOP_BLDC_I2C_ADDR, BEBOP_BLDC_TOGGLE_GPIO, mask); _i2c_sem->give(); } void RCOutput_Bebop::_stop_prop() { uint8_t data = BEBOP_BLDC_STOP_PROP; _state = BEBOP_BLDC_STOPPED; if (!_i2c_sem->take(0)) return; hal.i2c1->write(BEBOP_BLDC_I2C_ADDR, 1, &data); _i2c_sem->give(); } void RCOutput_Bebop::_clear_error() { uint8_t data = BEBOP_BLDC_CLEAR_ERROR; if (!_i2c_sem->take(0)) return; hal.i2c1->write(BEBOP_BLDC_I2C_ADDR, 1, &data); _i2c_sem->give(); } void RCOutput_Bebop::_play_sound(uint8_t sound) { if (!_i2c_sem->take(0)) return; hal.i2c1->writeRegister(BEBOP_BLDC_I2C_ADDR, BEBOP_BLDC_PLAY_SOUND, sound); _i2c_sem->give(); } uint16_t RCOutput_Bebop::_period_us_to_rpm(uint16_t period_us) { float period_us_fl = period_us; float rpm_fl = (period_us_fl - _min_pwm)/(_max_pwm - _min_pwm) * (_max_rpm - BEBOP_BLDC_MIN_RPM) + BEBOP_BLDC_MIN_RPM; return (uint16_t)rpm_fl; } void RCOutput_Bebop::init() { int ret=0; struct sched_param param = { .sched_priority = RCOUT_BEBOP_RTPRIO }; pthread_attr_t attr; pthread_condattr_t cond_attr; _i2c_sem = hal.i2c1->get_semaphore(); if (_i2c_sem == NULL) { AP_HAL::panic("RCOutput_Bebop: can't get i2c sem"); return; /* never reached */ } /* Initialize thread, cond, and mutex */ ret = pthread_mutex_init(&_mutex, NULL); if (ret != 0) { perror("RCout_Bebop: failed to init mutex\n"); return; } pthread_mutex_lock(&_mutex); pthread_condattr_init(&cond_attr); pthread_condattr_setclock(&cond_attr, CLOCK_MONOTONIC); ret = pthread_cond_init(&_cond, &cond_attr); pthread_condattr_destroy(&cond_attr); if (ret != 0) { perror("RCout_Bebop: failed to init cond\n"); goto exit; } ret = pthread_attr_init(&attr); if (ret != 0) { perror("RCOut_Bebop: failed to init attr\n"); goto exit; } pthread_attr_setinheritsched(&attr, PTHREAD_EXPLICIT_SCHED); pthread_attr_setschedpolicy(&attr, SCHED_FIFO); pthread_attr_setschedparam(&attr, ¶m); ret = pthread_create(&_thread, &attr, _control_thread, this); if (ret != 0) { perror("RCOut_Bebop: failed to create thread\n"); goto exit; } _clear_error(); /* Set an initial dummy frequency */ _frequency = 50; exit: pthread_mutex_unlock(&_mutex); return; } void RCOutput_Bebop::set_freq(uint32_t chmask, uint16_t freq_hz) { _frequency = freq_hz; } uint16_t RCOutput_Bebop::get_freq(uint8_t ch) { return _frequency; } void RCOutput_Bebop::enable_ch(uint8_t ch) { } void RCOutput_Bebop::disable_ch(uint8_t ch) { _stop_prop(); } void RCOutput_Bebop::write(uint8_t ch, uint16_t period_us) { if (ch >= BEBOP_BLDC_MOTORS_NUM) return; _request_period_us[ch] = period_us; if (!_corking) push(); } void RCOutput_Bebop::cork() { _corking = true; } void RCOutput_Bebop::push() { _corking = false; pthread_mutex_lock(&_mutex); memcpy(_period_us, _request_period_us, sizeof(_period_us)); pthread_cond_signal(&_cond); pthread_mutex_unlock(&_mutex); memset(_request_period_us, 0 ,sizeof(_request_period_us)); } uint16_t RCOutput_Bebop::read(uint8_t ch) { if (ch < BEBOP_BLDC_MOTORS_NUM) { return _period_us[ch]; } else { return 0; } } void RCOutput_Bebop::read(uint16_t* period_us, uint8_t len) { for (int i = 0; i < len; i++) period_us[i] = read(0 + i); } void RCOutput_Bebop::set_esc_scaling(uint16_t min_pwm, uint16_t max_pwm) { _min_pwm = min_pwm; _max_pwm = max_pwm; } /* Separate thread to handle the Bebop motors controller */ void* RCOutput_Bebop::_control_thread(void *arg) { RCOutput_Bebop* rcout = (RCOutput_Bebop *) arg; rcout->_run_rcout(); return NULL; } void RCOutput_Bebop::_run_rcout() { uint16_t current_period_us[BEBOP_BLDC_MOTORS_NUM]; uint8_t i; int ret; struct timespec ts; struct bldc_info info; uint8_t bebop_bldc_channels[BEBOP_BLDC_MOTORS_NUM]; uint8_t bebop_bldc_right_front, bebop_bldc_left_front, bebop_bldc_left_back, bebop_bldc_right_back; int hw_version; memset(current_period_us, 0, sizeof(current_period_us)); if (!_get_info(&info)) { AP_HAL::panic("failed to get BLDC info"); } /* Set motor order depending on BLDC version.On bebop 1 with version 1 * keep current order. The order changes from version 2 on bebop 1 and * remains the same as this for bebop 2 */ if (info.version_maj == 1) { bebop_bldc_right_front = BEBOP_BLDC_MOTOR_1; bebop_bldc_left_front = BEBOP_BLDC_MOTOR_2; bebop_bldc_left_back = BEBOP_BLDC_MOTOR_3; bebop_bldc_right_back = BEBOP_BLDC_MOTOR_4; } else { bebop_bldc_right_front = BEBOP_BLDC_MOTOR_2; bebop_bldc_left_front = BEBOP_BLDC_MOTOR_1; bebop_bldc_left_back = BEBOP_BLDC_MOTOR_4; bebop_bldc_right_back = BEBOP_BLDC_MOTOR_3; } bebop_bldc_channels[0] = bebop_bldc_right_front; bebop_bldc_channels[1] = bebop_bldc_left_back; bebop_bldc_channels[2] = bebop_bldc_left_front; bebop_bldc_channels[3] = bebop_bldc_right_back; hw_version = Util::from(hal.util)->get_hw_arm32(); if (hw_version == UTIL_HARDWARE_BEBOP) { _max_rpm = BEBOP_BLDC_MAX_RPM_1; } else if (hw_version == UTIL_HARDWARE_BEBOP2) { _max_rpm = BEBOP_BLDC_MAX_RPM_2; } else if (hw_version < 0) { AP_HAL::panic("failed to get hw version %s", strerror(hw_version)); } else { AP_HAL::panic("unsupported hw version %d", hw_version); } while (true) { pthread_mutex_lock(&_mutex); ret = clock_gettime(CLOCK_MONOTONIC, &ts); if (ret != 0) hal.console->println("RCOutput_Bebop: bad checksum in obs data"); if (ts.tv_nsec > (1000000000 - BEBOP_BLDC_TIMEOUT_NS)) { ts.tv_sec += 1; ts.tv_nsec = ts.tv_nsec + BEBOP_BLDC_TIMEOUT_NS - 1000000000; } else { ts.tv_nsec += BEBOP_BLDC_TIMEOUT_NS; } ret = 0; while ((memcmp(_period_us, current_period_us, sizeof(_period_us)) == 0) && (ret == 0)) ret = pthread_cond_timedwait(&_cond, &_mutex, &ts); memcpy(current_period_us, _period_us, sizeof(_period_us)); pthread_mutex_unlock(&_mutex); /* start propellers if the speed of the 4 motors is >= min speed * min speed set to min_pwm + 50*/ for (i = 0; i < BEBOP_BLDC_MOTORS_NUM; i++) { if (current_period_us[i] <= _min_pwm + 50) break; _rpm[bebop_bldc_channels[i]] = _period_us_to_rpm(current_period_us[i]); } if (i < BEBOP_BLDC_MOTORS_NUM) { /* one motor pwm value is at minimum (or under) * if the motors are started, stop them*/ if (_state == BEBOP_BLDC_STARTED) { _stop_prop(); _clear_error(); } } else { /* all the motor pwm values are higher than minimum * if the bldc is stopped, start it*/ if (_state == BEBOP_BLDC_STOPPED) _start_prop(); } _set_ref_speed(_rpm); } } #endif