Subversion Repositories adv_debug_sys

#ifndef _HARDWARE_MONITOR_H_

#define _HARDWARE_MONITOR_H_

/* Communication between servers (such as the RSP server) and the target

 * monitor is done via 2 pipes, created using pipe().  One pipe, pipe_fds[0],

 * is used by the server to command the target monitor thread to stall or

 * unstall the CPU.  This is done by sending single-letter commands; sending "S"

 * commands the monitor thread to stall the CPU, sending "U" commands the monitor

 * to unstall the CPU.

 *

 * Feedback is sent back to servers using pipe_fds[1]. When the CPU transitions

 * from the stalled state to the run state, an "R" is sent to all registered

 * servers.  When the CPU goes from running to stopped, an "H" is sent to indicate

 * the halt state.

 */

/* This should be called once at initialization */

int start_monitor_thread(void);

/* This is called to create a  pair of shared pipes with the monitor thread.

 * The pipes should NOT have already been created before calling this function,

 * but the pipe_fds array must be already allocated.  pipe_fds[0] is for

 * communicating server->monitor, pipe_fds[1] is for monitor->server.

 */

int register_with_monitor_thread(int pipe_fds[2]);

/* Un-share a set of pipes with the monitor.  The pipes may be closed

 * after this call returns.

 */

void unregister_with_monitor_thread(int pipe_fds[2]);

#endif