Mike at 12:59, 15 March 2010

2010-03-15T12:59:57Z

New page

== Introduction ==
{{Cmd|Sysconf.exe}} is a command line tool recommended for advanced system debugging. The tool enables access to the internal registers of PXA CPU and peripheral devices. Please consult the [[WinCE:_Sysconf#See also|PXA Processor Developers Manual]] before using {{Cmd|Sysconf.exe}} utility.

== Sysconf Usage ==

=== SysConf Syntax ===
<pre>
SysConf - to print this help
SysConf <name> - to dump named register
SysConf <address> - to dump memory address (prefix with 0x for hex number)
SysConf <name> <value> - to set named register
SysConf ALL - to dump all registers
SysConf LCD - to dump all LCCR registers
SysConf AC97 <address> <value> - to update AC97 Codec register
SysConf AC97_ALL - to dump all AC97 Codec registers
SysConf DA9030 <address> <value> - to update DA9030 register
SysConf DA9030_ALL -to dump all DA9030 Codec registers
SysConf GPIO <pin number> - to print all the relevant gpio data for the specified pin
SysConf GPIO <pin number> L<#> D<#> RE<#> FE<#> AF<#> - to manually set a certain pin with desired config args meaning:
L-Level(set=1/clear=0) D-direction(1 for output) RE-rise edge set AF- between 0-3
SysConf GPIO - to dump all GPIO registers
SysConf DEVICE <name> START - to activate a device
SysConf DEVICE <name> STOP - to activate a device
SysConf DEVICE <name> RESTART - to activate a device <name> - is the alias as specified in the documentation
SysConf ALLDEVICES - to print all active devices
SysConf ALLALIAS - to print all active devices with Alias name
SysConf NETIF - to list all available network interfaces
SysConf NETIF <name> <cmd> - to START/STOP/RESTART a network interface for example - SysConf NETIF WLAN1 STOP
</pre>
{{Note|The {{Cmd|Sysconf}} tool is NOT case sensitive}}
=== Sysconf Usage Examples ===
* {{Cmd|SysConf <RegName>}} - print register value.
:- {{Parameter|RegName}} - register name as defined in the PXA3xx documentation
:- The following example will print GRER0 value:
> SysConf GRER0
* {{Cmd|SysConf <address>}} - print value at the specified address
:- {{Parameter|address}} - address in the PXA3xx internal address space
:- The following example will print the value of the GPLR0 register mapped at 0x40e00000:
> SysConf 0x40e00000
* {{Cmd|SysConf GPIO <pin number>}} - print GPIO state
:- Example:
> SysConf GPIO 86
Level=HIGH
Direction=INPUT
Rising edge=DISABLED
Falling edge=DISABLED
Edge transition NOT DETECTED
AlternateFunction=0
* {{Cmd|SysConf GPIO <pin number> [L<#>] [D<#>] [RE<#>] [FE<#>] [AF<#>]}} - set GPIO pin attributes
** L - set GPIO logical state (low=0, high=1),
** D - set GPIO direction (input=0, output=1)
** RE - rising edge detection control (disable=0, enable=1)
** FE - falling edge detection control (disable=0, enable=1)
** AF - GPIO alternate function (values are from 0-3)
:- The following example will configure GPIO 86 as output, logical 1, alternate function 0:
> SysConf GPIO 86 L1 D1 AF0
:- The following example will configure GPIO 86 as input, rising edge detection enabled, alternate function 1:
> SysConf GPIO 86 D0 RE1 AF1
* {{Cmd|SysConf ALLALIAS}} - print all active devices that have an alias name.
An alias is defined in the registry value {{Cmd|Alias}} in the BuiltIn registry key of the driver. The alias name is case sensitive and has to be in capital letters.<br>
:- Example:
<pre>
1: WLN1: -> Drivers\BuiltIn\SPI, Alias=WLAN, key name is: 50
2: UFN1: -> Drivers\BuiltIn\Usbfn, Alias=USBFN, key name is: 39
3: COM3: -> Drivers\BuiltIn\Serial4, Alias=SERIALD, key name is: 35
4: COM2: -> Drivers\BuiltIn\Serial3, Alias=SERIALC, key name is: 30
5: COM1: -> Drivers\BuiltIn\Serial2, Alias=SERIALB, key name is: 29
6: SDH1: -> Drivers\BuiltIn\SDHC, Alias=SDCARD, key name is: 27
7: HCD2: -> Drivers\BuiltIn\PCI\Instance\OHCI2, Alias=OHCIITE, key name is: 26
8: NDS1: -> Drivers\BuiltIn\PCI\Instance\RTL81392, Alias=RTL8319, key name is: 25
9: HCD1: -> Drivers\BuiltIn\OHCI, Alias=OHCIPXA, key name is: 21
10: DSK1: -> Drivers\BuiltIn\NorFlashV3, Alias=NOR, key name is: 18
11: I2C1: -> Drivers\BuiltIn\I2C, Alias=I2C, key name is: 14
12: GIO1: -> Drivers\BuiltIn\GIO, Alias=GPIO, key name is: 11
13: DSK0: -> Drivers\BuiltIn\NandFlashV3, Alias=NAND, key name is: 02
</pre>
* {{Cmd|SysConf DEVICE <DevName> STOP}} - stop a device driver and unload it from the system.
:- {{Parameter|DevName}} - device alias name as displayed by the {{Cmd|SysConf ALLALIAS}} command
:- Example:
> SysConf DEVICE WLAN STOP
* {{Cmd|SysConf DEVICE <DevName> START}} - load a device driver and start it
:- {{Parameter|DevName}} - device alias name as displayed by the {{Cmd|SysConf ALLALIAS}} command
:- Example:
> SysConf DEVICE WLAN START
* {{Cmd|SysConf ALLDEVICES}} - print all active devices that have a prefix name.
:- Example:
<pre>
1: TEL1: -> services\TELNETD\NewSession, key name is: 62
2: NTP0: -> Services\TIMESVC, key name is: 59
3: SMB0: -> Services\SMBServer, key name is: 58
4: TEL0: -> Services\TELNETD, key name is: 57
5: FTP0: -> Services\FTPD, key name is: 56
6: HTP0: -> Services\HTTPD, key name is: 54
7: UIP1: -> uiproxy, key name is: 52
</pre>
* {{Cmd|SysConf NETIF}} - print a list of all network interfaces.
* {{Cmd|SysConf NETIF <IfName> <cmd>}} - change network interface state
:- {{Parameter|IfName}} - the interface name as displayed by the {{Cmd|SysConf NETIF}} command
:- {{Parameter|cmd}} - can be STOP, START or RESTART
:- The following example will disable WLAN1 network interface in the GUI:
> SysConf NETIF WLAN1 STOP

== See also ==
* [http://www.marvell.com/products/processors/applications/pxa_3xx/PXA3xx_Developers_Manual.zip PXA3xx Processor Family Developers Manual]
* [http://www.marvell.com/products/processors/applications/pxa_27x/pxa_27x_dev_man.pdf PXA27x Developers Manual]

[[Category:Windows CE|Sysconf Usage]]
[[Category:CM-X300|WinCE: Sysconf Usage]]
[[Category:EM-X270|WinCE: Sysconf Usage]]

WinCE: Sysconf - Revision history

Mike at 12:59, 15 March 2010