This topic outlines several Windows CE logging tasks, diagnostics logging, and the Watson dump features of Microsoft RoundTable.

CE Logging Tasks

RoundTable writes to the CE Log for hardware functional tests and critical system issues. This section identifies several tasks that are related to the CE log, that you can perform.

Send the CE Log to the Update Service Server

  • Open a command prompt, and execute the following command line.

rtmanage.exe -m:diag -l:flush

The CE log for the device is written to a directory on the share. The directory name is the product ID of the device.

The CE log file name has the form YYYYMMDDHHMMSS-CELOG n.clg, where nis 0 or 1. An example CE log file name is 20070501170926-CELOG0.clg.

Note:
The file name might change based on the implementation of Office Communications Server 2007 Update Service.

Interpret the CE Log

You must use the Readlog.exe that is included with Windows CE Platform Builder to interpret the .clg file. Alternatively, you can send the file to Microsoft Customer Service and Support for investigation. For information about Readlog Command-Line Options, see http://go.microsoft.com/fwlink/?linkid=147112 .

To extract the contents of the .clg file to a text file, use the -v (verbose) print option when you run Readlog.exe. For example, Readlog.exe -v CE_log_file output_file.txt.

The CE log contains the results of the hardware functional tests and critical system errors.

The following is an example of the contents of a CE log.

Copy Code
0:00:01.523.868 : Raw data   31 (wchar), ,,,FIRMWARE
REV,,NA,1.0.3528.0
0:00:01.524.306 : Raw data   31 (wchar), ,,,FIRMWARE CURRENT
REV,,NA,,,
0:00:01.524.769 : Raw data   41 (wchar), ,,,FIRMWARE FACTORY
REV,,NA,1.0.3528.0,,
0:00:01.525.254 : Raw data   27 (wchar), ,,,OS REV,,NA,1.0.3528.0,,
0:00:01.525.674 : Raw data   26 (wchar), ,,,POST Version,,NA,1.0,,
0:00:01.526.107 : Raw data   30 (wchar), ,,,CPU
STATUS,,PASS,0x10000,,
0:00:01.526.557 : Raw data   36 (wchar), ,,,ETH0 TEST,,NOT
DONE,0xFFFFFFFF,,
0:00:01.527.109 : Raw data   36 (wchar), ,,,ETH1 TEST,,NOT
DONE,0xFFFFFFFF,,
0:00:01.527.626 : Raw data   36 (wchar), ,,,VDSP ENUM
STATUS,,PASS,0x30000,,
0:00:01.528.088 : Raw data   36 (wchar), ,,,USBF ENUM
STATUS,,PASS,0x30001,,
0:00:01.528.539 : Raw data   36 (wchar), ,,,USBH ENUM
STATUS,,PASS,0x30002,,
0:00:01.528.965 : Raw data   30 (wchar), ,,,RTC
VERIFY,,PASS,0x40001,,
0:00:01.529.756 : Raw data   35 (wchar), ,,,TOUCHCTL
VERIFY,,PASS,0x40000,,
0:00:01.530.221 : Raw data   38 (wchar), ,,,NORFLASH
VERIFY,,FAIL,0xFFFFFFFF,,
0:00:01.530.671 : Raw data   36 (wchar), ,,,NANDFLASH
VERIFY,,PASS,0x60000,,
0:00:01.531.213 : Raw data   30 (wchar), ,,,LCD
VERIFY,,PASS,0x70000,,
0:00:01.531.646 : Raw data   30 (wchar), ,,,SDRAM
TEST,,PASS,0x80000,,
0:00:01.532.087 : Raw data   32 (wchar), ,,,System
Cable,,PASS,0x90000,,
0:00:01.532.540 : Raw data   39 (wchar), ,,,UFN1:
Initialize,,PASS,0x00000000,,
0:00:01.532.989 : Raw data   39 (wchar), ,,,HCD1:
Initialize,,PASS,0x00000000,,
0:00:01.533.518 : Raw data   39 (wchar), ,,,HCD3:
Initialize,,PASS,0x00000000,,
0:00:01.534.027 : Raw data   53 (wchar), ,,,Display
Hardware,,PASS,Initialized Successfully,,
0:00:07.754.119 : Raw data   31 (wchar),
,,,PSTN,,FAIL,Initialization,,
0:00:08.737.588 : Raw data   31 (wchar),
,,,PSTN,,FAIL,Initialization,,
0:00:08.738.118 : Raw data   33 (wchar), ,,,ADSP Microphone
Test,,PASS,,,
0:00:46.745.599 : Raw data   29 (wchar), ,,,Camera
ID,,PASS,723308F,,
0:00:46.746.059 : Raw data   22 (wchar), ,,,Restarts,,PASS,0,,
0:00:46.746.553 : Raw data   40 (wchar), ,,,Video Port,,PASS,0
Frames Dropped.,,
0:00:46.747.036 : Raw data   35 (wchar), ,,,Camera Video,,PASS,Y Y
Y Y Y ,,
0:00:46.747.496 : Raw data   29 (wchar), ,,,I2C Status,,PASS,OK 0
C,,
0:00:46.747.936 : Raw data   26 (wchar), ,,,Calibration,,PASS,OK,,
0:00:46.749.127 : Raw data   28 (wchar), ,,,White
Balance,,FAIL,NO,,
0:00:46.749.719 : Raw data   19 (wchar), ,,,POST,,PASS,OK,,
0:00:46.750.187 : Raw data   27 (wchar), ,,,Stack Health,,PASS,OK,,

A hardware failure can be identified by a FAIL in the following entries:

Copy Code
0:00:01.526.107 : Raw data   30 (wchar), ,,,CPU
STATUS,,FAIL,0x10000,,
0:00:01.527.626 : Raw data   36 (wchar), ,,,VDSP ENUM
STATUS,,FAIL,0x30000,,
0:00:01.528.088 : Raw data   36 (wchar), ,,,USBF ENUM
STATUS,,FAIL,0x30001,,
0:00:01.528.539 : Raw data   36 (wchar), ,,,USBH ENUM
STATUS,,FAIL,0x30002,,
0:00:01.528.965 : Raw data   30 (wchar), ,,,RTC
VERIFY,,FAIL,0x40001,,
0:00:01.529.756 : Raw data   35 (wchar), ,,,TOUCHCTL
VERIFY,,FAIL,0x40000,,
0:00:01.530.671 : Raw data   36 (wchar), ,,,NANDFLASH
VERIFY,,FAIL,0x60000,,
0:00:01.531.213 : Raw data   30 (wchar), ,,,LCD
VERIFY,,FAIL,0x70000,,
0:00:01.531.646 : Raw data   30 (wchar), ,,,SDRAM
TEST,,FAIL,0x80000,,
0:00:01.532.087 : Raw data   32 (wchar), ,,,System
Cable,,FAIL,0x90000,,
0:00:01.532.540 : Raw data   39 (wchar), ,,,UFN1:
Initialize,,FAIL,0x00000000,,
0:00:01.532.989 : Raw data   39 (wchar), ,,,HCD1:
Initialize,,FAIL,0x00000000,,
0:00:01.533.518 : Raw data   39 (wchar), ,,,HCD3:
Initialize,,FAIL,0x00000000,,
0:00:01.534.027 : Raw data   53 (wchar), ,,,Display
Hardware,,FAIL,Initialization failed,,
Note:
The CE logs are not localized because they are required for debugging by Microsoft developers.

Errata in the RoundTable CE log

The CE log contains a harmless incorrect entry, similar to the following:

Copy Code
0:00:01.530.221 : Raw data   38 (wchar), ,,,NORFLASH
VERIFY,,FAIL,0xFFFFFFFF,,

The NORFLASH VERIFY test is not run and does not have to be run. If there is a NORFLASH failure, the RoundTable device will not start.

Diagnostics Logging

If the Log to the serverfield is checked in the Loggingsection of the RoundTable device configuration, the device writes self-diagnostic data to the Microsoft Office Communications Server 2007 Update Service. For the file name and location of the log, see the documentation for Office Communications Server 2007 Update Service.

Diagnostics Log Schema

The following table lists the column names and their data types by column number. Data in the diagnostics log is comma-delimited.

Diagnostic log schema names by column number

Column Number Column Name and Data Type

1

DeviceType (varchar(32))

2

Date Time (datetime)

3

ID (varchar(32)) (Product ID from Microsoft RoundTable)

4

LoggingType (Error/Health/Debug/POST)

5

Device Name (varchar(32))

6

Component (varchar(32)) (Hardware | System | Video | Audio)

7

SubComponent1 (varchar(32))

8

SubComponent2 (varchar(32))

9

SubComponent3 (varchar(32))

10

Property (varchar(32))

11

Value1 (varchar(64))

12

Value2 (varchar(64))

13

Value3 (varchar(64))

14

Value4 (varchar(64))

15

Value5 (varchar(64))

Interpreting Diagnostics Logs

The RoundTable diagnostics logs fall into three LoggingType categories: POST, Health, and Image Update. Power-on self-test (POST) diagnostics consist of information generated when the device is powered on. Health diagnostics relate to the health of the device, with regard to either system performance or resource usage. Image update diagnostics relate to updating the device firmware.

LoggingType == POST

RoundTable powers on and performs a POST. The following table shows the columns that are used, together with the values that are logged. The three values of Component represent the system, audio digital signal processor, and video digital signal processor.

Columns and values used in POST logging

Physical Column Value Logged

Device Type

RoundTable

Date Time

Value of [Date Time]

ID

Value of [Product ID]

LoggingType

POST

Device Name

Value of [Device Name]

Component

System | ADSP | VDSP

When Component = System, only the Property, Value2, and Value3 columns are used.

The Property column contains the name of the test. The Value2 column contain the status (PASS | FAIL | NOT DONE | NA). The Value3 column contains the detailed status code. These entries indicate the general health of the system. Note that some entries are reserved for system use.

The following table shows the possible values in the Property, Value2, and Value3 columns when the Component value is System.

Properties and values for POST logging, Component == System

Property Value2 Value3

ADSP Microphone Test

PASS | FAIL

NULL

CPU STATUS

PASS | FAIL

Status code

Display Hardware

PASS | FAIL

Detailed status

ETH0 TEST

NOT DONE

Reserved

ETH1 TEST

NOT DONE

Reserved

FIRMWARE CURRENT REV

Not applicable

Reserved

FIRMWARE FACTORY REV

Not applicable

Revision number for factory default version of EBOOT.bin in the format of 1.0.xxxx.x

FIRMWARE REV

Not applicable

Revision number for working version of EBOOT.bin in the format of 1.0.xxxx.x

HCD1: Initialize

PASS | FAIL

Status code

HCD3: Initialize

PASS | FAIL

Status code

LCD VERIFY

PASS | FAIL

Status code

NANDFLASH VERIFY

PASS | FAIL

Status code

NORFLASH VERIFY

NOT DONE

Reserved

OS REV

Not applicable

Revision number for working version nk.bin in the format of 1.0.xxxx.x

POST Version

Not applicable

Reserved

PSTN

PASS | FAIL

Initialization

RTC VERIFY

PASS | FAIL

Status code

SDRAM TEST

PASS | FAIL

Status code

System Cable

PASS | FAIL

Status code

TOUCHCTL VERIFY

PASS | FAIL

Status code

UFN1: Initialize

PASS | FAIL

Status code

USBF ENUM STATUS

PASS | FAIL

Status code

USBH ENUM STATUS

PASS | FAIL

Status code

VDSP ENUM STATUS

PASS | FAIL

Status code

When component = VDSP, only the Property, Value2, and Value3 columns are used.

The Property column contains the name of the test. The Value2 column contains the status (PASS | FAIL | NOT DONE | NA). The Value3 column contains the detailed status code. These entries indicate the general health of the video subsystem.

The following table shows the possible values in the Property, Value2, and Value3 columns when the Component value is VDSP.

Properties and values for POST logging, Component == VDSP

Property Value2 Value3

Calibration

PASS | FAIL

OK | FAIL

Camera ID

PASS | FAIL

The camera ID

Camera Video

PASS | FAIL

XXXXX

The health of each of the five cameras. X can be Y or N, with Y = Pass and N = Fail

I2C Status

PASS | FAIL

OK | FAIL

POST

PASS | FAIL

OK | FAIL

Restarts

PASS | FAIL

Number of restarts since boot

Stack Health

PASS | FAIL

OK | FAIL

Video Port

PASS | FAIL

X Frames Dropped.

White Balance

PASS | FAIL

YES | NO (Expect yes)

When Component = ADSP, only the Property, Value2, and Value3 columns are used.

The Property] column contains the name of the test. The Value2 column contain the status (PASS | FAIL | NOT DONE | NA). The Value3 column contains the detailed status code. These entries indicate the general health of the initialization phase of the audio sub-system.

The following table shows the possible values in the Property, Value2, and Value3 columns when the Component value is ADSP.

Property and values for POST logging, Component == ADSP

Property Value2 Value3

ADSP FBAB POST

PASS | FAIL

Detailed status

Logging Type == Health

There are two types of health logging: system performance and usage. This section discusses system performance logging. Usage logging is discussed in the next section.

System performance refers to memory usage, system uptime, and health of the audio digital signal processor.

The following table shows the columns used and values logged in health logging.

Columns and values that are used in system performance logging

Physical Column Value Logged

DeviceType

RoundTable

Date Time

Value of [Date Time]

ID

Value of [Product ID]

LoggingType

Health

Device Name

Value of [Device Name]

For performance logging, only the Component, Subcomponent, Property, and Value1 columns are used.

The following table shows the possible values of these columns for System (either memory usage or uptime) and for audio digital signal processor (ADSP) health.

Possible values for Component, Subcomponent, Property, and Value1 Columns

Component Subcomponent Property Value1

System

Name of exe to which the property applies.

MemoryUsage

Usage in bytes

System

NULL

Uptime

Uptime since boot

ADSP

NULL

ADSP HEALTH

nI2CStatus:<#> :

nSPIErrorCounts: <#> :

nSPILastError: <#> : nI2SReadGlitchCount: <#> : nI2SWriteGlitchCount: <#> :

This section discusses usage logging.

The following table shows the columns and values that are used when LoggingType == Health and Property == Usage.

Columns used in usage logging

Physical Column Value Logged

DeviceType

RoundTable

Date Time

Value of [Date Time]

ID

Value of [Product ID]

LoggingType

Health

Device Name

Value of [Device Name]

The following table shows the columns and values that are used in usage logging. This type of usage logging uses the Component, Property, Value1, Value2, Value3, Value4, and Value5 columns. The Value3 value is the session type, which can be one of PcAudio, PcVideo, or PstnCall. When VoIP is used with Microsoft RoundTable, a PcAudio usage entry is logged with the start time and end time. When video streams are used in Microsoft RoundTable, a PcVideo usage entry is logged with the start time and end time. When Microsoft RoundTable is used as an analog phone, a PstnCall usage entry is logged with the start time, end time, originating phone number (configured in the RoundTable device configuration), and the first digit of the dialed phone number.

Values used in usage logging when Component == System

Component Property Value1 Value2 Value3 Value4 Value 5

System

Usage

Start time

End time

PcAudio

Null

 

System

Usage

Start time

End time

PcVideo

Null

 

System

Usage

Start time

End time

PstnCall

Phone number of the originating RoundTable

First digit of dialed number

Note:
To create a report about usage, import the diagnostics log on to a database and create a view of all records where Component = System and Property = Usage.

Logging Type == Image Update

The following table shows the columns used and values logged when LoggingType == Image Update.

Columns and values that are used in Image UpdateLogging

Physical Column Value Logged

DeviceType

RoundTable

Date Time

Value of [Date Time]

ID

Value of [Product ID]

LoggingType

Image Update

Component

System

SubComponent1

<NULL>

SubComponent2

<NULL>

SubComponent3

<NULL>

Property

Version

Value1

Value of [EBOOT Version]

Value2

Value of [Nk.bin Timestamp]

Value3

Value of [Config Timestamp]

Value4

Value of [Last Update Time]

Value5

Value of [Image Update Success/Fail]