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

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

From 2.74 to 2.75 From 2.77 to 2.78

From version 2.75

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

Change comment: There is no comment for this version

To version 2.77

edited by Max
on 2025/02/25 17:22

Change comment: (Autosaved)

Raw
Rendered

Summary

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

Details

Page properties

Content

@@ -1212,129 +1212,131 @@
--= **Команды для работы со стеком TCP/IP** =
++= Commands for working with the TCP/IP stack =
--следующие команды работают с буфером информации TCP/IP cтека.
++The following commands operate on the TCP/IP stack information buffer.
--== **040: Получить ip адрес и прочие настройки стека TCP/IP в буфер** ==
++== 040: Get IP address and other TCP/IP stack settings to buffer ==
--Код команды 040,  данная команда заполняет буфер информацией с TCP/IP cтека текущей (фактической) информацией.
++Command code 040, this command fills the buffer with information from the TCP/IP stack with current (actual) information.
--== **041: Чтение буфера ip адреса** ==
++== 041: Reading ip address buffer ==
--Код команды 041,  данная команда передает буфер на шину
++Command code 041, this command transfers the buffer to the bus
--эта пара команд позволяет получить текущую информацию со стека
++This pair of commands allows you to get current information from the stack
--* IP адрес
--* MASK маску
--* GW гейтвей
--* NTP адрес NTP-сервера
--* DNS1 адрес основного DNS
--* DNS2 адрес резервного DNS
++* IP address
++* MASK mask
++* GW gateway
++* NTP address of the NTP server
++* DNS1 primary DNS address
++* DNS2 backup DNS address
--соответственно это 12 слов
++accordingly it is 12 words
--Пример программы:
++Example program:
  {{code language="assembler"}}
--; trap 52 - чтение блока IP адресов в блок памяти IPADDDBLOCK (8. ячеек)
--; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK)
--GetIPaddrs:     push    R1
--                push    R2
--                call    AZreset; сбросим
--                tst     R1
--                bne     0ERR$
--                MOV     #AZ$CSR,R1
--                mov     #40,(R1)
--0$:             TSTB    (R1); прочитать адреса в свою память
--                BPL     0$; ждем
--                mov     #41,(R1)
--1$:             TSTB    (R1); подготовить буфер
--                BPL     1$; ждем
--                TST     (R1)+; инкрементируем
--                mov     #IPADDDBLOCK,R3
--                mov     #12.,R2
--2$:             mov     (R1),(R3)+; читаем блок слов в память
--                sob     R2,2$
--                mov     #IPADDDBLOCK,R3; успешно
--                br      0END$
--0ERR$:          CLR     R3
--0END$:          pop     R2
--                pop     R1
--                return
++; trap 52 - reading a block of IP addresses into the IPADDDBLOCK memory block (8 cells)
++; result in R3 = 0 if error, otherwise the address where it was read (IPADDDBLOCK)
++GetIPaddrs:     push    R1
++                push    R2
++                call    AZreset; reset
++                tst     R1
++                bne     0ERR$
++                MOV     #AZ$CSR,R1
++                mov     #40,(R1)
++0$:             TSTB    (R1); read addresses into its memory
++                BPL     0$; wait
++                mov     #41,(R1)
++1$:             TSTB    (R1); prepare buffer
++                BPL     1$; wait
++                TST     (R1)+; increment
++                mov     #IPADDDBLOCK,R3
++                mov     #12.,R2
++2$:             mov     (R1),(R3)+; read block of words into memory
++                sob     R2,2$
++                mov     #IPADDDBLOCK,R3; success
++                br      0END$
++0ERR$:          CLR     R3
++0END$:          pop     R2
++                pop     R1
++                return
++
  {{/code}}
--Пример данных
++Example return data:
  {{info}}
--Примеры данных - возвращаемые слова в восьмеричном формате
--124300 116400 - IP адрес 192.168.0.157
--177777 000377 - MASK маску 255.255.255.0
--124300 000400 - GW гейтвей 192.168.0.1
--124300 000400 - NTP адрес NTP-сервера 192.168.0.1
--124300 050000 - DNS1 адрес основного DNS 192.168.0.90
--124300 055000 - DNS2 адрес резервного DNS 192.168.0.80
++Data examples - words returned in octal format
++124300 116400 - IP address 192.168.0.157
++177777 000377 - MASK mask 255.255.255.0
++124300 000400 - GW gateway 192.168.0.1
++124300 000400 - NTP address of NTP server 192.168.0.1
++124300 050000 - DNS1 address of primary DNS 192.168.0.90
++124300 055000 - DNS2 address of backup DNS 192.168.0.80
  {{/info}}
--== **043: чтение MAC-адреса в ip буфер** ==
++== 043: Read MAC address into ip buffer ==
--Код команды 043, данная команда читает текущий фактический MAC адрес в буфер IP адресов
--те сначала 043, а затем 041 команды
++Command code 043, this command reads the current actual MAC address into the IP address buffer i.e. first 043 and then 041 commands
--Пример программы:
++Example program:
  {{code language="assembler"}}
--; trap 72 - чтение MAC адреса в блок памяти IPADDDBLOCK (12. ячеек)
--; результат в R3 =0 error, иначе адрес куда считано (IPADDDBLOCK)
--GetMACaddrs:    push    R1
--                push    R2
--                call    AZreset     ; сбросим
--                tst     R1
--                bne     0ERR$
--                MOV     #AZ$CSR,R1
--                mov     #43,(R1)
--0$:             TSTB    (R1)        ; прочитать адреса в свою память
--                BPL     0$          ; ждем
--                mov     #41,(R1)
--1$:             TSTB    (R1)        ; подготовить буфер
--                BPL     1$          ; ждем
--                TST     (R1)+       ; инкрементируем
--                mov     #IPADDDBLOCK,R3
--                mov     #12.,R2
--2$:             mov     (R1),(R3)+  ; читаем блок слов в память
--                sob     R2,2$
--                mov     #IPADDDBLOCK,R3; успешно
--                br      0END$
--0ERR$:          CLR     R3
--0END$:          pop     R2
--                pop     R1
--                retur
++; trap 72 - reading the MAC address into the IPADDDBLOCK memory block (12 cells)
++; result in R3 = 0 if error, otherwise the address where it was read (IPADDDBLOCK)
++GetMACaddrs:    push    R1
++                push    R2
++                call    AZreset     ; reset
++                tst     R1
++                bne     0ERR$
++                MOV     #AZ$CSR,R1
++                mov     #43,(R1)
++0$:             TSTB    (R1)        ; read addresses into its memory
++                BPL     0$          ; wait
++                mov     #41,(R1)
++1$:             TSTB    (R1)        ; prepare buffer
++                BPL     1$          ; wait
++                TST     (R1)+       ; increment
++                mov     #IPADDDBLOCK,R3
++                mov     #12.,R2
++2$:             mov     (R1),(R3)+  ; read block of words into memory
++                sob     R2,2$
++                mov     #IPADDDBLOCK,R3; success
++                br      0END$
++0ERR$:          CLR     R3
++0END$:          pop     R2
++                pop     R1
++                retur
++
  {{/code}}
--= **Команды для работы с MicroSD картой на файловом уровне** =
++= Commands for working with a MicroSD card at the file level =
--Данные команды предназначены для работы с MicroSD картой на уровне файловой системы и позволяет читать/писать файлы без монтирования файлов как образов дисков.
++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.
--Эти команды используют буфер 256. слов который задействован в интерфейсе работы с энергонезависимой памятью (см выше команды 022 023)
--\\Ограничения - длина полного пути к файлу  256 байт
++These commands use a 256-word buffer that is used in the interface for working with non-volatile memory (see commands 022 023 above)
--== **050: Установить имя файла который будем читать** ==
++Limitations - the length of the full path to the file is 256 bytes
--Код команды 050,  данная команда устанавливает имя файла который будем читать, при этом производится открытие файла на чтение, а также получение его свойств.
++== 050: Set the name of the file we will read ==
--== **051: Получить размер файла на чтение (или его статус) на МПИ** ==
++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.
--Код команды 051,  данная команда передает на МПИ размер файла или ошибку его чтения. Размер файла 31бит, старший бит является признаком ошибки. Соответственно максимальный размер файлов с которыми можно работать через этот интерфейс ограничен 2^31 байт (2GB).
++== 051: Get file size for reading (or its status) on BUS ==
--формирование ошибки выглядит так:
--sizeanyfile=1<<31 + FFres; ~/~/ если установлен старший бит 32х битного слова - то в младшей части код ошибки
--\\FFres = ошибка FatFS
--
++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).
++The error generation looks like this:
++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
++
++FFres = FatFS error
++
  {{code language="c"}}
  typedef enum {
      FR_OK = 0,                /* (0) Succeeded */
@@ -1362,23 +1362,22 @@
  [[http:~~/~~/elm-chan.org/fsw/ff/doc/open.html>>url:http://elm-chan.org/fsw/ff/doc/open.html]]
--== **052: Читать блок установленного файла в буфер** ==
++== 052: Read a block of a set file into a buffer ==
--Код команды 052,  данная команда осуществляет чтение файла в буфер энергонезависимой памяти.
++Command code 052, this command reads a file into a non-volatile memory buffer.
--В итоге схема чтения файла выглядит вот так
--**023** - заливаем имя файла в буфер
--**050** - устанавливаем файл на чтение
--**051 **- читаем длину файла или ошибку открытия файла
--если ошибка - повторяем сначала 023 050 051
--если все ok - приступаем к чтению файла
--**052** - читает блок файла в буфер
--**022 **- забираем данные из буфера
--пары 052 022 повторяем нужное количество раз дабы считать весь файл
--как файл будет прочтен - последняя 052 команда закроет его автоматически.
--
++As a result, the file reading scheme looks like this
++**023** - fill the file name into the buffer
++**050 **- set the file for reading
++**051** - read the file length or file open error
++if there is an error - repeat 023 050 051 from the beginning
++if everything is ok - start reading the file
++**052** - read the file block into the buffer
++**022** - take data from the buffer
++repeat the **052 022** pairs the required number of times in order to read the entire file
++once the file is read - the last 052 command will close it automatically.
--Пример программы
++Example program:
  {{code language="assembler"}}
@@ -1499,7 +1499,7 @@
  как файл будет записан - последняя 055 команда закроет его автоматически
--Пример программы:
++Example program:
  {{code language="assembler"}}
  ; заливаем в буфер имя файла

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

Summary

Details

Applications

Navigation

Need help?