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

Summary

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

Details

Page properties

Content

...	...	@@ -445,84 +445,83 @@
445	445
446	446	{{code language="assembler"}}
447	447	;..................................
448		-RdBuf=015; symbolic name of the command
	448	+RdBuf=015; символическое наименование команды
449	449
450		-; In R3 from the previous fragment there is the address of the CSR
	450	+; В 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.
	453	+; Считаем, что у нас в R2 находится адрес первого слова
	454	+; памяти, куда следует разместить прочитанный блок.
	455	+; Программа получения этого адреса не приводится.
456	456
457		- MOV #400,R1; Prepare the word counter
	457	+ 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).
	460	+ MOV #RdBuf,(R3)+; и пересылаем команду
	461	+; 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
	463	+3$: MOV @R3,(R2)+;перешлем очередное слово в
	464	+ ; память
	465	+ SOB R1,3$; и повторим это 256 (0400)
	466	+ ; раз
467	467	;..................................
468	468	{{/code}}
469	469
470		-That's it, reading is complete.
	470	+Всё, чтение закончено.
	471	+\\Для записи наоборот, требуется сначала перенести весь блок данных из памяти ЦП в контроллер и потом выдать команду "Записать содержимое буфера на диск"
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	+== **016: Принять блок данных в буфер** ==
474	474
475		-== 016: Receive data block into buffer ==
	476	+Код команды 016. Команда настраивает контроллер на прием блока данных и помещении его в буфер. Следующие 256 циклов записи в DR поместят данные, переданные через МПИ, в буфер.
	477	+\\Пример программы.
476	476
477		-Command code 016. The command sets the controller to receive a block of data and place it in the buffer. The next 256 write cycles to DR will place the data transferred via the QBUS in the buffer.
478		-\\Example program:
479		-
480	480	{{code language="assembler"}}
481	481	;..................................
482	482
483		-WrBuf=016; Symbolic name of the command
	482	+WrBuf=016; Символическое наименование команды
484	484
485		-; Before writing, you need to perform the same actions as in
486		-; pp. 3.1.-3.3. Usually, this is the same program,
487		-; just after point 3.3. a check is performed "What
488		-; is required: reading or writing?" and a branch is made to the
489		-; reading or writing program.
	484	+; Перед записью нужно выполнить те же действия, что и в
	485	+; пп. 3.1.-3.3. Обычно, это одна и та же программа,
	486	+; просто после пункта 3.3. выполняется проверка "Что
	487	+; требуется: чтение или запись?" и разветвление на
	488	+; программу чтения или записи.
490	490
491		-; After the fragment in point 3.3., the CSR address
492		-; (177220) remains in R3. We will assume that R2 contains the address in the CPU
493		-; memory where the block to be written is located.
494		-; The program for obtaining this address is not shown.
	490	+; После фрагмента в п. 3.3. в R3 остался адрес CSR
	491	+; (177220). Будем считать, что в R2 находится адрес в
	492	+; памяти ЦП, где находится блок, подлежащий записи.
	493	+; Программа получения этого адреса не показана.
495	495
496		- MOV #400,R1; Preparing the counter
	495	+ MOV #400,R1; Готовим счетчик
497	497
498		- MOV #WrBuf,(R3)+; Let's forward the command to the CSR and
499		-; switch the address in R3 to
500		-; DR
	497	+ MOV #WrBuf,(R3)+; Перешлем команду в CSR и
	498	+ ; переключим адрес в R3 на
	499	+ ; DR
501	501
502		-4$: MOV (R2)+,@R3; Let's forward the next word
503		-; data
504		- SOB R1,4$; and repeat this 256 times
	501	+4$: MOV (R2)+,@R3; Перешлем очередное слово
	502	+ ; данных
	503	+ SOB R1,4$; и повторим это 256 раз
505	505	;..................................
506	506	{{/code}}
507	507
508		-== 017: Get ramdisk size, large ==
	507	+== **017: Получить размер псевдодиска, большой** ==
509	509
510		-There are two commands to get the size of a pseudo-disk, i.e. the AZn file-image mounted on the selected pseudo-drive.
511		-\\If the OS being used (or a program working with disks without an OS) can work with large (more than 32M) disks, you should use the command with the code 017. The sequence of actions: reset the controller (p. 3.1), select the drive (p. 3.2) and send the code 017 to the CSR, and then, without any waiting, read from DR first the lower word, and then the higher word of the size of the selected drive (image file).
512		-\\If the OS you are using cannot work with disks larger than 32M (RT-11), you should use the 007 command - get the pseudo-disk size with a limit of up to 32M. The steps are similar: reset the controller, select the disk, send the 007 code to the CSR and read one word of the pseudo-disk size from DR. If the size of the image file mounted on the selected pseudo-drive is larger than 65534 blocks, the controller returns the number 65534 instead of this "large" size. We remind you that the number 65535 is used in some places for special purposes and cannot be the disk size.
513		-\\We also remind you that if the image file is not mounted on this drive, the sequence of actions will not work (command 001 select device) and the program execution will simply not reach this point. Therefore, these commands do not provide for errors.
514		-\\Example of a program with large disks
	509	+Есть две команды получения размера псевдодиска, т.е. смонтированного на выбранный псевдопривод AZn файл-образа.
	510	+\\Если используемая ОС (или программа, работающая с дисками без ОС) умеет работать с большими (больше 32М) дисками, следует пользоваться командой с кодом 017. Последовательность действий: сбросить контроллер (п. 3.1), выбрать накопитель (п. 3.2) и переслать в CSR код 017, а затем, без каких-либо ожиданий, считать из DR сначала младшее, и следом за ним старшее слово размера выбранного накопителя (файл-образа).
	511	+\\Если используемая ОС не умеет работать с дисками бОльшими, чем 32М (RT-11), следует пользоваться командой 007 - получить размер псевдодиска с ограничением до 32М. Действия похожие: сбрасываем контроллер, выбираем диск, посылаем в CSR код [[007>>doc:||anchor="H007:41F43E43B44344743844244C44043043743C43544043F44143543243443E43443844143A430"]] и считываем из DR одно слово размера псевдодиска. Если размер файл-образа, смонтированного на выбранный псевдопривод, больше 65534 блоков, вместо этого "большого" размера, контроллер возвращает число 65534. Напоминаем, что число 65535 кое-где используется в специальных целях и не может быть размером диска.
	512	+\\Также напоминаем, что если на этот накопитель не смонтирован файл-образ, последовательность действий не пройдет (команда 001 выбор устройства) и исполнение программы до этого места просто не дойдет. Поэтому ошибок у этих команд не предусмотрено.
	513	+\\Пример программы с большими дисками
515	515
516	516	{{code language="assembler"}}
517	517	;......................................
518	518
519		-GetBig=017; Get the "big" disk size
	518	+GetBig=017; Получить "большой" размер диска
520	520
521		-; From fragment 3.2 (disk selection) we have in R3
522		-; DR address (177222)
	520	+; От фрагмента 3.2 (выбор диска) у нас в R3 остался
	521	+; адрес DR (177222)
523	523
524		- MOV #GetBig,-(R3); send the command
525		- TST (R3)+; return the address in R3 back to DR
	523	+ MOV #GetBig,-(R3); пошлем команду
	524	+ TST (R3)+; вернем адрес в R3 назад, на DR
526	526	MOV @R3,BigSiz
527	527	MOV @R3,BigSiz+2
528	528	;......................................