Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/graysonarts/imuduino-3js

An example setup for using Imuduino with three.js (with a little bit of websockets thrown in)
https://github.com/graysonarts/imuduino-3js

Last synced: about 5 hours ago
JSON representation

An example setup for using Imuduino with three.js (with a little bit of websockets thrown in)

Awesome Lists containing this project

README

        

IMUduino + ThreeJS README
=========================

If you are using a Bluetooth 4.0 adapter on a GNU/Linux machine, you may need to run the following command from within this folder:

```
find -path '*noble*Release/hci-ble' -exec sudo setcap cap_net_raw+eip '{}' \;
```
...This will allow the noble library to run without requiring 'sudo' to access local hardware.

Note, if you have multiple Bluetooth HCI devices on your machine, you may need to power down the non-BLE capable devices using `hciconfig hciX down` (X is the index number, as seen with the `hcitool` command).

# Starting up
Grab a checkout of this code, then run the following from within the checkout 'imuduino-3js' folder (Node v0.12 or better):

```
# Install these globally if you don't have them yet...
npm install -g gulp
npm install -g browserify

# Install local deps
npm install

# Run gulp
gulp

# Configure app to run the Yaw-Pitch-Roll section, see localhost:4200/ after starting the server.
npm config set imuduino-3js:type IMUduino_Bluetooth_UART_YawPitchRoll

# Plug in your IMUduino board,
# Upload sketch "IMUduino_Bluetooth_UART_YawPitchRoll",
# Start the Arduino Serial Monitor!

# Start the server. See configuration notes below first.
npm start

```

## Configuration
The `lib/service-info.js` file contains the value for your Peripheral UUID (Your IMUduino's Universally Unique ID).

* PLEASE UPDATE IT WITH YOUR IMUDUINO's UUID *

If you don't know it, open up the Nordic "nRF UART v2.0" app on a BT 4.0 Smart Device (Android or iOS), and power up your IMUduino.
Start the Arduino Serial Monitor, then use the app to scan. Your UUID should letters and/or numbers only, no colons - likeley all lower case.

If you have a Unix/Linux machine, and you have the hcitool and hciconfig commands, you can also scan as follows:

```
# Assuming hci0 is a Bluetooth LE capable HCI device. CTRL-C to stop scanning.
sudo hcitool -i hci0 lescan
```