IPC@CHIP® RTOS-LNX – API Documentation

Header image

Main page


CHIP.INI [UDPCFG]


[UDPCFG]
LEVEL=mask

Defines the supported functions of the configuration server.

LEVEL is a bit mask. Each bit represents one function. Setting the resp. bit to 1 enables the function, setting it to 0 disables the function. The bit assignment is as follows:
  • Bit 0: Detection of the IPC@CHIP® on the network
  • Bit 1: IP configuration
  • Bit 2: Password protection for IP configuration (see here)
  • Bit 3: Reserved for future use
  • Bit 4: Programming of flash (RTOS update)
  • Bit 5: Password protection for programming of flash (see here)
  • Bit 6: Disable transmission of Hello answers via PPP connections. This configration bit is deprecated. Please enable the DISABLE_HELLO entry in the interface of the PPPCLIENT or PPPSERVER section.
  • Bits 7-14: Reserved for future use
  • Bit 15: This bit can be set to start the server without any function enabled. This could be useful if you want to set from an application at run-time.

    If the configuration level is set to 0x00, the configuration server task will not be started at all.
Default:
If safe mode is off, the default value is 0x0013. If safe mode is on, the default value is 0x8000.
Example:
This would allow detection on the network and IP configuration, but no RTOS update.
[UDPCFG]
LEVEL=0x3
Since
V0.80


[UDPCFG]
PRIO=priority

Defines the task priority of the configuration server (@UDP). Legal values are in the range 0-90.
Default:
Default is 30.
Example:
[UDPCFG]
PRIO=30
Since
V0.80


[UDPCFG]
IPCFG_USERx=user name

Defines a user name for IP configuration.

You must specify both the user name and their password unless only one password or hashed password is defined. Both user name and password are case sensitive.

This feature can be used with ChipTool V7.2.3.0 and ChipControl V2.3.8.0 or greater.

Note: The tag IPCFG_USER0 is not recognized, instead the tag IPCFG_USER must be used.

Maximum user name size: 19 characters.
Example:
[UDPCFG]
IPCFG_USER=user
IPCFG_PASSWORD=pass
IPCFG_USER1=user1
IPCFG_PASSWORD1=pass1
Since
V1.21


[UDPCFG]
FLASH_USERx=user name

Defines a user name for flashing the device.

You must specify both the user name and their password unless only one password or hashed password is defined. Both user name and password are case sensitive.

This feature can be used with ChipTool V7.2.3.0 and ChipControl V2.3.8.0 or greater.

Note: The tag FLASH_USER0 is not recognized, instead the tag FLASH_USER must be used.

Maximum user name size: 19 characters.
Example:
[UDPCFG]
FLASH_USER=user
FLASH_PASSWORD=pass
FLASH_USER1=user1
FLASH_PASSWORD1=pass1
Since
V1.21


[UDPCFG]
IPCFG_PASSWORDx=password

Sets the passwords for IP configuration of the IPC@CHIP® via the configuration server. The passwords must consist of up to 19 printable non-whitespace characters. A maximum of ten passwords may be defined with tags IPCFG_PASSWORD and IPCFG_PASSWORD1 up to IPCFG_PASSWORD9. The passwords must be set up in incremental order and without gaps.

Note: The tag IPCFG_PASSWORD0 is not recognized, instead the tag IPCFG_PASSWORD must be used.

Password protection must be enabled by setting the respective bit in the configuration level.

Default:
No default.
Example:
[UDPCFG]
IPCFG_PASSWORD=abc123
IPCFG_PASSWORD1=123abc
Since
V0.80
Changes:
V1.21 - Extend the maximum number of entries from 1 to 10.


[UDPCFG]
FLASH_PASSWORDx=password

Sets the passwords for flash programming of the IPC@CHIP® via the configuration server. The passwords must consist of up to 19 printable non-whitespace characters. A maximum of ten passwords may be defined with tags FLASH_PASSWORD and FLASH_PASSWORD1 up to FLASH_PASSWORD9. The passwords must be set up in incremental order and without gaps.

Note: The tag FLASH_PASSWORD0 is not recognized, instead the tag FLASH_PASSWORD must be used.

Password protection must be enabled by setting the respective bit in the configuration level.
Default:
No default.
Example:
[UDPCFG]
FLASH_PASSWORD=abc123
FLASH_PASSWORD1=123abc
Since
V0.80
Changes:
V1.21 - Extend the maximum number of entries from 1 to 10.


[UDPCFG]
IPCFG_PASSHASHx=password hash

Defines the password hash for a IP configuration user. This alternate method does not require a clear text password in the CHIP.INI. If this entry is present the IPCFG_PASSWORDx entry is ignored.
A maximum of ten hashes may be defined with tags IPCFG_PASSHASH and IPCFG_PASSHASH1 up to IPCFG_PASSHASH9. The passwords must be set up in incremental order and without gaps.

This feature can be used with ChipTool V7.2.3.0 and ChipControl V2.3.8.0 or greater.

Note: The tag IPCFG_PASSHASH0 is not recognized, instead the tag IPCFG_PASSHASH must be used.

Use the passhash command to generate a password hash.
Example:
[UDPCFG]
IPCFG_USER=user
IPCFG_PASSHASH=$5$4lkah074$7qBJC0U5fQR2wJvonp9OE51VIw1iftyi6qF2.j5FbgB
IPCFG_USER1=user1
IPCFG_PASSHASH1=$5$UtGcvfoO$EP2Vpdt5SXmYds13Gq8QpmK1QBlLHm1.sDLWbvHSXG1
Since
V1.21


[UDPCFG]
FLASH_PASSHASHx=password hash

Defines the password hash for a user that can flash the device. This alternate method does not require a clear text password in the CHIP.INI. If this entry is present the FLASH_PASSWORDx entry is ignored.
A maximum of ten hashes may be defined with tags FLASH_PASSHASH and FLASH_PASSHASH1 up to FLASH_PASSHASH9. The passwords must be set up in incremental order and without gaps.

This feature can be used with ChipTool V7.2.3.0 and ChipControl V2.3.8.0 or greater.

Note: The tag FLASH_PASSHASH0 is not recognized, instead the tag FLASH_PASSHASH must be used.

Use the passhash command to generate a password hash.
Example:
[UDPCFG]
FLASH_USER=user
FLASH_PASSHASH=$5$4lkah074$7qBJC0U5fQR2wJvonp9OE51VIw1iftyi6qF2.j5FbgB
FLASH_USER1=user1
FLASH_PASSHASH1=$5$UtGcvfoO$EP2Vpdt5SXmYds13Gq8QpmK1QBlLHm1.sDLWbvHSXG1
Since
V1.21





Top of page | Main page

Copyright © 2018 Beck IPC GmbH
Generated on Fri Jun 8 2018 12:48:20 by Doxygen 1.8.13