[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[avr-libc-commit] [2374] Contributed by Knut Schwichtenberg:

From: Joerg Wunsch
Subject: [avr-libc-commit] [2374] Contributed by Knut Schwichtenberg:
Date: Mon, 29 Apr 2013 21:06:52 +0000

Revision: 2374
Author:   joerg_wunsch
Date:     2013-04-29 21:06:52 +0000 (Mon, 29 Apr 2013)
Log Message:
Contributed by Knut Schwichtenberg:

Add POD (plain old documentation).

Modified Paths:

Modified: trunk/avr-libc/ChangeLog
--- trunk/avr-libc/ChangeLog    2013-04-29 20:35:36 UTC (rev 2373)
+++ trunk/avr-libc/ChangeLog    2013-04-29 21:06:52 UTC (rev 2374)
@@ -1,5 +1,10 @@
 2013-04-29 Joerg Wunsch <address@hidden>
+       Contributed by Knut Schwichtenberg:
+       * devtools/ioreg.pl: Add POD (plain old documentation).
+2013-04-29 Joerg Wunsch <address@hidden>
        * configure.ac (--with-debug-info): New option.
        * devtools/Device.am: Replace hard-coded debug information
        options by CDEBUG or ASDEBUG, respectively.

Modified: trunk/avr-libc/devtools/ioreg.pl
--- trunk/avr-libc/devtools/ioreg.pl    2013-04-29 20:35:36 UTC (rev 2373)
+++ trunk/avr-libc/devtools/ioreg.pl    2013-04-29 21:06:52 UTC (rev 2374)
@@ -439,7 +439,8 @@
     print STDERR "$0 version: $VERSION Copyright (c) by Knut Schwichtenberg\n";
     print STDERR "Usage: $0\ [switches] AVR_XML_file\n";
     print STDERR "   -h This message\n";
-    print STDERR "   -v Version\n";
+    print STDERR "   -V Version\n";
+    print STDERR "   -v Verbose\n";
     print STDERR "   -x path to saxon9\n";
     print STDERR "   -o output file otherwise STDOUT \n";
@@ -448,7 +449,7 @@
 # Handle the command line
-$options = 'hVvx:c:o:';
+$options = 'hVvx:o:';
 getopts( $options, \%opts );
 if( defined $opts{'h'} ){
@@ -541,5 +542,80 @@
 print $trailer;
+=head1 NAME
+ioreg.pl  - Create debug information from Atmel XML files for IO-Ports and 
+=head1 SYNOPSIS
+       perl ioreg.pl xxxxx.XML   
+Using GDB and AVaRICE to debug AVR code requies to know the addresses of
+IO registers! The GDB command "x PORTA" leads to an unkonwn address
+error. Beginning with Atmel Studio 5 well formed XML file are deliverd 
+as part of the installation. This script converts these XML-files using a 
+stylesheet into dwarf-2 debug information. To prevent Atmel's debugger from
+crashing only dwarf-2 can be used, while GDB could use debug information
+up to dwarf-4. Similar to the handling of the IO-addresses the eeprom
+start address can be accessed by the lable __eeprom.  Its type is an CPU 
+speficfic array of uint8_t.
+This debug information is added to the device specific start-up code of 
+avr-libc and now allows debugging symbolic 
+It is possible to use dwarf-4 debug information for the 
+application and mix it with dwarf-2 of the start-up code.
+=head1 Preconditions
+This script relies on
+=over 3
+=item *
+Atmel's AVR XML files
+=item *
+Stylesheet file named "findreg.xsl". It has to be located in the same 
directory as ioreg.pl 
+=item *
+XSLT processor, either xsltproc or saxon9
+If xsltproc is used, it must be in the PATH. Using saxon9 gives a runtime 
warning which can be ignored.
+=head1 Command line parameter
+The following command line parameter are supported
+=over 5
+=item h
+Print the help infomation to STDERR
+=item V
+Print the version information to STDERR
+=item v
+Print verbose information to STDERR
+=item x
+Sets the path to saxon9. Default: /usr/share/java
+=item o
+Set the output file otherwise STDOUT is used 
+=head1 Authors
+Knut Schwichtenberg / Joerg Wunsch

reply via email to

[Prev in Thread] Current Thread [Next in Thread]