readme.md 2.63 KB
Newer Older
*Kim's avatar
*Kim committed
1
# About the Kymera wearables
*Kim's avatar
*Kim committed
2 3 4 5 6 7 8

Kymera werables are designed from the ground up to be affordable assistive
technology devices with a focus on durability, upgradability, and
user-extensibility.  To this end the Kymera wearables are developed as
open-source hardware, with the idea that the source provided can be used to
build an ecosystem of extensible assistive technology wearables.

*Kim's avatar
*Kim committed
9 10
These werables use [Haptic Braille](#haptic-braille) to provide users constant
access to information without the need to view a screen.
*Kim's avatar
*Kim committed
11

*Kim's avatar
*Kim committed
12 13 14 15 16 17 18 19 20 21 22 23 24
This is the main repository for the Kymera wearables, which functions as a
starting point for newcomers and central area for issue tracking.  For source
code, or to place a pull request, please check out one of the related
repositories:

- Core libraries [@kymera/core][]
- Simulator app [@kymera/simulator][]

[@kymera/core]: https://gitlab.com/chameleoid/kymera/core
[@kymera/simulator]: https://gitlab.com/chameleoid/kymera/simulator


## Development Boards
*Kim's avatar
*Kim committed
25 26 27 28

Minimum Hardware Features:
- 3 haptic feedback vibrators or actuators; required for Haptic Braille
- 3 hardware buttons
*Kim's avatar
*Kim committed
29 30 31 32 33 34 35 36 37 38 39 40 41

Preferred Features:
- 8 haptic feedback vibrators or actuators
- 3 hardware buttons
- For TTS support, an SBC with a minimum of 256MB of RAM is recommended

Supported SBCs:
_TBD_
<!--
- OMEGA2+
- Pi Zero W
- Banana Pi BPI-M2 Zero
-->
*Kim's avatar
*Kim committed
42 43


*Kim's avatar
*Kim committed
44 45 46 47 48 49 50 51 52
## Haptic Braille
Haptic Braille comes in three forms; [Full-Cell](#full-cell-haptic-braille),
[Split-Cell VI](#varying-intensity), and [Split-Cell VC](#varying-cadence).

### Full-Cell Haptic Braille
Full-cell Haptic Braille pulses each cell to an array of haptic feedback
vibrators or actuators.

### Split-Cell Haptic Braille
*Kim's avatar
*Kim committed
53 54
Split-cell Haptic Braille cuts each cell into two sections (left/right halves),
reducing the minimum number of vibration sources to three.  Cells are then
*Kim's avatar
*Kim committed
55
rendered using one of two methods: varying intensity, or varying cadence.
*Kim's avatar
*Kim committed
56

*Kim's avatar
*Kim committed
57 58
#### Varying Intensity
The first half of a cell uses light pulses to mark empty
*Kim's avatar
*Kim committed
59 60 61 62
dots, and regular pulses to mark filled dots.  The second half of a cell uses
regular intensity pulses to mark empty dots, and heavy pulses to mark filled
dots.

*Kim's avatar
*Kim committed
63 64
#### Varying Cadence
Like the first method, light pulses mark empty dots, and
*Kim's avatar
*Kim committed
65 66 67 68
stronger pulses mark filled dots.  The pause duration between the first and
second half of the cells are timed at 2/3 the pause duration between cells.
Ex: If the pause between cells is set to 300ms, the pause between cell halves
would then be 200ms.
*Kim's avatar
*Kim committed
69 70 71 72 73 74


## Text-to-Speech
Kymera wearables use Mimic for TTS capabilities due to its ease of use and
relatively low system requirements.  At the moment we're looking to find ways
to synchronize speech synthesis and Braille output.