Skip to content

docs: note macOS multicast fallback for D2D discovery #57

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.

Sign up for GitHub

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

Open
nicolas-rabault wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs: note macOS multicast fallback for D2D discovery #57

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
21 changes: 21 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -74,6 +74,27 @@ The device starts in D2D mode automatically — no URLs needed. Any other Device

> **Note:** `DEVICE_CONNECT_ALLOW_INSECURE=true` skips TLS and is intended for local development only.

<details>
<summary>Not seeing the device? (macOS / multicast)</summary>

D2D mode discovers peers over Zenoh UDP multicast. On some setups — notably
macOS over loopback — multicast scouting doesn't connect two local processes, so
`discover(...)` comes back empty and `invoke(...)` reports no responders. Give
the peers an explicit TCP link instead: have the device listen, and point the
agent at it.

```bash
# device — listen on a local endpoint
DEVICE_CONNECT_ALLOW_INSECURE=true DEVICE_CONNECT_DISCOVERY_MODE=d2d \
ZENOH_LISTEN=tcp/localhost:7447 python sensor.py

# agent — connect to that endpoint
DEVICE_CONNECT_ALLOW_INSECURE=true DEVICE_CONNECT_DISCOVERY_MODE=d2d \
ZENOH_CONNECT=tcp/localhost:7447 python your_agent.py
```

</details>

### 4. Discover and invoke from an agent

```bash
Expand Down