Skip to Content
Last modified by Max on 2025/03/02 15:18
From version 2.35
edited by Max
on 2025/02/25 14:21
Change comment: (Autosaved)
To version 2.48
edited by Max
on 2025/02/25 15:16
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -568,35 +568,35 @@
568 568  
569 569  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.
570 570  
571 -Все команды этого блока используют буфер энергонезависимой памяти для своей работы.
571 +All commands in this block use a non-volatile memory buffer for their operation.
572 572  
573 573  == 021: Read non-volatile memory block into buffer ==
574 574  
575 575  (% class="wikigeneratedid" %)
576 -Код команды 021, данная команда вызывает чтение блока энергонезависимой памяти в буфер энергонезависимой памяти.
576 +Command code 021, this command causes a block of non-volatile memory to be read into the non-volatile memory buffer.
577 577  
578 578  
579 579  == 022: Transfer the read block of non-volatile memory from the buffer to the bus ==
580 580  
581 581  (% class="wikigeneratedid" %)
582 -Код команды 022, данная команда обеспечивает передачу буфера энергонезависимой памяти в регистр DR для считывания.
582 +Command code 022, this command ensures that the non-volatile memory buffer is transferred to the DR register for reading.
583 583  
584 584  (% class="wikigeneratedid" %)
585 -Пример программы
585 +Example program
586 586  
587 587  {{code language="assembler"}}
588 -AZ$CSR = 177220; регистр команд и состояния (CSR)
589 -AZ$DR = 177222; регистр данных (DR)
588 +AZ$CSR = 177220; command and status register (CSR)
589 +AZ$DR = 177222; data register (DR)
590 590  
591 591  
592 -; trap 50 - cброс AZ
592 +; trap 50 - reset AZ
593 593  ; результат в R1 =0 ok
594 594  AZreset: MOV #AZ$CSR,R1
595 -1$: CLR (R1); Пошлем команду "Сброс"
596 - TSTB (R1); Проверим готовность контроллера
597 - BPL 1$; Если не готов, сбрасываем еще
598 - ; раз и проверяем снова
599 - TST (R1); Проверим на ошибку,
595 +1$: CLR (R1); Send the "Reset" command
596 + TSTB (R1); Check the controller readiness
597 + BPL 1$; If not ready, reset again
598 +; once and check again
599 + TST (R1); Check for an error,
600 600   BMI 0ERR$
601 601   CLR R1
602 602   return
... ... @@ -605,30 +605,30 @@
605 605   return
606 606  
607 607  
608 -; trap 54 - чтение энергонезависимой памяти блока 1 EEPROM в буфер с адреса ADREEPROMMEM
609 -; результат R3 - адрес, если R3=0 ошибка
610 -; статус чтения в R1 0 - ok
611 -; 1 - размер не соответствует сохраненному
612 -; 2 - oшибка версии
613 -; 3 - oшибка контрольной суммы
608 +; trap 54 - reading non-volatile memory of block 1 EEPROM to the buffer from the address ADREEPROMMEM
609 +; result R3 - address, if R3=0 error
610 +; read status in R1 0 - ok
611 +; 1 - size does not match saved
612 +; 2 - version error
613 +; 3 - checksum error
614 614  ReadEEPROM: push R2
615 - call AZreset; сбросим
615 + call AZreset; reset
616 616   tst R1
617 617   bne 0ERR$
618 618  ; теперь читаем
619 619   MOV #AZ$CSR,R1
620 - mov #21,(R1); считать блок 1 энергонезависимой памяти в буфер
621 -0$: TSTB (R1); проверяем результат выполнения
622 - BPL 0$; ждем
623 - mov #22,(R1); отдать на шину считанный блок энергонезависимой памяти из буфера
624 -1$: TSTB (R1); проверяем результат выполнения
625 - BPL 1$; ждем
626 - TST (R1)+; инкрементируем
620 + mov #21,(R1); read block 1 of non-volatile memory into buffer
621 +0$: TSTB (R1); check execution result
622 + BPL 0$; wait
623 + mov #22,(R1); send read block of non-volatile memory from buffer to bus
624 +1$: TSTB (R1); check execution result
625 + BPL 1$; wait
626 + TST (R1)+; increment
627 627   mov #ADREEPROMMEM,R3
628 - mov #256.,R2; читаем 256. слов; первое слово - результат чтения
629 -2$: mov (R1),(R3)+; читаем блок слов в память
628 + mov #256.,R2; read 256. words; first word is reading result
629 +2$: mov (R1),(R3)+; read block of words into memory
630 630   sob R2,2$
631 - mov #ADREEPROMMEM,R3; успешно
631 + mov #ADREEPROMMEM,R3; successful
632 632   mov (R3),R1
633 633   br 0END$
634 634  0ERR$: CLR R3
... ... @@ -636,41 +636,39 @@
636 636   return
637 637  {{/code}}
638 638  
639 -очевидно, после считывания памяти необходимо проверить код результата в первом слове - см расшифровку кодов ошибок
640 -\\Примеры возвращаемых данных по командам
641 -\\последовательная подача команды 021 и затем 022 позволит считать 256. слов
642 -из энергонезависимой памяти
643 -**Внимание! **первое слово это будет статус успешности чтения
644 -
639 +obviously, after reading the memory, it is necessary to check the result code in the first word - see the decoding of error codes
640 +\\Examples of returned data for commands
641 +\\sequentially issuing the command 021 and then 022 will allow reading 256 words from non-volatile memory
642 +Attention! The first word will be the reading success status
645 645  
646 646  * 0 - ok
647 -* 1 - размер не соответствует сохраненному
648 -* 2 - oшибка версии
649 -* 3 - oшибка контрольной суммы
645 +* 1 - size does not match saved
646 +* 2 - version error
647 +* 3 - checksum error
650 650  
651 -== **023: Принять с шины в буфер данные для последующей записи в буфер** ==
649 +== 023: Receive data from the bus into the buffer for subsequent writing into the buffer ==
652 652  
653 -Код команды 023, данная команда позволяет наполнить буфер энергонезависимой памяти
651 +Command code 023, this command allows you to fill the non-volatile memory buffer
654 654  
655 -== **024: Записать из буфера в блок энергонезависимой памяти** ==
653 +== 024: Write from buffer to non-volatile memory block ==
656 656  
657 -Код команды 024, данная команда вызывает запись блока энергонезависимой памяти из буфера энергонезависимой памяти.
655 +Command code 024, this command causes a non-volatile memory block to be written from the non-volatile memory buffer.
658 658  
659 -Пример программы
657 +Example program
660 660  
661 661  {{code language="assembler"}}
662 -AZ$CSR = 177220; регистр команд и состояния (CSR)
663 -AZ$DR = 177222; регистр данных (DR)
660 +AZ$CSR = 177220; Command and Status Register (CSR)
661 +AZ$DR = 177222; Data Register (DR)
664 664  
665 665  
666 -; trap 50 - cброс AZ
664 +; trap 50 - reset AZ
667 667  ; результат в R1 =0 ok
668 668  AZreset: MOV #AZ$CSR,R1
669 -1$: CLR (R1); Пошлем команду "Сброс"
670 - TSTB (R1); Проверим готовность контроллера
671 - BPL 1$; Если не готов, сбрасываем еще
672 - ; раз и проверяем снова
673 - TST (R1); Проверим на ошибку,
667 +1$: CLR (R1); Send the "Reset" command
668 + TSTB (R1); Check the controller readiness
669 + BPL 1$; If not ready, reset again
670 +; once and check again
671 + TST (R1); Check for an error,
674 674   BMI 0ERR$
675 675   CLR R1
676 676   return
... ... @@ -678,27 +678,27 @@
678 678   COM R1
679 679   return
680 680  
681 -; trap 55 - запись энергонезависимой памяти из буфера с адреса ADREEPROMMEM в блок 1 EEPROM
679 +; trap 55 - write non-volatile memory from the buffer at address ADREEPROMMEM в блок 1 EEPROM
682 682  WriteEEPROM: push R1
683 683   push R2
684 684   push R3
685 - call AZreset; сбросим
683 + call AZreset; reset
686 686   tst R1
687 687   bne 0ERR$
688 688  
689 689   MOV #AZ$CSR,R1
690 - mov #23,(R1); командуем что будем писать данные в буфер
691 -0$: TSTB (R1); проверяем результат выполнения
692 - BPL 0$; ждем
693 - TST (R1)+; инкрементируем
688 + mov #23,(R1);command that we will write data to the buffer
689 +0$: TSTB (R1); check the result of executio
690 + BPL 0$; wait
691 + TST (R1)+; increment
694 694   mov #ADREEPROMMEM+2,R3
695 - mov #255.,R2; пишем 255. слов; первое слово пропускаем - результат чтения
696 -1$: mov (R3)+,(R1); отдаем в контроллер
693 + mov #255.,R2; write 255. words; skip the first word - the result of reading
694 +1$: mov (R3)+,(R1); send to the controller
697 697   sob R2,1$
698 - tst -(R1); декрементируем
699 - mov #24,(R1); записать из буфера в блок 1 энергонезависимой памяти
700 -2$: TSTB (R1); проверяем результат выполнения
701 - BPL 2$; ждем
696 + tst -(R1); decrement
697 + mov #24,(R1); write from the buffer to block 1 of non-volatile memory
698 +2$: TSTB (R1); check the result of execution
699 + BPL 2$; we are waiting
702 702   br 0END$
703 703  0ERR$: CLR R3
704 704  0END$: pop R3
... ... @@ -707,23 +707,21 @@
707 707   return
708 708  {{/code}}
709 709  
710 -**Обращаю внимание**, при записи, буфер идет сразу с данными, те нет первого слова со статусом.
708 +**Please note** that when recording, the buffer immediately comes with the data, i.e. there is no first word with the statu
711 711  
712 712  
713 713  
714 -= Блок команд для работы с RTC и NTP =
712 += Block of commands for working with RTC and NTP =
715 715  
716 -В контроллере AZ®  есть 2 источника получения даты-времени, первый это RTC встроенный в STM32, второй это часы в стеке TCP/IP.  Часы RTC работают автономно при наличии установленной батарейки 2032. Часы в стеке TCP/IP устанавливаются на основании данных с NTP-сервера.
714 +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.
717 717  
718 718  
719 -== Формат буфера timestamp (доступен по чтению) ==
717 +== Buffer format timestamp (readable) ==
720 720  
721 -API контроллера сразу готовит время в нескольких форматах, дабы его было удобно применить на стороне PDP-11
719 +The controller API immediately prepares time in several formats, so that it can be conveniently used on the PDP-11 side
722 722  
723 723  {{info}}
724 -формат буфера даты-времени
725 -offset в восьмеричной системе - те слова
726 -формат буфера даты-времени
722 +datetime buffer format octal offset - those words datetime buffer format
727 727  \\[0]=rtc_rt11date();
728 728  [2]=rt11 time 50Hz big word;
729 729  [4]=rt11 time 50Hz little word;
... ... @@ -741,72 +741,72 @@
741 741  {{/info}}
742 742  
743 743  
744 -== Формат буфера SimpleIN (при записи) ==
740 +== SimpleIN buffer format (when writing) ==
745 745  
746 -формат максимально упрощен, для работы со стороны PDP-11
742 +the format is simplified as much as possible, for work with PDP-11
747 747  
748 748  {{info}}
749 -offset в восьмеричной системе - те слова
745 +offset in octal - those words
750 750  
751 -[0]=year       год, младшие две цифры - те 22 а не 2022(!)
752 -[2]=month;     месяц
753 -[4]=day;       день
754 -[6]=wday;      день недели =0 не установлен, 1- понедельник 2 - вторник итд
755 -[10]=hour;     час
756 -[12]=min;      минута
757 -[14]=sec;      секунда
747 +[0]=year, the lower two digits are 22 and not 2022(!)
748 +[2]=month; month
749 +[4]=day; day
750 +[6]=wday; day of the week =0 not set, 1 - Monday 2 - Tuesday etc.
751 +[10]=hour; hour
752 +[12]=min; minute
753 +[14]=sec; second
758 758  {{/info}}
759 759  
760 760  
761 -== **031:  Получить время из RTC в буфер timestamp** ==
757 +== 031: Get time from RTC to timestamp buffer ==
762 762  
763 -Код команды 031, данная команда использует RTC часы как источник заполнения буфера timestamp
759 +Command code 031, this command uses RTC clock as a source of filling the timestamp buffer
764 764  
765 -Пример программы:
761 +Example program:
766 766  
767 767  {{code language="assembler"}}
768 -; trap 61 - чтение данных часов из автономных часов RTC
769 -; R3 - адрес буфера куда надо считать
770 -; результат в R3 адрес, если успешно. R3=0 если ошибка
764 +; trap 61 - reading clock data from autonomous RTC clock
765 +; R3 - buffer address where to read
766 +; result in R3 address if successful. R3=0 if error
771 771  GetDateFromRTC: push R0
772 772   push R1
773 773   push R2
774 - call AZreset; сбросим
770 + call AZreset; reset
775 775   tst R1
776 776   bne G60ERR
777 777   MOV #AZ$CSR,R1
778 778   mov #31,(R1)
779 - br G60; идем туда тк дальше код одинаковый
775 + br G60; let's go there because further code is the same
780 780  {{/code}}
781 781  
782 -== **032:  Получить время из буфера timestamp** ==
778 +== 032: Get time from timestamp buffer ==
783 783  
784 -Код команды 032, данная команда отдает на шину содержимое буфера timestamp
780 +Command code 032, this command sends the contents of the timestamp buffer to the bus
785 785  
786 786  {{code language="assembler"}}
787 -; работа с часами
788 -; trap 60 - чтение данных часов из TCP/IP стека
789 -; R3 - адрес буфера куда надо считать
790 -; результат в R3 адрес, если успешно. R3=0 если ошибка
783 +; working with clock
784 +; trap 60 - reading clock data from TCP/IP stack
785 +; R3 - buffer address where to read
786 +; result in R3 address if successful. R3=0 if error
791 791  GetDateFromLAN: push R0
792 792   push R1
793 793   push R2
794 - call AZreset; сбросим
790 + call AZreset; reset
795 795   tst R1
796 796   bne G60ERR
797 797   MOV #AZ$CSR,R1
798 798   mov #42,(R1)
799 -G60: TSTB (R1); проверяем результат выполнения
800 - BPL G60; ждем
795 +G60: TSTB (R1); check execution result
796 + BPL G60; wait
801 801   mov #32,(R1)
802 -1$: TSTB (R1); проверяем результат выполнения
798 +1$: TSTB (R1); check execution result
803 803   BPL 1$; ждем
804 - TST (R1)+; инкрементируем
805 - mov R3,R0; запомним R3 - адрес
806 - mov #10.,R2; читаем 10 слов
807 -2$: mov (R1),(R3)+; читаем блок слов в память
800 + TST (R1)+; increment
801 + mov R3,R0; remember R3 address
802 + mov #10.,R2; read 10 words
803 +2$: mov (R1),(R3)+; read block of words into memory
808 808   sob R2,2$
809 - mov R0,R3; успешно, вернем адрес в R3
805 + mov R0,R3; successful, return address to R3
810 810   br 0END$
811 811  G60ERR: CLR R3
812 812  0END$: pop R2
... ... @@ -815,11 +815,11 @@
815 815   return
816 816  {{/code}}
817 817  
818 -Стоит проверить корректность полученного времени:
814 +It is worth checking the correctness of the received time:
819 819  
820 820  {{code language="assembler"}}
821 -; trap 63 - проверка корректности времени
822 -; R3 - адрес буфера, результат в R3, если адрес буфера то OK, =0 ошибка
817 +; trap 63 - check time correctness
818 +; R3 - buffer address, result in R3, if buffer address then OK, =0 error
823 823  CheckDateTime: Cmp 6(r3),#2021.
824 824   Blos 1err
825 825   Cmp 6(r3),#2100.
... ... @@ -829,41 +829,41 @@
829 829   return
830 830  {{/code}}
831 831  
832 -== **033:  Запись времени-даты в буфер SimpleIN** ==
828 +== 033: Write time-date to SimpleIN buffer ==
833 833  
834 -Код команды 033, данная команда  принимает с шины данные в буфер SimpleIN
830 +Command code 033, this command receives data from the bus into the SimpleIN buffer
835 835  
836 -Работа данной команды аналогична работе команд [[023>>doc:||anchor="H023:41F44043843D44F44244C44144843843D44B43243144344443544043443043D43D44B43543443B44F43F43E44143B43543444344E44943543943743043F438441438432431443444435440"]] и [[016>>doc:||anchor="H016:A041F44043843D44F44244C43143B43E43A43443043D43D44B445432431443444435440"]].
832 +The operation of this command is similar to the operation of commands 023 and 016.
837 837  
838 -== **034:  Установка RTC на основании данных из буфера** ==
834 +== 034: Set RTC based on buffer data ==
839 839  
840 -Код команды 034, данная команда  устанавливает RTC на основании данных в буфере SimpleIN
836 +Command code 034, this command sets the RTC based on the data in the SimpleIN buffer
841 841  
842 -Данная команда выполняется быстро, но для исключения проблем цикл ожидания выполнения рекомендуется.
838 +This command executes quickly, but to avoid problems, a wait loop is recommended.
843 843  
844 -== **035:  Стимуляция запроса времени с NTP сервера, установка на основании ответа** ==
840 +== 035: Stimulate time request from NTP server, set based on response ==
845 845  
846 -Код команды 035, данная команда отправляет запрос на NTP cервер (установленный в AZ.INI файле или полученный от DHCP) и устанавливает часы в стеке TCP/IP.
842 +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.
847 847  
848 -Пример программы: отсылка запроса на установку времени с NTP сервера
844 +Example program: sending a request to set the time from an NTP server
849 849  
850 850  {{code language="assembler"}}
851 -; trap 62 - отсылка запроса на установку времени с NTP сервера
847 +; trap 62 - sending a request to set the time from the NTP server
852 852  GetDateNTPtoNET:push R1
853 - call AZreset; сбросим
849 + call AZreset; reset
854 854   tst R1
855 855   bne 0ERR$
856 856   MOV #AZ$CSR,R1
857 857   mov #35,(R1)
858 -0$: TSTB (R1); проверяем результат выполнения
859 - BPL 0$; ждем
854 +0$: TSTB (R1); check the result of execution
855 + BPL 0$; wait
860 860  0ERR$: pop R1
861 861   return
862 862  {{/code}}
863 863  
864 -Выполнение команды занимает 1-2 секунды в среднем. Данная команда требует работы стека TCP/IP, соответственно нужны циклы ожидания при включенном стеке.
860 +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.
865 865  
866 -Пример цикла опроса с целью получить время с сети
862 +An example of a polling cycle to get time from the network
867 867  
868 868  {{code language="assembler"}}
869 869  ; дата-время