CHIP.INI Documentation - SC12 @CHIP-RTOS V1.10

IPC@CHIP Documentation Index Configuration News

The IPC@CHIP system configuration is controlled via the CHIP.INI file.
At startup, the system reads the file A:\chip.ini and uses the settings
found here to initialize the system.

CONFIG News

STDIO_STDIN

STDIO_STDOUT

STDIO_FOCUS

STDIO_FOCUSKEY

STDIO_CTRL_C

IP_ADDRESS

IP_NETMASK

IP_GATEWAY

IP_DHCP

IP_HOSTNAME_OPT

IP_TCPIPMEM

UDPCFG_LEVEL

PPPSERVER_REMOTEADDRESS

PPPSERVER_AUTH

PPPSERVER_MODEM

PPPSERVER_USERx

PPPSERVER_PASSWORDx

PPPSERVER_BAUD

PPPSERVER_INITCMDx

PPPSERVER_INITANSWERx

PPPSERVER_INITTIMEOUTx

PPPSERVER_INITRETRIESx

PPPSERVER_MODEMCTRL

PPPSERVER_CTRLTIME

PPPSERVER_CTRLCMDx

PPPSERVER_CTRLANSWERx

PPPSERVER_CTRLTIMEOUTx

PPPSERVER_CTRLRETRIESx

PPPSERVER_CMDMODE

PPPSERVER_HANGUPDELAY

PPPSERVER_HANGUPCMDx

PPPSERVER_HANGUPANSWERx

PPPSERVER_HANGUPTIMEOUTx

PPPSERVER_HANGUPRETRIESx

PPPSERVER_CONNECTMSGx

PPPSERVER_CONNECTANSWERx

PPPSERVER_CONNECTTIMEOUTx

RAMDRIVE_SIZE

TIMER_1C

TIMER_AF

FTP_ENABLE

FTP_CMDPORT

FTP_LOGINDELAY

FTP_TIMEOUT

FTP_USERx

FTP_PASSWORDx

FTP_ACCESSRIGHTx

FTP_DRIVEx

FTP_ROOTDIRx

WEB_ENABLE

WEB_MAINPAGE

WEB_TEMPPATH

WEB_DRIVE

WEB_ROOTDIR

WEB_MAXCGIENTRIES

WEB_WEBSERVERSTACK

WEB_HTTPPORT

WEB_USER0

WEB_PASSWORD0

WEB_SECURE

WEB_SEC_URLx

WEB_SEC_USERx

TFTP_TFTPPORT

TELNET_TIMEOUT

TELNET_USERx

TELNET_ENABLE

DEVICE_NAME

SERIAL_EXT_DMA

SERIAL_COM_DMA

SERIAL_SEND_DMA

SERIAL_COM_BAUD

SERIAL_EXT_BAUD

DOSLOADER_MEMGAP

BATCH_BATCHMODE

BATCH_EXECTIMEOUT

STDIO

[STDIO]
STDIN=Define standard input device

Define your device for standard input.
Valid devices are COM, EXT and TELNET. You can define several devices simultaneously.

Comments

The following example defines both COM and TELNET for stdin:

[STDIO]
STDIN=COM TELNET

By default, both COM and TELNET are used.

Top of list
Index page

STDIO

[STDIO]
STDOUT=Define standard output device

Define your device for standard output.
Valid devices are COM, EXT and TELNET. You can define several devices simultaneously.

Comments

The following example defines both COM and TELNET for stdout:

[STDIO]
STDOUT=COM TELNET

By default, both COM and TELNET are used.

Top of list
Index page

STDIO

[STDIO]
FOCUS=Command shell and/or user executables

Set the stdio focus to the command shell and/or to the user executables.

Valid entries are USER or SHELL
.
If only USER is defined, stdio in the command shell is suppressed.
If only SHELL is defined, stdout and stdin in the user's DOS executables
are disabled.

Comments

The following example enables stdio for both USER and SHELL:

[STDIO]
FOCUS=SHELL USER

By default, stdin and stdout for both SHELL and USER are enabled.

Important : If stdio is enabled for both, there is a rivalry
between USER and SHELL.

At runtime, pressing of the focus key (default is Ctrl-F) toggles
between these three modes and shows the current mode.

Comments

The following example sets Ctrl-F (ASCII 6) as the current stdio focus key:

[STDIO]
FOCUSKEY=6

By default, the focus key is set to CTRL-F (ASCII 6)
At runtime pressing Ctrl-F keys on the console will then cycle the stdio between the three modes:

The new mode is shown on the console.

Key Range: 0..254

If the key is set to zero, defines no focus key and the switching of stdio is disabled.
The focus key is not usable by the command shell or DOS executable.

Note:

The focus key code is filtered out by the system, and will not be visible to either the command shell or a DOS executable.

Comments

Only numerical IP addresses are allowed here.

Example: ADDRESS=192.168.200.1

If no address entry was found, the IP address will be set to 1.1.1.1.

Comments

Example: NETMASK=255.255.255.224

If no subnet mask entry was found, the subnet mask will be set to 255.255.255.0.

Comments

Example: GATEWAY=195.243.140.65

The TCP/IP stack of the IPC@CHIP supports only one valid default gateway for all device interfaces:
Ethernet and PPP Interface.
So see also PPP Server GATEWAY if you are using PPP.

We provide some additional API functions for modifying the default gateway:

Interrupt 0xAC, Service 0x80: add a default gateway
Interrupt 0xAC, Service 0x81: delete default gateway
Interrupt 0xAC, Service 0x82: get default gateway

Comments

Any settings for IP Address, subnet mask and gateway are ignored if DHCP is used.

Comments

This name feature can be used for the configuration of a DHCP server, e.g. to give a fixed IP to an IPC@CHIP which is configured with a device name.

Top of list
Index page

IP

[IP]
TCPIPMEM=Size

Set the size of the TCP/IP memory block in kBytes.   This block is allocated at the start
of the TCP/IP stack.

Valid Range:     Between 30 kBytes and 160 kBytes   (An out of range value for TCPIPMEM
                  will be set to closest of these limit values.)

Default value: 90 kBytes when @CHIP-RTOS configured without PPP capability (server or client)
                     98 kBytes when @CHIP-RTOS configured with PPP capability

Example:    TCPIPMEM=60

Comments

The TCP/IP API function 0x78, GET_MEMORY_INFO, reports the current used memory of the TCP/IP stack
Since @CHIP-RTOS version 1.02B we allow configuring a maximum value of 160kBytes, because some application programmers may require more then the old limit of 132 kByte.

Top of list
Index page

UDPCFG

[UDPCFG]
LEVEL=mask

Defines the supported functions of the configuration server.

Set LEVEL as a bit mask to define the functions that the configuration server should listen to.
The bit assignments are as follows:
    BIT0:    Allow detection on the network.
    BIT1:    Allow change of IP configuration.
    BIT4:    Allow programming of flash.
If defined as 0, the configuration server task will not start.

Example:     LEVEL=0x03
This would allow detection on the network and changing the IP configuration, but no @CHIP-RTOS update.

Comments

By default, all options are enabled (==0x13).

Comments

Received characters with an ASCII value smaller than 0x20 are printed as numbers.

Top of list
Index page

PPPSERVER

[PPPSERVER]
COMPORT=Define serial device for the PPP server

Define your serial device for the PPP server.
Valid devices are COM or EXT.

Comments

The following example defines EXT as device for the PPP server:

[PPPSERVER]
COMPORT=EXT

By default, no serial port is enabled.

Comments

Only numerical IP addresses are allowed here.
Example: ADDRESS=192.168.205.1
If no address entry was found, the address will be set to 1.1.2.1.

Comments

Only numerical IP addresses are allowed here.
Example: REMOTEADDRESS=192.168.205.2
If no address entry was found, the remote address will be set to 1.1.2.2.

Comments

Example: NETMASK=255.255.255.0
If no subnet mask entry was found, the subnet mask will be set to 255.255.255.0.

Comments

Example: GATEWAY=195.243.140.65

If no gateway entry was found, the gateway will be untouched.

The TCP/IP stack of the IPC@CHIP supports only one valid default gateway for all device interfaces:
Ethernet, PPP Interface.

If you define a gateway in the PPPSERVER section of the chip.ini, it becomes the default gateway for all interfaces when a PPP link to the server is established. The default gateway must be the same IP Address as the remote peer.
It does not make sense to define a different IP, because the remote Peer is the only peer, which is reachable. If a different IP than the remote IP is defined, the remote IP will used for the gateway entry automatically.
During a PPP server connection the command ipcfg indicates this default gateway. After the PPP session, the old gateway (if any was defined) will be restored.

Also we provide some functions for modifying the default gateway:

Interrupt 0xAC, Service 0x80: add a default gateway
Interrupt 0xAC, Service 0x81: delete default gateway
Interrupt 0xAC, Service 0x82: get default gateway

Comments

The following example selects PAP authentication mode:

[PPPSERVER]
AUTH=1

By default, authentication is disabled.

If AUTH!=0 you must define two user name / password pairs used to
authenticate the PPP client. The client must use one of these pairs
to get connected to the IPC@CHIP PPP server.

Comments

Caution:

Fossil API Xon/XOff usage (Chap.3)

Comments

You can define a USER0 and a USER1.
Default user is 'ppps' , password is 'ppps' for both USER0 and USER1.
You must specify both the user name and password.
Neither user name nor password are case sensitive.
The entries are only valid if AUTH=1 is specified.

Maximum name size: 49 characters

Important notice: To avoid security leaks you must define both user names and passwords.

Comments

You can define a PASSWORD0 for USER0 and a PASSWORD1 for USER1
Default user is 'ppps' , password is 'ppps'.
Neither user name nor password are case sensitive.
The entries are only valid if AUTH=1 is specified.

Maximum password size: 49 characters

Comments

The following example sets the PPP server serial port to 19,200 BAUD.

[PPPSERVER]
BAUD=19200

By default, PPP server BAUD rate is 38400 (with 8 data bits, no parity, 1 stop bit).

Comments

You can define a maximum of 3 modem commands e.g. INITCMD0=ATZ .
The entries are only valid if MODEM=1 is specified.
The maximum length for each command string is 25 characters.

Comments

You can define a maximum of 3 modem answers e.g. INITANSWER0=OK .
The entries are only valid, if MODEM=1 is specified.
The maximum length for each answer string is 80 characters.

Default for all answer strings: OK

Comments

Example: INITTIMEOUT0=2
The entries are only valid if MODEM=1 is specified.

Default value: 3 seconds

Comments

Example: INITRETRIES0=2
This entry is only valid if MODEM=1 is specified.

Default value: 1

Comments

You can define a maximum of 3 modem commands e.g. CTRLCMD0=+++ .
The maximum length for each control command string is 25 characters.

The entries are only valid, if MODEMCTRL=1 is specified.

Comments

You can define a maximum of 3 modem answers e.g. INITANSWER0=OK .
The entries are only valid, if MODEMCTRL=1 is specified.
The maximum length for each answer string is 80 characters.

Comments

Example: CTRLTIMEOUT0=2
The entries are only valid if MODEMCTRL=1 is specified.

Default value: 3 seconds

Comments

Example: CTRLRETRIES0=2
This entry is only valid if MODEMCTRL=1 is specified.

Default value: 1

Comments

The entries are only valid if MODEM=1 is specified.

Default string for CMDMODE:+++

Comments

The entries are only valid if MODEM=1 is specified.

Default time: 2 seconds

Comments

You can define a maximum of 3 modem hang-up commands e.g. HANGUPCMD0=ATH ,
which will be executed if the PPP connection is closed.
The maximum length for each command string is 25 characters.

Comments

You can define a maximum of 3 modem answers e.g. HANGUPANSWER0=OK .
The maximum length for each answer message is 80 characters.
Default for all answer strings: OK

Comments

Example: HANGUPTIMEOUT0=2

Default value: 3 seconds

Comments

Example: HANGUPRETRIES0=2

Default value: 1 try

Comments

You can define a maximum of three modem messages e.g. CONNECTMSG0=RING .
The maximum length for each connect message is 25 characters.

Defaults:
CONNECTMSG0=RING
CONNECTMSG1=CONNECT

Comments

You can define a maximum of three modem answers e.g. CONNECTANSWER0=ATA .
The maximum length for each answer string is 80 characters.

Defaults: CONNECTANSWER0=ATA

Comments

Example: CONNECTTIMEOUT0=0

Default values:
CONNECTTIMEOUT0=0
CONNECTTIMEOUT1=60

Comments

Default size: 0 (no RAM drive C:)

Top of list
Index page

TIMER

[TIMER]
1C=ms

Sets the interval in milliseconds for timer interrupt 0x1C.
Range: 1 to 32767, Default value=55 ms.

Comments

Use 0 to disable, 1 to enable.
By default, the FTP server is enabled.

Comments

Use 0 to deactivate, 1 to activate.
By default, the delayed login is enabled.
The delay time starts with 400 milliseconds.
After each following failed login, the delay time will be doubled until it reaches 20 seconds.
After a successful login the delay time will be set back to 400 milliseconds.

Top of list
Index page

FTP

[FTP]
TIMEOUT=sec

Defines the inactivity timeout for the FTP server in seconds.
The minimum value for the timeout is 20 seconds and maximum is 65535 seconds.

Comments

Default FTP timeout is 300 seconds.
RFC 1123 states that the minimum idle timeout should be 5 minutes.

Top of list
Index page

FTP

[FTP]
USERx=user

Defines the user name for FTP.

Comments

You can define a USER0 and a USER1.
Default users are: 'anonymous' (no password) and 'ftp' (password is 'ftp').
You must specify both the user name and their password.
Neither user name nor password are case sensitive.
Maximum name size: 19 characters

Important notice: To avoid security leaks you must define both user names and passwords.

Comments

You can define a PASSWORD0 for USER0 and a PASSWORD1 for USER1
Default users are anonymous (no password) and ftp (password is 'ftp').
Neither user name nor password are case sensitive.
Maximum password size: 19 characters

Top of list
Index page

FTP

[FTP]
ACCESSRIGHTx=Access rights for defined Users

This CHIP.INI entry allows you to deny write access to FTP USER0 or USER1.

Example which disables FTP write access for USER0:

[FTP]
USER0=otto
PASSWORD0=otto53pass
ACCESSRIGHT0=1

Comments

You can only forbid write access if you have defined the respective user with the FTP USERx and PASSWORDx entries.

By default write access is enabled for both FTP users.

Top of list
Index page

FTP

[FTP]
DRIVEx=Set user's FTP drive

Set user's FTP drive.

Comments

Entries DRIVE0 or DRIVE1 can be made to specify a particular drive for use by FTP USER0 and USER1 respectively. The drive numbers are coded as follows:

If the drive does not exist, the default drive A will be set.

The following example defines the root drive for USER0 to be on B: drive.

[FTP]
DRIVE0=1

Comments

The following example defines both root directory for USER1

[FTP]
ROOTDIR1=USERDIR

The default FTP root directory is the drive root directory, "\". If the specified FTP directory doesn't exist, the FTP server closes the connection.

If ROOTDIRx is set you must also specify the FTP DRIVEx entry.

Maximum ROOTDIRx path string length: 64 characters

Important notice:

Comments

Use 0 to disable, 1 to enable.
By default, the Web server is enabled.

Comments

This function allows the Web server to locate HTML files produced on the IPC@CHIP RAMDISK by application programs.

The maximum string length is 32.

Example:

[WEB]
TEMPPATH=C:\web

The webstat command shows the current temporary path.

Top of list
Index page

WEB

[WEB]
DRIVE=Set Web server's disk drive

Set Web server's disk drive.

If the drive does not exist, the default drive A will be set.
The console command webstat shows the current Web server drive.

Top of list
Index page

WEB

[WEB]
ROOTDIR=Name of the root directory

Defines the name of Web server's root directory. If the directory does not exist, the Web server sets "\" as the default root directory.

The console command webstat shows the current root directory.

Comments

Important notice: To avoid security leaks you should define a directory below the
"\" directory. If you use "\" as web root directory, everybody can read all your files.

Comments

Important notice: To avoid security leaks you should define a user name and password.

Top of list
Index page

WEB

[WEB]
PASSWORD0=Password for Web Server PUT method

Defines the password used to transfer files to the Web server's root directory using the HTTP Put method. The standard password is 'WEB'.

The console command webstat shows the Password and Username.

Comments

Important notice: To avoid security leaks you should define a user name and password.

Top of list
Index page

WEB

[WEB]
SECURE=Activated the Web security feature for the Web Server

Defines whether the security feature for the Web Server is active or not.

Comments

The Web Server security feature allows up to two paths to be protected with user name and password. When this security feature is activated, users must then authenticate themselves to get Web access to these paths.

Top of list
Index page

WEB

[WEB]
SEC_URLx=Define a path for the security feature

Defines a specified URL for the Web security feature. The user can define SEC_URL0 and SEC_URL1.

All sub URLs of SEC_URLx are then protected by user name and password. The SEC_URL0 path is protected by SEC_USER0 user name and SEC_PASSWORD0 password, and SEC_URL1 by SEC_USER1 user name and SEC_PASSWORD1 password.

The maximum length for the paths is 63 characters.

Comments

If the security feature is activated, the user should define a path, user name and password.

In the example below all sub URLs of "[IP]/sec" are protected (e.g. "192.168.200.4/sec/page.htm").

Example:

[WEB]
SEC_USER0=otto
SEC_PASSWORD0=web
SEC_URL0=/sec

Top of list
Index page

WEB

[WEB]
SEC_USERx=Define a user name for the security feature

Defines a user name for the Web security feature.
The user can define SEC_USER0 and SEC_USER1.
The max length of the user name is 19 characters.

Comments

If the security feature is activated, the user should define a path, user name and password.

Top of list
Index page

WEB

[WEB]
SEC_PASSWORDx=Define a password for the security feature

Defines a password for the Web security feature.
The user can define SEC_PASSWORD0 and SEC_PASSWORD1.
The max length of the password is 19 characters.

Comments

If the security feature is activated, the user should define a path, user name and password.

Top of list
Index page

TFTP

[TFTP]
TFTPPORT=port

Sets the port number of the TFTP server.
Default TFTP port: 69

Example:

[TFTP]
TFTPPORT=4000

Top of list
Index page

TELNET

[TELNET]
TELNETPORT=port

Sets the port number of the Telnet server.
Default Telnet port: 23

Example:

[TELNET]
TELNETPORT=5000

Top of list
Index page

TELNET

[TELNET]
TIMEOUT=Telnet timeout minutes

Telnet session will automatically close after TIMEOUT minutes without any
characters received from the client. A TIMEOUT setting of zero means no timeout.

Default Value: TIMEOUT=0 (no timeout)

Top of list
Index page

TELNET

[TELNET]
LOGINDELAY=0/1

Define if the delayed login of the Telnet server should be activated.

Comments

Use 0 to deactivate, 1 to activate.
By default, the delayed login is enabled.
The delay time starts with 400 milliseconds.
After each following failed login the delay time will be doubled until it reached 20 seconds.
After successful login the delay time will be set back to 400 milliseconds.

Top of list
Index page

TELNET

[TELNET]
LOGINRETRIES=number of login retries

Defines the number of login retries until Telnet session will be closed.

Example:

[TELNET]
LOGINRETRIES=3

Comments

The default value is 5.

Top of list
Index page

TELNET

[TELNET]
USERx=user

Defines a user name for Telnet.

Comments

You can define a USER0 and a USER1.
Default user is 'tel', password is 'tel'.
You must specify both the user name and their password.
Neither user name nor password are case sensitive.

Maximum user name size: 19 characters

Important notice: To avoid security leaks you must define both user names and passwords.

Top of list
Index page

TELNET

[TELNET]
PASSWORDx=password

Define the password for a Telnet user

Comments

You can define a PASSWORD0 for USER0 and a PASSWORD1 for USER1.
Default user is 'tel', password is 'tel'.
Neither user name nor password are case sensitive.

Maximum password size: 19 characters

Top of list
Index page

TELNET

[TELNET]
ENABLE=0/1

Define if the Telnet server should be activated.

Comments

Use 0 to disable, 1 to enable.
By default, the Telnet server is enabled.

Comments

0=disable (default), 1=enable

Top of list
Index page

DEVICE

[DEVICE]
NAME=name

Define the name of this device.

Comments

This name will show up with the 'Chiptool' software when the network is scanned.

Maximum name size: 20 characters

Top of list
Index page

TRACE

[TRACE]
FLASHWRITE=0/1

Trace the activity of flash writes for debug purposes.

Comments

Set to 1 to enable the debug output. On STDOUT a message is printed at every call to the low-level physical flash write routine.

By default the debug output is disabled.

Top of list
Index page

TRACE

[TRACE]
INTNOTSUPP=0/1

Trace the activity of calls to not supported interrupts or functions.

Comments

Set to 0 to disable the debug output. On STDOUT a message is printed at every call to a not supported interrupt vector or not supported function.

By default the debug output is enabled.

Top of list
Index page

SERIAL

[SERIAL]
EXT_DMA=0/1

Disable/enable DMA receive mode (DMA0 / INT5) on the EXT port.   If DMA
receive mode is disabled, the EXT port works with the standard serial interrupt.
The recommended mode is the DMA receive mode.   It is only necessary to disable the
DMA receive mode for the EXT port if DMA0 is needed by an external device
(in the future).   In the IRQ receive mode, you may loose characters if the system
gets lots of interrupts (e.g. network) or if you are writing to the flash disk (file system calls).
See documentation of the Hardware API.

Example which disables DMA receive mode on the EXT port.
[SERIAL]
EXT_DMA=0

By default, DMA receive mode is enabled.

Top of list
Index page

SERIAL

[SERIAL]
COM_DMA=0/1

Disable/enable DMA receive mode (DMA1 / INT6) on the COM port.   If DMA
transfer is disabled, the COM port works with the standard serial interrupt.
The recommended mode is the DMA receive mode.   It is only necessary to disable the
DMA receive mode for the COM port if DMA1 will be needed by an external device
(in the future).   In the IRQ receive mode, you may loose characters if the system
gets lots of interrupts (e.g. network) or if you are writing to the flash disk (file system calls).

See documentation of the Hardware API.

Example which disables DMA receive mode on the COM port.
[SERIAL]
COM_DMA=0

By default, DMA receive mode is enabled.

Top of list
Index page

SERIAL

[SERIAL]
SEND_DMA=0/1

Selects the DMA send mode for a serial port.

Comments

Use 0 to enable the DMA send mode for the EXT port.
Use 1 to enable the DMA send mode for the COM port.

Example which enables the DMA send mode on the COM port.
[SERIAL]
SEND_DMA=1

By default, DMA send is disabled.

Important:
The IPC@CHIP has only two DMA channels. By default both are used for receiving characters from the COM and EXT ports. If you want to use the DMA send mode for one serial port (e.g. the EXT port), the second port (e.g. the COM port) automatically switches over to using the serial port's receiver interrupt. Note that RS485 is not available with serial send DMA.

Top of list
Index page

SERIAL

[SERIAL]
EXT_RECVQUEUE=size

Sets the receive queue size of the EXT port. Minimum size is 1024.
Maximum size is 10240 byte.

Comments

Example:
[SERIAL]
EXT_RECVQUEUE=2048

By default, the receive queue size is 1024 byte.
If it is planned to use PPP server or PPP client the size should set to 4096.

Top of list
Index page

SERIAL

[SERIAL]
EXT_SENDQUEUE=size

Sets the send queue size of the EXT port. Minimum size is 1024.
Maximum size is 10240 byte.

Comments

Example:
[SERIAL]
EXT_SENDQUEUE=2048

By default, the send queue size is 1024 byte.
If it is planned to use PPP server or PPP client the size should set to 4096.

Top of list
Index page

SERIAL

[SERIAL]
COM_RECVQUEUE=size

Sets the receive queue size of the COM port. Minimum size is 1024.
Maximum size is 10240 byte.

Comments

Example:
[SERIAL]
COM_RECVQUEUE=2048

By default, the receive queue size is 1024 byte.
If it is planned to use PPP server or PPP client the size should be set to 4096.

Top of list
Index page

SERIAL

[SERIAL]
COM_SENDQUEUE=size

Sets the send queue size of the COM port. Minimum size is 1024.
Maximum size is 10240 byte.

Comments

Example:
[SERIAL]
COM_SENDQUEUE=2048

By default, the send queue size is 1024 byte.
If it is planned to use PPP server or PPP client the size should be set to 4096.

Top of list
Index page

SERIAL

[SERIAL]
COM_BAUD=BAUD Rate

Sets the BAUD rate of the COM port.

Comments

Example:

[SERIAL]
COM_BAUD=9600

By default, the BAUD rate of the COM port is 19200 (with 8 data bits, no parity, 1 stop bit).

Top of list
Index page

SERIAL

[SERIAL]
EXT_BAUD=BAUD Rate

Sets the BAUD rate of the EXT port.

Comments

Example:

[SERIAL]
EXT_BAUD=9600

By default, the BAUD rate of the EXT port is 19200 (with 8 data bits, no parity, 1 stop bit).

Top of list
Index page

DOSLOADER

[DOSLOADER]
MEMGAP=Paragraphs

Sets a memory gap between the loaded DOS programs as a memory reserve.

Comments

Some programs compiled with Borland C 5.02 (other compilers??) try to increase their program memory block at runtime.   This can occur, for example, when opening a file with Borland C-library function fopen, where some additional memory is required.   The Borland C-library fopen function calls int 21h 0x4A, which is not directly visible to the application programmer.   This memory resize call fails if another program is loaded after the previous one, because now there is no memory space left for increasing the memory size of the previously executed program.   The program then returns from fopen with an error.   In this case, the global program variable errno is set to value 8 (not enough memory).

To prevent this error, the @CHIP-RTOS allows a memory gap of a defined size between loaded programs.   This memory gap size is specified as a number of paragraphs (where 1 paragraph == 16 Bytes).

This strategy can fail when programs are terminated and restart again.

Example:

[DOSLOADER]
MEMGAP=128

By default, MEMGAP is set to 0.   The maximum value is 2048 paragraphs, where any value larger than this is truncated to 2048

Developer Notes

It is not necessary to set this entry if the application doesn't show the described error. Only if a C-library function call sets errno to 8, should this value be defined. We recommend in that case a value of 128 paragraphs (2048 Bytes). The described problem was noticed when the Borland C-library function fopen was used. The same can happen with usage of C-library function malloc using memory model Large. The malloc returns a NULL pointer in this case.

Top of list
Index page

BATCH

[BATCH]
BATCHMODE=0/1

Sets the batch file execution mode of DOS programs.

BATCHMODE=0 : (Default mode)

executed concurrently

WAIT

REBOOT

BATCHMODE=1 :

executed sequentially

21h Service 0x31

0xA0 Service 0x15

configuration

Important:

BATCHMODE=1

(int21h 0x4C)

int21h 0x31

0xA0 Service 0x15

Comments

This Boolean control applies only to BATCHMODE=1.

Example:

[BATCH]
EXECTIMEOUT=0

CHIP.INI Documentation - SC12 @CHIP-RTOS V1.10

Comments

Comments

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Comments

Comments

Related Topics

Related Topics

Comments

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Related Topics

Comments

Related Topics

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Related Topics

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments

Related Topics

Comments