8a1e4638f7
* feat(ledc): Allow custom channel selection * fix(ledc): Fix check of maximum channel * docs(ledc): Add ledcAttachChannel to docs * feat(ledc): Change channel to uint8_t + add log message
67 lines
2.4 KiB
C
67 lines
2.4 KiB
C
// Copyright 2015-2023 Espressif Systems (Shanghai) PTE LTD
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#ifndef _ESP32_HAL_LEDC_H_
|
|
#define _ESP32_HAL_LEDC_H_
|
|
|
|
#include "soc/soc_caps.h"
|
|
#if SOC_LEDC_SUPPORTED
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#include <stdint.h>
|
|
#include <stdbool.h>
|
|
|
|
typedef enum {
|
|
NOTE_C, NOTE_Cs, NOTE_D, NOTE_Eb, NOTE_E, NOTE_F, NOTE_Fs, NOTE_G, NOTE_Gs, NOTE_A, NOTE_Bb, NOTE_B, NOTE_MAX
|
|
} note_t;
|
|
|
|
typedef void (*voidFuncPtr)(void);
|
|
typedef void (*voidFuncPtrArg)(void*);
|
|
|
|
typedef struct {
|
|
uint8_t pin; // Pin assigned to channel
|
|
uint8_t channel; // Channel number
|
|
uint8_t channel_resolution; // Resolution of channel
|
|
voidFuncPtr fn;
|
|
void* arg;
|
|
#ifndef SOC_LEDC_SUPPORT_FADE_STOP
|
|
SemaphoreHandle_t lock; //xSemaphoreCreateBinary
|
|
#endif
|
|
} ledc_channel_handle_t;
|
|
|
|
//channel 0-15 resolution 1-16bits freq limits depend on resolution
|
|
bool ledcAttach(uint8_t pin, uint32_t freq, uint8_t resolution);
|
|
bool ledcAttachChannel(uint8_t pin, uint32_t freq, uint8_t resolution, uint8_t channel);
|
|
bool ledcWrite(uint8_t pin, uint32_t duty);
|
|
uint32_t ledcWriteTone(uint8_t pin, uint32_t freq);
|
|
uint32_t ledcWriteNote(uint8_t pin, note_t note, uint8_t octave);
|
|
uint32_t ledcRead(uint8_t pin);
|
|
uint32_t ledcReadFreq(uint8_t pin);
|
|
bool ledcDetach(uint8_t pin);
|
|
uint32_t ledcChangeFrequency(uint8_t pin, uint32_t freq, uint8_t resolution);
|
|
|
|
//Fade functions
|
|
bool ledcFade(uint8_t pin, uint32_t start_duty, uint32_t target_duty, int max_fade_time_ms);
|
|
bool ledcFadeWithInterrupt(uint8_t pin, uint32_t start_duty, uint32_t target_duty, int max_fade_time_ms, void (*userFunc)(void));
|
|
bool ledcFadeWithInterruptArg(uint8_t pin, uint32_t start_duty, uint32_t target_duty, int max_fade_time_ms, void (*userFunc)(void*), void * arg);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* SOC_LEDC_SUPPORTED */
|
|
#endif /* _ESP32_HAL_LEDC_H_ */
|