bldc/terminal.c

1283 lines
47 KiB
C

/*
Copyright 2016 - 2020 Benjamin Vedder benjamin@vedder.se
This file is part of the VESC firmware.
The VESC firmware 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.
The VESC firmware 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/>.
*/
#include "ch.h"
#include "hal.h"
#include "terminal.h"
#include "mcpwm.h"
#include "mcpwm_foc.h"
#include "mc_interface.h"
#include "commands.h"
#include "hw.h"
#include "comm_can.h"
#include "utils.h"
#include "timeout.h"
#include "encoder.h"
#include "drv8301.h"
#include "drv8305.h"
#include "drv8320s.h"
#include "drv8323s.h"
#include "app.h"
#include "comm_usb.h"
#include "comm_usb_serial.h"
#include "mempools.h"
#include "crc.h"
#include <string.h>
#include <stdio.h>
#include <math.h>
// Settings
#define FAULT_VEC_LEN 25
#define CALLBACK_LEN 40
// Private types
typedef struct _terminal_callback_struct {
const char *command;
const char *help;
const char *arg_names;
void(*cbf)(int argc, const char **argv);
} terminal_callback_struct;
// Private variables
static volatile fault_data fault_vec[FAULT_VEC_LEN];
static volatile int fault_vec_write = 0;
static terminal_callback_struct callbacks[CALLBACK_LEN];
static int callback_write = 0;
void terminal_process_string(char *str) {
enum { kMaxArgs = 64 };
int argc = 0;
char *argv[kMaxArgs];
char *p2 = strtok(str, " ");
while (p2 && argc < kMaxArgs) {
argv[argc++] = p2;
p2 = strtok(0, " ");
}
if (argc == 0) {
commands_printf("No command received\n");
return;
}
for (int i = 0;i < callback_write;i++) {
if (callbacks[i].cbf != 0 && strcmp(argv[0], callbacks[i].command) == 0) {
callbacks[i].cbf(argc, (const char**)argv);
return;
}
}
if (strcmp(argv[0], "ping") == 0) {
commands_printf("pong\n");
} else if (strcmp(argv[0], "stop") == 0) {
mc_interface_set_duty(0);
commands_printf("Motor stopped\n");
} else if (strcmp(argv[0], "last_adc_duration") == 0) {
commands_printf("Latest ADC duration: %.4f ms", (double)(mcpwm_get_last_adc_isr_duration() * 1000.0));
commands_printf("Latest injected ADC duration: %.4f ms", (double)(mc_interface_get_last_inj_adc_isr_duration() * 1000.0));
commands_printf("Latest sample ADC duration: %.4f ms\n", (double)(mc_interface_get_last_sample_adc_isr_duration() * 1000.0));
} else if (strcmp(argv[0], "kv") == 0) {
commands_printf("Calculated KV: %.2f rpm/volt\n", (double)mcpwm_get_kv_filtered());
} else if (strcmp(argv[0], "mem") == 0) {
size_t n, size;
n = chHeapStatus(NULL, &size);
commands_printf("core free memory : %u bytes", chCoreGetStatusX());
commands_printf("heap fragments : %u", n);
commands_printf("heap free total : %u bytes\n", size);
} else if (strcmp(argv[0], "threads") == 0) {
thread_t *tp;
static const char *states[] = {CH_STATE_NAMES};
commands_printf(" addr stack prio refs state name motor time ");
commands_printf("-------------------------------------------------------------------");
tp = chRegFirstThread();
do {
commands_printf("%.8lx %.8lx %4lu %4lu %9s %14s %5lu %lu (%.1f %%)",
(uint32_t)tp, (uint32_t)tp->p_ctx.r13,
(uint32_t)tp->p_prio, (uint32_t)(tp->p_refs - 1),
states[tp->p_state], tp->p_name, tp->motor_selected, (uint32_t)tp->p_time,
(double)(100.0 * (float)tp->p_time / (float)chVTGetSystemTimeX()));
tp = chRegNextThread(tp);
} while (tp != NULL);
commands_printf(" ");
} else if (strcmp(argv[0], "fault") == 0) {
commands_printf("%s\n", mc_interface_fault_to_string(mc_interface_get_fault()));
} else if (strcmp(argv[0], "faults") == 0) {
if (fault_vec_write == 0) {
commands_printf("No faults registered since startup\n");
} else {
commands_printf("The following faults were registered since start:\n");
for (int i = 0;i < fault_vec_write;i++) {
commands_printf("Fault : %s", mc_interface_fault_to_string(fault_vec[i].fault));
commands_printf("Motor : %d", fault_vec[i].motor);
commands_printf("Current : %.1f", (double)fault_vec[i].current);
commands_printf("Current filtered : %.1f", (double)fault_vec[i].current_filtered);
commands_printf("Voltage : %.2f", (double)fault_vec[i].voltage);
#ifdef HW_HAS_GATE_DRIVER_SUPPLY_MONITOR
commands_printf("Gate drv voltage : %.2f", (double)fault_vec[i].gate_driver_voltage);
#endif
commands_printf("Duty : %.3f", (double)fault_vec[i].duty);
commands_printf("RPM : %.1f", (double)fault_vec[i].rpm);
commands_printf("Tacho : %d", fault_vec[i].tacho);
commands_printf("Cycles running : %d", fault_vec[i].cycles_running);
commands_printf("TIM duty : %d", (int)((float)fault_vec[i].tim_top * fault_vec[i].duty));
commands_printf("TIM val samp : %d", fault_vec[i].tim_val_samp);
commands_printf("TIM current samp : %d", fault_vec[i].tim_current_samp);
commands_printf("TIM top : %d", fault_vec[i].tim_top);
commands_printf("Comm step : %d", fault_vec[i].comm_step);
commands_printf("Temperature : %.2f", (double)fault_vec[i].temperature);
#ifdef HW_HAS_DRV8301
if (fault_vec[i].fault == FAULT_CODE_DRV) {
commands_printf("DRV8301_FAULTS : %s", drv8301_faults_to_string(fault_vec[i].drv8301_faults));
}
#elif defined(HW_HAS_DRV8320S)
if (fault_vec[i].fault == FAULT_CODE_DRV) {
commands_printf("DRV8320S_FAULTS : %s", drv8320s_faults_to_string(fault_vec[i].drv8301_faults));
}
#elif defined(HW_HAS_DRV8323S)
if (fault_vec[i].fault == FAULT_CODE_DRV) {
commands_printf("DRV8323S_FAULTS : %s", drv8323s_faults_to_string(fault_vec[i].drv8301_faults));
}
#endif
commands_printf(" ");
}
}
} else if (strcmp(argv[0], "rpm") == 0) {
commands_printf("Electrical RPM: %.2f rpm\n", (double)mc_interface_get_rpm());
} else if (strcmp(argv[0], "tacho") == 0) {
commands_printf("Tachometer counts: %i\n", mc_interface_get_tachometer_value(0));
} else if (strcmp(argv[0], "dist") == 0) {
commands_printf("Trip dist. : %.2f m", (double)mc_interface_get_distance());
commands_printf("Trip dist. (ABS): %.2f m", (double)mc_interface_get_distance_abs());
commands_printf("Odometer : %u m\n", mc_interface_get_odometer());
} else if (strcmp(argv[0], "tim") == 0) {
chSysLock();
volatile int t1_cnt = TIM1->CNT;
volatile int t8_cnt = TIM8->CNT;
volatile int t1_cnt2 = TIM1->CNT;
volatile int t2_cnt = TIM2->CNT;
volatile int dir1 = !!(TIM1->CR1 & (1 << 4));
volatile int dir8 = !!(TIM8->CR1 & (1 << 4));
chSysUnlock();
int duty1 = TIM1->CCR1;
int duty2 = TIM1->CCR2;
int duty3 = TIM1->CCR3;
int top = TIM1->ARR;
int voltage_samp = TIM8->CCR1;
int current1_samp = TIM1->CCR4;
int current2_samp = TIM8->CCR2;
commands_printf("Tim1 CNT: %i", t1_cnt);
commands_printf("Tim8 CNT: %i", t8_cnt);
commands_printf("Tim2 CNT: %i", t2_cnt);
commands_printf("Amount off CNT: %i",top - (2*t8_cnt + t1_cnt + t1_cnt2)/2);
commands_printf("Duty cycle1: %u", duty1);
commands_printf("Duty cycle2: %u", duty2);
commands_printf("Duty cycle3: %u", duty3);
commands_printf("Top: %u", top);
commands_printf("Dir1: %u", dir1);
commands_printf("Dir8: %u", dir8);
commands_printf("Voltage sample: %u", voltage_samp);
commands_printf("Current 1 sample: %u", current1_samp);
commands_printf("Current 2 sample: %u\n", current2_samp);
} else if (strcmp(argv[0], "volt") == 0) {
commands_printf("Input voltage: %.2f\n", (double)GET_INPUT_VOLTAGE());
#ifdef HW_HAS_GATE_DRIVER_SUPPLY_MONITOR
commands_printf("Gate driver power supply output voltage: %.2f\n", (double)GET_GATE_DRIVER_SUPPLY_VOLTAGE());
#endif
} else if (strcmp(argv[0], "param_detect") == 0) {
// Use COMM_MODE_DELAY and try to figure out the motor parameters.
if (argc == 4) {
float current = -1.0;
float min_rpm = -1.0;
float low_duty = -1.0;
sscanf(argv[1], "%f", &current);
sscanf(argv[2], "%f", &min_rpm);
sscanf(argv[3], "%f", &low_duty);
if (current > 0.0 && current < mc_interface_get_configuration()->l_current_max &&
min_rpm > 10.0 && min_rpm < 3000.0 &&
low_duty > 0.02 && low_duty < 0.8) {
float cycle_integrator;
float coupling_k;
int8_t hall_table[8];
int hall_res;
if (conf_general_detect_motor_param(current, min_rpm, low_duty, &cycle_integrator, &coupling_k, hall_table, &hall_res)) {
commands_printf("Cycle integrator limit: %.2f", (double)cycle_integrator);
commands_printf("Coupling factor: %.2f", (double)coupling_k);
if (hall_res == 0) {
commands_printf("Detected hall sensor table:");
commands_printf("%i, %i, %i, %i, %i, %i, %i, %i\n",
hall_table[0], hall_table[1], hall_table[2], hall_table[3],
hall_table[4], hall_table[5], hall_table[6], hall_table[7]);
} else if (hall_res == -1) {
commands_printf("Hall sensor detection failed:");
commands_printf("%i, %i, %i, %i, %i, %i, %i, %i\n",
hall_table[0], hall_table[1], hall_table[2], hall_table[3],
hall_table[4], hall_table[5], hall_table[6], hall_table[7]);
} else if (hall_res == -2) {
commands_printf("WS2811 enabled. Hall sensors cannot be used.\n");
} else if (hall_res == -3) {
commands_printf("Encoder enabled. Hall sensors cannot be used.\n");
}
} else {
commands_printf("Detection failed. Try again with different parameters.\n");
}
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires three arguments.\n");
}
} else if (strcmp(argv[0], "rpm_dep") == 0) {
mc_rpm_dep_struct rpm_dep = mcpwm_get_rpm_dep();
commands_printf("Cycle int limit: %.2f", (double)rpm_dep.cycle_int_limit);
commands_printf("Cycle int limit running: %.2f", (double)rpm_dep.cycle_int_limit_running);
commands_printf("Cycle int limit max: %.2f\n", (double)rpm_dep.cycle_int_limit_max);
} else if (strcmp(argv[0], "can_devs") == 0) {
commands_printf("CAN devices seen on the bus the past second:\n");
for (int i = 0;i < CAN_STATUS_MSGS_TO_STORE;i++) {
can_status_msg *msg = comm_can_get_status_msg_index(i);
if (msg->id >= 0 && UTILS_AGE_S(msg->rx_time) < 1.0) {
commands_printf("ID : %i", msg->id);
commands_printf("RX Time : %i", msg->rx_time);
commands_printf("Age (milliseconds) : %.2f", (double)(UTILS_AGE_S(msg->rx_time) * 1000.0));
commands_printf("RPM : %.2f", (double)msg->rpm);
commands_printf("Current : %.2f", (double)msg->current);
commands_printf("Duty : %.2f\n", (double)msg->duty);
}
io_board_adc_values *io_adc = comm_can_get_io_board_adc_1_4_index(i);
if (io_adc->id >= 0 && UTILS_AGE_S(io_adc->rx_time) < 1.0) {
commands_printf("IO Board ADC 1_4");
commands_printf("ID : %i", io_adc->id);
commands_printf("RX Time : %i", io_adc->rx_time);
commands_printf("Age (milliseconds) : %.2f", (double)(UTILS_AGE_S(io_adc->rx_time) * 1000.0));
commands_printf("ADC : %.2f %.2f %.2f %.2f\n",
(double)io_adc->adc_voltages[0], (double)io_adc->adc_voltages[1],
(double)io_adc->adc_voltages[2], (double)io_adc->adc_voltages[3]);
}
io_adc = comm_can_get_io_board_adc_5_8_index(i);
if (io_adc->id >= 0 && UTILS_AGE_S(io_adc->rx_time) < 1.0) {
commands_printf("IO Board ADC 5_8");
commands_printf("ID : %i", io_adc->id);
commands_printf("RX Time : %i", io_adc->rx_time);
commands_printf("Age (milliseconds) : %.2f", (double)(UTILS_AGE_S(io_adc->rx_time) * 1000.0));
commands_printf("ADC : %.2f %.2f %.2f %.2f\n",
(double)io_adc->adc_voltages[0], (double)io_adc->adc_voltages[1],
(double)io_adc->adc_voltages[2], (double)io_adc->adc_voltages[3]);
}
io_board_digial_inputs *io_in = comm_can_get_io_board_digital_in_index(i);
if (io_in->id >= 0 && UTILS_AGE_S(io_in->rx_time) < 1.0) {
commands_printf("IO Board Inputs");
commands_printf("ID : %i", io_in->id);
commands_printf("RX Time : %i", io_in->rx_time);
commands_printf("Age (milliseconds) : %.2f", (double)(UTILS_AGE_S(io_in->rx_time) * 1000.0));
commands_printf("IN : %llu %llu %llu %llu %llu %llu %llu %llu\n",
(io_in->inputs >> 0) & 1, (io_in->inputs >> 1) & 1,
(io_in->inputs >> 2) & 1, (io_in->inputs >> 3) & 1,
(io_in->inputs >> 4) & 1, (io_in->inputs >> 5) & 1,
(io_in->inputs >> 6) & 1, (io_in->inputs >> 7) & 1);
}
}
} else if (strcmp(argv[0], "foc_encoder_detect") == 0) {
if (argc == 2) {
float current = -1.0;
sscanf(argv[1], "%f", &current);
mc_configuration *mcconf = mempools_alloc_mcconf();
*mcconf = *mc_interface_get_configuration();
if (current > 0.0 && current <= mcconf->l_current_max) {
if (encoder_is_configured()) {
mc_motor_type type_old = mcconf->motor_type;
mcconf->motor_type = MOTOR_TYPE_FOC;
mc_interface_set_configuration(mcconf);
float offset = 0.0;
float ratio = 0.0;
bool inverted = false;
mcpwm_foc_encoder_detect(current, true, &offset, &ratio, &inverted);
mcconf->motor_type = type_old;
mc_interface_set_configuration(mcconf);
commands_printf("Offset : %.2f", (double)offset);
commands_printf("Ratio : %.2f", (double)ratio);
commands_printf("Inverted : %s\n", inverted ? "true" : "false");
} else {
commands_printf("Encoder not enabled.\n");
}
} else {
commands_printf("Invalid argument(s).\n");
}
mempools_free_mcconf(mcconf);
} else {
commands_printf("This command requires one argument.\n");
}
} else if (strcmp(argv[0], "measure_res") == 0) {
if (argc == 2) {
float current = -1.0;
sscanf(argv[1], "%f", &current);
mc_configuration *mcconf = mempools_alloc_mcconf();
*mcconf = *mc_interface_get_configuration();
mc_configuration *mcconf_old = mempools_alloc_mcconf();
*mcconf_old = *mc_interface_get_configuration();
if (current > 0.0 && current <= mcconf->l_current_max) {
mcconf->motor_type = MOTOR_TYPE_FOC;
mc_interface_set_configuration(mcconf);
commands_printf("Resistance: %.6f ohm\n", (double)mcpwm_foc_measure_resistance(current, 2000, true));
mc_interface_set_configuration(mcconf_old);
} else {
commands_printf("Invalid argument(s).\n");
}
mempools_free_mcconf(mcconf);
mempools_free_mcconf(mcconf_old);
} else {
commands_printf("This command requires one argument.\n");
}
} else if (strcmp(argv[0], "measure_ind") == 0) {
if (argc == 2) {
float duty = -1.0;
sscanf(argv[1], "%f", &duty);
if (duty > 0.0 && duty < 0.9) {
mc_configuration *mcconf = mempools_alloc_mcconf();
*mcconf = *mc_interface_get_configuration();
mc_configuration *mcconf_old = mempools_alloc_mcconf();
*mcconf_old = *mc_interface_get_configuration();
mcconf->motor_type = MOTOR_TYPE_FOC;
mc_interface_set_configuration(mcconf);
float curr, ld_lq_diff;
float ind = mcpwm_foc_measure_inductance(duty, 400, &curr, &ld_lq_diff);
commands_printf("Inductance: %.2f uH, ld_lq_diff: %.2f uH (%.2f A)\n",
(double)ind, (double)ld_lq_diff, (double)curr);
mc_interface_set_configuration(mcconf_old);
mempools_free_mcconf(mcconf);
mempools_free_mcconf(mcconf_old);
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires one argument.\n");
}
} else if (strcmp(argv[0], "measure_linkage") == 0) {
if (argc == 5) {
float current = -1.0;
float duty = -1.0;
float min_erpm = -1.0;
float res = -1.0;
sscanf(argv[1], "%f", &current);
sscanf(argv[2], "%f", &duty);
sscanf(argv[3], "%f", &min_erpm);
sscanf(argv[4], "%f", &res);
if (current > 0.0 && current <= mc_interface_get_configuration()->l_current_max &&
min_erpm > 0.0 && duty > 0.02 && res >= 0.0) {
float linkage;
conf_general_measure_flux_linkage(current, duty, min_erpm, res, &linkage);
commands_printf("Flux linkage: %.7f\n", (double)linkage);
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires four arguments.\n");
}
} else if (strcmp(argv[0], "measure_res_ind") == 0) {
mc_configuration *mcconf = mempools_alloc_mcconf();
*mcconf = *mc_interface_get_configuration();
mc_configuration *mcconf_old = mempools_alloc_mcconf();
*mcconf_old = *mc_interface_get_configuration();
mcconf->motor_type = MOTOR_TYPE_FOC;
mc_interface_set_configuration(mcconf);
float res = 0.0;
float ind = 0.0;
mcpwm_foc_measure_res_ind(&res, &ind);
commands_printf("Resistance: %.6f ohm", (double)res);
commands_printf("Inductance: %.2f microhenry\n", (double)ind);
mc_interface_set_configuration(mcconf_old);
mempools_free_mcconf(mcconf);
mempools_free_mcconf(mcconf_old);
} else if (strcmp(argv[0], "measure_linkage_foc") == 0) {
if (argc == 2) {
float duty = -1.0;
sscanf(argv[1], "%f", &duty);
if (duty > 0.0) {
mc_configuration *mcconf = mempools_alloc_mcconf();
*mcconf = *mc_interface_get_configuration();
mc_configuration *mcconf_old = mempools_alloc_mcconf();
*mcconf_old = *mc_interface_get_configuration();
mcconf->motor_type = MOTOR_TYPE_FOC;
mc_interface_set_configuration(mcconf);
const float res = (3.0 / 2.0) * mcconf->foc_motor_r;
// Disable timeout
systime_t tout = timeout_get_timeout_msec();
float tout_c = timeout_get_brake_current();
timeout_reset();
timeout_configure(60000, 0.0);
for (int i = 0;i < 100;i++) {
mc_interface_set_duty(((float)i / 100.0) * duty);
chThdSleepMilliseconds(20);
}
float vq_avg = 0.0;
float rpm_avg = 0.0;
float samples = 0.0;
float iq_avg = 0.0;
for (int i = 0;i < 1000;i++) {
vq_avg += mcpwm_foc_get_vq();
rpm_avg += mc_interface_get_rpm();
iq_avg += mc_interface_get_tot_current_directional();
samples += 1.0;
chThdSleepMilliseconds(1);
}
mc_interface_release_motor();
mc_interface_set_configuration(mcconf_old);
mempools_free_mcconf(mcconf);
mempools_free_mcconf(mcconf_old);
// Enable timeout
timeout_configure(tout, tout_c);
vq_avg /= samples;
rpm_avg /= samples;
iq_avg /= samples;
float linkage = (vq_avg - res * iq_avg) / (rpm_avg * ((2.0 * M_PI) / 60.0));
commands_printf("Flux linkage: %.7f\n", (double)linkage);
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires one argument.\n");
}
} else if (strcmp(argv[0], "measure_linkage_openloop") == 0) {
if (argc == 6) {
float current = -1.0;
float duty = -1.0;
float erpm_per_sec = -1.0;
float res = -1.0;
float ind = -1.0;
sscanf(argv[1], "%f", &current);
sscanf(argv[2], "%f", &duty);
sscanf(argv[3], "%f", &erpm_per_sec);
sscanf(argv[4], "%f", &res);
sscanf(argv[5], "%f", &ind);
if (current > 0.0 && current <= mc_interface_get_configuration()->l_current_max &&
erpm_per_sec > 0.0 && duty > 0.02 && res >= 0.0 && ind >= 0.0) {
float linkage, linkage_undriven, undriven_samples;
commands_printf("Measuring flux linkage...");
conf_general_measure_flux_linkage_openloop(current, duty, erpm_per_sec, res, ind,
&linkage, &linkage_undriven, &undriven_samples);
commands_printf(
"Flux linkage : %.7f\n"
"Flux Linkage (undriven) : %.7f\n"
"Undriven samples : %.1f\n",
(double)linkage, (double)linkage_undriven, (double)undriven_samples);
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires five arguments.\n");
}
} else if (strcmp(argv[0], "foc_state") == 0) {
mcpwm_foc_print_state();
commands_printf(" ");
} else if (strcmp(argv[0], "hw_status") == 0) {
commands_printf("Firmware: %d.%d", FW_VERSION_MAJOR, FW_VERSION_MINOR);
#ifdef HW_NAME
commands_printf("Hardware: %s", HW_NAME);
#endif
commands_printf("UUID: %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X %02X",
STM32_UUID_8[0], STM32_UUID_8[1], STM32_UUID_8[2], STM32_UUID_8[3],
STM32_UUID_8[4], STM32_UUID_8[5], STM32_UUID_8[6], STM32_UUID_8[7],
STM32_UUID_8[8], STM32_UUID_8[9], STM32_UUID_8[10], STM32_UUID_8[11]);
commands_printf("Permanent NRF found: %s", conf_general_permanent_nrf_found ? "Yes" : "No");
int curr0_offset;
int curr1_offset;
int curr2_offset;
mcpwm_foc_get_current_offsets(&curr0_offset, &curr1_offset, &curr2_offset,
mc_interface_get_motor_thread() == 2);
commands_printf("FOC Current Offsets: %d %d %d",
curr0_offset, curr1_offset, curr2_offset);
#ifdef COMM_USE_USB
commands_printf("USB config events: %d", comm_usb_serial_configured_cnt());
commands_printf("USB write timeouts: %u", comm_usb_get_write_timeout_cnt());
#else
commands_printf("USB not enabled on hardware.");
#endif
commands_printf("Mempool mcconf now: %d highest: %d (max %d)",
mempools_mcconf_allocated_num(), mempools_mcconf_highest(), MEMPOOLS_MCCONF_NUM - 1);
commands_printf("Mempool appconf now: %d highest: %d (max %d)",
mempools_appconf_allocated_num(), mempools_appconf_highest(), MEMPOOLS_APPCONF_NUM - 1);
commands_printf(" ");
} else if (strcmp(argv[0], "foc_openloop") == 0) {
if (argc == 3) {
float current = -1.0;
float erpm = -1.0;
sscanf(argv[1], "%f", &current);
sscanf(argv[2], "%f", &erpm);
if (current >= 0.0 && erpm >= 0.0) {
timeout_reset();
mcpwm_foc_set_openloop(current, erpm);
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires two arguments.\n");
}
} else if (strcmp(argv[0], "foc_openloop_duty") == 0) {
if (argc == 3) {
float duty = -1.0;
float erpm = -1.0;
sscanf(argv[1], "%f", &duty);
sscanf(argv[2], "%f", &erpm);
if (duty >= 0.0 && erpm >= 0.0) {
timeout_reset();
mcpwm_foc_set_openloop_duty(duty, erpm);
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires two arguments.\n");
}
} else if (strcmp(argv[0], "nrf_ext_set_enabled") == 0) {
if (argc == 2) {
int enabled = -1;
sscanf(argv[1], "%d", &enabled);
if (enabled >= 0) {
uint8_t buffer[2];
buffer[0] = COMM_EXT_NRF_SET_ENABLED;
buffer[1] = enabled;
commands_send_packet_nrf(buffer, 2);
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires one argument.\n");
}
} else if (strcmp(argv[0], "foc_sensors_detect_apply") == 0) {
if (argc == 2) {
float current = -1.0;
sscanf(argv[1], "%f", &current);
if (current > 0.0 && current <= mc_interface_get_configuration()->l_current_max) {
int res = conf_general_autodetect_apply_sensors_foc(current, true, true);
if (res == 0) {
commands_printf("No sensors found, using sensorless mode.\n");
} else if (res == 1) {
commands_printf("Found hall sensors, using them.\n");
} else if (res == 2) {
commands_printf("Found AS5047 encoder, using it.\n");
} else {
commands_printf("Detection error: %d\n", res);
}
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires one argument.\n");
}
} else if (strcmp(argv[0], "rotor_lock_openloop") == 0) {
if (argc == 4) {
float current = -1.0;
float time = -1.0;
float angle = -1.0;
sscanf(argv[1], "%f", &current);
sscanf(argv[2], "%f", &time);
sscanf(argv[3], "%f", &angle);
if (current > 0.0 && current <= mc_interface_get_configuration()->l_current_max &&
angle >= 0.0 && angle <= 360.0) {
if (time <= 1e-6) {
timeout_reset();
mcpwm_foc_set_openloop_phase(current, angle);
commands_printf("OK\n");
} else {
int print_div = 0;
for (float t = 0.0;t < time;t += 0.002) {
timeout_reset();
mcpwm_foc_set_openloop_phase(current, angle);
chThdSleepMilliseconds(2);
print_div++;
if (print_div >= 200) {
print_div = 0;
commands_printf("T left: %.2f s", (double)(time - t));
}
}
commands_printf("Done\n");
}
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires three arguments.\n");
}
} else if (strcmp(argv[0], "foc_detect_apply_all") == 0) {
if (argc == 2) {
float max_power_loss = -1.0;
sscanf(argv[1], "%f", &max_power_loss);
if (max_power_loss > 0.0) {
int motor_thread_old = mc_interface_get_motor_thread();
commands_printf("Running detection...");
int res = conf_general_detect_apply_all_foc(max_power_loss, true, true);
commands_printf("Res: %d", res);
mc_interface_select_motor_thread(1);
if (res >= 0) {
commands_printf("Detection finished and applied. Results:");
const volatile mc_configuration *mcconf = mc_interface_get_configuration();
#ifdef HW_HAS_DUAL_MOTORS
commands_printf("\nMOTOR 1\n");
#endif
commands_printf("Motor Current : %.1f A", (double)(mcconf->l_current_max));
commands_printf("Motor R : %.2f mOhm", (double)(mcconf->foc_motor_r * 1e3));
commands_printf("Motor L : %.2f microH", (double)(mcconf->foc_motor_l * 1e6));
commands_printf("Motor Flux Linkage : %.3f mWb", (double)(mcconf->foc_motor_flux_linkage * 1e3));
commands_printf("Temp Comp : %s", mcconf->foc_temp_comp ? "true" : "false");
if (mcconf->foc_temp_comp) {
commands_printf("Temp Comp Base Temp : %.1f degC", (double)mcconf->foc_temp_comp_base_temp);
}
if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_SENSORLESS) {
commands_printf("No sensors found, using sensorless mode.\n");
} else if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_HALL) {
commands_printf("Found hall sensors, using them.\n");
} else if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_ENCODER) {
commands_printf("Found AS5047 encoder, using it.\n");
} else {
commands_printf("Detection error: %d\n", res);
}
#ifdef HW_HAS_DUAL_MOTORS
mc_interface_select_motor_thread(2);
mcconf = mc_interface_get_configuration();
commands_printf("\nMOTOR 2\n");
commands_printf("Motor Current : %.1f A", (double)(mcconf->l_current_max));
commands_printf("Motor R : %.2f mOhm", (double)(mcconf->foc_motor_r * 1e3));
commands_printf("Motor L : %.2f microH", (double)(mcconf->foc_motor_l * 1e6));
commands_printf("Motor Flux Linkage : %.3f mWb", (double)(mcconf->foc_motor_flux_linkage * 1e3));
commands_printf("Temp Comp : %s", mcconf->foc_temp_comp ? "true" : "false");
if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_SENSORLESS) {
commands_printf("No sensors found, using sensorless mode.\n");
} else if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_HALL) {
commands_printf("Found hall sensors, using them.\n");
} else if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_ENCODER) {
commands_printf("Found AS5047 encoder, using it.\n");
} else {
commands_printf("Detection error: %d\n", res);
}
#endif
} else {
if (res == -10) {
commands_printf("Could not measure flux linkage.");
} else if (res == -11) {
commands_printf("Fault code occurred during detection.");
}
commands_printf("Detection failed.\n");
}
mc_interface_select_motor_thread(motor_thread_old);
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires one argument.\n");
}
} else if (strcmp(argv[0], "can_scan") == 0) {
bool found = false;
for (int i = 0;i < 254;i++) {
HW_TYPE hw_type;
if (comm_can_ping(i, &hw_type)) {
commands_printf("Found %s with ID: %d", utils_hw_type_to_string(hw_type), i);
found = true;
}
}
if (found) {
commands_printf("Done\n");
} else {
commands_printf("No CAN devices found\n");
}
} else if (strcmp(argv[0], "foc_detect_apply_all_can") == 0) {
if (argc == 2) {
float max_power_loss = -1.0;
sscanf(argv[1], "%f", &max_power_loss);
if (max_power_loss > 0.0) {
commands_printf("Running detection...");
int res = conf_general_detect_apply_all_foc_can(true, max_power_loss, 0.0, 0.0, 0.0, 0.0);
commands_printf("Res: %d", res);
if (res >= 0) {
commands_printf("Detection finished and applied. Results:");
#ifdef HW_HAS_DUAL_MOTORS
commands_printf("\nMOTOR 1\n");
#endif
const volatile mc_configuration *mcconf = mc_interface_get_configuration();
commands_printf("Motor Current : %.1f A", (double)(mcconf->l_current_max));
commands_printf("Motor R : %.2f mOhm", (double)(mcconf->foc_motor_r * 1e3));
commands_printf("Motor L : %.2f microH", (double)(mcconf->foc_motor_l * 1e6));
commands_printf("Motor Flux Linkage : %.3f mWb", (double)(mcconf->foc_motor_flux_linkage * 1e3));
commands_printf("Temp Comp : %s", mcconf->foc_temp_comp ? "true" : "false");
if (mcconf->foc_temp_comp) {
commands_printf("Temp Comp Base Temp : %.1f degC", (double)mcconf->foc_temp_comp_base_temp);
}
if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_SENSORLESS) {
commands_printf("No sensors found, using sensorless mode.\n");
} else if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_HALL) {
commands_printf("Found hall sensors, using them.\n");
} else if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_ENCODER) {
commands_printf("Found AS5047 encoder, using it.\n");
} else {
commands_printf("Detection error: %d\n", res);
}
#ifdef HW_HAS_DUAL_MOTORS
mc_interface_select_motor_thread(2);
mcconf = mc_interface_get_configuration();
commands_printf("\nMOTOR 2\n");
commands_printf("Motor Current : %.1f A", (double)(mcconf->l_current_max));
commands_printf("Motor R : %.2f mOhm", (double)(mcconf->foc_motor_r * 1e3));
commands_printf("Motor L : %.2f microH", (double)(mcconf->foc_motor_l * 1e6));
commands_printf("Motor Flux Linkage : %.3f mWb", (double)(mcconf->foc_motor_flux_linkage * 1e3));
commands_printf("Temp Comp : %s", mcconf->foc_temp_comp ? "true" : "false");
if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_SENSORLESS) {
commands_printf("No sensors found, using sensorless mode.\n");
} else if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_HALL) {
commands_printf("Found hall sensors, using them.\n");
} else if (mcconf->foc_sensor_mode == FOC_SENSOR_MODE_ENCODER) {
commands_printf("Found AS5047 encoder, using it.\n");
} else {
commands_printf("Detection error: %d\n", res);
}
commands_printf("\nNote that this is only printing values of motors 1");
commands_printf("and 2 of the currently connected unit, other motors");
commands_printf("may have been detected, but won't be printed here");
#endif
} else {
if (res == -10) {
commands_printf("Could not measure flux linkage.");
} else if (res == -11) {
commands_printf("Fault code occurred during detection.");
}
commands_printf("Detection failed.\n");
}
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires one argument.\n");
}
} else if (strcmp(argv[0], "encoder") == 0) {
const volatile mc_configuration *mcconf = mc_interface_get_configuration();
if (mcconf->m_sensor_port_mode == SENSOR_PORT_MODE_AS5047_SPI ||
mcconf->m_sensor_port_mode == SENSOR_PORT_MODE_AD2S1205 ||
mcconf->m_sensor_port_mode == SENSOR_PORT_MODE_TS5700N8501 ||
mcconf->m_sensor_port_mode == SENSOR_PORT_MODE_TS5700N8501_MULTITURN) {
commands_printf("SPI encoder value: %d, errors: %d, error rate: %.3f %%",
(unsigned int)encoder_spi_get_val(),
encoder_spi_get_error_cnt(),
(double)encoder_spi_get_error_rate() * (double)100.0);
if (mcconf->m_sensor_port_mode == SENSOR_PORT_MODE_TS5700N8501 ||
mcconf->m_sensor_port_mode == SENSOR_PORT_MODE_TS5700N8501_MULTITURN) {
char sf[9];
char almc[9];
utils_byte_to_binary(encoder_ts5700n8501_get_raw_status()[0], sf);
utils_byte_to_binary(encoder_ts5700n8501_get_raw_status()[7], almc);
commands_printf("TS5700N8501 ABM: %d, SF: %s, ALMC: %s\n", encoder_ts57n8501_get_abm(), sf, almc);
}
}
if (mcconf->m_sensor_port_mode == SENSOR_PORT_MODE_SINCOS) {
commands_printf("Sin/Cos encoder signal below minimum amplitude: errors: %d, error rate: %.3f %%",
encoder_sincos_get_signal_below_min_error_cnt(),
(double)encoder_sincos_get_signal_below_min_error_rate() * (double)100.0);
commands_printf("Sin/Cos encoder signal above maximum amplitude: errors: %d, error rate: %.3f %%",
encoder_sincos_get_signal_above_max_error_cnt(),
(double)encoder_sincos_get_signal_above_max_error_rate() * (double)100.0);
}
if (mcconf->m_sensor_port_mode == SENSOR_PORT_MODE_AD2S1205) {
commands_printf("Resolver Loss Of Tracking (>5%c error): errors: %d, error rate: %.3f %%", 0xB0,
encoder_resolver_loss_of_tracking_error_cnt(),
(double)encoder_resolver_loss_of_tracking_error_rate() * (double)100.0);
commands_printf("Resolver Degradation Of Signal (>33%c error): errors: %d, error rate: %.3f %%", 0xB0,
encoder_resolver_degradation_of_signal_error_cnt(),
(double)encoder_resolver_degradation_of_signal_error_rate() * (double)100.0);
commands_printf("Resolver Loss Of Signal (>57%c error): errors: %d, error rate: %.3f %%", 0xB0,
encoder_resolver_loss_of_signal_error_cnt(),
(double)encoder_resolver_loss_of_signal_error_rate() * (double)100.0);
}
} else if (strcmp(argv[0], "encoder_clear_errors") == 0) {
encoder_ts57n8501_reset_errors();
commands_printf("Done!\n");
} else if (strcmp(argv[0], "encoder_clear_multiturn") == 0) {
encoder_ts57n8501_reset_multiturn();
commands_printf("Done!\n");
} else if (strcmp(argv[0], "uptime") == 0) {
commands_printf("Uptime: %.2f s\n", (double)chVTGetSystemTimeX() / (double)CH_CFG_ST_FREQUENCY);
} else if (strcmp(argv[0], "hall_analyze") == 0) {
if (argc == 2) {
float current = -1.0;
sscanf(argv[1], "%f", &current);
if (current > 0.0 && current <= mc_interface_get_configuration()->l_current_max) {
commands_printf("Starting hall sensor analysis...\n");
mc_interface_lock();
mc_configuration *mcconf = mempools_alloc_mcconf();
*mcconf = *mc_interface_get_configuration();
mc_motor_type motor_type_old = mcconf->motor_type;
mcconf->motor_type = MOTOR_TYPE_FOC;
mc_interface_set_configuration(mcconf);
commands_init_plot("Angle", "Hall Sensor State");
commands_plot_add_graph("Hall 1");
commands_plot_add_graph("Hall 2");
commands_plot_add_graph("Hall 3");
commands_plot_add_graph("Combined");
float phase = 0.0;
for (int i = 0;i < 1000;i++) {
timeout_reset();
mcpwm_foc_set_openloop_phase((float)i * current / 1000.0, phase);
chThdSleepMilliseconds(1);
}
bool is_second_motor = mc_interface_get_motor_thread() == 2;
int hall_last = utils_read_hall(is_second_motor, mcconf->m_hall_extra_samples);
float transitions[7] = {0.0};
int states[8] = {-1, -1, -1, -1, -1, -1, -1, -1};
int transition_index = 0;
for (int i = 0;i < 720;i++) {
int hall = utils_read_hall(is_second_motor, mcconf->m_hall_extra_samples);
if (hall_last != hall) {
if (transition_index < 7) {
transitions[transition_index++] = phase;
}
for (int j = 0;j < 8;j++) {
if (states[j] == hall || states[j] == -1) {
states[j] = hall;
break;
}
}
}
hall_last = hall;
// Notice that the plots are offset slightly in Y, to make it easier to see them.
commands_plot_set_graph(0);
commands_send_plot_points(phase, (float)(hall & 1) * 1.02);
commands_plot_set_graph(1);
commands_send_plot_points(phase, (float)((hall >> 1) & 1) * 1.04);
commands_plot_set_graph(2);
commands_send_plot_points(phase, (float)((hall >> 2) & 1) * 1.06);
commands_plot_set_graph(3);
commands_send_plot_points(phase, (float)hall);
phase += 1.0;
timeout_reset();
mcpwm_foc_set_openloop_phase(current, phase);
chThdSleepMilliseconds(20);
}
mc_interface_lock_override_once();
mc_interface_release_motor();
mcconf->motor_type = motor_type_old;
mc_interface_set_configuration(mcconf);
mempools_free_mcconf(mcconf);
mc_interface_unlock();
int state_num = 0;
for (int i = 0;i < 8;i++) {
if (states[i] != -1) {
state_num++;
}
}
if (state_num == 6) {
commands_printf("Found 6 different states. This seems correct.\n");
} else {
commands_printf("Found %d different states. Something is most likely wrong...\n", state_num);
}
float min = 900.0;
float max = 0.0;
for (int i = 0;i < 6;i++) {
float diff = fabsf(utils_angle_difference(transitions[i], transitions[i + 1]));
commands_printf("Hall diff %d: %.1f degrees", i + 1, (double)diff);
if (diff < min) {
min = diff;
}
if (diff > max) {
max = diff;
}
}
float deviation = (max - min) / 2.0;
if (deviation < 5) {
commands_printf("Maximum deviation: %.2f degrees. This is good alignment.\n", (double)deviation);
} else if ((max - min) < 10) {
commands_printf("Maximum deviation: %.2f degrees. This is OK, but not great alignment.\n", (double)deviation);
} else if ((max - min) < 15) {
commands_printf("Maximum deviation: %.2f degrees. This is bad, but probably usable alignment.\n", (double)deviation);
} else {
commands_printf("Maximum deviation: %.2f degrees. The hall sensors are significantly misaligned. This has "
"to be fixed for proper operation.\n", (double)(max - min));
}
commands_printf("Done. Go to the Realtime Data > Experiment page to see the plot.\n");
} else {
commands_printf("Invalid argument(s).\n");
}
} else {
commands_printf("This command requires one argument.\n");
}
} else if (strcmp(argv[0], "io_board_set_output") == 0) {
if (argc == 4) {
int id = -1;
int channel = -1;
int state = -1;
sscanf(argv[1], "%d", &id);
sscanf(argv[2], "%d", &channel);
sscanf(argv[3], "%d", &state);
if (id >= 0 && channel >= 0 && state >= 0) {
comm_can_io_board_set_output_digital(id, channel, state);
commands_printf("OK\n");
} else {
commands_printf("Invalid arguments\n");
}
}
} else if (strcmp(argv[0], "io_board_set_output_pwm") == 0) {
if (argc == 4) {
int id = -1;
int channel = -1;
float duty = -1.0;
sscanf(argv[1], "%d", &id);
sscanf(argv[2], "%d", &channel);
sscanf(argv[3], "%f", &duty);
if (id >= 0 && channel >= 0 && duty >= 0.0 && duty <= 1.0) {
comm_can_io_board_set_output_pwm(id, channel, duty);
commands_printf("OK\n");
} else {
commands_printf("Invalid arguments\n");
}
}
} else if (strcmp(argv[0], "build_date") == 0) {
commands_printf("Build date and time: %s at %s\n", __DATE__, __TIME__);
} else if (strcmp(argv[0], "crc") == 0) {
unsigned mc_crc0 = mc_interface_get_configuration()->crc;
unsigned mc_crc1 = mc_interface_calc_crc(NULL, false);
commands_printf(" MC CFG crc: 0x%04X (stored) 0x%04X (recalc)", mc_crc0, mc_crc1);
commands_printf(" Discrepancy is expected due to run-time recalculation of config params.\n");
unsigned app_crc0 = app_get_configuration()->crc;
unsigned app_crc1 = app_calc_crc(NULL);
commands_printf("APP CFG crc: 0x%04X (stored) 0x%04X (recalc)\n", app_crc0, app_crc1);
}
// The help command
else if (strcmp(argv[0], "help") == 0) {
commands_printf("Valid commands are:");
commands_printf("help");
commands_printf(" Show this help");
commands_printf("ping");
commands_printf(" Print pong here to see if the reply works");
commands_printf("stop");
commands_printf(" Stop the motor");
commands_printf("last_adc_duration");
commands_printf(" The time the latest ADC interrupt consumed");
commands_printf("kv");
commands_printf(" The calculated kv of the motor");
commands_printf("mem");
commands_printf(" Show memory usage");
commands_printf("threads");
commands_printf(" List all threads");
commands_printf("fault");
commands_printf(" Prints the current fault code");
commands_printf("faults");
commands_printf(" Prints all stored fault codes and conditions when they arrived");
commands_printf("rpm");
commands_printf(" Prints the current electrical RPM");
commands_printf("tacho");
commands_printf(" Prints tachometer value");
commands_printf("tim");
commands_printf(" Prints tim1 and tim8 settings");
commands_printf("volt");
commands_printf(" Prints different voltages");
commands_printf("param_detect [current] [min_rpm] [low_duty]");
commands_printf(" Spin up the motor in COMM_MODE_DELAY and compute its parameters.");
commands_printf(" This test should be performed without load on the motor.");
commands_printf(" Example: param_detect 5.0 600 0.06");
commands_printf("rpm_dep");
commands_printf(" Prints some rpm-dep values");
commands_printf("can_devs");
commands_printf(" Prints all CAN devices seen on the bus the past second");
commands_printf("foc_encoder_detect [current]");
commands_printf(" Run the motor at 1Hz on open loop and compute encoder settings");
commands_printf("measure_res [current]");
commands_printf(" Lock the motor with a current and calculate its resistance");
commands_printf("measure_ind [duty]");
commands_printf(" Send short voltage pulses, measure the current and calculate the motor inductance");
commands_printf("measure_linkage [current] [duty] [min_erpm] [motor_res]");
commands_printf(" Run the motor in BLDC delay mode and measure the flux linkage");
commands_printf(" example measure_linkage 5 0.5 700 0.076");
commands_printf(" tip: measure the resistance with measure_res first");
commands_printf("measure_res_ind");
commands_printf(" Measure the motor resistance and inductance with an incremental adaptive algorithm.");
commands_printf("measure_linkage_foc [duty]");
commands_printf(" Run the motor with FOC and measure the flux linkage.");
commands_printf("measure_linkage_openloop [current] [duty] [erpm_per_sec] [motor_res] [motor_ind]");
commands_printf(" Run the motor in openloop FOC and measure the flux linkage");
commands_printf(" example measure_linkage 5 0.5 1000 0.076 0.000015");
commands_printf(" tip: measure the resistance with measure_res first");
commands_printf("foc_state");
commands_printf(" Print some FOC state variables.");
commands_printf("hw_status");
commands_printf(" Print some hardware status information.");
commands_printf("foc_openloop [current] [erpm]");
commands_printf(" Create an open loop rotating current vector.");
commands_printf("foc_openloop_duty [duty] [erpm]");
commands_printf(" Create an open loop rotating voltage vector.");
commands_printf("nrf_ext_set_enabled [enabled]");
commands_printf(" Enable or disable external NRF51822.");
commands_printf("foc_sensors_detect_apply [current]");
commands_printf(" Automatically detect FOC sensors, and apply settings on success.");
commands_printf("rotor_lock_openloop [current_A] [time_S] [angle_DEG]");
commands_printf(" Lock the motor with a current for a given time. Time 0 means forever, or");
commands_printf(" or until the heartbeat packets stop.");
commands_printf("foc_detect_apply_all [max_power_loss_W]");
commands_printf(" Detect and apply all motor settings, based on maximum resistive motor power losses.");
commands_printf("can_scan");
commands_printf(" Scan CAN-bus using ping commands, and print all devices that are found.");
commands_printf("foc_detect_apply_all_can [max_power_loss_W]");
commands_printf(" Detect and apply all motor settings, based on maximum resistive motor power losses. Also");
commands_printf(" initiates detection in all VESCs found on the CAN-bus.");
commands_printf("encoder");
commands_printf(" Prints the status of the AS5047, AD2S1205, or TS5700N8501 encoder.");
commands_printf("encoder_clear_errors");
commands_printf(" Clear error of the TS5700N8501 encoder.)");
commands_printf("encoder_clear_multiturn");
commands_printf(" Clear multiturn counter of the TS5700N8501 encoder.)");
commands_printf("uptime");
commands_printf(" Prints how many seconds have passed since boot.");
commands_printf("hall_analyze [current]");
commands_printf(" Rotate motor in open loop and analyze hall sensors.");
commands_printf("io_board_set_output [id] [ch] [state]");
commands_printf(" Set digital output of IO board.");
commands_printf("io_board_set_output_pwm [id] [ch] [duty]");
commands_printf(" Set pwm output of IO board.");
commands_printf("build_date");
commands_printf(" Print build date and time.");
commands_printf("crc");
commands_printf(" Print CRC values.");
for (int i = 0;i < callback_write;i++) {
if (callbacks[i].cbf == 0) {
continue;
}
if (callbacks[i].arg_names) {
commands_printf("%s %s", callbacks[i].command, callbacks[i].arg_names);
} else {
commands_printf(callbacks[i].command);
}
if (callbacks[i].help) {
commands_printf(" %s", callbacks[i].help);
} else {
commands_printf(" There is no help available for this command.");
}
}
commands_printf(" ");
} else {
commands_printf("Invalid command: %s\n"
"type help to list all available commands\n", argv[0]);
}
}
void terminal_add_fault_data(fault_data *data) {
fault_vec[fault_vec_write++] = *data;
if (fault_vec_write >= FAULT_VEC_LEN) {
fault_vec_write = 0;
}
}
/**
* Register a custom command callback to the terminal. If the command
* is already registered the old command callback will be replaced.
*
* @param command
* The command name.
*
* @param help
* A help text for the command. Can be NULL.
*
* @param arg_names
* The argument names for the command, e.g. [arg_a] [arg_b]
* Can be NULL.
*
* @param cbf
* The callback function for the command.
*/
void terminal_register_command_callback(
const char* command,
const char *help,
const char *arg_names,
void(*cbf)(int argc, const char **argv)) {
int callback_num = callback_write;
for (int i = 0;i < callback_write;i++) {
// First check the address in case the same callback is registered more than once.
if (callbacks[i].command == command) {
callback_num = i;
break;
}
// Check by string comparison.
if (strcmp(callbacks[i].command, command) == 0) {
callback_num = i;
break;
}
// Check if the callback is empty (unregistered)
if (callbacks[i].cbf == 0) {
callback_num = i;
break;
}
}
callbacks[callback_num].command = command;
callbacks[callback_num].help = help;
callbacks[callback_num].arg_names = arg_names;
callbacks[callback_num].cbf = cbf;
if (callback_num == callback_write) {
callback_write++;
if (callback_write >= CALLBACK_LEN) {
callback_write = 0;
}
}
}
void terminal_unregister_callback(void(*cbf)(int argc, const char **argv)) {
for (int i = 0;i < callback_write;i++) {
if (callbacks[i].cbf == cbf) {
callbacks[i].cbf = 0;
}
}
}