ewrl78 linker config flashlibs

Trio ICF

Apa tujuan dari proyek trio ICF?

Proyek Trio ICF dikembangkan untuk Workbench Tertanam IAR untuk Renesas RL78 Versi 3.10 atau lebih baru . Ini menggunakan satu set 3 file yang bersama -sama akan mengarah ke konfigurasi tautan yang tepat untuk persyaratan reservasi memori ketika ada pustaka flash RL78 yang digunakan.

Manfaat

• Memberikan pengaturan yang disederhanakan untuk proyek -proyek baru yang mengandalkan salah satu perpustakaan Flash RL78 .
• Mengurangi upaya pengembang ketika konfigurasi ulang linker diperlukan, khususnya saat penargetan ulang atau beralih ke perpustakaan flash RL78 yang berbeda.
• Mengambil keuntungan dari kemampuan linker IAR IAR IAR canggih dengan menempatkan bagian yang terkait dengan konstanta __near dari akhir area yang dapat dicerminkan. Fitur ini dapat menghasilkan fleksibilitas yang lebih besar berkat ruang flash yang berdekatan yang tersisa untuk penempatan bagian program pengguna pada perangkat RL78 yang dilengkapi dengan flash kode yang lebih kecil.

Detail (klik untuk dibuka)

Spesifikasi tata letak trio konfigurasi linker

Di bagian ini Anda akan menemukan gambaran tentang bagaimana komponen trio ICF cocok bersama.

Mengajukan	Keterangan
trio_lnkr5f1nnxn.icf	Yang pertama dapat dipilih pengguna . Pilihan dilakukan berdasarkan kesamaan dalam peta memori untuk kelompok target RL78 yang berbeda. Masing -masing file ini menahan parameter override konfigurasi tautan yang tepat yang dapat diatur pada opsi proyek . X dalam nomor bagian berarti bahwa konfigurasi linker ditawarkan terlepas dari jumlah pin target. Misalnya, TRIO_LNKR5F100XE.ICF harus dipilih untuk target R5F100LE .
Common.icf	Yang kedua secara otomatis disertakan dari konfigurasi yang dipilih pengguna. Ini adalah jantung dari trio, yang mengandung arahan parametrized yang dapat diterapkan pada salah satu target RL78 yang didukung.
self_ram.icf	Yang ketiga secara otomatis dimasukkan oleh Common.ICF untuk mengevaluasi simbol reservasi RAM yang digunakan oleh linker untuk memesan jumlah RAM yang sesuai (untuk RAM mandiri ) saat menggunakan trio.

Rasa Perpustakaan Flash

Renesas RL78 MCU membutuhkan serangkaian perpustakaan spesifik untuk memungkinkan penggunaan kenangan flash mereka.

Renesas Electronics menyediakan perpustakaan Flash RL78 dalam 3 rasa yang berbeda:

• FSL (Flash-Mrogramming Library) memang memprogram flash kode RL78.
• FDL (Flash Data Library) memang memprogram flash data RL78.
• Belut (pustaka emulasi EEPROM) memang meniru perilaku EEPROM pada flash data RL78. Ini memberikan lapisan fungsionalitas tambahan di atas tipe pustaka FDL pendamping yang sesuai (T01 atau T02 - dijelaskan di bawah). Ini memberikan leveling keausan transparan di antara blok flash data yang disediakan yang dapat, dalam praktiknya, hampir meningkatkan jumlah kemungkinan penulisan ulang.

Jenis Perpustakaan Flash

Rasa pustaka Flash RL78 dapat disediakan sebagai salah satu jenis perpustakaan berikut:

• T01 (Type01, juga dikenal sebagai penuh ) adalah pustaka flash yang sepenuhnya matang.
• T02 (Type02, juga dikenal sebagai Tiny ) adalah yang seimbang, memberikan fungsionalitas utama dengan biaya lebih sedikit sumber daya bila dibandingkan dengan perpustakaan T01.
• T04 (Type04, juga dikenal sebagai PICO ) adalah yang hanya menyediakan fungsionalitas esensial yang telanjang. Jenis perpustakaan ini menawarkan jejak penggunaan sumber daya terendah. Biasanya ini adalah pilihan yang cocok untuk skenario di mana target RL78 yang dipilih hadir dengan sumber daya memori terbatas.

Rambat diri

Biasanya untuk setiap kombinasi Perpustakaan Flash RL78 MCU dan RL78 , programmer perlu merujuk pada dokumen aplikasi aplikasi Renesas Electronics R20UT2944 untuk mengetahui apakah kombinasi yang dipilih akan memerlukan beberapa rentang RAM spesifik untuk dicadangkan, oleh karena itu kombinasi yang dipilih dapat berfungsi dengan baik.

Rusak sendiri mengacu pada area RAM yang disebutkan di atas, yang harus dicadangkan pada beberapa kasus, ketika mengandalkan kemampuan pemrograman diri RL78 MCU.

Untuk sangat menyederhanakan proses ini, trio ICF sebagian besar mengotomatiskannya, dengan memanfaatkan setiap arahan konfigurasi linker lanjutan yang tersedia untuk mengganti konfigurasi tautan default, sambil mengikuti persyaratan yang ditentukan dalam catatan aplikasi yang disebutkan di atas.

Catatan untuk informasi lebih lanjut mengenai set fitur lengkap dan persyaratan untuk masing -masing perpustakaan flash ini, lihat dokumentasi masing -masing.

Cara menggunakan trio ICF

Bagian berikut adalah panduan langkah demi langkah tentang cara membuat dan mengonfigurasi proyek yang memanfaatkan trio ICF dari awal.

Sebagai referensi, Dewan Promosi Renesas untuk RL78/G14 digunakan sebagai target untuk walkthrough. Contohnya menggunakan kombinasi perpustakaan flash yang paling populer.

Apapun, langkah -langkah serupa dapat digunakan dengan kombinasi target RL78 lainnya dan pustaka flash terkait.

Prasyarat

Dalam walkthrough ini, komponen -komponen berikut yang sudah diinstal atau diunduh:

• Instalasi default Workbench Tertanam IAR untuk Renesas RL78 v4.21.
• Perpustakaan Flash RL78 pilihan Anda, didistribusikan secara eksklusif oleh Renesas Electronics Corporation dan dapat diunduh dari situs Renesas Electronics Europe "MyPages" . Unduhan memerlukan pra-pendaftaran atau masuk jika Anda sudah menjadi pengguna terdaftar.

Catatan RL78 Flash Library Installers Wizard akan meminta Anda untuk "memilih wilayah Anda". Perpustakaan yang kompatibel dengan Workbench Tertanam IAR untuk Renesas RL78 V2.10+ ( <library-name>.a ) hanya tersedia untuk " Amerika/Eropa/Timur Tengah/Afrika " pada tulisan ini.

Simbol reservasi RAM

Tabel di bawah ini mencantumkan perpustakaan yang tersedia di samping dokumentasi masing -masing serta simbol penghubung yang diperlukan proyek yang digunakan untuk reservasi RAM.

Perpustakaan Flash RL78	Dokumentasi	Simbol	Cadangan sendiri untuk ...
T01-FSL	T01-FSL	__RESERVE_T01_FSL=1	... T01-FSL Flash Library
T01-fdl	T01-fdl	__RESERVE_T01_FDL=1	... T01-FDL Data Flash Library
T01-Eel	T01-Eel	__RESERVE_T01_EEL=1	... T01-EED EEPROM EMULASI PERPUSTAKAAN
T02-fdl	T02-fdl	__RESERVE_T02_FDL=1	... T02-FDL Data Flash Library
T02-eel	T02-eel	__RESERVE_T02_EEL=1	... T02-Eel Eeprom Emulation Library
T04-fdl	T04-fdl	__RESERVE_T04_FDL=1	... t04-fdl pico flash lbrary

Membuat proyek dasar dengan applilet3

Applilet3 dan AP4 adalah generator kode berbasis GUI yang dapat menghasilkan driver startup dan periferal di C untuk target RL78.

• Workbench tertanam IAR untuk Renesas RL78 menginstal generator kode applilet3 Renesas Electronics ' . Luncurkan alat Applilet3 .

• Buat proyek baru bernama Project Name yang menargetkan MCU Dewan (PN# R5F104LEAFA ), menggunakan kompiler IAR sebagai alat build .

• Pada tab PIN penugasan , klik pengaturan Fix .

• Pada tab Pengaturan Debug on-chip , aktifkan pengaturan operasi debug on-chip .

• Aktifkan deteksi tegangan rendah , memilih nilai koheren untuk VLVD , seperti 3.63V . Simpan proyek. Akhirnya, klik Generate Code .

Siapkan proyek di Workbench Tertanam IAR

• Mulailah Workbench Tertanam IAR untuk RL78 , simpan ruang kerja ( .eww ) pada folder proyek yang sama yang dibuat di tempat yang dipilih. Folder ini dapat (dan akan) dirujuk oleh Workbench tertanam IAR melalui variabel lingkungan bawaannya $PROJ_DIR$ .

Catatan $PROJ_DIR$ adalah variabel argumen internal yang diterjemahkan ke direktori yang berisi file proyek ( .ewp ). Seringkali digunakan untuk merujuk pada file sumber proyek, file header, dan pustaka dengan relatif pathnames (misalnya, $PROJ_DIR$/<dir>/<file> ). Workbench tertanam IAR menawarkan pilihan variabel argumen bawaan lainnya.

• Pilih Proyek → Buat Proyek Baru ... dan buat proyek RL78 yang kosong . Simpan di lokasi $PROJ_DIR$ proyek.

• Pilih Proyek → Tambahkan Koneksi Proyek ... dan arahkan ke file .ipcf yang telah dibuat oleh Applilet3 saat kode dihasilkan.

• Kloning repositori ini di dalam $PROJ_DIR$ .

Catatan Alternatif repositori ini dapat diunduh sebagai arsip .zip melalui tombol kode .

Contoh

Pilih salah satu contoh yang tersedia di bawah ini untuk melanjutkan.

Setiap contoh berisi langkah -langkah lebih lanjut untuk membuat program sederhana yang terdiri dari menyimpan/mengambil data persisten menggunakan berbagai kombinasi dari perpustakaan Flash RL78 yang paling populer.

Contoh	Membuat program yang akan ...
T04-fdl	... Latih flash data
T01-FSL	... Latih kode flash
T02-EEL & T02-FDL	... Latih data flash dipartisi ke dalam kumpulan belut dan kumpulan FDL

Masalah

Menemukan masalah atau memiliki saran yang terkait dengan repositori ini ? Jangan ragu untuk menggunakan pelacak masalah publik.

• Jangan lupa untuk melihat masalah sebelumnya.
• Jika membuat masalah baru, jelaskan secara detail.

Penafian

Informasi dalam repositori ini dapat berubah tanpa pemberitahuan dan tidak mewakili komitmen pada bagian mana pun dari IAR. Sementara informasi yang terkandung di sini dianggap akurat, IAR tidak bertanggung jawab atas kesalahan atau kelalaian.