Github repository for the UvA's information studies course "Societal Complexity and Designing with Data".
Spectaicles Prototype, Progressive Web App for visual impairment tests. Uses Node.js with Express and EJS as a templating engine. Includes code for the prototype of the control device which runs on a ESP32 microcontroller with the BLE Keyboard library. Additionally the controller folder includes the .step and Fusion 360 files (3D files) of the CADed enclosure for the controller.
To run this project locally on your machine.
For the web application; make sure you have node and npm installed on your machine.
For the control device; install the Arduino IDE with the ESP32 and BLEKeyboard library.
To run the web application open the command line (terminal) and enter:
# start a development server in watch mode
npm run dev
To upload the sketch of the microcontroller:
- Open the controller.ino in the Arduino IDE
- Upload the sketch to the microcontroller
- Add a power source to controller
- Connect to it via the bluetooth settings of your device
A deployed version of the web application is continously deployed on Render.
├── controller # Arduino code, 3D files of the controller
├── python # Python code for distance measurement
├── static # Fonts, images, client-side javascript etc.
├── views # Pages and partials of the web interface
├── server.js # Entry point to start the server
└── README.md