Sherlock User Guide User Data Files

Transcription

1 Sherlock User Guide User Data Files Background Sherlock uses a collection of data files that define various properties used for data gathering and analysis. These data files are usually sufficient to handle most analysis tasks. Nonetheless, if users need to augment or replace specific properties they can do so by creating their own CSV data files. This lesson describes the required contents and location for each of the user-defined CSV data files that are supported. User Defined Data Files Users may create their own CSV data files for each of the following types of data: Laminate Properties Material Properties Part Type Properties Package Properties Package Images Solder Properties PTH Quality Factors For each data type, a single CSV file with the proper name can be created and placed in the Sherlock User Data Folder: Windows XP: Windows Vista: Windows 7: where USERID is the Window user ID. c:\documents and Settings\USERID\Application Data\Sherlock c:\users\userid\appdata\roaming\sherlock c:\users\userid\appdata\roaming\sherlock We now describe the required columns and data format for each CSV file of 10

2 Laminate Properties (laminate.csv) The user defined laminate.csv file must define the following data columns: Company String Manufacturer's name DfR Solutions Material String Material name FR-4 Product Name String Product Name DfR FR-4 Super CTExy Numeric CTE in XY plane (pre-tg, max) 15 CTEz Numeric CTE in Z direction (pre-tg) 70 Exy Numeric Tensile Modulus (MPa) Ez Numeric Out of Plane Modulus (MPa) 3450 Density Numeric Density (g/cc) 1.8 The Company, Material and Product Name columns are used as the unique key to determine if a laminate should be added to the database or overwritten by the values in the user defined file. Rows that have a blank value for Company will be ignored. Values must be specified in all columns specified above. All other columns defined in the CSV file will be ignored by Sherlock when loading the laminate data of 10

3 Material Properties (material.csv) The user defined material.csv file must define the following data columns: Name String Material Name COPPER Type Choice ELASTIC, DEFORMATION_PLASTICITY SubType Choice ISO, ORTHO, ENGINEERING_CONSTANTS, ANISO ELASTIC ISO Elastic Modulus Numeric Elastic Modulus (MPa) Poisson Ratio Numeric Poisson's Ratio 0.4 Expansion Type Choice NONE, ISO, ORTHO, ANISO ISO Expansion Zero Numeric Expansion Zero 0 CTE Numeric CTE (1/C) 1.8 Density Properties Numeric Density (tonne/mm3) 1.70E-009 Usage Choice Slash delimited list of LEAD, PAD, RESIN, FIBER (or empty) LEAD / PAD The Name column is used as the unique key to determine if a material should be added to the database or overwritten by the values in the user defined file. Rows that have a blank value for Name will be ignored. If one or more values are defined in the Usage column then they must be separated by a slash ( / ). Materials that are designated as LEAD materials will appear in the choice list displayed for component leads. Materials that are designated as PAD materials will appear in the choice lists displayed for conductor layers and pads. Materials that are designated as RESIN materials will appear in the choice list displayed for resin layers. Materials that are designated as FIBER materials will appear in the laminate manager when a glass style is selected. All other columns defined in the CSV file will be ignored by Sherlock when loading the material data of 10

4 Part Type Properties (parttype.csv) The user defined parttype.csv file must define the following data columns: designator String Part Designator C parttype String Part Type Capacitor partmaterial Choice Must be a valid Material Name BARIUMTITANATE The designator column is used as the unique key to determine if a part type should be added to the database or overwritten by the values in the user defined file. Rows that have a blank value for designator will be ignored. All other columns defined in the CSV file will be ignored by Sherlock when loading the part type data of 10

5 Package Properties (package.csv) The user-defined package.csv file must define the following data columns: Package Name String Common Package Name LQFP-64 JEP95 String JEDEC JEP95 designator MS-026 Package Units Choice in, mm, mil, micron mm Package Length Numeric Package length (long dimension) 10 Package Width Numeric Package width (short dimension) 10 Package Thickness Numeric Package thickness 1.6 Lead Count Integer Number of pins/balls 64 Lead Geometry Choice Gullwing, J_Lead, Leadless, ThroughHoleSquare, C_Lead, Stub Gullwing The Package Name column is used as the unique key to determine if a part type should be added to the database or overwritten by the values in the user defined file. Rows that have a blank value for Package Name will be ignored. If a value is specified in the JEP95 column then it will be automatically appended to the Package Name value to create a unique package identifier. Blank values may be specified in the JEP95 column if no JEDEC designator is known for a given package of 10

6 The following optional columns may be defined in the package.csv file: Aliases String Comma separated list of prefixes LQFP, TQFP Ball Chan Width Numeric Width of outer ball region (BGA packages) 3.2 Ball Count Numeric Number of solder balls (BGA packages) 5.0 Ball Diameter Numeric Diameter of BGA solder ball 1.1 Ball Height Numeric Height of solder ball (BGA packages) 1.1 Ball Package Diameter Numeric Diameter of solder ball where the ball attaches to the package Ball Height Numeric Maximum height of a solder ball 0.7 Ball Pattern Choice FULL, PERIMETER, ISLAND, CHANNEL, UNKNOWN Ball Pitch Numeric Distance between adjacent solder balls (BGA packages) BondPadLength Numeric Length of bond pad (chip component packages) BondPadPitch Numeric Distance between bond pads (chip component packages) BondPadWidth Numeric Width of bond pad (chip component packages) Corner Radius Numeric Radius of the package corner for MITER and ROUND packages 0.5 CHANNEL Corner Shape Choice MITER, ROUND, SQUARE ROUND Feature Size Numeric Smallest feature size (in microns) 10 Die Length Numeric Length of the die (long dimension) 3 Die Thickness Numeric Thickness (height) of the die 0.4 Die Width Numeric Width of the die (short dimension) 3.0 Flag Length Numeric Flag length (long dimension) (IC packages) 2.1 Flag Thickness Numeric Flag thickness (height) (IC packages) 0.5 Flag Width Numeric Flag width (short dimension) (IC packages) 1.9 Lead Bend (degrees) Numeric Number of degrees the lead is bent from vertical (leaded packages) Lead Foo tlength Numeric Length of lead foot (leaded packages) 0.6 Lead Height Numeric Height of lead (leaded packages) 0.5 Lead Hole Diameter Numeric Diameter of the hold used to solder the lead (leaded packages) of 10

7 Lead Layout Choice SIP, DIP, RADIAL, CIRCULAR SIP Lead Material Choice ALLOY42, COPPER COPPER Lead Pitch Numeric Center-to-center distance between adjacent SIP or DIP pattern leads (leaded packages) Lead Shoulder Numeric Length of non-vertical lead segment when a lead is bent (leaded packages) Lead Standoff Numeric Distance between the PCB and bottom of the body of a part with bent leads (leaded packages) Lead Thickness Numeric Lead thickness (leaded packages) 0.15 Lead Width Numeric Lead width (leaded packages) 0.2 Material Choice Package material: DEFAULT, FR4, ALUMINA, BARIUMTITANATE, EPOXYENCAPSULANT, TANTALUM, COPPER, KOVAR, ALLOY42, FERRITE, SILICON, LAMINATE-BGA, OVERMOLD-BGA, OVERMOLD-QFN, OVERMOLD-LEADED, COPPER-RESIN, ALUMINUM (or any material name listed in the user-defined material.csv file) Package Mount Choice SMT, TH SMT Pad Length Numeric Length of the pad measured parallel to the side of the component Pad Pitch Numeric Center-to-center distance between pads 1.27 Pad Width Numeric Width of the pad measured perpendicular to the side of the component TANTALUM Seal Type Choice NONHERMETIC, HERMETIC, GLASS, CAN HERMETIC Weight Numeric Weight of the package in grams If an Aliases value is defined then each of the prefixes defined in that list (along with the prefix defined in the Name column) will incorporated into a wild-card pattern used to match package names when importing data. The pattern will automatically include any suffix defined in the Name column, so only prefix values should be specified in the Aliases column. All of the numeric measurements should be specified using the units indicated by the Units column value. All other columns defined in the CSV file will be ignored by Sherlock when loading the package data of 10

8 Package Images (User Data Folder / packageimages) The Package Chooser attempts to display an image for each package name or package type selected. Default images are located in the Sherlock Installation directory and are automatically updated whenever Sherlock is upgraded. Users can override or augment the default images by placing one or more image files in the packageimages sub-directory located in the User Data Folder (see the first page of this tutorial for the exact platform-dependent folder location). Image files stored in that directory must satisfy the following conditions: 1. Image files must be in JPEG format, with a suffix of.jpg. For best viewing, the images should be 160x160 pixels, with a white background if possible. Sherlock will automatically resize images larger than that size. 2. Image files must be placed in the sub-folder corresponding to the Package Type of the package being represented. For example, all images to be displayed for CDIP packages should be in the CDIP sub-folder. 3. Image files must be named using either the standard Sherlock Package Name or the JEP95 identifier. For example, the image file for the CDIP-08 (MO-036AA) package must use either the CDIP-08.jpg or MO-036AA.jpg file name. A default image file can be defined for each Package Type by using the Package Type as the file name. For example, the default CDIP image would be stored in the CDIP sub-folder using the CDIP.jpg file name. Default images are displayed if no package-specific image file is found in either the Sherlock Installation Directory or the User Data Folder / packageimages directory of 10

9 Solder Properties (solder.csv) Unlike the other data files, the solder data file is defined as a vertical CSV file, in which each row of the file represents a specific property and each column represents a specific solder type. The first column denotes the property name. For example, the following solder.csv would be acceptable: Name 63Sn37Pb SAC305 Type Tin Lead Lead Free ModulusAtZero ModulusSlope The user defined solder.csv file must define the following data rows: Row Name Type Description Example Name String Unique solder name 63Sn37Pb Type Choice Tin Lead, Lead Free Tin Lead The user defined solder.csv file may define the following data rows: Row Name Type Description Example ModulusAtZero Numeric X-intercept value used to determine the Elastic Modulus ModulusSlope Numeric Slope value used to determine the Elastic Modulus CriticalDwellTime Numeric Used to determine strain energy ActivationEnergy Numeric Used to determine strain energy 1414 CriticalMaxTemp Numeric Used to determine strain energy 368 StrainEnergyCoefficient Numeric Used to determine Cycles to Fail of 10

10 PTH Quality Factors (pthquality.csv) The user defined pthquality.csv file must define the following data columns: QualityFactor String Unique quality factor name Good QualityValue Numeric Value associated with quality factor between 0.0 and StrainDistFactor Numeric Strain distribution factor 1.75 WeibullBeta Numeric Weibull beta value used when computing life prediction PredictionProb Numeric Predicition probability All rows must have values defined for each of the columns listed above. All other columns defined in the CSV file will be ignored by Sherlock when loading the data of 10