Skip to main content

Set SIP network mode​

Configures which network interface is used for SIP traffic when both Ethernet and Wi-Fi are active. DNS resolution is always performed via Wi-Fi.

Network constraints when both interfaces are in use:

  • Ethernet and Wi-Fi cannot both use static IP or both use DHCP simultaneously.
  • If Ethernet uses static IP, Wi-Fi must use DHCP, and vice versa.
  • Wi-Fi must be on a different IP subnet than Ethernet.
  • Ethernet settings must differ from Wi-Fi even if Ethernet is disconnected.

Fields:

  • network_mode: Network interface used for SIP registration, multicast, and SIP calls.
    • ethernet: Bound only to Ethernet.
    • wifi: Bound only to Wi-Fi.
    • dual: Ethernet and Wi-Fi are both usable at once. SIP registration and SIP calls go via Wi-Fi; multicast calls use whichever network the responding peer is on.
    • dual_gateway: Same as dual, and the device's Wi-Fi also acts as a gateway.

Example behaviors:

  • {"network_mode":"ethernet"}: DNS resolution is performed via Wi-Fi. SIP registration, multicast, and SIP calls work only via Ethernet.
  • {"network_mode":"wifi"}: DNS resolution is performed via Wi-Fi. SIP registration, multicast, and SIP calls work only via Wi-Fi.
  • {"network_mode":"dual"}: DNS resolution is performed via Wi-Fi. SIP registration and SIP calls work via Wi-Fi. Multicast calls work on both networks — the network used, Wi-Fi or Ethernet, depends on the IP information returned by the peer during the broadcast discovery phase. For example, if a device from the Ethernet network responds, the multicast call is established via Ethernet; if a device from the Wi-Fi network responds, the call is established via Wi-Fi.
  • {"network_mode":"dual_gateway"}: Same as dual, and the device's Wi-Fi is also usable as a gateway.
Request Body required
  • network_mode string required

    Possible values: [ethernet, wifi, dual, dual_gateway]

    Network interface used for SIP registration, multicast, and SIP calls. ethernet/wifi bind exclusively to that interface; dual lets Ethernet and Wi-Fi be used simultaneously (SIP via Wi-Fi, multicast via whichever network the peer responds on); dual_gateway is the same as dual with the device's Wi-Fi also acting as a gateway. DNS resolution is always performed via Wi-Fi, regardless of this value.

Responses

OK

Loading...