Changes for page API контроллеров AZ®

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

From 1.3 to 1.4 From 2.1483 to 2.1484

From version 1.4

edited by Max
on 2025/02/25 11:01

Change comment: (Autosaved)

To version 2.1483

edited by Max
on 2025/03/02 15:13

Change comment: (Autosaved)

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -15,7 +15,6 @@
  * 177224 - Primary Boot Register (BOOT1)
  * 177226 - Alternate Boot Register (BOOT2)
--
  The CSR register accepts commands in bits D0-D5 and the interrupt enable bit in bit D6, all write only, always zero is read. In bit D7, the readiness bit is read. One in it means that the previous command has been executed and the controller is ready for exchange. Zero means that the controller is busy executing the previous operation, the other registers are disabled, access to any of them will cause Trap to 4. If the execution of the previous command caused an error, bit D15 is set simultaneously with bit D7.
  \\Writing to registers is done only in words; byte writing is not allowed.
  \\All data exchange is conducted via DR. For commands with a single-word argument, this argument should be sent to DR, and then the command should be sent to CSR. For commands exchanging with the controller buffer, on the contrary, the command should be issued and only after it a data block of a certain length should be received or transmitted.
@@ -201,7 +201,7 @@
  ;.............................
  {{/code}}
--== **004: Монтировать диск** ==
++== 004: Mount a disk ==
  Sequence of actions:
  • Reset the controller
@@ -221,20 +221,20 @@
          MOV     #AZ$CSR,R3
 $:    CLR     @R3;
--        TSTB    @R3; Сбросим контроллер
++        TSTB    @R3; Reset the controller
          BPL     20$;
--        MOV     #WrBuf,(R3)+; Перешлем в него строку
--        MOV     #MDTXT,R2; с командой назначения
++        MOV     #WrBuf,(R3)+; Send it a string
++        MOV     #MDTXT,R2; with the assignment command
          MOV     #MDLEN/2,R1;
 $:    MOV     (R2)+,@R3;
          SOB     R1,21$;
--        MOV     #AZMNT,-(R3); и отдадим ее на
--22$:    TSTB    @R3   ; исполнение
++        MOV     #AZMNT,-(R3); and pass it to
++22$:    TSTB    @R3   ; execution
          BPL     22$   ;
--        TST     @R3; после чего проверим на ошибку
++        TST     @R3; then check for an error
          BMI     Err11;
  ;.........................
@@ -243,57 +243,57 @@
  ;..................
  {{/code}}
--В этом фрагменте на диск AZ4 монтируется файл-образ 51SYS_DS.DSK, лежащий в папке SYSTEM, которая лежит в папке DISKS, лежащей в корневом оглавлении карточки микро-SD.
++In this fragment, the 51SYS_DS.DSK image file is mounted on the AZ4 disk, located in the SYSTEM folder, which is located in the DISKS folder, which is located in the root directory of the micro-SD card.
--== **005: Чтение блока в буфер** ==
++== 005: Reading block into buffer ==
--У контроллера имеется [[встроенный буфер на 256 слов (512 байт).>>doc:||anchor="H411443444435440430"]] Фактически, это часть оперативной памяти микроконтроллера STM32, выделенная в его программе под этот буфер. Весь обмен в основном блоке команд идет через этот буфер.
--\\Память дисков AZ представлена, как набор блоков объемом 512 байт каждый. Такой блок - единственная доступная единица для обмена данными с дисками AZ. Блоки пронумерованы от нуля до 65533 для 16-разрядного варианта или до 8388607 для 32-разрядного - это при использовании накопителей AZ максимально допустимой емкости. Никто не мешает использовать накопители меньшей емкости - фактический размер накопителя равен размеру файл-образа, смонтированного на этот накопитель. При попытке обратиться за пределы файл-образа будет зарегистрирована ошибка.
--\\Команда 005 - чтение блока с MicroSD в [[буфер>>doc:||anchor="Micro"]]. С псевдодиска AZn, выбранного ранее командой "Выбор устройства" запускается на чтение блок, номер которого передан командой (командами) "Установка номера блока". Команда длительного действия.
--\\Фактически, блок с карточки MicroSD читается, примерно, 500-800 мкс. На это время контроллер переходит в состояние, которое во время обсуждения проекта получило название "Думаю, прошу не мешать." А именно, на все время ее исполнения отключаются все регистры устройства, кроме CSR, в котором считывается ноль до тех пор, пока контроллер занят исполнением этой команды. По окончании считывания блока к МПИ подключаются остальные регистры контроллера, взводится бит D7 (готовность) в CSR и, если был установлен бит D6 (разрешение прерываний) в CSR, вырабатывается прерывание с вектором 0174.
--\\Пример без прерываний тривиален:
++The controller has a built-in buffer for 256 words (512 bytes). In fact, this is part of the STM32 microcontroller's RAM, allocated in its program for this buffer. All exchange in the main command block goes through this buffer.
++\\The AZ disk memory is represented as a set of blocks, each 512 bytes in size. Such a block is the only available unit for exchanging data with AZ disks. The blocks are numbered from zero to 65533 for the 16-bit version or up to 8388607 for the 32-bit version - this is when using AZ drives of the maximum permissible capacity. No one prevents you from using drives of a smaller capacity - the actual size of the drive is equal to the size of the file-image mounted on this drive. An error will be registered if you try to access beyond the file-image.
++\\Command 005 - reading a block from MicroSD to the buffer. From the pseudo-disk AZn, previously selected by the command "Select device", the block whose number is transmitted by the command (commands) "Set block number" is started for reading. Long-term command.
++\\In fact, a block from a MicroSD card is read in about 500-800 µs. During this time, the controller goes into a state that during the discussion of the project was called "I think, please do not interfere." Namely, for the entire time of its execution, all device registers are disabled, except for CSR, in which zero is read as long as the controller is busy executing this command. After the block is read, the remaining controller registers are connected to the QBUS, bit D7 (ready) is set in CSR and, if bit D6 (interrupt enable) was set in CSR, an interrupt with vector 0174 is generated.
++\\An example without interruptions is trivial:
  {{code language="assembler"}}
  ;...................................
--CmdRea=005; символическое наименование команды "Читать
--; блок"
++CmdRea=005; symbolic name of the "Read block" command
--; В R3 у нас от предыдущего фрагмента остался адрес CSR.
--; Пересылаем туда код  команды чтения
++; In R3 we have the CSR address left from the previous fragment.
++; We send the read command code there
          MOV     #CmdRea,@R3
--2$:     TSTB    @R3   ; Проверим бит готовности
--        BPL     2$; Не готово -> уходим проверять еще
--            ; раз
--        TST     @R3; Проверим на ошибку
++2$:     TSTB    @R3   Let's check the ready bit
++        BPL     2$; Not ready -> we go to check again
++; once
++        TST     @R3; Let's check for an error
          BMI     ERR4
--; Здесь у нас опять, в отличие от фрагментов пп. 3.1 и
--; 3.2, в R3 остался адрес CSR, а не DR.
++; Here again, unlike the fragments of pp. 3.1 and
++; 3.2, we have the CSR address left in R3, not DR.
  ;...................................
  {{/code}}
--== **006: Записать блок из буфера на диск** ==
++== 006: Write block from buffer to disk ==
--Код команды 006. Содержимое буфера пишется на выбранный псевдодиск по заданному дисковомк адресу (номеру блока). Перед записью выполняются проверки (1) "была ли запись в буфер?", если нет, выдается ошибка и (2) "заполнен ли буфер полностью?", если нет (для последнего укороченного блока файла), остаток буфера очищается нулями. Далее производится запись блока на носитель. Операция длительная, после ее запуска контроллер, как и при чтении переходит в состояние "Думаю, прошу не мешать". И так же, как и при чтении окончания этой операции надо дождаться, теми же средствами, как и при чтении.
--\\Пример программы без прерываний:
++Command code 006. The buffer contents are written to the selected pseudo-disk at the specified disk address (block number). Before writing, checks are performed (1) "was there a write to the buffer?", if not, an error is returned and (2) "is the buffer completely filled?", if not (for the last shortened block of the file), the rest of the buffer is cleared with zeros. Then the block is written to the media. The operation is lengthy, after it is started the controller, as with reading, goes into the "I think, please do not interfere" state. And just as with reading, you must wait for the end of this operation, by the same means as with reading.
++
++Example of a program without interrupts:
++
  {{code language="assembler"}}
  ;...............................................................
--CmdWri=006; символическое наименование команды "Писать
--   ; блок"
++CmdWri=006; symbolic name of the "Write
++; block" command
--; В R3 у нас от предыдущего фрагмента остался адрес DR.
--; Исправляем его на CSR и пересылаем туда код  команды
--; записи
++; In R3 we have the DR address left over from the previous fragment.
++; We correct it to the CSR and send the
++; write command code there
          MOV     #CmdWri,-(R3)
--5$:     TSTB    @R3   ; Проверим бит готовности
--        BPL     5$; Не готово -> уходим проверять еще
--            ; раз
--        TST     @R3; Проверим на ошибку
++5$:     TSTB    @R3   ; Let's check the ready bit
++        BPL     5$; Not ready -> we go and check again once
++        TST     @R3; Let's check for an error
          BMI     ERR5
  ;....................................................................
@@ -300,126 +300,133 @@
  {{/code}}
--== **007: Получить размер псевдодиска** ==
++== 007: Get disk size ==
--Есть две команды получения размера псевдодиска, т.е. смонтированного на выбранный псевдопривод AZn файл-образа.
--\\Если используемая ОС (или программа, работающая с дисками без ОС) умеет работать с большими (больше 32М) дисками, следует пользоваться [[командой с кодом 017>>doc:||anchor="H017:A041F43E43B44344743844244C44043043743C43544043F44143543243443E43443844143A4302C43143E43B44C44843E439"]]. Последовательность действий: сбросить контроллер (команда 000), выбрать накопитель (п. 3.2) и переслать в CSR код 017, а затем, без каких-либо ожиданий, считать из DR сначала младшее, и следом за ним старшее слово размера выбранного накопителя (файл-образа).
--\\Если используемая ОС не умеет работать с дисками бОльшими, чем 32М (RT-11), следует пользоваться командой 007 - получить размер псевдодиска с ограничением до 32М. Действия похожие: сбрасываем контроллер, выбираем диск, посылаем в CSR код 007 и считываем из DR одно слово размера псевдодиска. Если размер файл-образа, смонтированного на выбранный псевдопривод, больше 65534 блоков, вместо этого "большого" размера, контроллер возвращает число 65534. Напоминаем, что число 65535 кое-где используется в специальных целях и не может быть размером диска.
--\\Также напоминаем, что если на этот накопитель не смонтирован файл-образ, последовательность действий не пройдет (команда 001 выбор устройства) и исполнение программы до этого места просто не дойдет. Поэтому ошибок у этих команд не предусмотрено.
++There are two commands for obtaining the size of a pseudo-disk, i.e. the AZn file-image mounted on the selected pseudo-drive.
++\\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 (command 000), 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).
++\\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.
++\\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.
--Пример программы с "малыми" дисками
++Example of a program with "small" disks
  {{code language="assembler"}}
  ;......................................
--GetSiz=007; Получить "малый" размер диска
++GetSiz=007; Get the "small" disk size
--; От фрагмента 3.2 (выбор диска) у нас в R3 остался
--; адрес DR (177222)
++; From fragment 3.2 (disk selection) we have in R3
++; DR address (177222)
--        MOV     #GetSiz,-(R3); пошлем команду
--        TST     (R3)+; вернем адрес в R3 назад, на DR
++        MOV     #GetSiz,-(R3); send the command
++        TST     (R3)+;  return the address in R3 back to DR
          MOV     @R3,DskSiz
  ;......................................
  {{/code}}
--== **010: Разрешить работу сети** ==
++== 010: Allow network operation ==
--Код команды 010. Закончив последовательность действий по передаче очередной порции данных, и ожидая, что следующий запрос последует не сразу же, можно "утилизировать" процессорное время микроконтроллера STM32, составляющего основу AZ - занять его обслуживанием сети. В той же RT-11 это можно сделать перед выходом из драйвера AZ, перед макрокомандой .DRFIN, завершающей исполнение запроса ввода-вывода.
--\\Действительно, операция ввода-вывода завершена, программа ЦП в системе будет готовить новую порцию данных для вывода, или соображать (на основании предыдущих прочитанных данных), где ей еще что-то прочитать, или вообще размышлять о чем-то своём. [[image:https://forum.maxiol.com/style_emoticons/default/smile.gif||alt="smile.gif"]] Другими словами, после окончания запроса ввода-вывода, довольно высока вероятность того, что последует пауза в работе с дисками AZ. Вот, время этой паузы и можно отдать на обслуживание сети. Для этого, перед исполнением макрокоманды .DRFIN в RT-11 или ее аналога в других ОС следует отправить в CSR код 110 (разрешить сеть плюс разрешить прерывания).
--\\Прерывание в этом случае не произойдет, оно активируется только по завершении "длительных" операций, которые переводят контроллер в состояние "Думаю, прошу не мешать", а установленный в "1" триггер разрешения прерываний, кроме этого, разрешает еще и работу сети, если она активирована. При запуске следующей операции ввода-вывода действия в п. 3.1 (сброс контроллера) сбросят и этот триггер, после чего программа обслуживания сети, обнаружив сброс этого триггера, прекратит (приостановит) свою работу и вернет управление основной программе обслуживания дисков AZ. Максимум, что можно заметить со стороны ЦП - это небольшая (10-20 мкс) задержка исполнения команды сброса, но это вполне умеренная плата за сетевые возможности.
--
++Command code 010. Having completed the sequence of actions for transferring the next portion of data, and expecting that the next request will not follow immediately, you can "utilize" the processor time of the STM32 microcontroller, which is the basis of AZ - occupy it with servicing the network. In the same RT-11, this can be done before exiting the AZ driver, before the .DRFIN macro command, which completes the execution of the input-output request.
++\\Indeed, the I/O operation is completed, the CPU program in the system will prepare a new portion of data for output, or figure out (based on the previously read data) where it should read something else, or generally think about something of its own. smile.gif In other words, after the I/O request is completed, there is a fairly high probability that there will be a pause in working with the AZ disks. So, the time of this pause can be given to servicing the network. To do this, before executing the .DRFIN macro in RT-11 or its analogue in other OS, you should send code 110 (enable network plus enable interrupts) to the CSR.
--== **011: Получить таблицу назначений приводов AZn** ==
--Код команды 011. Получив эту команду, контроллер переключается с буфера для блока на свою внутреннюю таблицу назначений (32 строки по 140 байт каждая)* . Перед выдачей этой команды следует сбросить контроллер. После выдачи этой команды следует выдать команду 015 (чтение буфера), но в этом случае будет читаться не буфер, а та самая таблица, последовательно, слово за словом.
--\\* начиная с версии v17, длина имени файла уже не 130 байт, а 386 байт (последнее слово - нулевое, для окончания строки)
++In this case, the interrupt will not occur, it is activated only upon completion of "long" operations that transfer the controller to the "Thinking, please do not interfere" state, and the interrupt enable trigger set to "1" also enables network operation if it is activated. When the next input-output operation is started, the actions in paragraph 3.1 (controller reset) will also reset this trigger, after which the network service program, having detected the reset of this trigger, will stop (suspend) its work and return control to the main disk service program AZ. The maximum that can be noticed from the CPU side is a small (10-20 µs) delay in executing the reset command, but this is a very reasonable price for network capabilities.
--[[**//пример утилиты AZSMNT//**>>url:https://forum.maxiol.com/index.php?s=&showtopic=5605&view=findpost&p=59420]]
++== 011: Get AZn drive assignment table ==
++Command code 011. Upon receiving this command, the controller switches from the block buffer to its internal assignment table (32 lines of 140 bytes each)*. Before issuing this command, the controller should be reset. After issuing this command, command 015 (read buffer) should be issued, but in this case it will not be the buffer that is read, but the same table, sequentially, word by word.
++\\* starting with v17, the file name length is no longer 130 bytes, but 386 bytes (the last word is zero, to end the line)
--Пример программы:
++[[AZSMNT utility example>>url:https://forum.maxiol.com/index.php?s=&showtopic=5605&view=findpost&p=59420]]
++
++Example program:
++
  {{code language="assembler"}}
  ;...................................
--AZ$CSR = 177220; CSR контроллера
--RdBuf = 012; Команда "Читать из памяти контроллера"
--RdTbl = 011; Команда "Читать таблицу назначений"
--TblSiz = 1120.; Длина таблицы в байтах (десятичная)
++AZ$CSR = 177220; Controller CSR
++RdBuf = 012; Command "Read from controller memory"
++RdTbl = 011; Command "Read assignment table"
++TblSiz = 1120.; Table length in bytes (decimal)
--; Считаем, что в R2 находится адрес первого слова
--; области памяти для таблицы назначений. Процедуру
--; получения этого адреса не показываем.
++; We assume that R2 contains the address of the first word of the
++; memory area for the assignment table. We do not show the procedure for obtaining this address.
--        MOV     #AZ$CSR,R3; Готовим CSR контроллера
++        MOV     #AZ$CSR,R3; Preparing the controller CSR
 $:    CLR     @R3;
--        TSTB    @R3; Сбросим контроллер
++        TSTB    @R3; Reset the controller
          BPL     10$;
--        MOV     #RdTbl,@R3; Команда "Передать
--                     ; таблицу"
++        MOV     #RdTbl,@R3;Command "Transfer
++                     ; table"
--        MOV     #RdBuf,(R3+); Команда "Читать из
--; памяти контроллера. Одновременно передвинем адрес в R3
--; на DR контроллера (177222).
++        MOV     #RdBuf,(R3+); Command "Read from
++; controller memory. At the same time, move the address in R3
++; to the DR of the controller (177222).
--        MOV     #TblSiz/2,R1; Готовим счетчик слов
++        MOV     #TblSiz/2,R1; Prepare the word counter
--11$:    MOV     @R3,(R2)+; Перешлем текущее слово
--        SOB     R1,11$; и повторим 560 раз
++11$:    MOV     @R3,(R2)+; Send the current word
++SOB R1,11$; and repeat 560 times
  ;...................................
  {{/code}}
--== **012: Установка номера блока, старшие биты номера блока** ==
++== 012: Setting the block number, block number high bits ==
--Контроллер предоставляет машинке с МПИ в качестве дисков AZ0 - AZ7 файл-образы типа DSK на карточке микро-SD. Размер этих файл-образов и, соответственно, псевдодисков, может быть любым, вплоть до 4Г каждый. Адресация на этих псевдодисках прямая - полученный по МПИ номер блока, после сдвига, используется в качестве смещения от начала соответствующего файл-образа. Фактически, это нечто, вроде LBA на PC.
--\\Существуют операционные системы PDP-11, поддерживающие такие диски - RSX-11, ДИАМС, еще что-то. Однако, самая распространенная ОС - RT-11 - использует для номера блока СЛОВО (16 бит), причем код 0177777 кое-где используется в специальных целях и как размер диска не годится, поэтому для RT-11 могут быть использованы диски с максимальным числом блоков 0177776, т.е. 65534 блока (33553408 байт или 32767 К байт). Поэтому команды установки номера блока две: установить младшие биты номера блока - код 002 и установить старшие биты номера блока - код 012. Если номер блока помещается в 16 разрядов (для RT-11 - всегда), достаточно использовать команду установки младших битов номера блока, старшие биты при этом очищаются. Если номер не помещается в 16 разрядов, то сначала надо выдавать младшие биты, а потом старшие. Если попытаться сразу передать старшие биты без предварительной передачи младших, выдается ошибка. Если переданный адрес выходит за границу файл-образа, также выдается ошибка, не важно, на каком этапе - хоть при передаче младших 16 битов номера блока, хоть при передаче старших.
--\\Для выполнения этих действий следует переслать требуемую часть битов номера блока в DR и затем переслать в CSR код команды, после чего следует проверить на ошибку. Команды мгновенные, т.е. выполняются за один цикл обращения по МПИ.
--
++The controller provides the machine with MPI as disks AZ0 - AZ7 file-images of the DSK type on the micro-SD card. The size of these file-images and, accordingly, pseudo-disks, can be any, up to 4G each. Addressing on these pseudo-disks is direct - the block number obtained by QBUS, after shifting, is used as an offset from the beginning of the corresponding file-image. In fact, this is something like LBA on a PC.
--== **013: Прочитать запись оглавления HFS** ==
--Код команды 013, команда читает запись оглавления во внутреннюю область памяти и переключает на нее указатель для передачи данных через DR. Оглавление перед этим должно быть открыто. Порядок действий следующий:
--• Сбросить контроллер.
--• Выдать в CSR команду "Прочитать запись оглавления" и дождаться ее окончания.
--• Выдать в CSR команду "Прочитать из памяти контроллера"
--• Прочитать из DR 11 слов записи оглавления
--\\Запись оглавления имеет формат:
--\\См. Имя Значение
--0 fSize Размер файла в байтах, младшее слово
--2 старшее слово
--4 fDate Дата в формате MS-DOS
--6 fTime Время в формате MS-DOS
--10 fAttr Атрибуты 1 байт
--11 fName ИМЯ.ТИП файла, 8+1+3+1 = 13 байт
--\\Смещения указаны восьмеричные. Формула в строке fName означает, что там сначала должно быть имя, максимально из восьми символов, далее должна быть точка, далее тип, до трёх символов, и завершающий нулевой байт 0х00. Если тип не указан, точка тоже не нужна.
--\\Атрибуты файлов в байте fAttr (восьмеричные):
++There are PDP-11 operating systems that support such disks - RSX-11, DIAMS, and some others. However, the most common OS - RT-11 - uses a WORD (16 bits) for the block number, and the code 0177777 is used in some places for special purposes and is not suitable as a disk size, so disks with a maximum number of blocks of 0177776, i.e. 65534 blocks (33553408 bytes or 32767 K bytes), can be used for RT-11. Therefore, there are two commands for setting the block number: to set the low-order bits of the block number - code 002 and to set the high-order bits of the block number - code 012. If the block number fits into 16 bits (for RT-11 - always), it is enough to use the command to set the low-order bits of the block number, the high-order bits are cleared. If the number does not fit into 16 digits, then first the lower bits must be output, and then the higher ones. If you try to immediately transmit the higher bits without first transmitting the lower ones, an error is returned. If the transmitted address goes beyond the file-image boundary, an error is also returned, no matter at what stage - either when transmitting the lower 16 bits of the block number, or when transmitting the higher ones.
++\\To perform these actions, you should send the required part of the block number bits to DR and then send the command code to CSR, after which you should check for an error. The commands are instantaneous, i.e. they are executed in one cycle of access via MPI.
++
++== 013: Read HFS TOC entry ==
++
++Command code 013, the command reads the TOC record into the internal memory area and switches the pointer to it for data transfer via DR. The TOC must be open before this.
++
++The procedure is as follows:
++• Reset the controller.
++• Issue the command "Read the table of contents entry" to the CSR and wait for it to finish.
++• Issue the command "Read from controller memory" to the CSR
++• Read 11 words of the table of contents entry from DR
++\\The table of contents entry has the format:
++
++(% style="width:686px" %)
++|=(% style="width: 136px;" %)Offset (octal)|=(% style="width: 305px;" %)Name|=(% style="width: 242px;" %)Value
++|(% style="width:136px" %)0|(% style="width:305px" %)fSize|(% style="width:242px" %)File size in bytes, low word
++|(% style="width:136px" %)2|(% style="width:305px" %)fSize|(% style="width:242px" %)File size in bytes, high word
++|(% style="width:136px" %)4|(% style="width:305px" %)fDate|(% style="width:242px" %)Date in MS-DOS format
++|(% style="width:136px" %)6|(% style="width:305px" %)fTime|(% style="width:242px" %)Time in MS-DOS format
++|(% style="width:136px" %)10|(% style="width:305px" %)fAttr|(% style="width:242px" %)Attributes 1 byte
++|(% style="width:136px" %)10|(% style="width:305px" %)fName|(% style="width:242px" %)NAME.FILE TYPE, 8+1+3+1 = 13 bytes
++
++
++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.
++\\File attributes in fAttr byte (octal):
  \\001 - Read Only
 - Hidden
 - System
 - Directory
 - Archive
--\\Пример программы.
++\\Example program
  {{code language="assembler"}}
  ;......................................
--RdDir = 013; код команды "Читать запись оглавления"
++RdDir = 013; command code "Read table of contents entry"
  RdBuf = 015
          MOV     #AZ$CSR,R3
 $:    CLR     @R3;
--        TSTB    @R3;  Сбросим контроллер
++        TSTB    @R3;  Reset the controller
          BPL     15$;
--        MOV     #RdDir,@R3; Попросим контроллер
--16$:    TSTB    @R3; прочитать в свою память
--        BPL     16$; запись оглавления
++        MOV     #RdDir,@R3; Ask the controller
++16$:    TSTB    @R3; to read into its memory
++        BPL     16$; table of contents entry
          MOV     @RdBuf,(R3)+;
--        MOV     DIRREC,R2; И перенесем ее к себе в
--        MOV     #11.,R1; область памяти, указатель
--17$:    MOV     @R3,(R2)+; на которую лежит в ячейке
++        MOV     DIRREC,R2; And transfer it to itself in
++        MOV     #11.,R1; memory area, pointer
++17$:    MOV     @R3,(R2)+; to which lies in cell
          SOB     R1,17$; DIRREC.
  ;......................................
@@ -426,96 +426,97 @@
  {{/code}}
--== **014: Размонтировать диск** ==
++== 014: Unmount disk ==
--Код команды 014, чтобы размонтировать диск, следует сбросить контроллер, переслать в DR контроллера номер привода AZ, который следует размонтировать, и послать в CSR контроллера код 014, после чего дождаться окончания операции (она длительная) и проверить на ошибку. Ошибка выдается, если привод не был смонтирован.
--[[**//пример утилиты AZUMNT//**>>url:https://forum.maxiol.com/index.php?showtopic=5605&st=0&p=59418&#entry59418]]
++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.
++[[AZUMNT utility example>>url:https://forum.maxiol.com/index.php?showtopic=5605&st=0&p=59418&#entry59418]]
--== **015: Начать передачу считанного блока** ==
++== 015: Start transferring the read block ==
--Код команды - 015. Получив эту команду, контроллер настраивается на пословную выдачу содержимого того самого встроенного буфера на 256 слов, которые будут выданы последовательно через регистр DR. Никаких ожиданий не требуется, просто пересылаем 256 раз слово из DR в последовательные ячейки памяти, и все. Если нужно меньше, чем 256 слов (последний укороченный блок файла), то остаток можно просто бросить, не считывая, сброс контроллера в начале следующей операции сбросит и этот остаток.
--\\Пример программы:
++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.
++\\Example program:
  {{code language="assembler"}}
  ;..................................
--RdBuf=015; символическое наименование команды
++RdBuf=015; symbolic name of the command
--; В R3 от предыдущего фрагмента остался адрес CSR
++; In R3 from the previous fragment there is the address of the CSR
  ; (177220)
--; Считаем, что у нас в R2 находится адрес первого слова
--; памяти, куда следует разместить прочитанный блок.
--; Программа получения этого адреса не приводится.
++; We assume that in R2 we have the address of the first word
++; of memory, where the read block should be placed.
++; The program for obtaining this address is not given.
--        MOV     #400,R1; Готовим счетчик слов
++        MOV     #400,R1; Prepare the word counter
                   ; 0400 oct = 256 dec
--        MOV     #RdBuf,(R3)+; и пересылаем команду
--; RdBuf в CSR. Адрес в R3 укажет на DR (177222).
++        MOV     #RdBuf,(R3)+; and send the command
++; RdBuf to the CSR. The address in R3 will point to DR (177222).
--3$:     MOV     @R3,(R2)+;перешлем очередное слово в
--                  ; память
--        SOB     R1,3$; и повторим это 256 (0400)
--                  ; раз
++3$:     MOV     @R3,(R2)+we will send the next word to
++; memory
++        SOB     R1,3$; and repeat this 256 (0400)
++                  ; times
  ;..................................
  {{/code}}
--Всё, чтение закончено.
--\\Для записи наоборот, требуется сначала перенести весь блок данных из памяти ЦП в контроллер и потом выдать команду "Записать содержимое буфера на диск"
++That's it, reading is complete.
++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"
--== **016: Принять блок данных в буфер** ==
--Код команды 016. Команда настраивает контроллер на прием блока данных и помещении его в буфер. Следующие 256 циклов записи в DR поместят данные, переданные через МПИ, в буфер.
--\\Пример программы.
++== 016: Receive data block into buffer ==
++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.
++\\Example program:
++
  {{code language="assembler"}}
  ;..................................
--WrBuf=016; Символическое наименование команды
++WrBuf=016; Symbolic name of the command
--; Перед записью нужно выполнить те же действия, что и в
--; пп. 3.1.-3.3. Обычно, это одна и та же программа,
--; просто после пункта 3.3. выполняется проверка "Что
--; требуется: чтение или запись?" и разветвление на
--; программу чтения или записи.
++; Before writing, you need to perform the same actions as in
++; pp. 3.1.-3.3. Usually, this is the same program,
++; just after point 3.3. a check is performed "What
++; is required: reading or writing?" and a branch is made to the
++; reading or writing program.
--; После фрагмента в п. 3.3. в R3 остался адрес CSR
--; (177220). Будем считать, что в R2 находится адрес в
--; памяти ЦП, где находится блок, подлежащий записи.
--; Программа получения этого адреса не показана.
++; After the fragment in point 3.3., the CSR address
++; (177220) remains in R3. We will assume that R2 contains the address in the CPU
++; memory where the block to be written is located.
++; The program for obtaining this address is not shown.
--        MOV     #400,R1; Готовим счетчик
++        MOV     #400,R1;  Preparing the counter
--        MOV     #WrBuf,(R3)+; Перешлем команду в CSR и
--                     ; переключим адрес в R3 на
--                     ; DR
++        MOV     #WrBuf,(R3)+;  Let's forward the command to the CSR and
++; switch the address in R3 to
++; DR
--4$:     MOV     (R2)+,@R3; Перешлем очередное слово
--                  ; данных
--        SOB     R1,4$; и повторим это 256 раз
++4$:     MOV     (R2)+,@R3;  Let's forward the next word
++; data
++        SOB     R1,4$; and repeat this 256 times
  ;..................................
  {{/code}}
--== **017: Получить размер псевдодиска, большой** ==
++== 017: Get ramdisk size, large ==
--Есть две команды получения размера псевдодиска, т.е. смонтированного на выбранный псевдопривод AZn файл-образа.
--\\Если используемая ОС (или программа, работающая с дисками без ОС) умеет работать с большими (больше 32М) дисками, следует пользоваться командой с кодом 017. Последовательность действий: сбросить контроллер (п. 3.1), выбрать накопитель (п. 3.2) и переслать в CSR код 017, а затем, без каких-либо ожиданий, считать из DR сначала младшее, и следом за ним старшее слово размера выбранного накопителя (файл-образа).
--\\Если используемая ОС не умеет работать с дисками бОльшими, чем 32М (RT-11), следует пользоваться командой 007 - получить размер псевдодиска с ограничением до 32М. Действия похожие: сбрасываем контроллер, выбираем диск, посылаем в CSR код [[007>>doc:||anchor="H007:41F43E43B44344743844244C44043043743C43544043F44143543243443E43443844143A430"]] и считываем из DR одно слово размера псевдодиска. Если размер файл-образа, смонтированного на выбранный псевдопривод, больше 65534 блоков, вместо этого "большого" размера, контроллер возвращает число 65534. Напоминаем, что число 65535 кое-где используется в специальных целях и не может быть размером диска.
--\\Также напоминаем, что если на этот накопитель не смонтирован файл-образ, последовательность действий не пройдет (команда 001 выбор устройства) и исполнение программы до этого места просто не дойдет. Поэтому ошибок у этих команд не предусмотрено.
--\\Пример программы с большими дисками
++There are two commands to get the size of a pseudo-disk, i.e. the AZn file-image mounted on the selected pseudo-drive.
++\\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).
++\\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.
++\\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.
++\\Example of a program with large disks
  {{code language="assembler"}}
  ;......................................
--GetBig=017; Получить "большой" размер диска
++GetBig=017; Get the "big" disk size
--; От фрагмента 3.2 (выбор диска) у нас в R3 остался
--; адрес DR (177222)
++; From fragment 3.2 (disk selection) we have in R3
++; DR address (177222)
--        MOV     #GetBig,-(R3); пошлем команду
--        TST     (R3)+; вернем адрес в R3 назад, на DR
++        MOV     #GetBig,-(R3); send the command
++        TST     (R3)+; return the address in R3 back to DR
          MOV     @R3,BigSiz
          MOV     @R3,BigSiz+2
  ;......................................
@@ -522,27 +522,26 @@
  {{/code}}
--== **020: Получить расширенный код диагностики** ==
++== 020: Get extended diagnostic code ==
--Код команды 020, после сброса контроллера следует выдать эту команду в CSR и затем прочитать два слова расширенной диагностики из DR. Команда мгновенная, ожидание не требуется.
++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.
--== **027: Получить версию firmware AZ STM32** ==
++== 027: Get firmware version AZ STM32 ==
--Код команды 027, возвращает 2 слова
--\\первое слово - 06404 = старший байт 13. это версия прошивки, младший байт 4. это версия железа - те AZБК в данном случае
--второе слово - 037 = это максимальный монтируемый диск - 31.
++Command code 027, returns 2 words
++\\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.
  {{code language="assembler"}}
  ;-------------------------------------------------------------
--; получение версии прошивки STM32 - результат в R1  R1=0 ошибка
++; getting STM32 firmware version - result in R1 R1=0 error
  GTSTMV:         MOV     #AZ$CSR,R1
--1$:             CLR     (R1)            ; Пошлем команду "Сброс"
--                TSTB    (R1)            ; Проверим готовность контроллера
--                BPL     1$              ; Если не готов, сбрасываем еще
++1$:             CLR     (R1)            ; Send "Reset" command
++                TSTB    (R1)            ;Check controller readinessконтроллера
++                BPL     1$              ;  If not ready, reset again
                  mov     #27,(R1)
--                TST     (R1)+           ; Проверяем на ошибку
++                TST     (R1)+           ; Check for error
                  BMI     2$
                  mov     (R1),R1
                  return
@@ -552,45 +552,45 @@
  {{/code}}
--== **030:  Нет операции** ==
++== 030: No operation ==
--Основное назначение этой команды - устанавливать бит разрешения прерываний от контроллера. Команда передает бит разрешения прерывания, который находится с ней в одном слове, но не входит в ее состав (напоминаем, команда располагается в битах D0 - D5, а бит разрешения прерываний - D6), в соответствующий триггер контроллера и больше никак не влияет на процессы в контроллере. Управление этим триггером работает даже в состоянии "Думаю, прошу не мешать", и это главная особенность команды "нет операции".
--\\Команда имеет код 0030. Посылка в CSR кода 0130 разрешит прерывания от контроллера, посылка кода 0030 запретит их. Пример не приводится вследствие тривиальности его.
++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.
++\\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.
--= **Блок команд работы с энергонезависимой памятью** =
++= Command block for working with non-volatile memory =
--Интерфейс предоставляет любому AZ-контроллеру доступ к 255 словам энергонезависимой памяти, все команды устанавливают бит готовности по завершению. Это позволяет сохранять пользовательские настройки в энергонезависимой памяти, к примеру это используется в AZБК - там сохраняются настройки для более комфортной работы контроллера.
++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.
--Все команды этого блока используют буфер энергонезависимой памяти для своей работы.
++All commands in this block use a non-volatile memory buffer for their operation.
--== **021: Cчитать блок энергонезависимой памяти в буфер** ==
++== 021: Read non-volatile memory block into buffer ==
  (% class="wikigeneratedid" %)
--Код команды 021, данная команда вызывает чтение блока энергонезависимой памяти в буфер энергонезависимой памяти.
++Command code 021, this command causes a block of non-volatile memory to be read into the non-volatile memory buffer.
--== **022: Отдать на шину считанный блок энергонезависимой памяти из буфера** ==
++== 022: Transfer the read block of non-volatile memory from the buffer to the bus ==
  (% class="wikigeneratedid" %)
--Код команды 022, данная команда обеспечивает передачу буфера энергонезависимой памяти в регистр DR для считывания.
++Command code 022, this command ensures that the non-volatile memory buffer is transferred to the DR register for reading.
  (% class="wikigeneratedid" %)
--Пример программы
++Example program
  {{code language="assembler"}}
--AZ$CSR      = 177220; регистр команд и состояния (CSR)
--AZ$DR       = 177222; регистр данных (DR)
++AZ$CSR = 177220; command and status register (CSR)
++AZ$DR = 177222; data register (DR)
--; trap 50 - cброс AZ
++; trap 50 - reset AZ
  ; результат в R1  =0 ok
  AZreset:        MOV     #AZ$CSR,R1
--1$:             CLR     (R1); Пошлем команду "Сброс"
--                TSTB    (R1); Проверим готовность контроллера
--                BPL     1$; Если не готов, сбрасываем еще
--            ; раз и проверяем снова
--                TST     (R1); Проверим на ошибку,
++1$:             CLR     (R1); Send the "Reset" command
++                TSTB    (R1); Check the controller readiness
++                BPL     1$; If not ready, reset again
++; once and check again
++                TST     (R1); Check for an error,
                  BMI     0ERR$
                  CLR     R1
                  return
@@ -599,30 +599,30 @@
                  return
--; trap 54 - чтение энергонезависимой памяти блока 1 EEPROM в буфер с адреса ADREEPROMMEM
--; результат R3 - адрес, если R3=0 ошибка
--; статус чтения в R1 0 - ok
--; 1 - размер не соответствует сохраненному
--; 2 - oшибка версии
--; 3 - oшибка контрольной суммы
++; trap 54 - reading non-volatile memory of block 1 EEPROM to the buffer from the address ADREEPROMMEM
++; result R3 - address, if R3=0 error
++; read status in R1 0 - ok
++; 1 - size does not match saved
++; 2 - version error
++; 3 - checksum error
  ReadEEPROM:     push    R2
--                call    AZreset; сбросим
++                call    AZreset; reset
                  tst     R1
                  bne     0ERR$
  ; теперь читаем
                  MOV     #AZ$CSR,R1
--                mov     #21,(R1); считать блок 1 энергонезависимой памяти в буфер
--0$:             TSTB    (R1); проверяем результат выполнения
--                BPL     0$; ждем
--                mov     #22,(R1); отдать на шину считанный блок  энергонезависимой памяти из буфера
--1$:             TSTB    (R1); проверяем результат выполнения
--                BPL     1$; ждем
--                TST     (R1)+; инкрементируем
++                mov     #21,(R1); read block 1 of non-volatile memory into buffer
++0$:             TSTB    (R1); check execution result
++                BPL     0$; wait
++                mov     #22,(R1); send read block of non-volatile memory from buffer to bus
++1$:             TSTB    (R1); check execution result
++                BPL     1$; wait
++                TST     (R1)+; increment
                  mov     #ADREEPROMMEM,R3
--                mov     #256.,R2; читаем 256. слов; первое слово - результат чтения
--2$:             mov     (R1),(R3)+; читаем блок слов в память
++                mov     #256.,R2; read 256. words; first word is reading result
++2$:             mov     (R1),(R3)+; read block of words into memory
                  sob     R2,2$
--                mov     #ADREEPROMMEM,R3; успешно
++                mov     #ADREEPROMMEM,R3; successful
                  mov     (R3),R1
                  br      0END$
 ERR$:          CLR     R3
@@ -630,41 +630,39 @@
                  return
  {{/code}}
--очевидно, после считывания памяти необходимо проверить код результата в первом слове - см расшифровку кодов ошибок
--\\Примеры возвращаемых данных по командам
--\\последовательная подача команды 021 и затем 022 позволит считать 256. слов
--из энергонезависимой памяти
--**Внимание! **первое слово это будет статус успешности чтения
--
++obviously, after reading the memory, it is necessary to check the result code in the first word - see the decoding of error codes
++\\Examples of returned data for commands
++\\sequentially issuing the command 021 and then 022 will allow reading 256 words from non-volatile memory
++Attention! The first word will be the reading success status
  * 0 - ok
--* 1 - размер не соответствует сохраненному
--* 2 - oшибка версии
--* 3 - oшибка контрольной суммы
++* 1 - size does not match saved
++* 2 - version error
++* 3 - checksum error
--== **023: Принять с шины в буфер данные для последующей записи в буфер** ==
++== 023: Receive data from the bus into the buffer for subsequent writing into the buffer ==
--Код команды 023, данная команда позволяет наполнить буфер энергонезависимой памяти
++Command code 023, this command allows you to fill the non-volatile memory buffer
--== **024: Записать из буфера в блок энергонезависимой памяти** ==
++== 024: Write from buffer to non-volatile memory block ==
--Код команды 024, данная команда вызывает запись блока энергонезависимой памяти из буфера энергонезависимой памяти.
++Command code 024, this command causes a non-volatile memory block to be written from the non-volatile memory buffer.
--Пример программы
++Example program
  {{code language="assembler"}}
--AZ$CSR      = 177220; регистр команд и состояния (CSR)
--AZ$DR       = 177222; регистр данных (DR)
++AZ$CSR = 177220; Command and Status Register (CSR)
++AZ$DR = 177222; Data Register (DR)
--; trap 50 - cброс AZ
++; trap 50 - reset AZ
  ; результат в R1  =0 ok
  AZreset:        MOV     #AZ$CSR,R1
--1$:             CLR     (R1); Пошлем команду "Сброс"
--                TSTB    (R1); Проверим готовность контроллера
--                BPL     1$; Если не готов, сбрасываем еще
--            ; раз и проверяем снова
--                TST     (R1); Проверим на ошибку,
++1$:             CLR     (R1); Send the "Reset" command
++                TSTB    (R1); Check the controller readiness
++                BPL     1$; If not ready, reset again
++; once and check again
++                TST     (R1); Check for an error,
                  BMI     0ERR$
                  CLR     R1
                  return
@@ -672,27 +672,27 @@
                  COM     R1
                  return
--; trap 55 - запись энергонезависимой памяти из буфера с адреса ADREEPROMMEM в блок 1 EEPROM
++; trap 55 - write non-volatile memory from the buffer at address ADREEPROMMEM в блок 1 EEPROM
  WriteEEPROM:    push    R1
                  push    R2
                  push    R3
--                call    AZreset; сбросим
++                call    AZreset; reset
                  tst     R1
                  bne     0ERR$
                  MOV     #AZ$CSR,R1
--                mov     #23,(R1); командуем что будем писать данные в буфер
--0$:             TSTB    (R1); проверяем результат выполнения
--                BPL     0$; ждем
--                TST     (R1)+; инкрементируем
++                mov     #23,(R1);command that we will write data to the buffer
++0$:             TSTB    (R1); check the result of executio
++                BPL     0$; wait
++                TST     (R1)+; increment
                  mov     #ADREEPROMMEM+2,R3
--                mov     #255.,R2; пишем 255. слов; первое слово пропускаем - результат чтения
--1$:             mov     (R3)+,(R1); отдаем в контроллер
++                mov     #255.,R2; write 255. words; skip the first word - the result of reading
++1$:             mov     (R3)+,(R1); send to the controller
                  sob     R2,1$
--                tst     -(R1); декрементируем
--                mov     #24,(R1); записать из буфера в блок 1 энергонезависимой памяти
--2$:             TSTB    (R1); проверяем результат выполнения
--                BPL     2$; ждем
++                tst     -(R1); decrement
++                mov     #24,(R1); write from the buffer to block 1 of non-volatile memory
++2$:             TSTB    (R1); check the result of execution
++                BPL     2$; we are waiting
                  br      0END$
 ERR$:          CLR     R3
 END$:          pop     R3
@@ -701,23 +701,21 @@
                  return
  {{/code}}
--**Обращаю внимание**, при записи, буфер идет сразу с данными, те нет первого слова со статусом.
++**Please note** that when recording, the buffer immediately comes with the data, i.e. there is no first word with the statu
--= Блок команд для работы с RTC и NTP =
++= Block of commands for working with RTC and NTP =
--В контроллере AZ®  есть 2 источника получения даты-времени, первый это RTC встроенный в STM32, второй это часы в стеке TCP/IP.  Часы RTC работают автономно при наличии установленной батарейки 2032. Часы в стеке TCP/IP устанавливаются на основании данных с NTP-сервера.
++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.
--== Формат буфера timestamp (доступен по чтению) ==
++== Buffer format timestamp (readable) ==
--API контроллера сразу готовит время в нескольких форматах, дабы его было удобно применить на стороне PDP-11
++The controller API immediately prepares time in several formats, so that it can be conveniently used on the PDP-11 side
  {{info}}
--формат буфера даты-времени
--offset в восьмеричной системе - те слова
--формат буфера даты-времени
++datetime buffer format octal offset - those words datetime buffer format
  \\[0]=rtc_rt11date();
  [2]=rt11 time 50Hz big word;
  [4]=rt11 time 50Hz little word;
@@ -735,72 +735,72 @@
  {{/info}}
--== Формат буфера SimpleIN (при записи) ==
++== SimpleIN buffer format (when writing) ==
--формат максимально упрощен, для работы со стороны PDP-11
++the format is simplified as much as possible, for work with PDP-11
  {{info}}
--offset в восьмеричной системе - те слова
++offset in octal - those words
--[0]=year       год, младшие две цифры - те 22 а не 2022(!)
--[2]=month;     месяц
--[4]=day;       день
--[6]=wday;      день недели =0 не установлен, 1- понедельник 2 - вторник итд
--[10]=hour;     час
--[12]=min;      минута
--[14]=sec;      секунда
++[0]=year, the lower two digits are 22 and not 2022(!)
++[2]=month; month
++[4]=day; day
++[6]=wday; day of the week =0 not set, 1 - Monday 2 - Tuesday etc.
++[10]=hour; hour
++[12]=min; minute
++[14]=sec; second
  {{/info}}
--== **031:  Получить время из RTC в буфер timestamp** ==
++== 031: Get time from RTC to timestamp buffer ==
--Код команды 031, данная команда использует RTC часы как источник заполнения буфера timestamp
++Command code 031, this command uses RTC clock as a source of filling the timestamp buffer
--Пример программы:
++Example program:
  {{code language="assembler"}}
--; trap 61 - чтение данных часов из автономных часов RTC
--; R3 - адрес буфера куда надо считать
--; результат в R3 адрес, если успешно. R3=0  если ошибка
++; trap 61 - reading clock data from autonomous RTC clock
++; R3 - buffer address where to read
++; result in R3 address if successful. R3=0 if error
  GetDateFromRTC: push    R0
                  push    R1
                  push    R2
--                call    AZreset; сбросим
++                call    AZreset;  reset
                  tst     R1
                  bne     G60ERR
                  MOV     #AZ$CSR,R1
                  mov     #31,(R1)
--                br      G60; идем туда тк дальше код одинаковый
++                br      G60; let's go there because further code is the same
  {{/code}}
--== **032:  Получить время из буфера timestamp** ==
++== 032: Get time from timestamp buffer ==
--Код команды 032, данная команда отдает на шину содержимое буфера timestamp
++Command code 032, this command sends the contents of the timestamp buffer to the bus
  {{code language="assembler"}}
--; работа с часами
--; trap 60 - чтение данных часов из TCP/IP стека
--; R3 - адрес буфера куда надо считать
--; результат в R3 адрес, если успешно. R3=0  если ошибка
++; working with clock
++; trap 60 - reading clock data from TCP/IP stack
++; R3 - buffer address where to read
++; result in R3 address if successful. R3=0 if error
  GetDateFromLAN: push    R0
                  push    R1
                  push    R2
--                call    AZreset; сбросим
++                call    AZreset; reset
                  tst     R1
                  bne     G60ERR
                  MOV     #AZ$CSR,R1
                  mov     #42,(R1)
--G60:            TSTB    (R1); проверяем результат выполнения
--                BPL     G60; ждем
++G60:            TSTB    (R1); check execution result
++                BPL     G60; wait
                  mov     #32,(R1)
--1$:             TSTB    (R1); проверяем результат выполнения
++1$:             TSTB    (R1); check execution result
                  BPL     1$; ждем
--                TST     (R1)+; инкрементируем
--                mov     R3,R0; запомним R3 - адрес
--                mov     #10.,R2; читаем 10 слов
--2$:             mov     (R1),(R3)+; читаем блок слов в память
++                TST     (R1)+;  increment
++                mov     R3,R0; remember R3 address
++                mov     #10.,R2;  read 10 words
++2$:             mov     (R1),(R3)+; read block of words into memory
                  sob     R2,2$
--                mov     R0,R3; успешно, вернем адрес в R3
++                mov     R0,R3; successful, return address to R3
                  br      0END$
  G60ERR:         CLR     R3
 END$:          pop     R2
@@ -809,11 +809,11 @@
                  return
  {{/code}}
--Стоит проверить корректность полученного времени:
++It is worth checking the correctness of the received time:
  {{code language="assembler"}}
--; trap 63 - проверка корректности времени
--; R3 - адрес буфера, результат в R3, если адрес буфера то OK, =0 ошибка
++; trap 63 - check time correctness
++; R3 - buffer address, result in R3, if buffer address then OK, =0 error
  CheckDateTime:  Cmp     6(r3),#2021.
                  Blos    1err
                  Cmp     6(r3),#2100.
@@ -823,119 +823,119 @@
                  return
  {{/code}}
--== **033:  Запись времени-даты в буфер SimpleIN** ==
++== 033: Write time-date to SimpleIN buffer ==
--Код команды 033, данная команда  принимает с шины данные в буфер SimpleIN
++Command code 033, this command receives data from the bus into the SimpleIN buffer
--Работа данной команды аналогична работе команд [[023>>doc:||anchor="H023:41F44043843D44F44244C44144843843D44B43243144344443544043443043D43D44B43543443B44F43F43E44143B43543444344E44943543943743043F438441438432431443444435440"]] и [[016>>doc:||anchor="H016:A041F44043843D44F44244C43143B43E43A43443043D43D44B445432431443444435440"]].
++The operation of this command is similar to the operation of commands 023 and 016.
--== **034:  Установка RTC на основании данных из буфера** ==
++== 034: Set RTC based on buffer data ==
--Код команды 034, данная команда  устанавливает RTC на основании данных в буфере SimpleIN
++Command code 034, this command sets the RTC based on the data in the SimpleIN buffer
--Данная команда выполняется быстро, но для исключения проблем цикл ожидания выполнения рекомендуется.
++This command executes quickly, but to avoid problems, a wait loop is recommended.
--== **035:  Стимуляция запроса времени с NTP сервера, установка на основании ответа** ==
++== 035: Stimulate time request from NTP server, set based on response ==
--Код команды 035, данная команда отправляет запрос на NTP cервер (установленный в AZ.INI файле или полученный от DHCP) и устанавливает часы в стеке TCP/IP.
++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.
--Пример программы: отсылка запроса на установку времени с NTP сервера
++Example program: sending a request to set the time from an NTP server
  {{code language="assembler"}}
--; trap 62 - отсылка запроса на установку времени с NTP сервера
++; trap 62 - sending a request to set the time from the NTP server
  GetDateNTPtoNET:push    R1
--                call    AZreset; сбросим
++                call    AZreset; reset
                  tst     R1
                  bne     0ERR$
                  MOV     #AZ$CSR,R1
                  mov     #35,(R1)
--0$:             TSTB    (R1); проверяем результат выполнения
--                BPL     0$; ждем
++0$:             TSTB    (R1); check the result of execution
++                BPL     0$; wait
 ERR$:          pop     R1
                  return
  {{/code}}
--Выполнение команды занимает 1-2 секунды в среднем. Данная команда требует работы стека TCP/IP, соответственно нужны циклы ожидания при включенном стеке.
++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.
--Пример цикла опроса с целью получить время с сети
++An example of a polling cycle to get time from the network
  {{code language="assembler"}}
--; дата-время
++; date-time
                  mov     #S_DateTime_0,R3; "Lan Date:"
                  trap    10
--                mov     #20,R4; количество циклов ожидания
--$datry:         trap    62; отослали запрос к NTP серверу
--                mov     #110,@#AZ$CSR; включим сеть
--                trap    47; ожидание
--                trap    47; ожидание
++                mov     #20,R4; number of wait cycles
++$datry:         trap    62; sent a request to the NTP server
++                mov     #110,@#AZ$CSR; enable the network
++                trap    47; waiting
++                trap    47; waiting
                  mov     #ADRTMPSTR,R3
--                trap    60; считали в буфер дату-время
--                trap    63; проверили дату-время
++                trap    60; read the date-time into the buffer
++                trap    63; checked the date-time
                  tst     R3
                  bne     $ok
  $sob:           sob     R4,$datry
--                mov     #S_DateTime_2,R3; печать ошибки
++                mov     #S_DateTime_2,R3; print error
                  trap    7
                  br      $go
  $ok:            mov     #ADRTMPSTR,R3
--                trap    24; печать даты
--                trap    25; времени
--$go:            mov     #110,@#AZ$CSR; включим сеть
++                trap    24; print date
++                trap    25; time
++$go:            mov     #110,@#AZ$CSR;  let's turn on the network
  {{/code}}
--Тут мы явно отсылаем запрос к NTP серверу, затем включаем работу сети и ждем результата, периодически опрашивая и проверяя корректность результата.
++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.
--== **036:  Установка RTC на основании часов TCP/IP стека** ==
++== 036: Setting RTC based on TCP/IP stack clock ==
--Код команды 036,  данная команда устанавливает RTC на основании часов в TCP/IP стека. Предварительно надо установить часы в TCP/IP - команда 036.
++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.
--Пример программы:
++Example program:
  {{code language="assembler"}}
--; trap 64 - установка времени RTC на основании времени стека
--; R1 - результат  R1=0 - OK
--SetDateNETtoRTC:call    AZreset; сбросим
++; trap 64 - set RTC time based on stack time
++; R1 - result R1=0 - OK
++SetDateNETtoRTC:call    AZreset; reset
                  tst     R1
                  bne     0ERR$
                  MOV     #AZ$CSR,R1
                  mov     #36,(R1)
--0$:             TSTB    (R1); проверяем результат выполнения
--                BPL     0$; ждем
++0$:             TSTB    (R1); check execution result
++                BPL     0$; wait
                  clr     R1
 ERR$:          return
  {{/code}}
--== **042:  Получить время из часов TCP/IP стека в буфер timestamp** ==
++== 042: Get time from TCP/IP stack clock into timestamp buffer ==
--Код команды 042,   данная команда использует часы TCP/IP стека как источник заполнения буфера timestamp.
++Command code 042, this command uses the TCP/IP stack clock as a source for filling the timestamp buffer.
--Пример программы:
++Example program:
  {{code language="assembler"}}
--; работа с часами
--; trap 60 - чтение данных часов из TCP/IP стека
--; R3 - адрес буфера куда надо считать
--; результат в R3 адрес, если успешно. R3=0  если ошибка
++; working with clock
++; trap 60 - reading clock data from TCP/IP stack
++; R3 - buffer address where to read
++; result in R3 address if successful. R3=0 if error
  GetDateFromLAN: push    R0
                  push    R1
                  push    R2
--                call    AZreset; сбросим
++                call    AZreset; reset
                  tst     R1
                  bne     G60ERR
                  MOV     #AZ$CSR,R1
                  mov     #42,(R1)
--G60:            TSTB    (R1); проверяем результат выполнения
--                BPL     G60; ждем
++G60:            TSTB    (R1); check execution result
++                BPL     G60; wait
                  mov     #32,(R1)
--1$:             TSTB    (R1); проверяем результат выполнения
--                BPL     1$; ждем
--                TST     (R1)+; инкрементируем
--                mov     R3,R0; запомним R3 - адрес
++1$:             TSTB    (R1); check execution result
++                BPL     1$; wait
++                TST     (R1)+;  increment
++                mov     R3,R0; remember R3 address
                  mov     #10.,R2; читаем 10 слов
--2$:             mov     (R1),(R3)+; читаем блок слов в память
++2$:             mov     (R1),(R3)+; read block of words into memory
                  sob     R2,2$
--                mov     R0,R3; успешно, вернем адрес в R3
++                mov     R0,R3; successful, return address to R3
                  br      0END$
  G60ERR:         CLR     R3
 END$:          pop     R2
@@ -944,52 +944,50 @@
                  return
  {{/code}}
--все команды устанавливают бит готовности по завершению.
++All commands set the ready bit upon completion.
--= **Команды специфические для [[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]]** =
++= **[[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] **specific commands =
--Данные команды предназначены для работы контроллера AZБК®, разработанного для серии компьютеров БК - БК-0010/БК-0010.01/БК-0011М.
++These commands are intended for operation of the AZБК® controller, developed for the BK series of computers - BK-0010/BK-0010.01/BK-0011M.
--Другие контроллеры AZ® игнорируют эти команды
++Other AZ® controllers ignore these commands.
--== **037: перезапуск контроллера [[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] и всей БК** ==
++== 037: Restart of the** [[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] **controller and the entire computer ==
--Код команды 037,  данная команда осуществляет перезапуск микроконтроллера AZ®, что вызывает и перезапуск самой БК-0010/БК-0010.01/БК-0011М
++Command code 037, this command restarts the AZ® microcontroller, which also causes a restart of the BK-0010/BK-0010.01/BK-0011M itself
--Пример программы
++Example program
  {{code language="assembler"}}
--AZ$CSR      = 177220; регистр команд и состояния (CSR)
--AZ$DR       = 177222; регистр данных (DR)
++AZ$CSR = 177220; command and status register (CSR)
++AZ$DR = 177222; data register (DR)
--; trap 57 - перезапуск БК полный
--AZcouldReboot:  call    AZreset; сбросим AZ дабы он был готов принимать команды
++; trap 57 - full restart
++AZcouldReboot:  call    AZreset; reset AZ so it is ready to receive
                  mov     #037,@#AZ$CSR
                  return
  {{/code}}
--== **044: Cохранение скриншота в файл** ==
++== 044: Saving a screenshot to a file ==
--Код команды 044,  данная команда предназначена для снятия образа памяти указанного размера (или определенного автоматически на основании сохраненных параметров)
--технически команда может служить как средство отладки ибо способная снимать образ памяти
--общее ограничение на снятие образа памяти - 2МБ на один образ
--\\в качестве параметров используется служебная страница памяти 76(8)
++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
++\\service memory page 76(8) is used as parameters
--Структура заполнения информации о скриншоте
++Structure of filling information about a screenshot
  {{code language="c"}}
--// структура хидера скриншота
++// screenshot header structure
  typedef __packed struct screen_header
  {
--    unsigned short int                tag;                    // должен быть равен 0240
++    unsigned short int                tag;                //  must be equal to 0240
--  unsigned int                             begin_adress;    // начальный адрес в словах - прямая задача в физических адресах
--    unsigned int                             length;                // длина в словах - прямая задача в физических адресах
++    unsigned int                      begin_adress;       // start address in words - forward task in physical addresses
++    unsigned int                      length;             // length in words - forward task in physical addresses
--    unsigned short int                begin_page;        // начальная страница - номер - прямая задача в номерах страниц
--    unsigned short int                len_pages;        // количество страниц - прямая задача в номерах страниц
++    unsigned short int                begin_page;         // start page - number - forward task in page numbers
++    unsigned short int                len_pages;          // number of pages - forward task in page numbers
      unsigned short int                R177300;            //
      unsigned short int                R177302;            //
@@ -1007,57 +1007,55 @@
      unsigned short int                R177332;            //
      unsigned short int                R177334;            //
      unsigned short int                R177336;            //
--    unsigned short int                R177340;            // - Регистр управления активацией окно - маски окон
--    unsigned short int                R177342;            // - Регистр управления r/o на окно
--    unsigned short int                R177344;            // - Регистр управления shadow окон - маски окон
--    unsigned short int                R177346;            // - Регистр управления маппером
--    unsigned short int                R177350;            // - регистр копия по записи 177130 в режиме записи управления памятью в SMK
--  unsigned short int                R177352;            // - регистр копия по записи 177716 в режиме записи управления памятью в БК11М
++    unsigned short int                R177340;            // - Window activation control register - window masks
++    unsigned short int                R177342;            // - Control register r/o per window
++    unsigned short int                R177344;            // - Shadow window control register - window masks
++    unsigned short int                R177346;            // - Mapper control register
++    unsigned short int                R177350;            // - copy by record register 177130 in memory management write mode in SMK
++    unsigned short int                R177352;            // - copy by record register 177716 in memory management write mode in BK11M
--    unsigned short int                R177230;            // - регистр управления
--    unsigned short int                R177232;            // - регистр номера страницы начала отображения - верхняя страница (слой 0)
--    unsigned short int                R177240;            // - регистр номера страницы начала отображения - средняя страница (слой 1)
--    unsigned short int                R177242;            // - регистр номера страницы начала отображения - нижняя страница  (слой 2)
--    unsigned short int                R177244;            // - регистр вертикального скролинга слой 2
--    unsigned short int                R177246;            // - регистр вертикального скролинга слой 1
--    unsigned short int                R177250;            // - регистр вертикального скролинга слой 0
--    unsigned short int                R177252;            // - регистр гозизонтального скролинга слой 0
--    unsigned short int                R177254;            // - регистр гозизонтального скролинга слой 1
--    unsigned short int                R177256;            // - регистр гозизонтального скролинга слой 2
++    unsigned short int                R177230;            // - control register
++    unsigned short int                R177232;            // - display start page number register - upper page (layer 0)
++    unsigned short int                R177240;            // - display start page number register - upper page (layer 1)
++    unsigned short int                R177242;            // - display start page number register - upper page (layer 2)
++    unsigned short int                R177244;            // - vertical scroll register layer 2
++    unsigned short int                R177246;            // - vertical scroll register layer 1
++    unsigned short int                R177250;            // - vertical scroll register layer 0
++    unsigned short int                R177252;            // - horizontal scroll register layer 0
++    unsigned short int                R177254;            // - horizontal scroll register layer 1
++    unsigned short int                R177256;            // - horizontal scroll register layer 2
      unsigned short int                paldata[338];    //
  } screen_header_t;
  {{/code}}
--Пример кода для заполнения страницы памяти
++Example code for filling a memory page
  {{code language="assembler"}}
  ;--------------------------------------------------
--; карта 76й страницы - туда мы готовим данные для команды скринщотов
--        SCR_PAGE        = 130000             ; 76ую страницу цепляем на место 77й временно - те в окно 130000
--        SCR_TAG         = SCR_PAGE+0         ; тут вход - 240 - 1 слово
--        SCR_ADDR_CONF   = SCR_TAG+2          ; сюда команду с адресами - адрес+длина 24 бита - 4 слова
--        SCR_PAGE_CONF   = SCR_ADDR_CONF+8.   ; сюда команду со страницами - начальная страница и количество страниц - 2 слова
--        SCR_MEM_CONF    = SCR_PAGE_CONF+4.   ; cюда конфигурацию памяти из регистров - 22 слова
--        SCR_VGA_CONF    = SCR_MEM_CONF+44.   ; сюда конфигурацию видеоконтроллера - 10 cлов
--        SCR_PAL         = SCR_VGA_CONF+20.   ; сюда 338. значений(слов) палитры 338 слов
++; 76th page map - we prepare data for the screenshot command there
++SCR_PAGE      = 130000            ; we temporarily attach the 76th page to the 77th - that is, into the 130000 window
++SCR_TAG       = SCR_PAGE+0        ; here is the input - 240 - 1 word
++SCR_ADDR_CONF = SCR_TAG+2         ; here is the command with addresses - address+length 24 bits - 4 words
++SCR_PAGE_CONF = SCR_ADDR_CONF+8.  ; here is the command with pages - the starting page and the number of pages - 2 words
++SCR_MEM_CONF  = SCR_PAGE_CONF+4.  ; here is the memory configuration from the registers - 22 words
++SCR_VGA_CONF  = SCR_MEM_CONF+44.  ; here video controller configuration - 10 words
++SCR_PAL       = SCR_VGA_CONF+20.  ; here 338. values (words) of palette 338 words
  ;--------------------------------------------------
++; trap 41 - preparation of default information for screenshot functionality
++PrepSRC:        jsr     R5, PUSHA            ; batch saving of registers
++                mov     @#177326,-(SP)       ; save page 130k which was before the call
++                mov     #76,@#177326         ; hook 76th page into window
--
--; trap 41 - подготовка дефолтной информации для работы функционала скриншотов
--PrepSRC:        jsr     R5, PUSHA             ; пакетное сохранение регистров
--                mov     @#177326,-(SP)       ; сохраним страницу 130k которая была до вызова
--                mov     #76,@#177326         ; цепляем 76ую страницу в окно
--
--                mov     #100377,R3           ; константа-заполнитель
++                mov     #100377,R3           ; constant-filler
                  mov     #SCR_PAGE,R4
                  mov     #2047.,R2
 $:             mov     R3,(R4)+
                  sob     R2,4$
--                mov     #240,@#SCR_TAG       ; проставляем тег
++                mov     #240,@#SCR_TAG       ; put the tag
--         ; чистим участок адресов - дефолтно автоматическое определение адресов
++         ; clean the address section - default is automatic address detection
                  clr     R3
                  mov     #SCR_ADDR_CONF,R4
                  mov     #10,R2
@@ -1064,7 +1064,7 @@
 $:             mov     R3,(R4)+
                  sob     R2,2$
--         ;конфигурация памяти - дефолтная
++         ; memory configuration - default
                  mov     #SCR_MEM_CONF,R4
                  mov     #30,(R4)+            ;177300
                  mov     #31,(R4)+            ;177302
@@ -1083,29 +1083,29 @@
                  mov     #110,(R4)+           ;177334
                  mov     #100,(R4)+           ;177336
--                mov     #170000,(R4)+        ;177340 - Регистр управления активацией окно - маски окон
--                mov     R3,(R4)+             ;177342 - Регистр управления r/o на окно
--                mov     #7777,(R4)+          ;177344 - Регистр управления shadow окон - маски окон
--                mov     #40404,(R4)+         ;177346 - Регистр управления маппером
--                mov     R3,(R4)+             ;177350 - регистр копия по записи 177130 в режиме записи управления памятью в SMK
--                mov     #16000,(R4)+         ;177352 - регистр копия по записи 177716 в режиме записи управления памятью в БК11М
++                mov     #170000,(R4)+        ;177340
++                mov     R3,(R4)+             ;177342
++                mov     #7777,(R4)+          ;177344
++                mov     #40404,(R4)+         ;177346
++                mov     R3,(R4)+             ;177350
++                mov     #16000,(R4)+         ;177352
--         ;конфигурация видеоконтроллера - дефолтная
++         ;Video controller configuration - default
           ;  177230-177256
                  mov     #SCR_VGA_CONF,R4
--                mov     #12201,(R4)+         ;177230 - регистр управления
--                mov     #4,(R4)+             ;177232 - регистр номера страницы начала отображения - верхняя страница (слой 0)
--                mov     R3,(R4)+             ;177240 - регистр номера страницы начала отображения - средняя страница (слой 1) "под спрайты"
--                mov     R3,(R4)+             ;177242 - регистр номера страницы начала отображения - нижняя страница (слой 2) "под фон"
--                mov     R3,(R4)+             ;177244 - регистр вертикального скролинга слой 2
--                mov     R3,(R4)+             ;177246 - регистр вертикального скролинга слой 1
--                mov     R3,(R4)+             ;177250 - регистр вертикального скролинга слой 0
--                mov     R3,(R4)+             ;177252 - регистр гозизонтального скролинга слой 0
--                mov     R3,(R4)+             ;177254 - регистр гозизонтального скролинга слой 1
--                mov     R3,(R4)+             ;177256 - регистр гозизонтального скролинга слой 2
++                mov     #12201,(R4)+         ;177230
++                mov     #4,(R4)+             ;177232
++                mov     R3,(R4)+             ;177240
++                mov     R3,(R4)+             ;177242
++                mov     R3,(R4)+             ;177244
++                mov     R3,(R4)+             ;177246
++                mov     R3,(R4)+             ;177250
++                mov     R3,(R4)+             ;177252
++                mov     R3,(R4)+             ;177254
++                mov     R3,(R4)+             ;177256
--         ; закачиваем палитру - берем дефолтную из этой ПЗУшки
++         ; download the palette - take the default one from this ROM
                  mov     #SCR_PAL,R4
                  mov        #PalData,R2
                  mov        #338.,R3
@@ -1112,233 +1112,233 @@
 $:             mov     (R2)+,(R4)+
                  sob        R3,1$
--                mov     (SP)+,@#177326; вернем страницу с которой был вызов
++                mov     (SP)+,@#177326; return the page from which the call was made
                  return
  {{/code}}
--Вариантов указания участков памяти три
++There are three options for specifying memory areas.
--1. указать адрес и длину 24х битные - cм формат, если их нет - система смотрит дальше
--1. указать номер страницы и количество страницы, если их нет
--1. система смотрит дальше - те делает скриншот на основании данных о регистрах 177230 и т.д..
++1. specify the address and length 24-bit - see format, if they are not there - the system looks further
++1. specify the page number and page quantity, if they are not there
++1. the system looks further - that is, it makes a screenshot based on the data about registers 177230, etc.
--Cкриншот сохраняется в формате
--- страница 76 - ее первый килобайт
--- сам образ памяти (если режим слоеный - то все три слоя)
++The screenshot is saved in the format
++- page 76 - its first kilobyte
++- the memory image itself (if the mode is layered - then all three layers)
--Перед вызовом команды можно загрузить имя файла для сохранения скриншота [в cmosmem буфер], однако при его отсутствии (в буфере не будет имени - строки заканчивающейся 0) система сформирует свое имя, на основании следующего правила:
--дефолтный путь для сохранения скриншотов
++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
 :/SCREENS/
--формат имени - DDHHMISS.SCR
--где DD - две цифры дня месяца, HH - час, MI - минута, SS-секунда
--\\Если в процессе выполнения команды возникнет ошибка - вместо имени будет "ERROR *"
--к примеру
++name format - DDHHMISS.SCR
++where DD is two digits of the day of the month, HH is the hour, MI is the minute, SS is the second
++\\If an error occurs during the command execution, the name will be "ERROR *"
++for example
  "ERROR f_open 6"
--Пример программы
++Example program
  {{code language="assembler"}}
--; обновим информацию в хидере скриншота
++; update the information in the screenshot header
  ;--------------------------------------------------
--; карта 76й страницы - туда мы готовим данные для команды скринщотов
--        SPAGE        = 170000             ; 76ую страницу цепляем на место 77й временно - те в окно 130000
--        STAG         = SPAGE+0         ; тут вход - 240 - 1 слово
--        SADDRC   = STAG+2          ; сюда команду с адресами - адрес+длина 24 бита - 4 слова
--        SPAGEC   = SADDRC+8.   ; сюда команду со страницами - начальная страница и количество страниц - 2 слова
--        SMEMC    = SPAGEC+4.   ; cюда конфигурацию памяти из регистров - 22 слова
--        SVGAC    = SMEMC+44.   ; сюда конфигурацию видеоконтроллера - 10 cлов
--        SPAL         = SVGAC+20.   ; сюда 338. значений(слов) палитры 338 слов
++; 76th page map - we prepare data for the screenshot command there
++SCR_PAGE      = 130000            ; we temporarily attach the 76th page to the 77th - that is, into the 130000 window
++SCR_TAG       = SCR_PAGE+0        ; here is the input - 240 - 1 word
++SCR_ADDR_CONF = SCR_TAG+2         ; here is the command with addresses - address+length 24 bits - 4 words
++SCR_PAGE_CONF = SCR_ADDR_CONF+8.  ; here is the command with pages - the starting page and the number of pages - 2 words
++SCR_MEM_CONF  = SCR_PAGE_CONF+4.  ; here is the memory configuration from the registers - 22 words
++SCR_VGA_CONF  = SCR_MEM_CONF+44.  ; here video controller configuration - 10 words
++SCR_PAL       = SCR_VGA_CONF+20.  ; here 338. values (words) of palette 338 words
  ;--------------------------------------------------
++                mov     @#177326,R5       ; save page 130k which was before the call
++                mov     #76,@#177336         ; hook the 76th page into the window
--                mov     @#177326,R5       ; сохраним страницу 130k которая была до вызова
--                mov     #76,@#177336         ; цепляем 76ую страницу в окно
--
--         ;конфигурация видеоконтроллера
++         ;video controller configuration
           ;  177230-177256
                  mov     #SVGAC,R4
--                mov     @#177230,(R4)+;177230 - регистр управления
--                mov     @#177232,(R4)+;177232 - регистр  - верхняя страница (слой 0)
--                mov     @#177240,(R4)+;177240 - регистр  - средняя страница (слой 1)
--                mov     @#177242,(R4)+;177242 - регистр - нижняя страница (слой 2)
--                mov     @#177244,(R4)+;177244 - регистр вертикального скролинга слой 2
--                mov     @#177246,(R4)+;177246 - регистр вертикального скролинга слой 1
--                mov     @#177250,(R4)+;177250 - регистр вертикального скролинга слой 0
--                mov     @#177252,(R4)+;177252 - регистр гозизонтального скролинга слой 0
--                mov     @#177254,(R4)+;177254 - регистр гозизонтального скролинга слой 1
--                mov     @#177256,(R4)+;177256 - регистр гозизонтального скролинга слой 2
++                mov     @#177230,(R4)+;177230 - control register
++                mov     @#177232,(R4)+;177232 - register - top page (layer 0)
++                mov     @#177240,(R4)+;177240 - register - top page (layer 1)
++                mov     @#177242,(R4)+;177242 - register - top page (layer 2)
++                mov     @#177244,(R4)+;177244 - vertical scroll register layer 2
++                mov     @#177246,(R4)+;177246 - vertical scroll register layer 1
++                mov     @#177250,(R4)+;177250 - vertical scroll register layer 0
++                mov     @#177252,(R4)+;177252 - horizontal scroll register layer 0
++                mov     @#177254,(R4)+;177254 - horizontal scroll register layer 1
++                mov     @#177256,(R4)+;177256 - horizontal scroll register layer 2
--                mov     R5,@#177336; вернем страницу с которой был вызов
++                mov     R5,@#177336; return the page from which the call was made
           ;-------------------------
--                MOV     #AZ$CSR,R3     ; Готовим CSR контроллера
--                MOV     #AZ$DR,R4     ; Готовим DR контроллера
--20$:            CLR     (R3)         ; Сбросим контроллер
++                MOV     #AZ$CSR,R3     ; Preparing controller CSR
++                MOV     #AZ$DR,R4     ; Preparing controller DR
++20$:            CLR     (R3)         ; Reset the controller
                  TSTB    (R3)
                  BPL     20$
--         ; очистим блок памяти для имени - дабы система сделала дефолтное имя файла
--                mov     #23,(R3)     ; командуем что будем писать данные в буфер
--128$:           TSTB    (R3)         ; проверяем результат выполнения
--                BPL     128$         ; ждем
++         ; clear the memory block for the name - so that the system makes a default file name
++                mov     #23,(R3)     ; command that we will write data to the buffer
++128$:           TSTB    (R3)         ; check the result of execution
++                BPL     128$         ; wait
                  clr     R1
                  mov     #256.,R2     ;
--129$:           mov     R1,(R4)      ; отдаем в контроллер
++129$:           mov     R1,(R4)      ; give to the controller
                  sob     R2,129$
--                MOV     #044,(R3)    ; команда скриншот
++                MOV     #044,(R3)    ; screenshot command
 $:            TSTB    (R3)         ;
                  BPL     22$          ;
--         ; получим имя скриншота
--                mov     #22,(R3)     ; отдать на шину считанный блок памяти из буфера
--121$:           tstb    (R3)         ; проверяем результат выполнения
--                bpl     121$         ; ждем
++         ; get the screenshot name
++                mov     #22,(R3)     ; give the read memory block from the buffer to the bus
++121$:           tstb    (R3)         ; check the result of execution
++                bpl     121$         ; wait
                  mov     #BUF,R1
--                mov     #256.,R2     ; читаем 256. слов; первое слово - результат чтения
--122$:           mov     (R4),(R1)+   ; читаем блок слов в память
++                mov     #256.,R2     ; read 256. words; the first word is the result of reading
++122$:           mov     (R4),(R1)+   ; read a block of words into memory
                  sob     R2,122$
                  .PRINT  #RESOK
                  .Print  #BUF
--                mov     #110,@#AZ$CSR; включаем сеть по-умолчанию сеть должна быть постоянно включена
++                mov     #110,@#AZ$CSR; enable the network by default, the network should be constantly enabled
                  .Exit
  {{/code}}
--Для распаковки скриншота можно использовать вот эту утилиту
++To unpack a screenshot, you can use this utility - [[https:~~/~~/master.pdp-11.ru/screen_unpack/>>https://master.pdp-11.ru/screen_unpack/]]
--= **Команды для работы со стеком TCP/IP** =
++= Commands for working with the TCP/IP stack =
--следующие команды работают с буфером информации TCP/IP cтека.
++The following commands operate on the TCP/IP stack information buffer.
--== **040: Получить ip адрес и прочие настройки стека TCP/IP в буфер** ==
++== 040: Get IP address and other TCP/IP stack settings to buffer ==
--Код команды 040,  данная команда заполняет буфер информацией с TCP/IP cтека текущей (фактической) информацией.
++Command code 040, this command fills the buffer with information from the TCP/IP stack with current (actual) information.
--== **041: Чтение буфера ip адреса** ==
++== 041: Reading ip address buffer ==
--Код команды 041,  данная команда передает буфер на шину
++Command code 041, this command transfers the buffer to the bus
--эта пара команд позволяет получить текущую информацию со стека
++This pair of commands allows you to get current information from the stack
--* IP адрес
--* MASK маску
--* GW гейтвей
--* NTP адрес NTP-сервера
--* DNS1 адрес основного DNS
--* DNS2 адрес резервного DNS
++* IP address
++* MASK mask
++* GW gateway
++* NTP address of the NTP server
++* DNS1 primary DNS address
++* DNS2 backup DNS address
--соответственно это 12 слов
++accordingly it is 12 words
--Пример программы:
++Example program:
  {{code language="assembler"}}
--; trap 52 - чтение блока IP адресов в блок памяти IPADDDBLOCK (8. ячеек)
--; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK)
--GetIPaddrs:     push    R1
--                push    R2
--                call    AZreset; сбросим
--                tst     R1
--                bne     0ERR$
--                MOV     #AZ$CSR,R1
--                mov     #40,(R1)
--0$:             TSTB    (R1); прочитать адреса в свою память
--                BPL     0$; ждем
--                mov     #41,(R1)
--1$:             TSTB    (R1); подготовить буфер
--                BPL     1$; ждем
--                TST     (R1)+; инкрементируем
--                mov     #IPADDDBLOCK,R3
--                mov     #12.,R2
--2$:             mov     (R1),(R3)+; читаем блок слов в память
--                sob     R2,2$
--                mov     #IPADDDBLOCK,R3; успешно
--                br      0END$
--0ERR$:          CLR     R3
--0END$:          pop     R2
--                pop     R1
--                return
++; trap 52 - reading a block of IP addresses into the IPADDDBLOCK memory block (8 cells)
++; result in R3 = 0 if error, otherwise the address where it was read (IPADDDBLOCK)
++GetIPaddrs:     push    R1
++                push    R2
++                call    AZreset; reset
++                tst     R1
++                bne     0ERR$
++                MOV     #AZ$CSR,R1
++                mov     #40,(R1)
++0$:             TSTB    (R1); read addresses into its memory
++                BPL     0$; wait
++                mov     #41,(R1)
++1$:             TSTB    (R1); prepare buffer
++                BPL     1$; wait
++                TST     (R1)+; increment
++                mov     #IPADDDBLOCK,R3
++                mov     #12.,R2
++2$:             mov     (R1),(R3)+; read block of words into memory
++                sob     R2,2$
++                mov     #IPADDDBLOCK,R3; success
++                br      0END$
++0ERR$:          CLR     R3
++0END$:          pop     R2
++                pop     R1
++                return
++
  {{/code}}
--Пример данных
++Example return data:
  {{info}}
--Примеры данных - возвращаемые слова в восьмеричном формате
--124300 116400 - IP адрес 192.168.0.157
--177777 000377 - MASK маску 255.255.255.0
--124300 000400 - GW гейтвей 192.168.0.1
--124300 000400 - NTP адрес NTP-сервера 192.168.0.1
--124300 050000 - DNS1 адрес основного DNS 192.168.0.90
--124300 055000 - DNS2 адрес резервного DNS 192.168.0.80
++Data examples - words returned in octal format
++124300 116400 - IP address 192.168.0.157
++177777 000377 - MASK mask 255.255.255.0
++124300 000400 - GW gateway 192.168.0.1
++124300 000400 - NTP address of NTP server 192.168.0.1
++124300 050000 - DNS1 address of primary DNS 192.168.0.90
++124300 055000 - DNS2 address of backup DNS 192.168.0.80
  {{/info}}
--== **043: чтение MAC-адреса в ip буфер** ==
++== 043: Read MAC address into ip buffer ==
--Код команды 043, данная команда читает текущий фактический MAC адрес в буфер IP адресов
--те сначала 043, а затем 041 команды
++Command code 043, this command reads the current actual MAC address into the IP address buffer i.e. first 043 and then 041 commands
--Пример программы:
++Example program:
  {{code language="assembler"}}
--; trap 72 - чтение MAC адреса в блок памяти IPADDDBLOCK (12. ячеек)
--; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK)
--GetMACaddrs:    push    R1
--                push    R2
--                call    AZreset     ; сбросим
--                tst     R1
--                bne     0ERR$
--                MOV     #AZ$CSR,R1
--                mov     #43,(R1)
--0$:             TSTB    (R1)        ; прочитать адреса в свою память
--                BPL     0$          ; ждем
--                mov     #41,(R1)
--1$:             TSTB    (R1)        ; подготовить буфер
--                BPL     1$          ; ждем
--                TST     (R1)+       ; инкрементируем
--                mov     #IPADDDBLOCK,R3
--                mov     #12.,R2
--2$:             mov     (R1),(R3)+  ; читаем блок слов в память
--                sob     R2,2$
--                mov     #IPADDDBLOCK,R3; успешно
--                br      0END$
--0ERR$:          CLR     R3
--0END$:          pop     R2
--                pop     R1
--                retur
++; trap 72 - reading the MAC address into the IPADDDBLOCK memory block (12 cells)
++; result in R3 = 0 if error, otherwise the address where it was read (IPADDDBLOCK)
++GetMACaddrs:    push    R1
++                push    R2
++                call    AZreset     ; reset
++                tst     R1
++                bne     0ERR$
++                MOV     #AZ$CSR,R1
++                mov     #43,(R1)
++0$:             TSTB    (R1)        ; read addresses into its memory
++                BPL     0$          ; wait
++                mov     #41,(R1)
++1$:             TSTB    (R1)        ; prepare buffer
++                BPL     1$          ; wait
++                TST     (R1)+       ; increment
++                mov     #IPADDDBLOCK,R3
++                mov     #12.,R2
++2$:             mov     (R1),(R3)+  ; read block of words into memory
++                sob     R2,2$
++                mov     #IPADDDBLOCK,R3; success
++                br      0END$
++0ERR$:          CLR     R3
++0END$:          pop     R2
++                pop     R1
++                retur
++
  {{/code}}
--= **Команды для работы с MicroSD картой на файловом уровне** =
++= Commands for working with a MicroSD card at the file level =
--Данные команды предназначены для работы с MicroSD картой на уровне файловой системы и позволяет читать/писать файлы без монтирования файлов как образов дисков.
++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.
--Эти команды используют буфер 256. слов который задействован в интерфейсе работы с энергонезависимой памятью (см выше команды 022 023)
--\\Ограничения - длина полного пути к файлу  256 байт
++These commands use a 256-word buffer that is used in the interface for working with non-volatile memory (see commands 022 023 above)
--== **050: Установить имя файла который будем читать** ==
++Limitations - the length of the full path to the file is 256 bytes
--Код команды 050,  данная команда устанавливает имя файла который будем читать, при этом производится открытие файла на чтение, а также получение его свойств.
++== 050: Set the name of the file we will read ==
--== **051: Получить размер файла на чтение (или его статус) на МПИ** ==
++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.
--Код команды 051,  данная команда передает на МПИ размер файла или ошибку его чтения. Размер файла 31бит, старший бит является признаком ошибки. Соответственно максимальный размер файлов с которыми можно работать через этот интерфейс ограничен 2^31 байт (2GB).
++== 051: Get file size for reading (or its status) on BUS ==
--формирование ошибки выглядит так:
--sizeanyfile=1<<31 + FFres; ~/~/ если установлен старший бит 32х битного слова - то в младшей части код ошибки
--\\FFres = ошибка FatFS
--
++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).
++The error generation looks like this:
++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
++
++FFres = FatFS error
++
  {{code language="c"}}
  typedef enum {
      FR_OK = 0,                /* (0) Succeeded */
@@ -1366,317 +1366,309 @@
  [[http:~~/~~/elm-chan.org/fsw/ff/doc/open.html>>url:http://elm-chan.org/fsw/ff/doc/open.html]]
--== **052: Читать блок установленного файла в буфер** ==
++== 052: Read a block of a set file into a buffer ==
--Код команды 052,  данная команда осуществляет чтение файла в буфер энергонезависимой памяти.
++Command code 052, this command reads a file into a non-volatile memory buffer.
--В итоге схема чтения файла выглядит вот так
--**023** - заливаем имя файла в буфер
--**050** - устанавливаем файл на чтение
--**051 **- читаем длину файла или ошибку открытия файла
--если ошибка - повторяем сначала 023 050 051
--если все ok - приступаем к чтению файла
--**052** - читает блок файла в буфер
--**022 **- забираем данные из буфера
--пары 052 022 повторяем нужное количество раз дабы считать весь файл
--как файл будет прочтен - последняя 052 команда закроет его автоматически.
--
++As a result, the file reading scheme looks like this
++**023** - fill the file name into the buffer
++**050 **- set the file for reading
++**051** - read the file length or file open error
++if there is an error - repeat 023 050 051 from the beginning
++if everything is ok - start reading the file
++**052** - read the file block into the buffer
++**022** - take data from the buffer
++repeat the **052 022** pairs the required number of times in order to read the entire file
++once the file is read - the last 052 command will close it automatically.
--Пример программы
++Example program:
  {{code language="assembler"}}
++                call    AZRST; reset
--                call    AZRST; сбросим
++; load the file name into the buffer
++7$:             mov     #23,(R1); command to write data to the buffer
++5$:             TSTB    (R1); check execution result
++                BPL     5$  ; wait
++                TST     (R1)+; increment
++                mov     #FILNM,R3
++1$:             mov     (R3),(R1); send to controller
++                tst     (R3)+
++                bne     1$
++                tst     -(R1); decrement
--; заливаем в буфер имя файла
--7$:             mov     #23,(R1); командуем что будем писать данные в буфер
--5$:             TSTB    (R1); проверяем результат выполнения
--                BPL     5$  ; ждем
--                TST     (R1)+; инкрементируем
--                mov     #FILNM,R3
--1$:             mov     (R3),(R1); отдаем в контроллер
--                tst     (R3)+
--                bne     1$
--                tst     -(R1); декрементируем
++; set the file for reading
++                mov     #50,(R1); set file for reading
++2$:             TSTB    (R1); check execution result
++                BPL     2$  ; wait
++; read the file length
++                mov     #51,(R1); set file for reading
++3$:             TSTB    (R1); check execution result
++                BPL     3$  ; wait
++                TST     (R1)+; increment
++                mov     #FILSZ,R3
++                mov     (R1),(R3)+; read from controller
++                mov     (R1),(R3); read from controller
--    ; устанавливаем файл на чтение
--                mov     #50,(R1); устанавливаем файл на чтение
--2$:             TSTB    (R1); проверяем результат выполнения
--                BPL     2$  ; ждем
++; display the file length on the screen
++                clr     R0
++                mov     #FILSZ+2,R3
++                mov     (R3),R1
++                call    DNOZ
++                mov     -(R3),R1
++                call    DNOZ
++                .print   #STMS2
++; read the file
++                mov     R1,R4; R1 holds the file length
++                MOV     #AZ$CSR,R1
++                mov     #BUFFL,R5
--    ; читаем длину файда
--                mov     #51,(R1); устанавливаем файл на чтение
--3$:             TSTB    (R1); проверяем результат выполнения
--                BPL     3$  ; ждем
--                TST     (R1)+; инкрементируем
--                mov     #FILSZ,R3
--                mov     (R1),(R3)+; читаем с контроллера
--                mov     (R1),(R3); читаем с контроллера
++                bit     #1,R4; if an odd number of bytes
++                beq     47$
++                inc      R4; add 1 more byte as we read words
--    ; выведем длину файла на экран
--                clr     R0
--                mov     #FILSZ+2,R3
--                mov     (R3),R1
--                call    DNOZ
--                mov     -(R3),R1
--                call    DNOZ
--                .print   #STMS2
++47$:            tst     R4
++                beq     45$ ; nothing left to read - exit
--    ; читаем файл
--                mov     R1,R4; в R1 осталась длина файла
--                MOV     #AZ$CSR,R1
--                mov     #BUFFL,R5
++                mov     #52,(R1); read block into buffer
++4$:             TSTB    (R1); check execution result
++                BPL     4$  ; wait
++                mov     #22,(R1); start reading buffer
++51$:            TSTB    (R1); check execution result
++                BPL     51$ ; wait
--                bit     #1,R4; если нечетное число байт
--                beq     47$
--                inc      R4; добавим еще 1 байт тк читаем словами
++                cmp     R4,#512.; compare with buffer size in bytes
++                Blos    44$ ; less than buffer size left
--47$:            tst     R4
--                beq     45$ ; уже нечего читать - выходим
++                .print  #STMS1
++                mov     #256.,R2
++                TST     (R1)+; move to data register
++46$:            mov     (R1),(R5)+; read into buffer
++                sob     R2,46$
++                sub     #512.,R4; subtract
++                TST     -(R1); move to command register
++                br      47$
++44$:            .print  #STMS3
++                mov     R4,R2
++                asr     R2  ; /2 since reading words
++                TST     (R1)+; move to data register
++43$:            mov     (R1),(R5)+; read into buffer
++                sob     R2,43$
--                mov     #52,(R1); читаем блок в буфер
--4$:             TSTB    (R1); проверяем результат выполнения
--                BPL     4$  ; ждем
--                mov     #22,(R1); будем читать буфер
--51$:            TSTB    (R1); проверяем результат выполнения
--                BPL     51$ ; ждем
++45$:            clr     (R5); set end of file marker
--                cmp     R4,#512.; сравниваем c размером буфера в байтах
--                Blos    44$ ; осталось меньше чем буфер
++; file read - display on screen
++                .print   #STMS4
++                .print  #BUFFL
++                .print   #STMS5
++                mov     #110,@#AZ$CSR; enable network
++                .Exit
--                .print  #STMS1
--                mov     #256.,R2
--                TST     (R1)+; переходим на регистр данных
--46$:            mov     (R1),(R5)+; читаем в буфер
--                sob     R2,46$
--                sub     #512.,R4; вычитаем
--                TST     -(R1); переходим на регистр команд
--                br      47$
--
--44$:            .print  #STMS3
--                mov     R4,R2
--                asr     R2  ; /2 тк читаем словами
--                TST     (R1)+; переходим на регистр данных
--43$:            mov     (R1),(R5)+; читаем в буфер
--                sob     R2,43$
--
--
--45$:            clr     (R5); проставим конец файла
--    ; файл считан - выводим на экран
--                .print   #STMS4
--                .print  #BUFFL
--                .print   #STMS5
--
--
--                mov     #110,@#AZ$CSR; включаем сеть
--                .Exit
  {{/code}}
--== **053:** установить имя файла который будем писать ==
++== 053: set the name of the file that we will write ==
--Код команды 053,  данная команда открывает файл на запись, получает параметры открытия (или ошибки).
++Command code 053, this command opens a file for writing, receives opening parameters (or errors).
--== **054:** установка длины файла ==
++== 054: Set file length ==
--Код команды 054,  данная команда устанавливает ожидаемую длину файла, это нужно для корректного формирования файла на файловом уровне MicroSD карты, а также для организации передачи данных.
++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.
--== **055:** записать в файл данные из буфера ==
++== 055: write data from buffer to file ==
--Код команды 055,  данная команда записывает в открытый файл на запись данные из буфера энергонезависимой памяти. Последняя команда 055 автоматически закроет файл по достижению заявленной длины файла.
++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.
--Схема подачи команд при записи вот такая
--**023** - заливаем имя файла в буфер
--**053** - устанавливаем файл на чтение
--**051 **- статус открытия/создания файла
--если ошибка - повторяем сначала 023 053 051
--если все ok - идем дальше
--**054** - установка длины файла, те надо сразу объявить какая у нас будет длина файла
--**023** - заливаем блок данных в буфер
--**055** - пишем из буфера в файл
--пары 023 055 повторяем нужное количество раз дабы записать весь файл
--как файл будет записан - последняя 055 команда закроет его автоматически
++The command flow chart for writing is as follows
++**023** - fill the file name into the buffer
++**053** - set the file for reading
++**051** - file opening/creation status
++if an error - repeat from the beginning 023 053 051
++if everything is ok - move on
++**054** - set the file length, i.e. we must immediately declare what the file length will be
++**023** - fill the data block into the buffer
++**055** - write from the buffer to the file
++repeat the 023 055 pairs the required number of times in order to write the entire file
++once the file is written - the last 055 command will close it automatically
--Пример программы:
++Example program:
  {{code language="assembler"}}
--; заливаем в буфер имя файла
--                MOV     #AZ$CSR,R1
--17$:            mov     #23,(R1); командуем что будем писать данные в буфер
--15$:            TSTB    (R1)    ; проверяем результат выполнения
--                BPL     15$     ; ждем
--                TST     (R1)+   ; переходим на регистр данных
--                mov     #FILNM2,R3
--11$:             mov    (R3),(R1); отдаем в контроллер
--                tst     (R3)+
--                bne     11$
--                tst     -(R1)   ; переходим на регистр команд
++; load the file name into the buffer
++                MOV     #AZ$CSR,R1
++17$:            mov     #23,(R1); command to write data to the buffer
++15$:            TSTB    (R1)    ; check execution result
++                BPL     15$     ; wait
++                TST     (R1)+   ; move to data register
++                mov     #FILNM2,R3
++11$:             mov    (R3),(R1); send to controller
++                tst     (R3)+
++                bne     11$
++                tst     -(R1)   ; move to command register
--        ; устанавливаем файл на запись
--                mov     #53,(R1); устанавливаем файл на запись
--12$:            TSTB    (R1)    ; проверяем результат выполнения
--                BPL     12$     ; ждем
++; set the file for writing
++                mov     #53,(R1); set file for writing
++12$:            TSTB    (R1)    ; check execution result
++                BPL     12$     ; wait
++; read file creation status
++                mov     #51,(R1)
++13$:            TSTB    (R1)    ; check execution result
++                BPL     13$     ; wait
++                TST     (R1)+   ; move to data register
++                mov     #STATS,R3
++                mov     (R1),(R3)+; read from controller
++                mov     (R1),(R3); read from controller
--        ; читаем статус создания файла
--                mov     #51,(R1)
--13$:            TSTB    (R1)    ; проверяем результат выполнения
--                BPL     13$     ; ждем
--                TST     (R1)+   ; переходим на регистр данных
--                mov     #STATS,R3
--                mov     (R1),(R3)+; читаем с контроллера
--                mov     (R1),(R3); читаем с контроллера
++; check here - if the file is created, both words should be zero
++                mov     #STATS,R3
++                TST     (R3)+
++                BNE     66$
++                TST     (R3)
++                BEQ     60$
++66$:            .print  #ERRMS1 ; print error
++                .exit
--        ; тут надо проверить - если файл создан то оба слова нулевые
--                mov     #STATS,R3
--                TST     (R3)+
--                BNE     66$
--                TST     (R3)
--                BEQ     60$
--66$:            .print  #ERRMS1 ; печать ошибки
--                .exit
++60$:            MOV     #AZ$CSR,R1
++                mov     #54,(R1); set file length to be written
++23$:            TSTB    (R1)    ; check execution result
++                BPL     23$     ; wait
++                TST     (R1)+   ; move to data register
++                mov     #FILSZ,R3
++                mov     (R3)+,(R1); write to controller
++                mov     (R3),(R1); write to controller
--60$:            MOV     #AZ$CSR,R1
--                mov     #54,(R1); установим длину файла который будем писать
--23$:            TSTB    (R1)    ; проверяем результат выполнения
--                BPL     23$     ; ждем
--                TST     (R1)+   ; переходим на регистр данных
--                mov     #FILSZ,R3
--                mov     (R3)+,(R1); пишем в контроллер
--                mov     (R3),(R1); пишем в контроллер
++                tst     -(R1)   ; move to command register
--                tst     -(R1)   ; переходим на регистр команд
++; write file
++                mov     @#FILSZ,R4; file length
++                MOV     #AZ$CSR,R1
++                mov     #BUFFL,R5; file buffer
++                bit     #1,R4   ; if an odd number of bytes
++                beq     147$
++                inc      R4   ; add 1 more byte since reading words
++147$:           tst     R4      ; check length
++                beq     145$    ; nothing left to write - exit
--        ; пишем файл
--                mov     @#FILSZ,R4; длина файла
--                MOV     #AZ$CSR,R1
--                mov     #BUFFL,R5; буфер файла
++                mov     #23,(R1); write to buffer
++151$:           TSTB    (R1)    ; check execution result
++                BPL     151$    ; wait
--                bit     #1,R4   ; если нечетное число байт
--                beq     147$
--                inc      R4   ; добавим еще 1 байт тк читаем словами
++                cmp     R4,#512.; compare with buffer size in bytes
++                Blos    144$    ; less than buffer size left
--147$:           tst     R4      ; проверим длину
--                beq     145$    ; уже нечего писать - выходим
++                .print  #STMS6  ; writing full block
++                mov     #256.,R2
++                TST     (R1)+   ; move to data register
++146$:           mov     (R5)+,(R1); write to controller buffer
++                sob     R2,146$
++                sub     #512.,R4; subtract
++                TST     -(R1)   ; move to command register
--                mov     #23,(R1); будем писать в буфер
--151$:           TSTB    (R1)    ; проверяем результат выполнения
--                BPL     151$    ; ждем
++                mov     #55,(R1); write buffer to file
++104$:           TSTB    (R1)    ; check execution result
++                BPL     104$    ; wait
++                br      147$    ; loop back
--                cmp     R4,#512.; сравниваем c размером буфера в байтах
--                Blos    144$    ; осталось меньше чем буфер
++144$:            .print  #STMS7 ; writing last block
++                TST     (R1)+   ; move to data register
++                mov     R4,R2
++                asr     R2      ; /2 since writing words
++143$:           mov     (R5)+,(R1); write to controller buffer
++                sob     R2,143$
--                .print  #STMS6  ; заливка полного блока
--                mov     #256.,R2
--                TST     (R1)+   ; переходим на регистр данных
--146$:           mov     (R5)+,(R1); пишем в буфер контроллера
--                sob     R2,146$
--                sub     #512.,R4; вычитаем
--                TST     -(R1)   ; переходим на регистр команд
++                TST     -(R1)   ; move to command register
++                mov     #55,(R1); write last buffer to file
++105$:           TSTB    (R1)    ; check execution result
++                BPL     105$    ; wait
--                mov     #55,(R1); запись буфера в файл
--104$:           TSTB    (R1)    ; проверяем результат выполнения
--                BPL     104$    ; ждем
--                br      147$    ; в начало
++145$:           .print #STMSE   ; end
++                mov     #110,@#AZ$CSR; enable network
++                .Exit           ; exit
--144$:            .print  #STMS7 ; заливка последнего блока
--                TST     (R1)+   ; переходим на регистр данных
--                mov     R4,R2
--                asr     R2      ; /2 тк пишем словами
--143$:           mov     (R5)+,(R1); пишем в буфер контроллера
--                sob     R2,143$
--
--                TST     -(R1)   ; переходим на регистр команд
--                mov     #55,(R1); запись пследнего буфера в файл
--105$:           TSTB    (R1)    ; проверяем результат выполнения
--                BPL     105$    ; ждем
--
--145$:           .print #STMSE   ; конец
--                mov     #110,@#AZ$CSR; включаем сеть
--                .Exit           ; выходим
  {{/code}}
--**[[пример полностью в виде утилиты RT11 выложен вот тут>>url:https://forum.maxiol.com/index.php?s=&showtopic=5605&view=findpost&p=57055]]**
++**[[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]]**
--== **056: Получить данные по размеру карты в буфер sizecard** ==
++== 056: Get data on the size of the map into the sizecard buffer ==
--Код команды 056,  данная команда читает параметры MicroSD карты в буфер sizecard
++Command code 056, this command reads the parameters of the MicroSD card into the sizecard buffer
--== **057: Чтение буфера sizecard** ==
++== 057: Reading sizecard buffer ==
--Код команды 057,  данная команда отдает буфер sizecard (2 слова)
++Command code 057, this command returns the sizecard buffer (2 words)
--буфер sizecard содержит 2 слова 16bit
--первое слово - общий объем карты доступный для FAT в МБ
--второе слово - свободный объем на карте в МБ
++sizecard buffer contains 2 words 16bit
++first word - total card size available for FAT in MB
++second word - free card size in MB
--Пример программы:
++Example program:
  {{code language="assembler"}}
--; trap 51 - получение объема SD карты всего/свободно в мегабайтах
--; результат в R1 - всего; R2 - свободно
--GetSizeSD:      call    AZreset; сбросим
--                tst     R1
--                bne     0ERR$
--                MOV     #AZ$CSR,R1
--                mov     #56,(R1)
--1$:             TSTB    (R1); подготовить буфер
--                BPL     1$; ждем
--                mov     #57,(R1)
--2$:             TSTB    (R1); подготовить буфер
--                BPL     2$; ждем
--                mov     @#AZ$DR ,R1; всего мегабайт
--                mov     @#AZ$DR ,R2; свободно мегабайт
--                return
--                clr     R1
--                clr     R2
--                return
++; trap 51 - get the total/free size of the SD card in megabytes
++; result in R1 - total; R2 - free
++GetSizeSD:      call    AZreset  ; reset
++                tst     R1
++                bne     0ERR$
++                MOV     #AZ$CSR,R1
++                mov     #56,(R1)
++1$:             TSTB    (R1)     ; prepare buffer
++                BPL     1$       ; wait
++                mov     #57,(R1)
++2$:             TSTB    (R1)     ; prepare buffer
++                BPL     2$       ; wait
++                mov     @#AZ$DR ,R1  ; total megabytes
++                mov     @#AZ$DR ,R2  ; free megabytes
++                return
++                clr     R1
++                clr     R2
++                return
++
  {{/code}}
--Пример данных
--035521 - всего на карточке мегабайт - 15185.
--035417 - свободно мегабайт - 15119.
--
++Example data
++035521 - total megabytes on the card - 15185.
++035417 - free megabytes - 15119.
--= **Блок команд API Hall of Fame** =
++= Hall of Fame API Command Block =
--Данный блок команд предназначен для взаимодействия с сервером [[Hall of Fame>>https://forum.maxiol.com/index.php?showtopic=5642]]
++This block of commands is intended for interaction with the server [[Hall of Fame>>https://forum.maxiol.com/index.php?showtopic=5642]]
  == **025: Инициализация Hall of Fame (HOF)** ==
--Код команды 025,  данная команда устанавливает соединение с сервером Hall of Fame, инициализирует шифрованный тоннель и подготавливает API к работе.
++Command code 025, this command establishes a connection to the Hall of Fame server, initializes the encrypted tunnel and prepares the API for work.
--Пример программы
++Example program:
  {{code language="assembler"}}
--AZ$CSR          = 177220                 ; регистр команд и состояния (CSR)
--AZ$DR           = 177222                 ; регистр данных (DR)
++AZ$CSR          = 177220                 ; command and status register (CSR)
++AZ$DR           = 177222                 ; data register (DR)
--; буфера
--SNDBUF:         .BLKW 256.               ; буфер передачи
--RCVBUF:         .BLKW 256.               ; буфер приема ответа
++; buffers
++SNDBUF:         .BLKW 256.               ; send buffer
++RCVBUF:         .BLKW 256.               ; receive buffer
  SIDMEM:         .BLKB 34.                ; SID
--SIDCST:         .ASCII    \{"SID":"\       ; заголовок SID-а
++SIDCST:         .ASCII    \{"SID":"\       ; SID header
                  .even
--HOFINI:      ; инициализация HOF
--             ;результатом является такой JSON
--             ;{"SID":"хеш сессии","RESULT":"OK"}
--             ;или ошибка
--             ;{"RESULT":"ERROR","DESCRIPTION":"SERVER_ERROR"}
--             ;{"RESULT":"ERROR","DESCRIPTION":"CONNECTION_ERROR"}
--             ; результат помещается в SNDBUF
--             ; в R5 фиксация успешности - =1 есть SID, =0 нет SID-а
--
++HOFINI:      ; HOF initialization
++             ; The result is a JSON response:
++             ; {"SID":"session hash","RESULT":"OK"}
++             ; or an error:
++             ; {"RESULT":"ERROR","DESCRIPTION":"SERVER_ERROR"}
++             ; {"RESULT":"ERROR","DESCRIPTION":"CONNECTION_ERROR"}
++             ; The result is placed in SNDBUF
++             ; R5 indicates success: 1 = SID exists, 0 = no SID
++
                  mov     R5, -(SP)
                  mov     R4, -(SP)
                  mov     R3, -(SP)
@@ -1684,29 +1684,29 @@
                  mov     R1, -(SP)
                  mov     R0, -(SP)
--                mov     #3,R5        ; количество попыток
++                mov     #3,R5        ; number of attempts
 $:           mov     #AZ$CSR,R1
--                clr     (R1)         ; Пошлем команду "Сброс"
--221$:           tstb    (R1)         ; Проверим готовность контроллера
--                bpl     221$         ; Если не готов ждем
++                clr     (R1)         ; Send "Reset" command
++221$:           tstb    (R1)         ; Check controller readiness
++                bpl     221$         ; If not ready, wait
--                mov     #25,(R1)     ; инициализация  - команда 025
--20$:            tstb    (R1)         ; проверяем результат выполнения
--                bpl     20$          ; ждем
++                mov     #25,(R1)     ; initialization - command 025
++20$:            tstb    (R1)         ; check execution result
++                bpl     20$          ; wait
--             ; получим результат
--                mov     #22,(R1)     ; отдать на шину считанный блок памяти из буфера
--21$:            tstb    (R1)         ; проверяем результат выполнения
--                bpl     21$          ; ждем
--                tst     (R1)+        ; инкрементируем
++             ; Retrieve the result
++                mov     #22,(R1)     ; output the read memory block from buffer to the bus
++21$:            tstb    (R1)         ; check execution result
++                bpl     21$          ; wait
++                tst     (R1)+        ; increment
                  mov     #SNDBUF,R3
--                mov     #256.,R2     ; читаем 256. слов; первое слово - результат чтения
--22$:            mov     (R1),(R3)+   ; читаем блок слов в память
++                mov     #256.,R2     ; read 256 words; first word is the read result
++22$:            mov     (R1),(R3)+   ; read block of words into memory
                  sob     R2,22$
--             ; надо понять - есть ли SID
++             ; Determine if SID exists
                  mov     #4,R0
                  mov     #SNDBUF,R1
                  mov     #SIDCST,R2
@@ -1715,11 +1715,11 @@
                  sob     R0,23$
                  clr     R5
                  inc     R5
--                br      26$          ; успешно
++                br      26$          ; success
--24$:         ; SID не найден!
++24$:         ; SID not found!
                  sob     R5,220$
--                clr     R5           ; ошибка - нет SID-а
++                clr     R5           ; error - no SID
 $:            mov     (SP)+, R0
                  mov     (SP)+, R1
@@ -1728,69 +1728,71 @@
                  mov     (SP)+, R4
                  mov     (SP)+, R5
                  return
++
  {{/code}}
--== **026: обмен с Hall of Fame (HOF)** ==
++== 026: Exchange with Hall of Fame (HOF) ==
--Код команды 026,  данная команда осуществляет непосредственный обмен с Hall of Fame
++Command code 026, this command makes a direct exchange with Hall of Fame
--Пример программы
++Example program:
  {{code language="assembler"}}
--             ;4. авторизация пользователя
--             ;технически это отправка JSON
--             ;{"SID":"хеш сессии","CMD":"AUTH_USER","NIKNAME":"никнейм пользователя","PASSWORD":"пароль пользователя"}
--             ;ответ тоже JSON
--             ;{"SID":"хеш сессии","RESULT":"OK","UID":"хеш пользователя"}
--             ;или
--             ;{"SID":"хеш сессии","RESULT":"ERROR","DESCRIPTION":"USER_NOT_FOUND_OR_WRONG_PASSWORD"}
--             ;{"SID":"хеш сессии","RESULT":"ERROR","DESCRIPTION":"SERVER_ERROR"}
--             ;{"SID":"хеш сессии","RESULT":"ERROR","DESCRIPTION":"SESSION_NOT_EXISTS_OR_EXPIRED"}
++             ;4. user authentication
++             ;technically, this is sending a JSON
++             ;{"SID":"session hash","CMD":"AUTH_USER","NIKNAME":"user nickname","PASSWORD":"user password"}
++             ;the response is also JSON
++             ;{"SID":"session hash","RESULT":"OK","UID":"user hash"}
++             ;or
++             ;{"SID":"session hash","RESULT":"ERROR","DESCRIPTION":"USER_NOT_FOUND_OR_WRONG_PASSWORD"}
++             ;{"SID":"session hash","RESULT":"ERROR","DESCRIPTION":"SERVER_ERROR"}
++             ;{"SID":"session hash","RESULT":"ERROR","DESCRIPTION":"SESSION_NOT_EXISTS_OR_EXPIRED"}
--             ; загоняем команду CMD04
--                mov     #CMD04,R1
--                mov     #ADRMEM,R2
--                add     #42.,R2      ; cдвигаем указатель на длину блока с SID
--33$:            movb   (R1)+,(R2)+
--                bne     33$
++             ; load command CMD04
++                mov     #CMD04,R1
++                mov     #ADRMEM,R2
++                add     #42.,R2      ; shift the pointer to the SID block length
++33$:            movb   (R1)+,(R2)+
++                bne     33$
--                .Print    #ADRMEM
++                .Print    #ADRMEM
--                .Print    #HOF05
--             ; отсылаем команду и ждем ответа
--             ; закачиваем в буфер
--                MOV     #AZ$CSR,R1
--331$:           TSTB    (R1)         ; Проверим готовность контроллера
--                BPL     331$         ; Если не готов ждем
--                mov     #23,(R1)     ; командуем что будем писать данные в буфер
--34$:            TSTB    (R1)         ; проверяем результат выполнения
--                BPL     34$          ; ждем
--                TST     (R1)+        ; инкрементируем
--                mov     #ADRMEM,R3
--                mov     #256.,R2     ;
--35$:            mov     (R3)+,(R1)   ; отдаем в контроллер
--                sob     R2,35$
--                tst     -(R1)        ; декрементируем
++                .Print    #HOF05
++             ; send the command and wait for a response
++             ; load into buffer
++                MOV     #AZ$CSR,R1
++331$:           TSTB    (R1)         ; Check controller readiness
++                BPL     331$         ; If not ready, wait
++                mov     #23,(R1)     ; command to write data into buffer
++34$:            TSTB    (R1)         ; check execution result
++                BPL     34$          ; wait
++                TST     (R1)+        ; increment
++                mov     #ADRMEM,R3
++                mov     #256.,R2     ;
++35$:            mov     (R3)+,(R1)   ; send to controller
++                sob     R2,35$
++                tst     -(R1)        ; decrement
--             ; обмен  - команда 026
--                MOV     #AZ$CSR,R1
--361$:           TSTB    (R1)         ; Проверим готовность контроллера
--                BPL     361$         ; Если не готов ждем
--                mov     #26,(R1)
--36$:            TSTB    (R1)         ; проверяем результат выполнения
--                BPL     36$          ; ждем
++             ; exchange - command 026
++                MOV     #AZ$CSR,R1
++361$:           TSTB    (R1)         ; Check controller readiness
++                BPL     361$         ; If not ready, wait
++                mov     #26,(R1)
++36$:            TSTB    (R1)         ; check execution result
++                BPL     36$          ; wait
--             ; получим результат
--371$:           TSTB    (R1)         ; Проверим готовность контроллера
--                BPL     371$         ; Если не готов ждем
--                mov     #22,(R1)     ; отдать на шину буфер
--37$:            TSTB    (R1)         ; проверяем результат выполнения
--                BPL     37$          ; ждем
--                TST     (R1)+        ; инкрементируем
--                mov     #ADRMEM,R3
--                mov     #256.,R2     ; читаем 256. слов; первое слово - результат чтения
--38$:            mov     (R1),(R3)+   ; читаем блок слов в память
--                sob     R2,38$
++             ; receive result
++371$:           TSTB    (R1)         ; Check controller readiness
++                BPL     371$         ; If not ready, wait
++                mov     #22,(R1)     ; send buffer to the bus
++37$:            TSTB    (R1)         ; check execution result
++                BPL     37$          ; wait
++                TST     (R1)+        ; increment
++                mov     #ADRMEM,R3
++                mov     #256.,R2     ; read 256 words; first word is the read result
++38$:            mov     (R1),(R3)+   ; read block of words into memory
++                sob     R2,38$
++
  {{/code}}

Changes for page API контроллеров AZ®

Summary

Details

Applications

Navigation

Need help?