azure-sphere-samples/ethernet-setup-instructions.md

Ethernet setup instructions

The Ethernet interface is enabled by default in the operating system, but some preparation is necessary before an application can use it.

The following steps describe how to set up a sample or tutorial to use Ethernet:

1. Add an Ethernet adapter to your hardware. If you are using an MT3620 RDB, see the wiring instructions.

2. Package a board configuration image for the Olimex ENC28J60-H. Follow the instructions in Create a board configuration image package.

3. Deploy the board configuration image package in addition to your application image package. Follow the instructions in Sideload a board configuration image package.

4. Ensure that the global constant networkInterface is set to "eth0". Search for the following declaration in source code. It is typically in main.c but may be in a different file for some samples.

   char networkInterface[] = "wlan0";

   Replace wlan0 with eth0 so that you now have the following declaration:

   char networkInterface[] = "eth0";