ewrl78 linker config flashlibs

Trio ICF

¿Cuál es el propósito del proyecto ICF Trio?

El proyecto ICF Trio se desarrolló para IAR integrado Workbench para Renesas RL78 versión 3.10 o posterior . Utiliza un conjunto de 3 archivos que juntos conducirán a una configuración de enlazador adecuada para los requisitos de reserva de memoria cuando hay bibliotecas RL78 Flash en uso.

Beneficios

• Proporciona una configuración simplificada para nuevos proyectos que dependen de cualquiera de las bibliotecas RL78 Flash .
• Reduce los esfuerzos del desarrollador cuando se necesita la reconfiguración del enlazador, especialmente al reorientar o cambiar a una biblioteca flash RL78 diferente.
• Aproveche las capacidades avanzadas de enlazador Iar Ilink colocando las secciones relacionadas con las constantes __near desde el final del área reflejable. Esta característica puede dar como resultado una mayor flexibilidad gracias al espacio flash contiguo que queda para la ubicación de las secciones del programa del usuario en dispositivos RL78 equipados con flash de código más pequeño.

Detalles (haga clic para desarrollar)

Especificación de diseño de trío de configuración de enlazador

En esta sección encontrará una descripción general de cómo se ajustan los componentes del trío ICF .

Archivo	Descripción
trio_lnkr5f1nnxn.icf	El primero es seleccionable por el usuario . La selección se realiza en función de la similitud en el mapa de memoria para distintos grupos de objetivos RL78. Cada uno de estos archivos contiene los parámetros de anulación de configuración del enlazador adecuados que se pueden establecer en las opciones del proyecto . La X dentro del número de pieza significa que la configuración del enlazador se ofrece independientemente del recuento de pines del objetivo. Por ejemplo, trio_lnkr5f100xe.icf debe seleccionarse para un objetivo R5F100LE .
común.icf	El segundo se incluye automáticamente desde la configuración seleccionada por el usuario. Este es el corazón del trío, que contiene directivas parametrizadas que se pueden aplicar a cualquiera de los objetivos RL78 compatibles.
self_ram.icf	Common.ICF incluye automáticamente el tercero para evaluar el símbolo de reserva de RAM utilizado por el enlazador para reservar la cantidad apropiada de RAM (para auto-RAM ) cuando se usa el trío.

Flavores de la biblioteca flash

El MCU RENESAS RL78 requiere un conjunto específico de bibliotecas para permitir el uso de sus recuerdos flash.

Renesas Electronics proporciona las bibliotecas RL78 Flash en 3 sabores diferentes:

• La FSL (Biblioteca de autoprogramación Flash) programa el código de RL78 flash .
• El FDL (Flash Data Library) programa el Flash de datos del RL78.
• La EEL (Biblioteca de emulación EEPROM) emula el comportamiento de EEPROM en el flash de datos del RL78. Proporciona una capa adicional de funcionalidades además de su tipo de biblioteca FDL complementaria correspondiente (T01 o T02, explicada a continuación). Proporciona nivelación de desgaste transparente entre los bloques de flash de datos aprovisionados que, en la práctica, pueden, prácticamente, aumentar la cantidad de posibles reescrituras.

Tipos de biblioteca flash

Los sabores de bibliotecas flash RL78 pueden proporcionarse como uno de los siguientes tipos de biblioteca:

• El T01 (tipo01, también conocido como completo ) son las bibliotecas de flash completamente incipientes.
• El T02 (Tipo02, también conocido como Tiny ) son los equilibrados, que proporcionan las principales funcionalidades a expensas de menos recursos en comparación con las bibliotecas T01.
• El T04 (tipo04, también conocido como PICO ) es el que proporciona solo las funcionalidades esenciales desnudas. Este tipo de biblioteca ofrece la huella de uso de recursos más baja. Por lo general, esta es la opción adecuada para los escenarios en los que el objetivo RL78 elegido viene con recursos de memoria restringidos.

Auto-ram

Por lo general, para cada combinación de la biblioteca Flash RL78 MCU y RL78 , el programador necesitaría consultar el documento de nota de aplicación de Renesas Electronics R20UT2944 para saber si la combinación elegida requerirá que se reserve algún rango de RAM específico, por lo tanto, la combinación elegida puede funcionar correctamente.

Auto-RAM se refiere al área de RAM antes mencionada, que debe reservarse en algunos casos, al confiar en las capacidades de autoprogramación de RL78 MCU.

Para simplificar enormemente este proceso, el TRIO ICF lo automatiza principalmente, aprovechando cada Directiva de configuración de enlazador avanzada disponible para anular la configuración predeterminada del enlazador, mientras se sigue los requisitos definidos en la nota de aplicación mencionada anteriormente.

Nota Para obtener más información sobre el conjunto completo de características y los requisitos para cada una de estas bibliotecas Flash, consulte su documentación respectiva.

Cómo usar el trio ICF

Las siguientes secciones son una guía paso a paso sobre cómo crear y configurar un proyecto que aproveche el trio ICF desde cero.

Como referencia, la Junta de Promoción de Renesas para RL78/G14 se utilizó como objetivo para el tutorial. Los ejemplos utilizaron las combinaciones de biblioteca Flash más popular.

De todos modos, se pueden usar pasos similares con otras combinaciones de objetivos RL78 y bibliotecas Flash relacionadas.

Requisitos previos

En este tutorial, los siguientes componentes ya instalados o descargados:

• Instalación predeterminada del banco de trabajo integrado IAR para Renesas RL78 V4.21.
• Una biblioteca RL78 Flash de su elección, distribuida exclusivamente por Renesas Electronics Corporation y descargable del sitio "MyPages" de Renesas Electronics Europe . La descarga requiere preinscripción o inicio de sesión si ya es un usuario registrado.

Tenga en cuenta que el asistente de instaladores de la biblioteca Flash RL78 le pedirá que "seleccione su región". Las bibliotecas compatibles con el banco de trabajo integrado IAR para Renesas RL78 V2.10+ ( <library-name>.a ) solo están disponibles para " América/Europa/Medio Oriente/África " ​​a partir de este escrito.

Símbolos de reserva de RAM

La siguiente tabla enumera las bibliotecas disponibles junto con su documentación respectiva, así como el símbolo de enlazador requerido del proyecto utilizado para la reserva RAM.

Biblioteca Flash RL78	Documentación	Símbolo	Se reserva a sí mismo para el ...
T01-FSL	T01-FSL	__RESERVE_T01_FSL=1	... Biblioteca flash de código T01-FSL
T01-FDL	T01-FDL	__RESERVE_T01_FDL=1	... Biblioteca Flash de datos T01-FDL
T01-ELE	T01-ELE	__RESERVE_T01_EEL=1	... Biblioteca de emulación de EEPROM T01-EEEL
T02-FDL	T02-FDL	__RESERVE_T02_FDL=1	... Biblioteca de Flash Tiny Data T02-FDL
T02-ELE	T02-ELE	__RESERVE_T02_EEL=1	... Biblioteca de emulación de EEPROM T02-EEEL
T04-FDL	T04-FDL	__RESERVE_T04_FDL=1	... T04-FDL Pico flash lbrary

Creación de un proyecto base con Applilet3

Applilet3 y AP4 son generadores de código basados ​​en GUI que pueden generar controladores de inicio y periféricos en C para objetivos RL78.

• El banco de trabajo IAR integrado para Renesas RL78 instala el generador de código Applilet3 de Renesas Electronics . Inicie la herramienta Applilet3 .

• Cree un nuevo proyecto con nombre del proyecto que se dirige a la MCU de la Junta (PN# R5F104Leafa ), utilizando el compilador IAR como herramienta de compilación .

• En la pestaña Asignación de PIN , haga clic en la configuración de corrección .

• En la pestaña Configuración de depuración en chip , habilite la configuración de operación de depuración en chip .

• Habilite la detección de bajo voltaje , seleccionando cualquier valor coherente para VLVD , como 3.63V . Guardar el proyecto. Finalmente, haga clic en Generar código .

Configurar el proyecto en el banco de trabajo integrado IAR

• Comience el Banco de trabajo IAR IAR INCRESE para RL78 , guarde el espacio de trabajo ( .eww ) en la misma carpeta de proyecto que se creó en el lugar elegido. Esta carpeta puede (y) ser referida por IAR integrado Workbench a través de su variable de entorno incorporada $PROJ_DIR$ .

Tenga en cuenta que $PROJ_DIR$ es una variable de argumento interno que se traduce en el directorio que contiene el archivo del proyecto ( .ewp ). A menudo se usa a menudo para referirse a los archivos fuente del proyecto, archivos de encabezado y bibliotecas con Names Relative Path (por ejemplo, $PROJ_DIR$/<dir>/<file> ). El Banco de trabajo integrado IAR ofrece una selección de otras variables útiles de argumentos incorporados.

• Elija Proyecto → Cree un nuevo proyecto ... y cree un proyecto RL78 vacío . Ahorre en la ubicación $PROJ_DIR$ del proyecto.

• Elija Proyecto → Agregar conexión del proyecto ... y señale el archivo .ipcf que ha sido creado por Applilet3 cuando se generó el código.

• Clone este repositorio dentro de $PROJ_DIR$ .

Nota Alternativamente, este repositorio se puede descargar como un archivo .zip a través del botón de código .

Ejemplos

Seleccione uno de los ejemplos disponibles a continuación para continuar.

Cada ejemplo contiene más pasos para crear un programa simple que consiste en almacenar/recuperar datos persistentes utilizando diferentes combinaciones de las bibliotecas Flash RL78 más populares.

Ejemplo	Crea un programa que ...
T04-FDL	... ejercer el flash de datos
T01-FSL	... Ejercar el código flash
T02-EEEL y T02-FDL	... Ejercar el flash de datos dividido en un grupo de anguilas y un grupo de FDL

Asuntos

¿Encontró un problema o tiene una sugerencia relacionada con este repositorio? Siéntase libre de usar el rastreador de problemas públicos.

• No olvides echar un vistazo a los problemas anteriores.
• Si crea un nuevo problema, descríbalo en detalle.

Descargo de responsabilidad

La información en este repositorio está sujeta a cambios sin previo aviso y no representa un compromiso en ninguna parte de IAR. Si bien se supone que la información contenida en este documento es precisa, IAR no asume ninguna responsabilidad por ningún error u omisión.