[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[avr-libc-commit] [2361] Add some basic infrastructure to generate auxil
|
From: |
Joerg Wunsch |
|
Subject: |
[avr-libc-commit] [2361] Add some basic infrastructure to generate auxiliary debugging information |
|
Date: |
Thu, 25 Apr 2013 11:29:44 +0000 |
Revision: 2361
http://svn.sv.gnu.org/viewvc/?view=rev&root=avr-libc&revision=2361
Author: joerg_wunsch
Date: 2013-04-25 11:29:43 +0000 (Thu, 25 Apr 2013)
Log Message:
-----------
Add some basic infrastructure to generate auxiliary debugging information
for IO registers which can then be used by debuggers.
The perl script is courtesy Knut Schwichtenberg, who also beta-tested the
generated DWARF-2 information. Many thanks to him!
(Obviously, this still has to be integrated into the build system.)
Modified Paths:
--------------
trunk/avr-libc/ChangeLog
Added Paths:
-----------
trunk/avr-libc/devtools/findreg.xsl
trunk/avr-libc/devtools/ioreg.pl
Modified: trunk/avr-libc/ChangeLog
===================================================================
--- trunk/avr-libc/ChangeLog 2013-04-24 22:22:58 UTC (rev 2360)
+++ trunk/avr-libc/ChangeLog 2013-04-25 11:29:43 UTC (rev 2361)
@@ -1,3 +1,9 @@
+2013-04-25 Joerg Wunsch <address@hidden>
+
+ * devtools/ioreg.pl: (New file.), contributed by Knut
+ Schwichtenberg
+ * devtools/findreg.xsl: (New file.)
+
2013-04-19 Joerg Wunsch <address@hidden>
* devtools/gen-avr-lib-tree.sh: De-POSIXify the shell usage, since
Added: trunk/avr-libc/devtools/findreg.xsl
===================================================================
--- trunk/avr-libc/devtools/findreg.xsl (rev 0)
+++ trunk/avr-libc/devtools/findreg.xsl 2013-04-25 11:29:43 UTC (rev 2361)
@@ -0,0 +1,93 @@
+<?xml version="1.0" encoding='UTF-8' ?>
+<xsl:stylesheet version="1.0"
+ xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
+ xmlns="http://www.w3.org/1999/xhtml";>
+<!--
+ * Copyright (c) 2013 Joerg Wunsch
+ *
+ * "THE BEER-WARE LICENSE" (Revision 42):
+ * Joerg Wunsch wrote this file. As long as you retain this notice you
+ * can do whatever you want with this stuff. If we meet some day, and you think
+ * this stuff is worth it, you can buy me a beer in return. Joerg Wunsch
+ *
+ * $Id$
+-->
+
+<!--
+ * Extract IO register names and offsets out of Atmel Studio 6.x device XML
files.
+ *
+ * The result is one line per IO register, in the form:
+ *
+ * REGNAME<tab>BASEADDRESS<tab>OFFSET<tab>SIZE<newline>
+ *
+ * REGNAME - name of this IO register
+ * BASEADDRESS - base address of register group (IO module)
+ * always 0 for non-Xmega devices
+ * OFFSET - offset of register within group
+ * SIZE - size of register in bytes (1 or 2)
+-->
+
+<!--
+ * Usage:
+ *
+ * xsltproc findreg.xsl ATxxx.xml > ATxxx.reg.txt
+ *
+ * or:
+ *
+ * java -jar /path/to/saxon9.jar -xsl:findreg.xsl -o:ATxxx.reg.txt ATxxx.xml
+ *
+ * (The warning about Saxon being an XSL 2.0 processor processing a 1.0
+ * style sheet can be ignoroed.)
+-->
+ <xsl:output method="text"/>
+
+ <!--
+ Pick all register-groups which are located in the
+ address-space named "data". Lock and fuse bits are also
+ declared as register-group, but they've got their own address
+ space so we can distinguish them from the normal IO registers
+ we are interested in here.
+ -->
+ <xsl:template match="//peripherals//address@hidden'data']">
+
+ <!-- remember for later, since we need the group offset later on -->
+ <xsl:variable name="group" select="current()" />
+ <xsl:variable name="registergroup"
+ select="//modules/module/address@hidden/@name-in-module]" />
+
+ <!-- now, iterate over all registers of this group -->
+ <xsl:for-each select="$registergroup/register">
+
+ <!--
+ On Xmega devices, prepend the name of the register-group
+ (aka. subsystem) to the register name, since the register
+ names are not unique across the device.
+
+ On tiny/mega AVR devices, register names are unique across
+ the entire device, so this is not needed/used.
+ -->
+ <xsl:if test="//device/@architecture='AVR8_XMEGA'">
+ <xsl:value-of select="$group/@name" />
+ <xsl:text>_</xsl:text>
+ </xsl:if>
+ <xsl:value-of select="@name" />
+ <xsl:text>	</xsl:text>
+ <xsl:value-of select="$group/@offset" />
+ <xsl:text>	</xsl:text>
+ <xsl:value-of select="@offset" />
+ <xsl:text>	</xsl:text>
+ <xsl:value-of select="@size" />
+ <xsl:text> </xsl:text>
+ </xsl:for-each>
+
+ </xsl:template>
+
+ <xsl:template match="node()">
+ <xsl:apply-templates />
+ </xsl:template>
+
+ <xsl:template match="/">
+ <xsl:apply-templates />
+ </xsl:template>
+
+</xsl:stylesheet>
Property changes on: trunk/avr-libc/devtools/findreg.xsl
___________________________________________________________________
Added: svn:mime-type
+ text/xml
Added: svn:keywords
+ Author Id Date
Added: svn:eol-style
+ native
Added: trunk/avr-libc/devtools/ioreg.pl
===================================================================
--- trunk/avr-libc/devtools/ioreg.pl (rev 0)
+++ trunk/avr-libc/devtools/ioreg.pl 2013-04-25 11:29:43 UTC (rev 2361)
@@ -0,0 +1,387 @@
+#!/usr/bin/perl
+
+#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+# Converter from Atmels Device XML-Files via stylesheet to dwarf-2(!)
+# debug information. This debug information is device specific added
+# to the gcrt1-file
+#
+# Created by Knut Schwichtenberg
+#
+# $Id$
+
+
+# ----------------------------------------------------------------------------
+# "THE BEER-WARE LICENSE" (Revision 42):
+# Knut Schwichtenberg wrote this file. As long as you retain this notice you
+# can do whatever you want with this stuff. If we meet some day, and you think
+# this stuff is worth it, you can buy me a beer in return.
+# ----------------------------------------------------------------------------
+
+########################################################################################
+#
+# Command line parameter
+# -V print version and exit
+# -v be verbose
+# -x path to saxon9
+# -o output file
+#
+# Return values:
+# 0 Okay
+# 1
+
+#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+# Perl modules to be required
+use strict;
+use warnings;
+use Getopt::Std 'getopts';
+my $ContentTmplate;
+my $StaticContent;
+
+#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+# Static part of the DWARF file
+#
+$StaticContent = <<'EOST';
+#include <avr/version.h>
+#define DW_TAG_compile_unit 0x11
+#define DW_TAG_typedef 0x16
+#define DW_TAG_base_type 0x24
+#define DW_TAG_variable 0x34
+
+#define DW_FORM_addr 0x01
+#define DW_FORM_block1 0x0a
+#define DW_FORM_block2 0x03
+#define DW_FORM_block4 0x04
+#define DW_FORM_data1 0x0b
+#define DW_FORM_data2 0x05
+#define DW_FORM_data4 0x06
+#define DW_FORM_data8 0x07
+#define DW_FORM_string 0x08
+#define DW_FORM_flag 0x0c
+#define DW_FORM_strp 0x0e
+#define DW_FORM_ref1 0x11
+#define DW_FORM_ref2 0x12
+#define DW_FORM_ref4 0x13
+#define DW_FORM_ref8 0x14
+
+#define DW_AT_location 0x02
+#define DW_AT_name 0x03
+#define DW_AT_byte_size 0x0b
+#define DW_AT_stmt_list 0x10
+#define DW_AT_language 0x13
+#define DW_AT_producer 0x25
+#define DW_AT_decl_file 0x3a
+#define DW_AT_decl_line 0x3b
+#define DW_AT_encoding 0x3e
+#define DW_AT_external 0x3f
+#define DW_AT_type 0x49
+
+#define DW_LANG_C89 0x0001
+
+#define DW_CHILDREN_no 0x00
+#define DW_CHILDREN_yes 0x01
+
+#define DW_ATE_unsigned 0x7
+#define DW_ATE_unsigned_char 0x8
+
+#define DW_OP_addr 0x03
+.eject
+ .section .debug_abbrev, "", @progbits
+.Ldebug_abbrev0:
+ .section .debug_info, "", @progbits
+ .section .debug_line, "", @progbits
+.Ldebug_line0:
+ .section .debug_str, "", @progbits
+
+ .section .debug_info, "", @progbits
+ ;; compilation unit header
+.Lssinfo:
+ .long .Leinfo - .Lsinfo
+.Lsinfo:
+ .word 2 ; DWARF-2
+ .long .Ldebug_abbrev0
+ .byte 4 ; sizeof(address)
+
+
+ ;; DIE #1: compilation unit
+ .section .debug_info
+ .uleb128 1 ; ref to abbrev 1
+ .section .debug_abbrev
+ .uleb128 1
+ .uleb128 DW_TAG_compile_unit
+ .byte DW_CHILDREN_yes
+
+ .uleb128 DW_AT_producer
+ .uleb128 DW_FORM_strp
+ .section .debug_str
+.Lproducer:
+ .string __AVR_LIBC_VERSION_STRING__
+ .section .debug_info
+ .long .Lproducer
+
+ .section .debug_abbrev
+ .uleb128 DW_AT_stmt_list
+ .uleb128 DW_FORM_data4
+ .section .debug_info
+ .long .Ldebug_line0
+
+ .section .debug_abbrev
+ .uleb128 0
+ .uleb128 0
+
+ ;; DIE #2: base type uint8_t
+ .section .debug_info
+.Luint8_t:
+ .uleb128 2 ; ref to abbrev 3
+ .section .debug_abbrev
+ .uleb128 2
+ .uleb128 DW_TAG_base_type
+ .byte DW_CHILDREN_no
+
+ .uleb128 DW_AT_name
+ .uleb128 DW_FORM_strp
+ .section .debug_str
+.Luint8_t_name:
+ .string "uint8_t"
+ .section .debug_info
+ .long .Luint8_t_name
+
+ .section .debug_abbrev
+ .uleb128 DW_AT_byte_size
+ .uleb128 DW_FORM_data1
+ .section .debug_info
+ .byte 1
+
+ .section .debug_abbrev
+ .uleb128 DW_AT_encoding
+ .uleb128 DW_FORM_data1
+ .section .debug_info
+ .byte DW_ATE_unsigned_char
+
+ .section .debug_abbrev
+ .uleb128 0
+ .uleb128 0
+
+ ;; DIE #3: base type uint16_t
+ .section .debug_info
+.Luint16_t:
+ .uleb128 3 ; ref to abbrev 3
+ .section .debug_abbrev
+ .uleb128 3
+ .uleb128 DW_TAG_base_type
+ .byte DW_CHILDREN_no
+
+ .uleb128 DW_AT_name
+ .uleb128 DW_FORM_strp
+ .section .debug_str
+.Luint16_t_name:
+ .string "uint16_t"
+ .section .debug_info
+ .long .Luint16_t_name
+
+ .section .debug_abbrev
+ .uleb128 DW_AT_byte_size
+ .uleb128 DW_FORM_data1
+ .section .debug_info
+ .byte 2
+
+ .section .debug_abbrev
+ .uleb128 DW_AT_encoding
+ .uleb128 DW_FORM_data1
+ .section .debug_info
+ .byte DW_ATE_unsigned
+
+ .section .debug_abbrev
+ .uleb128 0
+ .uleb128 0
+
+EOST
+
+#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+#
+#
+$ContentTmplate = <<'EODY';
+;- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+ ;; DIE #%No: variable %Reg
+ .section .debug_info
+ .uleb128 %No ; ref to abbrev 4
+ .section .debug_abbrev
+ .uleb128 %No
+ .uleb128 DW_TAG_variable
+ .byte DW_CHILDREN_no
+
+ .uleb128 DW_AT_name
+ .uleb128 DW_FORM_strp
+ .section .debug_str
+.Lname%No:
+ .string "%Reg"
+ .section .debug_info
+ .long .Lname%No
+
+ .section .debug_abbrev
+ .uleb128 DW_AT_decl_file
+ .uleb128 DW_FORM_data1
+ .section .debug_info
+ .byte 0 ; no source file information
+
+ .section .debug_abbrev
+ .uleb128 DW_AT_decl_line
+ .uleb128 DW_FORM_data1
+ .section .debug_info
+ .byte 0 ; no source line information
+
+ .section .debug_abbrev
+ .uleb128 DW_AT_type
+ .uleb128 DW_FORM_ref4
+ .section .debug_info
+ .long .Luint%Si_t - .Lssinfo
+
+ .section .debug_abbrev
+ .uleb128 DW_AT_external
+ .uleb128 DW_FORM_flag
+ .section .debug_info
+ .byte 1
+
+ .section .debug_abbrev
+ .uleb128 DW_AT_location
+ .uleb128 DW_FORM_block1
+ .section .debug_info
+ .byte 5 ; length of block
+ .byte DW_OP_addr
+ .long 0x800000 + %Ba + %Of
+
+ .section .debug_abbrev
+ .uleb128 0
+ .uleb128 0
+
+EODY
+
+
+#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+# trailing part of the dwarf Info
+#
+my $trailer = <<'EOT';
+ ;; trailer
+ .section .debug_abbrev
+ .uleb128 0
+
+ .section .debug_info
+ .uleb128 0
+.Leinfo:
+EOT
+
+
+#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+# All variables need have to be defined -> see "use strict"
+#
+my @allRegister;
+my $staticCmd;
+my $OneRegister;
+my @RegisterParameter;
+my $DIE_No; # Number of the Dwarf-DIE
+my $DynDIE;
+my ( $options, %opts ); # for the command line interpretation
+my $outfile = undef;
+my $XSLPath;
+
+#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+# $Revision is a RCS Key-Word any other revision system will provide another
key-word
+my $VERSION = sprintf("%s",('$Revision: 1.0 $' =~ /(\d*\.\d*[\.\d*]*)/));
+
+sub VERS_MESSAGE(){
+ print STDERR "$0 version: $VERSION Copyright (c) by Knut Schwichtenberg\n";
+ exit(0);
+ die;
+}
+
+sub HELPMESSAGE(){
+ 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 " -x path to saxon9\n";
+ print STDERR " -o output file otherwise STDOUT \n";
+}
+
+#- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+# Handle the command line
+
+#$Getopt::Std::STANDARD_HELP_VERSION=1;
+$options = 'hVvx:c:o:';
+getopts( $options, \%opts );
+if( defined $opts{'h'} ){
+ HELPMESSAGE();
+ exit (0);
+}
+if( defined $opts{'V'} ){
+ VERS_MESSAGE();
+}
+if(! @ARGV ){
+ print "$0: missing file name\n";
+ HELPMESSAGE();
+ exit(-1);
+}
+if( defined $opts{'o'} ){
+ $outfile = $opts{'o'}; #
+ open STDOUT,">$outfile" || die "can't open $_[0]: $!\n";
+}
+if( defined $opts{'x'} ){
+ $XSLPath = $opts{'x'}; #
+} else {
+ $XSLPath = "/usr/share/java/";
+}
+
+# If xsltproc is around, use it. Otherwise, use Saxon9.
+$staticCmd = "java -jar " . $XSLPath . "/saxon9.jar -xsl:findreg.xsl ";
+my $dummy;
+if ($dummy = `xsltproc -V`) {
+ $staticCmd = "xsltproc findreg.xsl ";
+ print STDERR "Using xsltproc for XSL transform\n" if $opts{'v'};
+} else {
+ print STDERR "Using Saxon for XSL transform\n" if $opts{'v'};
+}
+
+#- - - - - - - - - - - - - - - - - - - -
+# Create the static part of the debug information
+my $Filename = "ioreg_static.inc";
+#$StaticContent = do{local $/; open(my $f1, '<', $Filename) or die $!; my
$tmp1 = <$f1>; close $f1 or die $!; $tmp1};
+
+#- - - - - - - - - - - - - - - - - - - -
+# For each IO-register a debug-information template is used. First read the
template
+$Filename = "ioreg_dyn.inc";
+#$ContentTmplate = do{local $/; open(my $f1, '<', $Filename) or die $!; my
$tmp1 = <$f1>; close $f1 or die $!; $tmp1};
+
+#- - - - - - - - - - - - - - - - - - - -
+# Convert via java from XML via XSL into text and put into array
address@hidden = `$staticCmd $ARGV[0]`;
+
+#- - - - - - - - - - - - - - - - - - - -
+# use STDOUT as output file
+#
+$DynDIE=$ContentTmplate;
+print $StaticContent; # Enter constants and DIE 1-3
+
+$DIE_No = 4; # DIEs 1-3 are used by file, uint8_t, uint16_t
+
+#- - - - - - - - - - - - - - - - - - - -
+# Handle each array element (each register) as a DIE
+#
+foreach $OneRegister (@allRegister) {
+ chomp @RegisterParameter;
+ @RegisterParameter = split /\s+/,$OneRegister; # Register, Base, Offset, Size
+
+#- - - - - - - - - - - - - - - - - - - -
+# Replace variables by register values
+#
+ ($DynDIE = $ContentTmplate) =~ s/%Reg/$RegisterParameter[0]/g;
+ $DynDIE =~ s/%No/$DIE_No/g;
+ $RegisterParameter[3] *= 8; # This parameter is 1 -> uint8_t or 2
+ $DynDIE =~ s/%Si/$RegisterParameter[3]/g;
+ $DynDIE =~ s/%Ba/$RegisterParameter[1]/g;
+ $DynDIE =~ s/%Of/$RegisterParameter[2]/g;
+ print $DynDIE;
+ $DIE_No++;
+}
+print $trailer;
+close;
+
+__END__
Property changes on: trunk/avr-libc/devtools/ioreg.pl
___________________________________________________________________
Added: svn:executable
+ *
Added: svn:mime-type
+ text/plain
Added: svn:keywords
+ Author Id Date
Added: svn:eol-style
+ native
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [avr-libc-commit] [2361] Add some basic infrastructure to generate auxiliary debugging information,
Joerg Wunsch <=