mirror of
				https://github.com/0xFEEDC0DE64/arduino-esp32.git
				synced 2025-10-31 22:21:39 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			190 lines
		
	
	
		
			6.6 KiB
		
	
	
	
		
			C
		
	
	
		
			Executable File
		
	
	
	
	
			
		
		
	
	
			190 lines
		
	
	
		
			6.6 KiB
		
	
	
	
		
			C
		
	
	
		
			Executable File
		
	
	
	
	
| /*
 | |
|  *  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 */
 |