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

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

From 2.27 to 2.28 From 2.66 to 2.67

From version 2.28

edited by Max
on 2025/02/25 13:58

Change comment: There is no comment for this version

To version 2.66

edited by Max
on 2025/02/25 16:32

Change comment: (Autosaved)

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -505,24 +505,24 @@
  ;..................................
  {{/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
  ;......................................
@@ -529,27 +529,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
@@ -559,45 +559,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
@@ -606,30 +606,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
@@ -637,41 +637,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
@@ -679,27 +679,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
@@ -708,23 +708,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;
@@ -742,72 +742,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
@@ -816,11 +816,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.
@@ -830,119 +830,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
@@ -951,52 +951,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;            //
@@ -1014,57 +1014,56 @@
      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
@@ -1071,7 +1071,7 @@
 $:             mov     R3,(R4)+
                  sob     R2,2$
--         ;конфигурация памяти - дефолтная
++         ; memory configuration - default
                  mov     #SCR_MEM_CONF,R4
                  mov     #30,(R4)+            ;177300
                  mov     #31,(R4)+            ;177302
@@ -1090,29 +1090,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
@@ -1119,32 +1119,31 @@
 $:             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"}}
  ; обновим информацию в хидере скриншота

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

Summary

Details

Applications

Navigation

Need help?