ewrl78 linker config flashlibs

Trio da ICF

Qual é o objetivo do Projeto Trio da ICF?

O Projeto Trio da ICF foi desenvolvido para o Workbench incorporado IAR para Renesas RL78 versão 3.10 ou posterior . Ele usa um conjunto de 3 arquivos que juntos levarão a uma configuração adequada do vinculador para os requisitos de reserva de memória quando houver bibliotecas Flash RL78 em uso.

Benefícios

• Fornece configuração simplificada para novos projetos que dependem de qualquer uma das bibliotecas Flash RL78 .
• Reduz os esforços do desenvolvedor quando a reconfiguração do vinculador é necessária, especialmente ao redirecionar ou alternar para uma biblioteca Flash RL78 diferente.
• Aproveite os recursos avançados do Linker Iar ILink, colocando as seções relacionadas às constantes __near a partir do final da área espelhada. Esse recurso pode resultar em maior flexibilidade, graças ao espaço contíguo flash deixado para a colocação das seções do programa de usuário em dispositivos RL78 equipados com flash de código menor.

Detalhes (clique para se desenrolar)

Especificação de layout do trio de configuração do ligante

Nesta seção, você encontrará uma visão geral de como os componentes do TRIO da ICF se encaixam.

Arquivo	Descrição
trio_lnkr5f1nnxn.icf	O primeiro é selecionado pelo usuário . A seleção é feita com base na semelhança no mapa de memória para grupos distintos de alvos RL78. Cada um desses arquivos mantém os parâmetros de substituição de configuração do vinculador adequados que podem ser definidos nas opções do projeto . O X dentro do número da peça significa que a configuração do vinculador é oferecida independentemente da contagem de pinos do alvo. Por exemplo, trio_lnkr5f100xe.icf deve ser selecionado para um destino R5F100LE .
Common.icf	O segundo é incluído automaticamente na configuração selecionada pelo usuário. Este é o coração do trio, contendo diretivas parametrizadas que podem ser aplicadas a qualquer um dos alvos RL78 suportados.
auto_ram.icf	O terceiro é automaticamente incluído pelo Common.icf para avaliar o símbolo de reserva de RAM usado pelo ligante para reservar a quantidade apropriada de RAM (para auto-ram ) ao usar o trio.

Flavores da biblioteca flash

O MCUS RENESAS RL78 exige um conjunto específico de bibliotecas para permitir o uso de suas memórias flash.

Renesas Electronics fornece as bibliotecas Flash RL78 em 3 sabores diferentes:

• A FSL (biblioteca de autoprogramação flash) programa o flash de código do RL78.
• O FDL (Flash Data Data) programa o flash de dados do RL78.
• A EEL (biblioteca de emulação EEPROM) imita o comportamento da EEPROM no flash de dados do RL78. Ele fornece uma camada extra de funcionalidades no topo de seu tipo de biblioteca FDL correspondente (T01 ou T02 - explicado abaixo). Ele fornece nivelamento de desgaste transparente entre os blocos de flash de dados provisionados que podem, na prática, praticamente aumentar a quantidade de reescritas possíveis.

Tipos de biblioteca flash

Os sabores das bibliotecas Flash RL78 podem ser fornecidas como um dos seguintes tipos de biblioteca:

• O T01 (TIPO01, também conhecido como completo ) são as bibliotecas flash de pleno pleno.
• O T02 (TIPO02, também conhecido como minúsculo ) são os equilibrados, fornecendo as principais funcionalidades às custas de menos recursos quando comparadas às bibliotecas T01.
• O T04 (TIPO04, também conhecido como Pico ) é o que fornece apenas as funcionalidades essenciais. Esse tipo de biblioteca oferece a menor pegada de uso de recursos. Geralmente, essa é a escolha adequada para os cenários em que o destino RL78 escolhido vem com recursos de memória restritos.

Auto-ram

Normalmente, para todas as combinações da Biblioteca RL78 MCU e RL78 Flash , o programador precisaria se referir ao documento do Aplicativo da Renesas Electronics R20UT2944 para saber se a combinação escolhida exigirá algum intervalo de RAM específico a ser reservado, portanto, a combinação escolhida pode funcionar corretamente.

O auto-ramo refere-se à área de RAM acima mencionada, que deve ser reservada em alguns casos, ao confiar nas capacidades de autoprogramação do RL78 MCU.

Para simplificar tremendamente esse processo, o Trio da ICF o automatiza principalmente, aproveitando todas as diretivas avançadas de configuração do vinculador disponíveis para substituir a configuração do vinculador padrão, enquanto segue os requisitos definidos na nota de aplicação acima mencionada.

NOTA Para obter mais informações sobre o conjunto completo de recursos e os requisitos para cada uma dessas bibliotecas flash, consulte sua respectiva documentação.

Como usar o trio da ICF

As seções a seguir são um guia passo a passo sobre como criar e configurar um projeto que aproveite o trio da ICF do zero.

Como referência, o Conselho de Promoção Renesas para RL78/G14 foi usado como alvo para o passo a passo. Os exemplos usaram as combinações de bibliotecas flash mais populares.

Independentemente disso, etapas semelhantes podem ser usadas com outras combinações de alvos RL78 e bibliotecas flash relacionadas.

Pré-requisitos

Neste passo a passo, os seguintes componentes já instalados ou baixados:

• Instalação padrão da bancada de trabalho incorporada IAR para Renesas RL78 v4.21.
• Uma biblioteca RL78 Flash de sua escolha, distribuída exclusivamente pela Renesas Electronics Corporation e download do site Renesas Electronics Europe "MyPages" . O download requer pré-registro ou login se você já for um usuário registrado.

Observe o assistente RL78 Flash Library Installers Wizard solicitará que você "selecione sua região". As bibliotecas compatíveis com a bancada de trabalho incorporada do IAR para Renesas RL78 v2.10+ ( <library-name>.a ) estão disponíveis apenas para " America/Europa/Oriente Médio/África " ​​até o momento.

Símbolos de reserva de RAM

A tabela abaixo lista as bibliotecas disponíveis, juntamente com sua respectiva documentação , bem como o símbolo de ligação exigido do projeto usado para a reserva de RAM.

Biblioteca Flash RL78	Documentação	Símbolo	Reservas auto-ram para o ...
T01-FSL	T01-FSL	__RESERVE_T01_FSL=1	... biblioteca flash de código T01-FSL
T01-FDL	T01-FDL	__RESERVE_T01_FDL=1	... Biblioteca de dados de dados T01-FDL
T01-EEL	T01-EEL	__RESERVE_T01_EEL=1	... Biblioteca de emulação EEPROM T01-EEL
T02-FDL	T02-FDL	__RESERVE_T02_FDL=1	... T02-FDL Tiny Data Flash Library
T02-EEL	T02-EEL	__RESERVE_T02_EEL=1	... Biblioteca de emulação EEPROM de EEPROM T02
T04-FDL	T04-FDL	__RESERVE_T04_FDL=1	... t04-fdl pico flash lbrary

Criando um projeto básico com appilet3

Applilet3 e AP4 são geradores de código baseados em GUI que podem gerar drivers de inicialização e periférico em alvos C para RL78.

• A bancada de trabalho incorporada do IAR para Renesas RL78 instala o gerador de código Applilet3 do Renesas Electronics . Inicie a ferramenta AppLet3 .

• Crie um novo projeto chamado Nome do Projeto que visa o MCU da diretoria (PN# R5F104LEAA ), usando o compilador IAR como ferramenta de construção .

• Na guia Atribuição de PIN , clique nas configurações de correção .

• Na guia Configuração de depuração no chip , ative a configuração de operação de depuração no chip .

• Habilite a detecção de baixa tensão , selecionando qualquer valor coerente para VLVD , como 3.63V . Salve o projeto. Por fim, clique em Gerate Code .

Configure o projeto na bancada de trabalho incorporada IAR

• Inicie a bancada de trabalho incorporada do IAR para RL78 , salve o espaço de trabalho ( .eww ) na mesma pasta do projeto, criada no local escolhido. Esta pasta pode (e será referida pelo IAR Workbench incorporado através de sua variável de ambiente interno $PROJ_DIR$ .

Nota A $PROJ_DIR$ é uma variável de argumento interna que se traduz no diretório que contém o arquivo do projeto ( .ewp ). Muitas vezes, é usado para se referir aos arquivos de origem do projeto, arquivos de cabeçalho e bibliotecas com nomes de caminho relativos (por exemplo, $PROJ_DIR$/<dir>/<file> ). A bancada de trabalho incorporada do IAR oferece uma seleção de outras variáveis ​​úteis de argumento interno.

• Escolha Projeto → Crie um novo projeto ... e crie um projeto RL78 vazio . Salve -o no local $PROJ_DIR$ do projeto.

• Escolha Projeto → Adicionar conexão do projeto ... e aponte para o arquivo .ipcf que foi criado pelo AppLet3 quando o código foi gerado.

• Clone este repositório dentro de $PROJ_DIR$ .

Nota Alternativamente, este repositório pode ser baixado como um arquivo .zip através do botão Código .

Exemplos

Selecione um dos exemplos disponíveis abaixo para continuar.

Cada exemplo contém mais etapas para criar um programa simples que consiste em armazenar/recuperar dados persistentes usando diferentes combinações das bibliotecas Flash RL78 mais populares.

Exemplo	Cria um programa que vai ...
T04-FDL	... Exercite o flash de dados
T01-FSL	... exercite o código flash
T02-EEL & T02-FDL	... Exercite o flash de dados dividido em um pool de enguias e um pool de FDL

Problemas

Encontrou um problema ou tem uma sugestão relacionada a este repositório? Sinta -se à vontade para usar o rastreador de problemas público.

• Não se esqueça de dar uma olhada em questões anteriores.
• Se criar um novo problema, descreva -o em detalhes.

Isenção de responsabilidade

As informações deste repositório estão sujeitas a alterações sem aviso prévio e não representam um compromisso em nenhuma parte do IAR. Embora se suponha que as informações aqui contidas sejam precisas, o IAR não assume nenhuma responsabilidade por erros ou omissões.