pwm_apix_sample: add an example for the pwm digi apix
https://jira.digi.com/browse/DEL-4881 Signed-off-by: Francisco Gil Martinez <francisco.gilmartinez@digi.com>
This commit is contained in:
Francisco Gil Martinez
parent
2302b7c2e2
commit
372d338d3f
|
|
@ -0,0 +1,43 @@
|
|||
#
|
||||
# Copyright (c) 2017 Digi International Inc.
|
||||
#
|
||||
# Permission to use, copy, modify, and/or distribute this software for any
|
||||
# purpose with or without fee is hereby granted, provided that the above
|
||||
# copyright notice and this permission notice appear in all copies.
|
||||
#
|
||||
# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
|
||||
# REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
||||
# AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
|
||||
# INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
||||
# LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
|
||||
# OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
||||
# PERFORMANCE OF THIS SOFTWARE.
|
||||
#
|
||||
#
|
||||
|
||||
EXECUTABLE = pwm-digiapix-sample
|
||||
|
||||
SRC = .
|
||||
|
||||
CFLAGS += -Wall
|
||||
|
||||
CFLAGS += $(shell pkg-config --cflags libdigiapix)
|
||||
LDLIBS += $(shell pkg-config --libs libdigiapix)
|
||||
|
||||
SRCS = $(wildcard $(SRC)/*.c)
|
||||
OBJS = $(SRCS:.c=.o)
|
||||
|
||||
.PHONY: all
|
||||
all: $(EXECUTABLE)
|
||||
|
||||
$(EXECUTABLE): $(OBJS)
|
||||
$(CC) $(LDFLAGS) $^ $(LDLIBS) -o $@
|
||||
|
||||
.PHONY: install
|
||||
install: $(EXECUTABLE)
|
||||
install -d $(DESTDIR)/usr/bin
|
||||
install -m 0755 $(EXECUTABLE) $(DESTDIR)/usr/bin/
|
||||
|
||||
.PHONY: clean
|
||||
clean:
|
||||
-rm -f $(EXECUTABLE) $(OBJS)
|
||||
|
|
@ -0,0 +1,105 @@
|
|||
Digi APIX PWM Sample Application
|
||||
===================================
|
||||
|
||||
Sample application to access and manage PWM lines using the Digi APIX library.
|
||||
|
||||
The application enables one PWM line of the board using a frequency of
|
||||
1000Hz. Then, progressively modifies the duty cycle in a loop from 10% to
|
||||
90% and vice-versa.
|
||||
|
||||
The PWM lines used in the sample are mapped as follows in the Digi Boards:
|
||||
- **CCIMX6 SBC**: PWM1 - Pin **10** of the parallel video (LCD) connector.
|
||||
- **CCIMX6UL SBC Express**: PWM1 - Pin **27** of the expansion connector.
|
||||
- **CCIMX6UL SBC Pro**: PWM4 - Pin **11** of the GPIO connector.
|
||||
|
||||
The following device tree modifications are required for the sample to work:
|
||||
- **CCIMX6 SBC**:
|
||||
```
|
||||
/* PWM1 */
|
||||
&pwm1 {
|
||||
pinctrl-names = "default";
|
||||
pinctrl-0 = <&pinctrl_pwm1>;
|
||||
status = "okay";
|
||||
};
|
||||
|
||||
/* Pin mux configuration */
|
||||
&iomuxc {
|
||||
imx6q-ccimx6sbc {
|
||||
pinctrl_pwm1: pwm1grp {
|
||||
fsl,pins = <
|
||||
MX6QDL_PAD_DISP0_DAT8__PWM1_OUT 0x110b0
|
||||
>;
|
||||
};
|
||||
};
|
||||
};
|
||||
```
|
||||
- **CCIMX6UL SBC Express**:
|
||||
_No device tree modifications are required._
|
||||
- **CCIMX6UL SBC Pro**:
|
||||
```
|
||||
/* PWM4 */
|
||||
&pwm4 {
|
||||
pinctrl-names = "default";
|
||||
pinctrl-0 = <&pinctrl_pwm4>;
|
||||
clocks = <&clks IMX6UL_CLK_PWM4>,
|
||||
<&clks IMX6UL_CLK_PWM4>;
|
||||
status = "okay";
|
||||
};
|
||||
|
||||
/* Pin mux configuration */
|
||||
&iomuxc {
|
||||
imx6ul-ccimx6ul {
|
||||
pinctrl_pwm4: pwm4grp {
|
||||
fsl,pins = <
|
||||
MX6UL_PAD_GPIO1_IO05__PWM4_OUT 0x110b0
|
||||
>;
|
||||
};
|
||||
};
|
||||
};
|
||||
```
|
||||
|
||||
Running the application
|
||||
-----------------------
|
||||
Once the binary is in the target, launch the application:
|
||||
```
|
||||
#> pwm-digiapix-sample
|
||||
```
|
||||
|
||||
The sample applicaion is ready to work with all Digi platforms using the corresponding
|
||||
PWM chip (0 by default) and a frequency of 1000Hz. If a different PWM chip or frequency
|
||||
is required, the application allows 2 additional parameters in order to customize
|
||||
these values:
|
||||
```
|
||||
#> pwm-digiapix-sample [pwm-chip pwm-freq]
|
||||
```
|
||||
Where:
|
||||
- 'pwm-chip' is an optional PWM chip number.
|
||||
- 'pwm-freq' is an optional frequency to use (Hz).
|
||||
|
||||
Compiling the application
|
||||
-------------------------
|
||||
This demo can be compiled using a Digi Embedded Yocto based toolchain. Make
|
||||
sure to source the corresponding toolchain of the platform you are using, e.g:
|
||||
|
||||
```
|
||||
$> . <DEY-toolchain-path>/environment-setup-cortexa7hf-vfp-neon-dey-linux-gnueabi
|
||||
$> make
|
||||
```
|
||||
|
||||
More information about [Digi Embedded Yocto](https://github.com/digi-embedded/meta-digi).
|
||||
|
||||
License
|
||||
-------
|
||||
Copyright 2017, Digi International Inc.
|
||||
|
||||
Permission to use, copy, modify, and/or distribute this software for any purpose
|
||||
with or without fee is hereby granted, provided that the above copyright notice
|
||||
and this permission notice appear in all copies.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
|
||||
REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
|
||||
FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
|
||||
INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
|
||||
OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
|
||||
TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
|
||||
THIS SOFTWARE.
|
||||
|
|
@ -0,0 +1,197 @@
|
|||
/*
|
||||
* Copyright (c) 2017 Digi International Inc.
|
||||
*
|
||||
* Permission to use, copy, modify, and/or distribute this software for any
|
||||
* purpose with or without fee is hereby granted, provided that the above
|
||||
* copyright notice and this permission notice appear in all copies.
|
||||
*
|
||||
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
|
||||
* REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
|
||||
* AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
|
||||
* INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
|
||||
* LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
|
||||
* OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
|
||||
* PERFORMANCE OF THIS SOFTWARE.
|
||||
* =======================================================================
|
||||
*/
|
||||
#include <libgen.h>
|
||||
#include <signal.h>
|
||||
#include <stdio.h>
|
||||
#include <stdlib.h>
|
||||
#include <unistd.h>
|
||||
|
||||
#include <pwm.h>
|
||||
|
||||
/*------------------------------------------------------------------------------
|
||||
D E F I N I T I O N S
|
||||
------------------------------------------------------------------------------*/
|
||||
|
||||
#define DEFAULT_PWM_CHANNEL 0
|
||||
#define DEFAULT_FREQUENCY 1000 /* In Hz */
|
||||
#define DEFAULT_PWM_ALIAS "DEFAULT_PWM"
|
||||
|
||||
|
||||
#define BUFF_SIZE 256
|
||||
#define USAGE \
|
||||
"Usage:\n" \
|
||||
"%s [pwm-chip pwm-freq]\n\n" \
|
||||
"Where:\n" \
|
||||
" 'pwm-chip' is an optional PWM chip number\n" \
|
||||
" 'pwm-freq' is an optional frequency to use (Hz)\n\n" \
|
||||
|
||||
/*------------------------------------------------------------------------------
|
||||
F U N C T I O N D E C L A R A T I O N S
|
||||
------------------------------------------------------------------------------*/
|
||||
static void cleanup();
|
||||
static void add_sigkill_signal(void);
|
||||
static void graceful_shutdown(void);
|
||||
static void sigint_handler(int signum);
|
||||
static void usage(char const * const name);
|
||||
|
||||
/**
|
||||
* sigint_handler() - Manage signal received.
|
||||
*
|
||||
* @signum: Received signal.
|
||||
*/
|
||||
static void sigint_handler(int signum)
|
||||
{
|
||||
exit(EXIT_SUCCESS);
|
||||
}
|
||||
|
||||
/**
|
||||
* usage() - Print usage information
|
||||
*
|
||||
* @name: Name of the application.
|
||||
*/
|
||||
static void usage(char const * const name)
|
||||
{
|
||||
printf(USAGE, name);
|
||||
}
|
||||
|
||||
/*------------------------------------------------------------------------------
|
||||
G L O B A L V A R I A B L E S
|
||||
------------------------------------------------------------------------------*/
|
||||
static pwm_t *pwm_line;
|
||||
static int running = 1;
|
||||
|
||||
int main(int argc, char **argv)
|
||||
{
|
||||
unsigned int pwm_freq = DEFAULT_FREQUENCY;
|
||||
int ret, duty_cycle = 10, ascending = 1;
|
||||
char *name = basename(argv[0]);
|
||||
|
||||
/* Check if the PWM values are passed in the command line. */
|
||||
if (argc == 3) {
|
||||
unsigned int pwm_chip = atoi(argv[1]);
|
||||
pwm_freq = atoi(argv[2]);
|
||||
pwm_line = pwm_request(pwm_chip, DEFAULT_PWM_CHANNEL, REQUEST_SHARED);
|
||||
} else if (argc == 1) {
|
||||
/* Initialize the PWM. */
|
||||
pwm_line = pwm_request_by_alias(DEFAULT_PWM_ALIAS, REQUEST_SHARED);
|
||||
} else if (argc <= 2 || argc > 3) {
|
||||
usage(name);
|
||||
return EXIT_FAILURE;
|
||||
}
|
||||
|
||||
/* Check PWM. */
|
||||
if (!pwm_line) {
|
||||
printf("Failed to initialize PWM\n");
|
||||
return EXIT_FAILURE;
|
||||
}
|
||||
|
||||
add_sigkill_signal();
|
||||
|
||||
printf("Setting PWM frequency to %dHz...", pwm_freq);
|
||||
/* Set a duty cycle of 0 to avoid errors configuring the frequency */
|
||||
pwm_set_duty_cycle(pwm_line, 0);
|
||||
ret = pwm_set_freq(pwm_line, pwm_freq);
|
||||
if (ret != PWM_CONFIG_ERROR_NONE) {
|
||||
printf("Failed\n");
|
||||
return EXIT_FAILURE;
|
||||
}
|
||||
|
||||
/* Check the frequency. */
|
||||
ret = pwm_get_freq(pwm_line);
|
||||
printf("%s\n", ret >= 0 ? "Done" : "Failed");
|
||||
if (ret == -1) {
|
||||
return EXIT_FAILURE;
|
||||
}
|
||||
|
||||
printf("Enabling PWM %d:%d...", pwm_line->chip, pwm_line->channel);
|
||||
ret = pwm_enable(pwm_line, PWM_ENABLED);
|
||||
if (ret != EXIT_SUCCESS) {
|
||||
printf("Failed\n");
|
||||
return EXIT_FAILURE;
|
||||
}
|
||||
|
||||
ret = pwm_is_enabled(pwm_line);
|
||||
printf("%s\n", ret == PWM_ENABLED ? "Done" : "Failed");
|
||||
if (ret != PWM_ENABLED) {
|
||||
return EXIT_FAILURE;
|
||||
}
|
||||
|
||||
/* Main application loop.*/
|
||||
while (running) {
|
||||
/* Set the duty cycle. */
|
||||
ret = pwm_set_duty_cycle_percentage(pwm_line, duty_cycle);
|
||||
if (ret != PWM_CONFIG_ERROR_NONE) {
|
||||
printf("Failed to set the duty cycle\n");
|
||||
return EXIT_FAILURE;
|
||||
}
|
||||
if (ascending) {
|
||||
duty_cycle += 10;
|
||||
if (duty_cycle == 100) {
|
||||
duty_cycle = 80;
|
||||
ascending = 0;
|
||||
}
|
||||
} else {
|
||||
duty_cycle -= 10;
|
||||
if (duty_cycle == 0) {
|
||||
duty_cycle = 20;
|
||||
ascending = 1;
|
||||
}
|
||||
}
|
||||
sleep(1);
|
||||
}
|
||||
|
||||
return EXIT_SUCCESS;
|
||||
}
|
||||
|
||||
/**
|
||||
* cleanup() - Frees and leaves PWM into a known state before exit
|
||||
*/
|
||||
static void cleanup()
|
||||
{
|
||||
if (pwm_line) {
|
||||
pwm_enable(pwm_line, PWM_DISABLED);
|
||||
pwm_free(pwm_line);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* add_sigkill_signal() - Add the kill signal to the process
|
||||
*/
|
||||
static void add_sigkill_signal(void)
|
||||
{
|
||||
struct sigaction new_action;
|
||||
struct sigaction old_action;
|
||||
|
||||
/* Setup signal hander. */
|
||||
atexit(graceful_shutdown);
|
||||
new_action.sa_handler = sigint_handler;
|
||||
sigemptyset(&new_action.sa_mask);
|
||||
new_action.sa_flags = 0;
|
||||
sigaction(SIGINT, NULL, &old_action);
|
||||
|
||||
if (old_action.sa_handler != SIG_IGN)
|
||||
sigaction(SIGINT, &new_action, NULL);
|
||||
}
|
||||
|
||||
/**
|
||||
* graceful_shutdown() - Stop main loop
|
||||
*/
|
||||
void graceful_shutdown(void)
|
||||
{
|
||||
running = 0;
|
||||
cleanup();
|
||||
}
|
||||
Loading…
Reference in New Issue