Configure the module
The module can be configured using either the graphical interface on your mobile device or the module serial port. In this section we will present the former method. By clicking on the menu button, located on the right side of the tool bar, the following menu will appear.
The first menu item (Configure Module) allows you to access the page with the module configuration:
The presented form includes the following basic fields:
- AP SSID: this field represents the name of the Access Point created by the module. Enter a new name if you wish to use another Access Point name
- AP PWD: this is the password of the module Access Point. It is strongly recommended to change the initial password. Please note that the minimum allowed password length is 8 characters. If you leave this field empty, an open Access Point will be created
- AP CH: this is the radio channel used by the Access Point. Despite this parameter is reported in the form, in most of the cases, you won't be able to change this parameter while the WiFi is in use. It is therefore recommended to change this parameter through the Serial Interface
- Conn. to SSID: this parameter indicates the name of the local existing WiFi that can be used to connect to Internet. This is usually your Home WiFi network name. Please note that, it is not required that this network is actually connected to the Internet, but it can just connects your local devices
- Conn PWD: this field contains the password for connecting to your WiFi
- Enable Connection: if this box is checked the module will actually connect to your WiFi network. Leave this box unchecked if you don't wont to connect the module to Internet.
Please Note that, if you enable the connection to a WiFi network but the network can not be joined, the direct communication with the module through its WiFi access point will result intermittent. Therefore, it is strongly recommended disabling the Connection to a WiFi network if such a connection can not be established.
In order to be able to communicate with your module from the Internet (i.e. from everywhere in the world) you have to configure your router to allow incoming TCP connections to reach the module port 80 and 81. The µPanel firmware is able to automatically configure most of the routers so that they will accept and forward these incoming connections. The currently supported protocols are the NAT-PMP and UPnP. The former is adopted by Apple products, the latter by many home routers. The following three entries of the configuration module permit to set and enable the router auto-configurator function:
- Router Port 1: this field allows you to select a free router public port. The router will be configured to forward incoming TCP connections from this port to the module port 80
- Router Port 2: as above, the router will be configured to forward incoming TCP connections from this port to the module port 81
- Enable Router Conf.: checking this box the router auto-configuration function will be actually activated. Please note that if you activate this function, the module may require about 1 minute to successfully connect to Internet after start-up
When you want to connect to your module through the Internet but your app does not know the public IP address of your router, you can use the IP discovery mechanism based on our cloud server, which is accessible with the button "locate in cloud" in the product folder. Please note that, the module checks for its public IP every 15 minutes and, if necessary, communicates it to our server. This means that if your router changes IP (for instance, due to a router reboot or ADSL problems), you need to wait up to 15 minutes to be able to reconnect to your module again.
The last module entries permit to configure and access the following features:
- Serial Baud: this parameter permits to change the Serial Line speed. The default value is 57600 baud, but other standard values can be set, such as 115200 baud, for faster communication
- AT-Firmware: the module will be shipped with actually two firmwares onboard: the µPanel and the legacy AT. This menu line shows you if the firmware is actually revertible to AT. If you click on Revert to AT the module will switch firmware and will reboot with the AT interpreter. If you revert to AT, the only way to return back to the µPanel firmware is to issue an AT+PANEL command on the serial line (at 115200 baud). More details about the AT reverting procedure can be found in its specific section
- µPanel Ver.: this line shows the firmware version currently running on the module. Clicking on the upgrade button you can upgrade the firmware. The upgrade functions require internet connection. More details about the firmware upgrade can be found in the specific section
Some of the above discussed parameters and functions might be protected and locked by a controller connected to the serial port. Please refer to the serial section to know more about the protected commands.