BV UART: update code and add hardware flow control

This commit is contained in:
King Kévin 2018-03-22 13:53:05 +01:00
parent 93c8494b31
commit 2b67bd9608
1 changed files with 129 additions and 91 deletions

View File

@ -49,19 +49,24 @@ static enum busvoodoo_uart_setting_t {
BUSVOODOO_UART_SETTING_DATABITS,
BUSVOODOO_UART_SETTING_PARITY,
BUSVOODOO_UART_SETTING_STOPBITS,
BUSVOODOO_UART_SETTING_HWFLOWCTL,
BUSVOODOO_UART_SETTING_DRIVE,
BUSVOODOO_UART_SETTING_DONE,
} busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_NONE;
} busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_NONE; /**< current mode setup stage */
/** UART baud rate (in bps) */
static uint32_t busvoodoo_uart_baudrate = 115200;
/** UART data bits */
static uint8_t busvoodoo_uart_databits = 8;
/** UART parity setting */
static char busvoodoo_uart_parity= 'n';
/** UART stop bits (multiplied by 2) */
static uint8_t busvoodoo_uart_stopbits = 2;
/** pin drive mode */
static char busvoodoo_uart_drive = 'p';
static uint32_t busvoodoo_uart_parity = USART_PARITY_NONE;
/** UART stop bits setting */
static uint32_t busvoodoo_uart_stopbits = USART_STOPBITS_1;
/** UART hardware flow control setting (true = with hardware flow control, false = without hardware flow control */
static bool busvoodoo_uart_hwflowctl = false;
/** pin drive mode (true = push-pull, false = open-drain) */
static bool busvoodoo_uart_drive = true;
/** if embedded pull-up resistors are used */
static bool busvoodoo_uart_pullup = false;
/** setup UART mode
* @param[out] prefix terminal prompt prefix
@ -106,119 +111,139 @@ static bool busvoodoo_uart_setup(char** prefix, const char* line)
}
}
if (BUSVOODOO_UART_SETTING_PARITY==busvoodoo_uart_setting) { // if next setting
snprintf(busvoodoo_global_string, LENGTH(busvoodoo_global_string), "parity (n,e,o) [%c]", busvoodoo_uart_parity); // prepare next setting
printf("1) none\n");
printf("2) even\n");
printf("3) odd\n");
snprintf(busvoodoo_global_string, LENGTH(busvoodoo_global_string), "parity (1,2,3) [%c]", USART_PARITY_NONE==busvoodoo_uart_parity ? '1' : (USART_PARITY_EVEN==busvoodoo_uart_parity ? '2' : '3')); // prepare next setting
*prefix = busvoodoo_global_string; // display next setting
}
break;
case BUSVOODOO_UART_SETTING_PARITY:
if (NULL==line || 0==strlen(line)) { // use default setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_STOPBITS; // go to next setting
} else { // setting provided
if (0==strcmp("n", line) || 0==strcmp("e", line) || 0==strcmp("o", line)) { // check setting
busvoodoo_uart_parity = line[0]; // remember setting
} else if (1==strlen(line)) { // setting provided
if ('1'==line[0]) { // no parity
busvoodoo_uart_parity = USART_PARITY_NONE;
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_STOPBITS; // go to next setting
} else if ('2'==line[0]) { // even parity
busvoodoo_uart_parity = USART_PARITY_EVEN;
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_STOPBITS; // go to next setting
} else if ('3'==line[0]) { // odd parity
busvoodoo_uart_parity = USART_PARITY_ODD;
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_STOPBITS; // go to next setting
}
}
if (BUSVOODOO_UART_SETTING_STOPBITS==busvoodoo_uart_setting) { // if next setting
snprintf(busvoodoo_global_string, LENGTH(busvoodoo_global_string), "stop bits (0.5-2.0) [%.1f]", busvoodoo_uart_stopbits/2.0); // prepare next setting
printf("1) 0.5\n");
printf("2) 1\n");
printf("3) 1.5\n");
printf("4) 2\n");
snprintf(busvoodoo_global_string, LENGTH(busvoodoo_global_string), "stop bits (1,2,3,4) [%s]", USART_STOPBITS_0_5==busvoodoo_uart_stopbits ? "0.5" : (USART_STOPBITS_1==busvoodoo_uart_stopbits ? "1" : (USART_STOPBITS_1_5==busvoodoo_uart_stopbits ? "1.5" : "2.0"))); // prepare next setting
*prefix = busvoodoo_global_string; // display next setting
}
break;
case BUSVOODOO_UART_SETTING_STOPBITS:
if (NULL==line || 0==strlen(line)) { // use default setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_HWFLOWCTL; // go to next setting
} else if (1==strlen(line)) { // setting provided
if ('1'==line[0]) { // 0.5 stop bits
busvoodoo_uart_stopbits = USART_STOPBITS_0_5; // remember setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_HWFLOWCTL; // go to next setting
} else if ('2'==line[0]) { // 1 stop bits
busvoodoo_uart_stopbits = USART_STOPBITS_1; // remember setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_HWFLOWCTL; // go to next setting
} else if ('3'==line[0]) { // 1.5 stop bits
busvoodoo_uart_stopbits = USART_STOPBITS_1_5; // remember setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_HWFLOWCTL; // go to next setting
} else if ('4'==line[0]) { // 2 stop bits
busvoodoo_uart_stopbits = USART_STOPBITS_2; // remember setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_HWFLOWCTL; // go to next setting
}
}
if (BUSVOODOO_UART_SETTING_HWFLOWCTL==busvoodoo_uart_setting) { // if next setting
printf("1) no flow control\n");
printf("2) RTS/CTS hardware flow control\n");
snprintf(busvoodoo_global_string, LENGTH(busvoodoo_global_string), "flow control (1,2) [%c]", busvoodoo_uart_hwflowctl ? '2' : '1'); // prepare next setting
*prefix = busvoodoo_global_string; // display next setting
}
break;
case BUSVOODOO_UART_SETTING_HWFLOWCTL:
if (NULL==line || 0==strlen(line)) { // use default setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_DRIVE; // go to next setting
} else { // setting provided
if (0==strcmp("0.5", line) || 0==strcmp(".5", line)) { // check setting
busvoodoo_uart_stopbits = 1; // remember setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_DRIVE; // go to next setting
} else if (0==strcmp("1", line) || 0==strcmp("1.0", line)) { // check setting
busvoodoo_uart_stopbits = 2; // remember setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_DRIVE; // go to next setting
} else if (0==strcmp("1.5", line)) { // check setting
busvoodoo_uart_stopbits = 3; // remember setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_DRIVE; // go to next setting
} else if (0==strcmp("2", line) || 0==strcmp("2.0", line)) { // check setting
busvoodoo_uart_stopbits = 4; // remember setting
} else if (1==strlen(line)) { // setting provided
if ('1'==line[0] || '2'==line[0]) { // setting provided
busvoodoo_uart_hwflowctl = ('2'==line[0]); // remember setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_DRIVE; // go to next setting
}
}
if (BUSVOODOO_UART_SETTING_DRIVE==busvoodoo_uart_setting) { // if next setting
printf("p) push-pull (3.3V)\n");
printf("o) open-drain (set LV to the desired voltage), with embedded pull-up (2kO)\n");
snprintf(busvoodoo_global_string, LENGTH(busvoodoo_global_string), "drive mode (p,o) [%c]", busvoodoo_uart_drive); // show drive mode
printf("1) push-pull (3.3V)\n");
printf("2) open-drain, with embedded pull-up resistors (2kO)\n");
printf("3) open-drain, with external pull-up resistors\n");
snprintf(busvoodoo_global_string, LENGTH(busvoodoo_global_string), "drive mode (1,2,3) [%c]", busvoodoo_uart_drive ? '1' : (busvoodoo_uart_pullup ? '2' : '3')); // show drive mode
*prefix = busvoodoo_global_string; // display next setting
}
break;
case BUSVOODOO_UART_SETTING_DRIVE:
if (NULL==line || 0==strlen(line)) { // use default setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_DONE; // go to next setting
} else { // setting provided
if (0==strcmp("p", line) || 0==strcmp("o", line)) { // check setting
busvoodoo_uart_drive = line[0]; // remember setting
} else if (1==strlen(line)) { // setting provided
uint8_t drive = atoi(line); // parse setting
if (1==drive || 2==drive || 3==drive) { // check setting
busvoodoo_uart_drive = (1==drive); // remember setting
busvoodoo_uart_pullup = (2==drive); // remember setting
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_DONE; // go to next setting
}
}
if (BUSVOODOO_UART_SETTING_DONE==busvoodoo_uart_setting) { // we have all settings, configure UART
rcc_periph_clock_enable(RCC_AFIO); // enable clock for USART alternate function
rcc_periph_clock_enable(USART_RCC(BUSVOODOO_USART_ID)); // enable clock for USART peripheral
rcc_periph_clock_enable(RCC_USART(BUSVOODOO_USART_ID)); // enable clock for USART peripheral
usart_set_baudrate(USART(BUSVOODOO_USART_ID), busvoodoo_uart_baudrate); // set baud rate
usart_set_databits(USART(BUSVOODOO_USART_ID), busvoodoo_uart_databits); // set data bits
switch (busvoodoo_uart_parity) { // set parity
case 'n':
usart_set_parity(USART(BUSVOODOO_USART_ID), USART_PARITY_NONE);
break;
case 'e':
usart_set_parity(USART(BUSVOODOO_USART_ID), USART_PARITY_EVEN);
break;
case 'o':
usart_set_parity(USART(BUSVOODOO_USART_ID), USART_PARITY_ODD);
break;
default:
usart_set_parity(USART(BUSVOODOO_USART_ID), USART_PARITY_NONE);
break;
usart_set_parity(USART(BUSVOODOO_USART_ID), busvoodoo_uart_parity); // set parity
usart_set_stopbits(USART(BUSVOODOO_USART_ID), busvoodoo_uart_stopbits); // set stop bits
if (busvoodoo_uart_hwflowctl) {
usart_set_flow_control(USART(BUSVOODOO_USART_ID), USART_FLOWCONTROL_RTS_CTS); // set RTS/CTS flow control
} else {
usart_set_flow_control(USART(BUSVOODOO_USART_ID), USART_FLOWCONTROL_NONE); // set no flow control
}
switch (busvoodoo_uart_stopbits) { // set stop bits
case 1:
usart_set_stopbits(USART(BUSVOODOO_USART_ID), USART_STOPBITS_0_5);
break;
case 2:
usart_set_stopbits(USART(BUSVOODOO_USART_ID), USART_STOPBITS_1);
break;
case 3:
usart_set_stopbits(USART(BUSVOODOO_USART_ID), USART_STOPBITS_1_5);
break;
case 4:
usart_set_stopbits(USART(BUSVOODOO_USART_ID), USART_STOPBITS_2);
break;
default:
usart_set_stopbits(USART(BUSVOODOO_USART_ID), USART_STOPBITS_1);
break;
}
usart_set_flow_control(USART(BUSVOODOO_USART_ID), USART_FLOWCONTROL_NONE); // set hardware flow control
usart_set_mode(USART(BUSVOODOO_USART_ID), USART_MODE_TX_RX); // full-duplex communication
switch (busvoodoo_uart_drive) { // set drive mode
case 'p':
busvoodoo_embedded_pullup(false); // disable embedded pull-ups
gpio_set_mode(USART_PORT(BUSVOODOO_USART_ID), GPIO_MODE_OUTPUT_10_MHZ, GPIO_CNF_OUTPUT_ALTFN_PUSHPULL, USART_PIN_TX(BUSVOODOO_USART_ID)); // setup GPIO pin USART transmit
gpio_set_mode(USART_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_PULL_UPDOWN, USART_PIN_RX(BUSVOODOO_USART_ID)); // setup GPIO pin USART receive
gpio_set(USART_PORT(BUSVOODOO_USART_ID), USART_PIN_RX(BUSVOODOO_USART_ID)); // pull up to avoid noise when not connected
break;
case 'o':
busvoodoo_embedded_pullup(true); // enable embedded pull-ups
gpio_set_mode(USART_PORT(BUSVOODOO_USART_ID), GPIO_MODE_OUTPUT_2_MHZ, GPIO_CNF_OUTPUT_ALTFN_OPENDRAIN, USART_PIN_TX(BUSVOODOO_USART_ID)); // setup GPIO pin USART transmit
gpio_set_mode(USART_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_FLOAT, USART_PIN_RX(BUSVOODOO_USART_ID)); // setup GPIO pin USART receive
break;
rcc_periph_clock_enable(RCC_USART_PORT(BUSVOODOO_USART_ID)); // enable clock for USART GPIO peripheral
if (busvoodoo_uart_drive) { // use push-pull drive mode
gpio_set_mode(USART_TX_PORT(BUSVOODOO_USART_ID), GPIO_MODE_OUTPUT_10_MHZ, GPIO_CNF_OUTPUT_ALTFN_PUSHPULL, USART_TX_PIN(BUSVOODOO_USART_ID)); // setup GPIO pin USART transmit
gpio_set(USART_RX_PORT(BUSVOODOO_USART_ID), USART_RX_PIN(BUSVOODOO_USART_ID)); // pull up to avoid noise when not connected
gpio_set_mode(USART_RX_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_PULL_UPDOWN, USART_RX_PIN(BUSVOODOO_USART_ID)); // setup GPIO pin USART receive
if (busvoodoo_uart_hwflowctl) { // use open drain drive mode
gpio_set_mode(USART_RTS_PORT(BUSVOODOO_USART_ID), GPIO_MODE_OUTPUT_10_MHZ, GPIO_CNF_OUTPUT_ALTFN_OPENDRAIN, USART_RTS_PIN(BUSVOODOO_USART_ID)); // setup GPIO pin USART transmit
gpio_set(USART_CTS_PORT(BUSVOODOO_USART_ID), USART_CTS_PIN(BUSVOODOO_USART_ID)); // pull up to block transmission unless requested
gpio_set_mode(USART_CTS_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_PULL_UPDOWN, USART_CTS_PIN(BUSVOODOO_USART_ID)); // setup GPIO pin USART receive
}
} else {
gpio_set_mode(USART_TX_PORT(BUSVOODOO_USART_ID), GPIO_MODE_OUTPUT_10_MHZ, GPIO_CNF_OUTPUT_ALTFN_PUSHPULL, USART_TX_PIN(BUSVOODOO_USART_ID)); // setup GPIO pin USART transmit
gpio_set_mode(USART_RX_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_FLOAT, USART_RX_PIN(BUSVOODOO_USART_ID)); // setup GPIO pin USART receive
if (busvoodoo_uart_hwflowctl) {
gpio_set_mode(USART_RTS_PORT(BUSVOODOO_USART_ID), GPIO_MODE_OUTPUT_10_MHZ, GPIO_CNF_OUTPUT_ALTFN_OPENDRAIN, USART_RTS_PIN(BUSVOODOO_USART_ID)); // setup GPIO pin USART transmit
gpio_set_mode(USART_CTS_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_FLOAT, USART_CTS_PIN(BUSVOODOO_USART_ID)); // setup GPIO pin USART receive
}
}
if (!busvoodoo_uart_drive && busvoodoo_uart_pullup) { // enable embedded pull-ups if used
busvoodoo_embedded_pullup(true); // set embedded pull-ups
printf("use LV to set pull-up voltage\n");
}
usart_enable(USART(BUSVOODOO_USART_ID)); // enable USART
led_off(); // disable LED because there is no activity
busvoodoo_uart_setting = BUSVOODOO_UART_SETTING_NONE; // restart settings next time
*prefix = "UART"; // display mode
busvoodoo_oled_text_left("UART"); // set mode title on OLED display
const char* pinout_io[10] = {"GND", "5V", "3V3", "LV", "Rx", "Tx", NULL, NULL, NULL, NULL}; // UART mode pinout
busvoodoo_oled_text_left(*prefix); // set mode title on OLED display
char* pinout_io[10] = {"GND", "5V", "3V3", "LV", "Rx", "Tx", NULL, NULL, NULL, NULL}; // UART mode pinout
if (busvoodoo_uart_hwflowctl) { // hardware flow control is used
pinout_io[6] = "RTS"; // update pin name
pinout_io[7] = "CTS"; // update pin name
}
for (uint8_t i=0; i<LENGTH(pinout_io) && i<LENGTH(busvoodoo_global_pinout_io); i++) {
busvoodoo_global_pinout_io[i] = pinout_io[i]; // set pin names
}
busvoodoo_oled_text_pinout(pinout_io, true); // set pinout on display
busvoodoo_oled_text_pinout((const char**)pinout_io, true); // set pinout on display
busvoodoo_oled_update(); // update display to show text and pinout
complete = true; // configuration is complete
}
@ -235,26 +260,38 @@ static bool busvoodoo_uart_setup(char** prefix, const char* line)
static void busvoodoo_uart_exit(void)
{
usart_disable(USART(BUSVOODOO_USART_ID)); // disable USART
rcc_periph_clock_disable(USART_RCC(BUSVOODOO_USART_ID)); // disable domain clock
gpio_set_mode(USART_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_FLOAT, USART_PIN_TX(BUSVOODOO_USART_ID)); // set pin back to floating input
gpio_set_mode(USART_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_FLOAT, USART_PIN_RX(BUSVOODOO_USART_ID)); // set pin back to floating input
rcc_periph_clock_disable(RCC_USART(BUSVOODOO_USART_ID)); // disable domain clock
gpio_set_mode(USART_TX_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_FLOAT, USART_TX_PIN(BUSVOODOO_USART_ID)); // set pin back to floating input
gpio_set_mode(USART_RX_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_FLOAT, USART_RX_PIN(BUSVOODOO_USART_ID)); // set pin back to floating input
gpio_set_mode(USART_RTS_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_FLOAT, USART_RTS_PIN(BUSVOODOO_USART_ID)); // set pin back to floating input
gpio_set_mode(USART_CTS_PORT(BUSVOODOO_USART_ID), GPIO_MODE_INPUT, GPIO_CNF_INPUT_FLOAT, USART_CTS_PIN(BUSVOODOO_USART_ID)); // set pin back to floating input
busvoodoo_embedded_pullup(false); // disable embedded pull-ups
}
// command handlers
/** command to transmit a word
* @param[in] argument word to transmit
/** command to transmit a string
* @param[in] argument string to transmit (CR+LF when none provided)
*/
static void busvoodoo_uart_command_transmit(void* argument)
{
if (NULL==argument || 0==strlen(argument)) { // nothing to transmit
return;
argument = "\r\n"; // transmit CR+LF
}
uint16_t i=0;
while (((char*)(argument))[i]) { // go through word to send
usart_send_blocking(USART(BUSVOODOO_USART_ID), ((char*)(argument))[i++]); // send character
busvoodoo_led_red(100); // enable red LED to show transmission
printf("press any key to exit\n");
for (uint16_t i=0; ((char*)(argument))[i] && !user_input_available; i++) {
while ((0==(USART_SR(USART(BUSVOODOO_USART_ID)) & USART_SR_TXE) && !user_input_available)); // wait for transmit buffer to be empty
if (USART_SR(USART(BUSVOODOO_USART_ID)) & USART_SR_TXE) { // we can send a character
printf("%c", ((char*)(argument))[i]); // echo character to transmit
busvoodoo_led_red_pulse(BUSVOODOO_LED_PULSE); // pulse red LED to show transmission
usart_send(USART(BUSVOODOO_USART_ID), ((char*)(argument))[i]); // transmit character
}
}
if (user_input_available) { // user interrupted flow
user_input_get(); // discard user input
}
if (strcmp(argument, "\r\n")) {
printf("\n");
}
}
@ -268,7 +305,7 @@ static void busvoodoo_uart_command_receive(void* argument)
while (!user_input_available) { // check for user input to exit
if ((USART_SR(USART(BUSVOODOO_USART_ID)) & USART_SR_RXNE)) { // verify if data has been received
char c = usart_recv(USART(BUSVOODOO_USART_ID)); // receive character
busvoodoo_led_blue(100); // enable blue LED to show reception
busvoodoo_led_blue_pulse(BUSVOODOO_LED_PULSE); // enable blue LED to show reception
printf("%c", c); // print received character
}
}
@ -296,17 +333,18 @@ static void busvoodoo_uart_command_transceive(void* argument)
}
last_c = c; // remember key press
usart_send_blocking(USART(BUSVOODOO_USART_ID), c); // send user character
busvoodoo_led_red(100); // enable red LED to show transmission
busvoodoo_led_red_pulse(BUSVOODOO_LED_PULSE); // enable red LED to show transmission
}
if ((USART_SR(USART(BUSVOODOO_USART_ID)) & USART_SR_RXNE)) { // verify if data has been received
char c = usart_recv(USART(BUSVOODOO_USART_ID)); // receive character
busvoodoo_led_blue(100); // enable blue LED to show reception
busvoodoo_led_blue_pulse(BUSVOODOO_LED_PULSE); // enable blue LED to show reception
printf("%c", c); // print received character
}
}
printf("\n"); // get to next line
}
/** UART menu commands */
static const struct menu_command_t busvoodoo_uart_commands[] = {
{
'r',
@ -319,9 +357,9 @@ static const struct menu_command_t busvoodoo_uart_commands[] = {
{
't',
"transmit",
"transmit word",
"transmit ASCII text (empty for CR+LF)",
MENU_ARGUMENT_STRING,
"word",
"[text]",
&busvoodoo_uart_command_transmit,
},
{