# Network - OSC
[OSC]

Configure the Controller Board's Network Settings via OSC. More...

Configure the Controller Board's Network Settings via OSC.

## Devices

There is only one Network system, so a device index is not used.

## Properties

The Network system has the following properties

- address
- mask
- gateway
- valid
- mac
- osc_udp_listen_port
- osc_udp_send_port
- dhcp

Address
  The address property corresponds to the IP address of the Controller Board. This value can be both read and written. To set a new address, send a message like

      /network/address 192.168.0.235

  To read the current IP address, omit the argument value from the end of the message:

      /network/address

Mask
  The mask property corresponds to the network mask of the Controller Board. When on a subnet or local network, the network mask must be set in order for the gateway to route information to the board's IP address properly. The mask is commonly 255.255.255.0 for many home networks.

  To set the board's network mask, send a message like

      /network/mask 255.255.255.0

  To read the current mask, omit the argument value from the end of the message:

      /network/mask

Gateway
  The gateway property corresponds to the gateway address for the local network the Make Controller is on. The gateway address is the address The gateway address is commonly the address of the router on many home networks, and its value is commonly 192.168.0.1.
  This value is stored in EEPROM, so it persists even after the board is powered down.

  To set the board's gateway address, send a message like

      /network/gateway 192.168.0.1

  To read the current gateway, omit the argument value from the end of the message:

      /network/gateway

Valid
  The valid property is used to make sure the board's network settings are valid. If you're manually setting the address, gateway, or mask settings, you'll need to send the valid message for them to take effect.

  To set the board's current network settings as valid, send the message

      /network/valid 1

  To check if the current settings have been set as valid, send the message:

      /network/valid

  with no argument value.

OSC UDP Port
  The osc_udp_port property corresponds to the port that the Make Controller listens on for incoming OSC messages via UDP. This value is stored persistently, so it's available even after the board has rebooted. This is 10000 by default.

  To tell the board to listen on port 10001, instead of the default 10000, send the message

       /network/osc_udp_port 10001

  To read back the port that the board is currently listening on, send the message

      /network/osc_udp_port

  with no argument value.

DHCP
  The dhcp property sets whether the board should try to dynamically retrieve a network address from a network router. If no DHCP server is available, the board will use the network settings stored in memory for the address, gateway, and mask properties. If you're connecting the board directly to your computer, DHCP will not be available, so you should turn this off.

  To turn DHCP on, send the message

       /network/dhcp 1

  and the board will immediately try to get an address. To check what address the board got, send the message

       /network/address

  as you normally would. To turn DHCP off, send the message

       /network/dhcp 0

  To read whether DHCP is currently enabled on the board, send the message

       /network/dhcp

  with no argument value.

MAC
  The mac property corresponds to the Ethernet MAC address of the Controller Board. This value is read-only. Each board on a network must have a unique MAC address. The MAC address is generated using the board's serial number, so ensure that your board's serial numbers are unique.

  To read the MAC address of the Controller, send the message

      /network/mac

  The board will respond by sending back an OSC message with the MAC address.