Appearance
KNX
Общее
KNX IP (KNXnet/IP) — это коммуникационный протокол и аппаратный шлюз, который позволяет устройствам стандарта KNX (умный дом и автоматизация зданий) обмениваться данными через локальную сеть (LAN) или интернет. Он используется для программирования системы из программы ETS, подключения серверов визуализации и интеграции с голосовыми помощниками.
Настройки драйвера
ts
export const KNXIPSettingsSchema = z.object({
settings: z.object({
/** IP-адрес KNX-шлюза. */
IP: nonEmptyString(t("shared_text.ip_required")),
/** Порт KNX-шлюза. */
Port: nonEmptyString(t("shared_text.port_required")),
/** Физический адрес. */
PhysAddr: z.string(),
/** Трансляция сетевых адресов NAT (0/1). */
IsNat: z.number(),
/** Защита соединения (0/1). */
HasProtection: z.number(),
/** Код аутентификации. Появляется только при HasProtection === 1. */
authenticationCode: z.string().optional(),
/** Пароль пусконаладки. Появляется только при HasProtection === 1. */
commissioningPassword: z.string().optional(),
/** Устройства вкладки «Безопасность». Записывается в настройки, чтобы не менять структуру BaseObject. */
Security: ZodSecurityDevicesArray.optional().default([]),
}),
});Настройки связи
Справочник полей настроек связи (link.settings): ключ в БД, лейбл редактора, доступы, при которых поле видно в редакторе и уходит в запрос контроллеру, и дефолт нового линка. Хранятся настройки всегда целиком — доступ определяет только видимость полей и состав запроса.
| Ключ | Настройка | Чт. | Зап. | Дефолт |
|---|---|---|---|---|
KNX_ADDRESS | групповой адрес | ✓ | ✓ | "" |
DATA_TYPE | тип данных | ✓ | ✓ | "1.001" |
Типы
ts
export const knxipLinkSettingsSchema = z
.object({
[EDriverSettingsType.KNX_ADDRESS]: KNXIP_LINK_SETTINGS_SHAPE.KNX_ADDRESS.optional(),
[EDriverSettingsType.DATA_TYPE]: KNXIP_LINK_SETTINGS_SHAPE.DATA_TYPE.optional(),
})
.strict()
.superRefine((settings, ctx) => {
const address = settings.KNX_ADDRESS;
if (address === undefined || address.length === 0) {
if (address !== undefined) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
message: t("shared_text.KNX_address_empty"),
path: [EDriverSettingsType.KNX_ADDRESS],
});
}
return;
}
const parts = address.split("/");
const isFormatValid =
/^[\d/]+$/.test(address) &&
parts.length >= 1 &&
parts.length <= 3 &&
parts.every((part) => part.length > 0);
if (!isFormatValid) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
message: t("knxip.validation_errors.knx_address"),
path: [EDriverSettingsType.KNX_ADDRESS],
});
return;
}
if (parts.length === 3) {
const [main, middle, sub] = parts.map(Number);
const inRange = main <= 31 && middle <= 7 && sub <= 255;
const isBroadcast = main === 0 && middle === 0 && sub === 0;
if (!inRange) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
message: t("knxip.validation_errors.knx_address"),
path: [EDriverSettingsType.KNX_ADDRESS],
});
}
if (isBroadcast) {
ctx.addIssue({
code: z.ZodIssueCode.custom,
message: t("knxip.validation_errors.all_zerod_in_group_address"),
path: [EDriverSettingsType.KNX_ADDRESS],
});
}
}
});Вкладка безопасность
О том что такое стратегия импорта можно почитать здесь Таб 'безопасность' в драйверах. В данном случае мы импортируем файл .knxproj, в котором есоть xml файл. В этом файле есть теги Topology address="", Area address="", Lines address="", GroupAddress address="" Из этих тегов нам нужно собрать массив из утсройств. Главными его свойствами устройств являются адрес и групповые адреса.
Устройство KNX безопасности
ts
export const ZodSecurityDevice = z.object({
/** uuid устройства. */
id: z.string().uuid(),
/** Название устройства. */
name: z.string().min(1, t("shared_text.name_required")),
/** Составной адрес в формате "1.2.3". */
address: z
.string()
.regex(/^\d+\.\d+\.\d+$/, t("driver_security.validation.address_format")),
/** Частота опроса (раз в секунду, 1–60). */
frequencyPerSec: z.number().min(1).max(60),
/** Массив групповых адресов в формате "31/7/255". */
groupAddresses: z.array(
z
.string()
.regex(
/^\d{1,3}\/\d{1,3}\/\d{1,3}$/,
t("driver_security.validation.group_address_format"),
),
),
/** Белый список. Если false — устройство не учитывается при синхронизации. */
isEnabled: z.boolean(),
});Адрес
Адрес - это собирательное свойство, т.е его значение состоит из адресов Topology, Area и Line Рассмотрим на примере: Topology с адресом "1", в этом теге есть тег Area с адресом 5 и в нем Line с адресом 7, получается состовной адрес будет равен 1.5.7. Внутри Topology может быть много Area, а в этих Area может быть много Line
Групповой адрес
Групповые адреса - это сущности, которые привязываются к Line через аттрибут link и таким образом мы привязываем их к конечному устройству. Они могут дублироваться у всех устройств. У одного устройства их может быть неограниченное количество.
Выбор конкретных Topology, Area и Lines для создания
Мы, посредством диалогового окна KNXSelectLinesDialog, в котором иерархия этих тегов отображена в виде дерева, может выбирать нужные нам Topology, Area и Lines
Создание, удаление и редактирование устройств
После того как мы импортировали необходимые нам устройства из файла - мы забываем о нем. Связи между файлом и нашими устройствами в дальнейшем нет никакой, мы можем удалять все устройства (как массово так и поодиночке), редактировать и создавать новые в ручную
Валидация при создании и редактировании
Валидация при создании и редактиравании довольно простая - состовные адреса не должны дублироваться. Т.е если у нас есть два устройства с состовными адресами 1.3.5 и 1.3.7, и мы захотим поменять у второго последнию цифру адреса на 5, чтобы получлось 1.3.5, нам выдаст ошибку и не даст сохранить данное устройство
Валидация при создании и привязке новых, и уже существующих, групповых адресов
vue
// Поиск адресов
const searchAddresses = (query: string): void => {
searchQuery.value = query;
if (!query) {
// Если нет запроса, показываем все доступные адреса
filteredAddresses.value = props.allAddresses.map((addr) => ({ address: addr }));
return;
}
// Фильтруем существующие адреса
const existingMatches = props.allAddresses
.filter((addr) => addr.toLowerCase().includes(query.toLowerCase()))
.map((addr) => ({ address: addr }));
// Проверяем, является ли запрос валидным, существующим адресом
if (isValidGroupAddress(query) && !props.allAddresses.includes(query)) {
// Если запрос - валидный адрес, добавляем его в предложения
filteredAddresses.value = [{ address: query }, ...existingMatches];
} else {
// Если такого адреса нет, то предоставляем пользователю для выбора, то что он ввел
filteredAddresses.value = existingMatches;
}
}; Мы создаем новые или привязываем уже существующие адреса в компоненте GroupAddressAutocomplete.
- при создании нового, мы начинаем вводить групповой адрес в формате 31/7/255,
и нам выводится для выбора то что мы ввели.
При нажатии, создается групповой адрес, который можно привязать ко всем адресам
- при привязке существуюшего мы вводим адрес и нам выпадают адреса для привязки
Security при синхронизации
При синхронизации мы мапим IDevice в структуру которую ожидает runtime <<< @/generated-snippets/entities/project/object/drivers/KNXIP/model/entity.ts#knx-settings-sync
,
Mentioned In
None yet.