This software is a devLib extension towiringPiand enables it to control theAdafruit PCA9685 16-Channel 12-bit PWM/Servo Drivervia I2C interface.
Copyright (c) 2019 Reinhard Sprung
If you have questions or improvements email me at reinhard.sprung[at]gmail.com
NOTE: The software could run faster because some write function read the current register value before they write to it, but it shouldn't matter in usual setups. If you need it super fast, you probably need to program your own write functions.
Enable I2C on your Raspberry Pi and make sure your PCA9685 controller board can be found. A tutorial on how to do this can be foundhere.
This pca9685 library requires an installed version of wiringPi.
WiringPi comes preinstalled on standard raspbian systems so check first if it is there already.
To do so, open a terminal and executegpio -v.
If it's not installed, the easiest way is by callingsudo apt install wiringpi.If you need addidtional information or want to install from sources, check outhttp://wiringpi.com/download-and-install/.
NOTE: WiringPi is now deprecated and will not work out of the box on newer (≥Rpi4) boards, check out http://wiringpi.com/wiringpi-deprecated/
You can includepca9685.handpca9685.cdirectly in your project or compile it and include the lib file instead.
To compile, navigate into the src folder an run
sudo make installThis will install pca9685 in your/usr/lib,/usr/local/liband/usr/local/includedirectories. To include the files add the line
#include<pca9685.h>into your source code and include "wiringPiPca9685"in your linked files during compilation
There are some example files included in this repository. To compile them, cd intoexamplesdirectory andmakethem.
To run, add a "./"before each example and execute them, e.g../servo.
Use
intpca9685Setup(constintpinBase,constinti2cAddress/*= 0x40*/,floatfreq/*= 50*/);to setup a single pca9685 device at the specified i2c address and PWM frequency.
Parameters are:
- pinBase: Use a pinBase > 64, eg. 300
- i2cAddress: The default address is 0x40
- freq: Frequency will be capped to range [40..1000] Hertz. Try 50 for servos
When successful, this will reserve 17 pins in wiringPi and return a file descriptor with which you can access advanced functions (view below).
The pca9685 pins are as follows:
[0...15]: The 16 individual output pins as numbered on the driver
[16]: All pins (Note that reading from this pin returns always 0)
Use the following wiringPi functions to read and write PWM. NOTE: Don't forget to add the pin base!
Set PWM
voidpwmWrite(intpin,intvalue)if value <= 0, set full-off else if value >= 4096, set full-on else set PWM
Set full-on or full-off
voiddigitalWrite(intpin,intvalue)if value!= 0, set full-on else set full-off
Read off-register
intdigitalRead(intpin)To get PWM: mask with 0xFFF To get full-off bit: mask with 0x1000 Note: ALL_LED pin will always return 0
Read on-register
intanalogRead(intpin)To get PWM: mask with 0xFFF To get full-on bit: mask with 0x1000 Note: ALL_LED pin will always return 0
NOTE: Unfortunately wiringPi doesn't offer suitable names for pca9685's functions, so we have to work with the provided ones. Masking means to bitwise-AND (operator &) the return value with the mask. E.g. & 0xFFF
intoffValue = digitalRead(pinBase +0) &0xFFF;If you don't want to use the wiringPi functions or want to access the pca9685 directly, you can use the file descriptor returned from the setup function to access the following functions for each connected pca9685 individually. (View source code for more details)
Set output frequency in a range between 40 and 1000 Hertz
voidpca9685PWMFreq(intfd,floatfreq);Reset all PWM output of this device to default state which is full-off
voidpca9685PWMReset(intfd);Write PWM on and off values to a specific pin. (View source code)
voidpca9685PWMWrite(intfd,intpin,inton,intoff);
voidpca9685PWMRead(intfd,intpin,int*on,int*off);Write enable or disable full-on and full-off of a specific pin. (View source code)
voidpca9685FullOn(intfd,intpin,inttf);
voidpca9685FullOff(intfd,intpin,inttf);