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

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

From 2.37 to 2.38 From 2.66 to 2.67

From version 2.38

edited by Max
on 2025/02/25 14:31

Change comment: (Autosaved)

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

@@ -579,24 +579,24 @@
  == 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
@@ -605,30 +605,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
@@ -636,41 +636,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
@@ -678,27 +678,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
@@ -707,23 +707,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;
@@ -741,72 +741,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
@@ -815,11 +815,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.
@@ -829,119 +829,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
@@ -950,52 +950,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;            //
@@ -1013,57 +1013,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
@@ -1070,7 +1070,7 @@
 $:             mov     R3,(R4)+
                  sob     R2,2$
--         ;конфигурация памяти - дефолтная
++         ; memory configuration - default
                  mov     #SCR_MEM_CONF,R4
                  mov     #30,(R4)+            ;177300
                  mov     #31,(R4)+            ;177302
@@ -1089,29 +1089,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
@@ -1118,32 +1118,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?