1 | // SPDX-License-Identifier: GPL-2.0-only |
2 | /* |
3 | * Guillemot Maxi Radio FM 2000 PCI radio card driver for Linux |
4 | * (C) 2001 Dimitromanolakis Apostolos <apdim@grecian.net> |
5 | * |
6 | * Based in the radio Maestro PCI driver. Actually it uses the same chip |
7 | * for radio but different pci controller. |
8 | * |
9 | * I didn't have any specs I reversed engineered the protocol from |
10 | * the windows driver (radio.dll). |
11 | * |
12 | * The card uses the TEA5757 chip that includes a search function but it |
13 | * is useless as I haven't found any way to read back the frequency. If |
14 | * anybody does please mail me. |
15 | * |
16 | * For the pdf file see: |
17 | * http://www.nxp.com/acrobat_download2/expired_datasheets/TEA5757_5759_3.pdf |
18 | * |
19 | * |
20 | * CHANGES: |
21 | * 0.75b |
22 | * - better pci interface thanks to Francois Romieu <romieu@cogenit.fr> |
23 | * |
24 | * 0.75 Sun Feb 4 22:51:27 EET 2001 |
25 | * - tiding up |
26 | * - removed support for multiple devices as it didn't work anyway |
27 | * |
28 | * BUGS: |
29 | * - card unmutes if you change frequency |
30 | * |
31 | * (c) 2006, 2007 by Mauro Carvalho Chehab <mchehab@kernel.org>: |
32 | * - Conversion to V4L2 API |
33 | * - Uses video_ioctl2 for parsing and to add debug support |
34 | */ |
35 | |
36 | |
37 | #include <linux/module.h> |
38 | #include <linux/init.h> |
39 | #include <linux/ioport.h> |
40 | #include <linux/delay.h> |
41 | #include <linux/mutex.h> |
42 | #include <linux/pci.h> |
43 | #include <linux/videodev2.h> |
44 | #include <linux/io.h> |
45 | #include <linux/slab.h> |
46 | #include <media/drv-intf/tea575x.h> |
47 | #include <media/v4l2-device.h> |
48 | #include <media/v4l2-ioctl.h> |
49 | #include <media/v4l2-fh.h> |
50 | #include <media/v4l2-ctrls.h> |
51 | #include <media/v4l2-event.h> |
52 | |
53 | MODULE_AUTHOR("Dimitromanolakis Apostolos, apdim@grecian.net" ); |
54 | MODULE_DESCRIPTION("Radio driver for the Guillemot Maxi Radio FM2000." ); |
55 | MODULE_LICENSE("GPL" ); |
56 | MODULE_VERSION("1.0.0" ); |
57 | |
58 | static int radio_nr = -1; |
59 | module_param(radio_nr, int, 0644); |
60 | MODULE_PARM_DESC(radio_nr, "Radio device number" ); |
61 | |
62 | /* TEA5757 pin mappings */ |
63 | static const int clk = 1, data = 2, wren = 4, mo_st = 8, power = 16; |
64 | |
65 | static atomic_t maxiradio_instance = ATOMIC_INIT(0); |
66 | |
67 | #define PCI_VENDOR_ID_GUILLEMOT 0x5046 |
68 | #define PCI_DEVICE_ID_GUILLEMOT_MAXIRADIO 0x1001 |
69 | |
70 | struct maxiradio |
71 | { |
72 | struct snd_tea575x tea; |
73 | struct v4l2_device v4l2_dev; |
74 | struct pci_dev *pdev; |
75 | |
76 | u16 io; /* base of radio io */ |
77 | }; |
78 | |
79 | static inline struct maxiradio *to_maxiradio(struct v4l2_device *v4l2_dev) |
80 | { |
81 | return container_of(v4l2_dev, struct maxiradio, v4l2_dev); |
82 | } |
83 | |
84 | static void maxiradio_tea575x_set_pins(struct snd_tea575x *tea, u8 pins) |
85 | { |
86 | struct maxiradio *dev = tea->private_data; |
87 | u8 bits = 0; |
88 | |
89 | bits |= (pins & TEA575X_DATA) ? data : 0; |
90 | bits |= (pins & TEA575X_CLK) ? clk : 0; |
91 | bits |= (pins & TEA575X_WREN) ? wren : 0; |
92 | bits |= power; |
93 | |
94 | outb(value: bits, port: dev->io); |
95 | } |
96 | |
97 | /* Note: this card cannot read out the data of the shift registers, |
98 | only the mono/stereo pin works. */ |
99 | static u8 maxiradio_tea575x_get_pins(struct snd_tea575x *tea) |
100 | { |
101 | struct maxiradio *dev = tea->private_data; |
102 | u8 bits = inb(port: dev->io); |
103 | |
104 | return ((bits & data) ? TEA575X_DATA : 0) | |
105 | ((bits & mo_st) ? TEA575X_MOST : 0); |
106 | } |
107 | |
108 | static void maxiradio_tea575x_set_direction(struct snd_tea575x *tea, bool output) |
109 | { |
110 | } |
111 | |
112 | static const struct snd_tea575x_ops maxiradio_tea_ops = { |
113 | .set_pins = maxiradio_tea575x_set_pins, |
114 | .get_pins = maxiradio_tea575x_get_pins, |
115 | .set_direction = maxiradio_tea575x_set_direction, |
116 | }; |
117 | |
118 | static int maxiradio_probe(struct pci_dev *pdev, |
119 | const struct pci_device_id *ent) |
120 | { |
121 | struct maxiradio *dev; |
122 | struct v4l2_device *v4l2_dev; |
123 | int retval = -ENOMEM; |
124 | |
125 | dev = kzalloc(size: sizeof(*dev), GFP_KERNEL); |
126 | if (dev == NULL) { |
127 | dev_err(&pdev->dev, "not enough memory\n" ); |
128 | return -ENOMEM; |
129 | } |
130 | |
131 | v4l2_dev = &dev->v4l2_dev; |
132 | v4l2_device_set_name(v4l2_dev, basename: "maxiradio" , instance: &maxiradio_instance); |
133 | |
134 | retval = v4l2_device_register(dev: &pdev->dev, v4l2_dev); |
135 | if (retval < 0) { |
136 | v4l2_err(v4l2_dev, "Could not register v4l2_device\n" ); |
137 | goto errfr; |
138 | } |
139 | dev->tea.private_data = dev; |
140 | dev->tea.ops = &maxiradio_tea_ops; |
141 | /* The data pin cannot be read. This may be a hardware limitation, or |
142 | we just don't know how to read it. */ |
143 | dev->tea.cannot_read_data = true; |
144 | dev->tea.v4l2_dev = v4l2_dev; |
145 | dev->tea.radio_nr = radio_nr; |
146 | strscpy(dev->tea.card, "Maxi Radio FM2000" , sizeof(dev->tea.card)); |
147 | |
148 | retval = -ENODEV; |
149 | |
150 | if (!request_region(pci_resource_start(pdev, 0), |
151 | pci_resource_len(pdev, 0), v4l2_dev->name)) { |
152 | dev_err(&pdev->dev, "can't reserve I/O ports\n" ); |
153 | goto err_hdl; |
154 | } |
155 | |
156 | if (pci_enable_device(dev: pdev)) |
157 | goto err_out_free_region; |
158 | |
159 | dev->io = pci_resource_start(pdev, 0); |
160 | if (snd_tea575x_init(tea: &dev->tea, THIS_MODULE)) { |
161 | printk(KERN_ERR "radio-maxiradio: Unable to detect TEA575x tuner\n" ); |
162 | goto err_out_free_region; |
163 | } |
164 | return 0; |
165 | |
166 | err_out_free_region: |
167 | release_region(pci_resource_start(pdev, 0), pci_resource_len(pdev, 0)); |
168 | err_hdl: |
169 | v4l2_device_unregister(v4l2_dev); |
170 | errfr: |
171 | kfree(objp: dev); |
172 | return retval; |
173 | } |
174 | |
175 | static void maxiradio_remove(struct pci_dev *pdev) |
176 | { |
177 | struct v4l2_device *v4l2_dev = pci_get_drvdata(pdev); |
178 | struct maxiradio *dev = to_maxiradio(v4l2_dev); |
179 | |
180 | snd_tea575x_exit(tea: &dev->tea); |
181 | /* Turn off power */ |
182 | outb(value: 0, port: dev->io); |
183 | v4l2_device_unregister(v4l2_dev); |
184 | release_region(pci_resource_start(pdev, 0), pci_resource_len(pdev, 0)); |
185 | kfree(objp: dev); |
186 | } |
187 | |
188 | static const struct pci_device_id maxiradio_pci_tbl[] = { |
189 | { PCI_VENDOR_ID_GUILLEMOT, PCI_DEVICE_ID_GUILLEMOT_MAXIRADIO, |
190 | PCI_ANY_ID, PCI_ANY_ID, }, |
191 | { 0 } |
192 | }; |
193 | |
194 | MODULE_DEVICE_TABLE(pci, maxiradio_pci_tbl); |
195 | |
196 | static struct pci_driver maxiradio_driver = { |
197 | .name = "radio-maxiradio" , |
198 | .id_table = maxiradio_pci_tbl, |
199 | .probe = maxiradio_probe, |
200 | .remove = maxiradio_remove, |
201 | }; |
202 | |
203 | module_pci_driver(maxiradio_driver); |
204 | |