ewrl78 linker config flashlibs

Trio ICF

Quel est le but du projet Trio ICF?

Le projet ICF Trio a été développé pour IAR Embedded Workbench pour Renesas RL78 version 3.10 ou version ultérieure . Il utilise un ensemble de 3 fichiers qui conduiront ensemble à une configuration de liaison appropriée pour les exigences de réservation de mémoire lorsqu'il y a des bibliothèques Flash RL78 utilisées.

Avantages

• Fournit une configuration simplifiée pour de nouveaux projets en reposant sur l'une des bibliothèques Flash RL78 .
• Réduit les efforts du développeur lorsque la reconfiguration de l'éditeur de liens est nécessaire, spécialement lors du reciblage ou du passage à une autre bibliothèque Flash RL78 .
• Tire parti des capacités avancées de l'éditeur de links avancées en plaçant les sections liées aux constantes __near à partir de la fin de la zone mirorable. Cette fonctionnalité peut entraîner une plus grande flexibilité grâce à l'espace flash contigu laissé pour le placement des sections du programme utilisateur sur les périphériques RL78 équipés d' un flash de code plus petit.

Détails (cliquez pour se dérouler)

Spécification de mise en page de configuration de liaison

Dans cette section, vous trouverez un aperçu de la façon dont les composants du trio ICF s'assemblent.

Déposer	Description
trio_lnkr5f1nnxn.icf	Le premier est sélectionnable par l'utilisateur . La sélection est effectuée en fonction de la similitude de la carte mémoire pour des groupes distincts de cibles RL78. Chacun de ces fichiers maintient les paramètres de remplacement de configuration de liaison appropriés qui peuvent être définis sur les options du projet . Le X dans le numéro de pièce signifie que la configuration de l'éditeur de liens est offerte, quel que soit le nombre de broches de la cible. Par exemple, TRIO_LNKR5F100XE.ICF doit être sélectionné pour une cible R5F100L .
Common.icf	Le second est automatiquement inclus à partir de la configuration sélectionnée par l'utilisateur. C'est le cœur du trio, contenant des directives paramétrisées qui peuvent être appliquées à l'une des cibles RL78 prises en charge.
self_ram.icf	Le troisième est automatiquement inclus par Common.icf pour évaluer le symbole de réservation de RAM utilisé par le lieur pour réserver la quantité appropriée de RAM (pour l'auto-Ram ) lors de l'utilisation du trio.

Flash Library Flavors

Les MCU RLL78 RENESAS nécessitent un ensemble spécifique de bibliothèques pour permettre l'utilisation de leurs souvenirs flash.

Renesas Electronics fournit les bibliothèques Flash RL78 en 3 saveurs différentes:

• La FSL (Flash Auto-programming Library) programme le Code Flash du RL78.
• La FDL (Flash Data Library) programme le Flash de données du RL78.
• L' anguille (bibliothèque d'émulation EEPROM) imite le comportement EEPROM sur le flash de données du RL78. Il fournit une couche supplémentaire de fonctionnalités en plus de son type de bibliothèque FDL compagnon correspondant (T01 ou T02 - expliqué ci-dessous). Il fournit un nivellement d'usure transparent parmi les blocs de flash de données provisionnés qui peuvent, en pratique, augmenter pratiquement la quantité de réécritures possibles.

Types de bibliothèque flash

Les saveurs de bibliothèques Flash RL78 peuvent être fournies comme l'un des types de bibliothèque suivants:

• Le T01 (type01, également connu sous le nom de Full ) est les bibliothèques Flash à part entière.
• Le T02 (type02, également connu sous le nom de Tiny ) est les plus équilibrés, fournissant les principales fonctionnalités à des dépens de moins de ressources par rapport aux bibliothèques T01.
• Le T04 (type04, également connu sous le nom de PICO ) est celui qui ne fournit que les fonctionnalités essentielles nues. Ce type de bibliothèque offre l'empreinte d'utilisation des ressources la plus faible. Habituellement, il s'agit du choix approprié pour les scénarios où la cible RL78 choisie est livrée avec des ressources de mémoire contrainte.

Auto-gras

En règle générale, pour chaque combinaison de la bibliothèque Flash RL78 MCU et RL78 , le programmeur devrait se référer au document de note d'application de l'électronique de Renesas R20UT2944 afin de savoir si la combinaison choisie nécessitera une plage de RAM spécifique, donc la combinaison choisie peut fonctionner correctement.

Self-Ram fait référence à la zone de RAM susmentionnée, qui doit être réservée dans certains cas, lorsqu'il s'appuie sur les capacités d'auto-programmation du RL78 MCU.

Afin de simplifier considérablement ce processus, le trio ICF l'automatise principalement, en tirant parti de chaque directive de configuration de liaison avancée disponible pour remplacer la configuration de liaison par défaut, tout en suivant les exigences définies dans la note d'application susmentionnée.

Remarque Pour plus d'informations concernant l'ensemble de fonctionnalités et les exigences complètes pour chacune de ces bibliothèques Flash, reportez-vous à leur documentation respective.

Comment utiliser le trio ICF

Les sections suivantes sont un guide étape par étape sur la façon de créer et de configurer un projet qui tire parti du trio ICF à partir de zéro.

Comme référence, le conseil de promotion de la Renesas pour RL78 / G14 a été utilisé comme cible pour la procédure pas à pas. Les exemples ont utilisé les combinaisons de bibliothèque flash les plus populaires.

Quoi qu'il en soit, des étapes similaires peuvent être utilisées avec d'autres combinaisons de cibles RL78 et de bibliothèques flash associées.

Pré-requis

Dans cette procédure pas à pas, les composants suivants sont déjà installés ou téléchargés:

• Installation par défaut de IAR Embedded Workbench pour Renesas RL78 V4.21.
• Une bibliothèque Flash RL78 de votre choix, distribuée exclusivement par Renesas Electronics Corporation et téléchargeable à partir du site de "MyPages" de Renesas Electronics Europe . Le téléchargement nécessite une préinscription ou une connexion si vous êtes déjà un utilisateur enregistré.

Remarque L'assistant RL78 Flash Library Installers vous demandera de "sélectionner votre région". Les bibliothèques compatibles avec l'IAR Embedded Workbench pour Renesas RL78 v2.10 + ( <library-name>.a ) ne sont disponibles que pour " America / Europe / Middle East / Africa " ​​à ce jour.

Symboles de réservation RAM

Le tableau ci-dessous répertorie les bibliothèques disponibles ainsi que leur documentation respective ainsi que le symbole de liaison requis du projet utilisé pour la réservation de RAM.

Bibliothèque Flash RL78	Documentation	Symbole	Se réserve l'auto-rame pour le ...
T01-FSL	T01-FSL	__RESERVE_T01_FSL=1	... bibliothèque flash de code T01-FSL
T01-FDL	T01-FDL	__RESERVE_T01_FDL=1	... bibliothèque Flash de données T01-FDL
T01-eel	T01-eel	__RESERVE_T01_EEL=1	... bibliothèque d'émulation d'éprom de T01-Eel
T02-FDL	T02-FDL	__RESERVE_T02_FDL=1	... T02-FDL Tiny Data Flash Library
T02-eel	T02-eel	__RESERVE_T02_EEL=1	... Bibliothèque d'émulation d'élévation T02-EEEL
T04-FDL	T04-FDL	__RESERVE_T04_FDL=1	... t04-fdl pico flash lbrary

Création d'un projet de base avec Applelet3

Applelet3 et AP4 sont des générateurs de code basés sur GUI qui peuvent générer des startups et des pilotes périphériques en C pour les cibles RL78.

• L' IAR Embedded Workbench pour Renesas RL78 installe le générateur de code Applelet3 de Renesas Electronics . Lancez l'outil Applilet3 .

• Créez un nouveau projet nommé Nom du projet qui cible le MCU de la carte (PN # R5F104leafa ), en utilisant le compilateur IAR comme outil de construction .

• Dans l'onglet Affectation des broches , cliquez sur Correction des paramètres .

• Dans l'onglet Paramètre de débogage sur puce , activez le paramètre de fonctionnement de débogage sur puce .

• Activer la détection de basse tension , en sélectionnant toute valeur cohérente pour VLVD , comme 3,63 V. Enregistrez le projet. Enfin, cliquez sur Générer du code .

Configurez le projet dans l'IAR Embedded Workbench

• Commencez le Workbench IAR Embedded pour RL78 , enregistrez l'espace de travail ( .eww ) sur le même dossier de projet qui a été créé à l' endroit choisi. Ce dossier peut (et sera) référé par IAR Embedded Workbench via sa variable d'environnement intégrée $PROJ_DIR$ .

Remarque Le $PROJ_DIR$ est une variable d'argument interne qui se traduit par le répertoire contenant le fichier de projet ( .ewp ). Il est souvent utilisé pour se référer aux fichiers source du projet, aux fichiers d'en-tête et aux bibliothèques avec des pathnames relatifs (par exemple, $PROJ_DIR$/<dir>/<file> ). L' IAR Embedded Workbench propose une sélection d'autres variables d'argument intégrées utiles.

• Choisissez Projet → Créer un nouveau projet ... et créer un projet RL78 vide . Enregistrez-le sur l'emplacement $PROJ_DIR$ du projet.

• Choisissez Project → Ajouter une connexion du projet ... et pointer dans le fichier .ipcf qui a été créé par l' APLILET3 lorsque le code a été généré.

• Clone ce référentiel à l'intérieur $PROJ_DIR$ .

Remarque Alternativement, ce référentiel peut être téléchargé comme une archive .zip via le bouton de code .

Exemples

Sélectionnez l'un des exemples disponibles ci-dessous pour continuer.

Chaque exemple contient d'autres étapes pour créer un programme simple qui consiste à stocker / récupérer des données persistantes en utilisant différentes combinaisons des bibliothèques Flash RL78 les plus populaires.

Exemple	Crée un programme qui va ...
T04-FDL	... exercez le flash de données
T01-FSL	... exercez le code flash
T02-Eel & T02-FDL	... exercez le flash de données partitionné dans une piscine d'anguille et un pool FDL

Problèmes

Vous avez trouvé un problème ou avez une suggestion liée à ce référentiel? N'hésitez pas à utiliser le tracker du numéro public.

• N'oubliez pas de jeter un œil aux problèmes antérieurs.
• Si vous créez un nouveau problème, veuillez le décrire en détail.

Clause de non-responsabilité

Les informations de ce référentiel sont susceptibles de changer sans préavis et ne représentent un engagement sur aucune partie de l'IAR. Bien que les informations contenues dans les présentes soient supposées être exactes, IAR n'assume aucune responsabilité pour toute erreur ou omission.