TOMMY
Device Discovery

Automatic (mDNS)

The device discovers your instance via mDNS on your local network. Requires that multicast traffic reaches the device.

How It Works

When the TOMMY instance starts:

  1. TOMMY instance advertises itself as _tommy._tcp.local service via mDNS
  2. Broadcasts its IP address and required ports
  3. Includes metadata like version, startup time, and process ID

When the devices start:

  1. Devices with TOMMY firmware listen for _tommy._tcp.local broadcasts
  2. When devices detect the TOMMY instance advertisement, they extract:
    • Instance IP Address: Where to send data and heartbeats
    • Communication Ports: MQTT, file server, and other service ports
    • Service Availability: Confirms TOMMY instance is running and accessible
  3. Devices automatically connect to the discovered TOMMY instance
  4. Connected devices appear in the TOMMY dashboard within seconds

Requirements for mDNS Discovery

  • TOMMY instance and devices must be on the same network
  • Network infrastructure must allow multicast traffic