Last modified by Max on 2025/03/02 15:18

From version 2.63
edited by Max
on 2025/02/25 16:22
Change comment: (Autosaved)
To version 2.77
edited by Max
on 2025/02/25 17:22
Change comment: (Autosaved)

Summary

Details

Page properties
Content
... ... @@ -1033,31 +1033,29 @@
1033 1033  
1034 1034  {{code language="assembler"}}
1035 1035  ;--------------------------------------------------
1036 -; карта 76й страницы - туда мы готовим данные для команды скринщотов
1037 - SCR_PAGE = 130000 ; 76ую страницу цепляем на место 77й временно - те в окно 130000
1038 - SCR_TAG = SCR_PAGE+0 ; тут вход - 240 - 1 слово
1039 - SCR_ADDR_CONF = SCR_TAG+2 ; сюда команду с адресами - адрес+длина 24 бита - 4 слова
1040 - SCR_PAGE_CONF = SCR_ADDR_CONF+8. ; сюда команду со страницами - начальная страница и количество страниц - 2 слова
1041 - SCR_MEM_CONF = SCR_PAGE_CONF+4. ; cюда конфигурацию памяти из регистров - 22 слова
1042 - SCR_VGA_CONF = SCR_MEM_CONF+44. ; сюда конфигурацию видеоконтроллера - 10 cлов
1043 - SCR_PAL = SCR_VGA_CONF+20. ; сюда 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 в режиме записи управления памятью в SMK
1091 - 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 - регистр вертикального скролинга слой 2
1102 - mov R3,(R4)+ ;177246 - регистр вертикального скролинга слой 1
1103 - mov R3,(R4)+ ;177250 - регистр вертикального скролинга слой 0
1104 - mov R3,(R4)+ ;177252 - регистр гозизонтального скролинга слой 0
1105 - mov R3,(R4)+ ;177254 - регистр гозизонтального скролинга слой 1
1106 - mov R3,(R4)+ ;177256 - регистр гозизонтального скролинга слой 2
1095 + 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х битные - формат, если их нет - система смотрит дальше
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.SCR
1134 -где 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 - SPAGE = 170000 ; 76ую страницу цепляем на место 77й временно - те в окно 130000
1147 - STAG = SPAGE+0 ; тут вход - 240 - 1 слово
1148 - SADDRC = STAG+2 ; сюда команду с адресами - адрес+длина 24 бита - 4 слова
1149 - SPAGEC = SADDRC+8. ; сюда команду со страницами - начальная страница и количество страниц - 2 слова
1150 - SMEMC = SPAGEC+4. ; cюда конфигурацию памяти из регистров - 22 слова
1151 - SVGAC = SMEMC+44. ; сюда конфигурацию видеоконтроллера - 10 cлов
1152 - SPAL = SVGAC+20. ; сюда 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 - регистр вертикального скролинга слой 2
1167 - mov @#177246,(R4)+;177246 - регистр вертикального скролинга слой 1
1168 - mov @#177250,(R4)+;177250 - регистр вертикального скролинга слой 0
1169 - mov @#177252,(R4)+;177252 - регистр гозизонтального скролинга слой 0
1170 - mov @#177254,(R4)+;177254 - регистр гозизонтального скролинга слой 1
1171 - mov @#177256,(R4)+;177256 - регистр гозизонтального скролинга слой 2
1158 + 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 адрес основного DNS
1238 -* DNS2 адрес резервного DNS
1229 +* 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.157
1277 -177777 000377 - MASK маску 255.255.255.0
1278 -124300 000400 - GW гейтвей 192.168.0.1
1279 -124300 000400 - NTP адрес NTP-сервера 192.168.0.1
1280 -124300 050000 - DNS1 адрес основного DNS 192.168.0.90
1281 -124300 055000 - DNS2 адрес резервного DNS 192.168.0.80
1272 +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  ; заливаем в буфер имя файла