mikroSDK Reference Manual
drv_pwm.h
Go to the documentation of this file.
1/****************************************************************************
2**
3** Copyright (C) 2024 MikroElektronika d.o.o.
4** Contact: https://www.mikroe.com/contact
5**
6** This file is part of the mikroSDK package
7**
8** Commercial License Usage
9**
10** Licensees holding valid commercial NECTO compilers AI licenses may use this
11** file in accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The MikroElektronika Company.
14** For licensing terms and conditions see
15** https://www.mikroe.com/legal/software-license-agreement.
16** For further information use the contact form at
17** https://www.mikroe.com/contact.
18**
19**
20** GNU Lesser General Public License Usage
21**
22** Alternatively, this file may be used for
23** non-commercial projects under the terms of the GNU Lesser
24** General Public License version 3 as published by the Free Software
25** Foundation: https://www.gnu.org/licenses/lgpl-3.0.html.
26**
27** The above copyright notice and this permission notice shall be
28** included in all copies or substantial portions of the Software.
29**
30** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
31** OF MERCHANTABILITY, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
32** TO THE WARRANTIES FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
33** IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
34** DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT
35** OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
36** OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
37**
38****************************************************************************/
44#ifndef _DRV_PWM_H_
45#define _DRV_PWM_H_
46
47#ifdef __cplusplus
48extern "C"{
49#endif
50
51#include "drv_name.h"
52#include "hal_pwm.h"
53
57typedef enum
58{
60 PWM_ERROR = (-1)
62
83typedef struct
84{
86 uint32_t freq_hz;
88
89
96typedef struct
97{
98 handle_t handle;
100} pwm_t;
101
145
191
225err_t pwm_set_freq( pwm_t *obj, uint32_t freq_hz );
226
252
287err_t pwm_set_duty( pwm_t *obj, float duty_ratio );
288
315
339
340 // drvpwmgroup
341 // drvgroup
342 // pergroup
343
344#ifdef __cplusplus
345}
346#endif
347
348#endif // _DRV_PWM_H_
349// ------------------------------------------------------------------------- END
Pin and port name type definitions.
hal_pin_name_t pin_name_t
Definition drv_name.h:74
pwm_err_t
Definition drv_pwm.h:58
@ PWM_ERROR
Definition drv_pwm.h:60
@ PWM_SUCCESS
Definition drv_pwm.h:59
err_t pwm_stop(pwm_t *obj)
Stop PWM module.
err_t pwm_open(pwm_t *obj, pwm_config_t *config)
Open the PWM driver object on selected pin.
err_t pwm_start(pwm_t *obj)
Enable counter and start PWM module.
err_t pwm_close(pwm_t *obj)
Close PWM driver context object.
err_t pwm_set_duty(pwm_t *obj, float duty_ratio)
Set PWM duty cycle in percentages.
err_t pwm_set_freq(pwm_t *obj, uint32_t freq_hz)
Set PWM frequency in Hertz.
void pwm_configure_default(pwm_config_t *config)
Configure PWM config structure.
This file contains all the functions prototypes for the PWM library.
int32_t err_t
Definition hal_target.h:64
PWM driver config structure, consisted of the following fields:
Definition drv_pwm.h:84
pin_name_t pin
Definition drv_pwm.h:85
uint32_t freq_hz
Definition drv_pwm.h:86
PWM driver context structure.
Definition drv_pwm.h:97
pwm_config_t config
Definition drv_pwm.h:99
handle_t handle
Definition drv_pwm.h:98