componentPinData

R2026b

Pin data of component

Since R2025a

Syntax

cpindata = componentPinData(componentobj)

cpindata = componentPinData(componentobj,PinInd)

Description

cpindata = componentPinData(componentobj) returns a component pin data object of a component object for all pins.

cpindata = componentPinData(componentobj,PinInd) returns component pin data of a component object for a specified pin index.

Examples

Get Pin Data of a PCB Component

Use the componentPinData function to get the pin data of a pcb component.

Read-in a pcb file

Use the pcbFileRead object to read in a file. Accepted file formats are:

• ODB++

• Allegro

• Native

Here we are using a native format file.

pfile = pcbFileRead('native_ExampleBoard_Allegro')

pfile = 
  pcbFileRead with properties:

           FileName: 'native_ExampleBoard_Allegro'
          NumLayers: 5
         MetalLayer: [1 3 5]
    DielectricLayer: [2 4]
        LayerHeight: [0.0184 0.0104 0.0092 0.0012 0]
         NumCadnets: 7
       NumPadStacks: 6
      NumComponents: 8
           NumParts: 5

Get component list

Use the componentList function.

clist = componentList(pfile)

clist = 8×3 table
    ComponentIdx    ComponentName    NumPins
    ____________    _____________    _______

         1            {'OUT_V'}         1   
         2            {'U1'   }         6   
         3            {'C3'   }         2   
         4            {'R1'   }         2   
         5            {'TP1'  }         1   
         6            {'R2'   }         2   
         7            {'IN_N' }         1   
         8            {'IN_P' }         1   

Create a component object

Create a component object of 'U1'.

cobj = component(pfile,"U1")

cobj = 
  component with properties:

             pcBoard: [1×1 pcbFileRead]
       ComponentName: 'U1'
            PartName: 'IC6ANT'
       ComponentType: 'IC'
             NumPins: 6
               Value: ''
            Facement: 'TOP'
    ComponentPinInfo: [6×7 table]

Get pin data

Use the componentPinData function.

componentPinData(cobj)

ans = 
  1×6 pinsData array with properties:

    PinShape
    PartNumber
    Component
    PinNumber
    PadStack
    CadnetName

Input Arguments

componentobj — Component

object

The component object specified as a string.

Example: cpindata = componentPinData(componentname)

Data Types: string

PinInd — Pin index

scalar | array

One or more pin indices of a Component specified as scalar or array.

Example: cpindata = componentPinData(componentname,2)

Data Types: int8

Output Arguments

cpindata — Pin data

object

Returns the pin data object of a component.

Version History

Introduced in R2025a