chipscopy.api.ibert.link¶

chipscopy.api.ibert.create_links(*, rxs, txs)¶

Create link(s) for given RX object(s) and TX object(s). None of the RX or TX object(s) must be part of existing links.

Parameters

rxs (Union[RX, List[RX]]) – RX object(s) to use for link creation
txs (Union[TX, List[TX]]) – TX object(s) to use for link creation
NOTE: (.) – If passing a list of RX objects and TX objects: must be same for link creation to succeed. For link creation, RX and TX objects are used in the order they appear in the lists.
length of both the lists (the) – must be same for link creation to succeed. For link creation, RX and TX objects are used in the order they appear in the lists.

Return type

QueryList[Link]

Returns

Newly created Link object(s)

chipscopy.api.ibert.delete_links(links_to_delete=None)¶

Delete links that were created previously

Parameters: links_to_delete (Union[Link, List[Link], QueryList[Link], None]) – (Optional) Link objects to delete. .. NOTE::If no link objects are provided, all available links are deleted.

chipscopy.api.ibert.get_all_links()¶

Get all Link object(s)

Return type: QueryList[Link]
Returns: List of link(s)

class chipscopy.api.ibert.link.Link(rx, tx, name, handle='', filter_by=<factory>, link_group=None)[source]¶

Class for interacting with links. Please do not create an instance of this class directly. Please use the factory method create_links() instead.

rx: Optional[chipscopy.api.ibert.rx.RX]¶: RX attached to this link

tx: Optional[chipscopy.api.ibert.tx.TX]¶: TX attached to this link

name: str¶: Name of this link

handle: str = ''¶: Handle in the format tx.handle-->rx.handle. If TX/RX in unknown, replace tx/rx.handle with UnknownTX/RX

filter_by: Dict[str, Any]¶

link_group: Optional[chipscopy.api.ibert.link.group.LinkGroup] = None¶: Link group this link belongs to

invalidate()[source]¶

property eye_scan¶

Get the EyeScan object attached to the RX that is part of the link.

Return type: Optional[ForwardRef]
Returns: Eye scan object if available in RX

property ber¶

Refresh and get the BER value.

Note

There might be some loss of precision when converting the BER value from str to float.

Return type: float
Returns: BER str value converted to float

property status¶

Refresh and get the status.

Return type: str
Returns: Link status

property line_rate¶

Refresh and get the line rate of the RX

Return type: str
Returns: Line rate

property bit_count¶

Refresh and get the bits received by the RX

Returns: Bit count

property error_count¶

Refresh and get the error counter value

Returns: Error counter value

generate_report()[source]¶: Generate a report for this link and send it to the “printer” for printing

refresh()[source]¶: Refresh the attributes