# lauterbach-trace32-pystart
Since 2020, Python programs can control TRACE32 via the lauterbach-trace32-rcl module (pyrcl). Up to now, TRACE32 must be started using a config file, which requires familiarization with the TRACE32 configuration file syntax or the use of the configuration tool t32start.exe. Now Lauterbach offers a new
lauterbach-trace32-pystart module (pystart) which allows the configuration and start of TRACE32 directly from Python.
For feedback and questions, please contact support@lauterbach.com (include "pystart" in the subject).
## Example
```python
import lauterbach.trace32.pystart as pystart
pystart.defaults.system_path = r"C:\T32"
powerview = pystart.PowerView(pystart.USBConnection(), "t32marm")
powerview.title = f"TRACE32 PowerView for ARM 0"
powerview.id = "T32_arm0"
powerview.start()
powerview.wait()
```
## Release Notes
### v0.2.0
* use binaries from `PATH` if no system_path is specified
* gently stop Trace32 on Windows OS
* added timeout for `PowerView.stop()`
* wait necessary time in `PowerView.start()` instead of waiting for a predefined amount of time
* added exeptions `TimeoutExpiredError` and `AlreadyRunningError`
* limit startup script parameter to be of type `Iterable[str]`
* send `stdout` and `stderr` output of PowerView instance to a logger
### v0.1.7
* fix datatype of `library_file` parameters in some Connection classes to allow `pathlib.Path`'s.
* add `TCPConnection` for Lauterbach X-Series debugger.
* rename `EthernetConnection` to `UDPConnection`
### v0.1.6
* initial release
Raw data
{
"_id": null,
"home_page": "https://www.lauterbach.com",
"name": "lauterbach-trace32-pystart",
"maintainer": "Lauterbach GmbH",
"docs_url": null,
"requires_python": null,
"maintainer_email": "support@lauterbach.com",
"keywords": null,
"author": "Lauterbach GmbH",
"author_email": "support@lauterbach.com",
"download_url": "https://files.pythonhosted.org/packages/69/eb/9370306a5d9fea7583436890874121b2c5a5176efe407ed31ea1ebe1a42e/lauterbach-trace32-pystart-0.2.0.tar.gz",
"platform": null,
"description": "# lauterbach-trace32-pystart\r\nSince 2020, Python programs can control TRACE32 via the lauterbach-trace32-rcl module (pyrcl). Up to now, TRACE32 must be started using a config file, which requires familiarization with the TRACE32 configuration file syntax or the use of the configuration tool t32start.exe. Now Lauterbach offers a new\r\nlauterbach-trace32-pystart module (pystart) which allows the configuration and start of TRACE32 directly from Python.\r\n\r\nFor feedback and questions, please contact support@lauterbach.com (include \"pystart\" in the subject).\r\n\r\n## Example\r\n```python\r\nimport lauterbach.trace32.pystart as pystart\r\n\r\npystart.defaults.system_path = r\"C:\\T32\"\r\n\r\npowerview = pystart.PowerView(pystart.USBConnection(), \"t32marm\")\r\npowerview.title = f\"TRACE32 PowerView for ARM 0\"\r\npowerview.id = \"T32_arm0\"\r\n\r\npowerview.start()\r\npowerview.wait()\r\n```\r\n\r\n## Release Notes\r\n### v0.2.0\r\n* use binaries from `PATH` if no system_path is specified\r\n* gently stop Trace32 on Windows OS\r\n* added timeout for `PowerView.stop()`\r\n* wait necessary time in `PowerView.start()` instead of waiting for a predefined amount of time\r\n* added exeptions `TimeoutExpiredError` and `AlreadyRunningError`\r\n* limit startup script parameter to be of type `Iterable[str]`\r\n* send `stdout` and `stderr` output of PowerView instance to a logger\r\n\r\n### v0.1.7\r\n* fix datatype of `library_file` parameters in some Connection classes to allow `pathlib.Path`'s.\r\n* add `TCPConnection` for Lauterbach X-Series debugger.\r\n* rename `EthernetConnection` to `UDPConnection`\r\n\r\n### v0.1.6\r\n* initial release\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "start Lauterbach TRACE32",
"version": "0.2.0",
"project_urls": {
"Documentation": "https://support.lauterbach.com/news/posts/python-library-in-place-of-trace32-config-files",
"Homepage": "https://www.lauterbach.com"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "019fd079d6b8e3b61ca5b84f4e619312f50b03f7e07c28a3a599a7f8197eb42c",
"md5": "cd4a8c46819cf84948bd1b86822b5dd6",
"sha256": "2fe8f6fdbafda1aef26c2867c60ad7688de283e2e17b8a5f318c5b8ee0e722e2"
},
"downloads": -1,
"filename": "lauterbach_trace32_pystart-0.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cd4a8c46819cf84948bd1b86822b5dd6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 17472,
"upload_time": "2024-06-10T07:16:44",
"upload_time_iso_8601": "2024-06-10T07:16:44.853549Z",
"url": "https://files.pythonhosted.org/packages/01/9f/d079d6b8e3b61ca5b84f4e619312f50b03f7e07c28a3a599a7f8197eb42c/lauterbach_trace32_pystart-0.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "69eb9370306a5d9fea7583436890874121b2c5a5176efe407ed31ea1ebe1a42e",
"md5": "40f3747539664443e686f51bde474295",
"sha256": "0116153b62d701e89276ed00edb1cc67bd6606d5817ed1f1643b1ed7283acce1"
},
"downloads": -1,
"filename": "lauterbach-trace32-pystart-0.2.0.tar.gz",
"has_sig": false,
"md5_digest": "40f3747539664443e686f51bde474295",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 19385,
"upload_time": "2024-06-10T07:16:46",
"upload_time_iso_8601": "2024-06-10T07:16:46.380290Z",
"url": "https://files.pythonhosted.org/packages/69/eb/9370306a5d9fea7583436890874121b2c5a5176efe407ed31ea1ebe1a42e/lauterbach-trace32-pystart-0.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-10 07:16:46",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "lauterbach-trace32-pystart"
}
JSON