Здесь приведен перевод документации [1], рассматривающей особенности использования операционной системы extended BASIC совместно с Interface 1bis [2] для ZX Spectrum. Этот документ может использоваться как краткое руководство по использованию extended BASIC в контексте ввода/вывода файлов и данных, более полное руководство см. в оригинальной документации (см. doc \ ZXInterface1_Microdrive_Manual.pdf в архиве [3]).

[1. Совместимость]

Interface 1bis (IF1bis) является интерфейсом к устройствам хранения и обмена данными, совместимым с Sinclair 'ZX INTERFACE 1' на уровне команд BASIC, а также на уровне "хак-кодов" (Hook codes).

• Используется тот же самый механизм для расширения интерпретатора BASIC: страничная замена теневым ПЗУ (shadow ROM) базового ПЗУ микропрограмм (BASIC ROM) всякий раз, когда происходит ошибка синтаксиса.
• Одинаковый синтаксис extended BASIC.
• Одинаковые системные переменные.
• Тот же самый механизм для доступа к подпрограммам shadow ROM: 'Hook codes'.
• Те же структуры для обработки последовательного доступа к файлам - через канал M (M channel), и к сетевому обмену данными - через канал N (N channel).

[2. Распределение памяти]

Будучи активированным, интерфейс запрещает внутреннее ПЗУ ZX Spectrum, и подключает вместо него страницу своей собственной памяти с операционной системой (OpSys), которая размещается в двух непрерывных банках энергонезависимой памяти (NVSRAM) по 16 килобайт каждый. При этом получается следующая карта памяти:

2.1 BASIC ROM

Это незначительно модифицированная копия оригинального ZX Spectrum 48k ROM, диапазон изменений ограничен следующим:

- Разрешается программное управление страницами памяти для операции ввода/вывода в выделенные для управления порты.
- Перехватываются вызовы к подпрограммам, взаимодействующим с лентой, чтобы правильно работать с .TAP файлами.
- Модифицирована обработка NMI, чтобы позволить создавать снапшоты (.Z80), и опционально Осуществлять интеграцию с драйвером принтера ESC/P в ZX Spectrum BASIC.
- Исправлены некоторые известные баги ZX Spectrum 48k ROM.

2.2 Shadow ROM

Shadow ROM полностью совместимо с 8 килобайтным ROM оригинального Sinclair 'ZX INTERFACE 1' на уровне команд BASIC и на уровне 'hook code'. Не реализованы следующие hook-коды:

2.3. Рабочее ОЗУ

Рабочее ОЗУ (work RAM) структурировано следующим образом:

Внутренний стек используется для работы со снапшотами (.Z80) или для загрузки ленточных файлов (tape file, .TAP).

2.4 Буферы

Имеется 7 буферов сектора по 512 байт, область данных приложения (application data) из 256 байт и таблица текущей директории.

[3. Extended BASIC]

3.1 Синтаксис

Реализованы все расширенные операторы 'ZX INTERFACE 1' extended BASIC в своем оригинальном формате, причем добавлены некоторые расширения синтаксиса.

3.1.1 CAT [#< str >;]{*}[< dev >;][< drv >][;< fil >|< pth >] [ABS|NOT|LN]
3.1.2 CLEAR #
3.1.3 CLOSE #< str >
3.1.4 CLS #
3.1.5 ERASE < spe >|#< hdl >
3.1.6 FORMAT [#< csz >;]{*}[< dev >;][< drv >] [NOT]
3.1.7 FORMAT [#< rsd >;]{*}[< dev >;] 0 [NOT]
3.1.8 FORMAT "B";< brt >
3.1.9 FORMAT "N";< sta >;< sid >
3.1.10 INKEY$ #< str >
3.1.11 INPUT #< str >,< var >
3.1.12 LOAD < chn >|#< hdl > [< opt >]
3.1.13 LOAD [[*< dev >;]< drv >];< pth >
3.1.14 LOAD STOP
3.1.15 MERGE < chn >|#< hdl >
3.1.16 MOVE < spe >|< nfc >|#< str > TO|AT|OVER|IN|MERGE < spe >|< nfc >|#< str >
3.1.17 MOVE #< str >|#< hdl > VAL
3.1.18 MOVE #< str >|#< hdl > POINT [< pnt >]
3.1.19 OPEN #< str >;{*}[[< dev >;]< drv >];< fil > [IN|OUT|OVER|RND]
3.1.20 OPEN #< str >;< nfc >
3.1.21 PRINT #< str >;< exp >
3.1.22 SAVE < chn >|#< hdl > [< opt >]
3.1.23 SAVE [[*< dev >;]< drv >];< pth >
3.1.24 SAVE STOP
3.1.25 VERIFY < chn >|#< hdl > [< opt >]
3.1.26 VERIFY STOP

Здесь:

< str > = Stream, поток (0-15)
< hdl > = Handle, хендл (0-15)
< chn > = Channel, канал
        = [*< dev >;][< drv >];< fil >
< nfc > = Non-file channel, не файловый канал
        = {*}"B"|"T"
        = {*}"N";< sta >
< spe > = Спецификатор
        = {*}[< dev >;][< drv >];< fil >|< pth >
< dev > = Спецификатор устройства (device)
        = < typ >[< sta >]
< typ > = Буква типа устройства
        = M flash "M"icrodrive
        = R "R"AM drive
        = V ser"V"er drive
< sta > = Номер станции (устройства), 0-7
        = 0 локальная станция
        = 1..7 станция, подключенная через IP-сеть
< drv > = Номер привода (drive number), 1-255
< fil > = Файл (состоит из 1-254 символов)
        = [< pth >]< nam >[.< fty >]
< dir > = Директория (1-254 символов)
        = < nam >/
< pth > = Путь (1-254 символов)
        = [/]< dir >< dir >..< dir >
< nam > = Имя (1-254 символов)
< fty > = Буква типа файла (1 символ), подробнее см. раздел 3.4.
< opt > = опции для команд SAVE, LOAD или VERIFY
        = LINE < lin >
        = DATA < ary >[$]()
        = CODE [< add >[,< len >{,< pnt >}]]
        = SCREEN$
        = BIN [< add >[,< len >[,< pnt >]]]
< lin > = Номер строки для автозапуска программы BASIC (0-9999)
< ary > = Имя массива
< add > = Адрес блока памяти (0-65535)
< len > = Длина блока памяти (0-65535)
< pnt > = Указатель позиции в файле (File pointer)
        = < rec >[,< pos >]
< rec > = Номер записи (0-32767)
< pos > = Позиция внутри записи (0-511)
< var > = Переменная BASIC
< exp > = Выражение BASIC
< csz > = Единица памяти в секторах/кластерах (2, 4, 8, 16)
< rsd > = Количество зарезервированных приводов (1-127)
< brt > = Скорость (baud rate) в единицах бит/сек (0-65535)
< sid > = Имя или IP-адрес (1-254 символов)

Элементы синтаксиса в квадратных скобках не обязательны. Элементы синтаксиса в фигурных скобках принимаются, но не используются. Альтернативные элементы синтаксиса отделены друг от друга символом вертикальной линии.

Хендл (handle) файла это поток, открытый на файле, с использованием опции RND.

Позиция внутри записи: < pos > может быть указана в диапазоне (0..65535), потому что указатель всегда автоматически нормализуется:

   < rec > = < rec >+int(< pos >/512)
   < pos > = mod(< pos >,512)

Начальный символ '*', за которым не идет буква типа устройства, означает "M". Начальный символ '@', за которым не идет буква типа устройства, означает "E". Начальный символ '!' означает "R";1. Начальный символ '$' означает "V";1.

3.2 Устройства (Device) и каналы (Channel)

3.2.1 Устройства хранения (Storage devices)

3.2.2 Устройства обмена данными (Communication devices)

3.2.3 Каналы

3.3 Имена файлов

Полные имена могут быть составлены из сегментов, отделенных друг от друга символом слеша "/". Последний из сегментов предоставляет реальное имя файла, в то время как промежуточные сегменты составляют путь к файлу. Для блочного устройства значимы только первые 10 символов сегмента. Общая длина пути ограничена 254 символами.

Имя, оканчивающееся на "/", представляет имя директории.

У имен файлов как расширение в конце может быть буква типа файла, идущая через точку.

Начальный символ "/" обозначает корневую директорию диска, и "../" означает родительскую директорию по отношению к текущей директории.

Для файлового устройства пути "/A/", "/C/".."/Z/" представляют приводы A, C .. Z сервера. Также допустимо использовать альтернативную форму "a:/" и т. п.

Когда не создается новый файл, в для обычных имен можно использовать групповые символы (wild cards) "?" (означает "любой символ") и "*" (означает "любое количество любых символов"), за исключением каналов и хендлов, но не в именах директорий и не в составе пути.

Имена файлов чувствительны к регистру символов.

3.4 Типы файлов

3.4.1 BASIC-файлы

Чтобы можно было получить доступ к этим файлам через команды SAVE, LOAD и VERIFY, эти файлы содержат заголовок из 9 байт, со следующей структурой:

0 тип файла (0-3).
1-2 длина файла (не считая длины заголовка).
3-4 адрес загрузки (Code, для двоичного кода).
5-6 длина только программы (Program, для программы BASIC) или имя массива (цифровое или буквенное).
7-8 стартовая строка (Program, для программы BASIC).

3.4.2 Обычные (Regular) файлы

Максимальная длина обычного файла составляет 16 мегабайт (32768 записей, каждая по 512 байт).

3.4.3 Файлы эмулятора

3.4.4 Зарезервированные типы файлов

Номера типов 12, 13 и 14 зарезервированы. Тип 15 это групповой тип (type wild card), что означает "любой тип".

3.4.5 Директории (тип 16)

Директории это специальные файлы, к которым можно получить доступ командами: LOAD что означает 'поменять текущую директорию', SAVE что означает 'создать', и DELETE.

3.5 Сообщения об ошибках

Сообщения об ошибках те же самые, что и у оригинального ZX INTERFACE 1, за исключением следующих:

3.6 Другие вопросы синтаксиса

3.6.1 Значения по умолчанию

Будут использоваться значения по умолчанию для литеры устройства < dev >, литеры тома < sta > и номера привода < drv >, которые были указаны в последними в операторе.

Для оператора 3.1.1 значение по умолчанию < str > будет 2.

Для оператора 3.1.6 значение по умолчанию < csz > будет сохраненное на носителе, когда привод форматировался последний раз, иначе будет 8.

[4. Структуры данных]

4.1 Системные переменные ZX INTERFACE 1

Примечание: не показанные в таблице переменные не используются.

4.1.1 FLAGS3

Биты 0-4 означают то же самое, что и в оригинальном 'Shadow ROM' ZX INTERFACE 1.

Бит 0 в Shadow ROM произведен вход второй раз для той же самой ошибки.

Бит 1 в Shadow ROM производен вход первый раз после создания новых системных переменных, или выполняется команда CLEAR#.

Бит 2 в Shadow ROM произведен вход посредством hook-кода.

Бит 3 выполняется команда CAT.

Бит 4 выполняется команда MOVE по принципу перемещения символа за символом, или имя места назначения (Destination) в команде MOVE содержит групповые символы (wild cards), или в команде CAT было указано имя файла, или было произведено подавление автозапуска загруженной программы BASIC, или опция SAVE / LOAD указана в верхнем регистре.

Бит 5 выполняется SAVE / LOAD / VERIFY канала H(andle).

Бит 6 найдено последнее совпадение (last match) операции поиска.

Бит 7 найдено следующее совпадение (next match) операции поиска.

4.1.2 VECTOR и SER_FL

То же самое, что и в оригинальном 'Shadow ROM' ZX INTERFACE 1.

4.1.3 Спецификаторы файла

Два 8-байтных спецификатора файла в DSTR_1 и DSTR_2 осуществляют ту же функцию, что и в оригинальном ZX INTERFACE 1 'Shadow ROM', за исключением старшего байта номера привода, который используется для хранения длины имени пути, и старшего байта длины имени файла, который используется для сохранения типа файла.

4.1.4 BASIC header: HD__00 .. HD__11

То же самое, что и в оригинальном 'Shadow ROM' ZX INTERFACE 1.

4.1.5 HD__DV и HD__DR

Заменены старший байт HD_11 high и COPIES. Здесь сохраняются номер устройства (device) и привода (drive).

4.2 Дескриптор канала M

4.3 Дескриптор канала N

4.4 Рабочее ОЗУ (Work RAM, 512 байт)

Отображено на адрес #2E00 теневого ПЗУ (Shadow ROM).

4.4.1 Главный дескриптор логического диска (13 байт)

4.4.2 Альтернативный дескриптор логического диска (13 байт)

Такая же структура, как и главного дескриптора.

4.4.3 Номера блока по умолчанию и файлового устройства (2 байта)

4.4.4 Размеры носителя данных Flash, в логических приводах (8 байт)

4.4.5 Запасное пространство инициализированных переменных (12 байт)

4.4.6 Указатели буферов секторов (16 байт)

4.4.7 Переменные вывода на ленту (Output tape), 10 байт

4.4.8 Переменные для ввода с ленты (Input tape), 10 байт

4.4.9 Переменные снапшота (10 байт)

4.4.10 Указатель на буфер принтера (2 байта)

4.4.11 Дескриптор файлового устройства (16 байт)

4.4.12 Вспомогательная переменная (Auxiliary), 4 байта

4.4.13 Номер блока Flash-привода (6 байт)

4.4.14 Параметры для места назначения файла операции Copy/Rename (5 байт)

4.4.15 Временный буфер для имени файла (11 байт)

4.4.16 Место для записи директории (6 байт)

4.4.17 Внутренний стек (48 байт)

4.4.18 Буфер принтера (64 байта)

4.4.19 Буфер страницы (256 байт)

4.5 Буферы секторов (4 килобайта)

4.5.1 Буферы секторов

4.5.2 Данные приложения (256 байт)

4.5.3 Текущая таблица директорий (256 байт)

В этой таблице хранится информация по последним 64 директориям блочного устройства.

[5. Файловые системы]

Реализованы две различные файловые системы:

- Блочные устройства (Block devices): память на flash-карте SD и диск в ОЗУ (RAM drive).
- Файловые устройства (File devices): компьютеры, на которых работает соответствующее приложение сервера.

5.1 Протокол обмена

К устройствам хранения осуществляется доступ через "запрос блоков" ('request blocks'), отправляемый периферийному контроллеру, который обрабатывает все низкоуровневые операции ввода/вывода. Структура блока команды следующая:

После обработки этой команды периферийный контроллер посылает обратно блок ответа ('reply block'):

5.2 Устройства обмена данными (Communication devices)

Тот же самый протокол используется для обмена с устройствами, не являющимися устройствами хранения:

- Асинхронный последовательный порт
- Порт Ethernet

Протокол реализован для следующих команд:

Команда передачи последовательного порта (параметр 1) посылает 1-512 байт данных. Максимальное количество байт, принимаемых последовательным портом, может быть указано (команда с параметром 2) длиной в диапазоне 1-256.

Длина данных для команд передачи и приема Ethernet ограничена 255 байтами. Для обмена данными через сеть IP у следующих команд имеется 4-байтное расширение заголовка:

5.3 Блочные устройства

Блочное устройство бывает следующих типов:

- Локальное, local (station 0): это встроенная карта памяти microSD или диск в ОЗУ (RAM drive).
- Сетевое, remote (station 1-7): карта microSD интерфейса станции, подключенного к сети IP. 

5.3.1 Возможности файловой системы

Карта microSD неявно поделена на логические диски фиксированного размера 32 мегабайт (65536 секторов по 512 байт). Размер карты ограничен 255 логическими дисками, т. е. 8 гигабайтами. Блок памяти на диске (allocation unit, кластер) может быть размером 2, 4, 8 или 16 секторов.

FAT содержит (65536 / размер кластера) записей, занимающих сектора от 1 до (256 / размер кластера). Сектор номер (256 / размер кластера) + 1 содержит первую запись корневой директории (root directory).

Диск в ОЗУ (RAM drive) имеет емкость 256 секторов = 128 килобайт. Размер его кластера составляет 1 сектор. Сектор 1 содержит FAT, и сектор 2 содержит первую запись корневой директории.

Логические диски отформатированы в соответствии с упрощенной 16-битной системой FAT. У этой FAT пронумерованы сектора, а не кластеры. Сектор 0 любого логического диска не используется. Поскольку кластер 0 всегда занят под FAT, соответствующая запись FAT (байты 0 и 1 сектора 1) используются для хранения размера кластера.

Поскольку сектора 0 и 1 недоступны для выделения, то соответствующие значения записи FAT используются для маркировки: 0000 свободный кластер, 0001 последний кластер файла.

Директории содержат последовательности 16-байтных спецификаторов файла:

Здесь байт #FF используется в качестве маркета окончания последовательности.

Размер директории/поддиректории ограничивается только доступным местом и глубиной дерева директорий. Максимальная длина имени пути ограничена 255 байтами.

Первый элемент первой записи директории имеет следующую структуру:

Когда файл удален, его родительская директория уплотняется на 16 байт путем исправления соответствующей записи и сдвига всех остальных записей справа от записи удаленного файла.

5.3.2 Команды блочного устройства

5.3.3 Замечания

- 'Адрес' это 4-байтный номер сектора.

- Номер сектора с установленным самым старшим битом (31) интерпретируется как адрес диска ОЗУ (RAM drive).

- 'Идентификатор' это 8-байтная строка идентификатора карты, за которой следует 4-байтная емкость карты (последний номер сектора).

- 'Сектор' это блок данных из 512 байт.

- Запись сектора требует 2 шагов:

1. Указать номер сектора командой 'Установка адреса записи' (параметр 5).
2. Послать данные командой 'Записать сектор' (параметр 10).

- Команда 'Записать из буфера' (11) запишет сектор, который был ранее прочитан предыдущей командой 'Прочитать в буфер' (9).

- Стирание блока (erase) требует 3 шагов:

1. Указать начало блока командой 'Первый адрес стирания' (13).
2. Указать конец блока командой 'Последний адрес стирания' (14).
3. Послать команду 'Стереть блок' (15), чтобы реально выполнилось стирание блока.

- Команда 'Прием - запись' (4) отправляет команду 'Прочитать сектор' в файловое устройство, з записывает принятый блок по указанному адресу блочного устройства.

- Команда 'Чтение - передача' (7) читает блок по указанному адресу из блочного устройства и посылает его в файловое устройство выдачей команды 'Записать сектор' (10).

- После команды 'Прочитать несколько блоков' (6) поток байт может быть прочитан со скоростью инструкции INI (16 T-состояний), пока это не будет остановлено повторной выдачей команды (с произвольным адресом). Указатель чтения в любое время может быть переставлен на начало блока, если подать ту же самую команду без адреса.

- Команда 'Проиграть tape-файл' (3) нуждается в качестве данных:

5.3.4 Разделение больших последовательных файлов

Чтобы иметь возможность использовать файлы мультимедиа (типы 12-14) размером до 4 гигабайт, команда 3.1.7 может быть использована для резервирования < rsd > (1- 127) логических дисков, с целью разделение больших последовательных файлов, что также относится к пространству носителя данных карты SD, которое превышает максимальный размер тома 8 гигабайт.

Директория раздела сохраняется начиная с сектора 0 логического диска: (< размер тома в секторах >/65536 - < rsd > + 1), и распространяется на 4 сектора, так что может содержать максимум 128 записей следующей структуры:

Байт #FF обозначает конец записей. 

Это сопровождается файлами, сохраненными друг за другом в том порядке, в каком они появляются в директории.

Номер сектора первой записи файла должен быть вычислен парсингом директории и добавлением 4 + накопленная длина, предшествующая началу раздела. 

5.4 Файловые устройства

Файловое устройство может быть следующих видов: 

- Локальное (станция 0): это компьютер сервера, подключенный через порт USB.
- Сетевое (станции 1-7): машина сервера, подключенная через сеть.

5.4.1 Команды файлового устройства

5.4.2 Замечания

- 'Handle' это число в диапазоне 0-15.

- 'Type' это число в диапазоне 0-15, определенное в п. 3.4.

- 'Постоянный файл' выделяет handle = 1-15. Тот же самый handle не выделяется, пока файл не будет явно закрыт.

- 'Временный файл' всегда выделяет handle = 0. Создание или открытие другого 'временного файла' автоматически закрывает предыдущий временный файл.

- Функция 'Открыть зарезервированный handle' создает файл, указанный, когда handle был зарезервирован, с заданным типом.

- Для команды 'Установить указатель в файле' можно указать позицию в файле либо двумя, либо четырьмя байтами: [< Pos >]< Rec >, где < Pos >= указателю записи (0-511) и < Rec >= номеру записи (0-32767). Если был отправлен только 1 байт, то указатель устанавливается на начало файла, и его handle и длина будут возвращены в ответе пятью байтами.

- Команда 'Получить длинное имя' возвратит длинное имя последнего файла, найденного командой 'Найти [следующий] файл'.

5.4.3 Возврат команд 'Найти [next] файл'

Команды 'Найти файл' и 'Найти следующий файл' возвратят 16-байтный дескриптор:

5.4.4 Возврат команд 'Открыть временный файл', 'Открыть постоянный файл' и 'Открыть следующий файл'

Дескриптор, возвращаемый командой 'Open temporary|permanent [next] file', содержит также handle файла:

5.4.5 Возврат команд 'Создать временный файл' и 'Создать постоянный файл'

Хендл, который возвращают команды 'Create temporary|permanent file', это двухбайтный номер в диапазоне 0-15.

После команды 'Найти файл' или 'Открыть временный файл' последующая команда 'Найти следующий файл' или 'Открыть следующий файл' сделает попытку найти/открыть следующий файл, который совпадет с заданным именем.

5.4.6 Операция копирования/переименования (copy|rename) требует 2 шагов:

- Исходный файл находится выдачей команды 'Find [next] file' (Найти [следующий] файл).
- Имя назначения указывается командой 'Rename file' (Переименовать файл) или 'Copy file' (Копировать файл).

5.4.7 Список возврата команд 'Первый|Следующий список файлов'

Список, который возвращает команда 'First|Next file list', это последовательность 16-байтных дескрипторов файлов, как они возвращаются командой 'Find [next] file' (Найти [следующий] файл), с маркером #FF, обозначающим конец списка. Дескрипторы, которые возвращает команда 'First|Next BASIC file list' (Первый|Следующий список BASIC-файлов) для типов файлов 0-3, также содержат информацию из 9-байтного заголовка файлов BASIC:

5.4.8 Возврат команд 'Первая строка длинного имени' и 'Следующий список файлов/строка'

Команды 'First long name line' и 'Next file list/line' возвращают то же самое, что и команды 'First directory list' и 'Next directory list' соответственно, но вернут один список директории в следующем формате:

[6. Hook-коды]

Ниже в таблице приведены hook-коды ZX INTERFACE 1.

Дополнительные hook-коды:

Здесь 'File type literal (буква типа файла) это символ, определенный в п. 3.4, 'Device type literal' (буква типа устройства) это символ, определенный в п. 3.2.

'Device code' (код устройства) это байт, определенный следующим образом:

6.1 Консольный ввод (#1B)

6.1.1 Действие: ожидание нажатия на клавишу
6.1.2 Входные данные: отсутствуют
6.1.3 Выходные данные:
- (A) = код символа

6.2 Консольный вывод (#1C)

6.2.1 Действие: послать символ на экран
6.2.2 Входные данные:
- (A) = код символа
6.2.3 Выходные данные: отсутствуют

6.3 Ввод RS232 (#1D)

6.3.1 Действие: прием символа, поступающего снаружи, с таймаутом после 1 секунды
6.3.2 Входные данные: отсутствуют
6.3.3 Выходные данные:
- CY = принятый символ
- (A) = код символа

6.4 Вывод RS232 (#1E)

6.4.1 Действие: отправить символ наружу, с бесконечным ожиданием
6.4.2 Входные данные:
- (A) = код символа
6.4.3 Выходные данные: отсутствует

6.5 Вывод на принтер (#1F)

6.5.1 Действие: напечатать символ на принтере
6.5.2 Входные данные:
- (A) = код символа
6.5.3 Выходные данные: отсутствуют

6.6 Опрос клавиатуры (#20)

6.6.1 Действие: проверить, нажата ли клавиша
6.6.2 Входные данные: отсутствуют
6.6.3 Выходные данные:
- CY = нажатая клавиша

6.7 Выбор привода/диска (стандартного, legacy) (#21)

6.7.1 Действие: установить (A) в качестве текущего устройства (DEV_LT)
6.7.2 Входные данные:
- (A) = Номер привода/диска (1-255)
- (DEV_LT) = Буква типа устройства или код устройства
6.7.3 Выходные данные: отсутствуют

6.8 Открыть канал (#22)

6.8.1 Действие: открытие канала
6.8.2 Входные данные:

Файловый канал

- (A) = #BF (IN) - открыть для чтения
= #DE (OVER) - перезапись
= #DF (OUT) - открыть для записи
= #A5 (RND) - создать handle для файла
- (DRV_NR) = номер привода (диска) (1-255)
- (DEV_LT) = буква типа устройства или код устройства
- (NAM_LN) = длина имени файла (1-254)
- (FIL_TY) = буква типа файла
- (NAM_AD) = адрес имени файла (0-65535)

Не-файловый канал

- (DRV_NR) = номер станции (0-7) только для канала N
- (DEV_LT) = тип канала: B, T, N или U
- (NAM_LN) = недопустимая длина имени (0 или 255)

6.8.3 Выходные данные:
- (HL) = смещение канала
- (IX) = адрес дескриптора канала

6.9 Закрыть канал (#23)

6.9.1 Действие: закрытие канала
6.9.2 Входные данные:
- (IX) = Адрес дескриптора канала
6.9.3 Выходные данные: отсутствуют

6.10 Удалить файл (#24)

6.10.1 Действие: удаляет файл
6.10.2 Входные данные:
Параметры файла, указанные дескриптором или хендлом.

Дескриптор:

- (DRV_NR) = номер привода (1-255)
- (DEV_LT) = буква тип устройства или код устройства
- (NAM_LN) = длина имени файла (1-254)
- (FIL_TY) = буква типа файла
- (NAM_AD) = адрес имени файла (0-65535)

Handle:

- (STR_NR) = handle (0-15)
- (NAM_LN) = недопустимая длина имени (0 или 255)

6.10.3 Выходные данные: отсутствуют

6.11 Последовательное чтение (#25)

6.11.1 Действие: прочитать следующую запись
6.11.2 Входные данные:
- (IX) = Адрес дескриптора канала
6.11.3 Выходные данные: отсутствуют

6.12 Последовательная запись (#26)

6.12.1 Действие: записать текущую запись
6.12.2 Входные данные:
- (IX) = Адрес дескриптора канала
6.12.3 Выходные данные: отсутствуют

6.13 Прочитать запись (#27)
6.13.1 Действие: прочитать следующую запись
6.13.2 Входные данные:
- (IX) = Адрес дескриптора канала
6.13.3 Выходные данные: отсутствуют

6.14 Прочитать сектор (legacy, стандартная операция) (#28)
6.14.1 Действие: прочитать сектор CHREC в буфер канала
6.14.2 Входные данные:
- (IX) = Адрес дескриптора канала
6.14.3 Выходные данные:

6.15 Прочитать следующий сектор (legacy, стандартная операция) (#29)
6.15.1 Действие: прочитать следующий сектор в буфер канала
6.15.2 Входные данные:
- (IX) = Адрес дескриптора канала
6.15.3Выходные данные:

6.16 Записать сектор (legacy, стандартная операция) (#2A)
6.16.1 Действие: запись буфера канала в сектор CHREC
6.16.2 Входные данные:
- (IX) = Адрес дескриптора канала
6.16.3Выходные данные:

6.17 Создать канал (#2B)
6.17.1 Действие: Создание дескриптора канала
6.17.2 Входные данные:

Файловый канал

- (A) = #BF (IN) - открыть для чтения
= #DE (OVER) - перезаписать
= #DF (OUT) - открыть для записи
= #A5 (RND) - создать handle файла
- (DRV_NR) = номер привода (диска) (1-255)
- (DEV_LT) = буква типа устройства или код устройства
- (NAM_LN) = длина имени файла (1-254)
- (FIL_TY) = буква типа файла
- (NAM_AD) = адрес имени файла (0-65535)

Не файловый канал

- (DRV_NR) = номер станции (0-7), только для канала N
- (DEV_LT) = тип канала: B, T, N или U
- (NAM_LN) = недопустимая длина имени (0 или 255)

6.17.3 Выходные данные:
- (HL) = смещение канала
- (IX) = адрес дескриптора канала

6.18 Удалить канал (#2C)
6.18.1 Действие: удаляет дескриптор канала
6.18.2 Входные данные:
- (IX) = адрес дескриптора канала
6.18.3 Выходные данные: отсутствуют

6.19 Открыть сетевой канал (#2D)
6.19.1 Действие: создает канал типа N
6.19.2 Входные данные: отсутствуют
6.19.3 Выходные данные:
- (HL) = смещение канала
- (IX) = адрес дескриптора канала

6.20 Закрыть сетевой канал (#2E)
6.20.1 Действие: отправляет буферизированные данные и удаляет канал N
6.20.2 Входные данные: дескриптор
- (IX) = адрес дескриптора канала
6.20.3 Выходные данные: отсутствуют

6.21 Получить пакет (#2F)
6.21.1 Действие: принимает пакет из 255 байт в канал N channel с таймаутом в 1 секунду
6.21.2 Входные данные:
- (IX) = адрес дескриптора канала
6.21.3 Выходные данные:
- CY = произошел таймаут

6.22 Послать пакет (#30)
6.22.1 Действие: отправляет пакет максимум из 255 байт из канала N, без таймаута (с бесконечным ожиданием)
6.22.2 Входные данные:
- (IX) = адрес дескриптора канала
6.22.3 Выходные данные:

6.23 Создать системные переменные (#31)
6.23.1 Действие: создает системные переменные
6.23.2 Входные данные: отсутствуют
6.23.3 Выходные данные: отсутствуют

6.24 Выполнить код (#32)
6.24.1 Действие: запустить код по адресу (HD__11)
6.24.2 Входные данные:
- (HD__11) = Адрес исполняемого кода
6.24.3 Выходные данные: отсутствуют

6.25 Прочитать следующий заголовок (#33)
6.25.1 Действие: не реализовано
6.25.2 Входные данные: отсутствуют
6.25.3 Выходные данные: отсутствуют

6.26 Создать канал типа B (#34)
6.26.1 Действие: создает канал B
6.26.2 Входные данные: отсутствуют
6.26.3 Выходные данные:
- (HL) = смещение канала
- (IX) = адрес дескриптора канала

6.27 Прочитать сектор (#35)
6.27.1 Действие: читает сектор в буфер. Это не применимо к файловым устройствам
6.27.2 Входные данные:
- (BC) = номер сектора (0-65535)
- (HL) = адрес буфера (0-65535)
Если CY сброшен:
- (A) = Номер привода (диска) (0-65535)
- (DEV_LT) = Буква типа устройства или код устройства
6.27.3 Выходные данные: отсутствуют

6.28 Записать сектор (#36)
6.28.1 Действие: записывает сектор из буфера. Это не применимо к файловым устройствам
6.28.2 Входные данные:
- (BC) = номер сектора (0-65535)
- (HL) = адрес буфера (0-65535)
Если CY сброшен:
- (A) = Номер привода (диска) (0-65535)
- (DEV_LT) = Буква типа устройства или код устройства
6.28.3 Выходные данные: отсутствуют

6.29 Следующий сектор (#37)
6.29.1 Действие: найти номер сектора следующей записи файла
- Первоначально должно быть вызвано с (BC)=0, чтобы сбросить (flush) буфер FAT на диск. Не применимо к файловым устройствам
6.29.2 Входные данные:
- (BC) = номер сектора (0-65535)
Если CY сброшен:
- (A) = Номер привода (диска) (0-65535)
- (DEV_LT) = Буква типа устройства или код устройства
6.29.3 Выходные данные:
- Установлен флаг нуля (Z) = нет больше записей
- (BC) = следующий номер сектора (0-65535)

6.30 Отменить (reclaim) все 'ad-hoc' каналы (#38)
6.30.1 Действие: отменяет все каналы, не связанные с потоками
6.30.2 Входные данные: отсутствуют
6.30.3 Выходные данные: отсутствуют

6.31 Найти файл (#39)
6.31.1 Действие: ищет файл или директорию
6.31.2 Входные данные: параметры файла, указанные дескриптором или handle

Дескриптор:

- (DRV_NR) = номер привода (диска) (0-65535)
- (DEV_LT) = буква типа устройства или код устройства
- (NAM_LN) = длина имени файла (1-254)
- (FIL_TY) = буква типа файла
- (NAM_AD) = адрес имени файла (0-65535)

Handle:

- (STR_NR) = Handle (0-15)
- (NAM_LN) = недопустимая длина имени (0 или 255)

6.31.3 Выходные данные:
- CY = файл не найден
- (HL) = указатель на дескриптор файла

6.32 Найти следующий файл (#3A)
6.32.1 Действие: поиск следующего файла с именем, совпадающим с указанным ранее в вызове 'Найти файл'
6.32.2 Входные данные: отсутствуют
6.32.3 Выходные данные:
- CY = файл не найден
- (HL) = указатель на дескриптор файла

6.33 Открыть поток (#3B)
6.33.1 Действие: открывает поток или handle
6.33.2 Входные данные:

Файловый канал

- (A) = #BF (IN) - открыть для чтения
= #DE (OVER) - перезапись
= #DF (OUT) - открыть для записи
= #A5 (RND) - создать handle файла
- (DRV_NR) = номер привода (диска) (0-65535)
- (STR_NR) = поток или число handle (0-15)
- (DEV_LT) = буква типа устройства или код устройства
- (NAM_LN) = длина имени файла (1-254)
- (FIL_TY) = буква типа файла
- (NAM_AD) = адрес имени файла (0-65535)

Не файловый канал

- (DRV_NR) = номер станции (0-7), только для канала N
- (STR_NR) = номер потока (0-15)
- (DEV_LT) = тип канала: B, T, N или U
- (NAM_LN) = недопустимая длина имени (0 или 255)

6.33.3 Выходные данные: отсутствуют.

6.34 Закрыть поток (#3C)
6.34.1 Действие: закрывает поток или handle
6.34.2 Входные данные:
- (A) = поток или число handle (0-15)
6.34.3 Выходные данные: отсутствуют

6.35 SAVE / LOAD (#3D)
6.35.1 Действие:
- Читает (LOAD) или записывает (SAVE) содержимое памяти из файла или в файл.
- Создает директорию (SAVE) или меняет текущую директорию (LOAD).
- Закрывает файл входной ленты (input tape), файл выходной ленты (output tape) или файл снапшота (snapshot file).
6.35.2 Входные данные:

Тип операции:

- (A) = 0,4 - SAVE, очищается указатель файла и выполняется сохранение
= 1,5 - LOAD, очищается указатель файла и выполняется загрузка
= 2,6 - VERIFY, очищается указатель файла и выполняется операция сравнения
= 3,7 - MERGE, очищается указатель файла и выполняется слияние
= 8 - закрытие выходной ленты (output tape)
= 9 - закрытие входной ленты (input tape)
= 10 - закрыть файл снапшота

Параметры файла, указанные дескриптором или через handle

Дескриптор:

- (DRV_NR) = номер привода (диска) (0-65535)
- (DEV_LT) = буква типа устройства или код устройства
- (NAM_LN) = длина имени файла (1-254)
- (FIL_TY) = буква типа файла
= BASIC и стандартные типы (см. п. 3.4.1 - 3.4.2) только для типа данных 7, иначе произойдет переназначение типа данных
= Типы эмулятора (п. 3.4.3) переназначают типы данных, отличающиеся от 7
- (NAM_AD) = адрес имени файла (0-65535)

Handle:

- (STR_NR) = хендл (0-15)
- (NAM_LN) = недопустимая длина имени (0 или 255)

Код типа данных
- (HD__00) = 0-7, то же самое значение, как и у типа файла (см. п. 3.4)

Параметры программы BASIC, только для типов данных: 0
- (HD__11) = номер строки программы для автозапуска

Параметры массива BASIC, только для типов данных 1 и 2
- (HD__0F) = Имя массива ("a"-"z").

Адрес блока памяти, только для типов данных 3-7
- (HD__0D) = Адрес блока памяти.

Длина блока памяти, только для типов данных 3-7
- (HD__0B) = Длина блока памяти.

Файловый указатель, только для типов данных 4-7
- (HD__0F) = указатель записи (0-511)
- (HD__11) = номер записи (0-32767)

Этот указатель автоматически обновляется после операции.

6.35.3 Выходные данные: отсутствуют

6.36 Копировать (copy) / переименовать (rename) файл (#3E)
6.36.1 Действие: копирует или переименовывает файлы / переименовывает директорию
6.36.2 Входные данные:

Тип операции (только для двух файловых каналов):

- (A) = #CC (TO) - Copy
= #AC (AT) - Rename
= #DE (OVER) - Copy Overwrite (копирование с перезаписью)
= #BF (IN) - Rename Overwrite (переименование с перезаписью)
= #D5 (MERGE) - добавить (слияние)

Источник: указывается потоком или каналом

Поток:

- (STR_NR) = номер потока (0-15)
- (NAM_LN) = недопустимая длина имени (0 или 255)

Файловый канал:

- (DRV_NR) = номер привода (диска) (0-65535)
- (STR_NR) = 255
- (DEV_LT) = буква типа устройства или код устройства
- (NAM_LN) = длина имени файла (1-254)
- (FIL_TY) = буква типа файла
- (NAM_AD) = адрес имени файла (0-65535)

Не файловый канал:

- (DRV_NR) = номер станции (0-7), только для канала N
- (STR_NR) = 255
- (DEV_LT) = тип канала: B, T, N или U
- (NAM_LN) = недопустимая длина имени (0 или 255)

Место назначения, указанное потоком или файловым дескриптором

Поток:

- (STR_N2) = номер потока (0-15)
- (NAM_L2) = недопустимая длина имени (0 или 255)

Файловый канал:

- (DRV_N2) = номер привода (диска) (0-65535)
- (STR_N2) = 255
- (DEV_L2) = буква типа устройства или код устройства
- (NAM_L2) = длина имени файла (1-254)
- (FIL_T2) = буква типа файла
- (NAM_A2) = адрес имени файла (0-65535)

Не файловый канал:

- (DRV_N2) = номер станции (0-7), только для канала N
- (STR_N2) = 255
- (DEV_L2) = тип канала: B, T, N или U
- (NAM_L2) = недопустимая длина имени (0 или 255)

6.36.3 Выходные данные: отсутствуют

6.37 Получить файловый указатель (#3E)
6.37.1 Действие: получить файловый указатель для каналов M или H, к которым открыт указанный поток
6.37.2 Входные данные:
- (A) = тип операции: #B0 (VAL)

Канал, указанный по его адресу или номеру потока

Адрес канала:
- (STR_NR) = недопустимый номер потока (16-255)
- (IX) = адрес канала (0-65535)

Номер потока:
- (STR_NR) = номер потока (0-15)

6.37.3 Выходные данные:
Номер канала:
- (HD__0F) = указатель записи (0-511)
- (HD__11) = номер записи (0-32767)

6.38 Установить файловый указатель (#3E)
6.38.1 Действие: устанавливает файловый указатель канала M или H, к которому открыт указанный поток
6.38.2 Входные данные:
- (A) = тип операции: #A9 (POINT)

Канал, указанный по его адресу или номеру потока

Адрес канала:
- (STR_NR) = недопустимый номер потока (16-255)
- (IX) = адрес канала (0-65535)

Номер потока:
- (STR_NR) = номер потока (0-15)

Номер канала:
- (HD__0F) = указатель записи (0-511)
- (HD__11) = номер записи (0-32767)

6.38.3 Выходные данные: отсутствуют

6.39 Каталог (#3F)
6.39.1 Действие: генерирует каталог файлов
6.39.2 Входные данные:
- (DRV_NR) = номер привода (диска) (0-65535)
- (STR_NR) = номер потока (0-15)
- (DEV_LT) = буква типа устройства или код устройства
- (NAM_LN) = недопустимая длина имени (0 или 255)

Может быть указано имя директории или имени файла, чтобы использовать их как фильтр для вывода команды.

- (NAM_LN) = длина имени (1-254)
- (FIL_TY) = буква типа файла
- (NAM_AD) = адрес имени (0-65535)

6.39.3 Выходные данные:
- (HD_0D) = количество каталогизируемых файлов

Накопленная длина каталогизируемых файлов
- (HD_0F) = младшее слово
- (HD_11) = старшее слово

6.40 Формат логического привода/диска (#40)
6.40.1 Действие: выполняет форматирование логического привода. Это не применимо к файловым устройствам
6.40.2 Входные данные:
- (A) = номер привода (диска) (0-65535)
- (STR_NR) = размер кластера: 2, 4, 8 или 16
- (DEV_LT) = буква типа устройства или код устройства

или

- (A) = 0
- (STR_NR) = количество зарезервированных логических приводов
- (DEV_LT) = буква типа устройства или код устройства

6.40.3 Выходные данные: отсутствуют

6.41 Очистка экрана (#41)
6.41.1 Действие: то же самое, что и команда 'CLS #' операционной системы extended BASIC
6.41.2 Входные данные: отсутствуют
6.41.3 Выходные данные: отсутствуют

6.42 Закрыть все потоки (#42)
6.42.1 Действие: то же самое, что и команда 'CLEAR #' операционной системы extended BASIC
6.42.2 Входные данные: отсутствуют
6.42.3 Выходные данные: отсутствуют

6.43 Команда периферийного модуля (#43)
6.43.1 Действие: отправляет команду серверу или периферийному контроллеру, и печатает ответ в виде hex-дампа
6.43.2 Входные данные:
- (BC) = длина строки команды
- (HL) = адрес строки команды
- ZR = сервер/периферийный модуль
- CY = печать hex-дампа
6.43.3 Выходные данные: отсутствуют

6.44 Получить абсолютный путь (#44)
6.44.1 Действие: получает параметры абсолютного имени пути
6.44.2 Входные данные:
- (DRV_NR) = номер привода (диска) (0-65535)
- (DEV_LT) = буква типа устройства или код устройства

Относительное имя пути

- (NAM_LN) = длина имени файла (1-254) или 0 для текущей директории
- (NAM_AD) = адрес имени файла (0-65535)

6.44.3 Выходные данные: абсолютный путь в BUFF_3 (см. п. 4.5.1)
- (HL) = адрес абсолютного имени файла
- (BC) = длина абсолютного имени файла

6.45 Получить первый список директории (строка) (#45)
6.45.1 Действие: получает первый список директории или строку списка, как это указано п. 5.4.7 и п. 5.4.8
6.45.2 Входные данные:
- (A) = тип списка, только для файловых устройств
= 0 обычный список файлов
= 1 с информацией заголовка BASIC
= 2 строка списка с длинным именем
- (DRV_NR) = номер привода (диска) (0-65535)
- (DEV_LT) = буква типа устройства или код устройства

Относительный путь

- (NAM_LN) = длина имени директории (1-254) или 0 для текущей директории
- (NAM_AD) = адрес имени директории (0-65535)

6.45.3 Выходные данные: первый список директории/строка в BUFF_3
- (HL) = адрес первого списка/строки
- (BC) = длина списка/строки
- (DE) = 0 для корневой (root) директории

6.46 Получить следующий список директории (строка) (#46)
6.46.1 Действие: получить следующий список директории или строку списка
6.46.2 Входные данные: отсутствуют
6.46.3 Выходные данные: следующий список директории/строка в BUFF_3
- (HL) = адрес следующего списка директории/строки
- (BC) = длина списка/строки

6.47 Печать целого числа (#47)
6.47.1 Действие: вывести 3-байтное целое число (A) (DE) в 3, 6 или 8 цифрах, с лидирующими пробелами
6.47.2 Входные данные:
- (DE) = младшие байты
- (A) = старший байт
- Флаги, указывающие количество цифр, и опции count и add:

6.47.3 Выходные данные: если установлены оба ZR и CY, то печатаемые цифры считаются в (HD__0D), и их сумма вычисляется в (HD__0F и HD__11).

6.48 Команда периферийного устройства (#48)
6.48.1 Действие: контроллеру периферийного устройства посылается только код команды
6.48.2 Входные данные:
- (A) = код команды
- (HL) = адрес ответа (0-65535)
6.48.3 Выходные данные:
- CY = ошибка
- (A) = код ошибки или 0, если нет ошибки
- (HL) = адрес ответа

6.49 Передача-прием периферийного устройства (#49)
6.49.1 Действие: отправка и прием данных в периферийный контроллер и из него
6.49.2 Входные данные:
- (A) = код команды
- (HL) = адрес блока данных (0-65535)
- (BC) = длина блока данных (0-512)
- (DE) = адрес ответа (0-65535)
6.49.3 Выходные данные:
- (A) = код ошибки
- (HL) = адрес ответа
- (BC) = длина ответа

6.50 Получить размер устройства (#4A)
6.50.1 Действие: получить параметры текущего устройства
6.50.2 Входные данные: отсутствуют
6.50.3 Выходные данные:
- (H) = доступный размер тома в логических приводах (дисках)
- (L) = количество зарезервированных логических приводов (дисков) или #FF для RAM-диска или файловых устройств
- (BC) = реальный размер карты SD, в логических дисках

6.51 Прием последовательного порта (#4B)
6.51.1 Действие: прием в буфер из порта RS-232

Эта функция имеет таймаут 1 секунду, после истечения которого будет возвращено 0 байт

6.51.2 Входные данные:
- (C) = количество байт (1-256)
- (HL) = адрес буфера (0-65535)
6.51.3 Выходные данные:
- (C) = количество принятых байт (0-240)

6.52 Передача последовательного порта (#4C)
6.52.1 Действие: передает из буфера в через порт RS-232

Эта функция имеет таймаут после 12 секунд, после истечения которого выдается сигнал 'Communication error' (ошибка обмена).

6.52.2 Входные данные:
- (BC) = количество байт (1-512)
- (HL) = адрес буфера (0-65535)
6.52.3 Выходные данные: отсутствуют

6.53 Чтение строки из канала M (#4D)
6.53.1 Действие: читает строку, завершенную CR (#0D), если CY сброшен, или иначе читает блок максимум (BC) байт из канала M по адресу (IX) в буфер по адресу (DE)
6.53.2 Входные данные:
- (IX) = адрес канала
- (BC) = максимальное количество байт (0-65536)
- (DE) = адрес буфера (0-65535)
- CY = не проверять конец строки (CR)
6.53.3 Выходные данные:
- флаг Z установлен, если (BC) = 0
- (BC) = количество прочитанных байт (1-65536)

6.54 Запись строки в канал M (#4E)
6.54.1 Действие: записывает строку, завершенную CR (#0D), если CY сброшен, или иначе максимум (BC) байт из буфера по адресу (HL) в канал M по адресу (IX)
6.54.2 Входные данные:
- (IX) = адрес канала
- (BC) = максимальное количество байт (0-65536)
- (HL) = адрес буфера (0-65535)
- CY = не проверять на конец строки (CR)
6.54.3 Выходные данные: отсутствуют

6.55 Проверка наличия устройства (#4F)
6.57.1 Действие: проверяет, подключено ли устройство (A)
6.55.2 Входные данные:
- (A) = код устройства
6.55.3 Выходные данные:
- ZR = устройство присутствует
- CY = блочное устройство

6.56 Прием через Ethernet (#50)
6.56.1 Действие: принимает блок максимум (C) байт из станции (A). Сработает таймаут после 12 секунд
6.56.2 Входные данные:
- (A) = номер станции (1-7)
- (C) = количество байт (1-255)
- (HL) = адрес буфера (0-65535)
6.56.3 Выходные данные:
- CY = произошел таймаут
- (C) = количество байт received (0-255)

6.57 Передача Ethernet (#51)
6.57.1 Действие: передает блок максимум 255 байт в станцию (A). Сработает таймаут после 12 секунд
6.57.2 Входные данные:
- (A) = номер станции (1-7)
- (C) = количество байт (1-255)
- (HL) = адрес буфера (0-65535)
6.57.3 Выходные данные:
- CY = произошел таймаут

6.58 Получить длинное имя (#52)
6.58.1 Действие: получает длинное имя последнего найденного файла на файловом устройстве, или содержимое последнего найденного 'LNF' auxiliary-файла на блочном устройстве. Результат отправляется в буфер (HL).
6.58.2 Входные данные:
- (HL) = адрес буфера (0-65535)
6.58.3 Выходные данные:
- CY = ошибка - имя не было возвращено

[Ссылки]

1. Interface 1bis for the Sinclair ZX Spectrum 48k Ver 4b-4c Operating system reference site:sites.google.com.
2. Interface 1bis для ZX Spectrum.
3. 161010IF1bis.zip - документация, относящаяся к Interface 1bis.
4. Звуковой порт вывода tape-файлов Interface 1bis.