User Manual

VibHub is an open source, open hardware vibrator controller. It allows you to turn any non-battery-driven USB vibrator into a smart internet capable one, supporting 2 ports for the VibHub micro, and 4 ports for the classic 4xAA version. This manual is focused on the newer VibHub Micro version, but a lot of what's written here is also true for the older 4x AA version.

WARNING

• The VibHub USB output ports are ONLY for powering motors or similar simple devices such as lights. DO NOT USE THEM TO CHARGE COMPLEX DEVICES, OR YOU MAY CAUSE DAMAGE TO THEM!

First steps

1. Your device may arrive uncharged or with low charge. Plug the USB port into a charger. A red LED will light up. On charge completion, a green or blue LED will light up next to the charge port.
2. On the side of the device (next to the charging port), is an on/off switch. It's recommended to charge with the device being off.
3. The charging may take up to 3 hours. Footnotes: The reason it takes so long to charge is because the USB spec for computers is limited to 500mA, and the battery size is 1500mAh. Smart charge modules are still quite pricey, so this was a price/user-friendliness tradeoff.

Connecting to WiFi

The VibHub uses WiFi to communicate. The first time you turn on your device, the status LED (near the USB output ports) will turn a solid blue, indicating that the device is in configuration mode.

Note: You can always enter configuration mode by holding down the configuration button (next to the USB charge port) until the status LED turns blue.

1. Use a phone, laptop, or other WiFi device and look for networks. Locate the network called VibHub Micro (or similar for your device), and connect to it.
2. On a phone, you usually get the popup "this network requires login" or similar, in which case click that button to enter the captive portal. If not, you can manually open a browser and go to http://192.168.4.1
3. Make note of the device ID, which is the random letters and numbers in the yellow box. This is your "key" used to grant applications access to your device. Click the device ID to copy it. If you want to deauthorize all applications, you can generate a new device id (see below).
4. Click Setup to configure WiFi.
5. The WiFi page lists detected access points. Click the WiFi you want to connect to.
6. Enter the WiFi password.
7. Press Save. And wait for the device to reboot.
8. If the Status LED turns GREEN, you're ready to start using the device! If it turns blue, reconnect to the device WiFi and make sure you entered the correct WiFi credentials.

Using an App

This comes down to the specific app you'll want to use. But in general, most apps will provide a way to enter your device ID, (and often a minimum value).

Socket Demo

If you just want to quickly test if your device works, try the socket demo: https://jasxsl.github.io/VibHub-SocketDemo/

1. Paste your device ID into the text box. When connected, some sliders will be shown. Note: The VibHub cannot be used by an app while in WiFi configuration mode (blue LED).
2. Drag the first two sliders up to max. You should see the blue LEDs on the USB vibrator ports on your device light up (and any vibrator plugged in will start moving).
3. Pressing "send pulse" sends a pulse program.
4. Pressing "Get Battery" gets a battery voltage reading (if supported).

Reconfiguring

1. To reconfigure your device. Turn it on first. Then long-press the config button until the status LED turns a solid blue.
2. Connect again via WiFi (see first steps).

Change device ID

Note: Changing device ID will de-authorize all apps that have access to your device.

1. After entering the configuration portal, press New Normal ID to replace your current ID
2. You can also choose to generate a secure ID. A secure ID is longer and mixes upper and lower case characters.

Factory Reset

Factory reset will reset all configuration, including WiFi settings and your device ID. This can be useful if you intend to sell or give your device away and want to reset any personal information.

1. To perform a factory reset, turn your device off, then hold the config button while starting it. The status LED will flash RED. Upon performing a factory reset, the device will automatically enter WiFi configuration mode when started.

Custom Server

VibHub is fully open source, so if you want to host your own server, you absolutely can (install instructions here: https://github.com/JasXSL/VibHub-Server/)! Or maybe you just want to connect to someone else's server.

1. In config mode, click Setup.
2. At the bottom of the page, enter server host and server port. Do not use http or https:// etc in the server host, just the domain.

Status indicator

The status LED is located toward the USB output ports (where you plug in vibrators).

Color	Status
Solid Blue	Device is in WiFi Configuration mode. You can connect to it via WiFi, and configure it at http://192.168.4.1
Solid Green	Device is connected and operational!
Slow flashing green/yellow	Device is connected and operational, but battery is low.
Flashing blue/red	WiFi error, try restarting or reconfiguring.
Flashign red/green	Socket error, check if your server (usually vibhub.io) is up?
Cyan	Connecting...
Slow red blink	Disconnected from server.
Pink Flash	A websocket app has connected to our device.