Skip to Content
Last modified by Max on 2025/03/02 15:18
From version 1.3
edited by Max
on 2025/02/25 10:56
Change comment: (Autosaved)
To version 2.1
edited by Max
on 2025/02/25 11:51
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -154,18 +154,19 @@
154 154  
155 155  == 003: Open HFS Table of Contents ==
156 156  
157 -Последовательность действий
158 -\\• [[сбросить контроллер>>doc:||anchor="H000:A042143144043E44143A43E43D44244043E43B43B435440430"]]
159 -• подать в CSR команду "Принять блок данных в буфер" и передать пословно всю строку с полным текстом пути (Full Path) к требуемому оглавлению. Строка должна завершаться нулевым байтом (0х00) и быть не длиннее 384 байт (192 слов).
160 -• переслать в CSR код команды "Открыть оглавление"
161 -• дождаться ее окончания (команда длительная)
162 -• проверить на ошибку
157 +Sequence of actions:
163 163  
164 -[[**//Пример утилиты - AZDIR//**>>url:https://forum.maxiol.com/index.php?s=&showtopic=5605&view=findpost&p=59418]]
159 +• reset the controller
160 +• send the command "Accept data block to buffer" to the CSR and transmit the entire line with the full path text (Full Path) to the required table of contents word by word. The line must end with a zero byte (0x00) and be no longer than 384 bytes (192 words).
161 +• send the "Open table of contents" command code to the CSR
162 +• wait for it to finish (the command is long)
163 +• check for errors
165 165  
165 +[[Example utility - AZDIR>>url:https://forum.maxiol.com/index.php?s=&showtopic=5605&view=findpost&p=59418]]
166 166  
167 -Пример программы:
168 168  
168 +Example program:
169 +
169 169  {{code language="assembler"}}
170 170  ;.............................
171 171  AZ$CSR = 177220
... ... @@ -173,46 +173,44 @@
173 173  OpnDir = 003
174 174  
175 175   MOV #AZ$CSR,R3
176 -
177 -; Ячейка DirPtr содержит указатель на начало поля с Full
178 -; Path. Считаем, что строка завершается тремя нулевыми
179 -; байтами, чтобы распознать по нулю окончание пересылки
180 -; строки пословно. Действительно, если количество
181 -; символов в строке четное, то следующие два байта нулей
182 -; образуют нулевое слово; если же нечетное, то один ноль
183 -; уйдет вместе с последним символом строки, а нулевое
184 -; слово образуют второй и третий нулевые байты,
185 -; оканчивающие строку. То есть, такое окончание строки,
186 -; передаваемой пословно, вполне надежно.
177 +; The DirPtr cell contains a pointer to the beginning of the field with Full
178 +; Path. We assume that the string is terminated by three zero
179 +; bytes in order to recognize the end of the transfer of the
180 +; string word by word by zero. Indeed, if the number of
181 +; characters in the string is even, then the next two bytes of zeros
182 +; form a zero word; if it is odd, then one zero
183 +; will go away with the last character of the string, and the zero
184 +; word is formed by the second and third zero bytes,
185 +; ending the string. That is, such an end of the string,
186 +; transferred word by word, is quite reliable.
187 187   MOV DirPtr,R2
188 188  
189 - MOV #WrBuf,(R3)+; Подаем команду "Запись в
190 - ; буфер" и передаем строку
191 -11$: MOV (R2)+,@R3; пословно, до тех пор,
192 - BNE 11$ ; пока не перешлется ноль
189 + MOV #WrBuf,(R3)+; We issue the "Write to
190 + ; buffer" command and transmit the string
191 +11$: MOV (R2)+,@R3; word by word,
192 + BNE 11$ ;until zero is sent,
193 193  
194 - MOV #OpnDir,-(R3); Подаем команду "Открыть
195 - ; оглавление"
194 + MOV #OpnDir,-(R3); We issue the "Open
195 + ; table of contents" command
196 196  
197 -12$: TSTB @R3; и ждем, когда контроллер ее
198 - BPL 12$; выполнит,
199 - TST @R3; после чего проверяем на ошибку.
200 - BMI Err10; Ошибка -->
197 +12$: TSTB @R3; and wait for the controller to
198 + BPL 12$; execute it,
199 + TST @R3; after which we check for an error.
200 + BMI Err10; Error -->
201 201  ;.............................
202 202  {{/code}}
203 203  
204 -== **004: Монтировать диск** ==
204 +== 004: Mount a disk ==
205 205  
206 -Порядок действий:
207 -• [[Сбросить контроллер>>doc:||anchor="H000:A042143144043E44143A43E43D44244043E43B43B435440430"]]
208 -• Переслать в контроллер строку с записью, подобной строкам описания дисков в файле AZ.INI
209 -• Выдать команду "Монтировать диск"
210 -• Дождаться ее окончания (команда длительная)
211 -• Проверить на ошибки
212 -На выбранный накопитель AZnn НЕ ДОЛЖЕН быть смонтирован диск. Если он таки смонтирован, перед монтированием туда нового диска следует размонтировать старый - команда 014
213 -
206 +Sequence of actions:
207 +• Reset the controller
208 +• Send a line to the controller with a record similar to the lines describing the disks in the AZ.INI file
209 +• Issue the "Mount disk" command
210 +• Wait for it to finish (the command is long)
211 +• Check for errors
212 +The selected AZnn drive MUST NOT have a disk mounted. If it is mounted, the old disk should be unmounted before mounting a new one - command 014
214 214  
215 -Пример программы:
214 +Example program:
216 216  
217 217  {{code language="assembler"}}
218 218  ;..................
... ... @@ -222,20 +222,20 @@
222 222   MOV #AZ$CSR,R3
223 223  
224 224  20$: CLR @R3;
225 - TSTB @R3; Сбросим контроллер
224 + TSTB @R3; Reset the controller
226 226   BPL 20$;
227 227  
228 - MOV #WrBuf,(R3)+; Перешлем в него строку
229 - MOV #MDTXT,R2; с командой назначения
227 + MOV #WrBuf,(R3)+; Send it a string
228 + MOV #MDTXT,R2; with the assignment command
230 230   MOV #MDLEN/2,R1;
231 231  21$: MOV (R2)+,@R3;
232 232   SOB R1,21$;
233 233  
234 - MOV #AZMNT,-(R3); и отдадим ее на
235 -22$: TSTB @R3 ; исполнение
233 + MOV #AZMNT,-(R3); and pass it to
234 +22$: TSTB @R3 ; execution
236 236   BPL 22$ ;
237 237  
238 - TST @R3; после чего проверим на ошибку
237 + TST @R3; then check for an error
239 239   BMI Err11;
240 240  ;.........................
241 241  
... ... @@ -244,57 +244,57 @@
244 244  ;..................
245 245  {{/code}}
246 246  
247 -В этом фрагменте на диск AZ4 монтируется файл-образ 51SYS_DS.DSK, лежащий в папке SYSTEM, которая лежит в папке DISKS, лежащей в корневом оглавлении карточки микро-SD.
246 +In this fragment, the 51SYS_DS.DSK image file is mounted on the AZ4 disk, located in the SYSTEM folder, which is located in the DISKS folder, which is located in the root directory of the micro-SD card.
248 248  
249 249  
250 -== **005: Чтение блока в буфер** ==
249 +== 005: Reading block into buffer ==
251 251  
252 -У контроллера имеется [[встроенный буфер на 256 слов (512 байт).>>doc:||anchor="H411443444435440430"]] Фактически, это часть оперативной памяти микроконтроллера STM32, выделенная в его программе под этот буфер. Весь обмен в основном блоке команд идет через этот буфер.
253 -\\Память дисков AZ представлена, как набор блоков объемом 512 байт каждый. Такой блок - единственная доступная единица для обмена данными с дисками AZ. Блоки пронумерованы от нуля до 65533 для 16-разрядного варианта или до 8388607 для 32-разрядного - это при использовании накопителей AZ максимально допустимой емкости. Никто не мешает использовать накопители меньшей емкости - фактический размер накопителя равен размеру файл-образа, смонтированного на этот накопитель. При попытке обратиться за пределы файл-образа будет зарегистрирована ошибка.
254 -\\Команда 005 - чтение блока с MicroSD в [[буфер>>doc:||anchor="Micro"]]. С псевдодиска AZn, выбранного ранее командой "Выбор устройства" запускается на чтение блок, номер которого передан командой (командами) "Установка номера блока". Команда длительного действия.
255 -\\Фактически, блок с карточки MicroSD читается, примерно, 500-800 мкс. На это время контроллер переходит в состояние, которое во время обсуждения проекта получило название "Думаю, прошу не мешать." А именно, на все время ее исполнения отключаются все регистры устройства, кроме CSR, в котором считывается ноль до тех пор, пока контроллер занят исполнением этой команды. По окончании считывания блока к МПИ подключаются остальные регистры контроллера, взводится бит D7 (готовность) в CSR и, если был установлен бит D6 (разрешение прерываний) в CSR, вырабатывается прерывание с вектором 0174.
256 -\\Пример без прерываний тривиален:
251 +The controller has a built-in buffer for 256 words (512 bytes). In fact, this is part of the STM32 microcontroller's RAM, allocated in its program for this buffer. All exchange in the main command block goes through this buffer.
252 +\\The AZ disk memory is represented as a set of blocks, each 512 bytes in size. Such a block is the only available unit for exchanging data with AZ disks. The blocks are numbered from zero to 65533 for the 16-bit version or up to 8388607 for the 32-bit version - this is when using AZ drives of the maximum permissible capacity. No one prevents you from using drives of a smaller capacity - the actual size of the drive is equal to the size of the file-image mounted on this drive. An error will be registered if you try to access beyond the file-image.
253 +\\Command 005 - reading a block from MicroSD to the buffer. From the pseudo-disk AZn, previously selected by the command "Select device", the block whose number is transmitted by the command (commands) "Set block number" is started for reading. Long-term command.
254 +\\In fact, a block from a MicroSD card is read in about 500-800 µs. During this time, the controller goes into a state that during the discussion of the project was called "I think, please do not interfere." Namely, for the entire time of its execution, all device registers are disabled, except for CSR, in which zero is read as long as the controller is busy executing this command. After the block is read, the remaining controller registers are connected to the QBUS, bit D7 (ready) is set in CSR and, if bit D6 (interrupt enable) was set in CSR, an interrupt with vector 0174 is generated.
255 +\\An example without interruptions is trivial:
257 257  
258 258  {{code language="assembler"}}
259 259  ;...................................
260 260  
261 -CmdRea=005; символическое наименование команды "Читать
262 -; блок"
260 +CmdRea=005; symbolic name of the "Read block" command
263 263  
264 -; В R3 у нас от предыдущего фрагмента остался адрес CSR.
265 -; Пересылаем туда код команды чтения
262 +; In R3 we have the CSR address left from the previous fragment.
263 +; We send the read command code there
266 266   MOV #CmdRea,@R3
267 -2$: TSTB @R3 ; Проверим бит готовности
268 - BPL 2$; Не готово -> уходим проверять еще
269 - ; раз
270 - TST @R3; Проверим на ошибку
265 +2$: TSTB @R3 Let's check the ready bit
266 + BPL 2$; Not ready -> we go to check again
267 +; once
268 + TST @R3; Let's check for an error
271 271   BMI ERR4
272 -; Здесь у нас опять, в отличие от фрагментов пп. 3.1 и
273 -; 3.2, в R3 остался адрес CSR, а не DR.
270 +; Here again, unlike the fragments of pp. 3.1 and
271 +; 3.2, we have the CSR address left in R3, not DR.
274 274  
275 275  ;...................................
276 276  {{/code}}
277 277  
278 278  
279 -== **006: Записать блок из буфера на диск** ==
277 +== 006: Write block from buffer to disk ==
280 280  
281 -Код команды 006. Содержимое буфера пишется на выбранный псевдодиск по заданному дисковомк адресу (номеру блока). Перед записью выполняются проверки (1) "была ли запись в буфер?", если нет, выдается ошибка и (2) "заполнен ли буфер полностью?", если нет (для последнего укороченного блока файла), остаток буфера очищается нулями. Далее производится запись блока на носитель. Операция длительная, после ее запуска контроллер, как и при чтении переходит в состояние "Думаю, прошу не мешать". И так же, как и при чтении окончания этой операции надо дождаться, теми же средствами, как и при чтении.
282 -\\Пример программы без прерываний:
279 +Command code 006. The buffer contents are written to the selected pseudo-disk at the specified disk address (block number). Before writing, checks are performed (1) "was there a write to the buffer?", if not, an error is returned and (2) "is the buffer completely filled?", if not (for the last shortened block of the file), the rest of the buffer is cleared with zeros. Then the block is written to the media. The operation is lengthy, after it is started the controller, as with reading, goes into the "I think, please do not interfere" state. And just as with reading, you must wait for the end of this operation, by the same means as with reading.
283 283  
281 +
282 +Example of a program without interrupts:
283 +
284 284  {{code language="assembler"}}
285 285  ;...............................................................
286 286  
287 -CmdWri=006; символическое наименование команды "Писать
288 - ; блок"
287 +CmdWri=006; symbolic name of the "Write
288 +; block" command
289 289  
290 -; В R3 у нас от предыдущего фрагмента остался адрес DR.
291 -; Исправляем его на CSR и пересылаем туда код команды
292 -; записи
290 +; In R3 we have the DR address left over from the previous fragment.
291 +; We correct it to the CSR and send the
292 +; write command code there
293 293   MOV #CmdWri,-(R3)
294 -5$: TSTB @R3 ; Проверим бит готовности
295 - BPL 5$; Не готово -> уходим проверять еще
296 - ; раз
297 - TST @R3; Проверим на ошибку
294 +5$: TSTB @R3 ; Let's check the ready bit
295 + BPL 5$; Not ready -> we go and check again once
296 + TST @R3; Let's check for an error
298 298   BMI ERR5
299 299  
300 300  ;....................................................................