|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-6786C7D8-34B9-496C-890E-03DE018D2DE1" xml:lang="en"><title>IIC Testing Guide</title><shortdesc>Describes how to test an IIC platform service implementation</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
13 <p>The IIC bus has a standard <xref href="http://www.nxp.com/acrobat/literature/9398/39340011.pdf.dita">IIC |
|
14 bus specification v2-1 Jun 2000</xref>. For generic testing, there |
|
15 is also an IIC test harness.</p> |
|
16 <section id="GUID-02B42C64-BA3B-493D-97A0-8FF4430DD6DC"><title>IIC |
|
17 test source files</title><p>The following test code is available to |
|
18 test an IIC port.</p><table id="GUID-9F373E0B-6A39-494C-A421-4041F1765724"> |
|
19 <tgroup cols="4"><colspec colname="col1" colwidth="1.00*"/><colspec colname="col2" colwidth="1.44*"/><colspec colname="col3" colwidth="1.12*"/> |
|
20 <colspec colname="col4" colwidth="0.44*"/> |
|
21 <thead> |
|
22 <row> |
|
23 <entry align="center" valign="top"><p><b>File</b></p></entry> |
|
24 <entry align="center" valign="top"><p><b>Description</b></p></entry> |
|
25 <entry align="center" valign="top"><p><b>Location</b></p></entry> |
|
26 <entry align="center" valign="top"><p><b>Usage</b></p></entry> |
|
27 </row> |
|
28 </thead> |
|
29 <tbody> |
|
30 <row> |
|
31 <entry><p>t_iic.exe</p></entry> |
|
32 <entry><p>This file interacts with test-specific LDD to instigate |
|
33 tests of functionality that would normally be invoked by kernel-side |
|
34 device driver clients of the IIC</p></entry> |
|
35 <entry><p>/sf/os/kernelhwsrv/kerneltest/e32test/iic/t_iic.cpp</p></entry> |
|
36 <entry><p>Mandatory</p></entry> |
|
37 </row> |
|
38 <row> |
|
39 <entry><p>iic_client_ctrless.ldd</p></entry> |
|
40 <entry><p>Kernel-side proxy LDD acting as a client of the IIC.</p></entry> |
|
41 <entry><p>/sf/os/kernelhwsrv/kerneltest/e32test/iic/t_iic.cpp</p></entry> |
|
42 <entry><p>Mandatory</p></entry> |
|
43 </row> |
|
44 <row> |
|
45 <entry><p>iic_slaveclient_ctrless.ldd</p></entry> |
|
46 <entry><p>Kernel-side proxy LDD acting as a slave client of the IIC.</p></entry> |
|
47 <entry><p>/sf/os/kernelhwsrv/kerneltest/e32test/iic/t_iic.cpp</p></entry> |
|
48 <entry><p>Mandatory</p></entry> |
|
49 </row> |
|
50 <row> |
|
51 <entry><p>iic_client.ldd</p></entry> |
|
52 <entry><p>Kernel-side proxy LDD acting as a client of the IIC.</p></entry> |
|
53 <entry><p>/sf/os/kernelhwsrv/kerneltest/e32test/iic/t_iic.cpp</p></entry> |
|
54 <entry><p>Mandatory</p></entry> |
|
55 </row> |
|
56 <row> |
|
57 <entry><p>iic_slaveclient.ldd</p></entry> |
|
58 <entry><p>Kernel-side proxy LDD acting as a slave client of the IIC.</p></entry> |
|
59 <entry><p>/sf/os/kernelhwsrv/kerneltest/e32test/iic/t_iic.cpp</p></entry> |
|
60 <entry><p>Mandatory</p></entry> |
|
61 </row> |
|
62 </tbody> |
|
63 </tgroup> |
|
64 </table><p>The above test system consists of the executable (t_iic.exe) |
|
65 and associated ldd files. The default version of t_iic.exe is used |
|
66 to test that the platform independent layers of the IIC component |
|
67 work correctly. The default version only works on the emulator, so |
|
68 the layer below the SHAI is a series of stubs. In order for this test |
|
69 harness to work with actual hardware, extensive modification to t_iic.exe |
|
70 will have to be undertaken. </p></section> |
|
71 <section id="GUID-99B49CF1-FEE1-4F60-8265-DC592360ED04"><title>Test |
|
72 application use cases</title><p>The IIC test application is used to |
|
73 test:</p><ul> |
|
74 <li><p>The basic master channel functionality.</p></li> |
|
75 <li><p>The master channel data handling for transaction functionality.</p></li> |
|
76 <li><p>The master channel preamble and multi-transaction functionality.</p></li> |
|
77 <li><p>The slave channel capture and release APIs.</p></li> |
|
78 <li><p>The slave channel capture for receive and transmit of data.</p></li> |
|
79 <li><p>That MasterSlave channels can only be used for one mode at |
|
80 a time.</p></li> |
|
81 </ul></section> |
|
82 <section id="GUID-CCAF786E-A52C-4BAF-8C84-07FF68776376"><title>Limitations</title><p>The IIC test application has the following known limitations:</p><ul> |
|
83 <li><p>This test suite does not work on hardware.</p></li> |
|
84 </ul></section> |
|
85 </conbody></concept> |