Skip to content

Commit

Permalink
rewrote sidebard, updated file names and references
Browse files Browse the repository at this point in the history
  • Loading branch information
aburt2 committed Oct 27, 2023
1 parent 2222a28 commit d772f5c
Show file tree
Hide file tree
Showing 47 changed files with 18 additions and 13 deletions.
5 changes: 0 additions & 5 deletions docs/Gesture Algorithms.md

This file was deleted.

File renamed without changes
File renamed without changes
File renamed without changes.
6 changes: 3 additions & 3 deletions docs/T-Stick Designs.md → docs/T-Stick-functions.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,14 +9,14 @@ This document outlines the high level functions the T-Stick does and links previ
As shown in figure below the T-Stick has a relatively straight forward functional flow block diagram.


![](uploads/3beaeacb-7875-4267-b82a-cf15952f3e30/56b52481-887d-4043-95c6-8804b80c0eab/ffbd-tstick.png)
![functional flow block diagram of T-Stick](Images/ffbd-tstick.png)

The sensors must be initialised, and then regularly polled for their raw sensor data. Any sensor errors must be processed and then converted to error messages to be sent to the user. In the fourth generation of T-Sticks this function is not fully developed but still exists, as most errors are at least printed to the serial monitor. The power system of the T-Stick handles charging the instrument, providing power to all components and changing the power state between active operation and deep sleep. The control and communication system output signals and interpret any user inputs/signals such as using the serial monitor to reboot the T-Stick.

# Previous Designs


1. [T-Stick 4GW](./T-Stick%20Designs/T-Stick%204GW.md): Wi-Fi based T-Stick design, primarily for Sopranino and Soprano T-Stick with limited support for Alto and Tenor T-Stick. Uses the TinyPico ESP32 development board for control and communication along with a FSR for pressure sensing, a Trill Board for touch sensing and a LSM9DS1 for orientation and acceleration measurements.
2. [T-Stick 5GW](./T-Stick%20Designs/T-Stick%205GW.md): Wi-Fi based T-Stick design featuring a custom ESP32-S3 development board using a WROOM2 Module, alongside a ICM20948 IMU for orientation and acceleration measurements, a MAX17055 for battery management and keeping the Trill Board and FSR from the 4GW design.
1. [T-Stick 4GW](./designs/T-Stick%204GW.md): Wi-Fi based T-Stick design, primarily for Sopranino and Soprano T-Stick with limited support for Alto and Tenor T-Stick. Uses the TinyPico ESP32 development board for control and communication along with a FSR for pressure sensing, a Trill Board for touch sensing and a LSM9DS1 for orientation and acceleration measurements.
2. [T-Stick 5GW](./designs/T-Stick%205GW.md): Wi-Fi based T-Stick design featuring a custom ESP32-S3 development board using a WROOM2 Module, alongside a ICM20948 IMU for orientation and acceleration measurements, a MAX17055 for battery management and keeping the Trill Board and FSR from the 4GW design.


14 changes: 12 additions & 2 deletions docs/_sidebar.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,12 @@
- [Read Me](README)
- [Example Second Page](second-page)
- Getting Started
- [T-Stick Home](README)
- Technical Information
- [Technical Requirements](Technical%20Requirements%20and%20Constraints.md)
- [Design Guidelines](T-Stick%20Design%20Guidelines.md)
- [T-Stick Functions](T-Stick-functions.md)
- [Availability Modelling](Availability%20Modelling.md)
- Previous Designs
- [T-Stick 4GW](./designs/T-Stick%204GW.md)
- [T-Stick 5GW](./designs/T-Stick%205GW.md)
- Gesture Algorithms
- [Puara](./algorithms/Puara%20Gestures.md)
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Note that as the TinyPico is now discontinued it can be replaced with the TinyS3
The T-Stick can be split into four subsystems: a control system, power system, sensor system, and mapping system. The current architecture of the T-Stick 4GW is shown below.


![T-Stick 4GW System Architecture](uploads/3beaeacb-7875-4267-b82a-cf15952f3e30/9cff436b-2a8a-41e3-af45-2f272963ca74/fourtehgen-systemarchitecture.png)
![T-Stick 4GW System Architecture](Images/fourtehgen-systemarchitecture.png)

The control system interprets the outputs of the sensor system, identifies gestures, and manages the power state of the T-Stick (on/sleep/off). The power system delivers power to the rest of the subsystems as well as handling the charging and discharging of batteries. The sensor system handles the input of the user as well as basic signal processing. The raw and processed signals are sent to the control system to be interpreted. The mapping system handles the T-Stick’s connections with external devices. This is handled by either libmapper or OSC. The system handles sending and receiving signals.

Expand Down
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ The T-Stick 5GW consists of a custom ESP32 board which integrates a ESP32-S3 WRO

Figure 1 shows the hardware architecture for the new T-Stick design. Most of the power sytem functions such as providing power, charging the instrument and changing the power state is handled by the MCP73871. This IC handles charging the LiPO/Li-ion battery and changing between the USB power and battery power depending on voltage. In addition, two regulators, the NCP167AMX330TBG/NCP167AMX1800TBG series are used to step down the system power to 3.3V and 1.8V respectively. The MAX17055 is used as a fuel gauge. As mentioned previously this fuel gauge is used over its non-current sensing counter parts due to better accuracy.

![Figure 1: T-Stick 5GW Architecture](uploads/3beaeacb-7875-4267-b82a-cf15952f3e30/4768188f-aa9a-4950-941c-6afa66150118/TStick-HardwareArchitecture-Pro.png)
![Figure 1: T-Stick 5GW Architecture](Images/TStick-HardwareArchitecture-Pro.png)

The Trill Craft board is kept as the capacitive sensor solution of choice. A more integrated solution using just the MCU on the Trill Craft board was considered but figuring out how to flash the MCU in a systematic way, would have been more of a hassle than it is worth. The touch board uses a 32 pin FFC connector to connect to a flexible PCB with 30 touch points and two ground points. The IMU is changed to an ICM20948 9-DOF IMU. as mentioned previously this is due to the fact that the LSM9DS1 is no longer actively supported by the company that produces it. It receives the 1.8V power from one of the regulators. Three mosfets are used to convert the 1.8V logic from the ICM20948 to 3.3V to communicate with the ESP32.

Expand Down
File renamed without changes.
2 changes: 1 addition & 1 deletion docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
<script>
// Docsify Configuration (see https://docsify.js.org/#/configuration)
window.$docsify = {
name: 'Simple Docsify Template',
name: 'T-Stick Documentation',

// Sidebar Configuration
auto2top: true,
Expand Down

0 comments on commit d772f5c

Please sign in to comment.