//  File:  ATCA Guide Pin Receptacle
//
//  Date:   21-Apr-2014    Original Rev.
//
//           4-May-2016    Mounting screw hole becomes
//                         a Component Electrical Pin
//
//          16-Jun-2016    Add the "Component_not_in_bom" attribute to
//                         Remove all instances of this component from the BOM.
//
//
//
//
//      Geometry for the   ATCA  Guide Pin Receptacle
//     -----------------------------------------------
//
//
//   It is based on TE part number  1-1469373-1
//
//   This is the TE part number that has both of its "D"
//   shapped holes in the same default direction and is
//   (I think)  called unkeyed.
//   There are keyed versions that have "D" shapped holes
//   facing in different directions.
//
//
//   This is for the ATCA "Front Board" and is called  K1/K2
//
//
//   I currently think that there is a Guide Pin Receptacle at
//   the top of Zone 2  and  another at the top of Zone 3.
//
//
//   This Guide Pin Receptacle is attached to the pcb with
//   a  M2.5  mounting screw.
//
//   This geometry is drawn so that it may be placed onto
//   the PCB without requiring any rotation  (assuming that
//   the PCB is in out Standard Orientation).
//
//   The hole for the M2.5 mounting screw is the center
//   of this geometry.
//
//
//   Note:  I still have an "overhang" placement violation
//          with this component.  I do not understand this
//          but it *may* have to do with there being no
//          electrical pins AND this part being placed
//          with overhang.  For now I will "fix this by
//          reducing this component's  Component_Plaement_
//          _Outline  so that it is all within the PCB's
//          outline.   8-Feb-2015
//
//   Note:  The ATCA documentation show the Guide Pin Receptacle
//          as having 3 press-fit pins and an M2.5 mounting
//          screw.  The AMP part does not have the center press-
//          fit pin and I'm removing it out of this Geometry.
//          12-April-2016  remove press-fit pin at  -3.00, -5.00
//
//   Note:  The Guide Pin Receptacle needs to be connected
//          to the Shelf Ground net.  On 4-May-2016 change
//          the two drill holes and the M2.5 screw hole from
//          just mechanical holes into component pins.  This
//          requires adding two pad-stacks to the definition
//          of this geometry and adding a pin list at the end.
//          An advantage of making the M2.5 hole into a
//          component pin is that the metal on the surface
//          helps act as a washer and thus helps prevent the
//          screw head from digging into the pcb.
//
//   Note:  This component has the  Not in BOM  attribute.
//
//
//




$abort_enable = @false;
$$lock_windows(@on) ;
$$snap_diagonal(@off) ;
$$snap_orthogonal(@off) ;


//
//----------------------------------------------------------------------------
//
//   Pad-Stack for the Press-Fit Pin Holes    1.60 mm diameter
//
//
//     1.60 mm  drill
//     2.60 mm  pad land
//     2.70 mm  soldermask opening
//     3.10 mm  plane relief
//
//     --> the thickness of the donut wall is     0.50 mm
//     --> the drill hole to plane clearance is   0.75 mm
//


$$create_pin("Term_Press_Guide_Pin", @replace);

$$page(0.0,0.0,0.0, @mm, 0.0, 0.0, [0.0, 0.0, 'PI$Term_Press_Guide_Pin']);

$$point_mode(@vertex);

$$attribute( "TERMINAL_THRUHOLE_DEFINITION", "");

$$attribute( "TERMINAL_DRILL_SIZE", "", , @scale , , [ 1.60,  0.0]);

$$circle( "PAD",         0.0, 0.0,  2.60,  0.0);

$$circle( "SIGNAL",      0.0, 0.0,  2.60,  0.0);

$$circle( "SOLDER_MASK", 0.0, 0.0,  2.70,  0.0);

$$circle( "POWER",       0.0, 0.0,  3.10, 0.0);

//
//----------------------------------------------------------------------------
//




//
//----------------------------------------------------------------------------
//
//
//   Pad-Stack for the M2.5 Mounting Screw Hole
//
//
//     2.70 mm  drill
//     5.20 mm  pad land
//     5.30 mm  soldermask opening
//     4.20 mm  plane relief
//
//     --> the thickness of the donut wall is     1.25 mm
//     --> the drill hole to plane clearance is   0.75 mm


$$create_pin("Term_M2_5_Guide_Pin", @replace);

$$page(0.0,0.0,0.0, @mm, 0.0, 0.0, [0.0, 0.0, 'PI$Term_M2_5_Guide_Pin']);

$$point_mode(@vertex);

$$attribute( "TERMINAL_THRUHOLE_DEFINITION", "");

$$attribute( "TERMINAL_DRILL_SIZE", "", , @scale , , [ 2.70, 0.0 ]);

$$circle( "PAD",         0.0, 0.0,  5.20,  0.0 );

$$circle( "SIGNAL",      0.0, 0.0,  5.20,  0.0 );

$$circle( "SOLDER_MASK", 0.0, 0.0,  5.30,  0.0 );

$$circle( "POWER",       0.0, 0.0,  4.20, 0.0 );

//
//----------------------------------------------------------------------------
//





//
//   Now start the actual   ATCA_Guide_Pin_Receptacle   Geometry
//


$$create_component("ATCA_Guide_Pin_Receptacle");

$$page(0.0, 0.0, 0.0, @mm, 0.0, 0.0, [0.0,0.0,'CO$ATCA_Guide_Pin_Receptacle'] );

$$point_mode(@vertex);



$$attribute( "COMPONENT_HEIGHT", "", , @scale , , [8.0, 0.0]);

$$attribute( "COMPONENT_OUTLINE_OVERHANG", "yes");

$$attribute( "COMPONENT_LAYOUT_SURFACE", "both");

$$attribute( "COMPONENT_NOT_IN_BOM" );




//
//  Component Outline
//

// // $$initial([   11.0,    2.5 ], , @nosnap );
// // $$terminal([ -11.0,    2.5 ]);
// // $$terminal([ -11.0,   -7.5 ]);
// // $$terminal([  11.0,   -7.5 ]);
// // $$terminal([  11.0,    2.5 ]);

$$initial([    5.0,    2.5 ], , @nosnap );
$$terminal([ -11.0,    2.5 ]);
$$terminal([ -11.0,   -7.5 ]);
$$terminal([   5.0,   -7.5 ]);
$$terminal([   5.0,    2.5 ]);

$$attribute( "COMPONENT_PLACEMENT_OUTLINE", "", @mark, @scale );



//
//  Silkscreen Outline then Details
//

$$template_line_style( @Solid );

$$initial([   11.0,    2.5 ], , @nosnap );
$$terminal([ -11.0,    2.5 ]);
$$terminal([ -11.0,   -7.5 ]);
$$terminal([  11.0,   -7.5 ]);
$$terminal([  11.0,    2.5 ]);

$$path( "SILKSCREEN_1", 0.20 );


//  Silkscreen Box and Arrow

$$template_line_style( @Solid );

$$initial([    9.0,    0.5 ], , @nosnap );
$$terminal([  -9.0,    0.5 ]);
$$terminal([  -9.0,   -5.5 ]);
$$terminal([   9.0,   -5.5 ]);
$$terminal([   9.0,    0.5 ]);

$$path( "SILKSCREEN_1", 0.20 );


$$path( "SILKSCREEN_1", 0.20 , , [  -7.70, -2.50,    -1.00, -2.50 ]);
$$path( "SILKSCREEN_1", 0.20 , , [  -7.70, -2.50,    -4.00, -1.00 ]);
$$path( "SILKSCREEN_1", 0.20 , , [  -7.70, -2.50,    -4.00, -4.00 ]);

//    Silkscreen  End of



//
//  Reference Designator
//

$$text( "SILKSCREEN", "^$ref",  -11.8,  -2.5,  2.5, @BC, 90, 1.00, 0.20, "std", "None", 0.0, 0.0 );



//
//  Drill Holes - 4 of them    3x 1.60 mm  for the receptacle's alignment pins
//                      and    1x 2.70 mm  for the M2.5 Mounting Screw
//
//  Three of these are now component pins  and  the press-fit
//  pin located at  -3.00, -5.00   does not exist on the TE part.
//




//
//   Now the  Pin List
//
//     Pin #1  is the M2.5 mounting screw
//
//     Pin #2  is the  inboard press-fit pin
//
//     Pin #3  is the outboard press-fit pin
//



$$attribute( "COMPONENT_PIN_DEFINITION",     "1", , @scale , ,          [   0.00,    0.00 ]);
$$attribute( "COMPONENT_PADSTACK_OVERRIDE",  "1, Term_M2_5_Guide_Pin");


$$attribute( "COMPONENT_PIN_DEFINITION",     "2", , @scale , ,          [  -9.00,   -5.00 ]);
$$attribute( "COMPONENT_PADSTACK_OVERRIDE",  "2, Term_Press_Guide_Pin");


$$attribute( "COMPONENT_PIN_DEFINITION",     "3", , @scale , ,          [   3.00,   -5.00 ]);
$$attribute( "COMPONENT_PADSTACK_OVERRIDE",  "3, Term_Press_Guide_Pin");