190 lines
6.6 KiB
C
190 lines
6.6 KiB
C
/*
|
|
* simcall.h - Simulator call numbers
|
|
*
|
|
* Software that runs on a simulated Xtensa processor using
|
|
* the instruction set simulator (ISS) can invoke simulator
|
|
* services using the SIMCALL instruction. The a2 register
|
|
* is set prior to executing SIMCALL to a "simcall number",
|
|
* indicating which service to invoke. This file defines the
|
|
* simcall numbers defined and/or supported by the Xtensa ISS.
|
|
*
|
|
* IMPORTANT NOTE: These numbers are highly subject to change!
|
|
*
|
|
* Copyright (c) 2002-2007 by Tensilica Inc. ALL RIGHTS RESERVED.
|
|
* These coded instructions, statements, and computer programs are the
|
|
* copyrighted works and confidential proprietary information of Tensilica Inc.
|
|
* They may not be modified, copied, reproduced, distributed, or disclosed to
|
|
* third parties in any manner, medium, or form, in whole or in part, without
|
|
* the prior written consent of Tensilica Inc.
|
|
*/
|
|
|
|
#ifndef SIMCALL_INCLUDED
|
|
#define SIMCALL_INCLUDED
|
|
|
|
/*
|
|
* System call like services offered by the simulator host.
|
|
* These are modeled after the Linux 2.4 kernel system calls
|
|
* for Xtensa processors. However not all system calls and
|
|
* not all functionality of a given system call are implemented,
|
|
* or necessarily have well defined or equivalent semantics in
|
|
* the context of a simulation (as opposed to a Unix kernel).
|
|
*
|
|
* These services behave largely as if they had been invoked
|
|
* as a task in the simulator host's operating system
|
|
* (eg. files accessed are those of the simulator host).
|
|
* However, these SIMCALLs model a virtual operating system
|
|
* so that various definitions, bit assignments etc
|
|
* (eg. open mode bits, errno values, etc) are independent
|
|
* of the host operating system used to run the simulation.
|
|
* Rather these definitions are specific to the Xtensa ISS.
|
|
* This way Xtensa ISA code written to use these SIMCALLs
|
|
* can (in principle) be simulated on any host.
|
|
*
|
|
* Up to 6 parameters are passed in registers a3 to a8
|
|
* (note the 6th parameter isn't passed on the stack,
|
|
* unlike windowed function calling conventions).
|
|
* The return value is in a2. A negative value in the
|
|
* range -4096 to -1 indicates a negated error code to be
|
|
* reported in errno with a return value of -1, otherwise
|
|
* the value in a2 is returned as is.
|
|
*/
|
|
|
|
/* These #defines need to match what's in Xtensa/OS/vxworks/xtiss/simcalls.c */
|
|
|
|
#define SYS_nop 0 /* n/a - setup; used to flush register windows */
|
|
#define SYS_exit 1 /*x*/
|
|
#define SYS_fork 2
|
|
#define SYS_read 3 /*x*/
|
|
#define SYS_write 4 /*x*/
|
|
#define SYS_open 5 /*x*/
|
|
#define SYS_close 6 /*x*/
|
|
#define SYS_rename 7 /*x 38 - waitpid */
|
|
#define SYS_creat 8 /*x*/
|
|
#define SYS_link 9 /*x (not implemented on WIN32) */
|
|
#define SYS_unlink 10 /*x*/
|
|
#define SYS_execv 11 /* n/a - execve */
|
|
#define SYS_execve 12 /* 11 - chdir */
|
|
#define SYS_pipe 13 /* 42 - time */
|
|
#define SYS_stat 14 /* 106 - mknod */
|
|
#define SYS_chmod 15
|
|
#define SYS_chown 16 /* 202 - lchown */
|
|
#define SYS_utime 17 /* 30 - break */
|
|
#define SYS_wait 18 /* n/a - oldstat */
|
|
#define SYS_lseek 19 /*x*/
|
|
#define SYS_getpid 20
|
|
#define SYS_isatty 21 /* n/a - mount */
|
|
#define SYS_fstat 22 /* 108 - oldumount */
|
|
#define SYS_time 23 /* 13 - setuid */
|
|
#define SYS_gettimeofday 24 /*x 78 - getuid (not implemented on WIN32) */
|
|
#define SYS_times 25 /*X 43 - stime (Xtensa-specific implementation) */
|
|
#define SYS_socket 26
|
|
#define SYS_sendto 27
|
|
#define SYS_recvfrom 28
|
|
#define SYS_select_one 29 /* not compitible select, one file descriptor at the time */
|
|
#define SYS_bind 30
|
|
#define SYS_ioctl 31
|
|
|
|
/*
|
|
* Other...
|
|
*/
|
|
#define SYS_iss_argc 1000 /* returns value of argc */
|
|
#define SYS_iss_argv_size 1001 /* bytes needed for argv & arg strings */
|
|
#define SYS_iss_set_argv 1002 /* saves argv & arg strings at given addr */
|
|
|
|
#define SYS_memset 1004 /* fill a range of memory (fast) */
|
|
|
|
/*
|
|
* SIMCALLs for the ferret memory debugger. All are invoked by
|
|
* libferret.a ... ( Xtensa/Target-Libs/ferret )
|
|
*/
|
|
#define SYS_ferret 1010
|
|
#define SYS_malloc 1011
|
|
#define SYS_free 1012
|
|
#define SYS_more_heap 1013
|
|
#define SYS_no_heap 1014
|
|
#define SYS_enter_ferret 1015
|
|
#define SYS_leave_ferret 1016
|
|
|
|
/*
|
|
* SIMCALLs for ISS client commands
|
|
*/
|
|
#define SYS_profile_enable 1020
|
|
#define SYS_profile_disable 1021
|
|
#define SYS_trace_level 1022
|
|
#define SYS_client_command 1023
|
|
|
|
/*
|
|
* SIMCALL for simulation mode switching
|
|
*/
|
|
#define SYS_sim_mode_switch 1030
|
|
|
|
/*
|
|
* SIMCALLs for XTMP/XTSC event notify and core stall
|
|
*/
|
|
#define SYS_event_fire 1040
|
|
#define SYS_event_stall 1041
|
|
|
|
/*
|
|
* SIMCALLs for callbacks registered in XTMP/XTSC
|
|
*/
|
|
#define SYS_callback_first 100
|
|
#define SYS_callback_last 999
|
|
|
|
/*
|
|
* User defined simcall
|
|
*/
|
|
#define SYS_user_simcall 100
|
|
|
|
#define SYS_xmpa_errinfo 200
|
|
#define SYS_xmpa_proc_status 201
|
|
#define SYS_xmpa_proc_start 202
|
|
#define SYS_xmpa_proc_stop 203
|
|
#define SYS_xmpa_proc_mem_read 204
|
|
#define SYS_xmpa_proc_mem_write 205
|
|
#define SYS_xmpa_proc_mem_fill 206
|
|
#define SYS_xmpa_proc_reg_read 207
|
|
#define SYS_xmpa_proc_reg_write 208
|
|
|
|
|
|
/*
|
|
* Extra SIMCALLs for GDB:
|
|
*/
|
|
#define SYS_gdb_break -1 /* invoked by XTOS on user exceptions if EPC points
|
|
to a break.n/break, regardless of cause! */
|
|
#define SYS_xmon_out -2 /* invoked by XMON: ... */
|
|
#define SYS_xmon_in -3 /* invoked by XMON: ... */
|
|
#define SYS_xmon_flush -4 /* invoked by XMON: ... */
|
|
#define SYS_gdb_abort -5 /* invoked by XTOS in _xtos_panic() */
|
|
#define SYS_gdb_illegal_inst -6 /* invoked by XTOS for illegal instructions (too deeply) */
|
|
#define SYS_xmon_init -7 /* invoked by XMON: ... */
|
|
#define SYS_gdb_enter_sktloop -8 /* invoked by XTOS on debug exceptions */
|
|
#define SYS_unhandled_kernel_exc -9 /* invoked by XTOS for unhandled kernel exceptions */
|
|
#define SYS_unhandled_user_exc -10 /* invoked by XTOS for unhandled user exceptions */
|
|
#define SYS_unhandled_double_exc -11 /* invoked by XTOS for unhandled double exceptions */
|
|
#define SYS_unhandled_highpri_interrupt -12 /* invoked by XTOS for unhandled high-priority interrupts */
|
|
#define SYS_xmon_close -13 /* invoked by XMON: ... */
|
|
|
|
/*
|
|
* SIMCALLs for vxWorks xtiss BSP:
|
|
*/
|
|
#define SYS_setup_ppp_pipes -83
|
|
#define SYS_log_msg -84
|
|
|
|
/*
|
|
* SYS_select_one specifiers
|
|
*/
|
|
#define XTISS_SELECT_ONE_READ 1
|
|
#define XTISS_SELECT_ONE_WRITE 2
|
|
#define XTISS_SELECT_ONE_EXCEPT 3
|
|
|
|
/*
|
|
* SIMCALL for client calling arbitrary code in a client plug in.
|
|
* see clients/xcc_instr to see how this works.
|
|
*/
|
|
|
|
#define SYS_client 0xC0DECAFE
|
|
|
|
|
|
|
|
#endif /* !SIMCALL_INCLUDED */
|