git.oblomov.eu Git - linux-2.6/blob - drivers/media/video/cx18/cx18-cards.c

   1 /*
   2  *  cx18 functions to query card hardware
   3  *
   4  *  Derived from ivtv-cards.c
   5  *
   6  *  Copyright (C) 2007  Hans Verkuil <hverkuil@xs4all.nl>
   7  *  Copyright (C) 2008  Andy Walls <awalls@radix.net>
   8  *
   9  *  This program is free software; you can redistribute it and/or modify
  10  *  it under the terms of the GNU General Public License as published by
  11  *  the Free Software Foundation; either version 2 of the License, or
  12  *  (at your option) any later version.
  13  *
  14  *  This program is distributed in the hope that it will be useful,
  15  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17  *  GNU General Public License for more details.
  18  *
  19  *  You should have received a copy of the GNU General Public License
  20  *  along with this program; if not, write to the Free Software
  21  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  22  *  02111-1307  USA
  23  */
  24
  25 #include "cx18-driver.h"
  26 #include "cx18-cards.h"
  27 #include "cx18-av-core.h"
  28 #include "cx18-i2c.h"
  29 #include <media/cs5345.h>
  30
  31 #define V4L2_STD_PAL_SECAM (V4L2_STD_PAL|V4L2_STD_SECAM)
  32
  33 /********************** card configuration *******************************/
  34
  35 /* usual i2c tuner addresses to probe */
  36 static struct cx18_card_tuner_i2c cx18_i2c_std = {
  37         .radio = { I2C_CLIENT_END },
  38         .demod = { 0x43, I2C_CLIENT_END },
  39         .tv    = { 0x61, 0x60, I2C_CLIENT_END },
  40 };
  41
  42 /* Please add new PCI IDs to: http://pci-ids.ucw.cz/iii
  43    This keeps the PCI ID database up to date. Note that the entries
  44    must be added under vendor 0x4444 (Conexant) as subsystem IDs.
  45    New vendor IDs should still be added to the vendor ID list. */
  46
  47 /* Hauppauge HVR-1600 cards */
  48
  49 /* Note: for Hauppauge cards the tveeprom information is used instead
  50    of PCI IDs */
  51 static const struct cx18_card cx18_card_hvr1600_esmt = {
  52         .type = CX18_CARD_HVR_1600_ESMT,
  53         .name = "Hauppauge HVR-1600",
  54         .comment = "Simultaneous Digital and Analog TV capture supported\n",
  55         .v4l2_capabilities = CX18_CAP_ENCODER,
  56         .hw_audio_ctrl = CX18_HW_418_AV,
  57         .hw_muxer = CX18_HW_CS5345,
  58         .hw_all = CX18_HW_TVEEPROM | CX18_HW_418_AV | CX18_HW_TUNER |
  59                   CX18_HW_CS5345 | CX18_HW_DVB | CX18_HW_GPIO_RESET_CTRL,
  60         .video_inputs = {
  61                 { CX18_CARD_INPUT_VID_TUNER,  0, CX18_AV_COMPOSITE7 },
  62                 { CX18_CARD_INPUT_SVIDEO1,    1, CX18_AV_SVIDEO1    },
  63                 { CX18_CARD_INPUT_COMPOSITE1, 1, CX18_AV_COMPOSITE3 },
  64                 { CX18_CARD_INPUT_SVIDEO2,    2, CX18_AV_SVIDEO2    },
  65                 { CX18_CARD_INPUT_COMPOSITE2, 2, CX18_AV_COMPOSITE4 },
  66         },
  67         .audio_inputs = {
  68                 { CX18_CARD_INPUT_AUD_TUNER,
  69                   CX18_AV_AUDIO8, CS5345_IN_1 | CS5345_MCLK_1_5 },
  70                 { CX18_CARD_INPUT_LINE_IN1,
  71                   CX18_AV_AUDIO_SERIAL1, CS5345_IN_2 },
  72                 { CX18_CARD_INPUT_LINE_IN2,
  73                   CX18_AV_AUDIO_SERIAL1, CS5345_IN_3 },
  74         },
  75         .radio_input = { CX18_CARD_INPUT_AUD_TUNER,
  76                          CX18_AV_AUDIO_SERIAL1, CS5345_IN_4 },
  77         .ddr = {
  78                 /* ESMT M13S128324A-5B memory */
  79                 .chip_config = 0x003,
  80                 .refresh = 0x30c,
  81                 .timing1 = 0x44220e82,
  82                 .timing2 = 0x08,
  83                 .tune_lane = 0,
  84                 .initial_emrs = 0,
  85         },
  86         .gpio_init.initial_value = 0x3001,
  87         .gpio_init.direction = 0x3001,
  88         .gpio_i2c_slave_reset = {
  89                 .active_lo_mask = 0x3001,
  90                 .msecs_asserted = 10,
  91                 .msecs_recovery = 40,
  92                 .ir_reset_mask  = 0x0001,
  93         },
  94         .i2c = &cx18_i2c_std,
  95 };
  96
  97 static const struct cx18_card cx18_card_hvr1600_samsung = {
  98         .type = CX18_CARD_HVR_1600_SAMSUNG,
  99         .name = "Hauppauge HVR-1600 (Preproduction)",
 100         .comment = "Simultaneous Digital and Analog TV capture supported\n",
 101         .v4l2_capabilities = CX18_CAP_ENCODER,
 102         .hw_audio_ctrl = CX18_HW_418_AV,
 103         .hw_muxer = CX18_HW_CS5345,
 104         .hw_all = CX18_HW_TVEEPROM | CX18_HW_418_AV | CX18_HW_TUNER |
 105                   CX18_HW_CS5345 | CX18_HW_DVB | CX18_HW_GPIO_RESET_CTRL,
 106         .video_inputs = {
 107                 { CX18_CARD_INPUT_VID_TUNER,  0, CX18_AV_COMPOSITE7 },
 108                 { CX18_CARD_INPUT_SVIDEO1,    1, CX18_AV_SVIDEO1    },
 109                 { CX18_CARD_INPUT_COMPOSITE1, 1, CX18_AV_COMPOSITE3 },
 110                 { CX18_CARD_INPUT_SVIDEO2,    2, CX18_AV_SVIDEO2    },
 111                 { CX18_CARD_INPUT_COMPOSITE2, 2, CX18_AV_COMPOSITE4 },
 112         },
 113         .audio_inputs = {
 114                 { CX18_CARD_INPUT_AUD_TUNER,
 115                   CX18_AV_AUDIO8, CS5345_IN_1 | CS5345_MCLK_1_5 },
 116                 { CX18_CARD_INPUT_LINE_IN1,
 117                   CX18_AV_AUDIO_SERIAL1, CS5345_IN_2 },
 118                 { CX18_CARD_INPUT_LINE_IN2,
 119                   CX18_AV_AUDIO_SERIAL1, CS5345_IN_3 },
 120         },
 121         .radio_input = { CX18_CARD_INPUT_AUD_TUNER,
 122                          CX18_AV_AUDIO_SERIAL1, CS5345_IN_4 },
 123         .ddr = {
 124                 /* Samsung K4D263238G-VC33 memory */
 125                 .chip_config = 0x003,
 126                 .refresh = 0x30c,
 127                 .timing1 = 0x23230b73,
 128                 .timing2 = 0x08,
 129                 .tune_lane = 0,
 130                 .initial_emrs = 2,
 131         },
 132         .gpio_init.initial_value = 0x3001,
 133         .gpio_init.direction = 0x3001,
 134         .gpio_i2c_slave_reset = {
 135                 .active_lo_mask = 0x3001,
 136                 .msecs_asserted = 10,
 137                 .msecs_recovery = 40,
 138                 .ir_reset_mask  = 0x0001,
 139         },
 140         .i2c = &cx18_i2c_std,
 141 };
 142
 143 /* ------------------------------------------------------------------------- */
 144
 145 /* Compro VideoMate H900: note that this card is analog only! */
 146
 147 static const struct cx18_card_pci_info cx18_pci_h900[] = {
 148         { PCI_DEVICE_ID_CX23418, CX18_PCI_ID_COMPRO, 0xe100 },
 149         { 0, 0, 0 }
 150 };
 151
 152 static const struct cx18_card cx18_card_h900 = {
 153         .type = CX18_CARD_COMPRO_H900,
 154         .name = "Compro VideoMate H900",
 155         .comment = "Analog TV capture supported\n",
 156         .v4l2_capabilities = CX18_CAP_ENCODER,
 157         .hw_audio_ctrl = CX18_HW_418_AV,
 158         .hw_all = CX18_HW_418_AV | CX18_HW_TUNER | CX18_HW_GPIO_RESET_CTRL,
 159         .video_inputs = {
 160                 { CX18_CARD_INPUT_VID_TUNER,  0, CX18_AV_COMPOSITE2 },
 161                 { CX18_CARD_INPUT_SVIDEO1,    1,
 162                         CX18_AV_SVIDEO_LUMA3 | CX18_AV_SVIDEO_CHROMA4 },
 163                 { CX18_CARD_INPUT_COMPOSITE1, 1, CX18_AV_COMPOSITE1 },
 164         },
 165         .audio_inputs = {
 166                 { CX18_CARD_INPUT_AUD_TUNER,
 167                   CX18_AV_AUDIO5, 0 },
 168                 { CX18_CARD_INPUT_LINE_IN1,
 169                   CX18_AV_AUDIO_SERIAL1, 0 },
 170         },
 171         .radio_input = { CX18_CARD_INPUT_AUD_TUNER,
 172                          CX18_AV_AUDIO_SERIAL1, 0 },
 173         .tuners = {
 174                 { .std = V4L2_STD_ALL, .tuner = TUNER_XC2028 },
 175         },
 176         .ddr = {
 177                 /* EtronTech EM6A9160TS-5G memory */
 178                 .chip_config = 0x50003,
 179                 .refresh = 0x753,
 180                 .timing1 = 0x24330e84,
 181                 .timing2 = 0x1f,
 182                 .tune_lane = 0,
 183                 .initial_emrs = 0,
 184         },
 185         .xceive_pin = 15,
 186         .pci_list = cx18_pci_h900,
 187         .i2c = &cx18_i2c_std,
 188 };
 189
 190 /* ------------------------------------------------------------------------- */
 191
 192 /* Yuan MPC718: not working at the moment! */
 193
 194 static const struct cx18_card_pci_info cx18_pci_mpc718[] = {
 195         { PCI_DEVICE_ID_CX23418, CX18_PCI_ID_YUAN, 0x0718 },
 196         { 0, 0, 0 }
 197 };
 198
 199 static const struct cx18_card cx18_card_mpc718 = {
 200         .type = CX18_CARD_YUAN_MPC718,
 201         .name = "Yuan MPC718",
 202         .comment = "Analog video capture works; some audio line in may not.\n",
 203         .v4l2_capabilities = CX18_CAP_ENCODER,
 204         .hw_audio_ctrl = CX18_HW_418_AV,
 205         .hw_all = CX18_HW_418_AV | CX18_HW_TUNER | CX18_HW_GPIO_RESET_CTRL,
 206         .video_inputs = {
 207                 { CX18_CARD_INPUT_VID_TUNER,  0, CX18_AV_COMPOSITE2 },
 208                 { CX18_CARD_INPUT_SVIDEO1,    1,
 209                                 CX18_AV_SVIDEO_LUMA3 | CX18_AV_SVIDEO_CHROMA4 },
 210                 { CX18_CARD_INPUT_COMPOSITE1, 1, CX18_AV_COMPOSITE1 },
 211                 { CX18_CARD_INPUT_SVIDEO2,    2,
 212                                 CX18_AV_SVIDEO_LUMA7 | CX18_AV_SVIDEO_CHROMA8 },
 213                 { CX18_CARD_INPUT_COMPOSITE2, 2, CX18_AV_COMPOSITE6 },
 214                 { CX18_CARD_INPUT_COMPOSITE3, 2, CX18_AV_COMPOSITE3 },
 215         },
 216         .audio_inputs = {
 217                 { CX18_CARD_INPUT_AUD_TUNER, CX18_AV_AUDIO5,        0 },
 218                 { CX18_CARD_INPUT_LINE_IN1,  CX18_AV_AUDIO_SERIAL1, 0 },
 219                 { CX18_CARD_INPUT_LINE_IN2,  CX18_AV_AUDIO_SERIAL1, 0 },
 220         },
 221         .radio_input = { CX18_CARD_INPUT_AUD_TUNER, CX18_AV_AUDIO_SERIAL1, 0 },
 222         .tuners = {
 223                 /* XC3028 tuner */
 224                 { .std = V4L2_STD_ALL, .tuner = TUNER_XC2028 },
 225         },
 226         .ddr = {
 227                 /* Probably Samsung K4D263238G-VC33 memory */
 228                 .chip_config = 0x003,
 229                 .refresh = 0x30c,
 230                 .timing1 = 0x23230b73,
 231                 .timing2 = 0x08,
 232                 .tune_lane = 0,
 233                 .initial_emrs = 2,
 234         },
 235         .xceive_pin = 0,
 236         .pci_list = cx18_pci_mpc718,
 237         .i2c = &cx18_i2c_std,
 238 };
 239
 240 /* ------------------------------------------------------------------------- */
 241
 242 /* Conexant Raptor PAL/SECAM: note that this card is analog only! */
 243
 244 static const struct cx18_card_pci_info cx18_pci_cnxt_raptor_pal[] = {
 245         { PCI_DEVICE_ID_CX23418, CX18_PCI_ID_CONEXANT, 0x0009 },
 246         { 0, 0, 0 }
 247 };
 248
 249 static const struct cx18_card cx18_card_cnxt_raptor_pal = {
 250         .type = CX18_CARD_CNXT_RAPTOR_PAL,
 251         .name = "Conexant Raptor PAL/SECAM",
 252         .comment = "Analog TV capture supported\n",
 253         .v4l2_capabilities = CX18_CAP_ENCODER,
 254         .hw_audio_ctrl = CX18_HW_418_AV,
 255         .hw_muxer = CX18_HW_GPIO_MUX,
 256         .hw_all = CX18_HW_418_AV | CX18_HW_TUNER | CX18_HW_GPIO_MUX,
 257         .video_inputs = {
 258                 { CX18_CARD_INPUT_VID_TUNER,  0, CX18_AV_COMPOSITE2 },
 259                 { CX18_CARD_INPUT_SVIDEO1,    1,
 260                         CX18_AV_SVIDEO_LUMA3 | CX18_AV_SVIDEO_CHROMA4 },
 261                 { CX18_CARD_INPUT_COMPOSITE1, 1, CX18_AV_COMPOSITE1 },
 262                 { CX18_CARD_INPUT_SVIDEO2,    2,
 263                         CX18_AV_SVIDEO_LUMA7 | CX18_AV_SVIDEO_CHROMA8 },
 264                 { CX18_CARD_INPUT_COMPOSITE2, 2, CX18_AV_COMPOSITE6 },
 265         },
 266         .audio_inputs = {
 267                 { CX18_CARD_INPUT_AUD_TUNER, CX18_AV_AUDIO5,        0 },
 268                 { CX18_CARD_INPUT_LINE_IN1,  CX18_AV_AUDIO_SERIAL1, 1 },
 269                 { CX18_CARD_INPUT_LINE_IN2,  CX18_AV_AUDIO_SERIAL2, 1 },
 270         },
 271         .tuners = {
 272                 { .std = V4L2_STD_PAL_SECAM, .tuner = TUNER_PHILIPS_FM1216ME_MK3 },
 273         },
 274         .radio_input = { CX18_CARD_INPUT_AUD_TUNER, CX18_AV_AUDIO_SERIAL1, 2 },
 275         .ddr = {
 276                 /* MT 46V16M16 memory */
 277                 .chip_config = 0x50306,
 278                 .refresh = 0x753,
 279                 .timing1 = 0x33220953,
 280                 .timing2 = 0x09,
 281                 .tune_lane = 0,
 282                 .initial_emrs = 0,
 283         },
 284         .gpio_init.initial_value = 0x1002,
 285         .gpio_init.direction = 0xf002,
 286         .gpio_audio_input = { .mask   = 0xf002,
 287                               .tuner  = 0x1002,   /* LED D1  Tuner AF  */
 288                               .linein = 0x2000,   /* LED D2  Line In 1 */
 289                               .radio  = 0x4002 }, /* LED D3  Tuner AF  */
 290         .pci_list = cx18_pci_cnxt_raptor_pal,
 291         .i2c = &cx18_i2c_std,
 292 };
 293
 294 /* ------------------------------------------------------------------------- */
 295
 296 /* Toshiba Qosmio laptop internal DVB-T/Analog Hybrid Tuner */
 297
 298 static const struct cx18_card_pci_info cx18_pci_toshiba_qosmio_dvbt[] = {
 299         { PCI_DEVICE_ID_CX23418, CX18_PCI_ID_TOSHIBA, 0x0110 },
 300         { 0, 0, 0 }
 301 };
 302
 303 static const struct cx18_card cx18_card_toshiba_qosmio_dvbt = {
 304         .type = CX18_CARD_TOSHIBA_QOSMIO_DVBT,
 305         .name = "Toshiba Qosmio DVB-T/Analog",
 306         .comment = "Experimenters and photos needed for device to work well.\n"
 307                   "\tTo help, mail the ivtv-devel list (www.ivtvdriver.org).\n",
 308         .v4l2_capabilities = CX18_CAP_ENCODER,
 309         .hw_audio_ctrl = CX18_HW_418_AV,
 310         .hw_all = CX18_HW_418_AV | CX18_HW_TUNER | CX18_HW_GPIO_RESET_CTRL,
 311         .video_inputs = {
 312                 { CX18_CARD_INPUT_VID_TUNER,  0, CX18_AV_COMPOSITE6 },
 313                 { CX18_CARD_INPUT_SVIDEO1,    1,
 314                         CX18_AV_SVIDEO_LUMA3 | CX18_AV_SVIDEO_CHROMA4 },
 315                 { CX18_CARD_INPUT_COMPOSITE1, 1, CX18_AV_COMPOSITE1 },
 316         },
 317         .audio_inputs = {
 318                 { CX18_CARD_INPUT_AUD_TUNER, CX18_AV_AUDIO5,        0 },
 319                 { CX18_CARD_INPUT_LINE_IN1,  CX18_AV_AUDIO_SERIAL1, 1 },
 320         },
 321         .tuners = {
 322                 { .std = V4L2_STD_ALL, .tuner = TUNER_XC2028 },
 323         },
 324         .ddr = {
 325                 .chip_config = 0x202,
 326                 .refresh = 0x3bb,
 327                 .timing1 = 0x33320a63,
 328                 .timing2 = 0x0a,
 329                 .tune_lane = 0,
 330                 .initial_emrs = 0x42,
 331         },
 332         .xceive_pin = 15,
 333         .pci_list = cx18_pci_toshiba_qosmio_dvbt,
 334         .i2c = &cx18_i2c_std,
 335 };
 336
 337 /* ------------------------------------------------------------------------- */
 338
 339 /* Leadtek WinFast PVR2100 */
 340
 341 static const struct cx18_card_pci_info cx18_pci_leadtek_pvr2100[] = {
 342         { PCI_DEVICE_ID_CX23418, CX18_PCI_ID_LEADTEK, 0x6f27 }, /* PVR2100   */
 343         { PCI_DEVICE_ID_CX23418, CX18_PCI_ID_LEADTEK, 0x6690 }, /* DVR3100 H */
 344         { 0, 0, 0 }
 345 };
 346
 347 static const struct cx18_card cx18_card_leadtek_pvr2100 = {
 348         .type = CX18_CARD_LEADTEK_PVR2100,
 349         .name = "Leadtek WinFast PVR2100/DVR3100 H",
 350         .comment = "Experimenters and photos needed for device to work well.\n"
 351                   "\tTo help, mail the ivtv-devel list (www.ivtvdriver.org).\n",
 352         .v4l2_capabilities = CX18_CAP_ENCODER,
 353         .hw_audio_ctrl = CX18_HW_418_AV,
 354         .hw_muxer = CX18_HW_GPIO_MUX,
 355         .hw_all = CX18_HW_418_AV | CX18_HW_TUNER | CX18_HW_GPIO_MUX |
 356                   CX18_HW_GPIO_RESET_CTRL,
 357         .video_inputs = {
 358                 { CX18_CARD_INPUT_VID_TUNER,  0, CX18_AV_COMPOSITE2 },
 359                 { CX18_CARD_INPUT_SVIDEO1,    1,
 360                         CX18_AV_SVIDEO_LUMA3 | CX18_AV_SVIDEO_CHROMA4 },
 361                 { CX18_CARD_INPUT_COMPOSITE1, 1, CX18_AV_COMPOSITE7 },
 362         },
 363         .audio_inputs = {
 364                 { CX18_CARD_INPUT_AUD_TUNER, CX18_AV_AUDIO5,        0 },
 365                 { CX18_CARD_INPUT_LINE_IN1,  CX18_AV_AUDIO_SERIAL1, 1 },
 366         },
 367         .tuners = {
 368                 /* XC3028 tuner */
 369                 { .std = V4L2_STD_ALL, .tuner = TUNER_XC2028 },
 370         },
 371         .radio_input = { CX18_CARD_INPUT_AUD_TUNER, CX18_AV_AUDIO5, 2 },
 372         .ddr = {
 373                 /*
 374                  * Pointer to proper DDR config values provided by
 375                  * Terry Wu <terrywu at leadtek.com.tw>
 376                  */
 377                 .chip_config = 0x303,
 378                 .refresh = 0x3bb,
 379                 .timing1 = 0x24220e83,
 380                 .timing2 = 0x1f,
 381                 .tune_lane = 0,
 382                 .initial_emrs = 0x2,
 383         },
 384         .gpio_init.initial_value = 0x6,
 385         .gpio_init.direction = 0x7,
 386         .gpio_audio_input = { .mask   = 0x7,
 387                               .tuner  = 0x6, .linein = 0x2, .radio  = 0x2 },
 388         .xceive_pin = 15,
 389         .pci_list = cx18_pci_leadtek_pvr2100,
 390         .i2c = &cx18_i2c_std,
 391 };
 392
 393 /* ------------------------------------------------------------------------- */
 394
 395 static const struct cx18_card *cx18_card_list[] = {
 396         &cx18_card_hvr1600_esmt,
 397         &cx18_card_hvr1600_samsung,
 398         &cx18_card_h900,
 399         &cx18_card_mpc718,
 400         &cx18_card_cnxt_raptor_pal,
 401         &cx18_card_toshiba_qosmio_dvbt,
 402         &cx18_card_leadtek_pvr2100,
 403 };
 404
 405 const struct cx18_card *cx18_get_card(u16 index)
 406 {
 407         if (index >= ARRAY_SIZE(cx18_card_list))
 408                 return NULL;
 409         return cx18_card_list[index];
 410 }
 411
 412 int cx18_get_input(struct cx18 *cx, u16 index, struct v4l2_input *input)
 413 {
 414         const struct cx18_card_video_input *card_input =
 415                 cx->card->video_inputs + index;
 416         static const char * const input_strs[] = {
 417                 "Tuner 1",
 418                 "S-Video 1",
 419                 "S-Video 2",
 420                 "Composite 1",
 421                 "Composite 2",
 422                 "Composite 3"
 423         };
 424
 425         memset(input, 0, sizeof(*input));
 426         if (index >= cx->nof_inputs)
 427                 return -EINVAL;
 428         input->index = index;
 429         strlcpy(input->name, input_strs[card_input->video_type - 1],
 430                         sizeof(input->name));
 431         input->type = (card_input->video_type == CX18_CARD_INPUT_VID_TUNER ?
 432                         V4L2_INPUT_TYPE_TUNER : V4L2_INPUT_TYPE_CAMERA);
 433         input->audioset = (1 << cx->nof_audio_inputs) - 1;
 434         input->std = (input->type == V4L2_INPUT_TYPE_TUNER) ?
 435                                 cx->tuner_std : V4L2_STD_ALL;
 436         return 0;
 437 }
 438
 439 int cx18_get_audio_input(struct cx18 *cx, u16 index, struct v4l2_audio *audio)
 440 {
 441         const struct cx18_card_audio_input *aud_input =
 442                 cx->card->audio_inputs + index;
 443         static const char * const input_strs[] = {
 444                 "Tuner 1",
 445                 "Line In 1",
 446                 "Line In 2"
 447         };
 448
 449         memset(audio, 0, sizeof(*audio));
 450         if (index >= cx->nof_audio_inputs)
 451                 return -EINVAL;
 452         strlcpy(audio->name, input_strs[aud_input->audio_type - 1],
 453                         sizeof(audio->name));
 454         audio->index = index;
 455         audio->capability = V4L2_AUDCAP_STEREO;
 456         return 0;
 457 }