nuttx/arch/sim/Kconfig

#
# For a description of the syntax of this configuration file,
# see the file kconfig-language.txt in the NuttX tools repository.
#

if ARCH_SIM
comment "Simulation Configuration Options"

choice
	prompt "Host CPU Type"
	default HOST_X86_64

config HOST_X86_64
	bool "x86_64"
	select ARCH_HAVE_STACKCHECK
	select LIBC_ARCH_ELF_64BIT if LIBC_ARCH_ELF && !SIM_M32
	select ARCH_HAVE_MATH_H
	select ARCH_TOOLCHAIN_GNU

config HOST_X86
	bool "x86"
	select ARCH_HAVE_STACKCHECK
	select ARCH_TOOLCHAIN_GNU

config HOST_ARM
	bool "arm"
	select ARCH_HAVE_STACKCHECK
	select ARCH_TOOLCHAIN_GNU

config HOST_ARM64
	bool "arm64"
	select ARCH_HAVE_STACKCHECK
	select ARCH_TOOLCHAIN_GNU

endchoice # Host CPU Type

config ARCH_CHIP
	string
	default "sim"

config SIM_M32
	bool "Build 32-bit simulation on 64-bit machine"
	default n
	depends on HOST_X86_64
	---help---
		Simulation context switching is based on logic like setjmp and longjmp.  This
		context switching is only available for 32-bit targets.  On 64-bit machines,
		this context switching will fail.

		The workaround on 64-bit machines for now is to build for a 32-bit target on the
		64-bit machine.  The workaround for this issue has been included in NuttX 6.15 and
		beyond.  For those versions, you must add SIM_M32=y to the .config file in
		order to enable building a 32-bit image on a 64-bit platform.

config SIM_CYGWIN_DECORATED
	bool "Decorated Cygwin names"
	default n
	depends on WINDOWS_CYGWIN
	---help---
		Older versions of Cygwin tools decorated C symbol names by adding an
		underscore to the beginning of the symbol name.  Newer versions of
		Cygwin do not seem to do this.

		How do you know if you need this option?  You could look at the generated
		symbol tables to see if there are underscore characters at the beginning
		of the symbol names.  Or, if you need this option, the simulation will not
		run:  It will crash early, probably in some function due to the failure to
		allocate memory.

config SIM_ASAN
	bool "Address Sanitizer"
	default n
	depends on MM_CUSTOMIZE_MANAGER && FRAME_POINTER
	---help---
		AddressSanitizer (ASan) is a fast compiler-based tool for detecting memory
		bugs in native code.

config SIM_UBSAN
	bool "Undefined Behaviour Sanitizer"
	default n
	depends on FRAME_POINTER
	---help---
		Compile-time instrumentation is used to detect various undefined behaviours
		at runtime.

config SIM_UBSAN_DUMMY
	bool "Bypass Undefined Behaviour Sanitizer"
	default n
	depends on SIM_UBSAN
	---help---
		Keep SIM_UBSAN compile time but disable runtime actions.

choice
	prompt "X64_64 ABI"
	default SIM_X8664_SYSTEMV if HOST_LINUX
	default SIM_X8664_MICROSOFT if HOST_WINDOWS
	depends on HOST_X86_64 && !SIM_32

config SIM_X8664_SYSTEMV
	bool "System V AMD64 ABI"
	---help---
		The calling convention of the System V AMD64 ABI is followed on Solaris,
		Linux, FreeBSD, macOS, and other UNIX-like or POSIX-compliant operating
		systems. The first six integer or pointer arguments are passed in registers
		RDI, RSI, RDX, RCX, R8, and R9, while XMM0, XMM1, XMM2, XMM3, XMM4, XMM5,
		XMM6 and XMM7 are used for floating point arguments. For system calls, R10
		is used instead of RCX.  As in the Microsoft x64 calling convention,
		additional arguments are passed on the stack and the return value is stored
		in RAX.

		Registers RBP, RBX, and R12-R15 are callee-save registers; all others must
		be saved by the caller if they wish to preserve their values.

		Unlike the Microsoft calling convention, a shadow space is not provided; on
		function entry, the return address is adjacent to the seventh integer argument
		on the stack.

config SIM_X8664_MICROSOFT
	bool "Microsoft x64 calling convention"
	---help---
		The Microsoft x64 calling convention is followed on Microsoft Windows and
		pre-boot UEFI (for long mode on x86-64). It uses registers RCX, RDX, R8,
		R9 for the first four integer or pointer arguments (in that order), and
		XMM0, XMM1, XMM2, XMM3 are used for floating point arguments. Additional
		arguments are pushed onto the stack (right to left). Integer return
		values (similar to x86) are returned in RAX if 64 bits or less. Floating
		point return values are returned in XMM0. Parameters less than 64 bits
		long are not zero extended; the high bits are not zeroed.

endchoice

choice
	prompt "Simulation at a fixed cadence in near real-time"
	default SIM_WALLTIME_SLEEP

config SIM_WALLTIME_SLEEP
	bool "Execution the simulation in near real-time using host sleep"
	---help---
		NOTE: This configuration setting will cause the sim target's IDLE loop to delay
		on each call so that the system "timer interrupt" is called at a rate approximately
		correct for the system timer tick rate.  With this definition in the configuration,
		sleep() behavior is more or less normal.

config SIM_WALLTIME_SIGNAL
	bool "Execute the simulation using a host timer"
	---help---
		Run the NuttX simulation using a host timer that delivers periodic SIGALRM
		events at a tick rate specified by CONFIG_USEC_PER_TICK. Enabling this option
		will generate the timer 'tick' events from the host timer at a fixed rate.
		The simulated 'tick' events from Idle task are no longer sent.

endchoice

config SIM_LOOPTASK_PRIORITY
	int "looptask priority"
	default SCHED_HPWORKPRIORITY if SCHED_HPWORK
	default 255 if !SCHED_HPWORK
	---help---
		Looptask priority

config SIM_LOOPTASK_INTERVAL
	int "looptask interval in us"
	default 10000
	---help---
		Looptask sleep time

config SIM_STACKSIZE_ADJUSTMENT
	int "The adjustment of stack size for sim"
	default 65536
	---help---
		The adjustment of stack size for sim. When the task is created,
		the stack size is increased by this amount.

config SIM_HOSTFS
	bool "Simulated HostFS"
	depends on FS_HOSTFS
	---help---
		Access host filesystem through HostFS.

config SIM_IMAGEPATH_AS_CWD
	bool "Simulator switch working directory"
	default n
	---help---
		If this option is enabled, the working path of nuttx will be modified
		to the folder where the nuttx file is located.
		It affects the file access of hostfs, which will start looking for
		files based on the nuttx image folder.
		Otherwise the default $CWD will be used as the starting path for the search.
		Absolute paths are never affected.

choice
	prompt "Simulated Network Interface"
	default SIM_NETDEV
	depends on NET
	optional

config SIM_NETDEV
	bool "Simulated Network Device"
	select ARCH_HAVE_NETDEV_STATISTICS
	select SCHED_LPWORK
	select NET_ETHERNET
	---help---
		Build in support for a simulated network device.

config SIM_NETUSRSOCK
	bool "Simulated Network Device with Native Stack via usrsock"
	select NET_USRSOCK
	---help---
		Built-in support for a simulated network device using native stack via usrsock

endchoice

if SIM_NETDEV

choice
	prompt "Simulated Network Device Type"
	default SIM_NETDEV_TAP

config SIM_NETDEV_TAP
	bool "Simulated Network Device with TAP/WPCAP"
	depends on (HOST_LINUX || HOST_WINDOWS)
	---help---
		Build in support for a simulated network device using a TAP device on Linux or
		WPCAP on Windows.

config SIM_NETDEV_VPNKIT
	bool "Simulated Network Device with VPNKit"
	---help---
		Build in support for a simulated network device using VPNKit.

endchoice

config SIM_NETDEV_MTU
	int "The MTU of Simulated Network Device"
	default 1500
	range 1280 65535 if NET_IPv6
	range 576 65535 if !NET_IPv6
	---help---
		The MTU of the network devices.

config SIM_NETDEV_NUMBER
	int "Number of Simulated Network Device"
	default 1
	range 1 8
	depends on SIM_NETDEV
	---help---
		The number of simulated network devices.

		Note that only one network device will be brought up by netinit automatically,
		others will be kept in DOWN state by default.

config SIM_WIFIDEV_NUMBER
	int "Number of Simulated WiFi Device"
	default 0
	range 0 SIM_NETDEV_NUMBER
	depends on SIM_NETDEV && DRIVERS_IEEE80211 && NETDEV_WIRELESS_HANDLER
	---help---
		The number of simulated wifi network devices.

		Note that only one network device will be brought up by netinit automatically,
		others will be kept in DOWN state by default.
endif

config SIM_NETDEV_VPNKIT_PATH
	string "Unix domain socket to communicate with VPNKit"
	default "/tmp/vpnkit-nuttx"
	depends on SIM_NETDEV_VPNKIT

if HOST_LINUX
choice
	prompt "Simulation Network Type"
	default SIM_NET_HOST_ROUTE
	depends on SIM_NETDEV_TAP

config SIM_NET_HOST_ROUTE
	bool "Use local host route"
	---help---
		Add a host route for the simulation that points to the created tap device.  The
		simulation will not be able to access the public network unless iptables is
		configured to masquerade for it.  See boards/sim/sim sim/NETWORK-LINUX.txt
		for more information.

config SIM_NET_BRIDGE
	bool "Attach to Linux bridge"
	---help---
		Add the created tap device to the specified bridge.  You will need to manually
		configure the bridge IP address (if any) and routes that point to the bridge.
		See boards/sim/sim/sim/NETWORK-LINUX.txt for more information.

endchoice
endif

if SIM_NET_BRIDGE
config SIM_NET_BRIDGE_DEVICE
	string "Bridge device to attach"
	default "nuttx0"
	---help---
		The name of the bridge device (as passed to "brctl create") to which the simulation's
		TAP interface should be added.

endif

config SIM_SOUND
	bool "Simulated sound support"
	depends on AUDIO
	default y

if SIM_SOUND

choice
	prompt "Simulated sound Type"
	default SIM_SOUND_ALSA

config SIM_SOUND_ALSA
	bool "alsa support on sim"
	depends on HOST_LINUX

endchoice

endif

config SIM_CAMERA
	bool "Simulated video support"
	depends on VIDEO
	default y

if SIM_CAMERA

choice
	prompt "Simulated video device type"
	default SIM_CAMERA_V4L2

config SIM_CAMERA_V4L2
	bool "V4L2 camera support on sim"
	depends on HOST_LINUX

endchoice

config HOST_VIDEO_DEV_PATH
	string "Host video device path"
	default "/dev/video0"

config SIM_CAMERA_DEV_PATH
	string "NuttX video device path"
	default "/dev/video"

endif

menu "Simulated v4l2m2m support"

config SIM_VIDEO_DECODER
	bool "Video decoder support on sim"
	depends on VIDEO
	depends on VIDEOUTILS_OPENH264
	default n
	---help---
		v4l2m2m simlator decoder, dependent on videoutils_openh264.

config SIM_VIDEO_DECODER_DEV_PATH
	string "Video decoder device path"
	depends on SIM_VIDEO_DECODER
	default "/dev/video1"

config SIM_VIDEO_ENCODER
	bool "Video encoder support on sim"
	depends on VIDEO
	depends on VIDEOUTILS_LIBX264
	default n
	---help---
		v4l2m2m simlator encoder, dependent on videoutils_libx264.

config SIM_VIDEO_ENCODER_DEV_PATH
	string "Video encoder device path"
	depends on SIM_VIDEO_ENCODER
	default "/dev/video2"

endmenu

menu "Simulated Graphics/Input"

config SIM_X11FB
	bool "X11 graphics/input"
	default n
	select SCHED_LPWORK
	---help---
		Use X11 to provide graphics and input emulation to interact with host.

if SIM_X11FB
config SIM_X11NOSHM
	bool "Don't use shared memory with X11"
	default n
	---help---
		Don't use shared memory with the X11 graphics device emulation.

menu "Window Configuration"

config SIM_FBHEIGHT
	int "Display height"
	default 240
	---help---
		Simulated display height.  Default: 240

config SIM_FBWIDTH
	int "Display width"
	default 320
	---help---
		Simulated width of the display.  Default: 320

config SIM_FBBPP
	int "Pixel depth in bits"
	default 32
	---help---
		Pixel depth in bits.  Valid choices are 4, 8, 16, 24, or 32.
		If you use the X11 display emulation, the selected BPP must match the BPP
		of your graphics hardware (probably 32 bits).  Default: 32

config SIM_FRAMEBUFFER_COUNT
	int "Framebuffer count"
	depends on SIM_FRAMEBUFFER
	default 2
	---help---
		Framebuffer count.
		Simulated frambuffer count.  Default: 2

endmenu

choice
	prompt "Graphics Device"
	default SIM_FRAMEBUFFER
	---help---
		Choose which kind of graphics device to emulate

config SIM_LCDDRIVER
	bool "LCD device"
	depends on LCD
	---help---
		Emulate an LCD driver

config SIM_FRAMEBUFFER
	bool "Framebuffer"
	depends on VIDEO_FB
	---help---
		Emulate a framebuffer

endchoice

endif # SIM_X11FB

if INPUT
choice
	prompt "Input Device"
	default SIM_NOINPUT

config SIM_TOUCHSCREEN
	bool "X11 mouse-based touchscreen emulation"
	select INPUT_TOUCHSCREEN
	depends on SIM_X11FB
	---help---
		Support an X11 mouse-based touchscreen emulation.  Also needs INPUT=y

config SIM_AJOYSTICK
	bool "X11 mouse-based analog joystick emulation"
	depends on SIM_X11FB
	---help---
		Support an X11 mouse-based analog joystick emulation.  Also needs INPUT=y

config SIM_BUTTONS
	bool "X11 mouse-based button emulation"
	depends on SIM_X11FB
	---help---
		Support an X11 mouse-based button emulation
		(left-click mapped to button press). Also needs INPUT=y

config SIM_NOINPUT
	bool "No input device"

endchoice # Input Device

config SIM_KEYBOARD
	bool "X11 keyboard"
	select INPUT_KEYBOARD
	depends on SIM_X11FB
	---help---
		Support an X11 mouse-based keyboard emulation.  Also needs INPUT=y

config SIM_KEYBOARD_BUFFSIZE
	int "sim keyboard buffer size"
	default 64
	depends on SIM_KEYBOARD
	---help---
		Emulator keyboard buffer size

endif # if INPUT

endmenu

config SIM_HCISOCKET
	bool "Attach Host Bluetooth"
	default false
	depends on HOST_LINUX && (UART_BTH4 || UART_BTH5 || WIRELESS_BLUETOOTH)
	---help---
		Attached the local bluetooth device to the simulation
		target via HCI_CHANNEL_USER. This gives NuttX full
		control of the device, but is abstracted from the
		physical interface which is still handled by Linux.

config SIM_HCISOCKET_DEVID
	int "Bluetooth Device ID"
	default 0
	depends on SIM_HCISOCKET
	---help---
		Attached the local bluetooth device use specific
		Bluetooth HCI number id.

config SIM_I2CBUS
	bool "Simulated I2C Bus"
	default n
	select I2C
	---help---
		Build in support for simulated i2c bus

if SIM_I2CBUS

choice
	prompt "Simulated I2C Bus Type"
	default SIM_I2CBUS_LINUX

config SIM_I2CBUS_LINUX
	bool "Linux I2C Bus Character Dev"
	depends on HOST_LINUX
	---help---
		Attach a Linux I2C bus via the character device
		interface. This should be used with caution as it
		could interfere with devices internal to the system.
		It is recommended to use this with a USB<>I2C device
		like the MCP2221 and set udev rules so that only
		the bus provided by this device can be controlled
		by the user running the simulator.
		https://www.kernel.org/doc/html/latest/i2c/dev-interface.html

endchoice

config SIM_I2CBUS_ID
	int "I2C host bus ID to attach to simulator"
	default 0
	depends on SIM_I2CBUS
	---help---
		This is the bus identifier that should be used by the host implementation to
		attach to the simulator driver.

endif

config SIM_SPI
	bool "Simulated SPI port"
	default n
	select SPI
	---help---
		Build in support for simulated spi port

if SIM_SPI

choice
	prompt "Simulated SPI Type"
	default SIM_SPI_LINUX

config SIM_SPI_LINUX
	bool "Linux SPI Character Dev"
	depends on HOST_LINUX
	---help---
		Attach a Linux SPI port via the character device
		interface. To achieve a SPI port on Linux host, it is
		recommended to use a USB<>SPI device such as CH341A/B.

endchoice

config SIM_SPIDEV_NAME
	string "the name of SPI host dev to attach to simulator"
	default "/dev/spidev0.0"
	depends on SIM_SPI
	---help---
		This is the name of the SPI device on the host implementation to
		attach to the simulator driver.

endif

menu "Simulated UART"

config SIM_UART_DMA
	bool "SIM UART use DMA mode"
	default y
	select SERIAL_TXDMA
	select SERIAL_RXDMA
	---help---
		console use DMA mode or single char mode

config SIM_UART_NUMBER
	int "Number of simulated UART ports"
	default 0
	range 0 4
	---help---
		Under simulation, a NuttX port can be bound to a serial
		port on the host machine. This way NuttX can access the
		host's hardware directly.

		There are two possibilities regarding the host's port:
		it can be either a physical one, or a simulated one.

		In case of a physical port, NuttX will be able to open
		this port and communicate with any actual hardware that
		it is connected to. This is useful for testing code that
		uses external hardware (e.g. sensors or other boards).
		In order for this to work, NuttX port name must be set to
		the same name that the host is using for this port (e.g.
		/dev/ttyUSB0).

		Alternativelly, a "simulated" host port may be used to.
		This is useful if you need to also simulate the external
		hardware, or to have NuttX communicate with any other
		software in your system.
		You can create a "simulated" port in your host,
		by running:

			socat PTY,link=/dev/ttySIM0 PTY,link=/dev/ttyNX0
			stty -F /dev/ttySIM0 raw
			stty -F /dev/ttyNX0 raw

		This will create two new ports on your system.
		NuttX will use the ttySIM0 port, and another software
		may open and use the ttyNX0 port.
		Anything sent to the one of these ports will be relayed
		automatically to the other, and vice-versa.

config SIM_UART_BUFFER_SIZE
	int "UART buffer size"
	default 256
	depends on SIM_UART_NUMBER >= 1
	---help---
		The size of the transmit and receive buffers of the
		simulated UART ports.

		Note that all ports will have the same buffer size.

config SIM_UART0_NAME
	string "UART port 0 name"
	default "/dev/ttySIM0"
	depends on SIM_UART_NUMBER >= 1
	---help---
		This is the name of the simulated UART port.
		The port will be mounted in NuttX under this name.

		A UART port must also exist on the host system
		with the exact same name specified here.

config SIM_UART1_NAME
	string "UART port 1 name"
	default "/dev/ttySIM1"
	depends on SIM_UART_NUMBER >= 2
	---help---
		This is the name of the simulated UART port.
		The port will be mounted in NuttX under this name.

		A UART port must also exist on the host system
		with the exact same name specified here.

config SIM_UART2_NAME
	string "UART port 2 name"
	default "/dev/ttySIM2"
	depends on SIM_UART_NUMBER >= 3
	---help---
		This is the name of the simulated UART port.
		The port will be mounted in NuttX under this name.

		A UART port must also exist on the host system
		with the exact same name specified here.

config SIM_UART3_NAME
	string "UART port 3 name"
	default "/dev/ttySIM3"
	depends on SIM_UART_NUMBER >= 4
	---help---
		This is the name of the simulated UART port.
		The port will be mounted in NuttX under this name.

		A UART port must also exist on the host system
		with the exact same name specified here.

config SIM_RAM_UART
	bool "SIM RAM UART Device"
	depends on RAM_UART
	default n
	---help---
		SIM RAM UART. It emulates a UART device but using a RAM memory
		instead a physical peripheral.

if SIM_RAM_UART
config SIM_RAM_UART0
	bool "SIM RAM UART Device 0"
	default n
	---help---
		sim ram uart device 0

config SIM_RAM_UART0_SLAVE
	bool "SIM_RAM_UART0 is slave"
	depends on SIM_RAM_UART0
	default n
	---help---
		The sim ram uart0 is slave

config SIM_RAM_UART1
	bool "SIM RAM UART Device 1"
	default n
	---help---
		sim ram uart device 1

config SIM_RAM_UART1_SLAVE
	bool "SIM_RAM_UART1 is slave"
	depends on SIM_RAM_UART1
	default n
	---help---
		The sim ram uart1 is slave

config SIM_RAM_UART2
	bool "SIM RAM UART Device 2"
	default n
	---help---
		sim ram uart device 2

config SIM_RAM_UART2_SLAVE
	bool "SIM_RAM_UART2 is slave"
	depends on SIM_RAM_UART2
	default n
	---help---
		The sim ram uart2 is slave
endif

endmenu

config SIM_USB_DEV
	bool "Linux USB Device"
	select USBDEV
	---help---
		Build in support for simulated usb device

if SIM_USB_DEV

config SIM_USB_RAW_GADGET
	bool "Simulated USB Raw Gadget Dev"
	default n
	depends on HOST_LINUX
	---help---
		Use USB Raw Gadget and Dummy HCD/UDC to set up virtual
		USB Device and Host controller that connected to each
		other inside the kernel.

		Get Raw Gadget:
		Get Raw Gadget code at https://github.com/xairy/raw-gadget.

		Make Raw Gadget:
		Run make in the raw_gadget and dummy_hcd directory. If raw_gadget
		build fail, you need to check which register interface meets your
		kenel version, usb_gadget_probe_driver or usb_gadget_register_driver.

		Install Raw Gadget:
		Run ./insmod.sh in the raw_gadget and dummy_hcd directory.

endif

config SIM_USB_HOST
	bool "Linux USB Host"
	select USBHOST
	select USBHOST_HAVE_ASYNCH
	select USBHOST_ASYNCH
	---help---
		Build in support for simulated usb host

if SIM_USB_HOST

config SIM_LIBUSB
	bool "Simulated USB Host use libusb"
	default n
	depends on HOST_LINUX
	---help---
		Use libusb to set up virtual USB Host controller.

config SIM_USB_VID
	hex "Simulated USB Dev VID"
	default 0x18d1

config SIM_USB_PID
	hex "Simulated USB Dev PID"
	default 0x4e11

config SIM_USB_STACKSIZE
	int "Simulated USB waiter stack size"
	default 1024

config SIM_USB_PRIO
	int "Simulated USB waiter task priority"
	default 100

endif

config SIM_CUSTOM_DATA_SECTION
	string "Custom data section name for Simulator"
	default ""
	---help---
		Custom data section name for Simulator to allow
		developer to define special data sections.

endif # ARCH_SIM