First you need to figure out the following information:
To get started with Gokit3(S), see “Introduction to Gokit3(S) Development Kit”.
To understand the functions of the keys, see the following table.
|Reset||Short press||Reset Wi-Fi module|
|Key1||Short press||To be customized|
|Key1||Long press (3s)||Reset Wi-Fi module|
|Key2||Short press||Enter SoftAP mode|
|Key2||Long press (3s)||Enter AirLink mode|
|Key3||customized||To be customized|
To control Gokit3(S), it is recommended to adopt these two ways: use the Gizwits Gokit App or the Gizwits WeChat Official Account (ID: go-kit).
To get the Gizwits Gokit App, choose any one of the following ways:
Once the installation is successful, you can see the Gizwits Gokit App icon on the screen. Next, you can control Gokit3(S).
Now that you have got Gokit and installed the Gizwits Gokit App, the next step is to connect your Gokit to the router. How to do this? Gokit offers two ways to configure network access: AirLink, SoftAP.
Airlink is used to configure the network access, the steps of which are the same as those of the Gokit3(S) paper manual, as shown below:
Precautions for configuring network access:
Note: Make sure the phone is connected to an available router which can access the Internet. You need to know the Wi-Fi access point credentials you have used (you will need it later).
Open the Gizwits Gokit App. If you have not used it before, your App should not present any devices (as shown below).
Press and hold the Key2 button for 3 seconds. After the green LED of the function expansion board is illuminated, the Wi-Fi module enters the AirLink configuration mode (as shown below).
Click on the upper right menu of the App, then choose Add Device (as shown below). Select the Espressif Wi-Fi module and enter your router credentials.
Click the Configure button on your App. Wait for no more than one minute, and the App will indicate the successful configuration (as shown below).
Note: During this time, you can see that Gokit’s green light is off, indicating that Gokit3 is connected to your router.
After short press on the Key2 button and the red light on the function expansion board is always on, it indicates that the Wi-Fi module enters the SoftAP configuration mode (as shown below).
Go to the Wi-Fi configuration page on your phone (usually in Settings > Wi-Fi).
Select the Wi-Fi hotspot name in the form of “XPG-GAgent-XXXX” whose password is 123456789 (as shown below)
Note: XXXX is the last four digits of the Wi-Fi module’s MAC (1FDC as shown above).
Open the Gizwits Gokit App (note that you have to close the App completely from the background and then Start it again)
In the pop-up page (as shown below), select an available Wi-Fi hotspot and enter the corresponding password.
Waiting for no more than one minute, the App will indicate the successful configuration (as shown below).
Note: If you see the Gokit red light is off, it indicates that Gokit3 has successfully connected to your router.
After the device is successfully configured, it is located at the device list page by default and is not bound yet (as shown below).
After clicking on the unbound device, it will be automatically bound. At this point, the device becomes operable (as shown below).
Clicking on the device will bring you to the device’s operation page (as shown below).
On this page, you can control the Gokit in various ways, or you can receive various statuses reported by Gokit.
Gokit natively supports remote control. You can switch your mobile phone to 2G, 3G, 4G, and then start the App. You can see that your Gokit still exists and works in the same way as the local operation.
Gokit3(S) supports the MCU mode in addition to the SoC mode. For the difference between the two, please refer to the section “3.1. Difference between SoC mode and MCU mode” in “Introduction to Gokit3 series development kit”. The following illustrates how to use it in the MCU mode.
Because the firmware can be downloaded normally only in the SOC mode, first determine that the ESP8266 Wi-Fi module is located in the SoC module interface (lower position), as shown below:
When in the MCU mode, the ESP8266 (Wi-Fi module) is only responsible for receiving and transmitting data, so it needs to flash the GAgent firmware to ESP8266. GAgent is an application developed by Gizwits that can run on various communication modules. Using GAgent, you only need to focus on the business logic of the product, and don’t care about the communication function, which greatly reduces the development difficulty.
Download the latest version of GAgent here.
Note: Please download the latest version corresponding to ESP8266, as shown below:
The firmware downloading in MCU mode is similar to that in SoC mode. For details, please refer to the “Firmware downloading for ESP8266 via serial port”.
After powering off the GoKit3(S), unplug the ESP8266 Wi-Fi module from the SoC mode interface (lower position) and plug it into the “MCU mode interface” (upper position), as shown below:
The operation of Gokit3(S) in MCU mode is the same as that in SoC mode. For the network access configuration, refer to the section “3. Connect to the Router” above.
If you want to understand the entire development frameworks of Gizwits, please check Developer Documentation Center:
To check out more development tutorials, visit the Gokit section of Gizwits Community.