Descrição

Escreve um valor analógico (onda PWM) em um pino. Pode ser usado para acender um LED variando o brilho ou girar um motor a velocidade variável. Depois de realizar um analogWrite(), o pino vai gerar uma onda quadrada estável com o ciclo de rendimento especificado até que o próximo analogWrite() seja realizado (ou que seja realizado um digitalRead() ou digitalWrite() no mesmo pino). A freqüência do sinal PWM é de aproximadamente 490Hz.

Nas novas placas Arduino (incluindo o Mini e o BT) com o chip ATmega168 esta função é eficiente nos pinos 3,5,6,9,10 e 11. Placas Arduino mais antigas com um ATmega8 suportam o analogWrite() apenas nos pinos 9,10 e 11.

Sintaxe

analogWrite(pin, valor)

Parâmetros

pin: o pino no qual se deseja escrever

valor: o rendimento do ciclo: entre 0 (sempre desligado) e 255 (sempre ligado).

Retorno

nenhum

Notas e problemas conhecidos

Não é necessário realizar um pinMode() para pré-determinar o comportamento do pino como saída antes de realizar um analogWrite().

As saídas PWM geradas pelos pinos 5 e 6 terão rendimento de ciclo acima do esperado. Isto se deve às interações com as funções millis() e delay(), que compartilham o mesmo temporizador interno usado para gerar as saídas PWM.

Exemplo

Torna o brilho de um LED proporcional ao valor lido em um potenciómetro.

 
int ledPin = 9; // LED conectado ao pino digital 9
int analogPin = 3; // potentiómetro conectado ao pino analógico 3
int val = 0; // variável para armazenar o valor lido

void setup()
{
pinMode(ledPin, OUTPUT); // pré-determina o pino como saída
}

void loop()
{
val = analogRead(analogPin); // lê o pino de entrada
analogWrite(ledPin, val / 4); // os valores do analogRead variam de 0 a 1023, os valores do analogWrite variam de 0 a 255

}

See also

 

Página de início da referência

Correções, sugestões, e nova documentação devem ser enviadas ao Forum.

O texto de referência do Arduino está baixo uma Licença Creative Commons Attribution-ShareAlike 3.0. Amostras de código utilizadas na referência foram deixados  ao domínio público.

 

O conteúdo desta página é uma tradução para o português a partir do site original do Arduino.

Esta obra está sob uma Licença Creative Commons.

Creative Commons License