dthuering/nervousnet-axons

Axons let you visualise and manipulate your phones sensor data.

Nervousnet Axons

Axons let you visualise and manipulate your phones sensor data using the nervousnet Android or iOS apps. You can get Axons from the nervousnet Space accessible within the apps. Axons are not standalone applications and only run within the nervousnet Android or iOS app, giving developers easy access to sensor data but also to a future computational infrastructure.

How to Make an Axon

Take a look at the example axon, fork and modify it:

1. Fork Example Axon.
2. Modify your axon by changing axon.html and axon.js to do what you like.
   • A UI framework is included for your convenience.
   • You may use a local browser to test the Axon, although the special URLs below and the included libs.js will only be available on your phone at this time.
   • Testing Axons on the phone is easy, as your code is redownloaded from your GitHub repo when you press the special refresh button (this is why step 1 is important).
3. Submit package.json here and it will be added to the nervousnet Space in the Android and iOS apps by us.
4. Download and install your Axon from the nervousnet Space in the Android and iOS apps.

Getting Sensor Data from Your Phone

Call these local URLs from within the Axon code to get real time sensor data of your phone

• http://localhost:8080/nervousnet-api/raw-sensor-data/GPS
• http://localhost:8080/nervousnet-api/raw-sensor-data/Accelerometer
• http://localhost:8080/nervousnet-api/raw-sensor-data/Magnetometer
• http://localhost:8080/nervousnet-api/raw-sensor-data/Gyroscope
• http://localhost:8080/nervousnet-api/raw-sensor-data/BLE
• more methods that allow saving data to phone and more coming in future releases

## Documentation

• Nervousnet Android App Docs
• Nervousnet iOS App Docs

Submitting Axons to Nervousnet Space

1. Fork this repository.
2. Add your axon's package.json under a new name in the contrib or testing directory. Note: Axons added to the testing directory are immediately available on the Testflight version of the app.
3. Send us a pull request and your axon will be available shortly.

Debugging Axons

1. Open the Axon in the nervousnet app on your phone or simulator.
2. Open Safari and enable the develop menu.
3. Go to "Develop" and select your phone or simulator (see screenshot), then the axon.html page.
4. An inspector will open, with which you have full debugging access (editing code, breakpoints, network analysis, etc). This is also where you'll see console.log messages.