annotate src/external_flash.inc @ 593:c31e0292bc92

doc update (clarification/correction of max. depth reading header data)
author heinrichsweikamp
date Sat, 28 Apr 2018 11:26:08 +0200
parents b455b31ce022
children c40025d8e750
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
heinrichsweikamp
parents:
diff changeset
1 ;=============================================================================
heinrichsweikamp
parents:
diff changeset
2 ;
582
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
3 ; File external_flash.inc V2.98
0
heinrichsweikamp
parents:
diff changeset
4 ;
heinrichsweikamp
parents:
diff changeset
5 ;
heinrichsweikamp
parents:
diff changeset
6 ; Copyright (c) 2011, JD Gascuel, HeinrichsWeikamp, all right reserved.
heinrichsweikamp
parents:
diff changeset
7 ;=============================================================================
heinrichsweikamp
parents:
diff changeset
8 ; HISTORY
heinrichsweikamp
parents:
diff changeset
9 ; 2011-08-12 : [mH] creation
heinrichsweikamp
parents:
diff changeset
10
heinrichsweikamp
parents:
diff changeset
11 ; Misc
582
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
12 extern incf_ext_flash_address_p1 ; +1 for the ext_flash_address:3
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
13 extern ext_flash_disable_protection ; Disables write protection
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
14 extern ext_flash_enable_protection ; Enables write protection
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
15
0
heinrichsweikamp
parents:
diff changeset
16 ; Writes
582
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
17 extern write_byte_ext_flash_plus ; Write from WREG and increase address after write with banking at 0x200000
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
18 extern write_byte_ext_flash_plus_nocnt ; No increase of ext_flash_dive_counter:3
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
19 extern write_byte_ext_flash_plus_nodel ; Does NOT delete 4kB Page when required
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
20 extern write_byte_ext_flash_plus_header ; Write from WREG and increase address after write
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
21 extern ext_flash_byte_write ; Writes one byte from WREG @ext_flash_address:3
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
22 extern ext_flash_byte_write_comms ; without wait, ~86us fixed delay due to 115200 Bauds (Use with caution)
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
23 extern write_spi1 ; Just (dummy)write to read a byte
0
heinrichsweikamp
parents:
diff changeset
24
582
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
25 ; Delete
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
26 extern ext_flash_erase_logbook ; erases logbook memory (000000h -> 2FFFFFh -> 3MByte)
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
27 extern ext_flash_erase4kB ; Erases 4kB sector @ext_flash_address:3
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
28
0
heinrichsweikamp
parents:
diff changeset
29 ; Reads
582
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
30 extern ext_flash_read_block_start ; Block read start and reads one byte@ext_flash_address:3 into WREG
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
31 extern ext_flash_read_block ; Read another byte into WREG
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
32 extern ext_flash_read_block_stop ; Stop block read
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
33 extern ext_flash_byte_read ; Reads one byte@ext_flash_address:3 into WREG and ext_flash_rw
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
34 extern ext_flash_byte_read_plus ; Return data read in WREG and ext_flash_rw and increase address after read with banking at 0x200000
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
35 extern ext_flash_byte_read_plus_0x20 ; Return data read in WREG and ext_flash_rw
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
36
0
heinrichsweikamp
parents:
diff changeset
37
heinrichsweikamp
parents:
diff changeset
38 ; Will decrease ext_flash_address:2 with the 8Bit value "ext_flash_temp1"
heinrichsweikamp
parents:
diff changeset
39 extern decf_ext_flash_address0
heinrichsweikamp
parents:
diff changeset
40 decf_ext_flash_address macro ext_flash_temp1
582
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
41 movlw ext_flash_temp1
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
42 call decf_ext_flash_address0
0
heinrichsweikamp
parents:
diff changeset
43 endm
heinrichsweikamp
parents:
diff changeset
44
heinrichsweikamp
parents:
diff changeset
45
582
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
46 ; Will increase ext_flash_address:2 with the 8Bit value "ext_flash_temp1"
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
47 extern incf_ext_flash_address0
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
48 incf_ext_flash_address macro ext_flash_temp1
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
49 movlw ext_flash_temp1
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
50 call incf_ext_flash_address0
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
51 endm
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
52
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
53
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
54 ; With banking at 0x200000
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
55 ; Will increase ext_flash_address:2 with the 8Bit value "ext_flash_temp1"
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
56 extern incf_ext_flash_address0_0x20
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
57 incf_ext_flash_address_0x20 macro ext_flash_temp1
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
58 movlw ext_flash_temp1
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
59 call incf_ext_flash_address0_0x20
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
60 endm
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
61
b455b31ce022 work on 2.97 stable
heinrichsweikamp
parents: 561
diff changeset
62