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

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

From 2.34 to 2.35 From 2.47 to 2.48

From version 2.35

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

Change comment: (Autosaved)

To version 2.47

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

Change comment: (Autosaved)

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -568,35 +568,35 @@
  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: 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: 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,47 +741,47 @@
  {{/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"}}
  ; работа с часами

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

Summary

Details

Applications

Navigation

Need help?