avareza - Online na nuvem

PROGRAMA:

NOME

avarice - Fornece uma interface do avr-gdb para a caixa JTAGICE da Atmel.

SINOPSE

avareza [OPÇÕES] ... [[NOME DE ANFITRIÃO]:PORT]

DESCRIÇÃO

AVaRICE é executado em uma máquina POSIX e se conecta ao gdb por meio de um soquete TCP e se comunica via
"protocolo de depuração serial" do gdb. Este protocolo permite que o gdb envie comandos como "definir / remover
ponto de interrupção "e" memória de leitura / gravação ".

AVaRICE traduz esses comandos para o protocolo Atmel usado para controlar o AVR JTAG
GELO. A conexão ao AVR JTAG ICE é feita por meio de uma porta serial na máquina POSIX.

Como a conexão GDB <---> AVaRICE é feita por meio de um soquete TCP, os dois programas não precisam
para rodar na mesma máquina. Em um ambiente de escritório, isso permite que um desenvolvedor depure um
alvo no laboratório do conforto de seu cubo (ou ainda melhor, de sua casa!)

NOTA: Mesmo que você possa correr avareza e avr-gdb em sistemas diferentes, não é
recomendado devido ao risco de segurança envolvido. avareza não foi projetado para ser um
servidor seguro. Não há autenticação realizada quando um cliente se conecta ao
avareza quando está sendo executado no modo de servidor gdb.

Suportado Dispositivos/Instrumentos
avareza atualmente oferece suporte para os seguintes dispositivos:
at90can128
at90can32 (o)
at90can64 (o)
at90pwm2 (o) (+)
at90pwm216 (o) (+)
at90pwm2b (o) (+)
at90pwm3 (o) (+)
at90pwm316 (o) (+)
at90pwm3b (o) (+)
at90usb1287 (o)
at90usb162 (o) (+)
at90usb646 (o)
at90usb647 (o)
atmega128
atmega1280 (o)
atmega1281 (o)
atmega1284p (o)
atmega128rfa1 (o)
atmega16
atmega162
atmega164p (o)
atmega165 (o)
atmega165p (o)
atmega168 (o) (+)
atmega168p (o) (+)
atmega169
atmega16hva (o)
atmega16m1 (o) (+)
atmega2560 (o)
atmega2561 (o)
atmega32
atmega323
atmega324p (o)
atmega325 (o)
atmega3250 (o)
atmega3250p (o)
atmega325p (o)
atmega328p (o) (+)
atmega329 (o)
atmega3290 (o)
atmega3290p (o)
atmega329p (o)
atmega32c1 (o) (+)
atmega32hvb (o) (+)
atmega32m1 (o) (+)
atmega32u4 (o)
atmega406 (o)
atmega48 (o) (+)
atmega48p (o) (+)
atmega64
atmega640 (o)
atmega644 (o)
atmega644p (o)
atmega645 (o)
atmega6450 (o)
atmega649 (o)
atmega6490 (o)
atmega64c1 (o) (+)
atmega64m1 (o) (+)
atmega88 (o) (+)
atmega88p (o) (+)
attiny13 (o) (+)
attiny167 (o) (+)
attiny2313 (o) (+)
attiny24 (o) (+)
attiny25 (o) (+)
attiny261 (o) (+)
attiny4313 (o) (+)
attiny43u (o) (+)
attiny44 (o) (+)
attiny45 (o) (+)
attiny461 (o) (+)
attiny48 (o) (+)
attiny84 (o) (+)
attiny85 (o) (+)
attiny861 (o) (+)
attiny88 (o) (+)
atxmega128a1 (o) (*)
atxmega128a1revd (o) (*)
atxmega128a3 (o) (*)
atxmega32a4 (o) (*)
atxmega16d4 (o) (*)
atxmega128b1 (o) (*)
atxmega128b3 (o) (*)
atxmega64b1 (o) (*)
atxmega64b3 (o) (*)

o - Suportado apenas pelo dispositivo JTAG ICE mkII e AVR Dragon.
* - Dispositivo Xmega, requer versão de firmware de pelo menos 7.x (fornecido com AVR Studio 5)
+ - debugWire, veja abaixo

Suportado Envie o Formatos
avareza usa libbfd para ler arquivos de entrada. Como tal, pode lidar com qualquer formato de arquivo que
conhecido sobre libbfd. Isso inclui os formatos Intel Hex, Motorola SRecord e ELF, entre
outros. Se você contar avareza para ler um arquivo ELF, ele lidará automaticamente com a programação
todas as seções contidas no arquivo (por exemplo, flash, eeprom, etc.).

OPÇÕES

-h, --Socorro
Imprima esta mensagem.

-1, --mkI
Conecte ao JTAG ICE mkI (padrão).

-2, --mkII
Conecte-se ao JTAG ICE mkII.

-3, --jtag3
Conecte-se ao JTAGICE3.

-B, --jtag-taxa de bits
Defina a taxa de bits que a caixa JTAG se comunica com o dispositivo AVR alvo. Esse
deve ser inferior a 1/4 da frequência do alvo. Os valores válidos são 1 MHz, 500
kHz, 250 kHz ou 125 kHz para o JTAG ICE mkI, qualquer coisa entre 22 kHz por meio
aproximadamente 6400 kHz para o JTAG ICE mkII. (padrão: 250 kHz)

-C, --capturar
Capture programa em execução.
Nota: a depuração deve ter sido habilitada antes de iniciar o programa. (por exemplo, por
correndo avareza antes)

-c, --guirlanda de margaridas
Configure as informações de ligação em cadeia JTAG.
Quatro parâmetros separados por vírgula precisam ser fornecidos, correspondendo a unidades antes,
unidades depois de, pedaços antes e pedaços depois de.

-D, --separar
Desanexar uma vez sincronizado com JTAG ICE

-d, --depurar
Habilite a impressão de informações de depuração.

-e, --apagar
Apague o alvo. Não é possível no modo debugWire.

-E, --evento
Lista de eventos que não interrompem. Apenas JTAG ICE mkII e AVR Dragon. Predefinição
é "none, run, target_power_on, target_sleep, target_wakeup"

-f, --Arquivo
Especifique um arquivo para usar com as opções --program e --verify. Se --file for passado
e nem --program ou --verify são fornecidos então --program está implícito. NOTA:
recurso obsoleto, deve ser habilitado usando o --enable-target-programming
opção de configuração.

-g, --Dragão
Conecte-se a um AVR Dragon. Esta opção implica o -2 opção.

-I, --ignore-intr
Evite interrupções automaticamente.

-j, --jtag
Porta conectada à caixa JTAG (padrão: / dev / avrjtag). Se o JTAG_DEV ambiental
variável é definida, avarice irá usar isso como o padrão em vez disso.
If avareza foi configurado com suporte libusb, o JTAG ICE mkII pode ser
conectado por USB. Nesse caso, a corda usb é usado como o nome do
dispositivo. Se houver vários dispositivos JTAG ICE mkII conectados ao sistema
através de USB, esta string pode ser seguida pela (parte posterior do) serial do ICE
número, delimitado do usb por dois pontos.
O AVR Dragon e o JTAGICE3 só podem ser conectados via USB, então esta opção
o padrão é "usb" nesse caso.

-k, --dispositivos-conhecidos
Imprima uma lista de dispositivos conhecidos.

-L, --write-lockbits
Grave bits de bloqueio. Os dados do byte de bloqueio devem ser fornecidos em formato hexadecimal de dois dígitos
com preenchimento zero, se necessário.

-l, --read-lockbits
Leia os bits de bloqueio do destino. Os bits individuais também são exibidos com
nomes.

-P, --papel
Nome do dispositivo de destino (por exemplo, atmega16). Normalmente, avareza detecta automaticamente o dispositivo via
JTAG ou debugWIRE. Se esta opção for fornecida, ela substituirá o resultado do
autodetecção.

-p, --programa
Programe o alvo. O nome do arquivo binário deve ser especificado com a opção --file. NOTA:
recurso obsoleto, deve ser habilitado usando o --enable-target-programming
opção de configuração.

-R, --reset-srst
Aplique o sinal nSRST (reset externo) ao conectar. Isso pode substituir
aplicativos que definem o bit JTD.

-r, --read-fusíveis
Leia os bytes dos fusíveis.

-V, --versão
Imprima informações sobre a versão.

-v, --verificar
Verifique o programa no dispositivo em relação ao arquivo especificado com a opção --file. NOTA:
recurso obsoleto, deve ser habilitado usando o --enable-target-programming
opção de configuração.

-w, --debugwire
Conecte-se a JTAG ICE mkII, JTAGICE3 ou AVR Dragon, falando do protocolo debugWire para
o alvo. Esta opção implica o -2 opção. Consulte a seção DEBUGWIRE abaixo.

-W, --write-fusíveis
Escreve bytes de fusíveis. ee é o byte de fusível estendido, hh é o byte de fusível alto e ll is
o byte de fusível baixo. Os dados do byte do fusível devem ser fornecidos em formato hexadecimal de dois dígitos
com preenchimento zero, se necessário. Todos os três bytes devem ser fornecidos atualmente.
NOTA: Atual, se o dispositivo de destino não tiver um byte de fusível estendido (por exemplo, o
atmega16), você deve definir ee == ll ao escrever os bytes do fusível.

-x, --xmega
O dispositivo de destino é uma peça ATxmega, usando transporte JTAG. Já que o ATxmega usa
uma comunicação JTAG diferente de outros AVRs, a autodetecção normal do dispositivo
com base no ID JTAG não funciona. Se o dispositivo foi explicitamente selecionado
por meio da opção -P, não é necessário especificar também a opção -x.

-X, --pdi
O dispositivo de destino é uma peça ATxmega, usando transporte PDI.

NOME DE ANFITRIÃO o padrão é 0.0.0.0 (ouvir em qualquer interface) se não for fornecido.

:PORT é necessário para colocar a avareza no modo de servidor gdb.

EXEMPLO USO

avareza --erase --program --file test.bin --jtag / dev / ttyS0: 4242

Programe o arquivo teste.bin no JTAG ICE (mkI) conectado a / dev / ttyS0 após apagar
o dispositivo e, em seguida, escute no modo GDB na porta local 4242. Esta funcionalidade é
obsoleto e não é mais configurado por padrão. Em vez disso, use o comando "load" do GDB.

avareza --jtag usb: 1234 --mkII: 4242

Conecte ao JTAG ICE mkII conectado ao USB cujo número de série termina em 1234, E ouça
no modo GDB na porta local 4242.

DEPURAÇÃO COM AVAREZA

O ambiente de depuração JTAG ICE tem algumas restrições e mudanças:

· Sem pontos de interrupção "suaves" e apenas três pontos de interrupção de hardware. Os conjuntos de comandos de pausa
pontos de interrupção de hardware. A maneira mais fácil de lidar com essa restrição é habilitar e
desative os pontos de interrupção conforme necessário.

· Dois watchpoints de hardware de 1 byte (mas cada watchpoint de hardware tira um hardware
ponto de interrupção). Se você definir um ponto de controle em uma variável que leva mais de um byte,
a execução será terrivelmente lenta. Em vez disso, é melhor fazer o seguinte:

assistir * (char *) e minha variável

que observa o byte menos significativo de minha variável.

· Os processadores Atmel AVR têm uma arquitetura Harvard (código separado e barramentos de dados).
Para distinguir o endereço de dados 0 do endereço de código 0, avr-gdb adiciona 0x800000 a todos os dados
endereços. Tenha isso em mente ao examinar ponteiros impressos, ou ao passar absoluto
endereços para comandos gdb.

DEBUGWIRE

A debugWire protocol é um protocolo proprietário introduzido pela Atmel para permitir a depuração
pequenos controladores AVR que não oferecem pinos suficientes (e recursos de chip suficientes) para
implementar JTAG completo. A comunicação ocorre ao longo do /REDEFINIR pino que precisa ser
transformado em um pino de conexão debugWire programando o DWEN fusível (debugWire enable),
usando uma conexão de programador normal (programação no sistema, programação de alta tensão).
Observe que, ao ativar este fusível, a funcionalidade de redefinição padrão desse pino será
perdido, então qualquer programação no sistema deixará de funcionar, pois requer um funcional /REDEFINIR
alfinete. Portanto, deve ser feito absolutamente certo lá is a maneira em caminho duplo, como um dispositivo (como o
STK500, por exemplo) que pode lidar com a programação de alta tensão do AVR. Atualmente,
avareza não oferece a opção de desligar o fusível DWEN. Contudo, avrdude oferece a opção de
desligue-o através da programação de alta tensão ou usando o JTAG ICE mkII para
primeiro transforme o alvo em um modo compatível com o ISP e, em seguida, use os comandos normais do ISP para
alterar as configurações do fusível.
Observe que o ambiente debugWire é ainda mais limitado, em comparação com JTAG. Isso não
oferecem pontos de interrupção de hardware, portanto, todos os pontos de interrupção devem ser implementados como software
pontos de interrupção reescrevendo páginas flash usando QUEBRAR instruções. Alguns espaços de memória (fusível
e bits de bloqueio) não são acessíveis por meio do protocolo debugWire.

Use avareza online usando serviços onworks.net