Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Troubleshooting information added for UPnP (Issue #13077) #2190

Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Rollback of changes that do not belong to this PR
pgfeller committed Jan 30, 2024
commit 41ab7a325968ab4a14a162015ee560e38282c5e9
2 changes: 0 additions & 2 deletions .vuepress/config.js
Original file line number Diff line number Diff line change
@@ -29,8 +29,6 @@ module.exports = {
// ['script', { src: `https://identity.netlify.com/v1/netlify-identity-widget.js` }]
],
extendMarkdown(md) {
md.use(require('markdown-it-footnote'));

md.options.linkify = true
const highlight = md.options.highlight
md.options.highlight = (str, lang) => {
8 changes: 0 additions & 8 deletions .vuepress/styles/index.styl
Original file line number Diff line number Diff line change
@@ -48,14 +48,6 @@
// .site-name
// display none

.footnotes
padding 1rem
font-size 10pt
font-style italic;

.editLink
display contents

.dropdown-wrapper .nav-dropdown .dropdown-item h4
margin-bottom .2rem

7 changes: 1 addition & 6 deletions installation/docker.md
Original file line number Diff line number Diff line change
@@ -255,7 +255,7 @@ It then performs all the same steps that the upgrade script and which are perfor

### Universal Plug and Play (UPnP)

Some bindings, like e.g. [SONOS](https://www.openhab.org/addons/bindings/sonos/), depend on the common [UPnP](https://en.wikipedia.org/wiki/Universal_Plug_and_Play) communication infrastructure installed with openHAB[^jupnp]. The protocol is based on IP multicast messages, which are limited to a local subnet[^multicastrouting]. In case you have multiple network adapters in your system (which is the case if you use docker), it is necessary to inform openHAB what interface shall be used for UPnP discovery and communication. If more than one IP address is assigend to the interface, the address to use must be specified as well.
Some bindings, like e.g. [SONOS](https://www.openhab.org/addons/bindings/sonos/), depend on the common [UPnP](https://en.wikipedia.org/wiki/Universal_Plug_and_Play) communication infrastructure installed with openHAB. The protocol is based on IP multicast messages, which are limited to a local subnet. In case you have multiple network adapters in your system (which is the case if you use docker), it is necessary to inform openHAB what interface shall be used for UPnP discovery and communication. If more than one IP address is assigend to the interface, the address to use must be specified as well.
pgfeller marked this conversation as resolved.
Show resolved Hide resolved

This information can be specified via the `EXTRA_JAVA_OPTS` [Environment Variable](#environment-variables):

@@ -373,8 +373,3 @@ This command changes permissions of the specific device as expected (readable an
::: tip Note
The device path (`/dev/ttyACM0`) or container name (`openhab`) could be different in your system, command can be modified accordingly.
:::

[^multicastrouting]:
IP multicast is always available within the local subnet. Achieving IP multicast service over a wider area requires multicast routing. Many networks, including the Internet, do not support multicast routing. Multicast routing functionality is available in enterprise-grade network equipment but is typically not available until configured by a network administrator.
[^jupnp]:
openHAB is using the [UPnP/DLNA library for Java](https://www.jupnp.org); it defines the relevant parameters in the [NetworkAddressFactory](https://github.com/jupnp/jupnp/blob/4a3ab9dec37cb9be324d02f6dc81ffca74237e1e/bundles/org.jupnp/src/main/java/org/jupnp/transport/spi/NetworkAddressFactory.java#L33) implementation.
1 change: 0 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
@@ -20,7 +20,6 @@
},
"homepage": "https://github.com/openhab/openhab-docs#readme",
"dependencies": {
"markdown-it-footnote": "^4.0.0",
"vue-tabs-component": "^1.5.0",
"vuepress": "^1.5.0",
"vuepress-plugin-container": "^2.1.4",