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

Summary

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

Details

Page properties

Content

...	...	@@ -395,43 +395,37 @@
395	395	|(% style="width:136px" %)4|(% style="width:305px" %)fDate|(% style="width:242px" %)Date in MS-DOS format
396	396	|(% style="width:136px" %)6|(% style="width:305px" %)fTime|(% style="width:242px" %)Time in MS-DOS format
397	397	|(% style="width:136px" %)10|(% style="width:305px" %)fAttr|(% style="width:242px" %)Attributes 1 byte
	398	+|(% style="width:136px" %)10|(% style="width:305px" %)fName|(% style="width:242px" %)NAME.FILE TYPE, 8+1+3+1 = 13 bytes
398	398
399	399
400		-Смещение  Имя Значение
401		-0 fSize Размер файла в байтах, младшее слово
402		-2 старшее слово
403		-4 fDate Дата в формате MS-DOS
404		-6 fTime Время в формате MS-DOS
405		-10 fAttr Атрибуты 1 байт
406		-11 fName ИМЯ.ТИП файла, 8+1+3+1 = 13 байт
407		-\\Смещения указаны восьмеричные. Формула в строке fName означает, что там сначала должно быть имя, максимально из восьми символов, далее должна быть точка, далее тип, до трёх символов, и завершающий нулевой байт 0х00. Если тип не указан, точка тоже не нужна.
408		-\\Атрибуты файлов в байте fAttr (восьмеричные):
	401	+The offsets are specified in octal. The formula in the fName line means that there must first be a name, maximum of eight characters, then a period, then a type, up to three characters, and a terminating zero byte 0x00. If the type is not specified, the period is also not needed.
	402	+\\File attributes in fAttr byte (octal):
409	409	\\001 - Read Only
410	410	002 - Hidden
411	411	004 - System
412	412	020 - Directory
413	413	040 - Archive
414		-\\Пример программы.
	408	+\\Example program
415	415
416	416	{{code language="assembler"}}
417	417	;......................................
418		-RdDir = 013; код команды "Читать запись оглавления"
	412	+RdDir = 013; command code "Read table of contents entry"
419	419	RdBuf = 015
420	420
421	421	MOV #AZ$CSR,R3
422	422
423	423	15$: CLR @R3;
424		- TSTB @R3; Сбросим контроллер
	418	+ TSTB @R3; Reset the controller
425	425	BPL 15$;
426	426
427		- MOV #RdDir,@R3; Попросим контроллер
428		-16$: TSTB @R3; прочитать в свою память
429		- BPL 16$; запись оглавления
	421	+ MOV #RdDir,@R3; Ask the controller
	422	+16$: TSTB @R3; to read into its memory
	423	+ BPL 16$; table of contents entry
430	430
431	431	MOV @RdBuf,(R3)+;
432		- MOV DIRREC,R2; И перенесем ее к себе в
433		- MOV #11.,R1; область памяти, указатель
434		-17$: MOV @R3,(R2)+; на которую лежит в ячейке
	426	+ MOV DIRREC,R2; And transfer it to itself in
	427	+ MOV #11.,R1; memory area, pointer
	428	+17$: MOV @R3,(R2)+; to which lies in cell
435	435	SOB R1,17$; DIRREC.
436	436
437	437	;......................................
...	...	@@ -438,45 +438,46 @@
438	438	{{/code}}
439	439
440	440
441		-== **014: Размонтировать диск** ==
	435	+== 014: Unmount disk ==
442	442
443		-Код команды 014, чтобы размонтировать диск, следует сбросить контроллер, переслать в DR контроллера номер привода AZ, который следует размонтировать, и послать в CSR контроллера код 014, после чего дождаться окончания операции (она длительная) и проверить на ошибку. Ошибка выдается, если привод не был смонтирован.
444		-[[**//пример утилиты AZUMNT//**>>url:https://forum.maxiol.com/index.php?showtopic=5605&st=0&p=59418&#entry59418]]
	437	+Command code 014, to unmount the disk, you should reset the controller, send the AZ drive number to the controller DR, which should be unmounted, and send the 014 code to the controller CSR, then wait for the operation to complete (it takes a long time) and check for an error. An error is issued if the drive has not been mounted.
	438	+[[AZUMNT utility example>>url:https://forum.maxiol.com/index.php?showtopic=5605&st=0&p=59418&#entry59418]]
445	445
446	446
447		-== **015: Начать передачу считанного блока** ==
	441	+== 015: Start transferring the read block ==
448	448
449		-Код команды - 015. Получив эту команду, контроллер настраивается на пословную выдачу содержимого того самого встроенного буфера на 256 слов, которые будут выданы последовательно через регистр DR. Никаких ожиданий не требуется, просто пересылаем 256 раз слово из DR в последовательные ячейки памяти, и все. Если нужно меньше, чем 256 слов (последний укороченный блок файла), то остаток можно просто бросить, не считывая, сброс контроллера в начале следующей операции сбросит и этот остаток.
450		-\\Пример программы:
	443	+The command code is 015. Having received this command, the controller is configured to output word by word the contents of the same built-in buffer for 256 words, which will be output sequentially through the DR register. No waiting is required, we simply send a word from DR to sequential memory cells 256 times, and that's it. If less than 256 words are needed (the last shortened block of the file), then the remainder can simply be discarded without reading, resetting the controller at the beginning of the next operation will also reset this remainder.
	444	+\\Example program:
451	451
452	452	{{code language="assembler"}}
453	453	;..................................
454		-RdBuf=015; символическое наименование команды
	448	+RdBuf=015; symbolic name of the command
455	455
456		-; В R3 от предыдущего фрагмента остался адрес CSR
	450	+; In R3 from the previous fragment there is the address of the CSR
457	457	; (177220)
458	458
459		-; Считаем, что у нас в R2 находится адрес первого слова
460		-; памяти, куда следует разместить прочитанный блок.
461		-; Программа получения этого адреса не приводится.
	453	+; We assume that in R2 we have the address of the first word
	454	+; of memory, where the read block should be placed.
	455	+; The program for obtaining this address is not given.
462	462
463		- MOV #400,R1; Готовим счетчик слов
	457	+ MOV #400,R1; Prepare the word counter
464	464	; 0400 oct = 256 dec
465	465
466		- MOV #RdBuf,(R3)+; и пересылаем команду
467		-; RdBuf в CSR. Адрес в R3 укажет на DR (177222).
	460	+ MOV #RdBuf,(R3)+; and send the command
	461	+; RdBuf to the CSR. The address in R3 will point to DR (177222).
468	468
469		-3$: MOV @R3,(R2)+;перешлем очередное слово в
470		- ; память
471		- SOB R1,3$; и повторим это 256 (0400)
472		- ; раз
	463	+3$: MOV @R3,(R2)+we will send the next word to
	464	+; memory
	465	+ SOB R1,3$; and repeat this 256 (0400)
	466	+ ; times
473	473	;..................................
474	474	{{/code}}
475	475
476		-Всё, чтение закончено.
477		-\\Для записи наоборот, требуется сначала перенести весь блок данных из памяти ЦП в контроллер и потом выдать команду "Записать содержимое буфера на диск"
	470	+That's it, reading is complete.
478	478
	472	+To write the opposite way, you first need to transfer the entire data block from the CPU memory to the controller and then issue the command "Write the contents of the buffer to disk"
479	479
	474	+
480	480	== **016: Принять блок данных в буфер** ==
481	481
482	482	Код команды 016. Команда настраивает контроллер на прием блока данных и помещении его в буфер. Следующие 256 циклов записи в DR поместят данные, переданные через МПИ, в буфер.