Version:  2.0.40 2.2.26 2.4.37 3.6 3.7 3.8 3.9 3.10 3.11 3.12 3.13 3.14 3.15 3.16 3.17 3.18 3.19 4.0 4.1 4.2

Linux/drivers/media/pci/dm1105/dm1105.c

  1 /*
  2  * dm1105.c - driver for DVB cards based on SDMC DM1105 PCI chip
  3  *
  4  * Copyright (C) 2008 Igor M. Liplianin <liplianin@me.by>
  5  *
  6  * This program is free software; you can redistribute it and/or modify
  7  * it under the terms of the GNU General Public License as published by
  8  * the Free Software Foundation; either version 2 of the License, or
  9  * (at your option) any later version.
 10  *
 11  * This program is distributed in the hope that it will be useful,
 12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
 13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 14  * GNU General Public License for more details.
 15  *
 16  * You should have received a copy of the GNU General Public License
 17  * along with this program; if not, write to the Free Software
 18  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 19  *
 20  */
 21 
 22 #include <linux/i2c.h>
 23 #include <linux/i2c-algo-bit.h>
 24 #include <linux/init.h>
 25 #include <linux/interrupt.h>
 26 #include <linux/kernel.h>
 27 #include <linux/module.h>
 28 #include <linux/proc_fs.h>
 29 #include <linux/pci.h>
 30 #include <linux/dma-mapping.h>
 31 #include <linux/slab.h>
 32 #include <media/rc-core.h>
 33 
 34 #include "demux.h"
 35 #include "dmxdev.h"
 36 #include "dvb_demux.h"
 37 #include "dvb_frontend.h"
 38 #include "dvb_net.h"
 39 #include "dvbdev.h"
 40 #include "dvb-pll.h"
 41 
 42 #include "stv0299.h"
 43 #include "stv0288.h"
 44 #include "stb6000.h"
 45 #include "si21xx.h"
 46 #include "cx24116.h"
 47 #include "z0194a.h"
 48 #include "ts2020.h"
 49 #include "ds3000.h"
 50 
 51 #define MODULE_NAME "dm1105"
 52 
 53 #define UNSET (-1U)
 54 
 55 #define DM1105_BOARD_NOAUTO                     UNSET
 56 #define DM1105_BOARD_UNKNOWN                    0
 57 #define DM1105_BOARD_DVBWORLD_2002              1
 58 #define DM1105_BOARD_DVBWORLD_2004              2
 59 #define DM1105_BOARD_AXESS_DM05                 3
 60 #define DM1105_BOARD_UNBRANDED_I2C_ON_GPIO      4
 61 
 62 /* ----------------------------------------------- */
 63 /*
 64  * PCI ID's
 65  */
 66 #ifndef PCI_VENDOR_ID_TRIGEM
 67 #define PCI_VENDOR_ID_TRIGEM    0x109f
 68 #endif
 69 #ifndef PCI_VENDOR_ID_AXESS
 70 #define PCI_VENDOR_ID_AXESS     0x195d
 71 #endif
 72 #ifndef PCI_DEVICE_ID_DM1105
 73 #define PCI_DEVICE_ID_DM1105    0x036f
 74 #endif
 75 #ifndef PCI_DEVICE_ID_DW2002
 76 #define PCI_DEVICE_ID_DW2002    0x2002
 77 #endif
 78 #ifndef PCI_DEVICE_ID_DW2004
 79 #define PCI_DEVICE_ID_DW2004    0x2004
 80 #endif
 81 #ifndef PCI_DEVICE_ID_DM05
 82 #define PCI_DEVICE_ID_DM05      0x1105
 83 #endif
 84 /* ----------------------------------------------- */
 85 /* sdmc dm1105 registers */
 86 
 87 /* TS Control */
 88 #define DM1105_TSCTR                            0x00
 89 #define DM1105_DTALENTH                         0x04
 90 
 91 /* GPIO Interface */
 92 #define DM1105_GPIOVAL                          0x08
 93 #define DM1105_GPIOCTR                          0x0c
 94 
 95 /* PID serial number */
 96 #define DM1105_PIDN                             0x10
 97 
 98 /* Odd-even secret key select */
 99 #define DM1105_CWSEL                            0x14
100 
101 /* Host Command Interface */
102 #define DM1105_HOST_CTR                         0x18
103 #define DM1105_HOST_AD                          0x1c
104 
105 /* PCI Interface */
106 #define DM1105_CR                               0x30
107 #define DM1105_RST                              0x34
108 #define DM1105_STADR                            0x38
109 #define DM1105_RLEN                             0x3c
110 #define DM1105_WRP                              0x40
111 #define DM1105_INTCNT                           0x44
112 #define DM1105_INTMAK                           0x48
113 #define DM1105_INTSTS                           0x4c
114 
115 /* CW Value */
116 #define DM1105_ODD                              0x50
117 #define DM1105_EVEN                             0x58
118 
119 /* PID Value */
120 #define DM1105_PID                              0x60
121 
122 /* IR Control */
123 #define DM1105_IRCTR                            0x64
124 #define DM1105_IRMODE                           0x68
125 #define DM1105_SYSTEMCODE                       0x6c
126 #define DM1105_IRCODE                           0x70
127 
128 /* Unknown Values */
129 #define DM1105_ENCRYPT                          0x74
130 #define DM1105_VER                              0x7c
131 
132 /* I2C Interface */
133 #define DM1105_I2CCTR                           0x80
134 #define DM1105_I2CSTS                           0x81
135 #define DM1105_I2CDAT                           0x82
136 #define DM1105_I2C_RA                           0x83
137 /* ----------------------------------------------- */
138 /* Interrupt Mask Bits */
139 
140 #define INTMAK_TSIRQM                           0x01
141 #define INTMAK_HIRQM                            0x04
142 #define INTMAK_IRM                              0x08
143 #define INTMAK_ALLMASK                          (INTMAK_TSIRQM | \
144                                                 INTMAK_HIRQM | \
145                                                 INTMAK_IRM)
146 #define INTMAK_NONEMASK                         0x00
147 
148 /* Interrupt Status Bits */
149 #define INTSTS_TSIRQ                            0x01
150 #define INTSTS_HIRQ                             0x04
151 #define INTSTS_IR                               0x08
152 
153 /* IR Control Bits */
154 #define DM1105_IR_EN                            0x01
155 #define DM1105_SYS_CHK                          0x02
156 #define DM1105_REP_FLG                          0x08
157 
158 /* EEPROM addr */
159 #define IIC_24C01_addr                          0xa0
160 /* Max board count */
161 #define DM1105_MAX                              0x04
162 
163 #define DRIVER_NAME                             "dm1105"
164 #define DM1105_I2C_GPIO_NAME                    "dm1105-gpio"
165 
166 #define DM1105_DMA_PACKETS                      47
167 #define DM1105_DMA_PACKET_LENGTH                (128*4)
168 #define DM1105_DMA_BYTES                        (128 * 4 * DM1105_DMA_PACKETS)
169 
170 /*  */
171 #define GPIO08                                  (1 << 8)
172 #define GPIO13                                  (1 << 13)
173 #define GPIO14                                  (1 << 14)
174 #define GPIO15                                  (1 << 15)
175 #define GPIO16                                  (1 << 16)
176 #define GPIO17                                  (1 << 17)
177 #define GPIO_ALL                                0x03ffff
178 
179 /* GPIO's for LNB power control */
180 #define DM1105_LNB_MASK                         (GPIO_ALL & ~(GPIO14 | GPIO13))
181 #define DM1105_LNB_OFF                          GPIO17
182 #define DM1105_LNB_13V                          (GPIO16 | GPIO08)
183 #define DM1105_LNB_18V                          GPIO08
184 
185 /* GPIO's for LNB power control for Axess DM05 */
186 #define DM05_LNB_MASK                           (GPIO_ALL & ~(GPIO14 | GPIO13))
187 #define DM05_LNB_OFF                            GPIO17/* actually 13v */
188 #define DM05_LNB_13V                            GPIO17
189 #define DM05_LNB_18V                            (GPIO17 | GPIO16)
190 
191 /* GPIO's for LNB power control for unbranded with I2C on GPIO */
192 #define UNBR_LNB_MASK                           (GPIO17 | GPIO16)
193 #define UNBR_LNB_OFF                            0
194 #define UNBR_LNB_13V                            GPIO17
195 #define UNBR_LNB_18V                            (GPIO17 | GPIO16)
196 
197 static unsigned int card[]  = {[0 ... 3] = UNSET };
198 module_param_array(card,  int, NULL, 0444);
199 MODULE_PARM_DESC(card, "card type");
200 
201 static int ir_debug;
202 module_param(ir_debug, int, 0644);
203 MODULE_PARM_DESC(ir_debug, "enable debugging information for IR decoding");
204 
205 static unsigned int dm1105_devcount;
206 
207 DVB_DEFINE_MOD_OPT_ADAPTER_NR(adapter_nr);
208 
209 struct dm1105_board {
210         char    *name;
211         struct  {
212                 u32     mask, off, v13, v18;
213         } lnb;
214         u32     gpio_scl, gpio_sda;
215 };
216 
217 struct dm1105_subid {
218         u16     subvendor;
219         u16     subdevice;
220         u32     card;
221 };
222 
223 static const struct dm1105_board dm1105_boards[] = {
224         [DM1105_BOARD_UNKNOWN] = {
225                 .name           = "UNKNOWN/GENERIC",
226                 .lnb = {
227                         .mask = DM1105_LNB_MASK,
228                         .off = DM1105_LNB_OFF,
229                         .v13 = DM1105_LNB_13V,
230                         .v18 = DM1105_LNB_18V,
231                 },
232         },
233         [DM1105_BOARD_DVBWORLD_2002] = {
234                 .name           = "DVBWorld PCI 2002",
235                 .lnb = {
236                         .mask = DM1105_LNB_MASK,
237                         .off = DM1105_LNB_OFF,
238                         .v13 = DM1105_LNB_13V,
239                         .v18 = DM1105_LNB_18V,
240                 },
241         },
242         [DM1105_BOARD_DVBWORLD_2004] = {
243                 .name           = "DVBWorld PCI 2004",
244                 .lnb = {
245                         .mask = DM1105_LNB_MASK,
246                         .off = DM1105_LNB_OFF,
247                         .v13 = DM1105_LNB_13V,
248                         .v18 = DM1105_LNB_18V,
249                 },
250         },
251         [DM1105_BOARD_AXESS_DM05] = {
252                 .name           = "Axess/EasyTv DM05",
253                 .lnb = {
254                         .mask = DM05_LNB_MASK,
255                         .off = DM05_LNB_OFF,
256                         .v13 = DM05_LNB_13V,
257                         .v18 = DM05_LNB_18V,
258                 },
259         },
260         [DM1105_BOARD_UNBRANDED_I2C_ON_GPIO] = {
261                 .name           = "Unbranded DM1105 with i2c on GPIOs",
262                 .lnb = {
263                         .mask = UNBR_LNB_MASK,
264                         .off = UNBR_LNB_OFF,
265                         .v13 = UNBR_LNB_13V,
266                         .v18 = UNBR_LNB_18V,
267                 },
268                 .gpio_scl       = GPIO14,
269                 .gpio_sda       = GPIO13,
270         },
271 };
272 
273 static const struct dm1105_subid dm1105_subids[] = {
274         {
275                 .subvendor = 0x0000,
276                 .subdevice = 0x2002,
277                 .card      = DM1105_BOARD_DVBWORLD_2002,
278         }, {
279                 .subvendor = 0x0001,
280                 .subdevice = 0x2002,
281                 .card      = DM1105_BOARD_DVBWORLD_2002,
282         }, {
283                 .subvendor = 0x0000,
284                 .subdevice = 0x2004,
285                 .card      = DM1105_BOARD_DVBWORLD_2004,
286         }, {
287                 .subvendor = 0x0001,
288                 .subdevice = 0x2004,
289                 .card      = DM1105_BOARD_DVBWORLD_2004,
290         }, {
291                 .subvendor = 0x195d,
292                 .subdevice = 0x1105,
293                 .card      = DM1105_BOARD_AXESS_DM05,
294         },
295 };
296 
297 static void dm1105_card_list(struct pci_dev *pci)
298 {
299         int i;
300 
301         if (0 == pci->subsystem_vendor &&
302                         0 == pci->subsystem_device) {
303                 printk(KERN_ERR
304                         "dm1105: Your board has no valid PCI Subsystem ID\n"
305                         "dm1105: and thus can't be autodetected\n"
306                         "dm1105: Please pass card=<n> insmod option to\n"
307                         "dm1105: workaround that.  Redirect complaints to\n"
308                         "dm1105: the vendor of the TV card.  Best regards,\n"
309                         "dm1105: -- tux\n");
310         } else {
311                 printk(KERN_ERR
312                         "dm1105: Your board isn't known (yet) to the driver.\n"
313                         "dm1105: You can try to pick one of the existing\n"
314                         "dm1105: card configs via card=<n> insmod option.\n"
315                         "dm1105: Updating to the latest version might help\n"
316                         "dm1105: as well.\n");
317         }
318         printk(KERN_ERR "Here is a list of valid choices for the card=<n> "
319                    "insmod option:\n");
320         for (i = 0; i < ARRAY_SIZE(dm1105_boards); i++)
321                 printk(KERN_ERR "dm1105:    card=%d -> %s\n",
322                                 i, dm1105_boards[i].name);
323 }
324 
325 /* infrared remote control */
326 struct infrared {
327         struct rc_dev           *dev;
328         char                    input_phys[32];
329         struct work_struct      work;
330         u32                     ir_command;
331 };
332 
333 struct dm1105_dev {
334         /* pci */
335         struct pci_dev *pdev;
336         u8 __iomem *io_mem;
337 
338         /* ir */
339         struct infrared ir;
340 
341         /* dvb */
342         struct dmx_frontend hw_frontend;
343         struct dmx_frontend mem_frontend;
344         struct dmxdev dmxdev;
345         struct dvb_adapter dvb_adapter;
346         struct dvb_demux demux;
347         struct dvb_frontend *fe;
348         struct dvb_net dvbnet;
349         unsigned int full_ts_users;
350         unsigned int boardnr;
351         int nr;
352 
353         /* i2c */
354         struct i2c_adapter i2c_adap;
355         struct i2c_adapter i2c_bb_adap;
356         struct i2c_algo_bit_data i2c_bit;
357 
358         /* irq */
359         struct work_struct work;
360         struct workqueue_struct *wq;
361         char wqn[16];
362 
363         /* dma */
364         dma_addr_t dma_addr;
365         unsigned char *ts_buf;
366         u32 wrp;
367         u32 nextwrp;
368         u32 buffer_size;
369         unsigned int    PacketErrorCount;
370         unsigned int dmarst;
371         spinlock_t lock;
372 };
373 
374 #define dm_io_mem(reg)  ((unsigned long)(&dev->io_mem[reg]))
375 
376 #define dm_readb(reg)           inb(dm_io_mem(reg))
377 #define dm_writeb(reg, value)   outb((value), (dm_io_mem(reg)))
378 
379 #define dm_readw(reg)           inw(dm_io_mem(reg))
380 #define dm_writew(reg, value)   outw((value), (dm_io_mem(reg)))
381 
382 #define dm_readl(reg)           inl(dm_io_mem(reg))
383 #define dm_writel(reg, value)   outl((value), (dm_io_mem(reg)))
384 
385 #define dm_andorl(reg, mask, value) \
386         outl((inl(dm_io_mem(reg)) & ~(mask)) |\
387                 ((value) & (mask)), (dm_io_mem(reg)))
388 
389 #define dm_setl(reg, bit)       dm_andorl((reg), (bit), (bit))
390 #define dm_clearl(reg, bit)     dm_andorl((reg), (bit), 0)
391 
392 /* The chip has 18 GPIOs. In HOST mode GPIO's used as 15 bit address lines,
393  so we can use only 3 GPIO's from GPIO15 to GPIO17.
394  Here I don't check whether HOST is enebled as it is not implemented yet.
395  */
396 static void dm1105_gpio_set(struct dm1105_dev *dev, u32 mask)
397 {
398         if (mask & 0xfffc0000)
399                 printk(KERN_ERR "%s: Only 18 GPIO's are allowed\n", __func__);
400 
401         if (mask & 0x0003ffff)
402                 dm_setl(DM1105_GPIOVAL, mask & 0x0003ffff);
403 
404 }
405 
406 static void dm1105_gpio_clear(struct dm1105_dev *dev, u32 mask)
407 {
408         if (mask & 0xfffc0000)
409                 printk(KERN_ERR "%s: Only 18 GPIO's are allowed\n", __func__);
410 
411         if (mask & 0x0003ffff)
412                 dm_clearl(DM1105_GPIOVAL, mask & 0x0003ffff);
413 
414 }
415 
416 static void dm1105_gpio_andor(struct dm1105_dev *dev, u32 mask, u32 val)
417 {
418         if (mask & 0xfffc0000)
419                 printk(KERN_ERR "%s: Only 18 GPIO's are allowed\n", __func__);
420 
421         if (mask & 0x0003ffff)
422                 dm_andorl(DM1105_GPIOVAL, mask & 0x0003ffff, val);
423 
424 }
425 
426 static u32 dm1105_gpio_get(struct dm1105_dev *dev, u32 mask)
427 {
428         if (mask & 0xfffc0000)
429                 printk(KERN_ERR "%s: Only 18 GPIO's are allowed\n", __func__);
430 
431         if (mask & 0x0003ffff)
432                 return dm_readl(DM1105_GPIOVAL) & mask & 0x0003ffff;
433 
434         return 0;
435 }
436 
437 static void dm1105_gpio_enable(struct dm1105_dev *dev, u32 mask, int asoutput)
438 {
439         if (mask & 0xfffc0000)
440                 printk(KERN_ERR "%s: Only 18 GPIO's are allowed\n", __func__);
441 
442         if ((mask & 0x0003ffff) && asoutput)
443                 dm_clearl(DM1105_GPIOCTR, mask & 0x0003ffff);
444         else if ((mask & 0x0003ffff) && !asoutput)
445                 dm_setl(DM1105_GPIOCTR, mask & 0x0003ffff);
446 
447 }
448 
449 static void dm1105_setline(struct dm1105_dev *dev, u32 line, int state)
450 {
451         if (state)
452                 dm1105_gpio_enable(dev, line, 0);
453         else {
454                 dm1105_gpio_enable(dev, line, 1);
455                 dm1105_gpio_clear(dev, line);
456         }
457 }
458 
459 static void dm1105_setsda(void *data, int state)
460 {
461         struct dm1105_dev *dev = data;
462 
463         dm1105_setline(dev, dm1105_boards[dev->boardnr].gpio_sda, state);
464 }
465 
466 static void dm1105_setscl(void *data, int state)
467 {
468         struct dm1105_dev *dev = data;
469 
470         dm1105_setline(dev, dm1105_boards[dev->boardnr].gpio_scl, state);
471 }
472 
473 static int dm1105_getsda(void *data)
474 {
475         struct dm1105_dev *dev = data;
476 
477         return dm1105_gpio_get(dev, dm1105_boards[dev->boardnr].gpio_sda)
478                                                                         ? 1 : 0;
479 }
480 
481 static int dm1105_getscl(void *data)
482 {
483         struct dm1105_dev *dev = data;
484 
485         return dm1105_gpio_get(dev, dm1105_boards[dev->boardnr].gpio_scl)
486                                                                         ? 1 : 0;
487 }
488 
489 static int dm1105_i2c_xfer(struct i2c_adapter *i2c_adap,
490                             struct i2c_msg *msgs, int num)
491 {
492         struct dm1105_dev *dev ;
493 
494         int addr, rc, i, j, k, len, byte, data;
495         u8 status;
496 
497         dev = i2c_adap->algo_data;
498         for (i = 0; i < num; i++) {
499                 dm_writeb(DM1105_I2CCTR, 0x00);
500                 if (msgs[i].flags & I2C_M_RD) {
501                         /* read bytes */
502                         addr  = msgs[i].addr << 1;
503                         addr |= 1;
504                         dm_writeb(DM1105_I2CDAT, addr);
505                         for (byte = 0; byte < msgs[i].len; byte++)
506                                 dm_writeb(DM1105_I2CDAT + byte + 1, 0);
507 
508                         dm_writeb(DM1105_I2CCTR, 0x81 + msgs[i].len);
509                         for (j = 0; j < 55; j++) {
510                                 mdelay(10);
511                                 status = dm_readb(DM1105_I2CSTS);
512                                 if ((status & 0xc0) == 0x40)
513                                         break;
514                         }
515                         if (j >= 55)
516                                 return -1;
517 
518                         for (byte = 0; byte < msgs[i].len; byte++) {
519                                 rc = dm_readb(DM1105_I2CDAT + byte + 1);
520                                 if (rc < 0)
521                                         goto err;
522                                 msgs[i].buf[byte] = rc;
523                         }
524                 } else if ((msgs[i].buf[0] == 0xf7) && (msgs[i].addr == 0x55)) {
525                         /* prepaired for cx24116 firmware */
526                         /* Write in small blocks */
527                         len = msgs[i].len - 1;
528                         k = 1;
529                         do {
530                                 dm_writeb(DM1105_I2CDAT, msgs[i].addr << 1);
531                                 dm_writeb(DM1105_I2CDAT + 1, 0xf7);
532                                 for (byte = 0; byte < (len > 48 ? 48 : len); byte++) {
533                                         data = msgs[i].buf[k + byte];
534                                         dm_writeb(DM1105_I2CDAT + byte + 2, data);
535                                 }
536                                 dm_writeb(DM1105_I2CCTR, 0x82 + (len > 48 ? 48 : len));
537                                 for (j = 0; j < 25; j++) {
538                                         mdelay(10);
539                                         status = dm_readb(DM1105_I2CSTS);
540                                         if ((status & 0xc0) == 0x40)
541                                                 break;
542                                 }
543 
544                                 if (j >= 25)
545                                         return -1;
546 
547                                 k += 48;
548                                 len -= 48;
549                         } while (len > 0);
550                 } else {
551                         /* write bytes */
552                         dm_writeb(DM1105_I2CDAT, msgs[i].addr << 1);
553                         for (byte = 0; byte < msgs[i].len; byte++) {
554                                 data = msgs[i].buf[byte];
555                                 dm_writeb(DM1105_I2CDAT + byte + 1, data);
556                         }
557                         dm_writeb(DM1105_I2CCTR, 0x81 + msgs[i].len);
558                         for (j = 0; j < 25; j++) {
559                                 mdelay(10);
560                                 status = dm_readb(DM1105_I2CSTS);
561                                 if ((status & 0xc0) == 0x40)
562                                         break;
563                         }
564 
565                         if (j >= 25)
566                                 return -1;
567                 }
568         }
569         return num;
570  err:
571         return rc;
572 }
573 
574 static u32 functionality(struct i2c_adapter *adap)
575 {
576         return I2C_FUNC_I2C;
577 }
578 
579 static struct i2c_algorithm dm1105_algo = {
580         .master_xfer   = dm1105_i2c_xfer,
581         .functionality = functionality,
582 };
583 
584 static inline struct dm1105_dev *feed_to_dm1105_dev(struct dvb_demux_feed *feed)
585 {
586         return container_of(feed->demux, struct dm1105_dev, demux);
587 }
588 
589 static inline struct dm1105_dev *frontend_to_dm1105_dev(struct dvb_frontend *fe)
590 {
591         return container_of(fe->dvb, struct dm1105_dev, dvb_adapter);
592 }
593 
594 static int dm1105_set_voltage(struct dvb_frontend *fe,
595                               enum fe_sec_voltage voltage)
596 {
597         struct dm1105_dev *dev = frontend_to_dm1105_dev(fe);
598 
599         dm1105_gpio_enable(dev, dm1105_boards[dev->boardnr].lnb.mask, 1);
600         if (voltage == SEC_VOLTAGE_18)
601                 dm1105_gpio_andor(dev,
602                                 dm1105_boards[dev->boardnr].lnb.mask,
603                                 dm1105_boards[dev->boardnr].lnb.v18);
604         else if (voltage == SEC_VOLTAGE_13)
605                 dm1105_gpio_andor(dev,
606                                 dm1105_boards[dev->boardnr].lnb.mask,
607                                 dm1105_boards[dev->boardnr].lnb.v13);
608         else
609                 dm1105_gpio_andor(dev,
610                                 dm1105_boards[dev->boardnr].lnb.mask,
611                                 dm1105_boards[dev->boardnr].lnb.off);
612 
613         return 0;
614 }
615 
616 static void dm1105_set_dma_addr(struct dm1105_dev *dev)
617 {
618         dm_writel(DM1105_STADR, (__force u32)cpu_to_le32(dev->dma_addr));
619 }
620 
621 static int dm1105_dma_map(struct dm1105_dev *dev)
622 {
623         dev->ts_buf = pci_alloc_consistent(dev->pdev,
624                                         6 * DM1105_DMA_BYTES,
625                                         &dev->dma_addr);
626 
627         return !dev->ts_buf;
628 }
629 
630 static void dm1105_dma_unmap(struct dm1105_dev *dev)
631 {
632         pci_free_consistent(dev->pdev,
633                         6 * DM1105_DMA_BYTES,
634                         dev->ts_buf,
635                         dev->dma_addr);
636 }
637 
638 static void dm1105_enable_irqs(struct dm1105_dev *dev)
639 {
640         dm_writeb(DM1105_INTMAK, INTMAK_ALLMASK);
641         dm_writeb(DM1105_CR, 1);
642 }
643 
644 static void dm1105_disable_irqs(struct dm1105_dev *dev)
645 {
646         dm_writeb(DM1105_INTMAK, INTMAK_IRM);
647         dm_writeb(DM1105_CR, 0);
648 }
649 
650 static int dm1105_start_feed(struct dvb_demux_feed *f)
651 {
652         struct dm1105_dev *dev = feed_to_dm1105_dev(f);
653 
654         if (dev->full_ts_users++ == 0)
655                 dm1105_enable_irqs(dev);
656 
657         return 0;
658 }
659 
660 static int dm1105_stop_feed(struct dvb_demux_feed *f)
661 {
662         struct dm1105_dev *dev = feed_to_dm1105_dev(f);
663 
664         if (--dev->full_ts_users == 0)
665                 dm1105_disable_irqs(dev);
666 
667         return 0;
668 }
669 
670 /* ir work handler */
671 static void dm1105_emit_key(struct work_struct *work)
672 {
673         struct infrared *ir = container_of(work, struct infrared, work);
674         u32 ircom = ir->ir_command;
675         u8 data;
676 
677         if (ir_debug)
678                 printk(KERN_INFO "%s: received byte 0x%04x\n", __func__, ircom);
679 
680         data = (ircom >> 8) & 0x7f;
681 
682         /* FIXME: UNKNOWN because we don't generate a full NEC scancode (yet?) */
683         rc_keydown(ir->dev, RC_TYPE_UNKNOWN, data, 0);
684 }
685 
686 /* work handler */
687 static void dm1105_dmx_buffer(struct work_struct *work)
688 {
689         struct dm1105_dev *dev = container_of(work, struct dm1105_dev, work);
690         unsigned int nbpackets;
691         u32 oldwrp = dev->wrp;
692         u32 nextwrp = dev->nextwrp;
693 
694         if (!((dev->ts_buf[oldwrp] == 0x47) &&
695                         (dev->ts_buf[oldwrp + 188] == 0x47) &&
696                         (dev->ts_buf[oldwrp + 188 * 2] == 0x47))) {
697                 dev->PacketErrorCount++;
698                 /* bad packet found */
699                 if ((dev->PacketErrorCount >= 2) &&
700                                 (dev->dmarst == 0)) {
701                         dm_writeb(DM1105_RST, 1);
702                         dev->wrp = 0;
703                         dev->PacketErrorCount = 0;
704                         dev->dmarst = 0;
705                         return;
706                 }
707         }
708 
709         if (nextwrp < oldwrp) {
710                 memcpy(dev->ts_buf + dev->buffer_size, dev->ts_buf, nextwrp);
711                 nbpackets = ((dev->buffer_size - oldwrp) + nextwrp) / 188;
712         } else
713                 nbpackets = (nextwrp - oldwrp) / 188;
714 
715         dev->wrp = nextwrp;
716         dvb_dmx_swfilter_packets(&dev->demux, &dev->ts_buf[oldwrp], nbpackets);
717 }
718 
719 static irqreturn_t dm1105_irq(int irq, void *dev_id)
720 {
721         struct dm1105_dev *dev = dev_id;
722 
723         /* Read-Write INSTS Ack's Interrupt for DM1105 chip 16.03.2008 */
724         unsigned int intsts = dm_readb(DM1105_INTSTS);
725         dm_writeb(DM1105_INTSTS, intsts);
726 
727         switch (intsts) {
728         case INTSTS_TSIRQ:
729         case (INTSTS_TSIRQ | INTSTS_IR):
730                 dev->nextwrp = dm_readl(DM1105_WRP) - dm_readl(DM1105_STADR);
731                 queue_work(dev->wq, &dev->work);
732                 break;
733         case INTSTS_IR:
734                 dev->ir.ir_command = dm_readl(DM1105_IRCODE);
735                 schedule_work(&dev->ir.work);
736                 break;
737         }
738 
739         return IRQ_HANDLED;
740 }
741 
742 static int dm1105_ir_init(struct dm1105_dev *dm1105)
743 {
744         struct rc_dev *dev;
745         int err = -ENOMEM;
746 
747         dev = rc_allocate_device();
748         if (!dev)
749                 return -ENOMEM;
750 
751         snprintf(dm1105->ir.input_phys, sizeof(dm1105->ir.input_phys),
752                 "pci-%s/ir0", pci_name(dm1105->pdev));
753 
754         dev->driver_name = MODULE_NAME;
755         dev->map_name = RC_MAP_DM1105_NEC;
756         dev->driver_type = RC_DRIVER_SCANCODE;
757         dev->input_name = "DVB on-card IR receiver";
758         dev->input_phys = dm1105->ir.input_phys;
759         dev->input_id.bustype = BUS_PCI;
760         dev->input_id.version = 1;
761         if (dm1105->pdev->subsystem_vendor) {
762                 dev->input_id.vendor = dm1105->pdev->subsystem_vendor;
763                 dev->input_id.product = dm1105->pdev->subsystem_device;
764         } else {
765                 dev->input_id.vendor = dm1105->pdev->vendor;
766                 dev->input_id.product = dm1105->pdev->device;
767         }
768         dev->dev.parent = &dm1105->pdev->dev;
769 
770         INIT_WORK(&dm1105->ir.work, dm1105_emit_key);
771 
772         err = rc_register_device(dev);
773         if (err < 0) {
774                 rc_free_device(dev);
775                 return err;
776         }
777 
778         dm1105->ir.dev = dev;
779         return 0;
780 }
781 
782 static void dm1105_ir_exit(struct dm1105_dev *dm1105)
783 {
784         rc_unregister_device(dm1105->ir.dev);
785 }
786 
787 static int dm1105_hw_init(struct dm1105_dev *dev)
788 {
789         dm1105_disable_irqs(dev);
790 
791         dm_writeb(DM1105_HOST_CTR, 0);
792 
793         /*DATALEN 188,*/
794         dm_writeb(DM1105_DTALENTH, 188);
795         /*TS_STRT TS_VALP MSBFIRST TS_MODE ALPAS TSPES*/
796         dm_writew(DM1105_TSCTR, 0xc10a);
797 
798         /* map DMA and set address */
799         dm1105_dma_map(dev);
800         dm1105_set_dma_addr(dev);
801         /* big buffer */
802         dm_writel(DM1105_RLEN, 5 * DM1105_DMA_BYTES);
803         dm_writeb(DM1105_INTCNT, 47);
804 
805         /* IR NEC mode enable */
806         dm_writeb(DM1105_IRCTR, (DM1105_IR_EN | DM1105_SYS_CHK));
807         dm_writeb(DM1105_IRMODE, 0);
808         dm_writew(DM1105_SYSTEMCODE, 0);
809 
810         return 0;
811 }
812 
813 static void dm1105_hw_exit(struct dm1105_dev *dev)
814 {
815         dm1105_disable_irqs(dev);
816 
817         /* IR disable */
818         dm_writeb(DM1105_IRCTR, 0);
819         dm_writeb(DM1105_INTMAK, INTMAK_NONEMASK);
820 
821         dm1105_dma_unmap(dev);
822 }
823 
824 static struct stv0299_config sharp_z0194a_config = {
825         .demod_address = 0x68,
826         .inittab = sharp_z0194a_inittab,
827         .mclk = 88000000UL,
828         .invert = 1,
829         .skip_reinit = 0,
830         .lock_output = STV0299_LOCKOUTPUT_1,
831         .volt13_op0_op1 = STV0299_VOLT13_OP1,
832         .min_delay_ms = 100,
833         .set_symbol_rate = sharp_z0194a_set_symbol_rate,
834 };
835 
836 static struct stv0288_config earda_config = {
837         .demod_address = 0x68,
838         .min_delay_ms = 100,
839 };
840 
841 static struct si21xx_config serit_config = {
842         .demod_address = 0x68,
843         .min_delay_ms = 100,
844 
845 };
846 
847 static struct cx24116_config serit_sp2633_config = {
848         .demod_address = 0x55,
849 };
850 
851 static struct ds3000_config dvbworld_ds3000_config = {
852         .demod_address = 0x68,
853 };
854 
855 static struct ts2020_config dvbworld_ts2020_config  = {
856         .tuner_address = 0x60,
857         .clk_out_div = 1,
858 };
859 
860 static int frontend_init(struct dm1105_dev *dev)
861 {
862         int ret;
863 
864         switch (dev->boardnr) {
865         case DM1105_BOARD_UNBRANDED_I2C_ON_GPIO:
866                 dm1105_gpio_enable(dev, GPIO15, 1);
867                 dm1105_gpio_clear(dev, GPIO15);
868                 msleep(100);
869                 dm1105_gpio_set(dev, GPIO15);
870                 msleep(200);
871                 dev->fe = dvb_attach(
872                         stv0299_attach, &sharp_z0194a_config,
873                         &dev->i2c_bb_adap);
874                 if (dev->fe) {
875                         dev->fe->ops.set_voltage = dm1105_set_voltage;
876                         dvb_attach(dvb_pll_attach, dev->fe, 0x60,
877                                         &dev->i2c_bb_adap, DVB_PLL_OPERA1);
878                         break;
879                 }
880 
881                 dev->fe = dvb_attach(
882                         stv0288_attach, &earda_config,
883                         &dev->i2c_bb_adap);
884                 if (dev->fe) {
885                         dev->fe->ops.set_voltage = dm1105_set_voltage;
886                         dvb_attach(stb6000_attach, dev->fe, 0x61,
887                                         &dev->i2c_bb_adap);
888                         break;
889                 }
890 
891                 dev->fe = dvb_attach(
892                         si21xx_attach, &serit_config,
893                         &dev->i2c_bb_adap);
894                 if (dev->fe)
895                         dev->fe->ops.set_voltage = dm1105_set_voltage;
896                 break;
897         case DM1105_BOARD_DVBWORLD_2004:
898                 dev->fe = dvb_attach(
899                         cx24116_attach, &serit_sp2633_config,
900                         &dev->i2c_adap);
901                 if (dev->fe) {
902                         dev->fe->ops.set_voltage = dm1105_set_voltage;
903                         break;
904                 }
905 
906                 dev->fe = dvb_attach(
907                         ds3000_attach, &dvbworld_ds3000_config,
908                         &dev->i2c_adap);
909                 if (dev->fe) {
910                         dvb_attach(ts2020_attach, dev->fe,
911                                 &dvbworld_ts2020_config, &dev->i2c_adap);
912                         dev->fe->ops.set_voltage = dm1105_set_voltage;
913                 }
914 
915                 break;
916         case DM1105_BOARD_DVBWORLD_2002:
917         case DM1105_BOARD_AXESS_DM05:
918         default:
919                 dev->fe = dvb_attach(
920                         stv0299_attach, &sharp_z0194a_config,
921                         &dev->i2c_adap);
922                 if (dev->fe) {
923                         dev->fe->ops.set_voltage = dm1105_set_voltage;
924                         dvb_attach(dvb_pll_attach, dev->fe, 0x60,
925                                         &dev->i2c_adap, DVB_PLL_OPERA1);
926                         break;
927                 }
928 
929                 dev->fe = dvb_attach(
930                         stv0288_attach, &earda_config,
931                         &dev->i2c_adap);
932                 if (dev->fe) {
933                         dev->fe->ops.set_voltage = dm1105_set_voltage;
934                         dvb_attach(stb6000_attach, dev->fe, 0x61,
935                                         &dev->i2c_adap);
936                         break;
937                 }
938 
939                 dev->fe = dvb_attach(
940                         si21xx_attach, &serit_config,
941                         &dev->i2c_adap);
942                 if (dev->fe)
943                         dev->fe->ops.set_voltage = dm1105_set_voltage;
944 
945         }
946 
947         if (!dev->fe) {
948                 dev_err(&dev->pdev->dev, "could not attach frontend\n");
949                 return -ENODEV;
950         }
951 
952         ret = dvb_register_frontend(&dev->dvb_adapter, dev->fe);
953         if (ret < 0) {
954                 if (dev->fe->ops.release)
955                         dev->fe->ops.release(dev->fe);
956                 dev->fe = NULL;
957                 return ret;
958         }
959 
960         return 0;
961 }
962 
963 static void dm1105_read_mac(struct dm1105_dev *dev, u8 *mac)
964 {
965         static u8 command[1] = { 0x28 };
966 
967         struct i2c_msg msg[] = {
968                 {
969                         .addr = IIC_24C01_addr >> 1,
970                         .flags = 0,
971                         .buf = command,
972                         .len = 1
973                 }, {
974                         .addr = IIC_24C01_addr >> 1,
975                         .flags = I2C_M_RD,
976                         .buf = mac,
977                         .len = 6
978                 },
979         };
980 
981         dm1105_i2c_xfer(&dev->i2c_adap, msg , 2);
982         dev_info(&dev->pdev->dev, "MAC %pM\n", mac);
983 }
984 
985 static int dm1105_probe(struct pci_dev *pdev,
986                                   const struct pci_device_id *ent)
987 {
988         struct dm1105_dev *dev;
989         struct dvb_adapter *dvb_adapter;
990         struct dvb_demux *dvbdemux;
991         struct dmx_demux *dmx;
992         int ret = -ENOMEM;
993         int i;
994 
995         dev = kzalloc(sizeof(struct dm1105_dev), GFP_KERNEL);
996         if (!dev)
997                 return -ENOMEM;
998 
999         /* board config */
1000         dev->nr = dm1105_devcount;
1001         dev->boardnr = UNSET;
1002         if (card[dev->nr] < ARRAY_SIZE(dm1105_boards))
1003                 dev->boardnr = card[dev->nr];
1004         for (i = 0; UNSET == dev->boardnr &&
1005                                 i < ARRAY_SIZE(dm1105_subids); i++)
1006                 if (pdev->subsystem_vendor ==
1007                         dm1105_subids[i].subvendor &&
1008                                 pdev->subsystem_device ==
1009                                         dm1105_subids[i].subdevice)
1010                         dev->boardnr = dm1105_subids[i].card;
1011 
1012         if (UNSET == dev->boardnr) {
1013                 dev->boardnr = DM1105_BOARD_UNKNOWN;
1014                 dm1105_card_list(pdev);
1015         }
1016 
1017         dm1105_devcount++;
1018         dev->pdev = pdev;
1019         dev->buffer_size = 5 * DM1105_DMA_BYTES;
1020         dev->PacketErrorCount = 0;
1021         dev->dmarst = 0;
1022 
1023         ret = pci_enable_device(pdev);
1024         if (ret < 0)
1025                 goto err_kfree;
1026 
1027         ret = pci_set_dma_mask(pdev, DMA_BIT_MASK(32));
1028         if (ret < 0)
1029                 goto err_pci_disable_device;
1030 
1031         pci_set_master(pdev);
1032 
1033         ret = pci_request_regions(pdev, DRIVER_NAME);
1034         if (ret < 0)
1035                 goto err_pci_disable_device;
1036 
1037         dev->io_mem = pci_iomap(pdev, 0, pci_resource_len(pdev, 0));
1038         if (!dev->io_mem) {
1039                 ret = -EIO;
1040                 goto err_pci_release_regions;
1041         }
1042 
1043         spin_lock_init(&dev->lock);
1044         pci_set_drvdata(pdev, dev);
1045 
1046         ret = dm1105_hw_init(dev);
1047         if (ret < 0)
1048                 goto err_pci_iounmap;
1049 
1050         /* i2c */
1051         i2c_set_adapdata(&dev->i2c_adap, dev);
1052         strcpy(dev->i2c_adap.name, DRIVER_NAME);
1053         dev->i2c_adap.owner = THIS_MODULE;
1054         dev->i2c_adap.dev.parent = &pdev->dev;
1055         dev->i2c_adap.algo = &dm1105_algo;
1056         dev->i2c_adap.algo_data = dev;
1057         ret = i2c_add_adapter(&dev->i2c_adap);
1058 
1059         if (ret < 0)
1060                 goto err_dm1105_hw_exit;
1061 
1062         i2c_set_adapdata(&dev->i2c_bb_adap, dev);
1063         strcpy(dev->i2c_bb_adap.name, DM1105_I2C_GPIO_NAME);
1064         dev->i2c_bb_adap.owner = THIS_MODULE;
1065         dev->i2c_bb_adap.dev.parent = &pdev->dev;
1066         dev->i2c_bb_adap.algo_data = &dev->i2c_bit;
1067         dev->i2c_bit.data = dev;
1068         dev->i2c_bit.setsda = dm1105_setsda;
1069         dev->i2c_bit.setscl = dm1105_setscl;
1070         dev->i2c_bit.getsda = dm1105_getsda;
1071         dev->i2c_bit.getscl = dm1105_getscl;
1072         dev->i2c_bit.udelay = 10;
1073         dev->i2c_bit.timeout = 10;
1074 
1075         /* Raise SCL and SDA */
1076         dm1105_setsda(dev, 1);
1077         dm1105_setscl(dev, 1);
1078 
1079         ret = i2c_bit_add_bus(&dev->i2c_bb_adap);
1080         if (ret < 0)
1081                 goto err_i2c_del_adapter;
1082 
1083         /* dvb */
1084         ret = dvb_register_adapter(&dev->dvb_adapter, DRIVER_NAME,
1085                                         THIS_MODULE, &pdev->dev, adapter_nr);
1086         if (ret < 0)
1087                 goto err_i2c_del_adapters;
1088 
1089         dvb_adapter = &dev->dvb_adapter;
1090 
1091         dm1105_read_mac(dev, dvb_adapter->proposed_mac);
1092 
1093         dvbdemux = &dev->demux;
1094         dvbdemux->filternum = 256;
1095         dvbdemux->feednum = 256;
1096         dvbdemux->start_feed = dm1105_start_feed;
1097         dvbdemux->stop_feed = dm1105_stop_feed;
1098         dvbdemux->dmx.capabilities = (DMX_TS_FILTERING |
1099                         DMX_SECTION_FILTERING | DMX_MEMORY_BASED_FILTERING);
1100         ret = dvb_dmx_init(dvbdemux);
1101         if (ret < 0)
1102                 goto err_dvb_unregister_adapter;
1103 
1104         dmx = &dvbdemux->dmx;
1105         dev->dmxdev.filternum = 256;
1106         dev->dmxdev.demux = dmx;
1107         dev->dmxdev.capabilities = 0;
1108 
1109         ret = dvb_dmxdev_init(&dev->dmxdev, dvb_adapter);
1110         if (ret < 0)
1111                 goto err_dvb_dmx_release;
1112 
1113         dev->hw_frontend.source = DMX_FRONTEND_0;
1114 
1115         ret = dmx->add_frontend(dmx, &dev->hw_frontend);
1116         if (ret < 0)
1117                 goto err_dvb_dmxdev_release;
1118 
1119         dev->mem_frontend.source = DMX_MEMORY_FE;
1120 
1121         ret = dmx->add_frontend(dmx, &dev->mem_frontend);
1122         if (ret < 0)
1123                 goto err_remove_hw_frontend;
1124 
1125         ret = dmx->connect_frontend(dmx, &dev->hw_frontend);
1126         if (ret < 0)
1127                 goto err_remove_mem_frontend;
1128 
1129         ret = dvb_net_init(dvb_adapter, &dev->dvbnet, dmx);
1130         if (ret < 0)
1131                 goto err_disconnect_frontend;
1132 
1133         ret = frontend_init(dev);
1134         if (ret < 0)
1135                 goto err_dvb_net;
1136 
1137         dm1105_ir_init(dev);
1138 
1139         INIT_WORK(&dev->work, dm1105_dmx_buffer);
1140         sprintf(dev->wqn, "%s/%d", dvb_adapter->name, dvb_adapter->num);
1141         dev->wq = create_singlethread_workqueue(dev->wqn);
1142         if (!dev->wq) {
1143                 ret = -ENOMEM;
1144                 goto err_dvb_net;
1145         }
1146 
1147         ret = request_irq(pdev->irq, dm1105_irq, IRQF_SHARED,
1148                                                 DRIVER_NAME, dev);
1149         if (ret < 0)
1150                 goto err_workqueue;
1151 
1152         return 0;
1153 
1154 err_workqueue:
1155         destroy_workqueue(dev->wq);
1156 err_dvb_net:
1157         dvb_net_release(&dev->dvbnet);
1158 err_disconnect_frontend:
1159         dmx->disconnect_frontend(dmx);
1160 err_remove_mem_frontend:
1161         dmx->remove_frontend(dmx, &dev->mem_frontend);
1162 err_remove_hw_frontend:
1163         dmx->remove_frontend(dmx, &dev->hw_frontend);
1164 err_dvb_dmxdev_release:
1165         dvb_dmxdev_release(&dev->dmxdev);
1166 err_dvb_dmx_release:
1167         dvb_dmx_release(dvbdemux);
1168 err_dvb_unregister_adapter:
1169         dvb_unregister_adapter(dvb_adapter);
1170 err_i2c_del_adapters:
1171         i2c_del_adapter(&dev->i2c_bb_adap);
1172 err_i2c_del_adapter:
1173         i2c_del_adapter(&dev->i2c_adap);
1174 err_dm1105_hw_exit:
1175         dm1105_hw_exit(dev);
1176 err_pci_iounmap:
1177         pci_iounmap(pdev, dev->io_mem);
1178 err_pci_release_regions:
1179         pci_release_regions(pdev);
1180 err_pci_disable_device:
1181         pci_disable_device(pdev);
1182 err_kfree:
1183         kfree(dev);
1184         return ret;
1185 }
1186 
1187 static void dm1105_remove(struct pci_dev *pdev)
1188 {
1189         struct dm1105_dev *dev = pci_get_drvdata(pdev);
1190         struct dvb_adapter *dvb_adapter = &dev->dvb_adapter;
1191         struct dvb_demux *dvbdemux = &dev->demux;
1192         struct dmx_demux *dmx = &dvbdemux->dmx;
1193 
1194         dm1105_ir_exit(dev);
1195         dmx->close(dmx);
1196         dvb_net_release(&dev->dvbnet);
1197         if (dev->fe)
1198                 dvb_unregister_frontend(dev->fe);
1199 
1200         dmx->disconnect_frontend(dmx);
1201         dmx->remove_frontend(dmx, &dev->mem_frontend);
1202         dmx->remove_frontend(dmx, &dev->hw_frontend);
1203         dvb_dmxdev_release(&dev->dmxdev);
1204         dvb_dmx_release(dvbdemux);
1205         dvb_unregister_adapter(dvb_adapter);
1206         i2c_del_adapter(&dev->i2c_adap);
1207 
1208         dm1105_hw_exit(dev);
1209         synchronize_irq(pdev->irq);
1210         free_irq(pdev->irq, dev);
1211         pci_iounmap(pdev, dev->io_mem);
1212         pci_release_regions(pdev);
1213         pci_disable_device(pdev);
1214         dm1105_devcount--;
1215         kfree(dev);
1216 }
1217 
1218 static struct pci_device_id dm1105_id_table[] = {
1219         {
1220                 .vendor = PCI_VENDOR_ID_TRIGEM,
1221                 .device = PCI_DEVICE_ID_DM1105,
1222                 .subvendor = PCI_ANY_ID,
1223                 .subdevice = PCI_ANY_ID,
1224         }, {
1225                 .vendor = PCI_VENDOR_ID_AXESS,
1226                 .device = PCI_DEVICE_ID_DM05,
1227                 .subvendor = PCI_ANY_ID,
1228                 .subdevice = PCI_ANY_ID,
1229         }, {
1230                 /* empty */
1231         },
1232 };
1233 
1234 MODULE_DEVICE_TABLE(pci, dm1105_id_table);
1235 
1236 static struct pci_driver dm1105_driver = {
1237         .name = DRIVER_NAME,
1238         .id_table = dm1105_id_table,
1239         .probe = dm1105_probe,
1240         .remove = dm1105_remove,
1241 };
1242 
1243 module_pci_driver(dm1105_driver);
1244 
1245 MODULE_AUTHOR("Igor M. Liplianin <liplianin@me.by>");
1246 MODULE_DESCRIPTION("SDMC DM1105 DVB driver");
1247 MODULE_LICENSE("GPL");
1248 

This page was automatically generated by LXR 0.3.1 (source).  •  Linux is a registered trademark of Linus Torvalds  •  Contact us