diff --git a/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/Makefile b/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/Makefile new file mode 100644 index 00000000..73ed3b91 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/Makefile @@ -0,0 +1,25 @@ +## +## This file is part of the libopencm3 project. +## +## Copyright (C) 2009 Uwe Hermann +## +## This library is free software: you can redistribute it and/or modify +## it under the terms of the GNU Lesser General Public License as published by +## the Free Software Foundation, either version 3 of the License, or +## (at your option) any later version. +## +## This library 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 Lesser General Public License for more details. +## +## You should have received a copy of the GNU Lesser General Public License +## along with this library. If not, see . +## + +BINARY = main + +LDSCRIPT = $(OPENCM3_DIR)/lib/stm32/l1/stm32l100xc.ld + +include ../../Makefile.include + diff --git a/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/README.md b/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/README.md new file mode 100644 index 00000000..9caf8245 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/README.md @@ -0,0 +1,22 @@ +# README + +In order for this example to work with STM32L100C-DISCO, +the external 32.768kHz crystal X3 together with the surrounding components (R24, R25, C15, C16) should be installed. + +This is _functionally_ identical to the "button-irq-printf" +example, but has been modified to use some low power features. + +There is a 115200@8n1 console on PA2, which prints a tick count every second, +and when the user push button is pressed, the time it is held down for is +timed (in milliseconds) + +Instead of free running timers and busy loops, this version uses the RTC +module and attempts to sleep as much as possible, including while the button +is pressed. + +## Status +Only very basic power savings are done! + +Current consumption, led off/on, 16Mhz HSI: 2.7mA/5.4mA +Current consumption, led off/on, 4Mhz HSI: 1.4mA/?.?mA +Current consumption, led off/on, 4Mhz MSI: 0.9mA/?.?mA diff --git a/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/main.c b/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/main.c new file mode 100644 index 00000000..92779aaf --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/main.c @@ -0,0 +1,308 @@ +/* + * This file is part of the libopencm3 project. + * + * Copyright (C) 2012 Karl Palsson + * + * This library is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This library 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 Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this library. If not, see . + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "syscfg.h" + +//#define FULL_USER_EXPERIENCE + +static volatile struct state_t state; + +int _write(int file, char *ptr, int len); + +static inline __attribute__((always_inline)) void __WFI(void) +{ + __asm volatile ("wfi"); +} + +static void gpio_setup(void) +{ + /* green led for ticking, blue for button feedback */ + gpio_mode_setup(LED_DISCO_GREEN_PORT, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, + LED_DISCO_GREEN_PIN); + + gpio_mode_setup(LED_DISCO_BLUE_PORT, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, + LED_DISCO_BLUE_PIN); + + /* Setup GPIO pins for USART2 transmit. */ + gpio_mode_setup(GPIOA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO2); + + /* Setup USART2 TX pin as alternate function. */ + gpio_set_af(GPIOA, GPIO_AF7, GPIO2); +} + +void BUTTON_DISCO_USER_isr(void) +{ + exti_reset_request(BUTTON_DISCO_USER_EXTI); + state.pressed = true; + if (state.falling) { + state.falling = false; + exti_set_trigger(BUTTON_DISCO_USER_EXTI, EXTI_TRIGGER_RISING); + state.hold_time = TIM_CNT(TIMER_BUTTON_PRESS); + } else { + state.falling = true; + exti_set_trigger(BUTTON_DISCO_USER_EXTI, EXTI_TRIGGER_FALLING); + state.hold_time = TIM_CNT(TIMER_BUTTON_PRESS) = 0; + } +} + +static void setup_buttons(void) +{ + /* Enable EXTI0 interrupt. */ + nvic_enable_irq(BUTTON_DISCO_USER_NVIC); + + gpio_mode_setup(BUTTON_DISCO_USER_PORT, GPIO_MODE_INPUT, GPIO_PUPD_NONE, + BUTTON_DISCO_USER_PIN); + + /* Configure the EXTI subsystem. */ + exti_select_source(BUTTON_DISCO_USER_EXTI, BUTTON_DISCO_USER_PORT); + state.falling = false; + exti_set_trigger(BUTTON_DISCO_USER_EXTI, EXTI_TRIGGER_RISING); + exti_enable_request(BUTTON_DISCO_USER_EXTI); +} + +static void usart_setup(void) +{ + usart_set_baudrate(USART_CONSOLE, 115200); + usart_set_databits(USART_CONSOLE, 8); + usart_set_stopbits(USART_CONSOLE, USART_STOPBITS_1); + usart_set_mode(USART_CONSOLE, USART_MODE_TX); + usart_set_parity(USART_CONSOLE, USART_PARITY_NONE); + usart_set_flow_control(USART_CONSOLE, USART_FLOWCONTROL_NONE); + + /* Finally enable the USART. */ + usart_enable(USART_CONSOLE); +} + +/** + * Use USART_CONSOLE as a console. + * @param file + * @param ptr + * @param len + * @return + */ +int _write(int file, char *ptr, int len) +{ + int i; + + if (file == STDOUT_FILENO || file == STDERR_FILENO) { + for (i = 0; i < len; i++) { + if (ptr[i] == '\n') { + usart_send_blocking(USART_CONSOLE, '\r'); + } + usart_send_blocking(USART_CONSOLE, ptr[i]); + } + return i; + } + errno = EIO; + return -1; +} + +/* + * Free running ms timer. + */ +static void setup_button_press_timer(void) +{ + rcc_periph_reset_pulse(TIMER_BUTTON_PRESS_RST); + timer_set_prescaler(TIMER_BUTTON_PRESS, 3999); /* 4Mhz/1000hz - 1 */ + timer_set_period(TIMER_BUTTON_PRESS, 0xffff); + timer_enable_counter(TIMER_BUTTON_PRESS); +} + +static int setup_rtc(void) +{ + /* turn on power block to enable unlocking */ + rcc_periph_clock_enable(RCC_PWR); + pwr_disable_backup_domain_write_protect(); + + /* reset rtc */ + RCC_CSR |= RCC_CSR_RTCRST; + RCC_CSR &= ~RCC_CSR_RTCRST; + + /* We want to use the LSE fitted on the discovery board */ + rcc_osc_on(RCC_LSE); + rcc_wait_for_osc_ready(RCC_LSE); + + /* Select the LSE as rtc clock */ + rcc_rtc_select_clock(RCC_CSR_RTCSEL_LSE); + + /* ?! Stdperiph examples don't turn this on until _afterwards_ which + * simply doesn't work. It must be on at least to be able to + * configure it */ + RCC_CSR |= RCC_CSR_RTCEN; + + rtc_unlock(); + + /* enter init mode */ + RTC_ISR |= RTC_ISR_INIT; + while ((RTC_ISR & RTC_ISR_INITF) == 0); + + /* set synch prescaler, using defaults for 1Hz out */ + uint32_t sync = 255; + uint32_t async = 127; + rtc_set_prescaler(sync, async); + + /* load time and date here if desired, and hour format */ + + /* exit init mode */ + RTC_ISR &= ~(RTC_ISR_INIT); + + /* and write protect again */ + rtc_lock(); + + /* and finally enable the clock */ + RCC_CSR |= RCC_CSR_RTCEN; + + /* And wait for synchro.. */ + rtc_wait_for_synchro(); + return 0; +} + +static int setup_rtc_wakeup(int period) +{ + rtc_unlock(); + + /* ensure wakeup timer is off */ + RTC_CR &= ~RTC_CR_WUTE; + + /* Wait until we can write */ + while ((RTC_ISR & RTC_ISR_WUTWF) == 0); + + RTC_WUTR = period - 1; + + /* Use the 1Hz clock as source */ + RTC_CR &= ~(RTC_CR_WUCLKSEL_MASK << RTC_CR_WUCLKSEL_SHIFT); + RTC_CR |= (RTC_CR_WUCLKSEL_SPRE << RTC_CR_WUCLKSEL_SHIFT); + + /* Restart WakeUp unit */ + RTC_CR |= RTC_CR_WUTE; + + /* interrupt configuration */ + + /* also, let's have an interrupt */ + RTC_CR |= RTC_CR_WUTIE; + + /* done with rtc registers, lock them again */ + rtc_lock(); + + nvic_enable_irq(NVIC_RTC_WKUP_IRQ); + + /* EXTI configuration */ + /* Configure the EXTI subsystem. */ + /* not needed, this chooses ports + exti_select_source(EXTI20, BUTTON_DISCO_USER_PORT); + */ + exti_set_trigger(EXTI20, EXTI_TRIGGER_RISING); + exti_enable_request(EXTI20); + return 0; +} + +void rtc_wkup_isr(void) +{ + /* clear flag, not write protected */ + RTC_ISR &= ~(RTC_ISR_WUTF); + exti_reset_request(EXTI20); + state.rtc_ticked = true; +} + +static int process_state(volatile struct state_t *st) +{ + if (st->rtc_ticked) { + st->rtc_ticked = 0; + printf("Tick: %x\n", (unsigned int) RTC_TR); +#if defined(FULL_USER_EXPERIENCE) + gpio_toggle(LED_DISCO_GREEN_PORT, LED_DISCO_GREEN_PIN); +#else + gpio_clear(LED_DISCO_GREEN_PORT, LED_DISCO_GREEN_PIN); +#endif + } + if (st->pressed) { + st->pressed = false; + if (st->falling) { + gpio_set(LED_DISCO_BLUE_PORT, LED_DISCO_BLUE_PIN); + printf("Pushed down!\n"); + } else { + gpio_clear(LED_DISCO_BLUE_PORT, LED_DISCO_BLUE_PIN); + printf("held: %u ms\n", st->hold_time); + } + } + return 0; +} + +static void reset_clocks(void) +{ + /* 4MHz MSI raw range 2*/ + struct rcc_clock_scale myclock_config = { + .hpre = RCC_CFGR_HPRE_SYSCLK_NODIV, + .ppre1 = RCC_CFGR_PPRE1_HCLK_NODIV, + .ppre2 = RCC_CFGR_PPRE2_HCLK_NODIV, + .voltage_scale = PWR_SCALE2, + .flash_config = FLASH_ACR_LATENCY_0WS, + .apb1_frequency = 4194000, + .apb2_frequency = 4194000, + .msi_range = RCC_ICSCR_MSIRANGE_4MHZ, + }; + rcc_clock_setup_msi(&myclock_config); + + /* buttons and uarts */ + rcc_periph_clock_enable(RCC_GPIOA); + /* user feedback leds */ + rcc_periph_clock_enable(RCC_GPIOC); + /* Enable clocks for USART2. */ + rcc_periph_clock_enable(RCC_USART2); + /* And a timers for button presses */ + rcc_periph_clock_enable(RCC_TIM7); +} + +int main(void) +{ + reset_clocks(); + gpio_setup(); + usart_setup(); + setup_buttons(); + setup_button_press_timer(); + printf("we're awake!\n"); + + setup_rtc(); + setup_rtc_wakeup(1); + + while (1) { + PWR_CR |= PWR_CR_LPSDSR; + pwr_set_stop_mode(); + __WFI(); + reset_clocks(); + process_state(&state); + } + + return 0; +} diff --git a/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/syscfg.h b/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/syscfg.h new file mode 100644 index 00000000..849bfd14 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/button-irq-printf-lowpower/syscfg.h @@ -0,0 +1,62 @@ +/* + * This file is part of the libopencm3 project. + * + * Copyright (C) 2012 Karl Palsson + * + * This library is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This library 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 Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this library. If not, see . + */ + +#ifndef SYSCFG_H +#define SYSCFG_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include +#include + + +#define USART_CONSOLE USART2 +#define USE_NASTYLOG 1 + +#define LED_DISCO_GREEN_PORT GPIOC +#define LED_DISCO_GREEN_PIN GPIO9 +#define LED_DISCO_BLUE_PORT GPIOC +#define LED_DISCO_BLUE_PIN GPIO8 + +#define BUTTON_DISCO_USER_PORT GPIOA +#define BUTTON_DISCO_USER_PIN GPIO0 +#define BUTTON_DISCO_USER_EXTI EXTI0 +#define BUTTON_DISCO_USER_isr exti0_isr +#define BUTTON_DISCO_USER_NVIC NVIC_EXTI0_IRQ +#define TIMER_BUTTON_PRESS TIM7 +#define TIMER_BUTTON_PRESS_RST RST_TIM7 + + struct state_t { + bool falling; + bool pressed; + int rtc_ticked; + int hold_time; + }; + + +#ifdef __cplusplus +} +#endif + +#endif /* SYSCFG_H */ + diff --git a/examples/stm32/l1/stm32l1-discovery/button-irq-printf/Makefile b/examples/stm32/l1/stm32l1-discovery/button-irq-printf/Makefile new file mode 100644 index 00000000..73ed3b91 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/button-irq-printf/Makefile @@ -0,0 +1,25 @@ +## +## This file is part of the libopencm3 project. +## +## Copyright (C) 2009 Uwe Hermann +## +## This library is free software: you can redistribute it and/or modify +## it under the terms of the GNU Lesser General Public License as published by +## the Free Software Foundation, either version 3 of the License, or +## (at your option) any later version. +## +## This library 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 Lesser General Public License for more details. +## +## You should have received a copy of the GNU Lesser General Public License +## along with this library. If not, see . +## + +BINARY = main + +LDSCRIPT = $(OPENCM3_DIR)/lib/stm32/l1/stm32l100xc.ld + +include ../../Makefile.include + diff --git a/examples/stm32/l1/stm32l1-discovery/button-irq-printf/README.md b/examples/stm32/l1/stm32l1-discovery/button-irq-printf/README.md new file mode 100644 index 00000000..a3e1b560 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/button-irq-printf/README.md @@ -0,0 +1,36 @@ +# README + +* Prints to the screen when the button is pushed/released (irq driven) + 115200@8n1 console on PA2 (tx only) +* uses basic timer 6 with overflows to generate a 1ms counter (not an ideal + use, but shows some api methods and can be demoed on the disco board) +* uses basic timer 7 with the exti interrupts to do ghetto input capture. + Not as fast or precise as the real input capture modes, but can be used + on any gpio pin. + +No effort at saving power is made here. Current consumption on the Disco board +is ~6.2mA when the green tick led is off, and about 8.8mA when it is on. + +example output: + + hi guys! + TICK 0 + TICK 1 + TICK 2 + Pushed down! + held: 443 ms + Pushed down! + TICK 3 + held: 217 ms + Pushed down! + held: 99 ms + Pushed down! + TICK 4 + held: 73 ms + Pushed down! + held: 60 ms + TICK 5 + Pushed down! + held: 98 ms + Pushed down! + diff --git a/examples/stm32/l1/stm32l1-discovery/button-irq-printf/main.c b/examples/stm32/l1/stm32l1-discovery/button-irq-printf/main.c new file mode 100644 index 00000000..8cd2c274 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/button-irq-printf/main.c @@ -0,0 +1,192 @@ +/* + * This file is part of the libopencm3 project. + * + * Copyright (C) 2012 Karl Palsson + * + * This library is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This library 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 Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this library. If not, see . + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "syscfg.h" + +static struct state_t state; + +int _write(int file, char *ptr, int len); + +static void clock_setup(void) +{ + rcc_clock_setup_pll(&rcc_clock_config[RCC_CLOCK_VRANGE1_HSI_PLL_24MHZ]); + /* Lots of things on all ports... */ + rcc_periph_clock_enable(RCC_GPIOA); + rcc_periph_clock_enable(RCC_GPIOC); + + /* Enable clocks for USART2. */ + rcc_periph_clock_enable(RCC_USART2); + + /* And timers. */ + rcc_periph_clock_enable(RCC_TIM6); + rcc_periph_clock_enable(RCC_TIM7); +} + +static void gpio_setup(void) +{ + /* green led for ticking, blue for button feedback */ + gpio_mode_setup(LED_DISCO_GREEN_PORT, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, + LED_DISCO_GREEN_PIN); + + gpio_mode_setup(LED_DISCO_BLUE_PORT, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, + LED_DISCO_BLUE_PIN); + + /* Setup GPIO pins for USART2 transmit. */ + gpio_mode_setup(GPIOA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO2); + + /* Setup USART2 TX pin as alternate function. */ + gpio_set_af(GPIOA, GPIO_AF7, GPIO2); +} + +static void usart_setup(void) +{ + usart_set_baudrate(USART_CONSOLE, 115200); + usart_set_databits(USART_CONSOLE, 8); + usart_set_stopbits(USART_CONSOLE, USART_STOPBITS_1); + usart_set_mode(USART_CONSOLE, USART_MODE_TX); + usart_set_parity(USART_CONSOLE, USART_PARITY_NONE); + usart_set_flow_control(USART_CONSOLE, USART_FLOWCONTROL_NONE); + + /* Finally enable the USART. */ + usart_enable(USART_CONSOLE); +} + +/** + * Use USART_CONSOLE as a console. + * @param file + * @param ptr + * @param len + * @return + */ +int _write(int file, char *ptr, int len) +{ + int i; + + if (file == STDOUT_FILENO || file == STDERR_FILENO) { + for (i = 0; i < len; i++) { + if (ptr[i] == '\n') { + usart_send_blocking(USART_CONSOLE, '\r'); + } + usart_send_blocking(USART_CONSOLE, ptr[i]); + } + return i; + } + errno = EIO; + return -1; +} + +void BUTTON_DISCO_USER_isr(void) +{ + exti_reset_request(BUTTON_DISCO_USER_EXTI); + if (state.falling) { + gpio_clear(LED_DISCO_BLUE_PORT, LED_DISCO_BLUE_PIN); + state.falling = false; + exti_set_trigger(BUTTON_DISCO_USER_EXTI, EXTI_TRIGGER_RISING); + unsigned int x = TIM_CNT(TIM7); + printf("held: %u ms\n", x); + } else { + gpio_set(LED_DISCO_BLUE_PORT, LED_DISCO_BLUE_PIN); + printf("Pushed down!\n"); + TIM_CNT(TIM7) = 0; + state.falling = true; + exti_set_trigger(BUTTON_DISCO_USER_EXTI, EXTI_TRIGGER_FALLING); + } +} + +static volatile int t6ovf; + +void tim6_isr(void) +{ + TIM_SR(TIM6) &= ~TIM_SR_UIF; + if (t6ovf++ > 2000) { + printf("TICK %d\n", state.tickcount++); + t6ovf = 0; + gpio_toggle(LED_DISCO_GREEN_PORT, LED_DISCO_GREEN_PIN); + } +} + +/* + * Another ms timer, this one used to generate an overflow interrupt at 1ms + * It is used to toggle leds and write tick counts + */ +static void setup_tim6(void) +{ + rcc_periph_reset_pulse(RST_TIM6); + /* 24Mhz / 10khz -1. */ + timer_set_prescaler(TIM6, 2399); /* 24Mhz/10000hz - 1 */ + /* 10khz for 10 ticks = 1 khz overflow = 1ms overflow interrupts */ + timer_set_period(TIM6, 10); + + nvic_enable_irq(NVIC_TIM6_IRQ); + timer_enable_update_event(TIM6); /* default at reset! */ + timer_enable_irq(TIM6, TIM_DIER_UIE); + timer_enable_counter(TIM6); +} + +/* + * Free running ms timer. + */ +static void setup_tim7(void) +{ + rcc_periph_reset_pulse(RST_TIM7); + timer_set_prescaler(TIM7, 23999); /* 24Mhz/1000hz - 1 */ + timer_set_period(TIM7, 0xffff); + timer_enable_counter(TIM7); +} + +static void setup_buttons(void) +{ + /* Enable EXTI0 interrupt. */ + nvic_enable_irq(BUTTON_DISCO_USER_NVIC); + + gpio_mode_setup(BUTTON_DISCO_USER_PORT, GPIO_MODE_INPUT, GPIO_PUPD_NONE, + BUTTON_DISCO_USER_PIN); + + /* Configure the EXTI subsystem. */ + exti_select_source(BUTTON_DISCO_USER_EXTI, BUTTON_DISCO_USER_PORT); + state.falling = false; + exti_set_trigger(BUTTON_DISCO_USER_EXTI, EXTI_TRIGGER_RISING); + exti_enable_request(BUTTON_DISCO_USER_EXTI); +} + +int main(void) +{ + clock_setup(); + gpio_setup(); + usart_setup(); + printf("hi guys!\n"); + setup_buttons(); + setup_tim6(); + setup_tim7(); + while (1) { + ; + } + + return 0; +} diff --git a/examples/stm32/l1/stm32l1-discovery/button-irq-printf/syscfg.h b/examples/stm32/l1/stm32l1-discovery/button-irq-printf/syscfg.h new file mode 100644 index 00000000..cdf7dde2 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/button-irq-printf/syscfg.h @@ -0,0 +1,58 @@ +/* + * This file is part of the libopencm3 project. + * + * Copyright (C) 2012 Karl Palsson + * + * This library is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This library 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 Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this library. If not, see . + */ + +#ifndef SYSCFG_H +#define SYSCFG_H + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include +#include + + +#define USART_CONSOLE USART2 +#define USE_NASTYLOG 1 + +#define LED_DISCO_GREEN_PORT GPIOC +#define LED_DISCO_GREEN_PIN GPIO9 +#define LED_DISCO_BLUE_PORT GPIOC +#define LED_DISCO_BLUE_PIN GPIO8 + +#define BUTTON_DISCO_USER_PORT GPIOA +#define BUTTON_DISCO_USER_PIN GPIO0 +#define BUTTON_DISCO_USER_EXTI EXTI0 +#define BUTTON_DISCO_USER_isr exti0_isr +#define BUTTON_DISCO_USER_NVIC NVIC_EXTI0_IRQ + + struct state_t { + bool falling; + int tickcount; + }; + + +#ifdef __cplusplus +} +#endif + +#endif /* SYSCFG_H */ + diff --git a/examples/stm32/l1/stm32l1-discovery/miniblink/Makefile b/examples/stm32/l1/stm32l1-discovery/miniblink/Makefile new file mode 100644 index 00000000..5364a577 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/miniblink/Makefile @@ -0,0 +1,25 @@ +## +## This file is part of the libopencm3 project. +## +## Copyright (C) 2009 Uwe Hermann +## +## This library is free software: you can redistribute it and/or modify +## it under the terms of the GNU Lesser General Public License as published by +## the Free Software Foundation, either version 3 of the License, or +## (at your option) any later version. +## +## This library 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 Lesser General Public License for more details. +## +## You should have received a copy of the GNU Lesser General Public License +## along with this library. If not, see . +## + +BINARY = miniblink + +LDSCRIPT = $(OPENCM3_DIR)/lib/stm32/l1/stm32l100xc.ld + +include ../../Makefile.include + diff --git a/examples/stm32/l1/stm32l1-discovery/miniblink/README.md b/examples/stm32/l1/stm32l1-discovery/miniblink/README.md new file mode 100644 index 00000000..c5ee2e07 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/miniblink/README.md @@ -0,0 +1,6 @@ +# README + +This is the smallest-possible example program using libopencm3. + +It's intended for the ST STM32L100C-DISCO eval board. It should blink +both LEDs on the board. diff --git a/examples/stm32/l1/stm32l1-discovery/miniblink/miniblink.c b/examples/stm32/l1/stm32l1-discovery/miniblink/miniblink.c new file mode 100644 index 00000000..0cc3a23e --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/miniblink/miniblink.c @@ -0,0 +1,75 @@ +/* + * This file is part of the libopencm3 project. + * + * Copyright (C) 2009 Uwe Hermann + * Copyright (C) 2011 Stephen Caudle + * Copyright (C) 2012 Karl Palsson + * + * This library is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This library 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 Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this library. If not, see . + */ + +#include +#include + +static void gpio_setup(void) +{ + /* Enable GPIOC clock. */ + /* Manually: */ + // RCC_AHBENR |= RCC_AHBENR_GPIOCEN; + /* Using API functions: */ + rcc_periph_clock_enable(RCC_GPIOC); + + /* Set GPIO8 and GPIO9 (in GPIO port C) to 'output push-pull'. */ + /* Using API functions: */ + gpio_mode_setup(GPIOC, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO8); + gpio_mode_setup(GPIOC, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO9); +} + +int main(void) +{ + int i; + + gpio_setup(); + + /* Blink both LEDs (PC8 and PC9) on the board. */ + while (1) { + /* Manually: */ + // GPIOC_BSRR = GPIO8; /* blue LED on */ + // GPIOC_BSRR = GPIO9 << 16; /* green LED off */ + // for (i = 0; i < 100000; i++) /* Wait a bit. */ + // __asm__("nop"); + // GPIOC_BSRR = GPIO8 << 16; /* blue LED off */ + // GPIOC_BSRR = GPIO9; /* green LED on */ + // for (i = 0; i < 100000; i++) /* Wait a bit. */ + // __asm__("nop"); + + /* Using API functions gpio_set()/gpio_clear(): */ + // gpio_set(GPIOC, GPIO8); /* blue LED on */ + // gpio_clear(GPIOC, GPIO9); /* green LED off */ + // for (i = 0; i < 100000; i++) /* Wait a bit. */ + // __asm__("nop"); + // gpio_clear(GPIOC, GPIO8); /* blue LED off */ + // gpio_set(GPIOC, GPIO9); /* green LED on */ + // for (i = 0; i < 100000; i++) /* Wait a bit. */ + // __asm__("nop"); + + /* Using API function gpio_toggle(): */ + gpio_toggle(GPIOC, GPIO8); /* toggle blue LED */ + gpio_toggle(GPIOC, GPIO9); /* toggle green LED */ + for (i = 0; i < 100000; i++) /* Wait a bit. */ + __asm__("nop"); + } + + return 0; +} diff --git a/examples/stm32/l1/stm32l1-discovery/usart-semihosting/Makefile b/examples/stm32/l1/stm32l1-discovery/usart-semihosting/Makefile new file mode 100644 index 00000000..e9e24241 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/usart-semihosting/Makefile @@ -0,0 +1,33 @@ +## +## This file is part of the libopencm3 project. +## +## Copyright (C) 2009 Uwe Hermann +## +## This library is free software: you can redistribute it and/or modify +## it under the terms of the GNU Lesser General Public License as published by +## the Free Software Foundation, either version 3 of the License, or +## (at your option) any later version. +## +## This library 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 Lesser General Public License for more details. +## +## You should have received a copy of the GNU Lesser General Public License +## along with this library. If not, see . +## + +BINARY = usart-semihosting + +LDSCRIPT = $(OPENCM3_DIR)/lib/stm32/l1/stm32l100xc.ld + +# To disable, run "make ENABLE_SEMIHOSTING=0" or comment next line out +ENABLE_SEMIHOSTING ?= 1 + +ifeq ($(ENABLE_SEMIHOSTING),1) +LDFLAGS += --specs=rdimon.specs +LDLIBS += -lrdimon +DEFS += -DENABLE_SEMIHOSTING=1 +endif + +include ../../Makefile.include diff --git a/examples/stm32/l1/stm32l1-discovery/usart-semihosting/README.md b/examples/stm32/l1/stm32l1-discovery/usart-semihosting/README.md new file mode 100644 index 00000000..3628deb1 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/usart-semihosting/README.md @@ -0,0 +1,59 @@ +# README + +This example program sends some characters on USART2 on the +ST STM32L100C-DISCO eval board. (USART2 TX on PA2 @ 115200 8n1) + +It can _ALSO_ use semihosting to use regular stdio via the attached debugger. +This expects you to be using gcc-arm-embedded from +https://launchpad.net/gcc-arm-embedded + +Semihosting is a neat feature, but remember that your application will +NOT WORK standalone if you have semihosting turned on! + + $ make ENABLE_SEMIHOSTING=0 will rebuild this image _without_ semihosting + +Semihosting is supported in "recent"[1] OpenOCD versions, however, you need +to enable semihosting first! If you have not enabled semihosting, you +will receive a message like this: + + (gdb) run + The program being debugged has been started already. + Start it from the beginning? (y or n) y + + Starting program: + /home/karlp/src/libopencm3-examples/examples/stm32/l1/stm32l-discovery/usart-semihosting/usart-semihosting.elf + + Program received signal SIGTRAP, Trace/breakpoint trap. + 0x08000456 in initialise_monitor_handles () + (gdb) + + # Here we enable semi-hosting + + (gdb) mon arm semihosting enable + semihosting is enabled + (gdb) continue + ... + +You should now see the semihosting output in the window running OpenOCD. + +## Size Notes + +Semihosting is basically free + +### Without + $ arm-none-eabi-size usart-semihosting.elf + text data bss dec hex filename + 22960 2484 60 25504 63a0 usart-semihosting.elf + +### With + $ arm-none-eabi-size usart-semihosting.elf + text data bss dec hex filename + 23824 2484 232 26540 67ac usart-semihosting.elf + +The large size here is because of printf being included regardless, see +nano.specs if you care about this, this data here is to show that semihosting +doesn't cost much at all. + + +[1] At least since OpenOcd version 0.8.0-dev-00011-g70a2ffa (2013-05-14-19:41) +possibly earlier. diff --git a/examples/stm32/l1/stm32l1-discovery/usart-semihosting/usart-semihosting.c b/examples/stm32/l1/stm32l1-discovery/usart-semihosting/usart-semihosting.c new file mode 100644 index 00000000..36ee0943 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/usart-semihosting/usart-semihosting.c @@ -0,0 +1,93 @@ +/* + * This file is part of the libopencm3 project. + * + * Copyright (C) 2009 Uwe Hermann + * Copyright (C) 2012 Karl Palsson + * + * This library is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This library 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 Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this library. If not, see . + */ + +#include +#include +#include +#include + +/* For semihosting on newlib */ +extern void initialise_monitor_handles(void); + +static void clock_setup(void) +{ + /* We are running on MSI after boot. */ + /* Enable GPIO clock for LED & USARTs. */ + rcc_periph_clock_enable(RCC_GPIOC); + rcc_periph_clock_enable(RCC_GPIOA); + + /* Enable clocks for USART2. */ + rcc_periph_clock_enable(RCC_USART2); +} + +static void usart_setup(void) +{ + /* Setup USART2 parameters. */ + usart_set_baudrate(USART2, 115200); + usart_set_databits(USART2, 8); + usart_set_stopbits(USART2, USART_STOPBITS_1); + usart_set_mode(USART2, USART_MODE_TX); + usart_set_parity(USART2, USART_PARITY_NONE); + usart_set_flow_control(USART2, USART_FLOWCONTROL_NONE); + + /* Finally enable the USART. */ + usart_enable(USART2); +} + +static void gpio_setup(void) +{ + /* Setup GPIO pin GPIO9 on GPIO port C for Green LED. */ + gpio_mode_setup(GPIOC, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO9); + + /* Setup GPIO pins for USART2 transmit. */ + gpio_mode_setup(GPIOA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO2); + + /* Setup USART2 TX pin as alternate function. */ + gpio_set_af(GPIOA, GPIO_AF7, GPIO2); +} + +int main(void) +{ + int i, j = 0, c = 0; + + clock_setup(); + gpio_setup(); + usart_setup(); +#if defined(ENABLE_SEMIHOSTING) && (ENABLE_SEMIHOSTING) + initialise_monitor_handles(); +#endif + + /* Blink the green LED (PC9) on the board with every transmitted byte. */ + while (1) { + gpio_toggle(GPIOC, GPIO9); /* LED on/off */ + usart_send_blocking(USART2, c + '0'); /* USART2: Send byte. */ + printf("Magic semihosting: %c\n", c + '0'); + c = (c == 9) ? 0 : c + 1; /* Increment c. */ + if ((j++ % 80) == 0) { /* Newline after line full. */ + usart_send_blocking(USART2, '\r'); + usart_send_blocking(USART2, '\n'); + } + for (i = 0; i < 100000; i++) { /* Wait a bit. */ + __asm__("NOP"); + } + } + + return 0; +} diff --git a/examples/stm32/l1/stm32l1-discovery/usart/Makefile b/examples/stm32/l1/stm32l1-discovery/usart/Makefile new file mode 100644 index 00000000..7cb0e033 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/usart/Makefile @@ -0,0 +1,25 @@ +## +## This file is part of the libopencm3 project. +## +## Copyright (C) 2009 Uwe Hermann +## +## This library is free software: you can redistribute it and/or modify +## it under the terms of the GNU Lesser General Public License as published by +## the Free Software Foundation, either version 3 of the License, or +## (at your option) any later version. +## +## This library 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 Lesser General Public License for more details. +## +## You should have received a copy of the GNU Lesser General Public License +## along with this library. If not, see . +## + +BINARY = usart + +LDSCRIPT = $(OPENCM3_DIR)/lib/stm32/l1/stm32l100xc.ld + +include ../../Makefile.include + diff --git a/examples/stm32/l1/stm32l1-discovery/usart/README.md b/examples/stm32/l1/stm32l1-discovery/usart/README.md new file mode 100644 index 00000000..813b9a0a --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/usart/README.md @@ -0,0 +1,10 @@ +# README + +This example program sends some characters on USART2 on the +ST STM32L100C-DISCO eval board. (USART2 TX on PA2) + +The terminal settings for the receiving device/PC are 38400 8n1. + +The sending is done in a blocking way in the code, see the usart\_irq example +for a more elaborate USART example. + diff --git a/examples/stm32/l1/stm32l1-discovery/usart/usart.c b/examples/stm32/l1/stm32l1-discovery/usart/usart.c new file mode 100644 index 00000000..e77b06f2 --- /dev/null +++ b/examples/stm32/l1/stm32l1-discovery/usart/usart.c @@ -0,0 +1,85 @@ +/* + * This file is part of the libopencm3 project. + * + * Copyright (C) 2009 Uwe Hermann + * Copyright (C) 2012 Karl Palsson + * + * This library is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * This library 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 Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with this library. If not, see . + */ + +#include +#include +#include + +static void clock_setup(void) +{ + /* We are running on MSI after boot. */ + /* Enable GPIO clock for LED & USARTs. */ + rcc_periph_clock_enable(RCC_GPIOC); + rcc_periph_clock_enable(RCC_GPIOA); + + /* Enable clocks for USART2. */ + rcc_periph_clock_enable(RCC_USART2); +} + +static void usart_setup(void) +{ + /* Setup USART2 parameters. */ + usart_set_baudrate(USART2, 38400); + usart_set_databits(USART2, 8); + usart_set_stopbits(USART2, USART_STOPBITS_1); + usart_set_mode(USART2, USART_MODE_TX); + usart_set_parity(USART2, USART_PARITY_NONE); + usart_set_flow_control(USART2, USART_FLOWCONTROL_NONE); + + /* Finally enable the USART. */ + usart_enable(USART2); +} + +static void gpio_setup(void) +{ + /* Setup GPIO pin GPIO9 on GPIO port C for Green LED. */ + gpio_mode_setup(GPIOC, GPIO_MODE_OUTPUT, GPIO_PUPD_NONE, GPIO9); + + /* Setup GPIO pins for USART2 transmit. */ + gpio_mode_setup(GPIOA, GPIO_MODE_AF, GPIO_PUPD_NONE, GPIO2); + + /* Setup USART2 TX pin as alternate function. */ + gpio_set_af(GPIOA, GPIO_AF7, GPIO2); +} + +int main(void) +{ + int i, j = 0, c = 0; + + clock_setup(); + gpio_setup(); + usart_setup(); + + /* Blink the LED (PC9) on the board with every transmitted byte. */ + while (1) { + gpio_toggle(GPIOC, GPIO9); /* LED on/off */ + usart_send_blocking(USART2, c + '0'); /* USART2: Send byte. */ + c = (c == 9) ? 0 : c + 1; /* Increment c. */ + if ((j++ % 80) == 0) { /* Newline after line full. */ + usart_send_blocking(USART2, '\r'); + usart_send_blocking(USART2, '\n'); + } + for (i = 0; i < 100000; i++) { /* Wait a bit. */ + __asm__("NOP"); + } + } + + return 0; +}