Changes for page API контроллеров AZ®
Last modified by Max on 2025/03/02 15:18
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1033,31 +1033,29 @@ 1033 1033 1034 1034 {{code language="assembler"}} 1035 1035 ;-------------------------------------------------- 1036 -; карта76йстраницы-тудамыготовимданныедлякомандыскринщотов1037 - уюстраницуцепляемнаместо77йвременно-тевокно1300001038 - тутвход- 240 - 1слово1039 - сюдакомандусадресами-адрес+длина24бита- 4слова1040 - сюдакомандусостраницами-начальнаястраницаиколичествостраниц- 2слова1041 - cюдаконфигурациюпамятиизрегистров- 22слова1042 - сюдаконфигурациювидеоконтроллера- 10cлов1043 - сюда338.значений(слов)палитры338слов1036 +; 76th page map - we prepare data for the screenshot command there 1037 +SCR_PAGE = 130000 ; we temporarily attach the 76th page to the 77th - that is, into the 130000 window 1038 +SCR_TAG = SCR_PAGE+0 ; here is the input - 240 - 1 word 1039 +SCR_ADDR_CONF = SCR_TAG+2 ; here is the command with addresses - address+length 24 bits - 4 words 1040 +SCR_PAGE_CONF = SCR_ADDR_CONF+8. ; here is the command with pages - the starting page and the number of pages - 2 words 1041 +SCR_MEM_CONF = SCR_PAGE_CONF+4. ; here is the memory configuration from the registers - 22 words 1042 +SCR_VGA_CONF = SCR_MEM_CONF+44. ; here video controller configuration - 10 words 1043 +SCR_PAL = SCR_VGA_CONF+20. ; here 338. values (words) of palette 338 words 1044 1044 ;-------------------------------------------------- 1045 +; trap 41 - preparation of default information for screenshot functionality 1046 +PrepSRC: jsr R5, PUSHA ; batch saving of registers 1047 + mov @#177326,-(SP) ; save page 130k which was before the call 1048 + mov #76,@#177326 ; hook 76th page into window 1045 1045 1046 - 1047 -; trap 41 - подготовка дефолтной информации для работы функционала скриншотов 1048 -PrepSRC: jsr R5, PUSHA ; пакетное сохранение регистров 1049 - mov @#177326,-(SP) ; сохраним страницу 130k которая была до вызова 1050 - mov #76,@#177326 ; цепляем 76ую страницу в окно 1051 - 1052 - mov #100377,R3 ; константа-заполнитель 1050 + mov #100377,R3 ; constant-filler 1053 1053 mov #SCR_PAGE,R4 1054 1054 mov #2047.,R2 1055 1055 4$: mov R3,(R4)+ 1056 1056 sob R2,4$ 1057 1057 1058 - mov #240,@#SCR_TAG ; проставляемтег1056 + mov #240,@#SCR_TAG ; put the tag 1059 1059 1060 - ; чистимучастокадресов-дефолтноавтоматическоеопределениеадресов1058 + ; clean the address section - default is automatic address detection 1061 1061 clr R3 1062 1062 mov #SCR_ADDR_CONF,R4 1063 1063 mov #10,R2 ... ... @@ -1064,7 +1064,7 @@ 1064 1064 2$: mov R3,(R4)+ 1065 1065 sob R2,2$ 1066 1066 1067 - ; конфигурацияпамяти-дефолтная1065 + ; memory configuration - default 1068 1068 mov #SCR_MEM_CONF,R4 1069 1069 mov #30,(R4)+ ;177300 1070 1070 mov #31,(R4)+ ;177302 ... ... @@ -1083,29 +1083,29 @@ 1083 1083 mov #110,(R4)+ ;177334 1084 1084 mov #100,(R4)+ ;177336 1085 1085 1086 - mov #170000,(R4)+ ;177340 - Регистр управления активацией окно - маски окон1087 - mov R3,(R4)+ ;177342 - Регистр управления r/o на окно1088 - mov #7777,(R4)+ ;177344 - Регистр управления shadow окон - маски окон1089 - mov #40404,(R4)+ ;177346 - Регистр управления маппером1090 - mov R3,(R4)+ ;177350 - регистр копия по записи 177130 в режиме записи управления памятью в SMK1091 - mov #16000,(R4)+ ;177352 - регистр копия по записи 177716 в режиме записи управления памятью в БК11М1084 + mov #170000,(R4)+ ;177340 1085 + mov R3,(R4)+ ;177342 1086 + mov #7777,(R4)+ ;177344 1087 + mov #40404,(R4)+ ;177346 1088 + mov R3,(R4)+ ;177350 1089 + mov #16000,(R4)+ ;177352 1092 1092 1093 - ; конфигурациявидеоконтроллера-дефолтная1091 + ;Video controller configuration - default 1094 1094 ; 177230-177256 1095 1095 mov #SCR_VGA_CONF,R4 1096 1096 1097 - mov #12201,(R4)+ ;177230 - регистр управления1098 - mov #4,(R4)+ ;177232 - регистр номера страницы начала отображения - верхняя страница (слой 0)1099 - mov R3,(R4)+ ;177240 - регистр номера страницы начала отображения - средняя страница (слой 1) "под спрайты"1100 - mov R3,(R4)+ ;177242 - регистр номера страницы начала отображения - нижняя страница (слой 2) "под фон"1101 - mov R3,(R4)+ ;177244 - регистр вертикального скролинга слой 21102 - mov R3,(R4)+ ;177246 - регистр вертикального скролинга слой 11103 - mov R3,(R4)+ ;177250 - регистр вертикального скролинга слой 01104 - mov R3,(R4)+ ;177252 - регистр гозизонтального скролинга слой 01105 - mov R3,(R4)+ ;177254 - регистр гозизонтального скролинга слой 11106 - mov R3,(R4)+ ;177256 - регистр гозизонтального скролинга слой 21095 + mov #12201,(R4)+ ;177230 1096 + mov #4,(R4)+ ;177232 1097 + mov R3,(R4)+ ;177240 1098 + mov R3,(R4)+ ;177242 1099 + mov R3,(R4)+ ;177244 1100 + mov R3,(R4)+ ;177246 1101 + mov R3,(R4)+ ;177250 1102 + mov R3,(R4)+ ;177252 1103 + mov R3,(R4)+ ;177254 1104 + mov R3,(R4)+ ;177256 1107 1107 1108 - ; закачиваемпалитру-беремдефолтнуюизэтойПЗУшки1106 + ; download the palette - take the default one from this ROM 1109 1109 mov #SCR_PAL,R4 1110 1110 mov #PalData,R2 1111 1111 mov #338.,R3 ... ... @@ -1112,233 +1112,233 @@ 1112 1112 1$: mov (R2)+,(R4)+ 1113 1113 sob R3,1$ 1114 1114 1115 - mov (SP)+,@#177326; вернемстраницускоторойбылвызов1113 + mov (SP)+,@#177326; return the page from which the call was made 1116 1116 return 1117 1117 {{/code}} 1118 1118 1119 - Вариантовуказанияучастковпамятитри1117 +There are three options for specifying memory areas. 1120 1120 1121 -1. указатьадресидлину24хбитные-cмформат,еслиихнет-системасмотритдальше1122 -1. указатьномерстраницыиколичествостраницы,еслиихнет1123 -1. системасмотритдальше-теделаетскриншотнаоснованииданныхорегистрах177230и т.д..1119 +1. specify the address and length 24-bit - see format, if they are not there - the system looks further 1120 +1. specify the page number and page quantity, if they are not there 1121 +1. the system looks further - that is, it makes a screenshot based on the data about registers 177230, etc. 1124 1124 1125 - Cкриншотсохраняетсявформате1126 -- страница76 -еепервыйкилобайт1127 -- самобразпамяти(еслирежимслоеный-товсетрислоя)1123 +The screenshot is saved in the format 1124 +- page 76 - its first kilobyte 1125 +- the memory image itself (if the mode is layered - then all three layers) 1128 1128 1129 1129 1130 -Перед вызовом команды можно загрузить имя файла для сохранения скриншота [в cmosmem буфер], однако при его отсутствии (в буфере не будет имени - строки заканчивающейся 0) система сформирует свое имя, на основании следующего правила: 1131 -дефолтный путь для сохранения скриншотов 1128 +Before calling the command, you can load the file name for saving the screenshot [in the cmosmem buffer], but if it is missing (there will be no name in the buffer - a line ending with 0), the system will generate its own name based on the following rule: default path for saving screenshots 1132 1132 0:/SCREENS/ 1133 - форматимени- DDHHMISS.SCR1134 - гдеDD-двецифрыднямесяца, HH-час, MI-минута, SS-секунда1135 -\\ Есливпроцессевыполнениякомандывозникнетошибка-вместоименибудет"ERROR *"1136 - кпримеру1130 +name format - DDHHMISS.SCR 1131 +where DD is two digits of the day of the month, HH is the hour, MI is the minute, SS is the second 1132 +\\If an error occurs during the command execution, the name will be "ERROR *" 1133 +for example 1137 1137 "ERROR f_open 6" 1138 1138 1139 1139 1140 - Примерпрограммы1137 +Example program 1141 1141 1142 1142 {{code language="assembler"}} 1143 -; обновиминформациювхидерескриншота1140 +; update the information in the screenshot header 1144 1144 ;-------------------------------------------------- 1145 -; карта76йстраницы-тудамыготовимданныедлякомандыскринщотов1146 - 70000уюстраницуцепляемнаместо77йвременно-тевокно1300001147 - тутвход- 240 - 1слово1148 - сюдакомандусадресами-адрес+длина24бита- 4слова1149 - сюдакомандусостраницами-начальнаястраницаиколичествостраниц- 2слова1150 - cюдаконфигурациюпамятиизрегистров- 22слова1151 - сюдаконфигурациювидеоконтроллера- 10cлов1152 - сюда338.значений(слов)палитры338слов1142 +; 76th page map - we prepare data for the screenshot command there 1143 +SCR_PAGE = 130000 ; we temporarily attach the 76th page to the 77th - that is, into the 130000 window 1144 +SCR_TAG = SCR_PAGE+0 ; here is the input - 240 - 1 word 1145 +SCR_ADDR_CONF = SCR_TAG+2 ; here is the command with addresses - address+length 24 bits - 4 words 1146 +SCR_PAGE_CONF = SCR_ADDR_CONF+8. ; here is the command with pages - the starting page and the number of pages - 2 words 1147 +SCR_MEM_CONF = SCR_PAGE_CONF+4. ; here is the memory configuration from the registers - 22 words 1148 +SCR_VGA_CONF = SCR_MEM_CONF+44. ; here video controller configuration - 10 words 1149 +SCR_PAL = SCR_VGA_CONF+20. ; here 338. values (words) of palette 338 words 1153 1153 ;-------------------------------------------------- 1151 + mov @#177326,R5 ; save page 130k which was before the call 1152 + mov #76,@#177336 ; hook the 76th page into the window 1154 1154 1155 - mov @#177326,R5 ; сохраним страницу 130k которая была до вызова 1156 - mov #76,@#177336 ; цепляем 76ую страницу в окно 1157 - 1158 - ;конфигурация видеоконтроллера 1154 + ;video controller configuration 1159 1159 ; 177230-177256 1160 1160 mov #SVGAC,R4 1161 1161 1162 - mov @#177230,(R4)+;177230 - региструправления1163 - mov @#177232,(R4)+;177232 - регистрверхняястраница(слой0)1164 - mov @#177240,(R4)+;177240 - регистрсредняястраница(слой1)1165 - mov @#177242,(R4)+;177242 - регистр-нижняястраница(слой2)1166 - mov @#177244,(R4)+;177244 - регистрвертикальногоскролингаслой21167 - mov @#177246,(R4)+;177246 - регистрвертикальногоскролингаслой11168 - mov @#177250,(R4)+;177250 - регистрвертикальногоскролингаслой01169 - mov @#177252,(R4)+;177252 - регистргозизонтальногоскролингаслой01170 - mov @#177254,(R4)+;177254 - регистргозизонтальногоскролингаслой11171 - mov @#177256,(R4)+;177256 - регистргозизонтальногоскролингаслой21158 + mov @#177230,(R4)+;177230 - control register 1159 + mov @#177232,(R4)+;177232 - register - top page (layer 0) 1160 + mov @#177240,(R4)+;177240 - register - top page (layer 1) 1161 + mov @#177242,(R4)+;177242 - register - top page (layer 2) 1162 + mov @#177244,(R4)+;177244 - vertical scroll register layer 2 1163 + mov @#177246,(R4)+;177246 - vertical scroll register layer 1 1164 + mov @#177250,(R4)+;177250 - vertical scroll register layer 0 1165 + mov @#177252,(R4)+;177252 - horizontal scroll register layer 0 1166 + mov @#177254,(R4)+;177254 - horizontal scroll register layer 1 1167 + mov @#177256,(R4)+;177256 - horizontal scroll register layer 2 1172 1172 1173 - mov R5,@#177336; вернемстраницускоторойбылвызов1169 + mov R5,@#177336; return the page from which the call was made 1174 1174 1175 1175 1176 1176 ;------------------------- 1177 - MOV #AZ$CSR,R3 ; ГотовимCSRконтроллера1178 - MOV #AZ$DR,R4 ; ГотовимDRконтроллера1179 -20$: CLR (R3) ; Сбросимконтроллер1173 + MOV #AZ$CSR,R3 ; Preparing controller CSR 1174 + MOV #AZ$DR,R4 ; Preparing controller DR 1175 +20$: CLR (R3) ; Reset the controller 1180 1180 TSTB (R3) 1181 1181 BPL 20$ 1182 1182 1183 - ; очистимблокпамятидляимени-дабысистемасделаладефолтноеимяфайла1184 - mov #23,(R3) ; командуемчтобудемписатьданныевбуфер1185 -128$: TSTB (R3) ; проверяемрезультатвыполнения1186 - BPL 128$ ; ждем1179 + ; clear the memory block for the name - so that the system makes a default file name 1180 + mov #23,(R3) ; command that we will write data to the buffer 1181 +128$: TSTB (R3) ; check the result of execution 1182 + BPL 128$ ; wait 1187 1187 clr R1 1188 1188 1189 1189 mov #256.,R2 ; 1190 -129$: mov R1,(R4) ; отдаемвконтроллер1186 +129$: mov R1,(R4) ; give to the controller 1191 1191 sob R2,129$ 1192 1192 1193 1193 1194 - MOV #044,(R3) ; командаскриншот1190 + MOV #044,(R3) ; screenshot command 1195 1195 22$: TSTB (R3) ; 1196 1196 BPL 22$ ; 1197 1197 1198 - ; получимимяскриншота1199 - mov #22,(R3) ; отдатьнашинусчитанныйблокпамятиизбуфера1200 -121$: tstb (R3) ; проверяемрезультатвыполнения1201 - bpl 121$ ; ждем1194 + ; get the screenshot name 1195 + mov #22,(R3) ; give the read memory block from the buffer to the bus 1196 +121$: tstb (R3) ; check the result of execution 1197 + bpl 121$ ; wait 1202 1202 1203 1203 mov #BUF,R1 1204 - mov #256.,R2 ; читаем256.слов;первоеслово-результатчтения1205 -122$: mov (R4),(R1)+ ; читаемблоксловвпамять1200 + mov #256.,R2 ; read 256. words; the first word is the result of reading 1201 +122$: mov (R4),(R1)+ ; read a block of words into memory 1206 1206 sob R2,122$ 1207 1207 1208 1208 .PRINT #RESOK 1209 1209 .Print #BUF 1210 1210 1211 - mov #110,@#AZ$CSR; включаемсетьпо-умолчаниюсетьдолжнабытьпостоянновключена1207 + mov #110,@#AZ$CSR; enable the network by default, the network should be constantly enabled 1212 1212 .Exit 1213 1213 {{/code}} 1214 1214 1215 - Дляраспаковкискриншотаможноиспользоватьвотэтуутилиту1211 +To unpack a screenshot, you can use this utility - [[https:~~/~~/master.pdp-11.ru/screen_unpack/>>https://master.pdp-11.ru/screen_unpack/]] 1216 1216 1217 1217 1218 1218 1219 -= **КомандыдляработысостекомTCP/IP**=1215 += Commands for working with the TCP/IP stack = 1220 1220 1221 - следующиекомандыработаютсбуфероминформацииTCP/IP cтека.1217 +The following commands operate on the TCP/IP stack information buffer. 1222 1222 1223 -== **040:Получитьipадресипрочиенастройки стекаTCP/IPвбуфер**==1219 +== 040: Get IP address and other TCP/IP stack settings to buffer == 1224 1224 1225 - Кодкоманды040,даннаякомандазаполняетбуферинформациейсTCP/IP cтекатекущей(фактической)информацией.1221 +Command code 040, this command fills the buffer with information from the TCP/IP stack with current (actual) information. 1226 1226 1227 -== **041:Чтениебуфераipадреса**==1223 +== 041: Reading ip address buffer == 1228 1228 1229 - Кодкоманды041,даннаякомандапередаетбуфернашину1225 +Command code 041, this command transfers the buffer to the bus 1230 1230 1231 - этапаракомандпозволяетполучитьтекущуюинформациюсостека1227 +This pair of commands allows you to get current information from the stack 1232 1232 1233 -* IP адрес1234 -* MASK маску1235 -* GW гейтвей1236 -* NTP адресNTP-сервера1237 -* DNS1 адресосновногоDNS1238 -* DNS2 адресрезервногоDNS1229 +* IP address 1230 +* MASK mask 1231 +* GW gateway 1232 +* NTP address of the NTP server 1233 +* DNS1 primary DNS address 1234 +* DNS2 backup DNS address 1239 1239 1240 - соответственноэто12слов1236 +accordingly it is 12 words 1241 1241 1242 - Примерпрограммы:1238 +Example program: 1243 1243 1244 1244 {{code language="assembler"}} 1245 -; trap 52 - чтение блока IP адресов в блок памяти IPADDDBLOCK (8. ячеек) 1246 -; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK) 1247 -GetIPaddrs: push R1 1248 - push R2 1249 - call AZreset; сбросим 1250 - tst R1 1251 - bne 0ERR$ 1252 - MOV #AZ$CSR,R1 1253 - mov #40,(R1) 1254 -0$: TSTB (R1); прочитать адреса в свою память 1255 - BPL 0$; ждем 1256 - mov #41,(R1) 1257 -1$: TSTB (R1); подготовить буфер 1258 - BPL 1$; ждем 1259 - TST (R1)+; инкрементируем 1260 - mov #IPADDDBLOCK,R3 1261 - mov #12.,R2 1262 -2$: mov (R1),(R3)+; читаем блок слов в память 1263 - sob R2,2$ 1264 - mov #IPADDDBLOCK,R3; успешно 1265 - br 0END$ 1266 -0ERR$: CLR R3 1267 -0END$: pop R2 1268 - pop R1 1269 - return 1241 +; trap 52 - reading a block of IP addresses into the IPADDDBLOCK memory block (8 cells) 1242 +; result in R3 = 0 if error, otherwise the address where it was read (IPADDDBLOCK) 1243 +GetIPaddrs: push R1 1244 + push R2 1245 + call AZreset; reset 1246 + tst R1 1247 + bne 0ERR$ 1248 + MOV #AZ$CSR,R1 1249 + mov #40,(R1) 1250 +0$: TSTB (R1); read addresses into its memory 1251 + BPL 0$; wait 1252 + mov #41,(R1) 1253 +1$: TSTB (R1); prepare buffer 1254 + BPL 1$; wait 1255 + TST (R1)+; increment 1256 + mov #IPADDDBLOCK,R3 1257 + mov #12.,R2 1258 +2$: mov (R1),(R3)+; read block of words into memory 1259 + sob R2,2$ 1260 + mov #IPADDDBLOCK,R3; success 1261 + br 0END$ 1262 +0ERR$: CLR R3 1263 +0END$: pop R2 1264 + pop R1 1265 + return 1266 + 1270 1270 {{/code}} 1271 1271 1272 - Примерданных1269 +Example return data: 1273 1273 1274 1274 {{info}} 1275 - Примерыданных-возвращаемыесловаввосьмеричномформате1276 -124300 116400 - IP адрес192.168.0.1571277 -177777 000377 - MASK маску255.255.255.01278 -124300 000400 - GW гейтвей192.168.0.11279 -124300 000400 - NTP адресNTP-сервера192.168.0.11280 -124300 050000 - DNS1 адресосновногоDNS 192.168.0.901281 -124300 055000 - DNS2 адресрезервногоDNS 192.168.0.801272 +Data examples - words returned in octal format 1273 +124300 116400 - IP address 192.168.0.157 1274 +177777 000377 - MASK mask 255.255.255.0 1275 +124300 000400 - GW gateway 192.168.0.1 1276 +124300 000400 - NTP address of NTP server 192.168.0.1 1277 +124300 050000 - DNS1 address of primary DNS 192.168.0.90 1278 +124300 055000 - DNS2 address of backup DNS 192.168.0.80 1282 1282 {{/info}} 1283 1283 1284 -== **043:чтениеMAC-адресавipбуфер**==1281 +== 043: Read MAC address into ip buffer == 1285 1285 1286 -Код команды 043, данная команда читает текущий фактический MAC адрес в буфер IP адресов 1287 -те сначала 043, а затем 041 команды 1283 +Command code 043, this command reads the current actual MAC address into the IP address buffer i.e. first 043 and then 041 commands 1288 1288 1289 - Примерпрограммы:1285 +Example program: 1290 1290 1291 1291 {{code language="assembler"}} 1292 -; trap 72 - чтение MAC адреса в блок памяти IPADDDBLOCK (12. ячеек) 1293 -; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK) 1294 -GetMACaddrs: push R1 1295 - push R2 1296 - call AZreset ; сбросим 1297 - tst R1 1298 - bne 0ERR$ 1299 - MOV #AZ$CSR,R1 1300 - mov #43,(R1) 1301 -0$: TSTB (R1) ; прочитать адреса в свою память 1302 - BPL 0$ ; ждем 1303 - mov #41,(R1) 1304 -1$: TSTB (R1) ; подготовить буфер 1305 - BPL 1$ ; ждем 1306 - TST (R1)+ ; инкрементируем 1307 - mov #IPADDDBLOCK,R3 1308 - mov #12.,R2 1309 -2$: mov (R1),(R3)+ ; читаем блок слов в память 1310 - sob R2,2$ 1311 - mov #IPADDDBLOCK,R3; успешно 1312 - br 0END$ 1313 -0ERR$: CLR R3 1314 -0END$: pop R2 1315 - pop R1 1316 - retur 1288 +; trap 72 - reading the MAC address into the IPADDDBLOCK memory block (12 cells) 1289 +; result in R3 = 0 if error, otherwise the address where it was read (IPADDDBLOCK) 1290 +GetMACaddrs: push R1 1291 + push R2 1292 + call AZreset ; reset 1293 + tst R1 1294 + bne 0ERR$ 1295 + MOV #AZ$CSR,R1 1296 + mov #43,(R1) 1297 +0$: TSTB (R1) ; read addresses into its memory 1298 + BPL 0$ ; wait 1299 + mov #41,(R1) 1300 +1$: TSTB (R1) ; prepare buffer 1301 + BPL 1$ ; wait 1302 + TST (R1)+ ; increment 1303 + mov #IPADDDBLOCK,R3 1304 + mov #12.,R2 1305 +2$: mov (R1),(R3)+ ; read block of words into memory 1306 + sob R2,2$ 1307 + mov #IPADDDBLOCK,R3; success 1308 + br 0END$ 1309 +0ERR$: CLR R3 1310 +0END$: pop R2 1311 + pop R1 1312 + retur 1313 + 1317 1317 {{/code}} 1318 1318 1319 1319 1320 1320 1321 -= **КомандыдляработысMicroSDкартойнафайловомуровне**=1318 += Commands for working with a MicroSD card at the file level = 1322 1322 1323 1323 1324 - ДанныекомандыпредназначеныдляработысMicroSDкартойнауровнефайловойсистемыипозволяетчитать/писатьфайлыбезмонтированияфайловкакобразовдисков.1321 +These commands are designed to work with a MicroSD card at the file system level and allow you to read/write files without mounting files as disk images. 1325 1325 1326 -Эти команды используют буфер 256. слов который задействован в интерфейсе работы с энергонезависимой памятью (см выше команды 022 023) 1327 -\\Ограничения - длина полного пути к файлу 256 байт 1323 +These commands use a 256-word buffer that is used in the interface for working with non-volatile memory (see commands 022 023 above) 1328 1328 1329 - ==**050:Установитьимяфайлакоторыйбудемчитать**==1325 +Limitations - the length of the full path to the file is 256 bytes 1330 1330 1331 - Кодкоманды050,даннаякомандаустанавливаетимяфайлакоторыйбудемчитать,приэтом производится открытие файла на чтение, а также получение его свойств.1327 +== 050: Set the name of the file we will read == 1332 1332 1333 - ==**051:Получитьразмерфайланачтение(илиегостатус)наМПИ**==1329 +Command code 050, this command sets the name of the file that we will read, while opening the file for reading, and also obtaining its properties. 1334 1334 1335 - Кодкоманды051,даннаякомандапередаетнаМПИразмерфайлаилиошибкуего чтения. Размер файла 31бит, старший бит является признаком ошибки. Соответственно максимальный размер файлов с которыми можно работать через этот интерфейс ограничен 2^31 байт (2GB).1331 +== 051: Get file size for reading (or its status) on BUS == 1336 1336 1337 -формирование ошибки выглядит так: 1338 -sizeanyfile=1<<31 + FFres; ~/~/ если установлен старший бит 32х битного слова - то в младшей части код ошибки 1339 -\\FFres = ошибка FatFS 1340 - 1333 +Command code 051, this command transmits the file size or reading error to the MPI. The file size is 31 bits, the most significant bit is an error indicator. Accordingly, the maximum file size that can be worked with via this interface is limited to 2 ^ 31 bytes (2GB). 1341 1341 1335 +The error generation looks like this: 1336 +sizeanyfile=1<<31 + FFres; ~/~/ if the most significant bit of a 32-bit word is set, then the error code is in the lower part 1337 + 1338 +FFres = FatFS error 1339 + 1342 1342 {{code language="c"}} 1343 1343 typedef enum { 1344 1344 FR_OK = 0, /* (0) Succeeded */ ... ... @@ -1366,23 +1366,22 @@ 1366 1366 1367 1367 [[http:~~/~~/elm-chan.org/fsw/ff/doc/open.html>>url:http://elm-chan.org/fsw/ff/doc/open.html]] 1368 1368 1369 -== **052:Читатьблокустановленногофайлавбуфер**==1367 +== 052: Read a block of a set file into a buffer == 1370 1370 1371 - Кодкоманды052,даннаякомандаосуществляетчтениефайлавбуферэнергонезависимойпамяти.1369 +Command code 052, this command reads a file into a non-volatile memory buffer. 1372 1372 1373 -В итоге схема чтения файла выглядит вот так 1374 -**023** - заливаем имя файла в буфер 1375 -**050** - устанавливаем файл на чтение 1376 -**051 **- читаем длину файла или ошибку открытия файла 1377 -если ошибка - повторяем сначала 023 050 051 1378 -если все ok - приступаем к чтению файла 1379 -**052** - читает блок файла в буфер 1380 -**022 **- забираем данные из буфера 1381 -пары 052 022 повторяем нужное количество раз дабы считать весь файл 1382 -как файл будет прочтен - последняя 052 команда закроет его автоматически. 1383 - 1371 +As a result, the file reading scheme looks like this 1372 +**023** - fill the file name into the buffer 1373 +**050 **- set the file for reading 1374 +**051** - read the file length or file open error 1375 +if there is an error - repeat 023 050 051 from the beginning 1376 +if everything is ok - start reading the file 1377 +**052** - read the file block into the buffer 1378 +**022** - take data from the buffer 1379 +repeat the **052 022** pairs the required number of times in order to read the entire file 1380 +once the file is read - the last 052 command will close it automatically. 1384 1384 1385 - Примерпрограммы1382 +Example program: 1386 1386 1387 1387 {{code language="assembler"}} 1388 1388 ... ... @@ -1503,7 +1503,7 @@ 1503 1503 как файл будет записан - последняя 055 команда закроет его автоматически 1504 1504 1505 1505 1506 - Примерпрограммы:1503 +Example program: 1507 1507 1508 1508 {{code language="assembler"}} 1509 1509 ; заливаем в буфер имя файла