Changes for page Сетевое API - MAXIOL Landisk technology ®

Summary

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

Details

Page properties

Content

...	...	@@ -142,6 +142,124 @@
142	142
143	143	При подключении клиент разрешает доменное имя в IP-адрес, затем устанавливает соединение с сервером через порт **34162**, что позволяет начать обмен блоками данных между сервером и ретро-компьютером.
144	144
145		-== Sub-paragraph ==
	145	+== Структура запроса ==
146	146
147		-Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
	147	+В **MAXIOL Landisk Technology®** как клиент, так и сервер написаны на языке C, что позволяет эффективно управлять памятью и работать с низкоуровневыми операциями ввода/вывода. Структуры запросов, отправляемых на сервер, имеют строгую формализованную форму, которая обеспечивает правильную передачу данных между клиентом и сервером. Эти структуры определяются с учетом специфики языка C, включая синтаксис описания структур данных и использование указателей.
	148	+
	149	+
	150	+{{code language="c++"}}
	151	+// структура пакета запроса
	152	+typedef __packed struct landisk_reqest
	153	+{
	154	+ unsigned int num_block; // номер блока (32 бита)
	155	+ unsigned short int command; // команда
	156	+ unsigned char reserved[32]; // зарезервировано
	157	+ unsigned char data[512]; // данные - если они отправляются
	158	+ char path[386]; // путь до диска
	159	+ unsigned short int crc; // CRC команды
	160	+} landisk_reqest_t;
	161	+{{/code}}
	162	+
	163	+при открытии файла блок данных (data[512]) рассматривается как пакет информации следующей структуры
	164	+
	165	+{{code language="c++"}}
	166	+// структура пакета открытия файла, информационные параметры
	167	+typedef __packed struct landisk_reqest_status
	168	+{
	169	+ unsigned long timestamp; // локальное время контроллера (unix-time)
	170	+ unsigned long uptime; // аптайм в секундах
	171	+ unsigned long ip_addr; // локальный ip адрес контроллера
	172	+ unsigned long dns_srv1; // ip адреса DNS-серверов
	173	+ unsigned long dns_srv2;
	174	+ unsigned short int tzone; // таймзона в минутах
	175	+ unsigned short int platform; // номер платформы
	176	+ unsigned short int controller; // тип контроллера
	177	+ unsigned short int version; // версия прошивки контроллера
	178	+ char build[32]; // дата билда прошивки контроллера
	179	+ char url[64]; // URL производителя контроллера
	180	+} landisk_reqest_status_t;
	181	+{{/code}}
	182	+
	183	+пакет информации настоятельно рекомендуется заполнять полностью
	184	+\\~/~/ platform - номер платформы
	185	+1 - PDP-11 - БК 10/11M
	186	+2 - PDP-11 - остальные -  ДВК Э60 УКНЦ оригинальные машины итд
	187	+3 - MSX
	188	+\\для добавления вашей платформы пишите в комментарии к этой статье.
	189	+\\~/~/ controller - тип контроллера
	190	+1 - AZБК
	191	+2 - AZ - для всех остальных PDP-11 машин
	192	+3 - Carnivore2+
	193	+\\для добавления вашего контроллера пишите в комментарии к этой статье.
	194	+
	195	+=== Команды ===
	196	+
	197	+{{code language="c++"}}
	198	+// команды
	199	+#define LANDISK_CMD_OPEN 1 // в ответ успешность/ошибка, и если успешно - размер диска
	200	+#define LANDISK_CMD_READ 2 // чтение блока
	201	+#define LANDISK_CMD_WRITE 3 // запись блока
	202	+#define LANDISK_CMD_CLOSE 4 // закрытие файла
	203	+#define LANDISK_CMD_OPENDIR 5 // открыть оглавление по указанному пути
	204	+#define LANDISK_CMD_READDIR 6 // прочитать одну запись оглавления в буфер
	205	+#define LANDISK_CMD_SEARCH_REQ 7 // послать запрос поиска
	206	+#define LANDISK_CMD_READ_SREQ 8 // прочитать одну запись результата поиска в буфер
	207	+{{/code}}
	208	+
	209	+
	210	+== Структура ответа ==
	211	+
	212	+Формат ответа
	213	+
	214	+{{code language="c++"}}
	215	+// структура пакета ответа с данными
	216	+typedef __packed struct landisk_answer
	217	+{
	218	+ unsigned short int result; // результат
	219	+ unsigned char data[512]; // принятые данные
	220	+ unsigned short int crc; // CRC ответа
	221	+} landisk_answer_t;
	222	+{{/code}}
	223	+
	224	+=== Статус файла ===
	225	+
	226	+при открытии файла, сервер возвращает статус файла, в блоке данных (data[512])
	227	+
	228	+{{code language="c++"}}
	229	+// структура пакета ответа статуса файла
	230	+typedef __packed struct landisk_answer_status
	231	+{
	232	+ unsigned char fattr; // File attribute
	233	+ unsigned short int fdate; // Fat date
	234	+ unsigned short int ftime; // Fat time
	235	+ unsigned int fsize; // File size
	236	+} landisk_answer_status_t;
	237	+{{/code}}
	238	+
	239	+=== Коды результатов выполнения команд ===
	240	+
	241	+{{code language="c++"}}
	242	+// ответы
	243	+#define LANDISK_ANS_OK 0x0000 // команда выполнена успешно
	244	+#define LANDISK_ANS_ERROR 0x0001 // флаг ошибки, устанавливается при любой ошибке
	245	+#define LANDISK_ANS_ACCESS_DENIED 0x0002 // нет доступа, устанавливается при любой ошибке доступа
	246	+#define LANDISK_ANS_NEED_REG 0x0004 // нет доступа - нужна регистрация
	247	+#define LANDISK_ANS_RO_ONLY 0x0008 // нет доступа на запись- данный диск только для чтения
	248	+#define LANDISK_ANS_NOT_EXISTS 0x0010 // нет данного образа - неверный путь до файла образа или директории
	249	+{{/code}}
	250	+
	251	+=== Стратегия работы ===
	252	+
	253	+~1. первая команда должна быть открытие файла (LANDISK_CMD_OPEN)
	254	+при запросе на открытие надо указать блок параметров (landisk_reqest_status_t)
	255	+в ответ будет прислан блок landisk_answer_t но data[512] надо рассматривать как landisk_answer_status_t
	256	+2. далее можно посылать команды чтения
	257	+3. на данный момент [февраль 2025] поддержаны команды LANDISK_CMD_OPEN, LANDISK_CMD_READ, LANDISK_CMD_WRITE, LANDISK_CMD_CLOSE
	258	+4. В конце работы желательно (но не обязательно) послать команды закрытия дисков.
	259	+
	260	+=== **Ограничения:
	261	+~1. не более 100 запросов в секунду с одного IP (иначе сработает блок анти-DDOS и забанит данный IP на некоторое время)
	262	+2. не более 10ти "висящих" соединений на IP.** ===
	263	+
	264	+
	265	+