ATtiny13 Basics – LED dimmen met PWM

In dit voorbeeld gaan we een LEDje laten dimmen op de ATtiny13.

Sluit het ledje aan volgens onderstaand schema (in dit schema is ook de bedrading voor het programmeren via de ISP meegenomen):
Let op: Het weerstandje is belangrijk, deze beperkt de stroom door de LED, als je deze niet gebruikt gaat het LEDje (snel) stuk!

Arduino ATtiny LED PWM layout

De code om de LED te laten in- en uit-faden met een loop (ipv een potmeter) heb ik aangepast van adnbr@Github:

Orginele code

Bron adnbr@github

Toelichting (eng)

I want to use an ATtiny13 to control the brightness of an LED light source (as a controller for this) and therefore need to control both the ADC input and the PWM output. This example is very simple, but will hopefully serve as a jumping off point for people new to the ADC and PWM systems in AVR microcontrollers.

First let’s take a look at a basic overview of the circuit we are using:

attiny13 adc pwm

It’s very simple, and it’s certainly not going to win any awards for style or efficiency. There are spare pins left over which could be utilised elsewhere should the need arise – in the microscope board I’ve broken these out into an extra header.

From the schematic we can see that the PWM output to the LED will be on pin 6 (PB1) and the ADC input we are using is on pin 7 (ADC1, PB2).

Setup the ADC

Selecting the ADC input is easy – look at Table 14.3 on page 92 of the datasheet for the correct mux settings.

Once we’ve selected the ADC channel and set the result to be left adjusted (more on that later) we set the prescaler for the ADC clock relative to the system clock and enable the system. Table 14.4 on page 93 has the values for the prescaler selection.

Put simply the prescaler divides the system clock speed the amount prescribed by the table – the ideal ADC clock speed is between 50 kHz and 200 kHz for the full 10 bits of resolution. The faster the clock, the faster the conversion takes place.

In our case the system clock is 9.6 MHz divided by 8 to achieve an ADC clock running at 75 kHz.

Let’s quickly package this up into a method we can call from the start of the main loop and move on to making a reading.

ADLAR, or how to achieve 10 bit results

The PWM module is only capable of 8-bit resolution, so why bother reading a full 10-bit ADC value? The ADLAR bit in the ADMUX register rearranges the results register (see page 93 again) to let you discard the lowest two bits of information by reading the ADCH result register.

If you do want 10-bit resolution, do not set the ADLAR bit and instead of reading ADCHyou should read ADC.

Make a reading

We have to wait for a conversion to finish before we can read it – here I’m going to use a busy wait loop which continually checks for the ADSC bit in the ADCSRA register to be cleared but there is also the facility to have an interrupt thrown when the ADC has completed a conversion. I will write about that at a later date.

Each conversion takes 13 ADC clock cycles (bar the first one, which takes 25.) Once the conversion is completed we need to grab the result from the result register, ADCH.

Starting a new conversion is as easy as setting the ADSC bit. And reading a 10 bit result (if you want it that is, see the section above about ADLAR) is remarkably simple – a preprocessor macro built into the avr-gcc libraries provides the helpful ADC pseudo-register that can be used to obtain the full 10 bit value.

So far…

We have a way to read the value of the ADC pin, but we can’t really do anything useful with the data we get. Here’s what we’ve got so far:

Setting up the PWM

If you are unsure as to what pulse width modulation is I suggest you find out before continuing onwards.

In the circuit we are running here it is possible to simply connect the LED directly to the pin with an appropriate resistor to ground, and the pin will run it. For the microscope project we will be using a MOSFET to allow the passing of more current, but for this experimental purpose the LED will do perfectly.

Before we get ahead of ourselves though, let’s find out a bit about the ATTiny13’s PWM functionality.

OCOA and OCOB

This AVR microcontroller has two channels with 8-bit PWM capability – PB0/OCOA (pin 5) and PB1/OCOB (pin 6), both running from Timer 0.

Just like the ADC there is a prescaler that adjusts how fast Timer 0 counts relative to the system clock speed. Controlled by the TCCR0B register this prescaler determines the maximum frequency of the PWM signal later on, according to this equation –

attiny pwm formule

Where P is the prescaler factor, and M depends on the PWM mode you choose – it is either 256 (Fast PWM) or 512 (Phase Correct PWM.) We will be using the “Fast” mode, which counts from 0 to 255 repeatedly to give a frequency of 4.7 kHz – more than fast enough to avoid eye-strain-inducing flicker.

Fast PWM Mode

Change the timer to Fast PWM mode by selecting the appropriate bits from Table 11.8, and tell it to set the output value low (clear the bit) when the timer equals the value of OCR0B.

To explain what is actually happening here, take a look at the graphic below. The black sawtooth line is the value of the Timer 0 counter which counts to 255 then resets to 0. If we set the PWM value to reasonably high, say 200 (the red horizontal line) then the PWM output will be equivalent to the red square wave below. As the output is high the majority of the time the LED will be quite bright.

Conversely if we set the PWM value to quite low (the yellow horizontal line) then the PWM output will change accordingly and the LED will be quite dim. Try to imagine each section of the sawtooth occuring in approximately 200 μs.

pwm gif

To then actually set the PWM duty cycle it is a matter of assigning a value to the OCR0Bregister.

Now would be a good time to package all the PWM setup code into its own method. I’ll leave that up to you as we move on to combining the ADC and PWM. Remember to set the LED pin, PB1 as an output.

oscilloscoop pwm meting

ADC and PWM together, in harmony

The ADC is set up, the PWM is ready to go and to get one talk to the other is as simple as just copying a value across:

It’s as simple as that. You may find you need to do some form of filtering to the ADC value, especially if the analog portion of your circuit is quite noisy, or perhaps there is a specific condition you want to fulfil before the PWM output is turned on. I’ll leave that up to you.

 

Bron: adnbr.co.uk