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

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

From 2.4 to 2.3 From 2.55 to 2.54

From version 2.54

edited by Max
on 2025/02/25 15:37

Change comment: (Autosaved)

To version 2.4

edited by Max
on 2025/02/25 12:06

Change comment: (Autosaved)

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -369,63 +369,56 @@
  ;...................................
  {{/code}}
--== 012: Setting the block number, block number high bits ==
++== **012: Установка номера блока, старшие биты номера блока** ==
--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.
++Контроллер предоставляет машинке с МПИ в качестве дисков 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 код команды, после чего следует проверить на ошибку. Команды мгновенные, т.е. выполняются за один цикл обращения по МПИ.
++
++== **013: Прочитать запись оглавления HFS** ==
--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):
++Код команды 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 (восьмеричные):
  \\001 - Read Only
 - Hidden
 - System
 - Directory
 - Archive
--\\Example program
++\\Пример программы.
  {{code language="assembler"}}
  ;......................................
--RdDir = 013; command code "Read table of contents entry"
++RdDir = 013; код команды "Читать запись оглавления"
  RdBuf = 015
          MOV     #AZ$CSR,R3
 $:    CLR     @R3;
--        TSTB    @R3;  Reset the controller
++        TSTB    @R3;  Сбросим контроллер
          BPL     15$;
--        MOV     #RdDir,@R3; Ask the controller
--16$:    TSTB    @R3; to read into its memory
--        BPL     16$; table of contents entry
++        MOV     #RdDir,@R3; Попросим контроллер
++16$:    TSTB    @R3; прочитать в свою память
++        BPL     16$; запись оглавления
          MOV     @RdBuf,(R3)+;
--        MOV     DIRREC,R2; And transfer it to itself in
--        MOV     #11.,R1; memory area, pointer
--17$:    MOV     @R3,(R2)+; to which lies in cell
++        MOV     DIRREC,R2; И перенесем ее к себе в
++        MOV     #11.,R1; область памяти, указатель
++17$:    MOV     @R3,(R2)+; на которую лежит в ячейке
          SOB     R1,17$; DIRREC.
  ;......................................
@@ -432,97 +432,96 @@
  {{/code}}
--== 014: Unmount disk ==
++== **014: Размонтировать диск** ==
--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]]
++Код команды 014, чтобы размонтировать диск, следует сбросить контроллер, переслать в DR контроллера номер привода AZ, который следует размонтировать, и послать в CSR контроллера код 014, после чего дождаться окончания операции (она длительная) и проверить на ошибку. Ошибка выдается, если привод не был смонтирован.
++[[**//пример утилиты AZUMNT//**>>url:https://forum.maxiol.com/index.php?showtopic=5605&st=0&p=59418&#entry59418]]
--== 015: Start transferring the read block ==
++== **015: Начать передачу считанного блока** ==
--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:
++Код команды - 015. Получив эту команду, контроллер настраивается на пословную выдачу содержимого того самого встроенного буфера на 256 слов, которые будут выданы последовательно через регистр DR. Никаких ожиданий не требуется, просто пересылаем 256 раз слово из DR в последовательные ячейки памяти, и все. Если нужно меньше, чем 256 слов (последний укороченный блок файла), то остаток можно просто бросить, не считывая, сброс контроллера в начале следующей операции сбросит и этот остаток.
++\\Пример программы:
  {{code language="assembler"}}
  ;..................................
--RdBuf=015; symbolic name of the command
++RdBuf=015; символическое наименование команды
--; In R3 from the previous fragment there is the address of the CSR
++; В R3 от предыдущего фрагмента остался адрес CSR
  ; (177220)
--; 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.
++; Считаем, что у нас в R2 находится адрес первого слова
++; памяти, куда следует разместить прочитанный блок.
++; Программа получения этого адреса не приводится.
--        MOV     #400,R1; Prepare the word counter
++        MOV     #400,R1; Готовим счетчик слов
                   ; 0400 oct = 256 dec
--        MOV     #RdBuf,(R3)+; and send the command
--; RdBuf to the CSR. The address in R3 will point to DR (177222).
++        MOV     #RdBuf,(R3)+; и пересылаем команду
++; RdBuf в CSR. Адрес в R3 укажет на DR (177222).
--3$:     MOV     @R3,(R2)+we will send the next word to
--; memory
--        SOB     R1,3$; and repeat this 256 (0400)
--                  ; times
++3$:     MOV     @R3,(R2)+;перешлем очередное слово в
++                  ; память
++        SOB     R1,3$; и повторим это 256 (0400)
++                  ; раз
  ;..................................
  {{/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: Receive data block into buffer ==
++Код команды 016. Команда настраивает контроллер на прием блока данных и помещении его в буфер. Следующие 256 циклов записи в DR поместят данные, переданные через МПИ, в буфер.
++\\Пример программы.
--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; Symbolic name of the command
++WrBuf=016; Символическое наименование команды
--; 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.1.-3.3. Обычно, это одна и та же программа,
++; просто после пункта 3.3. выполняется проверка "Что
++; требуется: чтение или запись?" и разветвление на
++; программу чтения или записи.
--; 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.
++; После фрагмента в п. 3.3. в R3 остался адрес CSR
++; (177220). Будем считать, что в R2 находится адрес в
++; памяти ЦП, где находится блок, подлежащий записи.
++; Программа получения этого адреса не показана.
--        MOV     #400,R1;  Preparing the counter
++        MOV     #400,R1; Готовим счетчик
--        MOV     #WrBuf,(R3)+;  Let's forward the command to the CSR and
--; switch the address in R3 to
--; DR
++        MOV     #WrBuf,(R3)+; Перешлем команду в CSR и
++                     ; переключим адрес в R3 на
++                     ; DR
--4$:     MOV     (R2)+,@R3;  Let's forward the next word
--; data
--        SOB     R1,4$; and repeat this 256 times
++4$:     MOV     (R2)+,@R3; Перешлем очередное слово
++                  ; данных
++        SOB     R1,4$; и повторим это 256 раз
  ;..................................
  {{/code}}
--== 017: Get ramdisk size, large ==
++== **017: Получить размер псевдодиска, большой** ==
--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
++Есть две команды получения размера псевдодиска, т.е. смонтированного на выбранный псевдопривод 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 выбор устройства) и исполнение программы до этого места просто не дойдет. Поэтому ошибок у этих команд не предусмотрено.
++\\Пример программы с большими дисками
  {{code language="assembler"}}
  ;......................................
--GetBig=017; Get the "big" disk size
++GetBig=017; Получить "большой" размер диска
--; From fragment 3.2 (disk selection) we have in R3
--; DR address (177222)
++; От фрагмента 3.2 (выбор диска) у нас в R3 остался
++; адрес DR (177222)
--        MOV     #GetBig,-(R3); send the command
--        TST     (R3)+; return the address in R3 back to DR
++        MOV     #GetBig,-(R3); пошлем команду
++        TST     (R3)+; вернем адрес в R3 назад, на DR
          MOV     @R3,BigSiz
          MOV     @R3,BigSiz+2
  ;......................................
@@ -529,26 +529,27 @@
  {{/code}}
--== 020: Get extended diagnostic code ==
++== **020: Получить расширенный код диагностики** ==
--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.
++Код команды 020, после сброса контроллера следует выдать эту команду в CSR и затем прочитать два слова расширенной диагностики из DR. Команда мгновенная, ожидание не требуется.
--== 027: Get firmware version AZ STM32 ==
++== **027: Получить версию firmware AZ STM32** ==
--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.
++Код команды 027, возвращает 2 слова
++\\первое слово - 06404 = старший байт 13. это версия прошивки, младший байт 4. это версия железа - те AZБК в данном случае
++второе слово - 037 = это максимальный монтируемый диск - 31.
  {{code language="assembler"}}
  ;-------------------------------------------------------------
--; getting STM32 firmware version - result in R1 R1=0 error
++; получение версии прошивки STM32 - результат в R1  R1=0 ошибка
  GTSTMV:         MOV     #AZ$CSR,R1
--1$:             CLR     (R1)            ; Send "Reset" command
--                TSTB    (R1)            ;Check controller readinessконтроллера
--                BPL     1$              ;  If not ready, reset again
++1$:             CLR     (R1)            ; Пошлем команду "Сброс"
++                TSTB    (R1)            ; Проверим готовность контроллера
++                BPL     1$              ; Если не готов, сбрасываем еще
                  mov     #27,(R1)
--                TST     (R1)+           ; Check for error
++                TST     (R1)+           ; Проверяем на ошибку
                  BMI     2$
                  mov     (R1),R1
                  return
@@ -558,45 +558,45 @@
  {{/code}}
--== 030: No operation ==
++== **030:  Нет операции** ==
--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.
++Основное назначение этой команды - устанавливать бит разрешения прерываний от контроллера. Команда передает бит разрешения прерывания, который находится с ней в одном слове, но не входит в ее состав (напоминаем, команда располагается в битах D0 - D5, а бит разрешения прерываний - D6), в соответствующий триггер контроллера и больше никак не влияет на процессы в контроллере. Управление этим триггером работает даже в состоянии "Думаю, прошу не мешать", и это главная особенность команды "нет операции".
++\\Команда имеет код 0030. Посылка в CSR кода 0130 разрешит прерывания от контроллера, посылка кода 0030 запретит их. Пример не приводится вследствие тривиальности его.
--= Command block for working with non-volatile memory =
++= **Блок команд работы с энергонезависимой памятью** =
--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.
++Интерфейс предоставляет любому AZ-контроллеру доступ к 255 словам энергонезависимой памяти, все команды устанавливают бит готовности по завершению. Это позволяет сохранять пользовательские настройки в энергонезависимой памяти, к примеру это используется в AZБК - там сохраняются настройки для более комфортной работы контроллера.
--All commands in this block use a non-volatile memory buffer for their operation.
++Все команды этого блока используют буфер энергонезависимой памяти для своей работы.
--== 021: Read non-volatile memory block into buffer ==
++== **021: Cчитать блок энергонезависимой памяти в буфер** ==
  (% class="wikigeneratedid" %)
--Command code 021, this command causes a block of non-volatile memory to be read into the non-volatile memory buffer.
++Код команды 021, данная команда вызывает чтение блока энергонезависимой памяти в буфер энергонезависимой памяти.
--== 022: Transfer the read block of non-volatile memory from the buffer to the bus ==
++== **022: Отдать на шину считанный блок энергонезависимой памяти из буфера** ==
  (% class="wikigeneratedid" %)
--Command code 022, this command ensures that the non-volatile memory buffer is transferred to the DR register for reading.
++Код команды 022, данная команда обеспечивает передачу буфера энергонезависимой памяти в регистр DR для считывания.
  (% class="wikigeneratedid" %)
--Example program
++Пример программы
  {{code language="assembler"}}
--AZ$CSR = 177220; command and status register (CSR)
--AZ$DR = 177222; data register (DR)
++AZ$CSR      = 177220; регистр команд и состояния (CSR)
++AZ$DR       = 177222; регистр данных (DR)
--; trap 50 - reset AZ
++; trap 50 - cброс AZ
  ; результат в R1  =0 ok
  AZreset:        MOV     #AZ$CSR,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,
++1$:             CLR     (R1); Пошлем команду "Сброс"
++                TSTB    (R1); Проверим готовность контроллера
++                BPL     1$; Если не готов, сбрасываем еще
++            ; раз и проверяем снова
++                TST     (R1); Проверим на ошибку,
                  BMI     0ERR$
                  CLR     R1
                  return
@@ -605,30 +605,30 @@
                  return
--; 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
++; trap 54 - чтение энергонезависимой памяти блока 1 EEPROM в буфер с адреса ADREEPROMMEM
++; результат R3 - адрес, если R3=0 ошибка
++; статус чтения в R1 0 - ok
++; 1 - размер не соответствует сохраненному
++; 2 - oшибка версии
++; 3 - oшибка контрольной суммы
  ReadEEPROM:     push    R2
--                call    AZreset; reset
++                call    AZreset; сбросим
                  tst     R1
                  bne     0ERR$
  ; теперь читаем
                  MOV     #AZ$CSR,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     #21,(R1); считать блок 1 энергонезависимой памяти в буфер
++0$:             TSTB    (R1); проверяем результат выполнения
++                BPL     0$; ждем
++                mov     #22,(R1); отдать на шину считанный блок  энергонезависимой памяти из буфера
++1$:             TSTB    (R1); проверяем результат выполнения
++                BPL     1$; ждем
++                TST     (R1)+; инкрементируем
                  mov     #ADREEPROMMEM,R3
--                mov     #256.,R2; read 256. words; first word is reading result
--2$:             mov     (R1),(R3)+; read block of words into memory
++                mov     #256.,R2; читаем 256. слов; первое слово - результат чтения
++2$:             mov     (R1),(R3)+; читаем блок слов в память
                  sob     R2,2$
--                mov     #ADREEPROMMEM,R3; successful
++                mov     #ADREEPROMMEM,R3; успешно
                  mov     (R3),R1
                  br      0END$
 ERR$:          CLR     R3
@@ -636,39 +636,41 @@
                  return
  {{/code}}
--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
++очевидно, после считывания памяти необходимо проверить код результата в первом слове - см расшифровку кодов ошибок
++\\Примеры возвращаемых данных по командам
++\\последовательная подача команды 021 и затем 022 позволит считать 256. слов
++из энергонезависимой памяти
++**Внимание! **первое слово это будет статус успешности чтения
++
  * 0 - ok
--* 1 - size does not match saved
--* 2 - version error
--* 3 - checksum error
++* 1 - размер не соответствует сохраненному
++* 2 - oшибка версии
++* 3 - oшибка контрольной суммы
--== 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
++Код команды 023, данная команда позволяет наполнить буфер энергонезависимой памяти
--== 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.
++Код команды 024, данная команда вызывает запись блока энергонезависимой памяти из буфера энергонезависимой памяти.
--Example program
++Пример программы
  {{code language="assembler"}}
--AZ$CSR = 177220; Command and Status Register (CSR)
--AZ$DR = 177222; Data Register (DR)
++AZ$CSR      = 177220; регистр команд и состояния (CSR)
++AZ$DR       = 177222; регистр данных (DR)
--; trap 50 - reset AZ
++; trap 50 - cброс AZ
  ; результат в R1  =0 ok
  AZreset:        MOV     #AZ$CSR,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,
++1$:             CLR     (R1); Пошлем команду "Сброс"
++                TSTB    (R1); Проверим готовность контроллера
++                BPL     1$; Если не готов, сбрасываем еще
++            ; раз и проверяем снова
++                TST     (R1); Проверим на ошибку,
                  BMI     0ERR$
                  CLR     R1
                  return
@@ -676,27 +676,27 @@
                  COM     R1
                  return
--; trap 55 - write non-volatile memory from the buffer at address ADREEPROMMEM в блок 1 EEPROM
++; trap 55 - запись энергонезависимой памяти из буфера с адреса ADREEPROMMEM в блок 1 EEPROM
  WriteEEPROM:    push    R1
                  push    R2
                  push    R3
--                call    AZreset; reset
++                call    AZreset; сбросим
                  tst     R1
                  bne     0ERR$
                  MOV     #AZ$CSR,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     #23,(R1); командуем что будем писать данные в буфер
++0$:             TSTB    (R1); проверяем результат выполнения
++                BPL     0$; ждем
++                TST     (R1)+; инкрементируем
                  mov     #ADREEPROMMEM+2,R3
--                mov     #255.,R2; write 255. words; skip the first word - the result of reading
--1$:             mov     (R3)+,(R1); send to the controller
++                mov     #255.,R2; пишем 255. слов; первое слово пропускаем - результат чтения
++1$:             mov     (R3)+,(R1); отдаем в контроллер
                  sob     R2,1$
--                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
++                tst     -(R1); декрементируем
++                mov     #24,(R1); записать из буфера в блок 1 энергонезависимой памяти
++2$:             TSTB    (R1); проверяем результат выполнения
++                BPL     2$; ждем
                  br      0END$
 ERR$:          CLR     R3
 END$:          pop     R3
@@ -705,21 +705,23 @@
                  return
  {{/code}}
--**Please note** that when recording, the buffer immediately comes with the data, i.e. there is no first word with the statu
++**Обращаю внимание**, при записи, буфер идет сразу с данными, те нет первого слова со статусом.
--= Block of commands for working with RTC and NTP =
++= Блок команд для работы с RTC и 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.
++В контроллере AZ®  есть 2 источника получения даты-времени, первый это RTC встроенный в STM32, второй это часы в стеке TCP/IP.  Часы RTC работают автономно при наличии установленной батарейки 2032. Часы в стеке TCP/IP устанавливаются на основании данных с NTP-сервера.
--== Buffer format timestamp (readable) ==
++== Формат буфера timestamp (доступен по чтению) ==
--The controller API immediately prepares time in several formats, so that it can be conveniently used on the PDP-11 side
++API контроллера сразу готовит время в нескольких форматах, дабы его было удобно применить на стороне PDP-11
  {{info}}
--datetime buffer format octal offset - those words datetime buffer format
++формат буфера даты-времени
++offset в восьмеричной системе - те слова
++формат буфера даты-времени
  \\[0]=rtc_rt11date();
  [2]=rt11 time 50Hz big word;
  [4]=rt11 time 50Hz little word;
@@ -737,72 +737,72 @@
  {{/info}}
--== SimpleIN buffer format (when writing) ==
++== Формат буфера SimpleIN (при записи) ==
--the format is simplified as much as possible, for work with PDP-11
++формат максимально упрощен, для работы со стороны PDP-11
  {{info}}
--offset in octal - those words
++offset в восьмеричной системе - те слова
--[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
++[0]=year       год, младшие две цифры - те 22 а не 2022(!)
++[2]=month;     месяц
++[4]=day;       день
++[6]=wday;      день недели =0 не установлен, 1- понедельник 2 - вторник итд
++[10]=hour;     час
++[12]=min;      минута
++[14]=sec;      секунда
  {{/info}}
--== 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
++Код команды 031, данная команда использует RTC часы как источник заполнения буфера timestamp
--Example program:
++Пример программы:
  {{code language="assembler"}}
--; 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
++; trap 61 - чтение данных часов из автономных часов RTC
++; R3 - адрес буфера куда надо считать
++; результат в R3 адрес, если успешно. R3=0  если ошибка
  GetDateFromRTC: push    R0
                  push    R1
                  push    R2
--                call    AZreset;  reset
++                call    AZreset; сбросим
                  tst     R1
                  bne     G60ERR
                  MOV     #AZ$CSR,R1
                  mov     #31,(R1)
--                br      G60; let's go there because further code is the same
++                br      G60; идем туда тк дальше код одинаковый
  {{/code}}
--== 032: Get time from timestamp buffer ==
++== **032:  Получить время из буфера timestamp** ==
--Command code 032, this command sends the contents of the timestamp buffer to the bus
++Код команды 032, данная команда отдает на шину содержимое буфера timestamp
  {{code language="assembler"}}
--; 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
++; работа с часами
++; trap 60 - чтение данных часов из TCP/IP стека
++; R3 - адрес буфера куда надо считать
++; результат в R3 адрес, если успешно. R3=0  если ошибка
  GetDateFromLAN: push    R0
                  push    R1
                  push    R2
--                call    AZreset; reset
++                call    AZreset; сбросим
                  tst     R1
                  bne     G60ERR
                  MOV     #AZ$CSR,R1
                  mov     #42,(R1)
--G60:            TSTB    (R1); check execution result
--                BPL     G60; wait
++G60:            TSTB    (R1); проверяем результат выполнения
++                BPL     G60; ждем
                  mov     #32,(R1)
--1$:             TSTB    (R1); check execution result
++1$:             TSTB    (R1); проверяем результат выполнения
                  BPL     1$; ждем
--                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
++                TST     (R1)+; инкрементируем
++                mov     R3,R0; запомним R3 - адрес
++                mov     #10.,R2; читаем 10 слов
++2$:             mov     (R1),(R3)+; читаем блок слов в память
                  sob     R2,2$
--                mov     R0,R3; successful, return address to R3
++                mov     R0,R3; успешно, вернем адрес в R3
                  br      0END$
  G60ERR:         CLR     R3
 END$:          pop     R2
@@ -811,11 +811,11 @@
                  return
  {{/code}}
--It is worth checking the correctness of the received time:
++Стоит проверить корректность полученного времени:
  {{code language="assembler"}}
--; trap 63 - check time correctness
--; R3 - buffer address, result in R3, if buffer address then OK, =0 error
++; trap 63 - проверка корректности времени
++; R3 - адрес буфера, результат в R3, если адрес буфера то OK, =0 ошибка
  CheckDateTime:  Cmp     6(r3),#2021.
                  Blos    1err
                  Cmp     6(r3),#2100.
@@ -825,119 +825,119 @@
                  return
  {{/code}}
--== 033: Write time-date to SimpleIN buffer ==
++== **033:  Запись времени-даты в буфер SimpleIN** ==
--Command code 033, this command receives data from the bus into the SimpleIN buffer
++Код команды 033, данная команда  принимает с шины данные в буфер SimpleIN
--The operation of this command is similar to the operation of commands 023 and 016.
++Работа данной команды аналогична работе команд [[023>>doc:||anchor="H023:41F44043843D44F44244C44144843843D44B43243144344443544043443043D43D44B43543443B44F43F43E44143B43543444344E44943543943743043F438441438432431443444435440"]] и [[016>>doc:||anchor="H016:A041F44043843D44F44244C43143B43E43A43443043D43D44B445432431443444435440"]].
--== 034: Set RTC based on buffer data ==
++== **034:  Установка RTC на основании данных из буфера** ==
--Command code 034, this command sets the RTC based on the data in the SimpleIN buffer
++Код команды 034, данная команда  устанавливает RTC на основании данных в буфере SimpleIN
--This command executes quickly, but to avoid problems, a wait loop is recommended.
++Данная команда выполняется быстро, но для исключения проблем цикл ожидания выполнения рекомендуется.
--== 035: Stimulate time request from NTP server, set based on response ==
++== **035:  Стимуляция запроса времени с NTP сервера, установка на основании ответа** ==
--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.
++Код команды 035, данная команда отправляет запрос на NTP cервер (установленный в AZ.INI файле или полученный от DHCP) и устанавливает часы в стеке TCP/IP.
--Example program: sending a request to set the time from an NTP server
++Пример программы: отсылка запроса на установку времени с NTP сервера
  {{code language="assembler"}}
--; trap 62 - sending a request to set the time from the NTP server
++; trap 62 - отсылка запроса на установку времени с NTP сервера
  GetDateNTPtoNET:push    R1
--                call    AZreset; reset
++                call    AZreset; сбросим
                  tst     R1
                  bne     0ERR$
                  MOV     #AZ$CSR,R1
                  mov     #35,(R1)
--0$:             TSTB    (R1); check the result of execution
--                BPL     0$; wait
++0$:             TSTB    (R1); проверяем результат выполнения
++                BPL     0$; ждем
 ERR$:          pop     R1
                  return
  {{/code}}
--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.
++Выполнение команды занимает 1-2 секунды в среднем. Данная команда требует работы стека TCP/IP, соответственно нужны циклы ожидания при включенном стеке.
--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; 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     #20,R4; количество циклов ожидания
++$datry:         trap    62; отослали запрос к NTP серверу
++                mov     #110,@#AZ$CSR; включим сеть
++                trap    47; ожидание
++                trap    47; ожидание
                  mov     #ADRTMPSTR,R3
--                trap    60; read the date-time into the buffer
--                trap    63; checked the date-time
++                trap    60; считали в буфер дату-время
++                trap    63; проверили дату-время
                  tst     R3
                  bne     $ok
  $sob:           sob     R4,$datry
--                mov     #S_DateTime_2,R3; print error
++                mov     #S_DateTime_2,R3; печать ошибки
                  trap    7
                  br      $go
  $ok:            mov     #ADRTMPSTR,R3
--                trap    24; print date
--                trap    25; time
--$go:            mov     #110,@#AZ$CSR;  let's turn on the network
++                trap    24; печать даты
++                trap    25; времени
++$go:            mov     #110,@#AZ$CSR; включим сеть
  {{/code}}
--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.
++Тут мы явно отсылаем запрос к NTP серверу, затем включаем работу сети и ждем результата, периодически опрашивая и проверяя корректность результата.
--== 036: Setting RTC based on TCP/IP stack clock ==
++== **036:  Установка RTC на основании часов TCP/IP стека** ==
--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.
++Код команды 036,  данная команда устанавливает RTC на основании часов в TCP/IP стека. Предварительно надо установить часы в TCP/IP - команда 036.
--Example program:
++Пример программы:
  {{code language="assembler"}}
--; trap 64 - set RTC time based on stack time
--; R1 - result R1=0 - OK
--SetDateNETtoRTC:call    AZreset; reset
++; trap 64 - установка времени RTC на основании времени стека
++; R1 - результат  R1=0 - OK
++SetDateNETtoRTC:call    AZreset; сбросим
                  tst     R1
                  bne     0ERR$
                  MOV     #AZ$CSR,R1
                  mov     #36,(R1)
--0$:             TSTB    (R1); check execution result
--                BPL     0$; wait
++0$:             TSTB    (R1); проверяем результат выполнения
++                BPL     0$; ждем
                  clr     R1
 ERR$:          return
  {{/code}}
--== 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.
++Код команды 042,   данная команда использует часы TCP/IP стека как источник заполнения буфера timestamp.
--Example program:
++Пример программы:
  {{code language="assembler"}}
--; 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
++; работа с часами
++; trap 60 - чтение данных часов из TCP/IP стека
++; R3 - адрес буфера куда надо считать
++; результат в R3 адрес, если успешно. R3=0  если ошибка
  GetDateFromLAN: push    R0
                  push    R1
                  push    R2
--                call    AZreset; reset
++                call    AZreset; сбросим
                  tst     R1
                  bne     G60ERR
                  MOV     #AZ$CSR,R1
                  mov     #42,(R1)
--G60:            TSTB    (R1); check execution result
--                BPL     G60; wait
++G60:            TSTB    (R1); проверяем результат выполнения
++                BPL     G60; ждем
                  mov     #32,(R1)
--1$:             TSTB    (R1); check execution result
--                BPL     1$; wait
--                TST     (R1)+;  increment
--                mov     R3,R0; remember R3 address
++1$:             TSTB    (R1); проверяем результат выполнения
++                BPL     1$; ждем
++                TST     (R1)+; инкрементируем
++                mov     R3,R0; запомним R3 - адрес
                  mov     #10.,R2; читаем 10 слов
--2$:             mov     (R1),(R3)+; read block of words into memory
++2$:             mov     (R1),(R3)+; читаем блок слов в память
                  sob     R2,2$
--                mov     R0,R3; successful, return address to R3
++                mov     R0,R3; успешно, вернем адрес в R3
                  br      0END$
  G60ERR:         CLR     R3
 END$:          pop     R2
@@ -946,28 +946,28 @@
                  return
  {{/code}}
--All commands set the ready bit upon completion.
++все команды устанавливают бит готовности по завершению.
--= **[[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] **specific commands =
++= **Команды специфические для [[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]]** =
--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БК®, разработанного для серии компьютеров БК - БК-0010/БК-0010.01/БК-0011М.
--Other AZ® controllers ignore these commands.
++Другие контроллеры AZ® игнорируют эти команды
--== 037: Restart of the** [[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] **controller and the entire computer ==
++== **037: перезапуск контроллера [[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] и всей БК** ==
--Command code 037, this command restarts the AZ® microcontroller, which also causes a restart of the BK-0010/BK-0010.01/BK-0011M itself
++Код команды 037,  данная команда осуществляет перезапуск микроконтроллера AZ®, что вызывает и перезапуск самой БК-0010/БК-0010.01/БК-0011М
--Example program
++Пример программы
  {{code language="assembler"}}
--AZ$CSR = 177220; command and status register (CSR)
--AZ$DR = 177222; data register (DR)
++AZ$CSR      = 177220; регистр команд и состояния (CSR)
++AZ$DR       = 177222; регистр данных (DR)
--; trap 57 - full restart
--AZcouldReboot:  call    AZreset; reset AZ so it is ready to receive
++; trap 57 - перезапуск БК полный
++AZcouldReboot:  call    AZreset; сбросим AZ дабы он был готов принимать команды
                  mov     #037,@#AZ$CSR
                  return
  {{/code}}

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

Summary

Details

Applications

Navigation

Need help?