Merge remote-tracking branch 'origin/main' into wds

default_config.json

@@ -29,5 +29,46 @@
         "Str",
         "PL",
         "RDS"
-    ]
+    ],
+    "equipment": {
+        "telescopes": [
+            {
+                "make": "Generic",
+                "name": "Dobsonian",
+                "aperture_mm": 200,
+                "focal_length_mm": 1000,
+                "obstruction_perc": 17.0,
+                "mount_type": "alt/az",
+                "flip_image": false,
+                "flop_image": true,
+                "reverse_arrow_a": false,
+                "reverse_arrow_b": false
+            }
+        ],
+        "eyepieces": [
+            {
+                "make": "Generic",
+                "name": "Plossl",
+                "focal_length_mm": 25,
+                "afov": 50,
+                "field_stop": 21.2
+            },
+            {
+                "make": "Generic",
+                "name": "Plossl",
+                "focal_length_mm": 11,
+                "afov": 50,
+                "field_stop": 9.1
+            },
+            {
+                "make": "Generic",
+                "name": "Plossl",
+                "focal_length_mm": 8,
+                "afov": 50,
+                "field_stop": 6.5
+            }
+        ],
+        "active_telescope_index": 0,
+        "active_eyepiece_index": 0
+    }
 }

docs/source/build_guide.rst

@@ -299,6 +299,9 @@ For left/right builds this is the bottom piece.  It needs four inserts for attac
 
 Flat Adaptor
 ^^^^^^^^^^^^^
+.. note::
+   The photos for the Flat Adaptor and the Back shown here are for the v2 build.  The v2.5 parts 
+   are almost identical, but have 2 camera mount holes rather than 4. 
 
 This piece takes the place of the bottom and back piece in the left/right build.  It needs eight inserts, 
 four to attach the dovetail mount and four to attach the camera
@@ -468,7 +471,7 @@ From here on out you'll need the M2.5 screws, stand-offs, and thumbscrews along
 
 *In all cases, don't over tighten the hardware!*  There is no need and you could end up damaging the 3d printed pieces, inserts or screws.  Once they feel snug, that's probably enough force.  The case forms a ridged assembly once everything is in place and will easily support the camera and other bits.
 
-Pi Mounting and Camera Prep
+Pi Mounting
 ---------------------------
 
 The first step is to mount the Pi and PiSugar battery to the Pi Mount piece.  The pieces you'll need are shown below
@@ -497,32 +500,52 @@ Snip the zip-ties off and you are ready to move on.
    :target: images/build_guide/common_1c.jpeg
 
 
-Now is a good time to route the camera cable, so you'll need to remove it from the camera module.  Start by removing the tripod mount, then gently pull up on the connector locking piece and slide the cable out.  See the photos below for more details
 
+Camera Prep
+---------------------------
 
-.. image:: ../../images/build_guide/v1.4/build_guide_07.jpg
-   :target: ../../images/build_guide/v1.4/build_guide_07.jpg
-   :alt: Build Guide Step
+The new v3 camera may come with one of two different lens holders aready installed. No matter 
+which your camera has you'll be removing and replacing it.
 
+.. image:: images/v25_upgrade/v25_upgrade_11.jpeg
 
-.. image:: ../../images/build_guide/v1.4/build_guide_08.jpg
-   :target: ../../images/build_guide/v1.4/build_guide_08.jpg
+Some cameras have pin headers installed, if you have one of these, you'll need to clip them as close
+as reasonable to the board. It can help here to remove the black plastic portion by pulling it with
+a pair of pliers.  Alternatively, you can just cut through it to get as close to the PCB as possilble.
+Take care not to clip any of the surrounding components.
 
+.. image:: images/v25_upgrade/v25_upgrade_12.jpeg
 
-.. image:: ../../images/build_guide/v1.4/build_guide_09.jpg
-   :target: ../../images/build_guide/v1.4/build_guide_09.jpg
-   :alt: Build Guide Step
+.. image:: images/v25_upgrade/v25_upgrade_13.jpeg
 
+Grab the lens holder and look through it to make sure it's clear of any obstructions.
 
-.. image:: ../../images/build_guide/v1.4/build_guide_10.jpg
-   :target: ../../images/build_guide/v1.4/build_guide_10.jpg
-   :alt: Build Guide Step
+Place the lens holder on the table with the large side up oriented as in the photo below.  The two screw
+tabs on the lens holder must stick out the opposite sides from the cream-white and dark-grey cable connector on the PCB.
+You'll be removing the two screws (yours might be black) near the center of the green PCB and lifting it gently
+to the new lens holder.  
 
+Mind the sensor surface on the under side of the PCB. It should sit nicely in the square recess of the lens holder.
+Use the same two screws to affix the sensor PCB to the lens holder.  The screws will be cutting their own threads, but
+there are holes there to help get started.  Tighten the screws down against the PCB so nothing is wiggling/moving.
 
-.. image:: ../../images/build_guide/v1.4/build_guide_11.jpg
-   :target: ../../images/build_guide/v1.4/build_guide_11.jpg
-   :alt: Build Guide Step
+.. image:: images/v25_upgrade/v25_upgrade_14.jpeg
+
+.. image:: images/v25_upgrade/v25_upgrade_15.jpeg
+
+Flip the camera assembly over and thread in the lens.  Be slow and careful here.  With gentle force
+the lens should slide in a few MM to get everything align and stop.  When it stops, check to make sure it seems 
+straight and start screwing it into place.  To get focus about right, You'll want a 6mm gap (picured below) between the 
+top of the lens holder and the bottom of the lip on the lens.  Don't fret too much about it as you'll do final focus 
+under the stars.
+
+.. image:: images/v25_upgrade/v25_upgrade_16.jpeg
 
+.. image:: images/v25_upgrade/v25_upgrade_17.jpeg
+
+
+Cable Routing
+---------------------------
 
 If you are building a flat unit, just set the camera cable to the side as it gets routed in a different manner.  For left/right builds, it's easier to get the cable roughly positioned now.
 
@@ -646,30 +669,40 @@ on the back plate.
 
      - .. image:: images/build_guide/right_9.jpeg
 
-Now it's time to mount the camera module.  You'll need the module, cover and four 8mm screws.
-
-.. list-table::
+Now it's time to mount the camera module.  You'll need the module, camera tray and 2x12mm m2.5 screws
 
-   * - .. image:: images/build_guide/left_10.jpeg
-
-     - .. image:: images/build_guide/right_10.jpeg
+.. note::
+   The images here show an older back piece and camera tray. New kits have a back piece 
+   with two holes which match the camera holder.  In this simpler arrangment the camera
+   tray is not directly secured to the back piece, but rather has two holes through it.
+   The camera holder is secured with longer screws through the tray into the two holes
+   in the back piece
 
-Start by connecting the camera to the cable, being careful with the orientation and the connector.  Insert the cable as show below and then carefully close the connector by pushing the grey portion down.
+Start by connecting the cable to the new camera module.  Open the connector all the way
+by sliding the dark-grey piece away from the PCB.  Be gentle as this part can break with too
+much force. 
 
-.. image:: images/build_guide/common_2.jpeg
+Once the connector is open, slide the cable into the connector using gentle force and making 
+sure it's well aligned.  Take you time and watch the
+dark-grey clip.  It should not close as you are inserting the cable, and if it does, you'll need
+to re-open it to get the cable to slide in all the way.
 
-Once the cable is connected, turn the PiFinder so the back is facing upwards to make mounting the camera easier.  Place the module on the
-four stand-offs, slide the cover down over it, and then secure everything with the four screws.
+Once the cable is seated in the connector, close the dark-grey clip by sliding it shut, this 
+may take a little force to get it completely closed.  Check the photo below if in doubt!
 
-.. list-table::
+.. image:: images/v25_upgrade/v25_upgrade_24.jpeg
 
-   * - .. image:: images/build_guide/left_11.jpeg
+Situate the camera in the adapter and use the two new screws to secure it.  They are 
+the same size as the other four, if they get mixed up.
 
-     - .. image:: images/build_guide/right_11.jpeg
+.. image:: images/v25_upgrade/v25_upgrade_25.jpeg
 
-   * - .. image:: images/build_guide/left_12.jpeg
+.. image:: images/v25_upgrade/v25_upgrade_26.jpeg
 
-     - .. image:: images/build_guide/right_12.jpeg
+.. note::
+   The remainder of the build guide is yet to be updated with new photos
+   including the v2.5 camera.  The build proceeds just the same and we
+   will be updating the photos soon.
 
 
 Flip the unit over and connect the RPI end of the camera cable.  The photo below show the proper orientation of the cable into the connector.  Note the silver contacts facing the white portion of the connector.

docs/source/user_guide.rst

@@ -22,7 +22,7 @@ Along with knowing where your telescope is pointing, the PiFinder knows where th
 
 .. note::
    If you would like a general overview of how to use the PiFinder, please give the 
-   :doc:`quick_start` a read.  This menual goes more in depth but does not cover some
+   :doc:`quick_start` a read.  This manual goes more in depth but does not cover some
    of the first time set-up items in the Quick Start
 
 

gerbers/v3/PiFinder_smt-top_jlcpos.csv

@@ -0,0 +1,48 @@
+Designator,Val,Package,Mid X,Mid Y,Rotation,Layer
+C1,1uF,C_0805_2012Metric,166.700000,-98.900000,90.000000,top
+C2,100nF,C_0805_2012Metric,169.600000,-103.450000,-90.000000,top
+C3,22pF,C_0805_2012Metric,162.700000,-107.600000,-90.000000,top
+C4,22pF,C_0805_2012Metric,170.300000,-106.500000,0.000000,top
+D1,LED,LED_1210_3225Metric,143.096000,-70.462000,0,top
+D2,LED,LED_1210_3225Metric,154.692000,-70.469000,0,top
+D3,LED,LED_1210_3225Metric,166.220000,-70.474000,0,top
+D4,LED,LED_1210_3225Metric,143.096000,-82.654000,0,top
+D5,LED,LED_1210_3225Metric,154.692000,-82.661000,0,top
+D6,LED,LED_1210_3225Metric,166.220000,-82.666000,0,top
+D7,LED,LED_1210_3225Metric,177.900000,-82.616000,0,top
+D8,LED,LED_1210_3225Metric,143.096000,-94.846000,0,top
+D9,LED,LED_1210_3225Metric,154.692000,-94.853000,0,top
+D10,LED,LED_1210_3225Metric,166.220000,-94.858000,0,top
+D11,LED,LED_1210_3225Metric,177.900000,-94.808000,0,top
+D12,LED,LED_1210_3225Metric,95.852000,-107.038000,0,top
+D13,LED,LED_1210_3225Metric,108.044000,-107.038000,0,top
+D14,LED,LED_1210_3225Metric,120.744000,-107.038000,0,top
+D15,LED,LED_1210_3225Metric,133.444000,-107.038000,0,top
+D16,LED,LED_1210_3225Metric,154.692000,-107.045000,0,top
+D17,LED,LED_1210_3225Metric,177.900000,-107.000000,0,top
+IMU1,BNO055,LGA-28_5.2x3.8mm_P0.5mm,165.100000,-102.800000,90,top
+Q1,Q_NPN_EBC,PF_SOT-23-NPN,144.400000,-104.100000,270,top
+R1,22,R_0805_2012Metric,181.600000,-110.600000,90.000000,top
+R2,330,R_0805_2012Metric,133.200000,-110.300000,0.000000,top
+R3,10k,R_0805_2012Metric,170.287500,-100.600000,180.000000,top
+R4,10k,R_0805_2012Metric,164.600000,-98.900000,-90.000000,top
+R5,10k,R_0805_2012Metric,171.300000,-109.500000,180.000000,top
+R6,10k,R_0805_2012Metric,167.900000,-109.512500,90.000000,top
+SW0,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,154.702600,-101.582800,180.000000,top
+SW1,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,143.096000,-89.385000,180.000000,top
+SW2,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,154.702600,-89.390800,180.000000,top
+SW3,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,166.220000,-89.397000,180.000000,top
+SW4,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,143.106600,-77.191800,180.000000,top
+SW5,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,154.702600,-77.198800,180.000000,top
+SW6,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,166.220000,-77.205000,180.000000,top
+SW7,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,143.096000,-64.999800,180.000000,top
+SW8,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,154.702600,-65.006800,180.000000,top
+SW9,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,166.220000,-65.011800,180.000000,top
+SW_A1,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,95.862600,-101.575800,180.000000,top
+SW_B1,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,108.044000,-101.577000,180.000000,top
+SW_C1,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,120.754600,-101.575800,180.000000,top
+SW_D1,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,133.454600,-101.575800,180.000000,top
+SW_DN1,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,177.800000,-89.392000,180.000000,top
+SW_GO1,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,177.800000,-101.584000,180.000000,top
+SW_UP1,SW_Push_Dual,SW_Push_6x6mm_SMT_withhole_tight,177.800000,-77.200000,180.000000,top
+Y1,Crystal,Crystal_SMD_3215-2Pin_3.2x1.5mm,166.100000,-106.600000,0.000000,top

gerbers/v3/PiFinder_smt_jlcpcb_bom.csv

@@ -1,12 +1,12 @@
 Comment,Designator,Footprint,LCSC
-"1uF","C1","Capacitor_SMD:C_0805_2012Metric","C2940738"
+"1uF","C1","Capacitor_SMD:C_0805_2012Metric","C28323"
 "100nF","C2","Capacitor_SMD:C_0805_2012Metric","C49678"
 "22pF","C3,C4","Capacitor_SMD:C_0805_2012Metric","C24658"
 "LED","D1,D2,D3,D4,D5,D6,D7,D8,D9,D10,D11,D12,D13,D14,D15,D16,D17","LED_SMD:LED_1210_3225Metric","C125112"
 "BNO055","IMU1","Package_LGA:LGA-28_5.2x3.8mm_P0.5mm","C93216"
-"Q_NPN_EBC","Q1","RSU:PF_SOT-23-NPN","C280842"
+"Q_NPN_EBC","Q1","RSU:PF_SOT-23-NPN","C2150"
 "22","R1","Resistor_SMD:R_0805_2012Metric","C17561"
 "330","R2","Resistor_SMD:R_0805_2012Metric","C17630"
 "10k","R3,R4,R5,R6","Resistor_SMD:R_0805_2012Metric","C17414"
 "SW_Push_Dual","SW0,SW1,SW_A1,SW_B1,SW_C1,SW_D1,SW_DN1,SW_GO1,SW_UP1,SW2,SW3,SW4,SW5,SW6,SW7,SW8,SW9","RSU:SW_Push_6x6mm_SMT_withhole_tight","C4364377"
-"Crystal","Y1","Crystal:Crystal_SMD_3215-2Pin_3.2x1.5mm","C5366532"
+"Crystal","Y1","Crystal:Crystal_SMD_3215-2Pin_3.2x1.5mm","C32346"