norns

docs/norns/index.md

@@ -8,12 +8,164 @@ permalink: /docs/norns/
 
 # norns
 
-almost there. full docs nearly complete.
+see the [beginning guide](norns-legend.pdf) for a one-sheet quick introduction.
 
-see the [beginning guide](norns-legend.pdf).
+## legend
 
-for a first look at _maiden_ (the web editor) turn on WIFI (connect to your norns via hotspot using password "nnnnnnnn") and try opening a web browser to `http://norns.local:5000` (if not found, try `http://172.24.1.1:5000` or the appropriate IP address.) more documentation coming!
+![](image/norns-legend-primary.png)
 
-note: on the bottom of the norns there is a tiny push switch will hard power-off the device in case of a software crash. for general shut down use the _sleep_ menu function. this fully turns off the norns with a proper software shutdown.  
+## begin
 
-*problems?* e-mail info@monome.org and we can help right away.
+The mini-USB plug provides power and charges the internal battery. Use the cable and power supply provided. (The included supply supplies 2A via USB connector).
+
+Hold KEY1 for three seconds.
+
+Be still, and norns will awaken.
+
+There's a small light near the power plug.  ORANGE means power.  WHITE means disk access.
+
+On the bottom of the norns there is a tiny push switch will hard power-off the device. For general shut down use the _sleep_ menu function. This fully turns off the norns with a proper software shutdown. Use the bottom switch is something in software went wrong.
+
+## awake
+
+A changing melody will play.
+
+- ENC1 changes the tempo.
+- ENC2 navigates position, ENC3 changes position.
+- KEY3 toggles the sequence to edit.
+- KEY2 morphs the current sequence.
+
+- HOLD KEY3, then:
+- ENC1 changes transposition.
+- ENC2 and ENC3 change sequence lengths.
+- KEY2 resets sequence positions.
+
+- HOLD KEY, then:
+- ENC1 changes scale mode.
+- ENC2 changes filter cutoff.
+- ENC3 changes release time.
+
+TAP KEY1 quickly to enter MENU.
+
+## menu
+
+Tap KEY1 to toggle between PLAY and MENU.
+
+In MENU mode:
+
+- ENC2 scrolls up/down.
+- KEY3 is forward.
+- KEY2 is back.
+
+![](image/norns-legend-menu.png)
+
+### SELECT
+
+Explore the collection of scripts.  Selecting a script will show a description.  Forward again will run the script.  The play screen will return upon running.  Tap KEY1 to toggle between PLAY and MENU.
+
+### PARAMETERS
+
+Scripts can define their own parameters.  ENC3 changes parameter values.  HOLD KEY1 and then use KEY2 and KEY3 to save/load parameter sets.  
+
+Some scripts may have no parameters.
+
+### SYSTEM / AUDIO
+
+Like the parameter list, but for the global audio settings. Includes output and input levels, headphone gain, aux send (reverb), and insert (compression).
+
+### SYSTEM / WIFI
+
+The WIFI nub must be inserted before starting.  Here you can set up a hotspot or connect to an existing network.  
+
+Hotspot will create a network:
+
+- SSID: `norns`
+- password: `nnnnnnnn`
+
+Connecting to an existing network requires a few steps. Upon entering the SYSTEM menu a WIFI scan is initiated. This will take a bit of time. Once entering the WIFI screen and scrolling to NETWORK you'll be able to select a network with ENC3 (indicated on the bottom right). You'll then be prompted for a password. This network and password will be saved for future use.
+
+_NOTE:_ Right now only WPA networks appear to work with this setup. We're looking to add WEP/etc networks soon. So you may need to adjust your router settings.
+
+### SYSTEM / SYNC
+
+A USB disk must be connected. Here you can sync your scripts/data/audio to an external disk, or copy scripts/audio/data from an external disk.
+
+This is the current method for getting sound and scripts on and off of the device.
+
+- Format a USB drive with a FAT32 file system.
+- Execute `SYSTEM > SYNC > TO DISK` (this may take some time, be patient)
+- Eject the disk and insert it into your computer. You can now retrieve your TAPE files, etc. Copy new audio files into the `dust/audio` folder for use with scripts.
+- Put the disk back into norns and execute `SYSTEM > SYNC > FROM DISK`
+
+### SYSTEM / UPDATE
+
+This searches the USB disk for update files.
+
+### SYSTEM / LOG
+
+Displays the day's news.
+
+### SLEEP
+
+Powers down, getting rest for later.
+
+### LEVELS
+
+Go BACK from home to see the LEVELS screen.
+
+Here you have VUs and mixing capabilities.
+
+- ENC1 output
+- ENC2 input
+- ENC3 monitor (input to output)
+
+Battery percentage level is indicated in the upper right.
+
+#### TAPE
+
+Within LEVELS you can record and play directly to and from disk.
+
+HOLD KEY2 for all. ENC3 toggles REC/PLAY.
+
+REC		
+
+- KEY3 to arm recording.	
+- KEY3 again to start.	
+- KEY3 again to stop.	
+
+PLAY
+
+- KEY3 loads file.
+- KEY3 to play.
+- ENC3 to toggle PLAY/STOP.
+
+## maiden
+
+For a first look at _maiden_ (the web editor) turn on WIFI (connect to your norns via hotspot) and try opening a web browser to:
+
+- `http://norns.local:5000`
+
+(if not found, try `http://172.24.1.1:5000` or the appropriate IP address.)
+
+More documentation coming.
+
+## other access
+
+When connected via WIFI you can SSH into norns at the IP address shown in SYSTEM.
+
+- user: `we`
+- password: `sleep`
+
+Without WIFI, you can connect to norns via USB-UART by connecting the power cable to your computer. On Mac/linux do:
+
+`screen /dev/tty.usb(tab) 115200`
+
+Where `(tab)` appears hit TAB to autocomplete the serial number. Login is the same as above.
+
+## help
+
+Check out the [community forum](https://llllllll.co) for various help threads.
+
+### Hardware problems
+
+Contact info@monome.org and we can help right away.