Driver for PCA9685 + example

2016-12-19 05:53:07 +05:00 · 2016-12-19 05:53:07 +05:00 · e96fb4242e
commit e96fb4242e
parent 7432c019f7
5 changed files with 409 additions and 0 deletions
--- a/extras/pca9685/pca9685.h
+++ b/extras/pca9685/pca9685.h
@ -0,0 +1,137 @@
+/**
+ * Driver for 16-channel, 12-bit PWM PCA9685
+ *
+ * Part of esp-open-rtos
+ * Copyright (C) 2016 Ruslan V. Uss <unclerus@gmail.com>
+ * BSD Licensed as described in the file LICENSE
+ */
+#ifndef _EXTRAS_PCA9685_H_
+#define _EXTRAS_PCA9685_H_
+
+#include <stdint.h>
+#include <stdbool.h>
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+#define PCA9685_ADDR_BASE 0x40
+
+/**
+ * Init device
+ * @param addr Device address
+ */
+void pca9685_init(uint8_t addr);
+
+/**
+ * Setup device subaddress (see section 7.3.6 if the datasheet)
+ * @param addr Device address
+ * @param num Subaddress number, 0..2
+ * @param subaddr Subaddress, 7 bit
+ * @param enable True to enable subaddress, false to disable
+ * @return False if error occured
+ */
+bool pca9685_set_subaddr(uint8_t addr, uint8_t num, uint8_t subaddr, bool enable);
+
+/**
+ * Restart device (see section 7.3.1.1 of the datasheet)
+ * @param addr Device address
+ */
+void pca9685_restart(uint8_t addr);
+
+/**
+ * Check if device is in sleep mode
+ * @param addr Device address
+ * @return True if device is sleeping
+ */
+bool pca9685_is_sleeping(uint8_t addr);
+
+/**
+ * Switch device to low-power mode or wake it up.
+ * @param addr Device address
+ * @param sleep True for sleep mode, false for wake up
+ */
+void pca9685_sleep(uint8_t addr, bool sleep);
+
+/**
+ * Get logic inversion of the outputs
+ * @param addr Device address
+ * @return True if outputs are inverted, false otherwise
+ */
+bool pca9685_is_output_inverted(uint8_t addr);
+
+/**
+ * Logically invert outputs (see section 7.7 of the datasheet)
+ * @param addr Device address
+ * @param inverted True for inverted outputs
+ */
+void pca9685_set_output_inverted(uint8_t addr, bool inverted);
+
+/**
+ * Get outputs mode
+ * @param addr Device address
+ * @return True if outputs are in open drain mode
+ */
+bool pca9685_get_output_open_drain(uint8_t addr);
+
+/**
+ * Set outputs mode
+ * @param addr Device address
+ * @param open_drain True to set open drain mode, false to normal mode
+ */
+void pca9685_set_output_open_drain(uint8_t addr, bool open_drain);
+
+/**
+ * Get current PWM frequency prescaler.
+ * @param addr Device address
+ * @return Frequency prescaler
+ */
+uint8_t pca9685_get_prescaler(uint8_t addr);
+
+/**
+ * Set PWM frequency prescaler.
+ * @param addr Device address
+ * @param prescaler Prescaler value
+ * @return False if error occured
+ */
+bool pca9685_set_prescaler(uint8_t addr, uint8_t prescaler);
+
+/**
+ * Get current PWM frequency
+ * @param addr Device address
+ * @return PWM frequency, Hz
+ */
+uint16_t pca9685_get_pwm_frequency(uint8_t addr);
+
+/**
+ * Set PWM frequency
+ * @param addr Device address
+ * @param freq PWM frequency, Hz
+ * @return False if error occured
+ */
+bool pca9685_set_pwm_frequency(uint8_t addr, uint16_t freq);
+
+/**
+ * Set PWM value on output channel
+ * @param addr Device address
+ * @param channel Channel number, 0..15 or >15 for all channels
+ * @param val PWM value, 0..4096
+ */
+void pca9685_set_pwm_value(uint8_t addr, uint8_t channel, uint16_t val);
+
+/**
+ * Set PWM values on output channels
+ * @param addr Device address
+ * @param first_ch First channel, 0..15
+ * @param channels Number of updating channels
+ * @param values Array of the channel values, each 0..4096
+ * @return False if error occured
+ */
+bool pca9685_set_pwm_values(uint8_t addr, uint8_t first_ch, uint8_t channels, const uint16_t *values);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* _EXTRAS_PCA9685_H_ */