This Unity package provides the libraries and API needed to connect the StimulHeat BLE device to Unity projects. It includes a Windows desktop demo that demonstrates how to establish connections and interact with the device.
You can install the package directly via Unity's Package Manager:
- Open your Unity project.
- Go to Window > Package Manager.
- Click the + button in the top-left.
- Select "Add package from git URL...".
- Paste the following repository URL and click Add.
https://gitlab.com/BiomedicalSensors/renforce/stimulheat/stimulheat-unity-scenes
The package will then appear in your Packages folder under StimulHeat.
A demo scene is included to help you quickly test the integration.
- Navigate to
Packages/StimulHeat/Examples - Open StimulheatDemoScene
- Enter Play Mode in the Unity Editor
- Turn on your StimulHeat devices
- Add every the public name of your StimulHeat devices (e.g. 0F6C) by clicking on
+ - You can remove a device by clicking on
- - When you have added every device, click on
Finish Configuration
- Select the device you want to control by selecting the according tab
- Click on the Temp/Flux toggle to change the modality of control
- Use the slider to select the value
- Click on Send Command to control the StimulHeat
- Click on Turn Off if you wish to stop giving thermal control. Be aware that temperature readings are only available when the device is turned on.
The demo shows the minimal workflow to integrate StimulHeat into a Unity project:
-
Navigate to
Packages/StimulHeat/Prefabsand add the StimulHeat prefab to your scene. This handles BLE scanning, connecting, and communication. -
By default, the BLEPlatformSwitch component is disabled, as it needs a list of StimulHeat devices to work. The list in the StimulHeatDevicesManager must be filled before enabling BLEPlatformSwitch (from either a static file or a GUI, the demo scene uses a GUI).
-
Use BLEPlatformSwitch methods to control your StimulHeat devices.
This software source code is licensed under the terms of the GNU General Public License v3 (GPLv3). You are free to use, study, modify, and distribute it under the same license. SPDX-License-Identifier: GPL-3.0-only
🔒 For commercial use without open hardware obligations, a separate commercial license may be available. For more details, see the License file.
The main contributors to this project are Matthieu Mesnage and Bertrand Massot from INSA Lyon, CNRS, INL UMR 5270, Villeurbanne, France.
The main developer of this Unity Package is Sophie Villenave, from Ecole Centrale de Lyon, CNRS, LIRIS UMR 5205, Saint-Etienne, France.
This work was supported by the French National Research Agency (ANR) under grant ANR-22-CE31-0023-03 RENFORCE.