Guia do Usuário do Software de Programação PEmicro PROGDSC

CPROGDSC é uma versão de linha de comando do Windows do software PROGDSC que programa Flash, EEPROM, EPROM, etc. através de uma interface de hardware PEmicro para um processador NXP DSC suportado. As interfaces de hardware estão disponíveis na PEmicro.

Uma vez que seu hardware de interface esteja conectado corretamente entre seu PC e o dispositivo de destino, você pode iniciar o executável CPROGDSC a partir da linha de comando. Além do executável, vários parâmetros de linha de comando também devem ser passados para configurar a qual interface de hardware PEmicro o CPROGDSC deve tentar se conectar e para configurar como essa interface de hardware se conectará ao dispositivo de destino. Esses parâmetros incluem o nome da configuração (.CFG) file, bem como comandos de inicialização, como o nome da interface de hardware ou a porta à qual a interface está conectada.

O .CFG file especifica como programar o destino como você pretende e inclui comandos de programação padrão e, opcionalmente, comandos de configuração. Os capítulos seguintes fornecerão uma explicação detalhada desses comandos e parâmetros.

Comece

Conecte a interface de hardware entre seu PC e o MCU de destino por meio do cabo de fita de depuração.
Inicie o software de programação executando-o no prompt de comando do Windows ou chamando o executável CPROGDSC com os parâmetros de linha de comando corretos. Os parâmetros de linha de comando permitidos são:

CPROGDSC [?/!] [filenome] [/PARAMn=s] [v] [reset_delay n] [bdm_speed n] [hideapp] [Interface=x] [porta=y] [showports] [-usebyteaddr][/logfile registrofilenome]

onde:

[?/!]
Use o '?' ou' '!' opção de caractere para fazer com que o programador de linha de comando espere e exiba o resultado da programação na janela PROGDSC. '?' sempre exibirá o resultado, '!' exibirá o resultado somente se ocorrer um erro. Se o usuário não usar um lote file para testar o nível de erro, isso fornece um método para exibir o resultado da programação. Esta opção deve ser a PRIMEIRA opção de linha de comando.

[filenome]
A file contendo comandos de programação e comentários, padrão = prog.cfg. Consulte a Seção 7 - Example Script de Programação File para um exampeu.
[/PARAMn=s]
Um parâmetro de linha de comando que pode modificar o script em execução substituindo especial tags (/PARAMn). Isso pode ser usado para substituir qualquer parte do script, incluindo comandos de programação, filenomes e parâmetros. Os valores válidos de n são 0..9. s é uma string que substituirá qualquer ocorrência de/PARAMn no script file. Seção 8 – Usar parâmetros de linha de comando em um script tem um example para uso.

[INTERFACE=x]
Onde x é um dos seguintes: (Veja exampseção de les)
- USB MULTILINK (Esta configuração também suporta OSBDM) CYCLONE
- PARALELO (porta paralela ou BDM Lightning [legado])
[PORTA=y]
Onde o valor de y é um dos seguintes (consulte o parâmetro de linha de comando showports para obter uma lista de hardware conectado; sempre especifique também o tipo de “interface”):
- USB x
  Onde x = 1,2,3 ou 4. Representa um número de enumeração para cada peça de hardware começando em 1. Útil se estiver tentando conectar a um produto Cyclone ou Multilink. Se apenas uma peça de hardware estiver conectada, ela sempre será enumerada como USB1.
  Um exampO arquivo para selecionar o primeiro Multilink encontrado é:
  INTERFACE=PORTA USBMULTILINK=USB1
- #.#.#.#
  Endereço IP Ethernet #.#.#.#. Cada símbolo # representa um número decimal entre 0 e 255. Válido para interfaces Cyclone e Tracelink.
  A conexão é via Ethernet.
  INTERFACE=CYCLONE PORTA=10.0.1.223
- NOME
  Alguns produtos, como o Cyclone e o Tracelink, suportam a atribuição de um nome à unidade, como “Joe's Max”. O ciclone pode ser referido por seu nome atribuído. Se houver espaços no nome, todo o parâmetro deve ser colocado entre aspas duplas (este é um requisito do Windows, não um requisito do PEmicro).
  Exampos:
  INTERFACE=PORTA DO CICLONE=MeuCyclone99
- ID ÚNICO
  Todos os produtos USB Multilink têm um número de série exclusivo atribuído a eles, como PE5650030. O Multilink pode ser referido a este número. Isso é útil no caso em que várias unidades estão conectadas ao mesmo PC.
  Exampos:
  INTERFACE=PORTA USBMULTILINK=PE5650030
- COMx
  Onde x = 1,2,3 ou 4. Representa um número de porta COM. Válido para interfaces Cyclone.
  Para se conectar a um Cyclone em COM1: INTERFACE=CYCLONE PORT=COM1
- x
  Onde x = 1,2,3 ou 4. Representa um número de porta paralela
  Para selecionar uma interface paralela na porta paralela nº 1: INTERFACE=PARALLEL PORT=1
- PCIx
  Onde x = 1,2,3 ou 4. Representa um número de cartão BDM Lightning. (Observação: este é um produto legado)
  Para selecionar um cabo paralelo no BDM Lightning #1:
  INTERFACE=PORTA PARALELA=PCI1
[showports]
O programador de linha de comando gera todas as portas disponíveis para um texto file e, em seguida, termina (independentemente de outros parâmetros de linha de comando). Esta saída de informação para o texto file inclui os parâmetros necessários para entrar em contato com o hardware de programação anexado, bem como uma descrição da interface do hardware. A saída padrão filenome é ports.txt e é criado na mesma pasta que CPROG.

A saída também pode ser direcionada para um file.

Examparquivo: SHOWPORTS=C:\MYPORTS.TXT
Esta lista não mostra as opções de porta paralela ou porta COM que também estão disponíveis. Abaixo está um examparquivo da saída para várias interfaces de hardware conectadas ao PC (observe que existem diferentes maneiras de endereçar a mesma unidade; os dados para cada interface podem ser seguidos por uma linha [DUPLICATE] que mostra um rótulo diferente para a mesma interface).

Saída de Showports Exampem:
INTERFACE=PORTA USBULTILINK=PE5650030;

USB 1: Multilink Universal FX Rev A (PE5650030)[PortNum=21]

INTERFACE=PORTA USBMULTILINK=USB1
USB 1: Multilink Universal FX Rev A (PE5650030)[PortNum=21][DUPLICADO]

INTERFACE=CYCLONE PORTA=10.0.9.197
; 10.0.9.197: Ciclone público [PortNum=61]
INTERFACE=CICLONE “PORTA=Ciclone Público”
; 10.0.9.197: ciclone público[PortNum=61][DUPLICATE]
INTERFACE=CICLONE “PORT=Ciclone do Joe”
; USB1: Cyclone (Joe's)[PortNum=101]
INTERFACE=CYCLONE PORTA=USB1
; USB1: Cyclone (Joe's)[PortNum=101][DUPLICATE]

[v] Isso faz com que o programador não verifique o intervalo de endereços de registro S antes de programar ou verificar. Isso agiliza o processo de programação. A opção deve ser usada com cuidado, pois todos os registros s fora do intervalo serão ignorados.

[reset_atraso n]
Especifica um atraso após o programador redefinir o destino que verificamos para ver se a peça entrou corretamente no modo de depuração em segundo plano. Isso é útil se o destino tiver um driver de reinicialização que mantém o MCU em reinicialização depois que o programador libera a linha de reinicialização. O valor n é um atraso em milissegundos.

[bdm_speed n] Esta opção permite ao usuário definir a velocidade do relógio de deslocamento BDM da interface de depuração do PEmicro. Este valor inteiro pode ser usado para determinar a velocidade das comunicações de acordo com as seguintes equações:

Multilink USB (inclui Universal): (1000000/(N+1)) Hz
FX universal multilink USB: (25000000/(N+1)) Hz
Ciclone ou Tracelink: (50000000/(2*N+5)) Hz

[ocultar aplicativo] Isso fará com que o programador de linha de comando não exiba uma presença visual durante a execução, exceto na barra de tarefas. Somente aplicativos de 32 bits!

[-usebyteaddr] Se o parâmetro opcional -usebyteaddr for especificado, os endereços no S19 S-Record serão tratados como endereços de byte. Se o parâmetro opcional -usebyteaddr for omitido, os endereços no S19 S-Record serão tratados como endereços de palavra.

[/registrofile registrofilenome]
Esta opção abre um logfile do nome “logfilenome” que fará com que qualquer informação escrita na janela de status também seja gravada nesta file. O
"registrofilename” deve ser um nome de caminho completo, como c:\mydir\mysubdir\mylog.log.

Linha de Comando Exampos:
CPROGDSC C:\ENGINE.CFG INTERFACE=PORTA USBMULTILINK=PE5650030

Abre o CPROGDSC com as seguintes opções:

Execute o script C:\ENGINE.CFG
A interface é a primeira USB Multilink Universal com número de série PE5650030
Frequência de comunicação de detecção automática (io_delay_cnt não definido)

CPROGDSC C:\ENGINE.CFG Interface=CICLONE Porta=209.61.110.251

Abre o CPROGDSC com as seguintes opções:

Execute o script C:\ENGINE.CFG
A interface é Cyclone Max através da porta Ethernet com um endereço IP de 209.61.110.251

CPROGDSC C:\ENGINE.CFG Interface=USBMULTILINK Porta=USB1

Abre o CPROGDSC com as seguintes opções:

Execute o script C:\ENGINE.CFG
A interface é USB Multilink Universal, primeira interface detectada.

Comandos de programação

Todos os comandos de programação começam com uma sequência de dois caracteres seguida por espaços em branco (em branco ou tabulações). As linhas que começam com caracteres que não são comandos são listadas como REMarks. O termo filenome significa um caminho DOS completo para um file. Os comandos usam os mesmos códigos de duas letras usados nos programadores interativos PROGDSC. O mesmo.DSP fileOs s usados pelo PROGDSC são usados para configurar um determinado dispositivo a ser programado. Se uma função de usuário for especificada para um determinado dispositivo, seu comando de dois caracteres e o significado ou user_par serão especificados no.DSP file.

Observação:
Os parâmetros de comando Starting_addr,ending_addr, base_addr, byte, word e user_par usam um formato hexadecimal padrão.

BM – Módulo de verificação em branco.
MUDAR n.nn – (Apenas Cyclone) Altere o volumetage fornecido ao alvo, onde n.nn representa um valor entre 0.00 e 5.00, inclusive. Quando o comando for executado, o Cyclone mudará imediatamente para aquele voltage. Se os relés Cyclone estiverem desligados antes de chamar este comando, os relés serão ligados e definirão o novo vol.tage valor quando este comando é executado. Note que muito baixo de um voltagO valor pode colocar o dispositivo no modo de baixo consumo de energia, o que pode causar a perda total da comunicação de depuração. Certifique-se de que as configurações do jumper do Cyclone estejam definidas corretamente para enviar a energia para as portas corretas.
EM – Apagar módulo.
PW Starting_addr palavra … palavra – Palavras do programa.
PM – Módulo de programa.
CM filenome base_addr – Escolha o módulo .DSP file. Nota: Certos módulos podem requerer a especificação de um endereço base.
VM – Verifique o módulo.
VR começando terminando – Verifique o alcance.
UM filenome – Módulo de carregamento.
UR começando terminando filenome - Faixa de upload.
SS filenome – Especifique o registro S.
SM início final – Mostrar módulo.
RELÉ DESLIGADO – (Apenas Multink FX e Cyclone) Desligue os relés que fornecem energia ao alvo, incluindo um atraso de desligamento, se especificado. Especialmente útil para usuários que desejam desligar e ligar sua placa antes de executar testes, permitir que seu gerenciador de inicialização seja executado ou que o código do aplicativo seja executado após a programação.
RELÉ – (Apenas Multink FX e Cyclone) Ligue os relés para fornecer energia ao alvo, incluindo um atraso de inicialização, se especificado. o voltage fornecido será baseado no último volumetage configuração especificada. Para usuários do Cyclone, o comando CHANGEV pode alterar o voltage valor. Especialmente útil para usuários que desejam desligar e ligar sua placa antes de executar testes, permitir que seu gerenciador de inicialização seja executado ou que o código do aplicativo seja executado após a programação.
HE – Ajuda (veja cprog.doc file).
QU - Desistir.
RE - Restaurar chip.
GO – Inicia o funcionamento do dispositivo. Pode ser usado como comando final se você quiser que o dispositivo seja executado para teste. Deve ser imediatamente precedido por um comando 'RE'.
Prazos DE – Atrasa “timeinms” milissegundos
xx usuário_par – Somente para função de usuário especificada em .DSP file.

Comandos de configuração para inicialização

Os comandos de configuração são todos processados antes que o programador tente contatar o alvo. toda a configuração file é analisado para esses comandos antes de tentar as comunicações. Esta seção dá umaview de usar esses comandos de configuração para fazer diferentes tipos de configuração.

Observação: A base padrão para parâmetros de comando de configuração é decimal.

Um fimview dos comandos de configuração é o seguinte:

DISPOSITIVO n
Determina o dispositivo de destino que está prestes a ser programado. Para obter uma lista de dispositivos suportados, você precisará executar o PROGDSC e consultar a lista suspensa Target CPU Information no PROGDSC Connection Manager. NOTA: Todos os .CFG files deve incluir este comando.

CUSTOMTRIMREF nnnnnnnn.nn
Frequência de clock de referência interna desejada para o “PT; Programa Trim” comando. Essa frequência substitui a frequência de clock de referência interna padrão. Os valores válidos para “n” dependem do dispositivo específico que está sendo programado. Consulte as especificações elétricas do seu dispositivo para obter uma faixa de relógio de frequência de referência interna válida. Onde:

nnnnnnnn.nn: Frequência em Hertz com duas casas decimais

ENERGIA DO DISPOSITIVO n
Para Cyclone (exclui Cyclone MAX). Esta configuração define o volume alvotage que será fornecido ao alvo se a fonte do voltage é derivado da energia interna do Cyclone. Os valores válidos de n são:

0: 5 volts, gerados/comutados por ciclone
2: 3 volts, gerados/comutados por ciclone
4: 2 volts, gerados/comutados por ciclone

FORNECER ENERGIA n
Determina se a interface deve fornecer energia ao alvo. NOTA: Nem todas as interfaces de hardware suportam este comando. Os valores válidos de n são:

0: A interface não fornece energia ao alvo. (padrão)
1: Ativar interface fornece energia ao alvo.

POWERDOWNDELAY n
Quantidade de tempo para atrasar quando a energia do alvo é desligada para que a fonte de alimentação do alvo caia abaixo de 0.1 V. n é o tempo em milissegundos.

POWERUPDELAY n
Quantidade de tempo de atraso quando a alimentação do destino é ligada OU o destino é redefinido e antes que o software tente falar com o destino. Esse tempo pode ser uma combinação de tempo de inicialização e tempo de redefinição (especialmente se um driver de redefinição for usado). n é o tempo em milissegundos.

POWEROFFONESIT n
Determina se a energia fornecida ao destino deve ser desligada quando o aplicativo CPROGDSC terminar. NOTA: Nem todas as interfaces de hardware suportam este comando. Os valores válidos de n são:

0: Desligue a energia ao sair (padrão)
1: Mantenha a energia ligada ao sair

SEM DIÁLOGOS DE ENERGIA
Não peça ao usuário para alternar a alimentação de destino e saia com erro se houver um problema ao entrar no modo de depuração.

Verificação encerradaview

Existem vários comandos disponíveis que podem ser usados para verificar o conteúdo do flash no dispositivo após programá-lo. O comando mais utilizado é “VC
;Verificar CRC do Objeto File ao Módulo”. O comando “VC” instruirá o CPROGDSC a primeiro calcular um valor CRC de 16 bits do objeto escolhido file. O CPROGDSC carregará o código na RAM do dispositivo e instruirá o dispositivo a calcular um valor CRC de 16 bits a partir do conteúdo em FLASH do dispositivo. Somente intervalos de endereços válidos no objeto file são calculados no dispositivo. Uma vez que o valor CRC de 16 bits do objeto file e o dispositivo estão disponíveis, o CPROGDSC os compara. Um erro é lançado se os dois valores não corresponderem.

Alternativamente, o comando “VM ;Verify Module” pode ser usado para realizar uma verificação byte a byte entre o objeto escolhido file e o dispositivo. Normalmente, o comando VM levará mais tempo para ser executado do que o comando VC, pois o CPROGDSC precisa ler o conteúdo do FLASH do dispositivo byte por byte. Existem também dois outros comandos que podem ser usados para verificação. O “SC ;Show Module CRC” instrui o CPROGDSC a carregar o código na RAM do dispositivo e instruir o dispositivo a calcular um valor CRC de 16 bits a partir do conteúdo de todo o FLASH do dispositivo, que inclui regiões em branco. Uma vez calculado o valor CRC de 16 bits, o CPROGDSC exibirá o valor na janela de status. O comando “VV ;Verify Module CRC to Value” é similar ao comando “SC”. A diferença é que, em vez de exibir o valor CRC de 16 bits calculado, o CPROGDSC irá comparar o valor calculado com um valor CRC de 16 bits fornecido pelo usuário.

Erros do DOS retornam

Os retornos de erro do DOS são fornecidos para que possam ser testados em .BAT files. Os códigos de erro usados são:

0 – Programa concluído sem erros.
1 – Cancelado pelo usuário.
2 – Erro na leitura do registro S file.
3 – Verifique o erro.
4 – Verificar cancelamento pelo usuário.
5 – Registro S file não está selecionado.
6 – Endereço inicial não está no módulo.
7 – O endereço final não está no módulo ou é menor que o endereço inicial.

8 – Incapaz de abrir file para carregar.
9 – File erro de gravação durante o upload.
10 – Upload cancelado pelo usuário.
11 – Erro ao abrir.DSP file.
12 – Erro na leitura.DSP file.
13 – O dispositivo não inicializou.
14 – Erro ao carregar.DSP file.
15 – Erro ao habilitar módulo recém selecionado.
16 – Registro S especificado file não encontrado.
17 – Espaço de buffer insuficiente especificado por .DSP para conter um file Registro S.
18 – Erro durante a programação.
19 – Endereço inicial não aponta para o módulo.
20 – Erro na programação do último byte.
21 – Endereço de programação não está mais no módulo.
22 – O endereço inicial não está em um limite de palavra alinhado.
23 – Erro durante a programação da última palavra.
24 – Módulo não pôde ser apagado.
25 – Palavra do módulo não apagada.
26 – .DSP selecionado file não implementa verificação de bytes.

27 – Byte do módulo não apagado.
28 – O endereço inicial do apagamento de palavras deve ser par.
29 – O endereço final de apagamento de palavras deve ser par.
30 – O parâmetro do usuário não está na faixa.
31 – Erro durante função especificada .DSP.
32 – A porta especificada não está disponível ou erro ao abrir a porta.
33 – Comando está inativo para este .DSP file.
34 – Não é possível entrar no modo de segundo plano. Verifique as conexões.
35 – Não é possível acessar o processador. Tente uma redefinição de software.
36 – .DSP inválido file.
37 – Não é possível acessar a RAM do processador. Tente uma redefinição de software.

38 – Inicialização cancelada pelo usuário.
39 – Erro ao converter número de comando hexadecimal.
40 – Configuração file não especificado e file prog.cfg não existe.
41 – .DSP file não existe.
42 – Erro no número io_delay na linha de comando.
43 – Parâmetro de linha de comando inválido.
44 – Erro ao especificar o atraso decimal em milissegundos.
47 – Erro no roteiro file.
49 – Cabo não detectado
50 – Registro S file não contém dados válidos.
51 – Falha na verificação da soma de verificação – os dados do registro S não correspondem à memória do MCU.
52 – A classificação deve estar habilitada para verificar a soma de verificação flash.

53 – S-Registros nem todos na faixa do módulo. (consulte o parâmetro de linha de comando “v”)
54 – Erro detectado nas configurações na linha de comando da porta/interface
55 – Parâmetro do dispositivo ausente no script file
60 – Erro ao calcular o valor CRC do dispositivo
61 – Erro – Device CRC não corresponde ao valor informado

70 – Erro – CPROG já está rodando
71 – Erro – Deve especificar a INTERFACE e a PORTA na linha de comando
72 – O processador de destino selecionado não é suportado pela interface de hardware atual.

Example Script de Programação File

o roteiro de programação file deve ser um ASCII puro file com um comando por linha. Este é o CFG file no ex anterioramples.

Um example é:

DISPOSITIVO MC56F84769; Selecione o dispositivo de destino para programar CM C:\PEMICRO\freescale_mc56f84769_1x_16x_80k_all.DSP; Escolha o Módulo Flash
EM; Apague o módulo
BM; Em branco Verifique o módulo
SS C:\PEMICRO\TEST.S19 ;Especificar o S19 a ser usado
PM; Programe o módulo com o S19
VM; Verifique o módulo novamente

Observação:
Os nomes dos caminhos de files relativos ao executável CPROG também podem ser usados.

Usando parâmetros de linha de comando em um script

Um parâmetro de linha de comando na forma de /PARAMn=s pode ser usado para inserir texto no script file no lugar de especial tags. Isso pode ser usado para substituir qualquer parte do script, incluindo comandos de programação, filenomes e parâmetros. Os valores válidos de n são 0..9. s é uma string que substituirá qualquer ocorrência de /PARAMn no script file.

Como um example, o seguinte script genérico pode ser usado para programar exatamente com a mesma funcionalidade do example script na Seção 7 - Example Script de Programação File:

DEVICE /PARAM1;Selecione o dispositivo de destino para programar
CM /PARAM2 ;Escolha o Módulo Flash
EM; Apague o módulo
BM; Em branco Verifique o módulo
SS /PARAM3 ;Especifica o S19 a usar
PM; Programe o módulo com o S19
/PARAM4; Verifique o módulo novamente

Os seguintes parâmetros seriam adicionados à linha de comando CPROG:

/PARAM1=MC56F84769
/PARAM2=C:\PEMICRO\freescale_mc56f84769_1x_16x80k_all.DSP
/PARAM3=C:\PEMICRO\TESTE.S19
/PARAM4=VM

OBSERVAÇÃO:
Se um parâmetro /PARAMn tiver um espaço em seu valor, todo o parâmetro precisará ser colocado entre aspas duplas. Isso indica ao Windows que é um único parâmetro. por example, se o caminho em /PARAM3 acima continha um espaço, você precisaria especificá-lo na linha de comando assim:

“/PARAM3=C:\PEMICRO\EXAMPLE FILES\TESTE.S19″

Então o ex completoampa linha de comando seria (observe que isso é contínuo; sem quebras de linha):

C:\PEMICRO\CPROGDSC INTERFACE=PORTA DO CICLONE=USB1 BDM_SPEED 1
C:\PROJECT\GENERIC.CFG /PARAM1=MC56F84769/PARAM2=C:\PEMICRO\freescale_mc56f84769_1x_16x_80k_all.DSP“/PARAM3=C:\PEMICRO\EXAMPLE FILES\TESTE.S19” /PARAM4=VM

Sampo lote File

Aqui está um examparquivo de chamar o programador de linha de comando e testar seu retorno de código de erro em um lote simples file. Eamplote files são fornecidos para Windows 95/98/XP e Windows 2000/NT/XP/Vista/7/8/10.

Windows NT/2000/Vista/7/8/10:

C:\PROJECT\CPROGDSC C:\PROJECT\ENGINE.CFG INTERFACE=USBMULTILINK PORT=USB1 se o nível de erro 1 for ruim, vá para bom: ruim

ECHO RUIM RUIM RUIM RUIM RUIM RUIM RUIM: bom ECO feito

Windows 95/98/ME/XP:

START /WC:\PROJECT\CPROGDSC C:\PROJECT\ENGINE.CFG INTERFACE=USBMULTILINK PORT=USB1 se o nível de erro 1 for ruim, vá para bom: ruim
ECHO RUIM RUIM RUIM RUIM RUIM RUIM RUIM: bom ECO feito

Observação:
Os nomes dos caminhos de files relativos ao executável CPROG também podem ser usados.

Informação

Para mais informações sobre CPROGDSC e PROGDSC, entre em contato conosco:

P&E Microcomputer Systems, Inc.

98 Galen St. Watertown, MA 02472-4502 EUA.
VOZ: 617-923-0053
FAX: 617-923-0808
WEB: http://www.pemicro.com.

Para view toda a nossa biblioteca de módulos.DSP, vá para a página de suporte do PEmicro website em www.pemicro.com/support.

Documentos / Recursos

Software de Programação PEmicro PROGDSC [pdf] Guia do Usuário
Software de Programação PROGDSC, PROGDSC, Software de Programação, Software

Referências

Manual do usuário

Software de Programação PEmicro PROGDSC

Introdução