Recent changes to Home

Home modified by Tomek Cedro

Tomek Cedro — Mon, 13 Apr 2015 11:12:28 -0000

--- v2
+++ v3
@@ -1,157 +1,2 @@
-Welcome to the Serial Wire Debug Open Library!
-==================
-
-This is an official website of the LibSWD, an Open solution for accessing the SW-DP (Serial Wire Debug Port) on ARM Cortex CPU based embedded systems. Library is available under ["new" 3 clause BSD License](http://www.opensource.org/licenses/bsd-license.php).
-
-This project was started by [Tomasz Bolesław CEDRO](http://www.tomek.cedro.info) to create and document Free and Open-Source SWD (Serial Wire Debug) access to new [ARM-Cortex CPU cores](http://en.wikipedia.org/wiki/ARM_architecture). SWD is an alternative to JTAG method for accessing the DAP that allows low-level access to system resources such as system bus, memory, IO, even single stepping the code execution - a must-have for an embedded systems developer. 
-
-SWD works on both simple and advanced devices from the ARM Cortex family. By default Cortex CPU or FPGA'a IP Core is both JTAG and SWD capable, so the common name for this transport method is SWJ (Serial Wire and JTAG). It is the application requirement and designer choice if a final product supports JTAG, SWD, or both (SWJ). [Here](http://www.arm.com/files/pdf/Low_Pin-Count_Debug_Interfaces_for_Multi-device_Systems.pdf) you can read short and interesting article on how SWD overcomes JTAG limitations.
-
-LibSWD can be considered almost standalone to be easily integrated into third party software with minimal impact on existing program structure. LibSWD implements all utilities necessary to generate bit stream and queue bus operations on both high (operation) and low (bit) abstraction level. High level functions can be called from external application to generate queue that represent bus operations or simply produce a bitstream that can be later flushed into real hardware with simple set of functions (these functions can utilise existing cable drivers already implemented in external software).
-
-The first approach and practical tests werure performed on simple [STM32Primer development kits](http://www.stm32circle.com/) using [UrJTAG](http://urjtag.sf.net) and [OpenOCD](http://openocd.sf.net) utilities as described on the <http: stm32primer2swd.sf.net=""> project webstie. Some parts of this research were conducted as a cooperation between [Orange Labs Warsaw](http://www.orange.com/en_EN/group/global_footprint/countries/poland/poland-lab.jsp) and [Orange Labs Paris](http://www.orange.com/en_EN/group/global_footprint/countries/france/france-lab.jsp), and some additionally by [Cybernetic Research Student Group](http://cyber.ise.pw.edu.pl/) from Warsaw University of Technology in Poland that I am founder and member.
-
-
-Releases
-------------------
-
-2013-10-20: [libswd-0.6.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.6.tar.gz/download) / [libswd-0.6.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.6.pdf/download)
-
-2012-12-06: [libswd-0.5.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.5.tar.gz/download) / [libswd-0.5.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.5.pdf/download)
-
-2012-10-14: [libswd-0.4.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.4.tar.gz/download) / [libswd-0.4.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.4.pdf/download)
-
-2011-11-11: [libswd-0.3.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.3.tar.gz/download) / [libswd-0.3.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.3.pdf/download)
-
-2011-10-31: [libswd-0.2.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.2.tar.gz/download) / [libswd-0.2.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.2.pdf/download) 
-
-2011-04-02: [libswd-0.1.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.1.tar.gz/download) / [libswd-0.1.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.1.pdf/download)
-
-
-Source Code Repository
-------------------
-
-Source code now use GIT for remote development and code repository, SVN is only used to store doxygen documentation. You can [browse SVN](http://libswd.svn.sourceforge.net/viewvc/libswd), [GIT](http://libswd.git.sourceforge.net/git/gitweb.cgi?p=libswd/libswd;a=summary), or checkout files to your local machine with command:
-
- `git clone git://git.code.sf.net/p/libswd/code libswd-code`
-
-
-Documentation
-------------------
-
-LibSWD is documented using Doxygen. Documentation body is included within the source code and then generated with doxygen utility to obtain html/pdf output files (run `make doxygen-doc` command), therefore documentation sources and its result is integral part of the source code repository. All necessary documents are frozen upon release and delivered within the package to match code version (see Releases section). 
-
-Practical part of this project is documented at: http://stm32primer2swd.sf.net/
-
-
-References
-------------------
-
- * <http: stm32primer2swd.sf.net=""> - a practical implementation and verification of LibSWD on ARM-Cortex devices (using Stm32Primer2 and KT-LINK).
- * [ARM Document on SWD](http://www.arm.com/files/pdf/Low_Pin-Count_Debug_Interfaces_for_Multi-device_Systems.pdf) - Low Pin-Count Debug Interfaces for Multi-device Systems - short but good introduction, recommended lecure! 
- * [STM32F103VE](http://www.st.com/mcu/modules.php?name=mcu&file=devicedocs&DEV=STM32F103VE) - ST website dedicated to the CPU used in Stm32Primer2, full documentation and examples. 
- * [OpenOCD](http://openocd.sf.net/) - Open-Source utility to (re)program target's memory and code debug. 
- * [UrJTAG](http://urjtag.sf.net/) - Open-Source utility to perform low-level TAP operations on various hardware targets. 
- * [ARM SWD Website](http://www.arm.com/products/system-ip/debug-trace/coresight-soc-components/serial-wire-debug.php) - Official ARM website with SWD description. 
- * [STM32 SWD Website](http://www.arm.com/products/system-ip/debug-trace/coresight-soc-components/serial-wire-debug.php) - Official STM32 with SWD description. 
- * [ARM Info Center](http://infocenter.arm.com/help/) - every information you need to get about ARM product is there (including CoreSight on-chip trace and debug).
-
-
-News
-------------------
-
-2013-10-20:
-
-* LibSWD 0.6 release:
- * Introducing CLI (Command Line Interface) parser framework. Updated error defines.
- * Major fixes in LOG functions. Introducing vprintf() like libswd_log_internal_va().
- * Added DEFAULT defines for LogLevel and AutoFixErrors libswdctx->config values.
- * Introducing MEM-AP routines.
- * Introducing Standalone LibSWD Aplication.
- * Introducing initial support for Debug and Flash access.
-
-012-12-06:
-
- * LibSWD 0.5 release.
- * All functions and defines were renamed to use prefix libswd_ and LIBSWD_.
- * This is a first and official candidate for release with OpenOCD master.
-
-2012-10-14:
-
- * LibSWD 0.4 is out, bugfix and functional verification release that includes:
- * Implemented necessary data phase on ACK={WAIT,FAULT} reply from Target.
- * Unknown ACK response and Protocol Error Sequence detection.
- * swd_cmd_t was added *errors to hold queue for error handling in ACK element.
- * automatic error handling on queue was not included in this release yet.
- * fixed swd_cmdq_free_tail()
- * swd_cmdq_flush() updates swdctx->cmdq upon execution.
- * swd_drv_transmit() updates swdctx->log values only on successful transmit.
- * DP and AP operations including MEM-AP now works.
- * OpenOCD integration is almost done, flashing works (1938B/18.6s with FT2232).
- * By the way, I express my admiration to Felix Baumgartner and the whole Redbull STRATOS team for their pioneer achievments and today aerospace/skydive records!! :-)
-
-2011-11-11
-
- * LibSWD 0.3 comes out, a major bugfix release:
- * Fixed critical issue with ACK/DATA bitswap due erratic ARM documentation.
- * Fixes and improvements in libswd.h.
- * Debug hint function in Request packet decoposition (libswd_drv).
- * Fixed OpenOCD drivers.
- * Introduced SWD_LOGLEVEL_PAYLOAD even more verbose than debug.
- * All transfers are now LSB-First.
- * Major bugfixes.
-
-2011-11-1
- 
-* Code repository now use only a GIT system.
-* SVN only stores doxygen documentation in trunk for easier web browsing, including documentation and code for releases.
-* Synchronization between svn and git is a mess, we don't need that, git is far better for code development :-)
-
-2011-10-31
-
- * LibSWD 0.2 release:
- * Source code reorganization (split into different files).
- * Build system fixes and documentation updates.
- * Integration with OpenOCD.
- * Bugfixes and improvements.
- * Created function set for easier work on DAP.
- * Error detection in swd_drv_transmit() - cmdq is truncated on error.
-
-2011-04-02
-
- * LibSWD initial version 0.1 released to the public.
- * Basic functionality of transport, queue and drivers for ADIv5.0.
- * Automated SW-DP activation/reset and IDCODE read.
- * Tested and verified functionality on UrJTAG.
- * Source code documented using Doxygen.
- * Autotools integration for standarized build.
-
-2011-03-23
-
- * Integration with UrJTAG complete. Source code sent to developers.
- * Functionality verification complete. Updated work in progress description
-   at http://stm32primer2swd.sf.net/
- * Started integration with OpenOCD...
-
-2011-02-09
-
- * Remote source code repository (SVN) started.
-
-2010-12-29
-
- * Official LibSWD project website launched at http://libswd.sf.net
-
-2010-11-23
-
- * Decision to implement SWD API as standalone library.
-
-2010-10-21
-
- * Work to create open swd implementation has begun.
- * Website with progress log launched at http://stm32primer2swd.sourceforge.net/.
-
-
-Support
-------------------
-
-Please use SourceForge goodies for support.
+Documentation is at GIT / README.md :-)
+https://github.com/cederom/libswd

Home modified by Tomek Cedro

Tomek Cedro — Wed, 01 Apr 2015 17:18:50 -0000

--- v1
+++ v2
@@ -1,8 +1,157 @@
-Welcome to your wiki!
+Welcome to the Serial Wire Debug Open Library!
+==================

-This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].
+This is an official website of the LibSWD, an Open solution for accessing the SW-DP (Serial Wire Debug Port) on ARM Cortex CPU based embedded systems. Library is available under ["new" 3 clause BSD License](http://www.opensource.org/licenses/bsd-license.php).

-The wiki uses [Markdown](/p/libswd/wiki/markdown_syntax/) syntax.
+This project was started by [Tomasz Bolesław CEDRO](http://www.tomek.cedro.info) to create and document Free and Open-Source SWD (Serial Wire Debug) access to new [ARM-Cortex CPU cores](http://en.wikipedia.org/wiki/ARM_architecture). SWD is an alternative to JTAG method for accessing the DAP that allows low-level access to system resources such as system bus, memory, IO, even single stepping the code execution - a must-have for an embedded systems developer. 

-[[project_admins]]
-[[download_button]]
+SWD works on both simple and advanced devices from the ARM Cortex family. By default Cortex CPU or FPGA'a IP Core is both JTAG and SWD capable, so the common name for this transport method is SWJ (Serial Wire and JTAG). It is the application requirement and designer choice if a final product supports JTAG, SWD, or both (SWJ). [Here](http://www.arm.com/files/pdf/Low_Pin-Count_Debug_Interfaces_for_Multi-device_Systems.pdf) you can read short and interesting article on how SWD overcomes JTAG limitations.
+
+LibSWD can be considered almost standalone to be easily integrated into third party software with minimal impact on existing program structure. LibSWD implements all utilities necessary to generate bit stream and queue bus operations on both high (operation) and low (bit) abstraction level. High level functions can be called from external application to generate queue that represent bus operations or simply produce a bitstream that can be later flushed into real hardware with simple set of functions (these functions can utilise existing cable drivers already implemented in external software).
+
+The first approach and practical tests werure performed on simple [STM32Primer development kits](http://www.stm32circle.com/) using [UrJTAG](http://urjtag.sf.net) and [OpenOCD](http://openocd.sf.net) utilities as described on the <http: stm32primer2swd.sf.net=""> project webstie. Some parts of this research were conducted as a cooperation between [Orange Labs Warsaw](http://www.orange.com/en_EN/group/global_footprint/countries/poland/poland-lab.jsp) and [Orange Labs Paris](http://www.orange.com/en_EN/group/global_footprint/countries/france/france-lab.jsp), and some additionally by [Cybernetic Research Student Group](http://cyber.ise.pw.edu.pl/) from Warsaw University of Technology in Poland that I am founder and member.
+
+
+Releases
+------------------
+
+2013-10-20: [libswd-0.6.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.6.tar.gz/download) / [libswd-0.6.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.6.pdf/download)
+
+2012-12-06: [libswd-0.5.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.5.tar.gz/download) / [libswd-0.5.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.5.pdf/download)
+
+2012-10-14: [libswd-0.4.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.4.tar.gz/download) / [libswd-0.4.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.4.pdf/download)
+
+2011-11-11: [libswd-0.3.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.3.tar.gz/download) / [libswd-0.3.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.3.pdf/download)
+
+2011-10-31: [libswd-0.2.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.2.tar.gz/download) / [libswd-0.2.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.2.pdf/download) 
+
+2011-04-02: [libswd-0.1.tar.gz](http://sourceforge.net/projects/libswd/files/releases/libswd-0.1.tar.gz/download) / [libswd-0.1.pdf](http://sourceforge.net/projects/libswd/files/releases/libswd-0.1.pdf/download)
+
+
+Source Code Repository
+------------------
+
+Source code now use GIT for remote development and code repository, SVN is only used to store doxygen documentation. You can [browse SVN](http://libswd.svn.sourceforge.net/viewvc/libswd), [GIT](http://libswd.git.sourceforge.net/git/gitweb.cgi?p=libswd/libswd;a=summary), or checkout files to your local machine with command:
+
+ `git clone git://git.code.sf.net/p/libswd/code libswd-code`
+
+
+Documentation
+------------------
+
+LibSWD is documented using Doxygen. Documentation body is included within the source code and then generated with doxygen utility to obtain html/pdf output files (run `make doxygen-doc` command), therefore documentation sources and its result is integral part of the source code repository. All necessary documents are frozen upon release and delivered within the package to match code version (see Releases section). 
+
+Practical part of this project is documented at: http://stm32primer2swd.sf.net/
+
+
+References
+------------------
+
+ * <http: stm32primer2swd.sf.net=""> - a practical implementation and verification of LibSWD on ARM-Cortex devices (using Stm32Primer2 and KT-LINK).
+ * [ARM Document on SWD](http://www.arm.com/files/pdf/Low_Pin-Count_Debug_Interfaces_for_Multi-device_Systems.pdf) - Low Pin-Count Debug Interfaces for Multi-device Systems - short but good introduction, recommended lecure! 
+ * [STM32F103VE](http://www.st.com/mcu/modules.php?name=mcu&file=devicedocs&DEV=STM32F103VE) - ST website dedicated to the CPU used in Stm32Primer2, full documentation and examples. 
+ * [OpenOCD](http://openocd.sf.net/) - Open-Source utility to (re)program target's memory and code debug. 
+ * [UrJTAG](http://urjtag.sf.net/) - Open-Source utility to perform low-level TAP operations on various hardware targets. 
+ * [ARM SWD Website](http://www.arm.com/products/system-ip/debug-trace/coresight-soc-components/serial-wire-debug.php) - Official ARM website with SWD description. 
+ * [STM32 SWD Website](http://www.arm.com/products/system-ip/debug-trace/coresight-soc-components/serial-wire-debug.php) - Official STM32 with SWD description. 
+ * [ARM Info Center](http://infocenter.arm.com/help/) - every information you need to get about ARM product is there (including CoreSight on-chip trace and debug).
+
+
+News
+------------------
+
+2013-10-20:
+
+* LibSWD 0.6 release:
+ * Introducing CLI (Command Line Interface) parser framework. Updated error defines.
+ * Major fixes in LOG functions. Introducing vprintf() like libswd_log_internal_va().
+ * Added DEFAULT defines for LogLevel and AutoFixErrors libswdctx->config values.
+ * Introducing MEM-AP routines.
+ * Introducing Standalone LibSWD Aplication.
+ * Introducing initial support for Debug and Flash access.
+
+012-12-06:
+
+ * LibSWD 0.5 release.
+ * All functions and defines were renamed to use prefix libswd_ and LIBSWD_.
+ * This is a first and official candidate for release with OpenOCD master.
+
+2012-10-14:
+
+ * LibSWD 0.4 is out, bugfix and functional verification release that includes:
+ * Implemented necessary data phase on ACK={WAIT,FAULT} reply from Target.
+ * Unknown ACK response and Protocol Error Sequence detection.
+ * swd_cmd_t was added *errors to hold queue for error handling in ACK element.
+ * automatic error handling on queue was not included in this release yet.
+ * fixed swd_cmdq_free_tail()
+ * swd_cmdq_flush() updates swdctx->cmdq upon execution.
+ * swd_drv_transmit() updates swdctx->log values only on successful transmit.
+ * DP and AP operations including MEM-AP now works.
+ * OpenOCD integration is almost done, flashing works (1938B/18.6s with FT2232).
+ * By the way, I express my admiration to Felix Baumgartner and the whole Redbull STRATOS team for their pioneer achievments and today aerospace/skydive records!! :-)
+
+2011-11-11
+
+ * LibSWD 0.3 comes out, a major bugfix release:
+ * Fixed critical issue with ACK/DATA bitswap due erratic ARM documentation.
+ * Fixes and improvements in libswd.h.
+ * Debug hint function in Request packet decoposition (libswd_drv).
+ * Fixed OpenOCD drivers.
+ * Introduced SWD_LOGLEVEL_PAYLOAD even more verbose than debug.
+ * All transfers are now LSB-First.
+ * Major bugfixes.
+
+2011-11-1
+ 
+* Code repository now use only a GIT system.
+* SVN only stores doxygen documentation in trunk for easier web browsing, including documentation and code for releases.
+* Synchronization between svn and git is a mess, we don't need that, git is far better for code development :-)
+
+2011-10-31
+
+ * LibSWD 0.2 release:
+ * Source code reorganization (split into different files).
+ * Build system fixes and documentation updates.
+ * Integration with OpenOCD.
+ * Bugfixes and improvements.
+ * Created function set for easier work on DAP.
+ * Error detection in swd_drv_transmit() - cmdq is truncated on error.
+
+2011-04-02
+
+ * LibSWD initial version 0.1 released to the public.
+ * Basic functionality of transport, queue and drivers for ADIv5.0.
+ * Automated SW-DP activation/reset and IDCODE read.
+ * Tested and verified functionality on UrJTAG.
+ * Source code documented using Doxygen.
+ * Autotools integration for standarized build.
+
+2011-03-23
+
+ * Integration with UrJTAG complete. Source code sent to developers.
+ * Functionality verification complete. Updated work in progress description
+   at http://stm32primer2swd.sf.net/
+ * Started integration with OpenOCD...
+
+2011-02-09
+
+ * Remote source code repository (SVN) started.
+
+2010-12-29
+
+ * Official LibSWD project website launched at http://libswd.sf.net
+
+2010-11-23
+
+ * Decision to implement SWD API as standalone library.
+
+2010-10-21
+
+ * Work to create open swd implementation has begun.
+ * Website with progress log launched at http://stm32primer2swd.sourceforge.net/.
+
+
+Support
+------------------
+
+Please use SourceForge goodies for support.

WikiPage Home modified by Tomek Cedro

Tomek Cedro — Thu, 06 Dec 2012 13:48:18 -0000

Welcome to your wiki! This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage]. The wiki uses [Markdown](/p/libswd/wiki/markdown_syntax/) syntax. [[project_admins]] [[download_button]]