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
-
... ... @@ -388,49 +388,44 @@ 388 388 • Read 11 words of the table of contents entry from DR 389 389 \\The table of contents entry has the format: 390 390 391 -|= |= |= 392 -| | | 393 -| | | 394 -| | | 395 -| | | 396 -| | | 391 +(% style="width:686px" %) 392 +|=(% style="width: 136px;" %)Offset (octal)|=(% style="width: 305px;" %)Name|=(% style="width: 242px;" %)Value 393 +|(% style="width:136px" %)0|(% style="width:305px" %)fSize|(% style="width:242px" %)File size in bytes, low word 394 +|(% style="width:136px" %)2|(% style="width:305px" %)fSize|(% style="width:242px" %)File size in bytes, high word 395 +|(% style="width:136px" %)4|(% style="width:305px" %)fDate|(% style="width:242px" %)Date in MS-DOS format 396 +|(% style="width:136px" %)6|(% style="width:305px" %)fTime|(% style="width:242px" %)Time in MS-DOS format 397 +|(% style="width:136px" %)10|(% style="width:305px" %)fAttr|(% style="width:242px" %)Attributes 1 byte 398 +|(% style="width:136px" %)10|(% style="width:305px" %)fName|(% style="width:242px" %)NAME.FILE TYPE, 8+1+3+1 = 13 bytes 397 397 398 398 399 -Смещение Имя Значение 400 -0 fSize Размер файла в байтах, младшее слово 401 -2 старшее слово 402 -4 fDate Дата в формате MS-DOS 403 -6 fTime Время в формате MS-DOS 404 -10 fAttr Атрибуты 1 байт 405 -11 fName ИМЯ.ТИП файла, 8+1+3+1 = 13 байт 406 -\\Смещения указаны восьмеричные. Формула в строке fName означает, что там сначала должно быть имя, максимально из восьми символов, далее должна быть точка, далее тип, до трёх символов, и завершающий нулевой байт 0х00. Если тип не указан, точка тоже не нужна. 407 -\\Атрибуты файлов в байте fAttr (восьмеричные): 401 +The offsets are specified in octal. The formula in the fName line means that there must first be a name, maximum of eight characters, then a period, then a type, up to three characters, and a terminating zero byte 0x00. If the type is not specified, the period is also not needed. 402 +\\File attributes in fAttr byte (octal): 408 408 \\001 - Read Only 409 409 002 - Hidden 410 410 004 - System 411 411 020 - Directory 412 412 040 - Archive 413 -\\ Примерпрограммы.408 +\\Example program 414 414 415 415 {{code language="assembler"}} 416 416 ;...................................... 417 -RdDir = 013; кодкоманды"Читатьзаписьоглавления"412 +RdDir = 013; command code "Read table of contents entry" 418 418 RdBuf = 015 419 419 420 420 MOV #AZ$CSR,R3 421 421 422 422 15$: CLR @R3; 423 - TSTB @R3; Сбросимконтроллер418 + TSTB @R3; Reset the controller 424 424 BPL 15$; 425 425 426 - MOV #RdDir,@R3; Попросимконтроллер427 -16$: TSTB @R3; прочитатьвсвоюпамять428 - BPL 16$; записьоглавления421 + MOV #RdDir,@R3; Ask the controller 422 +16$: TSTB @R3; to read into its memory 423 + BPL 16$; table of contents entry 429 429 430 430 MOV @RdBuf,(R3)+; 431 - MOV DIRREC,R2; Иперенесемеексебев432 - MOV #11.,R1; областьпамяти,указатель433 -17$: MOV @R3,(R2)+; накоторуюлежитвячейке426 + MOV DIRREC,R2; And transfer it to itself in 427 + MOV #11.,R1; memory area, pointer 428 +17$: MOV @R3,(R2)+; to which lies in cell 434 434 SOB R1,17$; DIRREC. 435 435 436 436 ;...................................... ... ... @@ -437,96 +437,97 @@ 437 437 {{/code}} 438 438 439 439 440 -== **014:Размонтироватьдиск**==435 +== 014: Unmount disk == 441 441 442 - Кодкоманды014,чтобыразмонтироватьдиск,следуетсброситьконтроллер,переслатьвDRконтроллераномерприводаAZ,которыйследуетразмонтировать,ипослатьвCSRконтроллеракод014,послечегодождатьсяокончанияоперации(онадлительная)ипроверитьнаошибку.Ошибкавыдается,еслиприводнебылсмонтирован.443 -[[ **//пример утилитыAZUMNT//**>>url:https://forum.maxiol.com/index.php?showtopic=5605&st=0&p=59418&#entry59418]]437 +Command code 014, to unmount the disk, you should reset the controller, send the AZ drive number to the controller DR, which should be unmounted, and send the 014 code to the controller CSR, then wait for the operation to complete (it takes a long time) and check for an error. An error is issued if the drive has not been mounted. 438 +[[AZUMNT utility example>>url:https://forum.maxiol.com/index.php?showtopic=5605&st=0&p=59418&#entry59418]] 444 444 445 445 446 -== **015:Начатьпередачусчитанногоблока**==441 +== 015: Start transferring the read block == 447 447 448 - Кодкоманды-015.Получивэтукоманду,контроллернастраиваетсянапословнуювыдачусодержимоготогосамоговстроенногобуферана256слов,которыебудутвыданыпоследовательночерезрегистрDR.Никакихожиданийнетребуется,простопересылаем256разсловоизDRвпоследовательныеячейкипамяти,ивсе.Еслинужноменьше,чем256слов(последнийукороченныйблокфайла),тоостатокможнопростобросить,несчитывая,сбросконтроллеравначалеследующейоперациисброситиэтотостаток.449 -\\ Примерпрограммы:443 +The command code is 015. Having received this command, the controller is configured to output word by word the contents of the same built-in buffer for 256 words, which will be output sequentially through the DR register. No waiting is required, we simply send a word from DR to sequential memory cells 256 times, and that's it. If less than 256 words are needed (the last shortened block of the file), then the remainder can simply be discarded without reading, resetting the controller at the beginning of the next operation will also reset this remainder. 444 +\\Example program: 450 450 451 451 {{code language="assembler"}} 452 452 ;.................................. 453 -RdBuf=015; символическоенаименованиекоманды448 +RdBuf=015; symbolic name of the command 454 454 455 -; ВR3отпредыдущегофрагментаосталсяадресCSR450 +; In R3 from the previous fragment there is the address of the CSR 456 456 ; (177220) 457 457 458 -; Считаем,чтоунасвR2находитсяадреспервогослова459 -; памяти,кудаследуетразместитьпрочитанныйблок.460 -; Программаполученияэтогоадресанеприводится.453 +; We assume that in R2 we have the address of the first word 454 +; of memory, where the read block should be placed. 455 +; The program for obtaining this address is not given. 461 461 462 - MOV #400,R1; Готовимсчетчикслов457 + MOV #400,R1; Prepare the word counter 463 463 ; 0400 oct = 256 dec 464 464 465 - MOV #RdBuf,(R3)+; ипересылаемкоманду466 -; RdBuf вCSR.АдресвR3укажетнаDR (177222).460 + MOV #RdBuf,(R3)+; and send the command 461 +; RdBuf to the CSR. The address in R3 will point to DR (177222). 467 467 468 -3$: MOV @R3,(R2)+ ;перешлемочередноесловов469 - память470 - SOB R1,3$; иповторимэто256 (0400)471 - ; раз463 +3$: MOV @R3,(R2)+we will send the next word to 464 +; memory 465 + SOB R1,3$; and repeat this 256 (0400) 466 + ; times 472 472 ;.................................. 473 473 {{/code}} 474 474 475 -Всё, чтение закончено. 476 -\\Для записи наоборот, требуется сначала перенести весь блок данных из памяти ЦП в контроллер и потом выдать команду "Записать содержимое буфера на диск" 470 +That's it, reading is complete. 477 477 472 +To write the opposite way, you first need to transfer the entire data block from the CPU memory to the controller and then issue the command "Write the contents of the buffer to disk" 478 478 479 -== **016: Принять блок данных в буфер** == 480 480 481 -Код команды 016. Команда настраивает контроллер на прием блока данных и помещении его в буфер. Следующие 256 циклов записи в DR поместят данные, переданные через МПИ, в буфер. 482 -\\Пример программы. 475 +== 016: Receive data block into buffer == 483 483 477 +Command code 016. The command sets the controller to receive a block of data and place it in the buffer. The next 256 write cycles to DR will place the data transferred via the QBUS in the buffer. 478 +\\Example program: 479 + 484 484 {{code language="assembler"}} 485 485 ;.................................. 486 486 487 -WrBuf=016; Символическоенаименованиекоманды483 +WrBuf=016; Symbolic name of the command 488 488 489 -; Передзаписьюнужновыполнитьтежедействия,чтоив490 -; пп. 3.1.-3.3.Обычно,этооднаитаже программа,491 -; простопослепункта3.3.выполняетсяпроверка"Что492 -; требуется:чтениеилизапись?"иразветвлениена493 -; программучтенияилизаписи.485 +; Before writing, you need to perform the same actions as in 486 +; pp. 3.1.-3.3. Usually, this is the same program, 487 +; just after point 3.3. a check is performed "What 488 +; is required: reading or writing?" and a branch is made to the 489 +; reading or writing program. 494 494 495 -; Послефрагментавп.3.3.вR3 остался адресCSR496 -; (177220). Будемсчитать,чтовR2находитсяадресв497 -; памятиЦП,гденаходитсяблок,подлежащийзаписи.498 -; Программаполученияэтогоадресанепоказана.491 +; After the fragment in point 3.3., the CSR address 492 +; (177220) remains in R3. We will assume that R2 contains the address in the CPU 493 +; memory where the block to be written is located. 494 +; The program for obtaining this address is not shown. 499 499 500 - MOV #400,R1; Готовимсчетчик496 + MOV #400,R1; Preparing the counter 501 501 502 - MOV #WrBuf,(R3)+; ПерешлемкомандувCSRи503 - переключимадресвR3на504 - 498 + MOV #WrBuf,(R3)+; Let's forward the command to the CSR and 499 +; switch the address in R3 to 500 +; DR 505 505 506 -4$: MOV (R2)+,@R3; Перешлемочередноеслово507 - данных508 - SOB R1,4$; иповторимэто256раз502 +4$: MOV (R2)+,@R3; Let's forward the next word 503 +; data 504 + SOB R1,4$; and repeat this 256 times 509 509 ;.................................. 510 510 {{/code}} 511 511 512 -== **017:Получитьразмерпсевдодиска,большой**==508 +== 017: Get ramdisk size, large == 513 513 514 - Естьдвекомандыполученияразмерапсевдодиска,т.е.смонтированногонавыбранныйпсевдоприводAZnфайл-образа.515 -\\ ЕслииспользуемаяОС(илипрограмма,работающаясдискамибезОС)умеетработатьсбольшими(больше32М)дисками,следуетпользоватьсякомандойскодом017.Последовательностьдействий:сброситьконтроллер(п. 3.1),выбратьнакопитель(п. 3.2)ипереслатьвCSRкод017,азатем,безкаких-либоожиданий,считатьизDRсначаламладшее,иследомзанимстаршеесловоразмеравыбранногонакопителя(файл-образа).516 -\\ ЕслииспользуемаяОСнеумеетработатьсдискамибОльшими,чем32М(RT-11),следуетпользоватьсякомандой007 -получитьразмерпсевдодискасограничениемдо32М.Действияпохожие:сбрасываемконтроллер,выбираемдиск,посылаемвCSRкод[[007>>doc:||anchor="H007:41F43E43B44344743844244C44043043743C43544043F44143543243443E43443844143A430"]]исчитываемизDRоднословоразмерапсевдодиска.Еслиразмерфайл-образа,смонтированногонавыбранныйпсевдопривод,больше65534блоков,вместоэтого"большого"размера,контроллервозвращает число65534.Напоминаем,чточисло65535кое-гдеиспользуетсявспециальныхцеляхинеможетбытьразмеромдиска.517 -\\ Такженапоминаем,чтоеслинаэтотнакопительнесмонтированфайл-образ,последовательностьдействийнепройдет(команда001выборустройства)иисполнениепрограммыдоэтогоместапростонедойдет.Поэтомуошибокуэтихкоманднепредусмотрено.518 -\\ Примерпрограммысбольшимидисками510 +There are two commands to get the size of a pseudo-disk, i.e. the AZn file-image mounted on the selected pseudo-drive. 511 +\\If the OS being used (or a program working with disks without an OS) can work with large (more than 32M) disks, you should use the command with the code 017. The sequence of actions: reset the controller (p. 3.1), select the drive (p. 3.2) and send the code 017 to the CSR, and then, without any waiting, read from DR first the lower word, and then the higher word of the size of the selected drive (image file). 512 +\\If the OS you are using cannot work with disks larger than 32M (RT-11), you should use the 007 command - get the pseudo-disk size with a limit of up to 32M. The steps are similar: reset the controller, select the disk, send the 007 code to the CSR and read one word of the pseudo-disk size from DR. If the size of the image file mounted on the selected pseudo-drive is larger than 65534 blocks, the controller returns the number 65534 instead of this "large" size. We remind you that the number 65535 is used in some places for special purposes and cannot be the disk size. 513 +\\We also remind you that if the image file is not mounted on this drive, the sequence of actions will not work (command 001 select device) and the program execution will simply not reach this point. Therefore, these commands do not provide for errors. 514 +\\Example of a program with large disks 519 519 520 520 {{code language="assembler"}} 521 521 ;...................................... 522 522 523 -GetBig=017; Получить"большой"размердиска519 +GetBig=017; Get the "big" disk size 524 524 525 -; Отфрагмента3.2 (выбордиска)унасвR3остался526 -; адресDR (177222)521 +; From fragment 3.2 (disk selection) we have in R3 522 +; DR address (177222) 527 527 528 - MOV #GetBig,-(R3); пошлемкоманду529 - TST (R3)+; вернемадресвR3назад,наDR524 + MOV #GetBig,-(R3); send the command 525 + TST (R3)+; return the address in R3 back to DR 530 530 MOV @R3,BigSiz 531 531 MOV @R3,BigSiz+2 532 532 ;...................................... ... ... @@ -533,27 +533,26 @@ 533 533 {{/code}} 534 534 535 535 536 -== **020:Получитьрасширенныйкоддиагностики**==532 +== 020: Get extended diagnostic code == 537 537 538 - Кодкоманды020,послесбросаконтроллераследуетвыдатьэтукомандувCSRизатемпрочитатьдвасловарасширеннойдиагностикиизDR.Командамгновенная,ожиданиенетребуется.534 +Command code 020, after resetting the controller, you should issue this command in the CSR and then read two words of extended diagnostics from DR. The command is instant, no waiting is required. 539 539 540 540 541 -== **027:Получитьверсиюfirmware AZ STM32**==537 +== 027: Get firmware version AZ STM32 == 542 542 543 -Код команды 027, возвращает 2 слова 544 -\\первое слово - 06404 = старший байт 13. это версия прошивки, младший байт 4. это версия железа - те AZБК в данном случае 545 -второе слово - 037 = это максимальный монтируемый диск - 31. 539 +Command code 027, returns 2 words 540 +\\first word - 06404 = high byte 13. this is the firmware version, low byte 4. this is the hardware version - i.e. AZБК in this case second word - 037 = this is the maximum mountable disk - 31. 546 546 547 547 548 548 {{code language="assembler"}} 549 549 ;------------------------------------------------------------- 550 -; получениеверсии прошивкиSTM32 -результатвR1ошибка545 +; getting STM32 firmware version - result in R1 R1=0 error 551 551 GTSTMV: MOV #AZ$CSR,R1 552 -1$: CLR (R1) ; Пошлемкоманду"Сброс"553 - TSTB (R1) ; Проверимготовностьконтроллера554 - BPL 1$ ; Еслинеготов,сбрасываемеще547 +1$: CLR (R1) ; Send "Reset" command 548 + TSTB (R1) ;Check controller readinessконтроллера 549 + BPL 1$ ; If not ready, reset again 555 555 mov #27,(R1) 556 - TST (R1)+ ; Проверяемнаошибку551 + TST (R1)+ ; Check for error 557 557 BMI 2$ 558 558 mov (R1),R1 559 559 return ... ... @@ -563,45 +563,45 @@ 563 563 {{/code}} 564 564 565 565 566 -== **030:Нетоперации**==561 +== 030: No operation == 567 567 568 - Основноеназначениеэтойкоманды-устанавливатьбитразрешенияпрерыванийотконтроллера.Командапередаетбитразрешенияпрерывания,которыйнаходитсяснейводномслове,ноневходитвеесостав(напоминаем,командарасполагаетсявбитахD0 - D5,абитразрешенияпрерываний-D6),всоответствующийтриггерконтроллераибольшеникакневлияетнапроцессывконтроллере.Управлениеэтимтриггеромработаетдажевсостоянии"Думаю,прошунемешать",иэтоглавнаяособенностькоманды"нетоперации".569 -\\ Командаимееткод0030.Посылка в CSRкода0130разрешитпрерыванияотконтроллера,посылкакода0030запретитих.Примернеприводитсявследствиетривиальностиего.563 +The main purpose of this command is to set the interrupt enable bit from the controller. The command transfers the interrupt enable bit, which is in the same word with it, but is not part of it (remember, the command is located in bits D0 - D5, and the interrupt enable bit is D6), to the corresponding trigger of the controller and does not affect the processes in the controller in any other way. Control of this trigger works even in the "Thinking, please do not interfere" state, and this is the main feature of the "no operation" command. 564 +\\The command has the code 0030. Sending the code 0130 to the CSR will enable interrupts from the controller, sending the code 0030 will disable them. An example is not given due to its triviality. 570 570 571 571 572 -= **Блоккомандработысэнергонезависимойпамятью**=567 += Command block for working with non-volatile memory = 573 573 574 - ИнтерфейспредоставляетлюбомуAZ-контроллерудоступк255словамэнергонезависимойпамяти,всекомандыустанавливаютбитготовностипозавершению.Этопозволяетсохранятьпользовательскиенастройкивэнергонезависимойпамяти,кпримеруэтоиспользуетсявAZБК-тамсохраняютсянастройкидляболеекомфортнойработыконтроллера.569 +The interface provides any AZ controller with access to 255 words of non-volatile memory, all commands set the ready bit upon completion. This allows you to save user settings in non-volatile memory, for example, this is used in AZBK ??- there are saved settings for more comfortable operation of the controller. 575 575 576 - Всекомандыэтогоблокаиспользуютбуферэнергонезависимойпамятидлясвоейработы.571 +All commands in this block use a non-volatile memory buffer for their operation. 577 577 578 -== **021:Cчитатьблокэнергонезависимойпамятивбуфер**==573 +== 021: Read non-volatile memory block into buffer == 579 579 580 580 (% class="wikigeneratedid" %) 581 - Кодкоманды021,даннаякомандавызываетчтениеблокаэнергонезависимойпамятивбуферэнергонезависимойпамяти.576 +Command code 021, this command causes a block of non-volatile memory to be read into the non-volatile memory buffer. 582 582 583 583 584 -== **022:Отдатьнашинусчитанныйблокэнергонезависимойпамятиизбуфера**==579 +== 022: Transfer the read block of non-volatile memory from the buffer to the bus == 585 585 586 586 (% class="wikigeneratedid" %) 587 - Кодкоманды022,даннаякомандаобеспечиваетпередачубуфераэнергонезависимойпамятиврегистрDRдлясчитывания.582 +Command code 022, this command ensures that the non-volatile memory buffer is transferred to the DR register for reading. 588 588 589 589 (% class="wikigeneratedid" %) 590 - Примерпрограммы585 +Example program 591 591 592 592 {{code language="assembler"}} 593 -AZ$CSR регистркомандисостояния(CSR)594 -AZ$DR регистрданных(DR)588 +AZ$CSR = 177220; command and status register (CSR) 589 +AZ$DR = 177222; data register (DR) 595 595 596 596 597 -; trap 50 - cбросAZ592 +; trap 50 - reset AZ 598 598 ; результат в R1 =0 ok 599 599 AZreset: MOV #AZ$CSR,R1 600 -1$: CLR (R1); Пошлемкоманду"Сброс"601 - TSTB (R1); Проверимготовностьконтроллера602 - BPL 1$; Еслинеготов,сбрасываемеще603 - разипроверяемснова604 - TST (R1); Проверимнаошибку,595 +1$: CLR (R1); Send the "Reset" command 596 + TSTB (R1); Check the controller readiness 597 + BPL 1$; If not ready, reset again 598 +; once and check again 599 + TST (R1); Check for an error, 605 605 BMI 0ERR$ 606 606 CLR R1 607 607 return ... ... @@ -610,30 +610,30 @@ 610 610 return 611 611 612 612 613 -; trap 54 - чтениеэнергонезависимойпамятиблока1 EEPROMвбуферсадресаADREEPROMMEM614 -; результатR3 -адрес,еслиR3=0ошибка615 -; статусчтениявR1 0 - ok616 -; 1 - размернесоответствуетсохраненному617 -; 2 - o шибкаверсии618 -; 3 - oшибкаконтрольной суммы608 +; trap 54 - reading non-volatile memory of block 1 EEPROM to the buffer from the address ADREEPROMMEM 609 +; result R3 - address, if R3=0 error 610 +; read status in R1 0 - ok 611 +; 1 - size does not match saved 612 +; 2 - version error 613 +; 3 - checksum error 619 619 ReadEEPROM: push R2 620 - call AZreset; сбросим615 + call AZreset; reset 621 621 tst R1 622 622 bne 0ERR$ 623 623 ; теперь читаем 624 624 MOV #AZ$CSR,R1 625 - mov #21,(R1); считатьблок1энергонезависимойпамятивбуфер626 -0$: TSTB (R1); проверяемрезультатвыполнения627 - BPL 0$; ждем628 - mov #22,(R1); отдатьнашинусчитанныйблокэнергонезависимойпамятиизбуфера629 -1$: TSTB (R1); проверяемрезультатвыполнения630 - BPL 1$; ждем631 - TST (R1)+; инкрементируем620 + mov #21,(R1); read block 1 of non-volatile memory into buffer 621 +0$: TSTB (R1); check execution result 622 + BPL 0$; wait 623 + mov #22,(R1); send read block of non-volatile memory from buffer to bus 624 +1$: TSTB (R1); check execution result 625 + BPL 1$; wait 626 + TST (R1)+; increment 632 632 mov #ADREEPROMMEM,R3 633 - mov #256.,R2; читаем256.слов;первоеслово-результатчтения634 -2$: mov (R1),(R3)+; читаемблоксловвпамять628 + mov #256.,R2; read 256. words; first word is reading result 629 +2$: mov (R1),(R3)+; read block of words into memory 635 635 sob R2,2$ 636 - mov #ADREEPROMMEM,R3; успешно631 + mov #ADREEPROMMEM,R3; successful 637 637 mov (R3),R1 638 638 br 0END$ 639 639 0ERR$: CLR R3 ... ... @@ -641,41 +641,39 @@ 641 641 return 642 642 {{/code}} 643 643 644 -очевидно, после считывания памяти необходимо проверить код результата в первом слове - см расшифровку кодов ошибок 645 -\\Примеры возвращаемых данных по командам 646 -\\последовательная подача команды 021 и затем 022 позволит считать 256. слов 647 -из энергонезависимой памяти 648 -**Внимание! **первое слово это будет статус успешности чтения 649 - 639 +obviously, after reading the memory, it is necessary to check the result code in the first word - see the decoding of error codes 640 +\\Examples of returned data for commands 641 +\\sequentially issuing the command 021 and then 022 will allow reading 256 words from non-volatile memory 642 +Attention! The first word will be the reading success status 650 650 651 651 * 0 - ok 652 -* 1 - размернесоответствуетсохраненному653 -* 2 - o шибкаверсии654 -* 3 - oшибкаконтрольной суммы645 +* 1 - size does not match saved 646 +* 2 - version error 647 +* 3 - checksum error 655 655 656 -== **023:Принятьсшинывбуферданныедляпоследующейзаписивбуфер**==649 +== 023: Receive data from the bus into the buffer for subsequent writing into the buffer == 657 657 658 - Кодкоманды023,даннаякомандапозволяетнаполнитьбуферэнергонезависимойпамяти651 +Command code 023, this command allows you to fill the non-volatile memory buffer 659 659 660 -== **024:Записатьизбуферавблокэнергонезависимойпамяти**==653 +== 024: Write from buffer to non-volatile memory block == 661 661 662 - Кодкоманды024,даннаякомандавызываетзаписьблокаэнергонезависимойпамятиизбуфераэнергонезависимойпамяти.655 +Command code 024, this command causes a non-volatile memory block to be written from the non-volatile memory buffer. 663 663 664 - Примерпрограммы657 +Example program 665 665 666 666 {{code language="assembler"}} 667 -AZ$CSR регистркомандисостояния(CSR)668 -AZ$DR регистрданных(DR)660 +AZ$CSR = 177220; Command and Status Register (CSR) 661 +AZ$DR = 177222; Data Register (DR) 669 669 670 670 671 -; trap 50 - cбросAZ664 +; trap 50 - reset AZ 672 672 ; результат в R1 =0 ok 673 673 AZreset: MOV #AZ$CSR,R1 674 -1$: CLR (R1); Пошлемкоманду"Сброс"675 - TSTB (R1); Проверимготовностьконтроллера676 - BPL 1$; Еслинеготов,сбрасываемеще677 - разипроверяемснова678 - TST (R1); Проверимнаошибку,667 +1$: CLR (R1); Send the "Reset" command 668 + TSTB (R1); Check the controller readiness 669 + BPL 1$; If not ready, reset again 670 +; once and check again 671 + TST (R1); Check for an error, 679 679 BMI 0ERR$ 680 680 CLR R1 681 681 return ... ... @@ -683,27 +683,27 @@ 683 683 COM R1 684 684 return 685 685 686 -; trap 55 - записьэнергонезависимойпамятиизбуферасадресаADREEPROMMEM в блок 1 EEPROM679 +; trap 55 - write non-volatile memory from the buffer at address ADREEPROMMEM в блок 1 EEPROM 687 687 WriteEEPROM: push R1 688 688 push R2 689 689 push R3 690 - call AZreset; сбросим683 + call AZreset; reset 691 691 tst R1 692 692 bne 0ERR$ 693 693 694 694 MOV #AZ$CSR,R1 695 - mov #23,(R1); командуемчтобудемписатьданныевбуфер696 -0$: TSTB (R1); проверяемрезультатвыполнения697 - BPL 0$; ждем698 - TST (R1)+; инкрементируем688 + mov #23,(R1);command that we will write data to the buffer 689 +0$: TSTB (R1); check the result of executio 690 + BPL 0$; wait 691 + TST (R1)+; increment 699 699 mov #ADREEPROMMEM+2,R3 700 - mov #255.,R2; пишем255.слов;первоесловопропускаем-результатчтения701 -1$: mov (R3)+,(R1); отдаемвконтроллер693 + mov #255.,R2; write 255. words; skip the first word - the result of reading 694 +1$: mov (R3)+,(R1); send to the controller 702 702 sob R2,1$ 703 - tst -(R1); декрементируем704 - mov #24,(R1); записатьизбуферавблок1энергонезависимойпамяти705 -2$: TSTB (R1); проверяемрезультатвыполнения706 - BPL 2$; ждем696 + tst -(R1); decrement 697 + mov #24,(R1); write from the buffer to block 1 of non-volatile memory 698 +2$: TSTB (R1); check the result of execution 699 + BPL 2$; we are waiting 707 707 br 0END$ 708 708 0ERR$: CLR R3 709 709 0END$: pop R3 ... ... @@ -712,23 +712,21 @@ 712 712 return 713 713 {{/code}} 714 714 715 -** Обращаювнимание**,призаписи,буферидетсразусданными,тенетпервогословасостатусом.708 +**Please note** that when recording, the buffer immediately comes with the data, i.e. there is no first word with the statu 716 716 717 717 718 718 719 -= БлоккоманддляработысRTCиNTP =712 += Block of commands for working with RTC and NTP = 720 720 721 - ВконтроллереAZ®есть2источникаполучениядаты-времени,первыйэтоRTCвстроенныйвSTM32,второйэточасывстекеTCP/IP.ЧасыRTCработаютавтономноприналичииустановленнойбатарейки2032.ЧасывстекеTCP/IPустанавливаютсянаоснованииданныхсNTP-сервера.714 +The AZ® controller has 2 sources of date-time, the first is the RTC built into the STM32, the second is the clock in the TCP/IP stack. The RTC clock works autonomously with a 2032 battery installed. The clock in the TCP/IP stack is set based on data from the NTP server. 722 722 723 723 724 -== Форматбуфераtimestamp (доступен по чтению) ==717 +== Buffer format timestamp (readable) == 725 725 726 -API контроллерасразуготовитвремявнескольких форматах,дабыегобылоудобноприменитьнасторонеPDP-11719 +The controller API immediately prepares time in several formats, so that it can be conveniently used on the PDP-11 side 727 727 728 728 {{info}} 729 -формат буфера даты-времени 730 -offset в восьмеричной системе - те слова 731 -формат буфера даты-времени 722 +datetime buffer format octal offset - those words datetime buffer format 732 732 \\[0]=rtc_rt11date(); 733 733 [2]=rt11 time 50Hz big word; 734 734 [4]=rt11 time 50Hz little word; ... ... @@ -746,72 +746,72 @@ 746 746 {{/info}} 747 747 748 748 749 -== Формат буфераSimpleIN (призаписи) ==740 +== SimpleIN buffer format (when writing) == 750 750 751 - форматмаксимальноупрощен,дляработысостороныPDP-11742 +the format is simplified as much as possible, for work with PDP-11 752 752 753 753 {{info}} 754 -offset ввосьмеричнойсистеме-теслова745 +offset in octal - those words 755 755 756 -[0]=year год,младшиедвецифры-те22ане2022(!)757 -[2]=month; месяц758 -[4]=day; день759 -[6]=wday; деньнедели=0неустановлен, 1-понедельник2 -вторникитд760 -[10]=hour; час761 -[12]=min; минута762 -[14]=sec; секунда747 +[0]=year, the lower two digits are 22 and not 2022(!) 748 +[2]=month; month 749 +[4]=day; day 750 +[6]=wday; day of the week =0 not set, 1 - Monday 2 - Tuesday etc. 751 +[10]=hour; hour 752 +[12]=min; minute 753 +[14]=sec; second 763 763 {{/info}} 764 764 765 765 766 -== **031:ПолучитьвремяизRTCвбуферtimestamp**==757 +== 031: Get time from RTC to timestamp buffer == 767 767 768 - Кодкоманды031,даннаякомандаиспользуетRTCчасыкакисточникзаполнениябуфераtimestamp759 +Command code 031, this command uses RTC clock as a source of filling the timestamp buffer 769 769 770 - Примерпрограммы:761 +Example program: 771 771 772 772 {{code language="assembler"}} 773 -; trap 61 - чтениеданныхчасовизавтономныхчасовRTC774 -; R3 - адресбуферакуданадосчитать775 -; результатвR3адрес,еслиуспешно. R3=0если ошибка764 +; trap 61 - reading clock data from autonomous RTC clock 765 +; R3 - buffer address where to read 766 +; result in R3 address if successful. R3=0 if error 776 776 GetDateFromRTC: push R0 777 777 push R1 778 778 push R2 779 - call AZreset; сбросим770 + call AZreset; reset 780 780 tst R1 781 781 bne G60ERR 782 782 MOV #AZ$CSR,R1 783 783 mov #31,(R1) 784 - br G60; идемтудаткдальшекододинаковый775 + br G60; let's go there because further code is the same 785 785 {{/code}} 786 786 787 -== **032:Получитьвремяизбуфераtimestamp**==778 +== 032: Get time from timestamp buffer == 788 788 789 - Кодкоманды032,даннаякомандаотдаетнашинусодержимоебуфераtimestamp780 +Command code 032, this command sends the contents of the timestamp buffer to the bus 790 790 791 791 {{code language="assembler"}} 792 -; работасчасами793 -; trap 60 - чтениеданныхчасовизTCP/IPстека794 -; R3 - адресбуферакуданадосчитать795 -; результатвR3адрес,еслиуспешно. R3=0если ошибка783 +; working with clock 784 +; trap 60 - reading clock data from TCP/IP stack 785 +; R3 - buffer address where to read 786 +; result in R3 address if successful. R3=0 if error 796 796 GetDateFromLAN: push R0 797 797 push R1 798 798 push R2 799 - call AZreset; сбросим790 + call AZreset; reset 800 800 tst R1 801 801 bne G60ERR 802 802 MOV #AZ$CSR,R1 803 803 mov #42,(R1) 804 -G60: TSTB (R1); проверяемрезультатвыполнения805 - BPL G60; ждем795 +G60: TSTB (R1); check execution result 796 + BPL G60; wait 806 806 mov #32,(R1) 807 -1$: TSTB (R1); проверяемрезультатвыполнения798 +1$: TSTB (R1); check execution result 808 808 BPL 1$; ждем 809 - TST (R1)+; инкрементируем810 - mov R3,R0; запомнимR3- адрес811 - mov #10.,R2; читаем10слов812 -2$: mov (R1),(R3)+; читаемблоксловвпамять800 + TST (R1)+; increment 801 + mov R3,R0; remember R3 address 802 + mov #10.,R2; read 10 words 803 +2$: mov (R1),(R3)+; read block of words into memory 813 813 sob R2,2$ 814 - mov R0,R3; успешно,вернемадресвR3805 + mov R0,R3; successful, return address to R3 815 815 br 0END$ 816 816 G60ERR: CLR R3 817 817 0END$: pop R2 ... ... @@ -820,11 +820,11 @@ 820 820 return 821 821 {{/code}} 822 822 823 - Стоитпроверитькорректностьполученноговремени:814 +It is worth checking the correctness of the received time: 824 824 825 825 {{code language="assembler"}} 826 -; trap 63 - проверкакорректностивремени827 -; R3 - адресбуфера,результатвR3,еслиадресбуфератоOK, =0ошибка817 +; trap 63 - check time correctness 818 +; R3 - buffer address, result in R3, if buffer address then OK, =0 error 828 828 CheckDateTime: Cmp 6(r3),#2021. 829 829 Blos 1err 830 830 Cmp 6(r3),#2100. ... ... @@ -834,119 +834,119 @@ 834 834 return 835 835 {{/code}} 836 836 837 -== **033:Записьвремени-датывбуферSimpleIN**==828 +== 033: Write time-date to SimpleIN buffer == 838 838 839 - Кодкоманды033,даннаякомандапринимаетсшиныданныевбуферSimpleIN830 +Command code 033, this command receives data from the bus into the SimpleIN buffer 840 840 841 - Работаданнойкомандыаналогичнаработе команд [[023>>doc:||anchor="H023:41F44043843D44F44244C44144843843D44B43243144344443544043443043D43D44B43543443B44F43F43E44143B43543444344E44943543943743043F438441438432431443444435440"]]и[[016>>doc:||anchor="H016:A041F44043843D44F44244C43143B43E43A43443043D43D44B445432431443444435440"]].832 +The operation of this command is similar to the operation of commands 023 and 016. 842 842 843 -== **034:УстановкаRTCнаоснованииданныхизбуфера**==834 +== 034: Set RTC based on buffer data == 844 844 845 - Кодкоманды034,даннаякомандаустанавливаетRTCнаоснованииданныхвбуфереSimpleIN836 +Command code 034, this command sets the RTC based on the data in the SimpleIN buffer 846 846 847 - Даннаякомандавыполняетсябыстро,нодляисключенияпроблемцикложиданиявыполнениярекомендуется.838 +This command executes quickly, but to avoid problems, a wait loop is recommended. 848 848 849 -== **035:СтимуляциязапросавременисNTPсервера,установканаоснованииответа**==840 +== 035: Stimulate time request from NTP server, set based on response == 850 850 851 - Кодкоманды035,даннаякомандаотправляетзапроснаNTPcервер(установленныйвAZ.INIфайлеилиполученныйотDHCP)иустанавливаетчасывстекеTCP/IP.842 +Command code 035, this command sends a request to the NTP server (set in the AZ.INI file or received from DHCP) and sets the clock in the TCP/IP stack. 852 852 853 - Примерпрограммы:отсылказапросанаустановкувременисNTPсервера844 +Example program: sending a request to set the time from an NTP server 854 854 855 855 {{code language="assembler"}} 856 -; trap 62 - отсылказапросанаустановкувременисNTPсервера847 +; trap 62 - sending a request to set the time from the NTP server 857 857 GetDateNTPtoNET:push R1 858 - call AZreset; сбросим849 + call AZreset; reset 859 859 tst R1 860 860 bne 0ERR$ 861 861 MOV #AZ$CSR,R1 862 862 mov #35,(R1) 863 -0$: TSTB (R1); проверяемрезультатвыполнения864 - BPL 0$; ждем854 +0$: TSTB (R1); check the result of execution 855 + BPL 0$; wait 865 865 0ERR$: pop R1 866 866 return 867 867 {{/code}} 868 868 869 - Выполнениекомандызанимает1-2секундывсреднем.ДаннаякомандатребуетработыстекаTCP/IP,соответственнонужныциклыожиданияпривключенномстеке.860 +The command execution takes 1-2 seconds on average. This command requires the TCP/IP stack to work, so waiting cycles are needed when the stack is enabled. 870 870 871 - Примерциклаопросасцельюполучитьвремяссети862 +An example of a polling cycle to get time from the network 872 872 873 873 {{code language="assembler"}} 874 -; дата-время865 +; date-time 875 875 mov #S_DateTime_0,R3; "Lan Date:" 876 876 trap 10 877 - mov #20,R4; количествоцикловожидания878 -$datry: trap 62; отослализапроскNTPсерверу879 - mov #110,@#AZ$CSR; включимсеть880 - trap 47; ожидание881 - trap 47; ожидание868 + mov #20,R4; number of wait cycles 869 +$datry: trap 62; sent a request to the NTP server 870 + mov #110,@#AZ$CSR; enable the network 871 + trap 47; waiting 872 + trap 47; waiting 882 882 mov #ADRTMPSTR,R3 883 - trap 60; считаливбуфер дату-время884 - trap 63; проверилидату-время874 + trap 60; read the date-time into the buffer 875 + trap 63; checked the date-time 885 885 tst R3 886 886 bne $ok 887 887 $sob: sob R4,$datry 888 - mov #S_DateTime_2,R3; печатьошибки879 + mov #S_DateTime_2,R3; print error 889 889 trap 7 890 890 br $go 891 891 892 892 $ok: mov #ADRTMPSTR,R3 893 - trap 24; печатьдаты894 - trap 25; времени895 -$go: mov #110,@#AZ$CSR; включимсеть884 + trap 24; print date 885 + trap 25; time 886 +$go: mov #110,@#AZ$CSR; let's turn on the network 896 896 {{/code}} 897 897 898 - ТутмыявноотсылаемзапроскNTPсерверу,затемвключаемработусетииждемрезультата,периодическиопрашиваяипроверяякорректностьрезультата.889 +Here we explicitly send a request to the NTP server, then turn on the network and wait for the result, periodically polling and checking the correctness of the result. 899 899 900 -== **036:УстановкаRTCнаоснованиичасовTCP/IPстека**==891 +== 036: Setting RTC based on TCP/IP stack clock == 901 901 902 - Кодкоманды036,даннаякомандаустанавливаетRTCнаоснованиичасоввTCP/IPстека.Предварительнонадоустановить часывTCP/IP -команда036.893 +Command code 036, this command sets the RTC based on the clock in the TCP/IP stack. You must first set the clock in TCP/IP - command 036. 903 903 904 - Примерпрограммы:895 +Example program: 905 905 906 906 {{code language="assembler"}} 907 -; trap 64 - установкавремениRTCнаоснованиивременистека908 -; R1 - результат909 -SetDateNETtoRTC:call AZreset; сбросим898 +; trap 64 - set RTC time based on stack time 899 +; R1 - result R1=0 - OK 900 +SetDateNETtoRTC:call AZreset; reset 910 910 tst R1 911 911 bne 0ERR$ 912 912 MOV #AZ$CSR,R1 913 913 mov #36,(R1) 914 -0$: TSTB (R1); проверяемрезультатвыполнения915 - BPL 0$; ждем905 +0$: TSTB (R1); check execution result 906 + BPL 0$; wait 916 916 clr R1 917 917 0ERR$: return 918 918 {{/code}} 919 919 920 -== **042:ПолучитьвремяизчасовTCP/IPстекавбуферtimestamp**==911 +== 042: Get time from TCP/IP stack clock into timestamp buffer == 921 921 922 - Кодкоманды042,даннаякомандаиспользуетчасыTCP/IPстекакакисточникзаполнениябуфераtimestamp.913 +Command code 042, this command uses the TCP/IP stack clock as a source for filling the timestamp buffer. 923 923 924 - Примерпрограммы:915 +Example program: 925 925 926 926 {{code language="assembler"}} 927 -; работасчасами928 -; trap 60 - чтениеданныхчасовизTCP/IPстека929 -; R3 - адресбуферакуданадосчитать930 -; результатвR3адрес,еслиуспешно. R3=0если ошибка918 +; working with clock 919 +; trap 60 - reading clock data from TCP/IP stack 920 +; R3 - buffer address where to read 921 +; result in R3 address if successful. R3=0 if error 931 931 GetDateFromLAN: push R0 932 932 push R1 933 933 push R2 934 - call AZreset; сбросим925 + call AZreset; reset 935 935 tst R1 936 936 bne G60ERR 937 937 MOV #AZ$CSR,R1 938 938 mov #42,(R1) 939 -G60: TSTB (R1); проверяемрезультатвыполнения940 - BPL G60; ждем930 +G60: TSTB (R1); check execution result 931 + BPL G60; wait 941 941 mov #32,(R1) 942 -1$: TSTB (R1); проверяемрезультатвыполнения943 - BPL 1$; ждем944 - TST (R1)+; инкрементируем945 - mov R3,R0; запомнимR3- адрес933 +1$: TSTB (R1); check execution result 934 + BPL 1$; wait 935 + TST (R1)+; increment 936 + mov R3,R0; remember R3 address 946 946 mov #10.,R2; читаем 10 слов 947 -2$: mov (R1),(R3)+; читаемблоксловвпамять938 +2$: mov (R1),(R3)+; read block of words into memory 948 948 sob R2,2$ 949 - mov R0,R3; успешно,вернемадресвR3940 + mov R0,R3; successful, return address to R3 950 950 br 0END$ 951 951 G60ERR: CLR R3 952 952 0END$: pop R2 ... ... @@ -955,52 +955,50 @@ 955 955 return 956 956 {{/code}} 957 957 958 - всекомандыустанавливаютбитготовностипозавершению.949 +All commands set the ready bit upon completion. 959 959 960 960 961 -= ** Команды специфические для[[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]]** =952 += **[[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] **specific commands = 962 962 963 - ДанныекомандыпредназначеныдляработыконтроллераAZБК®,разработанногодлясериикомпьютеровБК-БК-0010/БК-0010.01/БК-0011М.954 +These commands are intended for operation of the AZБК® controller, developed for the BK series of computers - BK-0010/BK-0010.01/BK-0011M. 964 964 965 - ДругиеконтроллерыAZ®игнорируютэтикоманды956 +Other AZ® controllers ignore these commands. 966 966 967 -== **037:перезапускконтроллера[[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]]и всей БК** ==958 +== 037: Restart of the** [[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] **controller and the entire computer == 968 968 969 - Кодкоманды037,даннаякомандаосуществляетперезапускмикроконтроллераAZ®,чтовызываетиперезапусксамойБК-0010/БК-0010.01/БК-0011М960 +Command code 037, this command restarts the AZ® microcontroller, which also causes a restart of the BK-0010/BK-0010.01/BK-0011M itself 970 970 971 - Примерпрограммы962 +Example program 972 972 973 973 {{code language="assembler"}} 974 -AZ$CSR регистркомандисостояния(CSR)975 -AZ$DR регистрданных(DR)965 +AZ$CSR = 177220; command and status register (CSR) 966 +AZ$DR = 177222; data register (DR) 976 976 977 977 978 -; trap 57 - перезапускБК полный979 -AZcouldReboot: call AZreset; сбросимAZдабыонбылготовприниматькоманды969 +; trap 57 - full restart 970 +AZcouldReboot: call AZreset; reset AZ so it is ready to receive 980 980 mov #037,@#AZ$CSR 981 981 return 982 982 {{/code}} 983 983 984 -== **044:Cохранениескриншотавфайл**==975 +== 044: Saving a screenshot to a file == 985 985 986 -Код команды 044, данная команда предназначена для снятия образа памяти указанного размера (или определенного автоматически на основании сохраненных параметров) 987 -технически команда может служить как средство отладки ибо способная снимать образ памяти 988 -общее ограничение на снятие образа памяти - 2МБ на один образ 989 -\\в качестве параметров используется служебная страница памяти 76(8) 977 +Command code 044, this command is designed to take a memory image of the specified size (or determined automatically based on saved parameters) technically, the command can serve as a debugging tool because it is capable of taking a memory image the general limitation on taking a memory image is 2MB per image 978 +\\service memory page 76(8) is used as parameters 990 990 991 - Структуразаполненияинформацииоскриншоте980 +Structure of filling information about a screenshot 992 992 993 993 {{code language="c"}} 994 -// структурахидераскриншота983 +// screenshot header structure 995 995 typedef __packed struct screen_header 996 996 { 997 - unsigned short int tag; долженбытьравен0240986 + unsigned short int tag; // must be equal to 0240 998 998 999 - unsigned int начальныйадресвсловах-прямаязадачавфизическихадресах1000 - unsigned int длинавсловах-прямаязадачавфизическихадресах988 + unsigned int begin_adress; // start address in words - forward task in physical addresses 989 + unsigned int length; // length in words - forward task in physical addresses 1001 1001 1002 - unsigned short int begin_page; // начальнаястраница-номер-прямаязадачавномерахстраниц1003 - unsigned short int len_pages; // количествостраниц-прямаязадачавномерахстраниц991 + unsigned short int begin_page; // start page - number - forward task in page numbers 992 + unsigned short int len_pages; // number of pages - forward task in page numbers 1004 1004 1005 1005 unsigned short int R177300; // 1006 1006 unsigned short int R177302; // ... ... @@ -1018,57 +1018,55 @@ 1018 1018 unsigned short int R177332; // 1019 1019 unsigned short int R177334; // 1020 1020 unsigned short int R177336; // 1021 - unsigned short int R177340; // - Региструправленияактивациейокно-маскиокон1022 - unsigned short int R177342; // - Региструправленияr/oнаокно1023 - unsigned short int R177344; // - Регистр управления shadowокон-маскиокон1024 - unsigned short int R177346; // - Региструправлениямаппером1025 - unsigned short int R177350; // - регистркопияпозаписи177130врежимезаписиуправленияпамятьювSMK1026 - unsigned short int R177352; // - регистркопияпозаписи177716врежимезаписиуправленияпамятьювБК11М1010 + unsigned short int R177340; // - Window activation control register - window masks 1011 + unsigned short int R177342; // - Control register r/o per window 1012 + unsigned short int R177344; // - Shadow window control register - window masks 1013 + unsigned short int R177346; // - Mapper control register 1014 + unsigned short int R177350; // - copy by record register 177130 in memory management write mode in SMK 1015 + unsigned short int R177352; // - copy by record register 177716 in memory management write mode in BK11M 1027 1027 1028 - unsigned short int R177230; // - региструправления1029 - unsigned short int R177232; // - регистрномерастраницыначалаотображения-верхняястраница(слой0)1030 - unsigned short int R177240; // - регистрномерастраницыначалаотображения-средняястраница(слой1)1031 - unsigned short int R177242; // - регистрномерастраницыначалаотображения-нижняястраницаслой2)1032 - unsigned short int R177244; // - регистрвертикальногоскролингаслой21033 - unsigned short int R177246; // - регистрвертикальногоскролингаслой11034 - unsigned short int R177250; // - регистрвертикальногоскролингаслой01035 - unsigned short int R177252; // - регистргозизонтальногоскролингаслой01036 - unsigned short int R177254; // - регистргозизонтальногоскролингаслой11037 - unsigned short int R177256; // - регистргозизонтальногоскролингаслой21017 + unsigned short int R177230; // - control register 1018 + unsigned short int R177232; // - display start page number register - upper page (layer 0) 1019 + unsigned short int R177240; // - display start page number register - upper page (layer 1) 1020 + unsigned short int R177242; // - display start page number register - upper page (layer 2) 1021 + unsigned short int R177244; // - vertical scroll register layer 2 1022 + unsigned short int R177246; // - vertical scroll register layer 1 1023 + unsigned short int R177250; // - vertical scroll register layer 0 1024 + unsigned short int R177252; // - horizontal scroll register layer 0 1025 + unsigned short int R177254; // - horizontal scroll register layer 1 1026 + unsigned short int R177256; // - horizontal scroll register layer 2 1038 1038 1039 1039 unsigned short int paldata[338]; // 1040 1040 } screen_header_t; 1041 1041 {{/code}} 1042 1042 1043 - Примеркодадлязаполнениястраницыпамяти1032 +Example code for filling a memory page 1044 1044 1045 1045 {{code language="assembler"}} 1046 1046 ;-------------------------------------------------- 1047 -; карта76йстраницы-тудамыготовимданныедлякомандыскринщотов1048 - уюстраницуцепляемнаместо77йвременно-тевокно1300001049 - тутвход- 240 - 1слово1050 - сюдакомандусадресами-адрес+длина24бита- 4слова1051 - сюдакомандусостраницами-начальнаястраницаиколичествостраниц- 2слова1052 - cюдаконфигурациюпамятиизрегистров- 22слова1053 - сюдаконфигурациювидеоконтроллера- 10cлов1054 - сюда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 1055 1055 ;-------------------------------------------------- 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 1056 1056 1057 - 1058 -; trap 41 - подготовка дефолтной информации для работы функционала скриншотов 1059 -PrepSRC: jsr R5, PUSHA ; пакетное сохранение регистров 1060 - mov @#177326,-(SP) ; сохраним страницу 130k которая была до вызова 1061 - mov #76,@#177326 ; цепляем 76ую страницу в окно 1062 - 1063 - mov #100377,R3 ; константа-заполнитель 1050 + mov #100377,R3 ; constant-filler 1064 1064 mov #SCR_PAGE,R4 1065 1065 mov #2047.,R2 1066 1066 4$: mov R3,(R4)+ 1067 1067 sob R2,4$ 1068 1068 1069 - mov #240,@#SCR_TAG ; проставляемтег1056 + mov #240,@#SCR_TAG ; put the tag 1070 1070 1071 - ; чистимучастокадресов-дефолтноавтоматическоеопределениеадресов1058 + ; clean the address section - default is automatic address detection 1072 1072 clr R3 1073 1073 mov #SCR_ADDR_CONF,R4 1074 1074 mov #10,R2 ... ... @@ -1075,7 +1075,7 @@ 1075 1075 2$: mov R3,(R4)+ 1076 1076 sob R2,2$ 1077 1077 1078 - ; конфигурацияпамяти-дефолтная1065 + ; memory configuration - default 1079 1079 mov #SCR_MEM_CONF,R4 1080 1080 mov #30,(R4)+ ;177300 1081 1081 mov #31,(R4)+ ;177302 ... ... @@ -1094,29 +1094,29 @@ 1094 1094 mov #110,(R4)+ ;177334 1095 1095 mov #100,(R4)+ ;177336 1096 1096 1097 - mov #170000,(R4)+ ;177340 - Регистр управления активацией окно - маски окон1098 - mov R3,(R4)+ ;177342 - Регистр управления r/o на окно1099 - mov #7777,(R4)+ ;177344 - Регистр управления shadow окон - маски окон1100 - mov #40404,(R4)+ ;177346 - Регистр управления маппером1101 - mov R3,(R4)+ ;177350 - регистр копия по записи 177130 в режиме записи управления памятью в SMK1102 - 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 1103 1103 1104 - ; конфигурациявидеоконтроллера-дефолтная1091 + ;Video controller configuration - default 1105 1105 ; 177230-177256 1106 1106 mov #SCR_VGA_CONF,R4 1107 1107 1108 - mov #12201,(R4)+ ;177230 - регистр управления1109 - mov #4,(R4)+ ;177232 - регистр номера страницы начала отображения - верхняя страница (слой 0)1110 - mov R3,(R4)+ ;177240 - регистр номера страницы начала отображения - средняя страница (слой 1) "под спрайты"1111 - mov R3,(R4)+ ;177242 - регистр номера страницы начала отображения - нижняя страница (слой 2) "под фон"1112 - mov R3,(R4)+ ;177244 - регистр вертикального скролинга слой 21113 - mov R3,(R4)+ ;177246 - регистр вертикального скролинга слой 11114 - mov R3,(R4)+ ;177250 - регистр вертикального скролинга слой 01115 - mov R3,(R4)+ ;177252 - регистр гозизонтального скролинга слой 01116 - mov R3,(R4)+ ;177254 - регистр гозизонтального скролинга слой 11117 - 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 1118 1118 1119 - ; закачиваемпалитру-беремдефолтнуюизэтойПЗУшки1106 + ; download the palette - take the default one from this ROM 1120 1120 mov #SCR_PAL,R4 1121 1121 mov #PalData,R2 1122 1122 mov #338.,R3 ... ... @@ -1123,233 +1123,233 @@ 1123 1123 1$: mov (R2)+,(R4)+ 1124 1124 sob R3,1$ 1125 1125 1126 - mov (SP)+,@#177326; вернемстраницускоторойбылвызов1113 + mov (SP)+,@#177326; return the page from which the call was made 1127 1127 return 1128 1128 {{/code}} 1129 1129 1130 - Вариантовуказанияучастковпамятитри1117 +There are three options for specifying memory areas. 1131 1131 1132 -1. указатьадресидлину24хбитные-cмформат,еслиихнет-системасмотритдальше1133 -1. указатьномерстраницыиколичествостраницы,еслиихнет1134 -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. 1135 1135 1136 - Cкриншотсохраняетсявформате1137 -- страница76 -еепервыйкилобайт1138 -- самобразпамяти(еслирежимслоеный-товсетрислоя)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) 1139 1139 1140 1140 1141 -Перед вызовом команды можно загрузить имя файла для сохранения скриншота [в cmosmem буфер], однако при его отсутствии (в буфере не будет имени - строки заканчивающейся 0) система сформирует свое имя, на основании следующего правила: 1142 -дефолтный путь для сохранения скриншотов 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 1143 1143 0:/SCREENS/ 1144 - форматимени- DDHHMISS.SCR1145 - гдеDD-двецифрыднямесяца, HH-час, MI-минута, SS-секунда1146 -\\ Есливпроцессевыполнениякомандывозникнетошибка-вместоименибудет"ERROR *"1147 - кпримеру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 1148 1148 "ERROR f_open 6" 1149 1149 1150 1150 1151 - Примерпрограммы1137 +Example program 1152 1152 1153 1153 {{code language="assembler"}} 1154 -; обновиминформациювхидерескриншота1140 +; update the information in the screenshot header 1155 1155 ;-------------------------------------------------- 1156 -; карта76йстраницы-тудамыготовимданныедлякомандыскринщотов1157 - 70000уюстраницуцепляемнаместо77йвременно-тевокно1300001158 - тутвход- 240 - 1слово1159 - сюдакомандусадресами-адрес+длина24бита- 4слова1160 - сюдакомандусостраницами-начальнаястраницаиколичествостраниц- 2слова1161 - cюдаконфигурациюпамятиизрегистров- 22слова1162 - сюдаконфигурациювидеоконтроллера- 10cлов1163 - сюда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 1164 1164 ;-------------------------------------------------- 1151 + mov @#177326,R5 ; save page 130k which was before the call 1152 + mov #76,@#177336 ; hook the 76th page into the window 1165 1165 1166 - mov @#177326,R5 ; сохраним страницу 130k которая была до вызова 1167 - mov #76,@#177336 ; цепляем 76ую страницу в окно 1168 - 1169 - ;конфигурация видеоконтроллера 1154 + ;video controller configuration 1170 1170 ; 177230-177256 1171 1171 mov #SVGAC,R4 1172 1172 1173 - mov @#177230,(R4)+;177230 - региструправления1174 - mov @#177232,(R4)+;177232 - регистрверхняястраница(слой0)1175 - mov @#177240,(R4)+;177240 - регистрсредняястраница(слой1)1176 - mov @#177242,(R4)+;177242 - регистр-нижняястраница(слой2)1177 - mov @#177244,(R4)+;177244 - регистрвертикальногоскролингаслой21178 - mov @#177246,(R4)+;177246 - регистрвертикальногоскролингаслой11179 - mov @#177250,(R4)+;177250 - регистрвертикальногоскролингаслой01180 - mov @#177252,(R4)+;177252 - регистргозизонтальногоскролингаслой01181 - mov @#177254,(R4)+;177254 - регистргозизонтальногоскролингаслой11182 - 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 1183 1183 1184 - mov R5,@#177336; вернемстраницускоторойбылвызов1169 + mov R5,@#177336; return the page from which the call was made 1185 1185 1186 1186 1187 1187 ;------------------------- 1188 - MOV #AZ$CSR,R3 ; ГотовимCSRконтроллера1189 - MOV #AZ$DR,R4 ; ГотовимDRконтроллера1190 -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 1191 1191 TSTB (R3) 1192 1192 BPL 20$ 1193 1193 1194 - ; очистимблокпамятидляимени-дабысистемасделаладефолтноеимяфайла1195 - mov #23,(R3) ; командуемчтобудемписатьданныевбуфер1196 -128$: TSTB (R3) ; проверяемрезультатвыполнения1197 - 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 1198 1198 clr R1 1199 1199 1200 1200 mov #256.,R2 ; 1201 -129$: mov R1,(R4) ; отдаемвконтроллер1186 +129$: mov R1,(R4) ; give to the controller 1202 1202 sob R2,129$ 1203 1203 1204 1204 1205 - MOV #044,(R3) ; командаскриншот1190 + MOV #044,(R3) ; screenshot command 1206 1206 22$: TSTB (R3) ; 1207 1207 BPL 22$ ; 1208 1208 1209 - ; получимимяскриншота1210 - mov #22,(R3) ; отдатьнашинусчитанныйблокпамятиизбуфера1211 -121$: tstb (R3) ; проверяемрезультатвыполнения1212 - 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 1213 1213 1214 1214 mov #BUF,R1 1215 - mov #256.,R2 ; читаем256.слов;первоеслово-результатчтения1216 -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 1217 1217 sob R2,122$ 1218 1218 1219 1219 .PRINT #RESOK 1220 1220 .Print #BUF 1221 1221 1222 - mov #110,@#AZ$CSR; включаемсетьпо-умолчаниюсетьдолжнабытьпостоянновключена1207 + mov #110,@#AZ$CSR; enable the network by default, the network should be constantly enabled 1223 1223 .Exit 1224 1224 {{/code}} 1225 1225 1226 - Дляраспаковкискриншотаможноиспользоватьвотэтуутилиту1211 +To unpack a screenshot, you can use this utility - [[https:~~/~~/master.pdp-11.ru/screen_unpack/>>https://master.pdp-11.ru/screen_unpack/]] 1227 1227 1228 1228 1229 1229 1230 -= **КомандыдляработысостекомTCP/IP**=1215 += Commands for working with the TCP/IP stack = 1231 1231 1232 - следующиекомандыработаютсбуфероминформацииTCP/IP cтека.1217 +The following commands operate on the TCP/IP stack information buffer. 1233 1233 1234 -== **040:Получитьipадресипрочиенастройки стекаTCP/IPвбуфер**==1219 +== 040: Get IP address and other TCP/IP stack settings to buffer == 1235 1235 1236 - Кодкоманды040,даннаякомандазаполняетбуферинформациейсTCP/IP cтекатекущей(фактической)информацией.1221 +Command code 040, this command fills the buffer with information from the TCP/IP stack with current (actual) information. 1237 1237 1238 -== **041:Чтениебуфераipадреса**==1223 +== 041: Reading ip address buffer == 1239 1239 1240 - Кодкоманды041,даннаякомандапередаетбуфернашину1225 +Command code 041, this command transfers the buffer to the bus 1241 1241 1242 - этапаракомандпозволяетполучитьтекущуюинформациюсостека1227 +This pair of commands allows you to get current information from the stack 1243 1243 1244 -* IP адрес1245 -* MASK маску1246 -* GW гейтвей1247 -* NTP адресNTP-сервера1248 -* DNS1 адресосновногоDNS1249 -* 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 1250 1250 1251 - соответственноэто12слов1236 +accordingly it is 12 words 1252 1252 1253 - Примерпрограммы:1238 +Example program: 1254 1254 1255 1255 {{code language="assembler"}} 1256 -; trap 52 - чтение блока IP адресов в блок памяти IPADDDBLOCK (8. ячеек) 1257 -; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK) 1258 -GetIPaddrs: push R1 1259 - push R2 1260 - call AZreset; сбросим 1261 - tst R1 1262 - bne 0ERR$ 1263 - MOV #AZ$CSR,R1 1264 - mov #40,(R1) 1265 -0$: TSTB (R1); прочитать адреса в свою память 1266 - BPL 0$; ждем 1267 - mov #41,(R1) 1268 -1$: TSTB (R1); подготовить буфер 1269 - BPL 1$; ждем 1270 - TST (R1)+; инкрементируем 1271 - mov #IPADDDBLOCK,R3 1272 - mov #12.,R2 1273 -2$: mov (R1),(R3)+; читаем блок слов в память 1274 - sob R2,2$ 1275 - mov #IPADDDBLOCK,R3; успешно 1276 - br 0END$ 1277 -0ERR$: CLR R3 1278 -0END$: pop R2 1279 - pop R1 1280 - 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 + 1281 1281 {{/code}} 1282 1282 1283 - Примерданных1269 +Example return data: 1284 1284 1285 1285 {{info}} 1286 - Примерыданных-возвращаемыесловаввосьмеричномформате1287 -124300 116400 - IP адрес192.168.0.1571288 -177777 000377 - MASK маску255.255.255.01289 -124300 000400 - GW гейтвей192.168.0.11290 -124300 000400 - NTP адресNTP-сервера192.168.0.11291 -124300 050000 - DNS1 адресосновногоDNS 192.168.0.901292 -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 1293 1293 {{/info}} 1294 1294 1295 -== **043:чтениеMAC-адресавipбуфер**==1281 +== 043: Read MAC address into ip buffer == 1296 1296 1297 -Код команды 043, данная команда читает текущий фактический MAC адрес в буфер IP адресов 1298 -те сначала 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 1299 1299 1300 - Примерпрограммы:1285 +Example program: 1301 1301 1302 1302 {{code language="assembler"}} 1303 -; trap 72 - чтение MAC адреса в блок памяти IPADDDBLOCK (12. ячеек) 1304 -; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK) 1305 -GetMACaddrs: push R1 1306 - push R2 1307 - call AZreset ; сбросим 1308 - tst R1 1309 - bne 0ERR$ 1310 - MOV #AZ$CSR,R1 1311 - mov #43,(R1) 1312 -0$: TSTB (R1) ; прочитать адреса в свою память 1313 - BPL 0$ ; ждем 1314 - mov #41,(R1) 1315 -1$: TSTB (R1) ; подготовить буфер 1316 - BPL 1$ ; ждем 1317 - TST (R1)+ ; инкрементируем 1318 - mov #IPADDDBLOCK,R3 1319 - mov #12.,R2 1320 -2$: mov (R1),(R3)+ ; читаем блок слов в память 1321 - sob R2,2$ 1322 - mov #IPADDDBLOCK,R3; успешно 1323 - br 0END$ 1324 -0ERR$: CLR R3 1325 -0END$: pop R2 1326 - pop R1 1327 - 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 + 1328 1328 {{/code}} 1329 1329 1330 1330 1331 1331 1332 -= **КомандыдляработысMicroSDкартойнафайловомуровне**=1318 += Commands for working with a MicroSD card at the file level = 1333 1333 1334 1334 1335 - Данныекомандыпредназначеныдляработыс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. 1336 1336 1337 -Эти команды используют буфер 256. слов который задействован в интерфейсе работы с энергонезависимой памятью (см выше команды 022 023) 1338 -\\Ограничения - длина полного пути к файлу 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) 1339 1339 1340 - ==**050:Установитьимяфайлакоторыйбудемчитать**==1325 +Limitations - the length of the full path to the file is 256 bytes 1341 1341 1342 - Кодкоманды050,даннаякомандаустанавливаетимяфайлакоторыйбудемчитать,приэтом производится открытие файла на чтение, а также получение его свойств.1327 +== 050: Set the name of the file we will read == 1343 1343 1344 - ==**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. 1345 1345 1346 - Кодкоманды051,даннаякомандапередаетнаМПИразмерфайлаилиошибкуего чтения. Размер файла 31бит, старший бит является признаком ошибки. Соответственно максимальный размер файлов с которыми можно работать через этот интерфейс ограничен 2^31 байт (2GB).1331 +== 051: Get file size for reading (or its status) on BUS == 1347 1347 1348 -формирование ошибки выглядит так: 1349 -sizeanyfile=1<<31 + FFres; ~/~/ если установлен старший бит 32х битного слова - то в младшей части код ошибки 1350 -\\FFres = ошибка FatFS 1351 - 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). 1352 1352 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 + 1353 1353 {{code language="c"}} 1354 1354 typedef enum { 1355 1355 FR_OK = 0, /* (0) Succeeded */ ... ... @@ -1377,317 +1377,309 @@ 1377 1377 1378 1378 [[http:~~/~~/elm-chan.org/fsw/ff/doc/open.html>>url:http://elm-chan.org/fsw/ff/doc/open.html]] 1379 1379 1380 -== **052:Читатьблокустановленногофайлавбуфер**==1367 +== 052: Read a block of a set file into a buffer == 1381 1381 1382 - Кодкоманды052,даннаякомандаосуществляетчтениефайлавбуферэнергонезависимойпамяти.1369 +Command code 052, this command reads a file into a non-volatile memory buffer. 1383 1383 1384 -В итоге схема чтения файла выглядит вот так 1385 -**023** - заливаем имя файла в буфер 1386 -**050** - устанавливаем файл на чтение 1387 -**051 **- читаем длину файла или ошибку открытия файла 1388 -если ошибка - повторяем сначала 023 050 051 1389 -если все ok - приступаем к чтению файла 1390 -**052** - читает блок файла в буфер 1391 -**022 **- забираем данные из буфера 1392 -пары 052 022 повторяем нужное количество раз дабы считать весь файл 1393 -как файл будет прочтен - последняя 052 команда закроет его автоматически. 1394 - 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. 1395 1395 1396 - Примерпрограммы1382 +Example program: 1397 1397 1398 1398 {{code language="assembler"}} 1385 + call AZRST; reset 1399 1399 1400 - call AZRST; сбросим 1387 +; load the file name into the buffer 1388 +7$: mov #23,(R1); command to write data to the buffer 1389 +5$: TSTB (R1); check execution result 1390 + BPL 5$ ; wait 1391 + TST (R1)+; increment 1392 + mov #FILNM,R3 1393 +1$: mov (R3),(R1); send to controller 1394 + tst (R3)+ 1395 + bne 1$ 1396 + tst -(R1); decrement 1401 1401 1402 -; заливаем в буфер имя файла 1403 -7$: mov #23,(R1); командуем что будем писать данные в буфер 1404 -5$: TSTB (R1); проверяем результат выполнения 1405 - BPL 5$ ; ждем 1406 - TST (R1)+; инкрементируем 1407 - mov #FILNM,R3 1408 -1$: mov (R3),(R1); отдаем в контроллер 1409 - tst (R3)+ 1410 - bne 1$ 1411 - tst -(R1); декрементируем 1398 +; set the file for reading 1399 + mov #50,(R1); set file for reading 1400 +2$: TSTB (R1); check execution result 1401 + BPL 2$ ; wait 1412 1412 1403 +; read the file length 1404 + mov #51,(R1); set file for reading 1405 +3$: TSTB (R1); check execution result 1406 + BPL 3$ ; wait 1407 + TST (R1)+; increment 1408 + mov #FILSZ,R3 1409 + mov (R1),(R3)+; read from controller 1410 + mov (R1),(R3); read from controller 1413 1413 1414 - ; устанавливаем файл на чтение 1415 - mov #50,(R1); устанавливаем файл на чтение 1416 -2$: TSTB (R1); проверяем результат выполнения 1417 - BPL 2$ ; ждем 1412 +; display the file length on the screen 1413 + clr R0 1414 + mov #FILSZ+2,R3 1415 + mov (R3),R1 1416 + call DNOZ 1417 + mov -(R3),R1 1418 + call DNOZ 1419 + .print #STMS2 1418 1418 1421 +; read the file 1422 + mov R1,R4; R1 holds the file length 1423 + MOV #AZ$CSR,R1 1424 + mov #BUFFL,R5 1419 1419 1420 - ; читаем длину файда 1421 - mov #51,(R1); устанавливаем файл на чтение 1422 -3$: TSTB (R1); проверяем результат выполнения 1423 - BPL 3$ ; ждем 1424 - TST (R1)+; инкрементируем 1425 - mov #FILSZ,R3 1426 - mov (R1),(R3)+; читаем с контроллера 1427 - mov (R1),(R3); читаем с контроллера 1426 + bit #1,R4; if an odd number of bytes 1427 + beq 47$ 1428 + inc R4; add 1 more byte as we read words 1428 1428 1429 - ; выведем длину файла на экран 1430 - clr R0 1431 - mov #FILSZ+2,R3 1432 - mov (R3),R1 1433 - call DNOZ 1434 - mov -(R3),R1 1435 - call DNOZ 1436 - .print #STMS2 1430 +47$: tst R4 1431 + beq 45$ ; nothing left to read - exit 1437 1437 1438 - ; читаем файл 1439 - mov R1,R4; в R1 осталась длина файла 1440 - MOV #AZ$CSR,R1 1441 - mov #BUFFL,R5 1433 + mov #52,(R1); read block into buffer 1434 +4$: TSTB (R1); check execution result 1435 + BPL 4$ ; wait 1436 + mov #22,(R1); start reading buffer 1437 +51$: TSTB (R1); check execution result 1438 + BPL 51$ ; wait 1442 1442 1443 - bit #1,R4; если нечетное число байт 1444 - beq 47$ 1445 - inc R4; добавим еще 1 байт тк читаем словами 1440 + cmp R4,#512.; compare with buffer size in bytes 1441 + Blos 44$ ; less than buffer size left 1446 1446 1447 -47$: tst R4 1448 - beq 45$ ; уже нечего читать - выходим 1443 + .print #STMS1 1444 + mov #256.,R2 1445 + TST (R1)+; move to data register 1446 +46$: mov (R1),(R5)+; read into buffer 1447 + sob R2,46$ 1448 + sub #512.,R4; subtract 1449 + TST -(R1); move to command register 1450 + br 47$ 1449 1449 1452 +44$: .print #STMS3 1453 + mov R4,R2 1454 + asr R2 ; /2 since reading words 1455 + TST (R1)+; move to data register 1456 +43$: mov (R1),(R5)+; read into buffer 1457 + sob R2,43$ 1450 1450 1451 - mov #52,(R1); читаем блок в буфер 1452 -4$: TSTB (R1); проверяем результат выполнения 1453 - BPL 4$ ; ждем 1454 - mov #22,(R1); будем читать буфер 1455 -51$: TSTB (R1); проверяем результат выполнения 1456 - BPL 51$ ; ждем 1459 +45$: clr (R5); set end of file marker 1457 1457 1458 - cmp R4,#512.; сравниваем c размером буфера в байтах 1459 - Blos 44$ ; осталось меньше чем буфер 1461 +; file read - display on screen 1462 + .print #STMS4 1463 + .print #BUFFL 1464 + .print #STMS5 1460 1460 1466 + mov #110,@#AZ$CSR; enable network 1467 + .Exit 1461 1461 1462 - .print #STMS1 1463 - mov #256.,R2 1464 - TST (R1)+; переходим на регистр данных 1465 -46$: mov (R1),(R5)+; читаем в буфер 1466 - sob R2,46$ 1467 - sub #512.,R4; вычитаем 1468 - TST -(R1); переходим на регистр команд 1469 - br 47$ 1470 - 1471 -44$: .print #STMS3 1472 - mov R4,R2 1473 - asr R2 ; /2 тк читаем словами 1474 - TST (R1)+; переходим на регистр данных 1475 -43$: mov (R1),(R5)+; читаем в буфер 1476 - sob R2,43$ 1477 - 1478 - 1479 -45$: clr (R5); проставим конец файла 1480 - ; файл считан - выводим на экран 1481 - .print #STMS4 1482 - .print #BUFFL 1483 - .print #STMS5 1484 - 1485 - 1486 - mov #110,@#AZ$CSR; включаем сеть 1487 - .Exit 1488 1488 {{/code}} 1489 1489 1490 1490 1491 1491 1492 -== **053:**установитьимяфайлакоторыйбудемписать==1473 +== 053: set the name of the file that we will write == 1493 1493 1494 - Кодкоманды053,даннаякомандаоткрываетфайлназапись,получаетпараметрыоткрытия(илиошибки).1475 +Command code 053, this command opens a file for writing, receives opening parameters (or errors). 1495 1495 1496 -== **054:**установкадлиныфайла==1477 +== 054: Set file length == 1497 1497 1498 - Кодкоманды054,даннаякомандаустанавливаетожидаемуюдлинуфайла,этонужнодлякорректногоформированияфайланафайловомуровнеMicroSDкарты,атакжедляорганизациипередачиданных.1479 +Command code 054, this command sets the expected file length, this is necessary for the correct formation of the file at the file level of the MicroSD card, as well as for organizing data transfer. 1499 1499 1500 -== **055:**записатьвфайлданныеизбуфера==1481 +== 055: write data from buffer to file == 1501 1501 1502 - Кодкоманды055,даннаякомандазаписываетвоткрытыйфайлназаписьданныеизбуфераэнергонезависимойпамяти.Последняякоманда055автоматическизакроетфайлподостижениюзаявленнойдлиныфайла.1483 +Command code 055, this command writes data from the non-volatile memory buffer to an open file for writing. The last command 055 will automatically close the file when the declared file length is reached. 1503 1503 1504 - Схемаподачикомандпризаписивоттакая1505 -**023** - заливаемимяфайлавбуфер1506 -**053** - устанавливаемфайлначтение1507 -**051 статусоткрытия/созданияфайла1508 - еслиошибка-повторяемсначала023 053 0511509 - есливсеok -идемдальше1510 -**054** - установкадлиныфайла,тенадосразуобъявитькакаяунасбудетдлинафайла1511 -**023** - заливаемблокданныхвбуфер1512 -**055** - пишемизбуферавфайл1513 - пары023 055повторяемнужноеколичествораздабызаписатьвесьфайл1514 - какфайлбудетзаписан-последняя055командазакроетегоавтоматически1485 +The command flow chart for writing is as follows 1486 +**023** - fill the file name into the buffer 1487 +**053** - set the file for reading 1488 +**051** - file opening/creation status 1489 +if an error - repeat from the beginning 023 053 051 1490 +if everything is ok - move on 1491 +**054** - set the file length, i.e. we must immediately declare what the file length will be 1492 +**023** - fill the data block into the buffer 1493 +**055** - write from the buffer to the file 1494 +repeat the 023 055 pairs the required number of times in order to write the entire file 1495 +once the file is written - the last 055 command will close it automatically 1515 1515 1516 1516 1517 - Примерпрограммы:1498 +Example program: 1518 1518 1519 1519 {{code language="assembler"}} 1520 -; заливаемвбуферимяфайла1521 - MOV #AZ$CSR,R1 1522 -17$: mov #23,(R1); командуемчтобудемписатьданныевбуфер1523 -15$: TSTB (R1) ; проверяемрезультатвыполнения1524 - BPL 15$ ; ждем1525 - TST (R1)+ ; переходимнарегистрданных1526 - mov #FILNM2,R3 1527 -11$: mov (R3),(R1); отдаемвконтроллер1528 - tst (R3)+ 1529 - bne 11$ 1530 - tst -(R1) ; переходимнарегистркоманд1501 +; load the file name into the buffer 1502 + MOV #AZ$CSR,R1 1503 +17$: mov #23,(R1); command to write data to the buffer 1504 +15$: TSTB (R1) ; check execution result 1505 + BPL 15$ ; wait 1506 + TST (R1)+ ; move to data register 1507 + mov #FILNM2,R3 1508 +11$: mov (R3),(R1); send to controller 1509 + tst (R3)+ 1510 + bne 11$ 1511 + tst -(R1) ; move to command register 1531 1531 1532 - ; устанавливаем файл на запись1533 - mov #53,(R1); устанавливаемфайлназапись1534 -12$: TSTB (R1) ; проверяемрезультатвыполнения1535 - BPL 12$ ; ждем1513 +; set the file for writing 1514 + mov #53,(R1); set file for writing 1515 +12$: TSTB (R1) ; check execution result 1516 + BPL 12$ ; wait 1536 1536 1518 +; read file creation status 1519 + mov #51,(R1) 1520 +13$: TSTB (R1) ; check execution result 1521 + BPL 13$ ; wait 1522 + TST (R1)+ ; move to data register 1523 + mov #STATS,R3 1524 + mov (R1),(R3)+; read from controller 1525 + mov (R1),(R3); read from controller 1537 1537 1538 - ;читаемстатуссозданияфайла1539 - mov # 51,(R1)1540 - 13$:TSTB(R1); проверяем результат выполнения1541 - B PL13$; ждем1542 - TST (R 1)+; переходим на регистр данных1543 - mov#STATS,R31544 - mov (R1),(R3)+;читаемсконтроллера1545 - mov(R1),(R3); читаем с контроллера1527 +; check here - if the file is created, both words should be zero 1528 + mov #STATS,R3 1529 + TST (R3)+ 1530 + BNE 66$ 1531 + TST (R3) 1532 + BEQ 60$ 1533 +66$: .print #ERRMS1 ; print error 1534 + .exit 1546 1546 1547 - ;тутнадопроверить-еслифайлсоздантообаслованулевые1548 - mov # STATS,R31549 - 3)+1550 - B NE66$1551 - TST (R 3)1552 - BEQ60$1553 - 66$:.print#ERRMS1печатьошибки1554 - .exit1536 +60$: MOV #AZ$CSR,R1 1537 + mov #54,(R1); set file length to be written 1538 +23$: TSTB (R1) ; check execution result 1539 + BPL 23$ ; wait 1540 + TST (R1)+ ; move to data register 1541 + mov #FILSZ,R3 1542 + mov (R3)+,(R1); write to controller 1543 + mov (R3),(R1); write to controller 1555 1555 1556 -60$: MOV #AZ$CSR,R1 1557 - mov #54,(R1); установим длину файла который будем писать 1558 -23$: TSTB (R1) ; проверяем результат выполнения 1559 - BPL 23$ ; ждем 1560 - TST (R1)+ ; переходим на регистр данных 1561 - mov #FILSZ,R3 1562 - mov (R3)+,(R1); пишем в контроллер 1563 - mov (R3),(R1); пишем в контроллер 1545 + tst -(R1) ; move to command register 1564 1564 1565 - tst -(R1) ; переходим на регистр команд 1547 +; write file 1548 + mov @#FILSZ,R4; file length 1549 + MOV #AZ$CSR,R1 1550 + mov #BUFFL,R5; file buffer 1566 1566 1552 + bit #1,R4 ; if an odd number of bytes 1553 + beq 147$ 1554 + inc R4 ; add 1 more byte since reading words 1567 1567 1556 +147$: tst R4 ; check length 1557 + beq 145$ ; nothing left to write - exit 1568 1568 1569 - ; пишем файл 1570 - mov @#FILSZ,R4; длина файла 1571 - MOV #AZ$CSR,R1 1572 - mov #BUFFL,R5; буфер файла 1559 + mov #23,(R1); write to buffer 1560 +151$: TSTB (R1) ; check execution result 1561 + BPL 151$ ; wait 1573 1573 1574 - bit #1,R4 ; если нечетное число байт 1575 - beq 147$ 1576 - inc R4 ; добавим еще 1 байт тк читаем словами 1563 + cmp R4,#512.; compare with buffer size in bytes 1564 + Blos 144$ ; less than buffer size left 1577 1577 1578 -147$: tst R4 ; проверим длину 1579 - beq 145$ ; уже нечего писать - выходим 1566 + .print #STMS6 ; writing full block 1567 + mov #256.,R2 1568 + TST (R1)+ ; move to data register 1569 +146$: mov (R5)+,(R1); write to controller buffer 1570 + sob R2,146$ 1571 + sub #512.,R4; subtract 1572 + TST -(R1) ; move to command register 1580 1580 1581 - mov #23,(R1); будем писать в буфер 1582 -151$: TSTB (R1) ; проверяем результат выполнения 1583 - BPL 151$ ; ждем 1574 + mov #55,(R1); write buffer to file 1575 +104$: TSTB (R1) ; check execution result 1576 + BPL 104$ ; wait 1577 + br 147$ ; loop back 1584 1584 1585 - cmp R4,#512.; сравниваем c размером буфера в байтах 1586 - Blos 144$ ; осталось меньше чем буфер 1579 +144$: .print #STMS7 ; writing last block 1580 + TST (R1)+ ; move to data register 1581 + mov R4,R2 1582 + asr R2 ; /2 since writing words 1583 +143$: mov (R5)+,(R1); write to controller buffer 1584 + sob R2,143$ 1587 1587 1588 - .print #STMS6 ; заливка полного блока 1589 - mov #256.,R2 1590 - TST (R1)+ ; переходим на регистр данных 1591 -146$: mov (R5)+,(R1); пишем в буфер контроллера 1592 - sob R2,146$ 1593 - sub #512.,R4; вычитаем 1594 - TST -(R1) ; переходим на регистр команд 1586 + TST -(R1) ; move to command register 1587 + mov #55,(R1); write last buffer to file 1588 +105$: TSTB (R1) ; check execution result 1589 + BPL 105$ ; wait 1595 1595 1596 - mov #55,(R1); запись буфера в файл 1597 -104$: TSTB (R1) ; проверяем результат выполнения 1598 - BPL 104$ ; ждем 1599 - br 147$ ; в начало 1591 +145$: .print #STMSE ; end 1592 + mov #110,@#AZ$CSR; enable network 1593 + .Exit ; exit 1600 1600 1601 -144$: .print #STMS7 ; заливка последнего блока 1602 - TST (R1)+ ; переходим на регистр данных 1603 - mov R4,R2 1604 - asr R2 ; /2 тк пишем словами 1605 -143$: mov (R5)+,(R1); пишем в буфер контроллера 1606 - sob R2,143$ 1607 - 1608 - TST -(R1) ; переходим на регистр команд 1609 - mov #55,(R1); запись пследнего буфера в файл 1610 -105$: TSTB (R1) ; проверяем результат выполнения 1611 - BPL 105$ ; ждем 1612 - 1613 -145$: .print #STMSE ; конец 1614 - mov #110,@#AZ$CSR; включаем сеть 1615 - .Exit ; выходим 1616 1616 {{/code}} 1617 1617 1618 -**[[ примерполностьюввидеутилитыRT11выложенвоттут>>url:https://forum.maxiol.com/index.php?s=&showtopic=5605&view=findpost&p=57055]]**1597 +**[[the example is completely in the form of the RT11 utility and is posted here>>url:https://forum.maxiol.com/index.php?s=&showtopic=5605&view=findpost&p=57055]]** 1619 1619 1620 1620 1621 -== **056:Получитьданныепоразмерукартывбуферsizecard**==1600 +== 056: Get data on the size of the map into the sizecard buffer == 1622 1622 1623 - Кодкоманды056,даннаякомандачитаетпараметрыMicroSDкартывбуферsizecard1602 +Command code 056, this command reads the parameters of the MicroSD card into the sizecard buffer 1624 1624 1625 -== **057:Чтениебуфераsizecard**==1604 +== 057: Reading sizecard buffer == 1626 1626 1627 - Кодкоманды057,даннаякомандаотдаетбуферsizecard (2слова)1606 +Command code 057, this command returns the sizecard buffer (2 words) 1628 1628 1629 - буферsizecardсодержит2слова16bit1630 - первоеслово-общийобъемкартыдоступныйдляFATвМБ1631 - второеслово-свободныйобъемнакартев МБ1608 +sizecard buffer contains 2 words 16bit 1609 +first word - total card size available for FAT in MB 1610 +second word - free card size in MB 1632 1632 1633 - Примерпрограммы:1612 +Example program: 1634 1634 1635 1635 {{code language="assembler"}} 1636 -; trap 51 - получение объема SD карты всего/свободно в мегабайтах 1637 -; результат в R1 - всего; R2 - свободно 1638 -GetSizeSD: call AZreset; сбросим 1639 - tst R1 1640 - bne 0ERR$ 1641 - MOV #AZ$CSR,R1 1642 - mov #56,(R1) 1643 -1$: TSTB (R1); подготовить буфер 1644 - BPL 1$; ждем 1645 - mov #57,(R1) 1646 -2$: TSTB (R1); подготовить буфер 1647 - BPL 2$; ждем 1648 - mov @#AZ$DR ,R1; всего мегабайт 1649 - mov @#AZ$DR ,R2; свободно мегабайт 1650 - return 1651 - clr R1 1652 - clr R2 1653 - return 1615 +; trap 51 - get the total/free size of the SD card in megabytes 1616 +; result in R1 - total; R2 - free 1617 +GetSizeSD: call AZreset ; reset 1618 + tst R1 1619 + bne 0ERR$ 1620 + MOV #AZ$CSR,R1 1621 + mov #56,(R1) 1622 +1$: TSTB (R1) ; prepare buffer 1623 + BPL 1$ ; wait 1624 + mov #57,(R1) 1625 +2$: TSTB (R1) ; prepare buffer 1626 + BPL 2$ ; wait 1627 + mov @#AZ$DR ,R1 ; total megabytes 1628 + mov @#AZ$DR ,R2 ; free megabytes 1629 + return 1630 + clr R1 1631 + clr R2 1632 + return 1633 + 1654 1654 {{/code}} 1655 1655 1656 -Пример данных 1657 -035521 - всего на карточке мегабайт - 15185. 1658 -035417 - свободно мегабайт - 15119. 1659 - 1636 +Example data 1637 +035521 - total megabytes on the card - 15185. 1638 +035417 - free megabytes - 15119. 1660 1660 1661 -= **Блок команд APIHall of Fame**=1640 += Hall of Fame API Command Block = 1662 1662 1663 - Данныйблоккомандпредназначендлявзаимодействияссервером[[Hall of Fame>>https://forum.maxiol.com/index.php?showtopic=5642]]1642 +This block of commands is intended for interaction with the server [[Hall of Fame>>https://forum.maxiol.com/index.php?showtopic=5642]] 1664 1664 1665 1665 == **025: Инициализация Hall of Fame (HOF)** == 1666 1666 1667 - Кодкоманды025,даннаякомандаустанавливаетсоединениессерверомHall of Fame,инициализируетшифрованныйтоннельиподготавливаетAPIкработе.1646 +Command code 025, this command establishes a connection to the Hall of Fame server, initializes the encrypted tunnel and prepares the API for work. 1668 1668 1669 - Примерпрограммы1648 +Example program: 1670 1670 1671 1671 {{code language="assembler"}} 1672 -AZ$CSR = 177220 ; регистркомандисостояния(CSR)1673 -AZ$DR = 177222 ; регистрданных(DR)1651 +AZ$CSR = 177220 ; command and status register (CSR) 1652 +AZ$DR = 177222 ; data register (DR) 1674 1674 1675 -; буфера1676 -SNDBUF: .BLKW 256. ; буферпередачи1677 -RCVBUF: .BLKW 256. ; буферприема ответа1654 +; buffers 1655 +SNDBUF: .BLKW 256. ; send buffer 1656 +RCVBUF: .BLKW 256. ; receive buffer 1678 1678 SIDMEM: .BLKB 34. ; SID 1679 -SIDCST: .ASCII \{"SID":"\ ; заголовокSID-а1658 +SIDCST: .ASCII \{"SID":"\ ; SID header 1680 1680 .even 1681 1681 1682 -HOFINI: ; инициализацияHOF1683 - ; результатомявляетсятакойJSON1684 - ;{"SID":" хешсессии","RESULT":"OK"}1685 - ; илиошибка1686 - ;{"RESULT":"ERROR","DESCRIPTION":"SERVER_ERROR"} 1687 - ;{"RESULT":"ERROR","DESCRIPTION":"CONNECTION_ERROR"} 1688 - ; результатпомещаетсявSNDBUF1689 - ; вR5фиксацияуспешности-=1естьSID,=0нетSID-а1690 - 1661 +HOFINI: ; HOF initialization 1662 + ; The result is a JSON response: 1663 + ; {"SID":"session hash","RESULT":"OK"} 1664 + ; or an error: 1665 + ; {"RESULT":"ERROR","DESCRIPTION":"SERVER_ERROR"} 1666 + ; {"RESULT":"ERROR","DESCRIPTION":"CONNECTION_ERROR"} 1667 + ; The result is placed in SNDBUF 1668 + ; R5 indicates success: 1 = SID exists, 0 = no SID 1669 + 1691 1691 mov R5, -(SP) 1692 1692 mov R4, -(SP) 1693 1693 mov R3, -(SP) ... ... @@ -1695,29 +1695,29 @@ 1695 1695 mov R1, -(SP) 1696 1696 mov R0, -(SP) 1697 1697 1698 - mov #3,R5 ; количествопопыток1677 + mov #3,R5 ; number of attempts 1699 1699 1700 1700 220$: mov #AZ$CSR,R1 1701 - clr (R1) ; Пошлемкоманду"Сброс"1702 -221$: tstb (R1) ; Проверимготовностьконтроллера1703 - bpl 221$ ; Еслинеготовждем1680 + clr (R1) ; Send "Reset" command 1681 +221$: tstb (R1) ; Check controller readiness 1682 + bpl 221$ ; If not ready, wait 1704 1704 1705 - mov #25,(R1) ; инициализациякоманда0251706 -20$: tstb (R1) ; проверяемрезультатвыполнения1707 - bpl 20$ ; ждем1684 + mov #25,(R1) ; initialization - command 025 1685 +20$: tstb (R1) ; check execution result 1686 + bpl 20$ ; wait 1708 1708 1709 - ; получимрезультат1710 - mov #22,(R1) ; отдатьнашинусчитанныйблокпамятиизбуфера1711 -21$: tstb (R1) ; проверяемрезультатвыполнения1712 - bpl 21$ ; ждем1713 - tst (R1)+ ; инкрементируем1688 + ; Retrieve the result 1689 + mov #22,(R1) ; output the read memory block from buffer to the bus 1690 +21$: tstb (R1) ; check execution result 1691 + bpl 21$ ; wait 1692 + tst (R1)+ ; increment 1714 1714 mov #SNDBUF,R3 1715 - mov #256.,R2 ; читаем256.слов;первоеслово-результатчтения1716 -22$: mov (R1),(R3)+ ; читаемблоксловвпамять1694 + mov #256.,R2 ; read 256 words; first word is the read result 1695 +22$: mov (R1),(R3)+ ; read block of words into memory 1717 1717 sob R2,22$ 1718 1718 1719 1719 1720 - ; надопонять- есть лиSID1699 + ; Determine if SID exists 1721 1721 mov #4,R0 1722 1722 mov #SNDBUF,R1 1723 1723 mov #SIDCST,R2 ... ... @@ -1726,11 +1726,11 @@ 1726 1726 sob R0,23$ 1727 1727 clr R5 1728 1728 inc R5 1729 - br 26$ ; успешно1708 + br 26$ ; success 1730 1730 1731 -24$: ; SID ненайден!1710 +24$: ; SID not found! 1732 1732 sob R5,220$ 1733 - clr R5 ; ошибка-нетSID-а1712 + clr R5 ; error - no SID 1734 1734 1735 1735 26$: mov (SP)+, R0 1736 1736 mov (SP)+, R1 ... ... @@ -1739,69 +1739,71 @@ 1739 1739 mov (SP)+, R4 1740 1740 mov (SP)+, R5 1741 1741 return 1721 + 1742 1742 {{/code}} 1743 1743 1744 -== **026:обменсHall of Fame (HOF)**==1724 +== 026: Exchange with Hall of Fame (HOF) == 1745 1745 1746 - Кодкоманды026,даннаякомандаосуществляетнепосредственныйобменсHall of Fame1726 +Command code 026, this command makes a direct exchange with Hall of Fame 1747 1747 1748 - Примерпрограммы1728 +Example program: 1749 1749 1750 1750 {{code language="assembler"}} 1751 - ;4. авторизацияпользователя1752 - ; техническиэтоотправкаJSON1753 - ;{"SID":" хешсессии","CMD":"AUTH_USER","NIKNAME":"никнеймпользователя","PASSWORD":"парольпользователя"}1754 - ; ответтожеJSON1755 - ;{"SID":" хешсессии","RESULT":"OK","UID":"хешпользователя"}1756 - ; или1757 - ;{"SID":" хешсессии","RESULT":"ERROR","DESCRIPTION":"USER_NOT_FOUND_OR_WRONG_PASSWORD"}1758 - ;{"SID":" хешсессии","RESULT":"ERROR","DESCRIPTION":"SERVER_ERROR"}1759 - ;{"SID":" хешсессии","RESULT":"ERROR","DESCRIPTION":"SESSION_NOT_EXISTS_OR_EXPIRED"}1731 + ;4. user authentication 1732 + ;technically, this is sending a JSON 1733 + ;{"SID":"session hash","CMD":"AUTH_USER","NIKNAME":"user nickname","PASSWORD":"user password"} 1734 + ;the response is also JSON 1735 + ;{"SID":"session hash","RESULT":"OK","UID":"user hash"} 1736 + ;or 1737 + ;{"SID":"session hash","RESULT":"ERROR","DESCRIPTION":"USER_NOT_FOUND_OR_WRONG_PASSWORD"} 1738 + ;{"SID":"session hash","RESULT":"ERROR","DESCRIPTION":"SERVER_ERROR"} 1739 + ;{"SID":"session hash","RESULT":"ERROR","DESCRIPTION":"SESSION_NOT_EXISTS_OR_EXPIRED"} 1760 1760 1761 - ; загоняемкомандуCMD041762 - mov #CMD04,R1 1763 - mov #ADRMEM,R2 1764 - add #42.,R2 ; cдвигаемуказательнадлинублокасSID1765 -33$: movb (R1)+,(R2)+ 1766 - bne 33$ 1741 + ; load command CMD04 1742 + mov #CMD04,R1 1743 + mov #ADRMEM,R2 1744 + add #42.,R2 ; shift the pointer to the SID block length 1745 +33$: movb (R1)+,(R2)+ 1746 + bne 33$ 1767 1767 1768 - .Print #ADRMEM 1748 + .Print #ADRMEM 1769 1769 1770 - .Print #HOF05 1771 - ; отсылаемкомандуиждемответа1772 - ; закачиваемвбуфер1773 - MOV #AZ$CSR,R1 1774 -331$: TSTB (R1) ; Проверимготовностьконтроллера1775 - BPL 331$ ; Еслинеготовждем1776 - mov #23,(R1) ; командуемчтобудемписатьданныевбуфер1777 -34$: TSTB (R1) ; проверяемрезультатвыполнения1778 - BPL 34$ ; ждем1779 - TST (R1)+ ; инкрементируем1780 - mov #ADRMEM,R3 1781 - mov #256.,R2 ; 1782 -35$: mov (R3)+,(R1) ; отдаемвконтроллер1783 - sob R2,35$ 1784 - tst -(R1) ; декрементируем1750 + .Print #HOF05 1751 + ; send the command and wait for a response 1752 + ; load into buffer 1753 + MOV #AZ$CSR,R1 1754 +331$: TSTB (R1) ; Check controller readiness 1755 + BPL 331$ ; If not ready, wait 1756 + mov #23,(R1) ; command to write data into buffer 1757 +34$: TSTB (R1) ; check execution result 1758 + BPL 34$ ; wait 1759 + TST (R1)+ ; increment 1760 + mov #ADRMEM,R3 1761 + mov #256.,R2 ; 1762 +35$: mov (R3)+,(R1) ; send to controller 1763 + sob R2,35$ 1764 + tst -(R1) ; decrement 1785 1785 1786 - ; обменкоманда0261787 - MOV #AZ$CSR,R1 1788 -361$: TSTB (R1) ; Проверимготовностьконтроллера1789 - BPL 361$ ; Еслинеготовждем1790 - mov #26,(R1) 1791 -36$: TSTB (R1) ; проверяемрезультатвыполнения1792 - BPL 36$ ; ждем1766 + ; exchange - command 026 1767 + MOV #AZ$CSR,R1 1768 +361$: TSTB (R1) ; Check controller readiness 1769 + BPL 361$ ; If not ready, wait 1770 + mov #26,(R1) 1771 +36$: TSTB (R1) ; check execution result 1772 + BPL 36$ ; wait 1793 1793 1794 - ; получим результат 1795 -371$: TSTB (R1) ; Проверим готовность контроллера 1796 - BPL 371$ ; Если не готов ждем 1797 - mov #22,(R1) ; отдать на шину буфер 1798 -37$: TSTB (R1) ; проверяем результат выполнения 1799 - BPL 37$ ; ждем 1800 - TST (R1)+ ; инкрементируем 1801 - mov #ADRMEM,R3 1802 - mov #256.,R2 ; читаем 256. слов; первое слово - результат чтения 1803 -38$: mov (R1),(R3)+ ; читаем блок слов в память 1804 - sob R2,38$ 1774 + ; receive result 1775 +371$: TSTB (R1) ; Check controller readiness 1776 + BPL 371$ ; If not ready, wait 1777 + mov #22,(R1) ; send buffer to the bus 1778 +37$: TSTB (R1) ; check execution result 1779 + BPL 37$ ; wait 1780 + TST (R1)+ ; increment 1781 + mov #ADRMEM,R3 1782 + mov #256.,R2 ; read 256 words; first word is the read result 1783 +38$: mov (R1),(R3)+ ; read block of words into memory 1784 + sob R2,38$ 1785 + 1805 1805 {{/code}} 1806 1806 1807 1807