Dictionary entries in the EEPROM

[TG9541]

Using the EEPROM to store dictionary entries can free up more than 500 bytes of Flash memory for application software on a Low Density device - a non-negligible amount.

Since no code can be executed from the EEPROM, only ALIAS words are allowed

[TG9541]

Please be aware that the STM8 core will always go through a reset when executing binary code from EEPROM. Since it is still possible to have dictionary entries in the EEPROM the unique STM8 eForth ALIAS feature allows moving Forth headers from the core to the EEPROM!

The library word EEALIAS does the following:

• find the root of the dictionary in Flash memory
• unlink an existing the EEPROM
• create and link a dictionary in the EEPROM (i.e. EEPROM MODE )
• abort if a normal compilation (non-ALIAS words) is attempted

After defining ALIAS words, e.g. from a build's target directory, return to RAM MODE with EECLOSE when done.

When the dictionary entries in the EEPROM are no longer needed, EERESET can be used to unlink the dictionary in the Flash ROM.

\ EEPROM MODE Example:
\ define ALIAS words in the EEPROM, 
#include EEALIAS
\ load ALIAS words
#require SPACES
#require DIGIT
#require DNEGATE
\ done: return to normal, and WIPE RAM
EECLOSE