
105
AT89C51RB2/RC2
4180E–8051–10/06
API Call Description
Several Application Program Interface (API) calls are available for use by an application
program to permit selective erasing and programming of Flash pages. All calls are made
through a common interface, PGM_MTP. The programming functions are selected by
setting up the microcontroller’s registers before making a call to PGM_MTP at FFF0h.
Results are returned in the registers.
When several Bytes have to be programmed, it is highly recommended to use the Atmel
API “PROGRAM DATA PAGE” call. Indeed, this API call writes up to 128 Bytes in a sin-
gle command.
All routines for software access are provided in the C Flash driver available at Atmel’s
web site.
The API calls description and arguments are shown in
Table 74.Table 74. API Call Summary
Command
R1
A
DPTR0
DPTR1
Returned Value
Command Effect
READ MANUF ID
00h
XXh
0000h
XXh
ACC = Manufacturer
Id
Read Manufacturer identifier
READ DEVICE ID1
00h
XXh
0001h
XXh
ACC = Device Id 1
Read Device identifier 1
READ DEVICE ID2
00h
XXh
0002h
XXh
ACC = Device Id 2
Read Device identifier 2
READ DEVICE ID3
00h
XXh
0003h
XXh
ACC = Device Id 3
Read Device identifier 3
ERASE BLOCK
01h
XXh
DPH = 00h
00h
ACC = DPH
Erase block 0
DPH = 20h
Erase block 1
DPH = 40h
Erase block 2
PROGRAM DATA
BYTE
02h
Vaue to write
Address of
byte to
program
XXh
ACC = 0: DONE
Program up one data byte in the on-chip
flash memory.
PROGRAM SSB
05h
XXh
DPH = 00h
DPL = 00h
00h
ACC = SSB value
Set SSB level 1
DPH = 00h
DPL = 01h
Set SSB level 2
DPH = 00h
DPL = 10h
Set SSB level 0
DPH = 00h
DPL = 11h
Set SSB level 1
PROGRAM BSB
06h
New BSB
value
0000h
XXh
none
Program boot status byte
PROGRAM SBV
06h
New SBV
value
0001h
XXh
none
Program software boot vector
READ SSB
07h
XXh
0000h
XXh
ACC = SSB
Read Software Security Byte
READ BSB
07h
XXh
0001h
XXh
ACC = BSB
Read Boot Status Byte
READ SBV
07h
XXh
0002h
XXh
ACC = SBV
Read Software Boot Vector
PROGRAM DATA
PAGE
09h
Number of
byte to
program
Address of
the first byte
to program in
the Flash
memory
Address in
XRAM of the
first data to
program
ACC = 0: DONE
Program up to 128 bytes in user Flash.
Remark: number of bytes to program is
limited such as the Flash write remains in a
single 128 bytes page. Hence, when ACC
is 128, valid values of DPL are 00h, or, 80h.