113 to a valid stack. </p> </li> |
113 to a valid stack. </p> </li> |
114 </ul> </section> |
114 </ul> </section> |
115 <section id="GUID-1C4372C8-DFC8-5989-AC10-5A12F661AE70"><title>BTF_RamBanks</title> <p><b>What the function should do</b> </p> <p>This function should return a |
115 <section id="GUID-1C4372C8-DFC8-5989-AC10-5A12F661AE70"><title>BTF_RamBanks</title> <p><b>What the function should do</b> </p> <p>This function should return a |
116 pointer to a list of RAM banks that are present. </p> <p>The list should be |
116 pointer to a list of RAM banks that are present. </p> <p>The list should be |
117 a sequence of two-word entries. Each entry has the following format: </p> <fig id="GUID-3B76398A-AE4C-563B-BB52-3701983D01B4"> |
117 a sequence of two-word entries. Each entry has the following format: </p> <fig id="GUID-3B76398A-AE4C-563B-BB52-3701983D01B4"> |
118 <image href="GUID-921AF7A3-C711-5979-877B-4B6D977888E8_d0e285569_href.png" placement="inline"/> |
118 <image href="GUID-921AF7A3-C711-5979-877B-4B6D977888E8_d0e291561_href.png" placement="inline"/> |
119 </fig> <p>The list is terminated by an entry that has a zero MAXSIZE. </p> <p>Of |
119 </fig> <p>The list is terminated by an entry that has a zero MAXSIZE. </p> <p>Of |
120 the 32 flag bits, only one is currently defined; all undefined flags should |
120 the 32 flag bits, only one is currently defined; all undefined flags should |
121 be zero. Flag 0, which is bit 0 of the first word is the <codeph>RAM_VERBATIM</codeph> flag |
121 be zero. Flag 0, which is bit 0 of the first word is the <codeph>RAM_VERBATIM</codeph> flag |
122 and is interpreted as follows: </p> <ul> |
122 and is interpreted as follows: </p> <ul> |
123 <li id="GUID-415A4838-2858-5EE5-B9F4-D55CDD9AE02C"><p>If clear, the specified |
123 <li id="GUID-415A4838-2858-5EE5-B9F4-D55CDD9AE02C"><p>If clear, the specified |
180 <section id="GUID-52792290-48DA-5F1A-A7AD-0105A8AA37CF"><title>BTF_RomBanks</title> <p><b>What the function should do</b> </p> <p>This function should return a |
180 <section id="GUID-52792290-48DA-5F1A-A7AD-0105A8AA37CF"><title>BTF_RomBanks</title> <p><b>What the function should do</b> </p> <p>This function should return a |
181 pointer to a list of XIP ROM banks that are present. It is not called if the |
181 pointer to a list of XIP ROM banks that are present. It is not called if the |
182 bootstrap is found to be running in RAM; in this case it is assumed that all |
182 bootstrap is found to be running in RAM; in this case it is assumed that all |
183 XIP code is in RAM. </p> <p>The list should be a sequence of four-word entries. |
183 XIP code is in RAM. </p> <p>The list should be a sequence of four-word entries. |
184 Each entry has the following format: </p> <fig id="GUID-35A65482-24F6-5F9A-83B8-ED490F651A9A"> |
184 Each entry has the following format: </p> <fig id="GUID-35A65482-24F6-5F9A-83B8-ED490F651A9A"> |
185 <image href="GUID-4E6520E8-4BF1-55D1-B643-81B8D2816D1D_d0e285809_href.png" placement="inline"/> |
185 <image href="GUID-4E6520E8-4BF1-55D1-B643-81B8D2816D1D_d0e291801_href.png" placement="inline"/> |
186 </fig> <p>The list is terminated by a zero value four-word entry. </p> <p>Only |
186 </fig> <p>The list is terminated by a zero value four-word entry. </p> <p>Only |
187 the first, second and fourth words of each entry are actually used by the |
187 the first, second and fourth words of each entry are actually used by the |
188 rest of the bootstrap. The third is there mainly to support autodetection |
188 rest of the bootstrap. The third is there mainly to support autodetection |
189 schemes. </p> <p>The <xref href="GUID-25941CD2-D124-55DD-8716-ACC93E3F1D6C.dita#GUID-25941CD2-D124-55DD-8716-ACC93E3F1D6C/GUID-7361BC74-7164-52EE-9A5B-D254560D1939">ROM_BANK</xref> macro |
189 schemes. </p> <p>The <xref href="GUID-25941CD2-D124-55DD-8716-ACC93E3F1D6C.dita#GUID-25941CD2-D124-55DD-8716-ACC93E3F1D6C/GUID-7361BC74-7164-52EE-9A5B-D254560D1939">ROM_BANK</xref> macro |
190 can be used to declare ROM bank entries. </p> <p><b>Entry conditions</b> </p> <ul> |
190 can be used to declare ROM bank entries. </p> <p><b>Entry conditions</b> </p> <ul> |