arpschuino

First steps with arpschuino32: connect.


arpschuino32

You have just received and assembled your arpschuino32. The first thing to do is to connect to it.

To do this, there are several methods. Don't worry, you only have to do this once. Then your arpschuino32 should automatically connect to your router (or whatever).

Material required :

In this tutorial, we'll explore :

  1. First connection with the arpschuino32 as an access point.

  2. Access the server.

  3. Configure your network.

  4. Plan B : connection with SSID "rescue".


For this first connection, you can power your arpschuino32 with an 5v USB/Serial programmer. You will be able to monitor what your card is doing, easily retrieve its IP address, etc... See how to do it in chapter 2.3.


1.First connection with the arpschuino32 as an access point :

At the first start, the arpschuino32 does not know the address of your network. In this situation, it automatically switches to access point mode.

It will then behave like a mini router. Its SSID (network name) and password are fixed:

SSID:

new_arpschuino32

Password :

12345678

Now the access point should appear in the available networks of your computer or smartphone :

access point arpschuino32

Once connected, you can access the arpschuino32 server by typing its IP address in your favorite browser. In access point mode, IP is fixed:

192.168.4.1

It works, the network page of the arpschuino32 server is displayed? Bravo, the first thing to do now is to fill in the first two fields, Network and Password with the name of your network (that of your box or router) and its password.

When you click on OK, the new values are displayed, they will be applied during the next restart. To view the password, click on the eye.

Finally restart your board by clicking on the reboot board button or by pressing the reset button on your arpschuino32. Your computer or smartphone should automatically reconnect to your usual network.

The board will reboot and automatically connect to your network.

It may happen, depending on the system used, that it is difficult to connect this way. If you are in this case, try the second method, go directly to chapter 4.


2.Access the server :

You can access a server on a local network by typing its IP address in the address bar of a browser. Of course the computer (or smartphone) and the arpschuino32 must be on the same network.

What to do when you don't know this IP address? Here too, several solutions:

2.1.With mDNS :

By simply typing the hostname of the board (by default arpschuino32) followed by .local . For instance :

arpschuino32.local


Connection with mDNS

This method will work directly for Mac or Iphone users.

On Windows, you will need to install the service Bonjour (here for example) and restart the 'computer. If you have already installed Apple software such as Safari or iTunes, Bonjour may already be installed on your machine.

Under Linux it should also work directly on many distributions (Mint, Ubuntu). If not, install Avahi.

On Android, this method is not possible until android 12... From android 13 it should work directly. We haven't been able to test it yet, If you have a smartphone running Android 13, don't hesitate to tell us about your experience on the forum arpschuino.

2.2.By retrieving the IP address from the router :

You can also find the IP address by connecting to your router or your box by typing its IP address or its url. They are normally found written on the label placed under the device, along with the password.

Then we retrieve the info in the section active devices, connected devices, clients or something like that.

example with a Bbox

And if you are connected to an access point, go to the parameters of this one :


Find the card's IP in the settings of its access point

2.3.With a network scanner:

You can also use a network scanner. On computer, Windows, Mac or Linux you can for example use Angry IP Scanner. (open sources)


angry IP scanner

On smartphones, there are also a multitude of apps for this, for example fing on Android or on iPhone and iPad .


Fing IP scanner (1)

Fing IP scanner (2)


2.4.By monitoring with USB/Serial 5v :

To know the IP address of your board, you can use a 5V USB>Serial or any other 5V USB/TTL adapter.

If you don't already have it, install the arduino IDE here.

For our programmer or any other CP210-based programmer, drivers are available here, choose the default version.

WARNING: we are told that on recent versions of OS X (Mac), you no longer need to install a Silicon Lab driver, a homemade driver is present in the OS. It may even be that following an update, you are forced to uninstall the Silicon Lab driver that was working until then.

Then restart your computer and launch the arduino IDE.

You now need to install the ESP32 core. Go to File -> Preferences, in the Additional boards Manager URL enter:

https://dl.espressif.com/dl/package_esp32_index.json

Each additional map URL must be separated by a comma. Example :

https://raw.githubusercontent.com/arpschuino/Arpschuino/master/Core/package_arpschuino_index.json,https://dl.espressif.com/dl/package_esp32_index.json

Go to Tools -> Board-> Board Manager. A pop-up window opens. Find ESP32 and install the esp32 board by Espressif Systems.

Now in Tools -> Board, choose ESP32 Dev Module.

In the Tools/Port tab, choose the port corresponding to your programmer. If in doubt, you can unplug it and plug it back in to determine the correct port. Please note that other types of hardware such as the Enttec USB/DMX adapter may appear here.

You can now open the serial port by clicking on the small magnifying glass at the top right of the window. Finally, set the baudrate, to 115200baud.

Now reboot your board and see what is displayed.

serial monitor


3.Configure your network :

Well, we are now connected and we have accessed the network page of the arpschuino32 server :

arpschuino32 server

We will now configure our network, then the arpschuino32 will connect automatically at startup.

MAC address :

First appears the MAC address of the card, it cannot be changed, it is in a way its serial number.

Current IP :

Indicates the current IP of the board.

Network,Password :

You can then enter the name of your network, its SSID, and the password. First, if you are at home, you can, for example, put those in your box. Thereafter, in the context of use in Artnet wifi, you will put the SSID of the router of the show. To view the password, click on the eye.

When you click OK, the new values are displayed, they will be applied on the next restart.

second SSID enabled :

The following button allows you to benefit from a second SSID, we strongly advise you to leave it on Enable.

Network 2, Password :

The second SSID is a backup SSID, if the card fails to connect to the first, it will try to connect to it. You can leave rescue, or put the name of the access point of your smartphone, the main thing is to memorize it and always be able to connect in case of problems.

hostname :

Then change the hostname of your board, this is the name under which it will appear on the network and the one you can type in the address bar of your browser. We advise you to give it an explicit name, especially if you have several arpschuino32, for example "rotary motor" or "distant_led_ribbon"... Attention, no space in the name !

timeout :

The timeout is the maximum time during which the board will try to connect. 20 seconds is a sufficient value, we can possibly reduce it a little bit but be careful!

      OK

As we have seen, the OK button is used to enter previous modifications, but be careful, they will only be taken into account on the next restart.

Mode IP :

In DHCP, the IP address is assigned by the router. You can also choose to assign a fixed IP to the arpschuino32.

However, we do not recommend this unless you are used to setting up a network. This will avoid address conflicts and above all assigning an address that is incompatible with your router.

Reminder: To connect to a card whose address has been assigned in DHCP, see chapter 2


You can also configure the access point mode. Reminder: the arpschuino32 sets itself up as an access point when it cannot connect to a network.

Hotspot, Password :

This is the name of the network created by the arpschuino32 and the password to connect to it.

IP address :

It's fixed, you can't change it.

visible SSID :

You can hide the SSID of the access point, but beware, it will be difficult to find it with a device that has not yet connected to it.

Do not forget to click on OK to enter the modifications and to reboot the board.


All these data are now stored in the non-volatile memory of the arpschuino32, they will remain there, including in the event of a firmware update.

The board will now connect automatically, you can now configure the card according to what you want to do.

Go to our arpschuino32 configuration tutorial.


4.Plan B : connect with SSID "rescue" :

In a new arpschuino32, a recovery SSID (network name) is saved.

This second method consists, before powering up the board, in creating an access point with this SSID, on your smartphone or computer.

If you don't know how to do it here are some links, for android, iphone, windows, mac OS, linux mint, Ubuntu.

Choose the following names and passwords :

SSID:

rescue

Password :

arpschuino

Finally, power on or reset your arpschuino32. After a few seconds, the arpschuino32 will connect to your access point.

We can now resume the normal course of this tutorial and return to chapter 2.



In case of difficulties, do not hesitate to ask questions on the arpschuino forum .