Factory methods¶
-
chipscopy.
create_session
(*, hw_server_url, cs_server_url=None, **kwargs)[source]¶ Create a new session. Connect to the specified hw_server, and optionally the cs_server.
hw_server is used for programming and Versal Memory read/write operations
cs_server is used for higher level debug core communication
Example 1: Default session create
my_session = create_session(hw_server_url="TCP:localhost:3121", cs_server_url="TCP:localhost:3042")
Example 2: Disable core scanning and server version checking
my_session = create_session(hw_server_url="TCP:localhost:3121", cs_server_url="TCP:localhost:3042", disable_core_scan=True, bypass_version_check=True)
- Parameters
hw_server_url (
str
) – Hardware server URL. FormatTCP:<hostname>:<port>
cs_server_url (
Optional
[str
]) – ChipScope server URL. FormatTCP:<hostname>:<port>
- Return type
- Returns
New session object.
chipscopy.api.session¶
-
class
chipscopy.api.session.
Session
(*, hw_server_url, cs_server_url=None, xvc_server_url=None, disable_core_scan, bypass_version_check)[source]¶ Bases:
object
Top level object that tracks a connection to a hardware server and optionally, chipscope server. To create and destroy a session, use the factory function create_session() and delete_session().
-
get_param
(params)[source]¶ Generic parameter get and set for low level chipscope server params
- Return type
Dict
[str
,str
]
-
property
devices
¶ Returns a list of devices connected to this hw_server. Devices may contain several chains so don’t always assume a single jtag chain in-order is returned
-
static
set_log_level
(level=None)[source]¶ Set the logging level for the ChipScoPy client. This applies to all sessions. Default is “NONE”
- Parameters
level (
Optional
[str
]) – The minimum level to use for the logger. Valid levels are “TRACE”, “DEBUG”, “INFO”, “SUCCESS”, “WARNING”, “ERROR”, “CRITICAL”, “NONE”
-