top of page

- Manual Overview

​

- Materials and Lab Setup

​

- Interactive Labs

Materials and Lab Setup

​In order to prepare for deployment, there are 2 different tasks that must be completed. The first task is for students to obtain all necessary parts of the kit and make sure that all the parts in the kit are present, so that they can put all the pieces together. The second part is that students must be able to obtain a device that is able to run the server link, either on windows or Chrome. The server link contains all of the activities and telemetry data for the sonic sole so that the students can run the activity.

Required Materials

Required Items in Each Box:

  • 1x Hardware assembly  - All required hardware components are available HERE

  • 1x 3D Printed Case

  • 1x logic unit

  • 1x foam sheet

  • 1x Tape

  • 1x Tacky Glue

  • 1x Scissors

  • 1x Pen / Pencil (easier to trace then cut foam sheet)

Server and Dashboard Setup

1.      Navigate to the Repository: Open a web browser and go to the project's GitHub page.

2.     Download the Project: Click the green Code button near the top right of the page and select Download ZIP.

3.     Extract the ZIP Folder: Locate the downloaded file (SonicSole-main.zip) in your Windows File Explorer. Right-click the file, select Extract All..., and click Extract to unpack the files.

4. Install Python

Open your newly extracted SonicSole-main directory. If Python is not yet installed on your system, open a command prompt terminal and type python followed by Enter. This will trigger the Windows Microsoft Store to open the official Python installation page. Click Get/Install and wait for it to complete.

5. Install Required Python Libraries

Open a terminal window and run the following command to download the server framework and mathematical backend packages needed for this dashboard: 

python -m pip install flask numpy matplotlib scipy websockets

6. Navigate to the Correct Application Folder

Open your regular Windows File Explorer and double-click into SonicSole-main, then double-click into the inner SonicSole-main folder, and finally double-click into the folder named web_page.

7. Open Terminal in the Current Directory

Click directly into the empty space of the address bar at the very top of your Windows File Explorer window (where the folder path is listed). Clear the text, type cmd, and press Enter. A black Command Prompt window will open up already pointed at the web_page directory.

8. Execute the Application Script

In the newly opened Command Prompt terminal, type the following command to spin up the backend script: python app.py 

Identify the Server Link: The terminal will display server logs and appear to "freeze" or stop updating. Look for the white lines stating the active local network port. It will resemble: Local: http://127.0.0.1:5001

9. Open the Dashboard in a Web Browser

Leaving the Command Prompt window completely open in the background, open your preferred web browser (e.g., Chrome, Edge). Copy and paste [http://127.0.0.1:5001](http://127.0.0.1:5001) into the URL address bar at the top and press Enter to view the live dashboard.

​

To access the dashboard any time after the previous steps have been completed:

1. Open your normal Windows File explorer and go to your web_page folder. If you cant find it, search it up on the home bar. 

2. Click on the address bar at the very top, type cmd, and hit enter. 

3. In the black terminal that pops up, just type python app.py and hit enter. 

4. Open your web browser and go to 

http://127.0.0.1:5001.

bottom of page