//
//  Licensed to the Apache Software Foundation (ASF) under one or more
//  contributor license agreements.  See the NOTICE file distributed with
//  this work for additional information regarding copyright ownership.
//  The ASF licenses this file to You under the Apache License, Version 2.0
//  (the "License"); you may not use this file except in compliance with
//  the License.  You may obtain a copy of the License at
//
//      https://www.apache.org/licenses/LICENSE-2.0
//
//  Unless required by applicable law or agreed to in writing, software
//  distributed under the License is distributed on an "AS IS" BASIS,
//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
//  See the License for the specific language governing permissions and
//  limitations under the License.
//
:imagesdir: ../../images/users/protocols
:icons: font

= KNXnet/IP

image::users/protocols/knx_banner.png[banner,512,167]





== Connection String Options

include::partial$knxnet-ip.adoc[]

== Individual Resource Address Format

KNX Addresses usually have one of the following structures:

- 3-level Address: `{main-group(0-15)}`/`{middle-group(0-15)}`/`{sub-group(0-255)}`
- 2-level Address: `{main-group(0-15)}`/`{sub-group(0-4095)}`
- 1-level Address: `{sub-group(0-65535)}`

Depending on the `group-address-type` configured in the connection string or defined in the knxproj-file configured by the `knxproj-file-path` connection string parameter, the corresponding address pattern has to be used.

However, when subscribing for events, each segment allows using of the wildcard character `*`.
If the addresses used in the KNX installation are structured, this way it is possible to, for example (depending on the scheme used):

- Collect all information for a given level of your building: `1/*/*`
- Collect all information for a given room: `2/4/*`
- Collect all information about heating in all rooms: `*/*/50`

NOTE: Don't use wildcards when explicitly reading or writing data, this is only supported when subscribing to events.