clean day
This commit is contained in:
parent
ab327d98c0
commit
e44b717c0b
52
avr_adc.c
52
avr_adc.c
@ -1,52 +0,0 @@
|
||||
//setup adc for an attiny85
|
||||
//
|
||||
#include<avr/io.h>
|
||||
#include"avr_adc.h"
|
||||
#define _BS(bit) (1<<bit)
|
||||
#define _BC(bit) ~(1<<bit)
|
||||
#define STARTADC ADCSRA |= _BS(ADSC)
|
||||
|
||||
|
||||
//1.setup_prescaler
|
||||
/* this function initialises the ADC
|
||||
|
||||
ADC Prescaler Notes:
|
||||
--------------------
|
||||
|
||||
ADC Prescaler needs to be set so that the ADC input frequency is between 50 - 200kHz.
|
||||
|
||||
For more information, see table 17.5 "ADC Prescaler Selections" in
|
||||
chapter 17.13.2 "ADCSRA – ADC Control and Status Register A"
|
||||
(pages 140 and 141 on the complete ATtiny25/45/85 datasheet, Rev. 2586M–AVR–07/10)
|
||||
|
||||
Valid prescaler values for various clock speeds
|
||||
|
||||
Clock Available prescaler values
|
||||
---------------------------------------
|
||||
1 MHz 8 (125kHz), 16 (62.5kHz)
|
||||
4 MHz 32 (125kHz), 64 (62.5kHz)
|
||||
8 MHz 64 (125kHz), 128 (62.5kHz)
|
||||
16 MHz 128 (125kHz)
|
||||
|
||||
Below example set prescaler to 128 for mcu running at 8MHz
|
||||
(check the datasheet for the proper bit values to set the prescaler)
|
||||
*/
|
||||
void setupADC(void)
|
||||
{
|
||||
ADMUX = //_BC(REFS0) | //Set_Vref
|
||||
//_BC(REFS1) | //Set_Vref
|
||||
//_BC(MUX3) | //
|
||||
//_BC(MUX2) | //
|
||||
_BS(MUX1) | //
|
||||
_BS(MUX0) | //PORT Select PB3
|
||||
_BS(ADLAR) ; //left shift conversion results(used in 8bit mode)
|
||||
|
||||
ADCSRA = _BS(ADEN) | //Enable ADC
|
||||
//_BC(ADATE) | //Disable AutoTrigger aka Freerunning mode
|
||||
_BS(ADPS2) | //Select Prescaler clk/32
|
||||
//_BC(ADPS1) |
|
||||
_BS(ADPS0);
|
||||
|
||||
}
|
||||
|
||||
|
269
fix_fft.c
269
fix_fft.c
@ -1,269 +0,0 @@
|
||||
#include <avr/pgmspace.h>
|
||||
#include "fix_fft.h"
|
||||
|
||||
|
||||
//#include <WProgram.h> depreacted
|
||||
|
||||
/* fix_fft.c - Fixed-point in-place Fast Fourier Transform */
|
||||
/*
|
||||
All data are fixed-point short integers, in which -32768
|
||||
to +32768 represent -1.0 to +1.0 respectively. Integer
|
||||
arithmetic is used for speed, instead of the more natural
|
||||
floating-point.
|
||||
|
||||
For the forward FFT (time -> freq), fixed scaling is
|
||||
performed to prevent arithmetic overflow, and to map a 0dB
|
||||
sine/cosine wave (i.e. amplitude = 32767) to two -6dB freq
|
||||
coefficients. The return value is always 0.
|
||||
|
||||
For the inverse FFT (freq -> time), fixed scaling cannot be
|
||||
done, as two 0dB coefficients would sum to a peak amplitude
|
||||
of 64K, overflowing the 32k range of the fixed-point integers.
|
||||
Thus, the fix_fft() routine performs variable scaling, and
|
||||
returns a value which is the number of bits LEFT by which
|
||||
the output must be shifted to get the actual amplitude
|
||||
(i.e. if fix_fft() returns 3, each value of fr[] and fi[]
|
||||
must be multiplied by 8 (2**3) for proper scaling.
|
||||
Clearly, this cannot be done within fixed-point short
|
||||
integers. In practice, if the result is to be used as a
|
||||
filter, the scale_shift can usually be ignored, as the
|
||||
result will be approximately correctly normalized as is.
|
||||
|
||||
Written by: Tom Roberts 11/8/89
|
||||
Made portable: Malcolm Slaney 12/15/94 malcolm@interval.com
|
||||
Enhanced: Dimitrios P. Bouras 14 Jun 2006 dbouras@ieee.org
|
||||
Modified for 8bit values David Keller 10.10.2010
|
||||
*/
|
||||
|
||||
|
||||
#define N_WAVE 256 /* full length of Sinewave[] */
|
||||
#define LOG2_N_WAVE 8 /* log2(N_WAVE) */
|
||||
|
||||
|
||||
|
||||
|
||||
/*
|
||||
Since we only use 3/4 of N_WAVE, we define only
|
||||
this many samples, in order to conserve data space.
|
||||
*/
|
||||
|
||||
|
||||
//typedef uint8_t PROGMEM prog_uint8_t;
|
||||
const uint8_t Sinewave[N_WAVE-N_WAVE/4] PROGMEM = {
|
||||
0, 3, 6, 9, 12, 15, 18, 21,
|
||||
24, 28, 31, 34, 37, 40, 43, 46,
|
||||
48, 51, 54, 57, 60, 63, 65, 68,
|
||||
71, 73, 76, 78, 81, 83, 85, 88,
|
||||
90, 92, 94, 96, 98, 100, 102, 104,
|
||||
106, 108, 109, 111, 112, 114, 115, 117,
|
||||
118, 119, 120, 121, 122, 123, 124, 124,
|
||||
125, 126, 126, 127, 127, 127, 127, 127,
|
||||
|
||||
127, 127, 127, 127, 127, 127, 126, 126,
|
||||
125, 124, 124, 123, 122, 121, 120, 119,
|
||||
118, 117, 115, 114, 112, 111, 109, 108,
|
||||
106, 104, 102, 100, 98, 96, 94, 92,
|
||||
90, 88, 85, 83, 81, 78, 76, 73,
|
||||
71, 68, 65, 63, 60, 57, 54, 51,
|
||||
48, 46, 43, 40, 37, 34, 31, 28,
|
||||
24, 21, 18, 15, 12, 9, 6, 3,
|
||||
|
||||
0, -3, -6, -9, -12, -15, -18, -21,
|
||||
-24, -28, -31, -34, -37, -40, -43, -46,
|
||||
-48, -51, -54, -57, -60, -63, -65, -68,
|
||||
-71, -73, -76, -78, -81, -83, -85, -88,
|
||||
-90, -92, -94, -96, -98, -100, -102, -104,
|
||||
-106, -108, -109, -111, -112, -114, -115, -117,
|
||||
-118, -119, -120, -121, -122, -123, -124, -124,
|
||||
-125, -126, -126, -127, -127, -127, -127, -127,
|
||||
|
||||
/*-127, -127, -127, -127, -127, -127, -126, -126,
|
||||
-125, -124, -124, -123, -122, -121, -120, -119,
|
||||
-118, -117, -115, -114, -112, -111, -109, -108,
|
||||
-106, -104, -102, -100, -98, -96, -94, -92,
|
||||
-90, -88, -85, -83, -81, -78, -76, -73,
|
||||
-71, -68, -65, -63, -60, -57, -54, -51,
|
||||
-48, -46, -43, -40, -37, -34, -31, -28,
|
||||
-24, -21, -18, -15, -12, -9, -6, -3, */
|
||||
};
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
/*
|
||||
FIX_MPY() - fixed-point multiplication & scaling.
|
||||
Substitute inline assembly for hardware-specific
|
||||
optimization suited to a particluar DSP processor.
|
||||
Scaling ensures that result remains 16-bit.
|
||||
*/
|
||||
static inline char FIX_MPY(char a, char b)
|
||||
{
|
||||
|
||||
//Serial.println(a);
|
||||
//Serial.println(b);
|
||||
|
||||
|
||||
/* shift right one less bit (i.e. 15-1) */
|
||||
int c = ((int)a * (int)b) >> 6;
|
||||
/* last bit shifted out = rounding-bit */
|
||||
b = c & 0x01;
|
||||
/* last shift + rounding bit */
|
||||
a = (c >> 1) + b;
|
||||
|
||||
/*
|
||||
Serial.println(Sinewave[3]);
|
||||
Serial.println(c);
|
||||
Serial.println(a);
|
||||
while(1);*/
|
||||
|
||||
return a;
|
||||
}
|
||||
|
||||
/*
|
||||
fix_fft() - perform forward/inverse fast Fourier transform.
|
||||
fr[n],fi[n] are real and imaginary arrays, both INPUT AND
|
||||
RESULT (in-place FFT), with 0 <= n < 2**m; set inverse to
|
||||
0 for forward transform (FFT), or 1 for iFFT.
|
||||
*/
|
||||
int fix_fft(char fr[], char fi[], int m, int inverse)
|
||||
{
|
||||
int mr, nn, i, j, l, k, istep, n, scale, shift;
|
||||
char qr, qi, tr, ti, wr, wi;
|
||||
|
||||
n = 1 << m;
|
||||
|
||||
/* max FFT size = N_WAVE */
|
||||
if (n > N_WAVE)
|
||||
return -1;
|
||||
|
||||
mr = 0;
|
||||
nn = n - 1;
|
||||
scale = 0;
|
||||
|
||||
/* decimation in time - re-order data */
|
||||
for (m=1; m<=nn; ++m) {
|
||||
l = n;
|
||||
do {
|
||||
l >>= 1;
|
||||
} while (mr+l > nn);
|
||||
mr = (mr & (l-1)) + l;
|
||||
|
||||
if (mr <= m)
|
||||
continue;
|
||||
tr = fr[m];
|
||||
fr[m] = fr[mr];
|
||||
fr[mr] = tr;
|
||||
ti = fi[m];
|
||||
fi[m] = fi[mr];
|
||||
fi[mr] = ti;
|
||||
}
|
||||
|
||||
l = 1;
|
||||
k = LOG2_N_WAVE-1;
|
||||
while (l < n) {
|
||||
if (inverse) {
|
||||
/* variable scaling, depending upon data */
|
||||
shift = 0;
|
||||
for (i=0; i<n; ++i) {
|
||||
j = fr[i];
|
||||
if (j < 0)
|
||||
j = -j;
|
||||
m = fi[i];
|
||||
if (m < 0)
|
||||
m = -m;
|
||||
if (j > 16383 || m > 16383) {
|
||||
shift = 1;
|
||||
break;
|
||||
}
|
||||
}
|
||||
if (shift)
|
||||
++scale;
|
||||
} else {
|
||||
/*
|
||||
fixed scaling, for proper normalization --
|
||||
there will be log2(n) passes, so this results
|
||||
in an overall factor of 1/n, distributed to
|
||||
maximize arithmetic accuracy.
|
||||
*/
|
||||
shift = 1;
|
||||
}
|
||||
/*
|
||||
it may not be obvious, but the shift will be
|
||||
performed on each data point exactly once,
|
||||
during this pass.
|
||||
*/
|
||||
istep = l << 1;
|
||||
for (m=0; m<l; ++m) {
|
||||
j = m << k;
|
||||
/* 0 <= j < N_WAVE/2 */
|
||||
wr = pgm_read_word_near(Sinewave + j+N_WAVE/4);
|
||||
|
||||
/*Serial.println("asdfasdf");
|
||||
Serial.println(wr);
|
||||
Serial.println(j+N_WAVE/4);
|
||||
Serial.println(Sinewave[256]);
|
||||
|
||||
Serial.println("");*/
|
||||
|
||||
|
||||
wi = -pgm_read_word_near(Sinewave + j);
|
||||
if (inverse)
|
||||
wi = -wi;
|
||||
if (shift) {
|
||||
wr >>= 1;
|
||||
wi >>= 1;
|
||||
}
|
||||
for (i=m; i<n; i+=istep) {
|
||||
j = i + l;
|
||||
tr = FIX_MPY(wr,fr[j]) - FIX_MPY(wi,fi[j]);
|
||||
ti = FIX_MPY(wr,fi[j]) + FIX_MPY(wi,fr[j]);
|
||||
qr = fr[i];
|
||||
qi = fi[i];
|
||||
if (shift) {
|
||||
qr >>= 1;
|
||||
qi >>= 1;
|
||||
}
|
||||
fr[j] = qr - tr;
|
||||
fi[j] = qi - ti;
|
||||
fr[i] = qr + tr;
|
||||
fi[i] = qi + ti;
|
||||
}
|
||||
}
|
||||
--k;
|
||||
l = istep;
|
||||
}
|
||||
return scale;
|
||||
}
|
||||
|
||||
/*
|
||||
fix_fftr() - forward/inverse FFT on array of real numbers.
|
||||
Real FFT/iFFT using half-size complex FFT by distributing
|
||||
even/odd samples into real/imaginary arrays respectively.
|
||||
In order to save data space (i.e. to avoid two arrays, one
|
||||
for real, one for imaginary samples), we proceed in the
|
||||
following two steps: a) samples are rearranged in the real
|
||||
array so that all even samples are in places 0-(N/2-1) and
|
||||
all imaginary samples in places (N/2)-(N-1), and b) fix_fft
|
||||
is called with fr and fi pointing to index 0 and index N/2
|
||||
respectively in the original array. The above guarantees
|
||||
that fix_fft "sees" consecutive real samples as alternating
|
||||
real and imaginary samples in the complex array.
|
||||
*/
|
||||
int fix_fftr(char f[], int m, int inverse)
|
||||
{
|
||||
int i, N = 1<<(m-1), scale = 0;
|
||||
char tt, *fr=f, *fi=&f[N];
|
||||
|
||||
if (inverse)
|
||||
scale = fix_fft(fi, fr, m-1, inverse);
|
||||
for (i=1; i<N; i+=2) {
|
||||
tt = f[N+i-1];
|
||||
f[N+i-1] = f[i];
|
||||
f[i] = tt;
|
||||
}
|
||||
if (! inverse)
|
||||
scale = fix_fft(fi, fr, m-1, inverse);
|
||||
return scale;
|
||||
}
|
38
fix_fft.h
38
fix_fft.h
@ -1,38 +0,0 @@
|
||||
#ifndef FIXFFT_H
|
||||
#define FIXFFT_H
|
||||
|
||||
//#include <WProgram.h> //depreacted included in arduino.h
|
||||
|
||||
|
||||
|
||||
|
||||
/*
|
||||
fix_fft() - perform forward/inverse fast Fourier transform.
|
||||
fr[n],fi[n] are real and imaginary arrays, both INPUT AND
|
||||
RESULT (in-place FFT), with 0 <= n < 2**m; set inverse to
|
||||
0 for forward transform (FFT), or 1 for iFFT.
|
||||
*/
|
||||
int fix_fft(char fr[], char fi[], int m, int inverse);
|
||||
|
||||
|
||||
|
||||
/*
|
||||
fix_fftr() - forward/inverse FFT on array of real numbers.
|
||||
Real FFT/iFFT using half-size complex FFT by distributing
|
||||
even/odd samples into real/imaginary arrays respectively.
|
||||
In order to save data space (i.e. to avoid two arrays, one
|
||||
for real, one for imaginary samples), we proceed in the
|
||||
following two steps: a) samples are rearranged in the real
|
||||
array so that all even samples are in places 0-(N/2-1) and
|
||||
all imaginary samples in places (N/2)-(N-1), and b) fix_fft
|
||||
is called with fr and fi pointing to index 0 and index N/2
|
||||
respectively in the original array. The above guarantees
|
||||
that fix_fft "sees" consecutive real samples as alternating
|
||||
real and imaginary samples in the complex array.
|
||||
*/
|
||||
int fix_fftr(char f[], int m, int inverse);
|
||||
static inline char FIX_MPY(char a,char b);
|
||||
|
||||
|
||||
|
||||
#endif
|
@ -1,52 +0,0 @@
|
||||
/*
|
||||
* ATTENTION: This example uses the old v1.0 interface.
|
||||
*
|
||||
* Light_WS2812 library example - Chained Writes
|
||||
*
|
||||
* This example shows how to use multiple calls without issuing a reset
|
||||
* in between, allowing to send the same buffer to the string
|
||||
* multiple times. This technique can be useful to conserve memory
|
||||
* or to calculate LED colors on-the-fly.
|
||||
*
|
||||
* Please make sure to set your configuration in "WS2812_config.h" first
|
||||
*
|
||||
*/
|
||||
|
||||
#include <util/delay.h>
|
||||
#include <avr/io.h>
|
||||
#include <avr/interrupt.h>
|
||||
#include "light_ws2812.h"
|
||||
|
||||
struct cRGB led[2];
|
||||
|
||||
int main(void)
|
||||
{
|
||||
|
||||
uint8_t pos=0;
|
||||
uint8_t direction=1;
|
||||
uint8_t i;
|
||||
|
||||
#ifdef __AVR_ATtiny10__
|
||||
CCP=0xD8; // configuration change protection, write signature
|
||||
CLKPSR=0; // set cpu clock prescaler =1 (8Mhz) (attiny 4/5/9/10)
|
||||
#endif
|
||||
|
||||
led[0].r=16;led[0].g=00;led[0].b=00; // LED 0 is red
|
||||
led[1].r=16;led[1].g=16;led[1].b=16; // LED 1 is White
|
||||
|
||||
while(1)
|
||||
{
|
||||
|
||||
for (i=0; i<pos; i++)
|
||||
ws2812_sendarray((uint8_t *)&led[0],3); // Repeatedly send "red" to the led string.
|
||||
// No more than 1-2µs should pass between calls
|
||||
// to avoid issuing a reset condition.
|
||||
for (i=0; i<(16-pos); i++)
|
||||
ws2812_sendarray((uint8_t *)&led[1],3); // white
|
||||
|
||||
_delay_ms(50); // Issue reset and wait for 50 ms.
|
||||
|
||||
pos+=direction;
|
||||
if ((pos==16)||(pos==0)) direction=-direction;
|
||||
}
|
||||
}
|
@ -1,45 +0,0 @@
|
||||
/*
|
||||
* Light_WS2812 library example - RGBW_blinky
|
||||
*
|
||||
* cycles one LED through red, green, blue, white
|
||||
*
|
||||
* This example does only work with the SK6812RGBW LEDs
|
||||
*
|
||||
* Please make sure to set your configuration in "WS2812_config.h" first
|
||||
*
|
||||
*/
|
||||
|
||||
#include <util/delay.h>
|
||||
#include <avr/io.h>
|
||||
#include <avr/interrupt.h>
|
||||
#include "light_ws2812.h"
|
||||
|
||||
struct cRGBW led[1];
|
||||
|
||||
int main(void)
|
||||
{
|
||||
#ifdef __AVR_ATtiny10__
|
||||
CCP=0xD8; // configuration change protection, write signature
|
||||
CLKPSR=0; // set cpu clock prescaler =1 (8Mhz) (attiny 4/5/9/10)
|
||||
#endif
|
||||
|
||||
while(1)
|
||||
{
|
||||
led[0].r=128;led[0].g=00;led[0].b=0;led[0].w=0; // Write red to array
|
||||
ws2812_setleds_rgbw(led,1);
|
||||
_delay_ms(500); // wait for 500ms.
|
||||
|
||||
led[0].r=0;led[0].g=128;led[0].b=0;led[0].w=0; // green
|
||||
ws2812_setleds_rgbw(led,1);
|
||||
_delay_ms(500);
|
||||
|
||||
led[0].r=0;led[0].g=0;led[0].b=128;led[0].w=0; // blue
|
||||
ws2812_setleds_rgbw(led,1);
|
||||
_delay_ms(500);
|
||||
|
||||
led[0].r=0;led[0].g=0;led[0].b=0;led[0].w=128; // white
|
||||
ws2812_setleds_rgbw(led,1);
|
||||
_delay_ms(500);
|
||||
|
||||
}
|
||||
}
|
@ -1,38 +0,0 @@
|
||||
/*
|
||||
* Light_WS2812 library example - RGB_blinky
|
||||
*
|
||||
* cycles one LED through red, green, blue
|
||||
*
|
||||
* This example is configured for a ATtiny85 with PLL clock fuse set and
|
||||
* the WS2812 string connected to PB4.
|
||||
*/
|
||||
|
||||
#include <util/delay.h>
|
||||
#include <avr/io.h>
|
||||
#include <avr/interrupt.h>
|
||||
#include "light_ws2812.h"
|
||||
|
||||
struct cRGB led[1];
|
||||
|
||||
int main(void)
|
||||
{
|
||||
#ifdef __AVR_ATtiny10__
|
||||
CCP=0xD8; // configuration change protection, write signature
|
||||
CLKPSR=0; // set cpu clock prescaler =1 (8Mhz) (attiny 4/5/9/10)
|
||||
#endif
|
||||
|
||||
while(1)
|
||||
{
|
||||
led[0].r=255;led[0].g=00;led[0].b=0; // Write red to array
|
||||
ws2812_setleds(led,1);
|
||||
_delay_ms(500); // wait for 500ms.
|
||||
|
||||
led[0].r=0;led[0].g=255;led[0].b=0; // green
|
||||
ws2812_setleds(led,1);
|
||||
_delay_ms(500);
|
||||
|
||||
led[0].r=0;led[0].g=00;led[0].b=255; // blue
|
||||
ws2812_setleds(led,1);
|
||||
_delay_ms(500);
|
||||
}
|
||||
}
|
@ -1,84 +0,0 @@
|
||||
/*
|
||||
*
|
||||
* This example is configured for a Atmega32 at 16MHz
|
||||
*/
|
||||
|
||||
#include <util/delay.h>
|
||||
#include <avr/io.h>
|
||||
#include <avr/interrupt.h>
|
||||
#include "light_ws2812.h"
|
||||
|
||||
#define MAXPIX 30
|
||||
#define COLORLENGTH (MAXPIX/2)
|
||||
#define FADE (256/COLORLENGTH)
|
||||
|
||||
struct cRGB colors[8];
|
||||
struct cRGB led[MAXPIX];
|
||||
|
||||
int main(void)
|
||||
{
|
||||
|
||||
uint8_t j = 1;
|
||||
uint8_t k = 1;
|
||||
|
||||
DDRB|=_BV(ws2812_pin);
|
||||
|
||||
uint8_t i;
|
||||
for(i=MAXPIX; i>0; i--)
|
||||
{
|
||||
led[i-1].r=0;led[i-1].g=0;led[i-1].b=0;
|
||||
}
|
||||
|
||||
//Rainbowcolors
|
||||
colors[0].r=150; colors[0].g=150; colors[0].b=150;
|
||||
colors[1].r=255; colors[1].g=000; colors[1].b=000;//red
|
||||
colors[2].r=255; colors[2].g=100; colors[2].b=000;//orange
|
||||
colors[3].r=100; colors[3].g=255; colors[3].b=000;//yellow
|
||||
colors[4].r=000; colors[4].g=255; colors[4].b=000;//green
|
||||
colors[5].r=000; colors[5].g=100; colors[5].b=255;//light blue (türkis)
|
||||
colors[6].r=000; colors[6].g=000; colors[6].b=255;//blue
|
||||
colors[7].r=100; colors[7].g=000; colors[7].b=255;//violet
|
||||
|
||||
while(1)
|
||||
{
|
||||
//shift all vallues by one led
|
||||
uint8_t i=0;
|
||||
for(i=MAXPIX; i>1; i--)
|
||||
led[i-1]=led[i-2];
|
||||
//change colour when colourlength is reached
|
||||
if(k>COLORLENGTH)
|
||||
{
|
||||
j++;
|
||||
if(j>7)
|
||||
{
|
||||
j=0;
|
||||
}
|
||||
|
||||
k=0;
|
||||
}
|
||||
k++;
|
||||
//loop colouers
|
||||
|
||||
//fade red
|
||||
if(led[0].r<(colors[j].r-FADE))
|
||||
led[0].r+=FADE;
|
||||
|
||||
if(led[0].r>(colors[j].r+FADE))
|
||||
led[0].r-=FADE;
|
||||
|
||||
if(led[0].g<(colors[j].g-FADE))
|
||||
led[0].g+=FADE;
|
||||
|
||||
if(led[0].g>(colors[j].g+FADE))
|
||||
led[0].g-=FADE;
|
||||
|
||||
if(led[0].b<(colors[j].b-FADE))
|
||||
led[0].b+=FADE;
|
||||
|
||||
if(led[0].b>(colors[j].b+FADE))
|
||||
led[0].b-=FADE;
|
||||
|
||||
_delay_ms(10);
|
||||
ws2812_sendarray((uint8_t *)led,MAXPIX*3);
|
||||
}
|
||||
}
|
@ -1,676 +0,0 @@
|
||||
|
||||
|
||||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The GNU General Public License is a free, copyleft license for
|
||||
software and other kinds of works.
|
||||
|
||||
The licenses for most software and other practical works are designed
|
||||
to take away your freedom to share and change the works. By contrast,
|
||||
the GNU General Public License is intended to guarantee your freedom to
|
||||
share and change all versions of a program--to make sure it remains free
|
||||
software for all its users. We, the Free Software Foundation, use the
|
||||
GNU General Public License for most of our software; it applies also to
|
||||
any other work released this way by its authors. You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
them if you wish), that you receive source code or can get it if you
|
||||
want it, that you can change the software or use pieces of it in new
|
||||
free programs, and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to prevent others from denying you
|
||||
these rights or asking you to surrender the rights. Therefore, you have
|
||||
certain responsibilities if you distribute copies of the software, or if
|
||||
you modify it: responsibilities to respect the freedom of others.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must pass on to the recipients the same
|
||||
freedoms that you received. You must make sure that they, too, receive
|
||||
or can get the source code. And you must show them these terms so they
|
||||
know their rights.
|
||||
|
||||
Developers that use the GNU GPL protect your rights with two steps:
|
||||
(1) assert copyright on the software, and (2) offer you this License
|
||||
giving you legal permission to copy, distribute and/or modify it.
|
||||
|
||||
For the developers' and authors' protection, the GPL clearly explains
|
||||
that there is no warranty for this free software. For both users' and
|
||||
authors' sake, the GPL requires that modified versions be marked as
|
||||
changed, so that their problems will not be attributed erroneously to
|
||||
authors of previous versions.
|
||||
|
||||
Some devices are designed to deny users access to install or run
|
||||
modified versions of the software inside them, although the manufacturer
|
||||
can do so. This is fundamentally incompatible with the aim of
|
||||
protecting users' freedom to change the software. The systematic
|
||||
pattern of such abuse occurs in the area of products for individuals to
|
||||
use, which is precisely where it is most unacceptable. Therefore, we
|
||||
have designed this version of the GPL to prohibit the practice for those
|
||||
products. If such problems arise substantially in other domains, we
|
||||
stand ready to extend this provision to those domains in future versions
|
||||
of the GPL, as needed to protect the freedom of users.
|
||||
|
||||
Finally, every program is threatened constantly by software patents.
|
||||
States should not allow patents to restrict development and use of
|
||||
software on general-purpose computers, but in those that do, we wish to
|
||||
avoid the special danger that patents applied to a free program could
|
||||
make it effectively proprietary. To prevent this, the GPL assures that
|
||||
patents cannot be used to render the program non-free.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
TERMS AND CONDITIONS
|
||||
|
||||
0. Definitions.
|
||||
|
||||
"This License" refers to version 3 of the GNU General Public License.
|
||||
|
||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||
works, such as semiconductor masks.
|
||||
|
||||
"The Program" refers to any copyrightable work licensed under this
|
||||
License. Each licensee is addressed as "you". "Licensees" and
|
||||
"recipients" may be individuals or organizations.
|
||||
|
||||
To "modify" a work means to copy from or adapt all or part of the work
|
||||
in a fashion requiring copyright permission, other than the making of an
|
||||
exact copy. The resulting work is called a "modified version" of the
|
||||
earlier work or a work "based on" the earlier work.
|
||||
|
||||
A "covered work" means either the unmodified Program or a work based
|
||||
on the Program.
|
||||
|
||||
To "propagate" a work means to do anything with it that, without
|
||||
permission, would make you directly or secondarily liable for
|
||||
infringement under applicable copyright law, except executing it on a
|
||||
computer or modifying a private copy. Propagation includes copying,
|
||||
distribution (with or without modification), making available to the
|
||||
public, and in some countries other activities as well.
|
||||
|
||||
To "convey" a work means any kind of propagation that enables other
|
||||
parties to make or receive copies. Mere interaction with a user through
|
||||
a computer network, with no transfer of a copy, is not conveying.
|
||||
|
||||
An interactive user interface displays "Appropriate Legal Notices"
|
||||
to the extent that it includes a convenient and prominently visible
|
||||
feature that (1) displays an appropriate copyright notice, and (2)
|
||||
tells the user that there is no warranty for the work (except to the
|
||||
extent that warranties are provided), that licensees may convey the
|
||||
work under this License, and how to view a copy of this License. If
|
||||
the interface presents a list of user commands or options, such as a
|
||||
menu, a prominent item in the list meets this criterion.
|
||||
|
||||
1. Source Code.
|
||||
|
||||
The "source code" for a work means the preferred form of the work
|
||||
for making modifications to it. "Object code" means any non-source
|
||||
form of a work.
|
||||
|
||||
A "Standard Interface" means an interface that either is an official
|
||||
standard defined by a recognized standards body, or, in the case of
|
||||
interfaces specified for a particular programming language, one that
|
||||
is widely used among developers working in that language.
|
||||
|
||||
The "System Libraries" of an executable work include anything, other
|
||||
than the work as a whole, that (a) is included in the normal form of
|
||||
packaging a Major Component, but which is not part of that Major
|
||||
Component, and (b) serves only to enable use of the work with that
|
||||
Major Component, or to implement a Standard Interface for which an
|
||||
implementation is available to the public in source code form. A
|
||||
"Major Component", in this context, means a major essential component
|
||||
(kernel, window system, and so on) of the specific operating system
|
||||
(if any) on which the executable work runs, or a compiler used to
|
||||
produce the work, or an object code interpreter used to run it.
|
||||
|
||||
The "Corresponding Source" for a work in object code form means all
|
||||
the source code needed to generate, install, and (for an executable
|
||||
work) run the object code and to modify the work, including scripts to
|
||||
control those activities. However, it does not include the work's
|
||||
System Libraries, or general-purpose tools or generally available free
|
||||
programs which are used unmodified in performing those activities but
|
||||
which are not part of the work. For example, Corresponding Source
|
||||
includes interface definition files associated with source files for
|
||||
the work, and the source code for shared libraries and dynamically
|
||||
linked subprograms that the work is specifically designed to require,
|
||||
such as by intimate data communication or control flow between those
|
||||
subprograms and other parts of the work.
|
||||
|
||||
The Corresponding Source need not include anything that users
|
||||
can regenerate automatically from other parts of the Corresponding
|
||||
Source.
|
||||
|
||||
The Corresponding Source for a work in source code form is that
|
||||
same work.
|
||||
|
||||
2. Basic Permissions.
|
||||
|
||||
All rights granted under this License are granted for the term of
|
||||
copyright on the Program, and are irrevocable provided the stated
|
||||
conditions are met. This License explicitly affirms your unlimited
|
||||
permission to run the unmodified Program. The output from running a
|
||||
covered work is covered by this License only if the output, given its
|
||||
content, constitutes a covered work. This License acknowledges your
|
||||
rights of fair use or other equivalent, as provided by copyright law.
|
||||
|
||||
You may make, run and propagate covered works that you do not
|
||||
convey, without conditions so long as your license otherwise remains
|
||||
in force. You may convey covered works to others for the sole purpose
|
||||
of having them make modifications exclusively for you, or provide you
|
||||
with facilities for running those works, provided that you comply with
|
||||
the terms of this License in conveying all material for which you do
|
||||
not control copyright. Those thus making or running the covered works
|
||||
for you must do so exclusively on your behalf, under your direction
|
||||
and control, on terms that prohibit them from making any copies of
|
||||
your copyrighted material outside their relationship with you.
|
||||
|
||||
Conveying under any other circumstances is permitted solely under
|
||||
the conditions stated below. Sublicensing is not allowed; section 10
|
||||
makes it unnecessary.
|
||||
|
||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||
|
||||
No covered work shall be deemed part of an effective technological
|
||||
measure under any applicable law fulfilling obligations under article
|
||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||
similar laws prohibiting or restricting circumvention of such
|
||||
measures.
|
||||
|
||||
When you convey a covered work, you waive any legal power to forbid
|
||||
circumvention of technological measures to the extent such circumvention
|
||||
is effected by exercising rights under this License with respect to
|
||||
the covered work, and you disclaim any intention to limit operation or
|
||||
modification of the work as a means of enforcing, against the work's
|
||||
users, your or third parties' legal rights to forbid circumvention of
|
||||
technological measures.
|
||||
|
||||
4. Conveying Verbatim Copies.
|
||||
|
||||
You may convey verbatim copies of the Program's source code as you
|
||||
receive it, in any medium, provided that you conspicuously and
|
||||
appropriately publish on each copy an appropriate copyright notice;
|
||||
keep intact all notices stating that this License and any
|
||||
non-permissive terms added in accord with section 7 apply to the code;
|
||||
keep intact all notices of the absence of any warranty; and give all
|
||||
recipients a copy of this License along with the Program.
|
||||
|
||||
You may charge any price or no price for each copy that you convey,
|
||||
and you may offer support or warranty protection for a fee.
|
||||
|
||||
5. Conveying Modified Source Versions.
|
||||
|
||||
You may convey a work based on the Program, or the modifications to
|
||||
produce it from the Program, in the form of source code under the
|
||||
terms of section 4, provided that you also meet all of these conditions:
|
||||
|
||||
a) The work must carry prominent notices stating that you modified
|
||||
it, and giving a relevant date.
|
||||
|
||||
b) The work must carry prominent notices stating that it is
|
||||
released under this License and any conditions added under section
|
||||
7. This requirement modifies the requirement in section 4 to
|
||||
"keep intact all notices".
|
||||
|
||||
c) You must license the entire work, as a whole, under this
|
||||
License to anyone who comes into possession of a copy. This
|
||||
License will therefore apply, along with any applicable section 7
|
||||
additional terms, to the whole of the work, and all its parts,
|
||||
regardless of how they are packaged. This License gives no
|
||||
permission to license the work in any other way, but it does not
|
||||
invalidate such permission if you have separately received it.
|
||||
|
||||
d) If the work has interactive user interfaces, each must display
|
||||
Appropriate Legal Notices; however, if the Program has interactive
|
||||
interfaces that do not display Appropriate Legal Notices, your
|
||||
work need not make them do so.
|
||||
|
||||
A compilation of a covered work with other separate and independent
|
||||
works, which are not by their nature extensions of the covered work,
|
||||
and which are not combined with it such as to form a larger program,
|
||||
in or on a volume of a storage or distribution medium, is called an
|
||||
"aggregate" if the compilation and its resulting copyright are not
|
||||
used to limit the access or legal rights of the compilation's users
|
||||
beyond what the individual works permit. Inclusion of a covered work
|
||||
in an aggregate does not cause this License to apply to the other
|
||||
parts of the aggregate.
|
||||
|
||||
6. Conveying Non-Source Forms.
|
||||
|
||||
You may convey a covered work in object code form under the terms
|
||||
of sections 4 and 5, provided that you also convey the
|
||||
machine-readable Corresponding Source under the terms of this License,
|
||||
in one of these ways:
|
||||
|
||||
a) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by the
|
||||
Corresponding Source fixed on a durable physical medium
|
||||
customarily used for software interchange.
|
||||
|
||||
b) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by a
|
||||
written offer, valid for at least three years and valid for as
|
||||
long as you offer spare parts or customer support for that product
|
||||
model, to give anyone who possesses the object code either (1) a
|
||||
copy of the Corresponding Source for all the software in the
|
||||
product that is covered by this License, on a durable physical
|
||||
medium customarily used for software interchange, for a price no
|
||||
more than your reasonable cost of physically performing this
|
||||
conveying of source, or (2) access to copy the
|
||||
Corresponding Source from a network server at no charge.
|
||||
|
||||
c) Convey individual copies of the object code with a copy of the
|
||||
written offer to provide the Corresponding Source. This
|
||||
alternative is allowed only occasionally and noncommercially, and
|
||||
only if you received the object code with such an offer, in accord
|
||||
with subsection 6b.
|
||||
|
||||
d) Convey the object code by offering access from a designated
|
||||
place (gratis or for a charge), and offer equivalent access to the
|
||||
Corresponding Source in the same way through the same place at no
|
||||
further charge. You need not require recipients to copy the
|
||||
Corresponding Source along with the object code. If the place to
|
||||
copy the object code is a network server, the Corresponding Source
|
||||
may be on a different server (operated by you or a third party)
|
||||
that supports equivalent copying facilities, provided you maintain
|
||||
clear directions next to the object code saying where to find the
|
||||
Corresponding Source. Regardless of what server hosts the
|
||||
Corresponding Source, you remain obligated to ensure that it is
|
||||
available for as long as needed to satisfy these requirements.
|
||||
|
||||
e) Convey the object code using peer-to-peer transmission, provided
|
||||
you inform other peers where the object code and Corresponding
|
||||
Source of the work are being offered to the general public at no
|
||||
charge under subsection 6d.
|
||||
|
||||
A separable portion of the object code, whose source code is excluded
|
||||
from the Corresponding Source as a System Library, need not be
|
||||
included in conveying the object code work.
|
||||
|
||||
A "User Product" is either (1) a "consumer product", which means any
|
||||
tangible personal property which is normally used for personal, family,
|
||||
or household purposes, or (2) anything designed or sold for incorporation
|
||||
into a dwelling. In determining whether a product is a consumer product,
|
||||
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||
product received by a particular user, "normally used" refers to a
|
||||
typical or common use of that class of product, regardless of the status
|
||||
of the particular user or of the way in which the particular user
|
||||
actually uses, or expects or is expected to use, the product. A product
|
||||
is a consumer product regardless of whether the product has substantial
|
||||
commercial, industrial or non-consumer uses, unless such uses represent
|
||||
the only significant mode of use of the product.
|
||||
|
||||
"Installation Information" for a User Product means any methods,
|
||||
procedures, authorization keys, or other information required to install
|
||||
and execute modified versions of a covered work in that User Product from
|
||||
a modified version of its Corresponding Source. The information must
|
||||
suffice to ensure that the continued functioning of the modified object
|
||||
code is in no case prevented or interfered with solely because
|
||||
modification has been made.
|
||||
|
||||
If you convey an object code work under this section in, or with, or
|
||||
specifically for use in, a User Product, and the conveying occurs as
|
||||
part of a transaction in which the right of possession and use of the
|
||||
User Product is transferred to the recipient in perpetuity or for a
|
||||
fixed term (regardless of how the transaction is characterized), the
|
||||
Corresponding Source conveyed under this section must be accompanied
|
||||
by the Installation Information. But this requirement does not apply
|
||||
if neither you nor any third party retains the ability to install
|
||||
modified object code on the User Product (for example, the work has
|
||||
been installed in ROM).
|
||||
|
||||
The requirement to provide Installation Information does not include a
|
||||
requirement to continue to provide support service, warranty, or updates
|
||||
for a work that has been modified or installed by the recipient, or for
|
||||
the User Product in which it has been modified or installed. Access to a
|
||||
network may be denied when the modification itself materially and
|
||||
adversely affects the operation of the network or violates the rules and
|
||||
protocols for communication across the network.
|
||||
|
||||
Corresponding Source conveyed, and Installation Information provided,
|
||||
in accord with this section must be in a format that is publicly
|
||||
documented (and with an implementation available to the public in
|
||||
source code form), and must require no special password or key for
|
||||
unpacking, reading or copying.
|
||||
|
||||
7. Additional Terms.
|
||||
|
||||
"Additional permissions" are terms that supplement the terms of this
|
||||
License by making exceptions from one or more of its conditions.
|
||||
Additional permissions that are applicable to the entire Program shall
|
||||
be treated as though they were included in this License, to the extent
|
||||
that they are valid under applicable law. If additional permissions
|
||||
apply only to part of the Program, that part may be used separately
|
||||
under those permissions, but the entire Program remains governed by
|
||||
this License without regard to the additional permissions.
|
||||
|
||||
When you convey a copy of a covered work, you may at your option
|
||||
remove any additional permissions from that copy, or from any part of
|
||||
it. (Additional permissions may be written to require their own
|
||||
removal in certain cases when you modify the work.) You may place
|
||||
additional permissions on material, added by you to a covered work,
|
||||
for which you have or can give appropriate copyright permission.
|
||||
|
||||
Notwithstanding any other provision of this License, for material you
|
||||
add to a covered work, you may (if authorized by the copyright holders of
|
||||
that material) supplement the terms of this License with terms:
|
||||
|
||||
a) Disclaiming warranty or limiting liability differently from the
|
||||
terms of sections 15 and 16 of this License; or
|
||||
|
||||
b) Requiring preservation of specified reasonable legal notices or
|
||||
author attributions in that material or in the Appropriate Legal
|
||||
Notices displayed by works containing it; or
|
||||
|
||||
c) Prohibiting misrepresentation of the origin of that material, or
|
||||
requiring that modified versions of such material be marked in
|
||||
reasonable ways as different from the original version; or
|
||||
|
||||
d) Limiting the use for publicity purposes of names of licensors or
|
||||
authors of the material; or
|
||||
|
||||
e) Declining to grant rights under trademark law for use of some
|
||||
trade names, trademarks, or service marks; or
|
||||
|
||||
f) Requiring indemnification of licensors and authors of that
|
||||
material by anyone who conveys the material (or modified versions of
|
||||
it) with contractual assumptions of liability to the recipient, for
|
||||
any liability that these contractual assumptions directly impose on
|
||||
those licensors and authors.
|
||||
|
||||
All other non-permissive additional terms are considered "further
|
||||
restrictions" within the meaning of section 10. If the Program as you
|
||||
received it, or any part of it, contains a notice stating that it is
|
||||
governed by this License along with a term that is a further
|
||||
restriction, you may remove that term. If a license document contains
|
||||
a further restriction but permits relicensing or conveying under this
|
||||
License, you may add to a covered work material governed by the terms
|
||||
of that license document, provided that the further restriction does
|
||||
not survive such relicensing or conveying.
|
||||
|
||||
If you add terms to a covered work in accord with this section, you
|
||||
must place, in the relevant source files, a statement of the
|
||||
additional terms that apply to those files, or a notice indicating
|
||||
where to find the applicable terms.
|
||||
|
||||
Additional terms, permissive or non-permissive, may be stated in the
|
||||
form of a separately written license, or stated as exceptions;
|
||||
the above requirements apply either way.
|
||||
|
||||
8. Termination.
|
||||
|
||||
You may not propagate or modify a covered work except as expressly
|
||||
provided under this License. Any attempt otherwise to propagate or
|
||||
modify it is void, and will automatically terminate your rights under
|
||||
this License (including any patent licenses granted under the third
|
||||
paragraph of section 11).
|
||||
|
||||
However, if you cease all violation of this License, then your
|
||||
license from a particular copyright holder is reinstated (a)
|
||||
provisionally, unless and until the copyright holder explicitly and
|
||||
finally terminates your license, and (b) permanently, if the copyright
|
||||
holder fails to notify you of the violation by some reasonable means
|
||||
prior to 60 days after the cessation.
|
||||
|
||||
Moreover, your license from a particular copyright holder is
|
||||
reinstated permanently if the copyright holder notifies you of the
|
||||
violation by some reasonable means, this is the first time you have
|
||||
received notice of violation of this License (for any work) from that
|
||||
copyright holder, and you cure the violation prior to 30 days after
|
||||
your receipt of the notice.
|
||||
|
||||
Termination of your rights under this section does not terminate the
|
||||
licenses of parties who have received copies or rights from you under
|
||||
this License. If your rights have been terminated and not permanently
|
||||
reinstated, you do not qualify to receive new licenses for the same
|
||||
material under section 10.
|
||||
|
||||
9. Acceptance Not Required for Having Copies.
|
||||
|
||||
You are not required to accept this License in order to receive or
|
||||
run a copy of the Program. Ancillary propagation of a covered work
|
||||
occurring solely as a consequence of using peer-to-peer transmission
|
||||
to receive a copy likewise does not require acceptance. However,
|
||||
nothing other than this License grants you permission to propagate or
|
||||
modify any covered work. These actions infringe copyright if you do
|
||||
not accept this License. Therefore, by modifying or propagating a
|
||||
covered work, you indicate your acceptance of this License to do so.
|
||||
|
||||
10. Automatic Licensing of Downstream Recipients.
|
||||
|
||||
Each time you convey a covered work, the recipient automatically
|
||||
receives a license from the original licensors, to run, modify and
|
||||
propagate that work, subject to this License. You are not responsible
|
||||
for enforcing compliance by third parties with this License.
|
||||
|
||||
An "entity transaction" is a transaction transferring control of an
|
||||
organization, or substantially all assets of one, or subdividing an
|
||||
organization, or merging organizations. If propagation of a covered
|
||||
work results from an entity transaction, each party to that
|
||||
transaction who receives a copy of the work also receives whatever
|
||||
licenses to the work the party's predecessor in interest had or could
|
||||
give under the previous paragraph, plus a right to possession of the
|
||||
Corresponding Source of the work from the predecessor in interest, if
|
||||
the predecessor has it or can get it with reasonable efforts.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
11. Patents.
|
||||
|
||||
A "contributor" is a copyright holder who authorizes use under this
|
||||
License of the Program or a work on which the Program is based. The
|
||||
work thus licensed is called the contributor's "contributor version".
|
||||
|
||||
A contributor's "essential patent claims" are all patent claims
|
||||
owned or controlled by the contributor, whether already acquired or
|
||||
hereafter acquired, that would be infringed by some manner, permitted
|
||||
by this License, of making, using, or selling its contributor version,
|
||||
but do not include claims that would be infringed only as a
|
||||
consequence of further modification of the contributor version. For
|
||||
purposes of this definition, "control" includes the right to grant
|
||||
patent sublicenses in a manner consistent with the requirements of
|
||||
this License.
|
||||
|
||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||
patent license under the contributor's essential patent claims, to
|
||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||
propagate the contents of its contributor version.
|
||||
|
||||
In the following three paragraphs, a "patent license" is any express
|
||||
agreement or commitment, however denominated, not to enforce a patent
|
||||
(such as an express permission to practice a patent or covenant not to
|
||||
sue for patent infringement). To "grant" such a patent license to a
|
||||
party means to make such an agreement or commitment not to enforce a
|
||||
patent against the party.
|
||||
|
||||
If you convey a covered work, knowingly relying on a patent license,
|
||||
and the Corresponding Source of the work is not available for anyone
|
||||
to copy, free of charge and under the terms of this License, through a
|
||||
publicly available network server or other readily accessible means,
|
||||
then you must either (1) cause the Corresponding Source to be so
|
||||
available, or (2) arrange to deprive yourself of the benefit of the
|
||||
patent license for this particular work, or (3) arrange, in a manner
|
||||
consistent with the requirements of this License, to extend the patent
|
||||
license to downstream recipients. "Knowingly relying" means you have
|
||||
actual knowledge that, but for the patent license, your conveying the
|
||||
covered work in a country, or your recipient's use of the covered work
|
||||
in a country, would infringe one or more identifiable patents in that
|
||||
country that you have reason to believe are valid.
|
||||
|
||||
If, pursuant to or in connection with a single transaction or
|
||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||
covered work, and grant a patent license to some of the parties
|
||||
receiving the covered work authorizing them to use, propagate, modify
|
||||
or convey a specific copy of the covered work, then the patent license
|
||||
you grant is automatically extended to all recipients of the covered
|
||||
work and works based on it.
|
||||
|
||||
A patent license is "discriminatory" if it does not include within
|
||||
the scope of its coverage, prohibits the exercise of, or is
|
||||
conditioned on the non-exercise of one or more of the rights that are
|
||||
specifically granted under this License. You may not convey a covered
|
||||
work if you are a party to an arrangement with a third party that is
|
||||
in the business of distributing software, under which you make payment
|
||||
to the third party based on the extent of your activity of conveying
|
||||
the work, and under which the third party grants, to any of the
|
||||
parties who would receive the covered work from you, a discriminatory
|
||||
patent license (a) in connection with copies of the covered work
|
||||
conveyed by you (or copies made from those copies), or (b) primarily
|
||||
for and in connection with specific products or compilations that
|
||||
contain the covered work, unless you entered into that arrangement,
|
||||
or that patent license was granted, prior to 28 March 2007.
|
||||
|
||||
Nothing in this License shall be construed as excluding or limiting
|
||||
any implied license or other defenses to infringement that may
|
||||
otherwise be available to you under applicable patent law.
|
||||
|
||||
12. No Surrender of Others' Freedom.
|
||||
|
||||
If conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot convey a
|
||||
covered work so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you may
|
||||
not convey it at all. For example, if you agree to terms that obligate you
|
||||
to collect a royalty for further conveying from those to whom you convey
|
||||
the Program, the only way you could satisfy both those terms and this
|
||||
License would be to refrain entirely from conveying the Program.
|
||||
|
||||
13. Use with the GNU Affero General Public License.
|
||||
|
||||
Notwithstanding any other provision of this License, you have
|
||||
permission to link or combine any covered work with a work licensed
|
||||
under version 3 of the GNU Affero General Public License into a single
|
||||
combined work, and to convey the resulting work. The terms of this
|
||||
License will continue to apply to the part which is the covered work,
|
||||
but the special requirements of the GNU Affero General Public License,
|
||||
section 13, concerning interaction through a network will apply to the
|
||||
combination as such.
|
||||
|
||||
14. Revised Versions of this License.
|
||||
|
||||
The Free Software Foundation may publish revised and/or new versions of
|
||||
the GNU General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the
|
||||
Program specifies that a certain numbered version of the GNU General
|
||||
Public License "or any later version" applies to it, you have the
|
||||
option of following the terms and conditions either of that numbered
|
||||
version or of any later version published by the Free Software
|
||||
Foundation. If the Program does not specify a version number of the
|
||||
GNU General Public License, you may choose any version ever published
|
||||
by the Free Software Foundation.
|
||||
|
||||
If the Program specifies that a proxy can decide which future
|
||||
versions of the GNU General Public License can be used, that proxy's
|
||||
public statement of acceptance of a version permanently authorizes you
|
||||
to choose that version for the Program.
|
||||
|
||||
Later license versions may give you additional or different
|
||||
permissions. However, no additional obligations are imposed on any
|
||||
author or copyright holder as a result of your choosing to follow a
|
||||
later version.
|
||||
|
||||
15. Disclaimer of Warranty.
|
||||
|
||||
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
|
||||
APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
|
||||
HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
|
||||
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
|
||||
THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
||||
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
|
||||
IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
|
||||
ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
|
||||
|
||||
16. Limitation of Liability.
|
||||
|
||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||
THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
|
||||
GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
|
||||
USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
|
||||
DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
|
||||
PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
|
||||
EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
|
||||
SUCH DAMAGES.
|
||||
|
||||
17. Interpretation of Sections 15 and 16.
|
||||
|
||||
If the disclaimer of warranty and limitation of liability provided
|
||||
above cannot be given local legal effect according to their terms,
|
||||
reviewing courts shall apply local law that most closely approximates
|
||||
an absolute waiver of all civil liability in connection with the
|
||||
Program, unless a warranty or assumption of liability accompanies a
|
||||
copy of the Program in return for a fee.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
state the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
{one line to give the program's name and a brief idea of what it does.}
|
||||
Copyright (C) {year} {name of author}
|
||||
|
||||
This program is free software: you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation, either version 3 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
{project} Copyright (C) {year} {fullname}
|
||||
This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, your program's commands
|
||||
might be different; for a GUI interface, you would use an "about box".
|
||||
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<http://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU General Public License does not permit incorporating your program
|
||||
into proprietary programs. If your program is a subroutine library, you
|
||||
may consider it more useful to permit linking proprietary applications with
|
||||
the library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
@ -1,218 +0,0 @@
|
||||
/*
|
||||
* light weight WS2812 lib V2.5b
|
||||
*
|
||||
* Controls WS2811/WS2812/WS2812B RGB-LEDs
|
||||
* Author: Tim (cpldcpu@gmail.com)
|
||||
*
|
||||
* Jan 18th, 2014 v2.0b Initial Version
|
||||
* Nov 29th, 2015 v2.3 Added SK6812RGBW support
|
||||
* Nov 11th, 2023 v2.5 Added support for ports that cannot be addressed with "out"
|
||||
* Added LGT8F88A support
|
||||
*
|
||||
* License: GNU GPL v2+ (see License.txt)
|
||||
*/
|
||||
|
||||
#include "light_ws2812.h"
|
||||
#include <avr/interrupt.h>
|
||||
#include <avr/io.h>
|
||||
#include <util/delay.h>
|
||||
|
||||
// Normally ws2812_sendarray_mask() runs under disabled-interrupt condition,
|
||||
// undefine if you want to accept interrupts in that function.
|
||||
#define interrupt_is_disabled
|
||||
|
||||
// Setleds for standard RGB
|
||||
void inline ws2812_setleds(struct cRGB *ledarray, uint16_t leds)
|
||||
{
|
||||
ws2812_setleds_pin(ledarray,leds, _BV(ws2812_pin));
|
||||
}
|
||||
|
||||
void inline ws2812_setleds_pin(struct cRGB *ledarray, uint16_t leds, uint8_t pinmask)
|
||||
{
|
||||
ws2812_sendarray_mask((uint8_t*)ledarray,leds+leds+leds,pinmask);
|
||||
_delay_us(ws2812_resettime);
|
||||
}
|
||||
|
||||
// Setleds for SK6812RGBW
|
||||
void inline ws2812_setleds_rgbw(struct cRGBW *ledarray, uint16_t leds)
|
||||
{
|
||||
ws2812_sendarray_mask((uint8_t*)ledarray,leds<<2,_BV(ws2812_pin));
|
||||
_delay_us(ws2812_resettime);
|
||||
}
|
||||
|
||||
void ws2812_sendarray(uint8_t *data,uint16_t datlen)
|
||||
{
|
||||
ws2812_sendarray_mask(data,datlen,_BV(ws2812_pin));
|
||||
}
|
||||
|
||||
/*
|
||||
This routine writes an array of bytes with RGB values to the Dataout pin
|
||||
using the fast 800kHz clockless WS2811/2812 protocol.
|
||||
*/
|
||||
|
||||
// Timing in ns
|
||||
#define w_zeropulse 350
|
||||
#define w_onepulse 900
|
||||
#define w_totalperiod 1250
|
||||
|
||||
// Fixed cycles used by the inner loop
|
||||
#if defined(__LGT8F__)
|
||||
#define w_fixedlow 4
|
||||
#define w_fixedhigh 6
|
||||
#define w_fixedtotal 10
|
||||
#else
|
||||
#define w_fixedlow 3
|
||||
#define w_fixedhigh 6
|
||||
#define w_fixedtotal 10
|
||||
#endif
|
||||
|
||||
// // Fixed cycles used by the inner loop
|
||||
// #define w_fixedlow 2
|
||||
// #define w_fixedhigh 4
|
||||
// #define w_fixedtotal 8
|
||||
|
||||
// Insert NOPs to match the timing, if possible
|
||||
#define w_zerocycles (((F_CPU/1000)*w_zeropulse )/1000000)
|
||||
#define w_onecycles (((F_CPU/1000)*w_onepulse +500000)/1000000)
|
||||
#define w_totalcycles (((F_CPU/1000)*w_totalperiod +500000)/1000000)
|
||||
|
||||
// w1 - nops between rising edge and falling edge - low
|
||||
#define w1 (w_zerocycles-w_fixedlow)
|
||||
// w2 nops between fe low and fe high
|
||||
#define w2 (w_onecycles-w_fixedhigh-w1)
|
||||
// w3 nops to complete loop
|
||||
#define w3 (w_totalcycles-w_fixedtotal-w1-w2)
|
||||
|
||||
#if w1>0
|
||||
#define w1_nops w1
|
||||
#else
|
||||
#define w1_nops 0
|
||||
#endif
|
||||
|
||||
// The only critical timing parameter is the minimum pulse length of the "0"
|
||||
// Warn or throw error if this timing can not be met with current F_CPU settings.
|
||||
#define w_lowtime ((w1_nops+w_fixedlow)*1000000)/(F_CPU/1000)
|
||||
#if w_lowtime>550
|
||||
#error "Light_ws2812: Sorry, the clock speed is too low. Did you set F_CPU correctly?"
|
||||
#elif w_lowtime>450
|
||||
#warning "Light_ws2812: The timing is critical and may only work on WS2812B, not on WS2812(S)."
|
||||
#warning "Please consider a higher clockspeed, if possible"
|
||||
#endif
|
||||
|
||||
#if w2>0
|
||||
#define w2_nops w2
|
||||
#else
|
||||
#define w2_nops 0
|
||||
#endif
|
||||
|
||||
#if w3>0
|
||||
#define w3_nops w3
|
||||
#else
|
||||
#define w3_nops 0
|
||||
#endif
|
||||
|
||||
#define w_nop1 "nop \n\t"
|
||||
#ifdef interrupt_is_disabled
|
||||
#define w_nop2 "brid .+0 \n\t"
|
||||
#else
|
||||
#define w_nop2 "brtc .+0 \n\t"
|
||||
#endif
|
||||
#define w_nop4 w_nop2 w_nop2
|
||||
#define w_nop8 w_nop4 w_nop4
|
||||
#define w_nop16 w_nop8 w_nop8
|
||||
|
||||
void inline ws2812_sendarray_mask(uint8_t *data,uint16_t datlen,uint8_t maskhi)
|
||||
{
|
||||
uint8_t curbyte,ctr,masklo;
|
||||
uint8_t sreg_prev;
|
||||
uint8_t *port = (uint8_t*) _SFR_MEM_ADDR(ws2812_PORTREG);
|
||||
|
||||
ws2812_DDRREG |= maskhi; // Enable output
|
||||
|
||||
masklo =~maskhi&ws2812_PORTREG;
|
||||
maskhi |= ws2812_PORTREG;
|
||||
|
||||
sreg_prev=SREG;
|
||||
#ifdef interrupt_is_disabled
|
||||
cli();
|
||||
#endif
|
||||
|
||||
while (datlen--) {
|
||||
curbyte=*data++;
|
||||
|
||||
asm volatile(
|
||||
" ldi %0,8 \n\t"
|
||||
#ifndef interrupt_is_disabled
|
||||
" clt \n\t"
|
||||
#endif
|
||||
"loop%=: \n\t"
|
||||
" st X,%3 \n\t" // '1' [02] '0' [02] - re
|
||||
|
||||
#if (w1_nops&1)
|
||||
w_nop1
|
||||
#endif
|
||||
#if (w1_nops&2)
|
||||
w_nop2
|
||||
#endif
|
||||
#if (w1_nops&4)
|
||||
w_nop4
|
||||
#endif
|
||||
#if (w1_nops&8)
|
||||
w_nop8
|
||||
#endif
|
||||
#if (w1_nops&16)
|
||||
w_nop16
|
||||
#endif
|
||||
#if defined(__LGT8F__)
|
||||
" bst %1,7 \n\t" // '1' [02] '0' [02]
|
||||
" brts 1f \n\t" // '1' [04] '0' [03]
|
||||
" st X,%4 \n\t" // '1' [--] '0' [04] - fe-low
|
||||
"1: lsl %1 \n\t" // '1' [05] '0' [05]
|
||||
#else
|
||||
" sbrs %1,7 \n\t" // '1' [04] '0' [03]
|
||||
" st X,%4 \n\t" // '1' [--] '0' [05] - fe-low
|
||||
" lsl %1 \n\t" // '1' [05] '0' [06]
|
||||
#endif
|
||||
#if (w2_nops&1)
|
||||
w_nop1
|
||||
#endif
|
||||
#if (w2_nops&2)
|
||||
w_nop2
|
||||
#endif
|
||||
#if (w2_nops&4)
|
||||
w_nop4
|
||||
#endif
|
||||
#if (w2_nops&8)
|
||||
w_nop8
|
||||
#endif
|
||||
#if (w2_nops&16)
|
||||
w_nop16
|
||||
#endif
|
||||
" brcc skipone%= \n\t" // '1' [+1] '0' [+2] -
|
||||
" st X,%4 \n\t" // '1' [+3] '0' [--] - fe-high
|
||||
"skipone%=: " // '1' [+3] '0' [+2] -
|
||||
#if (w3_nops&1)
|
||||
w_nop1
|
||||
#endif
|
||||
#if (w3_nops&2)
|
||||
w_nop2
|
||||
#endif
|
||||
#if (w3_nops&4)
|
||||
w_nop4
|
||||
#endif
|
||||
#if (w3_nops&8)
|
||||
w_nop8
|
||||
#endif
|
||||
#if (w3_nops&16)
|
||||
w_nop16
|
||||
#endif
|
||||
|
||||
" dec %0 \n\t" // '1' [+4] '0' [+3]
|
||||
" brne loop%=\n\t" // '1' [+5] '0' [+4]
|
||||
: "=&d" (ctr)
|
||||
: "r" (curbyte), "x" (port), "r" (maskhi), "r" (masklo)
|
||||
);
|
||||
}
|
||||
|
||||
SREG=sreg_prev;
|
||||
}
|
@ -1,98 +0,0 @@
|
||||
/*
|
||||
* light weight WS2812 lib include
|
||||
*
|
||||
* Version 2.3 - Nev 29th 2015
|
||||
* Author: Tim (cpldcpu@gmail.com)
|
||||
*
|
||||
* Please do not change this file! All configuration is handled in "ws2812_config.h"
|
||||
*
|
||||
* License: GNU GPL v2+ (see License.txt)
|
||||
+
|
||||
*/
|
||||
|
||||
#ifndef LIGHT_WS2812_H_
|
||||
#define LIGHT_WS2812_H_
|
||||
|
||||
#include "ws2812_config.h"
|
||||
#include <avr/io.h>
|
||||
#include <avr/interrupt.h>
|
||||
|
||||
///////////////////////////////////////////////////////////////////////
|
||||
// Define Reset time in µs.
|
||||
//
|
||||
// This is the time the library spends waiting after writing the data.
|
||||
//
|
||||
// WS2813 needs 300 µs reset time
|
||||
// WS2812 and clones only need 50 µs
|
||||
//
|
||||
///////////////////////////////////////////////////////////////////////
|
||||
#if !defined(ws2812_resettime)
|
||||
#define ws2812_resettime 300
|
||||
#endif
|
||||
|
||||
///////////////////////////////////////////////////////////////////////
|
||||
// Define I/O pin
|
||||
///////////////////////////////////////////////////////////////////////
|
||||
#if !defined(ws2812_port)
|
||||
#define ws2812_port B // Data port
|
||||
#endif
|
||||
|
||||
#if !defined(ws2812_pin)
|
||||
#define ws2812_pin 0 // Data out pin
|
||||
#endif
|
||||
|
||||
/*
|
||||
* Structure of the LED array
|
||||
*
|
||||
* cRGB: RGB for WS2812S/B/C/D, SK6812, SK6812Mini, SK6812WWA, APA104, APA106
|
||||
* cRGBW: RGBW for SK6812RGBW
|
||||
*/
|
||||
|
||||
struct cRGB { uint8_t g; uint8_t r; uint8_t b; };
|
||||
struct cRGBW { uint8_t g; uint8_t r; uint8_t b; uint8_t w;};
|
||||
|
||||
|
||||
|
||||
/* User Interface
|
||||
*
|
||||
* Input:
|
||||
* ledarray: An array of GRB data describing the LED colors
|
||||
* number_of_leds: The number of LEDs to write
|
||||
* pinmask (optional): Bitmask describing the output bin. e.g. _BV(PB0)
|
||||
*
|
||||
* The functions will perform the following actions:
|
||||
* - Set the data-out pin as output
|
||||
* - Send out the LED data
|
||||
* - Wait 50µs to reset the LEDs
|
||||
*/
|
||||
|
||||
void ws2812_setleds (struct cRGB *ledarray, uint16_t number_of_leds);
|
||||
void ws2812_setleds_pin (struct cRGB *ledarray, uint16_t number_of_leds,uint8_t pinmask);
|
||||
void ws2812_setleds_rgbw(struct cRGBW *ledarray, uint16_t number_of_leds);
|
||||
|
||||
/*
|
||||
* Old interface / Internal functions
|
||||
*
|
||||
* The functions take a byte-array and send to the data output as WS2812 bitstream.
|
||||
* The length is the number of bytes to send - three per LED.
|
||||
*/
|
||||
|
||||
void ws2812_sendarray (uint8_t *array,uint16_t length);
|
||||
void ws2812_sendarray_mask(uint8_t *array,uint16_t length, uint8_t pinmask);
|
||||
|
||||
|
||||
/*
|
||||
* Internal defines
|
||||
*/
|
||||
#if !defined(CONCAT)
|
||||
#define CONCAT(a, b) a ## b
|
||||
#endif
|
||||
|
||||
#if !defined(CONCAT_EXP)
|
||||
#define CONCAT_EXP(a, b) CONCAT(a, b)
|
||||
#endif
|
||||
|
||||
#define ws2812_PORTREG CONCAT_EXP(PORT,ws2812_port)
|
||||
#define ws2812_DDRREG CONCAT_EXP(DDR,ws2812_port)
|
||||
|
||||
#endif /* LIGHT_WS2812_H_ */
|
Binary file not shown.
@ -1,34 +0,0 @@
|
||||
/*
|
||||
* light_ws2812_config.h
|
||||
*
|
||||
* v2.4 - Nov 27, 2016
|
||||
*
|
||||
* User Configuration file for the light_ws2812_lib
|
||||
*
|
||||
*/
|
||||
|
||||
|
||||
#ifndef WS2812_CONFIG_H_
|
||||
#define WS2812_CONFIG_H_
|
||||
|
||||
///////////////////////////////////////////////////////////////////////
|
||||
// Define Reset time in µs.
|
||||
//
|
||||
// This is the time the library spends waiting after writing the data.
|
||||
//
|
||||
// WS2813 needs 300 µs reset time
|
||||
// WS2812 and clones only need 50 µs
|
||||
//
|
||||
///////////////////////////////////////////////////////////////////////
|
||||
|
||||
#define ws2812_resettime 300
|
||||
|
||||
///////////////////////////////////////////////////////////////////////
|
||||
// Define I/O pin
|
||||
///////////////////////////////////////////////////////////////////////
|
||||
|
||||
|
||||
#define ws2812_port B // Data port
|
||||
#define ws2812_pin 4 // Data out pin
|
||||
|
||||
#endif /* WS2812_CONFIG_H_ */
|
@ -1,40 +0,0 @@
|
||||
# Makefile to build light_ws2812 library examples
|
||||
# This is not a very good example of a makefile - the dependencies do not work, therefore everything is rebuilt every time.
|
||||
|
||||
# Change these parameters for your device
|
||||
|
||||
F_CPU = 16000000
|
||||
# DEVICE = attiny85
|
||||
DEVICE = atmega168p
|
||||
#
|
||||
# Tools:
|
||||
CC = avr-gcc
|
||||
|
||||
LIB = light_ws2812
|
||||
EXAMPLES = RGB_blinky RGBW_blinky Chained_writes Rainbow
|
||||
DEP = ws2812_config.h Light_WS2812/light_ws2812.h
|
||||
|
||||
CFLAGS = -g2 -I. -ILight_WS2812 -mmcu=$(DEVICE) -DF_CPU=$(F_CPU)
|
||||
CFLAGS+= -Os -ffunction-sections -fdata-sections -fpack-struct -fno-move-loop-invariants -fno-tree-scev-cprop -fno-inline-small-functions
|
||||
CFLAGS+= -Wall -Wno-pointer-to-int-cast
|
||||
#CFLAGS+= -Wa,-ahls=$<.lst
|
||||
|
||||
LDFLAGS = -Wl,--relax,--section-start=.text=0,-Map=main.map
|
||||
|
||||
all: $(EXAMPLES)
|
||||
|
||||
$(LIB): $(DEP)
|
||||
@echo Building Library
|
||||
@$(CC) $(CFLAGS) -o Objects/$@.o -c Light_WS2812/$@.c
|
||||
|
||||
$(EXAMPLES): $(LIB)
|
||||
@echo Building $@
|
||||
@$(CC) $(CFLAGS) -o Objects/$@.o Examples/$@.c Light_WS2812/$^.c
|
||||
@avr-size Objects/$@.o
|
||||
@avr-objcopy -j .text -j .data -O ihex Objects/$@.o $@.hex
|
||||
@avr-objdump -d -S Objects/$@.o >Objects/$@.lss
|
||||
|
||||
.PHONY: clean
|
||||
|
||||
clean:
|
||||
rm -f *.hex Objects/*.o Objects/*.lss
|
@ -1 +0,0 @@
|
||||
empty
|
42
main.c
42
main.c
@ -1,42 +0,0 @@
|
||||
#define F_CPU 1000000UL
|
||||
|
||||
#include<util/delay.h>
|
||||
#include<avr/io.h>
|
||||
#include"fix_fft.h"
|
||||
#include"avr_adc.h"
|
||||
#include"light_ws2812_AVR/Light_WS2812/ws2812_config.h"
|
||||
#include"light_ws2812_AVR/Light_WS2812/light_ws2812.h"
|
||||
|
||||
|
||||
#define STARTADC ADCSRA |= _BS(ADSC)
|
||||
#define PB_mic PB0
|
||||
|
||||
int main (void)
|
||||
{
|
||||
int i;
|
||||
char sample[128];
|
||||
char im[128];
|
||||
struct cRGB led_bar1[1];
|
||||
//DDRB = (1<<mic);//would be setting output, default is input so no need for setting
|
||||
//setupADC();
|
||||
|
||||
while(1)
|
||||
{
|
||||
//######RECORD SAMPLES#######
|
||||
/*for(i=0;i<128;i++)
|
||||
{
|
||||
sample[i] = ADCH; //read Analog value register 8bit
|
||||
im[i]=0; //pseudo data for funciton
|
||||
}*/
|
||||
//fix_fft(sample,im,7,0);//im[i] is always zero
|
||||
led_bar1[0].r=0;led_bar1[0].g=100;led_bar1[0].b=10;
|
||||
ws2812_setleds(led_bar1,1);
|
||||
|
||||
_delay_ms(500);
|
||||
led_bar1[0].r=255;led_bar1[0].g=0;led_bar1[0].b=10;
|
||||
ws2812_setleds(led_bar1,1);
|
||||
_delay_ms(500);
|
||||
}
|
||||
|
||||
return 0;
|
||||
}
|
223
makefile
223
makefile
@ -1,223 +0,0 @@
|
||||
# Hey Emacs, this is a -*- makefile -*-
|
||||
|
||||
# AVR-GCC Makefile template, derived from the WinAVR template (which
|
||||
# is public domain), believed to be neutral to any flavor of "make"
|
||||
# (GNU make, BSD make, SysV make)
|
||||
|
||||
|
||||
MCU = attiny85
|
||||
FORMAT = ihex
|
||||
TARGET = main
|
||||
SRC = $(TARGET).c avr_adc.c fix_fft.c light_ws2812_AVR/Light_WS2812/light_ws2812.c
|
||||
ASRC =
|
||||
OPT = s
|
||||
|
||||
# Name of this Makefile (used for "make depend").
|
||||
MAKEFILE = Makefile
|
||||
|
||||
# Debugging format.
|
||||
# Native formats for AVR-GCC's -g are stabs [default], or dwarf-2.
|
||||
# AVR (extended) COFF requires stabs, plus an avr-objcopy run.
|
||||
DEBUG = stabs
|
||||
|
||||
# Compiler flag to set the C Standard level.
|
||||
# c89 - "ANSI" C
|
||||
# gnu89 - c89 plus GCC extensions
|
||||
# c99 - ISO C99 standard (not yet fully implemented)
|
||||
# gnu99 - c99 plus GCC extensions
|
||||
CSTANDARD = -std=gnu99
|
||||
|
||||
# Place -D or -U options here
|
||||
CDEFS = -DF_CPU=1000000UL
|
||||
|
||||
# Place -I options here
|
||||
CINCS =
|
||||
|
||||
|
||||
CDEBUG = -g$(DEBUG)
|
||||
CWARN = -Wall -Wstrict-prototypes
|
||||
CTUNING = -funsigned-char -funsigned-bitfields -fpack-struct -fshort-enums
|
||||
#CEXTRA = -Wa,-adhlns=$(<:.c=.lst)
|
||||
CFLAGS = $(CDEBUG) $(CDEFS) $(CINCS) -O$(OPT) $(CWARN) $(CSTANDARD) $(CEXTRA)
|
||||
|
||||
|
||||
#ASFLAGS = -Wa,-adhlns=$(<:.S=.lst),-gstabs
|
||||
|
||||
|
||||
#Additional libraries.
|
||||
|
||||
# Minimalistic printf version
|
||||
PRINTF_LIB_MIN = -Wl,-u,vfprintf -lprintf_min
|
||||
|
||||
# Floating point printf version (requires MATH_LIB = -lm below)
|
||||
PRINTF_LIB_FLOAT = -Wl,-u,vfprintf -lprintf_flt
|
||||
|
||||
PRINTF_LIB =
|
||||
|
||||
# Minimalistic scanf version
|
||||
SCANF_LIB_MIN = -Wl,-u,vfscanf -lscanf_min
|
||||
|
||||
# Floating point + %[ scanf version (requires MATH_LIB = -lm below)
|
||||
SCANF_LIB_FLOAT = -Wl,-u,vfscanf -lscanf_flt
|
||||
|
||||
SCANF_LIB =
|
||||
|
||||
MATH_LIB = -lm
|
||||
|
||||
# External memory options
|
||||
|
||||
# 64 KB of external RAM, starting after internal RAM (ATmega128!),
|
||||
# used for variables (.data/.bss) and heap (malloc()).
|
||||
#EXTMEMOPTS = -Wl,--section-start,.data=0x801100,--defsym=__heap_end=0x80ffff
|
||||
|
||||
# 64 KB of external RAM, starting after internal RAM (ATmega128!),
|
||||
# only used for heap (malloc()).
|
||||
#EXTMEMOPTS = -Wl,--defsym=__heap_start=0x801100,--defsym=__heap_end=0x80ffff
|
||||
|
||||
EXTMEMOPTS =
|
||||
|
||||
#LDMAP = $(LDFLAGS) -Wl,-Map=$(TARGET).map,--cref
|
||||
LDFLAGS = $(EXTMEMOPTS) $(LDMAP) $(PRINTF_LIB) $(SCANF_LIB) $(MATH_LIB)
|
||||
|
||||
|
||||
# Programming support using avrdude. Settings and variables.
|
||||
|
||||
AVRDUDE_PROGRAMMER = arduino#usbasp
|
||||
#AVRDUDE_PORT = /dev/term/a
|
||||
|
||||
AVRDUDE_WRITE_FLASH = -U flash:w:$(TARGET).hex
|
||||
#AVRDUDE_WRITE_EEPROM = -U eeprom:w:$(TARGET).eep
|
||||
|
||||
|
||||
# Uncomment the following if you want avrdude's erase cycle counter.
|
||||
# Note that this counter needs to be initialized first using -Yn,
|
||||
# see avrdude manual.
|
||||
#AVRDUDE_ERASE_COUNTER = -y
|
||||
|
||||
# Uncomment the following if you do /not/ wish a verification to be
|
||||
# performed after programming the device.
|
||||
#AVRDUDE_NO_VERIFY = -V
|
||||
|
||||
# Increase verbosity level. Please use this when submitting bug
|
||||
# reports about avrdude. See <http://savannah.nongnu.org/projects/avrdude>
|
||||
# to submit bug reports.
|
||||
#AVRDUDE_VERBOSE = -v -v
|
||||
|
||||
AVRDUDE_BASIC = -p $(MCU) -c $(AVRDUDE_PROGRAMMER) -B4
|
||||
AVRDUDE_FLAGS = $(AVRDUDE_BASIC) $(AVRDUDE_NO_VERIFY) $(AVRDUDE_VERBOSE) $(AVRDUDE_ERASE_COUNTER)
|
||||
|
||||
|
||||
CC = avr-gcc
|
||||
OBJCOPY = avr-objcopy
|
||||
OBJDUMP = avr-objdump
|
||||
SIZE = avr-size
|
||||
NM = avr-nm
|
||||
AVRDUDE = avrdude
|
||||
REMOVE = rm -f
|
||||
MV = mv -f
|
||||
|
||||
# Define all object files.
|
||||
OBJ = $(SRC:.c=.o) $(ASRC:.S=.o)
|
||||
|
||||
# Define all listing files.
|
||||
LST = $(ASRC:.S=.lst) $(SRC:.c=.lst)
|
||||
|
||||
# Combine all necessary flags and optional flags.
|
||||
# Add target processor to flags.
|
||||
ALL_CFLAGS = -mmcu=$(MCU) -I. $(CFLAGS)
|
||||
ALL_ASFLAGS = -mmcu=$(MCU) -I. -x assembler-with-cpp $(ASFLAGS)
|
||||
|
||||
|
||||
# Default target.
|
||||
all: build
|
||||
|
||||
build: elf hex eep
|
||||
|
||||
elf: $(TARGET).elf
|
||||
hex: $(TARGET).hex
|
||||
eep: $(TARGET).eep
|
||||
lss: $(TARGET).lss
|
||||
sym: $(TARGET).sym
|
||||
|
||||
|
||||
# Program the device.
|
||||
program: $(TARGET).hex $(TARGET).eep
|
||||
$(AVRDUDE) $(AVRDUDE_FLAGS) $(AVRDUDE_WRITE_FLASH) $(AVRDUDE_WRITE_EEPROM)
|
||||
|
||||
|
||||
|
||||
|
||||
# Convert ELF to COFF for use in debugging / simulating in AVR Studio or VMLAB.
|
||||
COFFCONVERT=$(OBJCOPY) --debugging \
|
||||
--change-section-address .data-0x800000 \
|
||||
--change-section-address .bss-0x800000 \
|
||||
--change-section-address .noinit-0x800000 \
|
||||
--change-section-address .eeprom-0x810000
|
||||
|
||||
|
||||
coff: $(TARGET).elf
|
||||
$(COFFCONVERT) -O coff-avr $(TARGET).elf $(TARGET).cof
|
||||
|
||||
|
||||
extcoff: $(TARGET).elf
|
||||
$(COFFCONVERT) -O coff-ext-avr $(TARGET).elf $(TARGET).cof
|
||||
|
||||
|
||||
.SUFFIXES: .elf .hex .eep .lss .sym
|
||||
|
||||
.elf.hex:
|
||||
$(OBJCOPY) -O $(FORMAT) -R .eeprom $< $@
|
||||
|
||||
.elf.eep:
|
||||
-$(OBJCOPY) -j .eeprom --set-section-flags=.eeprom="alloc,load" \
|
||||
--change-section-lma .eeprom=0 -O $(FORMAT) $< $@
|
||||
|
||||
# Create extended listing file from ELF output file.
|
||||
.elf.lss:
|
||||
$(OBJDUMP) -h -S $< > $@
|
||||
|
||||
# Create a symbol table from ELF output file.
|
||||
.elf.sym:
|
||||
$(NM) -n $< > $@
|
||||
|
||||
|
||||
|
||||
# Link: create ELF output file from object files.
|
||||
$(TARGET).elf: $(OBJ)
|
||||
$(CC) $(ALL_CFLAGS) $(OBJ) --output $@ $(LDFLAGS)
|
||||
|
||||
|
||||
# Compile: create object files from C source files.
|
||||
.c.o:
|
||||
$(CC) -c $(ALL_CFLAGS) $< -o $@
|
||||
|
||||
|
||||
# Compile: create assembler files from C source files.
|
||||
.c.s:
|
||||
$(CC) -S $(ALL_CFLAGS) $< -o $@
|
||||
|
||||
|
||||
# Assemble: create object files from assembler source files.
|
||||
.S.o:
|
||||
$(CC) -c $(ALL_ASFLAGS) $< -o $@
|
||||
|
||||
|
||||
|
||||
# Target: clean project.
|
||||
clean:
|
||||
$(REMOVE) $(TARGET).hex $(TARGET).eep $(TARGET).cof $(TARGET).elf \
|
||||
$(TARGET).map $(TARGET).sym $(TARGET).lss \
|
||||
$(OBJ) $(LST) $(SRC:.c=.s) $(SRC:.c=.d)
|
||||
|
||||
depend:
|
||||
if grep '^# DO NOT DELETE' $(MAKEFILE) >/dev/null; \
|
||||
then \
|
||||
sed -e '/^# DO NOT DELETE/,$$d' $(MAKEFILE) > \
|
||||
$(MAKEFILE).$$$$ && \
|
||||
$(MV) $(MAKEFILE).$$$$ $(MAKEFILE); \
|
||||
fi
|
||||
echo '# DO NOT DELETE THIS LINE -- make depend depends on it.' \
|
||||
>> $(MAKEFILE); \
|
||||
$(CC) -M -mmcu=$(MCU) $(CDEFS) $(CINCS) $(SRC) $(ASRC) >> $(MAKEFILE)
|
||||
|
||||
.PHONY: all build elf hex eep lss sym program coff extcoff clean depend
|
BIN
micronucleus
BIN
micronucleus
Binary file not shown.
Loading…
Reference in New Issue
Block a user