ZBasic System Library
220
ZBasic Microcontrollers
Type
Subroutine
Invocation
PersistentPoke(value, address)
Parameter
Method
Type
Description
value
ByVal
Byte
The to write to persistent memory.
address
ByVal
int16
The persistent memory address to which to write.
Discussion
This routine will write the given value to the specified persistent memory address.
The address of any persistent variable can also be obtained using the DataAddress property. For
persistent variables, the DataAddress property is of type UnsignedInteger.
Caution
The first 32 bytes of persistent memory are reserved for the system. Modifying any of them may produce
unpredictable results.
The persistent memory (on-board EEPROM) has a limit specified by the manufacturer of a million write
cycles. When this limit is exceeded the memory may become unreliable.
Example
Dim pi as PersistentInteger
Call PersistentPoke(&H55, 1000)
Call PersistentPoke(&H55, pi.DataAddress + 1)
The second use of PersistentPoke() demonstrates how you can use the DataAddress property to
write a byte value to any part of a persistent variable of any type.
Compatibility
BasicX does not support the use of the DataAddress property for persistent items.
The BasicX system has only 512 bytes of persistent memory. In ZBasic, the amount of persistent
memory available depends on the particular target device; the first 32 bytes of persistent memory are
reserved for system use.
See Also
 |
 |
 |