RIOT-OS/RIOT
RIOT-OS/RIOT
1
0
Fork 0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
Code Releases Activity

drivers: add driver for apa102 RGB LEDs

Browse Source
This commit is contained in:
Hauke Petersen 2017-03-16 13:28:17 +01:00
parent 59861c1ef7
commit 9bde34df33
6 changed files with 220 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
drivers/Makefile.dep
View File

@ -4,6 +4,10 @@ ifneq (,$(filter adxl345,$(USEMODULE)))
FEATURES_REQUIRED += periph_i2c
endif
ifneq (,$(filter apa102,$(USEMODULE)))
FEATURES_REQUIRED += periph_gpio
endif
ifneq (,$(filter at30tse75x,$(USEMODULE)))
USEMODULE += xtimer
FEATURES_REQUIRED += periph_i2c

3
drivers/Makefile.include
View File

@ -142,3 +142,6 @@ endif
ifneq (,$(filter sx127%,$(USEMODULE)))
USEMODULE_INCLUDES += $(RIOTBASE)/drivers/sx127x/include
endif
ifneq (,$(filter apa102,$(USEMODULE)))
USEMODULE_INCLUDES += $(RIOTBASE)/drivers/apa102/include
endif

1
drivers/apa102/Makefile Normal file
View File

@ -0,0 +1 @@
include $(RIOTBASE)/Makefile.base

76
drivers/apa102/apa102.c Normal file
View File

@ -0,0 +1,76 @@
/*
* Copyright (C) 2017 Freie Universität Berlin
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup drivers_apa102
* @{
*
* @file
* @brief APA 102 RGB LED driver implementation
*
* @author Hauke Petersen <hauke.petersen@fu-berlin.de>
*
* @}
*/
#include <string.h>
#include "assert.h"
#include "apa102.h"
#define START (0x00000000)
#define END (0xffffffff)
#define HEAD (0xe0000000)
#define BRIGHT (0x1f000000)
#define BLUE (0x00ff0000)
#define GREEN (0x0000ff00)
#define RED (0x000000ff)
#define BRIGHT_SHIFT (21U)
#define BLUE_SHIFT (16U)
#define GREEN_SHIFT (8U)
static inline void shift(const apa102_t *dev, uint32_t data)
{
for (int i = 31; i >= 0; i--) {
gpio_write(dev->data_pin, ((data >> i) & 0x01));
gpio_set(dev->clk_pin);
gpio_clear(dev->clk_pin);
}
}
void apa102_init(apa102_t *dev, const apa102_params_t *params)
{
assert(dev && params);
memcpy(dev, params, sizeof(apa102_params_t));
gpio_init(dev->data_pin, GPIO_OUT);
gpio_init(dev->clk_pin, GPIO_OUT);
gpio_clear(dev->data_pin);
gpio_clear(dev->clk_pin);
}
void apa102_load_rgba(const apa102_t *dev, const color_rgba_t vals[])
{
assert(dev && vals);
shift(dev, START);
for (int i = 0; i < dev->led_numof; i++) {
uint32_t data = HEAD;
/* we scale the 8-bit alpha value to a 5-bit value by cutting off the
* 3 leas significant bits */
data |= (((uint32_t)vals[i].alpha << BRIGHT_SHIFT) & BRIGHT);
data |= ((uint32_t)vals[i].color.b << BLUE_SHIFT);
data |= ((uint32_t)vals[i].color.g << GREEN_SHIFT);
data |= vals[i].color.r;
shift(dev, data);
}
shift(dev, END);
}

64
drivers/apa102/include/apa102_params.h Normal file
View File

@ -0,0 +1,64 @@
/*
* Copyright (C) 2017 Freie Universität Berlin
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup drivers_apa102
* @{
*
* @file
* @brief APA102 board specific configuration
*
* @author Hauke Petersen <hauke.petersen@fu-berlin.de>
*/
#ifndef APA102_PARAMS_H
#define APA102_PARAMS_H
#include "board.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Set default configuration parameters for the APA102 driver
* @{
*/
#ifndef APA102_PARAM_LED_NUMOF
#define APA102_PARAM_LED_NUMOF (64) /* many have 64 per meter... */
#endif
#ifndef APA102_PARAM_DATA_PIN
#define APA102_PARAM_DATA_PIN (GPIO_PIN(0, 0))
#endif
#ifndef APA102_PARAM_CLK_PIN
#define APA102_PARAM_CLK_PIN (GPIO_PIN(0, 1))
#endif
#define APA102_PARAMS_DEFAULT { .led_numof = APA102_PARAM_LED_NUMOF, \
.data_pin = APA102_PARAM_DATA_PIN, \
.clk_pin = APA102_PARAM_CLK_PIN }
/**@}*/
/**
* @brief APA102 configuration
*/
static const apa102_params_t apa102_params[] =
{
#ifdef APA102_PARAMS_BOARD
APA102_PARAMS_BOARD,
#else
APA102_PARAMS_DEFAULT,
#endif
};
#ifdef __cplusplus
}
#endif
#endif /* APA102_PARAMS_H */
/** @} */

72
drivers/include/apa102.h Normal file
View File

@ -0,0 +1,72 @@
/*
* Copyright (C) 2017 Freie Universität Berlin
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @defgroup drivers_apa102 APA102 RGB LED
* @ingroup drivers_actuators
* @brief Driver for chained APA102 RGB LEDs
* @{
*
* @file
* @brief Interface for controlling APA102 LEDs
*
* @author Hauke Petersen <hauke.petersen@fu-berlin.de>
*/
#ifndef APA102_H
#define APA102_H
#include "color.h"
#include "periph/gpio.h"
#ifdef __cplusplus
extern "C" {
#endif
/**
* @brief Configuration parameters for (chained) APA102 LEDs
*/
typedef struct {
int led_numof; /**< number of chained LEDs */
gpio_t data_pin; /**< data pin */
gpio_t clk_pin; /**< clock pin */
} apa102_params_t;
/**
* @brief Device descriptor definition for APA102 LEDs
*/
typedef apa102_params_t apa102_t;
/**
* @brief Initialize (chained) APA102 LEDs
*
* @param[out] dev device descriptor
* @param[in] params device configuration
*
* @pre @p dev != NULL
* @pre @p params != NULL
*/
void apa102_init(apa102_t *dev, const apa102_params_t *params);
/**
* @brief Apply the given color values to the connected LED(s)
*
* @param[in] dev device descriptor
* @param[in] vals color values, MUST be of size `dev->led_numof`
*
* @pre @p dev != NULL
* @pre @p vals != NULL
*/
void apa102_load_rgba(const apa102_t *dev, const color_rgba_t vals[]);
#ifdef __cplusplus
}
#endif
#endif /* APA102_H */
/** @} */