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 (/boot/rtconfig.sys, in the case of INtime Distributed RTOS). There is a separate collection for each configured node (the file /config/{NodeName}/rtconfig.sys for INtime Distributed RTOS). Additional parameters controlling the bootloader for INtime Distributed RTOS may be found in the /boot/rtboot.ini file.
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] '{HostName}' [D] | Local INtime hostname; returned by gethostname() | |||||||||||||||||||||
| FPEXCEPMODE [W] | 0x1 (1) | Floating point exception mode: 0=old style, 1=IEEE, other=undefined | |||||||||||||||||||||
| HOSTFILE |
'C:\WINDOWS\SysWOW64\drivers\etc\hosts' [W] '/config/{NodeName}/etc/hosts' [D] (primary node) |
NetDB HOSTS file path | |||||||||||||||||||||
| INTIME [D] |
'C:\Program Files (x86)\INtime\' [W - environment variable] '/' [D] |
Path of INime installation root | |||||||||||||||||||||
| INTIMECFG [D] |
'C:\ProgramData\TenAsys\INtime\' [W - environment variable] '/config/' [D] |
Path of INtime configuration root | |||||||||||||||||||||
| INTIMEVEMACADDR [W] | auto | Windows VEther MAC address | |||||||||||||||||||||
| LSERVRC [D] | '/config/lservrc' | License file | |||||||||||||||||||||
| LSERCLOG [D] | '/config/lservrc.log' | License log file | |||||||||||||||||||||
| NETWORKSFILE |
'C;\WINDOWS\SysWOW64\drivers\etc\networks' [W] '/config/{NodeName}/etc/networks' [D] |
NetDB NETWORKS file path | |||||||||||||||||||||
| NODECFG |
'C:\ProgramData\TenAsys\INtime\{NodeName}' [W] '/config/{NodeName}/' [D] |
Node configuration directory | |||||||||||||||||||||
| PATH |
'C:\Program Files (x86)\INtime\bin;C:\Program Files (x86)\INtime\network7' [W] '/bin;/network7' [D] |
Search path for RTAs | |||||||||||||||||||||
| PROTOSFILE |
'C:\WINDOWS\SysWOW64\drivers\etc\protocol' [W] '/config/{NodeName}/etc/protos' [D] (primary node) |
NetDB PROTOS file path | |||||||||||||||||||||
| SERVICESFILE |
'C:\WINDOWS\SysWOW64\drivers\etc\services' [W] '/config/{NodeName}/etc/servoices' [D] (primary node) |
NetDB SERVICES file path | |||||||||||||||||||||
| TEMP [D] | '/' (primary node) | Temporary file path | |||||||||||||||||||||
| TZ | Default/Local timezone [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 | (primary node) | 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) (primary node) | 0 = disable Adjust Rate mode | |||||||||||||||||||||
| INTERVAL | 0x0 (0) (primary node) | 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 [W]; | |||||||||||||||||||||
| DRVSYSLOG [D] | (primary node) | Internal debug only | |||||||||||||||||||||
| DSM [D] | Distributed Systems Manager configuration | ||||||||||||||||||||||
| DSMPRIORITY | 0x84 (132) | Configures DSM thread priority, default 132 | |||||||||||||||||||||
| INIT [D] | Initial application loader configuration | ||||||||||||||||||||||
| FTP_ARGS | '-a' (primary node) | Default NO anonymous access | |||||||||||||||||||||
| LOGFILE | 'STDOUT' | Output destination from the init loader. Default 'STDOUT', set to 'NONE' to disable, set to a filename to collect in a file. | |||||||||||||||||||||
| RMP | 0x98 (152) (secondary nodes) | ||||||||||||||||||||||
| SYSAPPSMASK |
(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/secondary nodes (non-0 nodes).
| |||||||||||||||||||||
| VERBOSE | 0x0 (0) | Set to non-zero to enable verbose output from the loader. Used to debug init loader problems. | |||||||||||||||||||||
| IWIN32 | iwin32 configuration | ||||||||||||||||||||||
| CrePrio | 0x81 (129) (D - primary node) | Win32 "origionals creation thread" priority. | |||||||||||||||||||||
| DelPrio | 0x81 (129) (D - primary node) | Win32 "origionals deletion thread" priority. | |||||||||||||||||||||
| MaxHan | 0x1F40 (8000) (D - primary node) | 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] | keyboard driver configuration | ||||||||||||||||||||||
| BCP | 0x90 (144) | Console thread priority, default is 144 (90H) | |||||||||||||||||||||
| MPS | 0xFF (255) | Do not change this value - MultiProcessor Support | |||||||||||||||||||||
| KBTYPE | '/config/keymaps/kbmap.us' (primary node) | Path to keyboard map file for the attached keyboard. Selected during installation. | |||||||||||||||||||||
| AUTODELAYMS |
0x1F4 (500) (primary node) |
||||||||||||||||||||||
| AUTORATEMS | 0xFA (250) (primary node) | ||||||||||||||||||||||
| NCJ | 0xFF (255) (secondary nodes) | ||||||||||||||||||||||
| MCSYSINFO [D] | (primary node) | Do not change this section | |||||||||||||||||||||
| MDNS [D] | (primary node) | 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 | |||||||||||||||||||||
| MPFILEDRIVER [D] | Do not change this section | ||||||||||||||||||||||
| NODEMGR_DEFAULTS [D] | (primary node) | Do not change this section | |||||||||||||||||||||
| BOOTFILE | '/boot/drtos.bin' | Boot file for boot/primary node | |||||||||||||||||||||
| STARTERFILE | '/boot/rtboot.bin' | Do not change this value | |||||||||||||||||||||
| STARTERADDRESS | 0x8000 (32768) | Do not change this value | |||||||||||||||||||||
| AUTOSTART | 0xFF (255) | Automatically start all non-boot/application/secondary nodes | |||||||||||||||||||||
| CONFIGFILE | 'rtconfig.sys' | Do not change this value | |||||||||||||||||||||
| DEBUG | 0x0 (0) | Internal debug only | |||||||||||||||||||||
| NODEMGR_{Core} [D] | (primary node) | Edit in the Node Management menu | |||||||||||||||||||||
| NODENAME | '{NodeName}' | Required | |||||||||||||||||||||
| RESERVERDBASEMB | 0x80 (128) (only for primary node) | boot/primary node reserved memory | |||||||||||||||||||||
| RESERVEDEXTMB | 0x0 (0) (only for primary node) | boot/primary node external memory | |||||||||||||||||||||
| BASEMEMORYMB | 0x40 (64) (only for secondary nodes) | non-boot/secondary node reserverd memory | |||||||||||||||||||||
| EXTMEMORYMB | 0x0 (0) (only for secondary nodes) | non-boot/secondary node external memory | |||||||||||||||||||||
| AUTOSTART | 0xFF (255) (only for secondary nodes) | Automatically start node (use configuration optins) | |||||||||||||||||||||
| DEBUG | 0x0 (0) | Internal debug only | |||||||||||||||||||||
| NUC | Kernel configuration | ||||||||||||||||||||||
| BVENABLE |
0xFF (255) |
Enable BVS | |||||||||||||||||||||
| DEH [D] | 0x0 (0) | Override default system exception handler? (0H=false, 0FFH=true) | |||||||||||||||||||||
| FSMADDSRESIDUAL [W] | 0x1 (1) (primary node) | Do not change this value | |||||||||||||||||||||
| 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] | 0x1180 (4480) | 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] | (primary node) | Used to reboot after configuration changes | |||||||||||||||||||||
| check | 0x1 (1) | 1 = do a root check if needed, 0 - Skip root check even if needed | |||||||||||||||||||||
| checkforce | 0x0 (0) | Force a root check, even if not needed | |||||||||||||||||||||
| checkreboot | 0x0 (0) | Reboot after root check completes | |||||||||||||||||||||
| RTIO [D] | (secondary nodes) | ||||||||||||||||||||||
| CONSOLE | 'LOCAL' | Prinf Console | |||||||||||||||||||||
| SDMMONITOR [D] | System Debug Monitor 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] | (primary node) | 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] all nodes; [D] primary node | SpinDoctor configuration | |||||||||||||||||||||
| ACTIVE | 0xFF (255) TRUE | Activate SpinDoctor, 0FFH = ON, 0 = OFF | |||||||||||||||||||||
| MAX |
0x12C (300) |
Max time before the Doctor halts the thread, 3 seconds (300 ticks) | |||||||||||||||||||||
| SYSLOG | [W] all nodes; [D] primary node | Kernel syslog configuration | |||||||||||||||||||||
| DESTINATION | 0x2 (2) | Log destination: 0=none, 1=SDM [W default], 2=Windows [W], Other [D default] | |||||||||||||||||||||
| 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/primary 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.