/* * Copyright (C) 2014-2015 Freie Universität Berlin * * This file is subject to the terms and conditions of the GNU Lesser * General Public License v2.1. See the file LICENSE in the top level * directory for more details. */ /** * @ingroup tests * @{ * * @file * @brief Test for low-level PWM drivers * * This test initializes the given PWM device to run at 1KHz with a 1000 step * resolution. * * The PWM is then continuously oscillating it's duty cycle between 0% to 100% * every 1s on every channel. * * @author Hauke Petersen * @author Semjon Kerner * * @} */ #include #include #include #include #include "xtimer.h" #include "shell.h" #include "timex.h" #include "periph/pwm.h" #define OSC_INTERVAL (10LU * US_PER_MS) /* 10 ms */ #define OSC_STEP (10) #define OSC_MODE PWM_LEFT #define OSC_FREQU (1000U) #define OSC_STEPS (256U) #define PWR_SLEEP (1U) static uint32_t initialized; static unsigned _get_dev(const char *dev_str) { unsigned dev = atoi(dev_str); if (dev >= PWM_NUMOF) { printf("Error: device PWM_DEV(%u) is unknown\n", dev); return UINT_MAX; } return dev; } static int _init(int argc, char** argv) { if (argc != 5) { printf("usage: %s \n", argv[0]); printf("\tdev: device by number between 0 and %u\n", PWM_NUMOF - 1); puts("\tmode:\n"); puts("\t\t0: left aligned\n"); puts("\t\t1: right aligned\n"); puts("\t\t2: center aligned\n"); puts("\tfrequency: desired frequency in Hz\n"); puts("\tresolution: number between 2 and 65535"); return 1; } unsigned dev = _get_dev(argv[1]); if (dev == UINT_MAX) { return 1; } pwm_mode_t pwm_mode; switch(atoi(argv[2])) { case(0): pwm_mode = PWM_LEFT; break; case(1): pwm_mode = PWM_RIGHT; break; case(2): pwm_mode = PWM_CENTER; break; default: printf("Error: mode %d is not supported.\n", atoi(argv[2])); return 1; } uint32_t pwm_freq = pwm_init(PWM_DEV(dev), pwm_mode, (uint32_t)atoi(argv[3]), (uint16_t)atoi(argv[4])); if (pwm_freq != 0) { printf("The pwm frequency is set to %" PRIu32 "\n", pwm_freq); initialized |= (1 << dev); return 0; } puts("Error: device is not initialized"); return 1; } static int _set(int argc, char**argv) { if (argc != 4) { printf("usage: %s \n", argv[0]); printf("\tdev: device by number between 0 and %d\n", PWM_NUMOF - 1); puts("\tch: channel of device\n"); puts("\tval: duty cycle\n"); return 1; } unsigned dev = _get_dev(argv[1]); if (dev == UINT_MAX) { return 1; } if ((initialized & (1 << dev)) == 0) { puts("Error: pwm is not initialized.\n"); puts("Execute init function first.\n"); return 1; } uint8_t chan = atoi(argv[2]); if (chan >= pwm_channels(PWM_DEV(dev))) { printf("Error: channel %d is unknown.\n", chan); return 1; } pwm_set(PWM_DEV(dev), chan, (uint16_t)atoi(argv[3])); return 0; } static int _oscillate(int argc, char** argv) { (void)argc; (void)argv; int state = 0; int step = OSC_STEP; xtimer_ticks32_t last_wakeup = xtimer_now(); puts("\nRIOT PWM test"); puts("Connect an LED or scope to PWM pins to see something.\n"); printf("Available PWM device between 0 and %d\n", PWM_NUMOF - 1); for (unsigned i = 0; i < PWM_NUMOF; i++) { uint32_t real_f = pwm_init(PWM_DEV(i), OSC_MODE, OSC_FREQU, OSC_STEPS); if (real_f == 0) { printf("Error: initializing PWM_%u.\n", i); return 1; } else { printf("Initialized PWM_%u @ %" PRIu32 "Hz.\n", i, real_f); } } puts("\nLetting the PWM pins oscillate now..."); while (1) { for (unsigned i = 0; i < PWM_NUMOF; i++) { for (uint8_t chan = 0; chan < pwm_channels(PWM_DEV(i)); chan++) { pwm_set(PWM_DEV(i), chan, state); } } state += step; if (state <= 0 || state >= (int)OSC_STEPS) { step = -step; } xtimer_periodic_wakeup(&last_wakeup, OSC_INTERVAL); } return 0; } static int _power(int argc, char** argv) { if (argc != 3) { printf("usage: %s \n", argv[0]); printf("\tdev: device by number between 0 and %d\n", PWM_NUMOF - 1); puts("\tstate:\n"); puts("\t\t0: power off\n"); puts("\t\t1: power on\n"); return 1; } unsigned dev = _get_dev(argv[1]); if (dev == UINT_MAX) { return 1; } switch (atoi(argv[2])) { case (0): puts("Powering down PWM device.\n"); pwm_poweroff(PWM_DEV(dev)); break; case (1): puts("Powering up PWM device.\n"); pwm_poweron(PWM_DEV(dev)); break; default: puts("Error: power state not available.\n"); return 1; } return 0; } static int _power_test(int argc, char** argv) { if (argc != 2) { printf("usage: %s \n", argv[0]); printf("\tdev: device by number between 0 and %d\n", PWM_NUMOF - 1); return 1; } unsigned dev = _get_dev(argv[1]); if (dev == UINT_MAX) { return 1; } printf("Powering down PWM device and sleeping for %u second(s)...\n", PWR_SLEEP); pwm_poweroff(PWM_DEV(dev)); xtimer_sleep(PWR_SLEEP); puts("Powering up PWM device.\n"); pwm_poweron(PWM_DEV(dev)); return 0; } static const shell_command_t shell_commands[] = { { "init", "initial pwm configuration", _init }, { "set", "set pwm duty cycle", _set }, { "power", "set pwm power", _power }, { "powertest", "test power on/off functions", _power_test }, { "osci", "blocking, default oscillation test", _oscillate }, { NULL, NULL, NULL } }; int main(void) { puts("PWM peripheral driver test\n"); initialized = 0; char line_buf[SHELL_DEFAULT_BUFSIZE]; shell_run(shell_commands, line_buf, SHELL_DEFAULT_BUFSIZE); return 0; }