ewrl78 linker config flashlibs

ICF Trio

Was ist der Zweck des ICF -Trio -Projekts?

Das ICF -Trio -Projekt wurde für IAR eingebettete Workbench für Renesas RL78 Version 3.10 oder höher entwickelt. Es wird eine Reihe von 3 Dateien verwendet, die zusammen zu einer ordnungsgemäßen Linkerkonfiguration für die Speicherreservierungsanforderungen führen, wenn RL78 -Flash -Bibliotheken verwendet werden.

Vorteile

• Bietet vereinfachtes Setup für neue Projekte, die sich auf eine der RL78 -Flash -Bibliotheken stützen.
• Reduziert die Bemühungen des Entwicklers, wenn die Neukonfiguration der Linker erforderlich ist, insbesondere wenn die Relzierung oder Umstellung auf eine andere RL78 -Flash -Bibliothek wechselt.
• Nutzen Sie fortgeschrittene IAR Ilink -Linker -Funktionen, indem Sie die Abschnitte im Zusammenhang mit den __near -Konstanten aus dem Ende des spiegelenden Bereichs platzieren. Diese Funktion kann dank des zusammenhängenden Flash -Speicherplatzes für die Platzierung des Benutzerprogramms auf RL78 -Geräten, die mit kleineren Code -Flash ausgestattet sind, zu größerer Flexibilität führen.

Details (klicken, um sich zu entfalten)

Linker -Konfigurations -Trio -Layoutspezifikation

In diesem Abschnitt finden Sie einen Überblick darüber, wie die ICF -Trio -Komponenten zusammenpassen.

Datei	Beschreibung
trio_lnkr5f1nnxn.icf	Der erste ist benutzerfreundlich . Die Auswahl erfolgt auf der Grundlage der Ähnlichkeit in der Speicherkarte für verschiedene Gruppen von RL78 -Zielen. Jede dieser Dateien enthält die ordnungsgemäßen Parameter für die Überschreibung von Linker Configuration , die in den Projektoptionen festgelegt werden können. Das X innerhalb der Teilenummer bedeutet, dass die Linkerkonfiguration unabhängig von der PIN -Anzahl des Ziels angeboten wird. Zum Beispiel sollte Trio_Lnkr5f100xe.icf für ein R5F100LE -Ziel ausgewählt werden.
Common.icf	Die zweite wird automatisch aus der vom Benutzer ausgewählten Konfiguration enthalten. Dies ist das Herzstück des Trios, das parametrisierte Richtlinien enthält, die auf eines der unterstützten RL78 -Ziele angewendet werden können.
self_ram.icf	Der dritte wird automatisch von Common.ICF enthalten, um das vom Linker verwendete RAM-Reservierungssymbol zu bewerten, um die entsprechende Menge an RAM (für Selbstdatrum ) bei der Verwendung des Trios zu behalten.

Flash Library Aromen

Die Renesas RL78 MCUs erfordern einen bestimmten Satz von Bibliotheken, um die Verwendung ihrer Flash -Erinnerungen zu ermöglichen.

Renesas Electronics bietet die RL78 -Flash -Bibliotheken in 3 verschiedenen Geschmacksrichtungen:

• Die FSL (Flash Self-Programming Library) programmiert den Code-Flash des RL78.
• Die FDL (Flash Data Library) programmiert den Datenflash des RL78.
• Die EEL (EEPROM -Emulationsbibliothek) emuliert das EEPROM -Verhalten auf dem Datenblitz des RL78. Es bietet eine zusätzliche Funktionsebene über seinem entsprechenden FDL -Bibliothekstyp der FDL -Bibliothek (T01 oder T02 - Erklärung unten). Es bietet eine transparente Verschleißniveau zwischen den vorgesehenen Datenblöcken, die in der Praxis möglicherweise die Menge der möglichen Umschreibungen erhöhen können.

Blitzbibliothekstypen

Die RL78 -Flash -Bibliotheken können als einer der folgenden Bibliothekstypen bereitgestellt werden:

• Der T01 (Typ01, auch als Full bezeichnet) sind die vollwertigen Flash -Bibliotheken.
• Der T02 (Typ02, auch als winzig bezeichnet) sind die ausgewogenen und bieten die Hauptfunktionalitäten auf Kosten weniger Ressourcen im Vergleich zu den T01 -Bibliotheken.
• Der T04 (Typ04, auch als Pico bezeichnet) ist derjenige, der nur die bloßen wesentlichen Funktionen bietet. Dieser Bibliothekstyp bietet die niedrigste Ressourcennutzung. Normalerweise ist dies die geeignete Wahl für die Szenarien, in denen das gewählte RL78 -Ziel mit eingeschränkten Speicherressourcen geliefert wird.

Selbstanlagen

In der Regel müsste der Programmierer für jede Kombination von RL78 MCU und RL78 Flash -Bibliothek auf das Anwendungsnotiz -Dokument R20UT2944 von Renesas Electronics verweisen, um zu wissen, ob die ausgewählte Kombination einen bestimmten RAM -Bereich erfordert, um reserviert zu werden. Daher kann die ausgewählte Kombination ordnungsgemäß funktionieren.

Self-Ram bezieht sich auf den oben genannten RAM-Bereich, der in einigen Fällen vorbehalten sein muss , wenn sie sich auf die selbstprogrammierenden Funktionen der RL78 MCU verlassen.

Um diesen Prozess enorm zu vereinfachen, automatisiert das ICF -Trio es größtenteils, indem sie jede erweiterte Linker -Konfigurationsanweisung nutzt, um die Standard -Linker -Konfiguration zu überschreiben, während die in der oben genannten Anwendungsnotiz definierten Anforderungen erfolgt.

Hinweis für weitere Informationen zu den vollständigen Feature -Set und den Anforderungen für jede dieser Flash -Bibliotheken finden Sie in der jeweiligen Dokumentation.

So verwenden Sie das ICF -Trio

Die folgenden Abschnitte sind eine Schritt-für-Schritt-Anleitung zum Erstellen und Konfigurieren eines Projekts, das das ICF-Trio von Grund auf neu nutzt.

Als Referenz wurde das Renesas Promotion Board für RL78/G14 als Ziel für die Walkthrough verwendet. Die Beispiele verwendeten die beliebtesten Flash -Bibliothekskombinationen.

Unabhängig davon können ähnliche Schritte mit anderen Kombinationen von RL78 -Zielen und verwandten Flash -Bibliotheken verwendet werden.

Voraussetzungen

In dieser Vorgehensweise wurden die folgenden Komponenten bereits installiert oder heruntergeladen:

• Standardinstallation von IAR Embedded Workbench für Renesas RL78 V4.21.
• Eine RL78 -Flash -Bibliothek Ihrer Wahl, die ausschließlich von der Renesas Electronics Corporation verteilt und von der "MyPages" -Seite von Renesas Electronics Europe heruntergeladen werden kann. Der Download erfordert Vorregistrierung oder Anmeldung, wenn Sie bereits ein registrierter Benutzer sind.

Beachten Sie, dass der Assistent der RL78 Flash Library -Installateure Sie auffordert, "Ihre Region auszuwählen". Die mit der IAR-Embedded Workbench für Renesas RL78 v2.10+ ( <library-name>.a ) kompatibelen Bibliotheken sind zum jetzigen Zeitpunkt nur für " America/Europe/Middle East/Afrika " verfügbar.

RAM -Reservierungssymbole

In der folgenden Tabelle werden die verfügbaren Bibliotheken zusammen mit ihrer jeweiligen Dokumentation sowie dem für die RAM -Reservierung verwendeten Linker -Symbol des Projekts aufgeführt.

RL78 Flash Library	Dokumentation	Symbol	Reserviert Selbstram für ...
T01-FSL	T01-FSL	__RESERVE_T01_FSL=1	... T01-FSL -Code-Flash-Bibliothek
T01-fdl	T01-fdl	__RESERVE_T01_FDL=1	... T01-FDL- Datenblitzbibliothek
T01-EEL	T01-EEL	__RESERVE_T01_EEL=1	... T01-EEL- EEPROM-Emulationsbibliothek
T02-FDL	T02-FDL	__RESERVE_T02_FDL=1	... T02-FDL Tiny Data Flash Library
T02-EEL	T02-EEL	__RESERVE_T02_EEL=1	... T02-EEL- EEPROM-Emulationsbibliothek
T04-FDL	T04-FDL	__RESERVE_T04_FDL=1	... T04-FDL Pico Flash Lbrary

Erstellen eines Basisprojekts mit Applilet3

Applilet3 und AP4 sind GUI-basierte Codegeneratoren, die Startup- und Peripherie-Treiber in C für RL78-Ziele generieren können.

• Die IAR eingebettete Workbench für Renesas RL78 installiert den Applilet3 -Codegenerator von Renesas Electronics . Starten Sie das Applilet3 -Tool.

• Erstellen Sie ein neues Projekt namens Project Name , das auf die MCU (PN# R5F104 ) des Boards abzielt, wobei der IAR -Compiler als Build -Tool verwendet wird.

• Klicken Sie auf der Registerkarte PIN -Zuweisung auf Behebungseinstellungen .

• Aktivieren Sie auf der Registerkarte "On-Chip-Debug-Einstellung" die Einstellung des On-Chip-Debug-Betriebs .

• Aktivieren Sie die Erkennung niedriger Spannung und wählen Sie einen kohärenten Wert für VLVD , z. B. 3,63 V. Speichern Sie das Projekt. Klicken Sie schließlich auf Code generieren .

Richten Sie das Projekt im IAR eingebetteten Workbench ein

• Starten Sie die IAR -Embedded Workbench für RL78 und speichern Sie den Arbeitsbereich ( .eww ) auf demselben Projektordner, der am ausgewählten Ort erstellt wurde. Dieser Ordner kann (und wird) von der IAR eingebetteten Workbench über seine integrierte Umgebungsvariable $PROJ_DIR$ verwiesen.

Beachten Sie, dass $PROJ_DIR$ eine interne Argumentvariable ist, die in das Verzeichnis, das die Projektdatei ( .ewp ) enthält, übersetzt. Es wird oft verwendet, um auf die Quelldateien, Header -Dateien und Bibliotheken des Projekts mit relativen Pfadnamen zu verweisen (z. B. $PROJ_DIR$/<dir>/<file> ). Die IAR Embedded Workbench bietet eine Auswahl anderer nützlicher integrierter Argumentvariablen.

• Wählen Sie Projekt → neues Projekt erstellen ... und erstellen Sie ein leeres RL78 -Projekt . Speichern Sie es im $PROJ_DIR$ location des Projekts.

• Wählen Sie Projekt → Projektverbindung hinzufügen ... und verweisen Sie auf die .ipcf -Datei, die vom Applilet3 erstellt wurde, wenn der Code generiert wurde.

• Klonen Sie dieses Repository in $PROJ_DIR$ .

Hinweis Alternativ kann dieses Repository über die Code -Taste als .zip -Archiv heruntergeladen werden.

Beispiele

Wählen Sie eines der verfügbaren Beispiele unten, um fortzufahren.

Jedes Beispiel enthält weitere Schritte zum Erstellen eines einfachen Programms, das aus dem Speichern/Abrufen von anhaltenden Daten mit verschiedenen Kombinationen der beliebtesten RL78 -Flash -Bibliotheken besteht.

Beispiel	Erstellt ein Programm, das ...
T04-FDL	... trainieren Sie den Datenblitz
T01-FSL	... trainieren Sie den Code -Blitz
T02-EEL & T02-FDL	... trainieren​

Probleme

Ein Problem gefunden oder einen Vorschlag zu diesem Repository im Zusammenhang mit diesem Repository haben? Nutzen Sie den öffentlichen Problem Tracker.

• Vergessen Sie nicht, einen Blick auf frühere Ausgaben zu werfen.
• Wenn Sie ein neues Problem erstellen, beschreiben Sie es bitte ausführlich.

Haftungsausschluss

Die Informationen in diesem Repository können sich ohne vorherige Ankündigung ändern und stellen keine Verpflichtung für einen Teil von IAR dar. Während die hierin enthaltenen Informationen als genau angenommen werden, übernimmt IAR keine Verantwortung für Fehler oder Unterlassungen.