a bunch of tbd base docs. there is more to come.

Gemfile.lock

@@ -11,9 +11,9 @@ GEM
     eventmachine (1.2.7)
     ffi (1.16.3)
     forwardable-extended (2.6.0)
-    google-protobuf (3.25.1-arm64-darwin)
-    google-protobuf (3.25.1-x86_64-darwin)
-    google-protobuf (3.25.1-x86_64-linux)
+    google-protobuf (3.25.5-arm64-darwin)
+    google-protobuf (3.25.5-x86_64-darwin)
+    google-protobuf (3.25.5-x86_64-linux)
     http_parser.rb (0.8.0)
     i18n (1.14.1)
       concurrent-ruby (~> 1.0)
@@ -65,9 +65,12 @@ GEM
     rexml (3.2.6)
     rouge (4.2.0)
     safe_yaml (1.0.5)
-    sass-embedded (1.69.5)
+    sass-embedded (1.63.6-arm64-darwin)
+      google-protobuf (~> 3.23)
+    sass-embedded (1.63.6-x86_64-darwin)
+      google-protobuf (~> 3.23)
+    sass-embedded (1.63.6-x86_64-linux-gnu)
       google-protobuf (~> 3.23)
-      rake (>= 13.0.0)
     terminal-table (3.0.2)
       unicode-display_width (>= 1.1.1, < 3)
     unicode-display_width (2.5.0)

tbd/glossary.md

@@ -0,0 +1,27 @@
+---
+layout: default
+title: tbd glossary
+parent: tbd
+has_children: false
+---
+
+
+## Access Point mode
+
+TBD-AA has opened a hotspot and you can connect to it in order to set up your device. See [Midi](./midi.md)
+
+
+## Station Mode
+
+TBD-AA is connected to your local wifi and config UI available to all its users. See [Midi](./midi.md)
+
+## TBD
+
+Initial version of the TBD Project. A eurorack module. [TBD Eurorack](https://instrumentsofthings.com/products/tbd). 
+
+## TBD-AA
+
+Latest extension of the project. You are here. 
+
+
+

tbd/index.md

@@ -0,0 +1,17 @@
+---
+layout: default
+title: tbd
+nav_order: 3
+has_children: true
+---
+
+TBD is the latest iteration in family of musical tools and instruments based on versatile cheap system on a chip (SoC) commonly used in Internet of Things devices.
+
+The CTAG project was started as a space to explore technology for creative use with a strong emphasis on music and sound. It aims at creating usable creative tools and devices, exploring upcoming technolgies for creative playful use and foster students creative potential. CTAG is both an idea and also a real lab at the University of Applied Science Kiel (FH Kiel). CTAG has seen many different contributors and projects over the years, from educators to volunteers to students, from class attendees to large contributors to projects like TBD.
+
+* [Glossary of Terms](./glossary.md)
+* [Quickstart](./quickstart.md)
+* [Midi](./midi.md)
+
+
+

tbd/midi.md

@@ -0,0 +1,44 @@
+---
+layout: default
+title: midi
+parent: tbd
+has_children: false
+---
+# Midi
+
+In contrast to the Eurorack- or AE Modular-version of the TBD, the TBD BBA (Black Box Audio) focuses on MIDI as input to control the various instruments and effects available for the TBD-platform. MIDI can be applied either via the classical 5-pin DIN-jacks or via USB.
+
+As with the classical TBD, instruments and effects are, due to the character of their technical integration, also known as Plugins and can be mono or stereo. In mono operation-mode, two plugins can be used at once! 
+The TBD-BBA is backwards-compatible to the original TBD in many ways, so that you still can use the instruments and effects that previously had been designed for a module controlled by Gates, Triggers and CVs (control voltages) in mind. 
+
+Basically the TBD-BBA is a TBD with a builtin MIDI-to-CV/Gate interface including different keyboard-modes to facilitate the aggregation of functional groups to voices.
+
+In case you are not familiar with the concept of CV/Gate, wikipedia has a defintion: [wp: CV/gate](https://en.wikipedia.org/wiki/CV/gate)
+
+> CV/gate (an abbreviation of control voltage/gate) is an analog method of controlling synthesizers, drum machines, and similar equipment with external sequencers. The control voltage typically controls pitch and the gate signal controls note on-off.
+
+## Virtual CVs, Triggers and Gates
+
+* Triggers or Gates are symbolized as switches on the Web-GUI
+* CVs are symbolized as sliders on the Web-GUI
+
+When you open up the dropdown-listbox associated with any switch or slide of the Web-GUI, you’ll see a list of available MIDI-parameters for individual mappings.
+
+The available parameters that can be mapped as virtual Gates/Triggers or CVs are slightly different. Basically the MIDI-parameters for Gates are a subset of the parameters for CV, according to their original nature in the “MIDI-world”.
+
+Please note: some mappings of Voice A also are available with the Percussion voice.
+
+
+## MIDI-Channels
+
+Midi-Channels have two main functions regarding the TBD-BBA:
+
+1. Switching Voice-modes
+2. Context-sensitive filtering of “CVs” and “Gates” for mapping of parameters
+
+The following voice-modes are available:
+
+* Mono: Channel 1 (mimics the behavior of a classical mono-synth)
+* Duophonic-AB: Channel 14
+* Duophonic-CD: Channel 15
+* Polyphonic (4-voice) Channel 16

tbd/quickstart.md

@@ -0,0 +1,18 @@
+---
+layout: default
+title: quickstart
+parent: tbd
+has_children: false
+---
+# Quick Start
+
+Quick start:
+Plug the device with USB-C connector in the back (next to the audio jacks) to get power.
+After doing that press Reset (looking from the right - the rightmost button) - to trigger the TBD to boot. Currenly there is still a little issue so it isn't booting right after powering.
+Connect to the WEBUI by joining the WIFI "ctag-tbd" and going to "http://ctag-tbd.local/"
+One example for the various plugins is the "DRUMRACK". You can trigger the different tracks with Notes C1 and following on MIDI Channel 10.
+
+Examples:
+Playlist with Sound Examples: https://soundcloud.com/instrumentsofthings/sets/tbd-plugins
+Youtube Content about TBD > Eurorack: https://www.youtube.com/watch?v=4dGQUjqhLj4&list=PLB5iCbhcvJ2qdD7s1o9wsvQ9qtsCUWVLR
+Youtube Video about TBD BBA Preview (MIDI Version): https://www.youtube.com/watch?v=Lrzo0KT3fXU

tbd/wifi.md

@@ -0,0 +1,19 @@
+---
+layout: default
+title: wifi
+parent: tbd
+has_children: false
+---
+# Midi
+
+There are two ways to use wifi on the TBD BBA to configure your device
+
+## Access Point mode
+
+TBD opens up a wifi by itself. Join the ctag-tbd default network and can access the device by http://ctag-tbd.local/ or http://192.168.4.1/.
+
+## Station Mode
+
+TBD joins an existing network, i.e. you home Wifi or if you are traveling for instance your cell-phone hotspot.
+
+![tbd station mode config](images/tbd-wifi-station-mode.png)