This guide is tested on Ubuntu 16.04, but should also work on newer versions.
For the usage of the Bionic-Kit the Arduino IDE is needed.
In case, you have not already installed it, download the latest version from here .
Extract the archive to a location of your choice, for example in your /home folder.
By using the terminal, navigate to the extracted folder and change the execution rights of the file install.sh with:
sudo chmod +x install.sh
Now execute the install.sh file in the terminal
./install.sh
If no error occured, the installation of the Arduino IDE is done. Start the IDE once to make sure that everything is working properly and the IDE has generated all necessary folders for further installations.
To start the Arduino IDE, run the Arduino entry in the Start-Menu or run the binary inside the extracted Arduino folder with:
./arduino
If successfully opened, you can close the IDE again.
In case there is an error, visit the [Arduino Troubleshooting Page] (
https://forum.arduino.cc/index.php#c2
)
To compile the source code of the Bionic-Kit, additional libraries are needed.
The Bionic-Kit is based on the ESP32 SoC from Espressif, therefore the Arduino Core for the SoC is mandatory. To install all needed files follow the instructions on the official Espressif Arduino GIT here .
There is also an install guide on the official git repository called “Instructions for Boards Manager”. While testing the realease version 1.0, it was noted that it did not contain all necessary libraries and therefore we suggeest to use the above steps.
If you are interested in more stuff regarding the ESP32 for Arduino explore the official GIT repository .
For the purpose of displaying the control website of the Bionic-Kit a special web server for the ESP32 is needed. Therefore run:
cd ~/Arduino/libraries
Then clone the repository of the web server to the present directory:
git clone https://github.com/me-no-dev/ESPAsyncWebServer.git AsyncWebserver
The web server needs an additional package. Therefore stay in the libraries folder and clone the AsyncTCP repository as well:
git clone https://github.com/me-no-dev/AsyncTCP.git AsyncTCP
A special branch of the AsyncTCP has to be used, because of the current development status of the AsyncWebServer. For this, enter the directory and checkout the idf-update branch with:
cd AsyncTCP
git checkout idf-update
This extra step is necessary for the Asyncwebserver Version dated 26.09.2018. In future releases this step might not be necessary.
The last library which is needed to get the Bionic-Kit running is the ESP32Servo library.
1. For this go back to the libraries folder and clone the following repository:
cd ~/Arduino/libraries
git clone https://github.com/jkb-git/ESP32Servo.git ESP32Servo
To load the website to the internal file system of the ESP32 Chip a special upload tool is needed.
Then navigate to the Arduino folder and create a folder named “tools” if it doesn’t exist yet.
cd ~/Arduino
mkdir tools
Unpack the previous downloaded ZIP archive into tools directory (the path will look like
This installation guide is tested on Windows 10.
For the usage of the Bionic-Kit the Arduino IDE is needed. If you have not already installed it download the latest version from here
To compile the source code of the Bionic-Kit, additional libraries are needed.
The Bionic-Kit is based on the ESP32 SoC from Espressif, therefore the Arduino Core for the SoC is mandatory. To install all needed files follow the instructions on the official Espressif Arduino GIT here .
There is also an install guide on the official git repository called “Instructions for Boards Manager”. While testing the realease version 1.0 (July 2019), it was noted that it did not contain all necessary libraries and therefore we suggeest to use the above steps.
If you are interested in more stuff regarding the ESP32 for Arduino explore the official GIT repository .
For the purpose of displaying the control website of the Bionic-Kit a special web server for the ESP32 is needed.
Therefore run the
GIT gui
for Windows from your Start-Menu to clone the relevant library.
On the appearing Git Gui select
Clone Existing Repository
C:/Users/[YOUR_USER_NAME]/Documents/Arduino
and is listed underneath the “Sketchbook location” in Arduino preferences.
https://github.com/me-no-dev/ESPAsyncWebServer.git
[ARDUINO_SKETCHBOOK_DIR]/libraries/AsyncWebServer
Clone
to start cloning the repository
The AsyncWebserver needs an additional AsyncTCP package. This has to be cloned as well:
C:/Users/[YOUR_USER_NAME]/Documents/Arduino
and is listed underneath the “Sketchbook location” in Arduino preferences.
https://github.com/me-no-dev/AsyncTCP.git
[ARDUINO_SKETCHBOOK_DIR]/libraries/AsyncTCP
Clone
to start cloning the repository
Because of the current development status of the AsyncWebServer a special branch of the AsyncTCP has to be used. For this, the
idf-update
branch has to be checked out. When the previous cloning process is finished, click on
Branch
in the appearing window and select
Checkout...
In the
Checkout Branch
Window choose the bullet point
Tracking Branch
and then select
origin/idf-update
. At last click button
Checkout
.
The last library which is needed to get the Bionic-Kit running is the ESP32Servo library. For this open the
Git Gui
again and clone the ESP32Servo library to the
Arduino/libraries
folder as well.
C:/Users/[YOUR_USER_NAME]/Documents/Arduino
and is listed underneath the “Sketchbook location” in Arduino preferences.
https://github.com/jkb-git/ESP32Servo.git
[ARDUINO_SKETCHBOOK_DIR]/libraries/ESP32Servo
Clone
to start cloning the repository
To load the website to the internal file system of the ESP32 Chip a special upload tool is needed.
1. Go to
https://github.com/me-no-dev/arduino-esp32fs-plugin/releases/
and download the ZIP file of the sketch data upload plugin.
2. Navigate to the Arduino folder and create a folder named
tools
if it doesn’t exist yet.
3. Unpack the previous downloaded ZIP archive into tools directory (the path will look like
4. Restart the Arduino IDE
In the Arduino IDE select
Tools -> Board: -> ESP32 Dev Module
Make sure that the right port is selected. For this select
Tools -> Port
. If you use Windows the Port is named
COM X
, if you use Ubuntu your serial port is called
/dev/ttyUSBX
Click on the
upload
button (Arrow) on the top left corner of the Arduino IDE to compile the code and upload it to the Bionic-Kit. This may take a while.
Tools -> ESP32 Sketch Data Upload
Serial Monitor
of the Arduino IDE (magnifying glass symbol in the top right corner)
Now reset the ESP32 by pressing down the reset button on the PCB. The output should look like that:
Open your wifi settings menu of your PC and search for the shown
ẀifiSSID
for example “b4e_84_0D_8E_35_5A_EC”
Connect to the found wifi network with password
education
Once connected, open your web browser and type the address
www.b4e.de
or
192.168.4.1
If the batteries are attached on the Bionic-Kit and the switch is turned on, you should now be able to control the servos with the sliders.