Add Files for Control V1.1, with the AddSolderless

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

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)

docs/Safety and Hazards Failure Effects Mode Analysis

@@ -0,0 +1,48 @@
+In evaluation of proper control of an ODECOS and CFC, the following hazards need to be considered
+- Uncontrolled oxygen production
+  -- leaking pipes or cracked stacks could cause excessive O2 build up in enclosed spaces
+  -- could cause excessive oxygen levels in enclosed spaces
+- Thermal runaway
+  -- damage to property and equipment
+  -- possible ignition source for accelerant gasses such as O2
+- Electrical shock hazard
+  -- person and equipment hazard
+- Oxygen depleted waste exaust gas
+--  OSHA dictates that the minimum "safe level" of oxygen in a confined space is 19.5%, while the maximum "safe level" of oxygen in a confined space is 23.5%. 
+  With low oxygen levels being the biggest cause of death in confined spaces, accurate oxygen level measurements are essential.
+- Excessive ambient temperatures
+  -- can cause over temperatures on the heat exchanger
+  -- can cause an over temeprature on a hot water exchanger
+  -- can cause fire hazards for other devices and materials in the ajoined enclosed space.
+
+
+Resolutions
+-  Uncontrolled oxygen production 
+  -- a well functioning controller that monitors pressure and meters O2 production satisfies this condition during normal operation
+  -- Disabling the stack power supply and the stack heater will eliminate the systems ability to make oxygen 
+  -- In an ideal world, a sepearate system would monitor over pressure events on the output O2 stream and could disable the systems ability to make O2 through an electrical signal
+  -- a controller function watchdog/fault detection circuit would also satisfy this condition
+- Thermal Runaway
+  -- A well functoning controller that is monitoring temperature satisfies this condition during normal operation
+  -- A thermal fuse on the stacks or on critical components tied to the Estop circuit would fulfill this requriement
+  -- a controller function watchdog/fault detection circuit would also satisfy this condition
+- Electrical shock hazard
+  -- Metallic enclosure and all metal have a reliable connection to ground 
+      -- these usually mean a gas tight and dedicated pathway to ground for all metal components
+  -- A Ground fault and/or arc fault external protection in addtion to reliably grounding metallic components satisifes this condition
+- Oxygen depleted waste exaust gas
+  -- External Oxygen Deficiency Monitor for O2 Depletion Safety 0-25%   
+  -- a normally closed relay could trigger an e-stop  and satisfy this condition
+- Excessive ambient temperatures    
+  -- An ambient temperature sensor on the inlet and on the surface of the pcb, in conjunction to a relay tied to an estop should satisfy this condition
+  -- a thermal fuse on the inlet temperature should also satisfy this condition
+  -- a controller that monitors inlet and ambient temperature should satisfy this condition
+
+
+Controller safety features
+- The controller is designed such that on loss of control of the DUE or loss of power, the controller produces a condition that is intrinsically safe and disables production of oxygen
+
+
+References: 
+https://www.eaton.com/ie/en-gb/markets/machine-building/service-and-support-machine-building-moem-service-eaton/blogs/emergency-stop-circuit---blogs---eaton.html
+https://en.wikipedia.org/wiki/Watchdog_timer

docs/WattageControlExpreriment.md

@@ -0,0 +1,17 @@
+
+During a high temperature test on the mornign of Wednesday Sept. 20th, Rob collected the following data on the wattage and amperage settings to show that 
+the wattage control works.
+
+It shows some accuracy in our digital hardware, but basically was a successful test.
+
+Sadly, we were having problems with the thermocouple at this time, so I did not know the temperature.
+
+|  Software Watts Limit | Software Amps  | Reported Watts  | Reported Amps  |
+|---|---|---|---|
+| 12  | 10  | 13.75  |  4.63 |
+|  15 | 10  | 16.01  |  5.23  |
+| 12   | 10  | 14.48  | 4.70  |
+| 10  | 10  | 12.10| 4.23 |
+| 8  | 10  | 10.49 | 3.83 |
+| 6  | 10  | 7.85 | 3.18 |
+| 4  | 10  | 5.90 | 2.17 |