1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html> 3<head> 4<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 5<meta http-equiv="Content-Style-Type" content="text/css"> 6<title>PC-Side HostIO Library</title> 7<style type="text/css"> 8<!-- 9body { 10/* 11 font-size : 10pt; 12*/ 13 font-weight : normal; 14 color : #000000; 15 margin : 8px; 16} 17 18div { 19 width : 98%; 20 white-space : nowrap; 21} 22 23div.title { 24 text-align : left; 25 font-weight : bold; 26/* 27 font-size : 16pt; 28*/ 29 font-size : 150%; 30 color : #202020; 31 border-style : double; 32 border-width : 8px; 33 /* タイトルを囲む枠線の色を指定 */ 34 border-color : #CD202C; 35 36 margin : 4px; 37 padding : 4px; 38} 39 40h1 { 41 font-size : 150%; 42 font-family : Arial; 43 border-bottom-width : 5px; 44 border-bottom-style : solid; 45 border-bottom-color : #CD202C; 46 padding-bottom : 1px; 47 margin-bottom : 20px; 48 letter-spacing : normal; 49 font-weight : bold; 50} 51 52 53h2 { 54 font-weight : bold; 55/* 56 font-size : 16pt; 57*/ 58 font-size : 150%; 59 border-style : none none solid double; 60 border-width : 0px 0px 2px 8px; 61 /* 見出しの線の色を指定 */ 62 border-color : #CD202C; 63 64 margin-left : 2px; 65 padding-left : 4px; 66} 67table { 68 margin-top : 2pt; 69 margin-bottom : 2pt; 70 margin-left : 0pt; 71 margin-right : 0pt; 72 padding-left : 0pt; 73 padding-right : 0pt; 74 position : relative; 75 left : 12px; 76 font-family : Arial; 77 font-size : 10pt; 78 border-style : none none none none; 79} 80td,th { 81 padding : 2pt; 82 border-width : 2pt; 83 border-style : none none none none; 84 font-style : normal; 85} 86td { 87 background : #e8f4f4; 88 font-weight : normal; 89} 90th { 91 background : #c0d8d8; 92 font-weight : bold; 93} 94 95p { 96 margin-left : 4px; 97} 98.enable { background :#ffcccc; text-align : center } 99.disable { text-align : center } 100.exsample { 101 border-style : none none none none; 102 background : #e8f4f4; 103} 104 105--> 106</style> 107 108</head> 109<body> 110<h1>PC-Side HostIO Library</h1> 111This document describes the PC interface to the HostIO library. For details about the library interface, see the SDK documentation for the PARTNER-CTR HIO-Daemon. 112 113<h2>File Overview</h2> 114<table border="1"> 115 <tbody> 116 <tr> 117<th align="center"><strong>Files</strong></th> 118<th align="center"><strong>Description</strong></th> 119<th align="center"><strong>path</strong></th> 120 </tr> 121 <tr> 122<td align="left">devhio.dll</td> 123<td align="left">HostIO library. Place this file in the same directory as the sample application.</td> 124<td align="left"><CODE>$KMC_CTRHOSTIO/SDK</CODE></td> 125 </tr> 126 <tr> 127<td align="left">devhio.lib</td> 128 <td align="left"> 129C library file. 130 </td> 131<td><CODE>$KMC_CTRHOSTIO/SDK</CODE></td> 132 </tr> 133 <tr> 134<td align="left">devhio_host.h<br/>devhio_sio.h<br/>devhio_smem.h</td> 135 <td align="left"> 136C header files. 137 </td> 138<td><CODE>$KMC_CTRHOSTIO/SDK</CODE></td> 139 </tr> 140 <tr> 141<td align="left">CDEVHIO.h</td> 142 <td align="left"> 143Wrapper class for C++. This makes it simple to load and perform other operations on <CODE>devhio.dll</CODE>. 144 </td> 145<td><CODE>$KMC_CTRHOSTIO/SDK</CODE></td> 146 </tr> 147 </tbody> 148</table> 149 150<h2>How to Use the HostIO Host-Side Interface</h2> 151Assume that VisualStudio will be used. 152<h3>Changing Project Settings</h3> 153 <ul> 154<li>Add "$(KMC_CTRHOSTIO)/SDK" to "Additional Include Directories"</li> 155<li>Add "$(KMC_CTRHOSTIO)/SDK" to "Additional Library Directories"</li> 156<li>Add devhio.lib to "Additional Dependent Files"</li> 157 </ul> 158<h3>Adding Include Files to Source Files</h3> 159Add the following. 160 <ul> 161<li>#include <devhio_host.h></li> 162<li>#include <devhio_sio.h></li> 163<li>#include <devhio_smem.h></li> 164 </ul> 165For C++, also add the following. 166 <ul> 167<li>#include <CDevHIO.h></li> 168 </ul> 169<h3>Calling the HostIO API in Source Files (C++)</h3> 170First, initialize HostIO. 171 <ul> 172<li>CDEVHIO::CDEVHIO()</li> 173 </ul> 174Next, be sure to call the following functions, in order, to connect. 175 <ul> 176<li>CDEVHIO::Find()</li> 177<li>CDEVHIO::Connect()</li> 178 </ul> 179Next, call the appropriate serial communication functions, if performing serial communications. 180 <ul> 181<li>Functions with a format such as CDEVHIO::xxxSio() <br /> (see the SDK documentation for the PARTNER-CTR HIO-Daemon for details)</li> 182 </ul> 183Call the appropriate shared memory functions if using shared memory. 184 <ul> 185<li>Functions with a format such as CDEVHIO::xxxSmem() <br /> (see the SDK documentation for the PARTNER-CTR HIO-Daemon for details)</li> 186 </ul> 187When finished, call the disconnection and termination functions. 188 <ul> 189<li>CDEVHIO::Disconnect()</li> 190<li>CDEVHIO::~CDEVHIO()</li> 191 </ul> 192For the corresponding functions when using C, see the SDK documentation for the PARTNER-CTR HIO-Daemon. 193 194<h2>Note</h2> 195<h3>How do I connect the debugger to multiple systems?</h3> 196If you specify 0 for the <CODE>size</CODE> argument and call the <CODE>CDEVHIO::Find</CODE> function, a user interface for selecting the debugger will be displayed when the <CODE>Find</CODE> function is called. 197 198<h2>Notes</h2> 199<p>File I/O operates in such a way that a thread is created in the library when a file is opened. Waiting for commands from the target is handled automatically.<br/>As a result, breaks encountered while debugging a HOSTIO application may cause this waiting thread to halt within the driver, which in turn makes it impossible to perform any PARTNER-CTR/S operations.</p> 200<p>If input does not return from the <CODE>DEVHIO_cio_gets</CODE> function, file I/O on other channels will also be locked. (Serial/shared memory will work.)</p> 201<p>This library must be used with the 2010/04/16 build or later builds of PARTNER-CTR/S 5.61.</p> 202 203<h2>Revision History</h2> 204 205 <div class="section"> 206 <dl class="history"> 207 <dt>2012/03/29</dt> 208<dd>Added a description about how to use.<br /> 209 </dd> 210 <dt>2010/02/04</dt> 211<dd>Initial version.<br /> 212 </dd> 213 </dl> 214 </div> 215 216 <hr><p>CTR-06-0204-002-G<br>CONFIDENTIAL</p></body> 217</html>