https://github.com/virtuallyaverage/vrc-haptics-firmware

Firmware for the DIY haptics vest. ESP8266, or ESP32 based,
https://github.com/virtuallyaverage/vrc-haptics-firmware

esp32 esp8266 haptics platformio platformio-arduino virtual-reality virtual-reality-interfaces vr vrchat

Last synced: 3 days ago
JSON representation

Firmware for the DIY haptics vest. ESP8266, or ESP32 based,

• Host: GitHub
• URL: https://github.com/virtuallyaverage/vrc-haptics-firmware
• Owner: virtuallyaverage
• License: apache-2.0
• Created: 2024-08-17T11:02:47.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2024-11-03T03:03:57.000Z (3 days ago)
• Last Synced: 2024-11-03T04:16:55.047Z (3 days ago)
• Topics: esp32, esp8266, haptics, platformio, platformio-arduino, virtual-reality, virtual-reality-interfaces, vr, vrchat
• Language: C++
• Homepage:
• Size: 2.29 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# VRC-Haptics-Firmware-ESP

Firmware for the DIY haptics solution, See the projects PC application for more info: [VRC-Haptics-Host](https://github.com/virtuallyaverage/VRC-Haptics-Host)

## Usage

### Setup Environment

1. This project uses the Visual Studio Code extension PlatformIO. Please install both:

	- [Visual Studio Code](https://code.visualstudio.com/)

	- [PlatformIO](https://docs.platformio.org/en/latest/integration/ide/pioide.html#platformio-for-vscode)

2. Download this repository:

	- Use the big green "Code" button on at the top of the page and select Download Zip. 

	- Extract this repository somewhere you can find it later.

		- We will reference this location (path) as `` going forward.

### Setup Configuration

1. Open Config file:

	- Open the folder`/VRC-Haptics-Firmware-ESP` in Visual Studio Code

	- In VSCode open the config.hpp file found in the `include` folder.

2. **IMPORTANT** Notes on formatting:

	- Being precise with typing is **VERY** important. Spaces, CAPITALS, lowercase, and commas (`,`) all have meanings. Missing one will likely throw an error. Likely nothing catastrophic, but probably a pain to diagnose without help.

		- Most lines start with a hashtag prefix, like: `#define` They require a space between the keyword, and it's definition: `#define keyword configuration`

	-  Green lines are comments and don't affect the program at all (start with `//`)

		- To "uncomment" remove the two backslashes preceding a line: `//#define ROLE_VEST` -> `#define ROLE_VEST`

		- To "comment" a line do the reverse: `#define ROLE_VEST` -> `//#define ROLE_VEST`

3. Set Configuration: 

	There are 2 main items to configure: WIFI and Device Role

	1. WIFI: 

		1. `WIFI_SSID` this is your WIFI name you see on your computer. It tells the haptic device which network to connect to.

		2. `WIFI_PASSWORD`This is the password to your network, like what is used to connect your computer to WIFI.

	2. Device Role:

		1. Uncomment the role of the device you built to use the default configurations. 

		2. e.g. If you have a head haptics device, remove the `//` from the `#define ROLE_HEAD` and add them before 

		3. **NOTE:** You should only have ONE device role uncommented at a time. 

### Upload Program 

Next and final step is uploading the program to your device. 

1. Connect Board to computer VIA USB

2. Expand your platform type from the PlatformIO (wasp logo) on the left sidebar

3. Build and upload firmware: `` -> `General` -> `Upload`

### Enjoy!

If your configuration is accurate, your board is now capable of connecting to the server and driving your haptics. Have fun!