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
-
... ... @@ -1034,14 +1034,15 @@ 1034 1034 {{code language="assembler"}} 1035 1035 ;-------------------------------------------------- 1036 1036 ; 76th page map - we prepare data for the screenshot command there 1037 -SCR_PAGE 1038 -SCR_TAG 1039 -SCR_ADDR_CONF = SCR_TAG+2 1040 -SCR_PAGE_CONF = SCR_ADDR_CONF+8. ; here is the command with pages - the starting page and the number of pages - 2 words 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 1041 SCR_MEM_CONF = SCR_PAGE_CONF+4. ; here is the memory configuration from the registers - 22 words 1042 1042 SCR_VGA_CONF = SCR_MEM_CONF+44. ; here video controller configuration - 10 words 1043 -SCR_PAL 1043 +SCR_PAL = SCR_VGA_CONF+20. ; here 338. values ??(words) of palette 338 words 1044 1044 ;-------------------------------------------------- 1045 + 1045 1045 ; trap 41 - preparation of default information for screenshot functionality 1046 1046 PrepSRC: jsr R5, PUSHA ; batch saving of registers 1047 1047 mov @#177326,-(SP) ; save page 130k which was before the call ... ... @@ -1137,206 +1137,205 @@ 1137 1137 Example program 1138 1138 1139 1139 {{code language="assembler"}} 1140 -; updatetheinformationinthe screenshot header1141 +; обновим информацию в хидере скриншота 1141 1141 ;-------------------------------------------------- 1142 -; 76 thpagemap-wepreparedataforthescreenshotcommand there1143 -S CR_PAGE = 130000 ;we temporarily attach the76thpagetothe77th-thatis,intothe130000window1144 -S CR_TAG = SCR_PAGE+0 ;hereisthe input- 240 - 1word1145 -S CR_ADDR_CONF= SCR_TAG+2 ;hereisthecommandwith addresses-address+length24bits- 4words1146 -S CR_PAGE_CONF= SCR_ADDR_CONF+8. ;hereisthecommandwith pages-thestartingpageandthenumber of pages- 2words1147 -S CR_MEM_CONF= SCR_PAGE_CONF+4. ;here is the memoryconfigurationfromtheregisters- 22words1148 -S CR_VGA_CONF= SCR_MEM_CONF+44. ;herevideocontrollerconfiguration- 10words1149 -S CR_PAL = SCR_VGA_CONF+20. ;here338.values(words)ofpalette338words1143 +; карта 76й страницы - туда мы готовим данные для команды скринщотов 1144 + SPAGE = 170000 ; 76ую страницу цепляем на место 77й временно - те в окно 130000 1145 + STAG = SPAGE+0 ; тут вход - 240 - 1 слово 1146 + SADDRC = STAG+2 ; сюда команду с адресами - адрес+длина 24 бита - 4 слова 1147 + SPAGEC = SADDRC+8. ; сюда команду со страницами - начальная страница и количество страниц - 2 слова 1148 + SMEMC = SPAGEC+4. ; cюда конфигурацию памяти из регистров - 22 слова 1149 + SVGAC = SMEMC+44. ; сюда конфигурацию видеоконтроллера - 10 cлов 1150 + SPAL = SVGAC+20. ; сюда 338. значений(слов) палитры 338 слов 1150 1150 ;-------------------------------------------------- 1151 - mov @#177326,R5 ; save page 130k which was before the call 1152 - mov #76,@#177336 ; hook the 76th page into the window 1153 1153 1154 - ;video controller configuration 1153 + mov @#177326,R5 ; сохраним страницу 130k которая была до вызова 1154 + mov #76,@#177336 ; цепляем 76ую страницу в окно 1155 + 1156 + ;конфигурация видеоконтроллера 1155 1155 ; 177230-177256 1156 1156 mov #SVGAC,R4 1157 1157 1158 - mov @#177230,(R4)+;177230 - controlregister1159 - mov @#177232,(R4)+;177232 - register-toppage(layer0)1160 - mov @#177240,(R4)+;177240 - register-toppage(layer1)1161 - mov @#177242,(R4)+;177242 - register-toppage(layer2)1162 - mov @#177244,(R4)+;177244 - verticalscrollregisterlayer21163 - mov @#177246,(R4)+;177246 - verticalscrollregisterlayer11164 - mov @#177250,(R4)+;177250 - verticalscrollregisterlayer01165 - mov @#177252,(R4)+;177252 - horizontalscrollregisterlayer01166 - mov @#177254,(R4)+;177254 - horizontalscrollregisterlayer11167 - mov @#177256,(R4)+;177256 - horizontalscrollregisterlayer21160 + mov @#177230,(R4)+;177230 - регистр управления 1161 + mov @#177232,(R4)+;177232 - регистр - верхняя страница (слой 0) 1162 + mov @#177240,(R4)+;177240 - регистр - средняя страница (слой 1) 1163 + mov @#177242,(R4)+;177242 - регистр - нижняя страница (слой 2) 1164 + mov @#177244,(R4)+;177244 - регистр вертикального скролинга слой 2 1165 + mov @#177246,(R4)+;177246 - регистр вертикального скролинга слой 1 1166 + mov @#177250,(R4)+;177250 - регистр вертикального скролинга слой 0 1167 + mov @#177252,(R4)+;177252 - регистр гозизонтального скролинга слой 0 1168 + mov @#177254,(R4)+;177254 - регистр гозизонтального скролинга слой 1 1169 + mov @#177256,(R4)+;177256 - регистр гозизонтального скролинга слой 2 1168 1168 1169 - mov R5,@#177336; returnthepagefromwhichthe call was made1171 + mov R5,@#177336; вернем страницу с которой был вызов 1170 1170 1171 1171 1172 1172 ;------------------------- 1173 - MOV #AZ$CSR,R3 ; PreparingcontrollerCSR1174 - MOV #AZ$DR,R4 ; PreparingcontrollerDR1175 -20$: CLR (R3) ; Resetthe controller1175 + MOV #AZ$CSR,R3 ; Готовим CSR контроллера 1176 + MOV #AZ$DR,R4 ; Готовим DR контроллера 1177 +20$: CLR (R3) ; Сбросим контроллер 1176 1176 TSTB (R3) 1177 1177 BPL 20$ 1178 1178 1179 - ; clearthememoryblockforthe name-sothatthesystemmakesa default file name1180 - mov #23,(R3) ; commandthatwewillwritedatato the buffer1181 -128$: TSTB (R3) ; checktheresult of execution1182 - BPL 128$ ; wait1181 + ; очистим блок памяти для имени - дабы система сделала дефолтное имя файла 1182 + mov #23,(R3) ; командуем что будем писать данные в буфер 1183 +128$: TSTB (R3) ; проверяем результат выполнения 1184 + BPL 128$ ; ждем 1183 1183 clr R1 1184 1184 1185 1185 mov #256.,R2 ; 1186 -129$: mov R1,(R4) ; givetothe controller1188 +129$: mov R1,(R4) ; отдаем в контроллер 1187 1187 sob R2,129$ 1188 1188 1189 1189 1190 - MOV #044,(R3) ; screenshotcommand1192 + MOV #044,(R3) ; команда скриншот 1191 1191 22$: TSTB (R3) ; 1192 1192 BPL 22$ ; 1193 1193 1194 - ; getthescreenshot name1195 - mov #22,(R3) ; givethereadmemoryblockfromthebuffer to the bus1196 -121$: tstb (R3) ; checktheresult of execution1197 - bpl 121$ ; wait1196 + ; получим имя скриншота 1197 + mov #22,(R3) ; отдать на шину считанный блок памяти из буфера 1198 +121$: tstb (R3) ; проверяем результат выполнения 1199 + bpl 121$ ; ждем 1198 1198 1199 1199 mov #BUF,R1 1200 - mov #256.,R2 ; read256.words;thefirstwordisthe result of reading1201 -122$: mov (R4),(R1)+ ; readablockofwords into memory1202 + mov #256.,R2 ; читаем 256. слов; первое слово - результат чтения 1203 +122$: mov (R4),(R1)+ ; читаем блок слов в память 1202 1202 sob R2,122$ 1203 1203 1204 1204 .PRINT #RESOK 1205 1205 .Print #BUF 1206 1206 1207 - mov #110,@#AZ$CSR; enablethenetworkbydefault,thenetworkshould be constantly enabled1209 + mov #110,@#AZ$CSR; включаем сеть по-умолчанию сеть должна быть постоянно включена 1208 1208 .Exit 1209 1209 {{/code}} 1210 1210 1211 - Tounpackascreenshot,youcanusethisutility - [[https:~~/~~/master.pdp-11.ru/screen_unpack/>>https://master.pdp-11.ru/screen_unpack/]]1213 +Для распаковки скриншота можно использовать вот эту утилиту 1212 1212 1213 1213 1214 1214 1215 -= CommandsforworkingwiththeTCP/IPstack=1217 += **Команды для работы со стеком TCP/IP** = 1216 1216 1217 - ThefollowingcommandsoperateontheTCP/IPstack information buffer.1219 +следующие команды работают с буфером информации TCP/IP cтека. 1218 1218 1219 -== 040: GetIPaddressandotherTCP/IPstacksettingsto buffer==1221 +== **040: Получить ip адрес и прочие настройки стека TCP/IP в буфер** == 1220 1220 1221 - Commandcode040,thiscommandfillsthebufferwithinformation from theTCP/IPstackwithcurrent(actual)information.1223 +Код команды 040, данная команда заполняет буфер информацией с TCP/IP cтека текущей (фактической) информацией. 1222 1222 1223 -== 041: Readingipaddressbuffer==1225 +== **041: Чтение буфера ip адреса** == 1224 1224 1225 - Commandcode041,thiscommandtransfersthebuffertothe bus1227 +Код команды 041, данная команда передает буфер на шину 1226 1226 1227 - Thispairofcommandsallowsyoutogetcurrent information from the stack1229 +эта пара команд позволяет получить текущую информацию со стека 1228 1228 1229 -* IP address1230 -* MASK mask1231 -* GW gateway1232 -* NTP addressof theNTPserver1233 -* DNS1 primaryDNSaddress1234 -* DNS2 backupDNSaddress1231 +* IP адрес 1232 +* MASK маску 1233 +* GW гейтвей 1234 +* NTP адрес NTP-сервера 1235 +* DNS1 адрес основного DNS 1236 +* DNS2 адрес резервного DNS 1235 1235 1236 - accordinglyitis12words1238 +соответственно это 12 слов 1237 1237 1238 - Exampleprogram:1240 +Пример программы: 1239 1239 1240 1240 {{code language="assembler"}} 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 - 1243 +; trap 52 - чтение блока IP адресов в блок памяти IPADDDBLOCK (8. ячеек) 1244 +; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK) 1245 +GetIPaddrs: push R1 1246 + push R2 1247 + call AZreset; сбросим 1248 + tst R1 1249 + bne 0ERR$ 1250 + MOV #AZ$CSR,R1 1251 + mov #40,(R1) 1252 +0$: TSTB (R1); прочитать адреса в свою память 1253 + BPL 0$; ждем 1254 + mov #41,(R1) 1255 +1$: TSTB (R1); подготовить буфер 1256 + BPL 1$; ждем 1257 + TST (R1)+; инкрементируем 1258 + mov #IPADDDBLOCK,R3 1259 + mov #12.,R2 1260 +2$: mov (R1),(R3)+; читаем блок слов в память 1261 + sob R2,2$ 1262 + mov #IPADDDBLOCK,R3; успешно 1263 + br 0END$ 1264 +0ERR$: CLR R3 1265 +0END$: pop R2 1266 + pop R1 1267 + return 1267 1267 {{/code}} 1268 1268 1269 - Examplereturn data:1270 +Пример данных 1270 1270 1271 1271 {{info}} 1272 - Dataexamples-wordsreturnedinoctalformat1273 -124300 116400 - IP address192.168.0.1571274 -177777 000377 - MASK mask255.255.255.01275 -124300 000400 - GW gateway192.168.0.11276 -124300 000400 - NTP addressofNTPserver192.168.0.11277 -124300 050000 - DNS1 addressofprimaryDNS 192.168.0.901278 -124300 055000 - DNS2 addressofbackupDNS 192.168.0.801273 +Примеры данных - возвращаемые слова в восьмеричном формате 1274 +124300 116400 - IP адрес 192.168.0.157 1275 +177777 000377 - MASK маску 255.255.255.0 1276 +124300 000400 - GW гейтвей 192.168.0.1 1277 +124300 000400 - NTP адрес NTP-сервера 192.168.0.1 1278 +124300 050000 - DNS1 адрес основного DNS 192.168.0.90 1279 +124300 055000 - DNS2 адрес резервного DNS 192.168.0.80 1279 1279 {{/info}} 1280 1280 1281 -== 043: ReadMACaddressinto ipbuffer==1282 +== **043: чтение MAC-адреса в ip буфер** == 1282 1282 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 1284 +Код команды 043, данная команда читает текущий фактический MAC адрес в буфер IP адресов 1285 +те сначала 043, а затем 041 команды 1284 1284 1285 - Exampleprogram:1287 +Пример программы: 1286 1286 1287 1287 {{code language="assembler"}} 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 - 1290 +; trap 72 - чтение MAC адреса в блок памяти IPADDDBLOCK (12. ячеек) 1291 +; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK) 1292 +GetMACaddrs: push R1 1293 + push R2 1294 + call AZreset ; сбросим 1295 + tst R1 1296 + bne 0ERR$ 1297 + MOV #AZ$CSR,R1 1298 + mov #43,(R1) 1299 +0$: TSTB (R1) ; прочитать адреса в свою память 1300 + BPL 0$ ; ждем 1301 + mov #41,(R1) 1302 +1$: TSTB (R1) ; подготовить буфер 1303 + BPL 1$ ; ждем 1304 + TST (R1)+ ; инкрементируем 1305 + mov #IPADDDBLOCK,R3 1306 + mov #12.,R2 1307 +2$: mov (R1),(R3)+ ; читаем блок слов в память 1308 + sob R2,2$ 1309 + mov #IPADDDBLOCK,R3; успешно 1310 + br 0END$ 1311 +0ERR$: CLR R3 1312 +0END$: pop R2 1313 + pop R1 1314 + retur 1314 1314 {{/code}} 1315 1315 1316 1316 1317 1317 1318 -= CommandsforworkingwithaMicroSDcardatthefilelevel=1319 += **Команды для работы с MicroSD картой на файловом уровне** = 1319 1319 1320 1320 1321 - Thesecommandsaredesignedtoworkwith aMicroSDcardatthefilesystemlevelandallow you to read/writefileswithoutmountingfilesasdiskimages.1322 +Данные команды предназначены для работы с MicroSD картой на уровне файловой системы и позволяет читать/писать файлы без монтирования файлов как образов дисков. 1322 1322 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) 1324 +Эти команды используют буфер 256. слов который задействован в интерфейсе работы с энергонезависимой памятью (см выше команды 022 023) 1325 +\\Ограничения - длина полного пути к файлу 256 байт 1324 1324 1325 - Limitations-thelengthofthefullpathto the file is 256 bytes1327 +== **050: Установить имя файла который будем читать** == 1326 1326 1327 - ==050:Setthenameofthefilewewillread==1329 +Код команды 050, данная команда устанавливает имя файла который будем читать, при этом производится открытие файла на чтение, а также получение его свойств. 1328 1328 1329 - Commandcode050,thiscommandsetsthenameofthefilethatwewill read, while opening the file for reading, and also obtaining its properties.1331 +== **051: Получить размер файла на чтение (или его статус) на МПИ** == 1330 1330 1331 - ==051:Getfilesizeforreading(oritsstatus)onBUS==1333 +Код команды 051, данная команда передает на МПИ размер файла или ошибку его чтения. Размер файла 31бит, старший бит является признаком ошибки. Соответственно максимальный размер файлов с которыми можно работать через этот интерфейс ограничен 2^31 байт (2GB). 1332 1332 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). 1335 +формирование ошибки выглядит так: 1336 +sizeanyfile=1<<31 + FFres; ~/~/ если установлен старший бит 32х битного слова - то в младшей части код ошибки 1337 +\\FFres = ошибка FatFS 1338 + 1334 1334 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 - 1340 1340 {{code language="c"}} 1341 1341 typedef enum { 1342 1342 FR_OK = 0, /* (0) Succeeded */ ... ... @@ -1364,22 +1364,23 @@ 1364 1364 1365 1365 [[http:~~/~~/elm-chan.org/fsw/ff/doc/open.html>>url:http://elm-chan.org/fsw/ff/doc/open.html]] 1366 1366 1367 -== 052: Readablockofasetfile into a buffer==1367 +== **052: Читать блок установленного файла в буфер** == 1368 1368 1369 - Commandcode052,thiscommandreadsafileintoanon-volatilememory buffer.1369 +Код команды 052, данная команда осуществляет чтение файла в буфер энергонезависимой памяти. 1370 1370 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. 1371 +В итоге схема чтения файла выглядит вот так 1372 +**023** - заливаем имя файла в буфер 1373 +**050** - устанавливаем файл на чтение 1374 +**051 **- читаем длину файла или ошибку открытия файла 1375 +если ошибка - повторяем сначала 023 050 051 1376 +если все ok - приступаем к чтению файла 1377 +**052** - читает блок файла в буфер 1378 +**022 **- забираем данные из буфера 1379 +пары 052 022 повторяем нужное количество раз дабы считать весь файл 1380 +как файл будет прочтен - последняя 052 команда закроет его автоматически. 1381 + 1381 1381 1382 - Exampleprogram:1383 +Пример программы 1383 1383 1384 1384 {{code language="assembler"}} 1385 1385 ... ... @@ -1500,7 +1500,7 @@ 1500 1500 как файл будет записан - последняя 055 команда закроет его автоматически 1501 1501 1502 1502 1503 - Exampleprogram:1504 +Пример программы: 1504 1504 1505 1505 {{code language="assembler"}} 1506 1506 ; заливаем в буфер имя файла ... ... @@ -1616,7 +1616,7 @@ 1616 1616 первое слово - общий объем карты доступный для FAT в МБ 1617 1617 второе слово - свободный объем на карте в МБ 1618 1618 1619 - Exampleprogram:1620 +Пример программы: 1620 1620 1621 1621 {{code language="assembler"}} 1622 1622 ; trap 51 - получение объема SD карты всего/свободно в мегабайтах ... ... @@ -1652,7 +1652,7 @@ 1652 1652 1653 1653 Код команды 025, данная команда устанавливает соединение с сервером Hall of Fame, инициализирует шифрованный тоннель и подготавливает API к работе. 1654 1654 1655 - Exampleprogram:1656 +Пример программы 1656 1656 1657 1657 {{code language="assembler"}} 1658 1658 AZ$CSR = 177220 ; регистр команд и состояния (CSR) ... ... @@ -1731,7 +1731,7 @@ 1731 1731 1732 1732 Код команды 026, данная команда осуществляет непосредственный обмен с Hall of Fame 1733 1733 1734 - Exampleprogram:1735 +Пример программы 1735 1735 1736 1736 {{code language="assembler"}} 1737 1737 ;4. авторизация пользователя