From 161a9e6f569cc4384275bb1bce7a900f96a68be1 Mon Sep 17 00:00:00 2001
From: Edwin Chiu <inceptionev@gmail.com>
Date: Thu, 20 Apr 2023 11:39:40 -0500
Subject: [PATCH] issue #1284: create wiring files for pinch valve harness

---
 docs/wiring/pinch_valve.rst | 33 ++++++++++++++++++++++++++
 docs/wiring/pinch_valve.yml | 46 +++++++++++++++++++++++++++++++++++++
 2 files changed, 79 insertions(+)
 create mode 100644 docs/wiring/pinch_valve.rst
 create mode 100644 docs/wiring/pinch_valve.yml

diff --git a/docs/wiring/pinch_valve.rst b/docs/wiring/pinch_valve.rst
new file mode 100644
index 000000000..cd7f0daf2
--- /dev/null
+++ b/docs/wiring/pinch_valve.rst
@@ -0,0 +1,33 @@
+.. _Oxygen Sensor Harness:
+
+Oxygen Sensor Harness
+======================
+
+.. csv-table:: **BOM**
+   :widths: 5, 60, 5, 5, 5, 10, 10, 10
+   :header-rows: 1
+   :delim: 0009
+   :file: ./oxygen_sensor.bom.tsv
+
+.. image:: oxygen_sensor.png
+  :width: 800
+  :alt: Wiring diagram
+
+You will need all the tools listed.
+
+* Using items from above BOM as well as:
+   * 5mm heat shrink tubing [:ref:`ew-shrink5`]
+   * Heat gun
+   * Molex Micro-Fit 3.0 Crimper
+   * Molex KK Crimper
+   * Wire Strippers
+* Instructions:
+   #. Cut a 300mm length of blue and white wire.
+   #. Strip the desired length of insulation from each end of each wire.
+   #. Crimp the Micro-Fit contacts to one end, and the KK contacts to the other on each wire.
+   #. Cut 3 pieces, 15mm long each, of heat shrink tubing, and thread them onto the set of two wire.  Do not shrink the heat shrink yet.  Make sure to keep the simlar types of contacts on the same side.
+   #. Insert each contact into the Micro-Fit connector housing, according to the wiring diagram.  Then do the same for the KK connector.
+   #. Do a gentle pull test to confirm proper seating of the contacts.
+   #. Distribute the heat shrink tubing evenly along the harness and shrink them with the heat gun.
+
+Total price: USD 2.00
diff --git a/docs/wiring/pinch_valve.yml b/docs/wiring/pinch_valve.yml
new file mode 100644
index 000000000..f398b8b9f
--- /dev/null
+++ b/docs/wiring/pinch_valve.yml
@@ -0,0 +1,46 @@
+connectors:
+  X1:
+    pn: ee-stepper-motor-NEMA17                         # RW part number from purchasing JSON file
+    pincount: 4                                         # number of pins in the connector
+    pinlabels: [A+, A-, B+, B-]                         # names for the signal on the connector
+    type: NEMA 17 Full D Shaft Stepper Motor            # connector type                                  # connector sub-type
+    mpn: 17hs19-2004s1                                  # manufacturer part number
+    manufacturer: Stepper Online                        # manufacturer
+
+  X2:
+    pn: ec-micro1x4
+    pincount: 4
+    pinlabels: [1, 2, 3, 4]
+    type: Molex Micro-Fit 3.0 1x4
+    subtype: female
+    mpn: 0436450408
+    manufacturer: Molex
+    additional_components:                              # defines additional components such as contacts
+      -
+        type: crimp                                     # additional component type
+        subtype:  Molex Micro-Fit 3.0 Female Crimp Contact 20-24awg  # additional component name
+        qty: 1
+        qty_multiplier: populated                       # this multiples by the number of connector instances for the BOM
+        manufacturer: Molex                             # additional component manufacturer
+        mpn: 43030-0002                                 # additional component part number
+        pn: ec-microfit-f-crimp-20-24awg                # RW part number
+
+
+cables:
+  W1:
+    pn: included-with-motor
+    wirecount: 4
+    type: Stepper Motor Built-in Pigtails
+    mpn: N/A
+    manufacturer: N/A
+    # more cable parameters:
+    length: 1000 mm
+    gauge: 20 AWG
+    show_equiv: true # auto-calculate AWG equivalent
+    colors: [BK, GN, RD, BU]
+
+connections:
+  -
+    - X1: [1,2,3,4]
+    - W1: [1,2,3,4]
+