Routines to drive a chain of APA102 Leds.

Dependents:   blink_led_threading

The APA102 is an LED with a built in pwm driver which can be drive by SPI.

An array of Intensity, Red, Green, Blue values packed in to integers is displayed on a strip of APA102 elements.

The array is characterized by Rows, (active) Columns, Offset, Stride, and flags which determine how to traverse the data.

To support scrolling messages, it is possible to allocate an array which is Rows x Stride in size, and use offset to "scroll" the message. The Wrap flag is used to allow the index into the array to wrap back to zero.

To support the physical construction of arrays, the zigzag flag is used to cause the display order of odd rows to be reversed. For a 3x3 array the values are displayed in the following order is zigzag is set.

1 2 3
6 5 4
7 8 9

This allows the 3rd element to be wired to the fourth element, shortening the length of the wires on the array.

Files at this revision

API Documentation at this revision

Comitter:
rosienej
Date:
Wed Mar 11 14:25:18 2015 +0000
Parent:
1:ce2f23241f88
Commit message:
Formatting and docs

Changed in this revision

APA102.h Show annotated file Show diff for this revision Revisions of this file
diff -r ce2f23241f88 -r b8dc9a84801c APA102.h
--- a/APA102.h	Wed Mar 11 14:13:13 2015 +0000
+++ b/APA102.h	Wed Mar 11 14:25:18 2015 +0000
@@ -4,16 +4,10 @@
  
 #include "mbed.h"
 
-/** Create an APA102_IRGB helper macro to construct a 4 byte LED Frame
-    *
-    * @param I : 5 bits of intensity (0,1,2,...,31)
-    * @param R : 8 bits of Red   (0,1,...,255)
-    * @param G : 8 bits of Green (0,1,...,255)
-    * @param B : 8 bits of Blue  (0,1,...,255)
-    */
- 
- #define  APA102_IRGB(I,R,G,B) ((0xE0 + 0x1F&I)<<24)|((0xFF&R)<<16)|((0xFF&G)<<8)|(0xFF&B)
- 
+
+
+/** Create an APA102 Object 
+    */ 
  class APA102{
   public:
 /** Create an APA102 object connected to the specified mosi,miso,sclk pins
@@ -43,8 +37,19 @@
      */
      void Repaint();
      
+/** Create an IRGB helper function to construct a 4 byte LED Frame
+    *
+    * @param I : 5 bits of intensity (0,1,2,...,31)
+    * @param R : 8 bits of Red   (0,1,...,255)
+    * @param G : 8 bits of Green (0,1,...,255)
+    * @param B : 8 bits of Blue  (0,1,...,255)
+    */
+ 
+int IRGB(unsigned char I,unsigned char R,unsigned char G,unsigned char B) {
+     return ((0xE0 + 0x1F&I)<<24)|((0xFF&R)<<16)|((0xFF&G)<<8)|(0xFF&B);}
+     
   protected:
-  // SPI _spi(PTA16, PTA17, PTA15); // mosi, miso, sclk
+  
     SPI _spi;
   private: 
     int NR;