hal_diag.h File Reference

---

Detailed Description

HAL Support for Kernel Diagnostic Routines.

Author:

yoshinori sato, Uwe Kindler

Date:

2003-12-06

Diagnostic routines for use during kernel development.

Usage: #include <cyg/hal/hal_diag.h>

Definition in file hal_diag.h.

Go to the source code of this file.

Functions
externC void	hal_plf_diag_init (void)
	Initializes diagnostic channels (Virtual Vectors not present).
externC void	hal_diag_read_char (char *c)
	Read character from diagnostic device.
externC void	hal_diag_write_char (char c)
	Write char to diagnostic device.
externC int	hal_diag_put_buf (const char *pbuf_in, int len_in)
	Outputs a buffer of len_in bytes via diagnostic device.
externC void	hal_diag_put_string (unsigned char *pstr_in)
	Sends zero terminated string through diagnostic device.
externC void	hal_diag_put_long (unsigned long l_in)
	Send long value through diagnostic serial channel.
externC void	hal_diag_put_long_hex (long l_in)
	Converts long into hex string and sends it through diagnostic device.

---

Function Documentation

externC int hal_diag_put_buf (  const char *  pbuf_in, int  len_in )

Outputs a buffer of len_in bytes via diagnostic device. Parameters: pbuf_in  Points to buffer with date to be sent len_in  Number of bytes to be sent Returns: A simple checksum. Definition at line 209 of file hal_diag.c. References hal_diag_write_char(). Referenced by hal_diag_put_long_hex(). { unsigned char sum; sum = 0; while (len_in--) { sum += *(unsigned char*)pbuf_in; hal_diag_write_char(*pbuf_in++); } return sum; }

Here is the call graph for this function:

externC void hal_diag_put_long (  unsigned long  l_in  )

Send long value through diagnostic serial channel. Converts long number into a number string and sends it through serial channel. Parameters: l_in  Long number to be send Definition at line 250 of file hal_diag.c. References hal_diag_write_char(). { unsigned char charbuf[10]; unsigned char i; // // A zero value is a special case - we send zero char and leave // if (l_in == 0) { hal_diag_write_char('0'); return; } // // Here we calculate the entries for the char buffer. We start with // the least significant number and devide by 10 until l_in = zero. // An ASCII offset is added to get a char from a numeric value. // i = 9; while (l_in > 0) { charbuf[i] = (l_in % 10) + '0'; i--; l_in = l_in / 10; } // // This part sends the content of the charbuffer out through serial // interface // i++; while (i < 10) { hal_diag_write_char(charbuf[i]); i++; } }

Here is the call graph for this function:

externC void hal_diag_put_long_hex (  long  l_in  )

Converts long into hex string and sends it through diagnostic device. Parameters: l_in  Long number to be sent Definition at line 356 of file hal_diag.c. References hal_diag_put_buf(), and hal_long_to_hexbuf(). { unsigned char hexbuf[10] = "0x"; unsigned char len = 2; len += hal_long_to_hexbuf(l_in, &hexbuf[2]); hal_diag_put_buf(hexbuf, len); }

Here is the call graph for this function:

externC void hal_diag_put_string (  unsigned char *  pstr_in  )

Sends zero terminated string through diagnostic device. Parameters: pstr_in  Pointer to zero terminated string Definition at line 232 of file hal_diag.c. References hal_diag_write_char(). { while (*pstr_in != '\0') // repeat until detection of terminating zero { hal_diag_write_char(*pstr_in++); } }

Here is the call graph for this function:

externC void hal_diag_read_char (  char *  c  )

Read character from diagnostic device. If we do not use virtual vector comm channels then we have to use this function. Parameters: c  Stores received character Definition at line 193 of file hal_diag.c. References hal_sci_getc(), and pchannel. { *c = (char) hal_sci_getc((void *)pchannel); }

Here is the call graph for this function:

externC void hal_diag_write_char (  char  c  )

Write char to diagnostic device. If we do not use virtual vector comm channels then we have to use this function. Parameters: c  Char to be written to diagostic device Definition at line 178 of file hal_diag.c. References hal_sci_putc(), and pchannel. Referenced by hal_diag_put_buf(), hal_diag_put_long(), and hal_diag_put_string(). { hal_sci_putc((void *)pchannel, c); }

Here is the call graph for this function:

externC void hal_plf_diag_init (  void   )

Initializes diagnostic channels (Virtual Vectors not present). If we do not use virtual vector comm channels then we have to initialize the hardwired debug channel manual. We use the common diagnostic code provided by H8S architecture HAL Definition at line 166 of file plf_diag.c. References channel, and hal_diag_init(). { hal_diag_init(&channel); }

Here is the call graph for this function:

---