doc/html/ref/channel-command.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >channel</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="Common Commands"
  23 HREF="common-commands.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="cache"
  26 HREF="cache-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="cksum"
  29 HREF="cksum-command.html"></HEAD
  30 ><BODY
  31 CLASS="REFENTRY"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="cache-command.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 ></TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="cksum-command.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><H1
  81 ><A
  82 NAME="CHANNEL-COMMAND">channel</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN3100"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >channel&nbsp;--&nbsp;Select the system console channel</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN3103"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >channel</B
 100 >  [-1 | <TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 >channel_number</I
 104 ></TT
 105 >]</P
 106 ></DIV
 107 ><DIV
 108 CLASS="REFSECT1"
 109 ><A
 110 NAME="AEN3110"
 111 ></A
 112 ><H2
 113 >Arguments</H2
 114 ><DIV
 115 CLASS="INFORMALTABLE"
 116 ><A
 117 NAME="AEN3112"><P
 118 ></P
 119 ><TABLE
 120 BORDER="1"
 121 CLASS="CALSTABLE"
 122 ><THEAD
 123 ><TR
 124 ><TH
 125 WIDTH="25%"
 126 ALIGN="LEFT"
 127 VALIGN="TOP"
 128 >Name</TH
 129 ><TH
 130 WIDTH="25%"
 131 ALIGN="LEFT"
 132 VALIGN="TOP"
 133 >Type</TH
 134 ><TH
 135 WIDTH="25%"
 136 ALIGN="LEFT"
 137 VALIGN="TOP"
 138 >Description</TH
 139 ><TH
 140 WIDTH="25%"
 141 ALIGN="LEFT"
 142 VALIGN="TOP"
 143 >Default</TH
 144 ></TR
 145 ></THEAD
 146 ><TBODY
 147 ><TR
 148 ><TD
 149 WIDTH="25%"
 150 ALIGN="LEFT"
 151 VALIGN="TOP"
 152 >-1</TD
 153 ><TD
 154 WIDTH="25%"
 155 ALIGN="LEFT"
 156 VALIGN="TOP"
 157 >&nbsp;</TD
 158 ><TD
 159 WIDTH="25%"
 160 ALIGN="LEFT"
 161 VALIGN="TOP"
 162 >Reset the console channel</TD
 163 ><TD
 164 WIDTH="25%"
 165 ALIGN="LEFT"
 166 VALIGN="TOP"
 167 ><SPAN
 168 CLASS="emphasis"
 169 ><I
 170 CLASS="EMPHASIS"
 171 >none</I
 172 ></SPAN
 173 ></TD
 174 ></TR
 175 ><TR
 176 ><TD
 177 WIDTH="25%"
 178 ALIGN="LEFT"
 179 VALIGN="TOP"
 180 >channel_number</TD
 181 ><TD
 182 WIDTH="25%"
 183 ALIGN="LEFT"
 184 VALIGN="TOP"
 185 >Number</TD
 186 ><TD
 187 WIDTH="25%"
 188 ALIGN="LEFT"
 189 VALIGN="TOP"
 190 >Select a channel</TD
 191 ><TD
 192 WIDTH="25%"
 193 ALIGN="LEFT"
 194 VALIGN="TOP"
 195 ><SPAN
 196 CLASS="emphasis"
 197 ><I
 198 CLASS="EMPHASIS"
 199 >none</I
 200 ></SPAN
 201 ></TD
 202 ></TR
 203 ></TBODY
 204 ></TABLE
 205 ><P
 206 ></P
 207 ></DIV
 208 ></DIV
 209 ><DIV
 210 CLASS="REFSECT1"
 211 ><A
 212 NAME="AEN3137"
 213 ></A
 214 ><H2
 215 >Description</H2
 216 ><P
 217 >With no arguments, the <B
 218 CLASS="COMMAND"
 219 >channel</B
 220 > command displays the current console channel number.</P
 221 ><P
 222 >When passed an argument of 0 upward, this command switches the console
 223 channel to that channel number. The mapping between channel numbers and
 224 physical channels is platform specific but will typically be something like
 225 channel 0 is the first serial port, channel 1 is the second, etc.</P
 226 ><P
 227 >When passed an argument of -1, this command reverts RedBoot to responding
 228 to whatever channel receives input first, as happens when RedBoot initially
 229 starts execution.</P
 230 ></DIV
 231 ><DIV
 232 CLASS="REFSECT1"
 233 ><A
 234 NAME="AEN3143"
 235 ></A
 236 ><H2
 237 >Examples</H2
 238 ><P
 239 >Show the current channel.
 240 <TABLE
 241 BORDER="5"
 242 BGCOLOR="#E0E0F0"
 243 WIDTH="70%"
 244 ><TR
 245 ><TD
 246 ><PRE
 247 CLASS="SCREEN"
 248 >
 249 RedBoot&#62; <TT
 250 CLASS="USERINPUT"
 251 ><B
 252 >channel</B
 253 ></TT
 254 >
 255 Current console channel id: 0</PRE
 256 ></TD
 257 ></TR
 258 ></TABLE
 259 > </P
 260 ><P
 261 >Change to an invalid channel.
 262 <TABLE
 263 BORDER="5"
 264 BGCOLOR="#E0E0F0"
 265 WIDTH="70%"
 266 ><TR
 267 ><TD
 268 ><PRE
 269 CLASS="SCREEN"
 270 >
 271 RedBoot&#62; <TT
 272 CLASS="USERINPUT"
 273 ><B
 274 >channel 99</B
 275 ></TT
 276 >
 277 **Error: bad channel number '99'</PRE
 278 ></TD
 279 ></TR
 280 ></TABLE
 281 > </P
 282 ><P
 283 >Revert to the default channel setting (any console mode).
 284 <TABLE
 285 BORDER="5"
 286 BGCOLOR="#E0E0F0"
 287 WIDTH="70%"
 288 ><TR
 289 ><TD
 290 ><PRE
 291 CLASS="SCREEN"
 292 >
 293 RedBoot&#62; <TT
 294 CLASS="USERINPUT"
 295 ><B
 296 >channel -1</B
 297 ></TT
 298 ></PRE
 299 ></TD
 300 ></TR
 301 ></TABLE
 302 >
 303       </P
 304 ></DIV
 305 ><DIV
 306 CLASS="NAVFOOTER"
 307 ><HR
 308 ALIGN="LEFT"
 309 WIDTH="100%"><TABLE
 310 SUMMARY="Footer navigation table"
 311 WIDTH="100%"
 312 BORDER="0"
 313 CELLPADDING="0"
 314 CELLSPACING="0"
 315 ><TR
 316 ><TD
 317 WIDTH="33%"
 318 ALIGN="left"
 319 VALIGN="top"
 320 ><A
 321 HREF="cache-command.html"
 322 ACCESSKEY="P"
 323 >Prev</A
 324 ></TD
 325 ><TD
 326 WIDTH="34%"
 327 ALIGN="center"
 328 VALIGN="top"
 329 ><A
 330 HREF="ecos-ref.html"
 331 ACCESSKEY="H"
 332 >Home</A
 333 ></TD
 334 ><TD
 335 WIDTH="33%"
 336 ALIGN="right"
 337 VALIGN="top"
 338 ><A
 339 HREF="cksum-command.html"
 340 ACCESSKEY="N"
 341 >Next</A
 342 ></TD
 343 ></TR
 344 ><TR
 345 ><TD
 346 WIDTH="33%"
 347 ALIGN="left"
 348 VALIGN="top"
 349 >cache</TD
 350 ><TD
 351 WIDTH="34%"
 352 ALIGN="center"
 353 VALIGN="top"
 354 ><A
 355 HREF="common-commands.html"
 356 ACCESSKEY="U"
 357 >Up</A
 358 ></TD
 359 ><TD
 360 WIDTH="33%"
 361 ALIGN="right"
 362 VALIGN="top"
 363 >cksum</TD
 364 ></TR
 365 ></TABLE
 366 ></DIV
 367 ></BODY
 368 ></HTML
 369 >