Arduino Library?

[Sniperblue]

Hi, is it scheduled to release also a modify Library based on this Espressif one which works with Arduino IDE. Up to now I think there is nothing around like this in the net. Unfortunaley I'am not such a Bleutooth specialist to do this by myself :-(

[jvpernis]

Hi, thanks for your interest in using this library!

Releasing an Arduino library actually hasn't crossed my mind yet. I'd like to look into how feasible porting this library would be.

However, the API exposed by Espressif's Arduino implementation is vastly diffrent from the ESP-IDF framework. Next to that, I'd probably need to rewrite this library's API as well in order to conform to the Arduino API style guide. Because of these differences, it would be most sensible to create a new repository if I ever come around to porting it to Arduino.

Don't expect it anytime soon though, but I'll try to make some time to create an Arduino library.

I'll keep this issue open so you'll get notified whenever I get around to creating the Arduino library :)

[navar00]

Same here, it would be great to have a port into arduino. There is nothing off the self so far and it is highly demanded.....

[Sniperblue]

This would be great! I remain in hopeful expectation...

[jvpernis]

Good news!

As it turns out, adding support for the Arduino IDE wasn't so hard after all. I didn't even have to create another repository for it, as it works quite nicely together with the ESP-IDF!

Now I need your help!

Before releasing it as an official Arduino library, I want to polish things up a little. In the mean time, though, I could use your help in testing this library, to see if it suits your needs. Does it work properly? Does it miss any features? Would you prefer other naming schemes for the functions and variables? Maybe you can think of a better name for the library? Let me know what you think.

Installing the ESP32 boards

In case you haven't yet, you can add the ESP32 boards to your Arduino IDE by adding them to the Boards Manager: Open File -> Preferences, and paste the following URL in the Additional Boards Manager URLs field:

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

Open the Boards Manager with Tools -> Board: "xxx" -> Boards Manager, look for esp32 (probably the last one in the list), and click install.

Finally, select the ESP32 board you have with Tools -> Board: "xxx" under the section ESP32 Arduino (I have ESP32 Dev Module selected).

Installing the Ps3Controller library

You can download the Arduino library from the development branch: esp32-ps3-develop.zip.

Then, in the Arduino IDE, you can import the library with Sketch -> Include Library -> Add .ZIP Library..., and selecting the downloaded esp32-ps3-develop.zip file.

Running an example sketch

The example sketches should be immediately available in the IDE. Try to connect to the PS3 controller first with the Ps3Connect sketch: File -> Examples -> Ps3Controller -> Ps3Connect.

Don't forget to properly pair the PS3 controller as described here.

Hope this helps!

[Sniperblue]

When I try to complie you sketch I get the following error Message:

_In file included from C:\Users\Sniperblue\Documents\Arduino\libraries\esp32-ps3-develop\src\ps3_spp.c:6:0:

C:\Users\Sniperblue\Documents\Arduino\libraries\esp32-ps3-develop\src\include/ps3_int.h:29:2: error: #error "The selected Bluetooth controller mode is not supported by the ESP32-PS3 module"

#error "The selected Bluetooth controller mode is not supported by the ESP32-PS3 module"_

I use Arduino Version 1.8.9 with ESP Version 1.0.1 installed and try to compile withESP32 Dev Module and DOIT ESP32 Dev V1 selected. The ESP32 says this ESP32 SDK Version: v3.2-dev-39-gaaf12390

Hope this helps to get an idea about the root cause..!?

[jvpernis]

Thanks for trying it out! Unfortunately, I am unable to replicate your problem. I just tried to execute the steps I described above on a fresh Windows install, using Arduino Version 1.8.9 with ESP Version 1.0.1 installed, just like you described. Even with the DOIT ESP32 Dev V1 board selected it compiles just fine for me.

Could you try to restart the Arduino IDE, or even your computer, and try again?

Have you changed any configuration settings using make menuconfig?

Could you share how you've set up your Arduino environment?

[Sniperblue]

I can't rember that I changed any configuration settings using make menuconfig.

What do you mean with share how you've set up your Arduino environment, preferences.txt file from the ...AppData\Local\Arduino15 folder or something like that?

Compiling the with same Arduino IDE delivered BLE sketch BLE client compiles at my Win7 without any issues?

[jvpernis]

With sharing your setup I meant how you installed the Arduino IDE and the ESP SDK. But yes, seeing your ...AppData\Local\arduino15\preferences.txt file could help, and maybe even your ...AppData\Local\arduino15\packages\esp32\hardware\esp32\1.0.1\tools\sdk\sdkconfig file if you can.

The error you get means a misconfiguration in the sdkconfig file, where BTDM_CONTROLLER_MODE is set to BLE, while it should be set to any of the other options which enables the Classic Bluetooth ('Both' or 'BR/EDR Only'). The default config shipped with the ESP32 boards should be adequate in this regard, which is why I think it is really strange this is happening to you!

[Sniperblue]

ESP32 was installed in a standart was as described here:
https://randomnerdtutorials.com/installing-the-esp32-board-in-arduino-ide-windows-instructions/

Here are the BT extract form the sdkconfig file:

#
# Bluetooth
#
CONFIG_BT_ENABLED=y

#
# Bluetooth controller
#
CONFIG_BTDM_CONTROLLER_MODE_BLE_ONLY=
CONFIG_BTDM_CONTROLLER_MODE_BR_EDR_ONLY=
CONFIG_BTDM_CONTROLLER_MODE_BTDM=y
CONFIG_BTDM_CONTROLLER_BLE_MAX_CONN=3
CONFIG_BTDM_CONTROLLER_BR_EDR_MAX_ACL_CONN=2
CONFIG_BTDM_CONTROLLER_BR_EDR_MAX_SYNC_CONN=0
CONFIG_BTDM_CONTROLLER_BLE_MAX_CONN_EFF=3
CONFIG_BTDM_CONTROLLER_BR_EDR_MAX_ACL_CONN_EFF=2
CONFIG_BTDM_CONTROLLER_BR_EDR_MAX_SYNC_CONN_EFF=0
CONFIG_BTDM_CONTROLLER_PINNED_TO_CORE_0=y
CONFIG_BTDM_CONTROLLER_PINNED_TO_CORE_1=
CONFIG_BTDM_CONTROLLER_PINNED_TO_CORE=0
CONFIG_BTDM_CONTROLLER_HCI_MODE_VHCI=y
CONFIG_BTDM_CONTROLLER_HCI_MODE_UART_H4=

Here are the sdkconfig:
sdkconfig.txt

Here are the preferences:
preferences.txt

[jvpernis]

CONFIG_BTDM_CONTROLLER_MODE_BTDM=y

Strange... This is exactly what I'm testing for in ps3_int.h:26.

One thing you could try is to reinstall the ESP32 boards:

• Open the Boards Manager with Tools -> Board: "xxx" -> Boards Manager
• Look for esp32 (probably the last one in the list)
• Click Remove.
• Close the Arduino IDE (not sure if this matters)
• Clear the boards cache by deleting all files in ...AppData\Local\arduino15\staging\packages that has anything to do with the ESP32.
• Launch the Arduino IDE
• Open the Boards Manager with Tools -> Board: "xxx" -> Boards Manager
• Look for esp32 again
• Select the version you'd like to install (1.0.1)
• Click Install

Now try to compile the example sketch again. If this fixes your problem then Espressif has released updates to the same 1.0.1 version (which they do regularly with the ESP-IDF, so it wouldn't surprise me).

[Sniperblue]

Unfortunately seems to be reinstalling ESP32 did not solve the issue. Still sthe same error!
My sdkconfig file and all the folder inside the sdk folder has a build date from 11.01.2019 1:35 o'clock. Does this match with your sdk folder?

Nevertheless when I uncomment your check sequence (see below) the sketch works and I get an connection after changing the MAC Adress to Ps3.begin("00:12:34:56:78:90")

/** Check the configured blueooth mode 
#ifdef CONFIG_BTDM_CONTROLLER_MODE_BTDM
#define BT_MODE ESP_BT_MODE_BTDM
#elif defined CONFIG_BTDM_CONTROLLER_MODE_BR_EDR_ONLY
#define BT_MODE ESP_BT_MODE_CLASSIC_BT
#else
#error "The selected Bluetooth controller mode is not supported by the ESP32-PS3 module"
#endif
*/

By the way could you also change the MAC Adress in the example to Ps3.begin("00:12:34:56:78:90")
because this was the deliving adress of my PS3 controller. Maybe this save up to chance the MAC with the sixpair tool for other users?

I try also your PS3Data sketch and this works also :-)

[jvpernis]

My sdkconfig file and all the folder inside the sdk folder has a build date from 11.01.2019 1:35 o'clock

Yes, this is exactly what I have as well! I still can't really wrap my head around this issue yet, but maybe someone else can chime in with their experiences.

... when I uncomment your check sequence ... the sketch works

Maybe I will just disable the checks when it's used as an Arduino library, as it would not really be needed anyway.

By the way could you also change the MAC Adress in the example to Ps3.begin("00:12:34:56:78:90") because this was the deliving adress of my PS3 controller

I don't quite understand what you mean with this. Did you have to put 00:12:34:56:78:90 in the sketch while you wrote something else to the PS3 controller with the SixaxisPairTool?

I try also your PS3Data sketch and this works also :-)

Glad to hear that!

[Sniperblue]

Concerning 00:12:34:56:78:90 I did a misstake in understanding, for BT both MAC in the controllers must match. So you had to change the MAC in the ESP32 as you described in the describition if you dont want to change the MAC in the PS3 controller.

Meanwhile I playing a litte bit around with the lib and had a few question:
How can I disable one LED, set works but how can I switch them OFF?
I see the PS3controller provides accelerometer and gyroscope values, what is the ccommand to read out them?
What is the command to activate the rumble functionality?

I pimped a little bit your data example attached you'll find my test code:
ESP32_BTclassic_PS3ControllerTest_v1_TXT.txt

[jvpernis]

How can I disable one LED, set works but how can I switch them OFF?

You can simply set the LED to 0. I might add an enum or something to make this more obvious. Your code would look like this:

Ps3.setLed(0);

I see the PS3controller provides accelerometer and gyroscope values, what is the ccommand to read out them?

The accelerometer and gyroscope values should be provided automatically, but I haven't tested this yet. You can read the values like this:

Ps3.data.sensor.accelerometer.x;
Ps3.data.sensor.accelerometer.y;
Ps3.data.sensor.accelerometer.z;
Ps3.data.sensor.gyroscope.z;

What is the command to activate the rumble functionality?

Unfortunately, this hasn't been implemented in the Arduino library yet. In the mean time, you could just use the following snippet:

ps3_cmd_t cmd;

cmd.rumble_left_intensity = 0xff;
cmd.rumble_right_intensity = 0xff;
  
cmd.rumble_right_duration = 100;
cmd.rumble_left_duration = 100;
  
ps3Cmd(cmd);

I pimped a little bit your data example

Thanks! I had planned to include a bigger example sketch to showcase all of the data you can access, and this helps a lot!

[Sniperblue]

I include your information into the test sketch. Here are the test results:

Rumble functionality

• Only the right rumble works, the left ont won't work but I'am not sure whether this is an code or issue with my PS3 controller?

Battery functionality

• The response shows still LOW althought the Controller was loaded over night?

LED functionality

• ALL 4 LED starts blinken when the rumble request was activated and does not stop doing this?
• Ps3.setLed(0); means deactivation of ALL LED's so I hat to set the LED which should still active after this command again?

LED 1 == ON | LED 2 == OFF
Ps3.setLed(1);

LED 1 == OFF | LED 2 == ON
Ps3.setLed(0);
Ps3.setLed(2);

Accelerometer functionality

• Shows no values when PS3controller was moved?
  Accelerometer X-Acc: -4 Y-Acc: 0 Z-Acc: 16

Gyroscope functionality

• Shows no yaw values when I rotate the PS3controller?
  Gyroscope: 0

But maybe I do some misstakes during conding and the above mentioned weaknesses are no Lib issues!