diff packages/infra/current/src/diag.c @ 0:3111d98ba7b3 ecos-v1_1-release

Initial commit of eCos version 1.1
author jlarmour
date Tue, 11 May 1999 11:16:07 +0000
parents
children
line wrap: on
line diff
new file mode 100644
--- /dev/null
+++ b/packages/infra/current/src/diag.c
@@ -0,0 +1,431 @@
+/*========================================================================
+//
+//	diag.c
+//
+//	Infrastructure diagnostic output code
+//
+//========================================================================
+//####COPYRIGHTBEGIN####
+//
+// -------------------------------------------
+// The contents of this file are subject to the Cygnus eCos Public License
+// Version 1.0 (the "License"); you may not use this file except in
+// compliance with the License.  You may obtain a copy of the License at
+// http://sourceware.cygnus.com/ecos
+// 
+// Software distributed under the License is distributed on an "AS IS"
+// basis, WITHOUT WARRANTY OF ANY KIND, either express or implied.  See the
+// License for the specific language governing rights and limitations under
+// the License.
+// 
+// The Original Code is eCos - Embedded Cygnus Operating System, released
+// September 30, 1998.
+// 
+// The Initial Developer of the Original Code is Cygnus.  Portions created
+// by Cygnus are Copyright (C) 1998 Cygnus Solutions.  All Rights Reserved.
+// -------------------------------------------
+//
+//####COPYRIGHTEND####
+//========================================================================
+//#####DESCRIPTIONBEGIN####
+//
+// Author(s): 	nickg
+// Contributors:	nickg
+// Date:	1998-03-02
+// Purpose:     Infrastructure diagnostic output
+// Description:	Implementations of infrastructure diagnostic routines.
+//
+//####DESCRIPTIONEND####
+//
+//======================================================================*/
+
+#include <pkgconf/system.h>
+#include <pkgconf/hal.h>
+#include <pkgconf/infra.h>
+
+#include <cyg/infra/cyg_type.h>         // base types
+
+#include <cyg/infra/diag.h>             // HAL polled output
+#include <cyg/hal/hal_arch.h>           // architectural stuff for...
+#include <cyg/hal/hal_intr.h>           // interrupt control
+#include <cyg/hal/hal_diag.h>           // diagnostic output routines
+
+#ifdef CYGDBG_INFRA_DIAG_PRINTF_USE_VARARG
+
+#include <stdarg.h>
+
+#endif
+
+
+
+/*----------------------------------------------------------------------*/
+
+void diag_write_num(
+    cyg_uint32  n,              /* number to write              */
+    cyg_ucount8 base,           /* radix to write to            */
+    cyg_ucount8 sign,           /* sign, '-' if -ve, '+' if +ve */
+    cyg_bool    pfzero,         /* prefix with zero ?           */
+    cyg_ucount8 width           /* min width of number          */
+    );
+
+#ifdef CYGDBG_INFRA_DIAG_USE_DEVICE
+
+// this is not properly supported; in particular, there is no properly
+// defined API (extern definition) for the diag_device routines used below.
+
+/*----------------------------------------------------------------------*/
+/* Initialize, call before any others                                   */
+
+externC void diag_init()
+{
+}
+
+/*----------------------------------------------------------------------*/
+/* Write single char to output                                          */
+
+externC void diag_write_char(char c)
+{
+    diag_device_write_char(c);
+}
+
+#else
+
+/*----------------------------------------------------------------------*/
+/* Initialize, call before any others                                   */
+
+externC void diag_init(void)
+{
+    HAL_DIAG_INIT();
+}
+
+/*----------------------------------------------------------------------*/
+/* Write single char to output                                          */
+
+#define PREFIX()
+//#define PREFIX() HAL_DIAG_WRITE_CHAR(0x0F)
+
+externC void diag_write_char(char c)
+{    
+    /* Translate LF into CRLF */
+    
+    if( c == '\n' )
+    {
+        PREFIX();
+        HAL_DIAG_WRITE_CHAR('\r');        
+    }
+
+    PREFIX();
+    HAL_DIAG_WRITE_CHAR(c);
+}
+#endif
+
+/*----------------------------------------------------------------------*/
+/* Write zero terminated string                                         */
+  
+externC void diag_write_string(char *psz)
+{
+    while( *psz ) diag_write_char( *psz++ );
+}
+
+/*----------------------------------------------------------------------*/
+/* Write decimal value                                                  */
+
+externC void diag_write_dec( cyg_int32 n)
+{
+    cyg_ucount8 sign;
+
+    if( n < 0 ) n = -n, sign = '-';
+    else sign = '+';
+    
+    diag_write_num( n, 10, sign, false, 0);
+}
+
+/*----------------------------------------------------------------------*/
+/* Write hexadecimal value                                              */
+
+externC void diag_write_hex( cyg_uint32 n)
+{
+    diag_write_num( n, 16, '+', false, 0);
+}    
+
+/*----------------------------------------------------------------------*/
+/* Generic number writing function                                      */
+/* The parameters determine what radix is used, the signed-ness of the  */
+/* number, its minimum width and whether it is zero or space filled on  */
+/* the left.                                                            */
+
+void diag_write_num(
+    cyg_uint32  n,              /* number to write              */
+    cyg_ucount8 base,           /* radix to write to            */
+    cyg_ucount8 sign,           /* sign, '-' if -ve, '+' if +ve */
+    cyg_bool    pfzero,         /* prefix with zero ?           */
+    cyg_ucount8 width           /* min width of number          */
+    )
+{
+    char buf[16];
+    cyg_count8 bpos;
+    char bufinit = pfzero?'0':' ';
+    char *digits = "0123456789ABCDEF";
+
+    /* init buffer to padding char: space or zero */
+    for( bpos = 0; bpos < (cyg_count8)sizeof(buf); bpos++ ) buf[bpos] = bufinit;
+
+    /* Set pos to start */
+    bpos = 0;
+
+    /* construct digits into buffer in reverse order */
+    if( n == 0 ) buf[bpos++] = '0';
+    else while( n != 0 )
+    {
+        cyg_ucount8 d = n % base;
+        buf[bpos++] = digits[d];
+        n /= base;
+    }
+
+    /* set pos to width if less. */
+    if( (cyg_count8)width > bpos ) bpos = width;
+
+    /* set sign if negative. */
+    if( sign == '-' )
+    {
+        if( buf[bpos-1] == bufinit ) bpos--;
+        buf[bpos] = sign;
+    }
+    else bpos--;
+
+    /* Now write it out in correct order. */
+    while( bpos >= 0 )
+        diag_write_char(buf[bpos--]);
+}
+
+/*----------------------------------------------------------------------*/
+/* perform some simple sanity checks on a string to ensure that it      */
+/* consists of printable characters and is of reasonable length.        */
+
+static cyg_bool diag_check_string( char *str )
+{
+    cyg_bool result = true;
+    char *s;
+
+    if( str == NULL ) return false;
+    
+    for( s = str ; result && *s ; s++ )
+    {
+        char c = *s;
+
+        /* Check for a reasonable length string. */
+        
+        if( s-str > 256 ) result = false;
+
+        /* We only really support CR and NL at present. If we want to
+         * use tabs or other special chars, this test will have to be
+         * expanded.
+         */
+        
+        if( c == '\n' || c == '\r' )
+            continue;
+
+        /* Check for printable chars. This assumes ASCII */
+        
+        if( c < ' ' || c > '~' )
+            result = false;
+
+    }
+
+    return result;
+}
+
+/*----------------------------------------------------------------------*/
+
+externC void diag_vprintf( char *fmt, CYG_ADDRWORD *args)
+{
+    if( !diag_check_string(fmt) )
+    {
+        int i;
+        diag_write_string("<Bad format string: ");
+        diag_write_hex((cyg_uint32)fmt);
+        diag_write_string(" :");
+        for( i = 0; i < 8; i++ )
+        {
+            diag_write_char(' ');
+            diag_write_hex(args[i]);
+        }
+        diag_write_string(">\n");
+        return;
+    }
+    
+    while( *fmt != '\0' )
+    {
+        char c = *fmt;
+
+        if( c != '%' ) diag_write_char( c );
+        else
+        {
+            cyg_bool pfzero = false;
+            cyg_count8 width = 0;
+            char sign = '+';
+			
+            c = *++fmt;
+			
+            if( c == '0' ) pfzero = true;
+
+            while( '0' <= c && c <= '9' )
+            {
+                width = width*10 + c - '0';
+                c = *++fmt;
+            }
+
+            switch( c )
+            {
+            case 'd':
+            case 'D':
+            {
+                long val = (long)(*args++);
+                if( val < 0 ) val = -val, sign = '-';
+                diag_write_num(val, 10, sign, pfzero, width);
+                break;
+            }
+
+            case 'x':
+            case 'X':
+            {
+                unsigned long val = (long)(*args++);
+                diag_write_num(val, 16, sign, pfzero, width);
+                break;
+            }
+
+            case 'c':
+            case 'C':
+            {
+                char ch = (char)(*args++);
+                diag_write_char(ch);
+                break;
+            }
+
+            case 's':
+            case 'S':
+            {
+                char *s = (char *)(*args++);
+                cyg_count32 len = 0;
+                cyg_count32 pre = 0, post = 0;
+
+                if( s == NULL ) s = "<null>";
+                else if( !diag_check_string(s) )
+                {
+                    diag_write_string("<Not a string: 0x");
+                    diag_write_hex((cyg_uint32)s);
+                    s = ">";
+                    if( width > 25 ) width -= 25;
+                    pfzero = false;
+                    /* Drop through to print the closing ">" */
+                    /* and pad to the required length.       */
+                }
+                
+                while( s[len] != 0 ) len++;
+                
+                if( width && len > width ) len = width;
+
+                if( pfzero ) pre = width-len;
+                else post = width-len;
+
+                while( pre-- > 0 ) diag_write_char(' ');
+
+                while( *s != '\0' && len-- != 0)
+                    diag_write_char(*s++);
+
+                while( post-- > 0 ) diag_write_char(' ');
+				
+                break;
+            }
+
+            case 'b':
+            case 'B':
+            {
+                unsigned long val = (unsigned long)(*args++);
+                cyg_uint32 i;
+                if( width == 0 ) width = 32;
+
+                for( i = width-1; i >= 0; i-- )
+                    diag_write_char( (val&(1<<i))?'1':'.' );
+				
+                break;
+            }
+
+            default:
+                diag_write_char('%');
+                diag_write_char(c);
+                break;
+            }
+        }
+
+        fmt++;
+    }	
+    
+}
+
+/*-----------------------------------------------------------------------*/
+/* Formatted diagnostic output.                                          */
+
+#ifdef CYGDBG_INFRA_DIAG_PRINTF_USE_VARARG
+
+externC void diag_printf(char *fmt, ... )
+{
+    
+    CYG_ADDRWORD args[8];
+
+    va_list a;
+
+    va_start(a, fmt);
+
+    /* Move all of the arguments into simple scalars. This avoids
+     * having to use varargs to define diag_vprintf().
+     */
+    
+    args[0] = va_arg(a,CYG_ADDRWORD);
+    args[1] = va_arg(a,CYG_ADDRWORD);
+    args[2] = va_arg(a,CYG_ADDRWORD);
+    args[3] = va_arg(a,CYG_ADDRWORD);
+    args[4] = va_arg(a,CYG_ADDRWORD);
+    args[5] = va_arg(a,CYG_ADDRWORD);
+    args[6] = va_arg(a,CYG_ADDRWORD);
+    args[7] = va_arg(a,CYG_ADDRWORD);
+
+    va_end(a);
+    
+    diag_vprintf( fmt, args);
+}
+
+#else
+
+/* The prototype for diag_printf in diag.h is defined using K&R syntax   */
+/* to allow us to use a variable number of arguments in the call without */
+/* using ellipses, which would require use of varargs stuff. If we ever  */
+/* need to support arguments that are not simple words, we may need to   */
+/* use varargs.                                                          */
+/* For the actual implementation, a normal ANSI C prototype is           */
+/* acceptable.                                                            */
+
+externC void diag_printf(char *fmt, CYG_ADDRWORD a1, CYG_ADDRWORD a2,
+                         CYG_ADDRWORD a3, CYG_ADDRWORD a4,
+                         CYG_ADDRWORD a5, CYG_ADDRWORD a6,
+                         CYG_ADDRWORD a7, CYG_ADDRWORD a8)
+{
+    
+    CYG_ADDRWORD args[8];
+
+    args[0] = a1;
+    args[1] = a2;
+    args[2] = a3;
+    args[3] = a4;
+    args[4] = a5;
+    args[5] = a6;
+    args[6] = a7;
+    args[7] = a8;
+    
+    diag_vprintf( fmt, args);
+}
+
+#endif
+
+/*-----------------------------------------------------------------------*/
+/* EOF trace/diag.c */