Windows CE Musings http://geekswithblogs.net/BruceEitman/Default.aspx Bruce Eitman http://geekswithblogs.net/BruceEitman/Default.aspx Subtext 2011-06-28T09:44:12Z http://geekswithblogs.net/BruceEitman/archive/2010/08/30/windows-ce-c-application-to-format-tfat.aspx 2010-08-30T22:34:37-04:00:00 2010-08-31T09:41:58Z <div style="margin: 0in 0in 10pt">Windows CE: C# Application to Format TFAT</div> <div style="margin: 0in 0in 10pt">In <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/29/windows-ce-formatting-tfat.aspx"><font color="#800080">Windows CE: Formatting TFAT</font></a> I show how to format a disk with TFAT using C/C++ code. The customer that I wrote that for develops using C#, so I wrote a C# application to test the formatting code. To me, most formatting tools are just too difficult for the average user. In this case, the user will be someone working in the factory or field service. They just need to select a disk and request that it be formatted.</div> <div style="margin: 0in 0in 10pt">The application dialog look like:</div> <div style="margin: 0in 0in 10pt"><img width="329" height="167" alt="" src="/images/geekswithblogs_net/BruceEitman/8095/FormatTFAT/FormatTool.JPG" /></div> <div style="margin: 0in 0in 10pt">It has a drop down list which I populated with a list of disks, a format button and an exit button. It is simple, and easy to use.</div> <div style="margin: 0in 0in 10pt">The hard part of this application is populating the drop down list. I did some searching and found suggestion of using System.IO.DirectoryInfo to find the root folders and check the attributes for temporary folders. The following code demonstrates this approach, were DiskSelect is the drop down list:</div> <div><span>            System.IO.<span style="color: #2b91af">DirectoryInfo</span> DI = <span style="color: blue">new</span> System.IO.<span style="color: #2b91af">DirectoryInfo</span>(<span style="color: #a31515">@"\"</span>);</span></div> <div> </div> <div><span>            System.IO.<span style="color: #2b91af">DirectoryInfo</span>[] Folders = DI.GetDirectories();</span></div> <div><span>            <span style="color: blue">foreach</span> (System.IO.<span style="color: #2b91af">DirectoryInfo</span> FDI <span style="color: blue">in</span> Folders)</span></div> <div><span>            {</span></div> <div><span>                <span style="color: blue">if</span> (FDI.Attributes.CompareTo(System.IO.<span style="color: #2b91af">FileAttributes</span>.Temporary) == 1)</span></div> <div><span>                    DiskSelect.Items.Add(FDI.Name);</span></div> <div><span>            }</span></div> <div><span>            <span style="color: blue">if</span>( DiskSelect.Items.Count &gt; 0 )</span></div> <div style="margin: 0in 0in 10pt"> <span>              DiskSelect.SelectedIndex = 0;</span></div> <div style="margin: 0in 0in 10pt">This code works and can be effective on some systems. But it has a flaw which is that not all temprary folders are disks. If your OS includes the network redirector component, there will be a Network folder which is temporary but is not a disk. The Release folder which is used in debugging the OS using Platform Builder is also temporary, but not a disk.</div> <div style="margin: 0in 0in 10pt">The only alternative that I could find is to use FindFirstStore()/FindNextStore() and FindFirstPartition()/FindNextPartition() which are included in StoreAPI. The downside of this approach is that StoreAPI is not generaly included in the SDK and worse, it is not a DLL in the system so it cannot be P/Invoked. So if you don’t have access to the StoreAPI, you might as well stop reading now – the rest of this assumes that you do have access to StoreAPI. If you don’t have it, you might want to ask your OEM for it because it has some valuable functions for accessing disk information.</div> <div style="margin: 0in 0in 10pt">I could have simply wrapped the StoreAPI with a DLL, which would have been as simple as just linking StoreAPI.lib with a DllEntry() function. But I am not a good enough C# programmer to define the structures needed for C# and I felt that for a C# program the functions are just too clunky. Instead I made some assumptions before writing the code. The assumptions are:</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 27pt"><span>1.<span style="font: 7pt 'Times New Roman'">       </span></span>The functions that I will be writing will be used for populating a drop down list and nothing more sophisticated</div> <div style="text-indent: -0.25in; margin: 0in 0in 10pt 27pt"><span>2.<span style="font: 7pt 'Times New Roman'">       </span></span>The disks have only one partition, if you are working with systems that have multiple partitions you can extend the code to handle that but I didn’t need it</div> <div style="margin: 0in 0in 10pt">I realized that I needed to have some data that I could let the application track and pass into function calls. So I started by defining the structure that I needed:</div> <div><span style="color: blue">typedef</span> <span style="color: blue">struct __FindDiskInfo__</span></div> <div>{</div> <div><span>                STOREINFO StoreInfo;</span></div> <div><span>                PARTINFO PartInfo;</span></div> <div style="margin: 0in 0in 10pt">} FindDiskInfoT;</div> <div style="margin: 0in 0in 10pt">STOREINFO and PARTINFO are defined in storemgr.h which is included in the SDK. I plan to create functions that populate the structure and then some functions to get the strings that I need. This should make the C# fairly easy to write. The first step is to initalize the structure and get a pointer/reference from the C/C++ code to the C# code. NewStoreInfo() will allocate the storage and initialize it and DeleteStoreInfo() will release the structure:</div> <div><span style="color: blue">__declspec</span>(<span style="color: blue">dllexport) FindDiskInfoT * APIENTRY NewStoreInfo()</span></div> <div>{</div> <div><span>                FindDiskInfoT *FindDiskInfo;</span></div> <div><span>                RETAILMSG( 1, (TEXT(<span style="color: #a31515">"NewStoreInfo\n"</span>)));</span></div> <div><span>                FindDiskInfo = (FindDiskInfoT *)malloc( <span style="color: blue">sizeof</span>(FindDiskInfoT) );</span></div> <div><span>                <span style="color: blue">if</span>( FindDiskInfo == NULL )</span></div> <div><span>                {</span></div> <div><span>                                RETAILMSG( 1, (TEXT(<span style="color: #a31515">"StartFindStore: malloc failed\n"</span>)));</span></div> <div><span>                                <span style="color: blue">return</span> NULL;</span></div> <div><span>                }</span></div> <div><span>                memset(FindDiskInfo, 0, <span style="color: blue">sizeof</span>(FindDiskInfoT));</span></div> <div><span>                FindDiskInfo-&gt;StoreInfo.cbSize = <span style="color: blue">sizeof</span>(STOREINFO);</span></div> <div><span>                FindDiskInfo-&gt;PartInfo.cbSize = <span style="color: blue">sizeof</span>(PARTINFO);</span></div> <div><span>                                wcscpy(FindDiskInfo-&gt;PartInfo.szVolumeName, TEXT(<span style="color: #a31515">"TEST VolName"</span>));</span></div> <div> </div> <div><span>                RETAILMSG( 1, (TEXT(<span style="color: #a31515">"NewStoreInfo return %X\n"</span>), FindDiskInfo));</span></div> <div><span>                <span style="color: blue">return</span> FindDiskInfo;</span></div> <div>}</div> <div> </div> <div><span style="color: blue">__declspec</span>(<span style="color: blue">dllexport) BOOL APIENTRY DeleteStoreInfo(HANDLE hFind, FindDiskInfoT *FindDiskInfo)</span></div> <div>{</div> <div><span>                <span style="color: blue">if</span>( FindDiskInfo != NULL )</span></div> <div><span>                {</span></div> <div><span>                                free( FindDiskInfo );</span></div> <div><span>                }</span></div> <div><span>                <span style="color: blue">if</span>( hFind )</span></div> <div><span>                {</span></div> <div><span>                                FindCloseStore( hFind );</span></div> <div><span>                }</span></div> <div><span>                <span style="color: blue">return</span> TRUE;</span></div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">And the C# call to these function is:</div> <div><span style="color: #2b91af">IntPtr</span> StoreInfo;</div> <div> </div> <div>StoreInfo = NewStoreInfo();</div> <div>…</div> <div style="margin: 0in 0in 10pt">DeleteStoreInfo(hStore, StoreInfo);</div> <div style="margin: 0in 0in 10pt">Note that DeleteStoreInfo() has an hStore passed into into it. hStore is HANDLE used for finding the disks. hStore is returned from StartFindDisk() which is called to start finding available disks. StartFindDisk() receives a pointer to the previously allocated FindDiskInfoT:</div> <div><span style="color: blue">__declspec</span>(<span style="color: blue">dllexport) HANDLE APIENTRY StartFindDisk( FindDiskInfoT *FindDiskInfo )</span></div> <div>{</div> <div style="text-indent: 0.5in">HANDLE hFind = INVALID_HANDLE_VALUE;</div> <div> </div> <div><span>                hFind = FindFirstStore(&amp;(FindDiskInfo-&gt;StoreInfo));</span></div> <div><span>                </span></div> <div><span>                <span style="color: blue">if</span>( hFind != INVALID_HANDLE_VALUE )</span></div> <div><span>                {</span></div> <div><span>                                HANDLE hStore;</span></div> <div><span>                                hStore = OpenStore( FindDiskInfo-&gt;StoreInfo.szDeviceName );                </span></div> <div> </div> <div><span>                                <span style="color: blue">if</span>( hStore )</span></div> <div><span>                                {</span></div> <div><span>                                                HANDLE hFind = INVALID_HANDLE_VALUE;</span></div> <div><span>                                                hFind = FindFirstPartition(hStore, &amp;(FindDiskInfo-&gt;PartInfo));</span></div> <div> </div> <div><span>                                                <span style="color: blue">if</span>(INVALID_HANDLE_VALUE != hFind)</span></div> <div><span>                                                {</span></div> <div><span>                                                                FindClose(hFind);</span></div> <div><span>                                                }</span></div> <div><span>                                                <span style="color: blue">else</span></span></div> <div><span>                                                                RETAILMSG( 1, (TEXT(<span style="color: #a31515">"No Partitions Found\n"</span>)));</span></div> <div><span>                                                CloseHandle(hStore);</span></div> <div><span>                                }</span></div> <div><span>                                <span style="color: blue">else</span></span></div> <div><span>                                                RETAILMSG(1, (TEXT(<span style="color: #a31515">"OpenSelectedStore failed\n"</span>)));</span></div> <div><span>                }</span></div> <div><span>                <span style="color: blue">else</span></span></div> <div><span>                {</span></div> <div><span>                                RETAILMSG( 1, (TEXT(<span style="color: #a31515">"StartFindStore: FindFirstStore failed %d\n"</span>), GetLastError()));</span></div> <div><span>                }</span></div> <div><span>                </span></div> <div><span>                <span style="color: blue">return</span> hFind;</span></div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">And the C# call is:</div> <div style="margin: 0in 0in 10pt"><span>            hStore = StartFindDisk(StoreInfo);</span></div> <div style="margin: 0in 0in 10pt">StartFindDisk() finds the first available disk and the first partition on the disk and populates the FindDiskInfoT structure with the available information for use later. After calling this, to get the name of the folder, the device name and the partition name, the following functions can be used:</div> <div><span style="color: blue">__declspec</span>(<span style="color: blue">dllexport) TCHAR * APIENTRY GetStoreDeviceName( FindDiskInfoT *FindDiskInfo )</span></div> <div>{</div> <div><span>                TCHAR * RetVal = NULL;</span></div> <div><span>                <span style="color: blue">if</span>( FindDiskInfo )</span></div> <div><span>                {</span></div> <div><span>                                RetVal = FindDiskInfo-&gt;StoreInfo.szDeviceName;</span></div> <div><span>                }</span></div> <div><span>                <span style="color: blue">return</span> RetVal;</span></div> <div>}</div> <div> </div> <div><span style="color: blue">__declspec</span>(<span style="color: blue">dllexport) TCHAR * APIENTRY GetStoreFolderName( FindDiskInfoT *FindDiskInfo )</span></div> <div>{</div> <div><span>                TCHAR * RetVal = NULL;</span></div> <div><span>                <span style="color: blue">if</span>( FindDiskInfo )</span></div> <div><span>                {</span></div> <div><span>                                RetVal = FindDiskInfo-&gt;PartInfo.szVolumeName;</span></div> <div><span>                }</span></div> <div><span>                <span style="color: blue">return</span> RetVal;</span></div> <div>}</div> <div> </div> <div><span style="color: blue">__declspec</span>(<span style="color: blue">dllexport) TCHAR * APIENTRY GetStorePartitionName( FindDiskInfoT *FindDiskInfo )</span></div> <div>{</div> <div><span>                TCHAR * RetVal = NULL;</span></div> <div><span>                <span style="color: blue">if</span>( FindDiskInfo )</span></div> <div><span>                {</span></div> <div><span>                                RetVal = FindDiskInfo-&gt;PartInfo.szPartitionName;</span></div> <div><span>                }</span></div> <div><span>                <span style="color: blue">return</span> RetVal;</span></div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">Then to get the rest of the disks, FindNextDisk() is used:</div> <div><span style="color: blue">__declspec</span>(<span style="color: blue">dllexport) BOOL APIENTRY FindNextDisk( HANDLE hFind, FindDiskInfoT *FindDiskInfo )</span></div> <div>{</div> <div style="text-indent: 0.5in">BOOL FindResult = FALSE;</div> <div> </div> <div><span>                <span style="color: blue">if</span>( FindDiskInfo == NULL || hFind == INVALID_HANDLE_VALUE )</span></div> <div><span>                {</span></div> <div><span>                                                RETAILMSG( 1, (TEXT(<span style="color: #a31515">"FindNextDisk: invalid parameters\n"</span>)));</span></div> <div><span>                                                <span style="color: blue">return</span> FALSE;</span></div> <div><span>                }</span></div> <div><span>                FindResult = FindNextStore(hFind, &amp;(FindDiskInfo-&gt;StoreInfo));</span></div> <div><span>                </span></div> <div><span>                <span style="color: blue">if</span>( FindResult != FALSE )</span></div> <div><span>                {</span></div> <div><span>                                HANDLE hStore;</span></div> <div><span>                                hStore = OpenStore( FindDiskInfo-&gt;StoreInfo.szDeviceName );                </span></div> <div> </div> <div><span>                                <span style="color: blue">if</span>( hStore )</span></div> <div><span>                                {</span></div> <div><span>                                                HANDLE hFind = INVALID_HANDLE_VALUE;</span></div> <div><span>                                                memset( &amp;(FindDiskInfo-&gt;PartInfo), 0, <span style="color: blue">sizeof</span>(PARTINFO));</span></div> <div><span>                                                FindDiskInfo-&gt;PartInfo.cbSize = <span style="color: blue">sizeof</span>(PARTINFO);</span></div> <div> </div> <div><span>                                                hFind = FindFirstPartition(hStore, &amp;(FindDiskInfo-&gt;PartInfo));</span></div> <div> </div> <div><span>                                                <span style="color: blue">if</span>(INVALID_HANDLE_VALUE != hFind)</span></div> <div><span>                                                {</span></div> <div><span>                                                                FindClose(hFind);</span></div> <div><span>                                                }</span></div> <div><span>                                                <span style="color: blue">else</span></span></div> <div><span>                                                {</span></div> <div><span>                                                                RETAILMSG( 1, (TEXT(<span style="color: #a31515">"FindNextDisk: No Partitions Found %d\n"</span>), GetLastError()));</span></div> <div><span>                                                                FindResult = FALSE;</span></div> <div><span>                                                }</span></div> <div><span>                                                CloseHandle(hStore);</span></div> <div><span>                                }</span></div> <div><span>                                <span style="color: blue">else</span></span></div> <div><span>                                {</span></div> <div><span>                                                RETAILMSG(1, (TEXT(<span style="color: #a31515">"FindNextDisk: OpenSelectedStore failed\n"</span>)));</span></div> <div><span>                                                FindResult = FALSE;</span></div> <div><span>                                }</span></div> <div><span>                }</span></div> <div><span>                <span style="color: blue">else</span></span></div> <div><span>                {</span></div> <div><span>                                RETAILMSG( 1, (TEXT(<span style="color: #a31515">"FindNextDisk: FindNextStore failed %d\n"</span>), GetLastError()));</span></div> <div><span>                                FindResult = FALSE;</span></div> <div><span>                }</span></div> <div><span>                </span></div> <div><span>                <span style="color: blue">return</span> FindResult;</span></div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">Similar to StartFindDisk() this finds the next disk and its first partition and populates the FindDiskInfoT with the available data, so that the strings can be retreived later.</div> <div style="margin: 0in 0in 10pt">The code for setting up the C# dialog looks like:</div> <div><span>        [<span style="color: #2b91af">DllImport</span>(<span style="color: #a31515">"FormatDLL.dll"</span>, CharSet = <span style="color: #2b91af">CharSet</span>.Auto, SetLastError = <span style="color: blue">true</span>)]</span></div> <div><span>        <span style="color: blue">static</span> <span style="color: blue">extern</span> <span style="color: blue">bool</span> FormatDiskTFAT(<span style="color: #2b91af">String</span> StoreName, <span style="color: #2b91af">String</span> PartitionName);</span></div> <div><span>        [<span style="color: #2b91af">DllImport</span>(<span style="color: #a31515">"FormatDLL.dll"</span>, CharSet = <span style="color: #2b91af">CharSet</span>.Auto, SetLastError = <span style="color: blue">true</span>)]</span></div> <div><span>        <span style="color: blue">static</span> <span style="color: blue">extern</span> <span style="color: blue">bool</span> FormatDiskTFATEx(<span style="color: #2b91af">String</span> FolderName);</span></div> <div><span>        [<span style="color: #2b91af">DllImport</span>(<span style="color: #a31515">"FormatDLL.dll"</span>, CharSet = <span style="color: #2b91af">CharSet</span>.Auto, SetLastError = <span style="color: blue">true</span>)]</span></div> <div><span>        <span style="color: blue">static</span> <span style="color: blue">extern</span> <span style="color: #2b91af">IntPtr</span> StartFindDisk(<span style="color: #2b91af">IntPtr</span> pStoreInfo);</span></div> <div><span>        [<span style="color: #2b91af">DllImport</span>(<span style="color: #a31515">"FormatDLL.dll"</span>, CharSet = <span style="color: #2b91af">CharSet</span>.Auto, SetLastError = <span style="color: blue">true</span>)]</span></div> <div><span>        <span style="color: blue">static</span> <span style="color: blue">extern</span> <span style="color: blue">bool</span> DeleteStoreInfo(<span style="color: #2b91af">IntPtr</span> hStore, <span style="color: #2b91af">IntPtr</span> FindDiskInfo);</span></div> <div><span>        [<span style="color: #2b91af">DllImport</span>(<span style="color: #a31515">"FormatDLL.dll"</span>, CharSet = <span style="color: #2b91af">CharSet</span>.Auto, SetLastError = <span style="color: blue">true</span>)]</span></div> <div><span>        <span style="color: blue">static</span> <span style="color: blue">extern</span> <span style="color: blue">bool</span> FindNextDisk(<span style="color: #2b91af">IntPtr</span> hFind, <span style="color: #2b91af">IntPtr</span> pStoreInfo);</span></div> <div><span>        [<span style="color: #2b91af">DllImport</span>(<span style="color: #a31515">"FormatDLL.dll"</span>, CharSet = <span style="color: #2b91af">CharSet</span>.Auto, SetLastError = <span style="color: blue">true</span>)]</span></div> <div><span>        <span style="color: blue">static</span> <span style="color: blue">extern</span> <span style="color: #2b91af">IntPtr</span> GetStoreDeviceName(<span style="color: #2b91af">IntPtr</span> pStoreInfo);</span></div> <div><span>        [<span style="color: #2b91af">DllImport</span>(<span style="color: #a31515">"FormatDLL.dll"</span>, CharSet = <span style="color: #2b91af">CharSet</span>.Auto, SetLastError = <span style="color: blue">true</span>)]</span></div> <div><span>        <span style="color: blue">static</span> <span style="color: blue">extern</span> <span style="color: #2b91af">IntPtr</span> GetStoreFolderName(<span style="color: #2b91af">IntPtr</span> pStoreInfo);</span></div> <div><span>        [<span style="color: #2b91af">DllImport</span>(<span style="color: #a31515">"FormatDLL.dll"</span>, CharSet = <span style="color: #2b91af">CharSet</span>.Auto, SetLastError = <span style="color: blue">true</span>)]</span></div> <div><span>        <span style="color: blue">static</span> <span style="color: blue">extern</span> <span style="color: #2b91af">IntPtr</span> GetStorePartitionName(<span style="color: #2b91af">IntPtr</span> pStoreInfo);</span></div> <div><span>        [<span style="color: #2b91af">DllImport</span>(<span style="color: #a31515">"FormatDLL.dll"</span>, CharSet = <span style="color: #2b91af">CharSet</span>.Auto, SetLastError = <span style="color: blue">true</span>)]</span></div> <div><span>        <span style="color: blue">static</span> <span style="color: blue">extern</span> <span style="color: #2b91af">IntPtr</span> NewStoreInfo();</span></div> <div> </div> <div><span>        <span style="color: #2b91af">DiskInfo</span>[] Disks;</span></div> <div> </div> <div><span>        <span style="color: blue">public</span> FormatTool()</span></div> <div><span>        {</span></div> <div><span>            <span style="color: #2b91af">IntPtr</span> StoreInfo;</span></div> <div><span>            <span style="color: #2b91af">IntPtr</span> hStore;</span></div> <div><span>            <span style="color: #2b91af">IntPtr</span> ipName;</span></div> <div><span>            <span style="color: blue">int</span> DiskCount = 0;</span></div> <div> </div> <div><span>            InitializeComponent();</span></div> <div><span>           </span></div> <div><span>            StoreInfo = NewStoreInfo();</span></div> <div><span>            hStore = StartFindDisk(StoreInfo);</span></div> <div> </div> <div><span>            <span style="color: blue">if</span> (hStore != <span style="color: blue">null</span>)</span></div> <div><span>            {</span></div> <div><span>                Disks = <span style="color: blue">new</span> <span style="color: #2b91af">DiskInfo</span>[1];</span></div> <div><span>                Disks[DiskCount] = <span style="color: blue">new</span> <span style="color: #2b91af">DiskInfo</span>();</span></div> <div> </div> <div><span>                ipName = GetStoreDeviceName(StoreInfo);</span></div> <div><span>                Disks[DiskCount].DeviceName = <span style="color: #2b91af">Marshal</span>.PtrToStringUni(ipName).ToString();</span></div> <div> </div> <div><span>                ipName = GetStoreFolderName(StoreInfo);</span></div> <div><span>                Disks[DiskCount].FolderName = <span style="color: #2b91af">Marshal</span>.PtrToStringUni(ipName).ToString();</span></div> <div> </div> <div><span>                ipName = GetStorePartitionName(StoreInfo);</span></div> <div><span>                Disks[DiskCount].PartitionName = <span style="color: #2b91af">Marshal</span>.PtrToStringUni(ipName).ToString();</span></div> <div> </div> <div><span>                DiskSelect.Items.Add(Disks[DiskCount].FolderName);</span></div> <div><span>                DiskSelect.SelectedIndex = 0;</span></div> <div><span>                DiskCount++;</span></div> <div> </div> <div><span>                <span style="color: blue">while</span> (FindNextDisk(hStore, StoreInfo))</span></div> <div><span>                {</span></div> <div><span>                    <span style="color: #2b91af">DiskInfo</span>[] NewDisks = <span style="color: blue">new</span> <span style="color: #2b91af">DiskInfo</span>[DiskCount+1];</span></div> <div><span>                    Disks.CopyTo(NewDisks, 0);</span></div> <div><span>                    NewDisks[DiskCount] = <span style="color: blue">new</span> <span style="color: #2b91af">DiskInfo</span>();</span></div> <div> </div> <div><span>                    ipName = GetStoreDeviceName(StoreInfo);</span></div> <div><span>                    NewDisks[DiskCount].DeviceName = <span style="color: #2b91af">Marshal</span>.PtrToStringUni(ipName).ToString();</span></div> <div> </div> <div><span>                    ipName = GetStoreFolderName(StoreInfo);</span></div> <div><span>                    NewDisks[DiskCount].FolderName = <span style="color: #2b91af">Marshal</span>.PtrToStringUni(ipName).ToString();</span></div> <div> </div> <div><span>                    ipName = GetStorePartitionName(StoreInfo);</span></div> <div><span>                    NewDisks[DiskCount].PartitionName = <span style="color: #2b91af">Marshal</span>.PtrToStringUni(ipName).ToString();</span></div> <div> </div> <div><span>                    DiskSelect.Items.Add(NewDisks[DiskCount].FolderName);</span></div> <div><span>                    DiskCount++;</span></div> <div><span>                    Disks = NewDisks;</span></div> <div><span>                }</span></div> <div><span>                DeleteStoreInfo(hStore, StoreInfo);</span></div> <div><span>                <span style="color: blue">if</span> (DiskSelect.Items.Count &gt; 0)</span></div> <div><span>                    DiskSelect.SelectedIndex = 0;</span></div> <div><span>            }</span></div> <div><span>             </span></div> <div style="margin: 0in 0in 10pt"><span>        }</span></div> <div style="margin: 0in 0in 10pt">I probably could have simplified this code, and if it were a long term project I would spend time on that.<span>   This cod uses a class for keeping track of the disk information for use in the call to FormatDiskTFAT:</span></div> <div><span>    public class <span style="color: #2b91af">DiskInfo</span></span></div> <div><span>    {</span></div> <div><span>        public <span style="color: #2b91af">String</span> FolderName;</span></div> <div><span>        public <span style="color: #2b91af">String</span> DeviceName;</span></div> <div><span>        public <span style="color: #2b91af">String</span> PartitionName;</span></div> <div style="margin: 0in 0in 10pt"><span>    }</span></div> <div style="margin: 0in 0in 10pt">But in hindsight I wrote FormatDiskTFATEx() which doesn’t need all of that information. So the code can be simplified to:</div> <div><span>            <span style="color: #2b91af">String</span> DiskName;</span></div> <div><span>            StoreInfo = NewStoreInfo();</span></div> <div><span>            hStore = StartFindDisk(StoreInfo);</span></div> <div> </div> <div><span>            <span style="color: blue">if</span> (hStore != <span style="color: blue">null</span>)</span></div> <div><span>            {</span></div> <div><span>                ipName = GetStorePartitionName(StoreInfo);</span></div> <div><span>                DiskName = <span style="color: #2b91af">Marshal</span>.PtrToStringUni(ipName).ToString();</span></div> <div> </div> <div><span>                DiskSelect.Items.Add(DiskName);</span></div> <div><span>                DiskSelect.SelectedIndex = 0;</span></div> <div> </div> <div><span>                <span style="color: blue">while</span> (FindNextDisk(hStore, StoreInfo))</span></div> <div><span>                {</span></div> <div><span>                    ipName = GetStorePartitionName(StoreInfo);</span></div> <div><span>                    DiskName = <span style="color: #2b91af">Marshal</span>.PtrToStringUni(ipName).ToString();</span></div> <div> </div> <div><span>                    DiskSelect.Items.Add(DiskName);</span></div> <div><span>                }</span></div> <div><span>                DeleteStoreInfo(hStore, StoreInfo);</span></div> <div><span>                <span style="color: blue">if</span> (DiskSelect.Items.Count &gt; 0)</span></div> <div><span>                    DiskSelect.SelectedIndex = 0;</span></div> <div style="margin: 0in 0in 10pt"><span>            }</span></div> <div style="margin: 0in 0in 10pt">Finally, when the Format button is pressed we need to format the disk. The button handler is:</div> <div><span>        <span style="color: blue">private</span> <span style="color: blue">void</span> FormatButton_Click(<span style="color: blue">object</span> sender, <span style="color: #2b91af">EventArgs</span> e)</span></div> <div><span>        {</span></div> <div><span>            <span style="color: blue">int</span> Index = DiskSelect.SelectedIndex;</span></div> <div> </div> <div><span>            Exitbutton.Visible = <span style="color: blue">false</span>;</span></div> <div><span>            FormatButton.Visible = <span style="color: blue">false</span>;</span></div> <div><span>            Formatinglabel.Text = <span style="color: #a31515">"Formatting, Please Wait"</span>;</span></div> <div><span>            Formatinglabel.Visible = <span style="color: blue">true</span>;</span></div> <div><span>            <span style="color: blue">this</span>.Refresh();</span></div> <div> </div> <div><span>            System.Threading.<span style="color: #2b91af">Thread</span>.Sleep(2000); </span></div> <div><span>            FormatDiskTFAT(Disks[Index].DeviceName, Disks[Index].PartitionName);</span></div> <div> </div> <div><span>            Exitbutton.Visible = <span style="color: blue">true</span>;</span></div> <div><span>            FormatButton.Visible = <span style="color: blue">true</span>;</span></div> <div><span>            Formatinglabel.Text = <span style="color: #a31515">"Formatting Complete"</span>;</span></div> <div><span>            Formatinglabel.Visible = <span style="color: blue">true</span>;</span></div> <div><span>            <span style="color: blue">this</span>.Refresh();</span></div> <div style="margin: 0in 0in 10pt"><span>        }</span></div> <div style="margin: 0in 0in 10pt">Which uses FormatDiskTFAT(), but FormatDiskTFATEx() can be used as:</div> <div style="margin: 0in 0in 10pt"><span>            FormatDiskTFATEx(DiskSelect.SelectedItem.ToString());</span></div> <div style="margin: 0in 0in 10pt">FormatButton_Click() hides the buttons and puts a message in a static text box to tell the user to wait then formats the disk. After the disk is formatted, it changes the text to Format Complete and puts the buttons back in. The problem that I found is that the format can be very quick, too quick so that the message isn’t displayed and the buttons aren’t removed. So I added a 2 second delay just to let the user know that something happened.</div> <div style="margin: 0in 0in 10pt"> </div> <div style="text-align: center; line-height: normal" align="center"><span style="font-size: 9pt">Copyright © 2010 – Bruce Eitman</span></div> <div style="text-align: center; line-height: normal; margin: 0in 0in 10pt" align="center"><span style="font-size: 9pt">All Rights Reserved</span></div><img src="http://geekswithblogs.net/BruceEitman/aggbug/141557.aspx" width="1" height="1" /> http://geekswithblogs.net/BruceEitman/comments/141557.aspx 2 http://geekswithblogs.net/BruceEitman/comments/commentRss/141557.aspx http://geekswithblogs.net/BruceEitman/services/trackbacks/141557.aspx http://geekswithblogs.net/BruceEitman/archive/2010/08/29/windows-ce-formatting-tfat.aspx 2010-08-29T22:42:25-04:00:00 2010-08-31T09:09:18Z <div style="margin: 0in 0in 10pt">A customer came to me for assistance in formatting an SD card with TFAT. I did a quick look in the control panel code to find how it formats disks as TFAT and told the customer to use FormatVolume() and set the FORMAT_OPTIONS dwFlags FATUTIL_FORMAT_TFAT flag.   </div> <div style="margin: 0in 0in 10pt">I assumed that it was that easy and left the customer to write the code. A few weeks later the customer came back to me and said that they just couldn’t get FormatVolume() to work, let alone format the disk as TFAT. So this time I dug deeper and write some code to test it out before getting back to the customer. The following is what I figured out including the code to format a disk as TFAT.</div> <div style="margin: 0in 0in 10pt">What went wrong? When I first looked at how to format TFAT, I looked to see what happens when the Format button is selected. What I didn’t look for is what has to happen before the Format button is selectable. It turns out that before the Format button is selectable, the partition must first be dismounted.</div> <div>__declspec(dllexport) BOOL APIENTRY FormatDiskTFAT( TCHAR *<span style="font-size: 10pt">StoreName</span>, TCHAR *PartitionName )</div> <div>{</div> <div><span>                HANDLE hStore;</span></div> <div><span>                HANDLE hPartition;</span></div> <div> </div> <div><span>                hStore = OpenStore(</span><span style="font-size: 10pt">StoreName</span>);<span>           </span></div> <div> </div> <div><span>                if( INVALID_HANDLE_VALUE != hStore )</span></div> <div><span>                {</span></div> <div><span>                                hPartition = OpenPartition( hStore, PartitionName );</span></div> <div><span>                                if( INVALID_HANDLE_VALUE != hPartition )</span></div> <div><span>                                {</span></div> <div><span>                                                if( DismountPartition(hPartition) )</span></div> <div><span>                                                {    </span></div> <div><span>                                                                FORMAT_OPTIONS fo;</span></div> <div> </div> <div><span>                                                                // Get formating options</span></div> <div><span>                                                                fo.dwClusSize = 4 * 1024;</span></div> <div><span>                                                                fo.dwFatVersion = 32;</span></div> <div><span>                                                                fo.dwNumFats = 2;</span></div> <div><span>                                                                fo.dwRootEntries = 512;</span></div> <div> </div> <div><span>                                                                fo.dwFlags = 0;</span></div> <div><span>                                                                //fo.dwFlags |= FATUTIL_FULL_FORMAT;</span></div> <div><span>                                                                fo.dwFlags |= FATUTIL_FORMAT_TFAT;</span></div> <div> </div> <div><span>                                                                if( ERROR_SUCCESS != pfnFormatVolume( hPartition, NULL, &amp;fo, HandleProgress, HandleMessage ))</span></div> <div><span>                                                                                RETAILMSG( 1, (TEXT("Format Failed\n")));</span></div> <div><span>                                                                MountPartition(hPartition);</span></div> <div><span>                                                }</span></div> <div><span>                                                else</span></div> <div><span>                                                                RETAILMSG( 1, (TEXT("Failed to dismount Partition\n")));</span></div> <div> </div> <div><span>                                                CloseHandle( hPartition );</span></div> <div><span>                                }</span></div> <div><span>                                else</span></div> <div><span>                                                RETAILMSG(1, (TEXT("OpenPartition failed\n")));</span></div> <div> </div> <div><span>                                CloseHandle(hStore);</span></div> <div><span>                }</span></div> <div><span>                else</span></div> <div><span>                                RETAILMSG(1, (TEXT("OpenSelectedStore failed\n")));</span></div> <div> </div> <div><span>                return TRUE;</span></div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">FormatDiskTFAT() takes two strings as arguments:</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><span>·<span style="font: 7pt 'Times New Roman'">         </span></span>StoreName which is the szDeviceName in the STOREINFO structure returned from FindFirstStore()/FindNextStore() or the szStoreName in the CE_VOLUME_INFO structure returned from CeGetVolumeInfo(). The value of the string will be somethings like “DSK1:”.</div> <div style="text-indent: -0.25in; margin: 0in 0in 10pt 0.5in"><span>·<span style="font: 7pt 'Times New Roman'">         </span></span><span style="line-height: 115%">PartitionName which is the szPartionName in PARTINFO and CE_VOLUME_INFO returned by FindFirstPartition()/FindNextPartition() and CeGetVolumeInfo(). The value of the string will be something like “PART00”.</span></div> <div style="margin: 0in 0in 10pt">FormatDiskTFAT() uses the strings to open the store and the partition. Then it dismounts the partition, formats the disk and re-mounts the partition.</div> <div style="margin: 0in 0in 10pt">I choose the function signature because I was thinking about using FindFirstStore()/FindNextStore(), so the device name and the partition name would be readily available. As an afterthought, I decided that it might be handy to have a function that simply takes the folder name of the disk, so I came up with FormatDiskTFATEx():</div> <div><span style="color: blue">__declspec</span>(<span style="color: blue">dllexport) BOOL APIENTRY FormatDiskTFATEx( TCHAR *FolderName )</span></div> <div>{</div> <div><span>                CE_VOLUME_INFO VolInfo;</span></div> <div><span>                VolInfo.cbSize = <span style="color: blue">sizeof</span>( CE_VOLUME_INFO );</span></div> <div> </div> <div><span>                CeGetVolumeInfo(FolderName, CeVolumeInfoLevelStandard, &amp;VolInfo );</span></div> <div><span>                <span style="color: blue">return</span> FormatDiskTFAT( VolInfo.szStoreName, VolInfo.szPartitionName );</span></div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">FormatDiskTFATEx() takes one string as an argument which is the name of the disk folder. This will be something like “Storage Card” or “\Storage Card” depending on how you obtain the string.</div> <div style="margin: 0in 0in 10pt">One of the interesting problems that I ran into is that building this for Windows CE 5.0 (I have not tested yet with CE 6.0) the call to CeGetVolumeInfo() causes a linker error because CeGetVolumeInfoW() does not exist. The solution to this problem is to undefine CeGetVolumeInfo(). So I added:</div> <div><span style="color: blue">#ifdef</span> CeGetVolumeInfo</div> <div><span style="color: blue">#undef</span> CeGetVolumeInfo</div> <div style="margin: 0in 0in 10pt">#endif</div> <div style="margin: 0in 0in 10pt">Then next problem that I needed to solve is that while I can easily compile this code using Platform Builder, my customer who is using an SDK that I provided cannot. The problem is that FATUTIL.DLL is included in the OS, but FATUTIL.LIB is not included in the SDK and FormatVolume() is in FATUTIL. It would be easy enough to create a new SDK and release it, but that may be overkill for one function. So the solution that I came up with is to use LoadLibrary() and GetProcAddress().<span>   I am including these functions in a DLL, so I did the mapping in DllEntry():</span></div> <div>HMODULE hFatUtil = NULL;</div> <div>DWORD (*pfnFormatVolume)(HANDLE hVolume,<span style="color: blue">void *pdi,FORMAT_OPTIONS *pfo,<span style="color: blue">void</span> *pfnProgress,<span style="color: blue">void</span> *pfnMessage);</span></div> <div> </div> <div><span style="color: blue">static</span> <span style="color: blue">void *GetFormatVolume(HMODULE *hFatUtil);</span></div> <div> </div> <div> </div> <div>BOOL APIENTRY DllMain( HANDLE hModule,</div> <div><span>                       DWORD ul_reason_for_call, </span></div> <div><span>                       LPVOID lpReserved</span></div> <div><span>                                                                                 )</span></div> <div>{</div> <div><span>                <span style="color: blue">switch</span>( ul_reason_for_call )</span></div> <div><span>                {</span></div> <div><span>                                <span style="color: blue">case</span> DLL_PROCESS_ATTACH:</span></div> <div><span>                                                pfnFormatVolume = GetFormatVolume(&amp;hFatUtil);</span></div> <div><span>                                                <span style="color: blue">break</span>;</span></div> <div><span>                                <span style="color: blue">case</span> DLL_PROCESS_DETACH:</span></div> <div><span>                                                FreeLibrary(hFatUtil);</span></div> <div><span>                                                <span style="color: blue">break</span>;</span></div> <div><span>                }</span></div> <div><span>    <span style="color: blue">return</span> TRUE;</span></div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">The last problem is that FORMAT_OPTIONS needed by FormatVolume() is also not available in the SDK, or more accuratly the header file that they are included in doesn’t compile cleanly, so I included them in the C code:</div> <div><span style="color: blue">#define</span> FATUTIL_FULL_FORMAT<span>                 0x1</span></div> <div><span style="color: blue">#define</span> FATUTIL_FORMAT_TFAT<span>                 0x2</span></div> <div> </div> <div><span style="color: blue">typedef</span> <span style="color: blue">struct _FORMAT_OPTIONS {</span></div> <div><span>    DWORD   dwClusSize;</span></div> <div><span>    DWORD   dwRootEntries;</span></div> <div><span>    DWORD   dwFatVersion;</span></div> <div><span>    DWORD   dwNumFats;</span></div> <div><span>    DWORD   dwFlags;</span></div> <div style="margin: 0in 0in 10pt">} FORMAT_OPTIONS;</div> <div style="margin: 0in 0in 10pt"><span style="font-family: &quot;Calibri&quot;,&quot;sans-serif&quot;; font-size: 11pt; mso-ascii-theme-font: minor-latin; mso-fareast-font-family: Calibri; mso-fareast-theme-font: minor-latin; mso-hansi-theme-font: minor-latin; mso-bidi-font-family: 'Times New Roman'; mso-bidi-theme-font: minor-bidi; mso-ansi-language: EN-US; mso-fareast-language: EN-US; mso-bidi-language: AR-SA">In my next article (see <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/30/windows-ce-c-application-to-format-tfat.aspx"><font color="#800080">Windows CE: C# Application to Format TFAT</font></a>), </span>I will show how to use these functions from C#. As for using them from C/C++, you may want to review <a href="http://geekswithblogs.net/BruceEitman/archive/2008/06/25/windows-ce-displaying-disk-information.aspx"><font color="#800080">Windows CE: Displaying Disk Information</font></a> for example code that uses FindFirstStore()/FindNextStore() and FindFirstPartition()/FindNextPartition() to enumerate the mounted disks.</div> <div style="margin: 0in 0in 10pt"> <div style="margin: 0in 0in 10pt"><b>NOTE 1: </b>In FormatDiskTFAT() I have commented out the line “<span style="line-height: 115%">//fo.dwFlags |= FATUTIL_FULL_FORMAT;” because in my testing with both this code and the Storage Manager control panel applet, the full format would not complete.</span></div> <div style="margin: 0in 0in 10pt"><span style="line-height: 115%"> <div style="margin: 0in 0in 10pt"><b><span style="line-height: 115%">NOTE 2: </span></b><span style="line-height: 115%">I made a conscious choice to hardcode the formatting options in FormatDiskTFAT() because while these options are interesting, they just shouldn’t be user options in an embedded system. I could have pushed them up to the caller function, but that opens the door for a confusing user interface.</span></div> </span></div> </div> <div style="text-align: center; line-height: normal" align="center"><span style="font-size: 9pt">Copyright © 2010 – Bruce Eitman</span></div> <div style="text-align: center; line-height: normal; margin: 0in 0in 10pt" align="center"><span style="font-size: 9pt">All Rights Reserved</span></div><img src="http://geekswithblogs.net/BruceEitman/aggbug/141545.aspx" width="1" height="1" /> http://geekswithblogs.net/BruceEitman/comments/141545.aspx 0 http://geekswithblogs.net/BruceEitman/comments/commentRss/141545.aspx http://geekswithblogs.net/BruceEitman/services/trackbacks/141545.aspx http://geekswithblogs.net/BruceEitman/archive/2010/08/18/windows-compact-discussion-forums.aspx 2010-08-18T19:53:38-04:00:00 2011-06-28T09:44:12Z <div style="line-height: normal; margin: 0in 0in 10pt">I monitor some Windows Compact (the new name for Windows CE) Forums for a few reasons:</div> <ul> <li>I learn a lot from others working on Windows CE, so many of you are running into the same issues that I run into.  Sometimes you run into them before I do, other times I have already run into the issue.</li> <li>I learn a lot from answering questions.  You might be surprised to find that sometimes I don't already know the answer, so I do some investigation to get the answer.  Sometimes I am wrong, or there is a better way, with my answer, and there is always someone to point that out.</li> <li>I get satisfaction from helping others by answering their questions</li> </ul> <div style="line-height: normal; margin: 0in 0in 10pt">I monitor the following Forums:</div> <ol> <li><span style="color: #3a3e43"><a href="http://social.msdn.microsoft.com/Forums/en-US/winembmngdapp/threads">Windows Embedded Compact Managed Application Development</a> which discusses C# and VB .NET managed application development</span></li> <li><span style="color: #3a3e43"><a href="http://social.msdn.microsoft.com/Forums/en-US/winembnatapp/threads">Windows Embedded Compact Native Application Development</a> is a forum for discussing C/C++ application development</span></li> <li><span style="color: #3a3e43"><a href="http://social.msdn.microsoft.com/Forums/en-US/winembplatdev/threads"><font color="#800080">Windows Embedded Compact Platform Development</font></a> a forum for discussing issues related to use of Platform Builder for Windows Compact OS development</span></li> </ol> <p> </p> <p><span style="color: #3a3e43">I use Internet Explorer to monitor and answer questions. <a href="http://social.msdn.microsoft.com/Forums/en-US/category/windowsembeddedcompact"><font color="#800080">Windows Embedded Compact Category</font></a> is a page which lists all three of the Windows Compact forums.</span></p> <div style="text-align: center; line-height: normal" align="center"><span style="font-size: 9pt">Copyright © 2010 – Bruce Eitman</span></div> <div style="text-align: center; line-height: normal; margin: 0in 0in 10pt" align="center"><span style="font-size: 9pt">All Rights Reserved</span></div><img src="http://geekswithblogs.net/BruceEitman/aggbug/141374.aspx" width="1" height="1" /> http://geekswithblogs.net/BruceEitman/archive/2010/08/17/platform-builder-write-debug-fix-debug.aspx 2010-08-17T20:28:27-04:00:00 2010-08-17T20:28:27Z <div style="margin: 0in 0in 10pt">The question came up again about how to quickly test an application or driver using Platform Builder and KITL. This article will show how this test cycle can be done quickly without building a new OS and downloading it.</div> <div style="margin: 0in 0in 10pt">Of course Platform Builder is a tool for developing an operating system, so if you use its default behavior it will build an operating system. So that means that a small change to source code means building the operating system and deploying it to your device. But we will look at how we can do things a little differently and speed up the process. </div> <div style="margin: 0in 0in 10pt">The basic steps are:</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><span>1.<span style="font: 7pt 'Times New Roman'">       </span></span>Add KITL support</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><span>2.<span style="font: 7pt 'Times New Roman'">       </span></span>Add Target Control Support (Shell.exe)</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><span>3.<span style="font: 7pt 'Times New Roman'">       </span></span>Leave your app out of the OS, but leave in the registry settings</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><span>4.<span style="font: 7pt 'Times New Roman'">       </span></span>Build your OS</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><span>5.<span style="font: 7pt 'Times New Roman'">       </span></span>Start the OS and connect KITL</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><span>6.<span style="font: 7pt 'Times New Roman'">       </span></span>When your run the app, it will load over your KITL connection</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><span>7.<span style="font: 7pt 'Times New Roman'">       </span></span>Update your app</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><span>8.<span style="font: 7pt 'Times New Roman'">       </span></span>Build your app</div> <div style="text-indent: -0.25in; margin: 0in 0in 10pt 0.5in"><span>9.<span style="font: 7pt 'Times New Roman'">       </span></span>Repeat starting at step 6</div> <div style="margin: 0in 0in 10pt">For this article I am not going to show you everything, but I will describe what I did to write an application and test it using KITL without rebuilding the OS. I am writing this while sitting in an airport, so I am using the emulator but these techniques work just as well with a real device, maybe better.</div> <div style="margin: 0in 0in 10pt">I started by creating a new project, not that this is important but I didn’t have one to work with. I wanted to keep it simple so I chose the Emulator BSP and the Thin Client template. I left out anything that I didn’t need for this article, like the .NET CompactFramework. I double checked that KITL was enabled and that Target Control Support was included. Target Control Support is important to this because it adds support for the \Release folder which links back to the _FLATRELEASEDIR on the development PC. I change the shell from the Thin Client shell to the standard shell, honestly I am not familiar with the Thin Client shell and felt more comfortable with the standard shell for a quick test.</div> <div style="margin: 0in 0in 10pt">Next I added a subproject. I am adding it now, before building the OS, so that it more closely simulates a real world project. The project is a WCE Application and I selected a simple Hello World template. This template doesn’t provide a menu with an option to Exit, so using code from <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/06/windows-ce-setting-an-application-to-display-full-screen-in.aspx"><font color="#800080">Windows CE: Setting an Application to Display Full Screen in C/C++</font></a> I added an exit button. Being able to exit the application being tested will be very important for speeding up the test cycle.</div> <div style="margin: 0in 0in 10pt">We are almost ready to build and test, but first, and this is important for speeding up the test cycle, remove the subproject application from the OS image.   If you are testing a driver, the same thing applies. There are a couple of ways to remove the application from the image:</div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><span>1.<span style="font: 7pt 'Times New Roman'">       </span></span>In the OSDesign Properties, select Configuration Properties\Subproject Image Settings. Double click on the subproject that you are working on, and then select Exclude from Image.<br />  </div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"> </div> <div style="text-indent: -0.25in; margin: 0in 0in 0pt 0.5in"><img width="689" height="422" alt="" src="/images/geekswithblogs_net/BruceEitman/8095/WriteDebugFixDebug/Properties.JPG" /><br /> <br /> It took me a long time to find this property. In prior versions of Platform Builder it was much easier to exclude a file from the OS. For that reason, my first test I used option 2.</div> <div style="text-indent: -0.25in; margin: 0in 0in 10pt 0.5in"><span>2.<span style="font: 7pt 'Times New Roman'">       </span></span>Comment out the file in the bib file.</div> <div style="margin: 0in 0in 10pt">It is finally time to build the OS and run the first test. For this, run Sysgen and attach to the device.</div> <div style="margin: 0in 0in 10pt">Once the OS is running, you can start your application by using Start\Run. Looking at the debug output you will see that the application was loaded by RelFSD, which is the \Release folder.</div> <div style="margin: 0in 0in 10pt"><img width="760" height="196" alt="" src="/images/geekswithblogs_net/BruceEitman/8095/WriteDebugFixDebug/RelfsdDownload.JPG" /></div> <div style="margin: 0in 0in 10pt">That means that the application was downloaded from your _FLATRELEASEDIR and was not in the OS image. If it isn’t in the OS image, which means that we can change it without changing the OS image, or for that matter restarting the device and downloading the image. The application looks like this when I run it:</div> <div style="margin: 0in 0in 10pt"><img width="246" height="372" alt="" src="/images/geekswithblogs_net/BruceEitman/8095/WriteDebugFixDebug/Subproject1.JPG" /></div> <div style="margin: 0in 0in 10pt">The next step is to modify the application. In this case, I want to app to say “The App is running” instead of “Hello World!” So I changed the string table to modify the string that is displayed.  I also fixed the location of the button so that it doesn't sit on top of the text.</div> <div style="margin: 0in 0in 10pt">Now we need to build the application, not the whole OS. I am a command line kind of engineer, so I would open a build window, change directories to the subproject folder and run build. If you like to use Visual Studio, then start by unchecking Build\Targeted Build Settings\Make Run-Time Image After Build, which is important because we don’t need to make the run-time image and the process takes considerable time.   Now you can right click on your subproject in the Solution Explorer and select Build (for this to work well, set the environment variable WINCEREL to 1).</div> <div style="margin: 0in 0in 10pt">Finally, run the application again, now it looks like:</div> <div style="margin: 0in 0in 10pt"><img width="246" height="372" alt="" src="/images/geekswithblogs_net/BruceEitman/8095/WriteDebugFixDebug/Subproject1Changed.JPG" /></div> <div style="margin: 0in 0in 10pt">To use this same technique to test a stream interface driver, leave the driver and its registry settings out of the OS. Then call ActivateDevice() and DeactivateDevice() from your application as shown in <a href="http://geekswithblogs.net/BruceEitman/archive/2008/07/14/windows-ce-loading-a-driver-with-activatedeviceex.aspx"><font color="#800080">Windows CE: Loading a Driver with ActivateDeviceEx</font></a>.</div> <div> </div> <div style="text-align: center; line-height: normal" align="center"><span style="font-size: 9pt">Copyright © 2010 – Bruce Eitman</span></div> <div style="text-align: center; line-height: normal; margin: 0in 0in 10pt" align="center"><span style="font-size: 9pt">All Rights Reserved</span></div><img src="http://geekswithblogs.net/BruceEitman/aggbug/141361.aspx" width="1" height="1" /> http://geekswithblogs.net/BruceEitman/comments/141361.aspx 0 http://geekswithblogs.net/BruceEitman/comments/commentRss/141361.aspx http://geekswithblogs.net/BruceEitman/services/trackbacks/141361.aspx http://geekswithblogs.net/BruceEitman/archive/2010/08/15/windows-ce-disable-the-taskbar-for-full-screen-applications.aspx 2010-08-15T22:59:00-04:00:00 2010-08-15T22:59:00Z <div style="margin: 0in 0in 10pt">In the article <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/06/windows-ce-setting-an-application-to-display-full-screen-in.aspx"><font color="#800080">Windows CE: Setting an Application to Display Full Screen in C/C++</font></a> I discussed how to show an application full screen using C++. I discussed that for a kiosk application that the easiest way to disable the Explorer shell taskbar is to simply not have the Explorer shell launch when the system starts up. But there are cases where having the Explorer shell run underneath the kiosk app has value in some cases. The trouble is that the taskbar will still respond to special keys like the Windows key and suddenly the user has access to the full system. In this article, we will explore disabling the taskbar.</div> <div style="margin: 0in 0in 10pt">The first step to disable the taskbar is to get a handle to the taskbar window. To do this we will use FindWindow() and the class name of the taskbar which is “HHTaskBar”. We know that the name is HHTaskBar because the code for the taskbar is available in Platform Builder and a review of the code tells us the name. So to get a handle to the taskbar window:</div> <div style="margin: 0in 0in 10pt"><span>                HWND TaskBar = FindWindow(TEXT(<span style="color: #a31515">"HHTaskBar"</span>), NULL );</span></div> <div style="margin: 0in 0in 10pt">Now that we have a handle to the taskbar window, we can send it messages. We could send it a WM_CLOSE message:</div> <div style="margin: 0in 0in 10pt"><span>                SendMessage(TaskBar, WM_CLOSE, NULL, NULL );</span></div> <div style="margin: 0in 0in 10pt">But, that will close the Explore shell, which defeats the purpose which is to keep the Explorer shell running and have access to the APIs that it provides.</div> <div style="margin: 0in 0in 10pt">Better is to hide the taskbar, not in the sense of setting its auto hide feature which leaves it usable but minimized. Instead we will disable it with a call to EnableWindow():</div> <div style="margin: 0in 0in 10pt"><span>                EnableWindow( TaskBar, FALSE );</span></div> <div style="margin: 0in 0in 10pt">Which also allows us to reenable the taskbar if and when we need to do so.</div> <div style="margin: 0in 0in 10pt">In the modified full screen application from <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/06/windows-ce-setting-an-application-to-display-full-screen-in.aspx"><font color="#800080">Windows CE: Setting an Application to Display Full Screen in C/C++</font></a>, the WinMain() is now:</div> <div><span style="color: blue">int</span> WINAPI WinMain(HINSTANCE hInstance,</div> <div><span>                   HINSTANCE hPrevInstance,</span></div> <div><span>                   LPTSTR    lpCmdLine,</span></div> <div><span>                   <span style="color: blue">int</span>       nCmdShow)</span></div> <div>{</div> <div><span>                MSG msg;</span></div> <div> </div> <div><span>                <span style="color: blue">if</span>( lpCmdLine )</span></div> <div><span>                                SignalStarted( _wtol(lpCmdLine) );</span></div> <div><span>                HWND TaskBar = FindWindow(TEXT(<span style="color: #a31515">"HHTaskBar"</span>), NULL );</span></div> <div><span>                <span style="color: blue">if</span>( TaskBar != NULL )</span></div> <div><span>                {</span></div> <div><span>                                EnableWindow( TaskBar, FALSE );</span></div> <div><span>                }</span></div> <div> </div> <div><span>                <span style="color: green">// Perform application initialization:</span></span></div> <div><span>                <span style="color: blue">if</span> (!InitInstance(hInstance, nCmdShow)) </span></div> <div><span>                {</span></div> <div><span>                                <span style="color: blue">if</span>( TaskBar != NULL )</span></div> <div><span>                                {</span></div> <div><span>                                                EnableWindow( TaskBar, TRUE );</span></div> <div><span>                                }</span></div> <div><span>                                <span style="color: blue">return</span> FALSE;</span></div> <div><span>                }</span></div> <div> </div> <div><span>                HACCEL hAccelTable;</span></div> <div><span>                hAccelTable = LoadAccelerators(hInstance, MAKEINTRESOURCE(IDC_DELETEMENEXT));</span></div> <div> </div> <div><span>                <span style="color: green">// Main message loop:</span></span></div> <div><span>                <span style="color: blue">while</span> (GetMessage(&amp;msg, NULL, 0, 0)) </span></div> <div><span>                {</span></div> <div><span>                                <span style="color: blue">if</span> (!TranslateAccelerator(msg.hwnd, hAccelTable, &amp;msg)) </span></div> <div><span>                                {</span></div> <div><span>                                                TranslateMessage(&amp;msg);</span></div> <div><span>                                                DispatchMessage(&amp;msg);</span></div> <div><span>                                }</span></div> <div><span>                }</span></div> <div><span>                TaskBar = FindWindow(TEXT(<span style="color: #a31515">"HHTaskBar"</span>), NULL );</span></div> <div><span>                <span style="color: blue">if</span>( TaskBar != NULL )</span></div> <div><span>                {</span></div> <div><span>                                EnableWindow( TaskBar, TRUE );</span></div> <div><span>                }</span></div> <div><span>                <span style="color: blue">return</span> (<span style="color: blue">int</span>) msg.wParam;</span></div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">Which not only disables the taskbar when the application starts, but reenables it when the application exits.</div> <div style="text-align: center; line-height: normal" align="center"><span style="font-size: 9pt">Copyright © 2010 – Bruce Eitman</span></div> <div style="text-align: center; line-height: normal; margin: 0in 0in 10pt" align="center"><span style="font-size: 9pt">All Rights Reserved</span></div><img src="http://geekswithblogs.net/BruceEitman/aggbug/141326.aspx" width="1" height="1" /> http://geekswithblogs.net/BruceEitman/comments/141326.aspx 0 http://geekswithblogs.net/BruceEitman/comments/commentRss/141326.aspx http://geekswithblogs.net/BruceEitman/services/trackbacks/141326.aspx http://geekswithblogs.net/BruceEitman/archive/2010/08/06/windows-ce-setting-an-application-to-display-full-screen-in.aspx 2010-08-06T22:47:16-04:00:00 2010-08-06T22:58:37Z <div style="margin: 0in 0in 10pt">Many, maybe even most, Windows CE devices are single purpose devices that have an application that fills the entire screen. So of course setting the application to entirely fill the display is important. In this article we will explore setting an application to display full screen using C/C++.</div> <div style="margin: 0in 0in 10pt">My plan is to create a simple application that fills the screen with white and displays two buttons, exit and explore. Those may be odd buttons for a kiosk application, but they will come in handy while working on this application. The exit button will exit the application and the explore button will start the Explorer shell and then exit the application.</div> <div style="margin: 0in 0in 10pt">Working in Visual Studio 2005, I started by creating a new C++ Win32 Smart Device Application and let the wizard create the starting source code. I then deleted the code for the menu and the about dialog since I don’t need them. If we run the application now we will find two things about it; we can’t exit (now you know why I am going to add the exit button) and the Explorer shell’s task bar is filling part of the screen.</div> <div style="margin: 0in 0in 10pt">The application almost fills the screen. This is because the CreateWindow() call that was added by Visual Studio set the location and size using <span style="line-height: 115%; font-size: 10pt">CW_USEDEFAULT</span>. This causes the application size to be full screen, minus the task bar area.</div> <div style="margin: 0in 0in 10pt">Next let’s add the exit button. To do that, I added a global HWND and create the button with CreateWindow() in InitInstance():</div> <div style="margin: 0in 0in 10pt"> </div> <div style="line-height: normal"><span style="font-size: 10pt">HWND ExitButton;</span></div> <div style="margin: 0in 0in 10pt"> …</div> <div style="line-height: normal"><span style="font-size: 10pt">      ExitButton = CreateWindow(TEXT(<span style="color: #a31515">"Button"</span>),TEXT(<span style="color: #a31515">"Exit"</span>),</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            BS_PUSHBUTTON | WS_CHILD | WS_VISIBLE ,</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            20,20,100,40,hWnd,(HMENU)IDM_FILE_EXIT,g_hInst,0);    </span></div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: blue">if</span>( ExitButton == NULL )</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            DWORD Error = GetLastError();</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            RETAILMSG( 1, (TEXT(<span style="color: #a31515">"ExitButton failed %d\r\n"</span>), Error));</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: blue">return</span> FALSE;</span></div> <div><span>                }</span></div> <div>…</div> <div style="line-height: normal"><span style="font-size: 10pt">                              DestroyWindow(ExitButton);</span></div> <div> </div> <div style="margin: 0in 0in 10pt">Note that the button size and location are hardcoded, we will look at that later. When the button is pressed, the existing action for closing the application will be called, with the edition of a call to DestroyWindow() for the button. If you test the application now, the exit button will be placed in the top left corner and pressing the button will exit the application.</div> <div style="margin: 0in 0in 10pt">Let’s step back for little bit, this application is going to run in kiosk mode. That is the application will be full screen and we don’t need the Explorer shell. I discussed how to do this in a previous article, <a href="http://geekswithblogs.net/BruceEitman/archive/2008/06/30/windows-ce-starting-an-application-when-the-system-boots.aspx"><font color="#800080">Windows CE: Starting an Application when the System Boots</font></a>. My next step is to add the application to the OS and change the registry so that the Explorer shell doesn’t start and instead this applciation does start. The effect of this change is that the applciation now is full screen. We must add a call to SignalStarted():</div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: blue">if</span>( lpCmdLine )</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            SignalStarted( _wtol(lpCmdLine) );</span></div> <div style="margin: 0in 0in 10pt"> </div> <div style="margin: 0in 0in 10pt">My work here is done. But I will continue.</div> <div style="margin: 0in 0in 10pt">Now if we test the application by pressing the Exit button, what we will find is that the application stops, but it doesn’t look like it stops because there is nothing to draw on the display. Since we don’t expect this condition in the real world, I am not going to do anything about it. But what I would like to do is start the explorer shell for testing and debugging purposes. To do that lets’s add the Explore button now. The explore button is similar to the exit button, but we will need to add more handling code to support it.</div> <div style="line-height: normal"><span style="font-size: 10pt">HWND ExplorerShellButton;</span></div> <div>…</div> <div style="line-height: normal"><span style="font-size: 10pt">      ExplorerShellButton = CreateWindow(TEXT(<span style="color: #a31515">"Button"</span>),TEXT(<span style="color: #a31515">"Explore"</span>),</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            BS_PUSHBUTTON | WS_CHILD | WS_VISIBLE ,</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            20 + 10 + 100,20,100,40,hWnd,(HMENU)IDM_EXPLORER_BUTTON,g_hInst,0);     </span></div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: blue">if</span>( ExplorerShellButton == NULL )</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            DWORD Error = GetLastError();</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            RETAILMSG( 1, (TEXT(<span style="color: #a31515">"ExplorerShellButton failed %d\r\n"</span>), Error));</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: blue">return</span> FALSE;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      }</span></div> <div>…</div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: blue">case</span> IDM_EXPLORER_BUTTON:</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            TCHAR *AppName = TEXT(<span style="color: #a31515">"Explorer.exe"</span>);</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            TCHAR *CommandLine = NULL;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            PROCESS_INFORMATION pi;</span></div> <div style="line-height: normal"> </div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: blue">if</span>( CreateProcess( AppName, CommandLine, NULL, NULL, FALSE, 0, NULL, NULL, NULL, &amp;pi))</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  CloseHandle(pi.hProcess);</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  CloseHandle(pi.hThread);</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            }</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: blue">else</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">            {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  RETAILMSG( 1, (TEXT(<span style="color: #a31515">"Failed to start app: %s error %d\n"</span>), AppName, GetLastError() ));</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            }</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      }</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: green">//Fall through and exit</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt"><span style="color: green"> <div style="line-height: normal"><span style="color: #000000"><span style="font-size: 10pt">…</span></span></div> <div style="line-height: normal"><span style="color: #000000"><span style="font-size: 10pt">      DestroyWindow(ExplorerShellButton);</span></span></div> </span></span></div> <div><span style="color: #000000"> </span></div> <div>And in resource.h:</div> <div style="margin: 0in 0in 10pt"><span style="color: blue">#define</span> IDM_EXPLORER_BUTTON<span>                   40003</span></div> <div style="margin: 0in 0in 10pt">Now when we test the application, the exit button works like it did before, but we can now use the Explore button to start up the Explorer shell before exiting. If you are testing with the Explorer shell already running, you will find that Windows Explorer starts.</div> <div style="margin: 0in 0in 10pt">Some of you are problably thinking that for some reason or another you need the Explorer shell running under your application. So you need the application to run full screen even when the task bar is available. To solve this, modify InitInstance() to find out the dimensions of the display and set the application to be top most and use the dimension of the display. The application can find the dimensions of the display using GetDeviceCaps(), and then use the dimensions in a call to SetWindowPosition():</div> <div style="line-height: normal"><span style="font-size: 10pt">      HDC hDC;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      DWORD Width;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      DWORD Height;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">…</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      hDC = GetDC(NULL);</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      Width = GetDeviceCaps( hDC, HORZRES );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      Height = GetDeviceCaps( hDC, VERTRES );</span></div> <div style="line-height: normal"> </div> <div style="margin: 0in 0in 10pt"><span>                SetWindowPos(hWnd, HWND_TOPMOST,0, 0, Width, Height, 0 );</span></div> <div style="margin: 0in 0in 10pt">Now that we have the screen dimensions, I can move the buttons down to the bottom right where I think that they will be better placed:</div> <div style="line-height: normal"><span style="font-size: 10pt">      ExitButton = CreateWindow(TEXT(<span style="color: #a31515">"Button"</span>),TEXT(<span style="color: #a31515">"Exit"</span>),</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            BS_PUSHBUTTON | WS_CHILD | WS_VISIBLE ,</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            Width - 200 - 20 - 10, Height - 40 - 20,100,40,hWnd,(HMENU)IDM_FILE_EXIT,g_hInst,0); </span></div> <div style="line-height: normal"><span style="font-size: 10pt">…</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      ExplorerShellButton = CreateWindow(TEXT(<span style="color: #a31515">"Button"</span>),TEXT(<span style="color: #a31515">"Explore"</span>),</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            BS_PUSHBUTTON | WS_CHILD | WS_VISIBLE ,</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            Width - 100 - 20, Height - 40 - 20,100,40,hWnd,(HMENU)IDM_EXPLORER_BUTTON,g_hInst,0);</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      </span></div> <div style="line-height: normal"> <div style="line-height: normal">Now we have an application that displays full screen. </div> <div style="line-height: normal"> </div> <div style="line-height: normal">As you test the application with the Explorer shell still running, you will find that there is still a problem if the user has a full keyboard and can use hot keys like the Windows key. I would strongly urge you to consider running your kiosk application without the Explorer shell, so I won’t go into solving that problem now. If your application isn’t a kiosk application, but needs to be full screen, then you should consider leaving support for the hot keys, but I do know that sometimes that isn’t practical.</div>  </div> <div style="margin: 0in 0in 10pt"> </div> <div style="text-align: center; line-height: normal" align="center"><span style="font-size: 9pt">Copyright © 2010 – Bruce Eitman</span></div> <div style="text-align: center; line-height: normal; margin: 0in 0in 10pt" align="center"><span style="font-size: 9pt">All Rights Reserved</span></div><img src="http://geekswithblogs.net/BruceEitman/aggbug/141233.aspx" width="1" height="1" /> http://geekswithblogs.net/BruceEitman/comments/141233.aspx 0 http://geekswithblogs.net/BruceEitman/comments/commentRss/141233.aspx http://geekswithblogs.net/BruceEitman/services/trackbacks/141233.aspx http://geekswithblogs.net/BruceEitman/archive/2010/08/05/windows-ce-launching-an-application-when-a-network-connects.aspx 2010-08-05T21:07:06-04:00:00 2010-08-05T21:07:06Z <div style="margin: 0in 0in 10pt">I was working on a headless system recently and wanted to run cemgrc.exe when a network connection was made. That inspired me to write a little application to do it.</div> <div style="margin: 0in 0in 10pt">I decided to make the application flexible, so I added a few requirements; be able to run from HKEY_LOCAL_MACHINE\Init, and read the application name and command line from the registry.</div> <div style="margin: 0in 0in 10pt">Working backward, I wrote a function to read the registry to get the application name and command line and then start the application using CreateProcess(). Regular readers of this blog will recognize most of this code from <a href="http://geekswithblogs.net/BruceEitman/archive/2008/06/11/windows-ce-reading-a-string-from-the-registry.aspx"><font color="#800080">Windows CE: Reading a String from the Registry</font></a>.</div> <div style="line-height: normal"><span style="color: blue; font-size: 10pt">void</span><span style="font-size: 10pt"> StartApp()</span></div> <div style="line-height: normal"><span style="font-size: 10pt">{</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      TCHAR *AppName = NULL;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      TCHAR *CommandLine = NULL;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      DWORD Result;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      HKEY hKey;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      DWORD NumBytes = 0;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      DWORD Type;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      PROCESS_INFORMATION pi;</span></div> <div style="line-height: normal"> </div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: green">// Open the Registry Key</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">      Result = RegOpenKeyEx(HKEY_LOCAL_MACHINE, NETWORK_START_APP_KEY, 0, 0, &amp;hKey);</span></div> <div style="line-height: normal"><span style="font-size: 10pt"> </span></div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: blue">if</span>( ERROR_SUCCESS == Result )</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: green">// This is a fake read, all it does is fill in NumBytes with the number of</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: green">// bytes in the string value plus the null character.</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">            Result = RegQueryValueEx( hKey, NETWORK_START_APP_NAME, NULL, &amp;Type, NULL, &amp;NumBytes );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: blue">if</span>( NumBytes &gt; 0 )</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  <span style="color: green">// Now we know how big the string is allocate and read it</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  AppName = (TCHAR *)malloc( NumBytes );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  <span style="color: blue">if</span>( AppName != NULL )</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  Result = RegQueryValueEx( hKey, NETWORK_START_APP_NAME, NULL, &amp;Type, </span></div> <div style="line-height: normal"><span style="font-size: 10pt">                                                            (LPBYTE)AppName, &amp;NumBytes );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            }</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: green">// This is a fake read, all it does is fill in NumBytes with the number of</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: green">// bytes in the string value plus the null character.</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">            Result = RegQueryValueEx( hKey, NETWORK_START_APP_COMMANDLINE, NULL, &amp;Type, NULL, &amp;NumBytes );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: blue">if</span>( NumBytes &gt; 0 )</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  <span style="color: green">// Now we know how big the string is allocate and read it</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  CommandLine = (TCHAR *)malloc( NumBytes );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  <span style="color: blue">if</span>( CommandLine != NULL )</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  Result = RegQueryValueEx( hKey, NETWORK_START_APP_COMMANDLINE, NULL, &amp;Type, </span></div> <div style="line-height: normal"><span style="font-size: 10pt">                                                            (LPBYTE)CommandLine, &amp;NumBytes );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            }</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            RegCloseKey( hKey );</span></div> <div style="line-height: normal"> </div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: blue">if</span>( CreateProcess( AppName, CommandLine, NULL, NULL, FALSE, 0, NULL, NULL, NULL, &amp;pi))</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  CloseHandle(pi.hProcess);</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  CloseHandle(pi.hThread);</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            }</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: blue">else</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">            {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  RETAILMSG( 1, (TEXT(<span style="color: #a31515">"Failed to start app: %s error %d\n"</span>), AppName, GetLastError() ));</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            }</span></div> <div style="line-height: normal"> </div> <div style="line-height: normal"><span style="font-size: 10pt">            free( AppName );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            free( CommandLine );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      }</span></div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">StartApp() is really the meat of this application, now we just need to determine if we are running because of a network connection or not and we need to register for network notifications. I do all of this in WinMain():</div> <div style="line-height: normal"><span style="color: blue; font-size: 10pt">int</span><span style="font-size: 10pt"> WINAPI WinMain( HINSTANCE hInstance,</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                    HINSTANCE hPrevInstance,</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                    LPTSTR    lpCmdLine,</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                    <span style="color: blue">int</span>       nCmdShow)</span></div> <div style="line-height: normal"><span style="font-size: 10pt">{</span></div> <div style="line-height: normal"><span style="font-size: 10pt">    TCHAR Path[MAX_PATH];</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      HANDLE hMutex;</span></div> <div style="line-height: normal"> </div> <div style="line-height: normal"><span style="font-size: 10pt">    GetModuleFileName( hInstance, Path, MAX_PATH );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      hMutex = CreateMutex(NULL, TRUE, Path);</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: blue">if</span> (GetLastError() == ERROR_ALREADY_EXISTS){</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            RETAILMSG(1, (TEXT(<span style="color: #a31515">"%s is running already\r\n"</span>), Path));</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: blue">return</span> 0;</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      }</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      </span></div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: blue">if</span>( lpCmdLine &amp;&amp; 0 != wcscmp(lpCmdLine, TEXT(<span style="color: #a31515">"AppRunAtNetConnect"</span>)) ) </span></div> <div style="line-height: normal"><span style="font-size: 10pt">      {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: blue">if</span>( !CeRunAppAtEvent(Path, NOTIFICATION_EVENT_NET_CONNECT) )</span></div> <div style="line-height: normal"><span style="font-size: 10pt">                  RETAILMSG(1, (TEXT(<span style="color: #a31515">"Could not register for notifications\r\n"</span>)));</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            SignalStarted( _wtol(lpCmdLine) );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      }</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: blue">else</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">      {</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            StartApp();</span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: green">// Okay this is maybe wrong, but it prevents running again if we </span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">            <span style="color: green">// are run more than once on a network connection</span></span></div> <div style="line-height: normal"><span style="font-size: 10pt">            Sleep( 5000 );</span></div> <div style="line-height: normal"><span style="font-size: 10pt">      }</span></div> <div style="line-height: normal"> </div> <div style="line-height: normal"><span style="font-size: 10pt">      <span style="color: blue">return</span> 1;</span></div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">Note that if this isn’t a network connection, then the code calls CeRunAppAtEvent() to register for network notifications and calls SignalStarted() in case the application was started from HKEY_LOCAL_MACHINE\Init.</div> <div style="margin: 0in 0in 10pt">This file includes and defines the following:</div> <div style="line-height: normal"><span style="color: blue; font-size: 10pt">#include</span><span style="font-size: 10pt"> <span style="color: #a31515">&lt;windows.h&gt;</span></span></div> <div style="line-height: normal"><span style="color: blue; font-size: 10pt">#include</span><span style="font-size: 10pt"> <span style="color: #a31515">&lt;commctrl.h&gt;</span></span></div> <div style="line-height: normal"><span style="color: blue; font-size: 10pt">#include</span><span style="font-size: 10pt"> <span style="color: #a31515">&lt;notify.h&gt;</span></span></div> <div style="line-height: normal"> </div> <div style="line-height: normal"><span style="color: blue; font-size: 10pt">#define</span><span style="font-size: 10pt"> NETWORK_START_APP_KEY (TEXT(<span style="color: #a31515">"Software\\NetworkLauncher"</span>))</span></div> <div style="line-height: normal"><span style="color: blue; font-size: 10pt">#define</span><span style="font-size: 10pt"> NETWORK_START_APP_NAME      (TEXT(<span style="color: #a31515">"AppName"</span>))</span></div> <div style="line-height: normal"><span style="color: blue; font-size: 10pt">#define</span><span style="font-size: 10pt"> NETWORK_START_APP_COMMANDLINE     (TEXT(<span style="color: #a31515">"CommandLine"</span>))</span></div> <div> </div> <div style="margin: 0in 0in 10pt">And now when a network connection is made, I can start cemgrc.exe.</div> <div style="margin: 0in 0in 10pt"> </div> <div style="text-align: center; line-height: normal" align="center"><span style="font-size: 9pt">Copyright © 2010 – Bruce Eitman</span></div> <div style="text-align: center; line-height: normal; margin: 0in 0in 10pt" align="center"><span style="font-size: 9pt">All Rights Reserved</span></div><img src="http://geekswithblogs.net/BruceEitman/aggbug/141207.aspx" width="1" height="1" /> http://geekswithblogs.net/BruceEitman/comments/141207.aspx 0 http://geekswithblogs.net/BruceEitman/comments/commentRss/141207.aspx http://geekswithblogs.net/BruceEitman/services/trackbacks/141207.aspx http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-writing-an-application-to-test-gpio-pins.aspx 2010-08-01T19:33:25-04:00:00 2010-08-01T20:46:33Z <div style="margin: 0in 0in 10pt"> <div style="margin: 0in 0in 10pt"> <table border="1" cellspacing="0" cellpadding="0" style="border-bottom: medium none; border-left: medium none; border-collapse: collapse; background: #d9d9d9; border-top: medium none; border-right: medium none"> <tbody> <tr> <td valign="top" width="172" style="border-bottom: gray 2.25pt solid; border-left: #d9d9d9 2.25pt solid; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 200.35pt; padding-right: 5.4pt; border-top: #d9d9d9 2.25pt solid; border-right: gray 2.25pt solid; padding-top: 0in"> <div style="line-height: normal; margin: 0in 0in 0pt">   <a href="http://eurotech-inc.com/Wince-code/GPIO_Example.asp"><font color="#800080"><strong>Download GPIO Example driver and appplication source code</strong></font></a></div> </td> </tr> </tbody> </table> </div> </div> <div style="margin: 0in 0in 10pt">In previous articles I have developed a driver to access GPIO Pins, <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-using-a-driver-to-readwrite-hardware-registers.aspx"><font color="#800080">Windows CE: Using a Driver to Read/Write Hardware Registers</font></a>, and a wrapper API for the driver, <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-developing-an-api-to-access-a-driver.aspx"><font color="#800080">Windows CE: Developing an API to Access a Driver</font></a>. Now it is time to use them from an application.</div> <div style="margin: 0in 0in 10pt">Because the real work is done in the driver, and because we have some simple to use wrapper functions, this application is very simple. It starts by calling the InitGPIOAPI() function, then it sets GPIO Pin 30 to be an output and then toggles the pin high and low.</div> <div>#include &lt;Windows.h&gt;</div> <div>#include &lt;GPIO_API.h&gt;</div> <div> </div> <div>int WINAPI WinMain(     HINSTANCE hInstance,</div> <div>                                                                                HINSTANCE hPrevInstance,</div> <div>                                                                                LPTSTR    lpCmdLine,</div> <div>                                                                                int       nCmdShow)</div> <div>{</div> <div>                HANDLE hGPIO_API;     </div> <div>                DWORD count;</div> <div> </div> <div>                RETAILMSG( 1, (TEXT("Testing GPIO\n")));</div> <div> </div> <div>                hGPIO_API = InitGPIOAPI();</div> <div> </div> <div>                if( hGPIO_API != INVALID_HANDLE_VALUE )</div> <div>                {</div> <div>                                SetOutputGPIOPin( hGPIO_API, 30 );</div> <div> </div> <div>                                for( count = 0; count &lt; 20; count++ )</div> <div>                                {</div> <div>                                                SetGPIOPin( hGPIO_API, 30 );</div> <div>                                                RETAILMSG( 1, (TEXT( "set GPIO 30 is %s\r\n"), ReadGPIOPin(hGPIO_API, 30)?TEXT("Set"):TEXT("Clear")));</div> <div>                                                Sleep( 1000 );</div> <div> </div> <div>                                                ClearGPIOPin( hGPIO_API, 30 );</div> <div>                                                RETAILMSG( 1, (TEXT( "clear GPIO 30 is %s\r\n"), ReadGPIOPin(hGPIO_API, 30)?TEXT("Set"):TEXT("Clear")));</div> <div>                                                Sleep( 1000 );</div> <div>                                }</div> <div>                                DeinitGPIOAPI( hGPIO_API );</div> <div>                }</div> <div>                RETAILMSG(1,(TEXT("Done\n")));</div> <div> </div> <div>                return 0;</div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">  <div style="margin: 0in 0in 10pt">Also see the articles in this series at: <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-developing-an-api-to-access-a-driver.aspx"><font color="#800080">Windows CE: Developing an API to Access a Driver</font></a> and  <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-using-a-driver-to-readwrite-hardware-registers.aspx"><font color="#800080">Windows CE: Using a Driver to Read/Write Hardware Registers</font></a>.</div> </div> <div style="text-align: center; line-height: normal" align="center"><span style="font-size: 9pt">Copyright © 2010 – Bruce Eitman</span></div> <div style="text-align: center; line-height: normal; margin: 0in 0in 10pt" align="center"><span style="font-size: 9pt">All Rights Reserved</span></div><img src="http://geekswithblogs.net/BruceEitman/aggbug/141148.aspx" width="1" height="1" /> http://geekswithblogs.net/BruceEitman/comments/141148.aspx 14 http://geekswithblogs.net/BruceEitman/comments/commentRss/141148.aspx http://geekswithblogs.net/BruceEitman/services/trackbacks/141148.aspx http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-developing-an-api-to-access-a-driver.aspx 2010-08-01T17:48:25-04:00:00 2010-08-01T20:42:36Z <div style="margin: 0in 0in 10pt"> <table border="1" cellspacing="0" cellpadding="0" style="border-bottom: medium none; border-left: medium none; border-collapse: collapse; background: #d9d9d9; border-top: medium none; border-right: medium none"> <tbody> <tr> <td valign="top" width="172" style="border-bottom: gray 2.25pt solid; border-left: #d9d9d9 2.25pt solid; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 200.35pt; padding-right: 5.4pt; border-top: #d9d9d9 2.25pt solid; border-right: gray 2.25pt solid; padding-top: 0in"> <div style="line-height: normal; margin: 0in 0in 0pt">   <a href="http://eurotech-inc.com/Wince-code/GPIO_Example.asp"><font color="#800080"><strong>Download GPIO Example driver and appplication source code</strong></font></a></div> </td> </tr> </tbody> </table> </div> <div style="margin: 0in 0in 10pt">In my article on reading and writing GPIO pins from a driver (see <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-using-a-driver-to-readwrite-hardware-registers.aspx"><font color="#800080">Windows CE: Using a Driver to Read/Write Hardware Registers</font></a>) I developed a driver that exposes GPIO pins through DeviceIoControl() calls to the driver’s XXX_IOControl() function.   Using DeviceIoControl() can be messy, so developing wrapper functions helps clean that up, but if the driver developer also created the wrapper and provided it as an API that would help.</div> <div style="margin: 0in 0in 10pt">An API is really just a lib file, or DLL, that exposes some functions.   In this case, we will expose the functions from a statically linked library, but it would be a very minor change to provide them as a DLL included in the OS.</div> <div style="margin: 0in 0in 10pt">To start, this API will provide a init and deinit functions that will gain access to the driver through CreateFile() and then clean up with CloseHandle():</div> <div>HANDLE InitGPIOAPI()</div> <div>{</div> <div>                HANDLE hDriver;</div> <div> </div> <div>                // Get a handle to the driver. Which causes the driver's XXX_Open function to be called</div> <div>                hDriver = CreateFile( TEXT("XXX1:"), GENERIC_READ|GENERIC_WRITE, FILE_SHARE_READ|FILE_SHARE_WRITE, NULL, OPEN_EXISTING, 0, 0 );</div> <div>               </div> <div>                return hDriver;</div> <div>}</div> <div> </div> <div>void DeinitGPIOAPI( HANDLE hDriver )</div> <div>{</div> <div>                CloseHandle( hDriver );</div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">Now we wrapper each of the IOCTL calls:</div> <div>BOOL SetGPIOPin( HANDLE hDriver, DWORD PinNumber )</div> <div>{</div> <div>                DWORD BytesHandled;</div> <div> </div> <div>                return DeviceIoControl( hDriver,</div> <div>                                IOCTL_SET_GPIO,</div> <div>                                &amp;PinNumber,</div> <div>                                sizeof( PinNumber ),</div> <div>                                NULL,</div> <div>                                0,</div> <div>                                &amp;BytesHandled,</div> <div>                                NULL );</div> <div>}</div> <div> </div> <div>BOOL ClearGPIOPin( HANDLE hDriver, DWORD PinNumber )</div> <div>{</div> <div>                DWORD BytesHandled;</div> <div> </div> <div>                return DeviceIoControl( hDriver,</div> <div>                                IOCTL_CLEAR_GPIO,</div> <div>                                &amp;PinNumber,</div> <div>                                sizeof( PinNumber ),</div> <div>                                NULL,</div> <div>                                0,</div> <div>                                &amp;BytesHandled,</div> <div>                                NULL );</div> <div>}</div> <div> </div> <div>BOOL SetInputGPIOPin( HANDLE hDriver, DWORD PinNumber )</div> <div>{</div> <div>                DWORD BytesHandled;</div> <div> </div> <div>                return DeviceIoControl( hDriver,</div> <div>                                IOCTL_SET_INPUT_GPIO,</div> <div>                                &amp;PinNumber,</div> <div>                                sizeof( PinNumber ),</div> <div>                                NULL,</div> <div>                                0,</div> <div>                                &amp;BytesHandled,</div> <div>                                NULL );</div> <div>}</div> <div> </div> <div>BOOL SetOutputGPIOPin( HANDLE hDriver, DWORD PinNumber )</div> <div>{</div> <div>                DWORD BytesHandled;</div> <div> </div> <div>                return DeviceIoControl( hDriver,</div> <div>                                IOCTL_SET_OUTPUT_GPIO,</div> <div>                                &amp;PinNumber,</div> <div>                                sizeof( PinNumber ),</div> <div>                                NULL,</div> <div>                                0,</div> <div>                                &amp;BytesHandled,</div> <div>                                NULL );</div> <div>}</div> <div> </div> <div>BOOL ReadGPIOPin( HANDLE hDriver, DWORD PinNumber )</div> <div>{</div> <div>                DWORD BytesHandled;</div> <div>                DWORD GPIOValue;</div> <div> </div> <div>                DeviceIoControl( hDriver,</div> <div>                                IOCTL_READ_GPIO,</div> <div>                                &amp;PinNumber,</div> <div>                                sizeof( PinNumber ),</div> <div>                                &amp;GPIOValue,</div> <div>                                sizeof(GPIOValue),</div> <div>                                &amp;BytesHandled,</div> <div>                                NULL );</div> <div> </div> <div>                return GPIOValue &amp; 1;</div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">See how simple that was? And our application developers will love us for it because their code can be very simple. This code will even be easy for them to use from C# with a simple P/Invoke.</div> <div style="margin: 0in 0in 10pt">The sources file is straight forward for those of you using Platform Builder:</div> <div>TARGETNAME=GPIO_API</div> <div>TARGETTYPE=LIBRARY</div> <div>RELEASETYPE=PLATFORM</div> <div> </div> <div>SOURCES= \</div> <div>                GPIO_API.c</div> <div> </div> <div style="margin: 0in 0in 10pt">INCLUDES=$(INCLUDES);..\Inc</div> <div style="margin: 0in 0in 10pt">To turn this into a DLL, simply change the TARGETTYPE to DYNLINK and add a def file.</div> <div style="margin: 0in 0in 10pt">  <div style="margin: 0in 0in 10pt">Also see the articles in this series at: <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-writing-an-application-to-test-gpio-pins.aspx"><font color="#800080">Windows CE: Writing an Application to Test GPIO Pins</font></a> and <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-using-a-driver-to-readwrite-hardware-registers.aspx"><font color="#800080">Windows CE: Using a Driver to Read/Write Hardware Registers</font></a>.</div> </div> <div style="text-align: center; line-height: normal" align="center"><span style="font-size: 9pt">Copyright © 2010 – Bruce Eitman</span></div> <div style="text-align: center; line-height: normal; margin: 0in 0in 10pt" align="center"><span style="font-size: 9pt">All Rights Reserved</span></div><img src="http://geekswithblogs.net/BruceEitman/aggbug/141145.aspx" width="1" height="1" /> http://geekswithblogs.net/BruceEitman/comments/141145.aspx 4 http://geekswithblogs.net/BruceEitman/comments/commentRss/141145.aspx http://geekswithblogs.net/BruceEitman/services/trackbacks/141145.aspx http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-using-a-driver-to-readwrite-hardware-registers.aspx 2010-08-01T16:21:10-04:00:00 2011-06-10T11:25:16Z <div style="margin: 0in 0in 10pt"> <table border="1" cellspacing="0" cellpadding="0" style="border-bottom: medium none; border-left: medium none; border-collapse: collapse; background: #d9d9d9; border-top: medium none; border-right: medium none"> <tbody> <tr> <td valign="top" width="172" style="border-bottom: gray 2.25pt solid; border-left: #d9d9d9 2.25pt solid; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 200.35pt; padding-right: 5.4pt; border-top: #d9d9d9 2.25pt solid; border-right: gray 2.25pt solid; padding-top: 0in"> <div style="line-height: normal; margin: 0in 0in 0pt">   <a href="http://eurotech-inc.com/Wince-code/GPIO_Example.asp"><font color="#800080"><strong>Download GPIO Example driver and appplication source code</strong></font></a></div> </td> </tr> </tbody> </table> </div> <div style="margin: 0in 0in 10pt">A recent discussion thread in the <a href="http://social.msdn.microsoft.com/Forums/en-US/winembplatdev/threads"><font color="#800080">Windows Embedded Compact Platform Development</font></a> forum made it clear to me that for new Windows CE Software Engineers doing something as simple as accessing a hardware register can be very difficult. In the old days, Windows CE 5.0 and before, it was very easy; write an application that allocates a virtual address and then read or write a register. The problem with that is that allowing applications to access registers is a serious security and system stability problem. So in Windows CE 6.0 Microsoft fixed that and now only the kernel or kernel mode drivers can access hardware registers.</div> <div style="margin: 0in 0in 10pt">In the discussion thread, I suggested that the solution is to use my Driver Shell as a starting point to added code to access the CPU GPIO registers. In this article, I will do just that and then follow up with a series of articles that show how to use the driver to read and write GPIO pins using an set of wrapper APIs and an application.</div> <div style="margin: 0in 0in 10pt">I have discussed stream interface drivers in previous articles (see <a href="http://geekswithblogs.net/BruceEitman/archive/2008/06/09/windows-ce-a-stream-interface-shell.aspx"><font color="#800080">Windows CE: A Stream Interface Driver Shell</font></a>, <a href="http://geekswithblogs.net/BruceEitman/archive/2008/07/07/windows-ce-stream-interface-driver-dllentry.aspx"><font color="#800080">Windows CE: Stream Interface Driver, DllEntry()</font></a>, <a href="http://geekswithblogs.net/BruceEitman/archive/2008/08/07/windows-ce-stream-interface-driver-xxx_init.aspx"><font color="#800080">Windows CE: Stream Interface Driver, XXX_Init()</font></a>, and <a href="http://geekswithblogs.net/BruceEitman/archive/2008/08/13/windows-ce-stream-interface-driver-power-management.aspx"><font color="#800080">Windows CE: Stream Interface Driver Power Management</font></a>). In those articles I developed a driver that doesn’t actually do anything that I call Driver Shell. Driver Shell is a handy starting point for developing a stream interface driver because it includes the necessary functions, bib and reg files for creating a driver that will successfully be loaded by the device manager. I started by downloading the Driver Shell source code from this blog’s <a href="http://geekswithblogs.net/BruceEitman/archive/2009/10/09/downloads.aspx"><font color="#800080">Downloads</font></a> page and modify the driver to add control of reading pin state, writing pin state, and setting pin direction.</div> <div style="margin: 0in 0in 10pt">But I am getting ahead of myself; we need some hardware to use. For this example, I will use some (almost) imaginary CPU because I don’t want this discussion to be about any specific CPU, but about the driver. Although I have tested the driver on a specific CPU.</div> <div style="margin: 0in 0in 10pt">The imaginary CPU has 32 GPIO pins. All of the GPIO pins can be used as input or output, and therefore can be read and written as well as the direction of the pin can be set. The following is a brief description of the registers:</div> <div style="margin: 0in 0in 10pt"><b><span style="line-height: 115%; font-size: 12pt">ReadReg</span></b></div> <div style="margin: 0in 0in 10pt">Physical Address: 40E0_0008 <table border="1" cellspacing="0" cellpadding="0" style="border-bottom: medium none; border-left: medium none; margin: auto auto auto 20.25pt; border-collapse: collapse; border-top: medium none; border-right: medium none"> <tbody> <tr> <td valign="top" width="42" style="border-bottom: #d4d0c8; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 31.8pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: #d4d0c8; padding-top: 0in"> <div style="line-height: normal"> </div> </td> </tr> </tbody> </table> </div> <p><img alt="" width="706" height="115" src="/images/geekswithblogs_net/BruceEitman/8095/GPIO_Example/ReadReg.JPG" /></p> <p> </p> <table border="1" cellspacing="0" cellpadding="0" style="border-bottom: medium none; border-left: medium none; border-collapse: collapse; border-top: medium none; border-right: medium none"> <tbody> <tr> <td valign="top" width="83" style="border-bottom: black 1pt solid; border-left: black 1pt solid; padding-bottom: 0in; padding-left: 5.4pt; width: 62.6pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Bits</b></div> </td> <td valign="top" width="90" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 67.5pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Access</b></div> </td> <td valign="top" width="120" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 1.25in; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Pin Name</b></div> </td> <td valign="top" width="345" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 258.7pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Description</b></div> </td> </tr> <tr> <td valign="top" width="83" style="border-bottom: black 1pt solid; border-left: black 1pt solid; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 62.6pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">&lt;0..31&gt;</div> </td> <td valign="top" width="90" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 67.5pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">R</div> </td> <td valign="top" width="120" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 1.25in; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">LEVELx</div> </td> <td valign="top" width="345" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 258.7pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><span style="font-size: 8pt">GPIO Pin Level ‘x’ (where x = 0 to 31)</span></div> <div style="line-height: normal"><span style="font-size: 8pt">This read-only field indicates the current value of each GPIO.</span></div> <div style="line-height: normal"><span style="font-size: 8pt">0 = Pin state is low.</span></div> <div style="line-height: normal"><span style="font-size: 8pt">1 = Pin state is high.</span></div> </td> </tr> </tbody> </table> <div style="margin: 0in 0in 10pt"> </div> <div style="margin: 0in 0in 10pt"><b><span style="line-height: 115%; font-size: 14pt">DirectionReg </span></b></div> <div style="margin: 0in 0in 10pt">Physical Address: 40E0_0010</div> <p> </p> <p><img alt="" width="694" height="116" src="/images/geekswithblogs_net/BruceEitman/8095/GPIO_Example/DirectionReg.JPG" /></p> <p> </p> <table border="1" cellspacing="0" cellpadding="0" style="border-bottom: medium none; border-left: medium none; border-collapse: collapse; border-top: medium none; border-right: medium none"> <tbody> <tr> <td valign="top" width="83" style="border-bottom: black 1pt solid; border-left: black 1pt solid; padding-bottom: 0in; padding-left: 5.4pt; width: 62.6pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Bits</b></div> </td> <td valign="top" width="90" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 67.5pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Access</b></div> </td> <td valign="top" width="120" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 1.25in; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Pin Name</b></div> </td> <td valign="top" width="345" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 258.7pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Description</b></div> </td> </tr> <tr> <td valign="top" width="83" style="border-bottom: black 1pt solid; border-left: black 1pt solid; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 62.6pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">&lt;0..31&gt;</div> </td> <td valign="top" width="90" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 67.5pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">R/W</div> </td> <td valign="top" width="120" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 1.25in; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">DIRx</div> </td> <td valign="top" width="345" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 258.7pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><span style="font-size: 8pt">GPIO Pin Direction ‘x’ (where x = 0 to 31)</span></div> <div style="line-height: normal"><span style="font-size: 8pt">This field defines the direction of the GPIO pins.</span></div> <div style="line-height: normal"><span style="font-size: 8pt">0 = Pin is an input.</span></div> <div style="line-height: normal"><span style="font-size: 8pt">1 = Pin is an output</span></div> </td> </tr> </tbody> </table> <div style="margin: 0in 0in 10pt"> </div> <div style="margin: 0in 0in 10pt"><b><span style="line-height: 115%; font-size: 14pt">SetReg </span></b></div> <div style="margin: 0in 0in 10pt">Physical Address: 40E0_0018</div> <p> </p> <p><img alt="" width="690" height="113" src="/images/geekswithblogs_net/BruceEitman/8095/GPIO_Example/SetReg.JPG" /></p> <p> </p> <table border="1" cellspacing="0" cellpadding="0" style="border-bottom: medium none; border-left: medium none; border-collapse: collapse; border-top: medium none; border-right: medium none"> <tbody> <tr> <td valign="top" width="83" style="border-bottom: black 1pt solid; border-left: black 1pt solid; padding-bottom: 0in; padding-left: 5.4pt; width: 62.6pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Bits</b></div> </td> <td valign="top" width="90" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 67.5pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Access</b></div> </td> <td valign="top" width="120" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 1.25in; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Pin Name</b></div> </td> <td valign="top" width="345" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 258.7pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Description</b></div> </td> </tr> <tr> <td valign="top" width="83" style="border-bottom: black 1pt solid; border-left: black 1pt solid; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 62.6pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">&lt;0..31&gt;</div> </td> <td valign="top" width="90" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 67.5pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">W</div> </td> <td valign="top" width="120" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 1.25in; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">SETx</div> </td> <td valign="top" width="345" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 258.7pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><span style="font-size: 8pt">GPIO Pin SEt ‘x’ (where x = 0 to 31)</span></div> <div style="line-height: normal"><span style="font-size: 8pt">This field sets the output level of GPIO pins</span></div> <div style="line-height: normal"><span style="font-size: 8pt">0 = no change to pin state</span></div> <div style="line-height: normal"><span style="font-size: 8pt">1 = Pin state is driven high</span></div> </td> </tr> </tbody> </table> <div style="margin: 0in 0in 10pt"> </div> <div style="margin: 0in 0in 10pt"><b><span style="line-height: 115%; font-size: 14pt">ClearReg </span></b></div> <div style="margin: 0in 0in 10pt">Physical Address: 40E0_0020</div> <p> </p> <p><img alt="" width="707" height="120" src="/images/geekswithblogs_net/BruceEitman/8095/GPIO_Example/ClearReg.JPG" /></p> <p> </p> <table border="1" cellspacing="0" cellpadding="0" style="border-bottom: medium none; border-left: medium none; border-collapse: collapse; border-top: medium none; border-right: medium none"> <tbody> <tr> <td valign="top" width="83" style="border-bottom: black 1pt solid; border-left: black 1pt solid; padding-bottom: 0in; padding-left: 5.4pt; width: 62.6pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Bits</b></div> </td> <td valign="top" width="90" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 67.5pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Access</b></div> </td> <td valign="top" width="120" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 1.25in; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Pin Name</b></div> </td> <td valign="top" width="345" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; padding-left: 5.4pt; width: 258.7pt; padding-right: 5.4pt; background: #cccccc; border-top: black 1pt solid; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><b>Description</b></div> </td> </tr> <tr> <td valign="top" width="83" style="border-bottom: black 1pt solid; border-left: black 1pt solid; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 62.6pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">&lt;0..31&gt;</div> </td> <td valign="top" width="90" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 67.5pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">W</div> </td> <td valign="top" width="120" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 1.25in; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal">CLEARx</div> </td> <td valign="top" width="345" style="border-bottom: black 1pt solid; border-left: #d4d0c8; padding-bottom: 0in; background-color: transparent; padding-left: 5.4pt; width: 258.7pt; padding-right: 5.4pt; border-top: #d4d0c8; border-right: black 1pt solid; padding-top: 0in"> <div style="line-height: normal"><span style="font-size: 8pt">GPIO Pin CLEAR ‘x’ (where x = 0 to 31)</span></div> <div style="line-height: normal"><span style="font-size: 8pt">This field clears the output level of GPIO pins</span></div> <div style="line-height: normal"><span style="font-size: 8pt">0 = no change to pin state</span></div> <div style="line-height: normal"><span style="font-size: 8pt">1 = Pin state is driven low</span></div> </td> </tr> </tbody> </table> <div style="margin: 0in 0in 10pt"> </div> <div style="margin: 0in 0in 10pt">So the first step in developing code in the Driver Shell to access these registers is to define a data structure that matches the registers. The following GPIO_REGISTERS does that.</div> <div>typedef struct _GPIO_REGISTERS_</div> <div>{</div> <div>    volatile DWORD ReadReg;</div> <div>    DWORD Reserved2[2];</div> <div>    volatile DWORD DirectionReg;</div> <div>    DWORD Reserved3[2];</div> <div>    volatile DWORD SetReg;</div> <div>    DWORD Reserved4[2];</div> <div>    volatile DWORD ClearReg;</div> <div style="margin: 0in 0in 10pt">} GPIO_REGISTERS;</div> <div style="margin: 0in 0in 10pt">Note that the registers are in the structure ordered by their physical addresses, and that some filler variables have been added to place the registers at the correct offset from the address of the first register.</div> <div style="margin: 0in 0in 10pt">To access the registers, what we need is a pointer to BPIO_REGISTERS that points to the address of the ReadReg. Well that isn’t exactly true is it? We need it to point to a virtual address that maps to the physical address of ReadReg. I started by adding the pointer to the DRIVERSHELL_CONTEXT structure. The DRIVERSHELL_CONTEXT structure is used by the driver to keep track of instance data and is returned to the device manager by XXX_Init().</div> <div>typedef struct _DRIVERSHELL_CONTEXT</div> <div>{</div> <div>                DWORD Instance;</div> <div>                CEDEVICE_POWER_STATE CurrentPowerState;</div> <div>                HANDLE hDDKPower;</div> <div>                GPIO_REGISTERS *pGPIO;</div> <div style="margin: 0in 0in 10pt">} DRIVERSHELL_CONTEXT;</div> <div>Then the next step is to allocate a virtual address for the GPIO_REGISTERS structure. This is done in XXX_Init() using MmMapIoSpace(), the chages are in green below:</div> <div> </div> <div>DWORD XXX_Init(ULONG   RegistryPath)</div> <div>{</div> <div>                HKEY hKey;</div> <div>                DRIVERSHELL_CONTEXT *pDriverContext;</div> <div><span style="color: #00b050">                PHYSICAL_ADDRESS physicalAddress;</span></div> <div> </div> <div>                RETAILMSG( 1, (TEXT("XXX_Init\n")));</div> <div> </div> <div>                pDriverContext = LocalAlloc( LMEM_FIXED, sizeof( DRIVERSHELL_CONTEXT ));</div> <div>                if( pDriverContext == NULL )</div> <div>                {</div> <div>                                RETAILMSG( 1, (TEXT("XXX_Init failed, unable to allocate driver context\n")));</div> <div>                                return FALSE;</div> <div>                }</div> <div>               </div> <div>                hKey = OpenDeviceKey((LPCTSTR)RegistryPath);</div> <div>                if ( !hKey ) {</div> <div>                                RETAILMSG(1, (TEXT("Failed to open devkeypath,\r\n")));</div> <div>                }</div> <div>                else</div> <div>                {</div> <div>                                DWORD Type = REG_DWORD;</div> <div>                                DWORD Data;</div> <div>                                DWORD DataSize = sizeof( DWORD );</div> <div> </div> <div>                                // Read values from registry if needed</div> <div>                                if( ERROR_SUCCESS == RegQueryValueEx( hKey, TEXT("DeviceArrayIndex"), NULL, &amp;Type, (LPBYTE)&amp;Data, &amp;DataSize ) )</div> <div>                                                pDriverContext-&gt;Instance = Data;</div> <div> </div> <div>                                RETAILMSG( 1, (TEXT("pDriverContext-&gt;Instance %d\n"), pDriverContext-&gt;Instance));</div> <div>                                RegCloseKey (hKey);</div> <div>                }</div> <div> </div> <div>                // Init Power management</div> <div>                pDriverContext-&gt;CurrentPowerState = D0;</div> <div>                pDriverContext-&gt;hDDKPower = DDKPwr_Initialize(XXX_SetPowerState, (DWORD)pDriverContext , TRUE, 1000 );</div> <div> </div> <div><span style="color: #00b050">                physicalAddress.QuadPart = GPIO_REGISTERS_BASE_PHYSICAL;</span></div> <div><span style="color: #00b050">                pDriverContext-&gt;pGPIO = (GPIO_REGISTERS *)MmMapIoSpace(physicalAddress, sizeof(GPIO_REGISTERS), FALSE);</span></div> <div> </div> <div><span style="color: #00b050">                if (pDriverContext-&gt;pGPIO == NULL )</span></div> <div><span style="color: #00b050">                {</span></div> <div><span style="color: #00b050">                                RETAILMSG(TRUE, (_T("XXX_Init failed to allocate pGPIO (%d)\r\n"), GetLastError()));</span></div> <div><span style="color: #00b050">                                XXX_Deinit( pDriverContext );</span></div> <div><span style="color: #00b050">                                return (DWORD)NULL;</span></div> <div><span style="color: #00b050">                }</span></div> <div> </div> <div>                return (DWORD)pDriverContext;</div> <div>}</div> <div style="margin: 0in 0in 10pt"> </div> <div style="margin: 0in 0in 10pt">The address used to initialize the physical address is the address of the ReadReg, which is defined to as:</div> <div style="margin: 0in 0in 10pt">#define GPIO_REGISTERS_BASE_PHYSICAL (0x40E00008)</div> <div style="margin: 0in 0in 10pt">I suppose that you probably want to jump in now and start reading and writing registers, but we have some more to do first, we need to update XXX_Deinit() to free the virtual addresses that we just allocated – no nasty memory leaks here. The changes to XXX_Deinit() are in green below:</div> <div>BOOL XXX_Deinit( DWORD hDeviceContext )</div> <div>{</div> <div>                DRIVERSHELL_CONTEXT *pDriverContext = (DRIVERSHELL_CONTEXT *)hDeviceContext;</div> <div>                if( pDriverContext )</div> <div>                {</div> <div>                    if( pDriverContext-&gt;hDDKPower != INVALID_HANDLE_VALUE )</div> <div>                                                DDKPwr_Deinitialize(pDriverContext-&gt;hDDKPower);</div> <div><span style="color: #00b050">                                if( pDriverContext-&gt;pGPIO )</span></div> <div><span style="color: #00b050">                                                MmUnmapIoSpace( pDriverContext-&gt;pGPIO, sizeof(GPIO_REGISTERS) ); </span></div> <div>                                LocalFree( pDriverContext );</div> <div>                }</div> <div>                return TRUE;</div> <div style="margin: 0in 0in 10pt">}</div> <div style="margin: 0in 0in 10pt">So now we have the pointer to a data structure that is mapped to the GPIO registers. To access the registers we just use the pointer, like this:</div> <div style="margin: 0in 0in 10pt">DWORD State;</div> <div style="margin: 0in 0in 10pt">State = pDriverContext-&gt;pGPIO-&gt;ReadReg;</div> <div style="margin: 0in 0in 10pt">XXX_Read() and XXX_Write() might seem like good candidates for developing code to read and write the registers, but to me they would be awkward. Instead I am going to use XXX_IOControl(). I have also decided that having IOCTLS to handle pins makes more sense than accessing the entire registers.   One reason to handle pins is that the API can be used without change even if the number of pins increases to greater than 32 on other processors. This way transitioning from one board/CPU to another will be easier, although not pain free.</div> <div style="margin: 0in 0in 10pt">To start with, add some code to read the state of a pin. We know from the code above how to read the ReadReg, we just need to add some error handling and mask off the pin that was requested:</div> <div>                                case IOCTL_READ_GPIO:</div> <div>                                                if( pBufOut &amp;&amp; pBufIn &amp;&amp; *pBufIn &lt; 32 )</div> <div>                                                {</div> <div>                                                                DWORD *pPinNumber = (DWORD *)pBufIn;</div> <div>                                                                DWORD *pPinValue = (DWORD *)pBufOut;</div> <div>                                                                RETAILMSG( 1, (TEXT("Read GPIO pin %d\r\n"), *pPinNumber ));</div> <div>                                                                *pPinValue = (pDriverContext-&gt;pGPIO-&gt;ReadReg &amp; ( 1 &lt;&lt; *pPinNumber )) &gt;&gt; *pPinNumber;</div> <div>                                                                RetVal = TRUE;</div> <div>                                                }</div> <div>                                                else</div> <div>                                                {</div> <div>                                                                SetLastError(ERROR_INVALID_PARAMETER);</div> <div>                                                                RetVal = FALSE;</div> <div>                                                }</div> <div style="margin: 0in 0in 10pt">                                                break;</div> <div style="margin: 0in 0in 10pt">That is very simple, read the register, mask off the pin requested, then shit the result down so that we can return zero or one. The other IOCLTS are similar:</div> <div>                                case IOCTL_SET_GPIO:</div> <div>                                                if( pBufIn &amp;&amp; *pBufIn &lt; 32 )</div> <div>                                                {</div> <div>                                                                DWORD *pPinNumber = (DWORD *)pBufIn;</div> <div>                                                                RETAILMSG( 1, (TEXT("Set GPIO pin %d\r\n"), *pPinNumber ));</div> <div>                                                                pDriverContext-&gt;pGPIO-&gt;SetReg = ( 1 &lt;&lt; *pPinNumber );</div> <div>                                                                RetVal = TRUE;</div> <div>                                                }</div> <div>                                                else</div> <div>                                                {</div> <div>                                                                SetLastError(ERROR_INVALID_PARAMETER);</div> <div>                                                                RetVal = FALSE;</div> <div>                                                }</div> <div>                                                break;</div> <div>                                case IOCTL_CLEAR_GPIO:</div> <div>                                                if( pBufIn &amp;&amp; *pBufIn &lt; 32 )</div> <div>                                                {</div> <div>                                                                DWORD *pPinNumber = (DWORD *)pBufIn;</div> <div>                                                                RETAILMSG( 1, (TEXT("Clear GPIO pin %d\r\n"), *pPinNumber ));</div> <div>                                                                pDriverContext-&gt;pGPIO-&gt;ClearReg = ( 1 &lt;&lt; *pPinNumber );</div> <div>                                                                RetVal = TRUE;</div> <div>                                                }</div> <div>                                                else</div> <div>                                                {</div> <div>                                                                SetLastError(ERROR_INVALID_PARAMETER);</div> <div>                                                                RetVal = FALSE;</div> <div>                                                }</div> <div>                                                break;</div> <div>                                case IOCTL_SET_OUTPUT_GPIO:</div> <div>                                                if( pBufIn &amp;&amp; *pBufIn &lt; 32 )</div> <div>                                                {</div> <div>                                                                DWORD *pPinNumber = (DWORD *)pBufIn;</div> <div>                                                                RETAILMSG( 1, (TEXT("Set Output GPIO pin %d\r\n"), *pPinNumber ));</div> <div>                                                                pDriverContext-&gt;pGPIO-&gt;DirectionReg |= ( 1 &lt;&lt; *pPinNumber );</div> <div>                                                                RetVal = TRUE;</div> <div>                                                }</div> <div>                                                else</div> <div>                                                {</div> <div>                                                                SetLastError(ERROR_INVALID_PARAMETER);</div> <div>                                                                RetVal = FALSE;</div> <div>                                                }</div> <div>                                                break;</div> <div>                                case IOCTL_SET_INPUT_GPIO:</div> <div>                                                if( pBufIn &amp;&amp; *pBufIn &lt; 32 )</div> <div>                                                {</div> <div>                                                                DWORD *pPinNumber = (DWORD *)pBufIn;</div> <div>                                                                RETAILMSG( 1, (TEXT("Set Input GPIO pin %d\r\n"), *pPinNumber ));</div> <div>                                                                pDriverContext-&gt;pGPIO-&gt;DirectionReg &amp;= ~( 1 &lt;&lt; *pPinNumber );</div> <div>                                                                RetVal = TRUE;</div> <div>                                                }</div> <div>                                                else</div> <div>                                                {</div> <div>                                                                SetLastError(ERROR_INVALID_PARAMETER);</div> <div>                                                                RetVal = FALSE;</div> <div>                                                }</div> <div style="margin: 0in 0in 10pt">                                                break;</div> <div style="margin: 0in 0in 10pt">Now we have a driver that can read, write and change direction of the GPIO pins. You could certainly go from here and write code to use this driver (see <a href="http://geekswithblogs.net/BruceEitman/archive/2009/03/21/windows-ce-accessing-a-stream-interface-driver-from-an-application.aspx"><font color="#800080">Windows CE: Accessing a Stream Interface Driver from an Application</font></a>) but instead of having applications directly access the driver, the next article will develop an API to wrapper the driver and simplify application development.</div> <div style="margin: 0in 0in 10pt">  <div style="margin: 0in 0in 10pt">Also see the articles in this series at: <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-developing-an-api-to-access-a-driver.aspx"><font color="#800080">Windows CE: Developing an API to Access a Driver</font></a> and <a href="http://geekswithblogs.net/BruceEitman/archive/2010/08/01/windows-ce-writing-an-application-to-test-gpio-pins.aspx"><font color="#800080">Windows CE: Writing an Application to Test GPIO Pins</font></a>.</div> </div> <div style="text-align: center; line-height: normal" align="center"><span style="font-size: 9pt">Copyright © 2010 – Bruce Eitman</span></div> <div style="text-align: center; line-height: normal; margin: 0in 0in 10pt" align="center"><span style="font-size: 9pt">All Rights Reserved</span></div> <p> </p><img src="http://geekswithblogs.net/BruceEitman/aggbug/141144.aspx" width="1" height="1" /> http://geekswithblogs.net/BruceEitman/comments/141144.aspx 11 http://geekswithblogs.net/BruceEitman/comments/commentRss/141144.aspx http://geekswithblogs.net/BruceEitman/services/trackbacks/141144.aspx