e-puck2 mobile phone development and Wheelphone: Difference between pages

From GCtronic wiki
(Difference between pages)
Jump to navigation Jump to search
 
No edit summary
 
Line 1: Line 1:
[{{fullurl:e-puck2}} e-puck2 main wiki]<br/>
=Features=
* compatible with <b>Android</b> phones (USB communication) and <b>iPhone</b> (sound cable)
* telepresence (with Skype and robot remote control) <span class="plainlinks">[https://www.gctronic.com/doc/index.php/Wheelphone-videos#Wheelphone_robot_telepresence_with_Skype_.28iPhone_and_Android.29 <img width=16 src="https://www.gctronic.com/doc/images/phones-video-call-icon.png">]</span>
* avoid obstacles <span class="plainlinks">[https://www.gctronic.com/doc/index.php/Wheelphone-videos#Wheelphone_robot_capabilities <img width=16 src="https://www.gctronic.com/doc/images/phones-video-call-icon.png">]</span>
* doesn't fall from table <span class="plainlinks">[https://www.gctronic.com/doc/index.php/Wheelphone-videos#Wheelphone_robot_capabilities <img width=16 src="https://www.gctronic.com/doc/images/phones-video-call-icon.png">]</span>
* runs on carpet <span class="plainlinks">[https://www.gctronic.com/doc/index.php/Wheelphone-videos#Wheelphone_overcomes_obstacles <img width=16 src="https://www.gctronic.com/doc/images/phones-video-call-icon.png">]</span>
* docking station <span class="plainlinks">[https://www.gctronic.com/doc/index.php/Wheelphone-videos#Wheelphone_navigation_and_automatic_docking_with_markers <img width=16 src="https://www.gctronic.com/doc/images/phones-video-call-icon.png">]</span>
* charges phone
* available examples (apps) source code


=Robot configuration=
For more technical specifications refer to the page [{{fullurl:Wheelphone technical specifications}} Wheelphone technical specifications]
For working with Bluetooth Low Energy, the main microcontroller must be programmed with the factory firmware and radio module must be programmed with a dedicated firmware (not the factory ones):
* for the main microcontroller, refer to section [http://www.gctronic.com/doc/index.php?title=e-puck2#Firmware_update main microcontroller firmware update]
* [http://projects.gctronic.com/epuck2/esp32-firmware-ble_12.12.18_bb3bd7e.zip radio module ble firmware (12.12.18)], for information on how to update the firmware refer to section [http://www.gctronic.com/doc/index.php?title=e-puck2#Firmware_update_2 radio module firmware update]
Put the selector in position 15.<br/>


Section [http://www.gctronic.com/doc/index.php?title=e-puck2_mobile_phone_development#Connecting_to_the_BLE Connecting to the BLE] gives step by step instructions on how to accomplish your first BLE connection with the robot.<br/>
=Getting started=
Informations on how to start playing with the Wheelphone robot can be found in the following page [{{fullurl:Getting started}} Getting started].


=Connecting to the BLE=
=Software=
A minimal Android application was implemented as a starting point for further development. The built application can be downloaded from [http://projects.gctronic.com/epuck2/e-puck2-android-ble.apk e-puck2-android-ble.apk].<br/>
You can find the software related to the <b>Android</b> platform on the following page [{{fullurl:Android software}} <b>Android software</b>].<br/>
This application lets you connect to the robot and once connected, the phone receives the proximity sensors data and you can also send motion commands to the robot.<br/>
You can find the software related to the <b>iPhone</b> platform on the follwing page [{{fullurl:IPhone software}} <b>iPhone software</b>].
Follow these steps to connect to the robot:
# Turn on the robot, it will start advertising as <code>E-PUCK2_BLESPP</code>.
# Install the application in your phone and turn on Bluetooth (beware that your phone must support Bluetooth 4)
# Open the application <code>e-puck2 monitor BLE</code> and click on the <code>Connect</code> button; the robot should appear in the list of discoverable devices as shown in the following figure
# Select the robot and the connection will be established. If it doesn't work the first time, retry once more; if you still have connection problems try by switching off and on again the Bluetooth
# Now you will receive the sensors data and you can pilot the robot as shown in the following figure
<span class="plain links">[http://projects.gctronic.com/epuck2/wiki_images/e-puck2-ble-app1.png <img width=150 src="http://projects.gctronic.com/epuck2/wiki_images/e-puck2-ble-app1.png">]</span> <span class="plain links">[http://projects.gctronic.com/epuck2/wiki_images/e-puck2-ble-app2.png <img width=150 src="http://projects.gctronic.com/epuck2/wiki_images/e-puck2-ble-app2.png">]</span><br/>


=Get the source code=
=Media=
The main microcontroller wifi firmware source code can be downloaded with the command:<br/>
You can find images of the Wheelphone in the following page: [{{fullurl:Wheelphone-images}} Wheelphone images].<br/>
<code>git clone --recursive -b wifi https://github.com/e-puck2/e-puck2_main-processor.git</code><br/>
You can find various videos of the Wheelphone in the following page: [{{fullurl:Wheelphone-videos}} Wheelphone videos].


The radio module ble firmware source code can be downloaded with the command:<br/>
=Hands-on=
<code>git clone --recursive -b ble_spp https://github.com/e-puck2/esp-idf.git esp-idf_ble</code><br/>
If you're interested in doing some mechanical experiments to play with the Wheelphone robot visit the section [{{fullurl:Hands-on}} Hands-on].
 
The Android application source code can be downloaded from the following link [http://projects.gctronic.com/epuck2/e-puck2_ble_monitor.zip e-puck2_ble_monitor.zip]. It's an <code>Android Studio</code> project.

Latest revision as of 12:36, 27 January 2023

Features

  • compatible with Android phones (USB communication) and iPhone (sound cable)
  • telepresence (with Skype and robot remote control)
  • avoid obstacles
  • doesn't fall from table
  • runs on carpet
  • docking station
  • charges phone
  • available examples (apps) source code

For more technical specifications refer to the page Wheelphone technical specifications

Getting started

Informations on how to start playing with the Wheelphone robot can be found in the following page Getting started.

Software

You can find the software related to the Android platform on the following page Android software.
You can find the software related to the iPhone platform on the follwing page iPhone software.

Media

You can find images of the Wheelphone in the following page: Wheelphone images.
You can find various videos of the Wheelphone in the following page: Wheelphone videos.

Hands-on

If you're interested in doing some mechanical experiments to play with the Wheelphone robot visit the section Hands-on.

Retrieved from "http://www.gctronic.com/doc/index.php?title=e-puck2_mobile_phone_development&oldid=2234"