Candidate integration task2

README.md

@@ -24,21 +24,22 @@ An unlisted [YouTube video](https://youtu.be/1nq-Mw7jZ5A) has been uploaded that
 
 ## How to run
 
-At present, this code does little (for the NASA COG project). We intend
-to build a native (that is, laptop) simulation using mock hardware components.
-The fundamental way to run this is to perform:
-> cd firmware
-
-> pio run -e native && ./.pio/build/native/program
-
+### Linux
+The fundamental way to run this is to perform:  
+> cd firmware  
+> pio run -e native && ./.pio/build/native/program  
 We are currently creating the [RibbonFish](https://github.com/PubInv/NASA-COG/blob/develop/RibbonFish.md) proof-of-concept.
-
-This can be run on a Due by executing:
-
-> make pio-run-due_ribbonfish
-
-As this develops, it will use a specific Due hardware configuration,
-please see the [documentation](https://github.com/PubInv/NASA-COG/blob/develop/RibbonFish.md) for details to build your own.
+This can be run on a Due by executing:  
+> make pio-run-due_ribbonfish  
+As this develops, it will use a specific Due hardware configuration,  
+please see the [documentation](https://github.com/PubInv/NASA-COG/blob/develop/RibbonFish.md) for details to build your own.  
+
+### Windows
+With Visual Studio Code.  
+Install the Plateform IO extention  
+To open he project in Visual Studio Code.  
+Open Project. Navigate to the firmware folder.   
+Select the file platformio.ini  
 
 
 ## Annoyances

SBC setup instructions

@@ -0,0 +1,48 @@
+#download  Ubuntu Server 22.04.3 LTS                                                       
+#copy to usb                                                                     
+#plug in keyboard , display and usb to sbc
+#power up sbc                                       
+#when splash screen hit F12                                                      
+#boot to usb
+
+#install ubuntu server                                                           
+#   (you can choose minimal install)                                             
+#   use entire disk                                                              
+#     (you can turn off lvm - don't need it)                                     
+#   install open ssh server                                                      
+#   no need for any extra programs (at this time)                                
+#   set username and password                                                     
+#   add GitHub Keys to SSH account
+#   let install finish                                                           
+#   unplug usb flash drive
+#   reboot                                                                       
+
+#ssh into sbc   
+#run the following
+#sudo apt install git
+#git clone https://github.com/PubInv/NASA-COG.git
+#chmod +x 'SBC setup instructions'
+#run ./NASA-COG/'SBC setup instructions'
+
+#//install your favorite editor (sudo apt install emacs-nox)                 
+#install tmux https://github.com/tmux/tmux/wiki                                          
+#edit /etc/dpkg/dpkg.cfg.d/excludes                                              
+sudo apt update
+sudo apt dist-upgrade
+sudo apt install -y avahi-daemon bash-completion emacs-nox nano vim less build-essential python3-venv git tmux
+
+#   comment out the excludes for man and docs                                    
+sudo apt install -y man-db manpages manpages-dev manpages-posix manpages-posix-dev                                                                            
+sudo mv /usr/bin/man.REAL /usr/bin/man
+sudo mandb -c
+
+#use one of these
+#wget https://raw.githubusercontent.com/platformio/platformio-core-installer/master/get-platformio.py -O get-platformio.py
+curl -fsSL -o get-platformio.py https://raw.githubusercontent.com/platformio/platformio-core-installer/master/get-platformio.py
+python3 get-platformio.py
+curl -fsSL https://raw.githubusercontent.com/platformio/platformio-core/develop/platformio/assets/system/99-platformio-udev.rules | sudo tee /etc/udev/rules.d/99-platformio-udev.rules
+sudo mkdir -p /usr/local/bin
+sudo ln -s ~/.platformio/penv/bin/platformio /usr/local/bin/platformio
+sudo ln -s ~/.platformio/penv/bin/pio /usr/local/bin/pio
+sudo ln -s ~/.platformio/penv/bin/piodebuggdb /usr/local/bin/piodebuggdb
+

docs/Fan 4-wire cable interface.md

@@ -0,0 +1,14 @@
+
+As of verion 0.3.5, the fan is a 24V 4-wire fan with PWM control and tachometer (a Sanyo ACE B97).
+
+The wiring case at the end of the DB25 cable uses screw clamp connectors as shown below.
+
+The wiring of the fan is:
+|  Connect # | Color  |  Use |  
+|---|---|---|
+|  2 |  red |  +24V |
+|  22 |  black | GND  |
+|  13 | brown  | PWM  |
+|  6 |  yellow |  Tachometer |
+
+![IMG_4324](https://github.com/PubInv/NASA-COG/assets/5296671/8ee584ef-fd01-4cc7-978d-29192e5faf28)