Skip to Content
Last modified by Max on 2025/03/02 15:18
From version 2.77
edited by Max
on 2025/02/25 17:22
Change comment: (Autosaved)
To version 2.47
edited by Max
on 2025/02/25 15:12
Change comment: (Autosaved)

Summary

Details

Page properties
Content
... ... @@ -780,29 +780,29 @@
780 780  Command code 032, this command sends the contents of the timestamp buffer to the bus
781 781  
782 782  {{code language="assembler"}}
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
783 +; работа с часами
784 +; trap 60 - чтение данных часов из TCP/IP стека
785 +; R3 - адрес буфера куда надо считать
786 +; результат в R3 адрес, если успешно. R3=0 если ошибка
787 787  GetDateFromLAN: push R0
788 788   push R1
789 789   push R2
790 - call AZreset; reset
790 + call AZreset; сбросим
791 791   tst R1
792 792   bne G60ERR
793 793   MOV #AZ$CSR,R1
794 794   mov #42,(R1)
795 -G60: TSTB (R1); check execution result
796 - BPL G60; wait
795 +G60: TSTB (R1); проверяем результат выполнения
796 + BPL G60; ждем
797 797   mov #32,(R1)
798 -1$: TSTB (R1); check execution result
798 +1$: TSTB (R1); проверяем результат выполнения
799 799   BPL 1$; ждем
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
800 + TST (R1)+; инкрементируем
801 + mov R3,R0; запомним R3 - адрес
802 + mov #10.,R2; читаем 10 слов
803 +2$: mov (R1),(R3)+; читаем блок слов в память
804 804   sob R2,2$
805 - mov R0,R3; successful, return address to R3
805 + mov R0,R3; успешно, вернем адрес в R3
806 806   br 0END$
807 807  G60ERR: CLR R3
808 808  0END$: pop R2
... ... @@ -811,11 +811,11 @@
811 811   return
812 812  {{/code}}
813 813  
814 -It is worth checking the correctness of the received time:
814 +Стоит проверить корректность полученного времени:
815 815  
816 816  {{code language="assembler"}}
817 -; trap 63 - check time correctness
818 -; R3 - buffer address, result in R3, if buffer address then OK, =0 error
817 +; trap 63 - проверка корректности времени
818 +; R3 - адрес буфера, результат в R3, если адрес буфера то OK, =0 ошибка
819 819  CheckDateTime: Cmp 6(r3),#2021.
820 820   Blos 1err
821 821   Cmp 6(r3),#2100.
... ... @@ -825,119 +825,119 @@
825 825   return
826 826  {{/code}}
827 827  
828 -== 033: Write time-date to SimpleIN buffer ==
828 +== **033:  Запись времени-даты в буфер SimpleIN** ==
829 829  
830 -Command code 033, this command receives data from the bus into the SimpleIN buffer
830 +Код команды 033, данная команда  принимает с шины данные в буфер SimpleIN
831 831  
832 -The operation of this command is similar to the operation of commands 023 and 016.
832 +Работа данной команды аналогична работе команд [[023>>doc:||anchor="H023:41F44043843D44F44244C44144843843D44B43243144344443544043443043D43D44B43543443B44F43F43E44143B43543444344E44943543943743043F438441438432431443444435440"]] и [[016>>doc:||anchor="H016:A041F44043843D44F44244C43143B43E43A43443043D43D44B445432431443444435440"]].
833 833  
834 -== 034: Set RTC based on buffer data ==
834 +== **034:  Установка RTC на основании данных из буфера** ==
835 835  
836 -Command code 034, this command sets the RTC based on the data in the SimpleIN buffer
836 +Код команды 034, данная команда  устанавливает RTC на основании данных в буфере SimpleIN
837 837  
838 -This command executes quickly, but to avoid problems, a wait loop is recommended.
838 +Данная команда выполняется быстро, но для исключения проблем цикл ожидания выполнения рекомендуется.
839 839  
840 -== 035: Stimulate time request from NTP server, set based on response ==
840 +== **035:  Стимуляция запроса времени с NTP сервера, установка на основании ответа** ==
841 841  
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.
842 +Код команды 035, данная команда отправляет запрос на NTP cервер (установленный в AZ.INI файле или полученный от DHCP) и устанавливает часы в стеке TCP/IP.
843 843  
844 -Example program: sending a request to set the time from an NTP server
844 +Пример программы: отсылка запроса на установку времени с NTP сервера
845 845  
846 846  {{code language="assembler"}}
847 -; trap 62 - sending a request to set the time from the NTP server
847 +; trap 62 - отсылка запроса на установку времени с NTP сервера
848 848  GetDateNTPtoNET:push R1
849 - call AZreset; reset
849 + call AZreset; сбросим
850 850   tst R1
851 851   bne 0ERR$
852 852   MOV #AZ$CSR,R1
853 853   mov #35,(R1)
854 -0$: TSTB (R1); check the result of execution
855 - BPL 0$; wait
854 +0$: TSTB (R1); проверяем результат выполнения
855 + BPL 0$; ждем
856 856  0ERR$: pop R1
857 857   return
858 858  {{/code}}
859 859  
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.
860 +Выполнение команды занимает 1-2 секунды в среднем. Данная команда требует работы стека TCP/IP, соответственно нужны циклы ожидания при включенном стеке.
861 861  
862 -An example of a polling cycle to get time from the network
862 +Пример цикла опроса с целью получить время с сети
863 863  
864 864  {{code language="assembler"}}
865 -; date-time
865 +; дата-время
866 866   mov #S_DateTime_0,R3; "Lan Date:"
867 867   trap 10
868 - mov #20,R4; number of wait cycles
869 -$datry: trap 62; sent a request to the NTP server
870 - mov #110,@#AZ$CSR; enable the network
871 - trap 47; waiting
872 - trap 47; waiting
868 + mov #20,R4; количество циклов ожидания
869 +$datry: trap 62; отослали запрос к NTP серверу
870 + mov #110,@#AZ$CSR; включим сеть
871 + trap 47; ожидание
872 + trap 47; ожидание
873 873   mov #ADRTMPSTR,R3
874 - trap 60; read the date-time into the buffer
875 - trap 63; checked the date-time
874 + trap 60; считали в буфер дату-время
875 + trap 63; проверили дату-время
876 876   tst R3
877 877   bne $ok
878 878  $sob: sob R4,$datry
879 - mov #S_DateTime_2,R3; print error
879 + mov #S_DateTime_2,R3; печать ошибки
880 880   trap 7
881 881   br $go
882 882  
883 883  $ok: mov #ADRTMPSTR,R3
884 - trap 24; print date
885 - trap 25; time
886 -$go: mov #110,@#AZ$CSR; let's turn on the network
884 + trap 24; печать даты
885 + trap 25; времени
886 +$go: mov #110,@#AZ$CSR; включим сеть
887 887  {{/code}}
888 888  
889 -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.
889 +Тут мы явно отсылаем запрос к NTP серверу, затем включаем работу сети и ждем результата, периодически опрашивая и проверяя корректность результата.
890 890  
891 -== 036: Setting RTC based on TCP/IP stack clock ==
891 +== **036:  Установка RTC на основании часов TCP/IP стека** ==
892 892  
893 -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.
893 +Код команды 036,  данная команда устанавливает RTC на основании часов в TCP/IP стека. Предварительно надо установить часы в TCP/IP - команда 036.
894 894  
895 -Example program:
895 +Пример программы:
896 896  
897 897  {{code language="assembler"}}
898 -; trap 64 - set RTC time based on stack time
899 -; R1 - result R1=0 - OK
900 -SetDateNETtoRTC:call AZreset; reset
898 +; trap 64 - установка времени RTC на основании времени стека
899 +; R1 - результат R1=0 - OK
900 +SetDateNETtoRTC:call AZreset; сбросим
901 901   tst R1
902 902   bne 0ERR$
903 903   MOV #AZ$CSR,R1
904 904   mov #36,(R1)
905 -0$: TSTB (R1); check execution result
906 - BPL 0$; wait
905 +0$: TSTB (R1); проверяем результат выполнения
906 + BPL 0$; ждем
907 907   clr R1
908 908  0ERR$: return
909 909  {{/code}}
910 910  
911 -== 042: Get time from TCP/IP stack clock into timestamp buffer ==
911 +== **042:  Получить время из часов TCP/IP стека в буфер timestamp** ==
912 912  
913 -Command code 042, this command uses the TCP/IP stack clock as a source for filling the timestamp buffer.
913 +Код команды 042,   данная команда использует часы TCP/IP стека как источник заполнения буфера timestamp.
914 914  
915 -Example program:
915 +Пример программы:
916 916  
917 917  {{code language="assembler"}}
918 -; working with clock
919 -; trap 60 - reading clock data from TCP/IP stack
920 -; R3 - buffer address where to read
921 -; result in R3 address if successful. R3=0 if error
918 +; работа с часами
919 +; trap 60 - чтение данных часов из TCP/IP стека
920 +; R3 - адрес буфера куда надо считать
921 +; результат в R3 адрес, если успешно. R3=0 если ошибка
922 922  GetDateFromLAN: push R0
923 923   push R1
924 924   push R2
925 - call AZreset; reset
925 + call AZreset; сбросим
926 926   tst R1
927 927   bne G60ERR
928 928   MOV #AZ$CSR,R1
929 929   mov #42,(R1)
930 -G60: TSTB (R1); check execution result
931 - BPL G60; wait
930 +G60: TSTB (R1); проверяем результат выполнения
931 + BPL G60; ждем
932 932   mov #32,(R1)
933 -1$: TSTB (R1); check execution result
934 - BPL 1$; wait
935 - TST (R1)+; increment
936 - mov R3,R0; remember R3 address
933 +1$: TSTB (R1); проверяем результат выполнения
934 + BPL 1$; ждем
935 + TST (R1)+; инкрементируем
936 + mov R3,R0; запомним R3 - адрес
937 937   mov #10.,R2; читаем 10 слов
938 -2$: mov (R1),(R3)+; read block of words into memory
938 +2$: mov (R1),(R3)+; читаем блок слов в память
939 939   sob R2,2$
940 - mov R0,R3; successful, return address to R3
940 + mov R0,R3; успешно, вернем адрес в R3
941 941   br 0END$
942 942  G60ERR: CLR R3
943 943  0END$: pop R2
... ... @@ -946,50 +946,52 @@
946 946   return
947 947  {{/code}}
948 948  
949 -All commands set the ready bit upon completion.
949 +все команды устанавливают бит готовности по завершению.
950 950  
951 951  
952 -= **[[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] **specific commands =
952 += **Команды специфические для [[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]]** =
953 953  
954 -These commands are intended for operation of the AZБК® controller, developed for the BK series of computers - BK-0010/BK-0010.01/BK-0011M.
954 +Данные команды предназначены для работы контроллера AZБК®, разработанного для серии компьютеров БК - БК-0010/БК-0010.01/БК-0011М.
955 955  
956 -Other AZ® controllers ignore these commands.
956 +Другие контроллеры AZ® игнорируют эти команды
957 957  
958 -== 037: Restart of the** [[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] **controller and the entire computer ==
958 +== **037: перезапуск контроллера [[AZБК®>>doc:Контроллеры AZБК® для компьютеров БК-0010 БК-0010\.01 БК-0011М.WebHome]] и всей БК** ==
959 959  
960 -Command code 037, this command restarts the AZ® microcontroller, which also causes a restart of the BK-0010/BK-0010.01/BK-0011M itself
960 +Код команды 037,  данная команда осуществляет перезапуск микроконтроллера AZ®, что вызывает и перезапуск самой БК-0010/БК-0010.01/БК-0011М
961 961  
962 -Example program
962 +Пример программы
963 963  
964 964  {{code language="assembler"}}
965 -AZ$CSR = 177220; command and status register (CSR)
966 -AZ$DR = 177222; data register (DR)
965 +AZ$CSR = 177220; регистр команд и состояния (CSR)
966 +AZ$DR = 177222; регистр данных (DR)
967 967  
968 968  
969 -; trap 57 - full restart
970 -AZcouldReboot: call AZreset; reset AZ so it is ready to receive
969 +; trap 57 - перезапуск БК полный
970 +AZcouldReboot: call AZreset; сбросим AZ дабы он был готов принимать команды
971 971   mov #037,@#AZ$CSR
972 972   return
973 973  {{/code}}
974 974  
975 -== 044: Saving a screenshot to a file ==
975 +== **044: Cохранение скриншота в файл** ==
976 976  
977 -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
978 -\\service memory page 76(8) is used as parameters
977 +Код команды 044,  данная команда предназначена для снятия образа памяти указанного размера (или определенного автоматически на основании сохраненных параметров)
978 +технически команда может служить как средство отладки ибо способная снимать образ памяти
979 +общее ограничение на снятие образа памяти - 2МБ на один образ
980 +\\в качестве параметров используется служебная страница памяти 76(8)
979 979  
980 -Structure of filling information about a screenshot
982 +Структура заполнения информации о скриншоте
981 981  
982 982  {{code language="c"}}
983 -// screenshot header structure
985 +// структура хидера скриншота
984 984  typedef __packed struct screen_header
985 985  {
986 - unsigned short int tag; // must be equal to 0240
988 + unsigned short int tag; // должен быть равен 0240
987 987  
988 - unsigned int begin_adress; // start address in words - forward task in physical addresses
989 - unsigned int length; // length in words - forward task in physical addresses
990 + unsigned int begin_adress; // начальный адрес в словах - прямая задача в физических адресах
991 + unsigned int length; // длина в словах - прямая задача в физических адресах
990 990  
991 - unsigned short int begin_page; // start page - number - forward task in page numbers
992 - unsigned short int len_pages; // number of pages - forward task in page numbers
993 + unsigned short int begin_page; // начальная страница - номер - прямая задача в номерах страниц
994 + unsigned short int len_pages; // количество страниц - прямая задача в номерах страниц
993 993  
994 994   unsigned short int R177300; //
995 995   unsigned short int R177302; //
... ... @@ -1007,55 +1007,57 @@
1007 1007   unsigned short int R177332; //
1008 1008   unsigned short int R177334; //
1009 1009   unsigned short int R177336; //
1010 - unsigned short int R177340; // - Window activation control register - window masks
1011 - unsigned short int R177342; // - Control register r/o per window
1012 - unsigned short int R177344; // - Shadow window control register - window masks
1013 - unsigned short int R177346; // - Mapper control register
1014 - unsigned short int R177350; // - copy by record register 177130 in memory management write mode in SMK
1015 - unsigned short int R177352; // - copy by record register 177716 in memory management write mode in BK11M
1012 + unsigned short int R177340; // - Регистр управления активацией окно - маски окон
1013 + unsigned short int R177342; // - Регистр управления r/o на окно
1014 + unsigned short int R177344; // - Регистр управления shadow окон - маски окон
1015 + unsigned short int R177346; // - Регистр управления маппером
1016 + unsigned short int R177350; // - регистр копия по записи 177130 в режиме записи управления памятью в SMK
1017 + unsigned short int R177352; // - регистр копия по записи 177716 в режиме записи управления памятью в БК11М
1016 1016  
1017 - unsigned short int R177230; // - control register
1018 - unsigned short int R177232; // - display start page number register - upper page (layer 0)
1019 - unsigned short int R177240; // - display start page number register - upper page (layer 1)
1020 - unsigned short int R177242; // - display start page number register - upper page (layer 2)
1021 - unsigned short int R177244; // - vertical scroll register layer 2
1022 - unsigned short int R177246; // - vertical scroll register layer 1
1023 - unsigned short int R177250; // - vertical scroll register layer 0
1024 - unsigned short int R177252; // - horizontal scroll register layer 0
1025 - unsigned short int R177254; // - horizontal scroll register layer 1
1026 - unsigned short int R177256; // - horizontal scroll register layer 2
1019 + unsigned short int R177230; // - регистр управления
1020 + unsigned short int R177232; // - регистр номера страницы начала отображения - верхняя страница (слой 0)
1021 + unsigned short int R177240; // - регистр номера страницы начала отображения - средняя страница (слой 1)
1022 + unsigned short int R177242; // - регистр номера страницы начала отображения - нижняя страница (слой 2)
1023 + unsigned short int R177244; // - регистр вертикального скролинга слой 2
1024 + unsigned short int R177246; // - регистр вертикального скролинга слой 1
1025 + unsigned short int R177250; // - регистр вертикального скролинга слой 0
1026 + unsigned short int R177252; // - регистр гозизонтального скролинга слой 0
1027 + unsigned short int R177254; // - регистр гозизонтального скролинга слой 1
1028 + unsigned short int R177256; // - регистр гозизонтального скролинга слой 2
1027 1027  
1028 1028   unsigned short int paldata[338]; //
1029 1029  } screen_header_t;
1030 1030  {{/code}}
1031 1031  
1032 -Example code for filling a memory page
1034 +Пример кода для заполнения страницы памяти
1033 1033  
1034 1034  {{code language="assembler"}}
1035 1035  ;--------------------------------------------------
1036 -; 76th page map - we prepare data for the screenshot command there
1037 -SCR_PAGE = 130000 ; we temporarily attach the 76th page to the 77th - that is, into the 130000 window
1038 -SCR_TAG = SCR_PAGE+0 ; here is the input - 240 - 1 word
1039 -SCR_ADDR_CONF = SCR_TAG+2 ; here is the command with addresses - address+length 24 bits - 4 words
1040 -SCR_PAGE_CONF = SCR_ADDR_CONF+8. ; here is the command with pages - the starting page and the number of pages - 2 words
1041 -SCR_MEM_CONF = SCR_PAGE_CONF+4. ; here is the memory configuration from the registers - 22 words
1042 -SCR_VGA_CONF = SCR_MEM_CONF+44. ; here video controller configuration - 10 words
1043 -SCR_PAL = SCR_VGA_CONF+20. ; here 338. values (words) of palette 338 words
1038 +; карта 76й страницы - туда мы готовим данные для команды скринщотов
1039 + SCR_PAGE = 130000 ; 76ую страницу цепляем на место 77й временно - те в окно 130000
1040 + SCR_TAG = SCR_PAGE+0 ; тут вход - 240 - 1 слово
1041 + SCR_ADDR_CONF = SCR_TAG+2 ; сюда команду с адресами - адрес+длина 24 бита - 4 слова
1042 + SCR_PAGE_CONF = SCR_ADDR_CONF+8. ; сюда команду со страницами - начальная страница и количество страниц - 2 слова
1043 + SCR_MEM_CONF = SCR_PAGE_CONF+4. ; cюда конфигурацию памяти из регистров - 22 слова
1044 + SCR_VGA_CONF = SCR_MEM_CONF+44. ; сюда конфигурацию видеоконтроллера - 10 cлов
1045 + SCR_PAL = SCR_VGA_CONF+20. ; сюда 338. значений(слов) палитры 338 слов
1044 1044  ;--------------------------------------------------
1045 -; trap 41 - preparation of default information for screenshot functionality
1046 -PrepSRC: jsr R5, PUSHA ; batch saving of registers
1047 - mov @#177326,-(SP) ; save page 130k which was before the call
1048 - mov #76,@#177326 ; hook 76th page into window
1049 1049  
1050 - mov #100377,R3 ; constant-filler
1048 +
1049 +; trap 41 - подготовка дефолтной информации для работы функционала скриншотов
1050 +PrepSRC: jsr R5, PUSHA ; пакетное сохранение регистров
1051 + mov @#177326,-(SP) ; сохраним страницу 130k которая была до вызова
1052 + mov #76,@#177326 ; цепляем 76ую страницу в окно
1053 +
1054 + mov #100377,R3 ; константа-заполнитель
1051 1051   mov #SCR_PAGE,R4
1052 1052   mov #2047.,R2
1053 1053  4$: mov R3,(R4)+
1054 1054   sob R2,4$
1055 1055  
1056 - mov #240,@#SCR_TAG ; put the tag
1060 + mov #240,@#SCR_TAG ; проставляем тег
1057 1057  
1058 - ; clean the address section - default is automatic address detection
1062 + ; чистим участок адресов - дефолтно автоматическое определение адресов
1059 1059   clr R3
1060 1060   mov #SCR_ADDR_CONF,R4
1061 1061   mov #10,R2
... ... @@ -1062,7 +1062,7 @@
1062 1062  2$: mov R3,(R4)+
1063 1063   sob R2,2$
1064 1064  
1065 - ; memory configuration - default
1069 + ;конфигурация памяти - дефолтная
1066 1066   mov #SCR_MEM_CONF,R4
1067 1067   mov #30,(R4)+ ;177300
1068 1068   mov #31,(R4)+ ;177302
... ... @@ -1081,29 +1081,29 @@
1081 1081   mov #110,(R4)+ ;177334
1082 1082   mov #100,(R4)+ ;177336
1083 1083  
1084 - mov #170000,(R4)+ ;177340
1085 - mov R3,(R4)+ ;177342
1086 - mov #7777,(R4)+ ;177344
1087 - mov #40404,(R4)+ ;177346
1088 - mov R3,(R4)+ ;177350
1089 - mov #16000,(R4)+ ;177352
1088 + mov #170000,(R4)+ ;177340 - Регистр управления активацией окно - маски окон
1089 + mov R3,(R4)+ ;177342 - Регистр управления r/o на окно
1090 + mov #7777,(R4)+ ;177344 - Регистр управления shadow окон - маски окон
1091 + mov #40404,(R4)+ ;177346 - Регистр управления маппером
1092 + mov R3,(R4)+ ;177350 - регистр копия по записи 177130 в режиме записи управления памятью в SMK
1093 + mov #16000,(R4)+ ;177352 - регистр копия по записи 177716 в режиме записи управления памятью в БК11М
1090 1090  
1091 - ;Video controller configuration - default
1095 + ;конфигурация видеоконтроллера - дефолтная
1092 1092   ; 177230-177256
1093 1093   mov #SCR_VGA_CONF,R4
1094 1094  
1095 - mov #12201,(R4)+ ;177230
1096 - mov #4,(R4)+ ;177232
1097 - mov R3,(R4)+ ;177240
1098 - mov R3,(R4)+ ;177242
1099 - mov R3,(R4)+ ;177244
1100 - mov R3,(R4)+ ;177246
1101 - mov R3,(R4)+ ;177250
1102 - mov R3,(R4)+ ;177252
1103 - mov R3,(R4)+ ;177254
1104 - mov R3,(R4)+ ;177256
1099 + mov #12201,(R4)+ ;177230 - регистр управления
1100 + mov #4,(R4)+ ;177232 - регистр номера страницы начала отображения - верхняя страница (слой 0)
1101 + mov R3,(R4)+ ;177240 - регистр номера страницы начала отображения - средняя страница (слой 1) "под спрайты"
1102 + mov R3,(R4)+ ;177242 - регистр номера страницы начала отображения - нижняя страница (слой 2) "под фон"
1103 + mov R3,(R4)+ ;177244 - регистр вертикального скролинга слой 2
1104 + mov R3,(R4)+ ;177246 - регистр вертикального скролинга слой 1
1105 + mov R3,(R4)+ ;177250 - регистр вертикального скролинга слой 0
1106 + mov R3,(R4)+ ;177252 - регистр гозизонтального скролинга слой 0
1107 + mov R3,(R4)+ ;177254 - регистр гозизонтального скролинга слой 1
1108 + mov R3,(R4)+ ;177256 - регистр гозизонтального скролинга слой 2
1105 1105  
1106 - ; download the palette - take the default one from this ROM
1110 + ; закачиваем палитру - берем дефолтную из этой ПЗУшки
1107 1107   mov #SCR_PAL,R4
1108 1108   mov #PalData,R2
1109 1109   mov #338.,R3
... ... @@ -1110,233 +1110,233 @@
1110 1110  1$: mov (R2)+,(R4)+
1111 1111   sob R3,1$
1112 1112  
1113 - mov (SP)+,@#177326; return the page from which the call was made
1117 + mov (SP)+,@#177326; вернем страницу с которой был вызов
1114 1114   return
1115 1115  {{/code}}
1116 1116  
1117 -There are three options for specifying memory areas.
1121 +Вариантов указания участков памяти три
1118 1118  
1119 -1. specify the address and length 24-bit - see format, if they are not there - the system looks further
1120 -1. specify the page number and page quantity, if they are not there
1121 -1. the system looks further - that is, it makes a screenshot based on the data about registers 177230, etc.
1123 +1. указать адрес и длину 24х битные - cм формат, если их нет - система смотрит дальше
1124 +1. указать номер страницы и количество страницы, если их нет
1125 +1. система смотрит дальше - те делает скриншот на основании данных о регистрах 177230 и т.д..
1122 1122  
1123 -The screenshot is saved in the format
1124 -- page 76 - its first kilobyte
1125 -- the memory image itself (if the mode is layered - then all three layers)
1127 +Cкриншот сохраняется в формате
1128 +- страница 76 - ее первый килобайт
1129 +- сам образ памяти (если режим слоеный - то все три слоя)
1126 1126  
1127 1127  
1128 -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
1132 +Перед вызовом команды можно загрузить имя файла для сохранения скриншота [в cmosmem буфер], однако при его отсутствии (в буфере не будет имени - строки заканчивающейся 0) система сформирует свое имя, на основании следующего правила:
1133 +дефолтный путь для сохранения скриншотов
1129 1129  0:/SCREENS/
1130 -name format - DDHHMISS.SCR
1131 -where DD is two digits of the day of the month, HH is the hour, MI is the minute, SS is the second
1132 -\\If an error occurs during the command execution, the name will be "ERROR *"
1133 -for example
1135 +формат имени - DDHHMISS.SCR
1136 +где DD - две цифры дня месяца, HH - час, MI - минута, SS-секунда
1137 +\\Если в процессе выполнения команды возникнет ошибка - вместо имени будет "ERROR *"
1138 +к примеру
1134 1134  "ERROR f_open 6"
1135 1135  
1136 1136  
1137 -Example program
1142 +Пример программы
1138 1138  
1139 1139  {{code language="assembler"}}
1140 -; update the information in the screenshot header
1145 +; обновим информацию в хидере скриншота
1141 1141  ;--------------------------------------------------
1142 -; 76th page map - we prepare data for the screenshot command there
1143 -SCR_PAGE = 130000 ; we temporarily attach the 76th page to the 77th - that is, into the 130000 window
1144 -SCR_TAG = SCR_PAGE+0 ; here is the input - 240 - 1 word
1145 -SCR_ADDR_CONF = SCR_TAG+2 ; here is the command with addresses - address+length 24 bits - 4 words
1146 -SCR_PAGE_CONF = SCR_ADDR_CONF+8. ; here is the command with pages - the starting page and the number of pages - 2 words
1147 -SCR_MEM_CONF = SCR_PAGE_CONF+4. ; here is the memory configuration from the registers - 22 words
1148 -SCR_VGA_CONF = SCR_MEM_CONF+44. ; here video controller configuration - 10 words
1149 -SCR_PAL = SCR_VGA_CONF+20. ; here 338. values (words) of palette 338 words
1147 +; карта 76й страницы - туда мы готовим данные для команды скринщотов
1148 + SPAGE = 170000 ; 76ую страницу цепляем на место 77й временно - те в окно 130000
1149 + STAG = SPAGE+0 ; тут вход - 240 - 1 слово
1150 + SADDRC = STAG+2 ; сюда команду с адресами - адрес+длина 24 бита - 4 слова
1151 + SPAGEC = SADDRC+8. ; сюда команду со страницами - начальная страница и количество страниц - 2 слова
1152 + SMEMC = SPAGEC+4. ; cюда конфигурацию памяти из регистров - 22 слова
1153 + SVGAC = SMEMC+44. ; сюда конфигурацию видеоконтроллера - 10 cлов
1154 + SPAL = SVGAC+20. ; сюда 338. значений(слов) палитры 338 слов
1150 1150  ;--------------------------------------------------
1151 - mov @#177326,R5 ; save page 130k which was before the call
1152 - mov #76,@#177336 ; hook the 76th page into the window
1153 1153  
1154 - ;video controller configuration
1157 + mov @#177326,R5 ; сохраним страницу 130k которая была до вызова
1158 + mov #76,@#177336 ; цепляем 76ую страницу в окно
1159 +
1160 + ;конфигурация видеоконтроллера
1155 1155   ; 177230-177256
1156 1156   mov #SVGAC,R4
1157 1157  
1158 - mov @#177230,(R4)+;177230 - control register
1159 - mov @#177232,(R4)+;177232 - register - top page (layer 0)
1160 - mov @#177240,(R4)+;177240 - register - top page (layer 1)
1161 - mov @#177242,(R4)+;177242 - register - top page (layer 2)
1162 - mov @#177244,(R4)+;177244 - vertical scroll register layer 2
1163 - mov @#177246,(R4)+;177246 - vertical scroll register layer 1
1164 - mov @#177250,(R4)+;177250 - vertical scroll register layer 0
1165 - mov @#177252,(R4)+;177252 - horizontal scroll register layer 0
1166 - mov @#177254,(R4)+;177254 - horizontal scroll register layer 1
1167 - mov @#177256,(R4)+;177256 - horizontal scroll register layer 2
1164 + mov @#177230,(R4)+;177230 - регистр управления
1165 + mov @#177232,(R4)+;177232 - регистр - верхняя страница (слой 0)
1166 + mov @#177240,(R4)+;177240 - регистр - средняя страница (слой 1)
1167 + mov @#177242,(R4)+;177242 - регистр - нижняя страница (слой 2)
1168 + mov @#177244,(R4)+;177244 - регистр вертикального скролинга слой 2
1169 + mov @#177246,(R4)+;177246 - регистр вертикального скролинга слой 1
1170 + mov @#177250,(R4)+;177250 - регистр вертикального скролинга слой 0
1171 + mov @#177252,(R4)+;177252 - регистр гозизонтального скролинга слой 0
1172 + mov @#177254,(R4)+;177254 - регистр гозизонтального скролинга слой 1
1173 + mov @#177256,(R4)+;177256 - регистр гозизонтального скролинга слой 2
1168 1168  
1169 - mov R5,@#177336; return the page from which the call was made
1175 + mov R5,@#177336; вернем страницу с которой был вызов
1170 1170  
1171 1171  
1172 1172   ;-------------------------
1173 - MOV #AZ$CSR,R3 ; Preparing controller CSR
1174 - MOV #AZ$DR,R4 ; Preparing controller DR
1175 -20$: CLR (R3) ; Reset the controller
1179 + MOV #AZ$CSR,R3 ; Готовим CSR контроллера
1180 + MOV #AZ$DR,R4 ; Готовим DR контроллера
1181 +20$: CLR (R3) ; Сбросим контроллер
1176 1176   TSTB (R3)
1177 1177   BPL 20$
1178 1178  
1179 - ; clear the memory block for the name - so that the system makes a default file name
1180 - mov #23,(R3) ; command that we will write data to the buffer
1181 -128$: TSTB (R3) ; check the result of execution
1182 - BPL 128$ ; wait
1185 + ; очистим блок памяти для имени - дабы система сделала дефолтное имя файла
1186 + mov #23,(R3) ; командуем что будем писать данные в буфер
1187 +128$: TSTB (R3) ; проверяем результат выполнения
1188 + BPL 128$ ; ждем
1183 1183   clr R1
1184 1184  
1185 1185   mov #256.,R2 ;
1186 -129$: mov R1,(R4) ; give to the controller
1192 +129$: mov R1,(R4) ; отдаем в контроллер
1187 1187   sob R2,129$
1188 1188  
1189 1189  
1190 - MOV #044,(R3) ; screenshot command
1196 + MOV #044,(R3) ; команда скриншот
1191 1191  22$: TSTB (R3) ;
1192 1192   BPL 22$ ;
1193 1193  
1194 - ; get the screenshot name
1195 - mov #22,(R3) ; give the read memory block from the buffer to the bus
1196 -121$: tstb (R3) ; check the result of execution
1197 - bpl 121$ ; wait
1200 + ; получим имя скриншота
1201 + mov #22,(R3) ; отдать на шину считанный блок памяти из буфера
1202 +121$: tstb (R3) ; проверяем результат выполнения
1203 + bpl 121$ ; ждем
1198 1198  
1199 1199   mov #BUF,R1
1200 - mov #256.,R2 ; read 256. words; the first word is the result of reading
1201 -122$: mov (R4),(R1)+ ; read a block of words into memory
1206 + mov #256.,R2 ; читаем 256. слов; первое слово - результат чтения
1207 +122$: mov (R4),(R1)+ ; читаем блок слов в память
1202 1202   sob R2,122$
1203 1203  
1204 1204   .PRINT #RESOK
1205 1205   .Print #BUF
1206 1206  
1207 - mov #110,@#AZ$CSR; enable the network by default, the network should be constantly enabled
1213 + mov #110,@#AZ$CSR; включаем сеть по-умолчанию сеть должна быть постоянно включена
1208 1208   .Exit
1209 1209  {{/code}}
1210 1210  
1211 -To unpack a screenshot, you can use this utility - [[https:~~/~~/master.pdp-11.ru/screen_unpack/>>https://master.pdp-11.ru/screen_unpack/]]
1217 +Для распаковки скриншота можно использовать вот эту утилиту
1212 1212  
1213 1213  
1214 1214  
1215 -= Commands for working with the TCP/IP stack =
1221 += **Команды для работы со стеком TCP/IP** =
1216 1216  
1217 -The following commands operate on the TCP/IP stack information buffer.
1223 +следующие команды работают с буфером информации TCP/IP cтека.
1218 1218  
1219 -== 040: Get IP address and other TCP/IP stack settings to buffer ==
1225 +== **040: Получить ip адрес и прочие настройки стека TCP/IP в буфер** ==
1220 1220  
1221 -Command code 040, this command fills the buffer with information from the TCP/IP stack with current (actual) information.
1227 +Код команды 040,  данная команда заполняет буфер информацией с TCP/IP cтека текущей (фактической) информацией.
1222 1222  
1223 -== 041: Reading ip address buffer ==
1229 +== **041: Чтение буфера ip адреса** ==
1224 1224  
1225 -Command code 041, this command transfers the buffer to the bus
1231 +Код команды 041,  данная команда передает буфер на шину
1226 1226  
1227 -This pair of commands allows you to get current information from the stack
1233 +эта пара команд позволяет получить текущую информацию со стека
1228 1228  
1229 -* IP address
1230 -* MASK mask
1231 -* GW gateway
1232 -* NTP address of the NTP server
1233 -* DNS1 primary DNS address
1234 -* DNS2 backup DNS address
1235 +* IP адрес
1236 +* MASK маску
1237 +* GW гейтвей
1238 +* NTP адрес NTP-сервера
1239 +* DNS1 адрес основного DNS
1240 +* DNS2 адрес резервного DNS
1235 1235  
1236 -accordingly it is 12 words
1242 +соответственно это 12 слов
1237 1237  
1238 -Example program:
1244 +Пример программы:
1239 1239  
1240 1240  {{code language="assembler"}}
1241 -; trap 52 - reading a block of IP addresses into the IPADDDBLOCK memory block (8 cells)
1242 -; result in R3 = 0 if error, otherwise the address where it was read (IPADDDBLOCK)
1243 -GetIPaddrs: push R1
1244 - push R2
1245 - call AZreset; reset
1246 - tst R1
1247 - bne 0ERR$
1248 - MOV #AZ$CSR,R1
1249 - mov #40,(R1)
1250 -0$: TSTB (R1); read addresses into its memory
1251 - BPL 0$; wait
1252 - mov #41,(R1)
1253 -1$: TSTB (R1); prepare buffer
1254 - BPL 1$; wait
1255 - TST (R1)+; increment
1256 - mov #IPADDDBLOCK,R3
1257 - mov #12.,R2
1258 -2$: mov (R1),(R3)+; read block of words into memory
1259 - sob R2,2$
1260 - mov #IPADDDBLOCK,R3; success
1261 - br 0END$
1262 -0ERR$: CLR R3
1263 -0END$: pop R2
1264 - pop R1
1265 - return
1266 -
1247 +; trap 52 - чтение блока IP адресов в блок памяти IPADDDBLOCK (8. ячеек)
1248 +; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK)
1249 +GetIPaddrs: push R1
1250 + push R2
1251 + call AZreset; сбросим
1252 + tst R1
1253 + bne 0ERR$
1254 + MOV #AZ$CSR,R1
1255 + mov #40,(R1)
1256 +0$: TSTB (R1); прочитать адреса в свою память
1257 + BPL 0$; ждем
1258 + mov #41,(R1)
1259 +1$: TSTB (R1); подготовить буфер
1260 + BPL 1$; ждем
1261 + TST (R1)+; инкрементируем
1262 + mov #IPADDDBLOCK,R3
1263 + mov #12.,R2
1264 +2$: mov (R1),(R3)+; читаем блок слов в память
1265 + sob R2,2$
1266 + mov #IPADDDBLOCK,R3; успешно
1267 + br 0END$
1268 +0ERR$: CLR R3
1269 +0END$: pop R2
1270 + pop R1
1271 + return
1267 1267  {{/code}}
1268 1268  
1269 -Example return data:
1274 +Пример данных
1270 1270  
1271 1271  {{info}}
1272 -Data examples - words returned in octal format
1273 -124300 116400 - IP address 192.168.0.157
1274 -177777 000377 - MASK mask 255.255.255.0
1275 -124300 000400 - GW gateway 192.168.0.1
1276 -124300 000400 - NTP address of NTP server 192.168.0.1
1277 -124300 050000 - DNS1 address of primary DNS 192.168.0.90
1278 -124300 055000 - DNS2 address of backup DNS 192.168.0.80
1277 +Примеры данных - возвращаемые слова в восьмеричном формате
1278 +124300 116400 - IP адрес 192.168.0.157
1279 +177777 000377 - MASK маску 255.255.255.0
1280 +124300 000400 - GW гейтвей 192.168.0.1
1281 +124300 000400 - NTP адрес NTP-сервера 192.168.0.1
1282 +124300 050000 - DNS1 адрес основного DNS 192.168.0.90
1283 +124300 055000 - DNS2 адрес резервного DNS 192.168.0.80
1279 1279  {{/info}}
1280 1280  
1281 -== 043: Read MAC address into ip buffer ==
1286 +== **043: чтение MAC-адреса в ip буфер** ==
1282 1282  
1283 -Command code 043, this command reads the current actual MAC address into the IP address buffer i.e. first 043 and then 041 commands
1288 +Код команды 043, данная команда читает текущий фактический MAC адрес в буфер IP адресов
1289 +те сначала 043, а затем 041 команды
1284 1284  
1285 -Example program:
1291 +Пример программы:
1286 1286  
1287 1287  {{code language="assembler"}}
1288 -; trap 72 - reading the MAC address into the IPADDDBLOCK memory block (12 cells)
1289 -; result in R3 = 0 if error, otherwise the address where it was read (IPADDDBLOCK)
1290 -GetMACaddrs: push R1
1291 - push R2
1292 - call AZreset ; reset
1293 - tst R1
1294 - bne 0ERR$
1295 - MOV #AZ$CSR,R1
1296 - mov #43,(R1)
1297 -0$: TSTB (R1) ; read addresses into its memory
1298 - BPL 0$ ; wait
1299 - mov #41,(R1)
1300 -1$: TSTB (R1) ; prepare buffer
1301 - BPL 1$ ; wait
1302 - TST (R1)+ ; increment
1303 - mov #IPADDDBLOCK,R3
1304 - mov #12.,R2
1305 -2$: mov (R1),(R3)+ ; read block of words into memory
1306 - sob R2,2$
1307 - mov #IPADDDBLOCK,R3; success
1308 - br 0END$
1309 -0ERR$: CLR R3
1310 -0END$: pop R2
1311 - pop R1
1312 - retur
1313 -
1294 +; trap 72 - чтение MAC адреса в блок памяти IPADDDBLOCK (12. ячеек)
1295 +; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK)
1296 +GetMACaddrs: push R1
1297 + push R2
1298 + call AZreset ; сбросим
1299 + tst R1
1300 + bne 0ERR$
1301 + MOV #AZ$CSR,R1
1302 + mov #43,(R1)
1303 +0$: TSTB (R1) ; прочитать адреса в свою память
1304 + BPL 0$ ; ждем
1305 + mov #41,(R1)
1306 +1$: TSTB (R1) ; подготовить буфер
1307 + BPL 1$ ; ждем
1308 + TST (R1)+ ; инкрементируем
1309 + mov #IPADDDBLOCK,R3
1310 + mov #12.,R2
1311 +2$: mov (R1),(R3)+ ; читаем блок слов в память
1312 + sob R2,2$
1313 + mov #IPADDDBLOCK,R3; успешно
1314 + br 0END$
1315 +0ERR$: CLR R3
1316 +0END$: pop R2
1317 + pop R1
1318 + retur
1314 1314  {{/code}}
1315 1315  
1316 1316  
1317 1317  
1318 -= Commands for working with a MicroSD card at the file level =
1323 += **Команды для работы с MicroSD картой на файловом уровне** =
1319 1319  
1320 1320  
1321 -These commands are designed to work with a MicroSD card at the file system level and allow you to read/write files without mounting files as disk images.
1326 +Данные команды предназначены для работы с MicroSD картой на уровне файловой системы и позволяет читать/писать файлы без монтирования файлов как образов дисков.
1322 1322  
1323 -These commands use a 256-word buffer that is used in the interface for working with non-volatile memory (see commands 022 023 above)
1328 +Эти команды используют буфер 256. слов который задействован в интерфейсе работы с энергонезависимой памятью (см выше команды 022 023)
1329 +\\Ограничения - длина полного пути к файлу  256 байт
1324 1324  
1325 -Limitations - the length of the full path to the file is 256 bytes
1331 +== **050: Установить имя файла который будем читать** ==
1326 1326  
1327 -== 050: Set the name of the file we will read ==
1333 +Код команды 050,  данная команда устанавливает имя файла который будем читать, при этом производится открытие файла на чтение, а также получение его свойств.
1328 1328  
1329 -Command code 050, this command sets the name of the file that we will read, while opening the file for reading, and also obtaining its properties.
1335 +== **051: Получить размер файла на чтение (или его статус) на МПИ** ==
1330 1330  
1331 -== 051: Get file size for reading (or its status) on BUS ==
1337 +Код команды 051,  данная команда передает на МПИ размер файла или ошибку его чтения. Размер файла 31бит, старший бит является признаком ошибки. Соответственно максимальный размер файлов с которыми можно работать через этот интерфейс ограничен 2^31 байт (2GB).
1332 1332  
1333 -Command code 051, this command transmits the file size or reading error to the MPI. The file size is 31 bits, the most significant bit is an error indicator. Accordingly, the maximum file size that can be worked with via this interface is limited to 2 ^ 31 bytes (2GB).
1339 +формирование ошибки выглядит так:
1340 +sizeanyfile=1<<31 + FFres; ~/~/ если установлен старший бит 32х битного слова - то в младшей части код ошибки
1341 +\\FFres = ошибка FatFS
1342 +
1334 1334  
1335 -The error generation looks like this:
1336 -sizeanyfile=1<<31 + FFres; ~/~/ if the most significant bit of a 32-bit word is set, then the error code is in the lower part
1337 -
1338 -FFres = FatFS error
1339 -
1340 1340  {{code language="c"}}
1341 1341  typedef enum {
1342 1342   FR_OK = 0, /* (0) Succeeded */
... ... @@ -1364,22 +1364,23 @@
1364 1364  
1365 1365  [[http:~~/~~/elm-chan.org/fsw/ff/doc/open.html>>url:http://elm-chan.org/fsw/ff/doc/open.html]]
1366 1366  
1367 -== 052: Read a block of a set file into a buffer ==
1371 +== **052: Читать блок установленного файла в буфер** ==
1368 1368  
1369 -Command code 052, this command reads a file into a non-volatile memory buffer.
1373 +Код команды 052,  данная команда осуществляет чтение файла в буфер энергонезависимой памяти.
1370 1370  
1371 -As a result, the file reading scheme looks like this
1372 -**023** - fill the file name into the buffer
1373 -**050 **- set the file for reading
1374 -**051** - read the file length or file open error
1375 -if there is an error - repeat 023 050 051 from the beginning
1376 -if everything is ok - start reading the file
1377 -**052** - read the file block into the buffer
1378 -**022** - take data from the buffer
1379 -repeat the **052 022** pairs the required number of times in order to read the entire file
1380 -once the file is read - the last 052 command will close it automatically.
1375 +В итоге схема чтения файла выглядит вот так
1376 +**023** - заливаем имя файла в буфер
1377 +**050** - устанавливаем файл на чтение
1378 +**051 **- читаем длину файла или ошибку открытия файла
1379 +если ошибка - повторяем сначала 023 050 051
1380 +если все ok - приступаем к чтению файла
1381 +**052** - читает блок файла в буфер
1382 +**022 **- забираем данные из буфера
1383 +пары 052 022 повторяем нужное количество раз дабы считать весь файл
1384 +как файл будет прочтен - последняя 052 команда закроет его автоматически.
1385 +
1381 1381  
1382 -Example program:
1387 +Пример программы
1383 1383  
1384 1384  {{code language="assembler"}}
1385 1385  
... ... @@ -1500,7 +1500,7 @@
1500 1500  как файл будет записан - последняя 055 команда закроет его автоматически
1501 1501  
1502 1502  
1503 -Example program:
1508 +Пример программы:
1504 1504  
1505 1505  {{code language="assembler"}}
1506 1506  ; заливаем в буфер имя файла