Macros
#define	AngelSWI AngelSWI_ARM

#define	AngelSWI_ARM 0x123456

#define	AngelSWIAsm swi

#define	AngelSWIInsn "swi"

Enumerations
enum	OperationNumber { SEMIHOSTING_EnterSVC = 0x17 , SEMIHOSTING_ReportException = 0x18 , SEMIHOSTING_SYS_CLOSE = 0x02 , SEMIHOSTING_SYS_CLOCK = 0x10 , SEMIHOSTING_SYS_ELAPSED = 0x30 , SEMIHOSTING_SYS_ERRNO = 0x13 , SEMIHOSTING_SYS_FLEN = 0x0C , SEMIHOSTING_SYS_GET_CMDLINE = 0x15 , SEMIHOSTING_SYS_HEAPINFO = 0x16 , SEMIHOSTING_SYS_ISERROR = 0x08 , SEMIHOSTING_SYS_ISTTY = 0x09 , SEMIHOSTING_SYS_OPEN = 0x01 , SEMIHOSTING_SYS_READ = 0x06 , SEMIHOSTING_SYS_READC = 0x07 , SEMIHOSTING_SYS_REMOVE = 0x0E , SEMIHOSTING_SYS_RENAME = 0x0F , SEMIHOSTING_SYS_SEEK = 0x0A , SEMIHOSTING_SYS_SYSTEM = 0x12 , SEMIHOSTING_SYS_TICKFREQ = 0x31 , SEMIHOSTING_SYS_TIME = 0x11 , SEMIHOSTING_SYS_TMPNAM = 0x0D , SEMIHOSTING_SYS_WRITE = 0x05 , SEMIHOSTING_SYS_WRITEC = 0x03 , SEMIHOSTING_SYS_WRITE0 = 0x04 , ADP_Stopped_ApplicationExit = ((2 << 16) + 38) , ADP_Stopped_RunTimeError = ((2 << 16) + 35) }

Functions
static int	call_host (int reason, void *arg)

static void	report_exception (int reason)

Macro Definition Documentation

◆ AngelSWI

#define AngelSWI AngelSWI_ARM

Definition at line 72 of file semihosting.h.

◆ AngelSWI_ARM

#define AngelSWI_ARM 0x123456

Definition at line 68 of file semihosting.h.

◆ AngelSWIAsm

#define AngelSWIAsm swi

Definition at line 81 of file semihosting.h.

◆ AngelSWIInsn

#define AngelSWIInsn "swi"

Definition at line 80 of file semihosting.h.

Enumeration Type Documentation

◆ OperationNumber

enum OperationNumber

Enumerator
SEMIHOSTING_EnterSVC
SEMIHOSTING_ReportException
SEMIHOSTING_SYS_CLOSE
SEMIHOSTING_SYS_CLOCK
SEMIHOSTING_SYS_ELAPSED
SEMIHOSTING_SYS_ERRNO
SEMIHOSTING_SYS_FLEN
SEMIHOSTING_SYS_GET_CMDLINE
SEMIHOSTING_SYS_HEAPINFO
SEMIHOSTING_SYS_ISERROR
SEMIHOSTING_SYS_ISTTY
SEMIHOSTING_SYS_OPEN
SEMIHOSTING_SYS_READ
SEMIHOSTING_SYS_READC
SEMIHOSTING_SYS_REMOVE
SEMIHOSTING_SYS_RENAME
SEMIHOSTING_SYS_SEEK
SEMIHOSTING_SYS_SYSTEM
SEMIHOSTING_SYS_TICKFREQ
SEMIHOSTING_SYS_TIME
SEMIHOSTING_SYS_TMPNAM
SEMIHOSTING_SYS_WRITE
SEMIHOSTING_SYS_WRITEC
SEMIHOSTING_SYS_WRITE0
ADP_Stopped_ApplicationExit
ADP_Stopped_RunTimeError

Definition at line 31 of file semihosting.h.

  {
    // Regular operations
    SEMIHOSTING_EnterSVC = 0x17,
    SEMIHOSTING_ReportException = 0x18,
    SEMIHOSTING_SYS_CLOSE = 0x02,
    SEMIHOSTING_SYS_CLOCK = 0x10,
    SEMIHOSTING_SYS_ELAPSED = 0x30,
    SEMIHOSTING_SYS_ERRNO = 0x13,
    SEMIHOSTING_SYS_FLEN = 0x0C,
    SEMIHOSTING_SYS_GET_CMDLINE = 0x15,
    SEMIHOSTING_SYS_HEAPINFO = 0x16,
    SEMIHOSTING_SYS_ISERROR = 0x08,
    SEMIHOSTING_SYS_ISTTY = 0x09,
    SEMIHOSTING_SYS_OPEN = 0x01,
    SEMIHOSTING_SYS_READ = 0x06,
    SEMIHOSTING_SYS_READC = 0x07,
    SEMIHOSTING_SYS_REMOVE = 0x0E,
    SEMIHOSTING_SYS_RENAME = 0x0F,
    SEMIHOSTING_SYS_SEEK = 0x0A,
    SEMIHOSTING_SYS_SYSTEM = 0x12,
    SEMIHOSTING_SYS_TICKFREQ = 0x31,
    SEMIHOSTING_SYS_TIME = 0x11,
    SEMIHOSTING_SYS_TMPNAM = 0x0D,
    SEMIHOSTING_SYS_WRITE = 0x05,
    SEMIHOSTING_SYS_WRITEC = 0x03,
    SEMIHOSTING_SYS_WRITE0 = 0x04,
 
    // Codes returned by SEMIHOSTING_ReportException
    ADP_Stopped_ApplicationExit = ((2 << 16) + 38),
    ADP_Stopped_RunTimeError = ((2 << 16) + 35),
 
  };

Function Documentation

◆ call_host()

static int call_host	(	int	reason,
		void *	arg
	)

inlinestatic

Definition at line 97 of file semihosting.h.

  {
    int value;
    __asm__ volatile (
 
        " mov r0, %[rsn]  \n"
        " mov r1, %[arg]  \n"
#if defined(OS_DEBUG_SEMIHOSTING_FAULTS)
        " " AngelSWITestFault " \n"
#else
      " " AngelSWIInsn " %[swi] \n"
#endif
        " mov %[val], r0"
 
        : [val] "=r"(value) /* Outputs */
        : [rsn] "r"(reason), [arg] "r"(arg), [swi] "i"(AngelSWI) /* Inputs */
        : "r0", "r1", "r2", "r3", "ip", "lr", "memory", "cc"
        // Clobbers r0 and r1, and lr if in supervisor mode
    );
 
    // Accordingly to page 13-77 of ARM DUI 0040D other registers
    // can also be clobbered. Some memory positions may also be
    // changed by a system call, so they should not be kept in
    // registers. Note: we are assuming the manual is right and
    // Angel is respecting the APCS.
    return value;
  }

References AngelSWI, and AngelSWIInsn.

Referenced by report_exception().

◆ report_exception()

static void report_exception ( int reason )

inlinestatic

Definition at line 131 of file semihosting.h.

  {
    call_host (SEMIHOSTING_ReportException, (void*)reason);
 
    for (;;)
      ;
  }

References call_host(), and SEMIHOSTING_ReportException.

Macros

Enumerations

Functions