safwriteword - Anobium/Great-Cow-BASIC-Help GitHub Wiki
Syntax:
SAFWriteWord ( location, data_word_value )
Command Availability:
Available on all PIC micro-controllers with SAFM memory
Explanation:
SAFWriteWord is used to write information, word values, to the SAFM data storage, so that it can be accessed later by a programmer on a Personal, or by the SAFRead commands.
location
presents the location or relative address to write. The
location will range from 0 to SAF_BYTES -1. Each data Word requires
2 SAF Locations, therefore the location will range from either 0 to 254
or 0 to 126 (in steps of 2), depending upon the device.
data
is the data that is to be written to the SAFM location. This
can be a word value or a word variable.
This method writes information to SAFM given the specific location in SAFM. This method is similar to the methods for EEPROM, but supports Word values.
Example 1:
'... code preamble to select part
'... code to setup serial
'The following example stores in the word value of 0x1234 as SAFM location 34
SAFWriteWord( 34, 0x1234 )
Example 2:
#chip 18F24K42, 16
'... code to setup PPS
'... code to setup serial
'This example will write two word values to two specific locations.
dim Word_Variable1 as Word
dim Word_Variable2 as Word
;Write the data
SAFWriteWord (16, 0x1234) 'location 16, in this device, equates to 0x7F10
SAFWriteWord (18, 0x4321) 'location 18, in this device, equates to 0x7F12
;Read the data and send to terminal
SAFReadWord(16, Word_Variable1 )
SAFReadWord(18, Word_Variable2 )
HserPrint "Word_Variable1 = "
Hserprint Word_Variable1
HSerPrintCRLF
HserPrint "Word_Variable2 = "
Hserprint Word_Variable2
HSerPrintCRLF
If example 2 were displayed on a serial terminal. The result would
show, where ----
is the existing value.
Word_Variable1 = 4660
Word_Variable2 = 17185
See also SAFM Overview, SAFRead, SAFReadWord, SAFWrite, SAFWriteWord, SAFReadBlock, SAFWriteBlock, SAFEraseBlock