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

Summary

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

Details

Page properties

Content

...	...	@@ -388,44 +388,49 @@
388	388	• Read 11 words of the table of contents entry from DR
389	389	\\The table of contents entry has the format:
390	390
391		-(% style="width:686px" %)
392		-|=(% style="width: 136px;" %)Offset (octal)|=(% style="width: 305px;" %)Name|=(% style="width: 242px;" %)Value
393		-|(% style="width:136px" %)0|(% style="width:305px" %)fSize|(% style="width:242px" %)File size in bytes, low word
394		-|(% style="width:136px" %)2|(% style="width:305px" %)fSize|(% style="width:242px" %)File size in bytes, high word
395		-|(% style="width:136px" %)4|(% style="width:305px" %)fDate|(% style="width:242px" %)Date in MS-DOS format
396		-|(% style="width:136px" %)6|(% style="width:305px" %)fTime|(% style="width:242px" %)Time in MS-DOS format
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
	391	+|= |= |=
	392	+| | |
	393	+| | |
	394	+| | |
	395	+| | |
	396	+| | |
399	399
400	400
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):
	399	+Смещение  Имя Значение
	400	+0 fSize Размер файла в байтах, младшее слово
	401	+2 старшее слово
	402	+4 fDate Дата в формате MS-DOS
	403	+6 fTime Время в формате MS-DOS
	404	+10 fAttr Атрибуты 1 байт
	405	+11 fName ИМЯ.ТИП файла, 8+1+3+1 = 13 байт
	406	+\\Смещения указаны восьмеричные. Формула в строке fName означает, что там сначала должно быть имя, максимально из восьми символов, далее должна быть точка, далее тип, до трёх символов, и завершающий нулевой байт 0х00. Если тип не указан, точка тоже не нужна.
	407	+\\Атрибуты файлов в байте fAttr (восьмеричные):
403	403	\\001 - Read Only
404	404	002 - Hidden
405	405	004 - System
406	406	020 - Directory
407	407	040 - Archive
408		-\\Example program
	413	+\\Пример программы.
409	409
410	410	{{code language="assembler"}}
411	411	;......................................
412		-RdDir = 013; command code "Read table of contents entry"
	417	+RdDir = 013; код команды "Читать запись оглавления"
413	413	RdBuf = 015
414	414
415	415	MOV #AZ$CSR,R3
416	416
417	417	15$: CLR @R3;
418		- TSTB @R3; Reset the controller
	423	+ TSTB @R3; Сбросим контроллер
419	419	BPL 15$;
420	420
421		- MOV #RdDir,@R3; Ask the controller
422		-16$: TSTB @R3; to read into its memory
423		- BPL 16$; table of contents entry
	426	+ MOV #RdDir,@R3; Попросим контроллер
	427	+16$: TSTB @R3; прочитать в свою память
	428	+ BPL 16$; запись оглавления
424	424
425	425	MOV @RdBuf,(R3)+;
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
	431	+ MOV DIRREC,R2; И перенесем ее к себе в
	432	+ MOV #11.,R1; область памяти, указатель
	433	+17$: MOV @R3,(R2)+; на которую лежит в ячейке
429	429	SOB R1,17$; DIRREC.
430	430
431	431	;......................................
...	...	@@ -432,46 +432,45 @@
432	432	{{/code}}
433	433
434	434
435		-== 014: Unmount disk ==
	440	+== **014: Размонтировать диск** ==
436	436
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]]
	442	+Код команды 014, чтобы размонтировать диск, следует сбросить контроллер, переслать в DR контроллера номер привода AZ, который следует размонтировать, и послать в CSR контроллера код 014, после чего дождаться окончания операции (она длительная) и проверить на ошибку. Ошибка выдается, если привод не был смонтирован.
	443	+[[**//пример утилиты AZUMNT//**>>url:https://forum.maxiol.com/index.php?showtopic=5605&st=0&p=59418&#entry59418]]
439	439
440	440
441		-== 015: Start transferring the read block ==
	446	+== **015: Начать передачу считанного блока** ==
442	442
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:
	448	+Код команды - 015. Получив эту команду, контроллер настраивается на пословную выдачу содержимого того самого встроенного буфера на 256 слов, которые будут выданы последовательно через регистр DR. Никаких ожиданий не требуется, просто пересылаем 256 раз слово из DR в последовательные ячейки памяти, и все. Если нужно меньше, чем 256 слов (последний укороченный блок файла), то остаток можно просто бросить, не считывая, сброс контроллера в начале следующей операции сбросит и этот остаток.
	449	+\\Пример программы:
445	445
446	446	{{code language="assembler"}}
447	447	;..................................
448		-RdBuf=015; symbolic name of the command
	453	+RdBuf=015; символическое наименование команды
449	449
450		-; In R3 from the previous fragment there is the address of the CSR
	455	+; В R3 от предыдущего фрагмента остался адрес CSR
451	451	; (177220)
452	452
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.
	458	+; Считаем, что у нас в R2 находится адрес первого слова
	459	+; памяти, куда следует разместить прочитанный блок.
	460	+; Программа получения этого адреса не приводится.
456	456
457		- MOV #400,R1; Prepare the word counter
	462	+ MOV #400,R1; Готовим счетчик слов
458	458	; 0400 oct = 256 dec
459	459
460		- MOV #RdBuf,(R3)+; and send the command
461		-; RdBuf to the CSR. The address in R3 will point to DR (177222).
	465	+ MOV #RdBuf,(R3)+; и пересылаем команду
	466	+; RdBuf в CSR. Адрес в R3 укажет на DR (177222).
462	462
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
	468	+3$: MOV @R3,(R2)+;перешлем очередное слово в
	469	+ ; память
	470	+ SOB R1,3$; и повторим это 256 (0400)
	471	+ ; раз
467	467	;..................................
468	468	{{/code}}
469	469
470		-That's it, reading is complete.
	475	+Всё, чтение закончено.
	476	+\\Для записи наоборот, требуется сначала перенести весь блок данных из памяти ЦП в контроллер и потом выдать команду "Записать содержимое буфера на диск"
471	471
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"
473	473
474		-
475	475	== **016: Принять блок данных в буфер** ==
476	476
477	477	Код команды 016. Команда настраивает контроллер на прием блока данных и помещении его в буфер. Следующие 256 циклов записи в DR поместят данные, переданные через МПИ, в буфер.