INtime SDK Help
Advanced Configuration Settings
Both INtime for Windows and INtime Distributed RTOS have a number of configuration settings described as "Advanced" in the associated configuration tools. Many of these settings are changed using the normal user interface so it is not recommended that they are changed directly. However, there may be special occasions when it is necessary to make changes via the "Advanced" interface.
The parameters are described in the following sections. The parameters are organized as a series of values grouped under headings intended to convey their area of usage. In general a parameter name may be up to sixteen characters and its value may be either a string or a numerical value. Strings are stored in single-quotes. Numbers are stored in Intel Hex format (trailing H). They are stored either in the Windows registry (in the case of INtime for Windows) or in a text file (rtconfig.sys, in the case of INtime Distributed RTOS). There is a separate collection for each configured node. Additional parameters controlling the bootloader for INtime Distributed RTOS may be found in the rtboot.ini file in the disk root directory.
Key: [W] = INtime For Windows [D] = INtime Distributed RTOS
| Section | Parameter | Default | Description | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| CLIB | C Library configuration. All variables in this section become part of the default environment (accessible via getenv()) for each loaded process | ||||||||||||||||||||||
| COMPUTERNAME [D] | 'INTIMERTOS' | ||||||||||||||||||||||
| DEFHOSTNAME | 'NodeA-intime' [W] 'INTIMERTOS' [D] | Default local INtime hostname; returned by gethostname() | |||||||||||||||||||||
| FPEXCEPMODE | 0x1 (1) | Floating point exception mode: 0=old style, 1=IEEE, other=undefined | |||||||||||||||||||||
| HOSTFILE [W] | 'C:\WINDOWS\system32\drivers\etc\hosts' | NetDB HOSTS file path | |||||||||||||||||||||
| INTIME |
'C:\Program Files (x86)\INtime\' [W] '/' [D] |
Path of INime installation root | |||||||||||||||||||||
| INTIMECFG |
'C:\ProgramData\TenAsys\INtime\' [W] '/config/' [D] |
||||||||||||||||||||||
| INTIMEVEMACADDR [W] | auto | Windows VEther Address | |||||||||||||||||||||
| NETWORKSFILE [W] | C;\WINDOWS\system32\drivers\etc\networks | NetDB NETWORKS file path | |||||||||||||||||||||
| NODECFG |
'C:\ProgramData\TenAsys\INtime\{NodeName}' [W] '/config/{NodeName}/' [D] |
Path of the configuration root directory for current node | |||||||||||||||||||||
| PATH | Search path for location of RTA, RSL files. | ||||||||||||||||||||||
| PROTOSFILE [W] | 'C:\WINDOWS\system32\drivers\etc\protocol' | NetDB PROTOS file path | |||||||||||||||||||||
| SERVICESFILE [W] | 'C:\WINDOWS\system32\drivers\etc\services' | NetDB SERVICES file path | |||||||||||||||||||||
| TEMP | '/' [D] | ||||||||||||||||||||||
| TZ | POSIX TZ-format timezone specification. [W] set at node boot time. [D] set by user on installation. | ||||||||||||||||||||||
| others | Other variables may be added manually. They will become part of the default environment for each process created. | ||||||||||||||||||||||
| CLKSYNC | Clock synchronization configuration | ||||||||||||||||||||||
| ADJUSTTZ | 0 = src is UTC, don't adjust TOD for TZ; 1 = src is Local Time, do adjust TOD for TZ [set by installation] | ||||||||||||||||||||||
| ARMODE | 0x0 (0) | 0 = disable Adjust Rate mode | |||||||||||||||||||||
| INTERVAL | 0x0 (0) | 0 = disable periodic sync of TOD w/CMOS after init; >0 = sync period in seconds | |||||||||||||||||||||
| SYNCMODE | 0x1 (1) | 0 = Windows Clock Sync Server is init/sync src [ifw]; 1 = CMOS clock is init/sync src [D] | |||||||||||||||||||||
| DRVSYSLOG [D] | Internal debug only | ||||||||||||||||||||||
| DSM [D] | |||||||||||||||||||||||
| DSMPRIORITY | 0x84 (132) | Configures DSM thread priority, default 132 | |||||||||||||||||||||
| HPE | PHYWAITMS | 0x1F0 (8000) | Time to wait for PHY to configure itself in milliseconds (INtime 7+) | ||||||||||||||||||||
| INIT [D] | [D] Initial application loader configuration | ||||||||||||||||||||||
| LOGFILE | 'STDOUT' | Output destination from the init loader. Default 'STDOUT', set to 'NONE' to disable, set to a filename to collect in a file. | |||||||||||||||||||||
| SAFEMODE | 0x1 (1) | Set by the bootloader to prevent the startup script from running. | |||||||||||||||||||||
| SYSAPPSMASK [??] (not present by default except on first node) |
(depends on webs configuration) | Bitmask of system applications to start during boot phase (INtime Distribute RTOS). Do not manually change this value for the boot node, but can be manually edited for application nodes (non-0 nodes).
| |||||||||||||||||||||
| VERBOSE | 0x0 (0) | Set to non-zero to enable verbose output from the loader. Used to debug init loader problems. | |||||||||||||||||||||
| IOSYS | IOSYS file configuration for DRTOS | ||||||||||||||||||||||
| BASEPRI | 0x7F (127) | Set the base (highest) priority for threads within iosys. min=4, max=250. | |||||||||||||||||||||
| CLASSICISR | 0xFF (255) TRUE | Configure iosys to use interrupt level driver interrupt thread priorities. | |||||||||||||||||||||
| DISABLE_SD | 0x0 (0) FALSE | Disable SD media controllers. | |||||||||||||||||||||
| MAXFILES | 0x400 (1024) | Define the maximum number of open files that iosys can handle. | |||||||||||||||||||||
| IWIN32 | |||||||||||||||||||||||
| CrePrio | 0x81 (129) | Win32 "origionals creation thread" priority. | |||||||||||||||||||||
| DelPrio | 0x81 (129) | ||||||||||||||||||||||
| MaxHan | 0x1F40 (8000) | Maximum number of Win32 handles supported | |||||||||||||||||||||
| SegSize | 0x4 (4) | Size of the Win32 shared memory pool, in Mbytes. Must be a multiple of 4. | |||||||||||||||||||||
| KEYBD [D] | [D] keyboard driver configuration | ||||||||||||||||||||||
| BCP | 0x90 (144) | Console thread priority, default is 144 (90H) | |||||||||||||||||||||
| MPS | 0xFF (255) | Do not change this value - Multi Processor Support | |||||||||||||||||||||
| KBTYPE | '/config/keymaps/kbmap.us' | Path to keyboard map file for the attached keyboard. Selected during installation. | |||||||||||||||||||||
| LOADER [W] | Application loader server configuration | ||||||||||||||||||||||
| LOADER_PRI | 0x82 (130) | The priority of the load server thread which completes the loading of a new application. | |||||||||||||||||||||
| INIT_PRI | 0x9B (155) | The priority of the initial thread of a new application. | |||||||||||||||||||||
| RSL_DEL_TASK_PRI | 0x80 (128) | The priority of the RSL and RSL reference deletion threads. | |||||||||||||||||||||
| MCSYSINFO [D] | Do not change this section | ||||||||||||||||||||||
| MDNS [D] | mDNS configuration. Configures which services are advertised via mDNS. General format is _service._proto.local.:port where service is the name of the service to advertise, proto is udp or tcp and port is the port number. See the default values for examples | ||||||||||||||||||||||
| SERVICE0 | '_ftp._tcp.local.:21' | First service; advertises FTP service on TCP port 21 | |||||||||||||||||||||
| SERVICE1 | '_http._tcp.local.:80' | Second service; advertises HTTP service on TCP port 80 | |||||||||||||||||||||
| SERVICE2 | '_ntx2.udp.local.:48271 |
Third service; advertises NTX2 service on UDP port 48271 Up to 20 services may be configured | |||||||||||||||||||||
| MEMORY [D] | |||||||||||||||||||||||
| MCGMEMSIZE | 0x40000 (262144) | Amount of Global Shared Memory (bytes) | |||||||||||||||||||||
| OSAREABASEMB | 0x4 (4) | default address of first kernel | |||||||||||||||||||||
| OSAREASIZEMB | 0x400 (1024) | ||||||||||||||||||||||
| NUC | Kernel configuration settings. | ||||||||||||||||||||||
| BVENABLE |
0x1 (1) [W] 0xFF (255) [D] |
Enable BVS. | |||||||||||||||||||||
| DEH [D] | 0x0 (0) | Override default system exception handler? (0H=false, 0FFH=true) | |||||||||||||||||||||
| FSMADDSRESIDUAL | 0x1 (1) | ?? | |||||||||||||||||||||
| KTR [D] | 0x14 (20) | Kernel Tick Ratio | |||||||||||||||||||||
| MSIEXCLUSIVE [D] | 0xFF (255) | Only record devices in PCI IRQ table if they have no MSI capability | |||||||||||||||||||||
| OSLA | 0xFFFFFFFF (4294967295) | OS Linear address | |||||||||||||||||||||
| PCIEXCLUDECLASS [D] | 0xFFFFFFFF (4294967295) | Exclude all signal processor PCI devices from IRQ table (ApolloLake) | |||||||||||||||||||||
| RRP [D] | 0x8C (140) | Round Robin Threashhold Level - Real Time Fence | |||||||||||||||||||||
| RRT [D] | 0x5 (5) | Round Robin Time Period | |||||||||||||||||||||
| ROOT [D] | Root filesystem checking [D] | ||||||||||||||||||||||
| check | 01H | Check the root file system if needed. Default 1=check if required, 0=don't check. | |||||||||||||||||||||
| checkforce | 0H | Force a check of the root file system. Default 0=don't force. | |||||||||||||||||||||
| checkreboot | 0H | Force a reboot after the file check completes. Default 0=don't reboot, 1=reboot. | |||||||||||||||||||||
| SDMMONITOR [D] | [D] SDM configuration | ||||||||||||||||||||||
| GEN_COM_BASE_PORT | 0x3F8 (1016) | Base I/O port for console if set to 'COM' This value is configured by the "COM Port I/O Address" system setting. | |||||||||||||||||||||
| IOCHANNELNAME | 'CON' | Set SDM console to PC console. Alternative is 'COM' - default serial port | |||||||||||||||||||||
| SMMCIOINFO [D] | Do not change this section | ||||||||||||||||||||||
| SNTP [D] | configure SNTP client/server default settings | ||||||||||||||||||||||
| ENABLED | 0xFF (255) TRUE | Enable SNTP (set to 0 to disable) | |||||||||||||||||||||
| PRIORITY | 0x82 (130) | Client/server thread priority (min 130 max 254) | |||||||||||||||||||||
| DEBUG | 0x0 (0) FALSE | Debug mode (set to 1 to enable) | |||||||||||||||||||||
| VERBOSE | 0x0 (0) | Verbosity level Min 0, max 255 (set to 1 to enable) | |||||||||||||||||||||
| CMOSUPDATE | 0x0 (0) FALSE | Update PC cmos when time is first set. Set to 1 to enable | |||||||||||||||||||||
| DNSREFRESH | 0x5 (5) | How often the server names should be resolved. min 5 minutes, max unlimited | |||||||||||||||||||||
| MINADJUST | 0x14 (20) | The minimum time difference to adjust. Default 20 milliseconds. Min 20, Max unlimited. | |||||||||||||||||||||
| GRADADJUST | 0x05 (5) | The maximum amount of time difference to gradually adjust. Min 5 minutes, max unlimited | |||||||||||||||||||||
| CLIENTMODE | 0x0 (0) | The mode for the client. 0 = unicast client 1 = many cast client 2 = broadcast client | |||||||||||||||||||||
| SERVERMODE | 0x0 (0) | The mode for the server. This value is a bit mask. 0 = no server 1 = unicast server 2 = broadcast server 4 = many cast server | |||||||||||||||||||||
| REFRESH | 0x40 (64) | How often to refresh the time. Min 64 seconds, max unlimited | |||||||||||||||||||||
| SERVER0 | 'pool.ntp.org' | The first SNTP server. May be DNS name or ip address. | |||||||||||||||||||||
| SERVER1 | 'time.nist.gov' | The second SNTP server. May be DNS name or ip address. | |||||||||||||||||||||
| SERVER2 | 'time.windows.com' | The third SNTP server. May be DNS name or ip address. | |||||||||||||||||||||
| SPIN [W] | |||||||||||||||||||||||
| ACTIVE | 0xFF (255) TRUE | Activate SpinDoctor: -FFH = ON, 0 = OFF | |||||||||||||||||||||
| NMAX |
0x12C (300) |
Max time before the Doctor halts the thread | |||||||||||||||||||||
| SYSLOG | Kernel syslog configuration | ||||||||||||||||||||||
| DESTINATION | 0x2 (2) | Log destination: 0=none, 1=SDM (default), 2=Windows | |||||||||||||||||||||
| HEIMLICH [W] | 0x0 (0) | Debug facility to force entry into SDM. Non-zero enables, type CTRL-D on SDM console to enter SDM command line | |||||||||||||||||||||
| LOGLEVEL | 0x0 (0) | LOGLEVEL: 0=Emergency messages only, 1=Alerts, 2=Critical messages, 3=Errors, 4=Warnings, 5=Notices, 6=Info messages, 7=Debug messages | |||||||||||||||||||||
| USBSS [W] | |||||||||||||||||||||||
| BASEPRI | 0x7F (127) | USB Threads base priority | |||||||||||||||||||||
| DEBUG | 0x0 (0) | Debug level |
Distributed RTOS Initial Application Loader Startup script files
Scriptfiles (.rsc) that are executed during startup are named startup.rsc and are in the /config/{NodeName} directory.
Scriptfiles support all internal commands, can launch programs, and have some basic flow control. Every line is parsed separately, so a command cannot span lines. See the INshell INtime Distributed RTOS Utility page for more information about script files.
Bootloader configuration
The bootload configuration (INtime Distributed RTOS only) may be found in the file /boot/rtboot.ini. There is only one section.
| Section | Parameter | Default | Description |
|---|---|---|---|
| BOOT | Bootloader configuration | ||
| BDEVICE | 'msdosfs:/dev/ada0p1' | Name of boot partition set by the installer | |
| BDEVICEOPTS | 'rw' | Boot device options | |
| BOOTFILE | '/drtos.bin' | Default boot file path | |
| BREAK | 0H | Value configured by the "Debug on boot" field 0=no break, 1=break to SDM (console), 2=break to SDM (serial port) | |
| FDRIVER | 3H | Internal value used by kernel - do not change this value | |
| INIFILE | '/rtconfig.sys' | Configuration settings file path for the boot node | |
| RAMDISK | '/init.img' | Path name of RAM disk image | |
| RAMDISK_ADDR | 0H | RAM disk address set by the installer | |
| RDEVICE | 'ufs:/dev/ada0p2' | Name of the root partition set by the installer | |
| RDEVICEOPTS | 'rw' | Root device options | |
| SHOWBREAK | 0H | ||
| SHOWUI | 1H | Show the user interface. Set to 0 to boot without showing the UI. | |
| TIMEOUT | 5H | Number of seconds to display the UI before booting. If a key is pressed the timeout is canceled. This value is configured by the "Boot Menu Timeout" system setting. | |
| TITLE | 'INtime Distributed RTOS' | Bootloader title line text | |
| USE_VIDEO | 0H | Output to video. Setting this to zero causes the bootloader and the operating system to redirect its output to the first serial port (COM1). This value is configured by the "Use Video For Boot" system setting. |
Other parameters are for internal use and should not be modified or removed.